@ibm/ibmi-mcp-server 0.1.0

package/dist/mcp-server/transports/core/autoTransportManager.js

@@ -0,0 +1,57 @@
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { StatefulTransportManager, } from "./statefulTransportManager.js";
+import { StatelessTransportManager } from "./statelessTransportManager.js";
+/**
+ * A transport manager that dynamically handles both stateful and stateless requests.
+ * It inspects each request and routes it to an underlying stateful manager if it
+ * contains a session ID or is an initialization request. Otherwise, it handles
+ * the request ephemerally using a temporary stateless manager.
+ */
+export class AutoTransportManager {
+    statefulManager;
+    statelessManager;
+    /**
+     * @param createServerInstanceFn A factory function to create new McpServer instances.
+     * @param options Configuration options, primarily for the underlying stateful manager.
+     */
+    constructor(createServerInstanceFn, options) {
+        this.statefulManager = new StatefulTransportManager(createServerInstanceFn, options);
+        this.statelessManager = new StatelessTransportManager(createServerInstanceFn);
+    }
+    /**
+     * Handles an incoming request by routing it to the appropriate manager.
+     * If the request is an `initialize` request or includes a session ID, it is
+     * delegated to the stateful manager. Otherwise, a new stateless manager is
+     * created to handle the single request.
+     * @param request The standardized transport request object.
+     * @returns A promise that resolves to a TransportResponse object.
+     */
+    async handleRequest(request) {
+        const { body, sessionId } = request;
+        // Route to stateful manager if it's an initialize request or has a session ID
+        if (isInitializeRequest(body) || sessionId) {
+            // The plan describes an intermediate state for StatefulTransportManager's handleRequest,
+            // but for consistency with the new TransportManager interface, we will pass the whole request object.
+            // This anticipates the final state of the refactoring.
+            return this.statefulManager.handleRequest(request);
+        }
+        // Otherwise, handle as a one-off stateless request
+        return this.statelessManager.handleRequest(request);
+    }
+    /**
+     * Delegates a session deletion request to the underlying stateful manager.
+     * @param sessionId The ID of the session to delete.
+     * @param context The request context.
+     * @returns A promise resolving to a TransportResponse confirming closure.
+     */
+    async handleDeleteRequest(sessionId, context) {
+        return this.statefulManager.handleDeleteRequest(sessionId, context);
+    }
+    /**
+     * Shuts down the underlying stateful manager, cleaning up all its resources.
+     */
+    async shutdown() {
+        await this.statefulManager.shutdown();
+    }
+}
+//# sourceMappingURL=autoTransportManager.js.map

package/dist/mcp-server/transports/core/autoTransportManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoTransportManager.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/autoTransportManager.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,EACL,wBAAwB,GAEzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IACd,eAAe,CAA2B;IAC1C,gBAAgB,CAA4B;IAE7D;;;OAGG;IACH,YACE,sBAAgD,EAChD,OAAiC;QAEjC,IAAI,CAAC,eAAe,GAAG,IAAI,wBAAwB,CACjD,sBAAsB,EACtB,OAAO,CACR,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG,IAAI,yBAAyB,CACnD,sBAAsB,CACvB,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,aAAa,CACjB,OAA4B;QAE5B,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAEpC,8EAA8E;QAC9E,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;YAC3C,yFAAyF;YACzF,sGAAsG;YACtG,uDAAuD;YACvD,OAAO,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;QAED,mDAAmD;QACnD,OAAO,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CACvB,SAAiB,EACjB,OAAuB;QAEvB,OAAO,IAAI,CAAC,eAAe,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/mcp-server/transports/core/baseTransportManager.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Abstract base class for transport managers.
+ * @module src/mcp-server/transports/core/baseTransportManager
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpTransportRequest } from "./transportRequest.js";
+import { TransportManager, TransportResponse } from "./transportTypes.js";
+/**
+ * Abstract base class for transport managers, providing common functionality.
+ */
+export declare abstract class BaseTransportManager implements TransportManager {
+    protected readonly createServerInstanceFn: () => Promise<McpServer>;
+    constructor(createServerInstanceFn: () => Promise<McpServer>);
+    abstract handleRequest(request: McpTransportRequest): Promise<TransportResponse>;
+    abstract shutdown(): Promise<void>;
+}
+//# sourceMappingURL=baseTransportManager.d.ts.map

