@vibeframe/mcp-server 0.89.0 → 0.91.0

package/dist/index.js

@@ -7607,9 +7607,8 @@ vibe scene lint --json    # structured output for agent loops
 `;
 }
 function buildSceneGitignore() {
-  return `# VibeFrame caches
-.vibeframe/cache/
-.vibeframe/checkpoints/
+  return `# VibeFrame \u2014 caches, checkpoints, and project-scope config.yaml (may contain API keys)
+.vibeframe/
 
 # Render outputs
 renders/*.mp4
@@ -14023,7 +14022,7 @@ function getCommandKeyMap() {
 function getSetupProviders() {
   return [...apiKeyRegistry.values()].filter((k) => k.showInSetup).map((k) => ({
     key: k.configKey,
-    name: k.label,
+    name: getDisplayLabelForApiKey(k.configKey),
     env: k.envVar,
     desc: k.setupDescription ?? "",
     url: k.envExampleUrl
@@ -14035,6 +14034,16 @@ function getAllApiKeys() {
 function getKeyFormat(configKey) {
   return apiKeyRegistry.get(configKey)?.keyFormat;
 }
+function getDisplayLabelForApiKey(configKey) {
+  const apiKey = apiKeyRegistry.get(configKey);
+  if (!apiKey)
+    return configKey;
+  const provider = [...providerRegistry2.values()].find((p) => p.apiKey === configKey && p.displayName && p.gateway);
+  if (provider?.displayName && provider.gateway) {
+    return `${provider.displayName} (via ${provider.gateway})`;
+  }
+  return apiKey.label;
+}
 function getAllProviders() {
   return [...providerRegistry2.values()];
 }
@@ -24139,7 +24148,7 @@ var init_FalProvider = __esm({
     VALID_ASPECTS = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16", "auto"];
     FalProvider = class {
       constructor() {
-        this.id = "fal";
+        this.id = "seedance";
         this.name = "fal.ai (Seedance 2.0)";
         this.description = "fal.ai hosting ByteDance Seedance 2.0 \u2014 Artificial Analysis #2 on both text-to-video and image-to-video leaderboards";
         this.capabilities = ["text-to-video", "image-to-video"];
@@ -24238,11 +24247,13 @@ var init_fal = __esm({
     init_FalProvider();
     init_define_provider();
     defineProvider({
-      id: "fal",
-      label: "fal.ai (Seedance 2.0)",
+      id: "seedance",
+      label: "Seedance 2.0",
       displayName: "Seedance 2.0",
       gateway: "fal.ai",
-      aliases: ["seedance"],
+      // `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).
+      aliases: ["fal"],
       models: ["seedance-2.0", "seedance-2.0-fast"],
       capabilities: ["text-to-video", "image-to-video", "native-audio"],
       apiKey: "fal",
