@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/mcp/config-writer.js

@@ -0,0 +1,124 @@
+import { Buffer } from "node:buffer";
+import { existsSync, lstatSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import lockfile from "proper-lockfile";
+import { CONFIG_DIR_NAME } from "../../config.js";
+import { writeDurableAtomicFileSync } from "../../utils/durable-atomic-write.js";
+import { resolvePath } from "../../utils/paths.js";
+import { ensurePrivateDirectorySync, hardenPrivateRegularFileSync } from "../../utils/private-files.js";
+const MAX_MCP_CONFIG_BYTES = 4 * 1024 * 1024;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readJsonObject(path) {
+    if (!existsSync(path)) {
+        return {};
+    }
+    hardenPrivateRegularFileSync(path);
+    if (lstatSync(path).size > MAX_MCP_CONFIG_BYTES) {
+        throw new Error(`MCP config exceeds ${MAX_MCP_CONFIG_BYTES} bytes: ${path}`);
+    }
+    const parsed = JSON.parse(readFileSync(path, "utf-8"));
+    if (!isRecord(parsed)) {
+        throw new Error(`MCP config is not a JSON object: ${path}`);
+    }
+    return parsed;
+}
+function ensureObjectField(parent, field) {
+    const current = parent[field];
+    if (isRecord(current)) {
+        return current;
+    }
+    const next = {};
+    parent[field] = next;
+    return next;
+}
+function writeJsonObject(path, value) {
+    const serialized = `${JSON.stringify(value, null, 2)}\n`;
+    if (Buffer.byteLength(serialized, "utf8") > MAX_MCP_CONFIG_BYTES) {
+        throw new Error(`Refusing to write MCP config larger than ${MAX_MCP_CONFIG_BYTES} bytes`);
+    }
+    ensurePrivateDirectorySync(dirname(path));
+    writeDurableAtomicFileSync(path, serialized);
+}
+function withConfigLock(path, operation) {
+    const directoryPath = dirname(path);
+    ensurePrivateDirectorySync(directoryPath);
+    let release;
+    let lastError;
+    for (let attempt = 1; attempt <= 10; attempt++) {
+        try {
+            release = lockfile.lockSync(directoryPath, { realpath: false, lockfilePath: `${path}.lock` });
+            break;
+        }
+        catch (error) {
+            const code = typeof error === "object" && error !== null && "code" in error
+                ? String(error.code)
+                : undefined;
+            if (code !== "ELOCKED" || attempt === 10)
+                throw error;
+            lastError = error;
+            const startedAt = Date.now();
+            while (Date.now() - startedAt < 20) {
+                // Preserve the synchronous writer contract while waiting briefly.
+            }
+        }
+    }
+    if (!release)
+        throw lastError instanceof Error ? lastError : new Error("Failed to lock MCP config");
+    try {
+        return operation();
+    }
+    finally {
+        release();
+    }
+}
+export class McpConfigWriter {
+    cwd;
+    agentDir;
+    projectTrusted;
+    constructor(options) {
+        this.cwd = resolvePath(options.cwd);
+        this.agentDir = resolvePath(options.agentDir);
+        this.projectTrusted = options.projectTrusted;
+    }
+    setServerEnabled(server, enabled) {
+        return this.updateServerOverlay(server, (overlay) => {
+            overlay.enabled = enabled;
+        });
+    }
+    setServerDirectTools(server, directTools) {
+        return this.updateServerOverlay(server, (overlay) => {
+            overlay.directTools = Array.isArray(directTools) ? [...directTools] : directTools;
+        });
+    }
+    getVoltOwnedPath(scope) {
+        if (scope === "project") {
+            if (!this.projectTrusted) {
+                throw new Error("Cannot persist project MCP config because project trust is not granted");
+            }
+            return join(this.cwd, CONFIG_DIR_NAME, "mcp.json");
+        }
+        if (scope === "temporary") {
+            throw new Error("Cannot persist temporary MCP server config");
+        }
+        return join(this.agentDir, "mcp.json");
+    }
+    updateServerOverlay(server, update) {
+        const path = this.getVoltOwnedPath(server.source.scope);
+        withConfigLock(path, () => {
+            const config = readJsonObject(path);
+            if (typeof config.version !== "number") {
+                config.version = 1;
+            }
+            const servers = ensureObjectField(config, "servers");
+            const current = servers[server.id];
+            const overlay = isRecord(current) ? current : {};
+            servers[server.id] = overlay;
+            update(overlay);
+            writeJsonObject(path, config);
+        });
+        return { path, scope: server.source.scope };
+    }
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/core/mcp/config-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.js","sourceRoot":"","sources":["../../../src/core/mcp/config-writer.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport { existsSync, lstatSync, readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport lockfile from \"proper-lockfile\";\nimport { CONFIG_DIR_NAME } from \"../../config.ts\";\nimport { writeDurableAtomicFileSync } from \"../../utils/durable-atomic-write.ts\";\nimport { resolvePath } from \"../../utils/paths.ts\";\nimport { ensurePrivateDirectorySync, hardenPrivateRegularFileSync } from \"../../utils/private-files.ts\";\nimport type { McpResolvedServerConfig, McpSourceScope } from \"./types.ts\";\n\nconst MAX_MCP_CONFIG_BYTES = 4 * 1024 * 1024;\n\nexport interface McpConfigWriterOptions {\n\tcwd: string;\n\tagentDir: string;\n\tprojectTrusted: boolean;\n}\n\nexport interface McpConfigWriteResult {\n\tpath: string;\n\tscope: McpSourceScope;\n}\n\ntype MutableJsonRecord = Record<string, unknown>;\n\nfunction isRecord(value: unknown): value is MutableJsonRecord {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction readJsonObject(path: string): MutableJsonRecord {\n\tif (!existsSync(path)) {\n\t\treturn {};\n\t}\n\thardenPrivateRegularFileSync(path);\n\tif (lstatSync(path).size > MAX_MCP_CONFIG_BYTES) {\n\t\tthrow new Error(`MCP config exceeds ${MAX_MCP_CONFIG_BYTES} bytes: ${path}`);\n\t}\n\tconst parsed = JSON.parse(readFileSync(path, \"utf-8\")) as unknown;\n\tif (!isRecord(parsed)) {\n\t\tthrow new Error(`MCP config is not a JSON object: ${path}`);\n\t}\n\treturn parsed;\n}\n\nfunction ensureObjectField(parent: MutableJsonRecord, field: string): MutableJsonRecord {\n\tconst current = parent[field];\n\tif (isRecord(current)) {\n\t\treturn current;\n\t}\n\tconst next: MutableJsonRecord = {};\n\tparent[field] = next;\n\treturn next;\n}\n\nfunction writeJsonObject(path: string, value: MutableJsonRecord): void {\n\tconst serialized = `${JSON.stringify(value, null, 2)}\\n`;\n\tif (Buffer.byteLength(serialized, \"utf8\") > MAX_MCP_CONFIG_BYTES) {\n\t\tthrow new Error(`Refusing to write MCP config larger than ${MAX_MCP_CONFIG_BYTES} bytes`);\n\t}\n\tensurePrivateDirectorySync(dirname(path));\n\twriteDurableAtomicFileSync(path, serialized);\n}\n\nfunction withConfigLock<T>(path: string, operation: () => T): T {\n\tconst directoryPath = dirname(path);\n\tensurePrivateDirectorySync(directoryPath);\n\tlet release: (() => void) | undefined;\n\tlet lastError: unknown;\n\tfor (let attempt = 1; attempt <= 10; attempt++) {\n\t\ttry {\n\t\t\trelease = lockfile.lockSync(directoryPath, { realpath: false, lockfilePath: `${path}.lock` });\n\t\t\tbreak;\n\t\t} catch (error) {\n\t\t\tconst code =\n\t\t\t\ttypeof error === \"object\" && error !== null && \"code\" in error\n\t\t\t\t\t? String((error as { code?: unknown }).code)\n\t\t\t\t\t: undefined;\n\t\t\tif (code !== \"ELOCKED\" || attempt === 10) throw error;\n\t\t\tlastError = error;\n\t\t\tconst startedAt = Date.now();\n\t\t\twhile (Date.now() - startedAt < 20) {\n\t\t\t\t// Preserve the synchronous writer contract while waiting briefly.\n\t\t\t}\n\t\t}\n\t}\n\tif (!release) throw lastError instanceof Error ? lastError : new Error(\"Failed to lock MCP config\");\n\ttry {\n\t\treturn operation();\n\t} finally {\n\t\trelease();\n\t}\n}\n\nexport class McpConfigWriter {\n\tprivate cwd: string;\n\tprivate agentDir: string;\n\tprivate projectTrusted: boolean;\n\n\tconstructor(options: McpConfigWriterOptions) {\n\t\tthis.cwd = resolvePath(options.cwd);\n\t\tthis.agentDir = resolvePath(options.agentDir);\n\t\tthis.projectTrusted = options.projectTrusted;\n\t}\n\n\tsetServerEnabled(server: McpResolvedServerConfig, enabled: boolean): McpConfigWriteResult {\n\t\treturn this.updateServerOverlay(server, (overlay) => {\n\t\t\toverlay.enabled = enabled;\n\t\t});\n\t}\n\n\tsetServerDirectTools(server: McpResolvedServerConfig, directTools: boolean | string[]): McpConfigWriteResult {\n\t\treturn this.updateServerOverlay(server, (overlay) => {\n\t\t\toverlay.directTools = Array.isArray(directTools) ? [...directTools] : directTools;\n\t\t});\n\t}\n\n\tprivate getVoltOwnedPath(scope: McpSourceScope): string {\n\t\tif (scope === \"project\") {\n\t\t\tif (!this.projectTrusted) {\n\t\t\t\tthrow new Error(\"Cannot persist project MCP config because project trust is not granted\");\n\t\t\t}\n\t\t\treturn join(this.cwd, CONFIG_DIR_NAME, \"mcp.json\");\n\t\t}\n\t\tif (scope === \"temporary\") {\n\t\t\tthrow new Error(\"Cannot persist temporary MCP server config\");\n\t\t}\n\t\treturn join(this.agentDir, \"mcp.json\");\n\t}\n\n\tprivate updateServerOverlay(\n\t\tserver: McpResolvedServerConfig,\n\t\tupdate: (overlay: MutableJsonRecord) => void,\n\t): McpConfigWriteResult {\n\t\tconst path = this.getVoltOwnedPath(server.source.scope);\n\t\twithConfigLock(path, () => {\n\t\t\tconst config = readJsonObject(path);\n\t\t\tif (typeof config.version !== \"number\") {\n\t\t\t\tconfig.version = 1;\n\t\t\t}\n\t\t\tconst servers = ensureObjectField(config, \"servers\");\n\t\t\tconst current = servers[server.id];\n\t\t\tconst overlay = isRecord(current) ? current : {};\n\t\t\tservers[server.id] = overlay;\n\t\t\tupdate(overlay);\n\t\t\twriteJsonObject(path, config);\n\t\t});\n\t\treturn { path, scope: server.source.scope };\n\t}\n}\n"]}

package/dist/core/mcp/config.d.ts

@@ -0,0 +1,32 @@
+import type { McpConfigDiagnostic, McpConfigSource, McpLifecycle, McpResolvedConfig, McpResolvedServerConfig, McpSettings, McpTransportKind } from "./types.ts";
+export declare const DEFAULT_MCP_SETTINGS: McpSettings;
+export interface McpRawConfigFile {
+    version?: number;
+    settings?: Record<string, unknown>;
+    servers?: Record<string, unknown>;
+}
+export interface McpMergedConfigData {
+    settings: Record<string, unknown>;
+    servers: Map<string, Record<string, unknown>>;
+    serverSources: Map<string, McpConfigSource>;
+    serverDefinedIn: Map<string, McpConfigSource[]>;
+    diagnostics: McpConfigDiagnostic[];
+    sources: McpConfigSource[];
+}
+export declare function normalizeMcpServerId(id: string): string;
+export declare function normalizeMcpDirectToolSegment(value: string): string;
+export declare function getMcpDirectToolName(serverId: string, toolName: string): string;
+export declare function getMcpSourceLabel(source: McpConfigSource): string;
+export declare function sourceForMcpConfigPath(path: string, source: Omit<McpConfigSource, "baseDir" | "path">): McpConfigSource;
+export declare function createEmptyMcpMergedConfig(): McpMergedConfigData;
+export declare function mergeMcpConfigFile(merged: McpMergedConfigData, rawConfig: McpRawConfigFile, source: McpConfigSource): void;
+export declare function finalizeMcpConfig(merged: McpMergedConfigData): McpResolvedConfig;
+export declare function serverMatchesToolFilters(server: McpResolvedServerConfig, toolName: string): boolean;
+export declare function getServerTimeoutMs(server: McpResolvedServerConfig, settings: McpSettings, kind: "connect" | "metadata" | "call" | "idle" | "refresh"): number;
+export declare function mcpTransportToDto(transport: McpTransportKind): "stdio" | "streamable_http" | "sse";
+export declare function mcpLifecycleToDto(lifecycle: McpLifecycle): "lazy" | "eager" | "keep_alive";
+export declare function getMcpProjectConfigPaths(cwd: string): string[];
+export declare function hashMcpMetadata(value: unknown): string;
+export declare function hashMcpServerConfig(server: McpResolvedServerConfig): string;
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/mcp/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,oBAAoB,EAAE,WAalC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAChD,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC3B;AA4HD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQnE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAEjE;AAED,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAC,GAC/C,eAAe,CAMjB;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,CAShE;AAED,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,eAAe,GACrB,IAAI,CAkDN;AAmGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,iBAAiB,CAqBhF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKnG;AAED,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GACxD,MAAM,CAaR;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,GAAG,iBAAiB,GAAG,KAAK,CAElG;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAE1F;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAyB3E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYtD","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { dirname } from \"node:path\";\nimport { CONFIG_DIR_NAME } from \"../../config.ts\";\nimport { resolvePath } from \"../../utils/paths.ts\";\nimport type {\n\tMcpAuthConfig,\n\tMcpConfigDiagnostic,\n\tMcpConfigSource,\n\tMcpLifecycle,\n\tMcpResolvedConfig,\n\tMcpResolvedServerConfig,\n\tMcpSettings,\n\tMcpTransportKind,\n} from \"./types.ts\";\n\nexport const DEFAULT_MCP_SETTINGS: McpSettings = {\n\tenabled: true,\n\tmode: \"proxy\",\n\tidleTimeoutMs: 600_000,\n\tconnectTimeoutMs: 15_000,\n\tmetadataTimeoutMs: 10_000,\n\tcallTimeoutMs: 600_000,\n\tmaxOutputBytes: 50 * 1024,\n\tmaxOutputLines: 2000,\n\tdirectTools: false,\n\tresources: \"explicit\",\n\tprompts: \"user-preview\",\n\tmetadataRefreshMs: 24 * 60 * 60 * 1000,\n};\n\nexport interface McpRawConfigFile {\n\tversion?: number;\n\tsettings?: Record<string, unknown>;\n\tservers?: Record<string, unknown>;\n}\n\nexport interface McpMergedConfigData {\n\tsettings: Record<string, unknown>;\n\tservers: Map<string, Record<string, unknown>>;\n\tserverSources: Map<string, McpConfigSource>;\n\tserverDefinedIn: Map<string, McpConfigSource[]>;\n\tdiagnostics: McpConfigDiagnostic[];\n\tsources: McpConfigSource[];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isString(value: unknown): value is string {\n\treturn typeof value === \"string\";\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n\treturn Array.isArray(value) && value.every(isString);\n}\n\nfunction asFiniteNumber(value: unknown): number | undefined {\n\treturn typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n\nfunction asBoolean(value: unknown): boolean | undefined {\n\treturn typeof value === \"boolean\" ? value : undefined;\n}\n\nfunction asStringRecord(value: unknown): Record<string, string> {\n\tif (!isRecord(value)) {\n\t\treturn {};\n\t}\n\tconst result: Record<string, string> = {};\n\tfor (const [key, entry] of Object.entries(value)) {\n\t\tif (typeof entry === \"string\") {\n\t\t\tresult[key] = entry;\n\t\t}\n\t}\n\treturn result;\n}\n\nfunction asTransport(value: unknown, fallback: McpTransportKind): McpTransportKind {\n\treturn value === \"stdio\" || value === \"streamable-http\" || value === \"sse\" ? value : fallback;\n}\n\nfunction asLifecycle(value: unknown): McpLifecycle {\n\treturn value === \"eager\" || value === \"keep-alive\" || value === \"lazy\" ? value : \"lazy\";\n}\n\nfunction asDirectTools(value: unknown): boolean | string[] {\n\tif (typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\tif (isStringArray(value)) {\n\t\treturn [...value];\n\t}\n\treturn false;\n}\n\nfunction asAuthConfig(value: unknown): McpAuthConfig | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst type = value.type;\n\tconst auth: McpAuthConfig = {};\n\tif (type === \"none\" || type === \"bearer\" || type === \"oauth\" || type === \"env\") {\n\t\tauth.type = type;\n\t}\n\tif (typeof value.token === \"string\") {\n\t\tauth.token = value.token;\n\t}\n\tif (typeof value.env === \"string\") {\n\t\tauth.env = value.env;\n\t}\n\tif (value.flow === \"browser\" || value.flow === \"device\" || value.flow === \"auto\") {\n\t\tauth.flow = value.flow;\n\t}\n\tif (typeof value.scope === \"string\") {\n\t\tauth.scope = value.scope;\n\t}\n\tif (typeof value.clientId === \"string\") {\n\t\tauth.clientId = value.clientId;\n\t}\n\tif (typeof value.clientSecret === \"string\") {\n\t\tauth.clientSecret = value.clientSecret;\n\t}\n\tif (typeof value.clientMetadataUrl === \"string\") {\n\t\tauth.clientMetadataUrl = value.clientMetadataUrl;\n\t}\n\tif (typeof value.resourceMetadataUrl === \"string\") {\n\t\tauth.resourceMetadataUrl = value.resourceMetadataUrl;\n\t}\n\tif (\n\t\tvalue.tokenEndpointAuthMethod === \"client_secret_basic\" ||\n\t\tvalue.tokenEndpointAuthMethod === \"client_secret_post\" ||\n\t\tvalue.tokenEndpointAuthMethod === \"none\"\n\t) {\n\t\tauth.tokenEndpointAuthMethod = value.tokenEndpointAuthMethod;\n\t}\n\treturn Object.keys(auth).length > 0 ? auth : undefined;\n}\n\nfunction clampMs(value: unknown, fallback: number, min: number, max: number): number {\n\tconst numeric = asFiniteNumber(value);\n\tif (numeric === undefined) {\n\t\treturn fallback;\n\t}\n\treturn Math.max(min, Math.min(max, Math.floor(numeric)));\n}\n\nfunction deepMergeRecord(base: Record<string, unknown>, overrides: Record<string, unknown>): Record<string, unknown> {\n\tconst result: Record<string, unknown> = { ...base };\n\tfor (const [key, value] of Object.entries(overrides)) {\n\t\tif (value === undefined) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (value === null) {\n\t\t\tdelete result[key];\n\t\t\tcontinue;\n\t\t}\n\t\tconst baseValue = base[key];\n\t\tif (isRecord(baseValue) && isRecord(value)) {\n\t\t\tresult[key] = deepMergeRecord(baseValue, value);\n\t\t} else {\n\t\t\tresult[key] = value;\n\t\t}\n\t}\n\treturn result;\n}\n\nexport function normalizeMcpServerId(id: string): string {\n\tconst normalized = id\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9_-]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\")\n\t\t.slice(0, 80);\n\treturn normalized || \"server\";\n}\n\nexport function normalizeMcpDirectToolSegment(value: string): string {\n\tconst normalized = value\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9_]+/g, \"_\")\n\t\t.replace(/^_+|_+$/g, \"\")\n\t\t.slice(0, 80);\n\treturn normalized || \"tool\";\n}\n\nexport function getMcpDirectToolName(serverId: string, toolName: string): string {\n\treturn `mcp__${normalizeMcpDirectToolSegment(serverId)}__${normalizeMcpDirectToolSegment(toolName)}`;\n}\n\nexport function getMcpSourceLabel(source: McpConfigSource): string {\n\treturn source.label;\n}\n\nexport function sourceForMcpConfigPath(\n\tpath: string,\n\tsource: Omit<McpConfigSource, \"baseDir\" | \"path\">,\n): McpConfigSource {\n\treturn {\n\t\t...source,\n\t\tpath: resolvePath(path),\n\t\tbaseDir: dirname(resolvePath(path)),\n\t};\n}\n\nexport function createEmptyMcpMergedConfig(): McpMergedConfigData {\n\treturn {\n\t\tsettings: {},\n\t\tservers: new Map(),\n\t\tserverSources: new Map(),\n\t\tserverDefinedIn: new Map(),\n\t\tdiagnostics: [],\n\t\tsources: [],\n\t};\n}\n\nexport function mergeMcpConfigFile(\n\tmerged: McpMergedConfigData,\n\trawConfig: McpRawConfigFile,\n\tsource: McpConfigSource,\n): void {\n\tmerged.sources.push(source);\n\tif (rawConfig.settings && isRecord(rawConfig.settings)) {\n\t\tmerged.settings = deepMergeRecord(merged.settings, rawConfig.settings);\n\t}\n\tif (!rawConfig.servers || !isRecord(rawConfig.servers)) {\n\t\treturn;\n\t}\n\n\tconst normalizedIds = new Map<string, string>();\n\tfor (const rawId of Object.keys(rawConfig.servers)) {\n\t\tconst normalized = normalizeMcpServerId(rawId);\n\t\tconst existingRawId = normalizedIds.get(normalized);\n\t\tif (existingRawId && existingRawId !== rawId) {\n\t\t\tmerged.diagnostics.push({\n\t\t\t\tseverity: \"warning\",\n\t\t\t\tmessage: `MCP server id ${JSON.stringify(rawId)} collides with ${JSON.stringify(existingRawId)} after normalization`,\n\t\t\t\tpath: source.path,\n\t\t\t\tserverId: normalized,\n\t\t\t});\n\t\t}\n\t\tnormalizedIds.set(normalized, rawId);\n\t}\n\n\tfor (const [rawId, rawServer] of Object.entries(rawConfig.servers)) {\n\t\tconst normalizedId = normalizeMcpServerId(rawId);\n\t\tif (rawServer === null) {\n\t\t\tmerged.servers.delete(normalizedId);\n\t\t\tmerged.serverSources.delete(normalizedId);\n\t\t\tmerged.serverDefinedIn.delete(normalizedId);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!isRecord(rawServer)) {\n\t\t\tmerged.diagnostics.push({\n\t\t\t\tseverity: \"warning\",\n\t\t\t\tmessage: `MCP server ${JSON.stringify(rawId)} ignored because it is not an object`,\n\t\t\t\tpath: source.path,\n\t\t\t\tserverId: normalizedId,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst previousSource = merged.serverSources.get(normalizedId);\n\t\tconst canMergeWithExisting = previousSource?.scope === source.scope;\n\t\tconst current = canMergeWithExisting ? (merged.servers.get(normalizedId) ?? {}) : {};\n\t\tmerged.servers.set(normalizedId, deepMergeRecord(current, rawServer));\n\t\tmerged.serverSources.set(normalizedId, source);\n\t\tconst definedIn = canMergeWithExisting ? (merged.serverDefinedIn.get(normalizedId) ?? []) : [];\n\t\tdefinedIn.push(source);\n\t\tmerged.serverDefinedIn.set(normalizedId, definedIn);\n\t}\n}\n\nfunction inferTransport(server: Record<string, unknown>): McpTransportKind {\n\tif (typeof server.transport === \"string\") {\n\t\treturn asTransport(server.transport, \"stdio\");\n\t}\n\tif (typeof server.url === \"string\") {\n\t\treturn \"streamable-http\";\n\t}\n\treturn \"stdio\";\n}\n\nfunction normalizeSettings(settings: Record<string, unknown>): McpSettings {\n\tconst directTools = asBoolean(settings.directTools) ?? DEFAULT_MCP_SETTINGS.directTools;\n\tconst resources = settings.resources === \"disabled\" ? \"disabled\" : \"explicit\";\n\tconst prompts =\n\t\tsettings.prompts === \"disabled\" || settings.prompts === \"model\" || settings.prompts === \"user-preview\"\n\t\t\t? settings.prompts\n\t\t\t: DEFAULT_MCP_SETTINGS.prompts;\n\treturn {\n\t\tenabled: asBoolean(settings.enabled) ?? DEFAULT_MCP_SETTINGS.enabled,\n\t\tmode: \"proxy\",\n\t\tidleTimeoutMs: clampMs(settings.idleTimeoutMs, DEFAULT_MCP_SETTINGS.idleTimeoutMs, 1_000, 60 * 60 * 1000),\n\t\tconnectTimeoutMs: clampMs(settings.connectTimeoutMs, DEFAULT_MCP_SETTINGS.connectTimeoutMs, 1_000, 120_000),\n\t\tmetadataTimeoutMs: clampMs(settings.metadataTimeoutMs, DEFAULT_MCP_SETTINGS.metadataTimeoutMs, 1_000, 120_000),\n\t\tcallTimeoutMs: clampMs(settings.callTimeoutMs, DEFAULT_MCP_SETTINGS.callTimeoutMs, 1_000, 60 * 60 * 1000),\n\t\tmaxOutputBytes: clampMs(settings.maxOutputBytes, DEFAULT_MCP_SETTINGS.maxOutputBytes, 1024, 10 * 1024 * 1024),\n\t\tmaxOutputLines: clampMs(settings.maxOutputLines, DEFAULT_MCP_SETTINGS.maxOutputLines, 1, 200_000),\n\t\tdirectTools,\n\t\tresources,\n\t\tprompts,\n\t\tmetadataRefreshMs: clampMs(\n\t\t\tsettings.metadataRefreshMs,\n\t\t\tDEFAULT_MCP_SETTINGS.metadataRefreshMs,\n\t\t\t1_000,\n\t\t\t30 * 24 * 60 * 60 * 1000,\n\t\t),\n\t};\n}\n\nfunction normalizeServer(\n\tid: string,\n\tserver: Record<string, unknown>,\n\tsource: McpConfigSource,\n\tdefinedIn: McpConfigSource[],\n\tdiagnostics: McpConfigDiagnostic[],\n): McpResolvedServerConfig | undefined {\n\tconst transport = inferTransport(server);\n\tconst command = typeof server.command === \"string\" ? server.command.trim() : undefined;\n\tconst url = typeof server.url === \"string\" ? server.url.trim() : undefined;\n\tconst enabled = asBoolean(server.enabled) ?? true;\n\tif (enabled && transport === \"stdio\" && !command) {\n\t\tdiagnostics.push({\n\t\t\tseverity: \"error\",\n\t\t\tmessage: `MCP server ${id} is enabled but has no stdio command`,\n\t\t\tpath: source.path,\n\t\t\tserverId: id,\n\t\t});\n\t\treturn undefined;\n\t}\n\tif (enabled && (transport === \"streamable-http\" || transport === \"sse\") && !url) {\n\t\tdiagnostics.push({\n\t\t\tseverity: \"error\",\n\t\t\tmessage: `MCP server ${id} is enabled but has no URL`,\n\t\t\tpath: source.path,\n\t\t\tserverId: id,\n\t\t});\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\tid,\n\t\tenabled,\n\t\tdisplayName:\n\t\t\ttypeof server.displayName === \"string\" && server.displayName.trim().length > 0\n\t\t\t\t? server.displayName.trim()\n\t\t\t\t: id,\n\t\ttransport,\n\t\tlifecycle: asLifecycle(server.lifecycle),\n\t\tincludeTools: isStringArray(server.includeTools) ? [...server.includeTools] : [],\n\t\texcludeTools: isStringArray(server.excludeTools) ? [...server.excludeTools] : [],\n\t\tdirectTools: asDirectTools(server.directTools),\n\t\tconnectTimeoutMs: asFiniteNumber(server.connectTimeoutMs),\n\t\tcallTimeoutMs: asFiniteNumber(server.callTimeoutMs),\n\t\tidleTimeoutMs: asFiniteNumber(server.idleTimeoutMs),\n\t\tmetadataRefreshMs: asFiniteNumber(server.metadataRefreshMs),\n\t\t...(command ? { command } : {}),\n\t\targs: isStringArray(server.args) ? [...server.args] : [],\n\t\t...(typeof server.cwd === \"string\" && server.cwd.trim().length > 0 ? { cwd: server.cwd.trim() } : {}),\n\t\tenv: asStringRecord(server.env),\n\t\tenvAllowlist: isStringArray(server.envAllowlist) ? [...server.envAllowlist] : [],\n\t\t...(url ? { url } : {}),\n\t\theaders: asStringRecord(server.headers),\n\t\tauth: asAuthConfig(server.auth),\n\t\tsource,\n\t\tdefinedIn,\n\t};\n}\n\nexport function finalizeMcpConfig(merged: McpMergedConfigData): McpResolvedConfig {\n\tconst settings = normalizeSettings(merged.settings);\n\tconst diagnostics = [...merged.diagnostics];\n\tconst servers: Record<string, McpResolvedServerConfig> = {};\n\tfor (const [id, rawServer] of merged.servers.entries()) {\n\t\tconst source = merged.serverSources.get(id);\n\t\tif (!source) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst normalized = normalizeServer(\n\t\t\tid,\n\t\t\trawServer,\n\t\t\tsource,\n\t\t\tmerged.serverDefinedIn.get(id) ?? [source],\n\t\t\tdiagnostics,\n\t\t);\n\t\tif (normalized) {\n\t\t\tservers[id] = normalized;\n\t\t}\n\t}\n\treturn { settings, servers, diagnostics, sources: [...merged.sources] };\n}\n\nexport function serverMatchesToolFilters(server: McpResolvedServerConfig, toolName: string): boolean {\n\tif (server.includeTools.length > 0 && !server.includeTools.includes(toolName)) {\n\t\treturn false;\n\t}\n\treturn !server.excludeTools.includes(toolName);\n}\n\nexport function getServerTimeoutMs(\n\tserver: McpResolvedServerConfig,\n\tsettings: McpSettings,\n\tkind: \"connect\" | \"metadata\" | \"call\" | \"idle\" | \"refresh\",\n): number {\n\tswitch (kind) {\n\t\tcase \"connect\":\n\t\t\treturn server.connectTimeoutMs ?? settings.connectTimeoutMs;\n\t\tcase \"metadata\":\n\t\t\treturn settings.metadataTimeoutMs;\n\t\tcase \"call\":\n\t\t\treturn server.callTimeoutMs ?? settings.callTimeoutMs;\n\t\tcase \"idle\":\n\t\t\treturn server.idleTimeoutMs ?? settings.idleTimeoutMs;\n\t\tcase \"refresh\":\n\t\t\treturn server.metadataRefreshMs ?? settings.metadataRefreshMs;\n\t}\n}\n\nexport function mcpTransportToDto(transport: McpTransportKind): \"stdio\" | \"streamable_http\" | \"sse\" {\n\treturn transport === \"streamable-http\" ? \"streamable_http\" : transport;\n}\n\nexport function mcpLifecycleToDto(lifecycle: McpLifecycle): \"lazy\" | \"eager\" | \"keep_alive\" {\n\treturn lifecycle === \"keep-alive\" ? \"keep_alive\" : lifecycle;\n}\n\nexport function getMcpProjectConfigPaths(cwd: string): string[] {\n\treturn [resolvePath(\".mcp.json\", cwd), resolvePath(`${CONFIG_DIR_NAME}/mcp.json`, cwd)];\n}\n\nexport function hashMcpMetadata(value: unknown): string {\n\treturn `sha256:${createHash(\"sha256\").update(stableStringify(value)).digest(\"hex\")}`;\n}\n\nexport function hashMcpServerConfig(server: McpResolvedServerConfig): string {\n\treturn hashMcpMetadata({\n\t\tid: server.id,\n\t\tenabled: server.enabled,\n\t\tdisplayName: server.displayName,\n\t\ttransport: server.transport,\n\t\tlifecycle: server.lifecycle,\n\t\tincludeTools: server.includeTools,\n\t\texcludeTools: server.excludeTools,\n\t\tdirectTools: server.directTools,\n\t\tconnectTimeoutMs: server.connectTimeoutMs,\n\t\tcallTimeoutMs: server.callTimeoutMs,\n\t\tidleTimeoutMs: server.idleTimeoutMs,\n\t\tmetadataRefreshMs: server.metadataRefreshMs,\n\t\tcommand: server.command,\n\t\targs: server.args,\n\t\tcwd: server.cwd,\n\t\tenv: server.env,\n\t\tenvAllowlist: server.envAllowlist,\n\t\turl: server.url,\n\t\theaders: server.headers,\n\t\tauth: server.auth,\n\t\tsourceScope: server.source.scope,\n\t\tsourcePath: server.source.path,\n\t});\n}\n\nexport function stableStringify(value: unknown): string {\n\tif (value === null || typeof value !== \"object\") {\n\t\treturn JSON.stringify(value);\n\t}\n\tif (Array.isArray(value)) {\n\t\treturn `[${value.map((entry) => stableStringify(entry)).join(\",\")}]`;\n\t}\n\tconst record = value as Record<string, unknown>;\n\treturn `{${Object.keys(record)\n\t\t.sort()\n\t\t.map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)\n\t\t.join(\",\")}}`;\n}\n"]}

