@bastani/atomic 0.9.25-alpha.3 → 0.9.25-alpha.4

package/dist/extensions/mcp/client/protocol/types.js

@@ -0,0 +1,7 @@
+export const LATEST_PROTOCOL_VERSION = "2025-11-25";
+/**
+ * Versions the client accepts from a server. Servers that do not support the requested version answer
+ * with their own latest one, so older versions stay accepted for servers built on older SDKs.
+ */
+export const SUPPORTED_PROTOCOL_VERSIONS = [LATEST_PROTOCOL_VERSION, "2025-06-18", "2025-03-26", "2024-11-05"];
+//# sourceMappingURL=types.js.map

package/dist/extensions/mcp/client/protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/extensions/mcp/client/protocol/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC;AACpD;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,uBAAuB,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAU,CAAC","sourcesContent":["import type { BlobResourceContents, ContentAnnotations, TextResourceContents } from \"./content.js\";\nimport type { JsonRpcId } from \"./jsonrpc.js\";\n\nexport const LATEST_PROTOCOL_VERSION = \"2025-11-25\";\n/**\n * Versions the client accepts from a server. Servers that do not support the requested version answer\n * with their own latest one, so older versions stay accepted for servers built on older SDKs.\n */\nexport const SUPPORTED_PROTOCOL_VERSIONS = [LATEST_PROTOCOL_VERSION, \"2025-06-18\", \"2025-03-26\", \"2024-11-05\"] as const;\nexport type SupportedProtocolVersion = (typeof SUPPORTED_PROTOCOL_VERSIONS)[number];\n\nexport interface Implementation {\n\tname: string;\n\tversion: string;\n\ttitle?: string;\n}\n\nexport interface Root {\n\turi: string;\n\tname?: string;\n}\n\nexport interface ClientCapabilities {\n\texperimental?: Record<string, unknown>;\n\troots?: { listChanged?: boolean };\n\tsampling?: Record<string, unknown>;\n\telicitation?: Record<string, unknown>;\n}\n\nexport interface ServerCapabilities {\n\texperimental?: Record<string, unknown>;\n\tlogging?: Record<string, unknown>;\n\tprompts?: { listChanged?: boolean };\n\tresources?: { subscribe?: boolean; listChanged?: boolean };\n\ttools?: { listChanged?: boolean };\n\tcompletions?: Record<string, unknown>;\n}\n\nexport interface InitializeParams {\n\tprotocolVersion: string;\n\tcapabilities: ClientCapabilities;\n\tclientInfo: Implementation;\n}\n\nexport interface InitializeResult {\n\tprotocolVersion: string;\n\tcapabilities: ServerCapabilities;\n\tserverInfo: Implementation;\n\tinstructions?: string;\n}\n\nexport interface ProgressNotification {\n\tprogressToken: string | number;\n\tprogress: number;\n\ttotal?: number;\n\tmessage?: string;\n}\n\nexport interface CancelledNotification {\n\trequestId: JsonRpcId;\n\treason?: string;\n}\n\nexport interface ToolAnnotations {\n\ttitle?: string;\n\treadOnlyHint?: boolean;\n\tdestructiveHint?: boolean;\n\tidempotentHint?: boolean;\n\topenWorldHint?: boolean;\n}\n\nexport interface ToolExecution {\n\ttaskSupport?: \"forbidden\" | \"optional\" | \"required\";\n}\n\nexport interface Tool {\n\tname: string;\n\ttitle?: string;\n\tdescription?: string;\n\tinputSchema: Record<string, unknown>;\n\toutputSchema?: Record<string, unknown>;\n\tannotations?: ToolAnnotations;\n\texecution?: ToolExecution;\n\t_meta?: Record<string, unknown>;\n}\n\nexport interface ListToolsResult {\n\ttools: Tool[];\n\tnextCursor?: string;\n\t_meta?: Record<string, unknown>;\n}\n\n/** A resource a server lists in `resources/list`. */\nexport interface Resource {\n\turi: string;\n\tname: string;\n\ttitle?: string;\n\tdescription?: string;\n\tmimeType?: string;\n\tsize?: number;\n\tannotations?: ContentAnnotations;\n\t_meta?: Record<string, unknown>;\n}\n\n/** A family of resources, addressed by an RFC 6570 URI template, from `resources/templates/list`. */\nexport interface ResourceTemplate {\n\turiTemplate: string;\n\tname: string;\n\ttitle?: string;\n\tdescription?: string;\n\tmimeType?: string;\n\tannotations?: ContentAnnotations;\n\t_meta?: Record<string, unknown>;\n}\n\nexport interface ListResourcesResult {\n\tresources: Resource[];\n\tnextCursor?: string;\n\t_meta?: Record<string, unknown>;\n}\n\nexport interface ListResourceTemplatesResult {\n\tresourceTemplates: ResourceTemplate[];\n\tnextCursor?: string;\n\t_meta?: Record<string, unknown>;\n}\n\nexport interface ReadResourceResult {\n\tcontents: (TextResourceContents | BlobResourceContents)[];\n\t_meta?: Record<string, unknown>;\n}\n"]}

