@vibeframe/mcp-server 0.82.0 → 0.84.0

package/dist/index.js

@@ -452425,7 +452425,7 @@ var init_validate = __esm({
 import { resolve as resolve27, extname as extname7, basename as basename8 } from "node:path";
 import { existsSync as existsSync39 } from "node:fs";
 function registerEditCommands(aiCommand) {
-  aiCommand.command("silence-cut").alias("sc").description("Remove silent segments from video (FFmpeg default, or Gemini for smart detection)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path (default: <name>-cut.<ext>)").option("--noise <dB>", "Silence threshold in dB (default: -30)", "-30").option("-d, --min-duration <seconds>", "Minimum silence duration to cut (default: 0.5)", "0.5").option("--padding <seconds>", "Padding around non-silent segments (default: 0.1)", "0.1").option("--analyze-only", "Only detect silence, don't cut").option("--use-gemini", "Use Gemini Video Understanding for context-aware silence detection").option("-m, --model <model>", "Gemini model (default: flash)").option("--low-res", "Low resolution mode for longer videos (Gemini only)").option("-k, --api-key <key>", "Google API key override (or set GOOGLE_API_KEY env)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
+  aiCommand.command("silence-cut").alias("sc").description("Remove silent segments from video (FFmpeg default, or Gemini for smart detection)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path (default: <name>-cut.<ext>)").option("--noise <dB>", "Silence threshold in dB (default: -30)", "-30").option("-d, --min-duration <seconds>", "Minimum silence duration to cut (default: 0.5)", "0.5").option("--padding <seconds>", "Padding around non-silent segments (default: 0.1)", "0.1").option("--analyze-only", "(deprecated \u2014 use `vibe detect silence`) Only detect silence, don't cut").option("--use-gemini", "Use Gemini Video Understanding for context-aware silence detection").option("-m, --model <model>", "Gemini model (default: flash)").option("--low-res", "Low resolution mode for longer videos (Gemini only)").option("-k, --api-key <key>", "Google API key override (or set GOOGLE_API_KEY env)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe edit silence-cut interview.mp4 -o clean.mp4
   $ vibe ed sc podcast.mp4 -o trimmed.mp4 --noise -25 --min-duration 1.0
@@ -452450,6 +452450,13 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
       const name = basename8(videoPath, ext);
       const outputPath = options.output || `${name}-cut${ext}`;
       const useGemini = options.useGemini || false;
+      if (options.analyzeOnly) {
+        console.error(
+          source_default.yellow(
+            "\u26A0 --analyze-only is deprecated. Use `vibe detect silence` for read-only detection. Will be removed in v1.0."
+          )
+        );
+      }
       if (options.dryRun) {
         outputSuccess({
           command: "edit silence-cut",
@@ -453863,6 +453870,42 @@ var init_ai_fill_gaps = __esm({
   }
 });
 
+// ../cli/src/commands/_shared/cost-tier.ts
+function applyTier(cmd, tier) {
+  cmd[COST_TIER_KEY] = tier;
+  const colored = TIER_COLOR[tier](`Cost: ${tier} (${TIER_DESCRIPTION[tier]})`);
+  cmd.addHelpText("after", `
+${colored}
+`);
+  return cmd;
+}
+function applyTiers(parent, tiers) {
+  for (const cmd of parent.commands) {
+    const tier = tiers[cmd.name()];
+    if (tier) applyTier(cmd, tier);
+  }
+}
+var TIER_DESCRIPTION, TIER_COLOR, COST_TIER_KEY;
+var init_cost_tier = __esm({
+  "../cli/src/commands/_shared/cost-tier.ts"() {
+    "use strict";
+    init_source();
+    TIER_DESCRIPTION = {
+      "free": "FFmpeg only, no API call",
+      "low": "$0.01\u2013$0.10 per call",
+      "high": "$1\u2013$5 per call",
+      "very-high": "$5\u2013$50+ per call"
+    };
+    TIER_COLOR = {
+      "free": source_default.green,
+      "low": source_default.cyan,
+      "high": source_default.yellow,
+      "very-high": source_default.red
+    };
+    COST_TIER_KEY = /* @__PURE__ */ Symbol.for("@vibeframe/cli.costTier");
+  }
+});
+
 // ../cli/src/commands/edit-cmd.ts
 var edit_cmd_exports = {};
 __export(edit_cmd_exports, {
@@ -454065,6 +454108,7 @@ var init_edit_cmd = __esm({
     init_ai_fill_gaps();
     init_output();
     init_validate();
+    init_cost_tier();
     editCommand = new Command("edit").alias("ed").description(
       "Edit and post-process media (silence-cut, caption, grade, reframe, upscale...)"
     ).addHelpText(
@@ -454812,6 +454856,26 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         exitWithError(generalError(`Video upscaling failed: ${msg}`));
       }
     });
+    applyTiers(editCommand, {
+      // free — FFmpeg only
+      "noise-reduce": "free",
+      "fade": "free",
+      "text-overlay": "free",
+      "interpolate": "free",
+      // low — Whisper / single LLM call
+      "silence-cut": "low",
+      "caption": "low",
+      "translate-srt": "low",
+      "jump-cut": "low",
+      "grade": "low",
+      "speed-ramp": "low",
+      // high — vision LLM or image gen
+      "reframe": "high",
+      "image": "high",
+      "upscale": "high",
+      // very-high — video gen per gap
+      "fill-gaps": "very-high"
+    });
   }
 });
 
@@ -460269,6 +460333,10 @@ __export(generate_exports, {
   executeStoryboard: () => executeStoryboard,
   generateCommand: () => generateCommand
 });
+function tierLast(parent, tier) {
+  const newest = parent.commands[parent.commands.length - 1];
+  if (newest) applyTier(newest, tier);
+}
 var generateCommand;
 var init_generate = __esm({
   "../cli/src/commands/generate.ts"() {
@@ -460287,6 +460355,7 @@ var init_generate = __esm({
     init_video_extend();
     init_image();
     init_video();
+    init_cost_tier();
     init_sound_effect();
     init_music_status();
     init_background();
@@ -460324,18 +460393,31 @@ Run 'vibe schema generate.<command>' for structured parameter info.
 `
     );
     registerImageCommand(generateCommand);
+    tierLast(generateCommand, "high");
     registerVideoCommand(generateCommand);
+    tierLast(generateCommand, "very-high");
     registerSpeechCommand(generateCommand);
+    tierLast(generateCommand, "low");
     registerSoundEffectCommand(generateCommand);
+    tierLast(generateCommand, "low");
     registerMusicCommand(generateCommand);
+    tierLast(generateCommand, "low");
     registerMusicStatusCommand(generateCommand);
+    tierLast(generateCommand, "free");
     registerStoryboardCommand(generateCommand);
+    tierLast(generateCommand, "high");
     registerMotionCommand(generateCommand);
+    tierLast(generateCommand, "high");
     registerThumbnailCommand(generateCommand);
+    tierLast(generateCommand, "free");
     registerBackgroundCommand(generateCommand);
+    tierLast(generateCommand, "high");
     registerVideoStatusCommand(generateCommand);
+    tierLast(generateCommand, "free");
     registerVideoCancelCommand(generateCommand);
+    tierLast(generateCommand, "free");
     registerVideoExtendCommand(generateCommand);
+    tierLast(generateCommand, "very-high");
   }
 });
 
@@ -460809,6 +460891,7 @@ var init_detect = __esm({
     init_exec_safe();
     init_output();
     init_validate();
+    init_cost_tier();
     detectCommand = new Command("detect").description("Auto-detect scenes, beats, and silences in media");
     detectCommand.command("scenes").description("Detect scene changes in video").argument("<video>", "Video file path").option("--threshold <value>", "Scene change threshold (0-1)", "0.3").option("-o, --output <path>", "Output JSON file with timestamps").option("--project <path>", "Add scenes as clips to project").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
@@ -461100,6 +461183,11 @@ var init_detect = __esm({
         exitWithError(generalError(`Beat detection failed: ${msg}`));
       }
     });
+    applyTiers(detectCommand, {
+      "scenes": "free",
+      "silence": "free",
+      "beats": "free"
+    });
   }
 });
 
@@ -468088,6 +468176,59 @@ When the user has a working shell sequence, extract steps:
 The \`compose\` action is the catch-all assembly step (audio mux, video
 overlay, etc.) \u2014 useful at the tail of a pipeline.
 `;
+var ARCHITECTURE_WALKTHROUGH = `# vibe agent / build / run \u2014 when to pick which
+
+The CLI has three orchestrating commands that coordinate other primitives:
+\`vibe agent\`, \`vibe build\`, \`vibe run\`. New users routinely ask which one
+they want for a given task. The full audit lives in
+[\`docs/cli-architecture.md\`](../../../docs/cli-architecture.md); this
+walkthrough is the operator-facing summary.
+
+## TL;DR
+
+| | \`vibe agent\` | \`vibe build\` | \`vibe run\` |
+|---|---|---|---|
+| **Driving input** | natural-language prompt | \`STORYBOARD.md\` | YAML pipeline file |
+| **Interactivity** | REPL or one-shot | one-shot | one-shot |
+| **Reproducibility** | none | high (idempotent) | highest (checkpointed) |
+| **Budget caps** | per-session max-turns | none | \`--budget-usd\`, \`--budget-tokens\`, \`--max-errors\` |
+| **Resume after crash** | no | re-invoke | \`--resume\` |
+| **Best for** | exploration | finished script | repeatable workflows |
+
+## Decision tree
+
+- "I want to play, I'll know it when I see it" \u2192 \`vibe agent\`
+- "I have a finished script + visual identity" \u2192 \`vibe build\`
+- "I want this to run again next month" \u2192 \`vibe run\`
+
+If two seem to fit, pick the rightmost one \u2014 more reproducible, less surprise.
+
+## Cost-tier awareness (v0.83+)
+
+Every primitive subcommand carries a cost tier (\`free\` / \`low\` / \`high\` /
+\`very-high\`). \`vibe schema --list\` exposes the tier as JSON, and each
+\`vibe <group> <sub> --help\` page shows it as a colored footer. Use
+\`vibe doctor --test-keys\` before kicking off any high-cost orchestrator \u2014
+a single bad key wastes time and money.
+
+## Cross-command primitives
+
+All three commands ultimately call the same primitives:
+\`generate\` / \`edit\` / \`audio\` / \`inspect\` / \`detect\` / \`remix\`. The
+agent calls them through a tool manifest; \`build\` calls a curated subset
+(TTS + image + compose + render); \`run\` exposes 55+ actions one per primitive.
+
+## Known overlap
+
+- \`vibe build\` is conceptually a 4-step pipeline; \`vibe run\` could express
+  the same flow but build's STORYBOARD.md input + opinionated defaults are
+  the value-add.
+- \`vibe agent\`'s tool registry currently exposes primitives, not
+  orchestrators. Adding \`vibe.build\` / \`vibe.run\` as agent tools is on the
+  table for a future major.
+- \`vibe run --resume\` has no analog in build/agent; build's idempotent
+  re-invoke covers the common case.
+`;
 var META = {
   scene: {
     title: "Scene authoring with vibe",
@@ -468125,13 +468266,32 @@ var META = {
       "vibe schema --list",
       "vibe doctor"
     ]
+  },
+  architecture: {
+    title: "vibe agent / build / run \u2014 when to pick which",
+    summary: "Compare the three orchestrating commands on the dimensions that actually decide the choice",
+    steps: [
+      "Pick agent for exploration (NL prompt, REPL, no checkpoints).",
+      "Pick build for STORYBOARD.md \u2192 MP4 with opinionated defaults.",
+      "Pick run for repeatable, budget-capped, checkpointed YAML pipelines.",
+      "Run `vibe doctor --test-keys` before any high-cost orchestrator to validate keys upfront.",
+      "Use `vibe schema --list` (cost field, v0.84) to plan the budget per step before kicking off `vibe run --budget-usd`."
+    ],
+    relatedCommands: [
+      "vibe agent",
+      "vibe build",
+      "vibe run",
+      "vibe doctor",
+      "vibe schema --list"
+    ]
   }
 };
 var CONTENT2 = {
   scene: SCENE_WALKTHROUGH,
-  pipeline: PIPELINE_WALKTHROUGH
+  pipeline: PIPELINE_WALKTHROUGH,
+  architecture: ARCHITECTURE_WALKTHROUGH
 };
-var WALKTHROUGH_TOPICS = ["scene", "pipeline"];
+var WALKTHROUGH_TOPICS = ["scene", "pipeline", "architecture"];
 function loadWalkthrough(topic) {
   const meta = META[topic];
   const content = CONTENT2[topic];

package/package.json

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