@vibeframe/mcp-server 0.67.0 → 0.68.0

package/dist/index.js

@@ -13874,6 +13874,197 @@ var init_interface = __esm({
   }
 });
 
+// ../ai-providers/dist/define-provider.js
+function defineApiKey(meta) {
+  if (apiKeyRegistry.has(meta.configKey)) {
+    throw new Error(`defineApiKey: duplicate configKey "${meta.configKey}". Each API key must be declared once.`);
+  }
+  apiKeyRegistry.set(meta.configKey, meta);
+}
+function defineProvider(meta) {
+  if (providerRegistry2.has(meta.id)) {
+    throw new Error(`defineProvider: duplicate id "${meta.id}". Each provider must be declared once.`);
+  }
+  if (meta.apiKey !== null && !apiKeyRegistry.has(meta.apiKey)) {
+    throw new Error(`defineProvider: provider "${meta.id}" references apiKey "${meta.apiKey}" but no defineApiKey call has registered it. Order issue? api-keys.ts must be imported before provider modules.`);
+  }
+  providerRegistry2.set(meta.id, meta);
+}
+function getProvidersFor(kind) {
+  return [...providerRegistry2.values()].filter((p) => p.kinds.includes(kind)).sort((a, b) => (a.resolverPriority?.[kind] ?? 999) - (b.resolverPriority?.[kind] ?? 999)).map((p) => ({
+    name: p.id,
+    envVar: p.apiKey ? apiKeyRegistry.get(p.apiKey)?.envVar ?? null : null,
+    label: p.label
+  }));
+}
+function getProviderEnvVars() {
+  return Object.fromEntries([...apiKeyRegistry.values()].map((k) => [k.configKey, k.envVar]));
+}
+function getCommandKeyMap() {
+  const map3 = {};
+  for (const p of providerRegistry2.values()) {
+    if (!p.apiKey)
+      continue;
+    if (!p.commandsUnlocked || p.commandsUnlocked.length === 0)
+      continue;
+    const envVar = apiKeyRegistry.get(p.apiKey)?.envVar;
+    if (!envVar)
+      continue;
+    if (!map3[envVar])
+      map3[envVar] = [];
+    map3[envVar].push(...p.commandsUnlocked);
+  }
+  for (const k of apiKeyRegistry.values()) {
+    if (!k.commandsUnlocked || k.commandsUnlocked.length === 0)
+      continue;
+    if (!map3[k.envVar])
+      map3[k.envVar] = [];
+    map3[k.envVar].push(...k.commandsUnlocked);
+  }
+  return map3;
+}
+function getSetupProviders() {
+  return [...apiKeyRegistry.values()].filter((k) => k.showInSetup).map((k) => ({
+    key: k.configKey,
+    name: k.label,
+    env: k.envVar,
+    desc: k.setupDescription ?? ""
+  }));
+}
+function getAllApiKeys() {
+  return [...apiKeyRegistry.values()];
+}
+function getAllProviders() {
+  return [...providerRegistry2.values()];
+}
+var apiKeyRegistry, providerRegistry2;
+var init_define_provider = __esm({
+  "../ai-providers/dist/define-provider.js"() {
+    "use strict";
+    apiKeyRegistry = /* @__PURE__ */ new Map();
+    providerRegistry2 = /* @__PURE__ */ new Map();
+  }
+});
+
+// ../ai-providers/dist/api-keys.js
+var init_api_keys = __esm({
+  "../ai-providers/dist/api-keys.js"() {
+    "use strict";
+    init_define_provider();
+    defineApiKey({
+      configKey: "openai",
+      envVar: "OPENAI_API_KEY",
+      label: "OpenAI",
+      showInSetup: true,
+      setupDescription: "gpt-image-2 image gen ($, default since v0.56), Whisper transcribe, Agent",
+      envExampleComment: "OpenAI API Key (Whisper transcription, gpt-image-2 \u2014 default text-to-image since v0.56)",
+      envExampleUrl: "https://platform.openai.com/api-keys"
+    });
+    defineApiKey({
+      configKey: "google",
+      envVar: "GOOGLE_API_KEY",
+      label: "Google",
+      showInSetup: true,
+      setupDescription: "Gemini \u2014 image gen (free tier), video analysis ($), Veo ($$)",
+      envExampleComment: "Google API Key (Gemini auto-edit suggestions, image gen, Veo video)",
+      envExampleUrl: "https://aistudio.google.com/apikey"
+    });
+    defineApiKey({
+      configKey: "anthropic",
+      envVar: "ANTHROPIC_API_KEY",
+      label: "Anthropic",
+      showInSetup: true,
+      setupDescription: "Claude \u2014 storyboard, color grade, reframe, Agent ($)",
+      envExampleComment: "Anthropic API Key (Claude motion graphics & storyboarding)",
+      envExampleUrl: "https://console.anthropic.com/"
+    });
+    defineApiKey({
+      configKey: "elevenlabs",
+      envVar: "ELEVENLABS_API_KEY",
+      label: "ElevenLabs",
+      showInSetup: true,
+      setupDescription: "TTS ($), SFX, music, voice clone, dubbing \u2014 skip to use local Kokoro",
+      envExampleComment: "ElevenLabs API Key (text-to-speech \u2014 Kokoro local fallback runs when this is unset, since v0.54)",
+      envExampleUrl: "https://elevenlabs.io/api"
+    });
+    defineApiKey({
+      configKey: "fal",
+      envVar: "FAL_KEY",
+      label: "fal.ai",
+      showInSetup: true,
+      setupDescription: "Seedance 2.0 video gen ($$, default since v0.57)",
+      envExampleComment: "fal.ai API Key (Seedance 2.0 video \u2014 default text/image-to-video since v0.57, Artificial Analysis ELO #2)",
+      envExampleUrl: "https://fal.ai/dashboard/keys"
+    });
+    defineApiKey({
+      configKey: "xai",
+      envVar: "XAI_API_KEY",
+      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)",
+      envExampleUrl: "https://console.x.ai/"
+    });
+    defineApiKey({
+      configKey: "runway",
+      envVar: "RUNWAY_API_SECRET",
+      label: "Runway",
+      showInSetup: true,
+      setupDescription: "Gen-4.5 video generation ($$)",
+      envExampleComment: "Runway API Secret (Runway Gen-4.5 video generation)",
+      envExampleUrl: "https://app.runwayml.com/settings/api-keys"
+    });
+    defineApiKey({
+      configKey: "kling",
+      envVar: "KLING_API_KEY",
+      label: "Kling",
+      showInSetup: true,
+      setupDescription: "v2.5/v3 video \u2014 std ($$) and pro ($$$) modes",
+      envExampleComment: "Kling API Key (Kling video generation)",
+      envExampleUrl: "https://platform.klingai.com/",
+      envExampleExtraLines: ["Format: ACCESS_KEY:SECRET_KEY"]
+    });
+    defineApiKey({
+      configKey: "replicate",
+      envVar: "REPLICATE_API_TOKEN",
+      label: "Replicate",
+      showInSetup: true,
+      setupDescription: "MusicGen background music ($, max 30s)",
+      envExampleComment: "Replicate API Token (music generation, video upscale, audio restoration)",
+      envExampleUrl: "https://replicate.com/account/api-tokens"
+    });
+    defineApiKey({
+      configKey: "openrouter",
+      envVar: "OPENROUTER_API_KEY",
+      label: "OpenRouter",
+      showInSetup: true,
+      setupDescription: "300+ models via one key \u2014 Agent only (pay per model)",
+      envExampleComment: "OpenRouter API Key (300+ AI models via unified API, used by `vibe agent`)",
+      envExampleUrl: "https://openrouter.ai/keys"
+    });
+    defineApiKey({
+      configKey: "imgbb",
+      envVar: "IMGBB_API_KEY",
+      label: "ImgBB",
+      showInSetup: false,
+      // not prompted in setup wizard — internal upload host
+      envExampleComment: "ImgBB API Key (image hosting \u2014 used by Kling and fal.ai for image-to-video uploads)",
+      envExampleUrl: "https://api.imgbb.com/",
+      // ImgBB has no provider class (envvar-only); doctor still shows what it
+      // unlocks at the apiKey level.
+      commandsUnlocked: [
+        "generate video -p kling/fal (image-to-video upload host)"
+      ]
+    });
+    defineProvider({
+      id: "openrouter",
+      label: "OpenRouter",
+      apiKey: "openrouter",
+      kinds: ["llm"]
+    });
+  }
+});
+
 // ../ai-providers/dist/whisper/WhisperProvider.js
 var WhisperProvider, whisperProvider;
 var init_WhisperProvider = __esm({
@@ -15350,6 +15541,29 @@ var init_gemini = __esm({
     "use strict";
     init_GeminiProvider();
     init_gemini_motion();
+    init_define_provider();
+    defineProvider({
+      id: "gemini",
+      label: "Gemini",
+      apiKey: "google",
+      kinds: ["image", "llm"],
+      resolverPriority: { image: 2 },
+      commandsUnlocked: [
+        "generate image",
+        "edit image",
+        "analyze media",
+        "analyze video",
+        "analyze review"
+      ]
+    });
+    defineProvider({
+      id: "veo",
+      label: "Veo",
+      apiKey: "google",
+      kinds: ["video"],
+      resolverPriority: { video: 3 },
+      commandsUnlocked: ["generate video -p veo"]
+    });
   }
 });
 
@@ -15788,6 +16002,22 @@ var init_openai = __esm({
   "../ai-providers/dist/openai/index.js"() {
     "use strict";
     init_OpenAIProvider();
+    init_define_provider();
+    defineProvider({
+      id: "openai",
+      label: "OpenAI",
+      apiKey: "openai",
+      kinds: ["llm", "image", "transcription"],
+      resolverPriority: { image: 1 },
+      commandsUnlocked: [
+        "agent -p openai",
+        "generate image -p openai",
+        "edit image -p openai",
+        "audio transcribe",
+        "edit caption",
+        "edit jump-cut"
+      ]
+    });
   }
 });
 
@@ -17429,6 +17659,22 @@ var init_claude = __esm({
   "../ai-providers/dist/claude/index.js"() {
     "use strict";
     init_ClaudeProvider();
+    init_define_provider();
+    defineProvider({
+      id: "claude",
+      label: "Claude (Anthropic)",
+      apiKey: "anthropic",
+      kinds: ["llm"],
+      commandsUnlocked: [
+        "agent -p claude",
+        "generate storyboard",
+        "generate motion",
+        "edit grade",
+        "edit reframe",
+        "edit speed-ramp",
+        "pipeline script-to-video"
+      ]
+    });
   }
 });
 
@@ -17715,6 +17961,13 @@ var init_ollama = __esm({
   "../ai-providers/dist/ollama/index.js"() {
     "use strict";
     init_OllamaProvider();
+    init_define_provider();
+    defineProvider({
+      id: "ollama",
+      label: "Ollama (Local)",
+      apiKey: null,
+      kinds: ["llm"]
+    });
   }
 });
 
@@ -18148,6 +18401,22 @@ var init_elevenlabs = __esm({
   "../ai-providers/dist/elevenlabs/index.js"() {
     "use strict";
     init_ElevenLabsProvider();
+    init_define_provider();
+    defineProvider({
+      id: "elevenlabs",
+      label: "ElevenLabs",
+      apiKey: "elevenlabs",
+      kinds: ["speech", "music"],
+      resolverPriority: { speech: 1 },
+      commandsUnlocked: [
+        "generate speech",
+        "generate sound-effect",
+        "generate music",
+        "audio voices",
+        "audio voice-clone",
+        "audio dub"
+      ]
+    });
   }
 });
 
@@ -18243,6 +18512,14 @@ var init_kokoro = __esm({
   "../ai-providers/dist/kokoro/index.js"() {
     "use strict";
     init_KokoroProvider();
+    init_define_provider();
+    defineProvider({
+      id: "kokoro",
+      label: "Kokoro (local)",
+      apiKey: null,
+      kinds: ["speech"],
+      resolverPriority: { speech: 2 }
+    });
   }
 });
 
@@ -18809,6 +19086,15 @@ var init_runway = __esm({
   "../ai-providers/dist/runway/index.js"() {
     "use strict";
     init_RunwayProvider();
+    init_define_provider();
+    defineProvider({
+      id: "runway",
+      label: "Runway",
+      apiKey: "runway",
+      kinds: ["video"],
+      resolverPriority: { video: 5 },
+      commandsUnlocked: ["generate video -p runway"]
+    });
   }
 });
 
@@ -19239,6 +19525,15 @@ var init_kling = __esm({
   "../ai-providers/dist/kling/index.js"() {
     "use strict";
     init_KlingProvider();
+    init_define_provider();
+    defineProvider({
+      id: "kling",
+      label: "Kling",
+      apiKey: "kling",
+      kinds: ["video"],
+      resolverPriority: { video: 4 },
+      commandsUnlocked: ["generate video -p kling"]
+    });
   }
 });
 
@@ -19548,6 +19843,20 @@ var init_grok = __esm({
   "../ai-providers/dist/grok/index.js"() {
     "use strict";
     init_GrokProvider();
+    init_define_provider();
+    defineProvider({
+      id: "grok",
+      label: "Grok",
+      apiKey: "xai",
+      kinds: ["image", "video", "llm"],
+      resolverPriority: { image: 3, video: 2 },
+      commandsUnlocked: [
+        "agent -p xai",
+        "generate image -p grok",
+        "generate video -p grok",
+        "edit image -p grok"
+      ]
+    });
   }
 });
 
@@ -23810,6 +24119,19 @@ var init_fal = __esm({
   "../ai-providers/dist/fal/index.js"() {
     "use strict";
     init_FalProvider();
+    init_define_provider();
+    defineProvider({
+      id: "fal",
+      label: "fal.ai (Seedance 2.0)",
+      apiKey: "fal",
+      kinds: ["video"],
+      resolverPriority: { video: 1 },
+      commandsUnlocked: [
+        "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)"
+      ]
+    });
   }
 });
 
@@ -24459,6 +24781,14 @@ var init_replicate = __esm({
   "../ai-providers/dist/replicate/index.js"() {
     "use strict";
     init_ReplicateProvider();
+    init_define_provider();
+    defineProvider({
+      id: "replicate",
+      label: "Replicate",
+      apiKey: "replicate",
+      kinds: ["music"],
+      commandsUnlocked: ["generate music -p replicate"]
+    });
   }
 });
 
@@ -24482,10 +24812,18 @@ __export(dist_exports, {
   RunwayProvider: () => RunwayProvider,
   WhisperProvider: () => WhisperProvider,
   claudeProvider: () => claudeProvider,
+  defineApiKey: () => defineApiKey,
+  defineProvider: () => defineProvider,
   elevenLabsProvider: () => elevenLabsProvider,
   falProvider: () => falProvider,
   geminiProvider: () => geminiProvider,
+  getAllApiKeys: () => getAllApiKeys,
+  getAllProviders: () => getAllProviders,
   getBestProviderForCapability: () => getBestProviderForCapability,
+  getCommandKeyMap: () => getCommandKeyMap,
+  getProviderEnvVars: () => getProviderEnvVars,
+  getProvidersFor: () => getProvidersFor,
+  getSetupProviders: () => getSetupProviders,
   grokProvider: () => grokProvider,
   klingProvider: () => klingProvider,
   kokoroProvider: () => kokoroProvider,
@@ -24503,6 +24841,8 @@ var init_dist = __esm({
     "use strict";
     init_interface();
     init_registry();
+    init_api_keys();
+    init_define_provider();
     init_whisper();
     init_gemini();
     init_openai();
@@ -24937,19 +25277,8 @@ var PROVIDER_ENV_VARS;
 var init_schema = __esm({
   "../cli/src/config/schema.ts"() {
     "use strict";
-    PROVIDER_ENV_VARS = {
-      anthropic: "ANTHROPIC_API_KEY",
-      openai: "OPENAI_API_KEY",
-      google: "GOOGLE_API_KEY",
-      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",
-      openrouter: "OPENROUTER_API_KEY"
-    };
+    init_dist();
+    PROVIDER_ENV_VARS = getProviderEnvVars();
   }
 });
 
@@ -458534,8 +458863,8 @@ var init_ai_script_pipeline = __esm({
 
 // ../cli/src/utils/provider-resolver.ts
 function resolveProvider(category) {
-  const candidates = PROVIDER_MAP[category];
-  if (!candidates) return null;
+  const candidates = getProvidersFor(category);
+  if (candidates.length === 0) return null;
   if (configDefaults?.[category]) {
     const preferred = candidates.find((c) => c.name === configDefaults[category]);
     if (preferred && (preferred.envVar === null || hasApiKey(preferred.envVar))) {
@@ -458549,32 +458878,12 @@ function resolveProvider(category) {
   }
   return null;
 }
-var IMAGE_PROVIDERS, VIDEO_PROVIDERS, SPEECH_PROVIDERS, PROVIDER_MAP, configDefaults;
+var configDefaults;
 var init_provider_resolver = __esm({
   "../cli/src/utils/provider-resolver.ts"() {
     "use strict";
+    init_dist();
     init_api_key();
-    IMAGE_PROVIDERS = [
-      { name: "openai", envVar: "OPENAI_API_KEY", label: "OpenAI" },
-      { name: "gemini", envVar: "GOOGLE_API_KEY", label: "Gemini" },
-      { name: "grok", envVar: "XAI_API_KEY", label: "Grok" }
-    ];
-    VIDEO_PROVIDERS = [
-      { name: "fal", envVar: "FAL_KEY", label: "fal.ai (Seedance 2.0)" },
-      { name: "grok", envVar: "XAI_API_KEY", label: "Grok" },
-      { name: "veo", envVar: "GOOGLE_API_KEY", label: "Veo" },
-      { name: "kling", envVar: "KLING_API_KEY", label: "Kling" },
-      { name: "runway", envVar: "RUNWAY_API_SECRET", label: "Runway" }
-    ];
-    SPEECH_PROVIDERS = [
-      { name: "elevenlabs", envVar: "ELEVENLABS_API_KEY", label: "ElevenLabs" },
-      { name: "kokoro", envVar: null, label: "Kokoro (local)" }
-    ];
-    PROVIDER_MAP = {
-      image: IMAGE_PROVIDERS,
-      video: VIDEO_PROVIDERS,
-      speech: SPEECH_PROVIDERS
-    };
     configDefaults = null;
   }
 });
@@ -458791,6 +459100,7 @@ var init_generate = __esm({
     init_ai_helpers();
     init_validate();
     init_provider_resolver();
+    init_dist();
     init_ai_image();
     init_ai_motion();
     init_openai_image2();
@@ -458844,17 +459154,30 @@ Examples:
         if (options.output) {
           validateOutputPath(options.output);
         }
-        const validProviders = ["openai", "dalle", "gemini", "grok", "runway"];
-        const providerEnvMap = {
-          gemini: "GOOGLE_API_KEY",
-          openai: "OPENAI_API_KEY",
-          grok: "XAI_API_KEY"
+        const imageRegistry = getProvidersFor("image");
+        const validProviders = [...imageRegistry.map((p) => p.name), "dalle", "runway"];
+        const providerEnvMap = Object.fromEntries(
+          imageRegistry.filter((p) => p.envVar !== null).map((p) => [p.name, p.envVar])
+        );
+        const envKeyMap = {
+          ...providerEnvMap,
+          dalle: "OPENAI_API_KEY",
+          runway: "RUNWAY_API_SECRET"
+        };
+        const providerNameMap = {
+          ...Object.fromEntries(imageRegistry.map((p) => [p.name, p.label])),
+          // Override Gemini's resolver label "Gemini" with the more specific
+          // "Google" used in error messages, and add aliases.
+          gemini: "Google",
+          grok: "xAI Grok",
+          dalle: "OpenAI",
+          runway: "Runway"
         };
         let provider;
         if (options.provider) {
           provider = options.provider.toLowerCase();
           if (!validProviders.includes(provider)) {
-            exitWithError(usageError(`Invalid provider: ${provider}`, `Available providers: openai, gemini, grok, runway`));
+            exitWithError(usageError(`Invalid provider: ${provider}`, `Available providers: ${imageRegistry.map((p) => p.name).join(", ")}, runway`));
           }
           if (providerEnvMap[provider] && !hasApiKey(providerEnvMap[provider]) && !options.apiKey) {
             const resolved = resolveProvider("image");
@@ -458874,20 +459197,6 @@ Examples:
           outputResult({ dryRun: true, command: "generate image", params: { prompt: prompt3, provider, model: options.model, ratio: options.ratio, size: options.size, quality: options.quality, count: options.count, output: options.output } });
           return;
         }
-        const envKeyMap = {
-          openai: "OPENAI_API_KEY",
-          dalle: "OPENAI_API_KEY",
-          gemini: "GOOGLE_API_KEY",
-          grok: "XAI_API_KEY",
-          runway: "RUNWAY_API_SECRET"
-        };
-        const providerNameMap = {
-          openai: "OpenAI",
-          dalle: "OpenAI",
-          gemini: "Google",
-          grok: "xAI Grok",
-          runway: "Runway"
-        };
         const envKey = envKeyMap[provider];
         const providerName = providerNameMap[provider];
         const apiKey = await requireApiKey(envKey, providerName, options.apiKey);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.67.0",
+  "version": "0.68.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/cli": "0.67.0",
-    "@vibeframe/core": "0.67.0"
+    "@vibeframe/cli": "0.68.0",
+    "@vibeframe/core": "0.68.0"
   },
   "engines": {
     "node": ">=20"