package/dist/extensions/mcp/client/testing/index.d.ts

@@ -0,0 +1,2 @@
+export { createInMemoryTransportPair, InMemoryTransport } from "../transports/in-memory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/mcp/client/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/mcp/client/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/extensions/mcp/client/testing/index.js

@@ -0,0 +1,2 @@
+export { createInMemoryTransportPair, InMemoryTransport } from "../transports/in-memory.js";
+//# sourceMappingURL=index.js.map

package/dist/extensions/mcp/client/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/extensions/mcp/client/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC","sourcesContent":["export { createInMemoryTransportPair, InMemoryTransport } from \"../transports/in-memory.js\";\n"]}

package/dist/extensions/mcp/client/transports/in-memory.d.ts

@@ -0,0 +1,19 @@
+import { type JsonRpcMessage } from "../protocol/jsonrpc.js";
+import { type McpTransport, TransportEvents } from "./transport.js";
+export declare class InMemoryTransport extends TransportEvents implements McpTransport {
+    private peer;
+    private started;
+    private closed;
+    connectPeer(peer: InMemoryTransport): void;
+    start(): Promise<void>;
+    send(message: JsonRpcMessage): Promise<void>;
+    close(): Promise<void>;
+    /** Exposed so tests can simulate transport-level failures. */
+    emitError(error: unknown): void;
+    private deliver;
+}
+export declare function createInMemoryTransportPair(): {
+    client: InMemoryTransport;
+    server: InMemoryTransport;
+};
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/extensions/mcp/client/transports/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/mcp/client/transports/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAA4B,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,KAAK,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE,qBAAa,iBAAkB,SAAQ,eAAgB,YAAW,YAAY;IAC7E,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAGzC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAEK,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAK3B;IAED,8DAA8D;IACrD,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEvC;IAED,OAAO,CAAC,OAAO;CAIf;AAED,wBAAgB,2BAA2B,IAAI;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAMtG"}

package/dist/extensions/mcp/client/transports/in-memory.js

@@ -0,0 +1,50 @@
+import { McpConnectionClosedError } from "../protocol/jsonrpc.js";
+import { TransportEvents } from "./transport.js";
+export class InMemoryTransport extends TransportEvents {
+    peer;
+    started = false;
+    closed = false;
+    connectPeer(peer) {
+        if (this.peer)
+            throw new Error("In-memory MCP transport already has a peer");
+        this.peer = peer;
+    }
+    async start() {
+        if (this.closed)
+            throw new McpConnectionClosedError();
+        this.started = true;
+    }
+    async send(message) {
+        if (!this.started || this.closed)
+            throw new McpConnectionClosedError();
+        const peer = this.peer;
+        if (!peer?.started || peer.closed)
+            throw new McpConnectionClosedError("In-memory MCP peer is not connected");
+        const copy = structuredClone(message);
+        queueMicrotask(() => peer.deliver(copy));
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.emitClose();
+        await this.peer?.close();
+    }
+    /** Exposed so tests can simulate transport-level failures. */
+    emitError(error) {
+        super.emitError(error);
+    }
+    deliver(message) {
+        if (this.closed)
+            return;
+        this.emitMessage(message);
+    }
+}
+export function createInMemoryTransportPair() {
+    const client = new InMemoryTransport();
+    const server = new InMemoryTransport();
+    client.connectPeer(server);
+    server.connectPeer(client);
+    return { client, server };
+}
+//# sourceMappingURL=in-memory.js.map

