@ibm/ibmi-mcp-server 0.1.0

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

@@ -0,0 +1,326 @@
+/**
+ * @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 { JsonRpcErrorCode, McpError } from "../../../types-global/errors.js";
+import { ErrorHandler, logger, requestContextService, } from "../../../utils/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { randomUUID } from "node:crypto";
+import { Readable } from "stream";
+import { BaseTransportManager } from "./baseTransportManager.js";
+import { convertNodeHeadersToWebHeaders } from "./headerUtils.js";
+import { HonoStreamResponse } from "./honoNodeBridge.js";
+import { SessionState, // Import SessionState
+ } from "./transportTypes.js";
+/**
+ * Manages persistent, stateful MCP sessions.
+ */
+export class StatefulTransportManager extends BaseTransportManager {
+    transports = new Map();
+    servers = new Map();
+    sessions = new Map();
+    garbageCollector;
+    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(context, "Starting session garbage collector.");
+        const intervalMs = Math.max(10_000, Math.floor(this.options.staleSessionTimeoutMs / 2));
+        this.garbageCollector = setInterval(() => this.cleanupStaleSessions(), intervalMs);
+    }
+    /**
+     * 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
+     */
+    async initializeAndHandle(headers, body, context) {
+        const opContext = {
+            ...context,
+            operation: "StatefulTransportManager.initializeAndHandle",
+        };
+        logger.debug(opContext, "Initializing new stateful session.");
+        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,
+                        state: SessionState.ACTIVE, // Set initial state
+                        createdAt: new Date(),
+                        lastAccessedAt: new Date(),
+                        activeRequests: 0,
+                    });
+                    logger.info(sessionContext, `MCP Session created: ${sessionId}`);
+                },
+            });
+            transport.onclose = () => {
+                const sessionId = transport.sessionId;
+                if (sessionId) {
+                    const closeContext = { ...opContext, sessionId };
+                    this.closeSession(sessionId, closeContext).catch((err) => logger.error({ error: err, ...closeContext }, `Error during transport.onclose cleanup for session ${sessionId}`));
+                }
+            };
+            await server.connect(transport);
+            logger.debug(opContext, "Server connected, handling initial request.");
+            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);
+            }
+            const webStream = Readable.toWeb(mockRes);
+            return {
+                type: "stream",
+                headers: responseHeaders,
+                statusCode: mockRes.statusCode,
+                stream: webStream,
+                sessionId: transport.sessionId,
+            };
+        }
+        catch (error) {
+            logger.error({ ...opContext, error: error }, "Failed to initialize stateful session. Cleaning up orphaned resources.");
+            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,
+            });
+        }
+    }
+    /**
+     * 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.
+     */
+    async handleRequest(request) {
+        const { headers, body, context, sessionId } = request;
+        if (sessionId) {
+            const sessionContext = {
+                ...context,
+                sessionId,
+                operation: "StatefulTransportManager.handleRequest",
+            };
+            const transport = this.transports.get(sessionId);
+            const session = this.sessions.get(sessionId);
+            if (!transport || !session) {
+                logger.warning(sessionContext, `Request for non-existent session: ${sessionId}`);
+                return {
+                    type: "buffered",
+                    headers: new Headers({ "Content-Type": "application/json" }),
+                    statusCode: 404,
+                    body: {
+                        jsonrpc: "2.0",
+                        error: { code: -32601, message: "Session not found" },
+                    },
+                };
+            }
+            // Check session state before accepting the request
+            if (session.state === SessionState.CLOSING) {
+                logger.warning(sessionContext, `Request received for session in CLOSING state: ${sessionId}`);
+                throw new McpError(JsonRpcErrorCode.Conflict, // Use Conflict status
+                "Session is currently closing. Please start a new session.", sessionContext);
+            }
+            session.lastAccessedAt = new Date();
+            session.activeRequests += 1;
+            logger.debug(sessionContext, `Incremented activeRequests for session ${sessionId}. Count: ${session.activeRequests}`);
+            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,
+                };
+            }
+            catch (error) {
+                throw ErrorHandler.handleError(error, {
+                    operation: sessionContext.operation,
+                    context: sessionContext,
+                    rethrow: true,
+                });
+            }
+            finally {
+                session.activeRequests -= 1;
+                session.lastAccessedAt = new Date();
+                logger.debug(sessionContext, `Decremented activeRequests for session ${sessionId}. Count: ${session.activeRequests}`);
+            }
+        }
+        if (isInitializeRequest(body)) {
+            return this.initializeAndHandle(headers, body, context);
+        }
+        throw new McpError(JsonRpcErrorCode.InvalidRequest, "A session ID or an initialize request is required for stateful mode.", context);
+    }
+    /**
+     * Handles a request to explicitly delete a session.
+     */
+    async handleDeleteRequest(sessionId, context) {
+        const sessionContext = {
+            ...context,
+            sessionId,
+            operation: "StatefulTransportManager.handleDeleteRequest",
+        };
+        logger.info(sessionContext, `Attempting to delete session: ${sessionId}`);
+        if (!this.transports.has(sessionId)) {
+            logger.warning(sessionContext, `Attempted to delete non-existent session: ${sessionId}`);
+            throw new McpError(JsonRpcErrorCode.NotFound, "Session not found or expired.", sessionContext);
+        }
+        await this.closeSession(sessionId, sessionContext);
+        return {
+            type: "buffered",
+            headers: new Headers({ "Content-Type": "application/json" }),
+            statusCode: 200,
+            body: { status: "session_closed", sessionId },
+        };
+    }
+    /**
+     * Retrieves information about a specific session.
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Gracefully shuts down the manager, closing all active sessions.
+     */
+    async shutdown() {
+        const context = requestContextService.createRequestContext({
+            operation: "StatefulTransportManager.shutdown",
+        });
+        logger.info(context, "Shutting down stateful transport manager...");
+        clearInterval(this.garbageCollector);
+        logger.debug(context, "Garbage collector stopped.");
+        const sessionIds = Array.from(this.transports.keys());
+        if (sessionIds.length > 0) {
+            logger.info(context, `Closing ${sessionIds.length} active sessions.`);
+            const closePromises = sessionIds.map((sessionId) => this.closeSession(sessionId, context));
+            await Promise.all(closePromises);
+        }
+        this.transports.clear();
+        this.sessions.clear();
+        this.servers.clear();
+        logger.info(context, "All active sessions closed and manager shut down.");
+    }
+    /**
+     * Closes a single session and releases its associated resources.
+     */
+    async closeSession(sessionId, context) {
+        const sessionContext = {
+            ...context,
+            sessionId,
+            operation: "StatefulTransportManager.closeSession",
+        };
+        logger.debug(sessionContext, `Closing session: ${sessionId}`);
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return;
+        }
+        if (session.state === SessionState.CLOSING) {
+            logger.debug(sessionContext, `Session is already in CLOSING state.`);
+            return;
+        }
+        session.state = SessionState.CLOSING;
+        logger.debug(sessionContext, `Marking session ${sessionId} as CLOSING.`);
+        const transport = this.transports.get(sessionId);
+        const server = this.servers.get(sessionId);
+        await ErrorHandler.tryCatch(async () => {
+            if (transport)
+                await transport.close();
+            if (server)
+                await server.close();
+        }, { operation: "closeSession.cleanup", context: sessionContext });
+        this.transports.delete(sessionId);
+        this.servers.delete(sessionId);
+        this.sessions.delete(sessionId);
+        logger.info(sessionContext, `MCP Session closed and resources released: ${sessionId}`);
+    }
+    /**
+     * Periodically runs to find and clean up stale, inactive sessions.
+     */
+    async cleanupStaleSessions() {
+        const context = requestContextService.createRequestContext({
+            operation: "StatefulTransportManager.cleanupStaleSessions",
+        });
+        logger.debug(context, "Running stale session cleanup...");
+        const now = Date.now();
+        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) {
+                if (session.activeRequests > 0) {
+                    logger.info({ ...context, sessionId }, `Session ${sessionId} is stale but has ${session.activeRequests} active requests. Skipping cleanup.`);
+                    continue;
+                }
+                staleSessionIds.push(sessionId);
+            }
+        }
+        if (staleSessionIds.length > 0) {
+            logger.info(context, `Found ${staleSessionIds.length} stale sessions. Closing concurrently.`);
+            const closePromises = staleSessionIds.map((sessionId) => this.closeSession(sessionId, context).catch((err) => {
+                logger.error({ error: err, ...context, sessionId }, `Error during concurrent stale session cleanup for ${sessionId}`);
+            }));
+            await Promise.all(closePromises);
+            logger.info(context, `Stale session cleanup complete. Closed ${staleSessionIds.length} sessions.`);
+        }
+        else {
+            logger.debug(context, "No stale sessions found.");
+        }
+    }
+}
+//# sourceMappingURL=statefulTransportManager.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,57 @@
+/**
+ * @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 { BaseTransportManager } from "./baseTransportManager.js";
+import { McpTransportRequest } from "./transportRequest.js";
+import { TransportResponse } from "./transportTypes.js";
+/**
+ * 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, body, context, }: McpTransportRequest): Promise<TransportResponse>;
+    /**
+     * 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

@@ -0,0 +1 @@
+{"version":3,"file":"statelessTransportManager.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/statelessTransportManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAkB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExE;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,oBAAoB;IACjE;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,EAClB,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoEnD;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IA6B5B;;;OAGG;IACH,OAAO,CAAC,OAAO;IA0Bf;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAUhC"}

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

@@ -0,0 +1,151 @@
+/**
+ * @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 { ErrorHandler, logger, requestContextService, } from "../../../utils/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { Readable } from "stream";
+import { BaseTransportManager } from "./baseTransportManager.js";
+import { convertNodeHeadersToWebHeaders } from "./headerUtils.js";
+import { HonoStreamResponse } from "./honoNodeBridge.js";
+/**
+ * Manages ephemeral, single-request MCP operations.
+ */
+export 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.
+     */
+    async handleRequest({ headers, body, context, }) {
+        const opContext = {
+            ...context,
+            operation: "StatelessTransportManager.handleRequest",
+        };
+        logger.debug(opContext, "Creating ephemeral server instance for stateless request.");
+        let server;
+        let transport;
+        try {
+            // 1. Create ephemeral instances for this request.
+            server = await this.createServerInstanceFn();
+            transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined,
+                onsessioninitialized: undefined,
+            });
+            await server.connect(transport);
+            logger.debug(opContext, "Ephemeral server connected to transport.");
+            // 2. Set up the Node.js-to-Web stream bridge.
+            const mockReq = {
+                headers,
+                method: "POST",
+            };
+            const mockResBridge = new HonoStreamResponse();
+            // 3. Defer cleanup until the stream is fully processed.
+            // This is the critical fix to prevent premature resource release.
+            this.setupDeferredCleanup(mockResBridge, server, transport, opContext);
+            // 4. Process the request using the MCP transport.
+            const mockRes = mockResBridge;
+            await transport.handleRequest(mockReq, mockRes, body);
+            logger.info(opContext, "Stateless request handled successfully.");
+            // 5. Convert headers and create the final streaming response.
+            const responseHeaders = convertNodeHeadersToWebHeaders(mockRes.getHeaders());
+            const webStream = Readable.toWeb(mockResBridge);
+            return {
+                type: "stream",
+                headers: responseHeaders,
+                statusCode: mockRes.statusCode,
+                stream: webStream,
+            };
+        }
+        catch (error) {
+            // If an error occurs before the stream is returned, we must clean up immediately.
+            if (server || transport) {
+                this.cleanup(server, transport, opContext);
+            }
+            throw ErrorHandler.handleError(error, {
+                operation: "StatelessTransportManager.handleRequest",
+                context: opContext,
+                rethrow: true,
+            });
+        }
+    }
+    /**
+     * 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.
+     */
+    setupDeferredCleanup(stream, server, transport, context) {
+        let cleanedUp = false;
+        const cleanupFn = (error) => {
+            if (cleanedUp)
+                return;
+            cleanedUp = true;
+            if (error) {
+                logger.warning({
+                    ...context,
+                    error,
+                }, "Stream ended with an error, proceeding to cleanup.");
+            }
+            // Cleanup is fire-and-forget.
+            this.cleanup(server, transport, context);
+        };
+        // 'close' is the most reliable event, firing on both normal completion and abrupt termination.
+        stream.on("close", () => cleanupFn());
+        stream.on("error", (err) => cleanupFn(err));
+    }
+    /**
+     * Performs the actual cleanup of ephemeral resources.
+     * This method is designed to be "fire-and-forget".
+     */
+    cleanup(server, transport, context) {
+        const opContext = {
+            ...context,
+            operation: "StatelessTransportManager.cleanup",
+        };
+        logger.debug(opContext, "Scheduling cleanup for ephemeral resources.");
+        Promise.all([transport?.close(), server?.close()])
+            .then(() => {
+            logger.debug(opContext, "Ephemeral resources cleaned up successfully.");
+        })
+            .catch((cleanupError) => {
+            logger.warning({
+                ...opContext,
+                error: cleanupError,
+            }, "Error during stateless resource cleanup.");
+        });
+    }
+    /**
+     * Shuts down the manager. For the stateless manager, this is a no-op
+     * as there are no persistent resources to manage.
+     */
+    async shutdown() {
+        const context = requestContextService.createRequestContext({
+            operation: "StatelessTransportManager.shutdown",
+        });
+        logger.info(context, "Stateless transport manager shutdown - no persistent resources to clean up.");
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=statelessTransportManager.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { IncomingHttpHeaders } from "http";
+import type { RequestContext } from "../../../utils/index.js";
+export interface McpTransportRequest {
+    headers: IncomingHttpHeaders;
+    body: unknown;
+    context: RequestContext;
+    sessionId?: string;
+}
+//# sourceMappingURL=transportRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transportRequest.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/transportRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transportRequest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transportRequest.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/core/transportRequest.ts"],"names":[],"mappings":""}