@vibeframe/cli 0.105.1 → 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,36 @@ var init_gemini_storyboard = __esm({
   "../ai-providers/dist/gemini/gemini-storyboard.js"() {
     "use strict";
     init_storyboard_prompt();
+    init_gemini_models();
+  }
+});
+
+// ../ai-providers/dist/shared/http.js
+async function fetchJson(label, url, init) {
+  const response = await fetch(url, init);
+  if (!response.ok) {
+    throw new ProviderHttpError(label, response.status, await response.text());
+  }
+  return await response.json();
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : "Unknown error";
+}
+function sleep(ms) {
+  return new Promise((resolve81) => setTimeout(resolve81, ms));
+}
+var ProviderHttpError;
+var init_http = __esm({
+  "../ai-providers/dist/shared/http.js"() {
+    "use strict";
+    ProviderHttpError = class extends Error {
+      constructor(label, status, body) {
+        super(`${label} (${status}): ${body}`);
+        this.name = "ProviderHttpError";
+        this.status = status;
+        this.body = body;
+      }
+    };
   }
 });
 
@@ -7795,7 +7867,9 @@ 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 = {
       "flash": "gemini-2.5-flash-image",
       "3.1-flash": "gemini-3.1-flash-image-preview",
@@ -7890,7 +7964,7 @@ var init_GeminiProvider = __esm({
             instances: [instance],
             parameters
           };
-          const response = await fetch(`${this.baseUrl}/models/${model}:predictLongRunning`, {
+          const data = await fetchJson("Veo API error", `${this.baseUrl}/models/${model}:predictLongRunning`, {
             method: "POST",
             headers: {
               "Content-Type": "application/json",
@@ -7898,15 +7972,6 @@ var init_GeminiProvider = __esm({
             },
             body: JSON.stringify(requestBody)
           });
-          if (!response.ok) {
-            const errorText = await response.text();
-            return {
-              id: "",
-              status: "failed",
-              error: `Veo API error (${response.status}): ${errorText}`
-            };
-          }
-          const data = await response.json();
           if (data.name) {
             return {
               id: data.name,
@@ -7931,7 +7996,7 @@ var init_GeminiProvider = __esm({
           return {
             id: "",
             status: "failed",
-            error: error instanceof Error ? error.message : "Unknown error"
+            error: errorMessage(error)
           };
         }
       }
@@ -7947,21 +8012,12 @@ var init_GeminiProvider = __esm({
           };
         }
         try {
-          const response = await fetch(`https://generativelanguage.googleapis.com/v1beta/${operationName}?key=${this.apiKey}`, {
+          const data = await fetchJson("Status check failed", `https://generativelanguage.googleapis.com/v1beta/${operationName}?key=${this.apiKey}`, {
             method: "GET",
             headers: {
               "Content-Type": "application/json"
             }
           });
-          if (!response.ok) {
-            const errorText = await response.text();
-            return {
-              id: operationName,
-              status: "failed",
-              error: `Status check failed (${response.status}): ${errorText}`
-            };
-          }
-          const data = await response.json();
           if (data.error) {
             return {
               id: operationName,
@@ -7994,7 +8050,7 @@ var init_GeminiProvider = __esm({
           return {
             id: operationName,
             status: "failed",
-            error: error instanceof Error ? error.message : "Unknown error"
+            error: errorMessage(error)
           };
         }
       }
@@ -8012,7 +8068,7 @@ var init_GeminiProvider = __esm({
           if (result.status === "completed" || result.status === "failed" || result.status === "cancelled") {
             return result;
           }
-          await this.sleep(pollingInterval);
+          await sleep(pollingInterval);
         }
         return {
           id: operationName,
@@ -8020,12 +8076,6 @@ var init_GeminiProvider = __esm({
           error: "Generation timed out"
         };
       }
-      /**
-       * Sleep helper
-       */
-      sleep(ms) {
-        return new Promise((resolve81) => setTimeout(resolve81, ms));
-      }
       /**
        * Extend a previously generated Veo video
        * Uses the operation name from a completed generation to create a continuation
@@ -8052,7 +8102,7 @@ var init_GeminiProvider = __esm({
               durationSeconds: Math.max(4, Math.min(8, options?.duration || 6))
             }
           };
-          const response = await fetch(`${this.baseUrl}/models/${model}:predictLongRunning`, {
+          const data = await fetchJson("Veo extend API error", `${this.baseUrl}/models/${model}:predictLongRunning`, {
             method: "POST",
             headers: {
               "Content-Type": "application/json",
@@ -8060,15 +8110,6 @@ var init_GeminiProvider = __esm({
             },
             body: JSON.stringify(requestBody)
           });
-          if (!response.ok) {
-            const errorText = await response.text();
-            return {
-              id: "",
-              status: "failed",
-              error: `Veo extend API error (${response.status}): ${errorText}`
-            };
-          }
-          const data = await response.json();
           if (data.name) {
             return {
               id: data.name,
@@ -8085,7 +8126,7 @@ var init_GeminiProvider = __esm({
           return {
             id: "",
             status: "failed",
-            error: error instanceof Error ? error.message : "Unknown error"
+            error: errorMessage(error)
           };
         }
       }
@@ -8157,16 +8198,16 @@ var init_GeminiProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.error?.message || errorText;
+              errorMessage2 = errorData.error?.message || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               success: false,
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const data = await response.json();
@@ -8269,16 +8310,16 @@ var init_GeminiProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.error?.message || errorText;
+              errorMessage2 = errorData.error?.message || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               success: false,
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const data = await response.json();
@@ -8335,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") {
@@ -8394,16 +8435,16 @@ var init_GeminiProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.error?.message || errorText;
+              errorMessage2 = errorData.error?.message || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               success: false,
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const data = await response.json();
@@ -8442,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) => ({
@@ -8476,16 +8517,16 @@ var init_GeminiProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.error?.message || errorText;
+              errorMessage2 = errorData.error?.message || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               success: false,
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const data = await response.json();
@@ -8544,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"
@@ -8666,6 +8707,7 @@ var init_gemini = __esm({
     "use strict";
     init_GeminiProvider();
     init_gemini_motion();
+    init_gemini_models();
     init_define_provider();
     defineProvider({
       id: "gemini",
@@ -11718,20 +11760,20 @@ var init_OpenAIImageProvider = __esm({
           if (!response.ok) {
             const errorText = await response.text();
             console.error("OpenAI Image API error:", errorText);
-            let errorMessage = `API error: ${response.status}`;
+            let errorMessage2 = `API error: ${response.status}`;
             try {
               const errorJson = JSON.parse(errorText);
               if (errorJson.error?.message) {
-                errorMessage = errorJson.error.message;
+                errorMessage2 = errorJson.error.message;
               }
             } catch {
               if (errorText) {
-                errorMessage = errorText.substring(0, 200);
+                errorMessage2 = errorText.substring(0, 200);
               }
             }
             return {
               success: false,
-              error: errorMessage
+              error: errorMessage2
             };
           }
           const data = await response.json();
@@ -11826,20 +11868,20 @@ var init_OpenAIImageProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage = `API error: ${response.status}`;
+            let errorMessage2 = `API error: ${response.status}`;
             try {
               const errorJson = JSON.parse(errorText);
               if (errorJson.error?.message) {
-                errorMessage = errorJson.error.message;
+                errorMessage2 = errorJson.error.message;
               }
             } catch {
               if (errorText) {
-                errorMessage = errorText.substring(0, 200);
+                errorMessage2 = errorText.substring(0, 200);
               }
             }
             return {
               success: false,
-              error: errorMessage
+              error: errorMessage2
             };
           }
           const data = await response.json();
@@ -11996,12 +12038,12 @@ var init_RunwayProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.error || errorData.message || errorText;
+              errorMessage2 = errorData.error || errorData.message || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             console.error(`[Runway] POST /${endpoint} -> ${response.status} ${response.statusText}
   Model: ${model}, Ratio: ${apiRatio}, Duration: ${body.duration}
@@ -12009,7 +12051,7 @@ var init_RunwayProvider = __esm({
             return {
               id: "",
               status: "failed",
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const data = await response.json();
@@ -12381,17 +12423,17 @@ var init_KlingProvider = __esm({
       async handleResponse(response) {
         if (!response.ok) {
           const errorText = await response.text();
-          let errorMessage;
+          let errorMessage2;
           try {
             const errorData = JSON.parse(errorText);
-            errorMessage = errorData.message || errorData.error || errorText;
+            errorMessage2 = errorData.message || errorData.error || errorText;
           } catch {
-            errorMessage = errorText;
+            errorMessage2 = errorText;
           }
           return {
             id: "",
             status: "failed",
-            error: `API error (${response.status}): ${errorMessage}`
+            error: `API error (${response.status}): ${errorMessage2}`
           };
         }
         const data = await response.json();
@@ -12720,20 +12762,20 @@ var init_GrokProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage = `API error: ${response.status}`;
+            let errorMessage2 = `API error: ${response.status}`;
             try {
               const errorJson = JSON.parse(errorText);
               if (errorJson.error?.message) {
-                errorMessage = errorJson.error.message;
+                errorMessage2 = errorJson.error.message;
               }
             } catch {
               if (errorText) {
-                errorMessage = errorText.substring(0, 200);
+                errorMessage2 = errorText.substring(0, 200);
               }
             }
             return {
               success: false,
-              error: errorMessage
+              error: errorMessage2
             };
           }
           const data = await response.json();
@@ -12788,20 +12830,20 @@ var init_GrokProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage = `API error: ${response.status}`;
+            let errorMessage2 = `API error: ${response.status}`;
             try {
               const errorJson = JSON.parse(errorText);
               if (errorJson.error?.message) {
-                errorMessage = errorJson.error.message;
+                errorMessage2 = errorJson.error.message;
               }
             } catch {
               if (errorText) {
-                errorMessage = errorText.substring(0, 200);
+                errorMessage2 = errorText.substring(0, 200);
               }
             }
             return {
               success: false,
-              error: errorMessage
+              error: errorMessage2
             };
           }
           const data = await response.json();
@@ -13255,7 +13297,7 @@ var require_utils = __commonJS({
     exports.throttle = throttle;
     exports.isReact = isReact;
     exports.isPlainObject = isPlainObject;
-    exports.sleep = sleep3;
+    exports.sleep = sleep4;
     function ensureEndpointIdFormat(id) {
       const parts = id.split("/");
       if (parts.length > 1) {
@@ -13333,7 +13375,7 @@ var require_utils = __commonJS({
     function isPlainObject(value) {
       return !!value && Object.getPrototypeOf(value) === Object.prototype;
     }
-    function sleep3(ms) {
+    function sleep4(ms) {
       return __awaiter(this, void 0, void 0, function* () {
         return new Promise((resolve81) => setTimeout(resolve81, ms));
       });
@@ -17099,6 +17141,39 @@ var require_src = __commonJS({
 });
 
 // ../ai-providers/dist/fal/FalProvider.js
+function formatFalError(error) {
+  if (!(error instanceof Error))
+    return String(error);
+  const parts = [error.message];
+  const details = falErrorDetails(error);
+  if (details)
+    parts.push(details);
+  return parts.join(" - ");
+}
+function falErrorDetails(error) {
+  const withBody = error;
+  const items = [];
+  if (typeof withBody.status === "number")
+    items.push(`HTTP ${withBody.status}`);
+  if (withBody.requestId)
+    items.push(`request ${withBody.requestId}`);
+  if (Array.isArray(withBody.fieldErrors) && withBody.fieldErrors.length > 0) {
+    items.push(withBody.fieldErrors.map((fieldError) => {
+      const path2 = Array.isArray(fieldError.loc) ? fieldError.loc.join(".") : "body";
+      return `${path2}: ${fieldError.msg ?? fieldError.type ?? "invalid"}`;
+    }).join("; "));
+  } else if (withBody.body !== void 0) {
+    items.push(safeJson(withBody.body));
+  }
+  return items.filter(Boolean).join(" - ") || void 0;
+}
+function safeJson(value) {
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
 function pickReferenceImageUrl(input) {
   if (typeof input !== "string")
     return void 0;
@@ -17295,7 +17370,7 @@ var init_FalProvider = __esm({
           return {
             id: "",
             status: "failed",
-            error: err instanceof Error ? err.message : String(err)
+            error: formatFalError(err)
           };
         }
       }
@@ -17394,17 +17469,17 @@ var init_ReplicateProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.detail || errorData.error || errorText;
+              errorMessage2 = errorData.detail || errorData.error || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               id: "",
               status: "failed",
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const prediction = await response.json();
@@ -17467,17 +17542,17 @@ var init_ReplicateProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.detail || errorData.error || errorText;
+              errorMessage2 = errorData.detail || errorData.error || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               id: "",
               status: "failed",
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const prediction = await response.json();
@@ -17635,16 +17710,16 @@ var init_ReplicateProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.detail || errorData.error || errorText;
+              errorMessage2 = errorData.detail || errorData.error || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               success: false,
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const prediction = await response.json();
@@ -17738,16 +17813,16 @@ var init_ReplicateProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.detail || errorData.error || errorText;
+              errorMessage2 = errorData.detail || errorData.error || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               success: false,
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const prediction = await response.json();
@@ -17849,17 +17924,17 @@ var init_ReplicateProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.detail || errorData.error || errorText;
+              errorMessage2 = errorData.detail || errorData.error || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               id: "",
               status: "failed",
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const prediction = await response.json();
@@ -17922,17 +17997,17 @@ var init_ReplicateProvider = __esm({
           });
           if (!response.ok) {
             const errorText = await response.text();
-            let errorMessage;
+            let errorMessage2;
             try {
               const errorData = JSON.parse(errorText);
-              errorMessage = errorData.detail || errorData.error || errorText;
+              errorMessage2 = errorData.detail || errorData.error || errorText;
             } catch {
-              errorMessage = errorText;
+              errorMessage2 = errorText;
             }
             return {
               id: "",
               status: "failed",
-              error: `API error (${response.status}): ${errorMessage}`
+              error: `API error (${response.status}): ${errorMessage2}`
             };
           }
           const prediction = await response.json();
@@ -17996,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,
@@ -18026,6 +18105,7 @@ __export(dist_exports2, {
   getProvidersFor: () => getProvidersFor,
   getSetupProviders: () => getSetupProviders,
   grokProvider: () => grokProvider,
+  isGeminiTextModelAlias: () => isGeminiTextModelAlias,
   klingProvider: () => klingProvider,
   kokoroProvider: () => kokoroProvider,
   ollamaProvider: () => ollamaProvider,
@@ -18033,6 +18113,7 @@ __export(dist_exports2, {
   openaiProvider: () => openaiProvider,
   providerRegistry: () => providerRegistry,
   replicateProvider: () => replicateProvider,
+  resolveGeminiTextModel: () => resolveGeminiTextModel,
   resolveVoiceId: () => resolveVoiceId,
   runwayProvider: () => runwayProvider,
   whisperProvider: () => whisperProvider
@@ -25793,6 +25874,7 @@ var config_exports = {};
 __export(config_exports, {
   CONFIG_DIR: () => CONFIG_DIR,
   CONFIG_PATH: () => CONFIG_PATH,
+  ConfigFileError: () => ConfigFileError,
   LEGACY_USER_CONFIG_DIR: () => LEGACY_USER_CONFIG_DIR,
   LEGACY_USER_CONFIG_PATH: () => LEGACY_USER_CONFIG_PATH,
   PROVIDER_ENV_ALIASES: () => PROVIDER_ENV_ALIASES,
@@ -25903,8 +25985,8 @@ async function readConfigFile(path2) {
     const content = await readFile2(path2, "utf-8");
     const parsed = (0, import_yaml.parse)(content);
     return applyDefaults(parsed);
-  } catch {
-    return null;
+  } catch (error) {
+    throw new ConfigFileError(path2, error);
   }
 }
 async function readUserConfigFile() {
@@ -25984,7 +26066,7 @@ async function updateProviderKey(providerKey, apiKey, options = {}) {
   config2.providers[providerKey] = apiKey;
   await saveConfig(config2, { scope, cwd: options.cwd });
 }
-var import_yaml, USER_CONFIG_DIR, USER_CONFIG_PATH, USER_DATA_DIR, USER_CACHE_DIR, LEGACY_USER_CONFIG_DIR, LEGACY_USER_CONFIG_PATH, CONFIG_DIR, CONFIG_PATH;
+var import_yaml, USER_CONFIG_DIR, USER_CONFIG_PATH, USER_DATA_DIR, USER_CACHE_DIR, LEGACY_USER_CONFIG_DIR, LEGACY_USER_CONFIG_PATH, CONFIG_DIR, CONFIG_PATH, ConfigFileError;
 var init_config = __esm({
   "src/config/index.ts"() {
     "use strict";
@@ -26003,6 +26085,16 @@ var init_config = __esm({
     LEGACY_USER_CONFIG_PATH = resolve4(LEGACY_USER_CONFIG_DIR, "config.yaml");
     CONFIG_DIR = USER_CONFIG_DIR;
     CONFIG_PATH = USER_CONFIG_PATH;
+    ConfigFileError = class extends Error {
+      path;
+      constructor(path2, cause) {
+        const detail = cause instanceof Error ? cause.message : String(cause);
+        super(`Failed to read VibeFrame config at ${path2}: ${detail}`);
+        this.name = "ConfigFileError";
+        this.path = path2;
+        this.cause = cause;
+      }
+    };
   }
 });
 
@@ -27430,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}`);
@@ -27450,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 });
@@ -27520,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";
@@ -27531,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`;
   }
 });
 
@@ -29566,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();
@@ -29587,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 {
@@ -30538,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;
@@ -30566,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");
@@ -30587,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
   };
@@ -30864,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 {
@@ -30895,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
             }
           }
@@ -30923,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;
           }
@@ -31987,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
       });
@@ -32156,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();
@@ -32300,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" }
     };
   }
@@ -33590,7 +33815,7 @@ var init_speech = __esm({
 // src/commands/_shared/video-utils.ts
 import { writeFile as writeFile19, unlink, rename } from "node:fs/promises";
 import { resolve as resolve22, basename as basename4 } from "node:path";
-function sleep(ms) {
+function sleep2(ms) {
   return new Promise((resolve81) => setTimeout(resolve81, ms));
 }
 async function uploadToImgbb(imageBuffer, apiKey) {
@@ -34811,7 +35036,7 @@ async function refreshMusicStatus(taskId, wait) {
   let result = await executeMusicStatus({ taskId });
   if (!wait) return result;
   for (let i = 0; i < 120 && result.success && result.status === "processing"; i++) {
-    await sleep2(5e3);
+    await sleep3(5e3);
     result = await executeMusicStatus({ taskId });
   }
   return result;
@@ -35229,7 +35454,7 @@ function unique(items) {
     ...new Set(items.filter((item) => typeof item === "string" && item.length > 0))
   ];
 }
-function sleep2(ms) {
+function sleep3(ms) {
   return new Promise((resolve81) => setTimeout(resolve81, ms));
 }
 var init_status_jobs = __esm({
@@ -35727,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
@@ -35781,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);
@@ -37936,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(
@@ -38397,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";
@@ -38409,7 +38652,8 @@ Examples:
           negativePrompt: options.negative,
           model: falModel,
           resolution: options.resolution,
-          generateAudio: options.generateAudio
+          generateAudio: options.generateAudio,
+          lastFrame: seedanceEndImage
         });
         finalResult = result;
       }
@@ -38719,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:
@@ -41630,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);
@@ -42720,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;
@@ -42786,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) {
@@ -42871,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;
@@ -42914,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;
@@ -43035,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.
 
 {
@@ -43147,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) {
@@ -44846,7 +45070,7 @@ async function generateVideoWithRetryGrok(grok, segment, options, maxRetries, on
         onProgress?.(
           `\u26A0 ${providerErr.slice(0, 50)}... retry ${attempt + 1}/${maxRetries}`
         );
-        await sleep(RETRY_DELAY_MS);
+        await sleep2(RETRY_DELAY_MS);
       } else {
         console.error(source_default.dim(`
   [Grok error: ${providerErr}]`));
@@ -44855,7 +45079,7 @@ async function generateVideoWithRetryGrok(grok, segment, options, maxRetries, on
       const errMsg = err instanceof Error ? err.message : String(err);
       if (attempt < maxRetries) {
         onProgress?.(`\u26A0 Error: ${errMsg.slice(0, 50)}... retry ${attempt + 1}/${maxRetries}`);
-        await sleep(RETRY_DELAY_MS);
+        await sleep2(RETRY_DELAY_MS);
       } else {
         console.error(source_default.dim(`
   [Grok error: ${errMsg}]`));
@@ -44886,7 +45110,7 @@ async function generateVideoWithRetryKling(kling, segment, options, maxRetries,
       const providerErr = result.error || "Kling returned failed status";
       if (attempt < maxRetries) {
         onProgress?.(`\u26A0 ${providerErr.slice(0, 50)}... retry ${attempt + 1}/${maxRetries}`);
-        await sleep(RETRY_DELAY_MS);
+        await sleep2(RETRY_DELAY_MS);
       } else {
         console.error(source_default.dim(`
   [Kling error: ${providerErr}]`));
@@ -44895,7 +45119,7 @@ async function generateVideoWithRetryKling(kling, segment, options, maxRetries,
       const errMsg = err instanceof Error ? err.message : String(err);
       if (attempt < maxRetries) {
         onProgress?.(`\u26A0 Error: ${errMsg.slice(0, 50)}... retry ${attempt + 1}/${maxRetries}`);
-        await sleep(RETRY_DELAY_MS);
+        await sleep2(RETRY_DELAY_MS);
       } else {
         console.error(source_default.dim(`
   [Kling error: ${errMsg}]`));
@@ -44919,7 +45143,7 @@ async function generateVideoWithRetryRunway(runway, segment, referenceImage, opt
       const providerErr = result.error || "Runway returned failed status";
       if (attempt < maxRetries) {
         onProgress?.(`\u26A0 ${providerErr.slice(0, 50)}... retry ${attempt + 1}/${maxRetries}`);
-        await sleep(RETRY_DELAY_MS);
+        await sleep2(RETRY_DELAY_MS);
       } else {
         console.error(source_default.dim(`
   [Runway error: ${providerErr}]`));
@@ -44928,7 +45152,7 @@ async function generateVideoWithRetryRunway(runway, segment, referenceImage, opt
       const errMsg = err instanceof Error ? err.message : String(err);
       if (attempt < maxRetries) {
         onProgress?.(`\u26A0 Error: ${errMsg.slice(0, 50)}... retry ${attempt + 1}/${maxRetries}`);
-        await sleep(RETRY_DELAY_MS);
+        await sleep2(RETRY_DELAY_MS);
       } else {
         console.error(source_default.dim(`
   [Runway error: ${errMsg}]`));
@@ -44954,7 +45178,7 @@ async function generateVideoWithRetryVeo(gemini, segment, options, maxRetries, o
       const providerErr = result.error || "Veo returned failed status";
       if (attempt < maxRetries) {
         onProgress?.(`\u26A0 ${providerErr.slice(0, 50)}... retry ${attempt + 1}/${maxRetries}`);
-        await sleep(RETRY_DELAY_MS);
+        await sleep2(RETRY_DELAY_MS);
       } else {
         console.error(source_default.dim(`
   [Veo error: ${providerErr}]`));
@@ -44963,7 +45187,7 @@ async function generateVideoWithRetryVeo(gemini, segment, options, maxRetries, o
       const errMsg = err instanceof Error ? err.message : String(err);
       if (attempt < maxRetries) {
         onProgress?.(`\u26A0 Error: ${errMsg.slice(0, 50)}... retry ${attempt + 1}/${maxRetries}`);
-        await sleep(RETRY_DELAY_MS);
+        await sleep2(RETRY_DELAY_MS);
       } else {
         console.error(source_default.dim(`
   [Veo error: ${errMsg}]`));
@@ -59912,6 +60136,20 @@ var init_scene_render = __esm({
   }
 });
 
+// src/commands/_shared/scene-build-mode.ts
+function resolveSceneBuildMode(opts) {
+  const env2 = process.env.VIBE_BUILD_MODE?.trim().toLowerCase();
+  if (env2 === "agent" || env2 === "batch") return env2;
+  if (opts.mode === "agent" || opts.mode === "batch") return opts.mode;
+  return detectedAgentHosts().length > 0 ? "agent" : "batch";
+}
+var init_scene_build_mode = __esm({
+  "src/commands/_shared/scene-build-mode.ts"() {
+    "use strict";
+    init_agent_host_detect();
+  }
+});
+
 // src/commands/_shared/scene-build.ts
 var scene_build_exports = {};
 __export(scene_build_exports, {
@@ -61622,14 +61860,6 @@ function rootSyncBeatsFromOutcomes(beats, outcomes) {
     };
   });
 }
-function resolveSceneBuildMode(opts) {
-  const envOverride = process.env.VIBE_BUILD_MODE?.toLowerCase();
-  if (envOverride === "agent" || envOverride === "batch") return envOverride;
-  const requested = opts.mode ?? "auto";
-  if (requested === "agent") return "agent";
-  if (requested === "batch") return "batch";
-  return detectedAgentHosts().length > 0 ? "agent" : "batch";
-}
 async function resolveBeatDuration(opts) {
   const storyboardMin = opts.beatDuration ?? 3;
   if (!opts.narrationPath) return Number(storyboardMin.toFixed(2));
@@ -61649,7 +61879,6 @@ var init_scene_build = __esm({
     init_audio();
     init_compose_scenes_skills();
     init_compose_prompts();
-    init_agent_host_detect();
     init_config();
     init_scene_render();
     init_storyboard_parse();
@@ -61665,6 +61894,8 @@ var init_scene_build = __esm({
     init_status_jobs();
     init_scene_repair();
     init_tts_resolve();
+    init_scene_build_mode();
+    init_scene_build_mode();
   }
 });
 
@@ -62979,15 +63210,15 @@ var init_parseUtil = __esm({
           message: issueData.message
         };
       }
-      let errorMessage = "";
+      let errorMessage2 = "";
       const maps = errorMaps.filter((m) => !!m).slice().reverse();
       for (const map of maps) {
-        errorMessage = map(fullIssue, { data, defaultError: errorMessage }).message;
+        errorMessage2 = map(fullIssue, { data, defaultError: errorMessage2 }).message;
       }
       return {
         ...issueData,
         path: fullPath,
-        message: errorMessage
+        message: errorMessage2
       };
     };
     EMPTY_PATH = [];
@@ -67566,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"),
@@ -67942,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) {
@@ -67994,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"),
@@ -68022,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"),
@@ -68052,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) {
@@ -68144,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) {
@@ -68409,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"),
@@ -68416,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)"),
@@ -69631,10 +69863,10 @@ async function runExport(projectPath, outputPath, options = {}) {
       outputPath: finalOutputPath
     };
   } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
+    const errorMessage2 = error instanceof Error ? error.message : String(error);
     return {
       success: false,
-      message: `Export failed: ${errorMessage}`
+      message: `Export failed: ${errorMessage2}`
     };
   }
 }
@@ -71654,7 +71886,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.105.1",
+  version: "0.106.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -71687,128 +71919,28 @@ var package_default = {
   ],
   exports: {
     ".": {
-      import: "./src/index.ts",
-      types: "./src/index.ts"
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js"
     },
     "./engine": {
-      import: "./src/engine/index.ts",
-      types: "./src/engine/index.ts"
-    },
-    "./agent": {
-      import: "./src/agent/index.ts",
-      types: "./src/agent/index.ts"
+      types: "./dist/engine/index.d.ts",
+      import: "./dist/engine/index.js"
     },
     "./tools/manifest": {
-      import: "./src/tools/manifest/index.ts",
-      types: "./src/tools/manifest/index.ts"
+      types: "./dist/tools/manifest/index.d.ts",
+      import: "./dist/tools/manifest/index.js"
     },
     "./tools/define-tool": {
-      import: "./src/tools/define-tool.ts",
-      types: "./src/tools/define-tool.ts"
+      types: "./dist/tools/define-tool.d.ts",
+      import: "./dist/tools/define-tool.js"
     },
     "./tools/adapters/mcp": {
-      import: "./src/tools/adapters/mcp.ts",
-      types: "./src/tools/adapters/mcp.ts"
+      types: "./dist/tools/adapters/mcp.d.ts",
+      import: "./dist/tools/adapters/mcp.js"
     },
     "./tools/adapters/agent": {
-      import: "./src/tools/adapters/agent.ts",
-      types: "./src/tools/adapters/agent.ts"
-    },
-    "./commands/export": {
-      import: "./src/commands/export.ts",
-      types: "./src/commands/export.ts"
-    },
-    "./commands/ai-edit": {
-      import: "./src/commands/ai-edit.ts",
-      types: "./src/commands/ai-edit.ts"
-    },
-    "./commands/ai-analyze": {
-      import: "./src/commands/ai-analyze.ts",
-      types: "./src/commands/ai-analyze.ts"
-    },
-    "./commands/ai-review": {
-      import: "./src/commands/ai-review.ts",
-      types: "./src/commands/ai-review.ts"
-    },
-    "./commands/ai-image": {
-      import: "./src/commands/ai-image.ts",
-      types: "./src/commands/ai-image.ts"
-    },
-    "./commands/ai-script-pipeline": {
-      import: "./src/commands/ai-script-pipeline.ts",
-      types: "./src/commands/ai-script-pipeline.ts"
-    },
-    "./commands/ai-highlights": {
-      import: "./src/commands/ai-highlights.ts",
-      types: "./src/commands/ai-highlights.ts"
-    },
-    "./commands/ai-narrate": {
-      import: "./src/commands/ai-narrate.ts",
-      types: "./src/commands/ai-narrate.ts"
-    },
-    "./commands/ai-motion": {
-      import: "./src/commands/ai-motion.ts",
-      types: "./src/commands/ai-motion.ts"
-    },
-    "./commands/ai-animated-caption": {
-      import: "./src/commands/ai-animated-caption.ts",
-      types: "./src/commands/ai-animated-caption.ts"
-    },
-    "./commands/detect": {
-      import: "./src/commands/detect.ts",
-      types: "./src/commands/detect.ts"
-    },
-    "./commands/generate": {
-      import: "./src/commands/generate.ts",
-      types: "./src/commands/generate.ts"
-    },
-    "./commands/ai-video": {
-      import: "./src/commands/ai-video.ts",
-      types: "./src/commands/ai-video.ts"
-    },
-    "./commands/ai-audio": {
-      import: "./src/commands/ai-audio.ts",
-      types: "./src/commands/ai-audio.ts"
-    },
-    "./commands/edit-cmd": {
-      import: "./src/commands/edit-cmd.ts",
-      types: "./src/commands/edit-cmd.ts"
-    },
-    "./commands/scene": {
-      import: "./src/commands/scene.ts",
-      types: "./src/commands/scene.ts"
-    },
-    "./commands/_shared/scene-project": {
-      import: "./src/commands/_shared/scene-project.ts",
-      types: "./src/commands/_shared/scene-project.ts"
-    },
-    "./commands/_shared/scene-lint": {
-      import: "./src/commands/_shared/scene-lint.ts",
-      types: "./src/commands/_shared/scene-lint.ts"
-    },
-    "./commands/_shared/scene-render": {
-      import: "./src/commands/_shared/scene-render.ts",
-      types: "./src/commands/_shared/scene-render.ts"
-    },
-    "./commands/_shared/scene-html-emit": {
-      import: "./src/commands/_shared/scene-html-emit.ts",
-      types: "./src/commands/_shared/scene-html-emit.ts"
-    },
-    "./commands/_shared/scene-build": {
-      import: "./src/commands/_shared/scene-build.ts",
-      types: "./src/commands/_shared/scene-build.ts"
-    },
-    "./commands/_shared/visual-styles": {
-      import: "./src/commands/_shared/visual-styles.ts",
-      types: "./src/commands/_shared/visual-styles.ts"
-    },
-    "./commands/ai-suggest-edit": {
-      import: "./src/commands/ai-suggest-edit.ts",
-      types: "./src/commands/ai-suggest-edit.ts"
-    },
-    "./pipeline": {
-      import: "./src/pipeline/index.ts",
-      types: "./src/pipeline/index.ts"
+      types: "./dist/tools/adapters/agent.d.ts",
+      import: "./dist/tools/adapters/agent.js"
     }
   },
   scripts: {
@@ -72853,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",
   `
@@ -72918,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(
@@ -72983,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);
@@ -73086,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);
@@ -79502,7 +79644,7 @@ async function runSetupWizard(fullSetup = false, scope = "user") {
   const userStatus = scope === "user" ? await getUserConfigStatus() : null;
   const displayPath2 = scope === "user" ? userStatus?.source === "legacy" ? userStatus.configPath : USER_CONFIG_PATH : getConfigPath(scope);
   const cfgPath = displayPath2.replace(homedir5(), "~");
-  const scopeNote = scope === "project" ? "applies to this project only \xB7 add .vibeframe/ to .gitignore" : "applies to every project for this user";
+  const scopeNote = scope === "project" ? "applies to this project only \xB7 user config is ignored while this file exists \xB7 add .vibeframe/ to .gitignore" : "applies to every project for this user";
   console.log(source_default.bold.magenta("VibeFrame Setup") + source_default.bold(` \u2014 ${scope} scope`));
   console.log(source_default.dim(`${cfgPath} \xB7 ${scopeNote}`));
   if (userStatus?.source === "legacy") {
@@ -82315,7 +82457,7 @@ init_api_key();
 init_agent_host_detect();
 init_composer_resolve();
 init_cost_tier();
-init_scene_build();
+init_scene_build_mode();
 init_output();
 import { existsSync as existsSync48 } from "node:fs";
 import { resolve as resolve66 } from "node:path";
@@ -82479,7 +82621,14 @@ async function runDiagnostics() {
   const userConfig = await getUserConfigStatus();
   const configExists = userConfig.configured;
   const cwd = process.cwd();
-  const activeConfig = await loadConfig({ cwd });
+  let activeConfig = null;
+  let configError;
+  try {
+    activeConfig = await loadConfig({ cwd });
+  } catch (err) {
+    if (!(err instanceof ConfigFileError)) throw err;
+    configError = { path: err.path, message: err.message };
+  }
   const providers = {};
   let readyCount = FREE_COMMANDS.length;
   let totalCount = FREE_COMMANDS.length;
@@ -82528,7 +82677,11 @@ async function runDiagnostics() {
         ok: ffmpegExists,
         ...ffmpegFilters ? { filters: ffmpegFilters } : {}
       },
-      config: { path: userConfig.configPath, ok: configExists },
+      config: {
+        path: userConfig.configPath,
+        ok: (configExists || projectConfigExists) && !configError,
+        ...configError ? { error: configError } : {}
+      },
       ...Object.keys(optionalTools).length > 0 ? { optionalTools } : {}
     },
     scope: {
@@ -82554,7 +82707,8 @@ async function runDiagnostics() {
         composerEnvVar: composerEnv,
         sceneProjectInCwd,
         skillInstalled
-      }
+      },
+      ...configError ? { configError } : {}
     },
     providers,
     readyCount,
@@ -82626,10 +82780,12 @@ function printReport(results, opts = { verbose: false }) {
   const userActive = results.scope.activeScope === "user" && results.scope.user.configured;
   const projectActive = results.scope.activeScope === "project";
   const activeMark = source_default.cyan(" \u2190 active");
+  const configErrorPath = results.scope.configError?.path;
   if (results.scope.user.configured) {
     const userPath = results.scope.user.source === "legacy" ? `${results.scope.user.configPath} ${source_default.dim(`(legacy; writes ${results.scope.user.writePath})`)}` : results.scope.user.configPath;
+    const invalid = configErrorPath === results.scope.user.configPath;
     console.log(
-      `    Cfg(user)  ${source_default.green("OK")}       ${source_default.dim(userPath)}${userActive ? activeMark : ""}`
+      `    Cfg(user)  ${invalid ? source_default.red("INVALID") : source_default.green("OK")}  ${source_default.dim(userPath)}${userActive ? activeMark : ""}`
     );
   } else {
     console.log(
@@ -82637,14 +82793,23 @@ function printReport(results, opts = { verbose: false }) {
     );
   }
   if (results.scope.project.configFileExists) {
+    const invalid = configErrorPath === results.scope.project.configPath;
     console.log(
-      `    Cfg(proj)  ${source_default.green("OK")}       ${source_default.dim(results.scope.project.configPath)}${projectActive ? activeMark : ""}`
+      `    Cfg(proj)  ${invalid ? source_default.red("INVALID") : source_default.green("OK")}  ${source_default.dim(results.scope.project.configPath)}${projectActive ? activeMark : ""}`
     );
+    if (projectActive) {
+      console.log(
+        `               ${source_default.dim("project scope is isolated; user config is ignored while this file exists")}`
+      );
+    }
   } else {
     console.log(
       `    Cfg(proj)  ${source_default.dim("none")}     ${source_default.dim(`Run: vibe setup --scope project  (cwd: ${results.scope.project.cwd})`)}`
     );
   }
+  if (results.scope.configError) {
+    console.log(`    Cfg error  ${source_default.red(results.scope.configError.message)}`);
+  }
   if (results.scope.project.initialized) {
     const present = results.scope.project.files.filter((f) => f.exists).map((f) => f.path);
     console.log(`    Init       ${source_default.green("OK")}       ${source_default.dim(present.join(", "))}`);
@@ -82810,7 +82975,12 @@ async function runLiveKeyTests(results) {
     return;
   }
   const { testKey: testKey2 } = await Promise.resolve().then(() => (init_key_live_test(), key_live_test_exports));
-  const activeConfig = await loadConfig({ cwd: process.cwd() });
+  let activeConfig = null;
+  try {
+    activeConfig = await loadConfig({ cwd: process.cwd() });
+  } catch (err) {
+    if (!(err instanceof ConfigFileError)) throw err;
+  }
   for (const [name, info] of configured) {
     const value = process.env[info.envVar] || PROVIDER_ENV_ALIASES[info.envVar]?.map((alias) => process.env[alias]).find(Boolean) || activeConfig?.providers[name];
     if (!value) continue;
@@ -83506,12 +83676,12 @@ var ToolRegistry = class {
     try {
       return await tool.handler(args, context);
     } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
+      const errorMessage2 = error instanceof Error ? error.message : String(error);
       return {
         toolCallId: "",
         success: false,
         output: "",
-        error: errorMessage
+        error: errorMessage2
       };
     }
   }