@fractaal/pi-mcp 0.86.9 → 1.6.0

package/dist/transports/lines.js

@@ -0,0 +1,85 @@
+import { parseJsonRpcMessage } from "../protocol/jsonrpc.js";
+import { DEFAULT_MAX_MESSAGE_BYTES } from "./transport.js";
+const DEFAULT_MAX_STDERR_BYTES = 64 * 1024;
+/**
+ * Reads a program's output as MCP's stdio framing: newline-delimited JSON-RPC messages on stdout, and a bounded
+ * tail of stderr for diagnostics.
+ */
+export class JsonRpcLineReader {
+    options;
+    /** The bytes of the incomplete message received so far. */
+    stdoutChunks = [];
+    stdoutPendingBytes = 0;
+    stderrBuffer = Buffer.alloc(0);
+    constructor(options) {
+        this.options = options;
+    }
+    /** The last `maxStderrBytes` of stderr. */
+    get stderr() {
+        return this.stderrBuffer.toString("utf8");
+    }
+    /**
+     * Takes the next stdout bytes and reports every complete message, or the error parsing it. Bytes of an
+     * incomplete message are kept as chunks and joined once when its newline arrives, so a large message that
+     * arrives in many chunks is copied and scanned only once.
+     */
+    readStdout(chunk) {
+        const data = Buffer.from(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+        const maxMessageBytes = this.options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;
+        let start = 0;
+        while (true) {
+            const newline = data.indexOf(0x0a, start);
+            if (newline < 0) {
+                if (start < data.length) {
+                    // Copied, since the caller may reuse the chunk's memory.
+                    this.stdoutChunks.push(Buffer.from(data.subarray(start)));
+                    this.stdoutPendingBytes += data.length - start;
+                }
+                if (this.stdoutPendingBytes > maxMessageBytes) {
+                    this.stdoutChunks = [];
+                    this.stdoutPendingBytes = 0;
+                    this.options.onError(new Error(`MCP stdio message exceeds ${maxMessageBytes} bytes`));
+                }
+                return;
+            }
+            let line = data.subarray(start, newline);
+            if (this.stdoutChunks.length > 0) {
+                this.stdoutChunks.push(line);
+                line = Buffer.concat(this.stdoutChunks, this.stdoutPendingBytes + line.length);
+                this.stdoutChunks = [];
+                this.stdoutPendingBytes = 0;
+            }
+            start = newline + 1;
+            if (line.length > maxMessageBytes) {
+                this.options.onError(new Error(`MCP stdio message exceeds ${maxMessageBytes} bytes`));
+                continue;
+            }
+            const text = line.toString("utf8").replace(/\r$/, "");
+            if (!text.trim())
+                continue;
+            try {
+                this.options.onMessage(parseJsonRpcMessage(JSON.parse(text)));
+            }
+            catch (error) {
+                this.options.onError(error);
+            }
+        }
+    }
+    /** Takes the next stderr bytes into the tail and passes them to `onStderr`. */
+    readStderr(chunk) {
+        const maxStderrBytes = this.options.maxStderrBytes ?? DEFAULT_MAX_STDERR_BYTES;
+        this.stderrBuffer = Buffer.concat([this.stderrBuffer, chunk]);
+        if (this.stderrBuffer.length > maxStderrBytes)
+            this.stderrBuffer = this.stderrBuffer.subarray(-maxStderrBytes);
+        this.options.onStderr?.(Buffer.from(chunk.buffer, chunk.byteOffset, chunk.byteLength).toString("utf8"));
+    }
+    /** Ends stdout: a message without its newline is reported as an error and dropped. */
+    end() {
+        if (Buffer.concat(this.stdoutChunks).toString("utf8").trim()) {
+            this.options.onError(new Error("MCP stdio server closed with an incomplete JSON-RPC message"));
+        }
+        this.stdoutChunks = [];
+        this.stdoutPendingBytes = 0;
+    }
+}
+//# sourceMappingURL=lines.js.map

package/dist/transports/lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.js","sourceRoot":"","sources":["../../src/transports/lines.ts"],"names":[],"mappings":"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","sourcesContent":["import { type JsonRpcMessage, parseJsonRpcMessage } from \"../protocol/jsonrpc.ts\";\nimport { DEFAULT_MAX_MESSAGE_BYTES } from \"./transport.ts\";\n\nconst DEFAULT_MAX_STDERR_BYTES = 64 * 1024;\n\nexport interface JsonRpcLineReaderOptions {\n\tmaxMessageBytes?: number;\n\tmaxStderrBytes?: number;\n\t/** Every stderr chunk, decoded as UTF-8. */\n\tonStderr?: (chunk: string) => void;\n\tonMessage(message: JsonRpcMessage): void;\n\tonError(error: unknown): void;\n}\n\n/**\n * Reads a program's output as MCP's stdio framing: newline-delimited JSON-RPC messages on stdout, and a bounded\n * tail of stderr for diagnostics.\n */\nexport class JsonRpcLineReader {\n\tprivate readonly options: JsonRpcLineReaderOptions;\n\t/** The bytes of the incomplete message received so far. */\n\tprivate stdoutChunks: Buffer[] = [];\n\tprivate stdoutPendingBytes = 0;\n\tprivate stderrBuffer = Buffer.alloc(0);\n\n\tconstructor(options: JsonRpcLineReaderOptions) {\n\t\tthis.options = options;\n\t}\n\n\t/** The last `maxStderrBytes` of stderr. */\n\tget stderr(): string {\n\t\treturn this.stderrBuffer.toString(\"utf8\");\n\t}\n\n\t/**\n\t * Takes the next stdout bytes and reports every complete message, or the error parsing it. Bytes of an\n\t * incomplete message are kept as chunks and joined once when its newline arrives, so a large message that\n\t * arrives in many chunks is copied and scanned only once.\n\t */\n\treadStdout(chunk: Uint8Array): void {\n\t\tconst data = Buffer.from(chunk.buffer, chunk.byteOffset, chunk.byteLength);\n\t\tconst maxMessageBytes = this.options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;\n\t\tlet start = 0;\n\t\twhile (true) {\n\t\t\tconst newline = data.indexOf(0x0a, start);\n\t\t\tif (newline < 0) {\n\t\t\t\tif (start < data.length) {\n\t\t\t\t\t// Copied, since the caller may reuse the chunk's memory.\n\t\t\t\t\tthis.stdoutChunks.push(Buffer.from(data.subarray(start)));\n\t\t\t\t\tthis.stdoutPendingBytes += data.length - start;\n\t\t\t\t}\n\t\t\t\tif (this.stdoutPendingBytes > maxMessageBytes) {\n\t\t\t\t\tthis.stdoutChunks = [];\n\t\t\t\t\tthis.stdoutPendingBytes = 0;\n\t\t\t\t\tthis.options.onError(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\tlet line = data.subarray(start, newline);\n\t\t\tif (this.stdoutChunks.length > 0) {\n\t\t\t\tthis.stdoutChunks.push(line);\n\t\t\t\tline = Buffer.concat(this.stdoutChunks, this.stdoutPendingBytes + line.length);\n\t\t\t\tthis.stdoutChunks = [];\n\t\t\t\tthis.stdoutPendingBytes = 0;\n\t\t\t}\n\t\t\tstart = newline + 1;\n\t\t\tif (line.length > maxMessageBytes) {\n\t\t\t\tthis.options.onError(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.options.onMessage(parseJsonRpcMessage(JSON.parse(text)));\n\t\t\t} catch (error) {\n\t\t\t\tthis.options.onError(error);\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Takes the next stderr bytes into the tail and passes them to `onStderr`. */\n\treadStderr(chunk: Uint8Array): void {\n\t\tconst maxStderrBytes = this.options.maxStderrBytes ?? DEFAULT_MAX_STDERR_BYTES;\n\t\tthis.stderrBuffer = Buffer.concat([this.stderrBuffer, chunk]);\n\t\tif (this.stderrBuffer.length > maxStderrBytes) this.stderrBuffer = this.stderrBuffer.subarray(-maxStderrBytes);\n\t\tthis.options.onStderr?.(Buffer.from(chunk.buffer, chunk.byteOffset, chunk.byteLength).toString(\"utf8\"));\n\t}\n\n\t/** Ends stdout: a message without its newline is reported as an error and dropped. */\n\tend(): void {\n\t\tif (Buffer.concat(this.stdoutChunks).toString(\"utf8\").trim()) {\n\t\t\tthis.options.onError(new Error(\"MCP stdio server closed with an incomplete JSON-RPC message\"));\n\t\t}\n\t\tthis.stdoutChunks = [];\n\t\tthis.stdoutPendingBytes = 0;\n\t}\n}\n"]}

