@code-yeongyu/senpi 2026.7.4 → 2026.7.9-2

package/dist/core/extensions/builtin/mcp/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/mcp/connection.ts"],"names":[],"mappings":"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","sourcesContent":["import { UnauthorizedError } from \"@modelcontextprotocol/sdk/client/auth.js\";\nimport type { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { OAuthFlowError } from \"./auth/oauth-errors.ts\";\nimport type { McpOAuthProvider } from \"./auth/oauth-provider.ts\";\nimport type {\n\tServerConnectionListener,\n\tServerConnectionOptions,\n\tServerConnectionState,\n\tServerConnectionStateChangedEvent,\n\tServerConnectionToolsChangedEvent,\n} from \"./connection-types.ts\";\nimport { diagnoseCapturedMcpConnectFailure, diagnoseMcpConnectFailure } from \"./diagnose.ts\";\nimport { ConnectError } from \"./errors.ts\";\nimport type { McpLogger } from \"./log.ts\";\nimport { subscribeMcpServerLogging } from \"./logging.ts\";\nimport { subscribeMcpListChanged } from \"./notifications.ts\";\nimport { subscribeMcpResourceUpdated } from \"./resources.ts\";\nimport {\n\tconnectMcpTransport,\n\tcreateMcpTransport,\n\ttype McpTransportConnection,\n\tshutdownMcpTransport,\n} from \"./transport.ts\";\nimport { type McpAsyncErrorSink, wrapAsync } from \"./wrap.ts\";\n\nexport type {\n\tServerConnectionOptions,\n\tServerConnectionState,\n\tServerConnectionStateChangedEvent,\n\tServerConnectionToolsChangedEvent,\n} from \"./connection-types.ts\";\n\nexport class ServerConnection {\n\treadonly serverName: string;\n\treadonly #logger: McpLogger;\n\treadonly #env: Record<string, string | undefined> | undefined;\n\treadonly #config: ServerConnectionOptions[\"config\"];\n\treadonly #authProvider: McpOAuthProvider | undefined;\n\t#state: ServerConnectionState;\n\t#generation = 0;\n\t#connection: McpTransportConnection | undefined;\n\t#pendingConnection: McpTransportConnection | undefined;\n\t#pendingConnect: Promise<Client> | undefined;\n\t#lastError: Error | undefined;\n\treadonly #stateListeners = new Set<ServerConnectionListener<ServerConnectionStateChangedEvent>>();\n\treadonly #toolsListeners = new Set<ServerConnectionListener<ServerConnectionToolsChangedEvent>>();\n\treadonly #shutdownConnections = new Map<McpTransportConnection, Promise<void>>();\n\n\tconstructor(options: ServerConnectionOptions) {\n\t\tthis.serverName = options.serverName;\n\t\tthis.#config = options.config;\n\t\tthis.#logger = options.logger;\n\t\tthis.#env = options.env;\n\t\tthis.#authProvider = options.authProvider;\n\t\tthis.#state = options.config.enabled ? \"idle\" : \"disabled\";\n\t}\n\n\tget state(): ServerConnectionState {\n\t\treturn this.#state;\n\t}\n\tget lastError(): Error | undefined {\n\t\treturn this.#lastError;\n\t}\n\tget generation(): number {\n\t\treturn this.#generation;\n\t}\n\n\trefreshCapturedDiagnostics(): void {\n\t\tconst current = this.#lastError;\n\t\tif (current === undefined) return;\n\t\tconst capturedError = diagnoseCapturedMcpConnectFailure({\n\t\t\tconfig: this.#config,\n\t\t\tcause: current,\n\t\t\tenv: this.#env,\n\t\t\tlogger: this.#logger,\n\t\t\tserverName: this.serverName,\n\t\t});\n\t\tif (capturedError !== null && capturedError.message !== current.message) {\n\t\t\tthis.#lastError = capturedError;\n\t\t}\n\t}\n\n\tget client(): Client {\n\t\tif (this.#connection === undefined) {\n\t\t\tthrow new ConnectError(`MCP server ${this.serverName} is not connected`, {\n\t\t\t\tphase: \"client\",\n\t\t\t\tserverName: this.serverName,\n\t\t\t});\n\t\t}\n\t\treturn this.#connection.client;\n\t}\n\n\tgetRootPid(): number | null {\n\t\treturn this.#connection?.getRootPid() ?? null;\n\t}\n\tconnect(): Promise<Client> {\n\t\tif (this.#state === \"disabled\") {\n\t\t\treturn Promise.reject(this.#connectError(`MCP server ${this.serverName} is disabled`, \"connect\"));\n\t\t}\n\t\tif (this.#state === \"connected\") return Promise.resolve(this.client);\n\t\tif (this.#pendingConnect) return this.#pendingConnect;\n\n\t\tconst generation = this.#generation;\n\t\tconst connection = this.#createTransportConnection(generation);\n\t\tthis.#pendingConnection = connection;\n\t\tthis.#setState(\"connecting\");\n\t\tthis.#pendingConnect = this.#connectTransport(connection, generation).finally(() => {\n\t\t\tif (this.#pendingConnect !== undefined && generation === this.#generation) this.#pendingConnect = undefined;\n\t\t\tif (this.#pendingConnection === connection) this.#pendingConnection = undefined;\n\t\t});\n\t\treturn this.#pendingConnect;\n\t}\n\n\tasync renew(): Promise<Client> {\n\t\tif (this.#state === \"disabled\") {\n\t\t\tthrow this.#connectError(`MCP server ${this.serverName} is disabled`, \"renew\");\n\t\t}\n\t\tthis.#generation++;\n\t\tthis.#pendingConnect = undefined;\n\t\tthis.#setState(\"idle\");\n\t\tawait this.#disposeOwnedConnections();\n\t\treturn this.connect();\n\t}\n\n\tbumpGeneration(): Promise<void> {\n\t\tthis.#generation++;\n\t\tthis.#pendingConnect = undefined;\n\t\tthis.#lastError = undefined;\n\t\tif (this.#state !== \"disabled\") this.#setState(\"idle\");\n\t\treturn this.#disposeOwnedConnections();\n\t}\n\n\tdisable(): Promise<void> {\n\t\tthis.#generation++;\n\t\tthis.#pendingConnect = undefined;\n\t\tthis.#lastError = undefined;\n\t\tthis.#setState(\"disabled\");\n\t\treturn this.#disposeOwnedConnections();\n\t}\n\n\tasync dispose(): Promise<void> {\n\t\tthis.#generation++;\n\t\tthis.#pendingConnect = undefined;\n\t\tthis.#setState(\"disabled\");\n\t\tawait this.#disposeOwnedConnections();\n\t}\n\n\tmarkDegraded(error: Error): void {\n\t\tthis.#markFailure(\"degraded\", error);\n\t}\n\tmarkSuspended(error?: Error): void {\n\t\tthis.#markFailure(\"suspended\", error);\n\t}\n\tmarkNeedsAuth(error?: Error): void {\n\t\tthis.#markFailure(\"needs_auth\", error);\n\t}\n\tmarkNeedsClientRegistration(error?: Error): void {\n\t\tthis.#markFailure(\"needs_client_registration\", error);\n\t}\n\n\tmarkToolsChanged(): void {\n\t\tthis.#emit(this.#toolsListeners, {\n\t\t\ttype: \"tools_changed\",\n\t\t\tserverName: this.serverName,\n\t\t\tgeneration: this.#generation,\n\t\t});\n\t}\n\n\tonStateChange(listener: ServerConnectionListener<ServerConnectionStateChangedEvent>): () => void {\n\t\tthis.#stateListeners.add(listener);\n\t\treturn () => this.#stateListeners.delete(listener);\n\t}\n\n\tonToolsChanged(listener: ServerConnectionListener<ServerConnectionToolsChangedEvent>): () => void {\n\t\tthis.#toolsListeners.add(listener);\n\t\treturn () => this.#toolsListeners.delete(listener);\n\t}\n\n\t#createTransportConnection(generation: number): McpTransportConnection {\n\t\tconst connection = createMcpTransport({\n\t\t\tauthProvider: this.#authProvider,\n\t\t\tconfig: this.#config,\n\t\t\tenv: this.#env,\n\t\t\tlogger: this.#logger,\n\t\t\tserverName: this.serverName,\n\t\t});\n\t\tconnection.transport.onclose = wrapAsync(\n\t\t\t\"connection.transport.onclose\",\n\t\t\t() => {\n\t\t\t\tif (this.#shutdownConnections.has(connection)) return;\n\t\t\t\tif (connection === this.#pendingConnection && this.#state === \"connecting\") {\n\t\t\t\t\tconst closeError = this.#connectError(`MCP server ${this.serverName} transport closed`, \"close\", true);\n\t\t\t\t\tconst capturedError = diagnoseCapturedMcpConnectFailure({\n\t\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\t\tcause: closeError,\n\t\t\t\t\t\tenv: this.#env,\n\t\t\t\t\t\tlogger: this.#logger,\n\t\t\t\t\t\tserverName: this.serverName,\n\t\t\t\t\t});\n\t\t\t\t\tif (capturedError !== null) this.markDegraded(capturedError);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (connection !== this.#connection && connection !== this.#pendingConnection) return;\n\t\t\t\tif (generation === this.#generation && this.#state !== \"disabled\") {\n\t\t\t\t\tthis.markDegraded(this.#connectError(`MCP server ${this.serverName} transport closed`, \"close\", true));\n\t\t\t\t}\n\t\t\t},\n\t\t\tthis.#sink,\n\t\t);\n\t\treturn connection;\n\t}\n\n\tasync #connectTransport(connection: McpTransportConnection, generation: number): Promise<Client> {\n\t\ttry {\n\t\t\tawait connectMcpTransport(connection);\n\t\t} catch (error) {\n\t\t\tif (this.#pendingConnection === connection) this.#pendingConnection = undefined;\n\t\t\tawait this.#shutdown(connection);\n\t\t\tif (generation !== this.#generation || this.#state === \"disabled\") {\n\t\t\t\tthrow this.#connectError(`MCP server ${this.serverName} connect was superseded`, \"connect\", true);\n\t\t\t}\n\t\t\tif (isNeedsAuthError(error)) {\n\t\t\t\tconst authError = error instanceof Error ? error : new Error(String(error));\n\t\t\t\tthis.markNeedsAuth(authError);\n\t\t\t\tthrow authError;\n\t\t\t}\n\t\t\tconst connectError = await diagnoseMcpConnectFailure({\n\t\t\t\tconfig: this.#config,\n\t\t\t\tcause: error instanceof Error ? error : new Error(String(error)),\n\t\t\t\tenv: this.#env,\n\t\t\t\tlogger: this.#logger,\n\t\t\t\tserverName: this.serverName,\n\t\t\t});\n\t\t\tthis.markDegraded(connectError);\n\t\t\tthrow connectError;\n\t\t}\n\t\tif (generation !== this.#generation || this.#state === \"disabled\") {\n\t\t\tawait this.#shutdown(connection);\n\t\t\tthrow this.#connectError(`MCP server ${this.serverName} connect was superseded`, \"connect\", true);\n\t\t}\n\t\tif (this.#pendingConnection === connection) this.#pendingConnection = undefined;\n\t\tthis.#connection = connection;\n\t\tthis.#lastError = undefined;\n\t\t// Subscribe to list_changed on the fresh client (even if the server never\n\t\t// declared the capability) so dynamic catalog updates reach the service.\n\t\tsubscribeMcpListChanged(connection.client, () => this.markToolsChanged());\n\t\t// Resource updates ride the same refresh path: the service re-collects the\n\t\t// catalog (tools AND resources) on tools-changed.\n\t\tsubscribeMcpResourceUpdated(connection.client, () => this.markToolsChanged());\n\t\t// Server logging notifications (todo 42): RFC-5424 → the per-server\n\t\t// logger, filtered by config.logLevel, burst-capped.\n\t\tsubscribeMcpServerLogging(connection.client, { logLevel: this.#config.logLevel, logger: this.#logger });\n\t\tthis.#setState(\"connected\");\n\t\tthis.markToolsChanged();\n\t\treturn connection.client;\n\t}\n\n\tasync #disposeOwnedConnections(): Promise<void> {\n\t\tconst connections = new Set<McpTransportConnection>();\n\t\tconst connection = this.#connection;\n\t\tthis.#connection = undefined;\n\t\tif (connection !== undefined) connections.add(connection);\n\t\tconst pendingConnection = this.#pendingConnection;\n\t\tthis.#pendingConnection = undefined;\n\t\tif (pendingConnection !== undefined) connections.add(pendingConnection);\n\t\tawait Promise.all([...connections].map((item) => this.#shutdown(item)));\n\t}\n\n\tasync #shutdown(connection: McpTransportConnection): Promise<void> {\n\t\tconst pending = this.#shutdownConnections.get(connection);\n\t\tif (pending !== undefined) {\n\t\t\tawait pending;\n\t\t\treturn;\n\t\t}\n\t\tconst shutdown = (async () => {\n\t\t\tawait shutdownMcpTransport(connection);\n\t\t})();\n\t\tthis.#shutdownConnections.set(connection, shutdown);\n\t\ttry {\n\t\t\tawait shutdown;\n\t\t} finally {\n\t\t\tthis.#shutdownConnections.delete(connection);\n\t\t}\n\t}\n\n\t#setState(state: ServerConnectionState, error?: Error): void {\n\t\tif (this.#state === state) return;\n\t\tconst previousState = this.#state;\n\t\tthis.#state = state;\n\t\tthis.#emit(this.#stateListeners, {\n\t\t\ttype: \"state_changed\",\n\t\t\tserverName: this.serverName,\n\t\t\tpreviousState,\n\t\t\tstate,\n\t\t\tgeneration: this.#generation,\n\t\t\terror,\n\t\t});\n\t}\n\n\t#emit<TEvent>(listeners: Set<ServerConnectionListener<TEvent>>, event: TEvent): void {\n\t\tfor (const listener of listeners) {\n\t\t\tvoid wrapAsync(\"connection.event\", listener, this.#sink)(event);\n\t\t}\n\t}\n\n\t#markFailure(state: ServerConnectionState, error: Error | undefined): void {\n\t\tthis.#lastError = error;\n\t\tthis.#setState(state, error);\n\t}\n\n\t#connectError(message: string, phase: string, retriable?: true, cause?: unknown): ConnectError {\n\t\treturn new ConnectError(message, { cause, phase, retriable, serverName: this.serverName });\n\t}\n\n\tget #sink(): McpAsyncErrorSink {\n\t\treturn { logger: this.#logger };\n\t}\n}\n\nfunction isNeedsAuthError(error: unknown, depth = 0): boolean {\n\tif (error instanceof UnauthorizedError) return true;\n\tif (error instanceof OAuthFlowError) return error.terminal;\n\t// connectMcpTransport wraps the SDK error in a ConnectError; unwrap the cause.\n\tif (depth < 5 && error !== null && typeof error === \"object\" && \"cause\" in error) {\n\t\treturn isNeedsAuthError((error as { cause?: unknown }).cause, depth + 1);\n\t}\n\treturn false;\n}\n"]}