package/dist/extensions/mcp/client/transports/in-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../../../../src/extensions/mcp/client/transports/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAqB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IAC7C,IAAI,CAAgC;IACpC,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAG,KAAK,CAAC;IAEvB,WAAW,CAAC,IAAuB;QAClC,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC7E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,KAAK;QACV,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAuB;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,wBAAwB,CAAC,qCAAqC,CAAC,CAAC;QAC7G,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACtC,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,KAAK;QACV,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,8DAA8D;IACrD,SAAS,CAAC,KAAc;QAChC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAEO,OAAO,CAAC,OAAuB;QACtC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;CACD;AAED,MAAM,UAAU,2BAA2B;IAC1C,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACvC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC","sourcesContent":["import { type JsonRpcMessage, McpConnectionClosedError } from \"../protocol/jsonrpc.js\";\nimport { type McpTransport, TransportEvents } from \"./transport.js\";\n\nexport class InMemoryTransport extends TransportEvents implements McpTransport {\n\tprivate peer: InMemoryTransport | undefined;\n\tprivate started = false;\n\tprivate closed = false;\n\n\tconnectPeer(peer: InMemoryTransport): void {\n\t\tif (this.peer) throw new Error(\"In-memory MCP transport already has a peer\");\n\t\tthis.peer = peer;\n\t}\n\n\tasync start(): Promise<void> {\n\t\tif (this.closed) throw new McpConnectionClosedError();\n\t\tthis.started = true;\n\t}\n\n\tasync send(message: JsonRpcMessage): Promise<void> {\n\t\tif (!this.started || this.closed) throw new McpConnectionClosedError();\n\t\tconst peer = this.peer;\n\t\tif (!peer?.started || peer.closed) throw new McpConnectionClosedError(\"In-memory MCP peer is not connected\");\n\t\tconst copy = structuredClone(message);\n\t\tqueueMicrotask(() => peer.deliver(copy));\n\t}\n\n\tasync close(): Promise<void> {\n\t\tif (this.closed) return;\n\t\tthis.closed = true;\n\t\tthis.emitClose();\n\t\tawait this.peer?.close();\n\t}\n\n\t/** Exposed so tests can simulate transport-level failures. */\n\toverride emitError(error: unknown): void {\n\t\tsuper.emitError(error);\n\t}\n\n\tprivate deliver(message: JsonRpcMessage): void {\n\t\tif (this.closed) return;\n\t\tthis.emitMessage(message);\n\t}\n}\n\nexport function createInMemoryTransportPair(): { client: InMemoryTransport; server: InMemoryTransport } {\n\tconst client = new InMemoryTransport();\n\tconst server = new InMemoryTransport();\n\tclient.connectPeer(server);\n\tserver.connectPeer(client);\n\treturn { client, server };\n}\n"]}

package/dist/extensions/mcp/client/transports/stdio.d.ts

@@ -0,0 +1,32 @@
+import { type JsonRpcMessage } from "../protocol/jsonrpc.js";
+import { type McpTransport, TransportEvents } from "./transport.js";
+export interface StdioTransportOptions {
+    command: string;
+    args?: readonly string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    inheritEnv?: boolean;
+    stderr?: "pipe" | "inherit";
+    onStderr?: (chunk: string) => void;
+    maxMessageBytes?: number;
+    maxStderrBytes?: number;
+    /** Time to wait for the server to exit after SIGTERM before sending SIGKILL. Default: 2000. */
+    closeTimeoutMs?: number;
+}
+export declare class StdioTransport extends TransportEvents implements McpTransport {
+    readonly options: Readonly<StdioTransportOptions>;
+    private child;
+    private stdoutBuffer;
+    private stderrBuffer;
+    private started;
+    private closed;
+    constructor(options: StdioTransportOptions);
+    get pid(): number | undefined;
+    get stderr(): string;
+    start(): Promise<void>;
+    send(message: JsonRpcMessage): Promise<void>;
+    close(): Promise<void>;
+    private handleStdout;
+    private handleStderr;
+}
+//# sourceMappingURL=stdio.d.ts.map

package/dist/extensions/mcp/client/transports/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/mcp/client/transports/stdio.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAiD,MAAM,wBAAwB,CAAC;AAC5G,OAAO,EAA6B,KAAK,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAkD/F,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,cAAe,SAAQ,eAAgB,YAAW,YAAY;IAC1E,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAClD,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,OAAO,EAAE,qBAAqB,EAGzC;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAmD3B;IAEK,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOjD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA2B3B;IAED,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,YAAY;CAOpB"}

package/dist/extensions/mcp/client/transports/stdio.js