package/dist/transports/pipe.d.ts

@@ -0,0 +1,49 @@
+import { type JsonRpcMessage } from "../protocol/jsonrpc.ts";
+import { type McpTransport, TransportEvents } from "./transport.ts";
+/** A running program's stdio, as `@earendil-works/pi-env`'s `RemoteProcess` provides it. */
+export interface McpPipe {
+    write(data: Uint8Array | string): void;
+    closeStdin(): void;
+    /** Kill the program (and what it started). The pipe owns cleaning up what the program started. */
+    close(): void;
+    /** Settles when the program has ended, whatever the reason; it must also settle after `close()`. */
+    readonly exited: Promise<unknown>;
+}
+/** Handlers `PipeTransportOptions.open` connects to the program's output. */
+export interface McpPipeHandlers {
+    onStdout(bytes: Uint8Array): void;
+    onStderr(bytes: Uint8Array): void;
+}
+export interface PipeTransportOptions {
+    /** Start the program; `onStdout`/`onStderr` receive its output from then on. */
+    open(handlers: McpPipeHandlers): Promise<McpPipe>;
+    maxMessageBytes?: number;
+    maxStderrBytes?: number;
+    onStderr?: (chunk: string) => void;
+    /** After closing stdin, how long the program may take to exit before `close()` kills it. Default 2000. */
+    closeTimeoutMs?: number;
+}
+/**
+ * MCP's stdio transport over a program that something else runs, for example on another machine through pi-env.
+ * The transport closes when the program ends; a rejected `exited` that `close()` did not cause is reported as an
+ * error first.
+ */
+export declare class PipeTransport extends TransportEvents implements McpTransport {
+    readonly options: Readonly<PipeTransportOptions>;
+    private readonly lines;
+    private pipe;
+    private started;
+    private closed;
+    private ended;
+    constructor(options: PipeTransportOptions);
+    /** The last `maxStderrBytes` (default 64 KiB) of the program's stderr. */
+    get stderr(): string;
+    start(): Promise<void>;
+    send(message: JsonRpcMessage): Promise<void>;
+    close(): Promise<void>;
+    /** The program ended: report an unfinished message, then close. */
+    private exit;
+    /** `exited` rejected: an error unless `close()` caused it, then the same as an exit. */
+    private fail;
+}
+//# sourceMappingURL=pipe.d.ts.map

