* test(studio): the edit bench measures an element inside a sealed preview
* fix(studio): the edit bench reads a sealed preview through its editing port
* fix(studio): the edit bench drops a preview reply that lands after a release or the next drag
* fix(studio): the edit bench pairs each frame's pushed geometry with the pointer at that moment
* fix(studio): the edit bench pairs Studio's outlines and the watched element by time, not arrival
* fix(studio): the edit bench starts a drag only once the preview has measured the element
* test(studio): audio meters and group volume in a sealed preview
* fix(studio): audio meters and audio groups work in a sealed preview
* chore(inspector): raise the unpacked size budget for the preview's audio editing kinds
* test(studio): the sealed audio test serves a Studio-marked preview, as the editing port now requires
* fix(studio): a service worker a project left behind is gone before a preview frame loads
* fix(cli): the player page's inlined script list is escaped for a script tag
* fix(core): only Studio's own preview pages get the editing port, and undo sets only safe attributes
restore-attributes now changes only class, style and the editor's timing, layout, audio and label data- attributes, and drops only data- ones; any other change answers applied: false and Studio reloads the preview. The editing agent hands its port over only when the page carries Studio's preview mark and not the another-site mark, so a page no Studio marked never offers it.
* fix(core): undo on a lazily loaded image still applies in place
The preview server adds loading="lazy" to timed images and the saved file does not have it, so the restore now may drop loading; dropping it loads nothing new.
* style(core): keep the restore plan's doc comment within the line limit
* test(studio): three quick drags give three undo entries in the history list
* fix(studio): each drag shows as its own undo step once its save lands
* test(studio): the edit bench fails a gesture missing from the history list
* refactor(studio): the held-entry close is a plain function, and the bench helper stays private
* chore(studio): mark the history hook's existing complexity the way other large hooks are
* fix(studio): a drag's history claim waits for the previous drag's close to land
* test(studio): caption overlay shows and edits words in a sealed preview
* fix(studio): caption editing reads and moves words through the editing port in a sealed preview
* style(studio): format the caption port change and trim its comments
* fix(studio): keep the caption port change inside its files and under the size checks
* fix(studio): keep late caption frame answers from writing after Studio moves on
A caption detection, nudge or drag still waiting on a sealed preview no longer
writes after its effect is gone, and a frame-reported word transform past the
frame's own write bound is refused instead of stored. Each has a test against
the real editing agent that holds the frame's answer open.
* refactor(studio): move the sealed caption nudge queue next to the frame word helpers
Keeps the caption overlay under the studio file size limit and its comment share at the base. No behaviour change.
* refactor(studio): keep the sealed caption nudge request inside its helper file
* fix(studio): a sealed preview's reload shows in a fraction of a second, not after 8 s
* fix(studio): the sealed reload's frame sits under the live one, so clicks stay on the live frame
* fix(studio): the sealed reload's frame stays on top but inert, so clicks reach the live frame
Under the live frame (z-index -1) the reload's frame was left unpromoted in a traced run; on top and inert it renders and swaps in, and hit testing skips it, its own frame included.
* refactor(studio): name the sealed reload's style for what it does, not in comments
* fix(studio): the reload code marks a sealed reload's player inert until it is promoted
Player keeps main's shape: the hook that owns the reload sets inert on the hidden frame's player element when its frame arrives and clears it at promotion.
* test(studio): keep the reload-inert test's comment under the line limit
* fix(studio): the copied render command carries no composition text a shell can run
The Variables panel's "Copy render command" put every variable value inline,
quoted for POSIX shells only. A shared project's author chooses those values,
so in PowerShell, cmd.exe (including npx.cmd's re-parse) or fish a default
such as `x'; calc.exe; '` ran as commands when the command was pasted.
The command is now fixed text: `npx hyperframes render -c <composition>
--variables-file .hyperframes/render-variables.json`. Copying it saves the
previewed values to that file through a new PUT /projects/:id/render-variables
route, which refuses a link standing in for .hyperframes and replaces, rather
than writes through, a link at the file itself. A composition path that is not
one plain word in every shell (letters, digits, `_ . / -`) gets no command.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* fix(scripts): the comment checker skips a template nested in a substitution
stripLiterals ended a template literal at the first backtick, including one
that opens a nested template inside `${...}`. On a line such as
`'${value.replace(/'/g, `'\\''`)}'` that left a backtick unmatched, so
scanCLike read the rest of the file as one template and counted none of its
comments. The ratchet then measured VariablesPanel.tsx on main at 1 comment
line instead of 31 and failed any change that removed that line.
A `${...}` is now scanned as code: strings, regexes and templates inside it
are skipped, and its closing brace returns to the outer template.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* test(studio-server): read the replaced render-variables record through one no-follow descriptor
The link test checked the record with lstat and then read it by path, two
lookups CodeQL reports as a file-system race. Opening it once with O_NOFOLLOW
fails if a link is still there and reads the file that open checked.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(studio): dev Studio renders apply the received-project rule for outside files
The Vite Studio adapter started every render with files from outside the
project allowed. It now asks the CLI's outsideAssetsAllowed, the same check
the CLI's embedded Studio, hyperframes render and benchmark use. A project
whose received-files record lists code files, or cannot be read, renders
without files from outside the project, and the reason prints with a
[studio] prefix.
The adapter loads the rule from the CLI source through the dev server, as it
already does for background removal. It runs only from a source checkout, so
studio takes no package dependency on the CLI.
* fix(cli): a received project's .env provider key never replaces your own credential
A received project's .env could set OPENROUTER_API_KEY, GEMINI_API_KEY,
GOOGLE_API_KEY or Vertex settings that outranked a vision or Gemini
credential the person set in the shell, so capture, snapshot describe and
media-use speech and music could send content to another account.
After the CLI and capture load a project .env, each provider key it set is
unset when that .env came with a received project (a received-files record
lists it, or a record cannot be read) and the person has their own
credential for a competing provider. One stderr line names the key, the
.env file and the credential used instead.
A person's own project .env keeps its keys and its current precedence, so
an OPENROUTER_API_KEY in a project .env still wins over a Gemini key in the
shell, as the docs describe. Voice needs no change: the person's HeyGen
credential already ranks above ElevenLabs.
* fix(cli,media-use): media-use scripts apply the received .env rule, ElevenLabs included
The media-use audio scripts read the project .env again, so a Gemini key the
CLI had left out came back. They now apply the same rule after loading: a
key from a received project's .env gives way to the person's own credential
for a competing provider. GEMINI_API_KEY and GOOGLE_API_KEY give way to the
person's Gemini key or service account. ELEVENLABS_API_KEY gives way to the
person's HeyGen sign-in, saved key or shell key. A dropped key gets one
stderr line that names the file and the credential used instead.
A received ElevenLabs key that is still used, because the person has no
competing credential, gets one stderr line naming the .env before speech
starts. hyperframes media-use tells the engine which keys it took from a
project .env (HYPERFRAMES_PROJECT_ENV_ORIGINS), so a key the CLI loaded is
not mistaken for the shell's.
When the project's folders are too many to scan for received-files
records, the CLI's note now says the project's origin could not be
checked, instead of calling it a received project.
* refactor(studio): check the shape of the CLI's outside-files rule before calling it
The Vite adapter loads outsideAssetsAllowed from the CLI source at run time.
It now checks that the export is a function and treats only a true result
as allowed, instead of casting the module's export.
* docs(auth): a received project's ElevenLabs key gives way to your HeyGen credential
* test(studio): load the received-project rule before render waits start
* fix(studio): an undo on a sealed preview shows in place, not after a reload
* fix(studio): split the sealed restore checks, and the inspector budget takes the new kind
* feat(core): describe replies carry the picker's element label, and studio exports standInHandle
* fix(core): label an element by its rendered text, and read a describe reply without a label
* style(core): format the rendered-text walk
* fix(studio): beat analysis never picks a recording longer than a song
* fix(studio): a long music track keeps its saved beats; the cap judges the file alone
* fix(studio): a music track's beat edits survive its file length arriving
* feat(studio): a sealed preview frame forwards Studio's playback keys
* fix(core): a key held while Studio re-sends its watch list still forwards its keyup
* fix(core): the key watch adds and removes its listeners by name, as the runtime typecheck needs
* chore(producer): raise the unpacked size budget for the runtime's key forwarding
* fix(core): a graded video's opacity animation reaches its export
* fix(core): a graded clip keeps its own clip-path, so it never renders black
* test(producer): golden render of graded video dissolve and wipe
* fix(core): a graded clip stays clickable in the preview, hidden by a filter not a clip
* chore(studio): drop an import the reader no longer uses, and format the graded fixture
* fix(studio): the preview picture takes a new box size in the same frame
The preview stage measured its box in a ResizeObserver and stored the size
in React state, which rendered a frame later. A box that grows at once (the
window going full screen) painted one frame with the old, small picture, and
macOS animated that frame for its whole full-screen transition.
* fix(studio): the preview picture takes a new box size in the same frame
* fix(studio): the preview picture is sized from its box's layout, not its on-screen rect
* style(studio): format the preview stage size test
* fix(studio): a host that shows a still gets a preview reload with one page at a time
A full reload kept the live page beside the reload's own until it was promoted, so a heavy project held two
whole pages at once. A host that can show the live frame as a still (holdPreviewStill) now has the live page
dropped behind it while the reload's page loads alone; the still goes once the new page shows the live time,
and a reload that gives up brings the live page back at its time. With no still, nothing changes.
* fix(studio): keep the reload hook's comment share at the base
* fix(studio): pause before the still so a held reload resumes from the frame it shows
* fix(studio): drop a give-up's still on the live page's own load, not a polled load event
* fix(studio): a host that throws while taking the still falls back to the two-page reload
* fix(studio): recovery drafts are kept by each project's own server, never the browser
* fix(studio): a restored draft stays offered when Studio settles which composition is open
* fix(studio): a draft read never waits on a pipe or loads an oversized record
* test(studio): the draft read's child fixture is an entry point, and its note sits in the test
* chore(studio-server): size budget covers the recovery-draft route
* chore(cli): unpacked size budget covers the recovery-draft route
* fix(cli): the CLI trusts a preview only once it proves this user started it
* test(cli): a listener that cannot prove it is the user's preview is never trusted
* test(cli): stand-in previews answer the challenge as the user's own do
* style(cli): format the preview proof changes
* fix(cli): a preview's proof names its own endpoint and config, and the token file must be private
* style(cli): format the proof changes
* test(studio): the fake request in the host check has a socket, as every real one does
* fix(studio): a Studio started by hand proves it is the user's, so the CLI still finds it
* fix(cli): the challenge travels in a header, so Studio's routes keep their exact paths
* style(studio): keep the config producer compact
A preview made opaque by its server (Content-Security-Policy: sandbox) under a
frame with no sandbox attribute posts as null. frameOrigins now accepts null
for such a frame, only from that frame's own window and only while its window
refuses reads.
* fix(studio): the preview reads hf-preview messages only from its own frame
The preview message router acted on a message with no sender window, and on
any message that arrived before the preview frame existed. It now takes an
hf-preview message only when the preview frame exists, the message comes from
that frame's window, and its origin is one the frame can have: the page's own
origin, or "null" for a sealed frame. The element picker checks the same.
* fix(cli): present sandboxes deck pages another site loads and refuses framing by other sites
present now applies the same another-site decision as play to its
/composition/* route: a load by another site gets a sandbox CSP, its
validators are dropped, and the document is marked so its runtime offers
that site no editing port. Every present response also sends
frame-ancestors 'self' and X-Frame-Options SAMEORIGIN, so only the
presenter page itself can frame the deck. The route setup moves into
buildPresentApp so tests exercise the server as run() builds it.
* chore: release v0.9.55
* chore: release v0.9.55 notes include #7830
* chore: release v0.9.55 notes include #7859 and #7867
* chore: release v0.9.55 notes name the docs change and cloud render
* chore: release v0.9.55 notes include #7866 and #7801
* chore: release v0.9.55 notes match the style bar
* feat(studio): hosts can seal the preview frames NLEPreview draws
* refactor(studio): Player builds its frame src in a helper, keeping its complexity at main's
* refactor(core): Studio's key combo and typing-target rules live in core
* chore(core): raise the packed size budget for the key-combo and typing-target subpaths
* fix(deps): bump @mcp-b/global to 6.1.0 to clear @modelcontextprotocol/server advisories
@mcp-b/global 5.x and 6.0.x pin @modelcontextprotocol/server 2.0.0, which is
affected by GHSA-f897-62hf-6gxq, GHSA-46jr-4wx8-v453, GHSA-jm63-cq47-j5jp and
GHSA-rvq5-wwqv-78pq (>=2.0.0 <2.3.0). 6.1.0 is the first release that pins
server 2.4.0.
6.x installs the W3C WebMCP polyfill and passes { signal } to execute; the
real-package tests now drive the 6.x surface (secure context, MCP tools/call).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* test(studio): close the WebMCP polyfill after the real-package suite
6.x's BrowserMcpServer sends a tools-changed event on a timer after the
last tool unregisters. Without cleanupWebModelContext() it fired after jsdom
teardown and vitest failed the run on an unhandled rejection. Also scope the
transport test's header to the MCP transports it actually checks.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(studio): menu row highlight follows the menu's corner
* fix(studio): keep the menu row's comment share flat
* fix(studio): export the menu row class so hosts reuse it