package/dist/core/extensions/builtin/mcp/diagnose.d.ts

@@ -0,0 +1,17 @@
+import type { McpServerConfig } from "./config-schema.ts";
+import { ConnectError } from "./errors.ts";
+import type { McpLogger } from "./log.ts";
+export declare const MCP_STDIO_DIAGNOSTIC_TIMEOUT_MS = 5000;
+export interface McpStdioDiagnosticOptions {
+    readonly config: McpServerConfig;
+    readonly env?: Record<string, string | undefined>;
+    readonly logger: McpLogger;
+}
+export interface McpConnectFailureDiagnosticOptions extends McpStdioDiagnosticOptions {
+    readonly serverName: string;
+    readonly cause: Error;
+}
+export declare function diagnoseMcpConnectFailure(options: McpConnectFailureDiagnosticOptions): Promise<ConnectError>;
+export declare function diagnoseCapturedMcpConnectFailure(options: McpConnectFailureDiagnosticOptions): ConnectError | null;
+export declare function maybeDiagnoseStdioFailure(options: McpStdioDiagnosticOptions): Promise<string | null>;
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/core/extensions/builtin/mcp/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/mcp/diagnose.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAGpD,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,kCAAmC,SAAQ,yBAAyB;IACpF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACtB;AAQD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,kCAAkC,GAAG,OAAO,CAAC,YAAY,CAAC,CAGlH;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,kCAAkC,GAAG,YAAY,GAAG,IAAI,CAKlH;AAkBD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe1G"}

