@llmindset/hf-mcp-server 0.1.16

package/dist/server/transport/sse-transport.d.ts

@@ -0,0 +1,17 @@
+import { StatefulTransport, type TransportOptions, type BaseSession } from './base-transport.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+interface SSEConnection extends BaseSession<SSEServerTransport> {
+    cleanup: () => Promise<void>;
+}
+export declare class SseTransport extends StatefulTransport<SSEConnection> {
+    initialize(_options: TransportOptions): Promise<void>;
+    private handleSseConnection;
+    private handleSseMessage;
+    private createCleanupFunction;
+    private connectWithCleanup;
+    protected removeStaleSession(sessionId: string): Promise<void>;
+    cleanup(): Promise<void>;
+    closeConnection(sessionId: string): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=sse-transport.d.ts.map

package/dist/server/transport/sse-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-transport.d.ts","sourceRoot":"","sources":["../../../src/server/transport/sse-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAO7E,UAAU,aAAc,SAAQ,WAAW,CAAC,kBAAkB,CAAC;IAC9D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,qBAAa,YAAa,SAAQ,iBAAiB,CAAC,aAAa,CAAC;IAC3D,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YA0B7C,mBAAmB;YAyFnB,gBAAgB;IAwD9B,OAAO,CAAC,qBAAqB;YAIf,kBAAkB;cAsBhB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBxB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAe1D"}

package/dist/server/transport/sse-transport.js

@@ -0,0 +1,170 @@
+import { StatefulTransport } from './base-transport.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { logger } from '../lib/logger.js';
+import { JsonRpcErrors, extractJsonRpcId } from './json-rpc-errors.js';
+import { extractQueryParamsToHeaders } from '../utils/query-params.js';
+export class SseTransport extends StatefulTransport {
+    async initialize(_options) {
+        this.app.get('/sse', (req, res) => {
+            this.trackRequest();
+            void this.handleSseConnection(req, res);
+        });
+        this.app.post('/message', (req, res) => {
+            this.trackRequest();
+            void this.handleSseMessage(req, res);
+        });
+        this.startStaleConnectionCheck();
+        this.startPingKeepAlive();
+        logger.info('SSE transport routes initialized', {
+            heartbeatInterval: this.HEARTBEAT_INTERVAL,
+            staleCheckInterval: this.STALE_CHECK_INTERVAL,
+            staleTimeout: this.STALE_TIMEOUT,
+            pingEnabled: this.PING_ENABLED,
+            pingInterval: this.PING_INTERVAL,
+        });
+        return Promise.resolve();
+    }
+    async handleSseConnection(req, res) {
+        try {
+            if (this.isShuttingDown) {
+                logger.warn('Rejecting SSE connection during shutdown');
+                this.trackError(503);
+                res.status(503).json(JsonRpcErrors.serverShuttingDown());
+                return;
+            }
+            const existingSessionId = req.query.sessionId;
+            if (existingSessionId) {
+                const existing = this.sessions.get(existingSessionId);
+                if (existing) {
+                    logger.warn({
+                        sessionId: existingSessionId,
+                        age: Date.now() - existing.metadata.connectedAt.getTime(),
+                    }, 'Client attempting to reconnect with existing sessionId');
+                    await this.closeConnection(existingSessionId);
+                }
+            }
+            const headers = req.headers;
+            extractQueryParamsToHeaders(req, headers);
+            const authResult = await this.validateAuthAndTrackMetrics(headers);
+            if (!authResult.shouldContinue) {
+                this.trackError(authResult.statusCode);
+                res.status(authResult.statusCode || 401).send('Unauthorized');
+                return;
+            }
+            const server = await this.serverFactory(headers);
+            const transport = new SSEServerTransport('/message', res);
+            const sessionId = transport.sessionId;
+            logger.info({ sessionId }, 'New SSE connection established');
+            const cleanup = this.createCleanupFunction(sessionId);
+            const connection = {
+                transport,
+                server,
+                cleanup,
+                metadata: {
+                    id: sessionId,
+                    connectedAt: new Date(),
+                    lastActivity: new Date(),
+                    requestCount: 0,
+                    capabilities: {},
+                },
+            };
+            this.sessions.set(sessionId, connection);
+            this.trackSessionCreated(sessionId);
+            this.startHeartbeat(sessionId, res);
+            this.setupSseEventHandlers(sessionId, res);
+            await this.connectWithCleanup(transport, server, sessionId, cleanup);
+            logger.debug({ sessionId }, 'SSE transport fully initialized');
+        }
+        catch (error) {
+            logger.error({ error }, 'Error establishing SSE connection');
+            this.trackError(500, error instanceof Error ? error : new Error(String(error)));
+            if (!res.headersSent) {
+                res.status(500).json(JsonRpcErrors.internalError(null, 'Internal server error establishing SSE connection'));
+            }
+        }
+    }
+    async handleSseMessage(req, res) {
+        const trackingName = this.extractMethodForTracking(req.body);
+        try {
+            const sessionId = req.query.sessionId;
+            if (!sessionId) {
+                logger.warn('SSE message received without sessionId');
+                this.trackError(400);
+                this.metrics.trackMethod(trackingName, undefined, true);
+                res.status(400).json(JsonRpcErrors.invalidParams('sessionId is required', extractJsonRpcId(req.body)));
+                return;
+            }
+            const connection = this.sessions.get(sessionId);
+            if (!connection) {
+                logger.warn({ sessionId }, 'SSE message for unknown session');
+                this.trackError(404);
+                this.metrics.trackMethod(trackingName, undefined, true);
+                res.status(404).json(JsonRpcErrors.sessionNotFound(sessionId, extractJsonRpcId(req.body)));
+                return;
+            }
+            this.updateSessionActivity(sessionId);
+            if (trackingName) {
+                const session = this.sessions.get(sessionId);
+                if (session) {
+                    session.metadata.requestCount++;
+                }
+            }
+            await connection.transport.handlePostMessage(req, res, req.body);
+            this.metrics.trackMethod(trackingName, undefined, false);
+            logger.debug({ sessionId }, 'SSE message handled successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Error handling SSE message');
+            this.trackError(500, error instanceof Error ? error : new Error(String(error)));
+            this.metrics.trackMethod(trackingName, undefined, true);
+            if (!res.headersSent) {
+                res
+                    .status(500)
+                    .json(JsonRpcErrors.internalError(extractJsonRpcId(req.body), 'Internal server error handling SSE message'));
+            }
+        }
+    }
+    createCleanupFunction(sessionId) {
+        return () => this.cleanupSession(sessionId);
+    }
+    async connectWithCleanup(transport, server, sessionId, cleanup) {
+        try {
+            this.setupServerForSession(server, sessionId);
+            await server.connect(transport);
+        }
+        catch (error) {
+            logger.error({ error, sessionId }, 'Failed to connect transport to server');
+            this.trackError(500, error instanceof Error ? error : new Error(String(error)));
+            await cleanup();
+            throw error;
+        }
+    }
+    async removeStaleSession(sessionId) {
+        logger.info({ sessionId }, 'Removing stale SSE connection');
+        await this.cleanupSession(sessionId);
+    }
+    async cleanup() {
+        logger.info({
+            activeConnections: this.sessions.size,
+        }, 'Starting SSE transport cleanup');
+        this.stopStaleConnectionCheck();
+        await this.cleanupAllSessions();
+        logger.info('SSE transport cleanup completed');
+    }
+    async closeConnection(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            logger.debug({ sessionId }, 'Attempted to close non-existent connection');
+            return false;
+        }
+        try {
+            await this.cleanupSession(sessionId);
+            return true;
+        }
+        catch (error) {
+            logger.error({ error, sessionId }, 'Error closing connection');
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=sse-transport.js.map

package/dist/server/transport/sse-transport.js.map

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

package/dist/server/transport/stateless-http-transport.d.ts

@@ -0,0 +1,11 @@
+import { BaseTransport, type TransportOptions, type SessionMetadata } from './base-transport.js';
+export declare class StatelessHttpTransport extends BaseTransport {
+    private shouldHandle;
+    initialize(_options: TransportOptions): Promise<void>;
+    private handleJsonRpcRequest;
+    shutdown(): void;
+    cleanup(): Promise<void>;
+    getActiveConnectionCount(): number;
+    getSessions(): SessionMetadata[];
+}
+//# sourceMappingURL=stateless-http-transport.d.ts.map

package/dist/server/transport/stateless-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-http-transport.d.ts","sourceRoot":"","sources":["../../../src/server/transport/stateless-http-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAkB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAmBjH,qBAAa,sBAAuB,SAAQ,aAAa;IAKxD,OAAO,CAAC,YAAY;IAuBpB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YAqDvC,oBAAoB;IAiJzB,QAAQ,IAAI,IAAI;IAKzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxB,wBAAwB,IAAI,MAAM;IAQzB,WAAW,IAAI,eAAe,EAAE;CAIzC"}

package/dist/server/transport/stateless-http-transport.js

@@ -0,0 +1,172 @@
+import { BaseTransport, STATELESS_MODE } from './base-transport.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { logger } from '../lib/logger.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { JsonRpcErrors, extractJsonRpcId } from './json-rpc-errors.js';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { isJSONRPCNotification } from '@modelcontextprotocol/sdk/types.js';
+import { extractQueryParamsToHeaders } from '../utils/query-params.js';
+import { isBrowser } from '../utils/browser-detection.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export class StatelessHttpTransport extends BaseTransport {
+    shouldHandle(requestBody) {
+        const body = requestBody;
+        const method = body?.method;
+        if (method === 'tools/list' || method === 'tools/call') {
+            return true;
+        }
+        if (method === 'prompts/list' || method === 'prompts/get') {
+            return true;
+        }
+        if (method === 'initialize') {
+            return true;
+        }
+        return false;
+    }
+    initialize(_options) {
+        this.app.post('/mcp', (req, res) => {
+            this.trackRequest();
+            void this.handleJsonRpcRequest(req, res);
+        });
+        this.app.get('/mcp', (req, res) => {
+            if (process.env.MCP_STRICT_COMPLIANCE === 'true' || !isBrowser(req.headers)) {
+                this.metrics.trackStaticPageHit(405);
+                logger.debug('Rejected GET request to /mcp in strict compliance mode or from non-browser client');
+                res
+                    .status(405)
+                    .json(JsonRpcErrors.methodNotAllowed(null, 'Method not allowed. Use POST for stateless JSON-RPC requests.'));
+                return;
+            }
+            const isSecure = req.secure || req.headers['x-forwarded-proto'] === 'https';
+            const host = req.get('host') || '';
+            const isLocalhost = host === 'localhost' || host.startsWith('localhost:') || host === '127.0.0.1' || host.startsWith('127.0.0.1:');
+            if (!isSecure && !isLocalhost) {
+                const httpsUrl = `https://${host}${req.originalUrl}`;
+                logger.debug(`Redirecting insecure request to HTTPS: ${httpsUrl}`);
+                res.redirect(301, httpsUrl);
+                return;
+            }
+            this.metrics.trackStaticPageHit(200);
+            const mcpWelcomePath = path.join(__dirname, '..', '..', 'web', 'mcp-welcome.html');
+            res.sendFile(mcpWelcomePath);
+        });
+        this.app.delete('/mcp', (_req, res) => {
+            this.trackRequest();
+            this.trackError(405);
+            logger.warn('Rejected DELETE request to /mcp in stateless mode');
+            res
+                .status(405)
+                .json(JsonRpcErrors.methodNotAllowed(null, 'Method not allowed. Use POST for stateless JSON-RPC requests.'));
+        });
+        logger.info('HTTP JSON transport initialized (stateless mode)');
+        return Promise.resolve();
+    }
+    async handleJsonRpcRequest(req, res) {
+        const startTime = Date.now();
+        let server = null;
+        let transport = null;
+        const headers = req.headers;
+        extractQueryParamsToHeaders(req, headers);
+        const requestBody = req.body;
+        const trackingName = this.extractMethodForTracking(requestBody);
+        const authResult = await this.validateAuthAndTrackMetrics(headers);
+        if (!authResult.shouldContinue || trackingName === 'tools/call:Authenticate') {
+            res.set('WWW-Authenticate', 'Bearer resource_metadata="https://huggingface.co/.well-known/oauth-protected-resources/mcp"');
+            res.status(authResult.statusCode || 401).send('Unauthorized');
+            return;
+        }
+        this.trackNewConnection();
+        if (isJSONRPCNotification(req.body)) {
+            this.trackMethodCall(trackingName, startTime, false);
+            res.status(202).json({ jsonrpc: '2.0', result: null });
+            return;
+        }
+        try {
+            if (requestBody?.method === 'initialize' && requestBody?.params) {
+                const clientInfo = requestBody.params.clientInfo;
+                if (clientInfo?.name && clientInfo?.version) {
+                    this.associateSessionWithClient({ name: clientInfo.name, version: clientInfo.version });
+                    this.updateClientActivity({ name: clientInfo.name, version: clientInfo.version });
+                }
+                logger.debug({
+                    clientInfo: requestBody.params.clientInfo,
+                    capabilities: requestBody.params.capabilities,
+                }, 'Initialize request received');
+            }
+            const useFullServer = this.shouldHandle(requestBody);
+            if (useFullServer) {
+                extractQueryParamsToHeaders(req, headers);
+                const skipGradio = this.shouldSkipGradio(requestBody);
+                server = await this.serverFactory(headers, undefined, skipGradio);
+            }
+            else {
+                server = new McpServer({ name: '@huggingface/internal-responder', version: '0.0.1' });
+            }
+            transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined,
+                enableJsonResponse: true,
+            });
+            const cleanup = async () => {
+                if (transport) {
+                    await transport.close().catch((err) => {
+                        logger.warn({ error: err }, 'Error closing transport');
+                    });
+                }
+                if (server) {
+                    await server.close().catch((err) => {
+                        logger.warn({ error: err }, 'Error closing server');
+                    });
+                }
+            };
+            res.on('close', () => {
+                logger.debug('Client disconnected');
+                void cleanup();
+            });
+            server.server.onerror = (error) => {
+                this.trackError(undefined, error);
+                logger.error({ error }, 'Stateless HTTP server error');
+            };
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+            this.trackMethodCall(trackingName, startTime, false);
+            logger.debug({
+                duration: Date.now() - startTime,
+                method: trackingName,
+                handledBy: useFullServer ? 'full' : 'stub',
+            }, 'Request completed');
+        }
+        catch (error) {
+            logger.error({ error, method: trackingName }, 'Error handling request');
+            this.trackMethodCall(trackingName, startTime, true);
+            this.trackError(500, error instanceof Error ? error : new Error(String(error)));
+            if (transport) {
+                await transport.close().catch(() => {
+                });
+            }
+            if (server) {
+                await server.close().catch(() => {
+                });
+            }
+            if (!res.headersSent) {
+                const id = extractJsonRpcId(req.body);
+                res.status(500).json(JsonRpcErrors.internalError(id));
+            }
+        }
+    }
+    shutdown() {
+        logger.debug('Stateless HTTP transport shutdown signaled');
+    }
+    cleanup() {
+        logger.info('HTTP JSON transport cleanup complete');
+        return Promise.resolve();
+    }
+    getActiveConnectionCount() {
+        return STATELESS_MODE;
+    }
+    getSessions() {
+        return [];
+    }
+}
+//# sourceMappingURL=stateless-http-transport.js.map

