@loop_ouroboros/mcp-hub-lite 1.3.0 → 1.3.1

package/dist/server/src/services/gateway/gateway.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/gateway/gateway.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBpE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;;IAQpC,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,wBAAwB;IA2BhC,OAAO,CAAC,gBAAgB;IAkDxB;;;;;OAKG;IACI,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;IAIvF;;;;;OAKG;IACI,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAI5C;;;;;OAKG;IACI,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM;IAIpD;;;;OAIG;IACI,sBAAsB,IAAI,SAAS;IAI1C;;;;OAIG;IACU,KAAK;CAKnB;AAED,eAAO,MAAM,OAAO,gBAAuB,CAAC"}
+{"version":3,"file":"gateway.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/gateway/gateway.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBpE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;;IASpC,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,wBAAwB;IA2BhC,OAAO,CAAC,gBAAgB;IAkDxB;;;;;OAKG;IACI,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;IAIvF;;;;;OAKG;IACI,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAI5C;;;;;OAKG;IACI,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM;IAIpD;;;;OAIG;IACI,sBAAsB,IAAI,SAAS;IAI1C;;OAEG;IACI,SAAS,IAAI,SAAS;IAI7B;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAgEzB;;;;OAIG;IACU,KAAK;CAKnB;AAED,eAAO,MAAM,OAAO,gBAAuB,CAAC"}

package/dist/server/src/services/gateway/gateway.service.js

