mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-19 11:26:02 +00:00
A run stopped on a question now shows what it is being asked and the agent's own options, one button each; clicking one sends that option's id and the run carries on. The element says so too, in amber and still, where every working state moves: a run that has stopped must not look like one getting on with it. Being waited on leads the tray's headline and outranks working in the canvas badge, because it is the only state the reader can do something about. Three files had to come apart first, all of them over the editor's 600-line cap and so uncommittable as they stood: - the canvas connector moves out of InlineAgentComposer into its own file, and the composer's geometry joins the layout module that already owned the rest of it (813 -> 551) - the queue's mutations move out of useAskAgentModal into useAgentQueue, which is where answering belongs (653 -> 598) - useDomEditSession listed all 34 agent fields twice, once to destructure and once to return; it spreads them instead (604 -> 540) Polling also treated a parked run as idle, so an answer took up to eight seconds to look like it had landed.
@hyperframes/studio
Browser-based composition editor UI for Hyperframes. Provides a visual timeline, code editor, and live preview for building video compositions.
Install
npm install @hyperframes/studio
What it does
The studio is a React application with:
- Visual timeline — drag, resize, and arrange elements on tracks
- Code editor — edit HTML and GSAP scripts with CodeMirror (syntax highlighting, autocomplete)
- Live preview — see changes in real time as you edit
- Composition inspector — view and modify element properties
Development
The studio is embedded in the hyperframes preview command. To develop the studio UI itself:
cd packages/studio
bun run dev # Start Vite dev server
bun run build # Build for production
bun run typecheck # Type-check
Tech stack
- React 18/19, Zustand (state management)
- CodeMirror 6 (editor)
- Tailwind CSS (styling)
- Vite (bundler)
- Phosphor Icons
Documentation
Full documentation: hyperframes.heygen.com/packages/studio
Related packages
@hyperframes/core— types and parsers used by the editorhyperframes— CLI that serves the studio viahyperframes preview