@vibeframe/cli 0.57.1 → 0.57.3

package/dist/index.js

@@ -25210,6 +25210,7 @@ var init_schema = __esm({
       elevenlabs: "ELEVENLABS_API_KEY",
       runway: "RUNWAY_API_SECRET",
       kling: "KLING_API_KEY",
+      fal: "FAL_KEY",
       imgbb: "IMGBB_API_KEY",
       replicate: "REPLICATE_API_TOKEN",
       xai: "XAI_API_KEY",
@@ -33587,7 +33588,7 @@ Run 'vibe setup --show' to check API key status.
 Run 'vibe schema generate.<command>' for structured parameter info.
 `
     );
-    generateCommand.command("image").alias("img").description("Generate image using AI (Gemini, DALL-E, or Runway)").argument("[prompt]", "Image description prompt (interactive if omitted)").option("-p, --provider <provider>", "Provider: gemini, openai, grok, runway (dalle is deprecated)", "gemini").option("-k, --api-key <key>", "API key (or set env: OPENAI_API_KEY, GOOGLE_API_KEY)").option("-o, --output <path>", "Output file path (downloads image)").option("-s, --size <size>", "Image size (openai: 1024x1024, 1536x1024, 1024x1536)", "1024x1024").option("-r, --ratio <ratio>", "Aspect ratio (gemini: 1:1, 1:4, 1:8, 4:1, 8:1, 16:9, 9:16, 3:4, 4:3, etc.)", "1:1").option("-q, --quality <quality>", "Quality: standard, hd (openai only)", "standard").option("--style <style>", "Style: vivid, natural (openai only)", "vivid").option("-n, --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)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
+    generateCommand.command("image").alias("img").description("Generate image using AI (Gemini, DALL-E, or Runway)").argument("[prompt]", "Image description prompt (interactive if omitted)").option("-p, --provider <provider>", "Provider: openai (default when OPENAI_API_KEY set), gemini, grok, runway (dalle is deprecated)").option("-k, --api-key <key>", "API key (or set env: OPENAI_API_KEY, GOOGLE_API_KEY)").option("-o, --output <path>", "Output file path (downloads image)").option("-s, --size <size>", "Image size (openai: 1024x1024, 1536x1024, 1024x1536)", "1024x1024").option("-r, --ratio <ratio>", "Aspect ratio (gemini: 1:1, 1:4, 1:8, 4:1, 8:1, 16:9, 9:16, 3:4, 4:3, etc.)", "1:1").option("-q, --quality <quality>", "Quality: standard, hd (openai only)", "standard").option("--style <style>", "Style: vivid, natural (openai only)", "vivid").option("-n, --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)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe generate image "a sunset over the ocean" -o sunset.png
   $ vibe gen img "logo design" -o logo.png -p openai
@@ -33609,22 +33610,28 @@ Examples:
         if (options.output) {
           validateOutputPath(options.output);
         }
-        let provider = options.provider.toLowerCase();
         const validProviders = ["openai", "dalle", "gemini", "grok", "runway"];
-        if (!validProviders.includes(provider)) {
-          exitWithError(usageError(`Invalid provider: ${provider}`, `Available providers: openai, gemini, grok, runway`));
-        }
         const providerEnvMap = {
           gemini: "GOOGLE_API_KEY",
           openai: "OPENAI_API_KEY",
           grok: "XAI_API_KEY"
         };
-        if (providerEnvMap[provider] && !hasApiKey(providerEnvMap[provider]) && !options.apiKey) {
-          const resolved = resolveProvider("image");
-          if (resolved) {
-            log(source_default.dim(`  ${provider} key not found. Using ${resolved.label} instead.`));
-            provider = resolved.name;
+        let provider;
+        if (options.provider) {
+          provider = options.provider.toLowerCase();
+          if (!validProviders.includes(provider)) {
+            exitWithError(usageError(`Invalid provider: ${provider}`, `Available providers: openai, gemini, grok, runway`));
+          }
+          if (providerEnvMap[provider] && !hasApiKey(providerEnvMap[provider]) && !options.apiKey) {
+            const resolved = resolveProvider("image");
+            if (resolved) {
+              log(source_default.dim(`  ${provider} key not found. Using ${resolved.label} instead.`));
+              provider = resolved.name;
+            }
           }
+        } else {
+          const resolved = resolveProvider("image");
+          provider = resolved?.name ?? "gemini";
         }
         if (provider === "dalle") {
           console.log(source_default.yellow('Warning: "dalle" is deprecated. Use "openai" instead.'));
@@ -33918,7 +33925,7 @@ Examples:
         exitWithError(apiError(`Image generation failed: ${error.message}`));
       }
     });
-    generateCommand.command("video").alias("vid").description("Generate video using AI (Kling, Runway, Veo, or Grok)").argument("[prompt]", "Text prompt describing the video (interactive if omitted)").option("-p, --provider <provider>", "Provider: grok (default), kling, runway, veo, fal (Seedance 2.0)", "grok").option("-k, --api-key <key>", "API key (or set XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY / GOOGLE_API_KEY env)").option("-o, --output <path>", "Output file path (downloads video)").option("-i, --image <path>", "Reference image for image-to-video").option("-d, --duration <sec>", "Duration: 5 or 10 seconds", "5").option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1 (auto-detected from image if omitted)").option("-s, --seed <number>", "Random seed for reproducibility (Runway only)").option("-m, --mode <mode>", "Generation mode: std or pro (Kling only)", "std").option("-n, --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("--runway-model <model>", "Runway model: gen4.5 (default, text+image-to-video), gen4_turbo (image-to-video only)", "gen4.5").option("--no-wait", "Start generation and return task ID without waiting").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
+    generateCommand.command("video").alias("vid").description("Generate video using AI (Kling, Runway, Veo, or Grok)").argument("[prompt]", "Text prompt describing the video (interactive if omitted)").option("-p, --provider <provider>", "Provider: fal (Seedance 2.0, default when FAL_KEY set), grok, kling, runway, veo").option("-k, --api-key <key>", "API key (or set XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY / GOOGLE_API_KEY env)").option("-o, --output <path>", "Output file path (downloads video)").option("-i, --image <path>", "Reference image for image-to-video").option("-d, --duration <sec>", "Duration: 5 or 10 seconds", "5").option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1 (auto-detected from image if omitted)").option("-s, --seed <number>", "Random seed for reproducibility (Runway only)").option("-m, --mode <mode>", "Generation mode: std or pro (Kling only)", "std").option("-n, --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("--runway-model <model>", "Runway model: gen4.5 (default, text+image-to-video), gen4_turbo (image-to-video only)", "gen4.5").option("--no-wait", "Start generation and return task ID without waiting").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe generate video "dancing cat" -o cat.mp4                      # Grok (default)
   $ vibe gen vid "city timelapse" -o city.mp4 -p kling                # Kling
@@ -33940,11 +33947,7 @@ Examples:
         if (options.output) {
           validateOutputPath(options.output);
         }
-        let provider = options.provider.toLowerCase();
         const validProviders = ["runway", "kling", "veo", "grok", "fal"];
-        if (!validProviders.includes(provider)) {
-          exitWithError(usageError(`Invalid provider: ${provider}`, `Available providers: ${validProviders.join(", ")}`));
-        }
         const videoEnvMap = {
           grok: "XAI_API_KEY",
           veo: "GOOGLE_API_KEY",
@@ -33952,12 +33955,22 @@ Examples:
           runway: "RUNWAY_API_SECRET",
           fal: "FAL_KEY"
         };
-        if (videoEnvMap[provider] && !hasApiKey(videoEnvMap[provider]) && !options.apiKey) {
-          const resolved = resolveProvider("video");
-          if (resolved) {
-            log(source_default.dim(`  ${provider} key not found. Using ${resolved.label} instead.`));
-            provider = resolved.name;
+        let provider;
+        if (options.provider) {
+          provider = options.provider.toLowerCase();
+          if (!validProviders.includes(provider)) {
+            exitWithError(usageError(`Invalid provider: ${provider}`, `Available providers: ${validProviders.join(", ")}`));
+          }
+          if (videoEnvMap[provider] && !hasApiKey(videoEnvMap[provider]) && !options.apiKey) {
+            const resolved = resolveProvider("video");
+            if (resolved) {
+              log(source_default.dim(`  ${provider} key not found. Using ${resolved.label} instead.`));
+              provider = resolved.name;
+            }
           }
+        } else {
+          const resolved = resolveProvider("video");
+          provider = resolved?.name ?? "grok";
         }
         let referenceImage;
         let isImageToVideo = false;
@@ -57525,7 +57538,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.57.1",
+  version: "0.57.3",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -65233,25 +65246,25 @@ var AI_FEATURES = [
   {
     label: "Images",
     desc: "generate + edit",
-    defaultProvider: "Gemini Nano Banana",
-    alsoAvailable: "OpenAI GPT Image, Grok Imagine",
-    keys: [{ configKey: "google", envVar: "GOOGLE_API_KEY", name: "Google", url: "https://aistudio.google.com/apikey", what: "Gemini image generation + editing + video analysis" }],
+    defaultProvider: "OpenAI gpt-image-2 (Artificial Analysis #1, since v0.56)",
+    alsoAvailable: "Gemini Nano Banana, Grok Imagine",
+    keys: [{ configKey: "openai", envVar: "OPENAI_API_KEY", name: "OpenAI", url: "https://platform.openai.com/api-keys", what: "gpt-image-2 image generation + editing (also Whisper, Agent)" }],
     tryCommand: 'vibe generate image "a sunset over mountains" -o test.png'
   },
   {
     label: "Videos",
     desc: "generate + extend",
-    defaultProvider: "Grok Imagine (native audio)",
-    alsoAvailable: "Kling, Runway Gen-4.5, Google Veo",
-    keys: [{ configKey: "xai", envVar: "XAI_API_KEY", name: "xAI", url: "https://console.x.ai", what: "Grok video generation with native audio" }],
+    defaultProvider: "fal.ai Seedance 2.0 (Artificial Analysis #2 t2v + i2v, since v0.57)",
+    alsoAvailable: "Grok Imagine, Kling, Runway Gen-4.5, Google Veo",
+    keys: [{ configKey: "fal", envVar: "FAL_KEY", name: "fal.ai", url: "https://fal.ai/dashboard/keys", what: "ByteDance Seedance 2.0 text-to-video and image-to-video" }],
     tryCommand: 'vibe generate video "ocean waves" -o waves.mp4'
   },
   {
     label: "Audio",
     desc: "TTS, SFX, music, voice clone",
-    defaultProvider: "ElevenLabs",
+    defaultProvider: "ElevenLabs (paid, premium quality) \u2014 falls back to local Kokoro when no key (free, since v0.54)",
     alsoAvailable: "Replicate MusicGen (music only)",
-    keys: [{ configKey: "elevenlabs", envVar: "ELEVENLABS_API_KEY", name: "ElevenLabs", url: "https://elevenlabs.io/app/settings/api-keys", what: "Text-to-speech, sound effects, music, voice cloning" }],
+    keys: [{ configKey: "elevenlabs", envVar: "ELEVENLABS_API_KEY", name: "ElevenLabs", url: "https://elevenlabs.io/app/settings/api-keys", what: "Text-to-speech, sound effects, music, voice cloning (skip to use local Kokoro)" }],
     tryCommand: 'vibe generate speech "Hello world" -o hello.mp3'
   },
   {
@@ -65303,9 +65316,9 @@ async function runSetupWizard(fullSetup = false) {
     config2.llm.provider = "claude";
     const pipelineKeys = [
       { configKey: "anthropic", envVar: "ANTHROPIC_API_KEY", name: "Anthropic", url: "https://console.anthropic.com/settings/keys", what: "Claude \u2014 storyboard generation + reasoning" },
-      { configKey: "google", envVar: "GOOGLE_API_KEY", name: "Google", url: "https://aistudio.google.com/apikey", what: "Gemini \u2014 image generation + video analysis" },
-      { configKey: "elevenlabs", envVar: "ELEVENLABS_API_KEY", name: "ElevenLabs", url: "https://elevenlabs.io/app/settings/api-keys", what: "Text-to-speech narration + music" },
-      { configKey: "xai", envVar: "XAI_API_KEY", name: "xAI", url: "https://console.x.ai", what: "Grok \u2014 video generation with native audio" }
+      { configKey: "openai", envVar: "OPENAI_API_KEY", name: "OpenAI", url: "https://platform.openai.com/api-keys", what: "gpt-image-2 image generation (default since v0.56) + Whisper word-level transcribe" },
+      { configKey: "fal", envVar: "FAL_KEY", name: "fal.ai", url: "https://fal.ai/dashboard/keys", what: "Seedance 2.0 \u2014 video generation, default since v0.57" },
+      { configKey: "elevenlabs", envVar: "ELEVENLABS_API_KEY", name: "ElevenLabs", url: "https://elevenlabs.io/app/settings/api-keys", what: "Text-to-speech narration + music (skip to use local Kokoro)" }
     ];
     console.log(source_default.dim("Step 2 of 2"));
     console.log(source_default.bold("Pipeline requires these API keys:"));
@@ -65436,11 +65449,12 @@ async function runCustomSetup(config2) {
   console.log(source_default.dim("   Press Enter to skip any provider you don't need."));
   console.log();
   const allProviders = [
+    { key: "openai", name: "OpenAI", env: "OPENAI_API_KEY", desc: "gpt-image-2 image gen ($, default since v0.56), Whisper transcribe, Agent" },
     { key: "anthropic", name: "Anthropic", env: "ANTHROPIC_API_KEY", desc: "Claude \u2014 storyboard, color grade, reframe, Agent ($)" },
-    { key: "openai", name: "OpenAI", env: "OPENAI_API_KEY", desc: "Whisper (captions, jump-cut $), GPT Image ($), Agent" },
+    { key: "fal", name: "fal.ai", env: "FAL_KEY", desc: "Seedance 2.0 video gen ($$, default since v0.57)" },
     { key: "google", name: "Google", env: "GOOGLE_API_KEY", desc: "Gemini \u2014 image gen (free tier), video analysis ($), Veo ($$)" },
     { key: "xai", name: "xAI", env: "XAI_API_KEY", desc: "Grok \u2014 video gen with audio ($$), image ($), Agent" },
-    { key: "elevenlabs", name: "ElevenLabs", env: "ELEVENLABS_API_KEY", desc: "TTS ($), SFX, music, voice clone, dubbing" },
+    { key: "elevenlabs", name: "ElevenLabs", env: "ELEVENLABS_API_KEY", desc: "TTS ($), SFX, music, voice clone, dubbing \u2014 skip to use local Kokoro" },
     { key: "runway", name: "Runway", env: "RUNWAY_API_SECRET", desc: "Gen-4.5 video generation ($$)" },
     { key: "kling", name: "Kling", env: "KLING_API_KEY", desc: "v2.5/v3 video \u2014 std ($$) and pro ($$$) modes" },
     { key: "openrouter", name: "OpenRouter", env: "OPENROUTER_API_KEY", desc: "300+ models via one key \u2014 Agent only (pay per model)" },
@@ -65554,6 +65568,7 @@ async function showConfig() {
     { key: "openai", name: "OpenAI", env: "OPENAI_API_KEY" },
     { key: "google", name: "Google", env: "GOOGLE_API_KEY" },
     { key: "xai", name: "xAI", env: "XAI_API_KEY" },
+    { key: "fal", name: "fal.ai", env: "FAL_KEY" },
     { key: "elevenlabs", name: "ElevenLabs", env: "ELEVENLABS_API_KEY" },
     { key: "runway", name: "Runway", env: "RUNWAY_API_SECRET" },
     { key: "kling", name: "Kling", env: "KLING_API_KEY" },
@@ -65630,9 +65645,14 @@ var COMMAND_KEY_MAP = {
   XAI_API_KEY: [
     "agent -p xai",
     "generate image -p grok",
-    "generate video",
+    "generate video -p grok",
     "edit image -p grok"
   ],
+  FAL_KEY: [
+    "generate video -p fal (Seedance 2.0 \u2014 default since v0.57)",
+    "generate video -p fal -m fast (lower-latency variant)",
+    "generate video -p fal -i <image> (image-to-video)"
+  ],
   ELEVENLABS_API_KEY: [
     "generate speech",
     "generate sound-effect",
@@ -65644,7 +65664,7 @@ var COMMAND_KEY_MAP = {
   KLING_API_KEY: ["generate video -p kling"],
   RUNWAY_API_SECRET: ["generate video -p runway"],
   REPLICATE_API_TOKEN: ["generate music -p replicate"],
-  IMGBB_API_KEY: ["generate video -p kling (image-to-video)"]
+  IMGBB_API_KEY: ["generate video -p kling/fal (image-to-video upload host)"]
 };
 var FREE_COMMANDS = [
   "edit silence-cut",

package/package.json

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