@vibeframe/cli 0.110.0 → 0.111.1

package/dist/tools/manifest/index.js

@@ -53173,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) {
@@ -53234,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) {
@@ -53284,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) {
@@ -53362,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) {
@@ -53399,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) {
@@ -53479,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) {
@@ -53608,6 +53620,8 @@ var sceneBuildTool = defineTool({
   name: "build",
   category: "scene",
   cost: "high",
+  title: "Build Video from Storyboard",
+  annotations: { readOnly: false, openWorld: true },
   description: "v0.60 one-shot orchestrator: read STORYBOARD.md per-beat YAML cues (narration / backdrop / duration), dispatch TTS + image generation per beat, compose scene HTML via the compose-scenes-with-skills pipeline, then render to MP4. Use this instead of chaining init + scene_add + render manually. Caches by SHA256 of (DESIGN.md + cue body) so re-runs are idempotent and cheap. Long runs: over MCP, calls exceeding ~45s return immediately with { promoted: true, jobId, status: 'running' } \u2014 poll status_job every 15-30s until completed/failed instead of re-invoking build. Emits MCP progress notifications when the client supplies a progressToken. When the MCP host supports elicitation, unspecified asset choices (narration provider, backdrop images, cost cap) are confirmed with the user via a form before the build starts.",
   schema: sceneBuildSchema,
   async execute(args, ctx) {
@@ -53690,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) {
@@ -53736,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) {
@@ -53778,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) {
@@ -53819,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"),
@@ -53848,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"),
@@ -53867,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)"),
@@ -53888,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)"),
@@ -53918,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"),
@@ -54214,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"),
@@ -54244,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"),
@@ -54268,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"),
@@ -54291,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"),
@@ -54312,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"),
@@ -54335,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"),
@@ -54361,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"),
@@ -54397,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"),
@@ -54419,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"),
@@ -54441,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)"),
@@ -54465,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"),
@@ -54487,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"),
@@ -54509,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"),
@@ -54530,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"),
@@ -54562,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)"),
@@ -54585,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"),
@@ -56067,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),
@@ -56101,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),
@@ -56165,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"),
@@ -56193,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"),
@@ -56221,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"),
@@ -56249,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"),
@@ -56296,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"),
@@ -56335,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"),
@@ -56355,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"),
@@ -56379,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"),
@@ -56400,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"),
@@ -56445,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")
@@ -56468,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"),
@@ -56501,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.)"),
@@ -56524,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."),
@@ -56548,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"),
@@ -56569,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"),
@@ -56630,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"),
@@ -56660,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")
@@ -56678,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)"),
@@ -57079,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) {
@@ -57105,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) {
@@ -57135,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),
@@ -57157,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),
@@ -57193,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),
@@ -57223,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),
@@ -57254,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),
@@ -58951,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"),
@@ -58984,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"),
@@ -59021,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({
@@ -59100,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"),
@@ -59136,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"),
@@ -59160,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"),
@@ -59181,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"),
@@ -59242,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"),
@@ -59272,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")
@@ -59299,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"),
@@ -59324,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"),
@@ -59355,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"),
@@ -59373,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"),
@@ -59392,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"),
@@ -59414,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"),
@@ -59430,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"),
@@ -59448,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"),
@@ -59474,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"),
@@ -59500,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")
@@ -59541,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"),
@@ -59565,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")
@@ -60451,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"),
@@ -60541,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({
@@ -60574,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({
@@ -60596,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({
@@ -60616,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({
@@ -60637,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({
@@ -60706,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({
@@ -60775,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({
@@ -60831,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({
@@ -60905,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({
@@ -60950,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({
@@ -60988,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({
@@ -61022,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({
@@ -61040,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({
@@ -61058,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({
@@ -61142,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({
@@ -61203,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({
@@ -61250,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({
@@ -61786,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) {
@@ -61821,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."),
@@ -61856,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),