@vibeframe/cli 0.104.3 → 0.105.2

package/dist/index.js

@@ -7789,6 +7789,35 @@ var init_gemini_storyboard = __esm({
   }
 });
 
+// ../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;
+      }
+    };
+  }
+});
+
 // ../ai-providers/dist/gemini/GeminiProvider.js
 var MODEL_MAP, GeminiProvider, geminiProvider;
 var init_GeminiProvider = __esm({
@@ -7796,6 +7825,7 @@ var init_GeminiProvider = __esm({
     "use strict";
     init_gemini_motion();
     init_gemini_storyboard();
+    init_http();
     MODEL_MAP = {
       "flash": "gemini-2.5-flash-image",
       "3.1-flash": "gemini-3.1-flash-image-preview",
@@ -7890,7 +7920,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 +7928,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 +7952,7 @@ var init_GeminiProvider = __esm({
           return {
             id: "",
             status: "failed",
-            error: error instanceof Error ? error.message : "Unknown error"
+            error: errorMessage(error)
           };
         }
       }
@@ -7947,21 +7968,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 +8006,7 @@ var init_GeminiProvider = __esm({
           return {
             id: operationName,
             status: "failed",
-            error: error instanceof Error ? error.message : "Unknown error"
+            error: errorMessage(error)
           };
         }
       }
@@ -8012,7 +8024,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 +8032,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 +8058,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 +8066,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 +8082,7 @@ var init_GeminiProvider = __esm({
           return {
             id: "",
             status: "failed",
-            error: error instanceof Error ? error.message : "Unknown error"
+            error: errorMessage(error)
           };
         }
       }
@@ -8157,16 +8154,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 +8266,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();
@@ -8394,16 +8391,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();
@@ -8476,16 +8473,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();
@@ -11718,20 +11715,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 +11823,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 +11993,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 +12006,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 +12378,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 +12717,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 +12785,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 +13252,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 +13330,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 +17096,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;
@@ -17106,6 +17136,53 @@ function pickReferenceImageUrl(input) {
     return input;
   return void 0;
 }
+function isFalFileInput(value) {
+  return value.startsWith("http://") || value.startsWith("https://") || value.startsWith("data:");
+}
+async function normaliseReferences(input, client) {
+  if (!input)
+    return [];
+  const references = [];
+  for (const ref of input) {
+    if (!isFalFileInput(ref.url))
+      continue;
+    references.push({
+      ...ref,
+      url: ref.url.startsWith("data:") ? await uploadDataUri(client, ref.url) : ref.url
+    });
+  }
+  return references;
+}
+async function uploadDataUri(client, dataUri) {
+  const blob = dataUriToBlob(dataUri);
+  return client.storage.upload(blob, {
+    lifecycle: { expiresIn: "1h" }
+  });
+}
+function dataUriToBlob(dataUri) {
+  const match = /^data:([^;,]+)?(;base64)?,(.*)$/s.exec(dataUri);
+  if (!match)
+    throw new Error("Invalid data URI reference.");
+  const mimeType = match[1] || "application/octet-stream";
+  const isBase64 = Boolean(match[2]);
+  const payload = match[3] ?? "";
+  const buffer = isBase64 ? Buffer.from(payload, "base64") : Buffer.from(decodeURIComponent(payload), "utf-8");
+  return new Blob([new Uint8Array(buffer)], { type: mimeType });
+}
+function groupReferences(references) {
+  const image_urls = [];
+  const video_urls = [];
+  const audio_urls = [];
+  for (const ref of references) {
+    if (ref.kind === "image")
+      image_urls.push(ref.url);
+    if (ref.kind === "video")
+      video_urls.push(ref.url);
+    if (ref.kind === "audio")
+      audio_urls.push(ref.url);
+  }
+  return { image_urls, video_urls, audio_urls };
+}
 function normaliseAspect(value) {
   if (!value)
     return "auto";
@@ -17128,7 +17205,7 @@ function normaliseDuration(value) {
     return "auto";
   return Math.max(4, Math.min(15, Math.round(value)));
 }
-var import_client, ENDPOINT_TEXT_TO_VIDEO, ENDPOINT_IMAGE_TO_VIDEO, DEFAULT_VARIANT, VALID_RESOLUTIONS, VALID_ASPECTS, FalProvider, falProvider;
+var import_client, ENDPOINT_TEXT_TO_VIDEO, ENDPOINT_IMAGE_TO_VIDEO, ENDPOINT_REFERENCE_TO_VIDEO, DEFAULT_VARIANT, VALID_RESOLUTIONS, VALID_ASPECTS, FalProvider, falProvider;
 var init_FalProvider = __esm({
   "../ai-providers/dist/fal/FalProvider.js"() {
     "use strict";
@@ -17141,6 +17218,10 @@ var init_FalProvider = __esm({
       "seedance-2.0": "bytedance/seedance-2.0/image-to-video",
       "seedance-2.0-fast": "bytedance/seedance-2.0/fast/image-to-video"
     };
+    ENDPOINT_REFERENCE_TO_VIDEO = {
+      "seedance-2.0": "bytedance/seedance-2.0/reference-to-video",
+      "seedance-2.0-fast": "bytedance/seedance-2.0/fast/reference-to-video"
+    };
     DEFAULT_VARIANT = "seedance-2.0";
     VALID_RESOLUTIONS = ["480p", "720p", "1080p"];
     VALID_ASPECTS = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16", "auto"];
@@ -17149,7 +17230,7 @@ var init_FalProvider = __esm({
         this.id = "seedance";
         this.name = "fal.ai (Seedance 2.0)";
         this.description = "fal.ai hosting ByteDance Seedance 2.0 \u2014 Artificial Analysis #2 on both text-to-video and image-to-video leaderboards";
-        this.capabilities = ["text-to-video", "image-to-video"];
+        this.capabilities = ["text-to-video", "image-to-video", "reference-to-video"];
         this.iconUrl = "/icons/fal.svg";
         this.isAvailable = true;
       }
@@ -17188,9 +17269,11 @@ var init_FalProvider = __esm({
             error: `Unknown Seedance variant: ${variant}. Valid: ${Object.keys(ENDPOINT_TEXT_TO_VIDEO).join(", ")}.`
           };
         }
-        const referenceImage = pickReferenceImageUrl(options?.referenceImage);
+        const references = await normaliseReferences(options?.references, this.client);
+        const hasReferences = references.length > 0;
+        const referenceImage = hasReferences ? void 0 : pickReferenceImageUrl(options?.referenceImage);
         const isImageToVideo = !!referenceImage;
-        const endpointId = isImageToVideo ? ENDPOINT_IMAGE_TO_VIDEO[variant] : ENDPOINT_TEXT_TO_VIDEO[variant];
+        const endpointId = hasReferences ? ENDPOINT_REFERENCE_TO_VIDEO[variant] : isImageToVideo ? ENDPOINT_IMAGE_TO_VIDEO[variant] : ENDPOINT_TEXT_TO_VIDEO[variant];
         const aspect = normaliseAspect(options?.aspectRatio);
         const resolution = normaliseResolution(options?.resolution);
         const duration = normaliseDuration(options?.duration);
@@ -17200,13 +17283,26 @@ var init_FalProvider = __esm({
           resolution,
           duration
         };
-        if (referenceImage)
+        if (hasReferences) {
+          const grouped = groupReferences(references);
+          if (grouped.image_urls.length > 0)
+            input.image_urls = grouped.image_urls;
+          if (grouped.video_urls.length > 0)
+            input.video_urls = grouped.video_urls;
+          if (grouped.audio_urls.length > 0)
+            input.audio_urls = grouped.audio_urls;
+        } else if (referenceImage) {
           input.image_url = referenceImage;
+        }
         if (options?.negativePrompt)
           input.negative_prompt = options.negativePrompt;
         if (typeof options?.seed === "number")
           input.seed = options.seed;
-        if (options?.lastFrame)
+        if (typeof options?.generateAudio === "boolean")
+          input.generate_audio = options.generateAudio;
+        if (options?.endUserId)
+          input.end_user_id = options.endUserId;
+        if (!hasReferences && options?.lastFrame)
           input.end_image_url = options.lastFrame;
         try {
           const out = await this.client.subscribe(endpointId, { input, logs: false });
@@ -17229,7 +17325,7 @@ var init_FalProvider = __esm({
           return {
             id: "",
             status: "failed",
-            error: err instanceof Error ? err.message : String(err)
+            error: formatFalError(err)
           };
         }
       }
@@ -17253,14 +17349,15 @@ var init_fal = __esm({
       // Review this alias at the 1.0 cut.
       aliases: ["fal"],
       models: ["seedance-2.0", "seedance-2.0-fast"],
-      capabilities: ["text-to-video", "image-to-video", "native-audio"],
+      capabilities: ["text-to-video", "image-to-video", "reference-to-video", "native-audio"],
       apiKey: "fal",
       kinds: ["video"],
       resolverPriority: { video: 1 },
       commandsUnlocked: [
         "generate video -p seedance (Seedance 2.0 via fal.ai \u2014 default since v0.57)",
         "generate video -p seedance --seedance-model fast (lower-latency variant)",
-        "generate video -p seedance -i <image> (image-to-video)"
+        "generate video -p seedance -i <image> (image-to-video)",
+        "generate video -p seedance --ref-images <images...> (reference-to-video)"
       ]
     });
   }
@@ -17327,17 +17424,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();
@@ -17400,17 +17497,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();
@@ -17568,16 +17665,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();
@@ -17671,16 +17768,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();
@@ -17782,17 +17879,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();
@@ -17855,17 +17952,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();
@@ -25726,6 +25823,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,
@@ -25836,8 +25934,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() {
@@ -25917,7 +26015,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";
@@ -25936,6 +26034,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;
+      }
+    };
   }
 });
 
@@ -26553,6 +26661,33 @@ consult this file \u2014 run the generate command directly.
 Browse named styles: \`vibe scene list-styles\`. Re-seed from one with
 \`vibe scene init . --visual-style "Swiss Pulse"\` (idempotent).
 
+## Brief and local media
+
+\`brief.md\` is raw intent, not a strict schema. It may contain messy notes,
+pasted research, links, product requirements, or a one-line idea. \`vibe init
+--from brief.md\` uses it only to seed \`STORYBOARD.md\` and \`DESIGN.md\`;
+after init, those two files are the working source of truth.
+
+Use \`media/\` for user-provided source files: product photos, screenshots,
+logos, B-roll, recorded narration, or reference clips. Keep those inputs
+inside this project so build references stay project-relative. Do not put user
+media in \`references/\`; that directory is reserved for local composition
+rules installed by VibeFrame.
+
+When a beat should reuse a local file, reference it from \`STORYBOARD.md\`
+with a project-relative path:
+
+\`\`\`yaml
+backdrop: "media/product-shot.png" # existing still image
+video: "media/broll.mp4"           # existing video/B-roll
+narration: "media/voice.wav"       # existing recorded narration
+asset: "media/logo.png"            # generic local asset reference
+\`\`\`
+
+Use text cues when you want VibeFrame to generate an asset. Use path cues
+when you want VibeFrame to reuse a local file. Avoid absolute paths or parent
+directory references; copy files into \`media/\` first.
+
 ## Provider keys and project scope
 
 Use VibeFrame CLI generation for project assets:
@@ -26600,9 +26735,11 @@ the framework-level minimum, not the cinematic craft layer.
 
 - \`DESIGN.md\` \u2014 visual identity contract (palette, type, motion, transitions)
 - \`STORYBOARD.md\` \u2014 per-beat narration/backdrop/duration cues for \`vibe build\`
+- \`media/\` \u2014 user-provided source files (photos, logos, clips, voice recordings)
 - \`index.html\` \u2014 root composition (timeline)
 - \`compositions/scene-*.html\` \u2014 per-scene HTML authored by you or the agent
-- \`assets/\` \u2014 shared media (narration audio, images, video)
+- \`assets/\` \u2014 generated/canonical build media (narration audio, images, video)
+- \`references/\` \u2014 composition rule docs installed by VibeFrame, not user media
 - \`transcript.json\` \u2014 Whisper word-level transcript (if narration exists)
 - \`hyperframes.json\` \u2014 HF registry config (speak to both toolchains)
 - \`vibe.config.json\` \u2014 canonical VibeFrame config (providers, budget)
@@ -26750,7 +26887,11 @@ async function scaffoldSceneProject(opts) {
     if (await pathExists(metaPath)) {
       skipped2.push(metaPath);
     } else {
-      await writeFile4(metaPath, JSON.stringify(buildHyperframesMeta(name, now), null, 2) + "\n", "utf-8");
+      await writeFile4(
+        metaPath,
+        JSON.stringify(buildHyperframesMeta(name, now), null, 2) + "\n",
+        "utf-8"
+      );
       created.push(metaPath);
     }
     const rootPath = resolve7(dir, "index.html");
@@ -26765,11 +26906,7 @@ async function scaffoldSceneProject(opts) {
   if (await pathExists(vibeConfigJsonPath)) {
     skipped2.push(vibeConfigJsonPath);
   } else {
-    await writeFile4(
-      vibeConfigJsonPath,
-      projectConfigJson({ name, aspect }),
-      "utf-8"
-    );
+    await writeFile4(vibeConfigJsonPath, projectConfigJson({ name, aspect }), "utf-8");
     created.push(vibeConfigJsonPath);
   }
   const vibePath = resolve7(dir, "vibe.project.yaml");
@@ -26808,11 +26945,7 @@ ${existing}`, "utf-8");
   if (await pathExists(designPath)) {
     skipped2.push(designPath);
   } else {
-    await writeFile4(
-      designPath,
-      buildDesignMd({ name, style: opts.visualStyle }),
-      "utf-8"
-    );
+    await writeFile4(designPath, buildDesignMd({ name, style: opts.visualStyle }), "utf-8");
     created.push(designPath);
   }
   const storyboardPath2 = resolve7(dir, "STORYBOARD.md");
@@ -33498,7 +33631,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) {
@@ -33820,6 +33953,9 @@ async function executeVideoGenerate(options) {
     prompt: prompt3,
     provider = "kling",
     image,
+    refImages,
+    refVideos,
+    refAudio,
     duration = 5,
     ratio = "16:9",
     seed,
@@ -33828,6 +33964,7 @@ async function executeVideoGenerate(options) {
     resolution,
     veoModel = "3.1-fast",
     seedanceModel = "quality",
+    generateAudio,
     output,
     wait = true,
     apiKey
@@ -33866,8 +34003,13 @@ async function executeVideoGenerate(options) {
     if (provider === "seedance" || provider === "fal") {
       const fal = new FalProvider();
       await fal.initialize({ apiKey: key });
+      const references = await prepareSeedanceReferences({
+        refImages,
+        refVideos,
+        refAudio
+      });
       let falImage = referenceImage;
-      if (falImage && falImage.startsWith("data:")) {
+      if (falImage && falImage.startsWith("data:") && references.length === 0) {
         const uploadHost = await resolveUploadHost();
         const upload = await uploadHost.uploadImage(referenceImageBuffer, {
           filename: image,
@@ -33878,11 +34020,14 @@ async function executeVideoGenerate(options) {
       const model = seedanceModel === "fast" || seedanceModel === "seedance-2.0-fast" ? "seedance-2.0-fast" : "seedance-2.0";
       const result = await fal.generateVideo(prompt3, {
         prompt: prompt3,
-        referenceImage: falImage,
+        referenceImage: references.length > 0 ? void 0 : falImage,
+        references: references.length > 0 ? references : void 0,
         duration,
         aspectRatio: ratio,
         negativePrompt: negative,
-        model
+        model,
+        resolution,
+        generateAudio
       });
       if (result.status === "failed")
         return { success: false, error: result.error || "Seedance generation failed" };
@@ -34059,6 +34204,54 @@ async function executeVideoGenerate(options) {
     };
   }
 }
+async function prepareSeedanceReferences(opts) {
+  const references = [];
+  for (const sourcePath of opts.refImages ?? []) {
+    references.push({
+      kind: "image",
+      url: await fileInputToUrlOrDataUri(sourcePath, "image/png"),
+      sourcePath
+    });
+  }
+  for (const sourcePath of opts.refVideos ?? []) {
+    references.push({
+      kind: "video",
+      url: await fileInputToUrlOrDataUri(sourcePath, "video/mp4"),
+      sourcePath
+    });
+  }
+  for (const sourcePath of opts.refAudio ?? []) {
+    references.push({
+      kind: "audio",
+      url: await fileInputToUrlOrDataUri(sourcePath, "audio/mpeg"),
+      sourcePath
+    });
+  }
+  return references;
+}
+async function fileInputToUrlOrDataUri(input, fallbackMimeType) {
+  if (input.startsWith("http://") || input.startsWith("https://") || input.startsWith("data:")) {
+    return input;
+  }
+  const absPath = resolve23(process.cwd(), input);
+  const buffer = await readFile15(absPath);
+  return `data:${mimeTypeForPath(input, fallbackMimeType)};base64,${buffer.toString("base64")}`;
+}
+function mimeTypeForPath(path2, fallback2) {
+  const ext = path2.toLowerCase().split(".").pop();
+  const mimeTypes2 = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    gif: "image/gif",
+    webp: "image/webp",
+    mp4: "video/mp4",
+    mov: "video/quicktime",
+    mp3: "audio/mpeg",
+    wav: "audio/wav"
+  };
+  return mimeTypes2[ext || ""] || fallback2;
+}
 async function executeVideoStatus(options) {
   const {
     taskId,
@@ -34659,7 +34852,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;
@@ -35077,7 +35270,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({
@@ -36312,10 +36505,10 @@ var init_provider_resolver = __esm({
 
 // src/commands/_shared/openai-image.ts
 function resolveOpenAIImageModel(modelAlias) {
-  const isGptImage2 = modelAlias === "2" || modelAlias === "gpt-image-2";
+  const isGptImage15 = modelAlias === "1.5" || modelAlias === "gpt-image-1.5";
   return {
-    openaiModel: isGptImage2 ? "gpt-image-2" : void 0,
-    modelLabel: isGptImage2 ? "GPT Image 2" : "GPT Image 1.5"
+    openaiModel: isGptImage15 ? "gpt-image-1.5" : "gpt-image-2",
+    modelLabel: isGptImage15 ? "GPT Image 1.5" : "GPT Image 2"
   };
 }
 async function executeOpenAIImageGenerate(prompt3, options, ctx) {
@@ -36352,7 +36545,7 @@ function registerImageCommand(parent) {
     "1:1"
   ).option("--quality <quality>", "Quality: standard, hd (openai only)", "standard").option("--style <style>", "Style: vivid, natural (openai only)", "vivid").option("--count <n>", "Number of images to generate", "1").option(
     "-m, --model <model>",
-    "Model. Gemini: flash, 3.1-flash, latest, pro. OpenAI: 1.5 (default), 2 (gpt-image-2)"
+    "Model. Gemini: flash, 3.1-flash, latest, pro. OpenAI: 2 (default), 1.5"
   ).option("--dry-run", "Preview parameters without executing").addHelpText(
     "after",
     `
@@ -37786,8 +37979,8 @@ function registerVideoCommand(parent) {
     "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(
     "--ref-images <paths...>",
-    "Reference images for character consistency (Veo 3.1 only, max 3)"
-  ).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(
+    "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(
     "--runway-model <model>",
     "Runway model: gen4.5 (default, text+image-to-video), gen4_turbo (image-to-video only)",
     "gen4.5"
@@ -37930,7 +38123,11 @@ Examples:
               negative: options.negative,
               resolution: options.resolution,
               veoModel: options.veoModel,
-              seedanceModel: options.seedanceModel
+              seedanceModel: options.seedanceModel,
+              refImages: options.refImages,
+              refVideos: options.refVideos,
+              refAudio: options.refAudio,
+              generateAudio: options.generateAudio
             }
           }
         });
@@ -38217,8 +38414,13 @@ Examples:
       } else if (provider === "seedance") {
         const fal = new FalProvider();
         await fal.initialize({ apiKey });
+        const seedanceReferences = await prepareSeedanceReferences2({
+          refImages: options.refImages,
+          refVideos: options.refVideos,
+          refAudio: options.refAudio
+        });
         let falImage = referenceImage;
-        if (falImage && falImage.startsWith("data:")) {
+        if (falImage && falImage.startsWith("data:") && seedanceReferences.length === 0) {
           try {
             const uploadHost = await resolveUploadHost();
             spinner2.text = `Uploading image via ${uploadHost.provider} for Seedance...`;
@@ -38241,11 +38443,14 @@ Examples:
         const falModel = seedanceModel === "fast" || seedanceModel === "seedance-2.0-fast" ? "seedance-2.0-fast" : "seedance-2.0";
         result = await fal.generateVideo(prompt3, {
           prompt: prompt3,
-          referenceImage: falImage,
+          referenceImage: seedanceReferences.length > 0 ? void 0 : falImage,
+          references: seedanceReferences.length > 0 ? seedanceReferences : void 0,
           duration: options.duration ? parseInt(options.duration) : void 0,
           aspectRatio: options.ratio,
           negativePrompt: options.negative,
-          model: falModel
+          model: falModel,
+          resolution: options.resolution,
+          generateAudio: options.generateAudio
         });
         finalResult = result;
       }
@@ -38300,6 +38505,54 @@ Examples:
     }
   });
 }
+async function prepareSeedanceReferences2(opts) {
+  const references = [];
+  for (const sourcePath of opts.refImages ?? []) {
+    references.push({
+      kind: "image",
+      url: await fileInputToUrlOrDataUri2(sourcePath, "image/png"),
+      sourcePath
+    });
+  }
+  for (const sourcePath of opts.refVideos ?? []) {
+    references.push({
+      kind: "video",
+      url: await fileInputToUrlOrDataUri2(sourcePath, "video/mp4"),
+      sourcePath
+    });
+  }
+  for (const sourcePath of opts.refAudio ?? []) {
+    references.push({
+      kind: "audio",
+      url: await fileInputToUrlOrDataUri2(sourcePath, "audio/mpeg"),
+      sourcePath
+    });
+  }
+  return references;
+}
+async function fileInputToUrlOrDataUri2(input, fallbackMimeType) {
+  if (input.startsWith("http://") || input.startsWith("https://") || input.startsWith("data:")) {
+    return input;
+  }
+  const absPath = resolve31(process.cwd(), input);
+  const buffer = await readFile18(absPath);
+  return `data:${mimeTypeForPath2(input, fallbackMimeType)};base64,${buffer.toString("base64")}`;
+}
+function mimeTypeForPath2(path2, fallback2) {
+  const ext = path2.toLowerCase().split(".").pop();
+  const mimeTypes2 = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    gif: "image/gif",
+    webp: "image/webp",
+    mp4: "video/mp4",
+    mov: "video/quicktime",
+    mp3: "audio/mpeg",
+    wav: "audio/wav"
+  };
+  return mimeTypes2[ext || ""] || fallback2;
+}
 async function recordVideoNoWaitJob(opts) {
   return createAndWriteJobRecord({
     jobType: "generate-video",
@@ -44634,7 +44887,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}]`));
@@ -44643,7 +44896,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}]`));
@@ -44674,7 +44927,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}]`));
@@ -44683,7 +44936,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}]`));
@@ -44707,7 +44960,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}]`));
@@ -44716,7 +44969,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}]`));
@@ -44742,7 +44995,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}]`));
@@ -44751,7 +45004,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}]`));
@@ -59700,6 +59953,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, {
@@ -61410,14 +61677,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));
@@ -61437,7 +61696,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();
@@ -61453,6 +61711,8 @@ var init_scene_build = __esm({
     init_status_jobs();
     init_scene_repair();
     init_tts_resolve();
+    init_scene_build_mode();
+    init_scene_build_mode();
   }
 });
 
@@ -62767,15 +63027,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 = [];
@@ -68197,6 +68457,9 @@ 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"),
+        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"),
         duration: external_exports.number().optional().describe("Duration in seconds (default: 5; Seedance accepts 4-15)"),
         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"),
@@ -68205,6 +68468,7 @@ var init_generate2 = __esm({
         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)"),
+        generateAudio: external_exports.boolean().optional().describe("Generate native synchronized audio when supported"),
         output: external_exports.string().optional().describe("Output file path (downloads video)"),
         wait: external_exports.boolean().optional().describe("Wait for completion (default: true)")
       }),
@@ -69415,10 +69679,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}`
     };
   }
 }
@@ -71438,7 +71702,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.104.3",
+  version: "0.105.2",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -71471,128 +71735,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: {
@@ -79286,7 +79450,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") {
@@ -82099,7 +82263,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";
@@ -82263,7 +82427,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;
@@ -82312,7 +82483,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: {
@@ -82338,7 +82513,8 @@ async function runDiagnostics() {
         composerEnvVar: composerEnv,
         sceneProjectInCwd,
         skillInstalled
-      }
+      },
+      ...configError ? { configError } : {}
     },
     providers,
     readyCount,
@@ -82410,10 +82586,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(
@@ -82421,14 +82599,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(", "))}`);
@@ -82594,7 +82781,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;
@@ -83290,12 +83482,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
       };
     }
   }