package/dist/transports/pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../src/transports/pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAA4B,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAAE,KAAK,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIpE,4FAA4F;AAC5F,MAAM,WAAW,OAAO;IACvB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,UAAU,IAAI,IAAI,CAAC;IACnB,kGAAkG;IAClG,KAAK,IAAI,IAAI,CAAC;IACd,oGAAoG;IACpG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACpC,gFAAgF;IAChF,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,0GAA0G;IAC1G,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,eAAgB,YAAW,YAAY;IACzE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IAEtB,YAAY,OAAO,EAAE,oBAAoB,EAUxC;IAED,0EAA0E;IAC1E,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB3B;IAEK,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAyB3B;IAED,mEAAmE;IACnE,OAAO,CAAC,IAAI;IAMZ,wFAAwF;IACxF,OAAO,CAAC,IAAI;CAIZ"}

package/dist/transports/pipe.js

@@ -0,0 +1,96 @@
+import { McpConnectionClosedError } from "../protocol/jsonrpc.js";
+import { JsonRpcLineReader } from "./lines.js";
+import { TransportEvents } from "./transport.js";
+const DEFAULT_CLOSE_TIMEOUT_MS = 2_000;
+/**
+ * MCP's stdio transport over a program that something else runs, for example on another machine through pi-env.
+ * The transport closes when the program ends; a rejected `exited` that `close()` did not cause is reported as an
+ * error first.
+ */
+export class PipeTransport extends TransportEvents {
+    options;
+    lines;
+    pipe;
+    started = false;
+    closed = false;
+    ended = false;
+    constructor(options) {
+        super();
+        this.options = Object.freeze({ ...options });
+        this.lines = new JsonRpcLineReader({
+            maxMessageBytes: this.options.maxMessageBytes,
+            maxStderrBytes: this.options.maxStderrBytes,
+            onStderr: this.options.onStderr,
+            onMessage: (message) => this.emitMessage(message),
+            onError: (error) => this.emitError(error),
+        });
+    }
+    /** The last `maxStderrBytes` (default 64 KiB) of the program's stderr. */
+    get stderr() {
+        return this.lines.stderr;
+    }
+    async start() {
+        if (this.started)
+            throw new Error("MCP pipe transport already started");
+        if (this.closed)
+            throw new McpConnectionClosedError();
+        this.started = true;
+        const pipe = await this.options.open({
+            onStdout: (bytes) => this.lines.readStdout(bytes),
+            onStderr: (bytes) => this.lines.readStderr(bytes),
+        });
+        if (this.closed) {
+            // close() ran while the program was starting and found nothing to shut down. Nobody else awaits
+            // `exited`, and a pipe may reject it after a kill.
+            pipe.exited.catch(() => { });
+            pipe.close();
+            throw new McpConnectionClosedError();
+        }
+        this.pipe = pipe;
+        pipe.exited.then(() => this.exit(), (error) => this.fail(error));
+    }
+    async send(message) {
+        if (!this.pipe || this.closed || this.ended)
+            throw new McpConnectionClosedError();
+        this.pipe.write(`${JSON.stringify(message)}\n`);
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const pipe = this.pipe;
+        if (!pipe) {
+            this.emitClose();
+            return;
+        }
+        if (this.ended)
+            return;
+        // Shutdown per the spec: close stdin and let the program exit, then kill it.
+        pipe.closeStdin();
+        let timer;
+        const exitedInTime = await Promise.race([
+            pipe.exited.then(() => true, () => true),
+            new Promise((resolve) => {
+                timer = setTimeout(() => resolve(false), this.options.closeTimeoutMs ?? DEFAULT_CLOSE_TIMEOUT_MS);
+            }),
+        ]);
+        clearTimeout(timer);
+        if (exitedInTime)
+            return;
+        pipe.close();
+        await pipe.exited.catch(() => { });
+    }
+    /** The program ended: report an unfinished message, then close. */
+    exit() {
+        this.ended = true;
+        this.lines.end();
+        this.emitClose();
+    }
+    /** `exited` rejected: an error unless `close()` caused it, then the same as an exit. */
+    fail(error) {
+        if (!this.closed)
+            this.emitError(error);
+        this.exit();
+    }
+}
+//# sourceMappingURL=pipe.js.map

