@vibeframe/cli 0.96.0 → 0.96.4

package/dist/index.js

@@ -24528,7 +24528,7 @@ var init_fal = __esm({
       displayName: "Seedance 2.0",
       gateway: "fal.ai",
       // `fal` is a deprecated v0.x alias kept so existing scripts keep working.
-      // Will be removed at the 1.0 cut (see docs/1.0-readiness.md).
+      // 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"],
@@ -25847,8 +25847,8 @@ async function isConfigured() {
   }
   return false;
 }
-async function getApiKeyFromConfig(providerKey) {
-  const config2 = await loadConfig();
+async function getApiKeyFromConfig(providerKey, options = {}) {
+  const config2 = await loadConfig({ cwd: options.cwd });
   if (config2?.providers[providerKey]) {
     return config2.providers[providerKey];
   }
@@ -28827,6 +28827,20 @@ Requirements (non-negotiable):
   This is the #2 source of "text disappears mid-beat" bugs after \`.clip\` sizing.
 - Timed children inside the composition have \`class="clip"\` plus
   \`data-start\`, \`data-duration\`, \`data-track-index\`.
+- If the beat cues include \`backdrop\`, the build step has already generated
+  \`assets/backdrop-${ctx.beat.id}.png\`. Use that local file as the full-frame
+  visual backdrop. Do NOT replace it with abstract CSS, an external stock image,
+  Unsplash, a CDN URL, or a remote placeholder.
+- The exact backdrop path string is \`assets/backdrop-${ctx.beat.id}.png\`.
+  Do NOT prefix it with \`../\` or \`./\`: sub-composition fragments are mounted
+  from the project root \`index.html\`, so \`../assets/...\` resolves outside the
+  project and renders black.
+- Do not import external font or image URLs. Use the project DESIGN.md font
+  choice when explicit; otherwise use \`Inter\`, which is available in the
+  deterministic render font map.
+- If the beat cues include \`narration\`, do not embed an \`<audio>\` tag in the
+  scene fragment. The root timeline wires \`assets/narration-${ctx.beat.id}.wav\`
+  or \`assets/narration-${ctx.beat.id}.mp3\` separately.
 - **\`.clip\` elements get visibility control from the framework but NO
   sizing.** Always give \`.clip\` explicit fill via CSS:
   \`{ position: absolute; inset: 0; }\` (or equivalent
@@ -29027,6 +29041,18 @@ async function composeBeatWithRetry(ctx, overrides) {
 ${formatLintFeedback(lint2.findings)}`
   );
 }
+async function resolveComposerConfigAware(explicit, cwd) {
+  if (explicit) {
+    const configKey = await getApiKeyFromConfig(CONFIG_PROVIDER_BY_COMPOSER[explicit], { cwd });
+    if (configKey) return { provider: explicit, apiKey: configKey };
+    return resolveComposer(explicit);
+  }
+  for (const candidate of ["claude", "gemini", "openai"]) {
+    const configKey = await getApiKeyFromConfig(CONFIG_PROVIDER_BY_COMPOSER[candidate], { cwd });
+    if (configKey) return { provider: candidate, apiKey: configKey };
+  }
+  return resolveComposer();
+}
 async function executeComposeScenesWithSkills(params, outputDir, overrides) {
   const projectRoot = params.project ? resolve9(outputDir, params.project) : resolve9(outputDir);
   const designPath = resolve9(projectRoot, params.design ?? "DESIGN.md");
@@ -29051,7 +29077,7 @@ async function executeComposeScenesWithSkills(params, outputDir, overrides) {
   let provider;
   let apiKey;
   try {
-    const resolved = resolveComposer(params.composer);
+    const resolved = await resolveComposerConfigAware(params.composer, projectRoot);
     provider = resolved.provider;
     apiKey = resolved.apiKey;
   } catch {
@@ -29156,7 +29182,7 @@ ${failures.map((f) => `  - ${f.beatId}: ${f.error}`).join("\n")}`,
     data: aggregateData
   };
 }
-var MODEL_SETTINGS_BY_PROVIDER, ComposeBeatError, defaultCallLLM;
+var MODEL_SETTINGS_BY_PROVIDER, ComposeBeatError, defaultCallLLM, CONFIG_PROVIDER_BY_COMPOSER;
 var init_compose_scenes_skills = __esm({
   "src/commands/_shared/compose-scenes-skills.ts"() {
     "use strict";
@@ -29164,6 +29190,7 @@ var init_compose_scenes_skills = __esm({
     init_scene_lint();
     init_storyboard_parse();
     init_composer_resolve();
+    init_config();
     MODEL_SETTINGS_BY_PROVIDER = {
       // Anthropic Claude Sonnet 4.6 — v0.69 baseline. ~9 s/beat, $3/$15 per MTok.
       claude: {
@@ -29254,6 +29281,11 @@ var init_compose_scenes_skills = __esm({
         outputTokens: usage?.candidatesTokenCount ?? 0
       };
     };
+    CONFIG_PROVIDER_BY_COMPOSER = {
+      claude: "anthropic",
+      openai: "openai",
+      gemini: "google"
+    };
   }
 });
 
@@ -52528,9 +52560,7 @@ overlay, etc.) \u2014 useful at the tail of a pipeline.
 
 The CLI has three orchestrating commands that coordinate other primitives:
 \`vibe agent\`, \`vibe build\`, \`vibe run\`. New users routinely ask which one
-they want for a given task. The full audit lives in
-[\`docs/cli-architecture.md\`](../../../docs/cli-architecture.md); this
-guide is the operator-facing summary.
+they want for a given task. This guide is the operator-facing summary.
 
 If you already use Claude Code, Codex, Cursor, Aider, Gemini CLI, OpenCode,
 or another coding agent, let that host drive \`vibe\` directly through shell
@@ -53448,7 +53478,7 @@ async function dispatchBackdrop(beat, ctx) {
     return { status: "cached", path: rel };
   }
   loadSceneBuildEnv(ctx.projectDir);
-  const apiKey = process.env.OPENAI_API_KEY ?? "";
+  const apiKey = await getApiKeyFromConfig("openai", { cwd: ctx.projectDir }) ?? process.env.OPENAI_API_KEY ?? "";
   if (!apiKey) {
     const error = "OPENAI_API_KEY not set \u2014 cannot dispatch backdrop";
     ctx.onProgress({ type: "backdrop-failed", beatId: beat.id, error });
@@ -53580,6 +53610,7 @@ var init_scene_build = __esm({
     init_compose_scenes_skills();
     init_compose_prompts();
     init_agent_host_detect();
+    init_config();
     init_scene_render();
     init_storyboard_parse();
     init_scene_project();
@@ -54360,25 +54391,102 @@ function getOutput(params, outputDir, defaultName) {
   }
   return resolve57(outputDir, defaultName);
 }
+function stringParam(value) {
+  return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+function numberParam2(value) {
+  if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+  if (typeof value === "string" && value.trim() !== "") {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : void 0;
+  }
+  return void 0;
+}
+async function resolvePipelineImageProvider(provider) {
+  const explicit = stringParam(provider)?.toLowerCase();
+  if (explicit) return explicit;
+  await loadProviderDefaults();
+  return resolveProvider("image")?.name ?? "gemini";
+}
+async function resolvePipelineVideoProvider(provider) {
+  const explicit = stringParam(provider)?.toLowerCase();
+  if (explicit === "fal") return "seedance";
+  if (explicit) return explicit;
+  await loadProviderDefaults();
+  return resolveProvider("video")?.name ?? "grok";
+}
+function providerKeyForImage(provider) {
+  switch (provider) {
+    case "openai":
+      return "openai";
+    case "gemini":
+      return "google";
+    case "grok":
+      return "xai";
+    default:
+      return void 0;
+  }
+}
+function providerKeyForVideo(provider) {
+  switch (provider) {
+    case "seedance":
+    case "fal":
+      return "fal";
+    case "grok":
+      return "xai";
+    case "kling":
+      return "kling";
+    case "runway":
+      return "runway";
+    case "veo":
+      return "google";
+    default:
+      return void 0;
+  }
+}
+async function apiKeyForProvider(providerKey) {
+  return providerKey ? getApiKeyFromConfig(providerKey) : void 0;
+}
 async function ensureActionsRegistered() {
   if (Object.keys(ACTION_HANDLERS).length > 0) return;
   registerAction("generate-image", async (params, outputDir) => {
     const { executeImageGenerate: executeImageGenerate2 } = await Promise.resolve().then(() => (init_ai_image(), ai_image_exports));
     const output = getOutput(params, outputDir, "image.png");
-    const r = await executeImageGenerate2({ prompt: params.prompt, provider: params.provider, output, model: params.model, ratio: params.ratio });
+    const provider = await resolvePipelineImageProvider(params.provider);
+    const r = await executeImageGenerate2({
+      prompt: params.prompt,
+      provider,
+      output,
+      model: stringParam(params.model),
+      ratio: stringParam(params.ratio),
+      size: stringParam(params.size),
+      quality: stringParam(params.quality),
+      style: stringParam(params.style),
+      count: numberParam2(params.count),
+      apiKey: await apiKeyForProvider(providerKeyForImage(provider))
+    });
     return { id: "", action: "generate-image", success: r.success, output: r.outputPath, data: { provider: r.provider, model: r.model }, error: r.error };
   });
   registerAction("generate-video", async (params, outputDir) => {
     const { executeVideoGenerate: executeVideoGenerate2 } = await Promise.resolve().then(() => (init_ai_video(), ai_video_exports));
     const output = getOutput(params, outputDir, "video.mp4");
+    const provider = await resolvePipelineVideoProvider(params.provider);
     const r = await executeVideoGenerate2({
       prompt: params.prompt,
-      provider: params.provider,
-      image: params.image,
-      duration: params.duration,
-      ratio: params.ratio,
+      provider,
+      image: stringParam(params.image),
+      duration: numberParam2(params.duration),
+      ratio: stringParam(params.ratio),
+      seed: numberParam2(params.seed),
+      mode: stringParam(params.mode),
+      negative: stringParam(params.negative),
+      resolution: stringParam(params.resolution),
+      veoModel: stringParam(params.veoModel),
+      runwayModel: stringParam(params.runwayModel),
+      seedanceModel: stringParam(params.seedanceModel),
       output,
-      wait: true
+      wait: true,
+      apiKey: await apiKeyForProvider(providerKeyForVideo(provider))
     });
     return { id: "", action: "generate-video", success: r.success, output: r.outputPath || r.videoUrl, data: { taskId: r.taskId, provider: r.provider, videoUrl: r.videoUrl }, error: r.error };
   });
@@ -54782,6 +54890,8 @@ var init_executor = __esm({
     import_yaml8 = __toESM(require_dist(), 1);
     init_resolver();
     init_output();
+    init_config();
+    init_provider_resolver();
     ACTION_METADATA = {
       "generate-image": { id: "generate-image", title: "Generate image", category: "generate", command: "generate image", outputs: ["image"] },
       "generate-video": { id: "generate-video", title: "Generate video", category: "generate", command: "generate video", outputs: ["video"], requiredKeys: ["provider-dependent"] },
@@ -64048,7 +64158,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.96.0",
+  version: "0.96.4",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -66476,7 +66586,8 @@ function inferType(opt, name) {
     "<ms>",
     "<n>",
     "<count>",
-    "<duration>"
+    "<duration>",
+    "<usd>"
   ];
   if (numericFlags.some((f) => opt.flags.includes(f))) {
     return "number";
@@ -66497,7 +66608,8 @@ function inferType(opt, name) {
     "fps",
     "bitrate",
     "width",
-    "height"
+    "height",
+    "budgetUsd"
   ];
   if (numericNames.includes(name)) {
     return "number";
@@ -74750,8 +74862,8 @@ async function startAgent(options = {}) {
   const isNonInteractive = !!options.input;
   const confirmAlways = options.confirm || false;
   const noConfirm = options.noConfirm || false;
-  const budgetUsd = options.budgetUsd ? parseFloat(options.budgetUsd) : void 0;
-  if (budgetUsd !== void 0 && (Number.isNaN(budgetUsd) || budgetUsd < 0)) {
+  const budgetUsd = options.budgetUsd !== void 0 ? Number(options.budgetUsd) : void 0;
+  if (budgetUsd !== void 0 && (!Number.isFinite(budgetUsd) || budgetUsd < 0)) {
     exitWithError(generalError(`Invalid --budget-usd: ${options.budgetUsd}`, "Must be a non-negative number (e.g., --budget-usd 5)"));
   }
   if (!isNonInteractive && !hasTTY()) {
@@ -74956,7 +75068,7 @@ async function startAgent(options = {}) {
     rl.prompt();
   });
 }
-var agentCommand = new Command("agent").description("Optional built-in natural-language agent (fallback when no external coding agent is driving vibe)").option("-p, --provider <provider>", "LLM provider (openai, claude, gemini, ollama, xai, openrouter)", "openai").option("-m, --model <model>", "Model to use (provider-specific)").option("--project <path>", "Timeline file or directory to load").option("-v, --verbose", "Show verbose output including tool calls").option("--max-turns <n>", "Maximum turns per request", "10").option("-i, --input <query>", "Run a single query and exit (non-interactive)").option("-c, --confirm", "Confirm before every tool \u2014 broadens the default cost gate (paid only) to all calls").option("--no-confirm", "Disable all confirm prompts including the high/very-high cost gate (CI / automation)").option("--budget-usd <usd>", "Reject tool calls past this cumulative USD ceiling (tier-estimated, conservative)").action(async (options) => {
+var agentCommand = new Command("agent").description("Optional built-in natural-language agent (fallback when no external coding agent is driving vibe)").option("-p, --provider <provider>", "LLM provider (openai, claude, gemini, ollama, xai, openrouter)", "openai").option("-m, --model <model>", "Model to use (provider-specific)").option("--project <path>", "Timeline file or directory to load").option("-v, --verbose", "Show verbose output including tool calls").option("--max-turns <n>", "Maximum turns per request", "10").option("-i, --input <query>", "Run a single query and exit (non-interactive)").option("-c, --confirm", "Confirm before every tool \u2014 broadens the default cost gate (paid only) to all calls").option("--no-confirm", "Disable all confirm prompts including the high/very-high cost gate (CI / automation)").option("--budget-usd <usd>", "Reject tool calls past this cumulative USD ceiling using conservative tier estimates", parseFloat).action(async (options) => {
   await startAgent(options);
 });
 function getEnvVar(provider) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.96.0",
+  "version": "0.96.4",
   "description": "VibeFrame CLI - natural language video editing from the terminal",
   "private": false,
   "license": "MIT",
@@ -183,8 +183,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/core": "0.96.0",
-    "@vibeframe/ai-providers": "0.96.0"
+    "@vibeframe/ai-providers": "0.96.4",
+    "@vibeframe/core": "0.96.4"
   },
   "engines": {
     "node": ">=20"