@vibeframe/cli 0.109.2 → 0.111.0

package/dist/index.js

@@ -67838,6 +67838,82 @@ var init_long_poll = __esm({
   }
 });
 
+// src/tools/_shared/elicit.ts
+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;
+}
+var NARRATION_CHOICES, BACKDROP_CHOICES;
+var init_elicit = __esm({
+  "src/tools/_shared/elicit.ts"() {
+    "use strict";
+    NARRATION_CHOICES = ["kokoro", "elevenlabs"];
+    BACKDROP_CHOICES = ["skip", "openai"];
+  }
+});
+
 // src/tools/manifest/scene.ts
 import { resolve as resolve75, relative as relative12 } from "node:path";
 function summariseLint(result) {
@@ -67976,6 +68052,7 @@ var init_scene2 = __esm({
     init_zod();
     init_define_tool();
     init_long_poll();
+    init_elicit();
     init_visual_styles();
     init_scene_project();
     init_scene();
@@ -68003,6 +68080,8 @@ var init_scene2 = __esm({
       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) {
@@ -68064,6 +68143,8 @@ var init_scene2 = __esm({
       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) {
@@ -68114,6 +68195,8 @@ var init_scene2 = __esm({
       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) {
@@ -68171,6 +68254,8 @@ var init_scene2 = __esm({
       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) {
@@ -68208,6 +68293,8 @@ var init_scene2 = __esm({
       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) {
@@ -68244,6 +68331,8 @@ var init_scene2 = __esm({
       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) {
@@ -68309,9 +68398,34 @@ var init_scene2 = __esm({
       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 ? resolve75(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const runBuild = (report) => executeSceneBuild({
           projectDir,
@@ -68339,7 +68453,9 @@ var init_scene2 = __esm({
             ctx.onProgress?.({ message: update.message ?? update.stage });
             report(update);
           }
-        }).then(mapBuildResultToToolResult);
+        }).then(mapBuildResultToToolResult).then(
+          (result) => warnings === void 0 ? result : { ...result, data: { ...result.data, elicitationWarnings: warnings } }
+        );
         if (ctx.surface !== "mcp") {
           return runBuild(() => void 0);
         }
@@ -68366,6 +68482,8 @@ var init_scene2 = __esm({
       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) {
@@ -68412,6 +68530,8 @@ var init_scene2 = __esm({
       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) {
@@ -68454,6 +68574,8 @@ var init_scene2 = __esm({
       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) {
@@ -68503,6 +68625,8 @@ var init_audio2 = __esm({
       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: external_exports.object({
         audioPath: external_exports.string().describe("Input audio file path"),
@@ -68532,6 +68656,8 @@ var init_audio2 = __esm({
       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: external_exports.object({
         audioPath: external_exports.string().describe("Input audio file path"),
@@ -68551,6 +68677,8 @@ var init_audio2 = __esm({
       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: external_exports.object({
         samplePaths: external_exports.array(external_exports.string()).describe("Audio sample file paths (1-25 files)"),
@@ -68572,6 +68700,8 @@ var init_audio2 = __esm({
       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: external_exports.object({
         mediaPath: external_exports.string().describe("Input media file (video or audio)"),
@@ -68602,6 +68732,8 @@ var init_audio2 = __esm({
       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: external_exports.object({
         musicPath: external_exports.string().describe("Background music file path"),
@@ -68647,6 +68779,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the input video file"),
@@ -68677,6 +68811,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the input video file"),
@@ -68701,6 +68837,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the input video file"),
@@ -68724,6 +68862,8 @@ var init_edit = __esm({
       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: external_exports.object({
         inputPath: external_exports.string().describe("Path to the input media file"),
@@ -68745,6 +68885,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the input video file"),
@@ -68768,6 +68910,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the input video file"),
@@ -68794,6 +68938,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the input video file"),
@@ -68830,6 +68976,8 @@ var init_edit = __esm({
       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: external_exports.object({
         srtPath: external_exports.string().describe("Path to the input SRT file"),
@@ -68852,6 +69000,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Input video file path"),
@@ -68874,6 +69024,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Input video file path (must have audio)"),
@@ -68898,6 +69050,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Input video file path"),
@@ -68920,6 +69074,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Input video file path"),
@@ -68942,6 +69098,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Input video file path"),
@@ -68963,6 +69121,8 @@ var init_edit = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the input video file"),
@@ -68995,6 +69155,8 @@ var init_edit = __esm({
       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: external_exports.object({
         imagePaths: external_exports.array(external_exports.string()).describe("Input image file path(s)"),
@@ -69018,6 +69180,8 @@ var init_edit = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -69142,6 +69306,8 @@ var init_inspect = __esm({
       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: external_exports.object({
         projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION2),
@@ -69176,6 +69342,8 @@ var init_inspect = __esm({
       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: external_exports.object({
         projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION2),
@@ -69240,6 +69408,8 @@ var init_inspect = __esm({
       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: external_exports.object({
         source: external_exports.string().describe("Path to image/video or YouTube URL"),
@@ -69268,6 +69438,8 @@ var init_inspect = __esm({
       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: external_exports.object({
         source: external_exports.string().describe("Path to video file"),
@@ -69296,6 +69468,8 @@ var init_inspect = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the video file to review"),
@@ -69324,6 +69498,8 @@ var init_inspect = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -69379,6 +69555,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         description: external_exports.string().describe("Description of the motion graphic to generate"),
@@ -69418,6 +69596,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         text: external_exports.string().describe("Text to convert to speech"),
@@ -69438,6 +69618,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         text: external_exports.string().describe("Narration text to convert to speech"),
@@ -69462,6 +69644,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         prompt: external_exports.string().describe("Description of the sound effect"),
@@ -69483,6 +69667,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         prompt: external_exports.string().describe("Description of the music to generate"),
@@ -69528,6 +69714,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         taskId: external_exports.string().describe("Task ID returned from generate_music")
@@ -69551,6 +69739,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         prompt: external_exports.string().describe("Image description prompt"),
@@ -69584,6 +69774,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         content: external_exports.string().describe("Text content to analyze (script, article, etc.)"),
@@ -69607,6 +69799,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         description: external_exports.string().describe("Background description / image prompt."),
@@ -69631,6 +69825,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the video file"),
@@ -69652,6 +69848,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         prompt: external_exports.string().describe("Text prompt describing the video"),
@@ -69713,6 +69911,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         taskId: external_exports.string().describe("Task ID from video generation"),
@@ -69743,6 +69943,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         taskId: external_exports.string().describe("Task ID to cancel")
@@ -69761,6 +69963,8 @@ var init_generate2 = __esm({
       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: external_exports.object({
         videoId: external_exports.string().describe("Video ID (Kling) or operation name (Veo)"),
@@ -69836,6 +70040,8 @@ var init_storyboard2 = __esm({
       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) {
@@ -69862,6 +70068,8 @@ var init_storyboard2 = __esm({
       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) {
@@ -69892,6 +70100,8 @@ var init_storyboard2 = __esm({
       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: external_exports.object({
         projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -69914,6 +70124,8 @@ var init_storyboard2 = __esm({
       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: external_exports.object({
         projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -69950,6 +70162,8 @@ var init_storyboard2 = __esm({
       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: external_exports.object({
         projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -69980,6 +70194,8 @@ var init_storyboard2 = __esm({
       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: external_exports.object({
         projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -70011,6 +70227,8 @@ var init_storyboard2 = __esm({
       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: external_exports.object({
         projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -70091,6 +70309,8 @@ var init_remix = __esm({
       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: external_exports.object({
         media: external_exports.string().describe("Path to the input video file"),
@@ -70124,6 +70344,8 @@ var init_remix = __esm({
       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: external_exports.object({
         video: external_exports.string().describe("Path to the input video file"),
@@ -70161,6 +70383,8 @@ var init_remix = __esm({
       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: external_exports.object({
@@ -70240,6 +70464,8 @@ var init_remix = __esm({
       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: external_exports.object({
         projectDir: external_exports.string().describe("Path to the project output directory containing storyboard.json"),
@@ -70284,6 +70510,8 @@ var init_detect2 = __esm({
       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: external_exports.object({
         videoPath: external_exports.string().describe("Path to the input video file"),
@@ -70308,6 +70536,8 @@ var init_detect2 = __esm({
       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: external_exports.object({
         mediaPath: external_exports.string().describe("Path to the audio/video file"),
@@ -70329,6 +70559,8 @@ var init_detect2 = __esm({
       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: external_exports.object({
         audioPath: external_exports.string().describe("Path to the audio file"),
@@ -70402,6 +70634,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         name: external_exports.string().describe("Timeline name or directory path"),
@@ -70432,6 +70666,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file")
@@ -70459,6 +70695,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -70484,6 +70722,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -70515,6 +70755,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -70533,6 +70775,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -70552,6 +70796,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -70574,6 +70820,8 @@ var init_timeline = __esm({
       name: "timeline_delete_clip",
       category: "timeline",
       cost: "free",
+      title: "Delete Clip",
+      annotations: { readOnly: false, openWorld: false },
       description: "Delete a clip from the timeline",
       schema: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -70590,6 +70838,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -70608,6 +70858,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -70634,6 +70886,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -70660,6 +70914,8 @@ var init_timeline = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file")
@@ -70710,6 +70966,8 @@ var init_project2 = __esm({
       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: external_exports.object({
         name: external_exports.string().describe("Project name"),
@@ -70734,6 +70992,8 @@ var init_project2 = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file")
@@ -71633,6 +71893,8 @@ var init_export2 = __esm({
       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: external_exports.object({
         projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -71732,6 +71994,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -71765,6 +72029,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -71787,6 +72053,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -71807,6 +72075,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -71828,6 +72098,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -71897,6 +72169,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -71966,6 +72240,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -72022,6 +72298,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -72096,6 +72374,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -72141,6 +72421,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -72179,6 +72461,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -72213,6 +72497,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -72231,6 +72517,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -72249,6 +72537,8 @@ var init_agent_only = __esm({
       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: external_exports.object({
@@ -72333,6 +72623,8 @@ Audio:`);
       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: external_exports.object({
@@ -72394,6 +72686,8 @@ Audio:`);
       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: external_exports.object({
@@ -72441,6 +72735,8 @@ Audio:`);
       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: external_exports.object({
@@ -72541,6 +72837,8 @@ var init_walkthrough = __esm({
       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) {
@@ -72584,6 +72882,8 @@ var init_status = __esm({
       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: external_exports.object({
         jobId: external_exports.string().describe("Local job id returned by a no-wait command."),
@@ -72619,6 +72919,8 @@ var init_status = __esm({
       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: external_exports.object({
         projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION4),
@@ -72911,7 +73213,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.109.2",
+  version: "0.111.0",
   description: "VibeFrame CLI - agentic video workflow runtime",
   private: false,
   license: "MIT",