@vibeframe/cli 0.115.3 → 0.115.5

package/dist/index.js

@@ -6629,8 +6629,43 @@ function outputSuccess(opts) {
     const data = opts.data;
     const primary = data.outputPath ?? data.output ?? data.path ?? data.url ?? data.id;
     if (primary !== void 0) console.log(String(primary));
+    return;
+  }
+  if (opts.dryRun && !opts.humanRendered) {
+    printDryRunSummary(opts.command, costUsd, opts.data, opts.warnings ?? []);
+  }
+}
+function printWarnings(warnings) {
+  if (isJsonMode()) return;
+  for (const warning of warnings) {
+    process.stderr.write(`${source_default.yellow(`Warning: ${warning}`)}
+`);
   }
 }
+function formatDryRunValue(value) {
+  const text = Array.isArray(value) ? value.map((v) => formatDryRunValue(v)).join(", ") : typeof value === "object" ? JSON.stringify(value) : String(value);
+  return text.length > 80 ? `${text.slice(0, 77)}...` : text;
+}
+function printDryRunSummary(command, costUsd, data, warnings) {
+  const params = data.params && typeof data.params === "object" ? data.params : data;
+  const rows = [
+    ["cost", costUsd > 0 ? `up to $${costUsd.toFixed(2)} (estimate)` : "free"]
+  ];
+  for (const [key, value] of Object.entries(params)) {
+    if (value === void 0 || value === null || value === "") continue;
+    if (Array.isArray(value) && value.length === 0) continue;
+    rows.push([key, formatDryRunValue(value)]);
+  }
+  const width = Math.max(...rows.map(([key]) => key.length));
+  console.log();
+  console.log(`${source_default.bold.cyan(`Dry run: vibe ${command}`)} ${source_default.dim("(nothing was sent)")}`);
+  for (const [key, value] of rows) {
+    console.log(`  ${source_default.dim(key.padEnd(width))}  ${value}`);
+  }
+  printWarnings(warnings);
+  console.log(source_default.dim("  Run again without --dry-run to execute."));
+  console.log();
+}
 function log(...args) {
   if (!isJsonMode() && !isQuietMode()) {
     console.log(...args);
@@ -6984,8 +7019,8 @@ var init_api_keys = __esm({
       envVar: "GOOGLE_API_KEY",
       label: "Google",
       showInSetup: true,
-      setupDescription: "Gemini \u2014 image gen (free tier), video analysis ($), Veo ($$)",
-      envExampleComment: "Google API Key (Gemini auto-edit suggestions, image gen, Veo video)",
+      setupDescription: "Gemini \u2014 image gen (free tier), video analysis ($), Omni video ($$)",
+      envExampleComment: "Google API Key (Gemini auto-edit suggestions, image gen, Omni video)",
       envExampleUrl: "https://aistudio.google.com/apikey",
       keyFormat: { prefix: /^AIza/, example: "AIza..." }
     });
@@ -7222,6 +7257,114 @@ 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 modelLifecycle(spec, now = /* @__PURE__ */ new Date()) {
+  if (!spec.shutdown)
+    return { state: "served" };
+  const remainingMs = Date.parse(`${spec.shutdown}T00:00:00Z`) - now.getTime();
+  const instead = spec.replacement ? ` Use ${spec.replacement} instead.` : "";
+  if (remainingMs <= 0) {
+    return {
+      state: "retired",
+      shutdown: spec.shutdown,
+      message: `${spec.label} (${spec.id}) was shut down by the provider on ${spec.shutdown}.${instead}`
+    };
+  }
+  const daysLeft = Math.ceil(remainingMs / 864e5);
+  return {
+    state: "retiring",
+    shutdown: spec.shutdown,
+    daysLeft,
+    message: `${spec.label} (${spec.id}) shuts down on ${spec.shutdown} (${daysLeft} day${daysLeft === 1 ? "" : "s"} left).${instead}`
+  };
+}
+function assertModelServed(spec, now = /* @__PURE__ */ new Date()) {
+  const lifecycle = modelLifecycle(spec, now);
+  if (lifecycle.state === "retired")
+    throw new ModelRetiredError(lifecycle.message, spec);
+}
+function modelAliases(provider, kind) {
+  return listModels({ provider, kind }).flatMap((m) => m.aliases ?? []);
+}
+var MODEL_CATALOG, ModelRetiredError;
+var init_catalog = __esm({
+  "../ai-providers/dist/catalog/catalog.js"() {
+    "use strict";
+    MODEL_CATALOG = [
+      // ── LLMs ──────────────────────────────────────────────────────────────
+      { id: "claude-sonnet-5-5", provider: "claude", kind: "llm", label: "Claude Sonnet 5.5", aliases: ["sonnet"], default: true, status: "ga", price: { usd: 2, per: "1M input tokens" }, note: "Agent, storyboard, translate-srt, motion default" },
+      { id: "claude-opus-5-5", provider: "claude", kind: "llm", label: "Claude Opus 5.5", aliases: ["opus"], status: "ga", price: { usd: 4, per: "1M input tokens" } },
+      { id: "claude-opus-4-6", provider: "claude", kind: "llm", label: "Claude Opus 4.6", aliases: ["opus-4-6"], status: "legacy", price: { usd: 5, per: "1M input tokens" } },
+      { id: "gpt-5.4-mini", provider: "openai", kind: "llm", label: "GPT-5.4 mini", default: true, status: "ga", price: { usd: 0.75, per: "1M input tokens" }, note: "Agent and storyboard default (tools on Chat Completions)" },
+      { id: "gemini-3.8-flash", provider: "gemini", kind: "llm", label: "Gemini 3.8 Flash", aliases: ["flash", "latest", "flash-3.8", "gemini"], default: true, status: "ga", price: { usd: 0.75, per: "1M input tokens", basis: "until 2026-12-31, then $1.50" } },
+      { id: "gemini-3.5-flash", provider: "gemini", kind: "llm", label: "Gemini 3.5 Flash", aliases: ["flash-3.5"], status: "ga" },
+      { id: "gemini-3-flash-preview", provider: "gemini", kind: "llm", label: "Gemini 3 Flash (preview)", aliases: ["flash-3"], status: "preview" },
+      { id: "gemini-3.1-pro-preview", provider: "gemini", kind: "llm", label: "Gemini 3.1 Pro (preview)", aliases: ["pro", "pro-3.1", "3.1-pro", "gemini-3.1-pro"], status: "preview" },
+      { id: "gemini-2.5-flash", provider: "gemini", kind: "llm", label: "Gemini 2.5 Flash", aliases: ["flash-2.5"], status: "legacy", note: "New projects cannot use 2.5 models since 2026-09-18" },
+      { id: "gemini-2.5-pro", provider: "gemini", kind: "llm", label: "Gemini 2.5 Pro", aliases: ["pro-2.5", "2.5-pro"], status: "legacy" },
+      { id: "grok-4.3", provider: "grok", kind: "llm", label: "Grok 4.3", default: true, status: "ga", price: { usd: 1.25, per: "1M input tokens" } },
+      { id: "grok-4.7", provider: "grok", kind: "llm", label: "Grok 4.7", status: "ga", price: { usd: 2, per: "1M input tokens" } },
+      // ── Images ────────────────────────────────────────────────────────────
+      { id: "gpt-image-2.5-sunburst", provider: "openai", kind: "image", label: "GPT Image 2.5 Sunburst", aliases: ["2.5", "sunburst"], default: true, status: "ga", price: { usd: 0.211, per: "image", basis: "high, 1024x1024" } },
+      { id: "gpt-image-2.5-flare", provider: "openai", kind: "image", label: "GPT Image 2.5 Flare", aliases: ["flare", "2.5-flare"], status: "ga", price: { usd: 0.211, per: "image", basis: "high, 1024x1024" } },
+      { id: "gpt-image-2", provider: "openai", kind: "image", label: "GPT Image 2", aliases: ["2"], status: "ga", price: { usd: 0.211, per: "image", basis: "high, 1024x1024" } },
+      { id: "gpt-image-1.5", provider: "openai", kind: "image", label: "GPT Image 1.5", aliases: ["1.5"], status: "deprecated", shutdown: "2026-12-01", price: { usd: 0.133, per: "image", basis: "high, 1024x1024" } },
+      { id: "gemini-3.1-flash-image", provider: "gemini", kind: "image", label: "Nano Banana 2", aliases: ["flash", "3.1-flash", "latest"], default: true, status: "ga", price: { usd: 0.067, per: "image", basis: "1K" } },
+      { id: "gemini-3.1-flash-lite-image", provider: "gemini", kind: "image", label: "Nano Banana 2 Lite", aliases: ["lite"], status: "ga", price: { usd: 0.034, per: "image", basis: "1K" } },
+      { id: "gemini-3-pro-image", provider: "gemini", kind: "image", label: "Nano Banana Pro", aliases: ["pro"], status: "ga", price: { usd: 0.134, per: "image", basis: "1K-2K" } },
+      { id: "gemini-2.5-flash-image", provider: "gemini", kind: "image", label: "Nano Banana (2.5 Flash Image)", status: "deprecated", shutdown: "2026-10-02" },
+      { id: "gemini-3.1-flash-image-preview", provider: "gemini", kind: "image", label: "Nano Banana 2 (preview)", status: "deprecated", shutdown: "2026-06-25" },
+      { id: "gemini-3-pro-image-preview", provider: "gemini", kind: "image", label: "Nano Banana Pro (preview)", status: "deprecated", shutdown: "2026-06-25" },
+      { id: "grok-imagine-image", provider: "grok", kind: "image", label: "Grok Imagine Image", default: true, status: "ga", price: { usd: 0.02, per: "image" } },
+      { id: "grok-imagine-image-2.0", provider: "grok", kind: "image", label: "Grok Imagine Image 2.0", aliases: ["pro", "2.0", "quality"], status: "ga", price: { usd: 0.08, per: "image", basis: "medium, 2K" } },
+      // ── Video ─────────────────────────────────────────────────────────────
+      { id: "seedance-2.0", provider: "seedance", kind: "video", label: "Seedance 2.0", aliases: ["quality", "2.0"], default: true, status: "ga", price: { usd: 0.3024, per: "second", basis: "720p 16:9" }, note: "4-15 s, native audio" },
+      { id: "seedance-2.0-fast", provider: "seedance", kind: "video", label: "Seedance 2.0 Fast", aliases: ["fast"], status: "ga", price: { usd: 0.2419, per: "second", basis: "720p 16:9" }, note: "4-15 s, up to 720p, native audio" },
+      { id: "seedance-2.5", provider: "seedance", kind: "video", label: "Seedance 2.5", aliases: ["2.5"], status: "ga", price: { usd: 0.473, per: "second", basis: "720p 16:9" }, note: "Opt-in; 4-30 s, native audio" },
+      { id: "gemini-omni-1.1-flash", provider: "omni", kind: "video", label: "Gemini Omni 1.1 Flash", default: true, status: "ga", price: { usd: 0.1, per: "second", basis: "720p" }, note: "Google video default; the model picks 3-10 s; native audio" },
+      { id: "veo-3.1-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1", aliases: ["3.1"], status: "deprecated", shutdown: "2026-10-22", replacement: "`-p omni` (Gemini Omni 1.1 Flash)", price: { usd: 0.4, per: "second", basis: "720p/1080p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
+      { id: "veo-3.1-fast-generate-preview", provider: "veo", kind: "video", label: "Veo 3.1 Fast", aliases: ["3.1-fast"], default: true, status: "deprecated", shutdown: "2026-10-22", replacement: "`-p omni` (Gemini Omni 1.1 Flash)", price: { usd: 0.1, per: "second", basis: "720p" }, note: "4-8 s, native audio; explicit `-p veo` only" },
+      { id: "grok-imagine-video-1.5", provider: "grok", kind: "video", label: "Grok Imagine Video 1.5", aliases: ["1.5"], default: true, status: "ga", price: { usd: 0.14, per: "second", basis: "720p" }, note: "1-15 s, native audio; 720p unless `--resolution` says otherwise" },
+      { id: "grok-imagine-video-1.5-lite", provider: "grok", kind: "video", label: "Grok Imagine Video 1.5 Lite", aliases: ["lite", "1.5-lite"], status: "ga", price: { usd: 0.03, per: "second", basis: "720p" }, note: "1-15 s, native audio" },
+      { id: "grok-imagine-video", provider: "grok", kind: "video", label: "Grok Imagine Video", aliases: ["classic"], status: "legacy", price: { usd: 0.05, per: "second", basis: "480p" }, note: "Previous generation" },
+      { id: "kling-v3", provider: "kling", kind: "video", label: "Kling v3", aliases: ["v3"], default: true, status: "ga", price: { usd: 0.084, per: "second", basis: "std, silent" }, note: "3-15 s, multi-shot; `std` 720p, `pro` 1080p" },
+      { id: "kling-v2-6", provider: "kling", kind: "video", label: "Kling v2.6", aliases: ["v2.6"], status: "ga", price: { usd: 0.042, per: "second", basis: "std 720p" }, note: "5 or 10 s" },
+      { id: "kling-v2-5-turbo", provider: "kling", kind: "video", label: "Kling v2.5 Turbo", aliases: ["v2.5-turbo", "v2.5"], status: "ga", price: { usd: 0.042, per: "second", basis: "std" }, note: "5 or 10 s, no audio" },
+      { id: "gen4.5", provider: "runway", kind: "video", label: "Runway Gen-4.5", default: true, status: "ga", price: { usd: 0.12, per: "second" }, note: "2-10 s, no audio" },
+      { id: "gen4_turbo", provider: "runway", kind: "video", label: "Runway Gen-4 Turbo", status: "ga", price: { usd: 0.05, per: "second" }, note: "Image-to-video only, no audio" },
+      // ── Audio ─────────────────────────────────────────────────────────────
+      { id: "eleven_v3", provider: "elevenlabs", kind: "speech", label: "ElevenLabs v3", default: true, status: "ga", price: { usd: 0.08, per: "1K characters" } },
+      { id: "gpt-4o-mini-tts", provider: "openai", kind: "speech", label: "GPT-4o mini TTS", default: true, status: "deprecated", shutdown: "2027-01-06" },
+      { id: "music_v2_5", provider: "elevenlabs", kind: "music", label: "ElevenLabs Music v2.5", default: true, status: "ga", price: { usd: 0.15, per: "minute" } },
+      { id: "eleven_text_to_sound_v2", provider: "elevenlabs", kind: "sound-effect", label: "ElevenLabs Sound Effects v2", default: true, status: "ga", price: { usd: 0.12, per: "minute" }, note: "0.5-30 s" },
+      { id: "whisper-1", provider: "openai", kind: "transcription", label: "Whisper", default: true, status: "deprecated", shutdown: "2027-02-26", note: "Only OpenAI model with word timestamps" }
+    ];
+    ModelRetiredError = class extends Error {
+      constructor(message, model) {
+        super(message);
+        this.model = model;
+        this.name = "ModelRetiredError";
+      }
+    };
+  }
+});
+
 // ../ai-providers/dist/gemini/gemini-models.js
 function isGeminiTextModelAlias(model) {
   return Object.prototype.hasOwnProperty.call(GEMINI_TEXT_MODEL_ALIASES, model);
@@ -7240,19 +7383,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 +7720,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.",
@@ -7787,13 +7909,19 @@ var init_http = __esm({
 // ../ai-providers/dist/gemini/GeminiProvider.js
 function resolveVeoModel(alias) {
   if (Object.hasOwn(VEO_MODEL_ALIASES, alias)) {
-    return VEO_MODEL_ALIASES[alias];
+    return servedVeoModel(VEO_MODEL_ALIASES[alias]);
   }
   const valid = Object.keys(VEO_MODEL_ALIASES).join(", ");
   const hint = alias === "3.0" ? " Veo 3.0 was shut down by Google on 2025-11-12." : "";
   throw new Error(`Unknown Veo model "${alias}". Valid: ${valid}.${hint}`);
 }
-var VEO_MODEL_ALIASES, MODEL_MAP, GeminiProvider, geminiProvider;
+function servedVeoModel(id) {
+  const spec = id ? findModel("veo", "video", id) : defaultModel("veo", "video");
+  if (spec)
+    assertModelServed(spec);
+  return spec?.id ?? id;
+}
+var VEO_MODEL_ALIASES, GeminiProvider, geminiProvider;
 var init_GeminiProvider = __esm({
   "../ai-providers/dist/gemini/GeminiProvider.js"() {
     "use strict";
@@ -7801,23 +7929,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";
@@ -7851,7 +7964,7 @@ var init_GeminiProvider = __esm({
         }
         try {
           const veoOpts = options ?? {};
-          const model = veoOpts.model || "veo-3.1-fast-generate-preview";
+          const model = servedVeoModel(veoOpts.model);
           const aspectRatioMap = {
             "16:9": "16:9",
             "9:16": "9:16",
@@ -8028,7 +8141,7 @@ var init_GeminiProvider = __esm({
           };
         }
         try {
-          const model = options?.model || "veo-3.1-generate-preview";
+          const model = servedVeoModel(options?.model ?? findModel("veo", "video", "3.1")?.id);
           const instance = {
             video: { previousOperationName }
           };
@@ -8076,9 +8189,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 +8782,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 +8923,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 +8943,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 +8988,7 @@ var init_openai_storyboard = __esm({
   "../ai-providers/dist/openai/openai-storyboard.js"() {
     "use strict";
     init_storyboard_prompt();
+    init_catalog();
   }
 });
 
@@ -8877,6 +8998,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 +9008,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 +9314,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 +10715,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 +10725,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 +11027,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 +11367,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 +11401,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 +12065,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 +12390,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 +12444,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 +12551,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 +12563,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 +12577,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 +12694,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 +12709,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 +13149,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 +17606,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 +17737,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 +18582,8 @@ __export(dist_exports2, {
   KOKORO_MODEL_ID: () => KOKORO_MODEL_ID,
   KlingProvider: () => KlingProvider,
   KokoroProvider: () => KokoroProvider,
+  MODEL_CATALOG: () => MODEL_CATALOG,
+  ModelRetiredError: () => ModelRetiredError,
   OPENAI_IMAGE_DEFAULT_MODEL: () => OPENAI_IMAGE_DEFAULT_MODEL,
   OPENAI_TTS_VOICES: () => OPENAI_TTS_VOICES,
   OllamaProvider: () => OllamaProvider,
@@ -18500,12 +18595,15 @@ __export(dist_exports2, {
   RunwayProvider: () => RunwayProvider,
   VEO_MODEL_ALIASES: () => VEO_MODEL_ALIASES,
   WhisperProvider: () => WhisperProvider,
+  assertModelServed: () => assertModelServed,
   claudeProvider: () => claudeProvider,
+  defaultModel: () => defaultModel,
   defineApiKey: () => defineApiKey,
   defineProvider: () => defineProvider,
   elevenLabsProvider: () => elevenLabsProvider,
   estimateSeedanceVideoCostUsd: () => estimateSeedanceVideoCostUsd,
   falProvider: () => falProvider,
+  findModel: () => findModel,
   geminiProvider: () => geminiProvider,
   getAllApiKeys: () => getAllApiKeys,
   getAllProviders: () => getAllProviders,
@@ -18522,8 +18620,11 @@ __export(dist_exports2, {
   klingDuration: () => klingDuration,
   klingProvider: () => klingProvider,
   kokoroProvider: () => kokoroProvider,
+  listModels: () => listModels,
   loadBundledKokoroRuntime: () => loadBundledKokoroRuntime,
   loadKokoroFromWorkspace: () => loadKokoroFromWorkspace,
+  modelAliases: () => modelAliases,
+  modelLifecycle: () => modelLifecycle,
   ollamaProvider: () => ollamaProvider,
   omniProvider: () => omniProvider,
   openaiImageProvider: () => openaiImageProvider,
@@ -18550,6 +18651,7 @@ var init_dist2 = __esm({
     init_define_provider();
     init_whisper();
     init_gemini();
+    init_catalog2();
     init_openai();
     init_claude();
     init_ollama();
@@ -32160,16 +32262,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 +33011,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 +33032,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 +33411,6 @@ function registerMotionCommand(aiCommand) {
     }
   });
 }
-var MODEL_MAP2;
 var init_ai_motion = __esm({
   "src/commands/ai-motion.ts"() {
     "use strict";
@@ -33315,14 +33421,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 +34186,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 +34257,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 +34271,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 +34279,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 +34338,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 +34358,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 +34389,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 +34445,7 @@ async function executeVideoGenerate(options) {
     negative,
     resolution,
     veoModel = "3.1-fast",
+    runwayModel,
     seedanceModel = "quality",
     grokModel,
     klingModel,
@@ -34404,6 +34535,7 @@ async function executeVideoGenerate(options) {
       await runway.initialize({ apiKey: key });
       const result = await runway.generateVideo(prompt3, {
         prompt: prompt3,
+        model: runwayModel,
         referenceImage,
         duration,
         aspectRatio: ratio,
@@ -36546,6 +36678,34 @@ var init_thumbnail = __esm({
   }
 });
 
+// src/utils/model-lifecycle.ts
+function videoModelSpec(provider, flags) {
+  const catalogProvider = provider === "fal" ? "seedance" : provider;
+  const flag = VIDEO_MODEL_FLAG[catalogProvider];
+  return findModel(catalogProvider, "video", flag ? flags[flag] : void 0);
+}
+function checkModelLifecycle(spec, now = /* @__PURE__ */ new Date()) {
+  if (!spec) return [];
+  const lifecycle = modelLifecycle(spec, now);
+  if (lifecycle.state === "retired") exitWithError(usageError(lifecycle.message));
+  return lifecycle.state === "retiring" ? [lifecycle.message] : [];
+}
+var VIDEO_MODEL_FLAG;
+var init_model_lifecycle = __esm({
+  "src/utils/model-lifecycle.ts"() {
+    "use strict";
+    init_dist2();
+    init_output();
+    VIDEO_MODEL_FLAG = {
+      seedance: "seedanceModel",
+      grok: "grokModel",
+      kling: "klingModel",
+      veo: "veoModel",
+      runway: "runwayModel"
+    };
+  }
+});
+
 // src/commands/generate/video-extend.ts
 import { resolve as resolve26 } from "node:path";
 import { writeFile as writeFile23 } from "node:fs/promises";
@@ -36557,11 +36717,22 @@ function registerVideoExtendCommand(parent) {
       if (options.output) {
         validateOutputPath(options.output);
       }
+      let lifecycleWarnings = [];
+      if (provider === "veo") {
+        try {
+          resolveVeoModel(options.veoModel);
+        } catch (err) {
+          exitWithError(usageError(err instanceof Error ? err.message : String(err)));
+        }
+        lifecycleWarnings = checkModelLifecycle(findModel("veo", "video", options.veoModel));
+        if (!options.dryRun) printWarnings(lifecycleWarnings);
+      }
       if (options.dryRun) {
         outputSuccess({
           command: "generate video-extend",
           startedAt,
           dryRun: true,
+          warnings: lifecycleWarnings,
           data: {
             params: {
               id,
@@ -36714,6 +36885,7 @@ function registerVideoExtendCommand(parent) {
           outputSuccess({
             command: "generate video-extend",
             startedAt,
+            warnings: lifecycleWarnings,
             data: {
               provider: "veo",
               taskId: result.id,
@@ -36762,6 +36934,7 @@ var init_video_extend = __esm({
     init_ora();
     init_dist2();
     init_api_key();
+    init_model_lifecycle();
     init_output();
     init_validate();
     init_ai_helpers();
@@ -36829,16 +37002,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 +37018,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 +37156,7 @@ Examples:
           command: "generate image",
           startedAt,
           dryRun: true,
+          ...estimateImageCostUsd(provider, options.model, parseInt(options.count) || 1),
           data: {
             params: {
               prompt: prompt3,
@@ -37013,6 +37206,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
+            ...estimateImageCostUsd("openai", options.model, result.images.length),
             data: {
               provider: "openai",
               model: modelLabel,
@@ -37128,7 +37322,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
-            warnings: [],
+            ...estimateImageCostUsd("gemini", options.model, result.images.length),
             data: {
               provider: "gemini",
               model: usedLabel,
@@ -37223,6 +37417,7 @@ Examples:
           outputSuccess({
             command: "generate image",
             startedAt,
+            ...estimateImageCostUsd("grok", options.model, result.images.length),
             data: {
               provider: "grok",
               modelId: resolveGrokImageModel(options.model).model,
@@ -37342,6 +37537,7 @@ var init_image = __esm({
     init_validate();
     init_provider_resolver();
     init_openai_image2();
+    init_image_cost();
     init_image_file();
   }
 });
@@ -38441,6 +38637,16 @@ Examples:
         log(`${provider} does not support 1:1 \u2014 falling back to 16:9`);
         options.ratio = "16:9";
       }
+      try {
+        if (provider === "seedance" || provider === "fal") resolveSeedanceVariant(options.seedanceModel);
+        if (provider === "grok") resolveGrokVideoModel(options.grokModel);
+        if (provider === "kling") resolveKlingModel(options.klingModel);
+        if (provider === "veo") resolveVeoModel(options.veoModel);
+      } catch (err) {
+        exitWithError(usageError(err instanceof Error ? err.message : String(err)));
+      }
+      const lifecycleWarnings = checkModelLifecycle(videoModelSpec(provider, options));
+      if (!options.dryRun) printWarnings(lifecycleWarnings);
       if (options.dryRun) {
         const costUsd = provider === "seedance" || provider === "fal" ? realRunCost(provider, options).costUsd : void 0;
         outputSuccess({
@@ -38448,6 +38654,7 @@ Examples:
           startedAt,
           dryRun: true,
           costUsd,
+          warnings: lifecycleWarnings,
           data: {
             params: {
               prompt: prompt3,
@@ -38455,13 +38662,10 @@ Examples:
               duration: options.duration,
               ratio: options.ratio,
               image: options.image,
-              mode: options.mode,
+              mode: provider === "kling" ? options.mode : void 0,
               negative: options.negative,
               resolution: options.resolution,
-              veoModel: options.veoModel,
-              seedanceModel: options.seedanceModel,
-              grokModel: options.grokModel,
-              klingModel: options.klingModel,
+              model: videoModelSpec(provider, options)?.id,
               refImages: options.refImages,
               refVideos: options.refVideos,
               refAudio: options.refAudio,
@@ -38853,7 +39057,7 @@ Examples:
           command: "generate video",
           startedAt,
           costUsd: cost.costUsd,
-          warnings: provider === "veo" ? [VEO_SHUTDOWN_WARNING, ...cost.warnings] : cost.warnings,
+          warnings: [...lifecycleWarnings, ...cost.warnings],
           data: {
             provider,
             taskId: result?.id,
@@ -38865,9 +39069,6 @@ Examples:
         return;
       }
       console.log();
-      if (provider === "veo") {
-        console.log(source_default.yellow(VEO_SHUTDOWN_WARNING));
-      }
       if (finalResult.videoUrl) {
         console.log(`Video URL: ${finalResult.videoUrl}`);
       }
@@ -38992,7 +39193,6 @@ function printVideoStarted(providerLabel, taskId, taskType) {
   console.log(`Task ID: ${source_default.bold(taskId)}`);
   if (taskType) console.log(`Type: ${taskType}`);
 }
-var VEO_SHUTDOWN_WARNING;
 var init_video = __esm({
   "src/commands/generate/video.ts"() {
     "use strict";
@@ -39001,6 +39201,7 @@ var init_video = __esm({
     init_dist3();
     init_dist2();
     init_api_key();
+    init_model_lifecycle();
     init_tty();
     init_output();
     init_validate();
@@ -39008,7 +39209,6 @@ var init_video = __esm({
     init_upload_host();
     init_ai_helpers();
     init_status_jobs();
-    VEO_SHUTDOWN_WARNING = "Veo 3.1 preview models shut down on 2026-10-22. Use `-p omni` (Gemini Omni 1.1 Flash) instead.";
   }
 });
 
@@ -39118,7 +39318,7 @@ Advanced:
   generate video-cancel Provider lifecycle control; poll with 'vibe status job <job-id> --json'
 
 API Keys (per provider):
-  GOOGLE_API_KEY     Image (default), Veo video
+  GOOGLE_API_KEY     Image (default), Omni video
   OPENAI_API_KEY     Image (-p openai)
   FAL_API_KEY        Seedance video (-p seedance, default video)
   XAI_API_KEY        Grok image/video
@@ -40127,7 +40327,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 +40355,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 +40406,7 @@ var init_translate_srt = __esm({
   "src/commands/_shared/edit/translate-srt.ts"() {
     "use strict";
     init_subtitle();
+    init_dist2();
   }
 });
 
@@ -41019,22 +41220,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 +41377,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 +41427,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 +41507,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 +41630,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 +46669,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" },
@@ -56144,6 +56340,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect scenes",
             startedAt,
@@ -56263,6 +56460,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect silence",
             startedAt,
@@ -56349,6 +56547,7 @@ var init_detect = __esm({
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
+          spinner2.stop();
           outputSuccess({
             command: "detect beats",
             startedAt,
@@ -56709,8 +56908,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 +56921,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 +56952,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 +57058,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 +57243,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 +57340,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 +57825,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,
@@ -70305,7 +70505,7 @@ var init_generate2 = __esm({
       cost: "high",
       title: "Generate Video",
       annotations: { readOnly: false, openWorld: true },
-      description: "Generate video using AI. Supports Seedance 2.0 via fal.ai, Grok, Kling, Runway, and Veo. Requires FAL_API_KEY, XAI_API_KEY, KLING_API_KEY, RUNWAY_API_SECRET, or GOOGLE_API_KEY.",
+      description: "Generate video using AI. Supports Seedance 2.0 via fal.ai, Grok, Kling, Runway, Gemini Omni, and Veo (shuts down 2026-10-22). Requires FAL_API_KEY, XAI_API_KEY, KLING_API_KEY, RUNWAY_API_SECRET, or GOOGLE_API_KEY.",
       schema: external_exports.object({
         prompt: external_exports.string().describe("Text prompt describing the video"),
         provider: external_exports.enum(["seedance", "grok", "kling", "runway", "veo", "omni"]).optional().describe(
@@ -73588,7 +73788,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.115.3",
+  version: "0.115.5",
   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 +73860,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"
@@ -73973,6 +74174,7 @@ timelineCommand.command("add-source").description("Add a media source to the tim
   const spinner2 = ora("Adding source...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline add-source",
         startedAt,
@@ -74037,6 +74239,7 @@ timelineCommand.command("add-clip").description("Add a clip to the timeline").ar
     validateResourceId(sourceId);
     if (options.track) validateResourceId(options.track);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline add-clip",
         startedAt,
@@ -74117,6 +74320,7 @@ timelineCommand.command("add-track").description("Add a new track").argument("<p
   const spinner2 = ora("Adding track...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline add-track",
         startedAt,
@@ -74178,6 +74382,7 @@ timelineCommand.command("add-effect").description("Add an effect to a clip").arg
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline add-effect",
         startedAt,
@@ -74250,6 +74455,7 @@ timelineCommand.command("trim-clip").description("Trim a clip").argument("<proje
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline trim-clip",
         startedAt,
@@ -74417,6 +74623,7 @@ timelineCommand.command("split-clip").description("Split a clip at a specific ti
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline split-clip",
         startedAt,
@@ -74479,6 +74686,7 @@ timelineCommand.command("duplicate-clip").description("Duplicate a clip").argume
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline duplicate-clip",
         startedAt,
@@ -74538,6 +74746,7 @@ timelineCommand.command("delete-clip").description("Delete a clip from the timel
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline delete-clip",
         startedAt,
@@ -74591,6 +74800,7 @@ timelineCommand.command("move-clip").description("Move a clip to a new position"
     validateResourceId(clipId);
     if (options.track) validateResourceId(options.track);
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "timeline move-clip",
         startedAt,
@@ -80086,6 +80296,7 @@ batchCommand.command("import").description("Import multiple media files from a d
   const spinner2 = ora("Scanning directory...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "batch import",
         startedAt,
@@ -80163,6 +80374,7 @@ batchCommand.command("concat").description("Concatenate multiple sources into se
   const spinner2 = ora("Creating clips...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "batch concat",
         startedAt,
@@ -80241,6 +80453,7 @@ batchCommand.command("apply-effect").description("Apply an effect to multiple cl
     const spinner2 = ora("Applying effects...").start();
     try {
       if (options.dryRun) {
+        spinner2.stop();
         outputSuccess({
           command: "batch apply-effect",
           startedAt,
@@ -80312,6 +80525,7 @@ batchCommand.command("remove-clips").description("Remove multiple clips from the
   const spinner2 = ora("Removing clips...").start();
   try {
     if (options.dryRun) {
+      spinner2.stop();
       outputSuccess({
         command: "batch remove-clips",
         startedAt,
@@ -80374,7 +80588,9 @@ batchCommand.command("info").description("Show batch processing statistics").arg
     const tracks = project.getTracks();
     const summary = project.getSummary();
     spinner2.stop();
-    console.log(source_default.bold("\nProject Statistics\n"));
+    console.log(`
+${source_default.bold("Project Statistics")}
+`);
     const videoSources = sources.filter((s) => s.type === "video").length;
     const audioSources = sources.filter((s) => s.type === "audio").length;
     const imageSources = sources.filter((s) => s.type === "image").length;
@@ -80768,7 +80984,7 @@ var AI_FEATURES = [
     label: "Videos",
     desc: "generate + extend",
     defaultProvider: "Seedance 2.0 via fal.ai (Artificial Analysis #2 t2v + i2v, since v0.57)",
-    alsoAvailable: "Grok Imagine, Kling, Runway Gen-4.5, Google Veo",
+    alsoAvailable: "Grok Imagine, Kling, Runway Gen-4.5, Gemini Omni",
     keyHint: "1-2 keys",
     keys: [
       {
@@ -80847,16 +81063,16 @@ var AI_FEATURES = [
         defaultFor: { kind: "video", value: "runway" }
       },
       {
-        label: "Veo",
-        desc: "Google Veo video generation",
+        label: "Gemini Omni",
+        desc: "Google Gemini Omni video generation",
         key: {
           configKey: "google",
           envVar: "GOOGLE_API_KEY",
           name: "Google",
           url: "https://aistudio.google.com/apikey",
-          what: "Google Veo video generation"
+          what: "Google Gemini Omni video generation"
         },
-        defaultFor: { kind: "video", value: "veo" }
+        defaultFor: { kind: "video", value: "omni" }
       }
     ],
     tryCommand: 'vibe generate video "ocean waves" -o waves.mp4'
@@ -81537,7 +81753,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(
@@ -82390,7 +82606,7 @@ var AGENTS_MD = `# AGENTS.md
 
 This project uses [VibeFrame](https://github.com/vericontext/vibeframe) -
 a CLI for AI video generation on the user's own provider keys (Seedance,
-Runway, Veo, Kling), behind dry runs and a hard \`--max-cost\` ceiling.
+Runway, Kling, Gemini Omni), behind dry runs and a hard \`--max-cost\` ceiling.
 The \`vibe\` command provides 80+ subcommands for video generation,
 editing, and analysis. Cost tiers below - **always confirm with the user
 before running High / Very High tier commands**.
@@ -82715,7 +82931,7 @@ function renderEnvExample(opts = {}) {
 ${fallback2}# \u2500\u2500 LLM provider / optional \`vibe agent\` fallback (pick one) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
 ANTHROPIC_API_KEY=                    # Claude - recommended default
 OPENAI_API_KEY=                       # GPT-5.4 mini \xB7 Whisper \xB7 gpt-image-2.5
-GOOGLE_API_KEY=                       # Gemini \xB7 Veo
+GOOGLE_API_KEY=                       # Gemini \xB7 Omni video
 XAI_API_KEY=                          # Grok image+video
 OPENROUTER_API_KEY=                   # multiplexes any provider above
 # OLLAMA_HOST=http://localhost:11434  # offline, no key needed
@@ -86857,7 +87073,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 +87286,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) {
@@ -87567,7 +87785,8 @@ program2.name("vibe").showSuggestionAfterError(true).description("VibeFrame CLI
       process.stderr.write(JSON.stringify(err, null, 2) + "\n");
     } else {
       write2(source_default.red(str.trim()) + "\n");
-      write2(source_default.dim("Run with --help for full options.\n"));
+      write2(`${source_default.dim("Run with --help for full options.")}
+`);
     }
   }
 }).configureHelp({
@@ -87689,7 +87908,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 });
@@ -87720,7 +87939,8 @@ function propagateErrorHandling(cmd) {
           process.stderr.write(JSON.stringify(err, null, 2) + "\n");
         } else {
           write2(source_default.red(str.trim()) + "\n");
-          write2(source_default.dim("Run with --help for full options.\n"));
+          write2(`${source_default.dim("Run with --help for full options.")}
+`);
         }
       }
     });