@roarpeng/graphflow 1.7.0 → 1.7.5

package/dist/graph/language-indexers/tree-sitter-loader.js

@@ -9,6 +9,8 @@ const node_module_1 = require("node:module");
 const requireFn = (0, node_module_1.createRequire)(__filename);
 let initPromise = null;
 const WASM_CACHE_DIR = (0, node_path_1.join)(process.cwd(), ".graphflow-cache", "wasm");
+const languageLoadPromises = new Map();
+const parserPool = new Map();
 function wasmFileName(language) {
     return `tree-sitter-${language}.wasm`;
 }
@@ -65,18 +67,36 @@ function resolveTreeSitterWasmsPath(fileName) {
     }
 }
 async function getTreeSitterParser(language) {
+    const pooledParser = parserPool.get(language);
+    if (pooledParser) {
+        return pooledParser;
+    }
+    const parserPromise = createTreeSitterParser(language);
+    parserPool.set(language, parserPromise);
+    return parserPromise;
+}
+async function createTreeSitterParser(language) {
     if (!initPromise) {
         initPromise = Parser.init();
     }
     await initPromise;
+    const parser = new Parser();
+    const lang = await loadTreeSitterLanguage(language);
+    parser.setLanguage(lang);
+    return parser;
+}
+async function loadTreeSitterLanguage(language) {
+    const cachedLanguage = languageLoadPromises.get(language);
+    if (cachedLanguage) {
+        return cachedLanguage;
+    }
     const wasmPath = resolveBundledWasmPath(language);
     if (!wasmPath) {
         throw new Error(`Bundled tree-sitter grammar not found for "${language}". ` +
             "Reinstall @roarpeng/graphflow or run `npm run wasm:bundle` in the GraphFlow source tree.");
     }
-    const parser = new Parser();
-    const lang = await Parser.Language.load(wasmPath);
-    parser.setLanguage(lang);
-    return parser;
+    const languagePromise = Parser.Language.load(wasmPath);
+    languageLoadPromises.set(language, languagePromise);
+    return languagePromise;
 }
 //# sourceMappingURL=tree-sitter-loader.js.map

package/dist/graph/language-indexers/tree-sitter-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"tree-sitter-loader.js","sourceRoot":"","sources":["../../../src/graph/language-indexers/tree-sitter-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tree-sitter-loader.js","sourceRoot":"","sources":["../../../src/graph/language-indexers/tree-sitter-loader.ts"],"names":[],"mappings":"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"}

