mcp-server-framework 1.0.0

package/build/server/transport/sse/handler.js

@@ -0,0 +1,189 @@
+/**
+ * SSE Request Handler
+ *
+ * Manages SSE session lifecycle — connection setup, message routing,
+ * and cleanup. Parallel to the StreamableHttpTransport's role for
+ * the modern Streamable HTTP transport.
+ *
+ * This handler encapsulates all session management so the SSE router
+ * remains a thin routing layer.
+ *
+ * @module server/transport/sse/handler
+ */
+import { SseTransport } from "./transport.js";
+import { createJsonRpcError, JsonRpcErrorCode, HttpStatus, TransportErrorMessage } from "../../../errors/index.js";
+import { logger as baseLogger } from "../../../logger/index.js";
+import { TRANSPORT_LOG_COMPONENTS, SESSION_ID_DISPLAY_LENGTH } from "../constants.js";
+import { SESSION_CLOSE_REASONS } from "../../session/index.js";
+const logger = baseLogger.child({ component: TRANSPORT_LOG_COMPONENTS.SSE });
+/** @internal Log messages for SSE request handler */
+const LogMessages = {
+    // Connection lifecycle
+    SESSION_LIMIT_REACHED: "Session limit reached, rejecting SSE connection",
+    SESSION_CREATE_FAILED: "Failed to create SSE session (capacity reached)",
+    SESSION_CREATED: "SSE session created: %s",
+    SESSION_CLOSED: "SSE session closed: %s",
+    SESSION_CONNECTION_ERROR: "MCP session connection error for session %s: %s",
+    STREAM_CONNECTED: "SSE stream connected for session: %s",
+    CONNECTION_SETUP_ERROR: "Error setting up SSE connection: %s",
+    // Message handling
+    POST_REJECTED_NO_SESSION_PARAM: "SSE POST %s rejected: missing sessionId query param",
+    POST_REJECTED_SESSION_NOT_FOUND: "SSE POST %s rejected: session not found [%s]",
+    POST_MESSAGE: "SSE POST %s [%s] method=%s",
+    POST_ERROR: "Error handling SSE POST for session %s: %s",
+};
+// ============================================================================
+// SSE Request Handler
+// ============================================================================
+/**
+ * Handles SSE transport session lifecycle and message routing.
+ *
+ * Manages session creation, connection setup, and message dispatching
+ * for the legacy HTTP+SSE transport (deprecated protocol 2024-11-05).
+ */
+export class SseRequestHandler {
+    sessionFactory;
+    sessionManager;
+    constructor(sessionFactory, sessionManager) {
+        this.sessionFactory = sessionFactory;
+        this.sessionManager = sessionManager;
+    }
+    // ==========================================================================
+    // Connection Handler
+    // ==========================================================================
+    /**
+     * Handle an SSE connection (shared logic for /mcp and /sse endpoints).
+     *
+     * Creates an SSE stream and connects the MCP server to it.
+     * The messageEndpoint parameter determines where clients should POST messages to.
+     *
+     * Note: mcpServer.connect() automatically calls transport.start() internally,
+     * which sends the 'endpoint' SSE event with the message URL containing the sessionId.
+     *
+     * NOTE: This function requires real SSE connections for full test coverage.
+     */
+    /* v8 ignore start - SSE requires real SSE connections for testing */
+    async handleConnection(req, res, messageEndpoint) {
+        // Check session limits: global capacity AND per-transport (SSE) limit.
+        // Both checks must pass before starting the SSE stream to avoid sending
+        // SSE headers and then immediately rejecting the session in create().
+        if (!this.sessionManager.hasCapacity() || !this.sessionManager.hasCapacityForTransport("sse")) {
+            logger.warn(LogMessages.SESSION_LIMIT_REACHED);
+            res
+                .status(HttpStatus.SERVICE_UNAVAILABLE)
+                .json(createJsonRpcError(JsonRpcErrorCode.SERVER_ERROR, TransportErrorMessage.TOO_MANY_SESSIONS));
+            return;
+        }
+        try {
+            // Create our custom SSE transport
+            const transport = new SseTransport(messageEndpoint, res);
+            // Start the transport first (sends endpoint event with sessionId)
+            await transport.start();
+            // Get the sessionId that was sent to the client in the endpoint event
+            const sessionId = transport.sessionId;
+            // Create MCP session instance
+            const mcpSession = this.sessionFactory();
+            // IMPORTANT: Create unified session BEFORE connecting MCP session!
+            const session = this.sessionManager.create({
+                id: sessionId,
+                transportType: "sse",
+                transport,
+                mcpSession,
+            });
+            if (!session) {
+                logger.warn(LogMessages.SESSION_CREATE_FAILED);
+                // After transport.start(), SSE headers are already sent — cannot send JSON error.
+                // Close the transport; the client will detect the disconnection.
+                if (!res.headersSent) {
+                    res
+                        .status(HttpStatus.SERVICE_UNAVAILABLE)
+                        .json(createJsonRpcError(JsonRpcErrorCode.SERVER_ERROR, TransportErrorMessage.TOO_MANY_SESSIONS));
+                }
+                await transport.close();
+                return;
+            }
+            logger.debug(LogMessages.SESSION_CREATED, sessionId);
+            // Guard against duplicate close (transport.onclose + req.on('close') fire independently)
+            let closed = false;
+            const closeOnce = () => {
+                if (closed)
+                    return;
+                closed = true;
+                logger.debug(LogMessages.SESSION_CLOSED, sessionId);
+                void this.sessionManager.close(sessionId, SESSION_CLOSE_REASONS.CLIENT_DISCONNECT).catch((err) => {
+                    logger.warn("Error closing session on client disconnect: %s", err instanceof Error ? err.message : String(err));
+                });
+            };
+            // Handle cleanup when connection closes
+            transport.onclose = closeOnce;
+            // Also handle request close/error
+            req.on("close", closeOnce);
+            // Connect MCP session to transport
+            // Note: This is intentionally NOT awaited because connect() may block
+            // waiting for the initialize message from the client.
+            mcpSession.sdk.connect(transport).catch((err) => {
+                logger.error(LogMessages.SESSION_CONNECTION_ERROR, sessionId, err);
+                void this.sessionManager.close(sessionId, SESSION_CLOSE_REASONS.ERROR).catch((closeErr) => {
+                    logger.warn("Error closing session after connection failure: %s", closeErr instanceof Error ? closeErr.message : String(closeErr));
+                });
+            });
+            logger.debug(LogMessages.STREAM_CONNECTED, sessionId);
+        }
+        catch (error) {
+            logger.error(LogMessages.CONNECTION_SETUP_ERROR, error);
+            if (!res.headersSent) {
+                res
+                    .status(HttpStatus.INTERNAL_SERVER_ERROR)
+                    .json(createJsonRpcError(JsonRpcErrorCode.INTERNAL_ERROR, TransportErrorMessage.INTERNAL_ERROR));
+            }
+        }
+    }
+    /* v8 ignore stop */
+    // ==========================================================================
+    // Message Handler
+    // ==========================================================================
+    /**
+     * Handle an incoming POST message for an SSE session.
+     *
+     * Looks up the session by query parameter, validates it, and delegates
+     * the message to the session's SseTransport.
+     */
+    /* v8 ignore start - SSE session handling */
+    async handleMessage(req, res, endpoint) {
+        const rawSessionId = req.query.sessionId;
+        const sessionId = typeof rawSessionId === "string" ? rawSessionId : undefined;
+        if (!sessionId) {
+            logger.warn(LogMessages.POST_REJECTED_NO_SESSION_PARAM, endpoint);
+            res
+                .status(HttpStatus.BAD_REQUEST)
+                .json(createJsonRpcError(JsonRpcErrorCode.SERVER_ERROR, TransportErrorMessage.SESSION_ID_QUERY_REQUIRED));
+            return;
+        }
+        const session = this.sessionManager.get(sessionId);
+        if (!session || session.transport.type !== "sse") {
+            logger.warn(LogMessages.POST_REJECTED_SESSION_NOT_FOUND, endpoint, sessionId.substring(0, SESSION_ID_DISPLAY_LENGTH));
+            res
+                .status(HttpStatus.NOT_FOUND)
+                .json(createJsonRpcError(JsonRpcErrorCode.SESSION_NOT_FOUND, TransportErrorMessage.SESSION_NOT_FOUND));
+            return;
+        }
+        // Update session activity timestamp (idle timeout tracking)
+        this.sessionManager.touch(sessionId);
+        try {
+            const method = req.body?.method || "unknown";
+            logger.debug(LogMessages.POST_MESSAGE, endpoint, sessionId.substring(0, SESSION_ID_DISPLAY_LENGTH), method);
+            // @transport-downcast — Sessions in this handler are exclusively created with SSE transport
+            const transport = session.transport.instance;
+            await transport.handlePostMessage(req, res, req.body);
+        }
+        catch (error) {
+            logger.error(LogMessages.POST_ERROR, sessionId, error);
+            if (!res.headersSent) {
+                res
+                    .status(HttpStatus.INTERNAL_SERVER_ERROR)
+                    .json(createJsonRpcError(JsonRpcErrorCode.INTERNAL_ERROR, TransportErrorMessage.INTERNAL_ERROR));
+            }
+        }
+    }
+}
+//# sourceMappingURL=handler.js.map

