@vibeframe/cli 0.105.2 → 0.106.0

package/dist/index.js

@@ -7299,6 +7299,39 @@ var init_whisper = __esm({
   }
 });
 
+// ../ai-providers/dist/gemini/gemini-models.js
+function isGeminiTextModelAlias(model) {
+  return Object.prototype.hasOwnProperty.call(GEMINI_TEXT_MODEL_ALIASES, model);
+}
+function resolveGeminiTextModel(model) {
+  const trimmed = model?.trim();
+  if (!trimmed)
+    return GEMINI_DEFAULT_TEXT_MODEL;
+  if (isGeminiTextModelAlias(trimmed))
+    return GEMINI_TEXT_MODEL_ALIASES[trimmed];
+  if (trimmed.startsWith("gemini-"))
+    return trimmed;
+  return GEMINI_DEFAULT_TEXT_MODEL;
+}
+var GEMINI_DEFAULT_TEXT_MODEL, GEMINI_AGENT_DEFAULT_TEXT_MODEL, GEMINI_TEXT_MODEL_ALIASES, GEMINI_TEXT_MODEL_HELP;
+var init_gemini_models = __esm({
+  "../ai-providers/dist/gemini/gemini-models.js"() {
+    "use strict";
+    GEMINI_DEFAULT_TEXT_MODEL = "gemini-3.5-flash";
+    GEMINI_AGENT_DEFAULT_TEXT_MODEL = "gemini-2.5-flash";
+    GEMINI_TEXT_MODEL_ALIASES = {
+      flash: GEMINI_DEFAULT_TEXT_MODEL,
+      latest: GEMINI_DEFAULT_TEXT_MODEL,
+      "flash-3.5": GEMINI_DEFAULT_TEXT_MODEL,
+      "flash-3": "gemini-3-flash-preview",
+      "flash-2.5": "gemini-2.5-flash",
+      pro: "gemini-2.5-pro",
+      "pro-3.1": "gemini-3.1-pro-preview"
+    };
+    GEMINI_TEXT_MODEL_HELP = "flash/latest (Gemini 3.5 Flash), flash-3.5, flash-3, flash-2.5, pro, pro-3.1, or a full gemini-* model ID";
+  }
+});
+
 // ../ai-providers/dist/gemini/gemini-motion.js
 function buildMotionSystemPrompt(width, height, fps, duration, durationInFrames, stylePreset) {
   return `You are a world-class broadcast motion graphics designer (like Apple Keynote, Netflix intros, ESPN graphics). Create STUNNING, jaw-dropping overlays that make viewers go "wow".
@@ -7452,7 +7485,7 @@ async function generateMotion(api, description, options = {}) {
   const duration = options.duration || 5;
   const durationInFrames = Math.round(duration * fps);
   const stylePreset = options.style || "modern and clean";
-  const modelId = options.model || "gemini-2.5-pro";
+  const modelId = resolveGeminiTextModel(options.model);
   let systemPrompt = buildMotionSystemPrompt(width, height, fps, duration, durationInFrames, stylePreset);
   if (options.videoContext) {
     const sourceLabel = options.sourceType === "image" ? "IMAGE" : "VIDEO";
@@ -7533,7 +7566,7 @@ async function refineMotion(api, existingCode, instructions, options = {}) {
   const fps = options.fps || 30;
   const duration = options.duration || 5;
   const durationInFrames = Math.round(duration * fps);
-  const modelId = options.model || "gemini-2.5-pro";
+  const modelId = resolveGeminiTextModel(options.model);
   const systemPrompt = `You are a world-class broadcast motion graphics designer. Modify the provided Remotion component based on instructions.
 
 CANVAS: ${width}\xD7${height}px | ${fps}fps | ${durationInFrames} frames (${duration}s)
@@ -7628,9 +7661,18 @@ var GEMINI_MOTION_MODELS, STYLE_USER_INSTRUCTIONS;
 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.5": GEMINI_DEFAULT_TEXT_MODEL,
+      "flash-3": "gemini-3-flash-preview",
+      "flash-2.5": "gemini-2.5-flash",
       pro: "gemini-2.5-pro",
-      "3.1-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"
     };
     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.",
@@ -7753,7 +7795,7 @@ async function analyzeContent(api, content, targetDuration, options) {
         maxOutputTokens: 4096
       }
     };
