@vibeframe/mcp-server 0.115.4 → 0.115.5

package/README.md

@@ -1,6 +1,6 @@
 # @vibeframe/mcp-server
 
-The MCP (Model Context Protocol) **server** for [VibeFrame](https://github.com/vericontext/vibeframe), the frontier-video-generation layer for coding agents: generate video assets on your own provider keys (Seedance, Runway, Veo, Kling), behind dry runs and a hard `--max-cost` ceiling. This package is _only_ the MCP adapter - it exposes VibeFrame's operations as typed MCP tools so an MCP-capable host can call them by natural language.
+The MCP (Model Context Protocol) **server** for [VibeFrame](https://github.com/vericontext/vibeframe), the frontier-video-generation layer for coding agents: generate video assets on your own provider keys (Seedance, Runway, Kling, Gemini Omni), behind dry runs and a hard `--max-cost` ceiling. This package is _only_ the MCP adapter - it exposes VibeFrame's operations as typed MCP tools so an MCP-capable host can call them by natural language.
 
 VibeFrame is CLI-first, not terminal-only. The CLI is the stable runtime; MCP is the app-host surface for clients that prefer typed tools over shell commands.
 

package/dist/index.js

@@ -201,8 +201,8 @@ var init_api_keys = __esm({
       envVar: "GOOGLE_API_KEY",
       label: "Google",
       showInSetup: true,
-      setupDescription: "Gemini \u2014 image gen (free tier), video analysis ($), Veo ($$)",
-      envExampleComment: "Google API Key (Gemini auto-edit suggestions, image gen, Veo video)",
+      setupDescription: "Gemini \u2014 image gen (free tier), video analysis ($), Omni video ($$)",
+      envExampleComment: "Google API Key (Gemini auto-edit suggestions, image gen, Omni video)",
       envExampleUrl: "https://aistudio.google.com/apikey",
       keyFormat: { prefix: /^AIza/, example: "AIza..." }
     });
@@ -456,10 +456,35 @@ function findModel(provider, kind3, aliasOrId) {
   const lower = key2.toLowerCase();
   return listModels({ provider, kind: kind3 }).find((m2) => m2.id === key2 || m2.aliases?.includes(lower));
 }
+function modelLifecycle(spec, now = /* @__PURE__ */ new Date()) {
+  if (!spec.shutdown)
+    return { state: "served" };
+  const remainingMs = Date.parse(`${spec.shutdown}T00:00:00Z`) - now.getTime();
+  const instead = spec.replacement ? ` Use ${spec.replacement} instead.` : "";
+  if (remainingMs <= 0) {
+    return {
+      state: "retired",
+      shutdown: spec.shutdown,
+      message: `${spec.label} (${spec.id}) was shut down by the provider on ${spec.shutdown}.${instead}`
+    };
+  }
+  const daysLeft = Math.ceil(remainingMs / 864e5);
+  return {
+    state: "retiring",
+    shutdown: spec.shutdown,
+    daysLeft,
+    message: `${spec.label} (${spec.id}) shuts down on ${spec.shutdown} (${daysLeft} day${daysLeft === 1 ? "" : "s"} left).${instead}`
+  };
+}
+function assertModelServed(spec, now = /* @__PURE__ */ new Date()) {
+  const lifecycle = modelLifecycle(spec, now);
+  if (lifecycle.state === "retired")
+    throw new ModelRetiredError(lifecycle.message, spec);
+}
 function modelAliases(provider, kind3) {
   return listModels({ provider, kind: kind3 }).flatMap((m2) => m2.aliases ?? []);
 }
-var MODEL_CATALOG;
+var MODEL_CATALOG, ModelRetiredError;
 var init_catalog = __esm({
   "../ai-providers/dist/catalog/catalog.js"() {
     "use strict";
@@ -495,8 +520,8 @@ var init_catalog = __esm({
       { id: "seedance-2.0-fast", provider: "seedance", kind: "video", label: "Seedance 2.0 Fast", aliases: ["fast"], status: "ga", price: { usd: 0.2419, per: "second", basis: "720p 16:9" }, note: "4-15 s, up to 720p, native audio" },
       { id: "seedance-2.5", provider: "seedance", kind: "video", label: "Seedance 2.5", aliases: ["2.5"], status: "ga", price: { usd: 0.473, per: "second", basis: "720p 16:9" }, note: "Opt-in; 4-30 s, native audio" },
       { id: "gemini-omni-1.1-flash", provider: "omni", kind: "video", label: "Gemini Omni 1.1 Flash", default: true, status: "ga", price: { usd: 0.1, per: "second", basis: "720p" }, note: "Google video default; the model picks 3-10 s; native audio" },
-      { id: "veo-3.1-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1", aliases: ["3.1"], status: "deprecated", shutdown: "2026-10-22", price: { usd: 0.4, per: "second", basis: "720p/1080p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
-      { id: "veo-3.1-fast-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1 Fast", aliases: ["3.1-fast"], default: true, status: "deprecated", shutdown: "2026-10-22", price: { usd: 0.1, per: "second", basis: "720p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
+      { id: "veo-3.1-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1", aliases: ["3.1"], status: "deprecated", shutdown: "2026-10-22", replacement: "`-p omni` (Gemini Omni 1.1 Flash)", price: { usd: 0.4, per: "second", basis: "720p/1080p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
+      { id: "veo-3.1-fast-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1 Fast", aliases: ["3.1-fast"], default: true, status: "deprecated", shutdown: "2026-10-22", replacement: "`-p omni` (Gemini Omni 1.1 Flash)", price: { usd: 0.1, per: "second", basis: "720p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
       { id: "grok-imagine-video-1.5", provider: "grok", kind: "video", label: "Grok Imagine Video 1.5", aliases: ["1.5"], default: true, status: "ga", price: { usd: 0.14, per: "second", basis: "720p" }, note: "1-15 s, native audio; 720p unless `--resolution` says otherwise" },
       { id: "grok-imagine-video-1.5-lite", provider: "grok", kind: "video", label: "Grok Imagine Video 1.5 Lite", aliases: ["lite", "1.5-lite"], status: "ga", price: { usd: 0.03, per: "second", basis: "720p" }, note: "1-15 s, native audio" },
       { id: "grok-imagine-video", provider: "grok", kind: "video", label: "Grok Imagine Video", aliases: ["classic"], status: "legacy", price: { usd: 0.05, per: "second", basis: "480p" }, note: "Previous generation" },
@@ -512,6 +537,13 @@ var init_catalog = __esm({
       { id: "eleven_text_to_sound_v2", provider: "elevenlabs", kind: "sound-effect", label: "ElevenLabs Sound Effects v2", default: true, status: "ga", price: { usd: 0.12, per: "minute" }, note: "0.5-30 s" },
       { id: "whisper-1", provider: "openai", kind: "transcription", label: "Whisper", default: true, status: "deprecated", shutdown: "2027-02-26", note: "Only OpenAI model with word timestamps" }
     ];
+    ModelRetiredError = class extends Error {
+      constructor(message, model) {
+        super(message);
+        this.model = model;
+        this.name = "ModelRetiredError";
+      }
+    };
   }
 });
 
@@ -1059,12 +1091,18 @@ var init_http = __esm({
 // ../ai-providers/dist/gemini/GeminiProvider.js
 function resolveVeoModel(alias) {
   if (Object.hasOwn(VEO_MODEL_ALIASES, alias)) {
-    return VEO_MODEL_ALIASES[alias];
+    return servedVeoModel(VEO_MODEL_ALIASES[alias]);
   }
   const valid = Object.keys(VEO_MODEL_ALIASES).join(", ");
   const hint = alias === "3.0" ? " Veo 3.0 was shut down by Google on 2025-11-12." : "";
   throw new Error(`Unknown Veo model "${alias}". Valid: ${valid}.${hint}`);
 }
+function servedVeoModel(id) {
+  const spec = id ? findModel("veo", "video", id) : defaultModel("veo", "video");
+  if (spec)
+    assertModelServed(spec);
+  return spec?.id ?? id;
+}
 var VEO_MODEL_ALIASES, GeminiProvider, geminiProvider;
 var init_GeminiProvider = __esm({
   "../ai-providers/dist/gemini/GeminiProvider.js"() {
@@ -1108,7 +1146,7 @@ var init_GeminiProvider = __esm({
         }
         try {
           const veoOpts = options ?? {};
-          const model = veoOpts.model || "veo-3.1-fast-generate-preview";
+          const model = servedVeoModel(veoOpts.model);
           const aspectRatioMap = {
             "16:9": "16:9",
             "9:16": "9:16",
@@ -1285,7 +1323,7 @@ var init_GeminiProvider = __esm({
           };
         }
         try {
-          const model = options?.model || "veo-3.1-generate-preview";
+          const model = servedVeoModel(options?.model ?? findModel("veo", "video", "3.1")?.id);
           const instance = {
             video: { previousOperationName }
           };
@@ -11727,6 +11765,7 @@ __export(dist_exports, {
   KlingProvider: () => KlingProvider,
   KokoroProvider: () => KokoroProvider,
   MODEL_CATALOG: () => MODEL_CATALOG,
+  ModelRetiredError: () => ModelRetiredError,
   OPENAI_IMAGE_DEFAULT_MODEL: () => OPENAI_IMAGE_DEFAULT_MODEL,
   OPENAI_TTS_VOICES: () => OPENAI_TTS_VOICES,
   OllamaProvider: () => OllamaProvider,
@@ -11738,6 +11777,7 @@ __export(dist_exports, {
   RunwayProvider: () => RunwayProvider,
   VEO_MODEL_ALIASES: () => VEO_MODEL_ALIASES,
   WhisperProvider: () => WhisperProvider,
+  assertModelServed: () => assertModelServed,
   claudeProvider: () => claudeProvider,
   defaultModel: () => defaultModel,
   defineApiKey: () => defineApiKey,
@@ -11766,6 +11806,7 @@ __export(dist_exports, {
   loadBundledKokoroRuntime: () => loadBundledKokoroRuntime,
   loadKokoroFromWorkspace: () => loadKokoroFromWorkspace,
   modelAliases: () => modelAliases,
+  modelLifecycle: () => modelLifecycle,
   ollamaProvider: () => ollamaProvider,
   omniProvider: () => omniProvider,
   openaiImageProvider: () => openaiImageProvider,
@@ -268527,7 +268568,42 @@ function outputSuccess(opts) {
     const data2 = opts.data;
     const primary = data2.outputPath ?? data2.output ?? data2.path ?? data2.url ?? data2.id;
     if (primary !== void 0) console.log(String(primary));
+    return;
+  }
+  if (opts.dryRun && !opts.humanRendered) {
+    printDryRunSummary(opts.command, costUsd, opts.data, opts.warnings ?? []);
+  }
+}
+function printWarnings(warnings) {
+  if (isJsonMode()) return;
+  for (const warning of warnings) {
+    process.stderr.write(`${source_default.yellow(`Warning: ${warning}`)}
+`);
+  }
+}
+function formatDryRunValue(value) {
+  const text = Array.isArray(value) ? value.map((v4) => formatDryRunValue(v4)).join(", ") : typeof value === "object" ? JSON.stringify(value) : String(value);
+  return text.length > 80 ? `${text.slice(0, 77)}...` : text;
+}
+function printDryRunSummary(command3, costUsd, data2, warnings) {
+  const params = data2.params && typeof data2.params === "object" ? data2.params : data2;
+  const rows = [
+    ["cost", costUsd > 0 ? `up to $${costUsd.toFixed(2)} (estimate)` : "free"]
+  ];
+  for (const [key2, value] of Object.entries(params)) {
+    if (value === void 0 || value === null || value === "") continue;
+    if (Array.isArray(value) && value.length === 0) continue;
+    rows.push([key2, formatDryRunValue(value)]);
+  }
+  const width = Math.max(...rows.map(([key2]) => key2.length));
+  console.log();
+  console.log(`${source_default.bold.cyan(`Dry run: vibe ${command3}`)} ${source_default.dim("(nothing was sent)")}`);
+  for (const [key2, value] of rows) {
+    console.log(`  ${source_default.dim(key2.padEnd(width))}  ${value}`);
   }
+  printWarnings(warnings);
+  console.log(source_default.dim("  Run again without --dry-run to execute."));
+  console.log();
 }
 function log(...args) {
   if (!isJsonMode() && !isQuietMode()) {
@@ -282130,6 +282206,34 @@ var init_thumbnail = __esm({
   }
 });
 
+// ../cli/src/utils/model-lifecycle.ts
+function videoModelSpec(provider, flags) {
+  const catalogProvider = provider === "fal" ? "seedance" : provider;
+  const flag = VIDEO_MODEL_FLAG[catalogProvider];
+  return findModel(catalogProvider, "video", flag ? flags[flag] : void 0);
+}
+function checkModelLifecycle(spec, now = /* @__PURE__ */ new Date()) {
+  if (!spec) return [];
+  const lifecycle = modelLifecycle(spec, now);
+  if (lifecycle.state === "retired") exitWithError(usageError(lifecycle.message));
+  return lifecycle.state === "retiring" ? [lifecycle.message] : [];
+}
+var VIDEO_MODEL_FLAG;
+var init_model_lifecycle = __esm({
+  "../cli/src/utils/model-lifecycle.ts"() {
+    "use strict";
+    init_dist();
+    init_output();
+    VIDEO_MODEL_FLAG = {
+      seedance: "seedanceModel",
+      grok: "grokModel",
+      kling: "klingModel",
+      veo: "veoModel",
+      runway: "runwayModel"
+    };
+  }
+});
+
 // ../cli/src/commands/generate/video-extend.ts
 import { resolve as resolve65 } from "node:path";
 import { writeFile as writeFile38 } from "node:fs/promises";
@@ -282141,11 +282245,22 @@ function registerVideoExtendCommand(parent) {
       if (options.output) {
         validateOutputPath(options.output);
       }
+      let lifecycleWarnings = [];
+      if (provider === "veo") {
+        try {
+          resolveVeoModel(options.veoModel);
+        } catch (err) {
+          exitWithError(usageError(err instanceof Error ? err.message : String(err)));
+        }
+        lifecycleWarnings = checkModelLifecycle(findModel("veo", "video", options.veoModel));
+        if (!options.dryRun) printWarnings(lifecycleWarnings);
+      }
       if (options.dryRun) {
         outputSuccess({
           command: "generate video-extend",
           startedAt,
           dryRun: true,
+          warnings: lifecycleWarnings,
           data: {
             params: {
               id,
@@ -282298,6 +282413,7 @@ function registerVideoExtendCommand(parent) {
           outputSuccess({
             command: "generate video-extend",
             startedAt,
+            warnings: lifecycleWarnings,
             data: {
               provider: "veo",
               taskId: result.id,
@@ -282346,6 +282462,7 @@ var init_video_extend = __esm({
     init_ora();
     init_dist();
     init_api_key();
+    init_model_lifecycle();
     init_output();
     init_validate();
     init_ai_helpers();
@@ -284056,6 +284173,8 @@ Examples:
       } catch (err) {
         exitWithError(usageError(err instanceof Error ? err.message : String(err)));
       }
+      const lifecycleWarnings = checkModelLifecycle(videoModelSpec(provider, options));
+      if (!options.dryRun) printWarnings(lifecycleWarnings);
       if (options.dryRun) {
         const costUsd = provider === "seedance" || provider === "fal" ? realRunCost(provider, options).costUsd : void 0;
         outputSuccess({
@@ -284063,6 +284182,7 @@ Examples:
           startedAt,
           dryRun: true,
           costUsd,
+          warnings: lifecycleWarnings,
           data: {
             params: {
               prompt: prompt3,
@@ -284070,13 +284190,10 @@ Examples:
               duration: options.duration,
               ratio: options.ratio,
               image: options.image,
-              mode: options.mode,
+              mode: provider === "kling" ? options.mode : void 0,
               negative: options.negative,
               resolution: options.resolution,
-              veoModel: options.veoModel,
-              seedanceModel: options.seedanceModel,
-              grokModel: options.grokModel,
-              klingModel: options.klingModel,
+              model: videoModelSpec(provider, options)?.id,
               refImages: options.refImages,
               refVideos: options.refVideos,
               refAudio: options.refAudio,
@@ -284468,7 +284585,7 @@ Examples:
           command: "generate video",
           startedAt,
           costUsd: cost.costUsd,
-          warnings: provider === "veo" ? [VEO_SHUTDOWN_WARNING, ...cost.warnings] : cost.warnings,
+          warnings: [...lifecycleWarnings, ...cost.warnings],
           data: {
             provider,
             taskId: result?.id,
@@ -284480,9 +284597,6 @@ Examples:
         return;
       }
       console.log();
-      if (provider === "veo") {
-        console.log(source_default.yellow(VEO_SHUTDOWN_WARNING));
-      }
       if (finalResult.videoUrl) {
         console.log(`Video URL: ${finalResult.videoUrl}`);
       }
@@ -284607,7 +284721,6 @@ function printVideoStarted(providerLabel, taskId, taskType) {
   console.log(`Task ID: ${source_default.bold(taskId)}`);
   if (taskType) console.log(`Type: ${taskType}`);
 }
-var VEO_SHUTDOWN_WARNING;
 var init_video = __esm({
   "../cli/src/commands/generate/video.ts"() {
     "use strict";
@@ -284616,6 +284729,7 @@ var init_video = __esm({
     init_dist5();
     init_dist();
     init_api_key();
+    init_model_lifecycle();
     init_tty();
     init_output();
     init_validate();
@@ -284623,7 +284737,6 @@ var init_video = __esm({
     init_upload_host();
     init_ai_helpers();
     init_status_jobs();
-    VEO_SHUTDOWN_WARNING = "Veo 3.1 preview models shut down on 2026-10-22. Use `-p omni` (Gemini Omni 1.1 Flash) instead.";
   }
 });
 
@@ -284733,7 +284846,7 @@ Advanced:
   generate video-cancel Provider lifecycle control; poll with 'vibe status job <job-id> --json'
 
 API Keys (per provider):
-  GOOGLE_API_KEY     Image (default), Veo video
+  GOOGLE_API_KEY     Image (default), Omni video
   OPENAI_API_KEY     Image (-p openai)
   FAL_API_KEY        Seedance video (-p seedance, default video)
   XAI_API_KEY        Grok image/video
@@ -303918,6 +304031,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect scenes",
             startedAt,
@@ -304037,6 +304151,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect silence",
             startedAt,
@@ -304123,6 +304238,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect beats",
             startedAt,
@@ -309834,7 +309950,7 @@ var generateVideoTool = defineTool({
   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.",
+  description: "Generate video using AI. Supports Seedance 2.0 via fal.ai, Grok, Kling, Runway, Gemini Omni, and Veo (shuts down 2026-10-22). Requires FAL_API_KEY, XAI_API_KEY, KLING_API_KEY, RUNWAY_API_SECRET, or GOOGLE_API_KEY.",
   schema: z7.object({
     prompt: z7.string().describe("Text prompt describing the video"),
     provider: z7.enum(["seedance", "grok", "kling", "runway", "veo", "omni"]).optional().describe(
@@ -315433,7 +315549,7 @@ function handleCliFlags(argv, version2) {
 }
 
 // src/index.ts
-if (handleCliFlags(process.argv.slice(2), "0.115.4")) {
+if (handleCliFlags(process.argv.slice(2), "0.115.5")) {
   process.exit(0);
 }
 console.log = (...args) => console.error(...args);
@@ -315446,7 +315562,7 @@ var server = new Server(
   {
     name: "vibeframe",
     // Stamped with the package version by build.js at bundle time.
-    version: "0.115.4"
+    version: "0.115.5"
   },
   {
     capabilities: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.115.4",
-  "description": "VibeFrame MCP Server - frontier AI video generation for agents (Seedance, Runway, Veo, Kling) on your own keys, behind a hard cost cap",
+  "version": "0.115.5",
+  "description": "VibeFrame MCP Server - frontier AI video generation for agents (Seedance, Runway, Kling, Gemini Omni) on your own keys, behind a hard cost cap",
   "type": "module",
   "bin": {
     "vibeframe-mcp": "./dist/index.js"
@@ -66,8 +66,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/cli": "0.115.4",
-    "@vibeframe/core": "0.115.4"
+    "@vibeframe/cli": "0.115.5",
+    "@vibeframe/core": "0.115.5"
   },
   "engines": {
     "node": ">=20"