* fix(reverse): give agents the sign-in reason to say, and catch stale CLIs that know reverse
- `reverse start`'s signed-out `next` now carries a sentence the agent can say as is
(why HeyGen, and that the HyperFrames account is the HeyGen account), asks for it at
the start of the sign-in message, and on remote terminals has the agent send the
device link and code before it waits.
- references/start.md: same ordering, an example that fits both login routes, and no
links to or quotes from the instructions themselves.
- An old global install that knows `reverse start` but predates `next` was never caught:
agent runs get no update notice and no auto-install, so it stays frozen. The skill now
also treats `_meta.updateAvailable: true` from `reverse start` as an old install and
runs the rest with `npx -y hyperframes@latest`; every CLI that knows `reverse start`
already reports that field.
* fix(reverse): send remote terminals straight to device sign-in, reason in every link message
- `reverse start` now knows when no browser can open (the check `auth login` uses, moved
to attendedTerminal): `login_command` is `auth login --device` and `next` asks for one
message with the reason, the link and the code. The two-step route (a refused browser
login, then a bare follow-up with the code) is where the reason got lost.
- Every message that gives the sign-in link starts with the reason; agents say they are
waiting rather than quoting the skill, and give no file paths.
- The out-of-date line for an old global install goes in the next message to the person.
* fix(reverse): flag an older global install that shadows npx, and pin the run's release
- installerDetection: `shadowingInstall` finds the older global `hyperframes` that a plain
`npx hyperframes` runs instead of this npx copy (first on PATH outside the npx cache), with
the command that moves it. `detectInstaller` takes the entry to classify.
- `reverse start` run through npx opens `next` with that line as words to say, signed in or
not. Skill prose alone did not get agents to tell the person.
- Skill: a signed-out `reverse start` with no `reverse.next` is also an old install, which
covers a cold update cache; the run pins the release `@latest` resolved to.
* fix(studio-server): reject cross-origin state-changing requests
Non-GET routes in createStudioApi answer 403 unless the shared
sameOriginPost predicate (lifted into studio-server's ./request-identity
subpath) accepts the request: the Host must be a server identity, a
present Sec-Fetch-Site must be same-origin, and a present Origin must
match the effective host and scheme. Hosts behind Codespaces or tunnels
allow their public name with HYPERFRAMES_PREVIEW_ALLOWED_HOSTS, read by
`hyperframes preview` and the Studio dev server.
Squashed from #6128 (42574a7, 110a300, 89011e1, 41c6626, 27193bb) onto
current main.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* fix(cli): the preview server answers only the hosts it is reached by
Every route of `hyperframes preview` (the forwarded studio API, the SSE
stream, /__hyperframes_config and the Studio page) now answers only
loopback names, the HYPERFRAMES_PREVIEW_HOST bind, or a host listed in
HYPERFRAMES_PREVIEW_ALLOWED_HOSTS, the same list the write guard uses.
Only the Host header counts here, since a page can set X-Forwarded-Host
on its own requests and a read carries no Origin to compare it with.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Dextheking1 <Dextheking1@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* feat(cli): label GPT image prices as estimates and show the charged credits
GPT Image generations on a HyperFrames plan are moving to fal's reported
vendor cost, so the pre-run figure is an estimate. The --plan basis for
gpt-image-2.5, 2.6 and 2.6-flare now reads "about N credits (charged at
vendor cost)". Nano Banana is unchanged.
When the /v3/images job carries charged.amount, generate reports it as
charged_credits and records it in the media ledger's provenance. Without
it, nothing new is printed. --max-credits is unchanged.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* feat(cli): keep 10% headroom under --max-credits for vendor-priced images
gpt-image-2.5, 2.6 and 2.6-flare are charged at the vendor's cost, so
--max-credits now refuses one when its estimate plus 10%, rounded up to a
whole credit, is over the limit. A 16:9 gpt-image-2.5 image (about 40
credits) is refused at --max-credits 40 and passes at 44. Other models keep
the plain estimate check. The refusal and the --max-credits help say so, and
the help notes this is not a hard ceiling.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(cli): count only HyperFrames-credit charges, and keep headroom under the run's limit
Review fixes for the vendor-cost image work:
- charged_credits is reported only when the job's charged.pool is
hyperframes_credits. A charge to api_credits or any other pool is in
that pool's own unit, so an API-key caller no longer sees it as HF
credits.
- runJob logs that charged amount, not the estimate, on a job's completion
row in heygen-jobs.jsonl, so later credit-limit checks see the real total.
Without a HyperFrames-credit charge the estimate is kept.
- The run's credit limit (.hyperframes/credit-limit.json) uses the same 10%
headroom rule as --max-credits for gpt-image-2.5, 2.6 and 2.6-flare,
through one shared limitCheck helper, with the same refusal wording.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* docs(media-use): say the credit limit is not a hard ceiling for GPT Image
A GPT Image call is admitted at its estimate plus 10% but charged the
vendor's cost, so it can still go past a run's credit limit. The media-use
skill, its HeyGen reference, the --max-credits help and the limit doc
strings now say so, and that a finished call's reported charge counts
toward the limit afterwards. Other models keep the "refuses what would go
past it" wording. No logic change.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(cli): hold a running GPT Image call at its headroom under the project limit
A reserved or still-running vendor-priced call was logged at its plain
estimate, so two concurrent calls could each pass the 10% headroom check
and together go over. Log the headroom amount until HeyGen reports the
charge.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(cli): templates pull unpacks under .hyperframes so a watched project can take the template
* fix(cli): templates pull's staging comment fits on one line
createSvgContactSheet built each path with path.join and then took the
label with split("/"), so on Windows the label was the whole path and
the 60-character cell limit cut the file name off. Use basename, as the
scroll and snapshot sheets in the same file already do.
* fix(cli): staging folders beside a project path no longer fail past 260 characters on Windows
mkdtemp does not get the long-path prefix that mkdir does, so every staging folder
made beside a project or output path failed once its full path passed 260 characters.
They now come from one helper, createStagingDir in @hyperframes/core/atomic-file, and a
scan test fails on a new mkdtemp beside a path.
* fix(cli): give mkdtemp the long-path form instead of replacing it
CodeQL treats mkdtemp as the safe way to make a folder under the system temp dir and
flagged every file written into a folder from the mkdir-based helper. createStagingDir
now calls mkdtemp with the long-path form of the path on Windows, so both hold.
* fix(cli): leave non-Windows paths alone when making a staging folder
The long-path form is now chosen by the shape of the path, not process.platform,
so tests that pretend to be Windows keep working and the comment share does not rise.
* fix(core): a staging folder keeps a Windows path that already names its namespace
* fix(core): a staging folder keeps a Windows device path as the caller gave it
* fix(core): the staging folder helper's comment fits the line limit
* fix(cli): no macOS developer-tools prompt from git, xcrun or cc checks on a Mac without the tools
* fix(cli): treat Xcode.app as installed tools and only take executables from PATH
* test(cli): give skills tests a developer folder so darwin cases run on any host
* fix(cli): read macOS tool paths the same way on every host
Follow-ups from review on #7443 and #7444:
- The quote hint returned the first run of words that existed, so a
"Final Cut/" folder hid "Final Cut export.mp4". It now names the longest.
- "--compare=my clip.mp4" got no hint; the value after = now starts a run.
- The telemetry section lists the skill a reverse or templates command ran
for, and the HeyGen session id a recorded reverse run carries.
* feat(cli): reverse and templates report their own runs; commands say which skills are installed
Gaps in what skill telemetry can answer for /reverse-any-video and
/style-sampling:
- The skill's beacon fires only when the agent runs it, and agents often
skip it. `reverse start` and `templates pull` now send `skill_invoked`
with `source: command`; beacons carry `source: beacon`. A person counts
once.
- style-sampling renders were never tagged. A pull marks the project the
episode is built in (only a folder that is already a project).
- Installs of an on-demand skill were invisible. `cli_command` carries
`skills_installed` and `skills_outdated`, the names from the cached
background skills check, so "never triggered" and "not installed" can
be told apart.
- `auth status` signed out exits 1 with a bare "Command failed", which
reads like a login failure. It now carries `NotSignedIn`, and an auth
error its own cause.
And a step that gets lost: a reverse started signed out often goes on
without ever trying to sign in. `reverse start` signed out now prints
`login_command` and a `next` line in the JSON the agent reads, not only
in the skill's reference.
* refactor(cli): keep comment share at the base in the reverse telemetry files
* fix(cli): command runs get their own event, counted once per piece of work
Review on the first cut: `skill_invoked` from the commands doubled the
#7176 beacon's single observation, and it fired before any work.
- `reverse start` and `templates pull` send `skill_command_ran`, not
`skill_invoked`; the beacon is back to its #7176 shape.
- `reverse start` sends it after the probe, with `signed_in` and the
reverse `session_id` that keys a retry; a video it cannot probe sends
nothing.
- `templates pull` sends it only when it downloads; a re-pull or a
refused pull sends nothing.
- A skills check that finds no install forgets the installed names.
- `auth status` failures carry only a code, never the auth error's text.
* fix(cli): measure answers the four mistakes agents make most
The usage errors agents hit most on `measure`: no op named, a path it
cannot read, and a flag it does not take. Some agents never get past
them to a successful measure.
- `measure <video>` with no op (alone or with --json) runs `probe` and
says so on stderr. With other flags the op is a guess, so the
unknown-command hint asks for one; it now names a path that does not
exist yet too.
- When ffprobe cannot read a file, the error carries ffprobe's reason and
a matching fix: a cut-short download, a page saved as .mp4, a
permission.
- An unquoted path with spaces says to quote it, both where the extra
words are rejected and where the cut path is missing.
- Window flags take --from/--to, and folder flags take -o.
* refactor(cli): keep comment share at the base in the measure files
* test(cli): expect a spaced path as the shell split it, on Windows too
* fix(cli): a cut-short MP4 says download it again, read from its header and ffprobe's specific line
* fix(cli): an unquoted spaced path reaches probe or its quote hint wherever it falls
* feat(skills): reverse-any-video and style-sampling install with the core set
A skill only triggers when it is installed. On demand these two rarely
were, so a request to copy a video or make an episode in a proven style
seldom reached them, and the entry skill named only one of them, in its
closing line.
- isCoreSkill, FALLBACK_CORE_SKILLS and the marketplace `core-skills`
entry include both, so `init` and `skills update` install them. The
`hyperframes` plugin already bundled every skill.
- `/hyperframes` routes to both from the top of its table: a video to
copy or remake, and an episode in a proven style. Its budget takes
+64 B for those two rows.
- `/reverse-any-video` triggers on "remake" and on 「复刻这个视频」
「照着做一个」, inside the 320 B description cap.
- Every catalog surface lists both in the core group: CLAUDE.md,
AGENTS.md, README, the skills guide, skill-lifecycle and the two init
templates (still byte-identical).
* refactor(cli): keep comment share at the base in skillsManifest
* feat(producer): distributed and range renders honour page motion blur
A film with data-motion-blur="on" blurs the same way however it is rendered. plan() no longer
forces the synthetic job to pageMotionBlur "off", so the plan locks screenshot capture for a
blurred film as a whole render does, and renderChunk() no longer defaults the page's off switch
to "distributed-render". An explicit pageMotionBlur "off" in the config still stands the page down.
Hosted renders pick this up after the next OSS release and a producer pin bump; a render of a
blur-on film that goes distributed changes output then.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* test(producer): the default tier blurs the same in chunks; docs agree distributed renders blur
Two files compare plan -> renderChunk -> assemble with the tier attribute removed, so `auto`
(the filter tier) decides, against a whole render: held-card and callbacks (the muted-callback
path). The skill's motion reference no longer says distributed renders are off. The rewritten
R19 plan test gets 60 s for its three plan() calls.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
CLAUDE_CODE_ENTRYPOINT is set by current Claude Code versions too, and it
is the only Claude marker MCP servers inherit, so it is not an
"older versions" fallback. The Agent SDK comment still said Claude Code's
shell tool sets CLAUDECODE; the rule keys on CLAUDE_CODE_CHILD_SESSION.
Follow-up to review nits on #7425. Comments only.
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* feat(cli): add agent markers other detectors use, verified upstream
Compared std-env, @vercel/detect-agent, am-i-vibing and agent-cli-detector
against our rules and kept only markers the agent itself sets on the
shells it spawns: Auggie AUGMENT_AGENT, Amp AMP_CURRENT_THREAD_ID, Cursor
CURSOR_CONVERSATION_ID and CURSOR_SANDBOX, Cline CLI CLINE_WRAPPER_PATH,
Muse MUSE_RELEASE_INFO, and Warp Oz OZ_RUN_ID (after the harnesses it
wraps).
Claude Code now keys on CLAUDE_CODE_CHILD_SESSION or
CLAUDE_CODE_ENTRYPOINT. Its IDE extensions also set CLAUDECODE in the
integrated terminal a person types into, so CLAUDECODE alone counted that
person as an agent: no prompts, agent-mode login.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* docs(cli): trim comments and fix citations the comment gates flag
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* chore: raise the cli packed size budget to its measured size
main already sat at the edge of the 1% tolerance; the new agent rules
put the packed CLI 842 bytes past it (8062664 vs 7982002 + 1%).
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
TERM_PROGRAM=cursor|windsurf and Replit's REPL_ID only say where a shell
runs. They now sit in their own list, checked after the AI_AGENT / AGENT
name check, so Amp in a Cursor terminal or Devin in Replit report as
themselves, and an unknown AI_AGENT there keeps its discovery hints.
agentOnly had no users left, so it is gone.
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* feat(cli): detect more agent runtimes in telemetry
Agent runtime rules:
- copilot_agent: key on COPILOT_AGENT=1 or AI_AGENT=github_copilot_*
(VS Code agent terminals) instead of the unverified Actions markers.
- copilot_cli: COPILOT_CLI=1 or COPILOT_AGENT_SESSION_ID, ahead of
copilot_agent.
- kilo (KILO=1, KILOCODE_VERSION), ahead of opencode.
- opencode (OPENCODE=1, OPENCODE_SESSION_ID).
- qwen_code (QWEN_CODE=1), junie (JUNIE_SHIM_PATH),
antigravity (ANTIGRAVITY_AGENT), qoder (QODER_AGENT),
kiro (AGENT_DISPLAY_OUT, AGENT_CONTEXT_OUT), openhands (AI_AGENT=openhands).
- AI_AGENT fallback after every vendor rule: known names map to their
runtime, any other slug-safe name becomes other_ai_agent. Bare AGENT
is not used.
Discovery hints: other_ai_agent keeps its hints, agent_hint prefers
AI_AGENT over AGENT, and AGENT_TOOLSDIRECTORY,
GSM_SKIP_SSH_AGENT_WORKAROUND and EDGE_METRICS_SESSION_ID are no
longer hint keys.
CI: name AWS CodeBuild (CODEBUILD_BUILD_ID) as codebuild.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* feat(cli): detect agents seen in discovery hints
Add rules for closed-source agents whose markers show up in the CLI's
own agent_env_hints on non-interactive runs: WorkBuddy, CodeBuddy, Trae,
Pippit, Doubao, Aily, Grok, Kimi, ZCode, SWE-agent and apps built on the
Claude Agent SDK. Qoder also matches its CLI and agent SDK keys.
The AI_AGENT name map now covers the names agents report (Devin, Amp,
v0, Rovo Dev, Base44, Trae, Antigravity, OpenHands, Copilot, and
hermes-agent), and a known name in the bare AGENT variable counts too.
Unknown AGENT values such as AGENT=1 still do not.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* feat(cli): detect the DeepSeek harness
Every dsh model shell call runs with DSH_SHELL=1 and the agent's
DSH_SESSION_ID. HyperFrames Desktop also runs dsh; its runs carry
HYPERFRAMES_CLIENT, so the client field separates the two.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* docs(cli): cite the Agent SDK source for claude_agent_sdk
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* fix(cli): let the closest agent win over inherited markers
Copilot's COPILOT_AGENT / AI_AGENT and COPILOT_CLI pass down to the
agents it starts, and TERM_PROGRAM / REPL_ID only say where a shell runs.
Those rules now come after every other agent rule, so opencode or Qwen
started by Copilot, or Kilo in a Cursor terminal, report as themselves.
dsh keys on DSH_SHELL=1 only: it sets DSH_SESSION_ID on the terminal a
person types into too. Qoder drops its app-wide SDK and setting keys,
CodeBuddy drops CODEBUDDY_AGENT_RUNTIME (a setting it reads), and Kiro's
markers must be non-empty.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* feat(cli): add 1440p resolution presets to --resolution
Adds landscape-1440p (2560x1440), portrait-1440p (1440x2560) and
square-1440p (1440x1440) next to the existing 4K, 720p and 480p tiers,
with the aliases 1440p, 2k and qhd plus 1440p-portrait and 1440p-square.
1440p joins the aspect-agnostic aliases, like 720p and 480p.
Every validator derives from CANVAS_DIMENSIONS, so no logic changes: a 4K
composition renders down to 1440p through the existing smaller-preset
path, and a 1280x720 composition supersamples to 1440p at an exact 2x.
A 1920x1080 composition is still refused by the non-integer-scale check
(4/3); fractional scale factors are not part of this change.
Refs #6309
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* fix(cli): clarify 1440p aliases and repair skill validation
---------
Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-authored-by: James <james.russo@heygen.com>
* fix(cli): cloud render finds media whose file name is stored in another Unicode form than the page's
* fix(cli): keep the archive-key change from raising publishProject's comment share
* fix(cli): a page that names a decomposed file as the disk lists it still matches its archive entry
* feat(cli): check returns an unchanged project's last pass in about a second
* fix(cli): the check cache hashes files without a stat race and its tests run before the signal test
* test(cli): the warm check test compares two real runs, not a run and its cached pass
* feat(cli): check --no-craft skips the craft pass for a render preflight
* fix(cli): the check cache keys on timeout, env and large files and never replays a moved tree
* style(cli): format the check cache
* fix(cli): the large-file cache test waits for the clock tick it depends on
* fix(cli): the check cache keys on the browser and on scripts under .hyperframes
* fix(cli): the check cache ignores the video copies the check itself touches
* fix(cli): a media file referenced by its filesystem path goes into the cloud archive
* fix(cli): an absolute media path keeps its fragment and query, and the resolver is split
* fix(cli): a Windows drive-letter media path is a filesystem path too
* fix(check): lint and check skip compositions the project never mounts
* refactor(lint): let two new names stand without doc comments
* test(cli): lint tests that lint unmounted files say so
* refactor(cli): the cloud upload's PUT and retry code moves to its own file
* feat(cli): cloud uploads send a big file in parts, so a cut connection resends one part
* test(cli): the cutting link fails a single PUT of the same file
* fix(cli): a file the cloud refuses forgets its saved parts plan
* fix(cli): a resumed upload goes straight to its parts, so a saved plan never feeds the single PUT
* fix(cli): a re-encode of a media file over the cap is limited to fit it
* fix(cli): satisfy the typecheck and the comment and complexity gates for the re-encode limit
* fix(cli): the re-encode limit applies to every video, not only a source over the cap
* fix(cli): transcribe names why whisper is missing and the one line that fixes it
* fix(cli): a Windows box gets a runnable install line and finds the whisper it just built
* fix(check): masked or clipped-away text no longer counts as overlapping
* test(check): name the masked-overlap fixture's headings in plain words
* test(check): word a gradient-stop comment without an acronym
* fix(check): a moved or content-box mask keeps today's overlap verdict
The desktop app can't run an edit while a preview of the project is
running, because the preview holds the project's history lock. Following
the hint that `preview --background` prints therefore left the app's edit
waiting until someone stopped the preview by hand.
`hyperframes open` now stops a background preview of the same project
before handing it to the app, and prints one line saying so. It only
stops a preview it can prove it started (a saved session whose wrapper
process still owns the server). Any other preview is left running, and
`open` prints the exact `preview --stop --port N` command instead. With
--json the result carries a `preview` field.
The hint that `preview` prints now says that `open` stops a background
preview, or that a foreground one must be stopped first. The project
template and the CLI skill's preview reference say the same.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(check): a Chrome that never becomes ready ends the check with a named error
* fix(check): name the Chrome start window in code instead of comments
* fix(cli): wait for the cloud's file check as long as the file's size allows before giving up
* style(cli): format the complete-wait test
* fix(cli): keep the complete-wait settings private to the upload module
* refactor(cli): split the upload retry decision and the test drain to keep complexity down
* test(cli): drain the slow upload test server at a fixed rate whatever the chunk size
* fix(cli): two cuts at the same age are the same cut whatever bytes each got through
* fix(cli): sample upload progress on its own interval so a short try still reports its bytes
* style(cli): format the cloud upload files
* fix(cli): cloud render zip carries files the composition references under dot-folders
* fix(cli): a missing link href no longer fails the cloud zip; media refs still do
* chore(cli): shorten the referenced-file comment
* fix(cli): only a missing video, audio, img src or poster stops the cloud zip
* fix(cli): a stylesheet url() never stops the cloud zip; only the no-fallback media refs do
* feat(check): every check step prints a line on stderr and repeats it every 30 s while it runs long
* feat(check): name the saved report file on stderr and tell agents not to use npm run
* fix(check): print a step's line once when the step starts, not on every progress ping
* style(check): wrap two long lines for oxfmt
* fix(check): say the report file is written unless a not-recorded warning follows
* chore(skills): refresh the skills manifest hash for the check doc line
* fix(check): keep the start line free of the not-recorded warning text
* fix(cli): a cloud upload cut at a fixed age stops after two identical cuts and shows its progress
* test(cli): size the upload tests so the kernel cannot buffer the whole file
* test(cli): keep the upload test server quiet when the client drops the connection
* test(cli): shorten the upload test server comment
* fix(check): count a Korean number and its counter as one word in line reading time
* fix(check): keep segmenting Thai, Lao, Khmer and Burmese when counting reading words
* feat(cli): audio --read --layer music|sfx|voice reads a one-layer file whole
A caller that knows a file holds a single layer can declare it: the file is
read whole as that layer with no stem separation and nothing uploaded.
Without the flag the read is unchanged. An unknown layer is rejected.
Consumer: heygen-com/experiment-framework#66322. Proposal OK'd by Rory
(C0BEH487Q7R, 2026-11-07).
Co-Authored-By: Jerrai
* chore(cli): drop added comments from audio read layer
Co-Authored-By: Jerrai
* fix(cli): price GPT Image 2.6 and every GPT Image reference picture
The media-use image estimate priced every non-default model as GPT Image 2.5 and
charged references at $0.0082 after the first. fal bills every reference picture,
the first one too, at about $0.0125, and the price book now does the same. GPT
Image 2.6 and 2.6-flare take 2.5's prices; nano-banana-2.1 gets its own; any
other model is not priced ahead instead of guessed.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* chore(cli): drop the new pricing comments to keep the comment share flat
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
* feat(cli): the sign-in page the browser lands on follows the design
* style(cli): format the sign-in page files
* fix(cli): the sign-in page picks Cancel or failure inside the page builder, and drops unused code
* fix(producer): a failure before the first frame reports frame capture as its stage
* fix(producer): a failure after the effect scan reports frame capture, with a stable code
* fix(engine): a render no longer finishes without an image that loaded late
* style(engine): format the frame gate
* fix(engine): an image outside the frame no longer stops a render
* fix(engine): a render stops and warns when a frame's image never arrives, with no cloud retries
* fix(producer): a cloud chunk keeps the missing image's error name so retries stop
* feat(studio): show the agent's storyboard in a Storyboard tab beside the preview
The board an agent writes per the storyboard recipe (boards/storyboard.html,
or a root storyboard.html) now shows in Studio the way HyperFrames Desktop
shows it: a Preview | Storyboard strip over the preview panel, only while the
project has a board. Studio reads the page's class="frame" boxes into a board
of stills, with acts, titles, times and words, and one frame at a time with
arrow keys. A page with no frames shows as written in a script-less iframe.
A board written while Studio is open brings its tab to the front, as Desktop
does at the agent's stop. A rewrite of the page, a still beside it or
STORYBOARD.md reloads it in place, and a dot marks a rewrite seen from the
preview. "Show in preview" goes back to the film at the frame's start.
Notes, drawings and the go belong to Desktop's agent, so the board's bar
carries the desktop-app button. Its funnel events now say which button was
pressed (placement: header or storyboard).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* refactor(studio): split the storyboard view and its frame reader into smaller parts
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* docs(skills): the agent's storyboard stop points at the Storyboard tab, not the file
With the board shown beside the preview in Studio as in Desktop, the recipe's
stop and style-sampling's stop 1 tell the person to look in the Storyboard
tab, and to start a preview and give its link when none is running, instead
of handing over boards/storyboard.html to open from disk.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* fix(studio): the storyboard listens on Studio's own file-change channel, and its notes are trimmed
The board opened its own /api/events stream, which the Vite dev server
behind the runtime smoke does not serve. It now subscribes through
subscribeFileChanges, the one channel picker the external-change
coordinator already uses (test adapter, Vite HMR, then SSE), so dev and
built Studio deliver the same changes to both.
The new files' comments are cut to the package's share, and the recipe's
Storyboard-tab line moves to the paragraph that names the board, leaving
the stop step as it was.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* fix(studio): the board hears file changes through the coordinator, not a second subscription
The external-change coordinator stays the one subscriber to the file-change
transport (HMR in dev, SSE when built), as externalFileChangeOwnership
asserts. It announces each decoded change through fileChangeFanout, and the
storyboard listens there. Mounting EditorShell alone, as its tests do, no
longer opens an EventSource, and the coordinator file stays under the line cap.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* feat(studio): the storyboard's Open in desktop app asks the app to open on the board, and its card says why
- The storyboard bar's button posts `doc: "storyboard"` with its page id. The preview server passes only that value
on, and `openInDesktop` writes it into `.hyperframes/desktop-cta.json` beside the page id, so the app can open the
project on its Storyboard tab with Build in sight (hyperframes-internal reads it).
- The guide card opened from the storyboard says "Approve this storyboard in the desktop app" and "Comment on a frame,
draw on it, then press Build", and its last step says the app opens on this storyboard. The header's card is
unchanged.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* feat(studio): approve the storyboard in Studio; comments on frames stay in the desktop app
A Studio user without the desktop app had no way to approve the board from the tab, and the bar said approval was
in the desktop app, so the tab read as a dead end. Studio talks to the person's own agent through their chat, so the
bar's Approve copies "The storyboard is approved. Build the video from it." for them to paste to it, and says so in
a toast (or spells the words out when the clipboard refuses). Commenting and drawing on frames stay in the desktop
app. The storyboard recipe tells the agent those pasted words are the person's go.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* fix(studio): the storyboard's desktop card offers commenting, since approving now happens in Studio
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* fix(studio): hand-off intent before dispatch, steady film under the board, stills outside the board folder
- openInDesktop writes desktop-cta.json before sending the folder, so a running
app reads the storyboard ask on arrival; a plain or header open drops an
earlier storyboard ask; a failed open puts the earlier record back.
- PreviewStage keeps the film at one place in the tree with or without a board,
so a board appearing never remounts it; the automatic switch goes through the
same pause as a click, and a play while the board is up is paused.
- The board reloads when a still it draws changes, including a root board's
stills/ and a boards/ page's ../assets.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* chore(cli): fit the Storyboard tab in the CLI's size budget; reword a record helper's doc
The CLI tarball carries Studio's build, which now holds the Storyboard tab; merged
with main it measures 7,982,002 bytes packed, 7 bytes past the 1% tolerance.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* fix(studio): hold the player while the storyboard covers the film
A pause after the fact let J's reverse loop schedule its next frame, so the
hidden film kept seeking. The stage now takes the player's own hold while the
board is up (and only when no one else holds it), so J, Space and playback
requests are refused before they start; Preview releases it.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* feat(core): motion blur reports what a composition holds, as counts
The runtime scans a composition once per blur scan, on both tiers, and reports
counts of what it holds (canvases, video, frames, custom elements, clips, masks,
scroll containers, 3D, blend modes, and movers that overflow, sit under other
content, hold fixed children or carry pseudo-elements outside their box), plus
whether pose reads need callbacks. Counts only: no ids, classes, text or URLs.
The engine puts the non-zero counts on its [motion-blur] line and hands the
parsed report to the perf summary; the producer aggregates workers (first report
wins, failed frames sum) and the CLI sends motion_blur_* properties on
render_complete, from the CLI and from Studio renders.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* fix(cli): disclose blur counts in telemetry docs, raise inspector budget
The runtime fingerprint code is bundled into @hyperframes/inspector, which
puts its unpacked size 2.2 KB past the 1% tolerance. The telemetry docs now
list the composition counts the CLI sends with a blur render.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
* feat(cli): check_report counts the browser-playable copies a check waited for
* style(cli): shorten the copy facts comment under the line limit
* fix(cli): a check stopped by the copy wait stays browserSkipped; count only abort-caused unfinished
* style(cli): format the copy facts tests
* fix(templates): pin the five style-sampling packs with the release-check fixes
New bundles for all five creator templates:
- science-explainer: the end card shows over the last section (assemble.py isolates
every mounted clip), instead of being hidden in every film.
- collage, 3d-brand, 3d-true-crime: add_sound.py runs on ffmpeg 4.2 and says what
failed instead of raising an AttributeError.
- all five: a voice clone is the one the person names as theirs; `media-use voices`
lists the whole workspace's clones and is never picked from by count or language.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
* fix(templates): re-pin the science pack so a Desktop voice tag is a pick, not consent
The science pack took Desktop's `[voice: your HeyGen voice ...]` tag as
settled and asked nothing. Desktop's own-voice picker lists every clone the
workspace can use, so the tag only records which voice was picked. The new
M9003 bundle uses a picked, named or id-given clone only when the person
says it is theirs or that its owner agreed, and asks once otherwise. The
other four packs are unchanged.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HebQXPiLcYKQfvPWB3Fgxy
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>