package/dist/core/extensions/builtin/mcp/diagnose.js

@@ -0,0 +1,144 @@
+import { execFile } from "node:child_process";
+import { getDefaultEnvironment } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { ConnectError } from "./errors.js";
+import { redactMcpLogText } from "./log.js";
+export const MCP_STDIO_DIAGNOSTIC_TIMEOUT_MS = 5000;
+const MCP_STDIO_DIAGNOSTIC_MAX_BYTES = 2048;
+export async function diagnoseMcpConnectFailure(options) {
+    const diagnostic = await maybeDiagnoseStdioFailure(options);
+    return connectErrorFromDiagnostic(options, diagnostic);
+}
+export function diagnoseCapturedMcpConnectFailure(options) {
+    if (options.config.type !== "stdio")
+        return null;
+    const diagnostic = extractCapturedStderr(options.logger);
+    if (diagnostic.length === 0)
+        return null;
+    return connectErrorFromDiagnostic(options, boundDiagnostic(diagnostic));
+}
+function connectErrorFromDiagnostic(options, diagnostic) {
+    const message = diagnostic === null || diagnostic.length === 0
+        ? `MCP server ${options.serverName} failed during connect: ${options.cause.message}`
+        : `MCP server ${options.serverName} failed during connect: ${options.cause.message}\n${diagnostic}`;
+    return new ConnectError(message, {
+        cause: options.cause,
+        phase: "connect",
+        retriable: true,
+        serverName: options.serverName,
+    });
+}
+export async function maybeDiagnoseStdioFailure(options) {
+    if (options.config.type !== "stdio")
+        return null;
+    const captured = extractCapturedStderr(options.logger);
+    if (captured.length > 0)
+        return boundDiagnostic(captured);
+    const command = options.config.command;
+    if (command === undefined || command.trim().length === 0)
+        return null;
+    const result = await execFileForDiagnostics(command, options.config.args, {
+        cwd: options.config.cwd,
+        env: buildDiagnosticEnv(options),
+    });
+    if (isNodeErrorCode(result.error, "ENOENT"))
+        return commandNotFoundDiagnostic(command, options);
+    const lines = meaningfulLines(`${result.stderr}\n${result.stdout}`);
+    if (lines.length > 0)
+        return boundDiagnostic(lines);
+    if (isTimedOut(result.error))
+        return `diagnostic rerun timed out after ${MCP_STDIO_DIAGNOSTIC_TIMEOUT_MS}ms`;
+    return null;
+}
+function extractCapturedStderr(logger) {
+    const messages = [];
+    for (const line of logger.getRingBuffer()) {
+        const parsed = parseLogLine(line);
+        if (parsed?.channel === "stderr" && typeof parsed.message === "string") {
+            messages.push(parsed.message);
+        }
+    }
+    return meaningfulLines(messages.join("\n"));
+}
+function parseLogLine(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (typeof parsed === "object" && parsed !== null)
+            return parsed;
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function meaningfulLines(text) {
+    return text
+        .split(/\r?\n/)
+        .map((line) => redactMcpLogText(line.trim()))
+        .filter((line) => line.length > 0);
+}
+function boundDiagnostic(lines) {
+    let output = "";
+    for (const line of lines) {
+        const next = output.length === 0 ? line : `${output}\n${line}`;
+        if (Buffer.byteLength(next, "utf8") > MCP_STDIO_DIAGNOSTIC_MAX_BYTES)
+            break;
+        output = next;
+    }
+    return output || lines[0]?.slice(0, MCP_STDIO_DIAGNOSTIC_MAX_BYTES) || "";
+}
+function execFileForDiagnostics(command, args, options) {
+    return new Promise((resolve) => {
+        execFile(command, args ?? [], {
+            cwd: options.cwd,
+            env: options.env,
+            killSignal: "SIGKILL",
+            maxBuffer: MCP_STDIO_DIAGNOSTIC_MAX_BYTES * 4,
+            timeout: MCP_STDIO_DIAGNOSTIC_TIMEOUT_MS,
+        }, (error, stdout, stderr) => {
+            resolve({
+                error,
+                stdout,
+                stderr,
+            });
+        });
+    });
+}
+function buildDiagnosticEnv(options) {
+    return {
+        ...getDefaultEnvironment(),
+        ...definedEnv(options.env),
+        ...(options.config.env ?? {}),
+    };
+}
+function commandNotFoundDiagnostic(command, options) {
+    const env = buildDiagnosticEnv(options);
+    const cwd = options.config.cwd ?? process.cwd();
+    const path = env.PATH ?? "";
+    return [
+        `command not found: ${redactMcpLogText(command)}`,
+        `cwd: ${redactMcpLogText(cwd)}`,
+        `PATH: ${redactMcpLogText(path)}`,
+        "Install the command, add it to PATH, or configure an absolute command path in mcp.json.",
+    ].join("\n");
+}
+function definedEnv(env) {
+    const result = {};
+    for (const [key, value] of Object.entries(env ?? {})) {
+        if (value !== undefined)
+            result[key] = value;
+    }
+    return result;
+}
+function isTimedOut(error) {
+    if (error === null)
+        return false;
+    const signal = getProperty(error, "signal");
+    return signal === "SIGKILL" || error.message.includes("timed out");
+}
+function isNodeErrorCode(error, code) {
+    return error !== null && getProperty(error, "code") === code;
+}
+function getProperty(value, key) {
+    return value[key];
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/core/extensions/builtin/mcp/diagnose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/mcp/diagnose.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile } from \"node:child_process\";\nimport { getDefaultEnvironment } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { McpServerConfig } from \"./config-schema.ts\";\nimport { ConnectError } from \"./errors.ts\";\nimport type { McpLogger } from \"./log.ts\";\nimport { redactMcpLogText } from \"./log.ts\";\n\nexport const MCP_STDIO_DIAGNOSTIC_TIMEOUT_MS = 5000;\nconst MCP_STDIO_DIAGNOSTIC_MAX_BYTES = 2048;\n\nexport interface McpStdioDiagnosticOptions {\n\treadonly config: McpServerConfig;\n\treadonly env?: Record<string, string | undefined>;\n\treadonly logger: McpLogger;\n}\n\nexport interface McpConnectFailureDiagnosticOptions extends McpStdioDiagnosticOptions {\n\treadonly serverName: string;\n\treadonly cause: Error;\n}\n\ninterface ExecResult {\n\treadonly error: Error | null;\n\treadonly stdout: string;\n\treadonly stderr: string;\n}\n\nexport async function diagnoseMcpConnectFailure(options: McpConnectFailureDiagnosticOptions): Promise<ConnectError> {\n\tconst diagnostic = await maybeDiagnoseStdioFailure(options);\n\treturn connectErrorFromDiagnostic(options, diagnostic);\n}\n\nexport function diagnoseCapturedMcpConnectFailure(options: McpConnectFailureDiagnosticOptions): ConnectError | null {\n\tif (options.config.type !== \"stdio\") return null;\n\tconst diagnostic = extractCapturedStderr(options.logger);\n\tif (diagnostic.length === 0) return null;\n\treturn connectErrorFromDiagnostic(options, boundDiagnostic(diagnostic));\n}\n\nfunction connectErrorFromDiagnostic(\n\toptions: McpConnectFailureDiagnosticOptions,\n\tdiagnostic: string | null,\n): ConnectError {\n\tconst message =\n\t\tdiagnostic === null || diagnostic.length === 0\n\t\t\t? `MCP server ${options.serverName} failed during connect: ${options.cause.message}`\n\t\t\t: `MCP server ${options.serverName} failed during connect: ${options.cause.message}\\n${diagnostic}`;\n\treturn new ConnectError(message, {\n\t\tcause: options.cause,\n\t\tphase: \"connect\",\n\t\tretriable: true,\n\t\tserverName: options.serverName,\n\t});\n}\n\nexport async function maybeDiagnoseStdioFailure(options: McpStdioDiagnosticOptions): Promise<string | null> {\n\tif (options.config.type !== \"stdio\") return null;\n\tconst captured = extractCapturedStderr(options.logger);\n\tif (captured.length > 0) return boundDiagnostic(captured);\n\tconst command = options.config.command;\n\tif (command === undefined || command.trim().length === 0) return null;\n\tconst result = await execFileForDiagnostics(command, options.config.args, {\n\t\tcwd: options.config.cwd,\n\t\tenv: buildDiagnosticEnv(options),\n\t});\n\tif (isNodeErrorCode(result.error, \"ENOENT\")) return commandNotFoundDiagnostic(command, options);\n\tconst lines = meaningfulLines(`${result.stderr}\\n${result.stdout}`);\n\tif (lines.length > 0) return boundDiagnostic(lines);\n\tif (isTimedOut(result.error)) return `diagnostic rerun timed out after ${MCP_STDIO_DIAGNOSTIC_TIMEOUT_MS}ms`;\n\treturn null;\n}\n\nfunction extractCapturedStderr(logger: McpLogger): string[] {\n\tconst messages: string[] = [];\n\tfor (const line of logger.getRingBuffer()) {\n\t\tconst parsed = parseLogLine(line);\n\t\tif (parsed?.channel === \"stderr\" && typeof parsed.message === \"string\") {\n\t\t\tmessages.push(parsed.message);\n\t\t}\n\t}\n\treturn meaningfulLines(messages.join(\"\\n\"));\n}\n\nfunction parseLogLine(line: string): { channel?: unknown; message?: unknown } | null {\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(line);\n\t\tif (typeof parsed === \"object\" && parsed !== null) return parsed as { channel?: unknown; message?: unknown };\n\t} catch {\n\t\treturn null;\n\t}\n\treturn null;\n}\n\nfunction meaningfulLines(text: string): string[] {\n\treturn text\n\t\t.split(/\\r?\\n/)\n\t\t.map((line) => redactMcpLogText(line.trim()))\n\t\t.filter((line) => line.length > 0);\n}\n\nfunction boundDiagnostic(lines: readonly string[]): string {\n\tlet output = \"\";\n\tfor (const line of lines) {\n\t\tconst next = output.length === 0 ? line : `${output}\\n${line}`;\n\t\tif (Buffer.byteLength(next, \"utf8\") > MCP_STDIO_DIAGNOSTIC_MAX_BYTES) break;\n\t\toutput = next;\n\t}\n\treturn output || lines[0]?.slice(0, MCP_STDIO_DIAGNOSTIC_MAX_BYTES) || \"\";\n}\n\nfunction execFileForDiagnostics(\n\tcommand: string,\n\targs: readonly string[] | undefined,\n\toptions: { cwd?: string; env: Record<string, string> },\n): Promise<ExecResult> {\n\treturn new Promise((resolve) => {\n\t\texecFile(\n\t\t\tcommand,\n\t\t\targs ?? [],\n\t\t\t{\n\t\t\t\tcwd: options.cwd,\n\t\t\t\tenv: options.env,\n\t\t\t\tkillSignal: \"SIGKILL\",\n\t\t\t\tmaxBuffer: MCP_STDIO_DIAGNOSTIC_MAX_BYTES * 4,\n\t\t\t\ttimeout: MCP_STDIO_DIAGNOSTIC_TIMEOUT_MS,\n\t\t\t},\n\t\t\t(error, stdout, stderr) => {\n\t\t\t\tresolve({\n\t\t\t\t\terror,\n\t\t\t\t\tstdout,\n\t\t\t\t\tstderr,\n\t\t\t\t});\n\t\t\t},\n\t\t);\n\t});\n}\n\nfunction buildDiagnosticEnv(options: McpStdioDiagnosticOptions): Record<string, string> {\n\treturn {\n\t\t...getDefaultEnvironment(),\n\t\t...definedEnv(options.env),\n\t\t...(options.config.env ?? {}),\n\t};\n}\n\nfunction commandNotFoundDiagnostic(command: string, options: McpStdioDiagnosticOptions): string {\n\tconst env = buildDiagnosticEnv(options);\n\tconst cwd = options.config.cwd ?? process.cwd();\n\tconst path = env.PATH ?? \"\";\n\treturn [\n\t\t`command not found: ${redactMcpLogText(command)}`,\n\t\t`cwd: ${redactMcpLogText(cwd)}`,\n\t\t`PATH: ${redactMcpLogText(path)}`,\n\t\t\"Install the command, add it to PATH, or configure an absolute command path in mcp.json.\",\n\t].join(\"\\n\");\n}\n\nfunction definedEnv(env: Record<string, string | undefined> | undefined): Record<string, string> {\n\tconst result: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(env ?? {})) {\n\t\tif (value !== undefined) result[key] = value;\n\t}\n\treturn result;\n}\n\nfunction isTimedOut(error: Error | null): boolean {\n\tif (error === null) return false;\n\tconst signal = getProperty(error, \"signal\");\n\treturn signal === \"SIGKILL\" || error.message.includes(\"timed out\");\n}\n\nfunction isNodeErrorCode(error: Error | null, code: string): boolean {\n\treturn error !== null && getProperty(error, \"code\") === code;\n}\n\nfunction getProperty(value: object, key: string): unknown {\n\treturn (value as Record<string, unknown>)[key];\n}\n"]}