package/build/server/transport/sse/handler.js.map

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

package/build/server/transport/sse/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SSE Transport Module
+ *
+ * Legacy HTTP+SSE Transport (deprecated protocol 2024-11-05)
+ * Still supported for backwards compatibility with older MCP clients.
+ *
+ * - **SseTransport** — Custom SSE transport implementation (SDK Transport interface)
+ * - **SseRequestHandler** — Session lifecycle and message routing
+ *
+ * @module server/transport/sse
+ */
+export { SseRequestHandler } from "./handler.js";
+export { SseTransport } from "./transport.js";
+export type { FlushableResponse } from "./transport.js";
+//# sourceMappingURL=index.d.ts.map

package/build/server/transport/sse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/transport/sse/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/build/server/transport/sse/index.js

@@ -0,0 +1,14 @@
+/**
+ * SSE Transport Module
+ *
+ * Legacy HTTP+SSE Transport (deprecated protocol 2024-11-05)
+ * Still supported for backwards compatibility with older MCP clients.
+ *
+ * - **SseTransport** — Custom SSE transport implementation (SDK Transport interface)
+ * - **SseRequestHandler** — Session lifecycle and message routing
+ *
+ * @module server/transport/sse
+ */
+export { SseRequestHandler } from "./handler.js";
+export { SseTransport } from "./transport.js";
+//# sourceMappingURL=index.js.map