@@ -26,6 +26,8 @@ import { registerInitializeHandlers, registerResourcesHandlers, registerSystemTo
 import { getAppVersion } from '../../utils/version.js';
 import { eventBus, EventTypes } from '../event-bus.service.js';
 import { hubManager } from '../hub-manager.service.js';
+import { mcpConnectionManager } from '../connection/index.js';
+import { sessionManager } from './session-manager.js';
 import { generateGatewayToolsList, rebuildFromScratch, addToCache, removeFromCache } from './tool-list-generator.js';
 import { formatToolArgs, formatToolResponse } from './log-formatter.js';
 export class GatewayService {
@@ -36,6 +38,7 @@ export class GatewayService {
         this.appVersion = getAppVersion();
         this.server = this.createServerWithHandlers();
         this.initToolCache();
+        this.initNotifications();
     }
     initToolCache() {
         rebuildFromScratch();
@@ -166,6 +169,75 @@ export class GatewayService {
     createConnectionServer() {
         return this.createServerWithHandlers();
     }
+    /**
+     * Returns the singleton McpServer instance used for HTTP transport.
+     */
+    getServer() {
+        return this.server;
+    }
+    /**
+     * Subscribes to EventBus events and pushes MCP notifications
+     * (notifications/resources/list_changed, notifications/tools/list_changed)
+     * to connected SSE clients via the singleton transport.
+     *
+     * Tools are aggregated by ServerName (multi-instance deduplication).
+     * Resources are per-instance (Category 1: hub://servers/{name}, Category 2: hub://servers/{name}/{idx}/{path}).
+     */
+    initNotifications() {
+        // --- Resources list_changed ---
+        // Category 1: new/removed server config
+        eventBus.subscribe(EventTypes.SERVER_ADDED, () => {
+            sessionManager.broadcastNotification('resources');
+        });
+        eventBus.subscribe(EventTypes.SERVER_DELETED, () => {
+            sessionManager.broadcastNotification('resources');
+        });
+        // Category 1 + 2: any instance connect/disconnect changes resource list
+        eventBus.subscribe(EventTypes.SERVER_CONNECTED, () => {
+            sessionManager.broadcastNotification('resources');
+        });
+        eventBus.subscribe(EventTypes.SERVER_DISCONNECTED, () => {
+            sessionManager.broadcastNotification('resources');
+        });
+        // Category 2: backend server resources refreshed
+        eventBus.subscribe(EventTypes.RESOURCES_UPDATED, () => {
+            sessionManager.broadcastNotification('resources');
+        });
+        // --- Tools list_changed ---
+        // Only notify when the first instance connects or last instance disconnects
+        eventBus.subscribe(EventTypes.SERVER_CONNECTED, (rawData) => {
+            const data = rawData;
+            const indexes = mcpConnectionManager.getConnectedIndexes(data.serverName);
+            if (indexes.length === 1) {
+                const serverConfig = hubManager.getServerByName(data.serverName);
+                if (serverConfig?.template?.aggregatedTools?.length) {
+                    sessionManager.broadcastNotification('tools');
+                }
+            }
+        });
+        eventBus.subscribe(EventTypes.SERVER_DISCONNECTED, (rawData) => {
+            const data = rawData;
+            const indexes = mcpConnectionManager.getConnectedIndexes(data.serverName);
+            if (indexes.length === 0) {
+                const serverConfig = hubManager.getServerByName(data.serverName);
+                if (serverConfig?.template?.aggregatedTools?.length) {
+                    sessionManager.broadcastNotification('tools');
+                }
+            }
+        });
+        // Backend server tools refreshed while connected
+        eventBus.subscribe(EventTypes.TOOLS_UPDATED, (rawData) => {
+            const data = rawData;
+            const serverConfig = hubManager.getServerByName(data.serverName);
+            if (serverConfig?.template?.aggregatedTools?.length) {
+                sessionManager.broadcastNotification('tools');
+            }
+        });
+        // Aggregated tools config changed
+        eventBus.subscribe(EventTypes.AGGREGATED_TOOLS_CHANGED, () => {
+            sessionManager.broadcastNotification('tools');
+        });
+    }
     /**
      * Starts the MCP gateway service on stdio transport.
      *

package/dist/server/src/services/gateway/global-transport.d.ts

@@ -1,19 +1,29 @@
 /**
- * MCP transport factory for per-request transport instances.
+ * MCP transport utilities — stateful session-based mode.
  *
- * This module provides a factory function to create isolated MCP transport and server instances
- * for each HTTP request, ensuring proper state isolation between concurrent clients.
+ * Each client session owns a StreamableHTTPServerTransport + McpServer pair.
+ * SDK's stateful mode (sessionIdGenerator) handles SSE stream setup and session management.
+ * Notifications are broadcast via SessionManager across all active sessions.
  */
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 /**
- * Creates a new MCP transport and server instance for a single request session.
- * Each call returns isolated instances that should be cleaned up after the request completes.
- *
- * @returns {Promise<{ transport: StreamableHTTPServerTransport, server: import('@modelcontextprotocol/sdk/server/mcp.js').McpServer }>}
- *          Object containing the transport and server instances
+ * Sets up debug logging on a transport instance.
+ */
+export declare function setupTransportLogging(transport: StreamableHTTPServerTransport): void;
+/**
+ * Initializes the global transport layer.
+ * With stateful session-based transport, this is a no-op.
+ * Kept for backward compatibility with app.ts startup sequence.
+ */
+export declare function initGlobalTransport(): void;
+/**
+ * Creates a new MCP transport and server instance for a single request (stateless mode).
+ * Each call returns isolated instances that should be GC'd after the request completes.
+ * This restores the v1.3.0 per-request transport pattern for clients like CherryStudio
+ * that do not properly support stateful sessions.
  */
-export declare function createSessionTransport(): Promise<{
+export declare function createPerRequestTransport(): Promise<{
     transport: StreamableHTTPServerTransport;
-    server: import("@modelcontextprotocol/sdk/server/mcp").McpServer;
+    server: import('@modelcontextprotocol/sdk/server/mcp.js').McpServer;
 }>;
 //# sourceMappingURL=global-transport.d.ts.map

package/dist/server/src/services/gateway/global-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-transport.d.ts","sourceRoot":"","sources":["../../../../../src/services/gateway/global-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAUnG;;;;;;GAMG;AACH,wBAAsB,sBAAsB;;;GAqE3C"}
+{"version":3,"file":"global-transport.d.ts","sourceRoot":"","sources":["../../../../../src/services/gateway/global-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAuBnG;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,6BAA6B,GAAG,IAAI,CAmCpF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC;IACzD,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,OAAO,yCAAyC,EAAE,SAAS,CAAC;CACrE,CAAC,CAWD"}

package/dist/server/src/services/gateway/global-transport.js

@@ -1,72 +1,88 @@
 /**
- * MCP transport factory for per-request transport instances.
+ * MCP transport utilities — stateful session-based mode.
  *
- * This module provides a factory function to create isolated MCP transport and server instances
- * for each HTTP request, ensuring proper state isolation between concurrent clients.
+ * Each client session owns a StreamableHTTPServerTransport + McpServer pair.
+ * SDK's stateful mode (sessionIdGenerator) handles SSE stream setup and session management.
+ * Notifications are broadcast via SessionManager across all active sessions.
  */
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import { gateway } from './gateway.service.js';
 import { logger, LOG_MODULES } from '../../utils/logger/index.js';
 import { stringifyForLogging, getMcpCommDebugSetting, getGatewayDebugSetting } from '../../utils/json-utils.js';
 import { formatMcpMessageForLogging, logNotificationMessage } from '../../utils/logger/log-output.js';
+import { gateway } from './gateway.service.js';
 /**
- * Creates a new MCP transport and server instance for a single request session.
- * Each call returns isolated instances that should be cleaned up after the request completes.
- *
- * @returns {Promise<{ transport: StreamableHTTPServerTransport, server: import('@modelcontextprotocol/sdk/server/mcp.js').McpServer }>}
- *          Object containing the transport and server instances
+ * Build log options from trace context stored on transport.
+ * Trace context is injected by gateway.ts before handleRequest() as an ALS fallback
+ * because the MCP SDK defers send()/onmessage calls and ALS context is lost.
  */
-export async function createSessionTransport() {
-    const transport = new StreamableHTTPServerTransport();
-    const server = gateway.createConnectionServer();
-    // Set up message logging (use empty string for sessionId in per-request mode)
+function traceLogOpts(transport) {
+    const ctx = transport;
+    const sid = ctx._traceSessionId;
+    const tid = ctx._traceId;
+    if (!sid && !tid)
+        return LOG_MODULES.COMMUNICATION;
+    return { module: 'Communication', ...(sid && { sessionId: sid }), ...(tid && { traceId: tid }) };
+}
+/**
+ * Sets up debug logging on a transport instance.
+ */
+export function setupTransportLogging(transport) {
     transport.onmessage = (message) => {
         try {
             if (getMcpCommDebugSetting()) {
-                logger.debug(`Session transport onmessage called with: ${stringifyForLogging(message)}`, LOG_MODULES.COMMUNICATION);
+                const opts = traceLogOpts(transport);
+                logger.debug(`Transport onmessage: ${stringifyForLogging(message)}`, opts);
                 const logMessage = formatMcpMessageForLogging(message);
-                logger.debug(`MCP message received: ${logMessage}`, LOG_MODULES.COMMUNICATION);
+                logger.debug(`MCP message received: ${logMessage}`, opts);
             }
-            logNotificationMessage(message, ''); // Empty sessionId for per-request
+            logNotificationMessage(message, '');
             if (getGatewayDebugSetting()) {
-                logger.debug(`Session transport onmessage completed successfully`, LOG_MODULES.GATEWAY);
+                logger.debug('Transport onmessage completed', LOG_MODULES.GATEWAY);
             }
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            logger.error(`Error in session transport onmessage handler: ${errorMessage}`, LOG_MODULES.GATEWAY);
+            logger.error(`Error in transport onmessage: ${errorMessage}`, LOG_MODULES.GATEWAY);
             logger.error(`Message that caused error: ${stringifyForLogging(message)}`, LOG_MODULES.GATEWAY);
         }
     };
-    // Wrap send method for debug logging
     if (getMcpCommDebugSetting()) {
         const originalSend = transport.send;
         transport.send = async (message, options) => {
             try {
                 const logMessage = formatMcpMessageForLogging(message);
-                logger.debug(`MCP message sent: ${logMessage}`, LOG_MODULES.COMMUNICATION);
+                logger.debug(`MCP message sent: ${logMessage}`, traceLogOpts(transport));
             }
             catch {
-                logger.debug(`MCP message sent: [Error formatting response]`, LOG_MODULES.COMMUNICATION);
+                logger.debug('MCP message sent: [Error formatting response]', LOG_MODULES.COMMUNICATION);
             }
             return await originalSend.call(transport, message, options);
         };
     }
-    // Connect server to transport
+}
+/**
+ * Initializes the global transport layer.
+ * With stateful session-based transport, this is a no-op.
+ * Kept for backward compatibility with app.ts startup sequence.
+ */
+export function initGlobalTransport() {
     if (getGatewayDebugSetting()) {
-        logger.debug('About to connect session server to transport', LOG_MODULES.GATEWAY);
-    }
-    try {
-        await server.connect(transport);
-        if (getGatewayDebugSetting()) {
-            logger.debug('MCP session transport initialized (per-request mode)', LOG_MODULES.GATEWAY);
-        }
+        logger.debug('Global transport layer initialized (stateful session mode)', LOG_MODULES.GATEWAY);
     }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        logger.error(`Failed to connect session server to transport: ${errorMessage}`, LOG_MODULES.GATEWAY);
-        logger.error(`Transport connection error details: ${stringifyForLogging(error)}`, LOG_MODULES.GATEWAY);
-        throw error;
+}
+/**
+ * Creates a new MCP transport and server instance for a single request (stateless mode).
+ * Each call returns isolated instances that should be GC'd after the request completes.
+ * This restores the v1.3.0 per-request transport pattern for clients like CherryStudio
+ * that do not properly support stateful sessions.
+ */
+export async function createPerRequestTransport() {
+    const transport = new StreamableHTTPServerTransport();
+    const server = gateway.createConnectionServer();
+    setupTransportLogging(transport);
+    await server.connect(transport);
+    if (getGatewayDebugSetting()) {
+        logger.debug('MCP per-request transport initialized (stateless mode)', LOG_MODULES.GATEWAY);
     }
     return { transport, server };
 }

package/dist/server/src/services/gateway/request-handlers/initialize-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialize-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/services/gateway/request-handlers/initialize-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsElE"}
+{"version":3,"file":"initialize-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/services/gateway/request-handlers/initialize-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuFlE"}

package/dist/server/src/services/gateway/request-handlers/initialize-handler.js

@@ -1,7 +1,8 @@
 import { logger, LOG_MODULES } from '../../../utils/logger/index.js';
-import { getGatewayDebugSetting } from '../../../utils/json-utils.js';
+import { getGatewayDebugSetting, stringifyForLogging } from '../../../utils/json-utils.js';
 import { MCP_HUB_LITE_SERVER } from '../../../models/system-tools.constants.js';
 import { getAppVersion, getProtocolVersion } from '../../../utils/version.js';
+import { sessionManager } from '../../gateway/session-manager.js';
 import { InitializedNotificationSchema, InitializeRequestSchema, PingRequestSchema } from './initialize.constants.js';
 /**
  * Register initialize and ping handlers on the MCP server.
@@ -14,6 +15,11 @@ export function registerInitializeHandlers(server) {
             const { name, version } = request.params.clientInfo;
             const protocolVersion = request.params?.protocolVersion || getProtocolVersion();
             const clientCapabilities = request.params?.capabilities;
+            sessionManager.storePendingClientMetadata(server, {
+                clientName: name,
+                clientVersion: version,
+                protocolVersion
+            });
             if (getGatewayDebugSetting()) {
                 logger.debug(`Initialized client: Name=${name}, Version=${version}, ProtocolVersion=${protocolVersion}`, LOG_MODULES.GATEWAY);
             }
@@ -30,15 +36,25 @@ export function registerInitializeHandlers(server) {
             capabilities: {
                 tools: {
                     list: true,
-                    execute: true
+                    execute: true,
+                    listChanged: true
                 },
                 resources: {
                     list: true,
-                    read: true
+                    read: true,
+                    listChanged: true
                 },
                 logging: {},
                 experimental: {}
-            }
+            },
+            instructions: 'MCP Hub Lite is a lightweight MCP gateway that aggregates multiple backend MCP servers into a unified interface. ' +
+                'HOW TO USE: 1) Start with resources/list to discover available servers and the use guide. ' +
+                '2) Use list_servers to see all connected servers. ' +
+                '3) Preview a server’s tools via resources/read on hub://servers/{name}. ' +
+                '4) Use list_tools for the full tool list, get_tool when you need inputSchema, then call_tool to execute. ' +
+                '5) Use search_tools to find tools by name or description across all servers. ' +
+                'MULTI-INSTANCE SERVERS: Use list_tags to view available instance tags, then pass matching tags via requestOptions.tags when calling call_tool. ' +
+                'System tools (list_servers, list_tools, get_tool, call_tool, search_tools, list_tags, update_server_description) must be called directly, not through call_tool.'
         };
     });
     server.server.setRequestHandler(PingRequestSchema, async () => {
@@ -47,7 +63,7 @@ export function registerInitializeHandlers(server) {
     server.server.setNotificationHandler(InitializedNotificationSchema, async (notification) => {
         if (getGatewayDebugSetting()) {
             logger.debug('Received initialized notification from client', LOG_MODULES.GATEWAY);
-            logger.debug(`Initialized notification details: ${JSON.stringify(notification)}`, LOG_MODULES.GATEWAY);
+            logger.debug(`Initialized notification details: ${stringifyForLogging(notification)}`, LOG_MODULES.GATEWAY);
         }
         try {
             // Process the notification
@@ -58,7 +74,7 @@ export function registerInitializeHandlers(server) {
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             logger.error(`Error processing initialized notification: ${errorMessage}`, LOG_MODULES.GATEWAY);
-            logger.error(`Notification that caused error: ${JSON.stringify(notification)}`, LOG_MODULES.GATEWAY);
+            logger.error(`Notification that caused error: ${stringifyForLogging(notification)}`, LOG_MODULES.GATEWAY);
             throw error; // Re-throw to see if this is the source of the problem
         }
     });

package/dist/server/src/services/gateway/request-handlers/resources-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/services/gateway/request-handlers/resources-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiDjE"}
+{"version":3,"file":"resources-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/services/gateway/request-handlers/resources-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsDjE"}

package/dist/server/src/services/gateway/request-handlers/resources-handler.js

@@ -1,7 +1,7 @@
 /**
  * Resources-related request handlers for Gateway service.
  */
-import { ListResourcesRequestSchema, ReadResourceRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
 import { logger } from '../../../utils/index.js';
 import { LOG_MODULES } from '../../../utils/logger/log-modules.js';
 import { hubToolsService } from '../../hub-tools.service.js';
@@ -11,6 +11,10 @@ import { hubToolsService } from '../../hub-tools.service.js';
  * @param server - MCP server instance to register handlers on
  */
 export function registerResourcesHandlers(server) {
+    // Resource templates — gateway does not use templates, return empty list
+    server.server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+        return { resourceTemplates: [] };
+    });
     server.server.setRequestHandler(ListResourcesRequestSchema, async () => {
         try {
             const resources = await hubToolsService.listResources();

package/dist/server/src/services/gateway/session-manager.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Session Manager for stateful Streamable HTTP MCP transport.
+ *
+ * Each client session owns a StreamableHTTPServerTransport + McpServer pair.
+ * Sessions are identified by mcp-session-id header (generated by the SDK).
+ * Notifications are broadcast to all active sessions via their McpServer instances.
+ */
+import type { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+interface SessionState {
+    sessionId: string;
+    transport: StreamableHTTPServerTransport;
+    server: McpServer;
+    createdAt: number;
+    lastAccessedAt: number;
+    isClosing: boolean;
+    activeSseCount: number;
+    lastPingedAt: number;
+    pingPending: boolean;
+    clientName?: string;
+    clientVersion?: string;
+    protocolVersion?: string;
+    createdByMethod?: string;
+    lastMethod?: string;
+}
+export declare class SessionManager {
+    private sessions;
+    private cleanupTimer;
+    private pendingClientMetadata;
+    /**
+     * Registers a newly created session.
+     */
+    addSession(sessionId: string, transport: StreamableHTTPServerTransport, server: McpServer): void;
+    /**
+     * Looks up an existing session by ID and updates lastAccessedAt.
+     */
+    getSession(sessionId: string): SessionState | undefined;
+    /**
+     * Marks an SSE stream as opened for the given session.
+     * Prevents the session from being cleaned up while the stream is active.
+     */
+    markSseOpened(sessionId: string): void;
+    /**
+     * Marks an SSE stream as closed for the given session.
+     */
+    markSseClosed(sessionId: string): void;
+    /**
+     * Removes a session (called on DELETE or onsessionclosed).
+     */
+    removeSession(sessionId: string): void;
+    private pendingBroadcasts;
+    private readonly BROADCAST_DEBOUNCE_MS;
+    /**
+     * Broadcasts a notification to all active sessions.
+     * Debounced: same-type notifications within BROADCAST_DEBOUNCE_MS are coalesced.
+     * @param method - 'tools' for sendToolListChanged, 'resources' for sendResourceListChanged
+     */
+    broadcastNotification(method: 'tools' | 'resources'): void;
+    /**
+     * Removes sessions that have been idle longer than SESSION_TIMEOUT_MS.
+     */
+    private cleanupStaleSessions;
+    private ensureCleanupTimer;
+    /**
+     * Shuts down all sessions. Called on server shutdown.
+     */
+    shutdownAll(): void;
+    /** Returns the current session count (for diagnostics). */
+    get sessionCount(): number;
+    /**
+     * Stores client metadata against a McpServer instance so that
+     * addSession() can consume it when the session is registered later.
+     */
+    storePendingClientMetadata(server: McpServer, metadata: {
+        clientName: string;
+        clientVersion: string;
+        protocolVersion: string;
+    }): void;
+    /**
+     * Returns metadata for all active sessions. Does not expose internal
+     * transport or server references.
+     */
+    getAllSessions(): Array<{
+        sessionId: string;
+        clientName?: string;
+        clientVersion?: string;
+        protocolVersion?: string;
+        createdByMethod?: string;
+        lastMethod?: string;
+        createdAt: string;
+        lastAccessedAt: string;
+        isClosing: boolean;
+        activeSseCount: number;
+    }>;
+    /** Updates the last HTTP method seen for a session. */
+    updateSessionMethod(sessionId: string, method: string): void;
+}
+/** Singleton instance. */
+export declare const sessionManager: SessionManager;
+export {};
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/server/src/services/gateway/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../../../src/services/gateway/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACxG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,YAAY,CAA+C;IAEnE,OAAO,CAAC,qBAAqB,CAGzB;IAEJ;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI;IA6BhG;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IASvD;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAatC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAatC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAuBtC,OAAO,CAAC,iBAAiB,CAAoD;IAC7E,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAQ;IAE9C;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI;IA4B1D;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiE5B,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,WAAW,IAAI,IAAI;IAenB,2DAA2D;IAC3D,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;OAGG;IACH,0BAA0B,CACxB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAC/E,IAAI;IAIP;;;OAGG;IACH,cAAc,IAAI,KAAK,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,OAAO,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAmBF,uDAAuD;IACvD,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAM7D;AAED,0BAA0B;AAC1B,eAAO,MAAM,cAAc,gBAAuB,CAAC"}