package/dist/mcp-server/transports/core/baseTransportManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseTransportManager.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/baseTransportManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE1E;;GAEG;AACH,8BAAsB,oBAAqB,YAAW,gBAAgB;IACpE,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;gBAExD,sBAAsB,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC;IAS5D,QAAQ,CAAC,aAAa,CACpB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,iBAAiB,CAAC;IAE7B,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CACnC"}

package/dist/mcp-server/transports/core/baseTransportManager.js

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Abstract base class for transport managers.
+ * @module src/mcp-server/transports/core/baseTransportManager
+ */
+import { logger, requestContextService } from "../../../utils/index.js";
+/**
+ * Abstract base class for transport managers, providing common functionality.
+ */
+export class BaseTransportManager {
+    createServerInstanceFn;
+    constructor(createServerInstanceFn) {
+        const context = requestContextService.createRequestContext({
+            operation: "BaseTransportManager.constructor",
+            managerType: this.constructor.name,
+        });
+        logger.debug(context, "Initializing transport manager.");
+        this.createServerInstanceFn = createServerInstanceFn;
+    }
+}
+//# sourceMappingURL=baseTransportManager.js.map

package/dist/mcp-server/transports/core/baseTransportManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseTransportManager.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/baseTransportManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAIjE;;GAEG;AACH,MAAM,OAAgB,oBAAoB;IACrB,sBAAsB,CAA2B;IAEpE,YAAY,sBAAgD;QAC1D,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,kCAAkC;YAC7C,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;SACnC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAC;QACzD,IAAI,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;IACvD,CAAC;CAOF"}

package/dist/mcp-server/transports/core/headerUtils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Provides a utility for converting HTTP headers between Node.js
+ * and Web Standards formats, ensuring compliance and correctness.
+ * @module src/mcp-server/transports/core/headerUtils
+ */
+import type { OutgoingHttpHeaders, IncomingHttpHeaders } from "http";
+/**
+ * Converts Node.js-style OutgoingHttpHeaders to a Web-standard Headers object.
+ *
+ * This function is critical for interoperability between Node.js's `http` module
+ * and Web APIs like Fetch and Hono. It correctly handles multi-value headers
+ * (e.g., `Set-Cookie`), which Node.js represents as an array of strings, by
+ * using the `Headers.append()` method. Standard single-value headers are set
+ * using `Headers.set()`.
+ *
+ * @param nodeHeaders - The Node.js-style headers object to convert.
+ * @returns A Web-standard Headers object.
+ */
+export declare function convertNodeHeadersToWebHeaders(nodeHeaders: OutgoingHttpHeaders): Headers;
+/**
+ * Converts a Web-standard Headers object (used by Hono) to Node.js-style IncomingHttpHeaders.
+ *
+ * @param webHeaders - The Web-standard Headers object to convert.
+ * @returns A Node.js-style IncomingHttpHeaders object.
+ */
+export declare function convertWebHeadersToNodeHeaders(webHeaders: Headers): IncomingHttpHeaders;
+//# sourceMappingURL=headerUtils.d.ts.map

package/dist/mcp-server/transports/core/headerUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerUtils.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/headerUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,mBAAmB,GAC/B,OAAO,CAmBT;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,OAAO,GAClB,mBAAmB,CAQrB"}