-    const response = await fetch(`${api.baseUrl}/models/gemini-2.5-flash:generateContent?key=${api.apiKey}`, {
+    const response = await fetch(`${api.baseUrl}/models/${GEMINI_DEFAULT_TEXT_MODEL}:generateContent?key=${api.apiKey}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(payload)
@@ -7786,6 +7828,7 @@ var init_gemini_storyboard = __esm({
   "../ai-providers/dist/gemini/gemini-storyboard.js"() {
     "use strict";
     init_storyboard_prompt();
+    init_gemini_models();
   }
 });
 
@@ -7824,6 +7867,7 @@ var init_GeminiProvider = __esm({
   "../ai-providers/dist/gemini/GeminiProvider.js"() {
     "use strict";
     init_gemini_motion();
+    init_gemini_models();
     init_gemini_storyboard();
     init_http();
     MODEL_MAP = {
@@ -8332,7 +8376,7 @@ var init_GeminiProvider = __esm({
             error: "Google API key not configured"
           };
         }
-        const modelId = options.model || "gemini-3-flash-preview";
+        const modelId = resolveGeminiTextModel(options.model);
         try {
           let videoPart;
           if (typeof videoData === "string") {
@@ -8439,7 +8483,7 @@ var init_GeminiProvider = __esm({
             error: "Google API key not configured"
           };
         }
-        const modelId = options.model || "gemini-3-flash-preview";
+        const modelId = resolveGeminiTextModel(options.model);
         try {
           const buffers = Array.isArray(imageData) ? imageData : [imageData];
           const imageParts = buffers.map((buf) => ({
@@ -8541,7 +8585,7 @@ Example response:
 [{"type":"trim","description":"Trim intro to 3 seconds","clipIds":["clip-1"],"params":{"newDuration":3},"confidence":0.9}]
 
 Respond with ONLY the JSON array, no other text.`;
-          const response = await fetch(`${this.baseUrl}/models/gemini-2.5-flash:generateContent?key=${this.apiKey}`, {
+          const response = await fetch(`${this.baseUrl}/models/${GEMINI_DEFAULT_TEXT_MODEL}:generateContent?key=${this.apiKey}`, {
             method: "POST",
             headers: {
               "Content-Type": "application/json"
@@ -8663,6 +8707,7 @@ var init_gemini = __esm({
     "use strict";
     init_GeminiProvider();
     init_gemini_motion();
+    init_gemini_models();
     init_define_provider();
     defineProvider({
       id: "gemini",
@@ -18026,6 +18071,10 @@ __export(dist_exports2, {
   ClaudeProvider: () => ClaudeProvider,
   ElevenLabsProvider: () => ElevenLabsProvider,
   FalProvider: () => FalProvider,
+  GEMINI_AGENT_DEFAULT_TEXT_MODEL: () => GEMINI_AGENT_DEFAULT_TEXT_MODEL,
+  GEMINI_DEFAULT_TEXT_MODEL: () => GEMINI_DEFAULT_TEXT_MODEL,
+  GEMINI_TEXT_MODEL_ALIASES: () => GEMINI_TEXT_MODEL_ALIASES,
+  GEMINI_TEXT_MODEL_HELP: () => GEMINI_TEXT_MODEL_HELP,
   GeminiProvider: () => GeminiProvider,
   GrokProvider: () => GrokProvider,
   KNOWN_VOICES: () => KNOWN_VOICES,
@@ -18056,6 +18105,7 @@ __export(dist_exports2, {
   getProvidersFor: () => getProvidersFor,
   getSetupProviders: () => getSetupProviders,
   grokProvider: () => grokProvider,
+  isGeminiTextModelAlias: () => isGeminiTextModelAlias,
   klingProvider: () => klingProvider,
   kokoroProvider: () => kokoroProvider,
   ollamaProvider: () => ollamaProvider,
@@ -18063,6 +18113,7 @@ __export(dist_exports2, {
   openaiProvider: () => openaiProvider,
   providerRegistry: () => providerRegistry,
   replicateProvider: () => replicateProvider,
+  resolveGeminiTextModel: () => resolveGeminiTextModel,
   resolveVoiceId: () => resolveVoiceId,
   runwayProvider: () => runwayProvider,
   whisperProvider: () => whisperProvider
@@ -27471,6 +27522,52 @@ function buildPreset(input) {
     }
   }
 }
+function lottieOverlayStyle(input) {
+  const pos = input.position ?? "full";
+  const rawScale = input.scale ?? (pos === "full" ? 1 : 0.25);
+  const scale = Math.max(0.01, Math.min(2, rawScale));
+  const opacity = Math.max(0, Math.min(1, input.opacity ?? 1));
+  const base = [
+    "position:absolute",
+    "pointer-events:none",
+    `opacity:${opacity}`
+  ];
+  if (pos === "full") {
+    base.push("inset:0", "width:100%", "height:100%");
+  } else {
+    const pct = scale * 100;
+    base.push(`width:${pct}%`, `height:${pct}%`);
+    switch (pos) {
+      case "center":
+        base.push("top:50%", "left:50%", "transform:translate(-50%,-50%)");
+        break;
+      case "top-left":
+        base.push("top:4%", "left:4%");
+        break;
+      case "top-right":
+        base.push("top:4%", "right:4%");
+        break;
+      case "bottom-left":
+        base.push("bottom:4%", "left:4%");
+        break;
+      case "bottom-right":
+        base.push("bottom:4%", "right:4%");
+        break;
+    }
+  }
+  return base.join(";");
+}
+function buildLottieOverlay(input, sceneId) {
+  const loop = input.loop ?? true ? " loop" : "";
+  const style = lottieOverlayStyle(input);
+  const overlayId = `lottie-overlay-${sceneId}`;
+  const markup = `<dotlottie-wc id="${overlayId}" src="${esc(input.src)}" autoplay${loop} style="${style}"></dotlottie-wc>`;
+  const script = `<script type="module">
+      import { setWasmUrl } from "${DOTLOTTIE_WC_CDN}";
+      setWasmUrl("${DOTLOTTIE_WASM_CDN}");
+    </script>`;
+  return { markup, script };
+}
 function emitSceneHtml(input) {
   if (input.duration <= 0) {
     throw new Error(`Scene duration must be > 0, got ${input.duration}`);
@@ -27491,15 +27588,20 @@ function emitSceneHtml(input) {
       data-volume="1"
     ></audio>
 ` : "";
+  const lottieLayer = input.lottie ? buildLottieOverlay(input.lottie, id) : null;
+  const lottieMarkup = lottieLayer ? `
+    ${lottieLayer.markup}` : "";
+  const lottieScript = lottieLayer ? `
+    ${lottieLayer.script}` : "";
   return `<template id="scene-${id}-template">
   <div data-composition-id="${id}" data-start="0" data-duration="${dur}" data-width="${input.width}" data-height="${input.height}">
     <style>
       ${parts.css}
     </style>
 
-    ${parts.body}
+    ${parts.body}${lottieMarkup}
 ${audioBlock}
-    <script src="${GSAP_CDN}"></script>
+    <script src="${GSAP_CDN}"></script>${lottieScript}
     <script>
       window.__timelines = window.__timelines || {};
       const tl = gsap.timeline({ paused: true });
@@ -27561,7 +27663,7 @@ function readRootDims(rootHtml) {
   if (!widthMatch || !heightMatch) return null;
   return { width: parseInt(widthMatch[1], 10), height: parseInt(heightMatch[1], 10) };
 }
-var SCENE_PRESETS, GSAP_CDN, SCENE_OVERLAP_SECONDS;
+var SCENE_PRESETS, LOTTIE_POSITIONS, GSAP_CDN, SCENE_OVERLAP_SECONDS, DOTLOTTIE_WC_VERSION, DOTLOTTIE_WEB_VERSION, DOTLOTTIE_WC_CDN, DOTLOTTIE_WASM_CDN;
 var init_scene_html_emit = __esm({
   "src/commands/_shared/scene-html-emit.ts"() {
     "use strict";
@@ -27572,8 +27674,20 @@ var init_scene_html_emit = __esm({
       "kinetic-type",
       "product-shot"
     ];
+    LOTTIE_POSITIONS = [
+      "full",
+      "center",
+      "top-left",
+      "top-right",
+      "bottom-left",
+      "bottom-right"
+    ];
     GSAP_CDN = "https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js";
     SCENE_OVERLAP_SECONDS = 0.4;
+    DOTLOTTIE_WC_VERSION = "0.9.12";
+    DOTLOTTIE_WEB_VERSION = "0.71.0";
+    DOTLOTTIE_WC_CDN = `https://cdn.jsdelivr.net/npm/@lottiefiles/dotlottie-wc@${DOTLOTTIE_WC_VERSION}/dist/index.js`;
+    DOTLOTTIE_WASM_CDN = `https://cdn.jsdelivr.net/npm/@lottiefiles/dotlottie-web@${DOTLOTTIE_WEB_VERSION}/dist/dotlottie-player.wasm`;
   }
 });
 
@@ -29607,6 +29721,7 @@ var MODEL_SETTINGS_BY_PROVIDER, ComposeBeatError, defaultCallLLM, CONFIG_PROVIDE
 var init_compose_scenes_skills = __esm({
   "src/commands/_shared/compose-scenes-skills.ts"() {
     "use strict";
+    init_dist2();
     init_config();
     init_bundle();
     init_scene_lint();
@@ -29628,12 +29743,12 @@ var init_compose_scenes_skills = __esm({
         medium: { model: "gpt-5", maxTokens: 6e3, costPerMTokIn: 1.25, costPerMTokOut: 10 },
         high: { model: "gpt-5", maxTokens: 8e3, costPerMTokIn: 1.25, costPerMTokOut: 10 }
       },
-      // Google Gemini 2.5 Pro — ~2.6× cheaper than Claude per spike, ~20 s/beat.
-      // Strong instruction-following on the Hyperframes skill bundle.
+      // Google Gemini 3.5 Flash — current one-shot Gemini default for
+      // analysis/composition. Keep agent loops on their explicit 2.5 Flash default.
       gemini: {
-        low: { model: "gemini-2.5-pro", maxTokens: 4e3, costPerMTokIn: 1.25, costPerMTokOut: 5 },
-        medium: { model: "gemini-2.5-pro", maxTokens: 6e3, costPerMTokIn: 1.25, costPerMTokOut: 5 },
-        high: { model: "gemini-2.5-pro", maxTokens: 8e3, costPerMTokIn: 1.25, costPerMTokOut: 5 }
+        low: { model: GEMINI_DEFAULT_TEXT_MODEL, maxTokens: 4e3, costPerMTokIn: 1.5, costPerMTokOut: 9 },
+        medium: { model: GEMINI_DEFAULT_TEXT_MODEL, maxTokens: 6e3, costPerMTokIn: 1.5, costPerMTokOut: 9 },
+        high: { model: GEMINI_DEFAULT_TEXT_MODEL, maxTokens: 8e3, costPerMTokIn: 1.5, costPerMTokOut: 9 }
       }
     };
     ComposeBeatError = class extends Error {
@@ -30579,6 +30694,30 @@ async function executeSceneAdd(opts) {
       await writeFile11(imageAbsPath, buffer);
     }
   }
+  let lottieRelPath;
+  let lottieAbsPath;
+  let lottieInput;
+  if (opts.lottie) {
+    const sourceAbs = resolve15(opts.lottie.src);
+    if (!await pathExists2(sourceAbs)) {
+      return errResult(`Lottie file not found: ${sourceAbs}`);
+    }
+    const ext = (sourceAbs.match(/\.([a-z0-9]+)$/i)?.[1] ?? "json").toLowerCase();
+    if (ext !== "json" && ext !== "lottie") {
+      return errResult(`Unsupported Lottie file extension: .${ext}. Use .json or .lottie.`);
+    }
+    lottieRelPath = `assets/lottie-${id}.${ext}`;
+    lottieAbsPath = resolve15(projectDir, lottieRelPath);
+    await mkdir6(dirname3(lottieAbsPath), { recursive: true });
+    await copyFile(sourceAbs, lottieAbsPath);
+    lottieInput = {
+      src: lottieRelPath,
+      position: opts.lottie.position,
+      scale: opts.lottie.scale,
+      opacity: opts.lottie.opacity,
+      loop: opts.lottie.loop
+    };
+  }
   const cfg = await loadVibeProjectConfig(projectDir);
   const fallback2 = cfg?.defaultSceneDuration ?? 5;
   const NARRATION_TAIL_BUFFER = 0.5;
@@ -30607,7 +30746,8 @@ async function executeSceneAdd(opts) {
     kicker: opts.kicker,
     imagePath: imageRelPath,
     audioPath: audioRelPath,
-    transcript: transcriptWords
+    transcript: transcriptWords,
+    lottie: lottieInput
   });
   await mkdir6(dirname3(scenePath), { recursive: true });
   await writeFile11(scenePath, sceneHtml, "utf-8");
@@ -30628,6 +30768,7 @@ async function executeSceneAdd(opts) {
     rootPath: relative6(process.cwd(), rootPath) || rootPath,
     audioPath: audioAbsPath ? relative6(process.cwd(), audioAbsPath) || audioAbsPath : void 0,
     imagePath: imageAbsPath ? relative6(process.cwd(), imageAbsPath) || imageAbsPath : void 0,
+    lottiePath: lottieAbsPath ? relative6(process.cwd(), lottieAbsPath) || lottieAbsPath : void 0,
     transcriptPath: transcriptAbsPath ? relative6(process.cwd(), transcriptAbsPath) || transcriptAbsPath : void 0,
     transcriptWordCount
   };
@@ -30905,9 +31046,40 @@ Run 'vibe schema scene.<command>' for structured parameter info.`
     ).option("--no-image", "Skip image generation even when --visuals is provided").option(
       "--no-transcribe",
       "Skip Whisper word-level transcribe step (no transcript-<id>.json emitted)"
-    ).option("--transcribe-language <code>", "BCP-47 language code passed to Whisper (e.g. en, ko)").option("--force", "Overwrite an existing compositions/scene-<id>.html").option("--dry-run", "Preview parameters without writing files or calling APIs").action(async (name, options) => {
+    ).option("--transcribe-language <code>", "BCP-47 language code passed to Whisper (e.g. en, ko)").option("--force", "Overwrite an existing compositions/scene-<id>.html").option("--lottie <path>", "Lottie animation file (.json/.lottie) to overlay on the scene").option(
+      "--lottie-position <position>",
+      `Lottie position: ${LOTTIE_POSITIONS.join(", ")}`,
+      "full"
+    ).option("--lottie-scale <number>", "Lottie overlay scale (0.01-2)").option("--lottie-opacity <number>", "Lottie overlay opacity (0-1)", "1").option("--lottie-no-loop", "Do not loop the Lottie animation").option("--dry-run", "Preview parameters without writing files or calling APIs").action(async (name, options) => {
       const startedAt = Date.now();
       if (options.style) options.style = validatePreset(options.style);
+      if (options.lottiePosition) {
+        if (!LOTTIE_POSITIONS.includes(options.lottiePosition)) {
+          exitWithError(
+            usageError(
+              `Invalid --lottie-position "${options.lottiePosition}". Valid: ${LOTTIE_POSITIONS.join(", ")}`
+            )
+          );
+        }
+      }
+      let lottieScale;
+      if (options.lottieScale !== void 0) {
+        lottieScale = Number(options.lottieScale);
+        if (!Number.isFinite(lottieScale) || lottieScale < 0.01 || lottieScale > 2) {
+          exitWithError(
+            usageError(`Invalid --lottie-scale "${options.lottieScale}". Must be between 0.01 and 2.`)
+          );
+        }
+      }
+      let lottieOpacity = 1;
+      if (options.lottieOpacity !== void 0) {
+        lottieOpacity = Number(options.lottieOpacity);
+        if (!Number.isFinite(lottieOpacity) || lottieOpacity < 0 || lottieOpacity > 1) {
+          exitWithError(
+            usageError(`Invalid --lottie-opacity "${options.lottieOpacity}". Must be between 0 and 1.`)
+          );
+        }
+      }
       if (options.duration !== void 0) options.duration = validateDuration(options.duration);
       let tts;
       try {
@@ -30936,7 +31108,11 @@ Run 'vibe schema scene.<command>' for structured parameter info.`
               imageProvider: options.imageProvider,
               tts,
               audio: options.audio,
-              // commander sets `audio: false` when --no-audio is passed
+              lottie: options.lottie ?? null,
+              lottiePosition: options.lottiePosition,
+              lottieScale: lottieScale ?? null,
+              lottieOpacity: options.lottieOpacity !== void 0 ? lottieOpacity : null,
+              lottieLoop: !options.lottieNoLoop,
               image: options.image
             }
           }
@@ -30964,6 +31140,13 @@ Run 'vibe schema scene.<command>' for structured parameter info.`
           skipTranscribe: options.transcribe === false,
           transcribeLanguage: options.transcribeLanguage,
           force: !!options.force,
+          lottie: options.lottie ? {
+            src: options.lottie,
+            position: options.lottiePosition ?? "full",
+            scale: lottieScale,
+            opacity: options.lottieOpacity !== void 0 ? lottieOpacity : 1,
+            loop: !options.lottieNoLoop
+          } : void 0,
           onProgress: (msg) => {
             if (spinner2) spinner2.text = msg;
           }
@@ -32028,7 +32211,7 @@ Use this image analysis to inform the color palette, typography placement, and o
 6. Recommended animation timing and entrance/exit style
 7. Any moments where overlays should pause, fade, or stay minimal`;
       const analysisResult = await gemini.analyzeVideo(videoBuffer, analysisPrompt, {
-        model: "gemini-2.5-flash",
+        model: GEMINI_DEFAULT_TEXT_MODEL,
         fps: 1,
         lowResolution: true
       });
@@ -32197,7 +32380,7 @@ function registerMotionCommand(aiCommand) {
     "auto"
   ).option("--understanding-prompt <text>", "Custom prompt for --video understanding").option("--from-tsx <path>", "Refine an existing TSX file instead of generating from scratch").option(
     "-m, --model <alias>",
-    "LLM model: sonnet (default), opus, gemini, gemini-3.1-pro",
+    "LLM model: sonnet (default), opus, gemini, gemini-2.5-pro, gemini-3.1-pro",
     "sonnet"
   ).option("--dry-run", "Preview parameters without executing").action(async (description, options) => {
     const startedAt = Date.now();
@@ -32341,7 +32524,8 @@ var init_ai_motion = __esm({
       sonnet: { provider: "claude", modelId: "claude-sonnet-4-6" },
       opus: { provider: "claude", modelId: "claude-opus-4-7" },
       "opus-4-6": { provider: "claude", modelId: "claude-opus-4-6" },
-      gemini: { provider: "gemini", modelId: "gemini-2.5-pro" },
+      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" }
     };
   }
@@ -35768,13 +35952,7 @@ async function executeThumbnailBestFrame(options) {
     await gemini.initialize({ apiKey: googleKey });
     const videoData = await readFile17(videoPath);
     const analysisPrompt = prompt3 || 'Analyze this video and find the single best frame for a thumbnail. Look for frames that are visually striking, well-composed, emotionally engaging, and representative of the video content. Avoid blurry frames, transitions, or dark scenes. Return ONLY a JSON object: {"timestamp": <seconds as number>, "reason": "<brief explanation>"}';
-    const modelMap = {
-      flash: "gemini-3-flash-preview",
-      latest: "gemini-2.5-flash",
-      "flash-2.5": "gemini-2.5-flash",
-      pro: "gemini-2.5-pro"
-    };
-    const modelId = modelMap[model] || "gemini-3-flash-preview";
+    const modelId = resolveGeminiTextModel(model);
     const result = await gemini.analyzeVideo(videoData, analysisPrompt, {
       model: modelId,
       fps: 1
@@ -35822,7 +36000,7 @@ import { resolve as resolve27, dirname as dirname8, basename as basename5, extna
 import { existsSync as existsSync17 } from "node:fs";
 import { writeFile as writeFile25, mkdir as mkdir12 } from "node:fs/promises";
 function registerThumbnailCommand(parent) {
-  parent.command("thumbnail").description("Generate video thumbnail (DALL-E) or extract best frame from video (Gemini)").argument("[description]", "Thumbnail description (for DALL-E generation)").option("-k, --api-key <key>", "API key (OpenAI for generation, Google for best-frame)").option("-o, --output <path>", "Output file path").option("--style <style>", "Platform style: youtube, instagram, tiktok, twitter").option("--best-frame <video>", "Extract best thumbnail frame from video using Gemini AI").option("--prompt <prompt>", "Custom prompt for best-frame analysis").option("--model <model>", "Gemini model: flash, latest, pro (default: flash)", "flash").action(async (description, options) => {
+  parent.command("thumbnail").description("Generate video thumbnail (DALL-E) or extract best frame from video (Gemini)").argument("[description]", "Thumbnail description (for DALL-E generation)").option("-k, --api-key <key>", "API key (OpenAI for generation, Google for best-frame)").option("-o, --output <path>", "Output file path").option("--style <style>", "Platform style: youtube, instagram, tiktok, twitter").option("--best-frame <video>", "Extract best thumbnail frame from video using Gemini AI").option("--prompt <prompt>", "Custom prompt for best-frame analysis").option("--model <model>", `Gemini model: ${GEMINI_TEXT_MODEL_HELP}`, "flash").action(async (description, options) => {
     const startedAt = Date.now();
     try {
       if (description) rejectControlChars(description);
@@ -37977,7 +38155,7 @@ function registerVideoCommand(parent) {
     "--seedance-model <model>",
     "Seedance variant: quality or fast (fal.ai only)",
     "quality"
-  ).option("--negative <prompt>", "Negative prompt - what to avoid (Kling/Veo)").option("--resolution <res>", "Video resolution: 720p, 1080p, 4k (Veo only)").option("--last-frame <path>", "Last frame image for frame interpolation (Veo only)").option(
+  ).option("--negative <prompt>", "Negative prompt - what to avoid (Kling/Veo)").option("--resolution <res>", "Video resolution: 480p, 720p, 1080p, or 4k depending on provider").option("--last-frame <path>", "Last frame image for frame interpolation (Veo) or Seedance end frame").option("--end-image <path>", "Ending frame image for Seedance image-to-video").option(
     "--ref-images <paths...>",
     "Reference images for Seedance reference-to-video or Veo character consistency"
   ).option("--ref-videos <paths...>", "Reference videos for Seedance reference-to-video").option("--ref-audio <paths...>", "Reference audio for Seedance reference-to-video").option("--no-generate-audio", "Disable native audio when the provider supports it").option("--person <mode>", "Person generation: allow_all, allow_adult (Veo only)").option("--veo-model <model>", "Veo model: 3.0, 3.1, 3.1-fast (default: 3.1-fast)", "3.1-fast").option(
@@ -38438,6 +38616,30 @@ Examples:
             exitWithError(apiError(message, true));
           }
         }
+        let seedanceEndImage;
+        const seedanceEndImagePath = options.endImage ?? options.lastFrame;
+        if (seedanceEndImagePath && seedanceReferences.length === 0) {
+          try {
+            const absEndImagePath = resolve31(process.cwd(), seedanceEndImagePath);
+            const endImageBuffer = await readFile18(absEndImagePath);
+            const ext = seedanceEndImagePath.toLowerCase().split(".").pop();
+            const mimeType = ext === "jpg" || ext === "jpeg" ? "image/jpeg" : `image/${ext || "png"}`;
+            const uploadHost = await resolveUploadHost();
+            spinner2.text = `Uploading end image via ${uploadHost.provider} for Seedance...`;
+            const upload = await uploadHost.uploadImage(endImageBuffer, {
+              filename: seedanceEndImagePath,
+              mimeType
+            });
+            seedanceEndImage = upload.url;
+          } catch (err) {
+            spinner2.fail("End image upload failed");
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes("IMGBB_API_KEY")) {
+              exitWithError(authError("IMGBB_API_KEY", "ImgBB"));
+            }
+            exitWithError(apiError(message, true));
+          }
+        }
         spinner2.text = "Generating video with fal.ai Seedance 2.0 (this may take 1-3 minutes)...";
         const seedanceModel = String(options.seedanceModel ?? "quality").toLowerCase();
         const falModel = seedanceModel === "fast" || seedanceModel === "seedance-2.0-fast" ? "seedance-2.0-fast" : "seedance-2.0";
@@ -38450,7 +38652,8 @@ Examples:
           negativePrompt: options.negative,
           model: falModel,
           resolution: options.resolution,
-          generateAudio: options.generateAudio
+          generateAudio: options.generateAudio,
+          lastFrame: seedanceEndImage
         });
         finalResult = result;
       }
@@ -38760,12 +38963,7 @@ async function detectSilencePeriodsWithGemini(videoPath, minDuration, options) {
   const gemini = new GeminiProvider();
   await gemini.initialize({ apiKey: geminiApiKey });
   const videoBuffer = await readFile19(videoPath);
-  const modelMap = {
-    flash: "gemini-3-flash-preview",
-    "flash-2.5": "gemini-2.5-flash",
-    pro: "gemini-2.5-pro"
-  };
-  const modelId = options.model ? modelMap[options.model] || modelMap.flash : void 0;
+  const modelId = options.model ? resolveGeminiTextModel(options.model) : void 0;
   const prompt3 = `Analyze this video and identify all silent or dead segments where there is NO meaningful content.
 
 Detect these as silent/dead segments:
@@ -41671,7 +41869,7 @@ async function executeMotionOverlay(options) {
   };
 }
 function registerMotionOverlayCommand(parent) {
-  parent.command("motion-overlay").description("Apply designed motion graphics overlays to an existing video").argument("<video>", "Video file path").argument("[description]", "Motion overlay description (omit when using --asset)").option("--asset <path>", "User-provided .json/.lottie animation to overlay").option("-o, --output <path>", "Output video file path").option("-d, --duration <sec>", "Overlay/render duration in seconds").option("--start <sec>", "Overlay start time in seconds", "0").option("--style <style>", "Style preset for generated overlays: minimal, corporate, playful, cinematic").option("-m, --model <alias>", "LLM model for generated overlays: sonnet, opus, gemini, gemini-3.1-pro", "sonnet").option("--understand <mode>", "Analyze video before generated overlay: auto, off, required", "auto").option("--understanding-prompt <text>", "Custom prompt for video understanding").option("--position <position>", "Lottie position: full, center, top-left, top-right, bottom-left, bottom-right", "full").option("--scale <number>", "Lottie overlay scale (0.01-2)").option("--opacity <number>", "Lottie overlay opacity (0-1)", "1").option("--loop", "Loop Lottie overlay", true).option("--no-loop", "Do not loop Lottie overlay").option("--dry-run", "Preview parameters without executing").action(async (videoPath, description, options) => {
+  parent.command("motion-overlay").description("Apply designed motion graphics overlays to an existing video").argument("<video>", "Video file path").argument("[description]", "Motion overlay description (omit when using --asset)").option("--asset <path>", "User-provided .json/.lottie animation to overlay").option("-o, --output <path>", "Output video file path").option("-d, --duration <sec>", "Overlay/render duration in seconds").option("--start <sec>", "Overlay start time in seconds", "0").option("--style <style>", "Style preset for generated overlays: minimal, corporate, playful, cinematic").option("-m, --model <alias>", "LLM model for generated overlays: sonnet, opus, gemini, gemini-2.5-pro, gemini-3.1-pro", "sonnet").option("--understand <mode>", "Analyze video before generated overlay: auto, off, required", "auto").option("--understanding-prompt <text>", "Custom prompt for video understanding").option("--position <position>", "Lottie position: full, center, top-left, top-right, bottom-left, bottom-right", "full").option("--scale <number>", "Lottie overlay scale (0.01-2)").option("--opacity <number>", "Lottie overlay opacity (0-1)", "1").option("--loop", "Loop Lottie overlay", true).option("--no-loop", "Do not loop Lottie overlay").option("--dry-run", "Preview parameters without executing").action(async (videoPath, description, options) => {
     const startedAt = Date.now();
     try {
       if (options.output) validateOutputPath(options.output);
@@ -42761,12 +42959,7 @@ async function executeGeminiVideo(options) {
       return { success: false, error: "Google API key required. Run 'vibe setup' or set GOOGLE_API_KEY in .env" };
     }
     const isYouTube = options.source.includes("youtube.com") || options.source.includes("youtu.be");
-    const modelMap = {
-      flash: "gemini-3-flash-preview",
-      "flash-2.5": "gemini-2.5-flash",
-      pro: "gemini-2.5-pro"
-    };
-    const modelId = modelMap[options.model || "flash"] || modelMap.flash;
+    const modelId = resolveGeminiTextModel(options.model);
     let videoData;
     if (isYouTube) {
       videoData = options.source;
@@ -42827,12 +43020,7 @@ async function executeAnalyze(options) {
         error: "Cannot detect source type. Supported: images (.png/.jpg/.webp/.gif), videos (.mp4/.mov/.webm), YouTube URLs, image URLs."
       };
     }
-    const modelMap = {
-      flash: "gemini-3-flash-preview",
-      "flash-2.5": "gemini-2.5-flash",
-      pro: "gemini-2.5-pro"
-    };
-    const modelId = modelMap[options.model || "flash"] || modelMap.flash;
+    const modelId = resolveGeminiTextModel(options.model);
     const gemini = new GeminiProvider();
     await gemini.initialize({ apiKey });
     if (isImage) {
@@ -42912,7 +43100,7 @@ async function executeAnalyze(options) {
   }
 }
 function registerAnalyzeCommands(aiCommand) {
-  aiCommand.command("gemini-video").description("Analyze video using Gemini (summarize, Q&A, extract info)").argument("<source>", "Video file path or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second (default: 1, higher for action)").option("--start <seconds>", "Start offset in seconds (for clipping)").option("--end <seconds>", "End offset in seconds (for clipping)").option("--low-res", "Use low resolution mode (fewer tokens, longer videos)").option("-v, --verbose", "Show token usage").action(async (source, prompt3, options) => {
+  aiCommand.command("gemini-video").description("Analyze video using Gemini (summarize, Q&A, extract info)").argument("<source>", "Video file path or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", `Model: ${GEMINI_TEXT_MODEL_HELP}`, "flash").option("--fps <number>", "Frames per second (default: 1, higher for action)").option("--start <seconds>", "Start offset in seconds (for clipping)").option("--end <seconds>", "End offset in seconds (for clipping)").option("--low-res", "Use low resolution mode (fewer tokens, longer videos)").option("-v, --verbose", "Show token usage").action(async (source, prompt3, options) => {
     try {
       if (options.apiKey) {
         process.env.GOOGLE_API_KEY = options.apiKey;
@@ -42955,7 +43143,7 @@ function registerAnalyzeCommands(aiCommand) {
       exitWithError(apiError(`Video analysis failed: ${error instanceof Error ? error.message : String(error)}`, true));
     }
   });
-  aiCommand.command("analyze").description("Analyze any media: images, videos, or YouTube URLs using Gemini").argument("<source>", "Image/video file path, image URL, or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Describe this image', 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second for video (default: 1)").option("--start <seconds>", "Start offset in seconds (video only)").option("--end <seconds>", "End offset in seconds (video only)").option("--low-res", "Use low resolution mode (fewer tokens)").option("-v, --verbose", "Show token usage").action(async (source, prompt3, options) => {
+  aiCommand.command("analyze").description("Analyze any media: images, videos, or YouTube URLs using Gemini").argument("<source>", "Image/video file path, image URL, or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Describe this image', 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", `Model: ${GEMINI_TEXT_MODEL_HELP}`, "flash").option("--fps <number>", "Frames per second for video (default: 1)").option("--start <seconds>", "Start offset in seconds (video only)").option("--end <seconds>", "End offset in seconds (video only)").option("--low-res", "Use low resolution mode (fewer tokens)").option("-v, --verbose", "Show token usage").action(async (source, prompt3, options) => {
     try {
       if (options.apiKey) {
         process.env.GOOGLE_API_KEY = options.apiKey;
@@ -43076,12 +43264,7 @@ ${content}`;
 
 Project context for beat-aware review:
 ${projectContext}` : "";
-  const modelMap = {
-    flash: "gemini-3-flash-preview",
-    "flash-2.5": "gemini-2.5-flash",
-    pro: "gemini-2.5-pro"
-  };
-  const modelId = modelMap[model] || modelMap.flash;
+  const modelId = resolveGeminiTextModel(model);
   const reviewPrompt = `You are a professional video editor reviewing this video for quality. Analyze the video and return a JSON review with the following structure. Return ONLY valid JSON, no extra text.
 
 {
@@ -43188,7 +43371,7 @@ Score each category 1-10. Prefer beatIssues when you can map a problem to a stor
   return result;
 }
 function registerReviewCommand(aiCommand) {
-  aiCommand.command("review", { hidden: true }).description("Review video quality using Gemini AI and optionally auto-fix issues").argument("<source>", "Video file path").option("--storyboard <path>", "Storyboard JSON file for context").option("--auto-apply", "Automatically apply fixable corrections").option("--verify", "Run verification pass after applying fixes").option("-m, --model <model>", "Gemini model: flash (default), flash-2.5, pro", "flash").option("-o, --output <path>", "Output video file path (for auto-apply)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+  aiCommand.command("review", { hidden: true }).description("Review video quality using Gemini AI and optionally auto-fix issues").argument("<source>", "Video file path").option("--storyboard <path>", "Storyboard JSON file for context").option("--auto-apply", "Automatically apply fixable corrections").option("--verify", "Run verification pass after applying fixes").option("-m, --model <model>", `Gemini model: ${GEMINI_TEXT_MODEL_HELP}`, "flash").option("-o, --output <path>", "Output video file path (for auto-apply)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
     const startedAt = Date.now();
     try {
       if (options.output) {
@@ -67614,7 +67797,7 @@ var init_edit = __esm({
         duration: external_exports.number().optional().describe("Overlay/render duration in seconds"),
         start: external_exports.number().optional().describe("Overlay start time in seconds"),
         style: external_exports.string().optional().describe("Style preset for generated overlays"),
-        model: external_exports.enum(["sonnet", "opus", "gemini", "gemini-3.1-pro"]).optional().describe("LLM model for generated overlays"),
+        model: external_exports.enum(["sonnet", "opus", "gemini", "gemini-2.5-pro", "gemini-3.1-pro"]).optional().describe("LLM model for generated overlays"),
         understand: external_exports.enum(["auto", "off", "required"]).optional().describe("Analyze video before generated overlay (default: auto)"),
         understandingPrompt: external_exports.string().optional().describe("Custom prompt for video understanding"),
         position: external_exports.enum(["full", "center", "top-left", "top-right", "bottom-left", "bottom-right"]).optional().describe("Lottie overlay position"),
@@ -67990,7 +68173,7 @@ var init_inspect = __esm({
         outputPath: external_exports.string().optional().describe("Optional review report path. Defaults to <project>/review-report.json."),
         report: external_exports.boolean().optional().describe("Write review-report.json. Default true."),
         ai: external_exports.boolean().optional().describe("Also run Gemini video review and merge findings into review-report.json. Default false."),
-        model: external_exports.enum(["flash", "flash-2.5", "pro"]).optional().describe("Gemini model variant for ai review. Default flash."),
+        model: external_exports.enum(["flash", "latest", "flash-3", "flash-2.5", "pro", "pro-3.1"]).optional().describe("Gemini model variant for ai review. Default flash."),
         dryRun: external_exports.boolean().optional().describe("Preview resolved inputs without probing video or calling Gemini.")
       }),
       async execute(args, ctx) {
@@ -68042,7 +68225,7 @@ var init_inspect = __esm({
       schema: external_exports.object({
         source: external_exports.string().describe("Path to image/video or YouTube URL"),
         prompt: external_exports.string().describe("Analysis prompt (e.g., 'Describe the scene', 'Count people')"),
-        model: external_exports.enum(["flash", "flash-2.5", "pro"]).optional().describe("Gemini model variant (default: flash)"),
+        model: external_exports.enum(["flash", "latest", "flash-3", "flash-2.5", "pro", "pro-3.1"]).optional().describe("Gemini model variant (default: flash)"),
         fps: external_exports.number().optional().describe("Frames per second for video sampling (default: 1)"),
         start: external_exports.number().optional().describe("Start time in seconds for video analysis"),
         end: external_exports.number().optional().describe("End time in seconds for video analysis"),
@@ -68070,7 +68253,7 @@ var init_inspect = __esm({
       schema: external_exports.object({
         source: external_exports.string().describe("Path to video file"),
         prompt: external_exports.string().describe("Analysis prompt"),
-        model: external_exports.enum(["flash", "flash-2.5", "pro"]).optional().describe("Gemini model variant (default: flash)"),
+        model: external_exports.enum(["flash", "latest", "flash-3", "flash-2.5", "pro", "pro-3.1"]).optional().describe("Gemini model variant (default: flash)"),
         fps: external_exports.number().optional().describe("Frames per second for sampling"),
         start: external_exports.number().optional().describe("Start time in seconds"),
         end: external_exports.number().optional().describe("End time in seconds"),
@@ -68100,7 +68283,7 @@ var init_inspect = __esm({
         storyboardPath: external_exports.string().optional().describe("Path to storyboard.json for intent comparison"),
         autoApply: external_exports.boolean().optional().describe("Automatically apply suggested fixes (default: false)"),
         verify: external_exports.boolean().optional().describe("Re-review after applying fixes (default: false)"),
-        model: external_exports.enum(["flash", "flash-2.5", "pro"]).optional().describe("Gemini model variant (default: flash)"),
+        model: external_exports.enum(["flash", "latest", "flash-3", "flash-2.5", "pro", "pro-3.1"]).optional().describe("Gemini model variant (default: flash)"),
         outputPath: external_exports.string().optional().describe("Output path for fixed video")
       }),
       async execute(args) {
@@ -68192,7 +68375,7 @@ var init_generate2 = __esm({
           "Analyze the base video with Gemini before generating motion graphics: auto, off, or required (default: auto)"
         ),
         understandingPrompt: external_exports.string().optional().describe("Custom prompt for video understanding when --video is provided"),
-        model: external_exports.enum(["sonnet", "opus", "gemini", "gemini-3.1-pro"]).optional().describe("LLM model for code generation (default: sonnet)"),
+        model: external_exports.enum(["sonnet", "opus", "gemini", "gemini-2.5-pro", "gemini-3.1-pro"]).optional().describe("LLM model for code generation (default: sonnet)"),
         output: external_exports.string().optional().describe("Output path (TSX if code-only, MP4 if rendered)")
       }),
       async execute(args) {
@@ -68457,6 +68640,7 @@ var init_generate2 = __esm({
           "Video provider (default: seedance when FAL_API_KEY is configured, otherwise first configured provider)"
         ),
         image: external_exports.string().optional().describe("Reference image path for image-to-video"),
+        endImage: external_exports.string().optional().describe("Ending frame image path for Seedance image-to-video"),
         refImages: external_exports.array(external_exports.string()).optional().describe("Reference images for Seedance reference-to-video"),
         refVideos: external_exports.array(external_exports.string()).optional().describe("Reference videos for Seedance reference-to-video"),
         refAudio: external_exports.array(external_exports.string()).optional().describe("Reference audio files for Seedance reference-to-video"),
@@ -68464,7 +68648,7 @@ var init_generate2 = __esm({
         ratio: external_exports.string().optional().describe("Aspect ratio: 16:9, 9:16, 1:1 (default: 16:9)"),
         mode: external_exports.string().optional().describe("Kling mode: std or pro"),
         negative: external_exports.string().optional().describe("Negative prompt (Seedance/Kling/Veo)"),
-        resolution: external_exports.string().optional().describe("Resolution: 720p, 1080p, 4k (Veo only)"),
+        resolution: external_exports.string().optional().describe("Resolution: 480p, 720p, 1080p, or 4k depending on provider"),
         veoModel: external_exports.string().optional().describe("Veo model: 3.0, 3.1, 3.1-fast"),
         runwayModel: external_exports.string().optional().describe("Runway model: gen4.5, gen4_turbo"),
         seedanceModel: external_exports.string().optional().describe("Seedance variant: quality or fast (fal.ai only)"),
@@ -71702,7 +71886,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.105.2",
+  version: "0.106.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -72801,7 +72985,14 @@ init_scene_inspect();
 init_render_inspect();
 import { readFile as readFile29, writeFile as writeFile36 } from "node:fs/promises";
 import { resolve as resolve42 } from "node:path";
-var VALID_RENDER_AI_MODELS = ["flash", "flash-2.5", "pro"];
+var VALID_RENDER_AI_MODELS = [
+  "flash",
+  "latest",
+  "flash-3",
+  "flash-2.5",
+  "pro",
+  "pro-3.1"
+];
 var inspectCommand = new Command("inspect").description("Inspect projects, renders, and media").addHelpText(
   "after",
   `
@@ -72866,7 +73057,7 @@ inspectCommand.command("project").description(
   }
 });
 applyTier(inspectCommand.commands[inspectCommand.commands.length - 1], "free");
-inspectCommand.command("render").description("Inspect a rendered project video with local checks and optional Gemini review").argument("[project-dir]", "VibeFrame project directory", ".").option("--cheap", "Run local checks only (default; no AI/API calls)").option("--ai", "Also run Gemini video review and merge findings into review-report.json").option("-m, --model <model>", "Gemini model for --ai: flash (default), flash-2.5, pro", "flash").option("--beat <id>", "Inspect a render for one storyboard beat").option(
+inspectCommand.command("render").description("Inspect a rendered project video with local checks and optional Gemini review").argument("[project-dir]", "VibeFrame project directory", ".").option("--cheap", "Run local checks only (default; no AI/API calls)").option("--ai", "Also run Gemini video review and merge findings into review-report.json").option("-m, --model <model>", `Gemini model for --ai: ${GEMINI_TEXT_MODEL_HELP}`, "flash").option("--beat <id>", "Inspect a render for one storyboard beat").option(
   "--video <path>",
   "Rendered video path. Defaults to build-report outputPath or latest renders/* video."
 ).option(
@@ -72931,7 +73122,7 @@ inspectCommand.command("render").description("Inspect a rendered project video w
   }
 });
 applyTier(inspectCommand.commands[inspectCommand.commands.length - 1], "low");
-inspectCommand.command("media").description("Analyze any media: images, videos, or YouTube URLs using Gemini").argument("<source>", "Image/video file path, image URL, or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Describe this image', 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second for video (default: 1)").option("--start <seconds>", "Start offset in seconds (video only)").option("--end <seconds>", "End offset in seconds (video only)").option("--low-res", "Use low resolution mode (fewer tokens)").option("--verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").option("--dry-run", "Preview parameters without executing").action(async (source, prompt3, options) => {
+inspectCommand.command("media").description("Analyze any media: images, videos, or YouTube URLs using Gemini").argument("<source>", "Image/video file path, image URL, or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Describe this image', 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", `Model: ${GEMINI_TEXT_MODEL_HELP}`, "flash").option("--fps <number>", "Frames per second for video (default: 1)").option("--start <seconds>", "Start offset in seconds (video only)").option("--end <seconds>", "End offset in seconds (video only)").option("--low-res", "Use low resolution mode (fewer tokens)").option("--verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").option("--dry-run", "Preview parameters without executing").action(async (source, prompt3, options) => {
   const startedAt = Date.now();
   try {
     rejectControlChars(prompt3);
@@ -73034,14 +73225,17 @@ function printInspectSummary(title, status, score, issues, reportPath) {
   }
 }
 function parseRenderAiModel(value) {
-  if (VALID_RENDER_AI_MODELS.includes(value)) {
+  if (isGeminiTextModelAlias(value) || value.startsWith("gemini-")) {
     return value;
   }
   exitWithError(
-    usageError(`Invalid --model: ${value}`, `Must be one of: ${VALID_RENDER_AI_MODELS.join(", ")}`)
+    usageError(
+      `Invalid --model: ${value}`,
+      `Must be one of: ${VALID_RENDER_AI_MODELS.join(", ")}, or a full gemini-* model ID`
+    )
   );
 }
-inspectCommand.command("video", { hidden: true }).description("Analyze video using Gemini (summarize, Q&A, extract info)").argument("<source>", "Video file path or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second (default: 1, higher for action)").option("--start <seconds>", "Start offset in seconds (for clipping)").option("--end <seconds>", "End offset in seconds (for clipping)").option("--low-res", "Use low resolution mode (fewer tokens, longer videos)").option("--verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").option("--dry-run", "Preview parameters without executing").action(async (source, prompt3, options) => {
+inspectCommand.command("video", { hidden: true }).description("Analyze video using Gemini (summarize, Q&A, extract info)").argument("<source>", "Video file path or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", `Model: ${GEMINI_TEXT_MODEL_HELP}`, "flash").option("--fps <number>", "Frames per second (default: 1, higher for action)").option("--start <seconds>", "Start offset in seconds (for clipping)").option("--end <seconds>", "End offset in seconds (for clipping)").option("--low-res", "Use low resolution mode (fewer tokens, longer videos)").option("--verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").option("--dry-run", "Preview parameters without executing").action(async (source, prompt3, options) => {
   const startedAt = Date.now();
   try {
     rejectControlChars(prompt3);