@vibeframe/mcp-server 0.115.3 → 0.115.5

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..." }
     });
@@ -439,6 +439,114 @@ var init_whisper = __esm({
   }
 });
 
+// ../ai-providers/dist/catalog/catalog.js
+function listModels(filter3 = {}) {
+  return MODEL_CATALOG.filter((m2) => (!filter3.provider || m2.provider === filter3.provider) && (!filter3.kind || m2.kind === filter3.kind));
+}
+function defaultModel(provider, kind3) {
+  const found = MODEL_CATALOG.find((m2) => m2.provider === provider && m2.kind === kind3 && m2.default);
+  if (!found)
+    throw new Error(`Model catalog has no default ${kind3} model for ${provider}`);
+  return found;
+}
+function findModel(provider, kind3, aliasOrId) {
+  const key2 = aliasOrId?.trim();
+  if (!key2)
+    return defaultModel(provider, kind3);
+  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, ModelRetiredError;
+var init_catalog = __esm({
+  "../ai-providers/dist/catalog/catalog.js"() {
+    "use strict";
+    MODEL_CATALOG = [
+      // ── LLMs ──────────────────────────────────────────────────────────────
+      { id: "claude-sonnet-5-5", provider: "claude", kind: "llm", label: "Claude Sonnet 5.5", aliases: ["sonnet"], default: true, status: "ga", price: { usd: 2, per: "1M input tokens" }, note: "Agent, storyboard, translate-srt, motion default" },
+      { id: "claude-opus-5-5", provider: "claude", kind: "llm", label: "Claude Opus 5.5", aliases: ["opus"], status: "ga", price: { usd: 4, per: "1M input tokens" } },
+      { id: "claude-opus-4-6", provider: "claude", kind: "llm", label: "Claude Opus 4.6", aliases: ["opus-4-6"], status: "legacy", price: { usd: 5, per: "1M input tokens" } },
+      { id: "gpt-5.4-mini", provider: "openai", kind: "llm", label: "GPT-5.4 mini", default: true, status: "ga", price: { usd: 0.75, per: "1M input tokens" }, note: "Agent and storyboard default (tools on Chat Completions)" },
+      { id: "gemini-3.8-flash", provider: "gemini", kind: "llm", label: "Gemini 3.8 Flash", aliases: ["flash", "latest", "flash-3.8", "gemini"], default: true, status: "ga", price: { usd: 0.75, per: "1M input tokens", basis: "until 2026-12-31, then $1.50" } },
+      { id: "gemini-3.5-flash", provider: "gemini", kind: "llm", label: "Gemini 3.5 Flash", aliases: ["flash-3.5"], status: "ga" },
+      { id: "gemini-3-flash-preview", provider: "gemini", kind: "llm", label: "Gemini 3 Flash (preview)", aliases: ["flash-3"], status: "preview" },
+      { id: "gemini-3.1-pro-preview", provider: "gemini", kind: "llm", label: "Gemini 3.1 Pro (preview)", aliases: ["pro", "pro-3.1", "3.1-pro", "gemini-3.1-pro"], status: "preview" },
+      { id: "gemini-2.5-flash", provider: "gemini", kind: "llm", label: "Gemini 2.5 Flash", aliases: ["flash-2.5"], status: "legacy", note: "New projects cannot use 2.5 models since 2026-09-18" },
+      { id: "gemini-2.5-pro", provider: "gemini", kind: "llm", label: "Gemini 2.5 Pro", aliases: ["pro-2.5", "2.5-pro"], status: "legacy" },
+      { id: "grok-4.3", provider: "grok", kind: "llm", label: "Grok 4.3", default: true, status: "ga", price: { usd: 1.25, per: "1M input tokens" } },
+      { id: "grok-4.7", provider: "grok", kind: "llm", label: "Grok 4.7", status: "ga", price: { usd: 2, per: "1M input tokens" } },
+      // ── Images ────────────────────────────────────────────────────────────
+      { id: "gpt-image-2.5-sunburst", provider: "openai", kind: "image", label: "GPT Image 2.5 Sunburst", aliases: ["2.5", "sunburst"], default: true, status: "ga", price: { usd: 0.211, per: "image", basis: "high, 1024x1024" } },
+      { id: "gpt-image-2.5-flare", provider: "openai", kind: "image", label: "GPT Image 2.5 Flare", aliases: ["flare", "2.5-flare"], status: "ga", price: { usd: 0.211, per: "image", basis: "high, 1024x1024" } },
+      { id: "gpt-image-2", provider: "openai", kind: "image", label: "GPT Image 2", aliases: ["2"], status: "ga", price: { usd: 0.211, per: "image", basis: "high, 1024x1024" } },
+      { id: "gpt-image-1.5", provider: "openai", kind: "image", label: "GPT Image 1.5", aliases: ["1.5"], status: "deprecated", shutdown: "2026-12-01", price: { usd: 0.133, per: "image", basis: "high, 1024x1024" } },
+      { id: "gemini-3.1-flash-image", provider: "gemini", kind: "image", label: "Nano Banana 2", aliases: ["flash", "3.1-flash", "latest"], default: true, status: "ga", price: { usd: 0.067, per: "image", basis: "1K" } },
+      { id: "gemini-3.1-flash-lite-image", provider: "gemini", kind: "image", label: "Nano Banana 2 Lite", aliases: ["lite"], status: "ga", price: { usd: 0.034, per: "image", basis: "1K" } },
+      { id: "gemini-3-pro-image", provider: "gemini", kind: "image", label: "Nano Banana Pro", aliases: ["pro"], status: "ga", price: { usd: 0.134, per: "image", basis: "1K-2K" } },
+      { id: "gemini-2.5-flash-image", provider: "gemini", kind: "image", label: "Nano Banana (2.5 Flash Image)", status: "deprecated", shutdown: "2026-10-02" },
+      { id: "gemini-3.1-flash-image-preview", provider: "gemini", kind: "image", label: "Nano Banana 2 (preview)", status: "deprecated", shutdown: "2026-06-25" },
+      { id: "gemini-3-pro-image-preview", provider: "gemini", kind: "image", label: "Nano Banana Pro (preview)", status: "deprecated", shutdown: "2026-06-25" },
+      { id: "grok-imagine-image", provider: "grok", kind: "image", label: "Grok Imagine Image", default: true, status: "ga", price: { usd: 0.02, per: "image" } },
+      { id: "grok-imagine-image-2.0", provider: "grok", kind: "image", label: "Grok Imagine Image 2.0", aliases: ["pro", "2.0", "quality"], status: "ga", price: { usd: 0.08, per: "image", basis: "medium, 2K" } },
+      // ── Video ─────────────────────────────────────────────────────────────
+      { id: "seedance-2.0", provider: "seedance", kind: "video", label: "Seedance 2.0", aliases: ["quality", "2.0"], default: true, status: "ga", price: { usd: 0.3024, per: "second", basis: "720p 16:9" }, note: "4-15 s, native audio" },
+      { 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", 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" },
+      { id: "kling-v3", provider: "kling", kind: "video", label: "Kling v3", aliases: ["v3"], default: true, status: "ga", price: { usd: 0.084, per: "second", basis: "std, silent" }, note: "3-15 s, multi-shot; `std` 720p, `pro` 1080p" },
+      { id: "kling-v2-6", provider: "kling", kind: "video", label: "Kling v2.6", aliases: ["v2.6"], status: "ga", price: { usd: 0.042, per: "second", basis: "std 720p" }, note: "5 or 10 s" },
+      { id: "kling-v2-5-turbo", provider: "kling", kind: "video", label: "Kling v2.5 Turbo", aliases: ["v2.5-turbo", "v2.5"], status: "ga", price: { usd: 0.042, per: "second", basis: "std" }, note: "5 or 10 s, no audio" },
+      { id: "gen4.5", provider: "runway", kind: "video", label: "Runway Gen-4.5", default: true, status: "ga", price: { usd: 0.12, per: "second" }, note: "2-10 s, no audio" },
+      { id: "gen4_turbo", provider: "runway", kind: "video", label: "Runway Gen-4 Turbo", status: "ga", price: { usd: 0.05, per: "second" }, note: "Image-to-video only, no audio" },
+      // ── Audio ─────────────────────────────────────────────────────────────
+      { id: "eleven_v3", provider: "elevenlabs", kind: "speech", label: "ElevenLabs v3", default: true, status: "ga", price: { usd: 0.08, per: "1K characters" } },
+      { id: "gpt-4o-mini-tts", provider: "openai", kind: "speech", label: "GPT-4o mini TTS", default: true, status: "deprecated", shutdown: "2027-01-06" },
+      { id: "music_v2_5", provider: "elevenlabs", kind: "music", label: "ElevenLabs Music v2.5", default: true, status: "ga", price: { usd: 0.15, per: "minute" } },
+      { 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";
+      }
+    };
+  }
+});
+
 // ../ai-providers/dist/gemini/gemini-models.js
 function isGeminiTextModelAlias(model) {
   return Object.prototype.hasOwnProperty.call(GEMINI_TEXT_MODEL_ALIASES, model);
@@ -457,19 +565,10 @@ var GEMINI_DEFAULT_TEXT_MODEL, GEMINI_AGENT_DEFAULT_TEXT_MODEL, GEMINI_TEXT_MODE
 var init_gemini_models = __esm({
   "../ai-providers/dist/gemini/gemini-models.js"() {
     "use strict";
-    GEMINI_DEFAULT_TEXT_MODEL = "gemini-3.8-flash";
+    init_catalog();
+    GEMINI_DEFAULT_TEXT_MODEL = defaultModel("gemini", "llm").id;
     GEMINI_AGENT_DEFAULT_TEXT_MODEL = GEMINI_DEFAULT_TEXT_MODEL;
-    GEMINI_TEXT_MODEL_ALIASES = {
-      flash: GEMINI_DEFAULT_TEXT_MODEL,
-      latest: GEMINI_DEFAULT_TEXT_MODEL,
-      "flash-3.8": GEMINI_DEFAULT_TEXT_MODEL,
-      "flash-3.5": "gemini-3.5-flash",
-      "flash-3": "gemini-3-flash-preview",
-      "flash-2.5": "gemini-2.5-flash",
-      pro: "gemini-3.1-pro-preview",
-      "pro-3.1": "gemini-3.1-pro-preview",
-      "pro-2.5": "gemini-2.5-pro"
-    };
+    GEMINI_TEXT_MODEL_ALIASES = Object.fromEntries(listModels({ provider: "gemini", kind: "llm" }).flatMap((m2) => (m2.aliases ?? []).map((a4) => [a4, m2.id])));
     GEMINI_TEXT_MODEL_HELP = "flash/latest (Gemini 3.8 Flash), flash-3.8, flash-3.5, flash-3, flash-2.5, pro (Gemini 3.1 Pro), pro-3.1, pro-2.5, or a full gemini-* model ID";
   }
 });
@@ -803,19 +902,7 @@ var init_gemini_motion = __esm({
   "../ai-providers/dist/gemini/gemini-motion.js"() {
     "use strict";
     init_gemini_models();
-    GEMINI_MOTION_MODELS = {
-      gemini: GEMINI_DEFAULT_TEXT_MODEL,
-      flash: GEMINI_DEFAULT_TEXT_MODEL,
-      latest: GEMINI_DEFAULT_TEXT_MODEL,
-      "flash-3.8": GEMINI_DEFAULT_TEXT_MODEL,
-      "flash-3.5": "gemini-3.5-flash",
-      "flash-3": "gemini-3-flash-preview",
-      "flash-2.5": "gemini-2.5-flash",
-      pro: "gemini-3.1-pro-preview",
-      "2.5-pro": "gemini-2.5-pro",
-      "3.1-pro": "gemini-3.1-pro-preview",
-      "pro-3.1": "gemini-3.1-pro-preview"
-    };
+    GEMINI_MOTION_MODELS = GEMINI_TEXT_MODEL_ALIASES;
     STYLE_USER_INSTRUCTIONS = {
       minimal: "CENTER-ALIGNED pure typography. Thin lines + large title + subtitle. NO glass panels, NO bokeh, NO dark bars. Breathing pulse during hold.",
       corporate: "Data-rich info bar at bottom + top-right badge. Animated number counter. Brand color stripe. Progress bar.",
@@ -1004,13 +1091,19 @@ 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}`);
 }
-var VEO_MODEL_ALIASES, MODEL_MAP, GeminiProvider, geminiProvider;
+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"() {
     "use strict";
@@ -1018,23 +1111,8 @@ var init_GeminiProvider = __esm({
     init_gemini_models();
     init_gemini_storyboard();
     init_http();
-    VEO_MODEL_ALIASES = {
-      "3.1": "veo-3.1-generate-preview",
-      "3.1-fast": "veo-3.1-fast-generate-preview"
-    };
-    MODEL_MAP = {
-      "flash": "gemini-3.1-flash-image",
-      "3.1-flash": "gemini-3.1-flash-image",
-      "latest": "gemini-3.1-flash-image",
-      "lite": "gemini-3.1-flash-lite-image",
-      "pro": "gemini-3-pro-image",
-      "gemini-3.1-flash-image": "gemini-3.1-flash-image",
-      "gemini-3.1-flash-lite-image": "gemini-3.1-flash-lite-image",
-      "gemini-3-pro-image": "gemini-3-pro-image",
-      "gemini-2.5-flash-image": "gemini-2.5-flash-image",
-      "gemini-3.1-flash-image-preview": "gemini-3.1-flash-image-preview",
-      "gemini-3-pro-image-preview": "gemini-3-pro-image-preview"
-    };
+    init_catalog();
+    VEO_MODEL_ALIASES = Object.fromEntries(listModels({ provider: "veo", kind: "video" }).flatMap((m2) => (m2.aliases ?? []).map((a4) => [a4, m2.id])));
     GeminiProvider = class {
       constructor() {
         this.id = "gemini";
@@ -1068,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",
@@ -1245,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 }
           };
@@ -1293,9 +1371,7 @@ var init_GeminiProvider = __esm({
        * Resolve model alias to full model ID
        */
       resolveModel(model) {
-        if (!model)
-          return MODEL_MAP["flash"];
-        return MODEL_MAP[model] || MODEL_MAP["flash"];
+        return (findModel("gemini", "image", model) ?? defaultModel("gemini", "image")).id;
       }
       /**
        * Check if model is Pro
@@ -1888,7 +1964,8 @@ var init_gemini_omni = __esm({
   "../ai-providers/dist/gemini/gemini-omni.js"() {
     "use strict";
     init_http();
-    OMNI_MODEL = "gemini-omni-1.1-flash";
+    init_catalog();
+    OMNI_MODEL = defaultModel("omni", "video").id;
     API_ROOT = "https://generativelanguage.googleapis.com";
     FILE_POLL_INTERVAL_MS = 3e3;
     FILE_POLL_TIMEOUT_MS = 5 * 60 * 1e3;
@@ -2028,6 +2105,14 @@ var init_gemini = __esm({
   }
 });
 
+// ../ai-providers/dist/catalog/index.js
+var init_catalog2 = __esm({
+  "../ai-providers/dist/catalog/index.js"() {
+    "use strict";
+    init_catalog();
+  }
+});
+
 // ../ai-providers/dist/openai/openai-storyboard.js
 async function analyzeContent2(apiKey, content, targetDuration, options) {
   const creativity = options?.creativity || "low";
@@ -2040,7 +2125,7 @@ async function analyzeContent2(apiKey, content, targetDuration, options) {
         Authorization: `Bearer ${apiKey}`
       },
       body: JSON.stringify({
-        model: "gpt-5.4-mini",
+        model: defaultModel("openai", "llm").id,
         messages: [
           { role: "system", content: systemPrompt },
           { role: "user", content: buildStoryboardUserMessage(content) }
@@ -2085,6 +2170,7 @@ var init_openai_storyboard = __esm({
   "../ai-providers/dist/openai/openai-storyboard.js"() {
     "use strict";
     init_storyboard_prompt();
+    init_catalog();
   }
 });
 
@@ -2094,6 +2180,7 @@ var init_OpenAIProvider = __esm({
   "../ai-providers/dist/openai/OpenAIProvider.js"() {
     "use strict";
     init_openai_storyboard();
+    init_catalog();
     OpenAIProvider = class {
       constructor() {
         this.id = "openai-gpt";
@@ -2103,7 +2190,7 @@ var init_OpenAIProvider = __esm({
         this.iconUrl = "/icons/openai.svg";
         this.isAvailable = true;
         this.baseUrl = "https://api.openai.com/v1";
-        this.model = "gpt-5.4-mini";
+        this.model = defaultModel("openai", "llm").id;
       }
       async initialize(config4) {
         this.apiKey = config4.apiKey;
@@ -2409,7 +2496,7 @@ Each segment should be 3-10 seconds long.`;
               Authorization: `Bearer ${this.apiKey}`
             },
             body: JSON.stringify({
-              model: "gpt-5.4-mini",
+              model: defaultModel("openai", "llm").id,
               // Reasoning tokens count against this cap.
               max_completion_tokens: 16384,
               response_format: { type: "json_object" },
@@ -3810,6 +3897,7 @@ var init_ClaudeProvider = __esm({
     init_claude_analysis();
     init_claude_viral();
     init_claude_visual_fx();
+    init_catalog();
     ClaudeProvider = class {
       constructor() {
         this.id = "claude";
@@ -3819,7 +3907,7 @@ var init_ClaudeProvider = __esm({
         this.iconUrl = "/icons/claude.svg";
         this.isAvailable = true;
         this.baseUrl = "https://api.anthropic.com/v1";
-        this.model = "claude-sonnet-5-5";
+        this.model = defaultModel("claude", "llm").id;
       }
       async initialize(config4) {
         this.apiKey = config4.apiKey;
@@ -4121,11 +4209,7 @@ Instruction: ${instruction}`
         return generateNarrationScript(this.api, videoAnalysis, duration, style, language);
       }
     };
-    ClaudeProvider.MOTION_MODELS = {
-      sonnet: "claude-sonnet-5-5",
-      opus: "claude-opus-5-5",
-      "opus-4-6": "claude-opus-4-6"
-    };
+    ClaudeProvider.MOTION_MODELS = Object.fromEntries(listModels({ provider: "claude", kind: "llm" }).flatMap((m2) => (m2.aliases ?? []).map((a4) => [a4, m2.id])));
     claudeProvider = new ClaudeProvider();
   }
 });
@@ -4465,6 +4549,7 @@ var KNOWN_VOICES, TTS_429_MAX_RETRIES, TTS_429_RETRY_DELAY_MS, ELEVENLABS_MUSIC_
 var init_ElevenLabsProvider = __esm({
   "../ai-providers/dist/elevenlabs/ElevenLabsProvider.js"() {
     "use strict";
+    init_catalog();
     KNOWN_VOICES = {
       // Default/popular voices
       rachel: "21m00Tcm4TlvDq8ikWAM",
@@ -4498,7 +4583,7 @@ var init_ElevenLabsProvider = __esm({
     };
     TTS_429_MAX_RETRIES = 1;
     TTS_429_RETRY_DELAY_MS = 2e3;
-    ELEVENLABS_MUSIC_MODEL = "music_v2_5";
+    ELEVENLABS_MUSIC_MODEL = defaultModel("elevenlabs", "music").id;
     ElevenLabsProvider = class {
       constructor() {
         this.id = "elevenlabs";
@@ -5162,7 +5247,8 @@ var OPENAI_IMAGE_DEFAULT_MODEL, DEFAULT_MODEL, OpenAIImageProvider, openaiImageP
 var init_OpenAIImageProvider = __esm({
   "../ai-providers/dist/openai-image/OpenAIImageProvider.js"() {
     "use strict";
-    OPENAI_IMAGE_DEFAULT_MODEL = "gpt-image-2.5-sunburst";
+    init_catalog();
+    OPENAI_IMAGE_DEFAULT_MODEL = defaultModel("openai", "image").id;
     DEFAULT_MODEL = OPENAI_IMAGE_DEFAULT_MODEL;
     OpenAIImageProvider = class {
       constructor() {
@@ -5486,7 +5572,8 @@ var DEFAULT_MODEL3, RunwayProvider, runwayProvider;
 var init_RunwayProvider = __esm({
   "../ai-providers/dist/runway/RunwayProvider.js"() {
     "use strict";
-    DEFAULT_MODEL3 = "gen4.5";
+    init_catalog();
+    DEFAULT_MODEL3 = defaultModel("runway", "video").id;
     RunwayProvider = class _RunwayProvider {
       constructor() {
         this.id = "runway";
@@ -5539,6 +5626,13 @@ var init_RunwayProvider = __esm({
           }
           const hasImage = !!options?.referenceImage;
           const endpoint = hasImage ? "image_to_video" : "text_to_video";
+          if (!hasImage && apiRatio === "960:960") {
+            return {
+              id: "",
+              status: "failed",
+              error: "Runway text-to-video supports 16:9 and 9:16 only. Use 16:9 or 9:16, or pass an image (-i) for square output."
+            };
+          }
           const body = {
             model,
             promptText: prompt3,
@@ -5639,7 +5733,9 @@ var init_RunwayProvider = __esm({
             SUCCEEDED: "completed",
             FAILED: "failed",
             CANCELLED: "cancelled",
-            THROTTLED: "failed"
+            // THROTTLED means queued behind the account's concurrency limit; the
+            // task starts on its own, so keep polling.
+            THROTTLED: "pending"
           };
           const result = {
             id: data2.id,
@@ -5649,8 +5745,9 @@ var init_RunwayProvider = __esm({
           if (data2.status === "SUCCEEDED" && data2.output && data2.output.length > 0) {
             result.videoUrl = data2.output[0];
           }
-          if (data2.status === "FAILED" || data2.status === "THROTTLED") {
-            result.error = data2.failure || data2.failureCode || "Generation failed";
+          if (data2.status === "FAILED") {
+            const reason = data2.failure || "Generation failed";
+            result.error = data2.failureCode ? `${reason} (${data2.failureCode})` : reason;
           }
           return result;
         } catch (error) {
@@ -5662,27 +5759,14 @@ var init_RunwayProvider = __esm({
         }
       }
       /**
-       * Cancel ongoing generation
+       * Cancel a pending or running task. Runway documents cancellation as
+       * `DELETE /v1/tasks/{id}` (there is no `/cancel` route).
        */
       async cancelGeneration(id) {
-        if (!this.apiKey) {
-          return false;
-        }
-        try {
-          const response = await fetch(`${this.baseUrl}/tasks/${id}/cancel`, {
-            method: "POST",
-            headers: {
-              Authorization: `Bearer ${this.apiKey}`,
-              "X-Runway-Version": _RunwayProvider.API_VERSION
-            }
-          });
-          return response.ok;
-        } catch {
-          return false;
-        }
+        return this.deleteTask(id);
       }
       /**
-       * Delete a completed task
+       * Cancel a running task, or delete a finished one (`DELETE /v1/tasks/{id}`).
        */
       async deleteTask(id) {
         if (!this.apiKey) {
@@ -5792,19 +5876,10 @@ var init_runway = __esm({
 // ../ai-providers/dist/kling/KlingProvider.js
 import { createHmac } from "node:crypto";
 function resolveKlingModel(alias) {
-  const key2 = (alias ?? "v3").trim().toLowerCase();
-  const aliases2 = {
-    v3: "kling-v3",
-    "kling-v3": "kling-v3",
-    "v2.6": "kling-v2-6",
-    "kling-v2-6": "kling-v2-6",
-    "v2.5-turbo": "kling-v2-5-turbo",
-    "v2.5": "kling-v2-5-turbo",
-    "kling-v2-5-turbo": "kling-v2-5-turbo"
-  };
-  if (Object.hasOwn(aliases2, key2))
-    return aliases2[key2];
-  throw new Error(`Unknown Kling model "${alias}". Valid: v3, v2.6, v2.5-turbo.`);
+  const model = findModel("kling", "video", alias);
+  if (model)
+    return model.id;
+  throw new Error(`Unknown Kling model "${alias}". Valid: ${modelAliases("kling", "video").join(", ")}.`);
 }
 function klingDuration(model, seconds) {
   const requested = typeof seconds === "number" && Number.isFinite(seconds) ? Math.round(seconds) : 5;
@@ -5816,7 +5891,8 @@ var DEFAULT_MODEL4, STD_MODE_MODELS, KlingProvider, klingProvider;
 var init_KlingProvider = __esm({
   "../ai-providers/dist/kling/KlingProvider.js"() {
     "use strict";
-    DEFAULT_MODEL4 = "kling-v3";
+    init_catalog();
+    DEFAULT_MODEL4 = defaultModel("kling", "video").id;
     STD_MODE_MODELS = ["kling-v2-5-turbo", "kling-v2-6", "kling-v3"];
     KlingProvider = class {
       constructor() {
@@ -6255,31 +6331,21 @@ var init_kling = __esm({
 
 // ../ai-providers/dist/grok/GrokProvider.js
 function resolveGrokVideoModel(alias) {
-  const key2 = (alias ?? "1.5").trim().toLowerCase();
-  const aliases2 = {
-    "1.5": "grok-imagine-video-1.5",
-    "grok-imagine-video-1.5": "grok-imagine-video-1.5",
-    lite: "grok-imagine-video-1.5-lite",
-    "1.5-lite": "grok-imagine-video-1.5-lite",
-    "grok-imagine-video-1.5-lite": "grok-imagine-video-1.5-lite",
-    classic: "grok-imagine-video",
-    "grok-imagine-video": "grok-imagine-video"
-  };
-  if (Object.hasOwn(aliases2, key2))
-    return aliases2[key2];
-  throw new Error(`Unknown Grok video model "${alias}". Valid: 1.5, lite, classic.`);
+  const model = findModel("grok", "video", alias);
+  if (model)
+    return model.id;
+  throw new Error(`Unknown Grok video model "${alias}". Valid: ${modelAliases("grok", "video").join(", ")}.`);
 }
 function resolveGrokImageModel(alias) {
-  if (alias === "pro" || alias === "2.0" || alias === "quality" || alias === "grok-imagine-image-2.0") {
-    return { model: "grok-imagine-image-2.0", quality: "medium" };
-  }
-  return { model: "grok-imagine-image" };
+  const model = (findModel("grok", "image", alias) ?? defaultModel("grok", "image")).id;
+  return model === "grok-imagine-image-2.0" ? { model, quality: "medium" } : { model };
 }
 var DEFAULT_MODEL5, DEFAULT_VIDEO_RESOLUTION, GROK_VIDEO_RESOLUTIONS, GrokProvider, grokProvider;
 var init_GrokProvider = __esm({
   "../ai-providers/dist/grok/GrokProvider.js"() {
     "use strict";
-    DEFAULT_MODEL5 = "grok-imagine-video-1.5";
+    init_catalog();
+    DEFAULT_MODEL5 = defaultModel("grok", "video").id;
     DEFAULT_VIDEO_RESOLUTION = "720p";
     GROK_VIDEO_RESOLUTIONS = ["480p", "720p", "1080p"];
     GrokProvider = class {
@@ -10722,19 +10788,10 @@ var require_src = __commonJS({
 
 // ../ai-providers/dist/fal/FalProvider.js
 function resolveSeedanceVariant(alias) {
-  const key2 = (alias ?? "quality").trim().toLowerCase();
-  const aliases2 = {
-    quality: "seedance-2.0",
-    "2.0": "seedance-2.0",
-    "seedance-2.0": "seedance-2.0",
-    fast: "seedance-2.0-fast",
-    "seedance-2.0-fast": "seedance-2.0-fast",
-    "2.5": "seedance-2.5",
-    "seedance-2.5": "seedance-2.5"
-  };
-  if (Object.hasOwn(aliases2, key2))
-    return aliases2[key2];
-  throw new Error(`Unknown Seedance model "${alias}". Valid: quality, fast, 2.5.`);
+  const model = findModel("seedance", "video", alias);
+  if (model)
+    return model.id;
+  throw new Error(`Unknown Seedance model "${alias}". Valid: ${modelAliases("seedance", "video").join(", ")}.`);
 }
 function estimateSeedanceVideoCostUsd(opts) {
   const shortSide = SEEDANCE_SHORT_SIDE[opts.resolution ?? "720p"] ?? 720;
@@ -10862,6 +10919,7 @@ var init_FalProvider = __esm({
   "../ai-providers/dist/fal/FalProvider.js"() {
     "use strict";
     import_client = __toESM(require_src(), 1);
+    init_catalog();
     ENDPOINT_TEXT_TO_VIDEO = {
       "seedance-2.0": "bytedance/seedance-2.0/text-to-video",
       "seedance-2.0-fast": "bytedance/seedance-2.0/fast/text-to-video",
@@ -11706,6 +11764,8 @@ __export(dist_exports, {
   KOKORO_MODEL_ID: () => KOKORO_MODEL_ID,
   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,
@@ -11717,12 +11777,15 @@ __export(dist_exports, {
   RunwayProvider: () => RunwayProvider,
   VEO_MODEL_ALIASES: () => VEO_MODEL_ALIASES,
   WhisperProvider: () => WhisperProvider,
+  assertModelServed: () => assertModelServed,
   claudeProvider: () => claudeProvider,
+  defaultModel: () => defaultModel,
   defineApiKey: () => defineApiKey,
   defineProvider: () => defineProvider,
   elevenLabsProvider: () => elevenLabsProvider,
   estimateSeedanceVideoCostUsd: () => estimateSeedanceVideoCostUsd,
   falProvider: () => falProvider,
+  findModel: () => findModel,
   geminiProvider: () => geminiProvider,
   getAllApiKeys: () => getAllApiKeys,
   getAllProviders: () => getAllProviders,
@@ -11739,8 +11802,11 @@ __export(dist_exports, {
   klingDuration: () => klingDuration,
   klingProvider: () => klingProvider,
   kokoroProvider: () => kokoroProvider,
+  listModels: () => listModels,
   loadBundledKokoroRuntime: () => loadBundledKokoroRuntime,
   loadKokoroFromWorkspace: () => loadKokoroFromWorkspace,
+  modelAliases: () => modelAliases,
+  modelLifecycle: () => modelLifecycle,
   ollamaProvider: () => ollamaProvider,
   omniProvider: () => omniProvider,
   openaiImageProvider: () => openaiImageProvider,
@@ -11767,6 +11833,7 @@ var init_dist = __esm({
     init_define_provider();
     init_whisper();
     init_gemini();
+    init_catalog2();
     init_openai();
     init_claude();
     init_ollama();
@@ -20009,12 +20076,15 @@ var init_ai_helpers = __esm({
 });
 
 // ../cli/src/commands/_shared/video-utils.ts
-async function uploadToImgbb(imageBuffer, apiKey) {
+async function uploadToImgbb(imageBuffer, apiKey, expirationSeconds) {
   try {
     const base64Image = imageBuffer.toString("base64");
     const formData = new URLSearchParams();
     formData.append("key", apiKey);
     formData.append("image", base64Image);
+    if (expirationSeconds !== void 0) {
+      formData.append("expiration", String(expirationSeconds));
+    }
     const response = await fetch("https://api.imgbb.com/1/upload", {
       method: "POST",
       body: formData
@@ -20077,7 +20147,10 @@ function awsEncode(value) {
     (c2) => `%${c2.charCodeAt(0).toString(16).toUpperCase()}`
   );
 }
-function presignS3PutUrl(params) {
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, Math.round(value)));
+}
+function presignS3Url(params) {
   const now = /* @__PURE__ */ new Date();
   const amzDate = now.toISOString().replace(/[:-]|\.\d{3}/g, "");
   const dateStamp = amzDate.slice(0, 8);
@@ -20088,7 +20161,7 @@ function presignS3PutUrl(params) {
     "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
     "X-Amz-Credential": `${params.accessKeyId}/${credentialScope}`,
     "X-Amz-Date": amzDate,
-    "X-Amz-Expires": String(params.ttlSeconds),
+    "X-Amz-Expires": String(clamp(params.ttlSeconds, 1, S3_MAX_PRESIGN_SECONDS)),
     "X-Amz-SignedHeaders": "host"
   };
   if (params.sessionToken) {
@@ -20096,7 +20169,7 @@ function presignS3PutUrl(params) {
   }
   const canonicalQuery = Object.entries(query2).sort(([a4], [b4]) => a4.localeCompare(b4)).map(([key2, value]) => `${awsEncode(key2)}=${awsEncode(value)}`).join("&");
   const canonicalRequest = [
-    "PUT",
+    params.method,
     canonicalUri,
     canonicalQuery,
     `host:${host}`,
@@ -20155,7 +20228,8 @@ async function resolveUploadHost() {
         const ext = extensionFor(opts);
         const prefix = safePrefix(settings.s3.prefix);
         const key2 = `${prefix}/${Date.now()}-${randomUUID()}.${ext}`;
-        const presignedUrl = presignS3PutUrl({
+        const presignedUrl = presignS3Url({
+          method: "PUT",
           accessKeyId,
           secretAccessKey,
           sessionToken,
@@ -20174,10 +20248,26 @@ async function resolveUploadHost() {
         if (!response.ok) {
           throw new Error(`S3 upload failed (${response.status}): ${response.statusText}`);
         }
+        if (settings.s3.publicBaseUrl) {
+          return {
+            provider: "s3",
+            url: publicS3Url({ region, bucket, key: key2, publicBaseUrl: settings.s3.publicBaseUrl })
+          };
+        }
+        const ttlSeconds = clamp(settings.ttlSeconds, 1, S3_MAX_PRESIGN_SECONDS);
         return {
           provider: "s3",
-          url: publicS3Url({ region, bucket, key: key2, publicBaseUrl: settings.s3.publicBaseUrl }),
-          expiresAt: new Date(Date.now() + settings.ttlSeconds * 1e3).toISOString()
+          url: presignS3Url({
+            method: "GET",
+            accessKeyId,
+            secretAccessKey,
+            sessionToken,
+            region,
+            bucket,
+            key: key2,
+            ttlSeconds
+          }),
+          expiresAt: new Date(Date.now() + ttlSeconds * 1e3).toISOString()
         };
       }
     };
@@ -20189,19 +20279,28 @@ async function resolveUploadHost() {
       if (!imgbbKey) {
         throw new Error("IMGBB_API_KEY required for image-to-video uploads.");
       }
-      const result = await uploadToImgbb(imageBuffer, imgbbKey);
+      const expiration = clamp(settings.ttlSeconds, IMGBB_MIN_EXPIRATION_SECONDS, IMGBB_MAX_EXPIRATION_SECONDS);
+      const result = await uploadToImgbb(imageBuffer, imgbbKey, expiration);
       if (!result.success || !result.url) {
         throw new Error(`ImgBB upload failed: ${result.error ?? "unknown error"}`);
       }
-      return { provider: "imgbb", url: result.url };
+      return {
+        provider: "imgbb",
+        url: result.url,
+        expiresAt: new Date(Date.now() + expiration * 1e3).toISOString()
+      };
     }
   };
 }
+var S3_MAX_PRESIGN_SECONDS, IMGBB_MIN_EXPIRATION_SECONDS, IMGBB_MAX_EXPIRATION_SECONDS;
 var init_upload_host = __esm({
   "../cli/src/utils/upload-host.ts"() {
     "use strict";
     init_config();
     init_video_utils();
+    S3_MAX_PRESIGN_SECONDS = 7 * 24 * 60 * 60;
+    IMGBB_MIN_EXPIRATION_SECONDS = 60;
+    IMGBB_MAX_EXPIRATION_SECONDS = 15552e3;
   }
 });
 
@@ -20842,6 +20941,7 @@ async function executeVideoGenerate(options) {
     negative,
     resolution,
     veoModel = "3.1-fast",
+    runwayModel,
     seedanceModel = "quality",
     grokModel,
     klingModel,
@@ -20931,6 +21031,7 @@ async function executeVideoGenerate(options) {
       await runway.initialize({ apiKey: key2 });
       const result = await runway.generateVideo(prompt3, {
         prompt: prompt3,
+        model: runwayModel,
         referenceImage,
         duration,
         aspectRatio: ratio,
@@ -268467,8 +268568,43 @@ 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()) {
     console.log(...args);
@@ -275942,16 +276078,14 @@ import { tmpdir as tmpdir9 } from "node:os";
 import { createHash as createHash11 } from "node:crypto";
 async function ensureRemotionInstalled() {
   try {
-    await execSafe("npx", ["--yes", "remotion", "--help"], { timeout: 6e4 });
+    await execSafe("npm", ["--version"], { timeout: 3e4 });
     return null;
   } catch (error) {
     const detail = error instanceof Error ? error.message : String(error);
-    console.error(`[Remotion] ensureRemotionInstalled failed: ${detail.slice(0, 300)}`);
     return [
-      "Remotion CLI not found or failed to initialize.",
+      "Remotion renders need npm to install the Remotion CLI into a temporary project.",
       `  Debug: ${detail.slice(0, 200)}`,
-      "  Fix: npm install -g @remotion/cli",
-      "  Or ensure npx is available and can download @remotion/cli on demand."
+      "  Fix: install Node.js 20+ (which includes npm) and make sure `npm` is on PATH."
     ].join("\n");
   }
 }
@@ -277074,7 +277208,7 @@ ${textsToTranslate}`;
             Authorization: `Bearer ${openaiKey}`
           },
           body: JSON.stringify({
-            model: "gpt-5.4-mini",
+            model: defaultModel("openai", "llm").id,
             messages: [{ role: "user", content: translatePrompt }]
           })
         });
@@ -277102,7 +277236,7 @@ ${textsToTranslate}`;
             "anthropic-version": "2023-06-01"
           },
           body: JSON.stringify({
-            model: "claude-sonnet-5-5",
+            model: defaultModel("claude", "llm").id,
             max_tokens: 16e3,
             messages: [{ role: "user", content: translatePrompt }]
           })
@@ -277153,6 +277287,7 @@ var init_translate_srt = __esm({
   "../cli/src/commands/_shared/edit/translate-srt.ts"() {
     "use strict";
     init_subtitle();
+    init_dist();
   }
 });
 
@@ -278353,22 +278488,13 @@ function analyzeGapFillability(gaps, videoClips, sources) {
     return { gap, canExtendBefore, canExtendAfter, remainingGap, gapStart };
   });
 }
-async function uploadFrameToImgbb(framePath, imgbbApiKey) {
+async function uploadFrame(host, framePath) {
   try {
-    const frameBuffer = await readFile26(framePath);
-    const frameBase64 = frameBuffer.toString("base64");
-    const formData = new FormData();
-    formData.append("key", imgbbApiKey);
-    formData.append("image", frameBase64);
-    const response = await fetch("https://api.imgbb.com/1/upload", {
-      method: "POST",
-      body: formData
+    const upload = await host.uploadImage(await readFile26(framePath), {
+      filename: framePath,
+      mimeType: "image/png"
     });
-    const data2 = await response.json();
-    if (!data2.success || !data2.data?.url) {
-      return { error: data2.error?.message || "Upload failed" };
-    }
-    return { url: data2.data.url };
+    return { url: upload.url };
   } catch (err) {
     return { error: err instanceof Error ? err.message : String(err) };
   }
@@ -278519,11 +278645,13 @@ async function executeFillGaps(options) {
       await mkdir20(footageDir, { recursive: true });
     }
     humanLines.push("Generating AI Videos");
-    const imgbbApiKey = options.imgbbApiKey || await getApiKey("IMGBB_API_KEY", "imgbb", void 0);
-    if (!imgbbApiKey) {
+    let uploadHost;
+    try {
+      uploadHost = await resolveUploadHost();
+    } catch (err) {
       return {
         success: false,
-        error: "IMGBB_API_KEY required for image hosting. Get a free API key at https://api.imgbb.com/",
+        error: err instanceof Error ? err.message : String(err),
         humanLines
       };
     }
@@ -278567,12 +278695,12 @@ async function executeFillGaps(options) {
           humanLines
         };
       }
-      onProgress("Uploading frame to imgbb...");
-      const upload = await uploadFrameToImgbb(framePath, imgbbApiKey);
+      onProgress(`Uploading frame via ${uploadHost.provider}...`);
+      const upload = await uploadFrame(uploadHost, framePath);
       if (!upload.url) {
         return {
           success: false,
-          error: `Failed to upload frame to imgbb: ${upload.error || "unknown"}`,
+          error: `Failed to upload frame via ${uploadHost.provider}: ${upload.error || "unknown"}`,
           humanLines
         };
       }
@@ -278647,7 +278775,7 @@ async function executeFillGaps(options) {
           humanLines.push("  Failed to extract frame for continuation");
           break;
         }
-        const extUpload = await uploadFrameToImgbb(lastFramePath, imgbbApiKey);
+        const extUpload = await uploadFrame(uploadHost, lastFramePath);
         if (!extUpload.url) {
           humanLines.push("  Failed to upload continuation frame");
           break;
@@ -278770,6 +278898,7 @@ var init_execute_fill_gaps = __esm({
     init_dist();
     init_engine();
     init_api_key();
+    init_upload_host();
     init_exec_safe();
     init_project_resolver();
     init_ai_helpers();
@@ -278837,6 +278966,13 @@ __export(ai_motion_exports, {
 import { resolve as resolve48 } from "node:path";
 import { existsSync as existsSync69 } from "node:fs";
 import { readFile as readFile27, writeFile as writeFile29 } from "node:fs/promises";
+function resolveMotionModel(alias) {
+  const claude = findModel("claude", "llm", alias);
+  if (claude) return { provider: "claude", modelId: claude.id };
+  const gemini = findModel("gemini", "llm", alias);
+  if (gemini) return { provider: "gemini", modelId: gemini.id };
+  return { provider: "claude", modelId: defaultModel("claude", "llm").id };
+}
 async function getOptionalGoogleApiKey() {
   const configKey = await getApiKeyFromConfig("google");
   if (configKey) return configKey;
@@ -278851,7 +278987,7 @@ function normalizeUnderstand(value) {
 }
 async function executeMotion(options) {
   const modelAlias = options.model || "sonnet";
-  const modelConfig = MODEL_MAP2[modelAlias] ?? MODEL_MAP2["sonnet"];
+  const modelConfig = resolveMotionModel(modelAlias);
   const useGemini = modelConfig.provider === "gemini";
   const width = options.width || 1920;
   const height = options.height || 1080;
@@ -279230,7 +279366,6 @@ function registerMotionCommand(aiCommand) {
     }
   });
 }
-var MODEL_MAP2;
 var init_ai_motion = __esm({
   "../cli/src/commands/ai-motion.ts"() {
     "use strict";
@@ -279241,14 +279376,6 @@ var init_ai_motion = __esm({
     init_config();
     init_output();
     init_validate();
-    MODEL_MAP2 = {
-      sonnet: { provider: "claude", modelId: "claude-sonnet-5-5" },
-      opus: { provider: "claude", modelId: "claude-opus-5-5" },
-      "opus-4-6": { provider: "claude", modelId: "claude-opus-4-6" },
-      gemini: { provider: "gemini", modelId: GEMINI_DEFAULT_TEXT_MODEL },
-      "gemini-2.5-pro": { provider: "gemini", modelId: "gemini-2.5-pro" },
-      "gemini-3.1-pro": { provider: "gemini", modelId: "gemini-3.1-pro-preview" }
-    };
   }
 });
 
@@ -282079,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";
@@ -282090,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,
@@ -282247,6 +282413,7 @@ function registerVideoExtendCommand(parent) {
           outputSuccess({
             command: "generate video-extend",
             startedAt,
+            warnings: lifecycleWarnings,
             data: {
               provider: "veo",
               taskId: result.id,
@@ -282295,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();
@@ -282362,16 +282530,8 @@ var init_provider_resolver = __esm({
 
 // ../cli/src/commands/_shared/openai-image.ts
 function resolveOpenAIImageModel(modelAlias) {
-  const alias = modelAlias?.trim() ?? "";
-  for (const [id, model] of Object.entries(OPENAI_IMAGE_MODELS)) {
-    if (alias === id || model.aliases.includes(alias)) {
-      return { openaiModel: id, modelLabel: model.label };
-    }
-  }
-  return {
-    openaiModel: OPENAI_IMAGE_DEFAULT_MODEL,
-    modelLabel: OPENAI_IMAGE_MODELS[OPENAI_IMAGE_DEFAULT_MODEL].label
-  };
+  const model = findModel("openai", "image", modelAlias) ?? defaultModel("openai", "image");
+  return { openaiModel: model.id, modelLabel: model.label };
 }
 async function executeOpenAIImageGenerate(prompt3, options, ctx) {
   const provider = new OpenAIImageProvider();
@@ -282386,18 +282546,45 @@ async function executeOpenAIImageGenerate(prompt3, options, ctx) {
   });
   return { result, openaiModel, modelLabel };
 }
-var OPENAI_IMAGE_MODELS;
 var init_openai_image2 = __esm({
   "../cli/src/commands/_shared/openai-image.ts"() {
     "use strict";
     init_dist();
-    OPENAI_IMAGE_MODELS = {
-      "gpt-image-2.5-sunburst": { label: "GPT Image 2.5 Sunburst", aliases: ["2.5", "sunburst"] },
-      "gpt-image-2.5-flare": { label: "GPT Image 2.5 Flare", aliases: ["flare", "2.5-flare"] },
-      "gpt-image-2": { label: "GPT Image 2", aliases: ["2"] },
-      "gpt-image-1.5": { label: "GPT Image 1.5", aliases: ["1.5"] }
+  }
+});
+
+// ../cli/src/commands/_shared/image-cost.ts
+function catalogPrice(provider, model) {
+  if (provider === "openai") return findModel("openai", "image", resolveOpenAIImageModel(model).openaiModel)?.price?.usd;
+  if (provider === "gemini") return findModel("gemini", "image", model ?? "flash")?.price?.usd ?? findModel("gemini", "image")?.price?.usd;
+  if (provider === "grok") return findModel("grok", "image", resolveGrokImageModel(model).model)?.price?.usd;
+  return void 0;
+}
+function estimateImageCostUsd(provider, model, count) {
+  const images = Math.max(1, count);
+  const perImage = catalogPrice(provider, model);
+  if (perImage === void 0) {
+    return {
+      costUsd: lookupCostEstimateUpperBound("generate image") ?? 5,
+      warnings: [
+        `costUsd is the tier upper bound for ${provider} - actual provider billing is typically lower and is not metered here.`
+      ]
     };
   }
+  return {
+    costUsd: Number((perImage * images).toFixed(3)),
+    warnings: [
+      `costUsd is an upper-bound estimate from ${provider} list prices for ${images} image(s) - not metered billing.`
+    ]
+  };
+}
+var init_image_cost = __esm({
+  "../cli/src/commands/_shared/image-cost.ts"() {
+    "use strict";
+    init_dist();
+    init_output();
+    init_openai_image2();
+  }
 });
 
 // ../cli/src/commands/generate/image.ts
@@ -282497,6 +282684,7 @@ Examples:
           command: "generate image",
           startedAt,
           dryRun: true,
+          ...estimateImageCostUsd(provider, options.model, parseInt(options.count) || 1),
           data: {
             params: {
               prompt: prompt3,
@@ -282546,6 +282734,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
+            ...estimateImageCostUsd("openai", options.model, result.images.length),
             data: {
               provider: "openai",
               model: modelLabel,
@@ -282661,7 +282850,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
-            warnings: [],
+            ...estimateImageCostUsd("gemini", options.model, result.images.length),
             data: {
               provider: "gemini",
               model: usedLabel,
@@ -282756,6 +282945,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
+            ...estimateImageCostUsd("grok", options.model, result.images.length),
             data: {
               provider: "grok",
               modelId: resolveGrokImageModel(options.model).model,
@@ -282875,6 +283065,7 @@ var init_image2 = __esm({
     init_validate();
     init_provider_resolver();
     init_openai_image2();
+    init_image_cost();
     init_image_file();
   }
 });
@@ -283974,6 +284165,16 @@ Examples:
         log(`${provider} does not support 1:1 \u2014 falling back to 16:9`);
         options.ratio = "16:9";
       }
+      try {
+        if (provider === "seedance" || provider === "fal") resolveSeedanceVariant(options.seedanceModel);
+        if (provider === "grok") resolveGrokVideoModel(options.grokModel);
+        if (provider === "kling") resolveKlingModel(options.klingModel);
+        if (provider === "veo") resolveVeoModel(options.veoModel);
+      } 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({
@@ -283981,6 +284182,7 @@ Examples:
           startedAt,
           dryRun: true,
           costUsd,
+          warnings: lifecycleWarnings,
           data: {
             params: {
               prompt: prompt3,
@@ -283988,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,
@@ -284386,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,
@@ -284398,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}`);
       }
@@ -284525,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";
@@ -284534,6 +284729,7 @@ var init_video = __esm({
     init_dist5();
     init_dist();
     init_api_key();
+    init_model_lifecycle();
     init_tty();
     init_output();
     init_validate();
@@ -284541,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.";
   }
 });
 
@@ -284651,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
@@ -298375,10 +298570,11 @@ var init_openai3 = __esm({
   "../cli/src/agent/adapters/openai.ts"() {
     "use strict";
     init_openai2();
+    init_dist();
     OpenAIAdapter = class {
       provider = "openai";
       client = null;
-      model = "gpt-5.4-mini";
+      model = defaultModel("openai", "llm").id;
       async initialize(apiKey) {
         this.client = new openai_default({ apiKey });
       }
@@ -301924,10 +302120,11 @@ var init_claude2 = __esm({
   "../cli/src/agent/adapters/claude.ts"() {
     "use strict";
     init_sdk();
+    init_dist();
     ClaudeAdapter = class {
       provider = "claude";
       client = null;
-      model = "claude-sonnet-5-5";
+      model = defaultModel("claude", "llm").id;
       async initialize(apiKey) {
         this.client = new sdk_default({ apiKey });
       }
@@ -303363,10 +303560,11 @@ var init_xai = __esm({
   "../cli/src/agent/adapters/xai.ts"() {
     "use strict";
     init_openai2();
+    init_dist();
     XAIAdapter = class {
       provider = "xai";
       client = null;
-      model = "grok-4.3";
+      model = defaultModel("grok", "llm").id;
       async initialize(apiKey) {
         this.client = new openai_default({
           apiKey,
@@ -303833,6 +304031,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect scenes",
             startedAt,
@@ -303952,6 +304151,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect silence",
             startedAt,
@@ -304038,6 +304238,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect beats",
             startedAt,
@@ -304157,8 +304358,9 @@ var EXPLICIT_COMMAND_METADATA = {
   schema: { surface: "agent", note: "Machine-readable command discovery." },
   completion: { surface: "advanced", note: "Shell ergonomics helper." },
   agent: {
-    surface: "advanced",
-    note: "Optional fallback REPL; external coding agents are the primary workflow."
+    surface: "legacy",
+    replacement: "a host agent (Claude Code, Codex, Cursor) or the MCP server via `vibe host setup`",
+    note: "Deprecated built-in REPL, removed before 1.0."
   },
   "design.validate": { surface: "public", note: "Validate the DESIGN.md visual contract." },
   "generate.image": { surface: "public" },
@@ -309748,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(
@@ -314191,8 +314393,9 @@ they want for a given task. This guide is the operator-facing summary.
 
 If you already use Claude Code, Codex, Cursor, Aider, Gemini CLI, OpenCode,
 or another coding agent, let that host drive \`vibe\` directly through shell
-commands plus \`AGENTS.md\` / \`CLAUDE.md\`. \`vibe agent\` is the optional
-built-in fallback when you do not already have an agent host.
+commands plus \`AGENTS.md\` / \`CLAUDE.md\`. Without a coding agent, connect
+the MCP server to Claude Desktop or ChatGPT (\`vibe host setup\`).
+\`vibe agent\` is deprecated and will be removed before 1.0.
 
 ## TL;DR
 
@@ -314203,12 +314406,12 @@ built-in fallback when you do not already have an agent host.
 | **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** | optional built-in exploration | finished script | repeatable workflows |
+| **Best for** | deprecated; use a host agent | finished script | repeatable workflows |
 
 ## Decision tree
 
 - "I am already in Claude Code/Codex/Cursor/etc." \u2192 regular \`vibe\` shell commands + \`vibe guide\` / \`vibe schema\`
-- "I want to play and do not have an external coding agent" \u2192 \`vibe agent\`
+- "I do not use a coding agent" \u2192 the MCP server in Claude Desktop or ChatGPT (\`vibe host setup\`)
 - "I have a finished script + visual identity" \u2192 \`vibe build\`
 - "I want this to run again next month" \u2192 \`vibe run\`
 
@@ -314234,9 +314437,6 @@ agent calls them through a tool manifest; \`build\` calls a curated subset
 - \`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.
 `;
@@ -314343,17 +314543,17 @@ var META = {
   },
   architecture: {
     title: "external agents / vibe agent / build / run",
-    summary: "Choose between host-agent shell use, optional built-in agent mode, storyboard builds, and YAML pipelines",
+    summary: "Choose between host-agent shell use, MCP hosts, storyboard builds, and YAML pipelines",
     steps: [
       "If you are already in Claude Code/Codex/Cursor/etc., let that host drive normal `vibe` shell commands using `AGENTS.md`, `vibe guide`, and `vibe schema`.",
-      "Pick `vibe agent` only for optional built-in exploration when no external agent host is driving the CLI.",
+      "Without a coding agent, connect the MCP server to Claude Desktop or ChatGPT with `vibe host setup`; `vibe agent` is deprecated.",
       "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 host setup",
       "vibe build",
       "vibe run",
       "vibe doctor",
@@ -315349,7 +315549,7 @@ function handleCliFlags(argv, version2) {
 }
 
 // src/index.ts
-if (handleCliFlags(process.argv.slice(2), "0.115.3")) {
+if (handleCliFlags(process.argv.slice(2), "0.115.5")) {
   process.exit(0);
 }
 console.log = (...args) => console.error(...args);
@@ -315362,7 +315562,7 @@ var server = new Server(
   {
     name: "vibeframe",
     // Stamped with the package version by build.js at bundle time.
-    version: "0.115.3"
+    version: "0.115.5"
   },
   {
     capabilities: {