@vibeframe/mcp-server 0.92.0 → 0.93.0

package/README.md

@@ -235,7 +235,7 @@ API keys are read from the host's environment (`~/.zshrc`, MCP config `env` bloc
 | `GOOGLE_API_KEY` | Gemini (analyze, review, silence-cut, narrate) |
 | `ELEVENLABS_API_KEY` | TTS, voice-clone, dubbing, SFX |
 | `XAI_API_KEY` | Grok |
-| `FAL_KEY` | Seedance image-to-video |
+| `FAL_API_KEY` | Seedance image-to-video |
 | `RUNWAY_API_SECRET` | Runway video |
 | `KLING_API_KEY` | Kling video |
 | `VIBE_PROJECT_PATH` | Default timeline JSON path for resources |

package/dist/index.js

@@ -13996,6 +13996,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 map3 = {};
   for (const p of providerRegistry2.values()) {
@@ -14103,7 +14106,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)",
@@ -14120,7 +14124,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-..." }
     });
@@ -24177,7 +24181,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;
@@ -24954,6 +24958,7 @@ __export(dist_exports, {
   getCommandKeyMap: () => getCommandKeyMap,
   getDisplayLabelForApiKey: () => getDisplayLabelForApiKey,
   getKeyFormat: () => getKeyFormat,
+  getProviderEnvAliases: () => getProviderEnvAliases,
   getProviderEnvVars: () => getProviderEnvVars,
   getProvidersFor: () => getProvidersFor,
   getSetupProviders: () => getSetupProviders,
@@ -25413,7 +25418,7 @@ function createDefaultConfig() {
     }
   };
 }
-var PROVIDER_NAMES, PROVIDER_ENV_VARS;
+var PROVIDER_NAMES, PROVIDER_ENV_VARS, PROVIDER_ENV_ALIASES;
 var init_schema = __esm({
   "../cli/src/config/schema.ts"() {
     "use strict";
@@ -25427,6 +25432,7 @@ var init_schema = __esm({
       openrouter: "OpenRouter"
     };
     PROVIDER_ENV_VARS = getProviderEnvVars();
+    PROVIDER_ENV_ALIASES = getProviderEnvAliases();
   }
 });
 
@@ -25435,6 +25441,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,
@@ -25549,7 +25556,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;
@@ -25560,9 +25567,12 @@ async function getApiKeyFromConfig(providerKey) {
     return config4.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 config4 = await loadConfig({ scope, cwd: options.cwd });
@@ -25588,6 +25598,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 resolve3 } 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: resolve3(process.cwd(), ".env"), debug: false, quiet: true });
   const monorepoRoot = findMonorepoRoot();
@@ -25650,19 +25666,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) {
@@ -25670,7 +25674,7 @@ async function getApiKey(envVar, providerName, optionValue) {
     }
   }
   loadEnv();
-  const envValue = process.env[envVar];
+  const envValue = getEnvValue2(envVar);
   if (envValue) {
     return envValue;
   }
@@ -25696,7 +25700,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 key2 = await getApiKey(envVar, providerName, cliOverride);
@@ -25725,19 +25729,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({
   "../cli/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",
@@ -457798,7 +457818,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;
@@ -457808,7 +457828,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) {
@@ -459610,7 +459630,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.",
@@ -459633,7 +459653,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
@@ -459676,7 +459696,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) {
@@ -459779,7 +459799,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",
@@ -460158,7 +460178,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
@@ -460169,7 +460189,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)
@@ -460242,10 +460262,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 key2 = apiKey || process.env[envKeyMap[provider] || ""];
+    const envKey = envKeyMap[provider] || "";
+    const key2 = apiKey || (hasApiKey(envKey) ? process.env[envKey] || (envKey === "FAL_API_KEY" ? process.env.FAL_KEY : void 0) : void 0);
     if (!key2) return { success: false, error: `${envKeyMap[provider]} required for ${provider}` };
     let referenceImage;
     let referenceImageBuffer;
@@ -460642,6 +460663,7 @@ var init_ai_video = __esm({
     init_dist();
     init_upload_host();
     init_ai_helpers();
+    init_api_key();
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.92.0",
+  "version": "0.93.0",
   "description": "VibeFrame MCP Server - AI-native video editing via Model Context Protocol",
   "type": "module",
   "bin": {
@@ -57,8 +57,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/core": "0.92.0",
-    "@vibeframe/cli": "0.92.0"
+    "@vibeframe/core": "0.93.0",
+    "@vibeframe/cli": "0.93.0"
   },
   "engines": {
     "node": ">=20"