package/dist/mcp-server/transports/core/headerUtils.js

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Provides a utility for converting HTTP headers between Node.js
+ * and Web Standards formats, ensuring compliance and correctness.
+ * @module src/mcp-server/transports/core/headerUtils
+ */
+/**
+ * Converts Node.js-style OutgoingHttpHeaders to a Web-standard Headers object.
+ *
+ * This function is critical for interoperability between Node.js's `http` module
+ * and Web APIs like Fetch and Hono. It correctly handles multi-value headers
+ * (e.g., `Set-Cookie`), which Node.js represents as an array of strings, by
+ * using the `Headers.append()` method. Standard single-value headers are set
+ * using `Headers.set()`.
+ *
+ * @param nodeHeaders - The Node.js-style headers object to convert.
+ * @returns A Web-standard Headers object.
+ */
+export function convertNodeHeadersToWebHeaders(nodeHeaders) {
+    const webHeaders = new Headers();
+    for (const [key, value] of Object.entries(nodeHeaders)) {
+        // Skip undefined headers, which are valid in Node.js but not in Web Headers.
+        if (value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            // For arrays, append each value to support multi-value headers.
+            for (const v of value) {
+                webHeaders.append(key, String(v));
+            }
+        }
+        else {
+            // For single values, set the header, overwriting any existing value.
+            webHeaders.set(key, String(value));
+        }
+    }
+    return webHeaders;
+}
+/**
+ * Converts a Web-standard Headers object (used by Hono) to Node.js-style IncomingHttpHeaders.
+ *
+ * @param webHeaders - The Web-standard Headers object to convert.
+ * @returns A Node.js-style IncomingHttpHeaders object.
+ */
+export function convertWebHeadersToNodeHeaders(webHeaders) {
+    const nodeHeaders = {};
+    // The Headers.forEach provides the comma-separated string if multiple headers existed.
+    webHeaders.forEach((value, key) => {
+        // Node.js lowercases incoming header keys.
+        nodeHeaders[key.toLowerCase()] = value;
+    });
+    return nodeHeaders;
+}
+//# sourceMappingURL=headerUtils.js.map

package/dist/mcp-server/transports/core/headerUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerUtils.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/headerUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,8BAA8B,CAC5C,WAAgC;IAEhC,MAAM,UAAU,GAAG,IAAI,OAAO,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,6EAA6E;QAC7E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,gEAAgE;YAChE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,qEAAqE;YACrE,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAC5C,UAAmB;IAEnB,MAAM,WAAW,GAAwB,EAAE,CAAC;IAC5C,uFAAuF;IACvF,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAChC,2CAA2C;QAC3C,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/mcp-server/transports/core/honoNodeBridge.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview Provides a high-fidelity bridge between the MCP SDK's Node.js-style
+ * streamable HTTP transport and Hono's Web Standards-based streaming response.
+ * This class is essential for adapting the Node.js `http.ServerResponse` API
+ * to a format consumable by modern web frameworks.
+ * @module src/mcp-server/transports/core/honoNodeBridge
+ */
+import { PassThrough } from "stream";
+import type { OutgoingHttpHeaders } from "http";
+/**
+ * A mock `http.ServerResponse` that pipes all written data to a `PassThrough` stream.
+ *
+ * This class serves as a critical compatibility layer, emulating the behavior of a
+ * Node.js `ServerResponse` to capture status codes, headers, and the response body.
+ * The captured data can then be used to construct a Web-standard `Response` object,
+ * for instance in a Hono application. It pays close attention to the timing of when
+ * headers are considered "sent" to mimic Node.js behavior accurately.
+ */
+export declare class HonoStreamResponse extends PassThrough {
+    statusCode: number;
+    headers: OutgoingHttpHeaders;
+    private _headersSent;
+    constructor();
+    /**
+     * A getter that reports whether the headers have been sent.
+     * In this emulation, headers are considered sent the first time `write()` or `end()` is called.
+     */
+    get headersSent(): boolean;
+    /**
+     * Sets the status code and headers for the response, mimicking `http.ServerResponse.writeHead`.
+     *
+     * @param statusCode - The HTTP status code.
+     * @param statusMessageOrHeaders - An optional status message (string) or headers object.
+     * @param headers - An optional headers object, used if the second argument is a status message.
+     * @returns The instance of the class for chaining.
+     */
+    writeHead(statusCode: number, statusMessageOrHeaders?: string | OutgoingHttpHeaders, headers?: OutgoingHttpHeaders): this;
+    /**
+     * Sets a single header value.
+     *
+     * @param name - The name of the header.
+     * @param value - The value of the header.
+     * @returns The instance of the class for chaining.
+     */
+    setHeader(name: string, value: string | number | string[]): this;
+    /**
+     * Gets a header that has been queued for the response.
+     * @param name - The name of the header.
+     * @returns The value of the header, or undefined if not set.
+     */
+    getHeader(name: string): string | number | string[] | undefined;
+    /**
+     * Returns a copy of the current outgoing headers.
+     */
+    getHeaders(): OutgoingHttpHeaders;
+    /**
+     * Removes a header that has been queued for the response.
+     * @param name - The name of the header to remove.
+     */
+    removeHeader(name: string): void;
+    /**
+     * A private helper to mark headers as sent. This is called implicitly
+     * before any part of the body is written.
+     */
+    private ensureHeadersSent;
+    /**
+     * Writes a chunk of the response body, mimicking `http.ServerResponse.write`.
+     * This is the first point where headers are implicitly flushed.
+     */
+    write(chunk: unknown, encodingOrCallback?: BufferEncoding | ((error: Error | null | undefined) => void), callback?: (error: Error | null | undefined) => void): boolean;
+    /**
+     * Finishes sending the response, mimicking `http.ServerResponse.end`.
+     * This also implicitly flushes headers if they haven't been sent yet.
+     */
+    end(chunk?: unknown, encodingOrCallback?: BufferEncoding | (() => void), callback?: () => void): this;
+}
+//# sourceMappingURL=honoNodeBridge.d.ts.map

