@vibeframe/mcp-server 0.109.2 → 0.111.0

package/README.md

@@ -125,6 +125,21 @@ Claude Code drives `vibe` natively via shell + the scaffolded `AGENTS.md` / `CLA
 claude mcp add vibeframe --scope project -- npx -y @vibeframe/mcp-server
 ```
 
+## Human-in-the-Loop Choices
+
+The server prefers asking over silently picking defaults:
+
+- On hosts that support **MCP elicitation** (Claude Code 2.1.76+), the `build`
+  tool opens a native form before the build starts for any choice the call
+  left unspecified: narration provider (Kokoro free/local vs ElevenLabs),
+  backdrop image generation (skip vs paid OpenAI), and a max cost cap.
+  Declining cancels the build before any provider spend. Set
+  `VIBE_MCP_ELICIT=off` in the server env to disable the form (headless and
+  automation setups).
+- On hosts without elicitation (Claude Desktop today), the server
+  instructions tell the agent to present the same choices in chat and wait
+  for your answer.
+
 ## What You Can Do
 
 Once connected, your MCP host can resolve prompts like these into typed tool calls:
@@ -308,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

@@ -486486,6 +486486,76 @@ function pickOutputPath(data) {
   return typeof candidate === "string" ? candidate : void 0;
 }
 