package/dist/graph/query-expand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-expand.d.ts","sourceRoot":"","sources":["../../src/graph/query-expand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,SAAS,EAAE,CAAC,CAsBtB"}
+{"version":3,"file":"query-expand.d.ts","sourceRoot":"","sources":["../../src/graph/query-expand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,SAAS,EAAE,CAAC,CAwBtB"}

package/dist/graph/query-expand.js

@@ -12,6 +12,7 @@ async function collectExpandedKeywordHits(client, query, workspaceRoot, englishQ
     const queries = (0, graph_utils_js_1.expandSearchQueries)(query, workspaceRoot, englishQuery);
     const baseScoreTokens = (0, graph_utils_js_1.buildSearchScoreTokens)(query, englishQuery);
     const matchQueries = englishQuery?.trim() ? [query, englishQuery.trim()] : [query];
+    const pathHints = (0, graph_utils_js_1.extractPathTokens)(workspaceRoot);
     const rankings = [];
     for (const q of queries) {
         const hits = await client.queryByKeyword(q);
@@ -19,6 +20,7 @@ async function collectExpandedKeywordHits(client, query, workspaceRoot, englishQ
         rankings.push((0, graph_utils_js_2.rankNodesForContextQuery)(hits, query, {
             scoreTokens: scoreTokens.length > 0 ? scoreTokens : baseScoreTokens,
             matchQueries,
+            pathHints,
         }));
     }
     if (rankings.length <= 1) {

package/dist/graph/query-expand.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-expand.js","sourceRoot":"","sources":["../../src/graph/query-expand.ts"],"names":[],"mappings":";;AAUA,gEA2BC;AAnCD,6DAAiE;AACjE,qDAA+E;AAC/E,qDAA4D;AAE5D;;;GAGG;AACI,KAAK,UAAU,0BAA0B,CAC9C,MAAmB,EACnB,KAAa,EACb,aAAsB,EACtB,YAAqB;IAErB,MAAM,OAAO,GAAG,IAAA,oCAAmB,EAAC,KAAK,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,eAAe,GAAG,IAAA,uCAAsB,EAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAA,uCAAsB,EAAC,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QACnE,QAAQ,CAAC,IAAI,CACX,IAAA,yCAAwB,EAAC,IAAI,EAAE,KAAK,EAAE;YACpC,WAAW,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe;YACnE,YAAY;SACb,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,IAAA,oCAAoB,EAAC,QAAQ,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"query-expand.js","sourceRoot":"","sources":["../../src/graph/query-expand.ts"],"names":[],"mappings":";;AAUA,gEA6BC;AArCD,6DAAiE;AACjE,qDAAkG;AAClG,qDAA4D;AAE5D;;;GAGG;AACI,KAAK,UAAU,0BAA0B,CAC9C,MAAmB,EACnB,KAAa,EACb,aAAsB,EACtB,YAAqB;IAErB,MAAM,OAAO,GAAG,IAAA,oCAAmB,EAAC,KAAK,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,eAAe,GAAG,IAAA,uCAAsB,EAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnF,MAAM,SAAS,GAAG,IAAA,kCAAiB,EAAC,aAAa,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAA,uCAAsB,EAAC,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QACnE,QAAQ,CAAC,IAAI,CACX,IAAA,yCAAwB,EAAC,IAAI,EAAE,KAAK,EAAE;YACpC,WAAW,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe;YACnE,YAAY;YACZ,SAAS;SACV,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,IAAA,oCAAoB,EAAC,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { orchestrate, type OrchestrateOptions } from "./core/orchestrator";
-export { runTask, runTaskResult, reportOutcome, submitAgentInsightResult, mergeAgentInsightResult, previewContext, expandAnchor, getGraphFlowSettings, getSettingsPanelStatus, testRoutingAndIndexGraph, indexGraphFromSettings, validateSettingsForGraphIndex, validateSettingsForRouting, saveGraphFlowSettings, indexGraph, inspectGraph, getSkillInsights, resolveConfig, diagnoseRouting, diagnoseRoutingResult, planAndBrainstorm, planAndBrainstormResult, assertGraphFlowRuntime, detectInstalledAgents, formatModelConfigGuide, installMcpToDetectedAgents, runLearningNightly, runLearningNightlyResult, startFileWatcherIfEnabled, } from "./surfaces/cli/runtime";
+export { runTask, runTaskResult, reportOutcome, submitAgentInsightResult, mergeAgentInsightResult, previewContext, expandAnchor, getGraphFlowSettings, getSettingsPanelStatus, testRoutingAndIndexGraph, indexGraphFromSettings, validateSettingsForGraphIndex, validateSettingsForRouting, saveGraphFlowSettings, indexGraph, inspectGraph, getSkillInsights, resolveConfig, diagnoseRouting, diagnoseRoutingResult, planAndBrainstorm, planAndBrainstormResult, assertGraphFlowRuntime, detectInstalledAgents, formatModelConfigGuide, installMcpToDetectedAgents, repairUnsafeWindowsMcpCommands, runLearningNightly, runLearningNightlyResult, startFileWatcherIfEnabled, } from "./surfaces/cli/runtime";
 export type { GraphFlowRuntime, GraphFlowRuntimeModule, LearningNightlyResult } from "./surfaces/cli/runtime";
 export { parseCliOptions, formatCliResult, type CliCommandResult } from "./surfaces/cli/output";
 export { createMcpServer, executeToolCall, getToolDefinitions, startStdioServer, } from "./surfaces/mcp/server";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACL,OAAO,EACP,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,0BAA0B,EAC1B,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAC3F,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/K,OAAO,EACL,eAAe,EACf,WAAW,EACX,UAAU,EACV,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACL,OAAO,EACP,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,0BAA0B,EAC1B,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAC3F,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/K,OAAO,EACL,eAAe,EACf,WAAW,EACX,UAAU,EACV,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listSkills = exports.invokeSkill = exports.graphflowSkills = exports.validateConfigDetailed = exports.loadConfigSafe = exports.loadConfig = exports.validateConfig = exports.createGraphClient = exports.planInsightResult = exports.summarizeInsightForContext = exports.buildAgentInsightWorkItems = exports.buildAgentDelegatedPlanInsight = exports.hasUsableLlmProvider = exports.startStdioServer = exports.getToolDefinitions = exports.executeToolCall = exports.createMcpServer = exports.formatCliResult = exports.parseCliOptions = exports.startFileWatcherIfEnabled = exports.runLearningNightlyResult = exports.runLearningNightly = exports.installMcpToDetectedAgents = exports.formatModelConfigGuide = exports.detectInstalledAgents = exports.assertGraphFlowRuntime = exports.planAndBrainstormResult = exports.planAndBrainstorm = exports.diagnoseRoutingResult = exports.diagnoseRouting = exports.resolveConfig = exports.getSkillInsights = exports.inspectGraph = exports.indexGraph = exports.saveGraphFlowSettings = exports.validateSettingsForRouting = exports.validateSettingsForGraphIndex = exports.indexGraphFromSettings = exports.testRoutingAndIndexGraph = exports.getSettingsPanelStatus = exports.getGraphFlowSettings = exports.expandAnchor = exports.previewContext = exports.mergeAgentInsightResult = exports.submitAgentInsightResult = exports.reportOutcome = exports.runTaskResult = exports.runTask = exports.orchestrate = void 0;
+exports.listSkills = exports.invokeSkill = exports.graphflowSkills = exports.validateConfigDetailed = exports.loadConfigSafe = exports.loadConfig = exports.validateConfig = exports.createGraphClient = exports.planInsightResult = exports.summarizeInsightForContext = exports.buildAgentInsightWorkItems = exports.buildAgentDelegatedPlanInsight = exports.hasUsableLlmProvider = exports.startStdioServer = exports.getToolDefinitions = exports.executeToolCall = exports.createMcpServer = exports.formatCliResult = exports.parseCliOptions = exports.startFileWatcherIfEnabled = exports.runLearningNightlyResult = exports.runLearningNightly = exports.repairUnsafeWindowsMcpCommands = exports.installMcpToDetectedAgents = exports.formatModelConfigGuide = exports.detectInstalledAgents = exports.assertGraphFlowRuntime = exports.planAndBrainstormResult = exports.planAndBrainstorm = exports.diagnoseRoutingResult = exports.diagnoseRouting = exports.resolveConfig = exports.getSkillInsights = exports.inspectGraph = exports.indexGraph = exports.saveGraphFlowSettings = exports.validateSettingsForRouting = exports.validateSettingsForGraphIndex = exports.indexGraphFromSettings = exports.testRoutingAndIndexGraph = exports.getSettingsPanelStatus = exports.getGraphFlowSettings = exports.expandAnchor = exports.previewContext = exports.mergeAgentInsightResult = exports.submitAgentInsightResult = exports.reportOutcome = exports.runTaskResult = exports.runTask = exports.orchestrate = void 0;
 var orchestrator_1 = require("./core/orchestrator");
 Object.defineProperty(exports, "orchestrate", { enumerable: true, get: function () { return orchestrator_1.orchestrate; } });
 var runtime_1 = require("./surfaces/cli/runtime");
@@ -30,6 +30,7 @@ Object.defineProperty(exports, "assertGraphFlowRuntime", { enumerable: true, get
 Object.defineProperty(exports, "detectInstalledAgents", { enumerable: true, get: function () { return runtime_1.detectInstalledAgents; } });
 Object.defineProperty(exports, "formatModelConfigGuide", { enumerable: true, get: function () { return runtime_1.formatModelConfigGuide; } });
 Object.defineProperty(exports, "installMcpToDetectedAgents", { enumerable: true, get: function () { return runtime_1.installMcpToDetectedAgents; } });
+Object.defineProperty(exports, "repairUnsafeWindowsMcpCommands", { enumerable: true, get: function () { return runtime_1.repairUnsafeWindowsMcpCommands; } });
 Object.defineProperty(exports, "runLearningNightly", { enumerable: true, get: function () { return runtime_1.runLearningNightly; } });
 Object.defineProperty(exports, "runLearningNightlyResult", { enumerable: true, get: function () { return runtime_1.runLearningNightlyResult; } });
 Object.defineProperty(exports, "startFileWatcherIfEnabled", { enumerable: true, get: function () { return runtime_1.startFileWatcherIfEnabled; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oDAA2E;AAAlE,2GAAA,WAAW,OAAA;AACpB,kDA8BgC;AA7B9B,kGAAA,OAAO,OAAA;AACP,wGAAA,aAAa,OAAA;AACb,wGAAA,aAAa,OAAA;AACb,mHAAA,wBAAwB,OAAA;AACxB,kHAAA,uBAAuB,OAAA;AACvB,yGAAA,cAAc,OAAA;AACd,uGAAA,YAAY,OAAA;AACZ,+GAAA,oBAAoB,OAAA;AACpB,iHAAA,sBAAsB,OAAA;AACtB,mHAAA,wBAAwB,OAAA;AACxB,iHAAA,sBAAsB,OAAA;AACtB,wHAAA,6BAA6B,OAAA;AAC7B,qHAAA,0BAA0B,OAAA;AAC1B,gHAAA,qBAAqB,OAAA;AACrB,qGAAA,UAAU,OAAA;AACV,uGAAA,YAAY,OAAA;AACZ,2GAAA,gBAAgB,OAAA;AAChB,wGAAA,aAAa,OAAA;AACb,0GAAA,eAAe,OAAA;AACf,gHAAA,qBAAqB,OAAA;AACrB,4GAAA,iBAAiB,OAAA;AACjB,kHAAA,uBAAuB,OAAA;AACvB,iHAAA,sBAAsB,OAAA;AACtB,gHAAA,qBAAqB,OAAA;AACrB,iHAAA,sBAAsB,OAAA;AACtB,qHAAA,0BAA0B,OAAA;AAC1B,6GAAA,kBAAkB,OAAA;AAClB,mHAAA,wBAAwB,OAAA;AACxB,oHAAA,yBAAyB,OAAA;AAG3B,gDAAgG;AAAvF,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AACzC,gDAK+B;AAJ7B,yGAAA,eAAe,OAAA;AACf,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAGlB,8DAAiE;AAAxD,wHAAA,oBAAoB,OAAA;AAC7B,4DAOiC;AAN/B,kIAAA,8BAA8B,OAAA;AAC9B,8HAAA,0BAA0B,OAAA;AAC1B,8HAAA,0BAA0B,OAAA;AAK5B,0DAA2F;AAAlF,4GAAA,iBAAiB,OAAA;AAC1B,yDAGgC;AAF9B,mHAAA,iBAAiB,OAAA;AAGnB,0CAA+K;AAAtK,wGAAA,cAAc,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAyB,gHAAA,sBAAsB,OAAA;AAClG,mCAqBkB;AApBhB,yGAAA,eAAe,OAAA;AACf,qGAAA,WAAW,OAAA;AACX,oGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oDAA2E;AAAlE,2GAAA,WAAW,OAAA;AACpB,kDA+BgC;AA9B9B,kGAAA,OAAO,OAAA;AACP,wGAAA,aAAa,OAAA;AACb,wGAAA,aAAa,OAAA;AACb,mHAAA,wBAAwB,OAAA;AACxB,kHAAA,uBAAuB,OAAA;AACvB,yGAAA,cAAc,OAAA;AACd,uGAAA,YAAY,OAAA;AACZ,+GAAA,oBAAoB,OAAA;AACpB,iHAAA,sBAAsB,OAAA;AACtB,mHAAA,wBAAwB,OAAA;AACxB,iHAAA,sBAAsB,OAAA;AACtB,wHAAA,6BAA6B,OAAA;AAC7B,qHAAA,0BAA0B,OAAA;AAC1B,gHAAA,qBAAqB,OAAA;AACrB,qGAAA,UAAU,OAAA;AACV,uGAAA,YAAY,OAAA;AACZ,2GAAA,gBAAgB,OAAA;AAChB,wGAAA,aAAa,OAAA;AACb,0GAAA,eAAe,OAAA;AACf,gHAAA,qBAAqB,OAAA;AACrB,4GAAA,iBAAiB,OAAA;AACjB,kHAAA,uBAAuB,OAAA;AACvB,iHAAA,sBAAsB,OAAA;AACtB,gHAAA,qBAAqB,OAAA;AACrB,iHAAA,sBAAsB,OAAA;AACtB,qHAAA,0BAA0B,OAAA;AAC1B,yHAAA,8BAA8B,OAAA;AAC9B,6GAAA,kBAAkB,OAAA;AAClB,mHAAA,wBAAwB,OAAA;AACxB,oHAAA,yBAAyB,OAAA;AAG3B,gDAAgG;AAAvF,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AACzC,gDAK+B;AAJ7B,yGAAA,eAAe,OAAA;AACf,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAGlB,8DAAiE;AAAxD,wHAAA,oBAAoB,OAAA;AAC7B,4DAOiC;AAN/B,kIAAA,8BAA8B,OAAA;AAC9B,8HAAA,0BAA0B,OAAA;AAC1B,8HAAA,0BAA0B,OAAA;AAK5B,0DAA2F;AAAlF,4GAAA,iBAAiB,OAAA;AAC1B,yDAGgC;AAF9B,mHAAA,iBAAiB,OAAA;AAGnB,0CAA+K;AAAtK,wGAAA,cAAc,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAyB,gHAAA,sBAAsB,OAAA;AAClG,mCAqBkB;AApBhB,yGAAA,eAAe,OAAA;AACf,qGAAA,WAAW,OAAA;AACX,oGAAA,UAAU,OAAA"}

package/dist/integrations/agent-mcp-installer.d.ts

@@ -84,6 +84,45 @@ export declare function resolveMcpNodeLaunch(options: {
     command: string;
     env: Record<string, string>;
 };
+/**
+ * On Windows, convert a long path containing spaces to its 8.3 short form.
+ * Many MCP clients (e.g., TRAE) spawn the `command` field via cmd.exe without
+ * quoting, so paths like "C:\Program Files\..." break with "'C:\Program' is not
+ * recognized". The 8.3 short name (e.g., "C:\PROGRA~1\...") avoids this entirely.
+ */
+export declare function getWindowsShortPath(longPath: string): string | undefined;
+/** Prefer 8.3 short path on Windows when the input contains spaces; otherwise keep as-is. */
+export declare function preferSpaceFreeWindowsPath(pathValue: string): string;
+/**
+ * Final guard for MCP clients (notably Trae) that spawn `command` via cmd.exe
+ * without quoting. Ensures install-time configs never write spaced absolute paths.
+ */
+export declare function sanitizeMcpServerNodeForWindowsClients(node: McpServerNode): McpServerNode;
+/** True when command/cwd/path-like args still contain spaces (unsafe for unquoted cmd spawn). */
+export declare function mcpNodeNeedsWindowsSpaceRepair(node: McpServerNode): boolean;
+export interface McpWindowsSpaceRepairResult {
+    agentId: string;
+    agentName: string;
+    configPath: string;
+    repaired: boolean;
+    beforeCommand?: string;
+    afterCommand?: string;
+}
+/**
+ * Painless migrate: rewrite existing GraphFlow MCP entries that still use spaced
+ * absolute paths (e.g. Program Files). Scans every known agent config path that
+ * exists — not only currently "detected" markers — so Trae / Trae CN / TRAE SOLO
+ * variants are all fixed on extension activate without a manual Install click.
+ */
+export declare function repairUnsafeWindowsMcpCommands(serverName?: string, options?: {
+    /** Test/injection hook — override scanned targets. */
+    targets?: Array<{
+        agentId: string;
+        agentName: string;
+        configPath: string;
+        serversKey: McpServersKey;
+    }>;
+}): McpWindowsSpaceRepairResult[];
 export declare function buildMcpServerNode(options: McpInstallOptions): McpServerNode;
 /** 从 JSON 配置文件中移除指定 MCP 服务器的配置条目 */
 export declare function removeMcpEntry(configPath: string, serversKey: McpServersKey, serverName: string): boolean;

package/dist/integrations/agent-mcp-installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-mcp-installer.d.ts","sourceRoot":"","sources":["../../src/integrations/agent-mcp-installer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-mcp-installer.d.ts","sourceRoot":"","sources":["../../src/integrations/agent-mcp-installer.ts"],"names":[],"mappings":"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"}

package/dist/integrations/agent-mcp-installer.js

@@ -8,6 +8,11 @@ exports.isEphemeralNodePath = isEphemeralNodePath;
 exports.isIdeBundledNode = isIdeBundledNode;
 exports.resolveSystemNodeCommand = resolveSystemNodeCommand;
 exports.resolveMcpNodeLaunch = resolveMcpNodeLaunch;
+exports.getWindowsShortPath = getWindowsShortPath;
+exports.preferSpaceFreeWindowsPath = preferSpaceFreeWindowsPath;
+exports.sanitizeMcpServerNodeForWindowsClients = sanitizeMcpServerNodeForWindowsClients;
+exports.mcpNodeNeedsWindowsSpaceRepair = mcpNodeNeedsWindowsSpaceRepair;
+exports.repairUnsafeWindowsMcpCommands = repairUnsafeWindowsMcpCommands;
 exports.buildMcpServerNode = buildMcpServerNode;
 exports.removeMcpEntry = removeMcpEntry;
 exports.removeCodexMcpEntry = removeCodexMcpEntry;
@@ -263,9 +268,6 @@ function buildAgentProfiles() {
         {
             id: "claude-code",
             name: "Claude Code",
-            // Claude Code stores user-scope MCP servers under the top-level `mcpServers`
-            // key of ~/.claude.json. Per official docs it does NOT read ~/.claude/mcp.json
-            // or %APPDATA%/Claude*/mcp.json, so those legacy paths are intentionally dropped.
             markerPaths: [
                 (0, node_path_1.join)(home, ".claude"),
                 (0, node_path_1.join)(home, ".claude.json"),
@@ -273,7 +275,6 @@ function buildAgentProfiles() {
             userTargets: [
                 { configPath: (0, node_path_1.join)(home, ".claude.json"), serversKey: "mcpServers" },
             ],
-            // Project scope is shared via <project>/.mcp.json (top-level `mcpServers`).
             workspaceRelativePaths: [{ relativePath: ".mcp.json", serversKey: "mcpServers" }],
         },
         {
@@ -372,9 +373,6 @@ function buildAgentProfiles() {
         {
             id: "gemini",
             name: "Gemini",
-            // Gemini CLI reads MCP servers from the `mcpServers` object in settings.json.
-            // User scope: ~/.gemini/settings.json; project scope: <project>/.gemini/settings.json.
-            // Shared Antigravity toolchain: ~/.gemini/config/mcp_config.json (optional).
             markerPaths: [
                 (0, node_path_1.join)(home, ".gemini"),
             ],
@@ -404,13 +402,9 @@ function buildAgentProfiles() {
                 },
             ],
         },
-        // ─── 实验性支持 ───
         {
             id: "antigravity",
             name: "Antigravity",
-            // Google Antigravity MCP: ~/.gemini/antigravity/mcp_config.json (mcpServers key).
-            // Shared config across Antigravity products: ~/.gemini/config/mcp_config.json.
-            // Project scope: .agents/mcp_config.json
             markerPaths: [
                 (0, node_path_1.join)(home, ".gemini", "antigravity"),
                 (0, node_path_1.join)(home, ".antigravity"),
@@ -442,8 +436,6 @@ function buildAgentProfiles() {
         {
             id: "zed",
             name: "Zed",
-            // Zed 已在 v0.165+ 支持 MCP（称为 "context servers"）
-            // 配置格式: settings.json 中的 "context_servers" 键
             markerPaths: [
                 (0, node_path_1.join)(home, ".config", "zed"),
                 isWindows() ? (0, node_path_1.join)(appData, "Zed") : undefined,
@@ -460,10 +452,6 @@ function buildAgentProfiles() {
         {
             id: "continue",
             name: "Continue",
-            // Continue 是 VS Code / JetBrains 的 AI 编程助手扩展
-            // MCP 配置写入 ~/.continue/config.yaml 中的 "mcpServers" 节
-            // 注意：Continue 的 config.yaml 格式为 YAML，当前实现仅支持 JSON
-            // 如需完整支持，需额外添加 YAML 读写逻辑
             markerPaths: [
                 (0, node_path_1.join)(home, ".continue"),
             ],
@@ -474,6 +462,28 @@ function buildAgentProfiles() {
                 },
             ],
         },
+        {
+            id: "qoder",
+            name: "Qoder",
+            markerPaths: [
+                (0, node_path_1.join)(home, ".qoder"),
+                (0, node_path_1.join)(appData, "Qoder"),
+                (0, node_path_1.join)(localAppData, "Programs", "qoder"),
+            ],
+            userTargets: [
+                {
+                    configPath: (0, node_path_1.join)(home, ".qoder", "mcp.json"),
+                    serversKey: "mcpServers",
+                },
+                {
+                    configPath: isWindows()
+                        ? (0, node_path_1.join)(appData, "Qoder", "User", "mcp.json")
+                        : (0, node_path_1.join)(home, ".config", "Qoder", "User", "mcp.json"),
+                    serversKey: "mcpServers",
+                },
+            ],
+            workspaceRelativePaths: [{ relativePath: (0, node_path_1.join)(".qoder", "mcp.json"), serversKey: "mcpServers" }],
+        },
     ];
     if (wslWindowsHome) {
         profiles.push(...buildWindowsProfilesFromWsl(wslWindowsHome));
@@ -631,7 +641,10 @@ function resolveMcpNodeLaunch(options) {
     // 1. Explicit node command (highest priority)
     const explicitNode = options.nodeCommand?.trim();
     if (explicitNode && isUsableNodeCommand(explicitNode) && !isEphemeralNodePath(explicitNode)) {
-        return { command: explicitNode, env: { ...MCP_STDIO_ENV } };
+        return {
+            command: preferSpaceFreeWindowsPath(explicitNode),
+            env: { ...MCP_STDIO_ENV },
+        };
     }
     // 2. System Node — preferred over Electron because:
     //    - Path is stable across IDE updates
@@ -639,13 +652,23 @@ function resolveMcpNodeLaunch(options) {
     //    - Better compatibility with MCP client spawn logic
     const systemNode = resolveSystemNodeCommand();
     if (systemNode && systemNode !== "node") {
-        return { command: systemNode, env: { ...MCP_STDIO_ENV } };
+        const safeNode = preferSpaceFreeWindowsPath(systemNode);
+        // Trae/some clients invoke `command` via cmd.exe without quoting. If we still
+        // have spaces (8.3 disabled), fall back to bare "node" so PATH resolution works.
+        if (safeNode.includes(" ")) {
+            return { command: "node", env: { ...MCP_STDIO_ENV } };
+        }
+        return { command: safeNode, env: { ...MCP_STDIO_ENV } };
     }
     // 3. Electron fallback — when system Node is unavailable, use the IDE's bundled Electron
     const electronExecPath = options.electronExecPath?.trim();
     if (electronExecPath && (0, node_fs_1.existsSync)(electronExecPath)) {
+        const safeElectron = preferSpaceFreeWindowsPath(electronExecPath);
+        if (safeElectron.includes(" ")) {
+            return { command: "node", env: { ...MCP_STDIO_ENV } };
+        }
         return {
-            command: electronExecPath,
+            command: safeElectron,
             env: {
                 ...MCP_STDIO_ENV,
                 ELECTRON_RUN_AS_NODE: "1",
@@ -655,6 +678,173 @@ function resolveMcpNodeLaunch(options) {
     // 4. Last resort: bare "node" (relies on PATH resolution at MCP launch time)
     return { command: "node", env: { ...MCP_STDIO_ENV } };
 }
+/**
+ * On Windows, convert a long path containing spaces to its 8.3 short form.
+ * Many MCP clients (e.g., TRAE) spawn the `command` field via cmd.exe without
+ * quoting, so paths like "C:\Program Files\..." break with "'C:\Program' is not
+ * recognized". The 8.3 short name (e.g., "C:\PROGRA~1\...") avoids this entirely.
+ */
+function getWindowsShortPath(longPath) {
+    if (!isWindows() || !longPath || !longPath.includes(" ")) {
+        return longPath;
+    }
+    // Try cmd.exe first (faster, available on all Windows)
+    try {
+        const result = (0, node_child_process_1.execSync)(`for %A in ("${longPath}") do @echo %~sA`, {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 3000,
+            shell: "cmd.exe",
+        }).trim();
+        const lines = result.split(/\r?\n/).filter((l) => l.trim());
+        const shortPath = lines[lines.length - 1]?.trim();
+        if (shortPath && !shortPath.includes(" ") && (0, node_fs_1.existsSync)(shortPath)) {
+            return shortPath;
+        }
+    }
+    catch {
+        // fall through to PowerShell
+    }
+    // Fallback: PowerShell with FileSystemObject COM
+    try {
+        const escaped = longPath.replace(/'/g, "''");
+        const result = (0, node_child_process_1.execSync)(`$fso = New-Object -ComObject Scripting.FileSystemObject; if (Test-Path -LiteralPath '${escaped}') { if ((Get-Item -LiteralPath '${escaped}') -is [System.IO.DirectoryInfo]) { $fso.GetFolder('${escaped}').ShortPath } else { $fso.GetFile('${escaped}').ShortPath } }`, {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 5000,
+            shell: "powershell.exe",
+        }).trim();
+        if (result && !result.includes(" ") && (0, node_fs_1.existsSync)(result)) {
+            return result;
+        }
+    }
+    catch {
+        // 8.3 name generation may be disabled on some volumes
+    }
+    return undefined;
+}
+/** Prefer 8.3 short path on Windows when the input contains spaces; otherwise keep as-is. */
+function preferSpaceFreeWindowsPath(pathValue) {
+    if (!isWindows() || !pathValue.includes(" ")) {
+        return pathValue;
+    }
+    return getWindowsShortPath(pathValue) ?? pathValue;
+}
+/**
+ * Final guard for MCP clients (notably Trae) that spawn `command` via cmd.exe
+ * without quoting. Ensures install-time configs never write spaced absolute paths.
+ */
+function sanitizeMcpServerNodeForWindowsClients(node) {
+    if (!isWindows()) {
+        return node;
+    }
+    let command = preferSpaceFreeWindowsPath(node.command);
+    // Absolute node/electron paths that still contain spaces → bare "node" via PATH.
+    if (command.includes(" ") &&
+        (/[\\/]node(\.exe)?$/i.test(command) || /[\\/]electron(\.exe)?$/i.test(command))) {
+        command = "node";
+    }
+    const args = node.args.map((arg) => {
+        if (!arg.includes(" ")) {
+            return arg;
+        }
+        // Only rewrite filesystem-looking args; leave flags like "--foo bar" alone.
+        if (/^[A-Za-z]:[\\/]/.test(arg) || arg.startsWith("\\\\") || arg.includes("/") || arg.includes("\\")) {
+            return preferSpaceFreeWindowsPath(arg);
+        }
+        return arg;
+    });
+    const sanitized = {
+        command,
+        args,
+    };
+    if (node.env) {
+        sanitized.env = node.env;
+    }
+    if (node.cwd) {
+        sanitized.cwd = preferSpaceFreeWindowsPath(node.cwd);
+    }
+    return sanitized;
+}
+/** True when command/cwd/path-like args still contain spaces (unsafe for unquoted cmd spawn). */
+function mcpNodeNeedsWindowsSpaceRepair(node) {
+    if (node.command.includes(" ")) {
+        return true;
+    }
+    if (node.cwd?.includes(" ")) {
+        return true;
+    }
+    return node.args.some((arg) => {
+        if (!arg.includes(" ")) {
+            return false;
+        }
+        return /^[A-Za-z]:[\\/]/.test(arg) || arg.startsWith("\\\\") || arg.includes("/") || arg.includes("\\");
+    });
+}
+/**
+ * Painless migrate: rewrite existing GraphFlow MCP entries that still use spaced
+ * absolute paths (e.g. Program Files). Scans every known agent config path that
+ * exists — not only currently "detected" markers — so Trae / Trae CN / TRAE SOLO
+ * variants are all fixed on extension activate without a manual Install click.
+ */
+function repairUnsafeWindowsMcpCommands(serverName = "graphflow", options) {
+    if (!isWindows()) {
+        return [];
+    }
+    const results = [];
+    const seen = new Set();
+    const targets = options?.targets ??
+        buildAgentProfiles().flatMap((profile) => profile.userTargets
+            .filter((t) => (t.configFormat ?? "json") !== "codex-toml")
+            .map((t) => ({
+            agentId: profile.id,
+            agentName: profile.name,
+            configPath: t.configPath,
+            serversKey: t.serversKey,
+        })));
+    for (const target of targets) {
+        const key = `${target.configPath}::${target.serversKey}`;
+        if (seen.has(key) || !(0, node_fs_1.existsSync)(target.configPath)) {
+            continue;
+        }
+        seen.add(key);
+        try {
+            const json = readJsonConfig(target.configPath);
+            const servers = json[target.serversKey] ?? {};
+            const previous = servers[serverName];
+            if (!previous || typeof previous.command !== "string" || !Array.isArray(previous.args)) {
+                continue;
+            }
+            if (!mcpNodeNeedsWindowsSpaceRepair(previous)) {
+                results.push({
+                    agentId: target.agentId,
+                    agentName: target.agentName,
+                    configPath: target.configPath,
+                    repaired: false,
+                    beforeCommand: previous.command,
+                    afterCommand: previous.command,
+                });
+                continue;
+            }
+            const sanitized = sanitizeMcpServerNodeForWindowsClients(previous);
+            servers[serverName] = sanitized;
+            json[target.serversKey] = servers;
+            writeJsonConfig(target.configPath, json);
+            results.push({
+                agentId: target.agentId,
+                agentName: target.agentName,
+                configPath: target.configPath,
+                repaired: true,
+                beforeCommand: previous.command,
+                afterCommand: sanitized.command,
+            });
+        }
+        catch {
+            // Config may be malformed; skip — install path will recreate.
+        }
+    }
+    return results;
+}
 function resolveWindowsNpxLaunch() {
     const node = resolveSystemNodeCommand();
     if (!node) {
@@ -667,15 +857,27 @@ function resolveWindowsNpxLaunch() {
     ];
     for (const npxCli of candidates) {
         if ((0, node_fs_1.existsSync)(npxCli)) {
+            // If paths contain spaces, try 8.3 short format to avoid quoting issues
+            // with MCP clients that don't properly quote the command (e.g., TRAE).
+            const shortNode = getWindowsShortPath(node) ?? node;
+            const shortNpxCli = getWindowsShortPath(npxCli) ?? npxCli;
+            if (shortNode.includes(" ") || shortNpxCli.includes(" ")) {
+                // Can't resolve to a space-free path; fall back to npx.cmd which
+                // relies on PATH resolution and handles quoting internally.
+                return undefined;
+            }
             return {
-                command: node,
-                args: [npxCli, "-y", "--package=@roarpeng/graphflow", "graphflow-mcp"],
+                command: shortNode,
+                args: [shortNpxCli, "-y", "--package=@roarpeng/graphflow", "graphflow-mcp"],
             };
         }
     }
     return undefined;
 }
 function buildMcpServerNode(options) {
+    return sanitizeMcpServerNodeForWindowsClients(buildMcpServerNodeRaw(options));
+}
+function buildMcpServerNodeRaw(options) {
     const cwd = options.workspaceRoot ?? options.npmScriptCwd ?? process.cwd();
     // Only inject workspace root when explicitly passed (workspace-scope installs).
     // Never fall back to process.env — that pollutes user-level agent configs.
@@ -692,12 +894,21 @@ function buildMcpServerNode(options) {
         }
         const runtimeRoot = options.bundledRuntimeRoot ?? (0, node_path_1.join)(options.bundledServerPath, "..", "..", "..");
         if (options.launcherPath) {
+            // Cursor/Node spawn(.cmd, {shell:false}) fails on Windows with EINVAL /
+            // "系统找不到指定的路径". Prefer the sibling .cjs under node; fall back to cmd /c.
+            let launcherForSpawn = options.launcherPath;
             if (isWindows() && options.launcherPath.toLowerCase().endsWith(".cmd")) {
-                return {
-                    command: options.launcherPath,
-                    args: [],
-                    env: { ...mcpEnv },
-                };
+                const cjsSibling = options.launcherPath.replace(/\.cmd$/i, ".cjs");
+                if ((0, node_fs_1.existsSync)(cjsSibling)) {
+                    launcherForSpawn = cjsSibling;
+                }
+                else {
+                    return {
+                        command: "cmd.exe",
+                        args: ["/c", options.launcherPath],
+                        env: { ...mcpEnv },
+                    };
+                }
             }
             const launch = resolveMcpNodeLaunch({
                 ...(options.nodeCommand !== undefined ? { nodeCommand: options.nodeCommand } : {}),
@@ -705,7 +916,7 @@ function buildMcpServerNode(options) {
             });
             return {
                 command: launch.command,
-                args: [options.launcherPath],
+                args: [launcherForSpawn],
                 env: { ...mcpEnv, ...launch.env },
             };
         }
@@ -909,13 +1120,13 @@ function injectIntoConfig(configPath, serversKey, serverName, node) {
     if (!node.env?.GRAPHFLOW_WORKSPACE_ROOT) {
         delete mergedEnv.GRAPHFLOW_WORKSPACE_ROOT;
     }
-    servers[serverName] = {
+    servers[serverName] = sanitizeMcpServerNodeForWindowsClients({
         ...previous,
         ...node,
         ...(previous?.args && !node.args?.length ? { args: previous.args } : {}),
         ...(previous?.command && !node.command ? { command: previous.command } : {}),
         env: mergedEnv,
-    };
+    });
     if (!Object.prototype.hasOwnProperty.call(node, "cwd")) {
         delete servers[serverName].cwd;
     }
@@ -1067,7 +1278,7 @@ function formatModelConfigGuide(workspaceRoot) {
         "在 VS Code 命令面板运行：`GraphFlow: Settings`",
         "",
         "## 2. 配置 LLM Provider（规划 / 执行任务）",
-        "- 在设置面板的 Smart / Economy 层分别选择 provider（如 openai / anthropic / bailian / doubao）",
+        "- 在设置面板的 Smart / Economy 层分别选择 provider（如 deepseek / openai / anthropic / bailian / doubao）",
         "- API Key：填环境变量名（如 `DEEPSEEK_API_KEY`）、`${DEEPSEEK_API_KEY}`、或直接 `sk-...`",
         "- Base URL：每层卡片内直接填写（如 DeepSeek 使用 `https://api.deepseek.com`）",
         "- Smart / Economy 模型均可选；留空则使用 provider 默认路由",