@@ -0,0 +1,201 @@
+import { spawn } from "node:child_process";
+import process from "node:process";
+import crossSpawn from "cross-spawn";
+import { McpConnectionClosedError, parseJsonRpcMessage } from "../protocol/jsonrpc.js";
+import { DEFAULT_MAX_MESSAGE_BYTES, TransportEvents } from "./transport.js";
+const DEFAULT_MAX_STDERR_BYTES = 64 * 1024;
+const DEFAULT_CLOSE_TIMEOUT_MS = 2_000;
+/** How long a server gets to exit on its own after stdin closes, before it is sent SIGTERM. */
+const STDIN_CLOSE_GRACE_MS = 500;
+const USE_PROCESS_GROUPS = process.platform !== "win32";
+/** Process groups of running servers, killed if the host exits without closing them. */
+const liveProcessGroups = new Set();
+let exitHookInstalled = false;
+function killProcessTree(child, signal) {
+    const pid = child.pid;
+    if (process.platform === "win32" && pid !== undefined) {
+        if (child.exitCode !== null)
+            return;
+        // Windows has no graceful signals, and cross-spawn runs `.cmd` shims through cmd.exe; killing only
+        // that would leave the server running.
+        spawn("taskkill", ["/pid", String(pid), "/T", "/F"], { stdio: "ignore", windowsHide: true }).on("error", () => { });
+        return;
+    }
+    if (USE_PROCESS_GROUPS && pid !== undefined) {
+        try {
+            // Negative pid: the whole group, so wrappers like `npx` or `uvx` do not leave the server behind.
+            process.kill(-pid, signal);
+            return;
+        }
+        catch {
+            // The group is gone or was never created; fall back to the direct child.
+        }
+    }
+    try {
+        child.kill(signal);
+    }
+    catch { }
+}
+function installExitHook() {
+    if (exitHookInstalled)
+        return;
+    exitHookInstalled = true;
+    process.once("exit", () => {
+        for (const pid of liveProcessGroups) {
+            try {
+                process.kill(-pid, "SIGTERM");
+            }
+            catch { }
+        }
+    });
+}
+export class StdioTransport extends TransportEvents {
+    options;
+    child;
+    stdoutBuffer = Buffer.alloc(0);
+    stderrBuffer = Buffer.alloc(0);
+    started = false;
+    closed = false;
+    constructor(options) {
+        super();
+        this.options = Object.freeze({ ...options, args: options.args ? [...options.args] : undefined });
+    }
+    get pid() {
+        return this.child?.pid;
+    }
+    get stderr() {
+        return this.stderrBuffer.toString("utf8");
+    }
+    async start() {
+        if (this.started)
+            throw new Error("MCP stdio transport already started");
+        if (this.closed)
+            throw new McpConnectionClosedError();
+        this.started = true;
+        const env = this.options.inheritEnv === false ? { ...this.options.env } : { ...process.env, ...this.options.env };
+        const child = crossSpawn(this.options.command, this.options.args ?? [], {
+            cwd: this.options.cwd,
+            env,
+            stdio: ["pipe", "pipe", this.options.stderr === "inherit" ? "inherit" : "pipe"],
+            windowsHide: true,
+            // Own process group, so closing the transport can terminate the server's children too.
+            detached: USE_PROCESS_GROUPS,
+        });
+        this.child = child;
+        const pid = child.pid;
+        if (USE_PROCESS_GROUPS && pid !== undefined) {
+            installExitHook();
+            liveProcessGroups.add(pid);
+            child.once("exit", () => liveProcessGroups.delete(pid));
+        }
+        child.stdout?.on("data", (chunk) => this.handleStdout(chunk));
+        child.stdout?.on("error", (error) => this.emitError(error));
+        child.stdin?.on("error", (error) => {
+            if (!this.closed)
+                this.emitError(error);
+        });
+        child.stderr?.on("data", (chunk) => this.handleStderr(chunk));
+        child.stderr?.on("error", (error) => this.emitError(error));
+        child.on("close", () => {
+            this.child = undefined;
+            if (this.stdoutBuffer.toString("utf8").trim()) {
+                this.emitError(new Error("MCP stdio server closed with an incomplete JSON-RPC message"));
+            }
+            this.stdoutBuffer = Buffer.alloc(0);
+            this.emitClose();
+        });
+        await new Promise((resolve, reject) => {
+            const onSpawn = () => {
+                child.off("error", onError);
+                resolve();
+            };
+            const onError = (error) => {
+                child.off("spawn", onSpawn);
+                reject(error);
+            };
+            child.once("spawn", onSpawn);
+            child.once("error", onError);
+        });
+        child.on("error", (error) => {
+            if (!this.closed)
+                this.emitError(error);
+        });
+    }
+    async send(message) {
+        const stdin = this.child?.stdin;
+        if (!this.started || this.closed || !stdin?.writable)
+            throw new McpConnectionClosedError();
+        const payload = `${JSON.stringify(message)}\n`;
+        await new Promise((resolve, reject) => {
+            stdin.write(payload, (error) => (error ? reject(error) : resolve()));
+        });
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const child = this.child;
+        if (!child) {
+            this.emitClose();
+            return;
+        }
+        if (child.exitCode !== null || child.signalCode !== null) {
+            child.stdin?.end();
+            return;
+        }
+        // Shutdown per the spec: close stdin and let the server exit, then SIGTERM, then SIGKILL.
+        const closeTimeoutMs = this.options.closeTimeoutMs ?? DEFAULT_CLOSE_TIMEOUT_MS;
+        await new Promise((resolve) => {
+            const timers = [];
+            child.once("close", () => {
+                for (const timer of timers)
+                    clearTimeout(timer);
+                // Children of the server that ignored stdin closing would otherwise outlive it.
+                killProcessTree(child, "SIGTERM");
+                resolve();
+            });
+            const grace = Math.min(STDIN_CLOSE_GRACE_MS, closeTimeoutMs);
+            timers.push(setTimeout(() => killProcessTree(child, "SIGTERM"), grace));
+            timers.push(setTimeout(() => killProcessTree(child, "SIGKILL"), grace + closeTimeoutMs));
+            child.stdin?.end();
+        });
+    }
+    handleStdout(chunk) {
+        this.stdoutBuffer = Buffer.concat([this.stdoutBuffer, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)]);
+        const maxMessageBytes = this.options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;
+        while (true) {
+            const newline = this.stdoutBuffer.indexOf(0x0a);
+            if (newline < 0) {
+                if (this.stdoutBuffer.length > maxMessageBytes) {
+                    this.stdoutBuffer = Buffer.alloc(0);
+                    this.emitError(new Error(`MCP stdio message exceeds ${maxMessageBytes} bytes`));
+                }
+                return;
+            }
+            const line = this.stdoutBuffer.subarray(0, newline);
+            this.stdoutBuffer = this.stdoutBuffer.subarray(newline + 1);
+            if (line.length > maxMessageBytes) {
+                this.emitError(new Error(`MCP stdio message exceeds ${maxMessageBytes} bytes`));
+                continue;
+            }
+            const text = line.toString("utf8").replace(/\r$/, "");
+            if (!text.trim())
+                continue;
+            try {
+                this.emitMessage(parseJsonRpcMessage(JSON.parse(text)));
+            }
+            catch (error) {
+                this.emitError(error);
+            }
+        }
+    }
+    handleStderr(chunk) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        const maxStderrBytes = this.options.maxStderrBytes ?? DEFAULT_MAX_STDERR_BYTES;
+        this.stderrBuffer = Buffer.concat([this.stderrBuffer, buffer]);
+        if (this.stderrBuffer.length > maxStderrBytes)
+            this.stderrBuffer = this.stderrBuffer.subarray(-maxStderrBytes);
+        this.options.onStderr?.(buffer.toString("utf8"));
+    }
+}
+//# sourceMappingURL=stdio.js.map

