@vibeframe/mcp-server 0.70.0 → 0.71.0

package/dist/index.js

@@ -79585,19 +79585,19 @@ var require_range = __commonJS({
     var replaceCaret = (comp, options) => {
       debug7("caret", comp, options);
       const r = options.loose ? re[t.CARETLOOSE] : re[t.CARET];
-      const z12 = options.includePrerelease ? "-0" : "";
+      const z13 = options.includePrerelease ? "-0" : "";
       return comp.replace(r, (_, M, m, p, pr) => {
         debug7("caret", comp, _, M, m, p, pr);
         let ret;
         if (isX(M)) {
           ret = "";
         } else if (isX(m)) {
-          ret = `>=${M}.0.0${z12} <${+M + 1}.0.0-0`;
+          ret = `>=${M}.0.0${z13} <${+M + 1}.0.0-0`;
         } else if (isX(p)) {
           if (M === "0") {
-            ret = `>=${M}.${m}.0${z12} <${M}.${+m + 1}.0-0`;
+            ret = `>=${M}.${m}.0${z13} <${M}.${+m + 1}.0-0`;
           } else {
-            ret = `>=${M}.${m}.0${z12} <${+M + 1}.0.0-0`;
+            ret = `>=${M}.${m}.0${z13} <${+M + 1}.0.0-0`;
           }
         } else if (pr) {
           debug7("replaceCaret pr", pr);
@@ -79614,9 +79614,9 @@ var require_range = __commonJS({
           debug7("no pr");
           if (M === "0") {
             if (m === "0") {
-              ret = `>=${M}.${m}.${p}${z12} <${M}.${m}.${+p + 1}-0`;
+              ret = `>=${M}.${m}.${p}${z13} <${M}.${m}.${+p + 1}-0`;
             } else {
-              ret = `>=${M}.${m}.${p}${z12} <${M}.${+m + 1}.0-0`;
+              ret = `>=${M}.${m}.${p}${z13} <${M}.${+m + 1}.0-0`;
             }
           } else {
             ret = `>=${M}.${m}.${p} <${+M + 1}.0.0-0`;
@@ -106350,7 +106350,7 @@ var require_emscripten_module_WASM_RELEASE_SYNC = __commonJS({
           m = b;
           n = c;
         });
-        var p = Object.assign({}, a), t = "./this.program", u = "object" == typeof window, v = "function" == typeof importScripts, w = "object" == typeof process && "object" == typeof process.versions && "string" == typeof process.versions.node, x = "", y, z12, A;
+        var p = Object.assign({}, a), t = "./this.program", u = "object" == typeof window, v = "function" == typeof importScripts, w = "object" == typeof process && "object" == typeof process.versions && "string" == typeof process.versions.node, x = "", y, z13, A;
         if (w) {
           var fs8 = __require("fs"), B = __require("path");
           x = v ? B.dirname(x) + "/" : __dirname + "/";
@@ -106366,7 +106366,7 @@ var require_emscripten_module_WASM_RELEASE_SYNC = __commonJS({
             b.buffer || (b = new Uint8Array(b));
             return b;
           };
-          z12 = (b, c, d) => {
+          z13 = (b, c, d) => {
             var e = C(b);
             e && c(e);
             b = b.startsWith("file://") ? new URL(b) : B.normalize(b);
@@ -106410,7 +106410,7 @@ var require_emscripten_module_WASM_RELEASE_SYNC = __commonJS({
                 return b;
               throw d;
             }
-          }), z12 = (b, c, d) => {
+          }), z13 = (b, c, d) => {
             var e = new XMLHttpRequest();
             e.open("GET", b, true);
             e.responseType = "arraybuffer";
@@ -106491,9 +106491,9 @@ var require_emscripten_module_WASM_RELEASE_SYNC = __commonJS({
               }).catch(function() {
                 return ha(b);
               });
-            if (z12)
+            if (z13)
               return new Promise(function(c, d) {
-                z12(b, function(e) {
+                z13(b, function(e) {
                   c(new Uint8Array(e));
                 }, d);
               });
@@ -347714,8 +347714,8 @@ async function queryElementStacking(page, nativeHdrVideoIds) {
       while (current) {
         const cs = window.getComputedStyle(current);
         const pos = cs.position;
-        const z12 = parseInt(cs.zIndex);
-        if (!Number.isNaN(z12) && pos !== "static") return z12;
+        const z13 = parseInt(cs.zIndex);
+        if (!Number.isNaN(z13) && pos !== "static") return z13;
         current = current.parentElement;
       }
       return 0;
@@ -396287,19 +396287,19 @@ ${sourceUrlComment}
         var replaceCaret = (comp, options) => {
           debug62("caret", comp, options);
           const r = options.loose ? re[t.CARETLOOSE] : re[t.CARET];
-          const z12 = options.includePrerelease ? "-0" : "";
+          const z13 = options.includePrerelease ? "-0" : "";
           return comp.replace(r, (_, M, m, p, pr) => {
             debug62("caret", comp, _, M, m, p, pr);
             let ret;
             if (isX(M)) {
               ret = "";
             } else if (isX(m)) {
-              ret = `>=${M}.0.0${z12} <${+M + 1}.0.0-0`;
+              ret = `>=${M}.0.0${z13} <${+M + 1}.0.0-0`;
             } else if (isX(p)) {
               if (M === "0") {
-                ret = `>=${M}.${m}.0${z12} <${M}.${+m + 1}.0-0`;
+                ret = `>=${M}.${m}.0${z13} <${M}.${+m + 1}.0-0`;
               } else {
-                ret = `>=${M}.${m}.0${z12} <${+M + 1}.0.0-0`;
+                ret = `>=${M}.${m}.0${z13} <${+M + 1}.0.0-0`;
               }
             } else if (pr) {
               debug62("replaceCaret pr", pr);
@@ -396316,9 +396316,9 @@ ${sourceUrlComment}
               debug62("no pr");
               if (M === "0") {
                 if (m === "0") {
-                  ret = `>=${M}.${m}.${p}${z12} <${M}.${m}.${+p + 1}-0`;
+                  ret = `>=${M}.${m}.${p}${z13} <${M}.${m}.${+p + 1}-0`;
                 } else {
-                  ret = `>=${M}.${m}.${p}${z12} <${M}.${+m + 1}.0-0`;
+                  ret = `>=${M}.${m}.${p}${z13} <${M}.${+m + 1}.0-0`;
                 }
               } else {
                 ret = `>=${M}.${m}.${p} <${+M + 1}.0.0-0`;
@@ -422114,7 +422114,7 @@ Attempted to suspend at:`);
               m = b;
               n = c;
             });
-            var p = Object.assign({}, a), t = "./this.program", u = "object" == typeof window, v = "function" == typeof importScripts, w = "object" == typeof process && "object" == typeof process.versions && "string" == typeof process.versions.node, x = "", y, z12, A;
+            var p = Object.assign({}, a), t = "./this.program", u = "object" == typeof window, v = "function" == typeof importScripts, w = "object" == typeof process && "object" == typeof process.versions && "string" == typeof process.versions.node, x = "", y, z13, A;
             if (w) {
               var fs8 = __require2("fs"), B = __require2("path");
               x = v ? B.dirname(x) + "/" : __dirname + "/";
@@ -422130,7 +422130,7 @@ Attempted to suspend at:`);
                 b.buffer || (b = new Uint8Array(b));
                 return b;
               };
-              z12 = (b, c, d) => {
+              z13 = (b, c, d) => {
                 var e = C(b);
                 e && c(e);
                 b = b.startsWith("file://") ? new URL(b) : B.normalize(b);
@@ -422174,7 +422174,7 @@ Attempted to suspend at:`);
                     return b;
                   throw d;
                 }
-              }), z12 = (b, c, d) => {
+              }), z13 = (b, c, d) => {
                 var e = new XMLHttpRequest();
                 e.open("GET", b, true);
                 e.responseType = "arraybuffer";
@@ -422255,9 +422255,9 @@ Attempted to suspend at:`);
                   }).catch(function() {
                     return ha(b);
                   });
-                if (z12)
+                if (z13)
                   return new Promise(function(c, d) {
-                    z12(b, function(e) {
+                    z13(b, function(e) {
                       c(new Uint8Array(e));
                     }, d);
                   });
@@ -448826,6 +448826,26 @@ function detectAgentHosts(env4 = process.env) {
       detected: false,
       signals: [],
       projectFiles: ["AGENTS.md", ".aider.conf.yml"]
+    },
+    {
+      id: "gemini-cli",
+      label: "Gemini CLI",
+      detected: false,
+      signals: [],
+      // Per https://geminicli.com/docs/cli/gemini-md/ Gemini CLI's primary
+      // context file is GEMINI.md; AGENTS.md is the cross-tool fallback
+      // VibeFrame writes by default. Both are honoured.
+      projectFiles: ["GEMINI.md", "AGENTS.md", ".gemini/"]
+    },
+    {
+      id: "opencode",
+      label: "OpenCode",
+      detected: false,
+      signals: [],
+      // sst/opencode officially supports the agents.md spec — AGENTS.md at
+      // project root is the standard place. Local config also under
+      // `.opencode/` per https://opencode.ai/docs/config/.
+      projectFiles: ["AGENTS.md", ".opencode/"]
     }
   ].map((host) => {
     const signals2 = [];
@@ -448873,14 +448893,21 @@ var init_agent_host_detect = __esm({
       "claude-code": "claude",
       codex: "codex",
       cursor: "cursor",
-      aider: "aider"
+      aider: "aider",
+      "gemini-cli": "gemini",
+      opencode: "opencode"
     };
     HOST_CONFIG_DIRS = {
       "claude-code": ".claude",
       codex: ".codex",
       cursor: ".cursor",
       // some installs; macOS app stores prefs elsewhere
-      aider: null
+      aider: null,
+      "gemini-cli": ".gemini",
+      // sst/opencode uses XDG-style `~/.config/opencode/` per
+      // https://opencode.ai/docs/config/. The path is relative to $HOME so
+      // the join in detectAgentHosts() resolves correctly.
+      opencode: ".config/opencode"
     };
   }
 });
@@ -467461,6 +467488,348 @@ var agentOnlyTools = [
   mediaConcatTool
 ];
 
+// ../cli/src/tools/manifest/walkthrough.ts
+import { z as z12 } from "zod";
+
+// ../cli/src/commands/_shared/walkthroughs/walkthroughs.ts
+var SCENE_WALKTHROUGH = `# Scene authoring with vibe
+
+A scene project is a directory that is **bilingual**: it works with both
+\`vibe\` and \`npx hyperframes\`. Each scene is one HTML file with scoped CSS
+and a paused GSAP timeline. Cheap to edit, cheap to lint, expensive only
+at render.
+
+\`vibe scene build\` (v0.60+) is the supported one-shot driver from a
+written storyboard to an MP4. Plan H (v0.70) added \`--mode agent\` so the
+host agent itself authors the per-beat HTML \u2014 no internal LLM call.
+
+## Three authoring paths
+
+| Path | Command | When to use |
+|---|---|---|
+| **One-shot (default, v0.60+)** | \`vibe scene build [project-dir]\` | STORYBOARD.md has YAML frontmatter + per-beat cues |
+| **High-craft (manual)** | \`DESIGN.md\` + Hyperframes skill in your agent | Maximum control: hand-author each scene |
+| **Quick draft** | \`vibe scene add --style <preset>\` | No agent or no API keys; fast iteration |
+
+Recommend \`vibe scene build\` whenever the user has a STORYBOARD with
+narration / backdrop intent.
+
+## High-craft path
+
+1. \`vibe scene init my-promo --visual-style "Swiss Pulse"\` \u2014 seeds
+   \`DESIGN.md\` (palette, typography, motion, transitions) plus the
+   \`vibe.project.yaml\` / \`hyperframes.json\` / \`index.html\` scaffold.
+   In Plan H this **also installs the Hyperframes skill** at the
+   right place for your host (\`.claude/skills/hyperframes/\` for Claude
+   Code, \`.cursor/rules/hyperframes.mdc\` for Cursor, universal
+   \`SKILL.md\` for everyone else).
+2. Read \`SKILL.md\` (or the host-specific copy) \u2014 Hyperframes
+   framework rules, motion principles, type system, transition recipes.
+3. Read \`DESIGN.md\` \u2014 project-specific palette / typography / motion
+   signature (visual identity hard-gate).
+4. Author each scene HTML directly under \`compositions/scene-<id>.html\`
+   using the rules from steps 2 and 3. The skill enforces the visual
+   identity contract \u2014 scenes that contradict DESIGN.md fail lint.
+5. \`vibe scene lint --fix\` for mechanical issues, \`vibe scene render\`
+   to MP4.
+
+## Quick-draft path
+
+\`\`\`bash
+vibe scene init my-promo -r 16:9 -d 30
+vibe scene add intro --style announcement \\
+    --headline "Ship videos, not clicks"
+vibe scene lint
+vibe scene render
+\`\`\`
+
+\`vibe scene init\` is **idempotent** \u2014 running it on an existing
+Hyperframes directory merges \`hyperframes.json\` instead of clobbering it.
+Safe to invoke on user-provided projects.
+
+## Subcommands
+
+\`\`\`bash
+vibe scene init <dir> [-r 16:9|9:16|1:1|4:5] [-d <sec>] [--visual-style "<name>"]
+vibe scene styles [<name>]                   # list / show vendored visual identities
+vibe scene install-skill [<dir>] [--host all]  # retroactive Hyperframes-skill install
+vibe scene add <name> --style <preset> [...]
+vibe scene compose-prompts [<dir>] [--beat <id>]   # H2: emit plan, no LLM call
+vibe scene lint [<root>] [--json] [--fix]
+vibe scene render [<root>] [--fps 30] [--quality standard] [--format mp4]
+vibe scene build [<dir>] [--mode agent|batch|auto]   # H3 dispatch
+\`\`\`
+
+## Style presets (for \`vibe scene add --style\`)
+
+- **simple** \u2014 backdrop + bottom caption (default)
+- **announcement** \u2014 single huge headline, gradient text
+- **explainer** \u2014 kicker + title + subtitle stack
+- **kinetic-type** \u2014 words animate in word-by-word
+- **product-shot** \u2014 corner label + bottom headline + slow zoom
+
+All presets accept \`--narration <text|file>\`, \`--visuals <prompt>\`,
+\`--headline\`, \`--kicker\`. With \`--narration\`, scene duration auto-derives
+from the generated TTS audio.
+
+## STORYBOARD-to-MP4 (one command, v0.60+)
+
+\`\`\`bash
+vibe scene init my-promo --visual-style "Swiss Pulse" -d 12
+# (edit STORYBOARD.md with per-beat YAML cues \u2014 narration, backdrop, duration)
+vibe scene build my-promo
+\`\`\`
+
+\`vibe scene build\` reads the STORYBOARD frontmatter + per-beat cues,
+dispatches TTS + image-gen per beat, then either:
+
+- **\`--mode agent\`** (default when an agent host is detected) \u2014 emits a
+  \`needs-author\` plan via \`vibe scene compose-prompts\`. The host agent
+  authors each \`compositions/scene-<id>.html\` itself, then re-invoking
+  \`vibe scene build\` proceeds to lint + render.
+- **\`--mode batch\`** \u2014 VibeFrame runs an internal LLM (Claude / OpenAI /
+  Gemini) to compose the HTML, then renders.
+
+\`VIBE_BUILD_MODE\` env var overrides the auto-resolve.
+
+## Lint feedback loop
+
+\`\`\`bash
+vibe scene lint --json --fix
+\`\`\`
+
+Returns structured findings. The recommended loop: 1) run lint with
+\`--fix\` (mechanical fixes applied), 2) if \`errorCount > 0\`, edit the
+scene HTML, 3) re-lint. Cap retries at 3 \u2014 if errors persist, fall back
+to a template preset (\`vibe scene add <id> --style simple --force\`)
+and surface the error to the user.
+
+## When to use VibeFrame vs raw Hyperframes
+
+| Task | Tool |
+|------|------|
+| Generate narration + image, then author scene | \`vibe scene add\` |
+| Generate a full scenes project from a STORYBOARD | \`vibe scene build\` |
+| Hand-tweak a single scene's animation | edit \`compositions/<file>.html\` directly |
+| Render the project | \`vibe scene render\` *or* \`npx hyperframes render\` (equivalent) |
+| Lint | \`vibe scene lint\` *or* \`npx hyperframes lint\` (equivalent) |
+
+The \`vibe\` CLI adds asset generation, AI orchestration, and pipeline
+integration on top of Hyperframes' rendering primitives.
+
+## Quality checklist before render
+
+- [ ] \`vibe scene lint\` exits 0 (or only warnings)
+- [ ] \`vibe doctor\` confirms a usable Chrome (required for render)
+- [ ] Root \`data-duration\` matches the sum of clip durations
+- [ ] Aspect ratio in \`vibe.project.yaml\` matches the destination platform
+`;
+var PIPELINE_WALKTHROUGH = `# YAML pipelines (Video as Code)
+
+A pipeline is a YAML manifest with steps that reference each other's
+outputs. \`vibe run pipeline.yaml\` executes them with checkpointing and
+cost estimation.
+
+## Minimal skeleton
+
+\`\`\`yaml
+name: promo-video
+description: 15s product teaser
+steps:
+  - id: backdrop
+    action: generate-image
+    prompt: "sleek product shot on white background"
+    output: backdrop.png
+  - id: scene
+    action: generate-video
+    image: $backdrop.output        # reference previous step output
+    prompt: "slow camera pan"
+    duration: 5
+    output: scene.mp4
+  - id: voice
+    action: generate-tts
+    text: "Meet the new standard."
+    output: voice.mp3
+  - id: final
+    action: compose
+    video: $scene.output
+    audio: $voice.output
+    output: final.mp4
+\`\`\`
+
+## Supported actions
+
+- \`generate-image\`, \`generate-video\`, \`generate-tts\`, \`generate-music\`,
+  \`generate-sound-effect\`, \`generate-storyboard\`, \`generate-motion\`
+- \`edit-silence-cut\`, \`edit-jump-cut\`, \`edit-caption\`, \`edit-grade\`,
+  \`edit-reframe\`, \`edit-speed-ramp\`, \`edit-fade\`, \`edit-noise-reduce\`,
+  \`edit-text-overlay\`, \`edit-fill-gaps\`
+- \`analyze-media\`, \`analyze-video\`, \`analyze-review\`, \`analyze-suggest\`
+- \`audio-transcribe\`, \`audio-isolate\`, \`audio-voice-clone\`, \`audio-dub\`,
+  \`audio-duck\`
+- \`detect-scenes\`, \`detect-silence\`, \`detect-beats\`
+- \`compose\`, \`export\`
+- \`scene-build\` (Plan H one-shot driver) and \`scene-render\`
+- \`compose-scenes-with-skills\` (internal-LLM compose pass)
+
+The full set lives in \`packages/cli/src/pipeline/executor.ts\`.
+
+## Variable references
+
+- \`$<step-id>.output\` \u2014 previous step's output path
+- \`$<step-id>.result.<field>\` \u2014 structured field from JSON result
+- \`\${ENV_VAR}\` \u2014 environment variable
+- Values can be templated: \`"\${SCRIPT_TITLE} - Episode \${EPISODE}"\`
+
+## Running
+
+\`\`\`bash
+vibe run pipeline.yaml --dry-run           # plan + cost estimate, no execution
+vibe run pipeline.yaml                     # execute
+vibe run pipeline.yaml --resume            # retry from last successful step
+vibe run pipeline.yaml --from scene        # start at specific step
+vibe run pipeline.yaml --provider-video kling   # override provider
+\`\`\`
+
+Checkpoints land next to the YAML: \`pipeline.yaml.checkpoint.json\`.
+
+## Authoring tips
+
+1. **Start from examples** \u2014 \`examples/demo-pipeline.yaml\` (FFmpeg-only,
+   no keys), \`examples/promo-video.yaml\` (AI providers).
+2. **Dry-run first** \u2014 you see estimated cost and resolved variable
+   graph before spending API credits.
+3. **Keep step ids short and descriptive** (\`intro\`, \`scene1\`, \`voice\`,
+   \`bgm\`) \u2014 they appear in logs and variable refs.
+4. **Name outputs** with extensions matching the action (\`.mp4\`, \`.mp3\`,
+   \`.png\`, \`.json\`).
+5. **Declare \`budget:\`** on expensive pipelines:
+   \`\`\`yaml
+   budget:
+     tokens: 500_000
+     max_tool_errors: 3
+     cost_usd: 5.00
+   \`\`\`
+6. **Split large pipelines** into smaller YAML files and compose via
+   \`action: run-pipeline\` (nested).
+
+## Converting ad-hoc shell sessions to pipelines
+
+When the user has a working shell sequence, extract steps:
+
+- Each \`vibe ...\` command becomes one step
+- File outputs become step outputs; downstream \`-i <file>\` references
+  become \`$<id>.output\`
+- Shared parameters move to a top-level \`defaults:\` section
+- Wrap the entire chain in a \`name:\` + \`steps:\` skeleton
+
+The \`compose\` action is the catch-all assembly step (audio mux, video
+overlay, etc.) \u2014 useful at the tail of a pipeline.
+`;
+var META = {
+  scene: {
+    title: "Scene authoring with vibe",
+    summary: "Author per-scene HTML compositions and render to MP4 (BUILD flow)",
+    steps: [
+      'Run `vibe scene init <dir> --visual-style "<style name>"` to scaffold the project + install the Hyperframes skill (Plan H).',
+      "Edit `STORYBOARD.md` with per-beat YAML cues (narration / backdrop / duration).",
+      "Read `SKILL.md` for the framework rules and `DESIGN.md` for the visual-identity hard-gate.",
+      "Run `vibe scene build <dir>`. With an agent host detected, the CLI emits a `needs-author` plan; the host agent authors each `compositions/scene-<id>.html` and re-invokes to render.",
+      "Run `vibe scene lint --fix` to validate, then `vibe scene render` to produce the MP4."
+    ],
+    relatedCommands: [
+      "vibe scene init",
+      "vibe scene styles",
+      "vibe scene install-skill",
+      "vibe scene compose-prompts",
+      "vibe scene build",
+      "vibe scene lint",
+      "vibe scene render",
+      "vibe scene add"
+    ]
+  },
+  pipeline: {
+    title: "YAML pipelines (Video as Code)",
+    summary: "Author and run reproducible multi-step video workflows",
+    steps: [
+      "Sketch the workflow as YAML \u2014 `name`, `description`, then `steps:` with `id` + `action` + inputs/outputs.",
+      "Reference previous step outputs via `$<step-id>.output` (or `$<step-id>.result.<field>` for structured returns).",
+      "Run `vibe run pipeline.yaml --dry-run` to see the resolved graph + cost estimate before spending API budget.",
+      "Add a `budget:` block (tokens / cost_usd / max_tool_errors) to cap expensive runs.",
+      "Run `vibe run pipeline.yaml` to execute. Failed steps checkpoint to `pipeline.yaml.checkpoint.json`; resume with `--resume`."
+    ],
+    relatedCommands: [
+      "vibe run",
+      "vibe schema --list",
+      "vibe doctor"
+    ]
+  }
+};
+var CONTENT2 = {
+  scene: SCENE_WALKTHROUGH,
+  pipeline: PIPELINE_WALKTHROUGH
+};
+var WALKTHROUGH_TOPICS = ["scene", "pipeline"];
+function loadWalkthrough(topic) {
+  const meta = META[topic];
+  const content = CONTENT2[topic];
+  if (!meta || !content) {
+    throw new Error(`Unknown walkthrough topic: ${topic}`);
+  }
+  return {
+    topic,
+    title: meta.title,
+    summary: meta.summary,
+    steps: meta.steps,
+    relatedCommands: meta.relatedCommands,
+    content
+  };
+}
+function listWalkthroughs() {
+  return WALKTHROUGH_TOPICS.map((topic) => ({
+    topic,
+    title: META[topic].title,
+    summary: META[topic].summary
+  }));
+}
+
+// ../cli/src/tools/manifest/walkthrough.ts
+var walkthroughSchema = z12.object({
+  topic: z12.enum(WALKTHROUGH_TOPICS).optional().describe(
+    "Walkthrough topic to load. Omit to list every available walkthrough \u2014 useful for discovery on first contact."
+  )
+});
+var walkthroughTool = defineTool({
+  name: "walkthrough",
+  category: "agent",
+  cost: "free",
+  description: "Load the step-by-step authoring guide for a vibe workflow (BUILD scene authoring, YAML pipeline authoring). Universal CLI-equivalent of Claude Code's /vibe-* slash commands \u2014 any host agent that calls this tool gets the same content the slash menu delivers in Claude Code, with no Claude Code dependency. Without a topic, returns the catalog of walkthroughs for discovery.",
+  schema: walkthroughSchema,
+  async execute(args) {
+    if (!args.topic) {
+      const topics = listWalkthroughs();
+      return {
+        success: true,
+        data: { action: "list", topics },
+        humanLines: [
+          `Available walkthroughs: ${topics.map((t) => t.topic).join(", ")}.`,
+          `Call again with topic to load full content.`
+        ]
+      };
+    }
+    const result = loadWalkthrough(args.topic);
+    return {
+      success: true,
+      data: { action: "show", ...result },
+      humanLines: [
+        `Loaded walkthrough: ${result.title}.`,
+        `${result.steps.length} steps, ${result.relatedCommands.length} related commands, ${result.content.length} chars of guide content.`
+      ]
+    };
+  }
+});
+var walkthroughTools = [walkthroughTool];
+
 // ../cli/src/tools/manifest/index.ts
 var manifest = [
   ...sceneTools,
@@ -467473,15 +467842,16 @@ var manifest = [
   ...timelineTools,
   ...projectTools,
   ...exportTools,
-  ...agentOnlyTools
+  ...agentOnlyTools,
+  ...walkthroughTools
 ];
 
 // ../cli/src/tools/zod-to-json-schema.ts
-function getDef(z12) {
-  return z12._def;
+function getDef(z13) {
+  return z13._def;
 }
-function getDescription(z12) {
-  let current = z12;
+function getDescription(z13) {
+  let current = z13;
   while (current) {
     const def = getDef(current);
     if (def.description) return def.description;
@@ -467489,24 +467859,24 @@ function getDescription(z12) {
   }
   return void 0;
 }
-function unwrapOptional(z12) {
-  const def = getDef(z12);
+function unwrapOptional(z13) {
+  const def = getDef(z13);
   if (def.typeName === "ZodOptional" && def.innerType) {
     return { inner: def.innerType, optional: true };
   }
-  return { inner: z12, optional: false };
+  return { inner: z13, optional: false };
 }
-function unwrapDefault(z12) {
-  const def = getDef(z12);
+function unwrapDefault(z13) {
+  const def = getDef(z13);
   if (def.typeName === "ZodDefault" && def.innerType && def.defaultValue) {
     return { inner: def.innerType, defaultValue: def.defaultValue() };
   }
-  return { inner: z12 };
+  return { inner: z13 };
 }
-function convertLeaf(z12, description) {
-  const { inner: afterDefault, defaultValue } = unwrapDefault(z12);
+function convertLeaf(z13, description) {
+  const { inner: afterDefault, defaultValue } = unwrapDefault(z13);
   const def = getDef(afterDefault);
-  const desc = description ?? getDescription(z12);
+  const desc = description ?? getDescription(z13);
   const base = {};
   if (desc) base.description = desc;
   if (defaultValue !== void 0) base.default = defaultValue;
@@ -467553,8 +467923,8 @@ function convertLeaf(z12, description) {
       );
   }
 }
-function convertObject(z12, description) {
-  const def = getDef(z12);
+function convertObject(z13, description) {
+  const def = getDef(z13);
   if (def.typeName !== "ZodObject" || !def.shape) {
     throw new Error(`zod-to-json-schema: convertObject called on non-ZodObject (${def.typeName})`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.70.0",
+  "version": "0.71.0",
   "description": "VibeFrame MCP Server - AI-native video editing via Model Context Protocol",
   "type": "module",
   "bin": {
@@ -57,8 +57,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/cli": "0.70.0",
-    "@vibeframe/core": "0.70.0"
+    "@vibeframe/core": "0.71.0",
+    "@vibeframe/cli": "0.71.0"
   },
   "engines": {
     "node": ">=20"