package/build/server/transport/sse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/transport/sse/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/build/server/transport/sse/transport.d.ts

@@ -0,0 +1,94 @@
+/**
+ * SSE Transport Implementation
+ *
+ * This is a custom implementation of the deprecated HTTP+SSE transport
+ * from MCP protocol version 2024-11-05. It provides backwards compatibility
+ * for older MCP clients that don't support the modern Streamable HTTP transport.
+ *
+ * Protocol Flow:
+ * 1. Client connects via GET to SSE endpoint
+ * 2. Server sends 'endpoint' event with URL for POSTing messages (includes sessionId)
+ * 3. Client POSTs JSON-RPC messages to that URL
+ * 4. Server responds via the SSE stream
+ *
+ * This replaces the deprecated SSEServerTransport from @modelcontextprotocol/sdk
+ * with a clean, maintainable implementation.
+ *
+ * @module server/transport/sse/transport
+ */
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
+import type { Response, Request } from "express";
+/**
+ * Response object that may have a flush method added by middleware.
+ * Some Express middleware (like compression) add this method.
+ */
+export interface FlushableResponse extends Response {
+    flush?: () => void;
+}
+/**
+ * Custom SSE Transport for backwards compatibility with MCP 2024-11-05 clients.
+ *
+ * Implements the Transport interface from the MCP SDK without using
+ * the deprecated SSEServerTransport class.
+ */
+export declare class SseTransport implements Transport {
+    private _sessionId;
+    private _res;
+    private _messageEndpoint;
+    private _started;
+    private _closed;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: (message: JSONRPCMessage) => void;
+    /**
+     * Creates a new SSE Transport
+     *
+     * @param messageEndpoint - The endpoint path where clients should POST messages
+     *                          (e.g., '/mcp/message' or '/sse/message')
+     * @param res - Express Response object for the SSE stream
+     */
+    constructor(messageEndpoint: string, res: Response);
+    /**
+     * Get the session ID for this transport
+     */
+    get sessionId(): string;
+    /**
+     * Start the SSE transport.
+     *
+     * Sets up SSE headers and sends the 'endpoint' event with the message URL.
+     * This method is idempotent - calling it multiple times has no effect after
+     * the first call. This is necessary because mcpServer.connect() calls start()
+     * internally, but we need to call it before connect() to send the endpoint event.
+     */
+    start(): Promise<void>;
+    /**
+     * Send a JSON-RPC message to the client via SSE
+     */
+    send(message: JSONRPCMessage): Promise<void>;
+    /**
+     * Close the transport
+     */
+    close(): Promise<void>;
+    /**
+     * Handle an incoming POST message from the client.
+     *
+     * This should be called by the Express route handler when a POST
+     * is received at the message endpoint.
+     *
+     * @param req - Express Request object
+     * @param res - Express Response object for the POST response
+     * @param body - Parsed JSON-RPC message body
+     */
+    handlePostMessage(req: Request, res: Response, body: JSONRPCMessage): Promise<void>;
+    /**
+     * Send an SSE event to the client
+     */
+    private _sendSseEvent;
+    /**
+     * Flushes the response buffer if the response supports it.
+     * Some middleware (like compression) add a flush method to the response.
+     */
+    private _flushResponse;
+}
+//# sourceMappingURL=transport.d.ts.map