+// ../cli/src/tools/_shared/elicit.ts
+var NARRATION_CHOICES = ["kokoro", "elevenlabs"];
+var BACKDROP_CHOICES = ["skip", "openai"];
+function planBuildElicitation(args) {
+  const assetsWillRun = args.stage === void 0 || args.stage === "all" || args.stage === "assets";
+  if (!assetsWillRun) return null;
+  const properties = {};
+  const required = [];
+  const narrationUndecided = !args.skipNarration && (args.ttsProvider === void 0 || args.ttsProvider === "auto");
+  if (narrationUndecided) {
+    properties.narration = {
+      type: "string",
+      title: "Narration voice-over",
+      description: "Which TTS engine narrates the video?",
+      enum: [...NARRATION_CHOICES],
+      enumNames: [
+        "Kokoro \u2014 free, runs locally on this machine",
+        "ElevenLabs \u2014 cloud TTS, uses your ElevenLabs credits"
+      ]
+    };
+    required.push("narration");
+  }
+  if (args.skipBackdrop === void 0 && args.imageProvider === void 0) {
+    properties.backdrop_images = {
+      type: "string",
+      title: "Backdrop images",
+      description: "Generate AI background images for each scene?",
+      enum: [...BACKDROP_CHOICES],
+      enumNames: [
+        "Skip \u2014 free, pure typographic scenes",
+        "OpenAI \u2014 paid image generation (roughly $1-3 per video)"
+      ]
+    };
+    required.push("backdrop_images");
+  }
+  if (args.maxCostUsd === void 0) {
+    properties.max_cost_usd = {
+      type: "number",
+      title: "Max provider spend (USD)",
+      description: "Abort before any paid provider call when the estimate exceeds this cap. Leave empty for no cap.",
+      minimum: 0
+    };
+  }
+  if (Object.keys(properties).length === 0) return null;
+  return {
+    message: "VibeFrame is about to build this video. Choose how the assets are generated:",
+    requestedSchema: { type: "object", properties, required }
+  };
+}
+function applyElicitationAnswers(args, content) {
+  if (!content) return args;
+  const next = { ...args };
+  const narration = content.narration;
+  if (typeof narration === "string" && NARRATION_CHOICES.includes(narration)) {
+    next.ttsProvider = narration;
+  }
+  const backdrop = content.backdrop_images;
+  if (backdrop === "skip") {
+    next.skipBackdrop = true;
+  } else if (backdrop === "openai") {
+    next.skipBackdrop = false;
+    next.imageProvider = "openai";
+  }
+  const cap = content.max_cost_usd;
+  if (typeof cap === "number" && Number.isFinite(cap) && cap >= 0) {
+    next.maxCostUsd = cap;
+  }
+  return next;
+}
+
 // ../cli/src/commands/_shared/visual-styles.ts
 var STYLES = [
   {
@@ -488289,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) {
@@ -488350,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) {
@@ -488400,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) {
@@ -488478,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) {
@@ -488515,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) {
@@ -488595,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) {
@@ -488724,9 +488806,34 @@ var sceneBuildTool = defineTool({
   name: "build",
   category: "scene",
   cost: "high",
-  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.",
+  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) {
+    let warnings;
+    if (ctx.surface === "mcp" && ctx.elicit) {
+      const form = planBuildElicitation(args);
+      if (form) {
+        const outcome = await ctx.elicit(form).catch(() => null);
+        if (outcome === null) {
+          warnings = ["Asset-choice elicitation failed or timed out; proceeding with defaults."];
+        } else if (outcome.action === "accept") {
+          args = applyElicitationAnswers(args, outcome.content);
+        } else {
+          return {
+            success: false,
+            error: "Build cancelled \u2014 the user declined the asset choices.",
+            data: {
+              cancelled: true,
+              retryWith: [
+                `build { projectDir: "${args.projectDir ?? "."}", ttsProvider: "kokoro", skipBackdrop: true }`
+              ]
+            }
+          };
+        }
+      }
+    }
     const projectDir = args.projectDir ? resolve34(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
     const runBuild = (report) => executeSceneBuild({
       projectDir,
@@ -488754,7 +488861,9 @@ var sceneBuildTool = defineTool({
         ctx.onProgress?.({ message: update2.message ?? update2.stage });
         report(update2);
       }
-    }).then(mapBuildResultToToolResult);
+    }).then(mapBuildResultToToolResult).then(
+      (result) => warnings === void 0 ? result : { ...result, data: { ...result.data, elicitationWarnings: warnings } }
+    );
     if (ctx.surface !== "mcp") {
       return runBuild(() => void 0);
     }
@@ -488781,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) {
@@ -488827,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) {
@@ -488869,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) {
@@ -488911,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"),
@@ -488940,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"),
@@ -488959,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)"),
@@ -488980,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)"),
@@ -489010,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"),
@@ -489307,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"),
@@ -489337,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"),
@@ -489361,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"),
@@ -489384,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"),
@@ -489405,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"),
@@ -489428,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"),
@@ -489454,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"),
@@ -489490,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"),
@@ -489512,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"),
@@ -489534,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)"),
@@ -489558,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"),
@@ -489580,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"),
@@ -489602,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"),
@@ -489623,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"),
@@ -489655,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)"),
@@ -489678,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"),
@@ -491161,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),
@@ -491195,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),
@@ -491259,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"),
@@ -491287,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"),
@@ -491315,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"),
@@ -491343,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"),
@@ -491391,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"),
@@ -491430,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"),
@@ -491450,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"),
@@ -491474,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"),
@@ -491495,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"),
@@ -491540,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")
@@ -491563,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"),
@@ -491596,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.)"),
@@ -491619,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."),
@@ -491643,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"),
@@ -491664,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"),
@@ -491725,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"),
@@ -491755,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")
@@ -491773,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)"),
@@ -492175,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) {
@@ -492201,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) {
@@ -492231,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),
@@ -492253,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),
@@ -492289,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),
@@ -492319,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),
@@ -492350,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),
@@ -494048,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"),
@@ -494081,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"),
@@ -494118,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({
@@ -494197,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"),
@@ -494234,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"),
@@ -494258,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"),
@@ -494279,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"),
@@ -494341,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"),
@@ -494371,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")
@@ -494398,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"),
@@ -494423,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"),
@@ -494454,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"),
@@ -494472,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"),
@@ -494491,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"),
@@ -494513,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"),
@@ -494529,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"),
@@ -494547,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"),
@@ -494573,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"),
@@ -494599,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")
@@ -494641,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"),
@@ -494665,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")
@@ -495552,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"),
@@ -495643,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({
@@ -495676,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({
@@ -495698,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({
@@ -495718,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({
@@ -495739,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({
@@ -495808,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({
@@ -495877,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({
@@ -495933,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({
@@ -496007,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({
@@ -496052,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({
@@ -496090,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({
@@ -496124,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({
@@ -496142,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({
@@ -496160,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({
@@ -496244,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({
@@ -496305,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({
@@ -496352,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({
@@ -496891,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) {
@@ -496927,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."),
@@ -496962,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),
@@ -497218,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) {
@@ -497252,7 +497560,8 @@ function buildMcpDispatcher(manifest2) {
         () => tool.execute(parsed.data, {
           workingDirectory: process.cwd(),
           surface: "mcp",
-          ...extra?.onProgress ? { onProgress: sink.send } : {}
+          ...extra?.onProgress ? { onProgress: sink.send } : {},
+          ...extra?.elicit ? { elicit: extra.elicit } : {}
         })
       );
       const text = result.success ? JSON.stringify({ success: true, ...result.data }) : result.data ? JSON.stringify({
@@ -497747,10 +498056,22 @@ function buildServerInstructions(cwd = resolveServerWorkspaceRoot()) {
     "For args named dir, projectDir, output, videoPath, or source, prefer workspace-relative paths unless the user explicitly provides an absolute path.",
     "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."
+    "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."
   ].join("\n");
 }
 
+// src/elicit.ts
+var ELICIT_TIMEOUT_MS = 6e5;
+function makeElicitFn(server3, env4 = process.env) {
+  if ((env4.VIBE_MCP_ELICIT ?? "").toLowerCase() === "off") return void 0;
+  if (!server3.getClientCapabilities()?.elicitation) return void 0;
+  return (form) => server3.elicitInput(
+    { mode: "form", message: form.message, requestedSchema: form.requestedSchema },
+    { timeout: ELICIT_TIMEOUT_MS }
+  );
+}
+
 // src/index.ts
 console.log = (...args) => console.error(...args);
 console.info = (...args) => console.error(...args);
@@ -497761,7 +498082,7 @@ var server2 = new Server(
   {
     name: "vibeframe",
     // Stamped with the package version by build.js at bundle time.
-    version: "0.109.2"
+    version: "0.111.0"
   },
   {
     capabilities: {
@@ -497778,20 +498099,28 @@ server2.setRequestHandler(ListToolsRequestSchema, async () => {
 server2.setRequestHandler(CallToolRequestSchema, async (request5, extra) => {
   const { name, arguments: args } = request5.params;
   const progressToken = request5.params._meta?.progressToken;
+  const elicit = makeElicitFn(server2);
   return handleToolCall(
     name,
     args || {},
-    progressToken === void 0 ? void 0 : {
-      onProgress: ({ progress, total, message }) => {
-        void extra.sendNotification({
-          method: "notifications/progress",
-          params: {
-            progressToken,
-            progress: progress ?? 0,
-            ...total !== void 0 ? { total } : {},
-            ...message ? { message } : {}
-          }
-        }).catch(() => void 0);
+    progressToken === void 0 && elicit === void 0 ? void 0 : {
+      ...elicit ? { elicit } : {},
+      ...progressToken === void 0 ? {} : {
+        onProgress: ({
+          progress,
+          total,
+          message
+        }) => {
+          void extra.sendNotification({
+            method: "notifications/progress",
+            params: {
+              progressToken,
+              progress: progress ?? 0,
+              ...total !== void 0 ? { total } : {},
+              ...message ? { message } : {}
+            }
+          }).catch(() => void 0);
+        }
       }
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.109.2",
+  "version": "0.111.0",
   "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.109.2",
-    "@vibeframe/cli": "0.109.2"
+    "@vibeframe/cli": "0.111.0",
+    "@vibeframe/core": "0.111.0"
   },
   "engines": {
     "node": ">=20"