package/dist/extensions/mcp/client/transports/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../../../../src/extensions/mcp/client/transports/stdio.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ChildProcess, spawn } from \"node:child_process\";\nimport process from \"node:process\";\nimport crossSpawn from \"cross-spawn\";\nimport { type JsonRpcMessage, McpConnectionClosedError, parseJsonRpcMessage } from \"../protocol/jsonrpc.js\";\nimport { DEFAULT_MAX_MESSAGE_BYTES, type McpTransport, TransportEvents } from \"./transport.js\";\n\nconst DEFAULT_MAX_STDERR_BYTES = 64 * 1024;\nconst DEFAULT_CLOSE_TIMEOUT_MS = 2_000;\n/** How long a server gets to exit on its own after stdin closes, before it is sent SIGTERM. */\nconst STDIN_CLOSE_GRACE_MS = 500;\nconst USE_PROCESS_GROUPS = process.platform !== \"win32\";\n\n/** Process groups of running servers, killed if the host exits without closing them. */\nconst liveProcessGroups = new Set<number>();\nlet exitHookInstalled = false;\n\nfunction killProcessTree(child: ChildProcess, signal: NodeJS.Signals): void {\n\tconst pid = child.pid;\n\tif (process.platform === \"win32\" && pid !== undefined) {\n\t\tif (child.exitCode !== null) return;\n\t\t// Windows has no graceful signals, and cross-spawn runs `.cmd` shims through cmd.exe; killing only\n\t\t// that would leave the server running.\n\t\tspawn(\"taskkill\", [\"/pid\", String(pid), \"/T\", \"/F\"], { stdio: \"ignore\", windowsHide: true }).on(\n\t\t\t\"error\",\n\t\t\t() => {},\n\t\t);\n\t\treturn;\n\t}\n\tif (USE_PROCESS_GROUPS && pid !== undefined) {\n\t\ttry {\n\t\t\t// Negative pid: the whole group, so wrappers like `npx` or `uvx` do not leave the server behind.\n\t\t\tprocess.kill(-pid, signal);\n\t\t\treturn;\n\t\t} catch {\n\t\t\t// The group is gone or was never created; fall back to the direct child.\n\t\t}\n\t}\n\ttry {\n\t\tchild.kill(signal);\n\t} catch {}\n}\n\nfunction installExitHook(): void {\n\tif (exitHookInstalled) return;\n\texitHookInstalled = true;\n\tprocess.once(\"exit\", () => {\n\t\tfor (const pid of liveProcessGroups) {\n\t\t\ttry {\n\t\t\t\tprocess.kill(-pid, \"SIGTERM\");\n\t\t\t} catch {}\n\t\t}\n\t});\n}\n\nexport interface StdioTransportOptions {\n\tcommand: string;\n\targs?: readonly string[];\n\tcwd?: string;\n\tenv?: Record<string, string>;\n\tinheritEnv?: boolean;\n\tstderr?: \"pipe\" | \"inherit\";\n\tonStderr?: (chunk: string) => void;\n\tmaxMessageBytes?: number;\n\tmaxStderrBytes?: number;\n\t/** Time to wait for the server to exit after SIGTERM before sending SIGKILL. Default: 2000. */\n\tcloseTimeoutMs?: number;\n}\n\nexport class StdioTransport extends TransportEvents implements McpTransport {\n\treadonly options: Readonly<StdioTransportOptions>;\n\tprivate child: ChildProcess | undefined;\n\tprivate stdoutBuffer = Buffer.alloc(0);\n\tprivate stderrBuffer = Buffer.alloc(0);\n\tprivate started = false;\n\tprivate closed = false;\n\n\tconstructor(options: StdioTransportOptions) {\n\t\tsuper();\n\t\tthis.options = Object.freeze({ ...options, args: options.args ? [...options.args] : undefined });\n\t}\n\n\tget pid(): number | undefined {\n\t\treturn this.child?.pid;\n\t}\n\n\tget stderr(): string {\n\t\treturn this.stderrBuffer.toString(\"utf8\");\n\t}\n\n\tasync start(): Promise<void> {\n\t\tif (this.started) throw new Error(\"MCP stdio transport already started\");\n\t\tif (this.closed) throw new McpConnectionClosedError();\n\t\tthis.started = true;\n\t\tconst env = this.options.inheritEnv === false ? { ...this.options.env } : { ...process.env, ...this.options.env };\n\t\tconst child = crossSpawn(this.options.command, this.options.args ?? [], {\n\t\t\tcwd: this.options.cwd,\n\t\t\tenv,\n\t\t\tstdio: [\"pipe\", \"pipe\", this.options.stderr === \"inherit\" ? \"inherit\" : \"pipe\"],\n\t\t\twindowsHide: true,\n\t\t\t// Own process group, so closing the transport can terminate the server's children too.\n\t\t\tdetached: USE_PROCESS_GROUPS,\n\t\t});\n\t\tthis.child = child;\n\t\tconst pid = child.pid;\n\t\tif (USE_PROCESS_GROUPS && pid !== undefined) {\n\t\t\tinstallExitHook();\n\t\t\tliveProcessGroups.add(pid);\n\t\t\tchild.once(\"exit\", () => liveProcessGroups.delete(pid));\n\t\t}\n\t\tchild.stdout?.on(\"data\", (chunk: Buffer | string) => this.handleStdout(chunk));\n\t\tchild.stdout?.on(\"error\", (error) => this.emitError(error));\n\t\tchild.stdin?.on(\"error\", (error) => {\n\t\t\tif (!this.closed) this.emitError(error);\n\t\t});\n\t\tchild.stderr?.on(\"data\", (chunk: Buffer | string) => this.handleStderr(chunk));\n\t\tchild.stderr?.on(\"error\", (error) => this.emitError(error));\n\t\tchild.on(\"close\", () => {\n\t\t\tthis.child = undefined;\n\t\t\tif (this.stdoutBuffer.toString(\"utf8\").trim()) {\n\t\t\t\tthis.emitError(new Error(\"MCP stdio server closed with an incomplete JSON-RPC message\"));\n\t\t\t}\n\t\t\tthis.stdoutBuffer = Buffer.alloc(0);\n\t\t\tthis.emitClose();\n\t\t});\n\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tconst onSpawn = () => {\n\t\t\t\tchild.off(\"error\", onError);\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\tconst onError = (error: Error) => {\n\t\t\t\tchild.off(\"spawn\", onSpawn);\n\t\t\t\treject(error);\n\t\t\t};\n\t\t\tchild.once(\"spawn\", onSpawn);\n\t\t\tchild.once(\"error\", onError);\n\t\t});\n\t\tchild.on(\"error\", (error) => {\n\t\t\tif (!this.closed) this.emitError(error);\n\t\t});\n\t}\n\n\tasync send(message: JsonRpcMessage): Promise<void> {\n\t\tconst stdin = this.child?.stdin;\n\t\tif (!this.started || this.closed || !stdin?.writable) throw new McpConnectionClosedError();\n\t\tconst payload = `${JSON.stringify(message)}\\n`;\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tstdin.write(payload, (error) => (error ? reject(error) : resolve()));\n\t\t});\n\t}\n\n\tasync close(): Promise<void> {\n\t\tif (this.closed) return;\n\t\tthis.closed = true;\n\t\tconst child = this.child;\n\t\tif (!child) {\n\t\t\tthis.emitClose();\n\t\t\treturn;\n\t\t}\n\t\tif (child.exitCode !== null || child.signalCode !== null) {\n\t\t\tchild.stdin?.end();\n\t\t\treturn;\n\t\t}\n\t\t// Shutdown per the spec: close stdin and let the server exit, then SIGTERM, then SIGKILL.\n\t\tconst closeTimeoutMs = this.options.closeTimeoutMs ?? DEFAULT_CLOSE_TIMEOUT_MS;\n\t\tawait new Promise<void>((resolve) => {\n\t\t\tconst timers: ReturnType<typeof setTimeout>[] = [];\n\t\t\tchild.once(\"close\", () => {\n\t\t\t\tfor (const timer of timers) clearTimeout(timer);\n\t\t\t\t// Children of the server that ignored stdin closing would otherwise outlive it.\n\t\t\t\tkillProcessTree(child, \"SIGTERM\");\n\t\t\t\tresolve();\n\t\t\t});\n\t\t\tconst grace = Math.min(STDIN_CLOSE_GRACE_MS, closeTimeoutMs);\n\t\t\ttimers.push(setTimeout(() => killProcessTree(child, \"SIGTERM\"), grace));\n\t\t\ttimers.push(setTimeout(() => killProcessTree(child, \"SIGKILL\"), grace + closeTimeoutMs));\n\t\t\tchild.stdin?.end();\n\t\t});\n\t}\n\n\tprivate handleStdout(chunk: Buffer | string): void {\n\t\tthis.stdoutBuffer = Buffer.concat([this.stdoutBuffer, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)]);\n\t\tconst maxMessageBytes = this.options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;\n\t\twhile (true) {\n\t\t\tconst newline = this.stdoutBuffer.indexOf(0x0a);\n\t\t\tif (newline < 0) {\n\t\t\t\tif (this.stdoutBuffer.length > maxMessageBytes) {\n\t\t\t\t\tthis.stdoutBuffer = Buffer.alloc(0);\n\t\t\t\t\tthis.emitError(new Error(`MCP stdio message exceeds ${maxMessageBytes} bytes`));\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst line = this.stdoutBuffer.subarray(0, newline);\n\t\t\tthis.stdoutBuffer = this.stdoutBuffer.subarray(newline + 1);\n\t\t\tif (line.length > maxMessageBytes) {\n\t\t\t\tthis.emitError(new Error(`MCP stdio message exceeds ${maxMessageBytes} bytes`));\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst text = line.toString(\"utf8\").replace(/\\r$/, \"\");\n\t\t\tif (!text.trim()) continue;\n\t\t\ttry {\n\t\t\t\tthis.emitMessage(parseJsonRpcMessage(JSON.parse(text)));\n\t\t\t} catch (error) {\n\t\t\t\tthis.emitError(error);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate handleStderr(chunk: Buffer | string): void {\n\t\tconst buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n\t\tconst maxStderrBytes = this.options.maxStderrBytes ?? DEFAULT_MAX_STDERR_BYTES;\n\t\tthis.stderrBuffer = Buffer.concat([this.stderrBuffer, buffer]);\n\t\tif (this.stderrBuffer.length > maxStderrBytes) this.stderrBuffer = this.stderrBuffer.subarray(-maxStderrBytes);\n\t\tthis.options.onStderr?.(buffer.toString(\"utf8\"));\n\t}\n}\n"]}

