@cyanheads/pubmed-mcp-server 1.3.5 → 1.4.1

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"}

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

@@ -1,24 +1,77 @@
 /**
- * @fileoverview Provides a bridge between the MCP SDK's Node.js-style
+ * @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 ServerResponse that pipes writes to a PassThrough stream.
- * This is the bridge between Model Context Protocol's SDK's Node.js-style response handling
- * and Hono's stream-based body. It captures status and headers.
+ * 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: Record<string, string | number | string[]>;
+    headers: OutgoingHttpHeaders;
+    private _headersSent;
     constructor();
-    writeHead(statusCode: number, headers?: Record<string, string | number | string[]>): this;
+    /**
+     * 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;
-    getHeaders(): Record<string, string | number | string[]>;
+    /**
+     * 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

@@ -1 +1 @@
-{"version":3,"file":"honoNodeBridge.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/honoNodeBridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,UAAU,SAAO;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAM;;IAMzD,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,GACnD,IAAI;IAQP,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAKhE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAI/D,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;IAIxD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC,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;IASV,GAAG,CACD,KAAK,CAAC,EAAE,OAAO,EACf,kBAAkB,CAAC,EAAE,cAAc,GAAG,CAAC,MAAM,IAAI,CAAC,EAClD,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,IAAI;CASR"}
+{"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;AAEhD;;;;;;;;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;IAahE;;;;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;IAUhC;;;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

@@ -1,51 +1,138 @@
 /**
- * @fileoverview Provides a bridge between the MCP SDK's Node.js-style
+ * @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";
 /**
- * A mock ServerResponse that pipes writes to a PassThrough stream.
- * This is the bridge between Model Context Protocol's SDK's Node.js-style response handling
- * and Hono's stream-based body. It captures status and headers.
+ * 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();
     }
-    writeHead(statusCode, headers) {
+    /**
+     * 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;
-        if (headers) {
-            this.headers = { ...this.headers, ...headers };
+        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) {
+            // This is a deviation from Node.js (which would throw), but provides a
+            // more graceful warning for this emulation layer.
+            console.warn(`[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;
+        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) {
+            console.warn(`[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;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return super.write(chunk, encoding, cb);
+        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;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        super.end(chunk, encoding, cb);
+        if (encoding) {
+            super.end(chunk, encoding, cb);
+        }
+        else {
+            super.end(chunk, cb);
+        }
         return this;
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"honoNodeBridge.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/honoNodeBridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD,UAAU,GAAG,GAAG,CAAC;IACjB,OAAO,GAA+C,EAAE,CAAC;IAEzD;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,SAAS,CACP,UAAkB,EAClB,OAAoD;QAEpD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,KAAiC;QACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CACH,KAAc,EACd,kBAE+C,EAC/C,QAAoD;QAEpD,MAAM,QAAQ,GACZ,OAAO,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,MAAM,EAAE,GACN,OAAO,kBAAkB,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3E,8DAA8D;QAC9D,OAAO,KAAK,CAAC,KAAK,CAAC,KAAY,EAAE,QAAe,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,GAAG,CACD,KAAe,EACf,kBAAkD,EAClD,QAAqB;QAErB,MAAM,QAAQ,GACZ,OAAO,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,MAAM,EAAE,GACN,OAAO,kBAAkB,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3E,8DAA8D;QAC9D,KAAK,CAAC,GAAG,CAAC,KAAY,EAAE,QAAe,EAAE,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"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

@@ -1,9 +1,17 @@
 /**
- * @fileoverview Stateful Transport Manager implementation for MCP SDK.
- * This manager handles multiple, persistent sessions, creating a dedicated
- * McpServer and StreamableHTTPServerTransport instance for each one.
- * This version is adapted for Hono by bridging the SDK's Node.js-style
- * request handling with Hono's stream-based response model.
+ * @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 { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -12,21 +20,58 @@ import { RequestContext } from "../../../utils/index.js";
 import { BaseTransportManager } from "./baseTransportManager.js";
 import { StatefulTransportManager as IStatefulTransportManager, TransportResponse, TransportSession } from "./transportTypes.js";
 /**
- * Stateful Transport Manager that handles MCP SDK integration and session management
- * for a Hono-based HTTP server.
+ * 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;
-    constructor(createServerInstanceFn: () => Promise<McpServer>);
+    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.
+     */
     initializeAndHandle(headers: IncomingHttpHeaders, body: unknown, context: RequestContext): Promise<TransportResponse>;
+    /**
+     * Handles a subsequent request for an existing stateful session.
+     */
     handleRequest(headers: IncomingHttpHeaders, body: unknown, context: RequestContext, sessionId?: string): 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

@@ -1 +1 @@
-{"version":3,"file":"statefulTransportManager.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/statefulTransportManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,MAAM,CAAC;AAKhE,OAAO,EAGL,cAAc,EAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAEL,wBAAwB,IAAI,yBAAyB,EACrD,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;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;gBAEtC,sBAAsB,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC;IAYtD,mBAAmB,CACvB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;IA4EvB,aAAa,CACjB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAuEvB,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAiC7B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IASrD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAsBjB,YAAY;YA+CZ,oBAAoB;CAkCnC"}
+{"version":3,"file":"statefulTransportManager.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/statefulTransportManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,MAAM,CAAC;AAIhE,OAAO,EAGL,cAAc,EAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAEL,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;IAcnC;;;;;;;OAOG;IACG,mBAAmB,CACvB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAwG7B;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAgF7B;;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;IAgC1B;;OAEG;YACW,oBAAoB;CA8CnC"}