@vibeframe/mcp-server 0.78.0 → 0.79.1

package/dist/index.js

@@ -452406,7 +452406,7 @@ 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", `
 Examples:
   $ vibe edit silence-cut interview.mp4 -o clean.mp4
-  $ vibe ed sc podcast.mp4 -o trimmed.mp4 -n -25 -d 1.0
+  $ vibe ed sc podcast.mp4 -o trimmed.mp4 --noise -25 --min-duration 1.0
   $ vibe ed sc video.mp4 --use-gemini -o smart-cut.mp4    # AI-powered detection
   $ vibe ed sc video.mp4 --analyze-only                    # Detect only, no cut
   $ vibe ed sc video.mp4 --dry-run --json
@@ -452507,9 +452507,9 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
   aiCommand.command("caption").alias("cap").description("Transcribe and burn styled captions onto video (Whisper + FFmpeg)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path (default: <name>-captioned.<ext>)").option("--style <style>", "Caption style: minimal, bold, outline, karaoke (default: bold)", "bold").option("--font-size <pixels>", "Override auto-calculated font size").option("--color <color>", "Font color (default: white)", "white").option("-l, --language <lang>", "Language code for transcription (e.g., en, ko)").option("--position <pos>", "Caption position: top, center, bottom (default: bottom)", "bottom").option("-k, --api-key <key>", "OpenAI API key (or set OPENAI_API_KEY env)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe edit caption video.mp4 -o captioned.mp4
-  $ vibe ed cap video.mp4 -o out.mp4 -s bold --position top
+  $ vibe ed cap video.mp4 -o out.mp4 --style bold --position top
   $ vibe ed cap video.mp4 -o out.mp4 -l ko              # Korean transcription
-  $ vibe ed cap video.mp4 -o out.mp4 -s karaoke          # Karaoke-style
+  $ vibe ed cap video.mp4 -o out.mp4 --style karaoke     # Karaoke-style
   $ vibe ed cap video.mp4 --dry-run --json
 
 Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoPath, options) => {
@@ -453999,12 +453999,12 @@ var init_edit_cmd = __esm({
       `
 Examples:
   $ vibe edit silence-cut interview.mp4 -o clean.mp4
-  $ vibe edit caption video.mp4 -o captioned.mp4 -s bold
+  $ vibe edit caption video.mp4 -o captioned.mp4 --style bold
   $ vibe edit grade video.mp4 -o graded.mp4 --preset cinematic-warm
   $ vibe edit reframe landscape.mp4 -o vertical.mp4 -a 9:16
   $ vibe edit image photo.png "add sunset background" -o edited.png
-  $ vibe edit text-overlay video.mp4 -t "Title" -s center-bold -o out.mp4
-  $ vibe edit noise-reduce noisy.mp4 -o clean.mp4 -s high
+  $ vibe edit text-overlay video.mp4 --text "Title" --style center-bold -o out.mp4
+  $ vibe edit noise-reduce noisy.mp4 -o clean.mp4 --strength high
   $ vibe edit fade video.mp4 -o faded.mp4 --fade-in 1 --fade-out 1
 
 API Keys (varies by subcommand):
@@ -455710,6 +455710,33 @@ function registerMotionCommand(aiCommand) {
       if (options.output) {
         validateOutputPath(options.output);
       }
+      if (options.duration !== void 0) {
+        const d = parseFloat(options.duration);
+        if (!Number.isFinite(d) || d <= 0 || d > 60) {
+          exitWithError(usageError(
+            `Invalid --duration: ${options.duration}`,
+            "Must be a positive number \u2264 60 seconds."
+          ));
+        }
+      }
+      if (options.width !== void 0) {
+        const w = parseInt(options.width, 10);
+        if (!Number.isFinite(w) || w < 16 || w > 7680) {
+          exitWithError(usageError(
+            `Invalid --width: ${options.width}`,
+            "Must be an integer between 16 and 7680."
+          ));
+        }
+      }
+      if (options.height !== void 0) {
+        const h = parseInt(options.height, 10);
+        if (!Number.isFinite(h) || h < 16 || h > 4320) {
+          exitWithError(usageError(
+            `Invalid --height: ${options.height}`,
+            "Must be an integer between 16 and 4320."
+          ));
+        }
+      }
       if (options.dryRun) {
         outputSuccess({
           command: "generate motion",
@@ -456674,13 +456701,22 @@ async function executeMusic(options) {
   }
 }
 function registerMusicCommand(parent) {
-  parent.command("music").description("Generate background music from a text prompt (ElevenLabs or Replicate MusicGen)").argument("<prompt>", "Description of the music to generate").option("-p, --provider <provider>", "Provider: elevenlabs (default, up to 10min), replicate (MusicGen, max 30s)", "elevenlabs").option("-k, --api-key <key>", "API key (or set ELEVENLABS_API_KEY / REPLICATE_API_TOKEN env)").option("-d, --duration <seconds>", "Duration in seconds (elevenlabs: 3-600, replicate: 1-30)", "8").option("--instrumental", "Force instrumental music, no vocals (ElevenLabs only)").option("--melody <file>", "Reference melody audio file for conditioning (Replicate only)").option("--model <model>", "Model variant (Replicate only): large, stereo-large, melody-large, stereo-melody-large", "stereo-large").option("-o, --output <path>", "Output audio file path", "music.mp3").option("--no-wait", "Don't wait for generation to complete (Replicate async mode)").option("--dry-run", "Preview parameters without executing").action(async (prompt3, options) => {
+  parent.command("music").description("Generate background music from a text prompt (ElevenLabs or Replicate MusicGen)").argument("<prompt>", "Description of the music to generate").option("-p, --provider <provider>", "Provider: elevenlabs (default, up to 10min), replicate (MusicGen, max 30s)", "elevenlabs").option("-k, --api-key <key>", "API key (or set ELEVENLABS_API_KEY / REPLICATE_API_TOKEN env)").option("-d, --duration <seconds>", "Duration in seconds (elevenlabs: 3-600, replicate: 1-30)", "8").option("--instrumental", "Force instrumental music, no vocals (ElevenLabs only)").option("--melody <file>", "Reference melody audio file for conditioning (Replicate only)").option("-m, --model <model>", "Model variant (Replicate only): large, stereo-large, melody-large, stereo-melody-large", "stereo-large").option("-o, --output <path>", "Output audio file path", "music.mp3").option("--no-wait", "Don't wait for generation to complete (Replicate async mode)").option("--dry-run", "Preview parameters without executing").action(async (prompt3, options) => {
     const startedAt = Date.now();
     try {
       rejectControlChars(prompt3);
       if (options.output) {
         validateOutputPath(options.output);
       }
+      if (options.duration !== void 0) {
+        const d = parseFloat(options.duration);
+        if (!Number.isFinite(d) || d <= 0 || d > 600) {
+          exitWithError(usageError(
+            `Invalid --duration: ${options.duration}`,
+            "Must be a positive number \u2264 600s (ElevenLabs 3-600, Replicate 1-30)."
+          ));
+        }
+      }
       const provider = (options.provider || "elevenlabs").toLowerCase();
       if (options.dryRun) {
         outputSuccess({
@@ -457549,6 +457585,15 @@ Examples:
       if (options.output) {
         validateOutputPath(options.output);
       }
+      if (options.count !== void 0) {
+        const n = parseInt(options.count, 10);
+        if (!Number.isFinite(n) || n < 1 || n > 10) {
+          exitWithError(usageError(
+            `Invalid --count: ${options.count}`,
+            "Must be an integer between 1 and 10."
+          ));
+        }
+      }
       const imageRegistry = getProvidersFor("image");
       const validProviders = [...imageRegistry.map((p) => p.name), "runway"];
       const providerEnvMap = Object.fromEntries(
@@ -459693,6 +459738,15 @@ Examples:
       if (options.output) {
         validateOutputPath(options.output);
       }
+      if (options.duration !== void 0) {
+        const d = parseFloat(options.duration);
+        if (!Number.isFinite(d) || d <= 0 || d > 60) {
+          exitWithError(usageError(
+            `Invalid --duration: ${options.duration}`,
+            "Must be a positive number \u2264 60 seconds."
+          ));
+        }
+      }
       const validProviders = ["runway", "kling", "veo", "grok", "seedance", "fal"];
       const videoEnvMap = {
         grok: "XAI_API_KEY",
@@ -466067,11 +466121,11 @@ var exportCommand = new Command("export").description("Export project to video f
 ).option("--overwrite", "Overwrite output file if exists", false).option("--gap-fill <strategy>", "Gap filling strategy (black, extend)", "extend").option("--backend <name>", "Render backend: ffmpeg (default) | hyperframes (experimental)", "ffmpeg").option("--bitrate <value>", "Video bitrate (e.g. 5000k, 8M) \u2014 overrides preset").option("--fps <number>", "Frames per second (e.g. 24, 30, 60) \u2014 overrides preset").option("--resolution <WxH>", "Output resolution (e.g. 1920x1080) \u2014 overrides preset").option("--codec <codec>", "Video codec: h264 (default) | h265 | vp9 \u2014 overrides preset").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe export project.vibe.json -o output.mp4
-  $ vibe export project.vibe.json -o output.mp4 -p high -y
-  $ vibe export project.vibe.json -o output.webm -f webm
-  $ vibe export project.vibe.json -o output.gif -f gif
+  $ vibe export project.vibe.json -o output.mp4 --preset high --overwrite
+  $ vibe export project.vibe.json -o output.webm --format webm
+  $ vibe export project.vibe.json -o output.gif --format gif
   $ vibe export project.vibe.json -o out.mp4 --bitrate 5000k --fps 24 --codec h265
-  $ vibe export project.vibe.json -o out.mp4 -p high --fps 60
+  $ vibe export project.vibe.json -o out.mp4 --preset high --fps 60
 
 Cost: Free (no API keys needed). Requires FFmpeg.
 GIF format: 15fps, no audio, looping. Good for previews and sharing.
@@ -467712,28 +467766,31 @@ narration / backdrop intent.
 ## Quick-draft path
 
 \`\`\`bash
-vibe scene init my-promo -r 16:9 -d 30
+vibe init my-promo -r 16:9 -d 30
 vibe scene add intro --style announcement \\
     --headline "Ship videos, not clicks"
 vibe scene lint
 vibe render my-promo
 \`\`\`
 
-\`vibe scene init\` is **idempotent** \u2014 running it on an existing
-Hyperframes directory merges \`hyperframes.json\` instead of clobbering it.
-Safe to invoke on user-provided projects.
+\`vibe init\` is **idempotent** \u2014 running it on an existing Hyperframes
+directory merges \`hyperframes.json\` instead of clobbering it. Safe to
+invoke on user-provided projects.
 
 ## Subcommands
 
 \`\`\`bash
-vibe scene init <dir> [-r 16:9|9:16|1:1|4:5] [-d <sec>] [--visual-style "<name>"]
+# Project flow (top-level \u2014 preferred entry points)
+vibe init <dir> [-r 16:9|9:16|1:1|4:5] [-d <sec>] [--visual-style "<name>"]
+vibe build [<dir>] [--mode agent|batch|auto]         # H3 dispatch
+vibe render [<dir>] [--fps 30] [--quality standard] [--format mp4]
+
+# Lower-level scene authoring
 vibe scene list-styles [<name>]                   # list / show vendored visual identities
 vibe scene install-skill [<dir>] [--host all]  # retroactive composition-rules install
 vibe scene add <name> --style <preset> [...]
 vibe scene compose-prompts [<dir>] [--beat <id>]   # H2: emit plan, no LLM call
 vibe scene lint [<root>] [--json] [--fix]
-vibe scene render [<root>] [--fps 30] [--quality standard] [--format mp4]
-vibe build [<dir>] [--mode agent|batch|auto]         # H3 dispatch
 \`\`\`
 
 ## Style presets (for \`vibe scene add --style\`)
@@ -467787,7 +467844,7 @@ and surface the error to the user.
 | Generate narration + image, then author scene | \`vibe scene add\` |
 | Generate a full scenes project from a STORYBOARD | \`vibe build\` |
 | Hand-tweak a single scene's animation | edit \`compositions/<file>.html\` directly |
-| Render the project | \`vibe render\` *or* \`vibe scene render\` for lower-level control |
+| Render the project | \`vibe render\` (one canonical entry point) |
 | Lint | \`vibe scene lint\` *or* \`npx hyperframes lint\` (equivalent) |
 
 The \`vibe\` CLI adds asset generation, AI orchestration, and pipeline
@@ -467915,12 +467972,12 @@ var META = {
     ],
     relatedCommands: [
       "vibe init",
+      "vibe build",
+      "vibe render",
       "vibe scene list-styles",
       "vibe scene install-skill",
       "vibe scene compose-prompts",
-      "vibe build",
       "vibe scene lint",
-      "vibe scene render",
       "vibe scene add"
     ]
   },

package/package.json

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