package/dist/transports/pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../../src/transports/pipe.ts"],"names":[],"mappings":"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","sourcesContent":["import { type JsonRpcMessage, McpConnectionClosedError } from \"../protocol/jsonrpc.ts\";\nimport { JsonRpcLineReader } from \"./lines.ts\";\nimport { type McpTransport, TransportEvents } from \"./transport.ts\";\n\nconst DEFAULT_CLOSE_TIMEOUT_MS = 2_000;\n\n/** A running program's stdio, as `@earendil-works/pi-env`'s `RemoteProcess` provides it. */\nexport interface McpPipe {\n\twrite(data: Uint8Array | string): void;\n\tcloseStdin(): void;\n\t/** Kill the program (and what it started). The pipe owns cleaning up what the program started. */\n\tclose(): void;\n\t/** Settles when the program has ended, whatever the reason; it must also settle after `close()`. */\n\treadonly exited: Promise<unknown>;\n}\n\n/** Handlers `PipeTransportOptions.open` connects to the program's output. */\nexport interface McpPipeHandlers {\n\tonStdout(bytes: Uint8Array): void;\n\tonStderr(bytes: Uint8Array): void;\n}\n\nexport interface PipeTransportOptions {\n\t/** Start the program; `onStdout`/`onStderr` receive its output from then on. */\n\topen(handlers: McpPipeHandlers): Promise<McpPipe>;\n\tmaxMessageBytes?: number;\n\tmaxStderrBytes?: number;\n\tonStderr?: (chunk: string) => void;\n\t/** After closing stdin, how long the program may take to exit before `close()` kills it. Default 2000. */\n\tcloseTimeoutMs?: number;\n}\n\n/**\n * MCP's stdio transport over a program that something else runs, for example on another machine through pi-env.\n * The transport closes when the program ends; a rejected `exited` that `close()` did not cause is reported as an\n * error first.\n */\nexport class PipeTransport extends TransportEvents implements McpTransport {\n\treadonly options: Readonly<PipeTransportOptions>;\n\tprivate readonly lines: JsonRpcLineReader;\n\tprivate pipe: McpPipe | undefined;\n\tprivate started = false;\n\tprivate closed = false;\n\tprivate ended = false;\n\n\tconstructor(options: PipeTransportOptions) {\n\t\tsuper();\n\t\tthis.options = Object.freeze({ ...options });\n\t\tthis.lines = new JsonRpcLineReader({\n\t\t\tmaxMessageBytes: this.options.maxMessageBytes,\n\t\t\tmaxStderrBytes: this.options.maxStderrBytes,\n\t\t\tonStderr: this.options.onStderr,\n\t\t\tonMessage: (message) => this.emitMessage(message),\n\t\t\tonError: (error) => this.emitError(error),\n\t\t});\n\t}\n\n\t/** The last `maxStderrBytes` (default 64 KiB) of the program's stderr. */\n\tget stderr(): string {\n\t\treturn this.lines.stderr;\n\t}\n\n\tasync start(): Promise<void> {\n\t\tif (this.started) throw new Error(\"MCP pipe transport already started\");\n\t\tif (this.closed) throw new McpConnectionClosedError();\n\t\tthis.started = true;\n\t\tconst pipe = await this.options.open({\n\t\t\tonStdout: (bytes) => this.lines.readStdout(bytes),\n\t\t\tonStderr: (bytes) => this.lines.readStderr(bytes),\n\t\t});\n\t\tif (this.closed) {\n\t\t\t// close() ran while the program was starting and found nothing to shut down. Nobody else awaits\n\t\t\t// `exited`, and a pipe may reject it after a kill.\n\t\t\tpipe.exited.catch(() => {});\n\t\t\tpipe.close();\n\t\t\tthrow new McpConnectionClosedError();\n\t\t}\n\t\tthis.pipe = pipe;\n\t\tpipe.exited.then(\n\t\t\t() => this.exit(),\n\t\t\t(error: unknown) => this.fail(error),\n\t\t);\n\t}\n\n\tasync send(message: JsonRpcMessage): Promise<void> {\n\t\tif (!this.pipe || this.closed || this.ended) throw new McpConnectionClosedError();\n\t\tthis.pipe.write(`${JSON.stringify(message)}\\n`);\n\t}\n\n\tasync close(): Promise<void> {\n\t\tif (this.closed) return;\n\t\tthis.closed = true;\n\t\tconst pipe = this.pipe;\n\t\tif (!pipe) {\n\t\t\tthis.emitClose();\n\t\t\treturn;\n\t\t}\n\t\tif (this.ended) return;\n\t\t// Shutdown per the spec: close stdin and let the program exit, then kill it.\n\t\tpipe.closeStdin();\n\t\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\t\tconst exitedInTime = await Promise.race([\n\t\t\tpipe.exited.then(\n\t\t\t\t() => true,\n\t\t\t\t() => true,\n\t\t\t),\n\t\t\tnew Promise<false>((resolve) => {\n\t\t\t\ttimer = setTimeout(() => resolve(false), this.options.closeTimeoutMs ?? DEFAULT_CLOSE_TIMEOUT_MS);\n\t\t\t}),\n\t\t]);\n\t\tclearTimeout(timer);\n\t\tif (exitedInTime) return;\n\t\tpipe.close();\n\t\tawait pipe.exited.catch(() => {});\n\t}\n\n\t/** The program ended: report an unfinished message, then close. */\n\tprivate exit(): void {\n\t\tthis.ended = true;\n\t\tthis.lines.end();\n\t\tthis.emitClose();\n\t}\n\n\t/** `exited` rejected: an error unless `close()` caused it, then the same as an exit. */\n\tprivate fail(error: unknown): void {\n\t\tif (!this.closed) this.emitError(error);\n\t\tthis.exit();\n\t}\n}\n"]}