package/dist/core/mcp/config.js

@@ -0,0 +1,385 @@
+import { createHash } from "node:crypto";
+import { dirname } from "node:path";
+import { CONFIG_DIR_NAME } from "../../config.js";
+import { resolvePath } from "../../utils/paths.js";
+export const DEFAULT_MCP_SETTINGS = {
+    enabled: true,
+    mode: "proxy",
+    idleTimeoutMs: 600_000,
+    connectTimeoutMs: 15_000,
+    metadataTimeoutMs: 10_000,
+    callTimeoutMs: 600_000,
+    maxOutputBytes: 50 * 1024,
+    maxOutputLines: 2000,
+    directTools: false,
+    resources: "explicit",
+    prompts: "user-preview",
+    metadataRefreshMs: 24 * 60 * 60 * 1000,
+};
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isString(value) {
+    return typeof value === "string";
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every(isString);
+}
+function asFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function asBoolean(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+function asStringRecord(value) {
+    if (!isRecord(value)) {
+        return {};
+    }
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry === "string") {
+            result[key] = entry;
+        }
+    }
+    return result;
+}
+function asTransport(value, fallback) {
+    return value === "stdio" || value === "streamable-http" || value === "sse" ? value : fallback;
+}
+function asLifecycle(value) {
+    return value === "eager" || value === "keep-alive" || value === "lazy" ? value : "lazy";
+}
+function asDirectTools(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (isStringArray(value)) {
+        return [...value];
+    }
+    return false;
+}
+function asAuthConfig(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const type = value.type;
+    const auth = {};
+    if (type === "none" || type === "bearer" || type === "oauth" || type === "env") {
+        auth.type = type;
+    }
+    if (typeof value.token === "string") {
+        auth.token = value.token;
+    }
+    if (typeof value.env === "string") {
+        auth.env = value.env;
+    }
+    if (value.flow === "browser" || value.flow === "device" || value.flow === "auto") {
+        auth.flow = value.flow;
+    }
+    if (typeof value.scope === "string") {
+        auth.scope = value.scope;
+    }
+    if (typeof value.clientId === "string") {
+        auth.clientId = value.clientId;
+    }
+    if (typeof value.clientSecret === "string") {
+        auth.clientSecret = value.clientSecret;
+    }
+    if (typeof value.clientMetadataUrl === "string") {
+        auth.clientMetadataUrl = value.clientMetadataUrl;
+    }
+    if (typeof value.resourceMetadataUrl === "string") {
+        auth.resourceMetadataUrl = value.resourceMetadataUrl;
+    }
+    if (value.tokenEndpointAuthMethod === "client_secret_basic" ||
+        value.tokenEndpointAuthMethod === "client_secret_post" ||
+        value.tokenEndpointAuthMethod === "none") {
+        auth.tokenEndpointAuthMethod = value.tokenEndpointAuthMethod;
+    }
+    return Object.keys(auth).length > 0 ? auth : undefined;
+}
+function clampMs(value, fallback, min, max) {
+    const numeric = asFiniteNumber(value);
+    if (numeric === undefined) {
+        return fallback;
+    }
+    return Math.max(min, Math.min(max, Math.floor(numeric)));
+}
+function deepMergeRecord(base, overrides) {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(overrides)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (value === null) {
+            delete result[key];
+            continue;
+        }
+        const baseValue = base[key];
+        if (isRecord(baseValue) && isRecord(value)) {
+            result[key] = deepMergeRecord(baseValue, value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+export function normalizeMcpServerId(id) {
+    const normalized = id
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+    return normalized || "server";
+}
+export function normalizeMcpDirectToolSegment(value) {
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .slice(0, 80);
+    return normalized || "tool";
+}
+export function getMcpDirectToolName(serverId, toolName) {
+    return `mcp__${normalizeMcpDirectToolSegment(serverId)}__${normalizeMcpDirectToolSegment(toolName)}`;
+}
+export function getMcpSourceLabel(source) {
+    return source.label;
+}
+export function sourceForMcpConfigPath(path, source) {
+    return {
+        ...source,
+        path: resolvePath(path),
+        baseDir: dirname(resolvePath(path)),
+    };
+}
+export function createEmptyMcpMergedConfig() {
+    return {
+        settings: {},
+        servers: new Map(),
+        serverSources: new Map(),
+        serverDefinedIn: new Map(),
+        diagnostics: [],
+        sources: [],
+    };
+}
+export function mergeMcpConfigFile(merged, rawConfig, source) {
+    merged.sources.push(source);
+    if (rawConfig.settings && isRecord(rawConfig.settings)) {
+        merged.settings = deepMergeRecord(merged.settings, rawConfig.settings);
+    }
+    if (!rawConfig.servers || !isRecord(rawConfig.servers)) {
+        return;
+    }
+    const normalizedIds = new Map();
+    for (const rawId of Object.keys(rawConfig.servers)) {
+        const normalized = normalizeMcpServerId(rawId);
+        const existingRawId = normalizedIds.get(normalized);
+        if (existingRawId && existingRawId !== rawId) {
+            merged.diagnostics.push({
+                severity: "warning",
+                message: `MCP server id ${JSON.stringify(rawId)} collides with ${JSON.stringify(existingRawId)} after normalization`,
+                path: source.path,
+                serverId: normalized,
+            });
+        }
+        normalizedIds.set(normalized, rawId);
+    }
+    for (const [rawId, rawServer] of Object.entries(rawConfig.servers)) {
+        const normalizedId = normalizeMcpServerId(rawId);
+        if (rawServer === null) {
+            merged.servers.delete(normalizedId);
+            merged.serverSources.delete(normalizedId);
+            merged.serverDefinedIn.delete(normalizedId);
+            continue;
+        }
+        if (!isRecord(rawServer)) {
+            merged.diagnostics.push({
+                severity: "warning",
+                message: `MCP server ${JSON.stringify(rawId)} ignored because it is not an object`,
+                path: source.path,
+                serverId: normalizedId,
+            });
+            continue;
+        }
+        const previousSource = merged.serverSources.get(normalizedId);
+        const canMergeWithExisting = previousSource?.scope === source.scope;
+        const current = canMergeWithExisting ? (merged.servers.get(normalizedId) ?? {}) : {};
+        merged.servers.set(normalizedId, deepMergeRecord(current, rawServer));
+        merged.serverSources.set(normalizedId, source);
+        const definedIn = canMergeWithExisting ? (merged.serverDefinedIn.get(normalizedId) ?? []) : [];
+        definedIn.push(source);
+        merged.serverDefinedIn.set(normalizedId, definedIn);
+    }
+}
+function inferTransport(server) {
+    if (typeof server.transport === "string") {
+        return asTransport(server.transport, "stdio");
+    }
+    if (typeof server.url === "string") {
+        return "streamable-http";
+    }
+    return "stdio";
+}
+function normalizeSettings(settings) {
+    const directTools = asBoolean(settings.directTools) ?? DEFAULT_MCP_SETTINGS.directTools;
+    const resources = settings.resources === "disabled" ? "disabled" : "explicit";
+    const prompts = settings.prompts === "disabled" || settings.prompts === "model" || settings.prompts === "user-preview"
+        ? settings.prompts
+        : DEFAULT_MCP_SETTINGS.prompts;
+    return {
+        enabled: asBoolean(settings.enabled) ?? DEFAULT_MCP_SETTINGS.enabled,
+        mode: "proxy",
+        idleTimeoutMs: clampMs(settings.idleTimeoutMs, DEFAULT_MCP_SETTINGS.idleTimeoutMs, 1_000, 60 * 60 * 1000),
+        connectTimeoutMs: clampMs(settings.connectTimeoutMs, DEFAULT_MCP_SETTINGS.connectTimeoutMs, 1_000, 120_000),
+        metadataTimeoutMs: clampMs(settings.metadataTimeoutMs, DEFAULT_MCP_SETTINGS.metadataTimeoutMs, 1_000, 120_000),
+        callTimeoutMs: clampMs(settings.callTimeoutMs, DEFAULT_MCP_SETTINGS.callTimeoutMs, 1_000, 60 * 60 * 1000),
+        maxOutputBytes: clampMs(settings.maxOutputBytes, DEFAULT_MCP_SETTINGS.maxOutputBytes, 1024, 10 * 1024 * 1024),
+        maxOutputLines: clampMs(settings.maxOutputLines, DEFAULT_MCP_SETTINGS.maxOutputLines, 1, 200_000),
+        directTools,
+        resources,
+        prompts,
+        metadataRefreshMs: clampMs(settings.metadataRefreshMs, DEFAULT_MCP_SETTINGS.metadataRefreshMs, 1_000, 30 * 24 * 60 * 60 * 1000),
+    };
+}
+function normalizeServer(id, server, source, definedIn, diagnostics) {
+    const transport = inferTransport(server);
+    const command = typeof server.command === "string" ? server.command.trim() : undefined;
+    const url = typeof server.url === "string" ? server.url.trim() : undefined;
+    const enabled = asBoolean(server.enabled) ?? true;
+    if (enabled && transport === "stdio" && !command) {
+        diagnostics.push({
+            severity: "error",
+            message: `MCP server ${id} is enabled but has no stdio command`,
+            path: source.path,
+            serverId: id,
+        });
+        return undefined;
+    }
+    if (enabled && (transport === "streamable-http" || transport === "sse") && !url) {
+        diagnostics.push({
+            severity: "error",
+            message: `MCP server ${id} is enabled but has no URL`,
+            path: source.path,
+            serverId: id,
+        });
+        return undefined;
+    }
+    return {
+        id,
+        enabled,
+        displayName: typeof server.displayName === "string" && server.displayName.trim().length > 0
+            ? server.displayName.trim()
+            : id,
+        transport,
+        lifecycle: asLifecycle(server.lifecycle),
+        includeTools: isStringArray(server.includeTools) ? [...server.includeTools] : [],
+        excludeTools: isStringArray(server.excludeTools) ? [...server.excludeTools] : [],
+        directTools: asDirectTools(server.directTools),
+        connectTimeoutMs: asFiniteNumber(server.connectTimeoutMs),
+        callTimeoutMs: asFiniteNumber(server.callTimeoutMs),
+        idleTimeoutMs: asFiniteNumber(server.idleTimeoutMs),
+        metadataRefreshMs: asFiniteNumber(server.metadataRefreshMs),
+        ...(command ? { command } : {}),
+        args: isStringArray(server.args) ? [...server.args] : [],
+        ...(typeof server.cwd === "string" && server.cwd.trim().length > 0 ? { cwd: server.cwd.trim() } : {}),
+        env: asStringRecord(server.env),
+        envAllowlist: isStringArray(server.envAllowlist) ? [...server.envAllowlist] : [],
+        ...(url ? { url } : {}),
+        headers: asStringRecord(server.headers),
+        auth: asAuthConfig(server.auth),
+        source,
+        definedIn,
+    };
+}
+export function finalizeMcpConfig(merged) {
+    const settings = normalizeSettings(merged.settings);
+    const diagnostics = [...merged.diagnostics];
+    const servers = {};
+    for (const [id, rawServer] of merged.servers.entries()) {
+        const source = merged.serverSources.get(id);
+        if (!source) {
+            continue;
+        }
+        const normalized = normalizeServer(id, rawServer, source, merged.serverDefinedIn.get(id) ?? [source], diagnostics);
+        if (normalized) {
+            servers[id] = normalized;
+        }
+    }
+    return { settings, servers, diagnostics, sources: [...merged.sources] };
+}
+export function serverMatchesToolFilters(server, toolName) {
+    if (server.includeTools.length > 0 && !server.includeTools.includes(toolName)) {
+        return false;
+    }
+    return !server.excludeTools.includes(toolName);
+}
+export function getServerTimeoutMs(server, settings, kind) {
+    switch (kind) {
+        case "connect":
+            return server.connectTimeoutMs ?? settings.connectTimeoutMs;
+        case "metadata":
+            return settings.metadataTimeoutMs;
+        case "call":
+            return server.callTimeoutMs ?? settings.callTimeoutMs;
+        case "idle":
+            return server.idleTimeoutMs ?? settings.idleTimeoutMs;
+        case "refresh":
+            return server.metadataRefreshMs ?? settings.metadataRefreshMs;
+    }
+}
+export function mcpTransportToDto(transport) {
+    return transport === "streamable-http" ? "streamable_http" : transport;
+}
+export function mcpLifecycleToDto(lifecycle) {
+    return lifecycle === "keep-alive" ? "keep_alive" : lifecycle;
+}
+export function getMcpProjectConfigPaths(cwd) {
+    return [resolvePath(".mcp.json", cwd), resolvePath(`${CONFIG_DIR_NAME}/mcp.json`, cwd)];
+}
+export function hashMcpMetadata(value) {
+    return `sha256:${createHash("sha256").update(stableStringify(value)).digest("hex")}`;
+}
+export function hashMcpServerConfig(server) {
+    return hashMcpMetadata({
+        id: server.id,
+        enabled: server.enabled,
+        displayName: server.displayName,
+        transport: server.transport,
+        lifecycle: server.lifecycle,
+        includeTools: server.includeTools,
+        excludeTools: server.excludeTools,
+        directTools: server.directTools,
+        connectTimeoutMs: server.connectTimeoutMs,
+        callTimeoutMs: server.callTimeoutMs,
+        idleTimeoutMs: server.idleTimeoutMs,
+        metadataRefreshMs: server.metadataRefreshMs,
+        command: server.command,
+        args: server.args,
+        cwd: server.cwd,
+        env: server.env,
+        envAllowlist: server.envAllowlist,
+        url: server.url,
+        headers: server.headers,
+        auth: server.auth,
+        sourceScope: server.source.scope,
+        sourcePath: server.source.path,
+    });
+}
+export function stableStringify(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
+    }
+    const record = value;
+    return `{${Object.keys(record)
+        .sort()
+        .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+        .join(",")}}`;
+}
+//# sourceMappingURL=config.js.map