@vibeframe/mcp-server 0.115.3 → 0.115.4

package/README.md

@@ -18,7 +18,7 @@ results, dry-run/cost gates, `build-report.json`, `review-report.json`,
 | ------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------- |
 | MCP host (Claude Desktop / Cursor / OpenCode / Claude Code)         | `@vibeframe/mcp-server` _(this)_ | host calls tool by name, for example `mcp__vibeframe__build({...})`                     |
 | Shell / scripts (any agent host: Codex / Aider / Gemini CLI / etc.) | `@vibeframe/cli`                 | `vibe init my-video && vibe build my-video && vibe render my-video`                     |
-| Optional standalone agent REPL                                      | `@vibeframe/cli` (`vibe agent`)  | natural language -> CLI calls when you do not already use Claude Code/Codex/Cursor/etc. |
+| Standalone agent REPL (deprecated, removed before 1.0)              | `@vibeframe/cli` (`vibe agent`)  | use an MCP host or a coding agent instead                                               |
 
 Outer-loop stop rules should be explicit: final MP4 path exists, duration and
 aspect ratio match the brief, render inspection has no errors, any AI review score

package/dist/index.js

@@ -439,6 +439,82 @@ 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 modelAliases(provider, kind3) {
+  return listModels({ provider, kind: kind3 }).flatMap((m2) => m2.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);
@@ -457,19 +533,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 +870,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.",
@@ -1010,7 +1065,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";
@@ -1018,23 +1073,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";
@@ -1293,9 +1333,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 +1926,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 +2067,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 +2087,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 +2132,7 @@ var init_openai_storyboard = __esm({
   "../ai-providers/dist/openai/openai-storyboard.js"() {
     "use strict";
     init_storyboard_prompt();
+    init_catalog();
   }
 });
 
@@ -2094,6 +2142,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 +2152,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 +2458,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 +3859,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 +3869,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 +4171,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 +4511,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 +4545,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 +5209,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 +5534,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 +5588,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 +5695,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 +5707,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 +5721,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 +5838,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 +5853,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 +6293,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 +10750,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 +10881,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 +11726,7 @@ __export(dist_exports, {
   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,
@@ -11718,11 +11739,13 @@ __export(dist_exports, {
   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,
@@ -11739,8 +11762,10 @@ __export(dist_exports, {
   klingDuration: () => klingDuration,
   klingProvider: () => klingProvider,
   kokoroProvider: () => kokoroProvider,
+  listModels: () => listModels,
   loadBundledKokoroRuntime: () => loadBundledKokoroRuntime,
   loadKokoroFromWorkspace: () => loadKokoroFromWorkspace,
+  modelAliases: () => modelAliases,
   ollamaProvider: () => ollamaProvider,
   omniProvider: () => omniProvider,
   openaiImageProvider: () => openaiImageProvider,
@@ -11767,6 +11792,7 @@ var init_dist = __esm({
     init_define_provider();
     init_whisper();
     init_gemini();
+    init_catalog2();
     init_openai();
     init_claude();
     init_ollama();
@@ -20009,12 +20035,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 +20106,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 +20120,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 +20128,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 +20187,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 +20207,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 +20238,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 +20900,7 @@ async function executeVideoGenerate(options) {
     negative,
     resolution,
     veoModel = "3.1-fast",
+    runwayModel,
     seedanceModel = "quality",
     grokModel,
     klingModel,
@@ -20931,6 +20990,7 @@ async function executeVideoGenerate(options) {
       await runway.initialize({ apiKey: key2 });
       const result = await runway.generateVideo(prompt3, {
         prompt: prompt3,
+        model: runwayModel,
         referenceImage,
         duration,
         aspectRatio: ratio,
@@ -275942,16 +276002,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 +277132,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 +277160,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 +277211,7 @@ var init_translate_srt = __esm({
   "../cli/src/commands/_shared/edit/translate-srt.ts"() {
     "use strict";
     init_subtitle();
+    init_dist();
   }
 });
 
@@ -278353,22 +278412,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 +278569,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 +278619,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 +278699,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 +278822,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 +278890,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 +278911,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 +279290,6 @@ function registerMotionCommand(aiCommand) {
     }
   });
 }
-var MODEL_MAP2;
 var init_ai_motion = __esm({
   "../cli/src/commands/ai-motion.ts"() {
     "use strict";
@@ -279241,14 +279300,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" }
-    };
   }
 });
 
@@ -282362,16 +282413,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 +282429,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 +282567,7 @@ Examples:
           command: "generate image",
           startedAt,
           dryRun: true,
+          ...estimateImageCostUsd(provider, options.model, parseInt(options.count) || 1),
           data: {
             params: {
               prompt: prompt3,
@@ -282546,6 +282617,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
+            ...estimateImageCostUsd("openai", options.model, result.images.length),
             data: {
               provider: "openai",
               model: modelLabel,
@@ -282661,7 +282733,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
-            warnings: [],
+            ...estimateImageCostUsd("gemini", options.model, result.images.length),
             data: {
               provider: "gemini",
               model: usedLabel,
@@ -282756,6 +282828,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
+            ...estimateImageCostUsd("grok", options.model, result.images.length),
             data: {
               provider: "grok",
               modelId: resolveGrokImageModel(options.model).model,
@@ -282875,6 +282948,7 @@ var init_image2 = __esm({
     init_validate();
     init_provider_resolver();
     init_openai_image2();
+    init_image_cost();
     init_image_file();
   }
 });
@@ -283974,6 +284048,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({
@@ -298375,10 +298457,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 +302007,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 +303447,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,
@@ -304157,8 +304242,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" },
@@ -314191,8 +314277,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 +314290,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 +314321,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 +314427,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 +315433,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.4")) {
   process.exit(0);
 }
 console.log = (...args) => console.error(...args);
@@ -315362,7 +315446,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.4"
   },
   {
     capabilities: {

package/package.json

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