@cyanheads/pubmed-mcp-server 1.3.5 → 1.4.3

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

@@ -1,89 +1,138 @@
 /**
- * @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 { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { randomUUID } from "node:crypto";
 import { Readable } from "stream";
-import { config } from "../../../config/index.js";
 import { BaseErrorCode, McpError } from "../../../types-global/errors.js";
 import { ErrorHandler, logger, requestContextService, } from "../../../utils/index.js";
 import { BaseTransportManager } from "./baseTransportManager.js";
 import { HonoStreamResponse } from "./honoNodeBridge.js";
+import { convertNodeHeadersToWebHeaders } from "./headerUtils.js";
 /**
- * Stateful Transport Manager that handles MCP SDK integration and session management
- * for a Hono-based HTTP server.
+ * Manages persistent, stateful MCP sessions.
  */
 export class StatefulTransportManager extends BaseTransportManager {
     transports = new Map();
     servers = new Map();
     sessions = new Map();
     garbageCollector;
-    constructor(createServerInstanceFn) {
+    options;
+    /**
+     * @param createServerInstanceFn - A factory function to create new McpServer instances.
+     * @param options - Configuration options for the manager.
+     */
+    constructor(createServerInstanceFn, options) {
         super(createServerInstanceFn);
+        this.options = options;
         const context = requestContextService.createRequestContext({
             operation: "StatefulTransportManager.constructor",
         });
         logger.info("Starting session garbage collector.", context);
-        this.garbageCollector = setInterval(() => this.cleanupStaleSessions(), config.mcpStatefulSessionStaleTimeoutMs);
+        this.garbageCollector = setInterval(() => this.cleanupStaleSessions(), this.options.staleSessionTimeoutMs);
     }
+    /**
+     * 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.
+     */
     async initializeAndHandle(headers, body, context) {
-        const operationName = "StatefulTransportManager.initializeAndHandle";
-        const opContext = { ...context, operation: operationName };
+        const opContext = {
+            ...context,
+            operation: "StatefulTransportManager.initializeAndHandle",
+        };
         logger.debug("Initializing new stateful session.", opContext);
-        const server = await this.createServerInstanceFn();
-        const mockRes = new HonoStreamResponse();
-        const transport = new StreamableHTTPServerTransport({
-            sessionIdGenerator: () => randomUUID(),
-            onsessioninitialized: (sessionId) => {
-                const sessionContext = { ...opContext, sessionId };
-                this.transports.set(sessionId, transport);
-                this.servers.set(sessionId, server);
-                this.sessions.set(sessionId, {
-                    id: sessionId,
-                    createdAt: new Date(),
-                    lastAccessedAt: new Date(),
-                });
-                logger.info(`MCP Session created: ${sessionId}`, sessionContext);
-            },
-        });
-        transport.onclose = () => {
-            const sessionId = transport.sessionId;
-            if (sessionId) {
-                const closeContext = requestContextService.createRequestContext({
-                    operation: "StatefulTransportManager.transport.onclose",
-                    sessionId,
-                });
-                this.closeSession(sessionId, closeContext).catch((err) => logger.error(`Error during transport.onclose cleanup for session ${sessionId}`, err, closeContext));
+        let server;
+        let transport;
+        try {
+            server = await this.createServerInstanceFn();
+            const mockRes = new HonoStreamResponse();
+            const currentServer = server;
+            transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+                onsessioninitialized: (sessionId) => {
+                    const sessionContext = { ...opContext, sessionId };
+                    this.transports.set(sessionId, transport);
+                    this.servers.set(sessionId, currentServer);
+                    this.sessions.set(sessionId, {
+                        id: sessionId,
+                        createdAt: new Date(),
+                        lastAccessedAt: new Date(),
+                        activeRequests: 0,
+                    });
+                    logger.info(`MCP Session created: ${sessionId}`, sessionContext);
+                },
+            });
+            transport.onclose = () => {
+                const sessionId = transport.sessionId;
+                if (sessionId) {
+                    const closeContext = { ...opContext, sessionId };
+                    this.closeSession(sessionId, closeContext).catch((err) => logger.error(`Error during transport.onclose cleanup for session ${sessionId}`, err, closeContext));
+                }
+            };
+            await server.connect(transport);
+            logger.debug("Server connected, handling initial request.", opContext);
+            const mockReq = {
+                headers,
+                method: "POST",
+                url: this.options.mcpHttpEndpointPath,
+            };
+            await transport.handleRequest(mockReq, mockRes, body);
+            const responseHeaders = convertNodeHeadersToWebHeaders(mockRes.getHeaders());
+            if (transport.sessionId) {
+                responseHeaders.set("Mcp-Session-Id", transport.sessionId);
             }
-        };
-        await server.connect(transport);
-        logger.debug("Server connected to transport, handling initial request.", opContext);
-        const mockReq = {
-            headers,
-            method: "POST",
-            url: config.mcpHttpEndpointPath,
-        };
-        await transport.handleRequest(mockReq, mockRes, body);
-        const responseHeaders = new Headers();
-        for (const [key, value] of Object.entries(mockRes.getHeaders())) {
-            responseHeaders.set(key, Array.isArray(value) ? value.join(", ") : String(value));
+            const webStream = Readable.toWeb(mockRes);
+            return {
+                type: "stream",
+                headers: responseHeaders,
+                statusCode: mockRes.statusCode,
+                stream: webStream,
+                sessionId: transport.sessionId,
+            };
         }
-        if (transport.sessionId) {
-            responseHeaders.set("Mcp-Session-Id", transport.sessionId);
+        catch (error) {
+            logger.error("Failed to initialize stateful session. Cleaning up orphaned resources.", error instanceof Error ? error : undefined, { ...opContext, error: String(error) });
+            const sessionInitialized = transport?.sessionId && this.transports.has(transport.sessionId);
+            if (!sessionInitialized) {
+                (async () => {
+                    await ErrorHandler.tryCatch(async () => {
+                        if (transport)
+                            await transport.close();
+                        if (server)
+                            await server.close();
+                    }, {
+                        operation: "initializeAndHandle.cleanupOrphaned",
+                        context: opContext,
+                    });
+                })();
+            }
+            throw ErrorHandler.handleError(error, {
+                operation: opContext.operation,
+                context: opContext,
+                rethrow: true,
+            });
         }
-        const webStream = Readable.toWeb(mockRes);
-        return {
-            headers: responseHeaders,
-            statusCode: mockRes.statusCode,
-            stream: webStream,
-            sessionId: transport.sessionId,
-        };
     }
+    /**
+     * Handles a subsequent request for an existing stateful session.
+     */
     async handleRequest(headers, body, context, sessionId) {
         if (!sessionId) {
             throw new McpError(BaseErrorCode.INVALID_INPUT, "Session ID is required for stateful requests.", context);
@@ -93,14 +142,12 @@ export class StatefulTransportManager extends BaseTransportManager {
             sessionId,
             operation: "StatefulTransportManager.handleRequest",
         };
-        logger.debug(`Handling request for session: ${sessionId}`, {
-            ...sessionContext,
-            method: headers["x-forwarded-proto"] || "http",
-        });
         const transport = this.transports.get(sessionId);
-        if (!transport) {
+        const session = this.sessions.get(sessionId);
+        if (!transport || !session) {
             logger.warning(`Request for non-existent session: ${sessionId}`, sessionContext);
             return {
+                type: "buffered",
                 headers: new Headers({ "Content-Type": "application/json" }),
                 statusCode: 404,
                 body: {
@@ -109,29 +156,43 @@ export class StatefulTransportManager extends BaseTransportManager {
                 },
             };
         }
-        const session = this.sessions.get(sessionId);
-        if (session) {
-            session.lastAccessedAt = new Date();
-            logger.debug(`Updated lastAccessedAt for session ${sessionId}.`, sessionContext);
+        session.lastAccessedAt = new Date();
+        session.activeRequests += 1;
+        logger.debug(`Incremented activeRequests for session ${sessionId}. Count: ${session.activeRequests}`, sessionContext);
+        try {
+            const mockReq = {
+                headers,
+                method: "POST",
+                url: this.options.mcpHttpEndpointPath,
+            };
+            const mockRes = new HonoStreamResponse();
+            await transport.handleRequest(mockReq, mockRes, body);
+            const responseHeaders = convertNodeHeadersToWebHeaders(mockRes.getHeaders());
+            const webStream = Readable.toWeb(mockRes);
+            return {
+                type: "stream",
+                headers: responseHeaders,
+                statusCode: mockRes.statusCode,
+                stream: webStream,
+                sessionId: transport.sessionId,
+            };
         }
-        const mockReq = {
-            headers,
-            method: "POST",
-        };
-        const mockRes = new HonoStreamResponse();
-        await transport.handleRequest(mockReq, mockRes, body);
-        const responseHeaders = new Headers();
-        for (const [key, value] of Object.entries(mockRes.getHeaders())) {
-            responseHeaders.set(key, Array.isArray(value) ? value.join(", ") : String(value));
+        catch (error) {
+            throw ErrorHandler.handleError(error, {
+                operation: sessionContext.operation,
+                context: sessionContext,
+                rethrow: true,
+            });
+        }
+        finally {
+            session.activeRequests -= 1;
+            session.lastAccessedAt = new Date();
+            logger.debug(`Decremented activeRequests for session ${sessionId}. Count: ${session.activeRequests}`, sessionContext);
         }
-        const webStream = Readable.toWeb(mockRes);
-        return {
-            headers: responseHeaders,
-            statusCode: mockRes.statusCode,
-            stream: webStream,
-            sessionId: transport.sessionId,
-        };
     }
+    /**
+     * Handles a request to explicitly delete a session.
+     */
     async handleDeleteRequest(sessionId, context) {
         const sessionContext = {
             ...context,
@@ -139,28 +200,27 @@ export class StatefulTransportManager extends BaseTransportManager {
             operation: "StatefulTransportManager.handleDeleteRequest",
         };
         logger.info(`Attempting to delete session: ${sessionId}`, sessionContext);
-        const transport = this.transports.get(sessionId);
-        if (!transport) {
+        if (!this.transports.has(sessionId)) {
             logger.warning(`Attempted to delete non-existent session: ${sessionId}`, sessionContext);
             throw new McpError(BaseErrorCode.NOT_FOUND, "Session not found or expired.", sessionContext);
         }
         await this.closeSession(sessionId, sessionContext);
-        const headers = new Headers();
-        headers.set("Content-Type", "application/json");
         return {
-            headers,
+            type: "buffered",
+            headers: new Headers({ "Content-Type": "application/json" }),
             statusCode: 200,
             body: { status: "session_closed", sessionId },
         };
     }
+    /**
+     * Retrieves information about a specific session.
+     */
     getSession(sessionId) {
-        const context = requestContextService.createRequestContext({
-            operation: "StatefulTransportManager.getSession",
-            sessionId,
-        });
-        logger.debug(`Retrieving session: ${sessionId}`, context);
         return this.sessions.get(sessionId);
     }
+    /**
+     * Gracefully shuts down the manager, closing all active sessions.
+     */
     async shutdown() {
         const context = requestContextService.createRequestContext({
             operation: "StatefulTransportManager.shutdown",
@@ -169,14 +229,19 @@ export class StatefulTransportManager extends BaseTransportManager {
         clearInterval(this.garbageCollector);
         logger.debug("Garbage collector stopped.", context);
         const sessionIds = Array.from(this.transports.keys());
-        logger.info(`Closing ${sessionIds.length} active sessions.`, context);
-        const closePromises = sessionIds.map((sessionId) => this.closeSession(sessionId, context));
-        await Promise.all(closePromises);
+        if (sessionIds.length > 0) {
+            logger.info(`Closing ${sessionIds.length} active sessions.`, context);
+            const closePromises = sessionIds.map((sessionId) => this.closeSession(sessionId, context));
+            await Promise.all(closePromises);
+        }
         this.transports.clear();
         this.sessions.clear();
         this.servers.clear();
         logger.info("All active sessions closed and manager shut down.", context);
     }
+    /**
+     * Closes a single session and releases its associated resources.
+     */
     async closeSession(sessionId, context) {
         const sessionContext = {
             ...context,
@@ -187,45 +252,43 @@ export class StatefulTransportManager extends BaseTransportManager {
         const transport = this.transports.get(sessionId);
         const server = this.servers.get(sessionId);
         await ErrorHandler.tryCatch(async () => {
-            if (transport) {
+            if (transport)
                 await transport.close();
-                logger.debug(`Transport closed for session ${sessionId}.`, sessionContext);
-            }
-            if (server) {
+            if (server)
                 await server.close();
-                logger.debug(`Server instance closed for session ${sessionId}.`, sessionContext);
-            }
-        }, {
-            operation: "closeSession.cleanup",
-            context: sessionContext,
-        });
+        }, { operation: "closeSession.cleanup", context: sessionContext });
         this.transports.delete(sessionId);
         this.servers.delete(sessionId);
         this.sessions.delete(sessionId);
         logger.info(`MCP Session closed and resources released: ${sessionId}`, sessionContext);
     }
+    /**
+     * Periodically runs to find and clean up stale, inactive sessions.
+     */
     async cleanupStaleSessions() {
         const context = requestContextService.createRequestContext({
             operation: "StatefulTransportManager.cleanupStaleSessions",
         });
         logger.debug("Running stale session cleanup...", context);
         const now = Date.now();
-        const STALE_TIMEOUT_MS = config.mcpStatefulSessionStaleTimeoutMs;
-        let staleCount = 0;
+        const STALE_TIMEOUT_MS = this.options.staleSessionTimeoutMs;
+        const staleSessionIds = [];
         for (const [sessionId, session] of this.sessions.entries()) {
             if (now - session.lastAccessedAt.getTime() > STALE_TIMEOUT_MS) {
-                staleCount++;
-                const sessionContext = {
-                    ...context,
-                    sessionId,
-                    lastAccessed: session.lastAccessedAt.toISOString(),
-                };
-                logger.info(`Found stale session, closing: ${sessionId}`, sessionContext);
-                await this.closeSession(sessionId, sessionContext);
+                if (session.activeRequests > 0) {
+                    logger.info(`Session ${sessionId} is stale but has ${session.activeRequests} active requests. Skipping cleanup.`, { ...context, sessionId });
+                    continue;
+                }
+                staleSessionIds.push(sessionId);
             }
         }
-        if (staleCount > 0) {
-            logger.info(`Stale session cleanup complete. Closed ${staleCount} sessions.`, context);
+        if (staleSessionIds.length > 0) {
+            logger.info(`Found ${staleSessionIds.length} stale sessions. Closing concurrently.`, context);
+            const closePromises = staleSessionIds.map((sessionId) => this.closeSession(sessionId, context).catch((err) => {
+                logger.error(`Error during concurrent stale session cleanup for ${sessionId}`, err, { ...context, sessionId });
+            }));
+            await Promise.all(closePromises);
+            logger.info(`Stale session cleanup complete. Closed ${staleSessionIds.length} sessions.`, context);
         }
         else {
             logger.debug("No stale sessions found.", context);

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

@@ -1 +1 @@
-{"version":3,"file":"statefulTransportManager.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/statefulTransportManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EACL,YAAY,EACZ,MAAM,EAEN,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAQzD;;;GAGG;AACH,MAAM,OAAO,wBACX,SAAQ,oBAAoB;IAGX,UAAU,GAAG,IAAI,GAAG,EAGlC,CAAC;IACa,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IACvC,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC/C,gBAAgB,CAAiB;IAElD,YAAY,sBAAgD;QAC1D,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,sCAAsC;SAClD,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,CAAC,gBAAgB,GAAG,WAAW,CACjC,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,EACjC,MAAM,CAAC,gCAAgC,CACxC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,OAA4B,EAC5B,IAAa,EACb,OAAuB;QAEvB,MAAM,aAAa,GAAG,8CAA8C,CAAC;QACrE,MAAM,SAAS,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,SAAS,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,kBAAkB,EAA+B,CAAC;QAEtE,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;YAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;YACtC,oBAAoB,EAAE,CAAC,SAAS,EAAE,EAAE;gBAClC,MAAM,cAAc,GAAG,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,CAAC;gBACnD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE;oBAC3B,EAAE,EAAE,SAAS;oBACb,SAAS,EAAE,IAAI,IAAI,EAAE;oBACrB,cAAc,EAAE,IAAI,IAAI,EAAE;iBAC3B,CAAC,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,wBAAwB,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;YACnE,CAAC;SACF,CAAC,CAAC;QAEH,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;YACvB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;YACtC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,YAAY,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;oBAC9D,SAAS,EAAE,4CAA4C;oBACvD,SAAS;iBACV,CAAC,CAAC;gBACH,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACvD,MAAM,CAAC,KAAK,CACV,sDAAsD,SAAS,EAAE,EACjE,GAAG,EACH,YAAY,CACb,CACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CACV,0DAA0D,EAC1D,SAAS,CACV,CAAC;QAEF,MAAM,OAAO,GAAG;YACd,OAAO;YACP,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,MAAM,CAAC,mBAAmB;SACE,CAAC;QACpC,MAAM,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAEtD,MAAM,eAAe,GAAG,IAAI,OAAO,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;YAChE,eAAe,CAAC,GAAG,CACjB,GAAG,EACH,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACxD,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YACxB,eAAe,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAC9B,OAAwC,CACX,CAAC;QAEhC,OAAO;YACL,OAAO,EAAE,eAAe;YACxB,UAAU,EAAE,OAAO,CAAC,UAA4B;YAChD,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,SAAS,CAAC,SAAS;SAC/B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,OAA4B,EAC5B,IAAa,EACb,OAAuB,EACvB,SAAkB;QAElB,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CAChB,aAAa,CAAC,aAAa,EAC3B,+CAA+C,EAC/C,OAAO,CACR,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAAG;YACrB,GAAG,OAAO;YACV,SAAS;YACT,SAAS,EAAE,wCAAwC;SACpD,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,iCAAiC,SAAS,EAAE,EAAE;YACzD,GAAG,cAAc;YACjB,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI,MAAM;SAC/C,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,CACZ,qCAAqC,SAAS,EAAE,EAChD,cAAc,CACf,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,IAAI,OAAO,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;gBAC5D,UAAU,EAAE,GAAG;gBACf,IAAI,EAAE;oBACJ,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE;iBACtD;aACF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,cAAc,GAAG,IAAI,IAAI,EAAE,CAAC;YACpC,MAAM,CAAC,KAAK,CACV,sCAAsC,SAAS,GAAG,EAClD,cAAc,CACf,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG;YACd,OAAO;YACP,MAAM,EAAE,MAAM;SACmB,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,kBAAkB,EAA+B,CAAC;QAEtE,MAAM,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAEtD,MAAM,eAAe,GAAG,IAAI,OAAO,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;YAChE,eAAe,CAAC,GAAG,CACjB,GAAG,EACH,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACxD,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAC9B,OAAwC,CACX,CAAC;QAEhC,OAAO;YACL,OAAO,EAAE,eAAe;YACxB,UAAU,EAAE,OAAO,CAAC,UAA4B;YAChD,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,SAAS,CAAC,SAAS;SAC/B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,SAAiB,EACjB,OAAuB;QAEvB,MAAM,cAAc,GAAG;YACrB,GAAG,OAAO;YACV,SAAS;YACT,SAAS,EAAE,8CAA8C;SAC1D,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,iCAAiC,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;QAE1E,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,CACZ,6CAA6C,SAAS,EAAE,EACxD,cAAc,CACf,CAAC;YACF,MAAM,IAAI,QAAQ,CAChB,aAAa,CAAC,SAAS,EACvB,+BAA+B,EAC/B,cAAc,CACf,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAEnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAEhD,OAAO;YACL,OAAO;YACP,UAAU,EAAE,GAAqB;YACjC,IAAI,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,qCAAqC;YAChD,SAAS;SACV,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,uBAAuB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,mCAAmC;SAC/C,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,6CAA6C,EAAE,OAAO,CAAC,CAAC;QACpE,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC;QAEpD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,WAAW,UAAU,CAAC,MAAM,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAEtE,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACjD,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CACtC,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,mDAAmD,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,SAAiB,EACjB,OAAuB;QAEvB,MAAM,cAAc,GAAG;YACrB,GAAG,OAAO;YACV,SAAS;YACT,SAAS,EAAE,uCAAuC;SACnD,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,oBAAoB,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;QAE9D,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE3C,MAAM,YAAY,CAAC,QAAQ,CACzB,KAAK,IAAI,EAAE;YACT,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;gBACxB,MAAM,CAAC,KAAK,CACV,gCAAgC,SAAS,GAAG,EAC5C,cAAc,CACf,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACrB,MAAM,CAAC,KAAK,CACV,sCAAsC,SAAS,GAAG,EAClD,cAAc,CACf,CAAC;YACJ,CAAC;QACH,CAAC,EACD;YACE,SAAS,EAAE,sBAAsB;YACjC,OAAO,EAAE,cAAc;SACxB,CACF,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEhC,MAAM,CAAC,IAAI,CACT,8CAA8C,SAAS,EAAE,EACzD,cAAc,CACf,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,oBAAoB;QAChC,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,+CAA+C;SAC3D,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,OAAO,CAAC,CAAC;QAE1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,gBAAgB,GAAG,MAAM,CAAC,gCAAgC,CAAC;QACjE,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3D,IAAI,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAAC;gBAC9D,UAAU,EAAE,CAAC;gBACb,MAAM,cAAc,GAAG;oBACrB,GAAG,OAAO;oBACV,SAAS;oBACT,YAAY,EAAE,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE;iBACnD,CAAC;gBACF,MAAM,CAAC,IAAI,CACT,iCAAiC,SAAS,EAAE,EAC5C,cAAc,CACf,CAAC;gBACF,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QACD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CACT,0CAA0C,UAAU,YAAY,EAChE,OAAO,CACR,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"statefulTransportManager.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/statefulTransportManager.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,16 @@
 /**
- * @fileoverview Stateless Transport Manager implementation for MCP SDK.
- * This manager handles single-request operations without maintaining sessions.
- * Each request creates a temporary server instance that is cleaned up immediately.
- * 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 stateless transport manager for the MCP SDK.
+ *
+ * This manager handles single, ephemeral MCP operations. For each incoming request,
+ * it dynamically creates a temporary McpServer and transport instance, processes the
+ * request, and then immediately schedules the resources for cleanup. This approach
+ * is ideal for simple, one-off tool calls that do not require persistent session state.
+ *
+ * The key challenge addressed here is bridging the Node.js-centric MCP SDK with
+ * modern, Web Standards-based frameworks like Hono. This is achieved by deferring
+ * resource cleanup until the response stream has been fully consumed by the web
+ * framework, preventing premature closure and truncated responses.
+ *
  * @module src/mcp-server/transports/core/statelessTransportManager
  */
 import type { IncomingHttpHeaders } from "http";
@@ -11,11 +18,41 @@ import { RequestContext } from "../../../utils/index.js";
 import { BaseTransportManager } from "./baseTransportManager.js";
 import { TransportResponse } from "./transportTypes.js";
 /**
- * Stateless Transport Manager that handles ephemeral MCP operations.
+ * Manages ephemeral, single-request MCP operations.
  */
 export declare class StatelessTransportManager extends BaseTransportManager {
+    /**
+     * Handles a single, stateless MCP request.
+     *
+     * This method orchestrates the creation of temporary server and transport instances,
+     * handles the request, and ensures resources are cleaned up only after the
+     * response stream is closed.
+     *
+     * @param headers - The incoming request headers.
+     * @param body - The parsed body of the request.
+     * @param context - The request context for logging and tracing.
+     * @returns A promise resolving to a streaming TransportResponse.
+     */
     handleRequest(headers: IncomingHttpHeaders, body: unknown, context: RequestContext): Promise<TransportResponse>;
-    shutdown(): Promise<void>;
+    /**
+     * Attaches listeners to the response stream to trigger resource cleanup
+     * only after the stream has been fully consumed or has errored.
+     *
+     * @param stream - The response stream bridge.
+     * @param server - The ephemeral McpServer instance.
+     * @param transport - The ephemeral transport instance.
+     * @param context - The request context for logging.
+     */
+    private setupDeferredCleanup;
+    /**
+     * Performs the actual cleanup of ephemeral resources.
+     * This method is designed to be "fire-and-forget".
+     */
     private cleanup;
+    /**
+     * Shuts down the manager. For the stateless manager, this is a no-op
+     * as there are no persistent resources to manage.
+     */
+    shutdown(): Promise<void>;
 }
 //# sourceMappingURL=statelessTransportManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"statelessTransportManager.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/statelessTransportManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,MAAM,CAAC;AAEhE,OAAO,EAGL,cAAc,EAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAkB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExE;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,oBAAoB;IAC3D,aAAa,CACjB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAgEvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,OAAO,CAAC,OAAO;CAyBhB"}
+{"version":3,"file":"statelessTransportManager.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/statelessTransportManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,MAAM,CAAC;AAEhE,OAAO,EAGL,cAAc,EAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAkB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExE;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,oBAAoB;IACjE;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAoE7B;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;;OAGG;IACH,OAAO,CAAC,OAAO;IA0Bf;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAUhC"}