@@ -24943,6 +24954,7 @@ __export(dist_exports, {
   getAllProviders: () => getAllProviders,
   getBestProviderForCapability: () => getBestProviderForCapability,
   getCommandKeyMap: () => getCommandKeyMap,
+  getDisplayLabelForApiKey: () => getDisplayLabelForApiKey,
   getKeyFormat: () => getKeyFormat,
   getProviderEnvVars: () => getProviderEnvVars,
   getProvidersFor: () => getProvidersFor,
@@ -25409,44 +25421,86 @@ var init_schema = __esm({
 import { resolve as resolve2 } from "node:path";
 import { homedir } from "node:os";
 import { readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2, access as access2 } from "node:fs/promises";
-async function loadConfig() {
+function getProjectConfigDir(cwd = process.cwd()) {
+  return resolve2(cwd, ".vibeframe");
+}
+function getProjectConfigPath(cwd = process.cwd()) {
+  return resolve2(getProjectConfigDir(cwd), "config.yaml");
+}
+function getConfigPath(scope, cwd) {
+  return scope === "project" ? getProjectConfigPath(cwd) : USER_CONFIG_PATH;
+}
+async function fileExists(path14) {
   try {
-    await access2(CONFIG_PATH);
-    const content = await readFile2(CONFIG_PATH, "utf-8");
-    const config4 = (0, import_yaml2.parse)(content);
-    const defaults = createDefaultConfig();
-    return {
-      ...defaults,
-      ...config4,
-      llm: { ...defaults.llm, ...config4.llm },
-      providers: { ...defaults.providers, ...config4.providers },
-      defaults: { ...defaults.defaults, ...config4.defaults },
-      repl: { ...defaults.repl, ...config4.repl }
-    };
+    await access2(path14);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function applyDefaults(parsed) {
+  const defaults = createDefaultConfig();
+  return {
+    ...defaults,
+    ...parsed,
+    llm: { ...defaults.llm, ...parsed.llm },
+    providers: { ...defaults.providers, ...parsed.providers },
+    defaults: { ...defaults.defaults, ...parsed.defaults },
+    repl: { ...defaults.repl, ...parsed.repl }
+  };
+}
+async function readConfigFile(path14) {
+  if (!await fileExists(path14)) return null;
+  try {
+    const content = await readFile2(path14, "utf-8");
+    const parsed = (0, import_yaml2.parse)(content);
+    return applyDefaults(parsed);
   } catch {
     return null;
   }
 }
+async function loadConfig(options = {}) {
+  const { scope, cwd, merge: merge3 } = options;
+  if (merge3) {
+    const user = await readConfigFile(USER_CONFIG_PATH);
+    const project2 = await readConfigFile(getProjectConfigPath(cwd));
+    if (!user && !project2) return null;
+    if (!user) return project2;
+    if (!project2) return user;
+    return {
+      ...user,
+      ...project2,
+      llm: { ...user.llm, ...project2.llm },
+      providers: { ...user.providers, ...project2.providers },
+      defaults: { ...user.defaults, ...project2.defaults },
+      repl: { ...user.repl, ...project2.repl }
+    };
+  }
+  if (scope) {
+    return readConfigFile(getConfigPath(scope, cwd));
+  }
+  const project = await readConfigFile(getProjectConfigPath(cwd));
+  if (project) return project;
+  return readConfigFile(USER_CONFIG_PATH);
+}
 async function getApiKeyFromConfig(providerKey) {
   const config4 = await loadConfig();
   if (config4?.providers[providerKey]) {
     return config4.providers[providerKey];
   }
   const envVar = PROVIDER_ENV_VARS[providerKey];
-  if (envVar) {
-    return process.env[envVar];
-  }
+  if (envVar) return process.env[envVar];
   return void 0;
 }
-var import_yaml2, CONFIG_DIR, CONFIG_PATH;
+var import_yaml2, USER_CONFIG_DIR, USER_CONFIG_PATH;
 var init_config = __esm({
   "../cli/src/config/index.ts"() {
     "use strict";
     import_yaml2 = __toESM(require_dist(), 1);
     init_schema();
     init_schema();
-    CONFIG_DIR = resolve2(homedir(), ".vibeframe");
-    CONFIG_PATH = resolve2(CONFIG_DIR, "config.yaml");
+    USER_CONFIG_DIR = resolve2(homedir(), ".vibeframe");
+    USER_CONFIG_PATH = resolve2(USER_CONFIG_DIR, "config.yaml");
   }
 });
 
@@ -127444,7 +127498,7 @@ var require_typescript2 = __commonJS({
         rangeStartIsOnSameLineAsRangeEnd: () => rangeStartIsOnSameLineAsRangeEnd,
         rangeStartPositionsAreOnSameLine: () => rangeStartPositionsAreOnSameLine,
         readBuilderProgram: () => readBuilderProgram,
-        readConfigFile: () => readConfigFile,
+        readConfigFile: () => readConfigFile2,
         readJson: () => readJson,
         readJsonConfigFile: () => readJsonConfigFile,
         readJsonOrUndefined: () => readJsonOrUndefined,
@@ -134068,7 +134122,7 @@ ${lanes.join("\n")}
             watchDirectory,
             preferNonRecursiveWatch: !fsSupportsRecursiveFsWatch,
             resolvePath: (path14) => _path.resolve(path14),
-            fileExists,
+            fileExists: fileExists2,
             directoryExists,
             getAccessibleFileSystemEntries,
             createDirectory(directoryName) {
@@ -134230,7 +134284,7 @@ ${lanes.join("\n")}
             if (platform === "win32" || platform === "win64") {
               return false;
             }
-            return !fileExists(swapCase(__filename));
+            return !fileExists2(swapCase(__filename));
           }
           function swapCase(s) {
             return s.replace(/\w/g, (ch) => {
@@ -134363,7 +134417,7 @@ ${lanes.join("\n")}
                 return false;
             }
           }
-          function fileExists(path14) {
+          function fileExists2(path14) {
             return fileSystemEntryExists(
               path14,
               0
@@ -171058,7 +171112,7 @@ ${lanes.join("\n")}
           watchOptionsToExtend
         );
       }
-      function readConfigFile(fileName, readFile34) {
+      function readConfigFile2(fileName, readFile34) {
         const textOrDiagnostic = tryReadFile(fileName, readFile34);
         return isString3(textOrDiagnostic) ? parseConfigFileTextToJson(fileName, textOrDiagnostic) : { config: {}, error: textOrDiagnostic };
       }
@@ -260189,7 +260243,7 @@ ${lanes.join("\n")}
         const getCanonicalFileName = createGetCanonicalFileName(useCaseSensitiveFileNames2);
         return {
           useCaseSensitiveFileNames: useCaseSensitiveFileNames2,
-          fileExists,
+          fileExists: fileExists2,
           readFile: (path14, encoding) => host.readFile(path14, encoding),
           directoryExists: host.directoryExists && directoryExists,
           getDirectories,
@@ -260275,7 +260329,7 @@ ${lanes.join("\n")}
           }
           return host.writeFile(fileName, data, writeByteOrderMark);
         }
-        function fileExists(fileName) {
+        function fileExists2(fileName) {
           const path14 = toPath3(fileName);
           const result = getCachedFileSystemEntriesForBaseDir(path14);
           return result && hasEntry(result.sortedAndCanonicalizedFiles, getCanonicalFileName(getBaseNameOfFileName(fileName))) || host.fileExists(fileName);
@@ -260391,10 +260445,10 @@ ${lanes.join("\n")}
             clearFirstAncestorEntry(filePath);
           }
         }
-        function updateFilesOfFileSystemEntry(parentResult, baseName, fileExists2) {
+        function updateFilesOfFileSystemEntry(parentResult, baseName, fileExists22) {
           const canonicalizedFiles = parentResult.sortedAndCanonicalizedFiles;
           const canonicalizedBaseName = getCanonicalFileName(baseName);
-          if (fileExists2) {
+          if (fileExists22) {
             if (insertSorted(canonicalizedFiles, canonicalizedBaseName, compareStringsCaseSensitive)) {
               parentResult.files.push(baseName);
             }
@@ -260694,10 +260748,10 @@ ${lanes.join("\n")}
       function closeFileWatcherOf(objWithWatcher) {
         objWithWatcher.watcher.close();
       }
-      function findConfigFile(searchPath, fileExists, configName = "tsconfig.json") {
+      function findConfigFile(searchPath, fileExists2, configName = "tsconfig.json") {
         return forEachAncestorDirectory(searchPath, (ancestor) => {
           const fileName = combinePaths(ancestor, configName);
-          return fileExists(fileName) ? fileName : void 0;
+          return fileExists2(fileName) ? fileName : void 0;
         });
       }
       function resolveTripleslashReference(moduleName, containingFile) {
@@ -261304,14 +261358,14 @@ ${lanes.join("\n")}
         }
         return { file, pos, end, packageId };
       }
-      function isProgramUptoDate(program2, rootFileNames, newOptions, getSourceVersion, fileExists, hasInvalidatedResolutions, hasInvalidatedLibResolutions, hasChangedAutomaticTypeDirectiveNames, getParsedCommandLine, projectReferences) {
+      function isProgramUptoDate(program2, rootFileNames, newOptions, getSourceVersion, fileExists2, hasInvalidatedResolutions, hasInvalidatedLibResolutions, hasChangedAutomaticTypeDirectiveNames, getParsedCommandLine, projectReferences) {
         if (!program2 || (hasChangedAutomaticTypeDirectiveNames == null ? void 0 : hasChangedAutomaticTypeDirectiveNames())) return false;
         if (!arrayIsEqualTo(program2.getRootFileNames(), rootFileNames)) return false;
         let seenResolvedRefs;
         if (!arrayIsEqualTo(program2.getProjectReferences(), projectReferences, projectReferenceUptoDate)) return false;
         if (program2.getSourceFiles().some(sourceFileNotUptoDate)) return false;
         const missingPaths = program2.getMissingFilePaths();
-        if (missingPaths && forEachEntry(missingPaths, fileExists)) return false;
+        if (missingPaths && forEachEntry(missingPaths, fileExists2)) return false;
         const currentOptions = program2.getCompilerOptions();
         if (!compareDataObjects(currentOptions, newOptions)) return false;
         if (program2.resolvedLibReferences && forEachEntry(program2.resolvedLibReferences, (_value, libFileName) => hasInvalidatedLibResolutions(libFileName))) return false;
@@ -261639,7 +261693,7 @@ ${lanes.join("\n")}
         let mapSourceFileToResolvedRef;
         let mapOutputFileToResolvedRef;
         const useSourceOfProjectReferenceRedirect = !!((_d = host.useSourceOfProjectReferenceRedirect) == null ? void 0 : _d.call(host)) && !options.disableSourceOfProjectReferenceRedirect;
-        const { onProgramCreateComplete, fileExists, directoryExists } = updateHostForUseSourceOfProjectReferenceRedirect({
+        const { onProgramCreateComplete, fileExists: fileExists2, directoryExists } = updateHostForUseSourceOfProjectReferenceRedirect({
           compilerHost: host,
           getSymlinkCache,
           useSourceOfProjectReferenceRedirect,
@@ -261873,7 +261927,7 @@ ${lanes.join("\n")}
           getImpliedNodeFormatForEmit: getImpliedNodeFormatForEmit2,
           shouldTransformImportCall,
           emitBuildInfo,
-          fileExists,
+          fileExists: fileExists2,
           readFile: readFile34,
           directoryExists,
           getSymlinkCache,
@@ -264372,8 +264426,8 @@ ${lanes.join("\n")}
         const originalDirectoryExists = host.compilerHost.directoryExists;
         const originalGetDirectories = host.compilerHost.getDirectories;
         const originalRealpath = host.compilerHost.realpath;
-        if (!host.useSourceOfProjectReferenceRedirect) return { onProgramCreateComplete: noop3, fileExists };
-        host.compilerHost.fileExists = fileExists;
+        if (!host.useSourceOfProjectReferenceRedirect) return { onProgramCreateComplete: noop3, fileExists: fileExists2 };
+        host.compilerHost.fileExists = fileExists2;
         let directoryExists;
         if (originalDirectoryExists) {
           directoryExists = host.compilerHost.directoryExists = (path14) => {
@@ -264412,13 +264466,13 @@ ${lanes.join("\n")}
             return ((_a7 = host.getSymlinkCache().getSymlinkedFiles()) == null ? void 0 : _a7.get(host.toPath(s))) || originalRealpath.call(host.compilerHost, s);
           };
         }
-        return { onProgramCreateComplete, fileExists, directoryExists };
+        return { onProgramCreateComplete, fileExists: fileExists2, directoryExists };
         function onProgramCreateComplete() {
           host.compilerHost.fileExists = originalFileExists;
           host.compilerHost.directoryExists = originalDirectoryExists;
           host.compilerHost.getDirectories = originalGetDirectories;
         }
-        function fileExists(file) {
+        function fileExists2(file) {
           if (originalFileExists.call(host.compilerHost, file)) return true;
           if (!host.getResolvedProjectReferences()) return false;
           if (!isDeclarationFileName(file)) return false;
@@ -268770,7 +268824,7 @@ ${lanes.join("\n")}
         compilerHost.getSourceFile = (fileName, ...args) => getVersionedSourceFileByPath(fileName, toPath3(fileName), ...args);
         compilerHost.getSourceFileByPath = getVersionedSourceFileByPath;
         compilerHost.getNewLine = () => newLine;
-        compilerHost.fileExists = fileExists;
+        compilerHost.fileExists = fileExists2;
         compilerHost.onReleaseOldSourceFile = onReleaseOldSourceFile;
         compilerHost.onReleaseParsedCommandLine = onReleaseParsedCommandLine;
         compilerHost.toPath = toPath3;
@@ -268974,7 +269028,7 @@ ${lanes.join("\n")}
         function isFilePresenceUnknownOnHost(hostSourceFile) {
           return typeof hostSourceFile.version === "boolean";
         }
-        function fileExists(fileName) {
+        function fileExists2(fileName) {
           const path14 = toPath3(fileName);
           if (isFileMissingOnHost(sourceFilesCache.get(path14))) {
             return false;
@@ -273732,12 +273786,12 @@ ${lanes.join("\n")}
         return nodeCoreModules.has(moduleName) ? "node" : moduleName;
       }
       function loadSafeList(host, safeListPath) {
-        const result = readConfigFile(safeListPath, (path14) => host.readFile(path14));
+        const result = readConfigFile2(safeListPath, (path14) => host.readFile(path14));
         return new Map(Object.entries(result.config));
       }
       function loadTypesMap(host, typesMapPath) {
         var _a7;
-        const result = readConfigFile(typesMapPath, (path14) => host.readFile(path14));
+        const result = readConfigFile2(typesMapPath, (path14) => host.readFile(path14));
         if ((_a7 = result.config) == null ? void 0 : _a7.simpleMap) {
           return new Map(Object.entries(result.config.simpleMap));
         }
@@ -273813,7 +273867,7 @@ ${lanes.join("\n")}
           let manifestTypingNames;
           if (host.fileExists(manifestPath)) {
             filesToWatch2.push(manifestPath);
-            manifest2 = readConfigFile(manifestPath, (path14) => host.readFile(path14)).config;
+            manifest2 = readConfigFile2(manifestPath, (path14) => host.readFile(path14)).config;
             manifestTypingNames = flatMap([manifest2.dependencies, manifest2.devDependencies, manifest2.optionalDependencies, manifest2.peerDependencies], getOwnKeys);
             addInferredTypings(manifestTypingNames, `Typing names in '${manifestPath}' dependencies`);
           }
@@ -273847,7 +273901,7 @@ ${lanes.join("\n")}
           if (log2) log2(`Searching for typing names in ${packagesFolderPath}; all files: ${JSON.stringify(dependencyManifestNames)}`);
           for (const manifestPath2 of dependencyManifestNames) {
             const normalizedFileName = normalizePath(manifestPath2);
-            const result2 = readConfigFile(normalizedFileName, (path14) => host.readFile(path14));
+            const result2 = readConfigFile2(normalizedFileName, (path14) => host.readFile(path14));
             const manifest22 = result2.config;
             if (!manifest22.name) {
               continue;
@@ -275943,15 +275997,15 @@ ${lanes.join("\n")}
         }
         return true;
       }
-      function getMappedLocation(location, sourceMapper, fileExists) {
+      function getMappedLocation(location, sourceMapper, fileExists2) {
         const mapsTo = sourceMapper.tryGetSourcePosition(location);
-        return mapsTo && (!fileExists || fileExists(normalizePath(mapsTo.fileName)) ? mapsTo : void 0);
+        return mapsTo && (!fileExists2 || fileExists2(normalizePath(mapsTo.fileName)) ? mapsTo : void 0);
       }
-      function getMappedDocumentSpan(documentSpan, sourceMapper, fileExists) {
+      function getMappedDocumentSpan(documentSpan, sourceMapper, fileExists2) {
         const { fileName, textSpan } = documentSpan;
-        const newPosition = getMappedLocation({ fileName, pos: textSpan.start }, sourceMapper, fileExists);
+        const newPosition = getMappedLocation({ fileName, pos: textSpan.start }, sourceMapper, fileExists2);
         if (!newPosition) return void 0;
-        const newEndPosition = getMappedLocation({ fileName, pos: textSpan.start + textSpan.length }, sourceMapper, fileExists);
+        const newEndPosition = getMappedLocation({ fileName, pos: textSpan.start + textSpan.length }, sourceMapper, fileExists2);
         const newLength = newEndPosition ? newEndPosition.pos - newPosition.pos : textSpan.length;
         return {
           fileName: newPosition.fileName,
@@ -275961,20 +276015,20 @@ ${lanes.join("\n")}
           },
           originalFileName: documentSpan.fileName,
           originalTextSpan: documentSpan.textSpan,
-          contextSpan: getMappedContextSpan(documentSpan, sourceMapper, fileExists),
+          contextSpan: getMappedContextSpan(documentSpan, sourceMapper, fileExists2),
           originalContextSpan: documentSpan.contextSpan
         };
       }
-      function getMappedContextSpan(documentSpan, sourceMapper, fileExists) {
+      function getMappedContextSpan(documentSpan, sourceMapper, fileExists2) {
         const contextSpanStart = documentSpan.contextSpan && getMappedLocation(
           { fileName: documentSpan.fileName, pos: documentSpan.contextSpan.start },
           sourceMapper,
-          fileExists
+          fileExists2
         );
         const contextSpanEnd = documentSpan.contextSpan && getMappedLocation(
           { fileName: documentSpan.fileName, pos: documentSpan.contextSpan.start + documentSpan.contextSpan.length },
           sourceMapper,
-          fileExists
+          fileExists2
         );
         return contextSpanStart && contextSpanEnd ? { start: contextSpanStart.pos, length: contextSpanEnd.pos - contextSpanStart.pos } : void 0;
       }
@@ -322947,7 +323001,7 @@ ${options.prefix}` : "\n" : options.prefix
         rangeStartIsOnSameLineAsRangeEnd: () => rangeStartIsOnSameLineAsRangeEnd,
         rangeStartPositionsAreOnSameLine: () => rangeStartPositionsAreOnSameLine,
         readBuilderProgram: () => readBuilderProgram,
-        readConfigFile: () => readConfigFile,
+        readConfigFile: () => readConfigFile2,
         readJson: () => readJson,
         readJsonConfigFile: () => readJsonConfigFile,
         readJsonOrUndefined: () => readJsonOrUndefined,
@@ -324458,9 +324512,9 @@ ${options.prefix}` : "\n" : options.prefix
             this.markContainingProjectsAsDirty();
           }
         }
-        close(fileExists = true) {
+        close(fileExists2 = true) {
           this.textStorage.isOpen = false;
-          if (fileExists && this.textStorage.scheduleReloadIfNeeded()) {
+          if (fileExists2 && this.textStorage.scheduleReloadIfNeeded()) {
             this.markContainingProjectsAsDirty();
           }
         }
@@ -325564,11 +325618,11 @@ ${options.prefix}` : "\n" : options.prefix
           this.rootFilesMap.set(path14, { fileName });
           this.markAsDirty();
         }
-        removeFile(info, fileExists, detachFromProject) {
+        removeFile(info, fileExists2, detachFromProject) {
           if (this.isRoot(info)) {
             this.removeRoot(info);
           }
-          if (fileExists) {
+          if (fileExists2) {
             this.resolutionCache.removeResolutionsOfFile(info.path);
           } else {
             this.resolutionCache.invalidateResolutionOfFile(info.path);
@@ -328438,8 +328492,8 @@ ${options.prefix}` : "\n" : options.prefix
          */
         closeOpenFile(info, skipAssignOrphanScriptInfosToInferredProject) {
           var _a7;
-          const fileExists = info.isDynamic ? false : this.host.fileExists(info.fileName);
-          info.close(fileExists);
+          const fileExists2 = info.isDynamic ? false : this.host.fileExists(info.fileName);
+          info.close(fileExists2);
           this.stopWatchingConfigFilesForScriptInfo(info);
           const canonicalFileName = this.toCanonicalFileName(info.fileName);
           if (this.openFilesWithNonRootedDiskPath.get(canonicalFileName) === info) {
@@ -328465,7 +328519,7 @@ ${options.prefix}` : "\n" : options.prefix
               }
               p.removeFile(
                 info,
-                fileExists,
+                fileExists2,
                 /*detachFromProject*/
                 true
               );
@@ -328481,7 +328535,7 @@ ${options.prefix}` : "\n" : options.prefix
           if (!skipAssignOrphanScriptInfosToInferredProject && ensureProjectsForOpenFiles) {
             this.assignOrphanScriptInfosToInferredProject();
           }
-          if (fileExists) {
+          if (fileExists2) {
             this.watchClosedScriptInfo(info);
           } else {
             this.handleDeletedFile(
@@ -459850,9 +459904,9 @@ var init_ai_script_pipeline = __esm({
 import { resolve as resolve50 } from "node:path";
 import { readFile as readFile25, writeFile as writeFile33 } from "node:fs/promises";
 function registerVideoCommand(parent) {
-  parent.command("video").alias("vid").description("Generate video using AI (Seedance, Grok, Kling, Runway, or Veo)").argument("[prompt]", "Text prompt describing the video (interactive if omitted)").option("-p, --provider <provider>", "Provider: seedance (ByteDance Seedance 2.0 via fal.ai), grok, kling, runway, veo. `fal` is a backwards-compatible alias for seedance.").option("-k, --api-key <key>", "API key (or set FAL_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(
+  parent.command("video").alias("vid").description("Generate video using AI (Seedance, Grok, Kling, Runway, or Veo)").argument("[prompt]", "Text prompt describing the video (interactive if omitted)").option("-p, --provider <provider>", "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)").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 (`fal` alias supported); Kling accepts 5 or 10; Veo maps to 6 or 8.",
+    "Duration in seconds. Seedance accepts 4-15; Kling accepts 5 or 10; Veo maps to 6 or 8.",
     "5"
   ).option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1 (auto-detected from image if omitted)").option("--seed <number>", "Random seed for reproducibility (Runway only)").option("--mode <mode>", "Generation mode: std or pro (Kling only)", "std").option("--seedance-model <model>", "Seedance variant: quality or fast (fal.ai only)", "quality").option("--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:
@@ -459898,8 +459952,7 @@ Examples:
         veo: "GOOGLE_API_KEY",
         kling: "KLING_API_KEY",
         runway: "RUNWAY_API_SECRET",
-        seedance: "FAL_KEY",
-        fal: "FAL_KEY"
+        seedance: "FAL_KEY"
       };
       let provider;
       if (options.provider) {
@@ -459908,10 +459961,18 @@ Examples:
           exitWithError(
             usageError(
               `Invalid provider: ${provider}`,
-              "Available providers: seedance, grok, kling, runway, veo. `fal` is a backwards-compatible alias for seedance."
+              "Available providers: seedance, grok, kling, runway, veo. `fal` is a deprecated alias for seedance."
             )
           );
         }
+        if (provider === "fal") {
+          process.stderr.write(
+            source_default.yellow(
+              "Note: `-p fal` is a deprecated alias for `-p seedance` and will be removed in 1.0.\n"
+            )
+          );
+          provider = "seedance";
+        }
         if (videoEnvMap[provider] && !hasApiKey(videoEnvMap[provider]) && !options.apiKey) {
           const resolved = resolveProvider("video");
           if (resolved) {
@@ -459971,7 +460032,7 @@ Examples:
           data: {
             params: {
               prompt: prompt3,
-              provider: provider === "fal" ? "seedance" : provider,
+              provider,
               duration: options.duration,
               ratio: options.ratio,
               image: options.image,
@@ -459990,16 +460051,14 @@ Examples:
         kling: "KLING_API_KEY",
         veo: "GOOGLE_API_KEY",
         grok: "XAI_API_KEY",
-        seedance: "FAL_KEY",
-        fal: "FAL_KEY"
+        seedance: "FAL_KEY"
       };
       const providerNameMap = {
         runway: "Runway",
         kling: "Kling",
         veo: "Veo",
         grok: "Grok",
-        seedance: "Seedance 2.0 via fal.ai",
-        fal: "Seedance 2.0 via fal.ai"
+        seedance: "Seedance 2.0 via fal.ai"
       };
       const envKey = envKeyMap[provider];
       const providerName = providerNameMap[provider];
@@ -460218,7 +460277,7 @@ Examples:
           },
           3e5
         );
-      } else if (provider === "fal" || provider === "seedance") {
+      } else if (provider === "seedance") {
         const fal = new FalProvider();
         await fal.initialize({ apiKey });
         let falImage = referenceImage;

package/package.json

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