package/dist/server/transport/stateless-http-transport.js.map

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

package/dist/server/transport/stateless-http-transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stateless-http-transport.test.d.ts.map

package/dist/server/transport/stateless-http-transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-http-transport.test.d.ts","sourceRoot":"","sources":["../../../src/server/transport/stateless-http-transport.test.ts"],"names":[],"mappings":""}

package/dist/server/transport/stateless-http-transport.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { StatelessHttpTransport } from './stateless-http-transport.js';
+import express from 'express';
+describe('StatelessHttpTransport', () => {
+    let transport;
+    beforeEach(() => {
+        const mockServerFactory = vi.fn();
+        const mockApp = express();
+        transport = new StatelessHttpTransport(mockServerFactory, mockApp);
+    });
+    describe('shouldHandle', () => {
+        it('should handle tools/list requests', () => {
+            const result = transport.shouldHandle({ method: 'tools/list' });
+            expect(result).toBe(true);
+        });
+        it('should handle tools/call requests', () => {
+            const result = transport.shouldHandle({ method: 'tools/call' });
+            expect(result).toBe(true);
+        });
+        it('should handle initialize requests', () => {
+            const result = transport.shouldHandle({ method: 'initialize' });
+            expect(result).toBe(true);
+        });
+        it('should not handle ping requests', () => {
+            const result = transport.shouldHandle({ method: 'ping' });
+            expect(result).toBe(false);
+        });
+        it('should handle prompts/list requests', () => {
+            const result = transport.shouldHandle({ method: 'prompts/list' });
+            expect(result).toBe(true);
+        });
+        it('should handle prompts/get requests', () => {
+            const result = transport.shouldHandle({ method: 'prompts/get' });
+            expect(result).toBe(true);
+        });
+        it('should not handle resources/list requests', () => {
+            const result = transport.shouldHandle({ method: 'resources/list' });
+            expect(result).toBe(false);
+        });
+        it('should not handle resources/read requests', () => {
+            const result = transport.shouldHandle({ method: 'resources/read' });
+            expect(result).toBe(false);
+        });
+        it('should handle undefined method gracefully', () => {
+            const result = transport.shouldHandle({});
+            expect(result).toBe(false);
+        });
+        it('should handle undefined body gracefully', () => {
+            const result = transport.shouldHandle(undefined);
+            expect(result).toBe(false);
+        });
+        it('should handle null body gracefully', () => {
+            const result = transport.shouldHandle(null);
+            expect(result).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=stateless-http-transport.test.js.map

package/dist/server/transport/stateless-http-transport.test.js.map

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

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

@@ -0,0 +1,12 @@
+import { StatefulTransport, type TransportOptions, type BaseSession } from './base-transport.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+type StdioSession = BaseSession<StdioServerTransport>;
+export declare class StdioTransport extends StatefulTransport<StdioSession> {
+    private readonly SESSION_ID;
+    initialize(_options: TransportOptions): Promise<void>;
+    protected removeStaleSession(sessionId: string): Promise<void>;
+    cleanup(): Promise<void>;
+    getSession(): StdioSession | undefined;
+}
+export {};
+//# sourceMappingURL=stdio-transport.d.ts.map

package/dist/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,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,KAAK,YAAY,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AAKtD,qBAAa,cAAe,SAAQ,iBAAiB,CAAC,YAAY,CAAC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;IAEhC,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiE3D,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB9B,UAAU,IAAI,YAAY,GAAG,SAAS;CAGtC"}

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

@@ -0,0 +1,78 @@
+import { StatefulTransport } from './base-transport.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { logger } from '../lib/logger.js';
+export class StdioTransport extends StatefulTransport {
+    SESSION_ID = 'STDIO';
+    async initialize(_options) {
+        const transport = new StdioServerTransport();
+        const server = await this.serverFactory(null);
+        const session = {
+            transport,
+            server,
+            metadata: {
+                id: this.SESSION_ID,
+                connectedAt: new Date(),
+                lastActivity: new Date(),
+                requestCount: 0,
+                capabilities: {},
+            },
+        };
+        this.sessions.set(this.SESSION_ID, session);
+        this.trackSessionCreated(this.SESSION_ID);
+        try {
+            const originalSendMessage = transport.send.bind(transport);
+            transport.send = (message) => {
+                this.trackRequest();
+                this.updateSessionActivity(this.SESSION_ID);
+                const session = this.sessions.get(this.SESSION_ID);
+                if (session) {
+                    session.metadata.requestCount++;
+                }
+                return originalSendMessage(message);
+            };
+            server.server.oninitialized = this.createClientInfoCapture(this.SESSION_ID);
+            server.server.onerror = (error) => {
+                this.trackError(undefined, error);
+                logger.error({ error }, 'STDIO server error');
+            };
+            await server.connect(transport);
+            logger.info('STDIO transport initialized');
+        }
+        catch (error) {
+            logger.error({ error }, 'Error connecting STDIO transport');
+            const session = this.sessions.get(this.SESSION_ID);
+            this.sessions.delete(this.SESSION_ID);
+            this.trackSessionCleaned(session);
+            throw error;
+        }
+    }
+    removeStaleSession(sessionId) {
+        logger.debug({ sessionId }, 'STDIO session staleness check (no-op)');
+        return Promise.resolve();
+    }
+    async cleanup() {
+        const session = this.sessions.get(this.SESSION_ID);
+        if (session) {
+            try {
+                await session.transport.close();
+            }
+            catch (error) {
+                logger.error({ error }, 'Error closing STDIO transport');
+            }
+            try {
+                await session.server.close();
+            }
+            catch (error) {
+                logger.error({ error }, 'Error closing STDIO server');
+            }
+            this.trackSessionCleaned(session);
+        }
+        this.sessions.clear();
+        logger.info('STDIO transport cleaned up');
+        return Promise.resolve();
+    }
+    getSession() {
+        return this.sessions.get(this.SESSION_ID);
+    }
+}
+//# sourceMappingURL=stdio-transport.js.map

package/dist/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":"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"}

package/dist/server/transport/streamable-http-transport.d.ts

@@ -0,0 +1,21 @@
+import { StatefulTransport, type TransportOptions, type BaseSession } from './base-transport.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import type { Response } from 'express';
+interface StreamableHttpConnection extends BaseSession<StreamableHTTPServerTransport> {
+    activeResponse?: Response;
+}
+type Session = StreamableHttpConnection;
+export declare class StreamableHttpTransport extends StatefulTransport<Session> {
+    initialize(_options: TransportOptions): Promise<void>;
+    private setupRoutes;
+    private handleRequest;
+    private handlePostRequest;
+    private handleGetRequest;
+    private handleDeleteRequest;
+    private createSession;
+    private removeSession;
+    protected removeStaleSession(sessionId: string): Promise<void>;
+    cleanup(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=streamable-http-transport.d.ts.map

package/dist/server/transport/streamable-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/server/transport/streamable-http-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,KAAK,EAAW,QAAQ,EAAE,MAAM,SAAS,CAAC;AAMjD,UAAU,wBAAyB,SAAQ,WAAW,CAAC,6BAA6B,CAAC;IACpF,cAAc,CAAC,EAAE,QAAQ,CAAC;CAC1B;AAED,KAAK,OAAO,GAAG,wBAAwB,CAAC;AAExC,qBAAa,uBAAwB,SAAQ,iBAAiB,CAAC,OAAO,CAAC;IACtE,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAerD,OAAO,CAAC,WAAW;YA0BL,aAAa;YA6Bb,iBAAiB;YAmFjB,gBAAgB;YA+BhB,mBAAmB;YAoBnB,aAAa;YA0Db,aAAa;cAOX,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS9B"}