@vibeframe/cli 0.52.1 → 0.53.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VibeFrame Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/agent/tools/index.d.ts

@@ -58,6 +58,7 @@ export { registerMediaTools } from "./media.js";
 export { registerAITools } from "./ai.js";
 export { registerExportTools } from "./export.js";
 export { registerBatchTools } from "./batch.js";
+export { registerSceneTools } from "./scene.js";
 /**
  * Register all tools
  */

package/dist/agent/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,YAAY,KAClB,OAAO,CAAC,UAAU,CAAC,CAAC;AAOzB;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0C;IAEvD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIhE;;OAEG;IACH,cAAc,IAAI,cAAc,EAAE;IAIlC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIvD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,UAAU,CAAC;IAwBtB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;CAGjB;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,YAAY,KAClB,OAAO,CAAC,UAAU,CAAC,CAAC;AAOzB;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0C;IAEvD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIhE;;OAEG;IACH,cAAc,IAAI,cAAc,EAAE;IAIlC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIvD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,UAAU,CAAC;IAwBtB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;CAGjB;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5E"}

package/dist/agent/tools/index.js

@@ -98,6 +98,7 @@ export { registerMediaTools } from "./media.js";
 export { registerAITools } from "./ai.js";
 export { registerExportTools } from "./export.js";
 export { registerBatchTools } from "./batch.js";
+export { registerSceneTools } from "./scene.js";
 /**
  * Register all tools
  */
@@ -109,6 +110,7 @@ export async function registerAllTools(registry) {
     const { registerAITools } = await import("./ai.js");
     const { registerExportTools } = await import("./export.js");
     const { registerBatchTools } = await import("./batch.js");
+    const { registerSceneTools } = await import("./scene.js");
     registerProjectTools(registry);
     registerTimelineTools(registry);
     registerFilesystemTools(registry);
@@ -116,5 +118,6 @@ export async function registerAllTools(registry) {
     registerAITools(registry);
     registerExportTools(registry);
     registerBatchTools(registry);
+    registerSceneTools(registry);
 }
 //# sourceMappingURL=index.js.map

package/dist/agent/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,UAA0B,EAAE,OAAoB;QACvD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,IAA6B,EAC7B,OAAqB;QAErB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,UAAU,EAAE,EAAE;gBACd,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,iBAAiB,IAAI,EAAE;aAC/B,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO;gBACL,UAAU,EAAE,EAAE;gBACd,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,YAAY;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;CACF;AAED,2BAA2B;AAC3B,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;AAE/C,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAsB;IAC3D,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;IAC9D,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAChE,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACpE,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1D,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC5D,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAE1D,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAChC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC7B,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC1B,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9B,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/agent/tools/scene.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module scene
+ * @description Agent tools for the per-scene HTML authoring surface
+ * (`vibe scene init/add/lint/render`). Each tool wraps the corresponding
+ * `executeXxx` from `commands/scene.ts` (or `_shared/scene-*.ts`) so the LLM
+ * agent can author and ship Hyperframes-style scene projects in natural
+ * language. Mirrored as MCP tools in `packages/mcp-server/src/tools/scene.ts`.
+ *
+ * ## Tools: scene_init, scene_add, scene_lint, scene_render
+ * ## Cost tier: Low (image+TTS for `scene_add` if narration/visuals supplied,
+ *                   otherwise free; `scene_render` is local Chrome/FFmpeg).
+ */
+import type { ToolRegistry } from "./index.js";
+import type { ToolDefinition } from "../types.js";
+export declare function registerSceneTools(registry: ToolRegistry): void;
+export declare const sceneToolDefinitions: ReadonlyArray<ToolDefinition>;
+//# sourceMappingURL=scene.d.ts.map

package/dist/agent/tools/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AA6Q9D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAK/D;AAID,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,cAAc,CAK9D,CAAC"}

package/dist/agent/tools/scene.js

