@vibeframe/mcp-server 0.110.0 → 0.111.1

package/README.md

@@ -323,6 +323,23 @@ API keys are read from the host's environment (`~/.zshrc`, MCP config `env` bloc
 - Node.js 20+
 - FFmpeg on `PATH` (export, editing, pipelines)
 
+## Privacy Policy
+
+VibeFrame is local-first: no telemetry, no VibeFrame-operated servers in the
+data path. Projects and generated media stay in the workspace folder you
+choose; content is sent only to the AI providers you configure (Anthropic,
+OpenAI, Google, ElevenLabs, …) when you explicitly invoke them, and API keys
+live only on your machine. Tools that reach external services are marked with
+`openWorldHint` in their MCP annotations; everything else (timeline edits,
+ffmpeg operations, linting, rendering, local Kokoro TTS) runs fully locally.
+
+Full policy: <https://vibeframe.ai/privacy> (source:
+[PRIVACY.md](https://github.com/vericontext/vibeframe/blob/main/PRIVACY.md)).
+
+> Installing the `.mcpb` file directly shows a standard "not verified by
+> Anthropic" sideload notice in Claude Desktop — that is expected for
+> extensions distributed outside the official directory.
+
 ## License
 
 MIT

package/dist/index.js

@@ -34586,7 +34586,7 @@ var require_source_map = __commonJS({
 var require_previous_map = __commonJS({
   "../../node_modules/.pnpm/postcss@8.5.6/node_modules/postcss/lib/previous-map.js"(exports, module) {
     "use strict";
-    var { existsSync: existsSync65, readFileSync: readFileSync12 } = __require("fs");
+    var { existsSync: existsSync66, readFileSync: readFileSync12 } = __require("fs");
     var { dirname: dirname33, join: join44 } = __require("path");
     var { SourceMapConsumer, SourceMapGenerator } = require_source_map();
     function fromBase64(str2) {
@@ -34649,7 +34649,7 @@ var require_previous_map = __commonJS({
       }
       loadFile(path14) {
         this.root = dirname33(path14);
-        if (existsSync65(path14)) {
+        if (existsSync66(path14)) {
           this.mapFile = path14;
           return readFileSync12(path14, "utf-8").toString().trim();
         }
@@ -39915,8 +39915,8 @@ var require_common2 = __commonJS({
         }
         return debug9;
       }
-      function extend(namespace, delimiter) {
-        const newDebug = createDebug(this.namespace + (typeof delimiter === "undefined" ? ":" : delimiter) + namespace);
+      function extend(namespace, delimiter2) {
+        const newDebug = createDebug(this.namespace + (typeof delimiter2 === "undefined" ? ":" : delimiter2) + namespace);
         newDebug.log = this.log;
         return newDebug;
       }
@@ -90548,10 +90548,10 @@ var require_parseListMLSD = __commonJS({
       // available on the server's operating system." The parser by Apache Commons tries to translate these
       // to Unix permissions – this is misleading users and might not even be correct.
     };
-    function splitStringOnce(str2, delimiter) {
-      const pos = str2.indexOf(delimiter);
+    function splitStringOnce(str2, delimiter2) {
+      const pos = str2.indexOf(delimiter2);
       const a2 = str2.substr(0, pos);
-      const b2 = str2.substr(pos + delimiter.length);
+      const b2 = str2.substr(pos + delimiter2.length);
       return [a2, b2];
     }
     function testLine(line) {
@@ -359330,8 +359330,8 @@ var init_dist2 = __esm({
             }
             return debug62;
           }
-          function extend(namespace, delimiter) {
-            const newDebug = createDebug(this.namespace + (typeof delimiter === "undefined" ? ":" : delimiter) + namespace);
+          function extend(namespace, delimiter2) {
+            const newDebug = createDebug(this.namespace + (typeof delimiter2 === "undefined" ? ":" : delimiter2) + namespace);
             newDebug.log = this.log;
             return newDebug;
           }
@@ -407094,10 +407094,10 @@ Closing reason: ${this._closingError.stack}`;
           // available on the server's operating system." The parser by Apache Commons tries to translate these
           // to Unix permissions – this is misleading users and might not even be correct.
         };
-        function splitStringOnce(str2, delimiter) {
-          const pos = str2.indexOf(delimiter);
+        function splitStringOnce(str2, delimiter2) {
+          const pos = str2.indexOf(delimiter2);
           const a2 = str2.substr(0, pos);
-          const b2 = str2.substr(pos + delimiter.length);
+          const b2 = str2.substr(pos + delimiter2.length);
           return [a2, b2];
         }
         function testLine(line) {
@@ -458340,10 +458340,10 @@ async function* iterSSEChunks(iterator3) {
     yield data;
   }
 }
-function partition(str2, delimiter) {
-  const index = str2.indexOf(delimiter);
+function partition(str2, delimiter2) {
+  const index = str2.indexOf(delimiter2);
   if (index !== -1) {
-    return [str2.substring(0, index), delimiter, str2.substring(index + delimiter.length)];
+    return [str2.substring(0, index), delimiter2, str2.substring(index + delimiter2.length)];
   }
   return [str2, "", ""];
 }
@@ -462204,10 +462204,10 @@ async function* iterSSEChunks2(iterator3) {
     yield data;
   }
 }
-function partition2(str2, delimiter) {
-  const index = str2.indexOf(delimiter);
+function partition2(str2, delimiter2) {
+  const index = str2.indexOf(delimiter2);
   if (index !== -1) {
-    return [str2.substring(0, index), delimiter, str2.substring(index + delimiter.length)];
+    return [str2.substring(0, index), delimiter2, str2.substring(index + delimiter2.length)];
   }
   return [str2, "", ""];
 }
@@ -488359,6 +488359,8 @@ var sceneStylesTool = defineTool({
   name: "scene_list_styles",
   category: "scene",
   cost: "free",
+  title: "List Visual Styles",
+  annotations: { readOnly: true, openWorld: false },
   description: "List the 8 vendored visual identities available for `init --visual-style` (Swiss Pulse, Data Drift, \u2026) or, when `name` is provided, return the full DESIGN.md hard-gate body for one style. The DESIGN.md content is what the LLM uses as a non-negotiable visual rulebook during compose-scenes-with-skills.",
   schema: sceneStylesSchema,
   async execute(args) {
@@ -488420,6 +488422,8 @@ var sceneInitTool = defineTool({
   name: "init",
   category: "scene",
   cost: "free",
+  title: "Initialize Video Project",
+  annotations: { readOnly: false, destructive: false, idempotent: true, openWorld: false },
   description: "Scaffold a new VibeFrame video scene project. Supports minimal, agent, and full profiles; full includes the current HTML render backend metadata. Idempotent: re-running keeps user-authored files and merges backend config instead of overwriting. No API keys required.",
   schema: sceneInitSchema,
   async execute(args, ctx) {
@@ -488470,6 +488474,8 @@ var sceneAddTool = defineTool({
   name: "scene_add",
   category: "scene",
   cost: "low",
+  title: "Add Scene from Preset",
+  annotations: { readOnly: false, openWorld: true },
   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.",
   schema: sceneAddSchema,
   async execute(args, ctx) {
@@ -488548,6 +488554,8 @@ var sceneLintTool = defineTool({
   name: "scene_lint",
   category: "scene",
   cost: "free",
+  title: "Lint Scene Compositions",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   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 \u2014 other issues surface with fixHints.",
   schema: sceneLintSchema,
   async execute(args, ctx) {
@@ -488585,6 +488593,8 @@ var sceneRepairTool = defineTool({
   name: "scene_repair",
   category: "scene",
   cost: "free",
+  title: "Repair Scene Compositions",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   description: "Apply deterministic mechanical scene repairs. Currently uses the safe lint auto-fix allow-list and never performs semantic creative rewrites.",
   schema: sceneRepairSchema,
   async execute(args, ctx) {
@@ -488665,6 +488675,8 @@ var sceneRenderTool = defineTool({
   name: "render",
   category: "scene",
   cost: "free",
+  title: "Render Video to MP4",
+  annotations: { readOnly: false, openWorld: false },
   description: "Render a scene project to MP4/WebM/MOV via the Hyperframes producer. Requires Chrome installed locally. Output defaults to renders/<projectName>-<isoStamp>.<format>. Long runs: over MCP, calls exceeding ~45s return immediately with { promoted: true, jobId, status: 'running' } \u2014 poll status_job every 15-30s until completed/failed instead of re-invoking render. Emits MCP progress notifications when the client supplies a progressToken.",
   schema: sceneRenderSchema,
   async execute(args, ctx) {
@@ -488794,6 +488806,8 @@ var sceneBuildTool = defineTool({
   name: "build",
   category: "scene",
   cost: "high",
+  title: "Build Video from Storyboard",
+  annotations: { readOnly: false, openWorld: true },
   description: "v0.60 one-shot orchestrator: read STORYBOARD.md per-beat YAML cues (narration / backdrop / duration), dispatch TTS + image generation per beat, compose scene HTML via the compose-scenes-with-skills pipeline, then render to MP4. Use this instead of chaining init + scene_add + render manually. Caches by SHA256 of (DESIGN.md + cue body) so re-runs are idempotent and cheap. Long runs: over MCP, calls exceeding ~45s return immediately with { promoted: true, jobId, status: 'running' } \u2014 poll status_job every 15-30s until completed/failed instead of re-invoking build. Emits MCP progress notifications when the client supplies a progressToken. When the MCP host supports elicitation, unspecified asset choices (narration provider, backdrop images, cost cap) are confirmed with the user via a form before the build starts.",
   schema: sceneBuildSchema,
   async execute(args, ctx) {
@@ -488876,6 +488890,8 @@ var sceneInstallSkillTool = defineTool({
   name: "scene_install_skill",
   category: "scene",
   cost: "free",
+  title: "Install Hyperframes Skill",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   description: "Install the vendored Hyperframes skill bundle into a scene project so the host agent (Claude Code, Cursor, Codex, Aider) can read framework rules + house style directly. Writes a universal SKILL.md + references/ at the project root, plus per-host layouts (.claude/skills/hyperframes/ for Claude Code, .cursor/rules/hyperframes.mdc for Cursor) when those hosts are detected. Phase H1 of the agentic-native composer plan \u2014 once installed, the host agent itself can author scene HTML using the rules instead of relying on vibe's internal LLM call.",
   schema: sceneInstallSkillSchema,
   async execute(args, ctx) {
@@ -488922,6 +488938,8 @@ var sceneComposePromptsTool = defineTool({
   name: "scene_compose_prompts",
   category: "scene",
   cost: "free",
+  title: "Get Scene Authoring Prompts",
+  annotations: { readOnly: true, openWorld: false },
   description: "Emit the per-beat compose plan for the host agent to author scene HTML itself. Reads STORYBOARD.md + DESIGN.md and returns each beat's outputPath + userPrompt + cues + body, plus references to the project's SKILL.md (Hyperframes rules) and DESIGN.md (visual identity). The host agent writes each compositions/scene-<id>.html file directly \u2014 VibeFrame makes NO LLM call here. Hosts that cannot write files (e.g. Claude Desktop) submit each authored beat with scene_submit instead. Pairs with scene_install_skill (Phase H1). Phase H2 of the agentic-native composer plan; the internal-LLM batch path (build) remains as a fallback for non-agent contexts.",
   schema: sceneComposePromptsSchema,
   async execute(args, ctx) {
@@ -488964,6 +488982,8 @@ var sceneSubmitTool = defineTool({
   name: "scene_submit",
   category: "scene",
   cost: "free",
+  title: "Submit Scene HTML",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   description: "Submit host-authored Hyperframes scene HTML for one beat. Validates with the same lint as the batch composer and writes compositions/scene-<id>.html on pass; on lint errors it returns the findings WITHOUT writing so you can fix and resubmit. This completes agent-mode compose for hosts that cannot write files (e.g. Claude Desktop): build (mode agent) \u2192 needs-author plan \u2192 author each beat from its composePrompts userPrompt \u2192 scene_submit per beat \u2192 build (stage sync) \u2192 render. No internal LLM call \u2014 the submitting agent is the composer.",
   schema: sceneSubmitSchema,
   async execute(args, ctx) {
@@ -489006,6 +489026,8 @@ var audioTranscribeTool = defineTool({
   name: "audio_transcribe",
   category: "audio",
   cost: "low",
+  title: "Transcribe Audio",
+  annotations: { readOnly: false, openWorld: true },
   description: "Transcribe audio using OpenAI Whisper. Outputs text, SRT, or VTT. Requires OPENAI_API_KEY.",
   schema: z3.object({
     audioPath: z3.string().describe("Input audio file path"),
@@ -489035,6 +489057,8 @@ var audioIsolateTool = defineTool({
   name: "audio_isolate",
   category: "audio",
   cost: "low",
+  title: "Isolate Vocals from Audio",
+  annotations: { readOnly: false, openWorld: true },
   description: "Isolate vocals from audio using ElevenLabs. Requires ELEVENLABS_API_KEY.",
   schema: z3.object({
     audioPath: z3.string().describe("Input audio file path"),
@@ -489054,6 +489078,8 @@ var audioVoiceCloneTool = defineTool({
   name: "audio_clone_voice",
   category: "audio",
   cost: "low",
+  title: "Clone Voice from Samples",
+  annotations: { readOnly: false, destructive: false, openWorld: true },
   description: "Clone a voice from audio samples using ElevenLabs. Requires ELEVENLABS_API_KEY.",
   schema: z3.object({
     samplePaths: z3.array(z3.string()).describe("Audio sample file paths (1-25 files)"),
@@ -489075,6 +489101,8 @@ var audioDubTool = defineTool({
   name: "audio_dub",
   category: "audio",
   cost: "high",
+  title: "Dub Audio to Another Language",
+  annotations: { readOnly: false, openWorld: true },
   description: "Dub audio/video to another language (transcribe + translate + TTS). Requires OPENAI_API_KEY, ANTHROPIC_API_KEY, ELEVENLABS_API_KEY.",
   schema: z3.object({
     mediaPath: z3.string().describe("Input media file (video or audio)"),
@@ -489105,6 +489133,8 @@ var audioDuckTool = defineTool({
   name: "audio_duck",
   category: "audio",
   cost: "free",
+  title: "Duck Background Music",
+  annotations: { readOnly: false, openWorld: false },
   description: "Auto-duck background music when voice is present using FFmpeg sidechain compression. Free, no API key needed.",
   schema: z3.object({
     musicPath: z3.string().describe("Background music file path"),
@@ -489402,6 +489432,8 @@ var editSilenceCutTool = defineTool({
   name: "edit_silence_cut",
   category: "edit",
   cost: "free",
+  title: "Cut Silence from Video",
+  annotations: { readOnly: false, openWorld: true },
   description: "Remove silent segments from a video using FFmpeg or Gemini AI detection. No API key needed for FFmpeg mode.",
   schema: z4.object({
     videoPath: z4.string().describe("Path to the input video file"),
@@ -489432,6 +489464,8 @@ var editCaptionTool = defineTool({
   name: "edit_caption",
   category: "edit",
   cost: "low",
+  title: "Burn Captions into Video",
+  annotations: { readOnly: false, openWorld: true },
   description: "Transcribe audio and burn styled captions into video. Requires OPENAI_API_KEY for Whisper transcription.",
   schema: z4.object({
     videoPath: z4.string().describe("Path to the input video file"),
@@ -489456,6 +489490,8 @@ var editFadeTool = defineTool({
   name: "edit_fade",
   category: "edit",
   cost: "free",
+  title: "Apply Fade Effects",
+  annotations: { readOnly: false, openWorld: false },
   description: "Apply fade in/out effects to video and/or audio. No API key needed.",
   schema: z4.object({
     videoPath: z4.string().describe("Path to the input video file"),
@@ -489479,6 +489515,8 @@ var editNoiseReduceTool = defineTool({
   name: "edit_noise_reduce",
   category: "edit",
   cost: "free",
+  title: "Reduce Audio Noise",
+  annotations: { readOnly: false, openWorld: false },
   description: "Reduce audio/video noise using FFmpeg filters. No API key needed.",
   schema: z4.object({
     inputPath: z4.string().describe("Path to the input media file"),
@@ -489500,6 +489538,8 @@ var editJumpCutTool = defineTool({
   name: "edit_jump_cut",
   category: "edit",
   cost: "low",
+  title: "Remove Filler Words",
+  annotations: { readOnly: false, openWorld: true },
   description: "Remove filler words (um, uh, like, etc.) from video using Whisper transcription. Requires OPENAI_API_KEY.",
   schema: z4.object({
     videoPath: z4.string().describe("Path to the input video file"),
@@ -489523,6 +489563,8 @@ var editTextOverlayTool = defineTool({
   name: "edit_text_overlay",
   category: "edit",
   cost: "free",
+  title: "Overlay Static Text",
+  annotations: { readOnly: false, openWorld: false },
   description: "Apply simple static text burn-in on video using FFmpeg drawtext. No API key needed. For designed or animated overlays, use edit_motion_overlay.",
   schema: z4.object({
     videoPath: z4.string().describe("Path to the input video file"),
@@ -489549,6 +489591,8 @@ var editMotionOverlayTool = defineTool({
   name: "edit_motion_overlay",
   category: "edit",
   cost: "low",
+  title: "Apply Motion Graphics Overlay",
+  annotations: { readOnly: false, openWorld: true },
   description: "Apply designed motion graphics overlays to an existing video. Generates Remotion overlays from a prompt, or overlays a user-provided .json/.lottie animation via the Hyperframes renderer.",
   schema: z4.object({
     videoPath: z4.string().describe("Path to the input video file"),
@@ -489585,6 +489629,8 @@ var editTranslateSrtTool = defineTool({
   name: "edit_translate_srt",
   category: "edit",
   cost: "low",
+  title: "Translate SRT Subtitles",
+  annotations: { readOnly: false, openWorld: true },
   description: "Translate SRT subtitle files using Claude or OpenAI. Requires ANTHROPIC_API_KEY or OPENAI_API_KEY.",
   schema: z4.object({
     srtPath: z4.string().describe("Path to the input SRT file"),
@@ -489607,6 +489653,8 @@ var editGradeTool = defineTool({
   name: "edit_grade",
   category: "edit",
   cost: "low",
+  title: "Apply Color Grading",
+  annotations: { readOnly: false, openWorld: true },
   description: "Apply AI-generated color grading using Claude + FFmpeg. Use preset for free built-in grades, or style for custom AI-generated grades (needs ANTHROPIC_API_KEY).",
   schema: z4.object({
     videoPath: z4.string().describe("Input video file path"),
@@ -489629,6 +489677,8 @@ var editSpeedRampTool = defineTool({
   name: "edit_speed_ramp",
   category: "edit",
   cost: "low",
+  title: "Apply Content-Aware Speed Ramping",
+  annotations: { readOnly: false, openWorld: true },
   description: "Apply content-aware speed ramping. Analyzes speech with Whisper, plans speed changes with Claude, applies with FFmpeg. Requires OPENAI_API_KEY + ANTHROPIC_API_KEY.",
   schema: z4.object({
     videoPath: z4.string().describe("Input video file path (must have audio)"),
@@ -489653,6 +489703,8 @@ var editReframeTool = defineTool({
   name: "edit_reframe",
   category: "edit",
   cost: "free",
+  title: "Reframe Video Aspect Ratio",
+  annotations: { readOnly: false, openWorld: false },
   description: "Auto-reframe video to a different aspect ratio using smart cropping. Free (FFmpeg only).",
   schema: z4.object({
     videoPath: z4.string().describe("Input video file path"),
@@ -489675,6 +489727,8 @@ var editInterpolateTool = defineTool({
   name: "edit_interpolate",
   category: "edit",
   cost: "free",
+  title: "Create Slow Motion with Frame Interpolation",
+  annotations: { readOnly: false, openWorld: false },
   description: "Create slow motion with AI frame interpolation using FFmpeg minterpolate. Free, no API key needed.",
   schema: z4.object({
     videoPath: z4.string().describe("Input video file path"),
@@ -489697,6 +489751,8 @@ var editUpscaleTool = defineTool({
   name: "edit_upscale",
   category: "edit",
   cost: "free",
+  title: "Upscale Video Resolution",
+  annotations: { readOnly: false, openWorld: false },
   description: "Upscale video resolution using FFmpeg (Lanczos scaling). Free, no API key needed.",
   schema: z4.object({
     videoPath: z4.string().describe("Input video file path"),
@@ -489718,6 +489774,8 @@ var editAnimatedCaptionTool = defineTool({
   name: "edit_animated_caption",
   category: "edit",
   cost: "low",
+  title: "Add Animated Captions",
+  annotations: { readOnly: false, openWorld: true },
   description: "Add animated word-by-word captions (TikTok/Reels style). Supports highlight, bounce, pop-in, neon, karaoke-sweep, typewriter styles. Requires OPENAI_API_KEY for Whisper.",
   schema: z4.object({
     videoPath: z4.string().describe("Path to the input video file"),
@@ -489750,6 +489808,8 @@ var editImageTool = defineTool({
   name: "edit_image",
   category: "edit",
   cost: "low",
+  title: "Edit Image with AI",
+  annotations: { readOnly: false, openWorld: true },
   description: "Edit image(s) using Gemini (Nano Banana). Provide image paths and an edit prompt. Requires GOOGLE_API_KEY.",
   schema: z4.object({
     imagePaths: z4.array(z4.string()).describe("Input image file path(s)"),
@@ -489773,6 +489833,8 @@ var editFillGapsTool = defineTool({
   name: "edit_fill_gaps",
   category: "edit",
   cost: "high",
+  title: "Fill Timeline Gaps with AI Video",
+  annotations: { readOnly: false, openWorld: true },
   description: "Fill timeline gaps with AI-generated video using Kling image-to-video. Detects empty regions in a project's timeline, extracts the last frame of the preceding clip, and generates a continuation video. Requires KLING_API_KEY and IMGBB_API_KEY (image hosting for Kling).",
   schema: z4.object({
     projectPath: z4.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -491256,6 +491318,8 @@ var inspectProjectTool = defineTool({
   name: "inspect_project",
   category: "analyze",
   cost: "free",
+  title: "Inspect Project",
+  annotations: { readOnly: false, openWorld: false },
   description: "Local project inspection: checks STORYBOARD.md, DESIGN.md, config, build-report, scene lint, composition files, and referenced assets. Writes review-report.json by default.",
   schema: z5.object({
     projectDir: z5.string().optional().describe(PROJECT_DIR_DESCRIPTION2),
@@ -491290,6 +491354,8 @@ var inspectRenderTool = defineTool({
   name: "inspect_render",
   category: "analyze",
   cost: "low",
+  title: "Inspect Render",
+  annotations: { readOnly: false, openWorld: false },
   description: "Render inspection: runs cheap local video checks by default, optionally adds Gemini AI review with ai: true, and writes review-report.json by default.",
   schema: z5.object({
     projectDir: z5.string().optional().describe(PROJECT_DIR_DESCRIPTION2),
@@ -491354,6 +491420,8 @@ var analyzeMediaTool = defineTool({
   name: "inspect_media",
   category: "analyze",
   cost: "low",
+  title: "Inspect Media with AI",
+  annotations: { readOnly: true, openWorld: true },
   description: "Analyze media (image, video, or YouTube URL) using Gemini AI. Requires GOOGLE_API_KEY.",
   schema: z5.object({
     source: z5.string().describe("Path to image/video or YouTube URL"),
@@ -491382,6 +491450,8 @@ var analyzeVideoTool = defineTool({
   name: "inspect_video",
   category: "analyze",
   cost: "low",
+  title: "Inspect Video with AI",
+  annotations: { readOnly: true, openWorld: true },
   description: "Analyze video content using Gemini AI with temporal understanding. Requires GOOGLE_API_KEY.",
   schema: z5.object({
     source: z5.string().describe("Path to video file"),
@@ -491410,6 +491480,8 @@ var analyzeReviewTool = defineTool({
   name: "inspect_review",
   category: "analyze",
   cost: "low",
+  title: "Review Video with AI",
+  annotations: { readOnly: false, openWorld: true },
   description: "AI video review: analyzes quality, suggests fixes, and optionally auto-applies them. Requires GOOGLE_API_KEY.",
   schema: z5.object({
     videoPath: z5.string().describe("Path to the video file to review"),
@@ -491438,6 +491510,8 @@ var analyzeSuggestTool = defineTool({
   name: "inspect_suggest",
   category: "analyze",
   cost: "low",
+  title: "Suggest Edits with AI",
+  annotations: { readOnly: false, openWorld: true },
   description: "Get natural-language edit suggestions for a project from Gemini. Returns suggestions array with type/confidence/clipIds. With `apply: true`, applies the first suggestion in place. Requires GOOGLE_API_KEY.",
   schema: z5.object({
     projectPath: z5.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -491486,6 +491560,8 @@ var generateMotionTool = defineTool({
   name: "generate_motion",
   category: "generate",
   cost: "low",
+  title: "Generate Motion Graphics",
+  annotations: { readOnly: false, openWorld: true },
   description: "Generate standalone motion graphics using Claude or Gemini + Remotion. For overlays on an existing video, prefer edit_motion_overlay. Requires ANTHROPIC_API_KEY (Claude) or GOOGLE_API_KEY (Gemini).",
   schema: z6.object({
     description: z6.string().describe("Description of the motion graphic to generate"),
@@ -491525,6 +491601,8 @@ var generateSpeechTool = defineTool({
   name: "generate_speech",
   category: "generate",
   cost: "low",
+  title: "Generate Speech Audio",
+  annotations: { readOnly: false, openWorld: true },
   description: "Generate speech from text using ElevenLabs TTS. Requires ELEVENLABS_API_KEY.",
   schema: z6.object({
     text: z6.string().describe("Text to convert to speech"),
@@ -491545,6 +491623,8 @@ var generateNarrationTool = defineTool({
   name: "generate_narration",
   category: "generate",
   cost: "low",
+  title: "Generate Narration Audio",
+  annotations: { readOnly: false, openWorld: true },
   description: "Generate narration from text using ElevenLabs TTS. Product-facing alias for generate_speech. Requires ELEVENLABS_API_KEY.",
   schema: z6.object({
     text: z6.string().describe("Narration text to convert to speech"),
@@ -491569,6 +491649,8 @@ var generateSoundEffectTool = defineTool({
   name: "generate_sound_effect",
   category: "generate",
   cost: "low",
+  title: "Generate Sound Effect",
+  annotations: { readOnly: false, openWorld: true },
   description: "Generate sound effects using ElevenLabs. Requires ELEVENLABS_API_KEY.",
   schema: z6.object({
     prompt: z6.string().describe("Description of the sound effect"),
@@ -491590,6 +491672,8 @@ var generateMusicTool = defineTool({
   name: "generate_music",
   category: "generate",
   cost: "low",
+  title: "Generate Music",
+  annotations: { readOnly: false, openWorld: true },
   description: "Generate background music from text prompt. ElevenLabs (default, up to 10min) or Replicate MusicGen (max 30s). Requires ELEVENLABS_API_KEY or REPLICATE_API_TOKEN.",
   schema: z6.object({
     prompt: z6.string().describe("Description of the music to generate"),
@@ -491635,6 +491719,8 @@ var generateMusicStatusTool = defineTool({
   name: "generate_music_status",
   category: "generate",
   cost: "free",
+  title: "Check Music Generation Status",
+  annotations: { readOnly: true, openWorld: true },
   description: "Check Replicate music generation task status. `generate_music` returns a task id; this tool polls it until the audio URL is ready. Requires REPLICATE_API_TOKEN.",
   schema: z6.object({
     taskId: z6.string().describe("Task ID returned from generate_music")
@@ -491658,6 +491744,8 @@ var generateImageTool = defineTool({
   name: "generate_image",
   category: "generate",
   cost: "low",
+  title: "Generate Image",
+  annotations: { readOnly: false, openWorld: true },
   description: "Generate an image using AI. Supports Gemini (free), OpenAI GPT Image, or Grok Imagine. Requires GOOGLE_API_KEY (Gemini), OPENAI_API_KEY (OpenAI), or XAI_API_KEY (Grok).",
   schema: z6.object({
     prompt: z6.string().describe("Image description prompt"),
@@ -491691,6 +491779,8 @@ var generateStoryboardTool = defineTool({
   name: "generate_storyboard",
   category: "generate",
   cost: "low",
+  title: "Generate Storyboard",
+  annotations: { readOnly: false, openWorld: true },
   description: "Generate a video storyboard from text content using Claude. Returns scene segments with descriptions, visuals, and narration. Requires ANTHROPIC_API_KEY.",
   schema: z6.object({
     content: z6.string().describe("Text content to analyze (script, article, etc.)"),
@@ -491714,6 +491804,8 @@ var generateBackgroundTool = defineTool({
   name: "generate_background",
   category: "generate",
   cost: "low",
+  title: "Generate Background Image",
+  annotations: { readOnly: false, openWorld: true },
   description: "Generate a cinematic backdrop image (OpenAI gpt-image-2 / DALL\xB7E variant tuned for video backgrounds). Returns the image URL and, when `output` is provided, downloads the PNG to disk. Requires OPENAI_API_KEY.",
   schema: z6.object({
     description: z6.string().describe("Background description / image prompt."),
@@ -491738,6 +491830,8 @@ var generateThumbnailTool = defineTool({
   name: "generate_thumbnail",
   category: "generate",
   cost: "low",
+  title: "Generate Thumbnail",
+  annotations: { readOnly: false, openWorld: true },
   description: "Extract the best thumbnail frame from a video using Gemini AI analysis. Requires GOOGLE_API_KEY.",
   schema: z6.object({
     videoPath: z6.string().describe("Path to the video file"),
@@ -491759,6 +491853,8 @@ var generateVideoTool = defineTool({
   name: "generate_video",
   category: "generate",
   cost: "high",
+  title: "Generate Video",
+  annotations: { readOnly: false, openWorld: true },
   description: "Generate video using AI. Supports Seedance 2.0 via fal.ai, Grok, Kling, Runway, and Veo. Requires FAL_API_KEY, XAI_API_KEY, KLING_API_KEY, RUNWAY_API_SECRET, or GOOGLE_API_KEY.",
   schema: z6.object({
     prompt: z6.string().describe("Text prompt describing the video"),
@@ -491820,6 +491916,8 @@ var generateVideoStatusTool = defineTool({
   name: "generate_video_status",
   category: "generate",
   cost: "free",
+  title: "Check Video Generation Status",
+  annotations: { readOnly: false, openWorld: true },
   description: "Check video generation status for Grok, Runway, Kling, or Veo tasks.",
   schema: z6.object({
     taskId: z6.string().describe("Task ID from video generation"),
@@ -491850,6 +491948,8 @@ var generateVideoCancelTool = defineTool({
   name: "generate_video_cancel",
   category: "generate",
   cost: "free",
+  title: "Cancel Video Generation",
+  annotations: { readOnly: false, openWorld: true },
   description: "Cancel a Runway video generation task.",
   schema: z6.object({
     taskId: z6.string().describe("Task ID to cancel")
@@ -491868,6 +491968,8 @@ var generateVideoExtendTool = defineTool({
   name: "generate_video_extend",
   category: "generate",
   cost: "high",
+  title: "Extend Generated Video",
+  annotations: { readOnly: false, openWorld: true },
   description: "Extend video duration using Kling or Veo. Requires the video/operation ID from a previous generation.",
   schema: z6.object({
     videoId: z6.string().describe("Video ID (Kling) or operation name (Veo)"),
@@ -492270,6 +492372,8 @@ var storyboardListTool = defineTool({
   name: "storyboard_list",
   category: "storyboard",
   cost: "free",
+  title: "List Storyboard Beats",
+  annotations: { readOnly: true, openWorld: false },
   description: "List beats, ids, durations, and cue blocks from a project's STORYBOARD.md.",
   schema: projectDirSchema,
   async execute(args, ctx) {
@@ -492296,6 +492400,8 @@ var storyboardValidateTool = defineTool({
   name: "storyboard_validate",
   category: "storyboard",
   cost: "free",
+  title: "Validate Storyboard",
+  annotations: { readOnly: true, openWorld: false },
   description: "Validate STORYBOARD.md beat ids and cue blocks.",
   schema: projectDirSchema,
   async execute(args, ctx) {
@@ -492326,6 +492432,8 @@ var storyboardGetTool = defineTool({
   name: "storyboard_get",
   category: "storyboard",
   cost: "free",
+  title: "Get Storyboard Beat",
+  annotations: { readOnly: true, openWorld: false },
   description: "Return one STORYBOARD.md beat as structured data.",
   schema: z7.object({
     projectDir: z7.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -492348,6 +492456,8 @@ var storyboardSetTool = defineTool({
   name: "storyboard_set",
   category: "storyboard",
   cost: "free",
+  title: "Set Storyboard Cue",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   description: "Set or unset one cue on one beat in STORYBOARD.md.",
   schema: z7.object({
     projectDir: z7.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -492384,6 +492494,8 @@ var storyboardMoveTool = defineTool({
   name: "storyboard_move",
   category: "storyboard",
   cost: "free",
+  title: "Reorder Storyboard Beat",
+  annotations: { readOnly: false, openWorld: false },
   description: "Move one beat after another beat in STORYBOARD.md.",
   schema: z7.object({
     projectDir: z7.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -492414,6 +492526,8 @@ var storyboardReviseTool = defineTool({
   name: "storyboard_revise",
   category: "storyboard",
   cost: "low",
+  title: "Revise Storyboard with AI",
+  annotations: { readOnly: false, openWorld: true },
   description: "Revise an existing STORYBOARD.md from a natural-language request. Reads project context, validates the revised storyboard, and writes unless dryRun is true.",
   schema: z7.object({
     projectDir: z7.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -492445,6 +492559,8 @@ var planTool = defineTool({
   name: "plan",
   category: "storyboard",
   cost: "free",
+  title: "Plan Build Cost and Stages",
+  annotations: { readOnly: true, openWorld: false },
   description: "Read STORYBOARD.md and return the build plan, missing artifacts, provider needs, and estimated cost.",
   schema: z7.object({
     projectDir: z7.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -494143,6 +494259,8 @@ var pipelineHighlightsTool = defineTool({
   name: "remix_highlights",
   category: "pipeline",
   cost: "low",
+  title: "Extract Video Highlights",
+  annotations: { readOnly: false, openWorld: true },
   description: "Extract highlight clips from a longer video using AI analysis. Requires OPENAI_API_KEY+ANTHROPIC_API_KEY or GOOGLE_API_KEY (with --use-gemini).",
   schema: z8.object({
     media: z8.string().describe("Path to the input video file"),
@@ -494176,6 +494294,8 @@ var pipelineAutoShortsTool = defineTool({
   name: "remix_auto_shorts",
   category: "pipeline",
   cost: "medium",
+  title: "Generate Auto Shorts",
+  annotations: { readOnly: false, openWorld: true },
   description: "Automatically generate short-form content (Reels/TikTok/Shorts) from a longer video. Same API key requirements as remix_highlights.",
   schema: z8.object({
     video: z8.string().describe("Path to the input video file"),
@@ -494213,6 +494333,8 @@ var pipelineRunTool = defineTool({
   name: "run",
   category: "pipeline",
   cost: "very-high",
+  title: "Run YAML Pipeline",
+  annotations: { readOnly: false, openWorld: true },
   surfaces: ["mcp"],
   description: "Execute a declarative YAML pipeline (Video as Code). Accepts either a file path or inline YAML. Supports dry-run, resume-from-checkpoint, and budget limits. Cost depends on the steps \u2014 use dryRun: true first to preview.",
   schema: z8.object({
@@ -494292,6 +494414,8 @@ var pipelineRegenerateSceneTool = defineTool({
   name: "remix_regenerate_scene",
   category: "pipeline",
   cost: "high",
+  title: "Regenerate Storyboard Scenes",
+  annotations: { readOnly: false, openWorld: true },
   description: "Regenerate specific scenes against an existing storyboard.{yaml,json} on disk. Can regenerate video, image, or narration independently.",
   schema: z8.object({
     projectDir: z8.string().describe("Path to the project output directory containing storyboard.json"),
@@ -494329,6 +494453,8 @@ var detectScenesTool = defineTool({
   name: "detect_scenes",
   category: "detect",
   cost: "free",
+  title: "Detect Scene Cuts",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   description: "Detect scene changes in video using FFmpeg. No API key needed.",
   schema: z9.object({
     videoPath: z9.string().describe("Path to the input video file"),
@@ -494353,6 +494479,8 @@ var detectSilenceTool = defineTool({
   name: "detect_silence",
   category: "detect",
   cost: "free",
+  title: "Detect Silence Periods",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   description: "Detect silence periods in audio/video using FFmpeg. No API key needed.",
   schema: z9.object({
     mediaPath: z9.string().describe("Path to the audio/video file"),
@@ -494374,6 +494502,8 @@ var detectBeatsTool = defineTool({
   name: "detect_beats",
   category: "detect",
   cost: "free",
+  title: "Detect Audio Beats",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   description: "Detect beats in audio for music sync using FFmpeg loudness analysis. No API key needed.",
   schema: z9.object({
     audioPath: z9.string().describe("Path to the audio file"),
@@ -494436,6 +494566,8 @@ var timelineCreateTool = defineTool({
   name: "timeline_create",
   category: "timeline",
   cost: "free",
+  title: "Create Timeline",
+  annotations: { readOnly: false, openWorld: false },
   description: "Create a low-level timeline JSON file for FFmpeg-style editing",
   schema: z10.object({
     name: z10.string().describe("Timeline name or directory path"),
@@ -494466,6 +494598,8 @@ var timelineInfoTool = defineTool({
   name: "timeline_info",
   category: "timeline",
   cost: "free",
+  title: "Get Timeline Info",
+  annotations: { readOnly: true, openWorld: false },
   description: "Get information about a timeline JSON file. Legacy *.vibe.json files are supported.",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file")
@@ -494493,6 +494627,8 @@ var timelineAddSourceTool = defineTool({
   name: "timeline_add_source",
   category: "timeline",
   cost: "free",
+  title: "Add Source to Timeline",
+  annotations: { readOnly: false, openWorld: false },
   description: "Add a media source (video, audio, image) to the timeline",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -494518,6 +494654,8 @@ var timelineAddClipTool = defineTool({
   name: "timeline_add_clip",
   category: "timeline",
   cost: "free",
+  title: "Add Clip to Timeline",
+  annotations: { readOnly: false, openWorld: false },
   description: "Add a clip to the timeline from an existing source",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -494549,6 +494687,8 @@ var timelineSplitClipTool = defineTool({
   name: "timeline_split_clip",
   category: "timeline",
   cost: "free",
+  title: "Split Clip",
+  annotations: { readOnly: false, openWorld: false },
   description: "Split a clip at a specific time",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -494567,6 +494707,8 @@ var timelineTrimClipTool = defineTool({
   name: "timeline_trim_clip",
   category: "timeline",
   cost: "free",
+  title: "Trim Clip",
+  annotations: { readOnly: false, openWorld: false },
   description: "Trim a clip by adjusting its start or end",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -494586,6 +494728,8 @@ var timelineMoveClipTool = defineTool({
   name: "timeline_move_clip",
   category: "timeline",
   cost: "free",
+  title: "Move Clip",
+  annotations: { readOnly: false, openWorld: false },
   description: "Move a clip to a new position or track",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -494608,6 +494752,8 @@ var timelineDeleteClipTool = defineTool({
   name: "timeline_delete_clip",
   category: "timeline",
   cost: "free",
+  title: "Delete Clip",
+  annotations: { readOnly: false, openWorld: false },
   description: "Delete a clip from the timeline",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -494624,6 +494770,8 @@ var timelineDuplicateClipTool = defineTool({
   name: "timeline_duplicate_clip",
   category: "timeline",
   cost: "free",
+  title: "Duplicate Clip",
+  annotations: { readOnly: false, openWorld: false },
   description: "Duplicate a clip on the timeline (optionally at a new start time)",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -494642,6 +494790,8 @@ var timelineAddEffectTool = defineTool({
   name: "timeline_add_effect",
   category: "timeline",
   cost: "free",
+  title: "Add Effect to Clip",
+  annotations: { readOnly: false, openWorld: false },
   description: "Add an effect to a clip",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -494668,6 +494818,8 @@ var timelineAddTrackTool = defineTool({
   name: "timeline_add_track",
   category: "timeline",
   cost: "free",
+  title: "Add Track to Timeline",
+  annotations: { readOnly: false, openWorld: false },
   description: "Add a new track to the timeline",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -494694,6 +494846,8 @@ var timelineListTool = defineTool({
   name: "timeline_list",
   category: "timeline",
   cost: "free",
+  title: "List Timeline Contents",
+  annotations: { readOnly: true, openWorld: false },
   description: "List all sources, tracks, and clips in a project",
   schema: z10.object({
     projectPath: z10.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file")
@@ -494736,6 +494890,8 @@ var projectCreateTool = defineTool({
   name: "project_create",
   category: "project",
   cost: "free",
+  title: "Create Project",
+  annotations: { readOnly: false, openWorld: false },
   description: "Deprecated alias for creating low-level timeline state. Prefer timeline_create.",
   schema: z11.object({
     name: z11.string().describe("Project name"),
@@ -494760,6 +494916,8 @@ var projectInfoTool = defineTool({
   name: "project_info",
   category: "project",
   cost: "free",
+  title: "Get Project Info",
+  annotations: { readOnly: true, openWorld: false },
   description: "Deprecated alias for timeline_info. Legacy *.vibe.json files remain supported.",
   schema: z11.object({
     projectPath: z11.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file")
@@ -495647,6 +495805,8 @@ var exportVideoTool = defineTool({
   name: "export_video",
   category: "export",
   cost: "free",
+  title: "Export Timeline to Video",
+  annotations: { readOnly: false, openWorld: false },
   description: "Export a VibeFrame timeline to a video file (MP4, WebM, or MOV). Requires FFmpeg.",
   schema: z12.object({
     projectPath: z12.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -495738,6 +495898,8 @@ var fsListTool = defineTool({
   name: "fs_list",
   category: "agent-only",
   cost: "free",
+  title: "List Files",
+  annotations: { readOnly: true, openWorld: false },
   surfaces: ["agent"],
   description: "List files and directories in a path",
   schema: z13.object({
@@ -495771,6 +495933,8 @@ var fsReadTool = defineTool({
   name: "fs_read",
   category: "agent-only",
   cost: "free",
+  title: "Read File",
+  annotations: { readOnly: true, openWorld: false },
   surfaces: ["agent"],
   description: "Read contents of a text file",
   schema: z13.object({
@@ -495793,6 +495957,8 @@ var fsWriteTool = defineTool({
   name: "fs_write",
   category: "agent-only",
   cost: "free",
+  title: "Write File",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Write content to a file",
   schema: z13.object({
@@ -495813,6 +495979,8 @@ var fsExistsTool = defineTool({
   name: "fs_exists",
   category: "agent-only",
   cost: "free",
+  title: "Check Path Exists",
+  annotations: { readOnly: true, openWorld: false },
   surfaces: ["agent"],
   description: "Check if a file or directory exists",
   schema: z13.object({
@@ -495834,6 +496002,8 @@ var batchImportTool = defineTool({
   name: "batch_import",
   category: "agent-only",
   cost: "free",
+  title: "Batch Import Media",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Import multiple media files from a directory into a project. Scans directory for video, audio, and image files.",
   schema: z13.object({
@@ -495903,6 +496073,8 @@ var batchConcatTool = defineTool({
   name: "batch_concat",
   category: "agent-only",
   cost: "free",
+  title: "Batch Concatenate Sources",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Concatenate multiple sources into sequential clips on the timeline",
   schema: z13.object({
@@ -495972,6 +496144,8 @@ var batchApplyEffectTool = defineTool({
   name: "batch_apply_effect",
   category: "agent-only",
   cost: "free",
+  title: "Batch Apply Effect",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Apply an effect to multiple clips at once",
   schema: z13.object({
@@ -496028,6 +496202,8 @@ var timelineClearTool = defineTool({
   name: "timeline_clear",
   category: "agent-only",
   cost: "free",
+  title: "Clear Timeline",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Clear timeline contents (remove clips, tracks, or sources)",
   schema: z13.object({
@@ -496102,6 +496278,8 @@ var projectSetTool = defineTool({
   name: "project_set",
   category: "agent-only",
   cost: "free",
+  title: "Update Project Settings",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   surfaces: ["agent"],
   description: "Update timeline settings (name, aspect ratio, frame rate)",
   schema: z13.object({
@@ -496147,6 +496325,8 @@ var projectOpenTool = defineTool({
   name: "project_open",
   category: "agent-only",
   cost: "free",
+  title: "Open Project",
+  annotations: { readOnly: false, idempotent: true, openWorld: false },
   surfaces: ["agent"],
   description: "Open an existing project and set it as the current context",
   schema: z13.object({
@@ -496185,6 +496365,8 @@ var projectSaveTool = defineTool({
   name: "project_save",
   category: "agent-only",
   cost: "free",
+  title: "Save Project",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Save the current project (uses ctx.agent.projectPath if no path given)",
   schema: z13.object({
@@ -496219,6 +496401,8 @@ var exportAudioTool = defineTool({
   name: "export_audio",
   category: "agent-only",
   cost: "free",
+  title: "Export Audio",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Export audio track from a project. Not implemented \u2014 use export_video then strip audio with FFmpeg.",
   schema: z13.object({
@@ -496237,6 +496421,8 @@ var exportSubtitlesTool = defineTool({
   name: "export_subtitles",
   category: "agent-only",
   cost: "free",
+  title: "Export Subtitles",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Export subtitles from transcription. Not implemented \u2014 use audio_transcribe to generate subtitles from audio.",
   schema: z13.object({
@@ -496255,6 +496441,8 @@ var mediaInfoTool = defineTool({
   name: "media_info",
   category: "agent-only",
   cost: "free",
+  title: "Get Media Info",
+  annotations: { readOnly: true, openWorld: false },
   surfaces: ["agent"],
   description: "Get information about a media file (duration, resolution, codec, etc.)",
   schema: z13.object({
@@ -496339,6 +496527,8 @@ var mediaCompressTool = defineTool({
   name: "media_compress",
   category: "agent-only",
   cost: "free",
+  title: "Compress Media",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Compress a video or audio file using FFmpeg",
   schema: z13.object({
@@ -496400,6 +496590,8 @@ var mediaConvertTool = defineTool({
   name: "media_convert",
   category: "agent-only",
   cost: "free",
+  title: "Convert Media",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Convert media file to a different format using FFmpeg",
   schema: z13.object({
@@ -496447,6 +496639,8 @@ var mediaConcatTool = defineTool({
   name: "media_concat",
   category: "agent-only",
   cost: "free",
+  title: "Concatenate Media Files",
+  annotations: { readOnly: false, openWorld: false },
   surfaces: ["agent"],
   description: "Concatenate multiple media files into one using FFmpeg",
   schema: z13.object({
@@ -496986,6 +497180,8 @@ var guideTool = defineTool({
   name: "guide",
   category: "agent",
   cost: "free",
+  title: "Load Workflow Guide",
+  annotations: { readOnly: true, openWorld: false },
   description: "Load the step-by-step guide for a vibe workflow (motion overlays, BUILD scene authoring, YAML pipeline authoring, architecture choices). Universal CLI-equivalent of `vibe guide <topic>` and Claude Code's /vibe-* slash commands. Without a topic, returns the guide catalog for discovery.",
   schema: guideSchema,
   async execute(args) {
@@ -497022,6 +497218,8 @@ var statusJobTool = defineTool({
   name: "status_job",
   category: "status",
   cost: "free",
+  title: "Check Job Status",
+  annotations: { readOnly: false, destructive: false, openWorld: true },
   description: "Read one local async job record and optionally refresh supported provider status. Supports Runway/Kling video and Replicate music live checks. Also tracks long-running MCP build/render jobs (jobType build/render, provider local): their records are updated in-process \u2014 on completion result.payload carries the full tool result; status 'unknown' means the MCP server restarted mid-job (check build-report.json / render-report.json on disk).",
   schema: z15.object({
     jobId: z15.string().describe("Local job id returned by a no-wait command."),
@@ -497057,6 +497255,8 @@ var statusProjectTool = defineTool({
   name: "status_project",
   category: "status",
   cost: "free",
+  title: "Check Project Status",
+  annotations: { readOnly: false, destructive: false, openWorld: true },
   description: "Summarize build-report.json, review-report.json, and local async job records for a VibeFrame project.",
   schema: z15.object({
     projectDir: z15.string().optional().describe(PROJECT_DIR_DESCRIPTION4),
@@ -497313,16 +497513,29 @@ function manifestToMcpTools(manifest2) {
     const inputSchema = zodToJsonSchema(t2.schema);
     return {
       name: t2.name,
+      title: t2.title,
       description: t2.description,
       inputSchema: {
         type: "object",
         properties: inputSchema.properties ?? {},
         required: inputSchema.required ?? [],
         ...inputSchema.description ? { description: inputSchema.description } : {}
-      }
+      },
+      annotations: toMcpAnnotations(t2.annotations)
     };
   });
 }
+function toMcpAnnotations(a2) {
+  if (a2.readOnly) {
+    return { readOnlyHint: true, openWorldHint: a2.openWorld };
+  }
+  return {
+    readOnlyHint: false,
+    destructiveHint: a2.destructive ?? true,
+    ...a2.idempotent !== void 0 ? { idempotentHint: a2.idempotent } : {},
+    openWorldHint: a2.openWorld
+  };
+}
 function buildMcpDispatcher(manifest2) {
   const byName = /* @__PURE__ */ new Map();
   for (const t2 of manifest2) {
@@ -497804,8 +498017,21 @@ This creates a music video-style edit where cuts happen in rhythm with the music
 }
 
 // src/instructions.ts
-import { mkdirSync as mkdirSync13 } from "node:fs";
-import { isAbsolute as isAbsolute9, resolve as resolve78 } from "node:path";
+import { existsSync as existsSync65, mkdirSync as mkdirSync13 } from "node:fs";
+import { delimiter, isAbsolute as isAbsolute9, resolve as resolve78 } from "node:path";
+var DEFAULT_EXTRA_PATH_DIRS = process.platform === "darwin" ? ["/opt/homebrew/bin", "/usr/local/bin", "/opt/local/bin"] : ["/usr/local/bin"];
+function ensureSystemPath(env4 = process.env, extraDirs = DEFAULT_EXTRA_PATH_DIRS) {
+  const current = (env4.PATH ?? "").split(delimiter).filter(Boolean);
+  const added = [];
+  for (const dir of extraDirs) {
+    if (!current.includes(dir) && existsSync65(dir)) {
+      current.push(dir);
+      added.push(dir);
+    }
+  }
+  if (added.length > 0) env4.PATH = current.join(delimiter);
+  return added;
+}
 function scrubUnresolvedUserConfigEnv(env4 = process.env) {
   const removed = [];
   for (const [key2, value] of Object.entries(env4)) {
@@ -497844,7 +498070,8 @@ function buildServerInstructions(cwd = resolveServerWorkspaceRoot()) {
     "When creating projects with init, use a project name or workspace-relative path under the workspace root.",
     "Do not create projects in /tmp, /home/claude, /workspace, or other synthetic roots unless the user explicitly asks.",
     "Before high or very-high cost provider work, run a dry-run or plan when available and ask the user to confirm provider spend.",
-    "When the user's request leaves them unspecified, ask the user before building instead of silently picking defaults: narration provider (kokoro = free local, elevenlabs = cloud credits), backdrop image generation (paid; skipping is free), and visual style (list options via scene_list_styles). Present the choices and wait for the answer."
+    "When the user's request leaves them unspecified, ask the user before building instead of silently picking defaults: narration provider (kokoro = free local, elevenlabs = cloud credits), backdrop image generation (paid; skipping is free), and visual style (list options via scene_list_styles). Present the choices and wait for the answer.",
+    "Narration and backdrop choices are independent \u2014 kokoro narration with OpenAI backdrops is a common combination. Pass each answer explicitly to build (ttsProvider plus skipBackdrop/imageProvider); never let one choice imply the other."
   ].join("\n");
 }
 
@@ -497865,11 +498092,12 @@ console.info = (...args) => console.error(...args);
 console.debug = (...args) => console.error(...args);
 scrubUnresolvedUserConfigEnv();
 applyWorkspaceEnv();
+ensureSystemPath();
 var server2 = new Server(
   {
     name: "vibeframe",
     // Stamped with the package version by build.js at bundle time.
-    version: "0.110.0"
+    version: "0.111.1"
   },
   {
     capabilities: {

package/package.json

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