@vibeframe/cli 0.115.3 → 0.115.4

package/dist/index.js

@@ -7222,6 +7222,82 @@ var init_whisper = __esm({
   }
 });
 
+// ../ai-providers/dist/catalog/catalog.js
+function listModels(filter = {}) {
+  return MODEL_CATALOG.filter((m) => (!filter.provider || m.provider === filter.provider) && (!filter.kind || m.kind === filter.kind));
+}
+function defaultModel(provider, kind) {
+  const found = MODEL_CATALOG.find((m) => m.provider === provider && m.kind === kind && m.default);
+  if (!found)
+    throw new Error(`Model catalog has no default ${kind} model for ${provider}`);
+  return found;
+}
+function findModel(provider, kind, aliasOrId) {
+  const key = aliasOrId?.trim();
+  if (!key)
+    return defaultModel(provider, kind);
+  const lower = key.toLowerCase();
+  return listModels({ provider, kind }).find((m) => m.id === key || m.aliases?.includes(lower));
+}
+function modelAliases(provider, kind) {
+  return listModels({ provider, kind }).flatMap((m) => m.aliases ?? []);
+}
+var MODEL_CATALOG;
+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", 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: "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" }
+    ];
+  }
+});
+
 // ../ai-providers/dist/gemini/gemini-models.js
 function isGeminiTextModelAlias(model) {
   return Object.prototype.hasOwnProperty.call(GEMINI_TEXT_MODEL_ALIASES, model);
@@ -7240,19 +7316,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((m) => (m.aliases ?? []).map((a) => [a, m.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";
   }
 });
@@ -7586,19 +7653,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.",
@@ -7793,7 +7848,7 @@ function resolveVeoModel(alias) {
   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;
+var VEO_MODEL_ALIASES, GeminiProvider, geminiProvider;
 var init_GeminiProvider = __esm({
   "../ai-providers/dist/gemini/GeminiProvider.js"() {
     "use strict";
@@ -7801,23 +7856,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((m) => (m.aliases ?? []).map((a) => [a, m.id])));
     GeminiProvider = class {
       constructor() {
         this.id = "gemini";
@@ -8076,9 +8116,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
@@ -8671,7 +8709,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;
@@ -8811,6 +8850,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";
@@ -8823,7 +8870,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) }
@@ -8868,6 +8915,7 @@ var init_openai_storyboard = __esm({
   "../ai-providers/dist/openai/openai-storyboard.js"() {
     "use strict";
     init_storyboard_prompt();
+    init_catalog();
   }
 });
 
@@ -8877,6 +8925,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";
@@ -8886,7 +8935,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(config2) {
         this.apiKey = config2.apiKey;
@@ -9192,7 +9241,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" },
@@ -10593,6 +10642,7 @@ var init_ClaudeProvider = __esm({
     init_claude_analysis();
     init_claude_viral();
     init_claude_visual_fx();
+    init_catalog();
     ClaudeProvider = class {
       constructor() {
         this.id = "claude";
@@ -10602,7 +10652,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(config2) {
         this.apiKey = config2.apiKey;
@@ -10904,11 +10954,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((m) => (m.aliases ?? []).map((a) => [a, m.id])));
     claudeProvider = new ClaudeProvider();
   }
 });
@@ -11248,6 +11294,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",
@@ -11281,7 +11328,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";
@@ -11945,7 +11992,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() {
@@ -12269,7 +12317,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";
@@ -12322,6 +12371,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,
@@ -12422,7 +12478,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: data.id,
@@ -12432,8 +12490,9 @@ var init_RunwayProvider = __esm({
           if (data.status === "SUCCEEDED" && data.output && data.output.length > 0) {
             result.videoUrl = data.output[0];
           }
-          if (data.status === "FAILED" || data.status === "THROTTLED") {
-            result.error = data.failure || data.failureCode || "Generation failed";
+          if (data.status === "FAILED") {
+            const reason = data.failure || "Generation failed";
+            result.error = data.failureCode ? `${reason} (${data.failureCode})` : reason;
           }
           return result;
         } catch (error) {
@@ -12445,27 +12504,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) {
@@ -12575,19 +12621,10 @@ var init_runway = __esm({
 // ../ai-providers/dist/kling/KlingProvider.js
 import { createHmac } from "node:crypto";
 function resolveKlingModel(alias) {
-  const key = (alias ?? "v3").trim().toLowerCase();
-  const aliases = {
-    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(aliases, key))
-    return aliases[key];
-  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;
@@ -12599,7 +12636,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() {
@@ -13038,31 +13076,21 @@ var init_kling = __esm({
 
 // ../ai-providers/dist/grok/GrokProvider.js
 function resolveGrokVideoModel(alias) {
-  const key = (alias ?? "1.5").trim().toLowerCase();
-  const aliases = {
-    "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(aliases, key))
-    return aliases[key];
-  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 {
@@ -17505,19 +17533,10 @@ var require_src = __commonJS({
 
 // ../ai-providers/dist/fal/FalProvider.js
 function resolveSeedanceVariant(alias) {
-  const key = (alias ?? "quality").trim().toLowerCase();
-  const aliases = {
-    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(aliases, key))
-    return aliases[key];
-  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;
@@ -17645,6 +17664,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",
@@ -18489,6 +18509,7 @@ __export(dist_exports2, {
   KOKORO_MODEL_ID: () => KOKORO_MODEL_ID,
   KlingProvider: () => KlingProvider,
   KokoroProvider: () => KokoroProvider,
+  MODEL_CATALOG: () => MODEL_CATALOG,
   OPENAI_IMAGE_DEFAULT_MODEL: () => OPENAI_IMAGE_DEFAULT_MODEL,
   OPENAI_TTS_VOICES: () => OPENAI_TTS_VOICES,
   OllamaProvider: () => OllamaProvider,
@@ -18501,11 +18522,13 @@ __export(dist_exports2, {
   VEO_MODEL_ALIASES: () => VEO_MODEL_ALIASES,
   WhisperProvider: () => WhisperProvider,
   claudeProvider: () => claudeProvider,
+  defaultModel: () => defaultModel,
   defineApiKey: () => defineApiKey,
   defineProvider: () => defineProvider,
   elevenLabsProvider: () => elevenLabsProvider,
   estimateSeedanceVideoCostUsd: () => estimateSeedanceVideoCostUsd,
   falProvider: () => falProvider,
+  findModel: () => findModel,
   geminiProvider: () => geminiProvider,
   getAllApiKeys: () => getAllApiKeys,
   getAllProviders: () => getAllProviders,
@@ -18522,8 +18545,10 @@ __export(dist_exports2, {
   klingDuration: () => klingDuration,
   klingProvider: () => klingProvider,
   kokoroProvider: () => kokoroProvider,
+  listModels: () => listModels,
   loadBundledKokoroRuntime: () => loadBundledKokoroRuntime,
   loadKokoroFromWorkspace: () => loadKokoroFromWorkspace,
+  modelAliases: () => modelAliases,
   ollamaProvider: () => ollamaProvider,
   omniProvider: () => omniProvider,
   openaiImageProvider: () => openaiImageProvider,
@@ -18550,6 +18575,7 @@ var init_dist2 = __esm({
     init_define_provider();
     init_whisper();
     init_gemini();
+    init_catalog2();
     init_openai();
     init_claude();
     init_ollama();
@@ -32160,16 +32186,14 @@ import { tmpdir } from "node:os";
 import { createHash } 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");
   }
 }
@@ -32911,6 +32935,13 @@ __export(ai_motion_exports, {
 import { resolve as resolve18 } from "node:path";
 import { existsSync as existsSync13 } from "node:fs";
 import { readFile as readFile14, writeFile as writeFile14 } 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;
@@ -32925,7 +32956,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;
@@ -33304,7 +33335,6 @@ function registerMotionCommand(aiCommand) {
     }
   });
 }
-var MODEL_MAP2;
 var init_ai_motion = __esm({
   "src/commands/ai-motion.ts"() {
     "use strict";
@@ -33315,14 +33345,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" }
-    };
   }
 });
 
@@ -34088,12 +34110,15 @@ var init_ai_helpers = __esm({
 });
 
 // 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
@@ -34156,7 +34181,10 @@ function awsEncode(value) {
     (c) => `%${c.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);
@@ -34167,7 +34195,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) {
@@ -34175,7 +34203,7 @@ function presignS3PutUrl(params) {
   }
   const canonicalQuery = Object.entries(query).sort(([a], [b]) => a.localeCompare(b)).map(([key, value]) => `${awsEncode(key)}=${awsEncode(value)}`).join("&");
   const canonicalRequest = [
-    "PUT",
+    params.method,
     canonicalUri,
     canonicalQuery,
     `host:${host}`,
@@ -34234,7 +34262,8 @@ async function resolveUploadHost() {
         const ext = extensionFor(opts);
         const prefix = safePrefix(settings.s3.prefix);
         const key = `${prefix}/${Date.now()}-${randomUUID()}.${ext}`;
-        const presignedUrl = presignS3PutUrl({
+        const presignedUrl = presignS3Url({
+          method: "PUT",
           accessKeyId,
           secretAccessKey,
           sessionToken,
@@ -34253,10 +34282,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, publicBaseUrl: settings.s3.publicBaseUrl })
+          };
+        }
+        const ttlSeconds = clamp(settings.ttlSeconds, 1, S3_MAX_PRESIGN_SECONDS);
         return {
           provider: "s3",
-          url: publicS3Url({ region, bucket, key, publicBaseUrl: settings.s3.publicBaseUrl }),
-          expiresAt: new Date(Date.now() + settings.ttlSeconds * 1e3).toISOString()
+          url: presignS3Url({
+            method: "GET",
+            accessKeyId,
+            secretAccessKey,
+            sessionToken,
+            region,
+            bucket,
+            key,
+            ttlSeconds
+          }),
+          expiresAt: new Date(Date.now() + ttlSeconds * 1e3).toISOString()
         };
       }
     };
@@ -34268,19 +34313,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({
   "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;
   }
 });
 
@@ -34315,6 +34369,7 @@ async function executeVideoGenerate(options) {
     negative,
     resolution,
     veoModel = "3.1-fast",
+    runwayModel,
     seedanceModel = "quality",
     grokModel,
     klingModel,
@@ -34404,6 +34459,7 @@ async function executeVideoGenerate(options) {
       await runway.initialize({ apiKey: key });
       const result = await runway.generateVideo(prompt3, {
         prompt: prompt3,
+        model: runwayModel,
         referenceImage,
         duration,
         aspectRatio: ratio,
@@ -36829,16 +36885,8 @@ var init_provider_resolver = __esm({
 
 // 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();
@@ -36853,18 +36901,45 @@ async function executeOpenAIImageGenerate(prompt3, options, ctx) {
   });
   return { result, openaiModel, modelLabel };
 }
-var OPENAI_IMAGE_MODELS;
 var init_openai_image2 = __esm({
   "src/commands/_shared/openai-image.ts"() {
     "use strict";
     init_dist2();
-    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"] }
+  }
+});
+
+// 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({
+  "src/commands/_shared/image-cost.ts"() {
+    "use strict";
+    init_dist2();
+    init_output();
+    init_openai_image2();
+  }
 });
 
 // src/commands/generate/image.ts
@@ -36964,6 +37039,7 @@ Examples:
           command: "generate image",
           startedAt,
           dryRun: true,
+          ...estimateImageCostUsd(provider, options.model, parseInt(options.count) || 1),
           data: {
             params: {
               prompt: prompt3,
@@ -37013,6 +37089,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
+            ...estimateImageCostUsd("openai", options.model, result.images.length),
             data: {
               provider: "openai",
               model: modelLabel,
@@ -37128,7 +37205,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
-            warnings: [],
+            ...estimateImageCostUsd("gemini", options.model, result.images.length),
             data: {
               provider: "gemini",
               model: usedLabel,
@@ -37223,6 +37300,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
+            ...estimateImageCostUsd("grok", options.model, result.images.length),
             data: {
               provider: "grok",
               modelId: resolveGrokImageModel(options.model).model,
@@ -37342,6 +37420,7 @@ var init_image = __esm({
     init_validate();
     init_provider_resolver();
     init_openai_image2();
+    init_image_cost();
     init_image_file();
   }
 });
@@ -38441,6 +38520,14 @@ 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)));
+      }
       if (options.dryRun) {
         const costUsd = provider === "seedance" || provider === "fal" ? realRunCost(provider, options).costUsd : void 0;
         outputSuccess({
@@ -40127,7 +40214,7 @@ ${textsToTranslate}`;
             Authorization: `Bearer ${openaiKey}`
           },
           body: JSON.stringify({
-            model: "gpt-5.4-mini",
+            model: defaultModel("openai", "llm").id,
             messages: [{ role: "user", content: translatePrompt }]
           })
         });
@@ -40155,7 +40242,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 }]
           })
@@ -40206,6 +40293,7 @@ var init_translate_srt = __esm({
   "src/commands/_shared/edit/translate-srt.ts"() {
     "use strict";
     init_subtitle();
+    init_dist2();
   }
 });
 
@@ -41019,22 +41107,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 readFile23(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 readFile23(framePath), {
+      filename: framePath,
+      mimeType: "image/png"
     });
-    const data = await response.json();
-    if (!data.success || !data.data?.url) {
-      return { error: data.error?.message || "Upload failed" };
-    }
-    return { url: data.data.url };
+    return { url: upload.url };
   } catch (err) {
     return { error: err instanceof Error ? err.message : String(err) };
   }
@@ -41185,11 +41264,13 @@ async function executeFillGaps(options) {
       await mkdir16(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
       };
     }
@@ -41233,12 +41314,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
         };
       }
@@ -41313,7 +41394,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;
@@ -41436,6 +41517,7 @@ var init_execute_fill_gaps = __esm({
     init_dist2();
     init_engine();
     init_api_key();
+    init_upload_host();
     init_exec_safe();
     init_project_resolver();
     init_ai_helpers();
@@ -46474,8 +46556,9 @@ var init_product_surface = __esm({
       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" },
@@ -56709,8 +56792,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
 
@@ -56721,12 +56805,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\`
 
@@ -56752,9 +56836,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.
 `;
@@ -56861,17 +56942,17 @@ vibe generate motion "animated product logo reveal" --render -o logo-reveal.mp4
       },
       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",
@@ -57046,10 +57127,11 @@ var OpenAIAdapter;
 var init_openai2 = __esm({
   "src/agent/adapters/openai.ts"() {
     "use strict";
+    init_dist2();
     OpenAIAdapter = class {
       provider = "openai";
       client = null;
-      model = "gpt-5.4-mini";
+      model = defaultModel("openai", "llm").id;
       async initialize(apiKey) {
         this.client = new OpenAI({ apiKey });
       }
@@ -57142,10 +57224,11 @@ var ClaudeAdapter;
 var init_claude2 = __esm({
   "src/agent/adapters/claude.ts"() {
     "use strict";
+    init_dist2();
     ClaudeAdapter = class {
       provider = "claude";
       client = null;
-      model = "claude-sonnet-5-5";
+      model = defaultModel("claude", "llm").id;
       async initialize(apiKey) {
         this.client = new Anthropic({ apiKey });
       }
@@ -57626,10 +57709,11 @@ var XAIAdapter;
 var init_xai = __esm({
   "src/agent/adapters/xai.ts"() {
     "use strict";
+    init_dist2();
     XAIAdapter = class {
       provider = "xai";
       client = null;
-      model = "grok-4.3";
+      model = defaultModel("grok", "llm").id;
       async initialize(apiKey) {
         this.client = new OpenAI2({
           apiKey,
@@ -73588,7 +73672,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.115.3",
+  version: "0.115.4",
   description: "Frontier AI video generation for coding agents - Seedance, Runway, Veo, and Kling on your own keys, behind a hard cost cap",
   private: false,
   license: "MIT",
@@ -73660,6 +73744,7 @@ var package_default = {
     start: "tsx src/index.ts",
     lint: "eslint --ext .ts,.tsx src/",
     test: "vitest run",
+    "test:integration": "VIBE_TEST_INTEGRATION=1 vitest run",
     "test:watch": "vitest",
     pretest: "pnpm --dir ../core build && pnpm --dir ../ai-providers build && node build.js",
     prepublishOnly: "node build.js"
@@ -81537,7 +81622,7 @@ async function collectKeys(config2, keys) {
 }
 async function runCustomSetup(config2, scope = "user", opts = {}) {
   console.log(
-    source_default.bold("1. LLM Provider") + source_default.dim(" (optional built-in vibe agent / fallback)")
+    source_default.bold("1. LLM Provider") + source_default.dim(" (only for the deprecated vibe agent)")
   );
   console.log(
     source_default.dim(
@@ -86857,7 +86942,9 @@ async function promptConfirm2(toolName, args, cost) {
   const defaultYes = cost !== "very-high";
   return promptConfirm("", defaultYes);
 }
+var AGENT_DEPRECATION_NOTICE = "`vibe agent` is deprecated and will be removed before 1.0. Drive vibe from Claude Code, Codex, or Cursor, or connect the MCP server to Claude Desktop or ChatGPT (`vibe host setup`).";
 async function startAgent(options = {}) {
+  console.error(source_default.yellow(`Deprecated: ${AGENT_DEPRECATION_NOTICE}`));
   const isNonInteractive = !!options.input;
   const confirmAlways = options.confirm || false;
   const noConfirm = options.noConfirm || false;
@@ -87068,7 +87155,7 @@ async function startAgent(options = {}) {
     rl.prompt();
   });
 }
-var agentCommand = new Command("agent").description("Optional built-in natural-language agent (fallback when no external coding agent is driving vibe)").option("-p, --provider <provider>", "LLM provider (openai, claude, gemini, ollama, xai, openrouter, evolink)", "openai").option("-m, --model <model>", "Model to use (provider-specific)").option("--project <path>", "Timeline file or directory to load").option("-v, --verbose", "Show verbose output including tool calls").option("--max-turns <n>", "Maximum turns per request", "10").option("-i, --input <query>", "Run a single query and exit (non-interactive)").option("-c, --confirm", "Confirm before every tool - broadens the default cost gate (paid only) to all calls").option("--no-confirm", "Disable all confirm prompts including the high/very-high cost gate (CI / automation)").option("--budget-usd <usd>", "Reject tool calls past this cumulative USD ceiling using conservative tier estimates", parseFloat).action(async (options) => {
+var agentCommand = new Command("agent").description("[Deprecated, removed before 1.0] Built-in natural-language agent. Use a host agent or the MCP server instead").option("-p, --provider <provider>", "LLM provider (openai, claude, gemini, ollama, xai, openrouter, evolink)", "openai").option("-m, --model <model>", "Model to use (provider-specific)").option("--project <path>", "Timeline file or directory to load").option("-v, --verbose", "Show verbose output including tool calls").option("--max-turns <n>", "Maximum turns per request", "10").option("-i, --input <query>", "Run a single query and exit (non-interactive)").option("-c, --confirm", "Confirm before every tool - broadens the default cost gate (paid only) to all calls").option("--no-confirm", "Disable all confirm prompts including the high/very-high cost gate (CI / automation)").option("--budget-usd <usd>", "Reject tool calls past this cumulative USD ceiling using conservative tier estimates", parseFloat).action(async (options) => {
   await startAgent(options);
 });
 function getEnvVar(provider) {
@@ -87689,7 +87776,7 @@ program2.addCommand(doctorCommand);
 program2.addCommand(hostCommand);
 program2.addCommand(demoCommand, { hidden: true });
 program2.addCommand(runCommand);
-program2.addCommand(agentCommand);
+program2.addCommand(agentCommand, { hidden: true });
 program2.addCommand(projectCommand, { hidden: true });
 program2.addCommand(sceneCommand, { hidden: true });
 program2.addCommand(timelineCommand, { hidden: true });