@vibeframe/cli 0.92.0 → 0.93.0

package/CONTEXT.md

@@ -92,7 +92,7 @@ export GOOGLE_API_KEY="..."        # Gemini (image, video, inspect)
 export OPENAI_API_KEY="..."        # Whisper, DALL-E, GPT
 export ANTHROPIC_API_KEY="..."     # Claude (storyboard, grading)
 export XAI_API_KEY="..."           # Grok
-export FAL_KEY="..."               # Seedance video (default)
+export FAL_API_KEY="..."           # Seedance video (default)
 export ELEVENLABS_API_KEY="..."    # TTS, music, sound effects
 export KLING_API_KEY="..."         # Kling video
 export RUNWAY_API_SECRET="..."     # Runway video

package/dist/index.js

@@ -14270,6 +14270,9 @@ function getProvidersFor(kind) {
 function getProviderEnvVars() {
   return Object.fromEntries([...apiKeyRegistry.values()].map((k) => [k.configKey, k.envVar]));
 }
+function getProviderEnvAliases() {
+  return Object.fromEntries([...apiKeyRegistry.values()].filter((k) => k.envAliases && k.envAliases.length > 0).map((k) => [k.envVar, k.envAliases ?? []]));
+}
 function getCommandKeyMap() {
   const map = {};
   for (const p of providerRegistry2.values()) {
@@ -14377,7 +14380,8 @@ var init_api_keys = __esm({
     });
     defineApiKey({
       configKey: "fal",
-      envVar: "FAL_KEY",
+      envVar: "FAL_API_KEY",
+      envAliases: ["FAL_KEY"],
       label: "fal.ai",
       showInSetup: true,
       setupDescription: "Seedance 2.0 video gen ($$, default since v0.57)",
@@ -14394,7 +14398,7 @@ var init_api_keys = __esm({
       label: "xAI",
       showInSetup: true,
       setupDescription: "Grok \u2014 video gen with audio ($$), image ($), Agent",
-      envExampleComment: "xAI API Key (Grok video generation \u2014 fallback when no FAL_KEY)",
+      envExampleComment: "xAI API Key (Grok video generation \u2014 fallback when no FAL_API_KEY)",
       envExampleUrl: "https://console.x.ai/",
       keyFormat: { prefix: /^xai-/, example: "xai-..." }
     });
@@ -24451,7 +24455,7 @@ var init_FalProvider = __esm({
           return {
             id: "",
             status: "failed",
-            error: "fal.ai API key not configured. Set FAL_KEY in .env."
+            error: "fal.ai API key not configured. Set FAL_API_KEY in .env."
           };
         }
         const variant = options?.model ?? DEFAULT_VARIANT;
@@ -25228,6 +25232,7 @@ __export(dist_exports2, {
   getCommandKeyMap: () => getCommandKeyMap,
   getDisplayLabelForApiKey: () => getDisplayLabelForApiKey,
   getKeyFormat: () => getKeyFormat,
+  getProviderEnvAliases: () => getProviderEnvAliases,
   getProviderEnvVars: () => getProviderEnvVars,
   getProvidersFor: () => getProvidersFor,
   getSetupProviders: () => getSetupProviders,
@@ -25687,7 +25692,7 @@ function createDefaultConfig() {
     }
   };
 }
-var PROVIDER_NAMES, PROVIDER_ENV_VARS;
+var PROVIDER_NAMES, PROVIDER_ENV_VARS, PROVIDER_ENV_ALIASES;
 var init_schema = __esm({
   "src/config/schema.ts"() {
     "use strict";
@@ -25701,6 +25706,7 @@ var init_schema = __esm({
       openrouter: "OpenRouter"
     };
     PROVIDER_ENV_VARS = getProviderEnvVars();
+    PROVIDER_ENV_ALIASES = getProviderEnvAliases();
   }
 });
 
@@ -25709,6 +25715,7 @@ var config_exports = {};
 __export(config_exports, {
   CONFIG_DIR: () => CONFIG_DIR,
   CONFIG_PATH: () => CONFIG_PATH,
+  PROVIDER_ENV_ALIASES: () => PROVIDER_ENV_ALIASES,
   PROVIDER_ENV_VARS: () => PROVIDER_ENV_VARS,
   PROVIDER_NAMES: () => PROVIDER_NAMES,
   USER_CONFIG_DIR: () => USER_CONFIG_DIR,
@@ -25823,7 +25830,7 @@ async function isConfigured() {
     return true;
   }
   const envVar = PROVIDER_ENV_VARS[providerKey];
-  if (envVar && process.env[envVar]) {
+  if (envVar && getEnvValue(envVar)) {
     return true;
   }
   return false;
@@ -25834,9 +25841,12 @@ async function getApiKeyFromConfig(providerKey) {
     return config2.providers[providerKey];
   }
   const envVar = PROVIDER_ENV_VARS[providerKey];
-  if (envVar) return process.env[envVar];
+  if (envVar) return getEnvValue(envVar);
   return void 0;
 }
+function getEnvValue(envVar) {
+  return process.env[envVar] || PROVIDER_ENV_ALIASES[envVar]?.map((alias) => process.env[alias]).find(Boolean);
+}
 async function updateProviderKey(providerKey, apiKey, options = {}) {
   const scope = options.scope ?? await getActiveScope(options.cwd);
   let config2 = await loadConfig({ scope, cwd: options.cwd });
@@ -25862,6 +25872,12 @@ var init_config = __esm({
 import { createInterface } from "node:readline";
 import { readFile as readFile3, writeFile as writeFile3, access as access3 } from "node:fs/promises";
 import { resolve as resolve5 } from "node:path";
+function providerKeyForEnvVar(envVar) {
+  return PROVIDER_KEY_BY_ENV_VAR[envVar];
+}
+function getEnvValue2(envVar) {
+  return process.env[envVar] || PROVIDER_ENV_ALIASES[envVar]?.map((alias) => process.env[alias]).find(Boolean);
+}
 function loadEnv() {
   (0, import_dotenv.config)({ path: resolve5(process.cwd(), ".env"), debug: false, quiet: true });
   const monorepoRoot = findMonorepoRoot();
@@ -25924,19 +25940,7 @@ async function getApiKey(envVar, providerName, optionValue) {
   if (optionValue) {
     return optionValue;
   }
-  const providerKeyMap = {
-    ANTHROPIC_API_KEY: "anthropic",
-    OPENAI_API_KEY: "openai",
-    GOOGLE_API_KEY: "google",
-    XAI_API_KEY: "xai",
-    ELEVENLABS_API_KEY: "elevenlabs",
-    RUNWAY_API_SECRET: "runway",
-    KLING_API_KEY: "kling",
-    OPENROUTER_API_KEY: "openrouter",
-    IMGBB_API_KEY: "imgbb",
-    REPLICATE_API_TOKEN: "replicate"
-  };
-  const providerKey = providerKeyMap[envVar];
+  const providerKey = providerKeyForEnvVar(envVar);
   if (providerKey) {
     const configKey = await getApiKeyFromConfig(providerKey);
     if (configKey) {
@@ -25944,7 +25948,7 @@ async function getApiKey(envVar, providerName, optionValue) {
     }
   }
   loadEnv();
-  const envValue = process.env[envVar];
+  const envValue = getEnvValue2(envVar);
   if (envValue) {
     return envValue;
   }
@@ -25970,7 +25974,7 @@ async function getApiKey(envVar, providerName, optionValue) {
 }
 function hasApiKey(envVar) {
   loadEnv();
-  return !!process.env[envVar];
+  return !!getEnvValue2(envVar);
 }
 async function requireApiKey(envVar, providerName, cliOverride) {
   const key = await getApiKey(envVar, providerName, cliOverride);
@@ -25999,19 +26003,35 @@ async function saveApiKeyToEnv(envVar, apiKey) {
   }
   await writeFile3(envPath, content, "utf-8");
 }
-var import_dotenv, API_KEY_URLS, ApiKeyError;
+var import_dotenv, PROVIDER_KEY_BY_ENV_VAR, API_KEY_URLS, ApiKeyError;
 var init_api_key = __esm({
   "src/utils/api-key.ts"() {
     "use strict";
     import_dotenv = __toESM(require_main(), 1);
     init_source();
     init_config();
+    PROVIDER_KEY_BY_ENV_VAR = {
+      ANTHROPIC_API_KEY: "anthropic",
+      OPENAI_API_KEY: "openai",
+      GOOGLE_API_KEY: "google",
+      XAI_API_KEY: "xai",
+      ELEVENLABS_API_KEY: "elevenlabs",
+      FAL_API_KEY: "fal",
+      FAL_KEY: "fal",
+      RUNWAY_API_SECRET: "runway",
+      KLING_API_KEY: "kling",
+      OPENROUTER_API_KEY: "openrouter",
+      IMGBB_API_KEY: "imgbb",
+      REPLICATE_API_TOKEN: "replicate"
+    };
     API_KEY_URLS = {
       GOOGLE_API_KEY: "https://aistudio.google.com/apikey",
       OPENAI_API_KEY: "https://platform.openai.com/api-keys",
       ANTHROPIC_API_KEY: "https://console.anthropic.com/settings/keys",
       XAI_API_KEY: "https://console.x.ai",
       ELEVENLABS_API_KEY: "https://elevenlabs.io/app/settings/api-keys",
+      FAL_API_KEY: "https://fal.ai/dashboard/keys",
+      FAL_KEY: "https://fal.ai/dashboard/keys",
       RUNWAY_API_SECRET: "https://app.runwayml.com/settings/api-keys",
       KLING_API_KEY: "https://klingai.com/dev",
       REPLICATE_API_TOKEN: "https://replicate.com/account/api-tokens",
@@ -33417,7 +33437,7 @@ async function loadProviderDefaults() {
     configProviderKeys = null;
   }
 }
-function providerKeyForEnvVar(envVar) {
+function providerKeyForEnvVar2(envVar) {
   const envVars = getProviderEnvVars();
   for (const [providerKey, candidateEnvVar] of Object.entries(envVars)) {
     if (candidateEnvVar === envVar) return providerKey;
@@ -33427,7 +33447,7 @@ function providerKeyForEnvVar(envVar) {
 function hasCandidateKey(candidate) {
   if (candidate.envVar === null) return true;
   if (hasApiKey(candidate.envVar)) return true;
-  const providerKey = providerKeyForEnvVar(candidate.envVar);
+  const providerKey = providerKeyForEnvVar2(candidate.envVar);
   return providerKey ? Boolean(configProviderKeys?.has(providerKey)) : false;
 }
 function resolveProvider(category) {
@@ -35229,7 +35249,7 @@ function registerVideoCommand(parent) {
     "Provider: seedance (ByteDance Seedance 2.0 via fal.ai), grok, kling, runway, veo. `fal` is a deprecated v0.x alias for seedance and will be removed in 1.0."
   ).option(
     "-k, --api-key <key>",
-    "API key (or set FAL_KEY / XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY / GOOGLE_API_KEY env)"
+    "API key (or set FAL_API_KEY / 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 in seconds. Seedance accepts 4-15; Kling accepts 5 or 10; Veo maps to 6 or 8.",
@@ -35252,7 +35272,7 @@ function registerVideoCommand(parent) {
     "after",
     `
 Examples:
-  $ vibe generate video "dancing cat" -o cat.mp4                      # Seedance when FAL_KEY is set
+  $ vibe generate video "dancing cat" -o cat.mp4                      # Seedance when FAL_API_KEY is set
   $ vibe gen vid "cinematic city timelapse" -o city.mp4 -p seedance   # Seedance via fal.ai
   $ vibe gen vid "city timelapse" -o city.mp4 -p kling                # Kling
   $ vibe gen vid "epic scene" -i frame.png -o out.mp4 -p runway       # Image-to-video
@@ -35295,7 +35315,7 @@ Examples:
         veo: "GOOGLE_API_KEY",
         kling: "KLING_API_KEY",
         runway: "RUNWAY_API_SECRET",
-        seedance: "FAL_KEY"
+        seedance: "FAL_API_KEY"
       };
       let provider;
       if (options.provider) {
@@ -35398,7 +35418,7 @@ Examples:
         kling: "KLING_API_KEY",
         veo: "GOOGLE_API_KEY",
         grok: "XAI_API_KEY",
-        seedance: "FAL_KEY"
+        seedance: "FAL_API_KEY"
       };
       const providerNameMap = {
         runway: "Runway",
@@ -35777,7 +35797,7 @@ var init_generate = __esm({
 Examples:
   $ vibe generate image "a sunset over the ocean" -o sunset.png
   $ vibe generate image "logo design" -o logo.png -p openai
-  $ vibe generate video "dancing cat" -o cat.mp4                  # Seedance when FAL_KEY is set
+  $ vibe generate video "dancing cat" -o cat.mp4                  # Seedance when FAL_API_KEY is set
   $ vibe generate video "city timelapse" -o city.mp4 -p seedance  # Seedance via fal.ai
   $ vibe generate video "city timelapse" -o city.mp4 -p kling     # Kling
   $ vibe generate video "epic scene" -i frame.png -o out.mp4 -p runway  # Image-to-video
@@ -35788,7 +35808,7 @@ Examples:
 API Keys (per provider):
   GOOGLE_API_KEY     Image (default), Veo video
   OPENAI_API_KEY     Image (-p openai)
-  FAL_KEY            Seedance video (-p seedance, default video)
+  FAL_API_KEY        Seedance video (-p seedance, default video)
   XAI_API_KEY        Grok image/video
   KLING_API_KEY      Kling video (-p kling)
   RUNWAY_API_SECRET  Runway video (-p runway)
@@ -52806,10 +52826,11 @@ async function executeVideoGenerate(options) {
       runway: "RUNWAY_API_SECRET",
       kling: "KLING_API_KEY",
       veo: "GOOGLE_API_KEY",
-      seedance: "FAL_KEY",
-      fal: "FAL_KEY"
+      seedance: "FAL_API_KEY",
+      fal: "FAL_API_KEY"
     };
-    const key = apiKey || process.env[envKeyMap[provider] || ""];
+    const envKey = envKeyMap[provider] || "";
+    const key = apiKey || (hasApiKey(envKey) ? process.env[envKey] || (envKey === "FAL_API_KEY" ? process.env.FAL_KEY : void 0) : void 0);
     if (!key) return { success: false, error: `${envKeyMap[provider]} required for ${provider}` };
     let referenceImage;
     let referenceImageBuffer;
@@ -53206,6 +53227,7 @@ var init_ai_video = __esm({
     init_dist2();
     init_upload_host();
     init_ai_helpers();
+    init_api_key();
   }
 });
 
@@ -63425,7 +63447,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.92.0",
+  version: "0.93.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -70423,6 +70445,13 @@ var VALID_LLM_PROVIDERS = [
   "openrouter"
 ];
 var VALID_SCOPES = ["user", "project"];
+function envValueFor(meta) {
+  return process.env[meta.envVar] || meta.envAliases?.map((alias) => process.env[alias]).find(Boolean);
+}
+function envValueForName(envVar) {
+  if (envVar === "FAL_API_KEY") return process.env.FAL_API_KEY || process.env.FAL_KEY;
+  return process.env[envVar];
+}
 function parseScope(raw) {
   const v = String(raw ?? "user");
   if (!VALID_SCOPES.includes(v)) {
@@ -70569,7 +70598,7 @@ var AI_FEATURES = [
     keys: [
       {
         configKey: "fal",
-        envVar: "FAL_KEY",
+        envVar: "FAL_API_KEY",
         name: "Seedance 2.0 (via fal.ai)",
         url: "https://fal.ai/dashboard/keys",
         what: "ByteDance Seedance 2.0 text-to-video and image-to-video"
@@ -70581,7 +70610,7 @@ var AI_FEATURES = [
         desc: "recommended default, text-to-video + image-to-video",
         key: {
           configKey: "fal",
-          envVar: "FAL_KEY",
+          envVar: "FAL_API_KEY",
           name: "Seedance 2.0 (via fal.ai)",
           url: "https://fal.ai/dashboard/keys",
           what: "ByteDance Seedance 2.0 text-to-video and image-to-video"
@@ -70890,7 +70919,7 @@ async function runNonInteractiveSetup(opts) {
   if (opts.importEnv) {
     loadEnv();
     for (const meta of getAllApiKeys()) {
-      const envValue = process.env[meta.envVar];
+      const envValue = envValueFor(meta);
       if (!envValue) continue;
       const existing = config2.providers[meta.configKey];
       if (existing === envValue) continue;
@@ -71020,7 +71049,7 @@ async function runSetupWizard(fullSetup = false, scope = "user") {
       },
       {
         configKey: "fal",
-        envVar: "FAL_KEY",
+        envVar: "FAL_API_KEY",
         name: "fal.ai",
         url: "https://fal.ai/dashboard/keys",
         what: "Seedance 2.0 \u2014 video generation, default since v0.57"
@@ -71231,7 +71260,7 @@ async function runAIFeaturesSetup(config2, _scope) {
           }
           loadEnv();
           const configValue = config2.providers[keyDef.configKey];
-          const envValue = process.env[keyDef.envVar];
+          const envValue = envValueForName(keyDef.envVar);
           if (configValue || envValue) {
             const value = configValue || envValue;
             const source = configValue ? "config" : ".env";
@@ -71279,7 +71308,7 @@ async function collectKeys(config2, keys) {
   loadEnv();
   for (const keyDef of keys) {
     const configValue = config2.providers[keyDef.configKey];
-    const envValue = process.env[keyDef.envVar];
+    const envValue = envValueForName(keyDef.envVar);
     if (configValue) {
       console.log(
         `  ${source_default.green("\u2713")} ${keyDef.name.padEnd(14)} ${maskApiKey(configValue)} ${source_default.dim("(config)")}`
@@ -71540,7 +71569,7 @@ async function showConfig(opts = { verbose: false }) {
     { 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: "fal", name: "fal.ai", env: "FAL_API_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" },
@@ -71551,7 +71580,7 @@ async function showConfig(opts = { verbose: false }) {
   let unsetCount = 0;
   for (const p of providerKeys) {
     const configValue = config2?.providers[p.key];
-    const dotenvValue = dotenvKeys[p.env];
+    const dotenvValue = dotenvKeys[p.env] || (p.env === "FAL_API_KEY" ? dotenvKeys.FAL_KEY : void 0);
     if (configValue || dotenvValue) {
       const sources = [];
       if (configValue) sources.push("config");
@@ -71847,7 +71876,7 @@ OPENROUTER_API_KEY=                   # multiplexes any provider above
 
 # \u2500\u2500 Media providers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
 ELEVENLABS_API_KEY=                   # paid TTS / SFX / music (Kokoro is the free fallback)
-FAL_KEY=                              # Seedance 2.0 \u2014 default video provider since v0.57
+FAL_API_KEY=                              # Seedance 2.0 \u2014 default video provider since v0.57
 IMGBB_API_KEY=                        # image hosting for Seedance/Kling image-to-video
 RUNWAY_API_SECRET=                    # Runway Gen-4.5 video
 KLING_API_KEY=                        # Kling video
@@ -72722,7 +72751,9 @@ async function runDiagnostics() {
   let readyCount = FREE_COMMANDS.length;
   let totalCount = FREE_COMMANDS.length;
   for (const [envVar, commands] of Object.entries(COMMAND_KEY_MAP)) {
-    const configured = !!process.env[envVar];
+    const configured = Boolean(
+      process.env[envVar] || PROVIDER_ENV_ALIASES[envVar]?.map((alias) => process.env[alias]).find(Boolean)
+    );
     const providerName = Object.entries(PROVIDER_ENV_VARS).find(([, v]) => v === envVar)?.[0] ?? envVar;
     providers[providerName] = { envVar, configured, commands };
     totalCount += commands.length;
@@ -73011,7 +73042,7 @@ async function runLiveKeyTests(results) {
   }
   const { testKey: testKey2 } = await Promise.resolve().then(() => (init_key_live_test(), key_live_test_exports));
   for (const [name, info] of configured) {
-    const value = process.env[info.envVar];
+    const value = process.env[info.envVar] || PROVIDER_ENV_ALIASES[info.envVar]?.map((alias) => process.env[alias]).find(Boolean);
     if (!value) continue;
     process.stdout.write(`    ${name.padEnd(12)} `);
     const result = await testKey2(name, value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.92.0",
+  "version": "0.93.0",
   "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.92.0",
-    "@vibeframe/ai-providers": "0.92.0"
+    "@vibeframe/ai-providers": "0.93.0",
+    "@vibeframe/core": "0.93.0"
   },
   "engines": {
     "node": ">=20"