package/dist/transports/stdio.d.ts

@@ -16,8 +16,7 @@ export interface StdioTransportOptions {
 export declare class StdioTransport extends TransportEvents implements McpTransport {
     readonly options: Readonly<StdioTransportOptions>;
     private child;
-    private stdoutBuffer;
-    private stderrBuffer;
+    private readonly lines;
     private started;
     private closed;
     constructor(options: StdioTransportOptions);
@@ -26,7 +25,5 @@ export declare class StdioTransport extends TransportEvents implements McpTransp
     start(): Promise<void>;
     send(message: JsonRpcMessage): Promise<void>;
     close(): Promise<void>;
-    private handleStdout;
-    private handleStderr;
 }
 //# sourceMappingURL=stdio.d.ts.map

package/dist/transports/stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/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"}
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/transports/stdio.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAA4B,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAAE,KAAK,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAiDpE,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,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,OAAO,EAAE,qBAAqB,EAUzC;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAiD3B;IAEK,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOjD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA6B3B;CACD"}

package/dist/transports/stdio.js

@@ -1,9 +1,9 @@
 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;
+import { McpConnectionClosedError } from "../protocol/jsonrpc.js";
+import { JsonRpcLineReader } from "./lines.js";
+import { TransportEvents } from "./transport.js";
 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;
@@ -52,19 +52,25 @@ function installExitHook() {
 export class StdioTransport extends TransportEvents {
     options;
     child;
-    stdoutBuffer = Buffer.alloc(0);
-    stderrBuffer = Buffer.alloc(0);
+    lines;
     started = false;
     closed = false;
     constructor(options) {
         super();
         this.options = Object.freeze({ ...options, args: options.args ? [...options.args] : undefined });
+        this.lines = new JsonRpcLineReader({
+            maxMessageBytes: this.options.maxMessageBytes,
+            maxStderrBytes: this.options.maxStderrBytes,
+            onStderr: this.options.onStderr,
+            onMessage: (message) => this.emitMessage(message),
+            onError: (error) => this.emitError(error),
+        });
     }
     get pid() {
         return this.child?.pid;
     }
     get stderr() {
-        return this.stderrBuffer.toString("utf8");
+        return this.lines.stderr;
     }
     async start() {
         if (this.started)
@@ -86,22 +92,20 @@ export class StdioTransport extends TransportEvents {
         if (USE_PROCESS_GROUPS && pid !== undefined) {
             installExitHook();
             liveProcessGroups.add(pid);
-            child.once("exit", () => liveProcessGroups.delete(pid));
+            // Not on "exit": children of the server can outlive it while still holding its pipes.
+            child.once("close", () => liveProcessGroups.delete(pid));
         }
-        child.stdout?.on("data", (chunk) => this.handleStdout(chunk));
+        child.stdout?.on("data", (chunk) => this.lines.readStdout(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("data", (chunk) => this.lines.readStderr(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.lines.end();
             this.emitClose();
         });
         await new Promise((resolve, reject) => {
@@ -139,7 +143,9 @@ export class StdioTransport extends TransportEvents {
             this.emitClose();
             return;
         }
-        if (child.exitCode !== null || child.signalCode !== null) {
+        // With process groups, a server that already exited can leave children holding its pipes; the
+        // group cleanup below still has to run for them.
+        if (!USE_PROCESS_GROUPS && (child.exitCode !== null || child.signalCode !== null)) {
             child.stdin?.end();
             return;
         }
@@ -160,42 +166,5 @@ export class StdioTransport extends TransportEvents {
             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/transports/stdio.js.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/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.ts\";\nimport { DEFAULT_MAX_MESSAGE_BYTES, type McpTransport, TransportEvents } from \"./transport.ts\";\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"]}
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/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 } from \"../protocol/jsonrpc.ts\";\nimport { JsonRpcLineReader } from \"./lines.ts\";\nimport { type McpTransport, TransportEvents } from \"./transport.ts\";\n\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 readonly lines: JsonRpcLineReader;\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\tthis.lines = new JsonRpcLineReader({\n\t\t\tmaxMessageBytes: this.options.maxMessageBytes,\n\t\t\tmaxStderrBytes: this.options.maxStderrBytes,\n\t\t\tonStderr: this.options.onStderr,\n\t\t\tonMessage: (message) => this.emitMessage(message),\n\t\t\tonError: (error) => this.emitError(error),\n\t\t});\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.lines.stderr;\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\t// Not on \"exit\": children of the server can outlive it while still holding its pipes.\n\t\t\tchild.once(\"close\", () => liveProcessGroups.delete(pid));\n\t\t}\n\t\tchild.stdout?.on(\"data\", (chunk: Buffer) => this.lines.readStdout(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) => this.lines.readStderr(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\tthis.lines.end();\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\t// With process groups, a server that already exited can leave children holding its pipes; the\n\t\t// group cleanup below still has to run for them.\n\t\tif (!USE_PROCESS_GROUPS && (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"]}

package/dist/transports/streamable-http.d.ts

@@ -1,6 +1,6 @@
 import type { AuthProvider, McpFetch } from "../auth-provider.ts";
 import { type JsonRpcMessage } from "../protocol/jsonrpc.ts";
-import { type McpTransport, TransportEvents } from "./transport.ts";
+import { type McpTransport, type McpTransportSendOptions, TransportEvents } from "./transport.ts";
 export interface SseEvent {
     event?: string;
     data: string;
@@ -56,18 +56,25 @@ export declare class StreamableHttpTransport extends TransportEvents implements
     private sessionIdValue;
     private protocolVersion;
     private getStreamStarted;
+    /** Access token of the latest request, which `close()` reuses instead of asking the auth provider. */
+    private lastToken;
     constructor(options: StreamableHttpTransportOptions);
     get sessionId(): string | undefined;
     start(): Promise<void>;
     setProtocolVersion(version: string): void;
-    send(message: JsonRpcMessage): Promise<void>;
+    send(message: JsonRpcMessage, { signal }?: McpTransportSendOptions): 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.
+     *
+     * `signal` only stops dispatch: getting a token or the authorization recovery can take a while, and a
+     * request its sender gave up on in the meantime must not reach the server. It does not abort the shared
+     * recovery, which other requests may wait for.
      */
     private authorizedFetch;
     private headers;
+    private buildHeaders;
     private captureSession;
     private checkResponse;
     private consumeSse;

package/dist/transports/streamable-http.d.ts.map

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