@orkestrel/mcp 0.0.21 → 0.0.22

package/dist/src/server/index.cjs

@@ -85,6 +85,18 @@ var DEFAULT_MCP_SESSION_CAPACITY = 1024;
 * this bounds the replay log paired with it.
 */
 var DEFAULT_MCP_SESSION_TTL = 3e5;
+/**
+* The default bound in milliseconds on one unconfirmed write to a stdio client transport's
+* child `stdin` — the `delivery` a `createStdioClientTransport` caller who supplies none gets.
+*
+* @remarks
+* Ten seconds. The load-bearing property is the ordering, not the magnitude: this bound stays
+* BELOW {@link import('@orkestrel/mcp').DEFAULT_MCP_REQUEST_TIMEOUT}, so a write the child never
+* reads fails as an undeliverable message while the request that carried it is still open,
+* rather than being masked by that request's own deadline expiring first. Override per
+* transport with `delivery`; an explicit `0` there removes the bound.
+*/
+var DEFAULT_MCP_DELIVERY = 1e4;
 //#endregion
 //#region src/server/helpers.ts
 /**
@@ -1381,9 +1393,10 @@ var WebSocketClientTransport = class {
 * - **Outbound (`send`).** `send(message)` writes one newline-terminated `JSON.stringify`d line
 *   through the supervisor's `send` and AWAITS its answer, so this promise settles only after the
 *   host reports the line handled rather than the moment the write is queued. The supervisor never
-*   rejects — it answers `false` for a channel that was closed, destroyed, or ended, and for a write
-*   that failed — so a `false` answer REJECTS here with the same not-connected error a transport
-*   that was never started raises. A dead peer surfaces at the caller instead of vanishing.
+*   rejects — it answers `false` for a channel that was closed, destroyed, or ended, for a write
+*   that failed, or for one that remained unconfirmed through `delivery`. A call made without a
+*   live child rejects as not connected; a `false` answer from a live child rejects as unable to
+*   deliver. The supervisor does not disclose which cause produced that answer.
 * - **`close()`** runs the supervisor's bounded termination and teardown, then fires `close` once
 *   (idempotent). That teardown reaches the child's TERMINAL MOMENT, where the supervisor freezes
 *   `evidence`, ends `lines`, and settles `exit` together, so this transport needs no release of
@@ -1423,6 +1436,7 @@ var StdioClientTransport = class {
 	#command;
 	#args;
 	#env;
+	#delivery;
 	#process = void 0;
 	#closing = void 0;
 	#closed = false;
@@ -1431,6 +1445,7 @@ var StdioClientTransport = class {
 		this.#command = options.command;
 		this.#args = options.args ?? [];
 		this.#env = options.env;
+		this.#delivery = options.delivery ?? 1e4;
 	}
 	get emitter() {
 		return this.#emitter;
@@ -1462,6 +1477,7 @@ var StdioClientTransport = class {
 			},
 			workspace: process.cwd(),
 			grace: _orkestrel_process.PROCESS_GRACE,
+			delivery: this.#delivery,
 			writable: true
 		});
 		this.#process = child;
@@ -1469,9 +1485,20 @@ var StdioClientTransport = class {
 		child.exit.then((exit) => this.#onExit(child, exit));
 		this.#pump(child);
 	}
+	/**
+	* Sends one newline-delimited JSON-RPC message to the live child.
+	*
+	* @param message - The message to write to the child's `stdin`
+	* @returns Resolves when the supervisor confirms the write
+	* @throws Thrown with `stdio transport is not connected` when no live child is available before
+	*   the write
+	* @throws Thrown with `stdio transport could not deliver the message` when a live child's write
+	*   resolves `false`
+	*/
 	async send(message) {
 		const child = this.#closed ? void 0 : this.#process;
-		if (!(child === void 0 ? false : await child.send(JSON.stringify(message)))) throw new Error("stdio transport is not connected");
+		if (child === void 0) throw new Error("stdio transport is not connected");
+		if (!await child.send(JSON.stringify(message))) throw new Error("stdio transport could not deliver the message");
 	}
 	async close() {
 		if (this.#closed && this.#closing === void 0) return;
@@ -1865,10 +1892,14 @@ function createWebSocketClientTransport(options) {
 * inherits it. Each JSON-RPC message the client `send`s is written as one
 * newline-terminated line to the child's `stdin`; each decoded reply line from the
 * child's `stdout` is surfaced on the transport's `message` event for the client's
-* id correlation.
+* id correlation. That write is bounded: a child that stays alive without ever reading
+* its `stdin` fills the pipe, and `options.delivery` is how long the unconfirmed write
+* waits before the `send` rejects. An omitted `delivery` selects {@link
+* import('./constants.js').DEFAULT_MCP_DELIVERY}; an explicit `0` removes the bound.
 *
 * @param options - `command` (the executable to spawn; REQUIRED), optional `args`,
-*   and optional `env`; see {@link StdioClientTransportOptions}
+*   optional `env`, and an optional `delivery` bound in milliseconds on an unconfirmed
+*   `stdin` write; see {@link StdioClientTransportOptions}
 * @returns A working {@link StdioClientTransportInterface} over a child process's stdio,
 *   whose `evidence` carries the supervised child's bounded stderr tail
 *
@@ -2107,6 +2138,7 @@ function createMCPSession(options) {
 	};
 }
 //#endregion
+exports.DEFAULT_MCP_DELIVERY = DEFAULT_MCP_DELIVERY;
 exports.DEFAULT_MCP_KEEPALIVE_INTERVAL = DEFAULT_MCP_KEEPALIVE_INTERVAL;
 exports.DEFAULT_MCP_PATH = DEFAULT_MCP_PATH;
 exports.DEFAULT_MCP_SESSION_CAPACITY = DEFAULT_MCP_SESSION_CAPACITY;