@@ -0,0 +1,263 @@
+/**
+ * @module scene
+ * @description Agent tools for the per-scene HTML authoring surface
+ * (`vibe scene init/add/lint/render`). Each tool wraps the corresponding
+ * `executeXxx` from `commands/scene.ts` (or `_shared/scene-*.ts`) so the LLM
+ * agent can author and ship Hyperframes-style scene projects in natural
+ * language. Mirrored as MCP tools in `packages/mcp-server/src/tools/scene.ts`.
+ *
+ * ## Tools: scene_init, scene_add, scene_lint, scene_render
+ * ## Cost tier: Low (image+TTS for `scene_add` if narration/visuals supplied,
+ *                   otherwise free; `scene_render` is local Chrome/FFmpeg).
+ */
+import { resolve, relative } from "node:path";
+import { scaffoldSceneProject, } from "../../commands/_shared/scene-project.js";
+import { executeSceneAdd, } from "../../commands/scene.js";
+import { runProjectLint, } from "../../commands/_shared/scene-lint.js";
+import { executeSceneRender, } from "../../commands/_shared/scene-render.js";
+const SCENE_PRESETS = [
+    "simple",
+    "announcement",
+    "explainer",
+    "kinetic-type",
+    "product-shot",
+];
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+const sceneInitDef = {
+    name: "scene_init",
+    description: "Scaffold a new bilingual VibeFrame + Hyperframes scene project. Creates index.html, hyperframes.json, vibe.project.yaml, compositions/, assets/, .gitignore, and a project-local CLAUDE.md. Idempotent: safe to run on a directory that already has hyperframes.json (the config is merged, not overwritten). No API keys required.",
+    parameters: {
+        type: "object",
+        properties: {
+            dir: { type: "string", description: "Project directory (created if missing). Relative paths resolve against the agent's working directory." },
+            name: { type: "string", description: "Project name. Defaults to the directory basename." },
+            aspect: { type: "string", description: "Aspect ratio for the canvas. Default 16:9.", enum: ["16:9", "9:16", "1:1", "4:5"] },
+            duration: { type: "number", description: "Default root composition duration in seconds. Default 10." },
+        },
+        required: ["dir"],
+    },
+};
+const sceneAddDef = {
+    name: "scene_add",
+    description: "Add a single scene to an existing scene project. Optionally generates narration audio (ElevenLabs) and/or a backdrop image (Gemini/OpenAI), then emits compositions/scene-<id>.html with a paused GSAP timeline and splices a clip reference into the root index.html. Use `skipAudio: true` and `skipImage: true` for text-only scenes that need no API calls.",
+    parameters: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: "Scene name. Slugified into the composition id (e.g. 'My Intro' → 'my-intro')." },
+            preset: { type: "string", description: `Style preset for the scene HTML. Default 'simple'.`, enum: [...SCENE_PRESETS] },
+            narration: { type: "string", description: "Narration text. If the value is a path to an existing .txt/.md file, its contents are used. Drives TTS + scene duration." },
+            duration: { type: "number", description: "Explicit scene duration in seconds. Overrides narration audio duration." },
+            visuals: { type: "string", description: "Image prompt — generates assets/scene-<id>.png via the configured image provider." },
+            headline: { type: "string", description: "Visible headline text. Defaults to the humanised scene name." },
+            kicker: { type: "string", description: "Small label above the headline (used by 'explainer' and 'product-shot' presets)." },
+            projectDir: { type: "string", description: "Project directory. Defaults to the agent's working directory." },
+            insertInto: { type: "string", description: "Root composition file (relative to projectDir). Default 'index.html'." },
+            imageProvider: { type: "string", description: "Image provider for --visuals. Default 'gemini'.", enum: ["gemini", "openai"] },
+            voice: { type: "string", description: "ElevenLabs voice id or name." },
+            skipAudio: { type: "boolean", description: "Skip TTS even if narration is provided. Useful for offline / agent dry runs." },
+            skipImage: { type: "boolean", description: "Skip image generation even if visuals is provided." },
+            force: { type: "boolean", description: "Overwrite an existing compositions/scene-<id>.html." },
+        },
+        required: ["name"],
+    },
+};
+const sceneLintDef = {
+    name: "scene_lint",
+    description: "Validate every scene file in a project against the public Hyperframes lint rules (in-process, no Chrome required). Returns errors, warnings, and info findings per file. Optional `fix: true` mechanically repairs `timed_element_missing_clip_class` only — other issues surface with fixHints for the agent to apply.",
+    parameters: {
+        type: "object",
+        properties: {
+            projectDir: { type: "string", description: "Project directory. Defaults to the agent's working directory." },
+            root: { type: "string", description: "Root composition file relative to projectDir. Default 'index.html'." },
+            fix: { type: "boolean", description: "Apply mechanical auto-fixes (currently: missing class=\"clip\")." },
+        },
+        required: [],
+    },
+};
+const sceneRenderDef = {
+    name: "scene_render",
+    description: "Render a scene project to MP4/WebM/MOV via the Hyperframes producer. Requires Chrome installed locally. Output defaults to renders/<projectName>-<isoStamp>.<format>. Costly only in CPU/GPU (no API keys).",
+    parameters: {
+        type: "object",
+        properties: {
+            projectDir: { type: "string", description: "Project directory. Defaults to the agent's working directory." },
+            root: { type: "string", description: "Root composition file relative to projectDir. Default 'index.html'." },
+            output: { type: "string", description: "Output file path (relative paths resolve against projectDir)." },
+            fps: { type: "number", description: "Frames per second. Must be 24, 30, or 60. Default 30." },
+            quality: { type: "string", description: "Quality preset. Default 'standard'.", enum: ["draft", "standard", "high"] },
+            format: { type: "string", description: "Container format. Default 'mp4'.", enum: ["mp4", "webm", "mov"] },
+            workers: { type: "number", description: "Capture worker count (1-16). Default 1." },
+        },
+        required: [],
+    },
+};
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+const sceneInitHandler = async (args, context) => {
+    const dir = resolve(context.workingDirectory, args.dir);
+    try {
+        const result = await scaffoldSceneProject({
+            dir,
+            name: args.name,
+            aspect: args.aspect,
+            duration: args.duration,
+        });
+        const lines = [
+            `✅ Scene project scaffolded at ${relative(context.workingDirectory, dir) || dir}`,
+            `   created: ${result.created.length} file(s)`,
+            `   merged:  ${result.merged.length} file(s)`,
+            `   skipped: ${result.skipped.length} file(s) (already existed)`,
+            ``,
+            `Next: scene_add { name: "intro", preset: "announcement", headline: "..." }`,
+        ];
+        return { toolCallId: "", success: true, output: lines.join("\n") };
+    }
+    catch (error) {
+        return {
+            toolCallId: "",
+            success: false,
+            output: "",
+            error: `scene_init failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+};
+const sceneAddHandler = async (args, context) => {
+    const projectDir = args.projectDir
+        ? resolve(context.workingDirectory, args.projectDir)
+        : context.workingDirectory;
+    const result = await executeSceneAdd({
+        name: args.name,
+        preset: args.preset ?? "simple",
+        narration: args.narration,
+        duration: args.duration,
+        visuals: args.visuals,
+        headline: args.headline,
+        kicker: args.kicker,
+        projectDir,
+        insertInto: args.insertInto,
+        imageProvider: args.imageProvider,
+        voice: args.voice,
+        skipAudio: args.skipAudio,
+        skipImage: args.skipImage,
+        force: args.force,
+    });
+    if (!result.success) {
+        return {
+            toolCallId: "",
+            success: false,
+            output: "",
+            error: result.error ?? "scene_add failed",
+        };
+    }
+    const lines = [
+        `✅ Added scene "${result.id}" (preset=${result.preset})`,
+        `   start:    ${result.start.toFixed(2)}s`,
+        `   duration: ${result.duration.toFixed(2)}s`,
+        `   scene:    ${result.scenePath}`,
+        `   root:     ${result.rootPath}`,
+    ];
+    if (result.audioPath)
+        lines.push(`   audio:    ${result.audioPath}`);
+    if (result.imagePath)
+        lines.push(`   image:    ${result.imagePath}`);
+    return { toolCallId: "", success: true, output: lines.join("\n") };
+};
+function summariseLint(result) {
+    const lines = [
+        `${result.ok ? "✅" : "❌"} Lint ${result.ok ? "clean" : "failed"} — ` +
+            `${result.errorCount} error(s), ${result.warningCount} warning(s), ${result.infoCount} info`,
+    ];
+    for (const file of result.files) {
+        if (file.findings.length === 0)
+            continue;
+        lines.push(``, `${file.file}`);
+        for (const f of file.findings) {
+            lines.push(`  [${f.severity}] ${f.code} — ${f.message}`);
+            if (f.fixHint)
+                lines.push(`     → ${f.fixHint}`);
+        }
+    }
+    if (result.fixed.length > 0) {
+        lines.push(``, `Auto-fixed:`);
+        for (const fx of result.fixed) {
+            lines.push(`  ${fx.file}: ${fx.codes.join(", ")}`);
+        }
+    }
+    return lines;
+}
+const sceneLintHandler = async (args, context) => {
+    const projectDir = args.projectDir
+        ? resolve(context.workingDirectory, args.projectDir)
+        : context.workingDirectory;
+    try {
+        const result = await runProjectLint({
+            projectDir,
+            rootRel: args.root,
+            fix: args.fix,
+        });
+        return {
+            toolCallId: "",
+            success: result.ok,
+            output: summariseLint(result).join("\n"),
+            error: result.ok ? undefined : `${result.errorCount} lint error(s)`,
+        };
+    }
+    catch (error) {
+        return {
+            toolCallId: "",
+            success: false,
+            output: "",
+            error: `scene_lint failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+};
+const sceneRenderHandler = async (args, context) => {
+    const projectDir = args.projectDir
+        ? resolve(context.workingDirectory, args.projectDir)
+        : context.workingDirectory;
+    const result = await executeSceneRender({
+        projectDir,
+        root: args.root,
+        output: args.output,
+        fps: args.fps,
+        quality: args.quality,
+        format: args.format,
+        workers: args.workers,
+    });
+    if (!result.success) {
+        return {
+            toolCallId: "",
+            success: false,
+            output: "",
+            error: result.error ?? "scene_render failed",
+        };
+    }
+    const lines = [
+        `✅ Render complete: ${result.outputPath}`,
+        `   duration: ${(((result.durationMs ?? 0) / 1000)).toFixed(1)}s`,
+        `   frames:   ${result.framesRendered ?? "?"}${result.totalFrames ? ` / ${result.totalFrames}` : ""}`,
+        `   config:   ${result.fps}fps · ${result.quality} · ${result.format}`,
+    ];
+    return { toolCallId: "", success: true, output: lines.join("\n") };
+};
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerSceneTools(registry) {
+    registry.register(sceneInitDef, sceneInitHandler);
+    registry.register(sceneAddDef, sceneAddHandler);
+    registry.register(sceneLintDef, sceneLintHandler);
+    registry.register(sceneRenderDef, sceneRenderHandler);
+}
+// Exported for tests so the same defs can be inspected without instantiating
+// a registry.
+export const sceneToolDefinitions = [
+    sceneInitDef,
+    sceneAddDef,
+    sceneLintDef,
+    sceneRenderDef,
+];
+//# sourceMappingURL=scene.js.map

package/dist/agent/tools/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../../../src/agent/tools/scene.ts"],"names":[],"mappings":"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"}

package/dist/agent/tools/scene.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scene.test.d.ts.map

package/dist/agent/tools/scene.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.test.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/scene.test.ts"],"names":[],"mappings":""}

package/dist/agent/tools/scene.test.js

@@ -0,0 +1,139 @@
+import { describe, expect, it, beforeEach } from "vitest";
+import { mkdtemp, readFile, access } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { ToolRegistry } from "./index.js";
+import { registerSceneTools, sceneToolDefinitions } from "./scene.js";
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function makeTmp(label = "vibe-scene-agent-") {
+    return mkdtemp(join(tmpdir(), label));
+}
+function ctx(workingDirectory) {
+    return { projectPath: null, workingDirectory };
+}
+let registry;
+beforeEach(() => {
+    registry = new ToolRegistry();
+    registerSceneTools(registry);
+});
+describe("scene agent tools — registration + schema", () => {
+    it("registers exactly four scene_* tools", () => {
+        const names = registry.getDefinitions().map((t) => t.name).filter((n) => n.startsWith("scene_")).sort();
+        expect(names).toEqual(["scene_add", "scene_init", "scene_lint", "scene_render"]);
+    });
+    it("exports definitions matching the registered set (parity with sceneToolDefinitions)", () => {
+        const exported = sceneToolDefinitions.map((d) => d.name).sort();
+        const registered = registry.getDefinitions().map((t) => t.name).sort();
+        expect(exported).toEqual(registered);
+    });
+    it.each(sceneToolDefinitions.map((d) => [d.name, d]))("%s has well-formed JSON-schema-ish parameters", (name, def) => {
+        expect(def.name).toBe(name);
+        expect(def.description.length).toBeGreaterThan(20);
+        expect(def.parameters.type).toBe("object");
+        expect(def.parameters.properties).toBeTypeOf("object");
+        expect(Array.isArray(def.parameters.required)).toBe(true);
+        // Every property has a string description.
+        for (const [key, prop] of Object.entries(def.parameters.properties)) {
+            expect(prop.description, `${name}.${key} missing description`).toBeTruthy();
+            expect(["string", "number", "boolean", "array", "object"]).toContain(prop.type);
+        }
+        // Every required arg is actually declared.
+        for (const req of def.parameters.required) {
+            expect(def.parameters.properties).toHaveProperty(req);
+        }
+    });
+    it("scene_init requires only `dir`; scene_add requires only `name`; lint+render are arg-free", () => {
+        const byName = Object.fromEntries(sceneToolDefinitions.map((d) => [d.name, d]));
+        expect(byName.scene_init.parameters.required).toEqual(["dir"]);
+        expect(byName.scene_add.parameters.required).toEqual(["name"]);
+        expect(byName.scene_lint.parameters.required).toEqual([]);
+        expect(byName.scene_render.parameters.required).toEqual([]);
+    });
+});
+describe("scene_init handler", () => {
+    it("scaffolds a project relative to the agent's working directory", async () => {
+        const cwd = await makeTmp();
+        const handler = registry.getHandler("scene_init");
+        const result = await handler({ dir: "promo", aspect: "9:16", duration: 8 }, ctx(cwd));
+        expect(result.success).toBe(true);
+        expect(result.output).toContain("Scene project scaffolded at promo");
+        expect(await pathExists(resolve(cwd, "promo/index.html"))).toBe(true);
+        expect(await pathExists(resolve(cwd, "promo/vibe.project.yaml"))).toBe(true);
+        expect(await pathExists(resolve(cwd, "promo/compositions"))).toBe(true);
+    });
+});
+describe("scene_add handler — offline path", () => {
+    it("adds a scene with skipAudio + skipImage and reports the new clip start/duration", async () => {
+        const cwd = await makeTmp();
+        await registry.getHandler("scene_init")({ dir: ".", aspect: "16:9", duration: 6 }, ctx(cwd));
+        const result = await registry.getHandler("scene_add")({
+            name: "Intro Scene",
+            preset: "announcement",
+            headline: "Hello",
+            duration: 4,
+            skipAudio: true,
+            skipImage: true,
+        }, ctx(cwd));
+        expect(result.success).toBe(true);
+        expect(result.output).toContain('Added scene "intro-scene"');
+        expect(result.output).toContain("preset=announcement");
+        expect(result.output).toContain("start:    0.00s");
+        expect(result.output).toContain("duration: 4.00s");
+        const sceneFile = await readFile(resolve(cwd, "compositions/scene-intro-scene.html"), "utf-8");
+        expect(sceneFile).toContain("Hello");
+        expect(sceneFile).not.toContain("<audio");
+    });
+    it("returns a structured failure when a scene file already exists (no --force)", async () => {
+        const cwd = await makeTmp();
+        await registry.getHandler("scene_init")({ dir: "." }, ctx(cwd));
+        await registry.getHandler("scene_add")({
+            name: "intro", duration: 3, skipAudio: true, skipImage: true,
+        }, ctx(cwd));
+        const second = await registry.getHandler("scene_add")({
+            name: "intro", duration: 3, skipAudio: true, skipImage: true,
+        }, ctx(cwd));
+        expect(second.success).toBe(false);
+        expect(second.error).toMatch(/already exists/);
+    });
+});
+describe("scene_lint handler — offline path", () => {
+    it("reports ok for a freshly scaffolded + populated project", async () => {
+        const cwd = await makeTmp();
+        await registry.getHandler("scene_init")({ dir: "." }, ctx(cwd));
+        await registry.getHandler("scene_add")({
+            name: "hello", duration: 3, skipAudio: true, skipImage: true,
+        }, ctx(cwd));
+        const result = await registry.getHandler("scene_lint")({}, ctx(cwd));
+        expect(result.success).toBe(true);
+        expect(result.output).toContain("Lint clean");
+    });
+    it("on an empty dir reports ok with zero findings (linter sees no files, the agent does not second-guess)", async () => {
+        const cwd = await makeTmp();
+        const result = await registry.getHandler("scene_lint")({}, ctx(cwd));
+        expect(result.success).toBe(true);
+        expect(result.output).toContain("0 error(s)");
+        expect(result.output).toContain("0 warning(s)");
+    });
+});
+describe("scene_render handler — Chrome-gated", () => {
+    it("returns a structured Chrome-not-found error when Chrome is missing OR the project is missing", async () => {
+        // We don't try to render — we just exercise the validation surface so the
+        // test stays Chrome-free. With a non-existent project the handler fails
+        // before reaching the Chrome preflight.
+        const cwd = await makeTmp();
+        const result = await registry.getHandler("scene_render")({
+            projectDir: "no-such-dir",
+        }, ctx(cwd));
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/Project directory not found|Chrome not found|Root composition not found/);
+    });
+});
+//# sourceMappingURL=scene.test.js.map

package/dist/agent/tools/scene.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.test.js","sourceRoot":"","sources":["../../../src/agent/tools/scene.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/_shared/scene-html-emit.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @module _shared/scene-html-emit
+ *
+ * Pure HTML emitters for `vibe scene add`. Each preset produces a self-contained
+ * Hyperframes-compatible scene composition: a `<template>`-wrapped `<div
+ * data-composition-id>` with scoped CSS, optional audio/image, and a paused
+ * GSAP timeline registered on `window.__timelines`.
+ *
+ * Also exposes helpers that mutate the root index.html:
+ * - `nextSceneStart()` — sum existing clip end-times to choose the new start
+ * - `insertClipIntoRoot()` — splice a `<div class="clip">` reference before the
+ *   root's closing div, preserving the user's hand-edited markup
+ * - `slugifySceneName()` — name → kebab-case scene id
+ *
+ * Pure functions only — no I/O. The orchestrating command (`scene add`) wires
+ * these to the filesystem.
+ */
+export type ScenePreset = "simple" | "announcement" | "explainer" | "kinetic-type" | "product-shot";
+export declare const SCENE_PRESETS: readonly ScenePreset[];
+export interface EmitSceneInput {
+    /** Kebab-case scene id; appears in `data-composition-id` and template id. */
+    id: string;
+    preset: ScenePreset;
+    /** Canvas width in px (must match the root composition). */
+    width: number;
+    /** Canvas height in px (must match the root composition). */
+    height: number;
+    /** Visible composition duration in seconds. */
+    duration: number;
+    /** Headline text — required for non-simple presets; defaulted from id. */
+    headline?: string;
+    /** Secondary text (subhead/caption). Often the narration. */
+    subhead?: string;
+    /** Optional small label above the headline (explainer / product-shot). */
+    kicker?: string;
+    /** Project-relative image path (e.g. "assets/scene-intro.png"). */
+    imagePath?: string;
+    /** Project-relative narration audio path (e.g. "assets/narration-intro.mp3"). */
+    audioPath?: string;
+}
+/**
+ * Slugify a free-form scene name to a kebab-case id usable in HTML attributes
+ * and filenames. Strips diacritics, collapses whitespace, lowercases.
+ */
+export declare function slugifySceneName(name: string): string;
+/**
+ * Emit the full per-scene HTML. Returns a complete `<template>`-wrapped
+ * composition ready to write to `compositions/scene-<id>.html`.
+ */
+export declare function emitSceneHtml(input: EmitSceneInput): string;
+/**
+ * Sum existing `<div class="clip">` end-times to find where the next scene
+ * should start. Returns 0 for an empty root.
+ */
+export declare function nextSceneStart(rootHtml: string): number;
+export interface ClipReferenceInput {
+    /** Scene id — used to derive the composition src path. */
+    id: string;
+    start: number;
+    duration: number;
+    trackIndex?: number;
+    /** Override the default `compositions/scene-<id>.html` src. */
+    src?: string;
+}
+/** Build the `<div class="clip" data-composition-id=... data-composition-src=...>` reference string. */
+export declare function buildClipReference(opts: ClipReferenceInput): string;
+/**
+ * Insert a clip reference inside the root composition's `#root` div, just
+ * before its closing `</div>`. Throws if the expected closing tag isn't
+ * found — callers should surface this as a structured error so users know
+ * to inspect a hand-edited root.
+ *
+ * Also grows the root's `data-duration` to fit the new clip's end-time.
+ */
+export declare function insertClipIntoRoot(rootHtml: string, clip: ClipReferenceInput): string;
+/**
+ * Read the root composition's canvas dims by parsing `data-width`/`data-height`
+ * on the `#root` div. Returns null if either is missing — caller should fall
+ * back to the project's aspect config.
+ */
+export declare function readRootDims(rootHtml: string): {
+    width: number;
+    height: number;
+} | null;
+//# sourceMappingURL=scene-html-emit.d.ts.map

package/dist/commands/_shared/scene-html-emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-html-emit.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/scene-html-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,cAAc,GACd,WAAW,GACX,cAAc,GACd,cAAc,CAAC;AAEnB,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAMtC,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA4BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASrD;AAmND;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA2C3D;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASvD;AAED,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wGAAwG;AACxG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAMnE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAiCrF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKvF"}