package/dist/mcp-server/transports/core/honoNodeBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"honoNodeBridge.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/honoNodeBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAGhD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IAC1C,UAAU,SAAO;IACjB,OAAO,EAAE,mBAAmB,CAAM;IACzC,OAAO,CAAC,YAAY,CAAS;;IAM7B;;;OAGG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;;;;OAOG;IACH,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,sBAAsB,CAAC,EAAE,MAAM,GAAG,mBAAmB,EACrD,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI;IAsBP;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAmBhE;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAI/D;;OAEG;IACH,UAAU,IAAI,mBAAmB;IAIjC;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkBhC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;IACH,KAAK,CACH,KAAK,EAAE,OAAO,EACd,kBAAkB,CAAC,EACf,cAAc,GACd,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC,EAC/C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,GACnD,OAAO;IAcV;;;OAGG;IACH,GAAG,CACD,KAAK,CAAC,EAAE,OAAO,EACf,kBAAkB,CAAC,EAAE,cAAc,GAAG,CAAC,MAAM,IAAI,CAAC,EAClD,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,IAAI;CAeR"}

package/dist/mcp-server/transports/core/honoNodeBridge.js

@@ -0,0 +1,150 @@
+/**
+ * @fileoverview Provides a high-fidelity bridge between the MCP SDK's Node.js-style
+ * streamable HTTP transport and Hono's Web Standards-based streaming response.
+ * This class is essential for adapting the Node.js `http.ServerResponse` API
+ * to a format consumable by modern web frameworks.
+ * @module src/mcp-server/transports/core/honoNodeBridge
+ */
+import { PassThrough } from "stream";
+import { logger, requestContextService } from "../../../utils/index.js";
+/**
+ * A mock `http.ServerResponse` that pipes all written data to a `PassThrough` stream.
+ *
+ * This class serves as a critical compatibility layer, emulating the behavior of a
+ * Node.js `ServerResponse` to capture status codes, headers, and the response body.
+ * The captured data can then be used to construct a Web-standard `Response` object,
+ * for instance in a Hono application. It pays close attention to the timing of when
+ * headers are considered "sent" to mimic Node.js behavior accurately.
+ */
+export class HonoStreamResponse extends PassThrough {
+    statusCode = 200;
+    headers = {};
+    _headersSent = false;
+    constructor() {
+        super();
+    }
+    /**
+     * A getter that reports whether the headers have been sent.
+     * In this emulation, headers are considered sent the first time `write()` or `end()` is called.
+     */
+    get headersSent() {
+        return this._headersSent;
+    }
+    /**
+     * Sets the status code and headers for the response, mimicking `http.ServerResponse.writeHead`.
+     *
+     * @param statusCode - The HTTP status code.
+     * @param statusMessageOrHeaders - An optional status message (string) or headers object.
+     * @param headers - An optional headers object, used if the second argument is a status message.
+     * @returns The instance of the class for chaining.
+     */
+    writeHead(statusCode, statusMessageOrHeaders, headers) {
+        if (this._headersSent) {
+            // Per Node.js spec, do nothing if headers are already sent.
+            return this;
+        }
+        this.statusCode = statusCode;
+        const headersArg = typeof statusMessageOrHeaders === "string"
+            ? headers
+            : statusMessageOrHeaders;
+        if (headersArg) {
+            for (const [key, value] of Object.entries(headersArg)) {
+                if (value !== undefined) {
+                    this.setHeader(key, value);
+                }
+            }
+        }
+        return this;
+    }
+    /**
+     * Sets a single header value.
+     *
+     * @param name - The name of the header.
+     * @param value - The value of the header.
+     * @returns The instance of the class for chaining.
+     */
+    setHeader(name, value) {
+        if (this._headersSent) {
+            // Retrieve context if available, otherwise create a basic one
+            const context = requestContextService.createRequestContext({
+                operation: "HonoStreamResponse.setHeader",
+                component: "HonoNodeBridge",
+            });
+            // Replace console.warn with logger.warning
+            logger.warning({ ...context, headerName: name }, `[HonoBridge] Warning: Cannot set header "${name}" after headers are sent.`);
+            return this;
+        }
+        this.headers[name.toLowerCase()] = value;
+        return this;
+    }
+    /**
+     * Gets a header that has been queued for the response.
+     * @param name - The name of the header.
+     * @returns The value of the header, or undefined if not set.
+     */
+    getHeader(name) {
+        return this.headers[name.toLowerCase()];
+    }
+    /**
+     * Returns a copy of the current outgoing headers.
+     */
+    getHeaders() {
+        return { ...this.headers };
+    }
+    /**
+     * Removes a header that has been queued for the response.
+     * @param name - The name of the header to remove.
+     */
+    removeHeader(name) {
+        if (this._headersSent) {
+            // Retrieve context if available
+            const context = requestContextService.createRequestContext({
+                operation: "HonoStreamResponse.removeHeader",
+                component: "HonoNodeBridge",
+            });
+            // Replace console.warn with logger.warning
+            logger.warning({ ...context, headerName: name }, `[HonoBridge] Warning: Cannot remove header "${name}" after headers are sent.`);
+            return;
+        }
+        delete this.headers[name.toLowerCase()];
+    }
+    /**
+     * A private helper to mark headers as sent. This is called implicitly
+     * before any part of the body is written.
+     */
+    ensureHeadersSent() {
+        if (!this._headersSent) {
+            this._headersSent = true;
+        }
+    }
+    /**
+     * Writes a chunk of the response body, mimicking `http.ServerResponse.write`.
+     * This is the first point where headers are implicitly flushed.
+     */
+    write(chunk, encodingOrCallback, callback) {
+        this.ensureHeadersSent();
+        const encoding = typeof encodingOrCallback === "string" ? encodingOrCallback : undefined;
+        const cb = typeof encodingOrCallback === "function" ? encodingOrCallback : callback;
+        if (encoding) {
+            return super.write(chunk, encoding, cb);
+        }
+        return super.write(chunk, cb);
+    }
+    /**
+     * Finishes sending the response, mimicking `http.ServerResponse.end`.
+     * This also implicitly flushes headers if they haven't been sent yet.
+     */
+    end(chunk, encodingOrCallback, callback) {
+        this.ensureHeadersSent();
+        const encoding = typeof encodingOrCallback === "string" ? encodingOrCallback : undefined;
+        const cb = typeof encodingOrCallback === "function" ? encodingOrCallback : callback;
+        if (encoding) {
+            super.end(chunk, encoding, cb);
+        }
+        else {
+            super.end(chunk, cb);
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=honoNodeBridge.js.map

package/dist/mcp-server/transports/core/honoNodeBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"honoNodeBridge.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/honoNodeBridge.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/transports/core/statefulTransportManager.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview Implements a stateful transport manager for the MCP SDK.
+ *
+ * This manager handles multiple, persistent MCP sessions. It creates and maintains
+ * a dedicated McpServer and StreamableHTTPServerTransport instance for each session,
+ * allowing for stateful, multi-turn interactions. It includes robust mechanisms for
+ * session lifecycle management, including garbage collection of stale sessions and
+ * concurrency controls to prevent race conditions.
+ *
+ * SCALABILITY NOTE: This manager maintains all session state in local process memory.
+ * For horizontal scaling across multiple server instances, a load balancer with
+ * sticky sessions (session affinity) is required to ensure that all requests for a
+ * given session are routed to the same process instance that holds that session's state.
+ *
+ * @module src/mcp-server/transports/core/statefulTransportManager
+ */
+import { RequestContext } from "../../../utils/index.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BaseTransportManager } from "./baseTransportManager.js";
+import { McpTransportRequest } from "./transportRequest.js";
+import { // Import SessionState
+StatefulTransportManager as IStatefulTransportManager, TransportResponse, TransportSession } from "./transportTypes.js";
+/**
+ * Defines the configuration options for the StatefulTransportManager.
+ */
+export interface StatefulTransportOptions {
+    staleSessionTimeoutMs: number;
+    mcpHttpEndpointPath: string;
+}
+/**
+ * Manages persistent, stateful MCP sessions.
+ */
+export declare class StatefulTransportManager extends BaseTransportManager implements IStatefulTransportManager {
+    private readonly transports;
+    private readonly servers;
+    private readonly sessions;
+    private readonly garbageCollector;
+    private readonly options;
+    /**
+     * @param createServerInstanceFn - A factory function to create new McpServer instances.
+     * @param options - Configuration options for the manager.
+     */
+    constructor(createServerInstanceFn: () => Promise<McpServer>, options: StatefulTransportOptions);
+    /**
+     * Initializes a new stateful session and handles the first request.
+     *
+     * @param headers - The incoming request headers.
+     * @param body - The parsed body of the request.
+     * @param context - The request context.
+     * @returns A promise resolving to a streaming TransportResponse with a session ID.
+     * @private
+     */
+    private initializeAndHandle;
+    /**
+     * The new public entry point that conforms to the TransportManager interface.
+     * It routes the request to the appropriate handler based on whether it's an
+     * initialization request or a subsequent request for an existing session.
+     */
+    handleRequest(request: McpTransportRequest): Promise<TransportResponse>;
+    /**
+     * Handles a request to explicitly delete a session.
+     */
+    handleDeleteRequest(sessionId: string, context: RequestContext): Promise<TransportResponse>;
+    /**
+     * Retrieves information about a specific session.
+     */
+    getSession(sessionId: string): TransportSession | undefined;
+    /**
+     * Gracefully shuts down the manager, closing all active sessions.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Closes a single session and releases its associated resources.
+     */
+    private closeSession;
+    /**
+     * Periodically runs to find and clean up stale, inactive sessions.
+     */
+    private cleanupStaleSessions;
+}
+//# sourceMappingURL=statefulTransportManager.d.ts.map

package/dist/mcp-server/transports/core/statefulTransportManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statefulTransportManager.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/statefulTransportManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAGL,cAAc,EAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAES,sBAAsB;AACpC,wBAAwB,IAAI,yBAAyB,EACrD,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,wBACX,SAAQ,oBACR,YAAW,yBAAyB;IAEpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;IACJ,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD;;;OAGG;gBAED,sBAAsB,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,EAChD,OAAO,EAAE,wBAAwB;IAkBnC;;;;;;;;OAQG;YACW,mBAAmB;IA2GjC;;;;OAIG;IACG,aAAa,CACjB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,iBAAiB,CAAC;IAoG7B;;OAEG;IACG,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;IA8B7B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI3D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB/B;;OAEG;YACW,YAAY;IA8C1B;;OAEG;YACW,oBAAoB;CA6CnC"}