package/dist/extensions/mcp/client/transports/streamable-http.d.ts

@@ -0,0 +1,96 @@
+import type { AuthProvider, McpFetch } from "../auth-provider.js";
+import { type JsonRpcMessage } from "../protocol/jsonrpc.js";
+import { type McpTransport, TransportEvents } from "./transport.js";
+export interface SseEvent {
+    event?: string;
+    data: string;
+    id?: string;
+}
+export interface ConsumeSseOptions {
+    maxEventBytes?: number;
+    onEvent(event: SseEvent): void;
+    /** Called for every `id` field, including events without data (for example resumption priming events). */
+    onId?(id: string): void;
+    /** Called for every valid `retry` field, in milliseconds. */
+    onRetry?(delayMs: number): void;
+}
+export declare function consumeSseStream(stream: ReadableStream<Uint8Array>, options: ConsumeSseOptions): Promise<void>;
+export interface StreamableHttpReconnectOptions {
+    /** Delay before the first reconnection attempt, unless the server sent a `retry` field. Default: 1000. */
+    initialDelayMs?: number;
+    /** Upper bound for the exponential backoff. Default: 30000. */
+    maxDelayMs?: number;
+    /** Consecutive failed attempts before giving up on a stream. Default: 5. */
+    maxRetries?: number;
+}
+export interface StreamableHttpTransportOptions {
+    url: string | URL;
+    headers?: Record<string, string>;
+    fetch?: McpFetch;
+    /** Open the server-to-client GET stream after initialization. Default: true. */
+    openGetStream?: boolean;
+    maxMessageBytes?: number;
+    authProvider?: AuthProvider;
+    /** Reconnection of dropped SSE streams (the GET stream, and response streams that carry event IDs). */
+    reconnect?: StreamableHttpReconnectOptions;
+}
+export declare class McpHttpError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, message: string, body?: string);
+}
+export declare class McpAuthRequiredError extends McpHttpError {
+    readonly wwwAuthenticate: string | null;
+    constructor(response: Response, body?: string);
+}
+export declare class McpSessionExpiredError extends McpHttpError {
+    constructor(body?: string);
+}
+export declare class StreamableHttpTransport extends TransportEvents implements McpTransport {
+    readonly url: URL;
+    readonly options: Readonly<StreamableHttpTransportOptions>;
+    private fetch;
+    private controller;
+    private started;
+    private closed;
+    private sessionIdValue;
+    private protocolVersion;
+    private getStreamStarted;
+    constructor(options: StreamableHttpTransportOptions);
+    get sessionId(): string | undefined;
+    start(): Promise<void>;
+    setProtocolVersion(version: string): void;
+    send(message: JsonRpcMessage): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Fetch with auth headers. A 401 (or a 403 asking for more scope) is handed to the auth provider
+     * once, and the request is retried with whatever credentials it left behind.
+     */
+    private authorizedFetch;
+    private headers;
+    private captureSession;
+    private checkResponse;
+    private consumeSse;
+    /**
+     * Read the SSE stream answering one request. When the stream ends or breaks before the response
+     * arrives and the server assigned event IDs, resume it with GET and `Last-Event-ID`, as the
+     * server may close response streams at will. Otherwise only this request fails.
+     */
+    private consumeResponseStream;
+    private startGetStream;
+    /** Keep the server-to-client stream open, reconnecting with backoff when it drops. */
+    private runGetStream;
+    /** Open a GET SSE stream. Resolves to undefined when the server answers 405 (no GET stream). */
+    private openSseStream;
+    /**
+     * Network failures and transient statuses are retried; auth, session, and protocol errors are not.
+     * `fetch` reports network failures, including a connection dropped mid-body, as `TypeError`.
+     */
+    private isRetryable;
+    private reconnectDelay;
+    private maxDelay;
+    private maxRetries;
+    /** Resolves false when the transport closed while waiting. */
+    private sleep;
+}
+//# sourceMappingURL=streamable-http.d.ts.map

package/dist/extensions/mcp/client/transports/streamable-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/mcp/client/transports/streamable-http.ts"],"names":[],"mappings":"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"}