package/build/server/transport/sse/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/server/transport/sse/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMjD;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAUD;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAE9C;;;;;;OAMG;gBACS,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ;IAMlD;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;;;;;;;;OASG;IACG,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BzF;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAOvB"}

package/build/server/transport/sse/transport.js

@@ -0,0 +1,175 @@
+/**
+ * SSE Transport Implementation
+ *
+ * This is a custom implementation of the deprecated HTTP+SSE transport
+ * from MCP protocol version 2024-11-05. It provides backwards compatibility
+ * for older MCP clients that don't support the modern Streamable HTTP transport.
+ *
+ * Protocol Flow:
+ * 1. Client connects via GET to SSE endpoint
+ * 2. Server sends 'endpoint' event with URL for POSTing messages (includes sessionId)
+ * 3. Client POSTs JSON-RPC messages to that URL
+ * 4. Server responds via the SSE stream
+ *
+ * This replaces the deprecated SSEServerTransport from @modelcontextprotocol/sdk
+ * with a clean, maintainable implementation.
+ *
+ * @module server/transport/sse/transport
+ */
+import { randomUUID } from "node:crypto";
+import { HttpStatus, TransportError, TransportErrorMessage } from "../../../errors/index.js";
+import { logger as baseLogger } from "../../../logger/index.js";
+import { TRANSPORT_LOG_COMPONENTS, SSE_EVENTS, SESSION_ID_DISPLAY_LENGTH } from "../constants.js";
+const logger = baseLogger.child({ component: TRANSPORT_LOG_COMPONENTS.SSE });
+/** @internal Log messages for SSE transport */
+const LogMessages = {
+    MESSAGE_REJECTED_CLOSED: "Message rejected: transport closed (session=%s)",
+    MESSAGE_PROCESSING_ERROR: "Error processing message (session=%s): %s",
+};
+/**
+ * Custom SSE Transport for backwards compatibility with MCP 2024-11-05 clients.
+ *
+ * Implements the Transport interface from the MCP SDK without using
+ * the deprecated SSEServerTransport class.
+ */
+export class SseTransport {
+    _sessionId;
+    _res;
+    _messageEndpoint;
+    _started = false;
+    _closed = false;
+    onclose;
+    onerror;
+    onmessage;
+    /**
+     * Creates a new SSE Transport
+     *
+     * @param messageEndpoint - The endpoint path where clients should POST messages
+     *                          (e.g., '/mcp/message' or '/sse/message')
+     * @param res - Express Response object for the SSE stream
+     */
+    constructor(messageEndpoint, res) {
+        this._sessionId = randomUUID();
+        this._messageEndpoint = messageEndpoint;
+        this._res = res;
+    }
+    /**
+     * Get the session ID for this transport
+     */
+    get sessionId() {
+        return this._sessionId;
+    }
+    /**
+     * Start the SSE transport.
+     *
+     * Sets up SSE headers and sends the 'endpoint' event with the message URL.
+     * This method is idempotent - calling it multiple times has no effect after
+     * the first call. This is necessary because mcpServer.connect() calls start()
+     * internally, but we need to call it before connect() to send the endpoint event.
+     */
+    async start() {
+        // Idempotent: if already started, just return silently
+        // This is needed because mcpServer.connect() calls start() internally
+        if (this._started) {
+            return;
+        }
+        if (this._closed) {
+            throw TransportError.closed();
+        }
+        this._started = true;
+        // Set SSE headers
+        this._res.setHeader("Content-Type", "text/event-stream");
+        this._res.setHeader("Cache-Control", "no-cache, no-transform");
+        this._res.setHeader("Connection", "keep-alive");
+        this._res.setHeader("X-Accel-Buffering", "no"); // Disable nginx buffering
+        this._res.flushHeaders();
+        // Send the endpoint event with the message URL
+        // This tells the client where to POST messages
+        const query = new URLSearchParams({ sessionId: this._sessionId });
+        const endpointUrl = `${this._messageEndpoint}?${query.toString()}`;
+        this._sendSseEvent(SSE_EVENTS.ENDPOINT, endpointUrl);
+    }
+    /**
+     * Send a JSON-RPC message to the client via SSE
+     */
+    async send(message) {
+        if (this._closed) {
+            throw TransportError.closed();
+        }
+        if (!this._started) {
+            throw TransportError.notStarted();
+        }
+        this._sendSseEvent(SSE_EVENTS.MESSAGE, JSON.stringify(message));
+    }
+    /**
+     * Close the transport
+     */
+    async close() {
+        if (this._closed)
+            return;
+        this._closed = true;
+        // End the SSE stream
+        if (!this._res.writableEnded) {
+            this._res.end();
+        }
+        this.onclose?.();
+    }
+    /**
+     * Handle an incoming POST message from the client.
+     *
+     * This should be called by the Express route handler when a POST
+     * is received at the message endpoint.
+     *
+     * @param req - Express Request object
+     * @param res - Express Response object for the POST response
+     * @param body - Parsed JSON-RPC message body
+     */
+    async handlePostMessage(req, res, body) {
+        if (this._closed) {
+            logger.warn(LogMessages.MESSAGE_REJECTED_CLOSED, this._sessionId.substring(0, SESSION_ID_DISPLAY_LENGTH));
+            res.status(HttpStatus.BAD_REQUEST).json({ error: TransportErrorMessage.TRANSPORT_CLOSED });
+            return;
+        }
+        // Notify the MCP server of the incoming message
+        try {
+            this.onmessage?.(body);
+            // For requests (with id), send 202 Accepted - response will come via SSE
+            // For notifications (no id), send 204 No Content
+            if ("id" in body && body.id !== undefined) {
+                res.status(HttpStatus.ACCEPTED).json({ status: "accepted" });
+            }
+            else {
+                res.status(HttpStatus.NO_CONTENT).end();
+            }
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            logger.error(LogMessages.MESSAGE_PROCESSING_ERROR, this._sessionId.substring(0, SESSION_ID_DISPLAY_LENGTH), err.message);
+            this.onerror?.(err);
+            res.status(HttpStatus.INTERNAL_SERVER_ERROR).json({ error: TransportErrorMessage.INTERNAL_ERROR });
+        }
+    }
+    /**
+     * Send an SSE event to the client
+     */
+    _sendSseEvent(event, data) {
+        if (this._res.writableEnded)
+            return;
+        this._res.write(`event: ${event}\n`);
+        this._res.write(`data: ${data}\n\n`);
+        // Flush to ensure immediate delivery (some Express middleware add flush)
+        this._flushResponse();
+    }
+    /**
+     * Flushes the response buffer if the response supports it.
+     * Some middleware (like compression) add a flush method to the response.
+     */
+    _flushResponse() {
+        // @express-api — Compression middleware adds flush() at runtime; not in Express Response type
+        const res = this._res;
+        if (typeof res.flush === "function") {
+            res.flush();
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/build/server/transport/sse/transport.js.map

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

package/build/server/transport/stdio-transport.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Stdio Transport
+ *
+ * Starts a stdio transport for single-client CLI usage.
+ * Creates one McpSession, registers it with the SessionManager,
+ * and connects it to stdin/stdout.
+ *
+ * @module server/transport/stdio-transport
+ */
+import type { TransportHandle, SessionFactory } from "./types.js";
+import type { SessionManager } from "../session/index.js";
+/**
+ * Starts a stdio transport for single-client CLI usage.
+ *
+ * Creates a single McpSession, registers it with the SessionManager,
+ * and connects it to stdin/stdout via the SDK's StdioServerTransport.
+ *
+ * @param sessionFactory - Factory to create McpSession instances
+ * @param sessionManager - Session manager for lifecycle tracking
+ * @returns TransportHandle for shutdown and runtime info
+ */
+export declare function startStdioTransport(sessionFactory: SessionFactory, sessionManager: SessionManager): Promise<TransportHandle>;
+//# sourceMappingURL=stdio-transport.d.ts.map

package/build/server/transport/stdio-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-transport.d.ts","sourceRoot":"","sources":["../../../src/server/transport/stdio-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAc1D;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,eAAe,CAAC,CAkC1B"}

package/build/server/transport/stdio-transport.js

@@ -0,0 +1,59 @@
+/**
+ * Stdio Transport
+ *
+ * Starts a stdio transport for single-client CLI usage.
+ * Creates one McpSession, registers it with the SessionManager,
+ * and connects it to stdin/stdout.
+ *
+ * @module server/transport/stdio-transport
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { logger as baseLogger } from "../../logger/index.js";
+const logger = baseLogger.child({ component: "StdioTransport" });
+const LogMessages = {
+    CONNECTING: "Connecting stdio transport...",
+    CONNECTED: "Stdio transport connected",
+};
+// ============================================================================
+// Stdio Transport Function
+// ============================================================================
+/**
+ * Starts a stdio transport for single-client CLI usage.
+ *
+ * Creates a single McpSession, registers it with the SessionManager,
+ * and connects it to stdin/stdout via the SDK's StdioServerTransport.
+ *
+ * @param sessionFactory - Factory to create McpSession instances
+ * @param sessionManager - Session manager for lifecycle tracking
+ * @returns TransportHandle for shutdown and runtime info
+ */
+export async function startStdioTransport(sessionFactory, sessionManager) {
+    logger.debug(LogMessages.CONNECTING);
+    const startedAt = new Date();
+    const session = sessionFactory();
+    const transport = new StdioServerTransport();
+    const created = sessionManager.create({
+        transportType: "stdio",
+        transport,
+        mcpSession: session,
+    });
+    if (!created) {
+        throw new Error("Failed to create stdio session — session capacity reached");
+    }
+    await session.sdk.connect(transport);
+    logger.debug(LogMessages.CONNECTED);
+    return {
+        async shutdown() {
+            // No transport-level resources to close for stdio.
+            // Session cleanup is handled by McpServerInstance.stop().
+        },
+        info() {
+            return {
+                state: "running",
+                startedAt,
+                mode: "stdio",
+            };
+        },
+    };
+}
+//# sourceMappingURL=stdio-transport.js.map

package/build/server/transport/stdio-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-transport.js","sourceRoot":"","sources":["../../../src/server/transport/stdio-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAIjF,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAEjE,MAAM,WAAW,GAAG;IAClB,UAAU,EAAE,+BAA+B;IAC3C,SAAS,EAAE,2BAA2B;CAC9B,CAAC;AAEX,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,cAA8B,EAC9B,cAA8B;IAE9B,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAErC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC;QACpC,aAAa,EAAE,OAAO;QACtB,SAAS;QACT,UAAU,EAAE,OAAO;KACpB,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAEpC,OAAO;QACL,KAAK,CAAC,QAAQ;YACZ,mDAAmD;YACnD,0DAA0D;QAC5D,CAAC;QAED,IAAI;YACF,OAAO;gBACL,KAAK,EAAE,SAAS;gBAChB,SAAS;gBACT,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/build/server/transport/streamable-http/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Streamable HTTP Transport
+ *
+ * MCP Streamable HTTP Transport implementation (2025-03-26 specification).
+ *
+ * @module server/transport/streamable-http
+ */
+export { StreamableHttpTransport, type StreamableHttpTransportOptions } from "./transport.js";
+//# sourceMappingURL=index.d.ts.map

package/build/server/transport/streamable-http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/transport/streamable-http/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,KAAK,8BAA8B,EAAE,MAAM,gBAAgB,CAAC"}

package/build/server/transport/streamable-http/index.js

@@ -0,0 +1,9 @@
+/**
+ * Streamable HTTP Transport
+ *
+ * MCP Streamable HTTP Transport implementation (2025-03-26 specification).
+ *
+ * @module server/transport/streamable-http
+ */
+export { StreamableHttpTransport } from "./transport.js";
+//# sourceMappingURL=index.js.map

package/build/server/transport/streamable-http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/transport/streamable-http/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAuC,MAAM,gBAAgB,CAAC"}