package/dist/core/extensions/builtin/mcp/elicitation.d.ts

@@ -0,0 +1,30 @@
+import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { ExtensionUIContext } from "../../types.ts";
+/** Declared empty on purpose: maximum server compatibility (form mode only). */
+export declare const MCP_CLIENT_ELICITATION_CAPABILITY: {
+    readonly elicitation: {};
+};
+export declare const MCP_ELICITATION_TIMEOUT_MS: number;
+type ElicitationUi = Pick<ExtensionUIContext, "input" | "select" | "confirm">;
+export interface ElicitationResponse {
+    action: "accept" | "decline" | "cancel";
+    content?: Record<string, string | number | boolean>;
+    [key: string]: unknown;
+}
+interface ElicitProperty {
+    type?: string;
+    title?: string;
+    description?: string;
+    enum?: unknown[];
+}
+/** The extension points this at the live session UI (undefined in print mode). */
+export declare function setMcpElicitationUiProvider(provider: (() => ElicitationUi | undefined) | undefined): void;
+/** Wire the elicitation/create handler onto a fresh client. */
+export declare function configureMcpElicitation(client: Client, timeoutMs?: number): void;
+/** Exported for tests: drive the form directly with a scripted UI. */
+export declare function runElicitationForm(ui: ElicitationUi, message: string, requestedSchema: {
+    properties?: Record<string, ElicitProperty>;
+    required?: string[];
+}, timeoutMs?: number): Promise<ElicitationResponse>;
+export {};
+//# sourceMappingURL=elicitation.d.ts.map

