@vibeframe/cli 0.109.2 → 0.111.0

package/dist/tools/manifest/index.js

@@ -51300,6 +51300,76 @@ function pickOutputPath(data) {
   return typeof candidate === "string" ? candidate : void 0;
 }
 
+// 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;
+}
+
 // src/commands/_shared/visual-styles.ts
 var STYLES = [
   {
@@ -53103,6 +53173,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) {
@@ -53164,6 +53236,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) {
@@ -53214,6 +53288,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) {
@@ -53292,6 +53368,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) {
@@ -53329,6 +53407,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) {
@@ -53409,6 +53489,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) {
@@ -53538,9 +53620,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 ? resolve26(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
     const runBuild = (report) => executeSceneBuild({
       projectDir,
@@ -53568,7 +53675,9 @@ var sceneBuildTool = defineTool({
         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);
     }
@@ -53595,6 +53704,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) {
@@ -53641,6 +53752,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) {
@@ -53683,6 +53796,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) {
@@ -53724,6 +53839,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: external_exports.object({
     audioPath: external_exports.string().describe("Input audio file path"),
@@ -53753,6 +53870,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: external_exports.object({
     audioPath: external_exports.string().describe("Input audio file path"),
@@ -53772,6 +53891,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: external_exports.object({
     samplePaths: external_exports.array(external_exports.string()).describe("Audio sample file paths (1-25 files)"),
@@ -53793,6 +53914,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: external_exports.object({
     mediaPath: external_exports.string().describe("Input media file (video or audio)"),
@@ -53823,6 +53946,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: external_exports.object({
     musicPath: external_exports.string().describe("Background music file path"),
@@ -54119,6 +54244,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the input video file"),
@@ -54149,6 +54276,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the input video file"),
@@ -54173,6 +54302,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the input video file"),
@@ -54196,6 +54327,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: external_exports.object({
     inputPath: external_exports.string().describe("Path to the input media file"),
@@ -54217,6 +54350,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the input video file"),
@@ -54240,6 +54375,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the input video file"),
@@ -54266,6 +54403,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the input video file"),
@@ -54302,6 +54441,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: external_exports.object({
     srtPath: external_exports.string().describe("Path to the input SRT file"),
@@ -54324,6 +54465,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: external_exports.object({
     videoPath: external_exports.string().describe("Input video file path"),
@@ -54346,6 +54489,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: external_exports.object({
     videoPath: external_exports.string().describe("Input video file path (must have audio)"),
@@ -54370,6 +54515,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: external_exports.object({
     videoPath: external_exports.string().describe("Input video file path"),
@@ -54392,6 +54539,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: external_exports.object({
     videoPath: external_exports.string().describe("Input video file path"),
@@ -54414,6 +54563,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: external_exports.object({
     videoPath: external_exports.string().describe("Input video file path"),
@@ -54435,6 +54586,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the input video file"),
@@ -54467,6 +54620,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: external_exports.object({
     imagePaths: external_exports.array(external_exports.string()).describe("Input image file path(s)"),
@@ -54490,6 +54645,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -55972,6 +56129,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: external_exports.object({
     projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION2),
@@ -56006,6 +56165,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: external_exports.object({
     projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION2),
@@ -56070,6 +56231,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: external_exports.object({
     source: external_exports.string().describe("Path to image/video or YouTube URL"),
@@ -56098,6 +56261,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: external_exports.object({
     source: external_exports.string().describe("Path to video file"),
@@ -56126,6 +56291,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the video file to review"),
@@ -56154,6 +56321,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -56201,6 +56370,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: external_exports.object({
     description: external_exports.string().describe("Description of the motion graphic to generate"),
@@ -56240,6 +56411,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: external_exports.object({
     text: external_exports.string().describe("Text to convert to speech"),
@@ -56260,6 +56433,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: external_exports.object({
     text: external_exports.string().describe("Narration text to convert to speech"),
@@ -56284,6 +56459,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: external_exports.object({
     prompt: external_exports.string().describe("Description of the sound effect"),
@@ -56305,6 +56482,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: external_exports.object({
     prompt: external_exports.string().describe("Description of the music to generate"),
@@ -56350,6 +56529,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: external_exports.object({
     taskId: external_exports.string().describe("Task ID returned from generate_music")
@@ -56373,6 +56554,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: external_exports.object({
     prompt: external_exports.string().describe("Image description prompt"),
@@ -56406,6 +56589,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: external_exports.object({
     content: external_exports.string().describe("Text content to analyze (script, article, etc.)"),
@@ -56429,6 +56614,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: external_exports.object({
     description: external_exports.string().describe("Background description / image prompt."),
@@ -56453,6 +56640,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the video file"),
@@ -56474,6 +56663,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: external_exports.object({
     prompt: external_exports.string().describe("Text prompt describing the video"),
@@ -56535,6 +56726,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: external_exports.object({
     taskId: external_exports.string().describe("Task ID from video generation"),
@@ -56565,6 +56758,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: external_exports.object({
     taskId: external_exports.string().describe("Task ID to cancel")
@@ -56583,6 +56778,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: external_exports.object({
     videoId: external_exports.string().describe("Video ID (Kling) or operation name (Veo)"),
@@ -56984,6 +57181,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) {
@@ -57010,6 +57209,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) {
@@ -57040,6 +57241,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: external_exports.object({
     projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -57062,6 +57265,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: external_exports.object({
     projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -57098,6 +57303,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: external_exports.object({
     projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -57128,6 +57335,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: external_exports.object({
     projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -57159,6 +57368,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: external_exports.object({
     projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
@@ -58856,6 +59067,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: external_exports.object({
     media: external_exports.string().describe("Path to the input video file"),
@@ -58889,6 +59102,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: external_exports.object({
     video: external_exports.string().describe("Path to the input video file"),
@@ -58926,6 +59141,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: external_exports.object({
@@ -59005,6 +59222,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: external_exports.object({
     projectDir: external_exports.string().describe("Path to the project output directory containing storyboard.json"),
@@ -59041,6 +59260,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: external_exports.object({
     videoPath: external_exports.string().describe("Path to the input video file"),
@@ -59065,6 +59286,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: external_exports.object({
     mediaPath: external_exports.string().describe("Path to the audio/video file"),
@@ -59086,6 +59309,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: external_exports.object({
     audioPath: external_exports.string().describe("Path to the audio file"),
@@ -59147,6 +59372,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: external_exports.object({
     name: external_exports.string().describe("Timeline name or directory path"),
@@ -59177,6 +59404,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file")
@@ -59204,6 +59433,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -59229,6 +59460,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -59260,6 +59493,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -59278,6 +59513,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -59297,6 +59534,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -59319,6 +59558,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -59335,6 +59576,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -59353,6 +59596,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -59379,6 +59624,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -59405,6 +59652,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file")
@@ -59446,6 +59695,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: external_exports.object({
     name: external_exports.string().describe("Project name"),
@@ -59470,6 +59721,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file")
@@ -60356,6 +60609,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: external_exports.object({
     projectPath: external_exports.string().describe("Path to timeline.json, a timeline directory, or a legacy *.vibe.json file"),
@@ -60446,6 +60701,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: external_exports.object({
@@ -60479,6 +60736,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: external_exports.object({
@@ -60501,6 +60760,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: external_exports.object({
@@ -60521,6 +60782,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: external_exports.object({
@@ -60542,6 +60805,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: external_exports.object({
@@ -60611,6 +60876,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: external_exports.object({
@@ -60680,6 +60947,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: external_exports.object({
@@ -60736,6 +61005,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: external_exports.object({
@@ -60810,6 +61081,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: external_exports.object({
@@ -60855,6 +61128,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: external_exports.object({
@@ -60893,6 +61168,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: external_exports.object({
@@ -60927,6 +61204,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: external_exports.object({
@@ -60945,6 +61224,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: external_exports.object({
@@ -60963,6 +61244,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: external_exports.object({
@@ -61047,6 +61330,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: external_exports.object({
@@ -61108,6 +61393,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: external_exports.object({
@@ -61155,6 +61442,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: external_exports.object({
@@ -61691,6 +61980,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) {
@@ -61726,6 +62017,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: external_exports.object({
     jobId: external_exports.string().describe("Local job id returned by a no-wait command."),
@@ -61761,6 +62054,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: external_exports.object({
     projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION4),