package/dist/core/extensions/builtin/mcp/elicitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/mcp/elicitation.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAExE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAIzD,gFAAgF;AAChF,eAAO,MAAM,iCAAiC;aAAK,WAAW;CAAe,CAAC;AAE9E,eAAO,MAAM,0BAA0B,QAAgB,CAAC;AAExD,KAAK,aAAa,GAAG,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAEpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,UAAU,cAAc;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;CACjB;AAID,kFAAkF;AAClF,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAEzG;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAmC,GAAG,IAAI,CAS5G;AAED,sEAAsE;AACtE,wBAAsB,kBAAkB,CACvC,EAAE,EAAE,aAAa,EACjB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EACrF,SAAS,GAAE,MAAmC,GAC5C,OAAO,CAAC,mBAAmB,CAAC,CAY9B"}

package/dist/core/extensions/builtin/mcp/elicitation.js

@@ -0,0 +1,85 @@
+// MCP elicitation, form mode only (todo 41).
+//
+// The client declares the capability as an EMPTY object — Spring-AI servers
+// reject richer shapes (FieldCoding lesson from the comparison corpus) — and
+// answers elicitation/create requests mid tool-call by walking the requested
+// flat-primitive schema through sequential ctx.ui primitives (input/select/
+// confirm; NEVER ctx.ui.custom, which is undefined in RPC mode). Without a UI
+// (print mode) the request is declined immediately — spec-correct, no hang.
+// The whole form is bounded by a timeout that resolves to cancel so a wedged
+// dialog can never wedge the tool-call pipeline. URL mode is deliberately not
+// implemented in v1.
+import { ElicitRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { createMcpLogger } from "./log.js";
+import { safeTimer } from "./wrap.js";
+/** Declared empty on purpose: maximum server compatibility (form mode only). */
+export const MCP_CLIENT_ELICITATION_CAPABILITY = { elicitation: {} };
+export const MCP_ELICITATION_TIMEOUT_MS = 5 * 60 * 1000;
+let currentUi;
+/** The extension points this at the live session UI (undefined in print mode). */
+export function setMcpElicitationUiProvider(provider) {
+    currentUi = provider;
+}
+/** Wire the elicitation/create handler onto a fresh client. */
+export function configureMcpElicitation(client, timeoutMs = MCP_ELICITATION_TIMEOUT_MS) {
+    client.setRequestHandler(ElicitRequestSchema, async (request) => {
+        const params = request.params;
+        // URL mode is deliberately unsupported in v1 (form mode only).
+        if (!("requestedSchema" in params))
+            return { action: "decline" };
+        const ui = currentUi?.();
+        if (ui === undefined)
+            return { action: "decline" };
+        return await runElicitationForm(ui, params.message, params.requestedSchema, timeoutMs);
+    });
+}
+/** Exported for tests: drive the form directly with a scripted UI. */
+export async function runElicitationForm(ui, message, requestedSchema, timeoutMs = MCP_ELICITATION_TIMEOUT_MS) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = safeTimer("mcp.elicitation.timeout", timeoutMs, () => resolve({ action: "cancel" }), {
+            logger: createMcpLogger("elicitation"),
+        });
+    });
+    try {
+        return await Promise.race([collectForm(ui, message, requestedSchema), timeout]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+async function collectForm(ui, message, requestedSchema) {
+    const content = {};
+    const required = new Set(requestedSchema.required ?? []);
+    for (const [name, property] of Object.entries(requestedSchema.properties ?? {})) {
+        const title = `${message} — ${property.title ?? name}`;
+        if (property.type === "boolean") {
+            content[name] = await ui.confirm(title, property.description ?? name);
+            continue;
+        }
+        if (Array.isArray(property.enum) && property.enum.length > 0) {
+            const picked = await ui.select(title, property.enum.map(String));
+            if (picked === undefined)
+                return { action: "decline" };
+            content[name] = picked;
+            continue;
+        }
+        const answer = await ui.input(title, property.description);
+        if (answer === undefined || answer.length === 0) {
+            if (required.has(name))
+                return { action: "decline" };
+            continue;
+        }
+        if (property.type === "number" || property.type === "integer") {
+            const parsed = Number(answer);
+            if (!Number.isFinite(parsed))
+                return { action: "decline" };
+            content[name] = parsed;
+            continue;
+        }
+        content[name] = answer;
+    }
+    return { action: "accept", content };
+}
+//# sourceMappingURL=elicitation.js.map

package/dist/core/extensions/builtin/mcp/elicitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/mcp/elicitation.ts"],"names":[],"mappings":"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","sourcesContent":["// MCP elicitation, form mode only (todo 41).\n//\n// The client declares the capability as an EMPTY object — Spring-AI servers\n// reject richer shapes (FieldCoding lesson from the comparison corpus) — and\n// answers elicitation/create requests mid tool-call by walking the requested\n// flat-primitive schema through sequential ctx.ui primitives (input/select/\n// confirm; NEVER ctx.ui.custom, which is undefined in RPC mode). Without a UI\n// (print mode) the request is declined immediately — spec-correct, no hang.\n// The whole form is bounded by a timeout that resolves to cancel so a wedged\n// dialog can never wedge the tool-call pipeline. URL mode is deliberately not\n// implemented in v1.\n\nimport type { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { ElicitRequestSchema } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ExtensionUIContext } from \"../../types.ts\";\nimport { createMcpLogger } from \"./log.ts\";\nimport { safeTimer } from \"./wrap.ts\";\n\n/** Declared empty on purpose: maximum server compatibility (form mode only). */\nexport const MCP_CLIENT_ELICITATION_CAPABILITY = { elicitation: {} } as const;\n\nexport const MCP_ELICITATION_TIMEOUT_MS = 5 * 60 * 1000;\n\ntype ElicitationUi = Pick<ExtensionUIContext, \"input\" | \"select\" | \"confirm\">;\n\nexport interface ElicitationResponse {\n\taction: \"accept\" | \"decline\" | \"cancel\";\n\tcontent?: Record<string, string | number | boolean>;\n\t// SDK request handlers must return an index-signature-compatible result.\n\t[key: string]: unknown;\n}\n\ninterface ElicitProperty {\n\ttype?: string;\n\ttitle?: string;\n\tdescription?: string;\n\tenum?: unknown[];\n}\n\nlet currentUi: (() => ElicitationUi | undefined) | undefined;\n\n/** The extension points this at the live session UI (undefined in print mode). */\nexport function setMcpElicitationUiProvider(provider: (() => ElicitationUi | undefined) | undefined): void {\n\tcurrentUi = provider;\n}\n\n/** Wire the elicitation/create handler onto a fresh client. */\nexport function configureMcpElicitation(client: Client, timeoutMs: number = MCP_ELICITATION_TIMEOUT_MS): void {\n\tclient.setRequestHandler(ElicitRequestSchema, async (request) => {\n\t\tconst params = request.params;\n\t\t// URL mode is deliberately unsupported in v1 (form mode only).\n\t\tif (!(\"requestedSchema\" in params)) return { action: \"decline\" };\n\t\tconst ui = currentUi?.();\n\t\tif (ui === undefined) return { action: \"decline\" };\n\t\treturn await runElicitationForm(ui, params.message, params.requestedSchema, timeoutMs);\n\t});\n}\n\n/** Exported for tests: drive the form directly with a scripted UI. */\nexport async function runElicitationForm(\n\tui: ElicitationUi,\n\tmessage: string,\n\trequestedSchema: { properties?: Record<string, ElicitProperty>; required?: string[] },\n\ttimeoutMs: number = MCP_ELICITATION_TIMEOUT_MS,\n): Promise<ElicitationResponse> {\n\tlet timer: NodeJS.Timeout | undefined;\n\tconst timeout = new Promise<ElicitationResponse>((resolve) => {\n\t\ttimer = safeTimer(\"mcp.elicitation.timeout\", timeoutMs, () => resolve({ action: \"cancel\" }), {\n\t\t\tlogger: createMcpLogger(\"elicitation\"),\n\t\t});\n\t});\n\ttry {\n\t\treturn await Promise.race([collectForm(ui, message, requestedSchema), timeout]);\n\t} finally {\n\t\tif (timer !== undefined) clearTimeout(timer);\n\t}\n}\n\nasync function collectForm(\n\tui: ElicitationUi,\n\tmessage: string,\n\trequestedSchema: { properties?: Record<string, ElicitProperty>; required?: string[] },\n): Promise<ElicitationResponse> {\n\tconst content: Record<string, string | number | boolean> = {};\n\tconst required = new Set(requestedSchema.required ?? []);\n\tfor (const [name, property] of Object.entries(requestedSchema.properties ?? {})) {\n\t\tconst title = `${message} — ${property.title ?? name}`;\n\t\tif (property.type === \"boolean\") {\n\t\t\tcontent[name] = await ui.confirm(title, property.description ?? name);\n\t\t\tcontinue;\n\t\t}\n\t\tif (Array.isArray(property.enum) && property.enum.length > 0) {\n\t\t\tconst picked = await ui.select(title, property.enum.map(String));\n\t\t\tif (picked === undefined) return { action: \"decline\" };\n\t\t\tcontent[name] = picked;\n\t\t\tcontinue;\n\t\t}\n\t\tconst answer = await ui.input(title, property.description);\n\t\tif (answer === undefined || answer.length === 0) {\n\t\t\tif (required.has(name)) return { action: \"decline\" };\n\t\t\tcontinue;\n\t\t}\n\t\tif (property.type === \"number\" || property.type === \"integer\") {\n\t\t\tconst parsed = Number(answer);\n\t\t\tif (!Number.isFinite(parsed)) return { action: \"decline\" };\n\t\t\tcontent[name] = parsed;\n\t\t\tcontinue;\n\t\t}\n\t\tcontent[name] = answer;\n\t}\n\treturn { action: \"accept\", content };\n}\n"]}

package/dist/core/extensions/builtin/mcp/errors.d.ts

@@ -0,0 +1,35 @@
+export type McpErrorKind = "connect" | "protocol" | "tool_exec" | "auth" | "timeout" | "session_expired";
+export interface McpErrorOptions {
+    readonly cause?: unknown;
+    readonly phase?: string;
+    readonly retriable?: boolean;
+    readonly serverName?: string;
+}
+export declare abstract class McpError extends Error {
+    readonly kind: McpErrorKind;
+    readonly phase?: string;
+    readonly retriable?: boolean;
+    readonly serverName?: string;
+    protected constructor(kind: McpErrorKind, name: string, message: string, options?: McpErrorOptions);
+}
+export declare class ConnectError extends McpError {
+    constructor(message: string, options?: McpErrorOptions);
+}
+export declare class ProtocolError extends McpError {
+    constructor(message: string, options?: McpErrorOptions);
+}
+export declare class ToolExecError extends McpError {
+    constructor(message: string, options?: McpErrorOptions);
+}
+export declare class AuthError extends McpError {
+    constructor(message: string, options?: McpErrorOptions);
+}
+export declare class TimeoutError extends McpError {
+    constructor(message: string, options?: McpErrorOptions);
+}
+export declare class SessionExpiredError extends McpError {
+    constructor(message: string, options?: McpErrorOptions);
+}
+export declare function isRetriableMcpError(error: unknown): boolean;
+export declare function isMcpSessionExpiredError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/extensions/builtin/mcp/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/mcp/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAEzG,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,8BAAsB,QAAS,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,SAAS,aAAa,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAerG;CACD;AAED,qBAAa,YAAa,SAAQ,QAAQ;IACzC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAEzD;CACD;AAED,qBAAa,aAAc,SAAQ,QAAQ;IAC1C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAEzD;CACD;AAED,qBAAa,aAAc,SAAQ,QAAQ;IAC1C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAEzD;CACD;AAED,qBAAa,SAAU,SAAQ,QAAQ;IACtC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAEzD;CACD;AAED,qBAAa,YAAa,SAAQ,QAAQ;IACzC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAEzD;CACD;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;IAChD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAEzD;CACD;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU3D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWhE"}

package/dist/core/extensions/builtin/mcp/errors.js

@@ -0,0 +1,154 @@
+export class McpError extends Error {
+    constructor(kind, name, message, options = {}) {
+        super(message);
+        this.name = name;
+        this.kind = kind;
+        this.phase = options.phase;
+        this.retriable = options.retriable;
+        this.serverName = options.serverName;
+        if (options.cause !== undefined) {
+            Object.defineProperty(this, "cause", {
+                configurable: true,
+                value: options.cause,
+                writable: false,
+            });
+        }
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class ConnectError extends McpError {
+    constructor(message, options = {}) {
+        super("connect", "ConnectError", message, options);
+    }
+}
+export class ProtocolError extends McpError {
+    constructor(message, options = {}) {
+        super("protocol", "ProtocolError", message, options);
+    }
+}
+export class ToolExecError extends McpError {
+    constructor(message, options = {}) {
+        super("tool_exec", "ToolExecError", message, options);
+    }
+}
+export class AuthError extends McpError {
+    constructor(message, options = {}) {
+        super("auth", "AuthError", message, options);
+    }
+}
+export class TimeoutError extends McpError {
+    constructor(message, options = {}) {
+        super("timeout", "TimeoutError", message, options);
+    }
+}
+export class SessionExpiredError extends McpError {
+    constructor(message, options = {}) {
+        super("session_expired", "SessionExpiredError", message, options);
+    }
+}
+const RETRIABLE_STATUS_CODES = new Set([404, 502, 503]);
+const RETRIABLE_NUMERIC_CODES = new Set([-32001]);
+const RETRIABLE_TEXT = ["econnrefused", "connection refused", "transport closed"];
+export function isRetriableMcpError(error) {
+    if (error instanceof McpError && error.retriable === true)
+        return true;
+    if (isMcpSessionExpiredError(error))
+        return true;
+    const seen = new Set();
+    if (hasRetriableNumericSignal(error, seen))
+        return true;
+    const text = collectText(error, new Set()).join(" ").toLowerCase();
+    if (RETRIABLE_TEXT.some((needle) => text.includes(needle)))
+        return true;
+    return /\b(?:404|502|503)\b/.test(text);
+}
+export function isMcpSessionExpiredError(error) {
+    const seen = new Set();
+    if (hasSessionExpiredNumericSignal(error, seen))
+        return true;
+    const text = collectText(error, new Set()).join(" ").toLowerCase();
+    return (/\b404\b/.test(text) ||
+        (text.includes("-32000") && text.includes("session")) ||
+        text.includes("session expired") ||
+        text.includes("session not found") ||
+        text.includes("mcp-session-id"));
+}
+function hasRetriableNumericSignal(value, seen) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (seen.has(value))
+        return false;
+    seen.add(value);
+    const code = numberFromUnknown(getProperty(value, "code"));
+    if (code !== undefined && RETRIABLE_NUMERIC_CODES.has(code))
+        return true;
+    const status = numberFromUnknown(getProperty(value, "status"));
+    if (status !== undefined && RETRIABLE_STATUS_CODES.has(status))
+        return true;
+    const statusCode = numberFromUnknown(getProperty(value, "statusCode"));
+    if (statusCode !== undefined && RETRIABLE_STATUS_CODES.has(statusCode))
+        return true;
+    return (hasRetriableNumericSignal(getProperty(value, "response"), seen) ||
+        hasRetriableNumericSignal(getProperty(value, "cause"), seen));
+}
+function hasSessionExpiredNumericSignal(value, seen) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (seen.has(value))
+        return false;
+    seen.add(value);
+    const code = numberFromUnknown(getProperty(value, "code"));
+    if (code === -32001)
+        return true;
+    if (code === -32000) {
+        const message = getProperty(value, "message");
+        if (typeof message === "string" && message.toLowerCase().includes("session"))
+            return true;
+    }
+    const status = numberFromUnknown(getProperty(value, "status"));
+    if (status === 404)
+        return true;
+    const statusCode = numberFromUnknown(getProperty(value, "statusCode"));
+    if (statusCode === 404)
+        return true;
+    return (hasSessionExpiredNumericSignal(getProperty(value, "response"), seen) ||
+        hasSessionExpiredNumericSignal(getProperty(value, "cause"), seen));
+}
+function collectText(value, seen) {
+    if (typeof value === "string")
+        return [value];
+    if (typeof value === "number")
+        return [String(value)];
+    if (typeof value !== "object" || value === null)
+        return [];
+    if (seen.has(value))
+        return [];
+    seen.add(value);
+    const parts = [];
+    if (value instanceof Error) {
+        parts.push(value.message, value.name);
+    }
+    for (const key of ["message", "code", "status", "statusCode"]) {
+        const property = getProperty(value, key);
+        if (typeof property === "string" || typeof property === "number") {
+            parts.push(String(property));
+        }
+    }
+    parts.push(...collectText(getProperty(value, "response"), seen));
+    parts.push(...collectText(getProperty(value, "cause"), seen));
+    return parts;
+}
+function numberFromUnknown(value) {
+    if (typeof value === "number")
+        return value;
+    if (typeof value !== "string" || value.trim() === "")
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function getProperty(value, key) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    return value[key];
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/extensions/builtin/mcp/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/mcp/errors.ts"],"names":[],"mappings":"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","sourcesContent":["export type McpErrorKind = \"connect\" | \"protocol\" | \"tool_exec\" | \"auth\" | \"timeout\" | \"session_expired\";\n\nexport interface McpErrorOptions {\n\treadonly cause?: unknown;\n\treadonly phase?: string;\n\treadonly retriable?: boolean;\n\treadonly serverName?: string;\n}\n\nexport abstract class McpError extends Error {\n\treadonly kind: McpErrorKind;\n\treadonly phase?: string;\n\treadonly retriable?: boolean;\n\treadonly serverName?: string;\n\n\tprotected constructor(kind: McpErrorKind, name: string, message: string, options: McpErrorOptions = {}) {\n\t\tsuper(message);\n\t\tthis.name = name;\n\t\tthis.kind = kind;\n\t\tthis.phase = options.phase;\n\t\tthis.retriable = options.retriable;\n\t\tthis.serverName = options.serverName;\n\t\tif (options.cause !== undefined) {\n\t\t\tObject.defineProperty(this, \"cause\", {\n\t\t\t\tconfigurable: true,\n\t\t\t\tvalue: options.cause,\n\t\t\t\twritable: false,\n\t\t\t});\n\t\t}\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\nexport class ConnectError extends McpError {\n\tconstructor(message: string, options: McpErrorOptions = {}) {\n\t\tsuper(\"connect\", \"ConnectError\", message, options);\n\t}\n}\n\nexport class ProtocolError extends McpError {\n\tconstructor(message: string, options: McpErrorOptions = {}) {\n\t\tsuper(\"protocol\", \"ProtocolError\", message, options);\n\t}\n}\n\nexport class ToolExecError extends McpError {\n\tconstructor(message: string, options: McpErrorOptions = {}) {\n\t\tsuper(\"tool_exec\", \"ToolExecError\", message, options);\n\t}\n}\n\nexport class AuthError extends McpError {\n\tconstructor(message: string, options: McpErrorOptions = {}) {\n\t\tsuper(\"auth\", \"AuthError\", message, options);\n\t}\n}\n\nexport class TimeoutError extends McpError {\n\tconstructor(message: string, options: McpErrorOptions = {}) {\n\t\tsuper(\"timeout\", \"TimeoutError\", message, options);\n\t}\n}\n\nexport class SessionExpiredError extends McpError {\n\tconstructor(message: string, options: McpErrorOptions = {}) {\n\t\tsuper(\"session_expired\", \"SessionExpiredError\", message, options);\n\t}\n}\n\nconst RETRIABLE_STATUS_CODES = new Set([404, 502, 503]);\nconst RETRIABLE_NUMERIC_CODES = new Set([-32001]);\nconst RETRIABLE_TEXT = [\"econnrefused\", \"connection refused\", \"transport closed\"];\n\nexport function isRetriableMcpError(error: unknown): boolean {\n\tif (error instanceof McpError && error.retriable === true) return true;\n\tif (isMcpSessionExpiredError(error)) return true;\n\n\tconst seen = new Set<unknown>();\n\tif (hasRetriableNumericSignal(error, seen)) return true;\n\n\tconst text = collectText(error, new Set()).join(\" \").toLowerCase();\n\tif (RETRIABLE_TEXT.some((needle) => text.includes(needle))) return true;\n\treturn /\\b(?:404|502|503)\\b/.test(text);\n}\n\nexport function isMcpSessionExpiredError(error: unknown): boolean {\n\tconst seen = new Set<unknown>();\n\tif (hasSessionExpiredNumericSignal(error, seen)) return true;\n\tconst text = collectText(error, new Set()).join(\" \").toLowerCase();\n\treturn (\n\t\t/\\b404\\b/.test(text) ||\n\t\t(text.includes(\"-32000\") && text.includes(\"session\")) ||\n\t\ttext.includes(\"session expired\") ||\n\t\ttext.includes(\"session not found\") ||\n\t\ttext.includes(\"mcp-session-id\")\n\t);\n}\n\nfunction hasRetriableNumericSignal(value: unknown, seen: Set<unknown>): boolean {\n\tif (typeof value !== \"object\" || value === null) return false;\n\tif (seen.has(value)) return false;\n\tseen.add(value);\n\n\tconst code = numberFromUnknown(getProperty(value, \"code\"));\n\tif (code !== undefined && RETRIABLE_NUMERIC_CODES.has(code)) return true;\n\n\tconst status = numberFromUnknown(getProperty(value, \"status\"));\n\tif (status !== undefined && RETRIABLE_STATUS_CODES.has(status)) return true;\n\n\tconst statusCode = numberFromUnknown(getProperty(value, \"statusCode\"));\n\tif (statusCode !== undefined && RETRIABLE_STATUS_CODES.has(statusCode)) return true;\n\n\treturn (\n\t\thasRetriableNumericSignal(getProperty(value, \"response\"), seen) ||\n\t\thasRetriableNumericSignal(getProperty(value, \"cause\"), seen)\n\t);\n}\n\nfunction hasSessionExpiredNumericSignal(value: unknown, seen: Set<unknown>): boolean {\n\tif (typeof value !== \"object\" || value === null) return false;\n\tif (seen.has(value)) return false;\n\tseen.add(value);\n\n\tconst code = numberFromUnknown(getProperty(value, \"code\"));\n\tif (code === -32001) return true;\n\tif (code === -32000) {\n\t\tconst message = getProperty(value, \"message\");\n\t\tif (typeof message === \"string\" && message.toLowerCase().includes(\"session\")) return true;\n\t}\n\n\tconst status = numberFromUnknown(getProperty(value, \"status\"));\n\tif (status === 404) return true;\n\n\tconst statusCode = numberFromUnknown(getProperty(value, \"statusCode\"));\n\tif (statusCode === 404) return true;\n\n\treturn (\n\t\thasSessionExpiredNumericSignal(getProperty(value, \"response\"), seen) ||\n\t\thasSessionExpiredNumericSignal(getProperty(value, \"cause\"), seen)\n\t);\n}\n\nfunction collectText(value: unknown, seen: Set<unknown>): string[] {\n\tif (typeof value === \"string\") return [value];\n\tif (typeof value === \"number\") return [String(value)];\n\tif (typeof value !== \"object\" || value === null) return [];\n\tif (seen.has(value)) return [];\n\tseen.add(value);\n\n\tconst parts: string[] = [];\n\tif (value instanceof Error) {\n\t\tparts.push(value.message, value.name);\n\t}\n\n\tfor (const key of [\"message\", \"code\", \"status\", \"statusCode\"] as const) {\n\t\tconst property = getProperty(value, key);\n\t\tif (typeof property === \"string\" || typeof property === \"number\") {\n\t\t\tparts.push(String(property));\n\t\t}\n\t}\n\n\tparts.push(...collectText(getProperty(value, \"response\"), seen));\n\tparts.push(...collectText(getProperty(value, \"cause\"), seen));\n\treturn parts;\n}\n\nfunction numberFromUnknown(value: unknown): number | undefined {\n\tif (typeof value === \"number\") return value;\n\tif (typeof value !== \"string\" || value.trim() === \"\") return undefined;\n\tconst parsed = Number(value);\n\treturn Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction getProperty(value: unknown, key: string): unknown {\n\tif (typeof value !== \"object\" || value === null) return undefined;\n\treturn (value as Record<string, unknown>)[key];\n}\n"]}