@loop_ouroboros/mcp-hub-lite 1.2.8 → 1.3.0

package/dist/server/src/services/gateway/tool-list-generator.js

@@ -1,35 +1,86 @@
 /**
- * Gateway tool list generator with collision resolution.
+ * Gateway tool list generator with collision resolution and global caching.
  */
-import { logger } from '../../utils/index.js';
-import { LOG_MODULES } from '../../utils/logger/log-modules.js';
-import { mcpConnectionManager } from '../mcp-connection-manager.js';
+import { logger, LOG_MODULES } from '../../utils/index.js';
+import { mcpConnectionManager } from '../connection/index.js';
 import { hubManager } from '../hub-manager.service.js';
-import { hubToolsService } from '../hub-tools.service.js';
+import { getSystemTools } from '../hub-tools/index.js';
 import { parseCompositeKey } from '../../utils/composite-key.js';
+// ── Double-layer cache ──────────────────────────────────────────
+/** Raw data layer: per-server aggregated tool snapshots */
+let rawToolData = null;
+/** Resolved name layer */
+let cachedToolMap = null;
+let cachedGatewayTools = null;
+// ── Phase 1: Data gathering ─────────────────────────────────────
 /**
- * Generates a unified list of gateway tools with proper naming and collision resolution.
- *
- * This method creates a comprehensive tool list that includes both system tools and
- * aggregated tools from all connected MCP servers. It implements sophisticated
- * naming collision resolution by:
- * - Adding server hash suffixes to non-unique tool names
- * - Handling conflicts with system tool names
- * - Ensuring names don't exceed 60 characters
- * - Providing final uniqueness guarantees through counter suffixes
- *
- * The method also populates the provided toolMap with mappings from gateway tool names
- * to actual server IDs and real tool names for efficient routing during tool execution.
- *
- * @param {Map<string, ToolMapEntry>} toolMap - Map to populate with gateway tool name to actual tool mappings
- * @returns {Array<GatewayTool>} Array of gateway tools with resolved names and descriptions
+ * Collects aggregated tool data from all connected servers.
+ * Iterates tool cache entries and applies the aggregatedTools filter.
  */
-export function generateGatewayToolsList(toolMap) {
-    const gatewayTools = [];
+function gatherRawToolData() {
+    const rawData = new Map();
+    for (const [compositeKey, tools] of mcpConnectionManager.getToolCacheEntries()) {
+        const parsed = parseCompositeKey(compositeKey);
+        const serverName = parsed ? parsed.serverName : compositeKey;
+        const serverIndex = parsed ? parsed.serverIndex : 0;
+        const serverConfig = hubManager.getServerByName(serverName);
+        if (!serverConfig)
+            continue;
+        const aggregatedTools = serverConfig.template?.aggregatedTools;
+        if (!aggregatedTools?.length)
+            continue;
+        const filteredTools = tools.filter((t) => aggregatedTools.includes(t.name));
+        if (filteredTools.length === 0)
+            continue;
+        const existing = rawData.get(serverName);
+        if (existing) {
+            // Merge tools from multiple instances — later tools overwrite earlier by name
+            const mergedTools = new Map();
+            for (const t of existing.tools)
+                mergedTools.set(t.name, t);
+            for (const t of filteredTools)
+                mergedTools.set(t.name, t);
+            // Update toolIndexes for tools from this instance
+            const mergedIndexes = new Map(existing.toolIndexes);
+            for (const t of filteredTools) {
+                mergedIndexes.set(t.name, serverIndex);
+            }
+            rawData.set(serverName, {
+                tools: Array.from(mergedTools.values()),
+                aggregated: aggregatedTools,
+                toolIndexes: mergedIndexes
+            });
+        }
+        else {
+            const toolIndexes = new Map();
+            for (const t of filteredTools) {
+                toolIndexes.set(t.name, serverIndex);
+            }
+            rawData.set(serverName, {
+                tools: filteredTools,
+                aggregated: aggregatedTools,
+                toolIndexes
+            });
+        }
+    }
+    let totalTools = 0;
+    for (const [, data] of rawData) {
+        totalTools += data.tools.length;
+    }
+    logger.debug(`Gateway tool cache: gathered ${totalTools} aggregated tools across ${rawData.size} servers`, LOG_MODULES.TOOL_LIST_GENERATOR);
+    return rawData;
+}
+// ── Phase 2: Name resolution ────────────────────────────────────
+/**
+ * Resolves final gateway tool names from raw data.
+ * Pure computation — no external calls.
+ */
+function resolveToolNames(rawData, toolMap) {
     toolMap.clear();
-    // Add system tools
-    const systemTools = hubToolsService.getSystemTools();
+    const gatewayTools = [];
     const usedNames = new Set();
+    // Add system tools
+    const systemTools = getSystemTools();
     for (const tool of systemTools) {
         gatewayTools.push({
             name: tool.name,
@@ -39,72 +90,31 @@ export function generateGatewayToolsList(toolMap) {
         });
         usedNames.add(tool.name);
     }
-    // First pass: Count tool name frequencies to determine uniqueness
+    // First pass: count tool name frequencies
     const toolNameCounts = new Map();
-    // Iterate through toolCache to get all tools - entries are keyed by compositeKey (serverName-serverIndex)
-    for (const [compositeKey, tools] of mcpConnectionManager.getToolCacheEntries()) {
-        for (const tool of tools) {
-            // Parse composite key to get serverName
-            const parsed = parseCompositeKey(compositeKey);
-            const serverName = parsed ? parsed.serverName : compositeKey;
-            const serverConfig = hubManager.getServerByName(serverName);
-            if (serverConfig) {
-                // Only include tools if server has aggregatedTools configured AND tool is in aggregatedTools
-                const aggregatedTools = serverConfig.template?.aggregatedTools;
-                const hasAggregatedTools = aggregatedTools && aggregatedTools.length > 0;
-                if (!hasAggregatedTools) {
-                    continue;
-                }
-                if (!Array.isArray(aggregatedTools) || !aggregatedTools.includes(tool.name)) {
-                    continue;
-                }
-            }
+    for (const [, data] of rawData) {
+        for (const tool of data.tools) {
             toolNameCounts.set(tool.name, (toolNameCounts.get(tool.name) || 0) + 1);
         }
     }
-    // Second pass: Generate gateway tools with proper naming
-    for (const [compositeKey, tools] of mcpConnectionManager.getToolCacheEntries()) {
-        // Parse composite key to get serverName
-        const parsed = parseCompositeKey(compositeKey);
-        const serverName = parsed ? parsed.serverName : compositeKey;
-        const serverIndex = parsed ? parsed.serverIndex : 0;
-        const serverConfig = hubManager.getServerByName(serverName);
-        // Skip if server configuration not found
-        if (!serverConfig) {
-            logger.warn(`Server configuration not found for serverName: ${serverName}, skipping tools`, LOG_MODULES.TOOL_LIST_GENERATOR);
-            continue;
-        }
-        // Only include tools if server has aggregatedTools configured
-        const aggregatedTools = serverConfig.template?.aggregatedTools;
-        const hasAggregatedTools = aggregatedTools && aggregatedTools.length > 0;
-        if (!hasAggregatedTools) {
-            continue;
-        }
-        // Get the instance ID for hash suffix (use compositeKey which contains serverName-serverIndex format)
-        const hashSuffix = compositeKey;
-        for (const tool of tools) {
-            if (!aggregatedTools.includes(tool.name)) {
-                continue;
-            }
+    // Second pass: generate gateway tools with collision resolution
+    for (const [serverName, data] of rawData) {
+        for (const tool of data.tools) {
             let gatewayToolName = tool.name;
             const isUnique = toolNameCounts.get(tool.name) === 1;
             const isSystemConflict = usedNames.has(tool.name);
-            // If tool name is not unique or conflicts with system tool, append server hash
             if (!isUnique || isSystemConflict) {
-                // Use hash suffix from compositeKey for uniqueness
-                const hash = hashSuffix.substring(0, 4);
+                const hash = serverName.substring(0, 4);
                 gatewayToolName = `${tool.name}_${hash}`;
             }
             // Ensure name doesn't exceed 60 chars
             if (gatewayToolName.length > 60) {
-                // Use hash suffix from compositeKey
-                const hash = hashSuffix.substring(0, 4);
-                // Reserve space for hash and separator
+                const hash = serverName.substring(0, 4);
                 const maxToolNameLen = 60 - hash.length - 1;
                 const truncatedToolName = tool.name.substring(0, maxToolNameLen);
                 gatewayToolName = `${truncatedToolName}_${hash}`;
             }
-            // Final uniqueness check (in case of hash collision or previous renaming conflict)
+            // Final uniqueness check
             let finalName = gatewayToolName;
             let counter = 1;
             while (usedNames.has(finalName)) {
@@ -118,19 +128,150 @@ export function generateGatewayToolsList(toolMap) {
                 }
                 counter++;
             }
-            gatewayToolName = finalName;
-            usedNames.add(gatewayToolName);
-            toolMap.set(gatewayToolName, {
+            usedNames.add(finalName);
+            toolMap.set(finalName, {
                 serverName,
-                serverIndex,
+                serverIndex: data.toolIndexes.get(tool.name) ?? 0,
                 realToolName: tool.name
             });
             gatewayTools.push({
-                name: gatewayToolName,
+                name: finalName,
                 description: `[From ${serverName}] ${tool.description || ''}`,
-                inputSchema: tool.inputSchema
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        serverName: {
+                            type: 'string',
+                            description: `Must be "${serverName}"`
+                        },
+                        toolName: {
+                            type: 'string',
+                            description: `Must be "${tool.name}"`
+                        },
+                        toolArgs: tool.inputSchema || { type: 'object', properties: {} },
+                        requestOptions: {
+                            type: 'object',
+                            description: 'Optional: instance selection options',
+                            properties: {
+                                sessionId: {
+                                    type: 'string',
+                                    description: 'Session ID for instance stickiness'
+                                },
+                                tags: {
+                                    type: 'object',
+                                    description: 'Tags for instance matching (e.g. {"env":"prod"})'
+                                }
+                            }
+                        }
+                    },
+                    required: ['serverName', 'toolName', 'toolArgs']
+                }
             });
         }
     }
     return gatewayTools;
 }
+// ── Composite: original function (backward compatible) ──────────
+export function generateGatewayToolsList(toolMap) {
+    const rawData = gatherRawToolData();
+    return resolveToolNames(rawData, toolMap);
+}
+// ── Cache API ────────────────────────────────────────────────────
+/** Lazy get — first-request fallback when cache hasn't been built yet */
+export function getOrBuildGatewayToolMap() {
+    if (!cachedToolMap) {
+        rebuildFromScratch();
+    }
+    return cachedToolMap;
+}
+/** Lazy get — first-request fallback when cache hasn't been built yet */
+export function getOrBuildGatewayToolsList() {
+    if (!cachedGatewayTools) {
+        rebuildFromScratch();
+    }
+    return cachedGatewayTools;
+}
+/** Lazy get — returns only aggregated external tools (excludes system tools) */
+export function getExternalGatewayTools() {
+    return getOrBuildGatewayToolsList().filter((t) => !t.description?.startsWith('[System]'));
+}
+/** Full rebuild from global state — used by TOOLS_UPDATED / SERVER_DISCONNECTED */
+export function rebuildFromScratch() {
+    const prevSize = cachedToolMap?.size ?? 0;
+    rawToolData = gatherRawToolData();
+    cachedToolMap = new Map();
+    cachedGatewayTools = resolveToolNames(rawToolData, cachedToolMap);
+    logger.info(`Gateway tool cache rebuilt: ${cachedToolMap.size} tools (was ${prevSize})`, LOG_MODULES.TOOL_LIST_GENERATOR);
+}
+/** Incremental add — update raw data layer, re-resolve names only */
+export function addToCache(serverName, toolNames) {
+    if (!rawToolData) {
+        logger.debug(`Gateway tool cache: raw data not initialized, falling back to full rebuild`, LOG_MODULES.TOOL_LIST_GENERATOR);
+        rebuildFromScratch();
+        return;
+    }
+    // Find tool definitions with instance info from tool cache entries
+    const toolDefs = new Map();
+    const toolIndexes = new Map();
+    for (const [compositeKey, tools] of mcpConnectionManager.getToolCacheEntries()) {
+        const parsed = parseCompositeKey(compositeKey);
+        if (!parsed || parsed.serverName !== serverName)
+            continue;
+        for (const t of tools) {
+            if (toolNames.includes(t.name)) {
+                toolDefs.set(t.name, t);
+                toolIndexes.set(t.name, parsed.serverIndex);
+            }
+        }
+    }
+    const newTools = Array.from(toolDefs.values());
+    const existing = rawToolData.get(serverName);
+    if (existing) {
+        const mergedTools = new Map();
+        for (const t of existing.tools)
+            mergedTools.set(t.name, t);
+        for (const t of newTools)
+            mergedTools.set(t.name, t);
+        const mergedIndexes = new Map(existing.toolIndexes);
+        for (const [name, idx] of toolIndexes) {
+            mergedIndexes.set(name, idx);
+        }
+        existing.tools = Array.from(mergedTools.values());
+        existing.aggregated = [...new Set([...existing.aggregated, ...toolNames])];
+        existing.toolIndexes = mergedIndexes;
+    }
+    else {
+        const serverConfig = hubManager.getServerByName(serverName);
+        rawToolData.set(serverName, {
+            tools: newTools,
+            aggregated: serverConfig?.template?.aggregatedTools ?? toolNames,
+            toolIndexes
+        });
+    }
+    cachedToolMap = new Map();
+    cachedGatewayTools = resolveToolNames(rawToolData, cachedToolMap);
+    logger.info(`Gateway tool cache: added ${toolNames.length} tool(s) from [${serverName}], total=${cachedToolMap.size}`, LOG_MODULES.TOOL_LIST_GENERATOR);
+}
+/** Incremental remove — update raw data layer, re-resolve names only */
+export function removeFromCache(serverName, toolNames) {
+    if (!rawToolData) {
+        logger.debug(`Gateway tool cache: raw data not initialized, falling back to full rebuild`, LOG_MODULES.TOOL_LIST_GENERATOR);
+        rebuildFromScratch();
+        return;
+    }
+    const existing = rawToolData.get(serverName);
+    if (!existing) {
+        logger.debug(`Gateway tool cache: no cached data for [${serverName}], skip remove`, LOG_MODULES.TOOL_LIST_GENERATOR);
+        return;
+    }
+    const removeSet = new Set(toolNames);
+    existing.tools = existing.tools.filter((t) => !removeSet.has(t.name));
+    existing.aggregated = existing.aggregated.filter((t) => !removeSet.has(t));
+    if (existing.aggregated.length === 0) {
+        rawToolData.delete(serverName);
+        logger.info(`Gateway tool cache: all aggregated tools removed from [${serverName}], server removed from cache`, LOG_MODULES.TOOL_LIST_GENERATOR);
+    }
+    cachedToolMap = new Map();
+    cachedGatewayTools = resolveToolNames(rawToolData, cachedToolMap);
+    logger.info(`Gateway tool cache: removed ${toolNames.length} tool(s) from [${serverName}], total=${cachedToolMap.size}`, LOG_MODULES.TOOL_LIST_GENERATOR);
+}

package/dist/server/src/services/hub-manager.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hub-manager.service.d.ts","sourceRoot":"","sources":["../../../../src/services/hub-manager.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,YAAY,EACZ,cAAc,EACd,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAKxC;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,GAAE,aAA6B;IAIlD;;OAEG;IACG,0BAA0B,CAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC,GAChE,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,gCAAgC,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5E;;OAEG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BlE;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC;IAI9D;;OAEG;IACH,aAAa,CACX,EAAE,EAAE,MAAM,GACT;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,GAAG,SAAS;IAe/E;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIvD;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAIxD;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAStD;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAQtF;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAOrF;;;;OAIG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC;IAQ1B;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAkBhG;;OAEG;IACG,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBlD;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAetE;;OAEG;IACG,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D;;OAEG;IACG,qCAAqC,CACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAwBhC;AAED,eAAO,MAAM,UAAU,mBAA0B,CAAC"}
+{"version":3,"file":"hub-manager.service.d.ts","sourceRoot":"","sources":["../../../../src/services/hub-manager.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,YAAY,EACZ,cAAc,EACd,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAKxC;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,GAAE,aAA6B;IAIlD;;OAEG;IACG,0BAA0B,CAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC,GAChE,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,gCAAgC,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5E;;OAEG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BlE;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC;IAI9D;;OAEG;IACH,aAAa,CACX,EAAE,EAAE,MAAM,GACT;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,GAAG,SAAS;IAe/E;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIvD;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAIxD;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAStD;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAQtF;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAOrF;;;;OAIG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC;IAQ1B;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAkChG;;OAEG;IACG,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBlD;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtE;;OAEG;IACG,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D;;OAEG;IACG,qCAAqC,CACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAwBhC;AAED,eAAO,MAAM,UAAU,mBAA0B,CAAC"}

package/dist/server/src/services/hub-manager.service.js

@@ -1,7 +1,7 @@
 import { configManager } from '../config/config-manager.js';
 import { resolveInstanceConfig } from '../config/config-migrator.js';
-import { logger, LOG_MODULES } from '../utils/logger.js';
-import { mcpConnectionManager } from './mcp-connection-manager.js';
+import { logger, LOG_MODULES } from '../utils/logger/index.js';
+import { mcpConnectionManager } from './connection/index.js';
 import { eventBus, EventTypes } from './event-bus.service.js';
 /**
  * Manages MCP server configurations and lifecycle operations through the configuration manager.
@@ -148,11 +148,24 @@ export class HubManagerService {
             logger.warn(`Attempted to update non-existent server: ${name}`, LOG_MODULES.HUB_MANAGER);
             return null;
         }
+        const oldAggregated = existing.template?.aggregatedTools ?? [];
         await this.configManager.updateServer(name, updates);
         logger.info(`Server updated: ${name}`, LOG_MODULES.HUB_MANAGER);
         const updatedServer = this.getServerByName(name) || null;
         if (updatedServer) {
             eventBus.publish(EventTypes.SERVER_UPDATED, { name, config: updatedServer });
+            if ('aggregatedTools' in updates) {
+                const newAggregated = (updates.aggregatedTools ?? []);
+                const oldSet = new Set(oldAggregated);
+                const newSet = new Set(newAggregated);
+                const added = newAggregated.filter((t) => !oldSet.has(t));
+                const removed = oldAggregated.filter((t) => !newSet.has(t));
+                eventBus.publish(EventTypes.AGGREGATED_TOOLS_CHANGED, {
+                    name,
+                    added,
+                    removed
+                });
+            }
         }
         return updatedServer;
     }
@@ -174,7 +187,9 @@ export class HubManagerService {
         }
         const instances = this.getServerInstancesByName(name);
         for (const instance of instances) {
-            await mcpConnectionManager.disconnect(name, instance.index ?? 0).catch(() => { });
+            await mcpConnectionManager
+                .disconnect(name, instance.index ?? 0)
+                .catch((err) => logger.debug(`Disconnect error during server removal: ${err}`, LOG_MODULES.HUB_MANAGER));
         }
         await this.configManager.removeServer(name);
         logger.info(`Server removed: ${name}`, LOG_MODULES.HUB_MANAGER);
@@ -188,7 +203,9 @@ export class HubManagerService {
         const instances = this.getServerInstancesByName(name);
         const instance = instances.find((inst) => inst.index === index);
         if (instance) {
-            await mcpConnectionManager.disconnect(name, instance.index ?? 0).catch(() => { });
+            await mcpConnectionManager
+                .disconnect(name, instance.index ?? 0)
+                .catch((err) => logger.debug(`Disconnect error during instance removal: ${err}`, LOG_MODULES.HUB_MANAGER));
         }
         await this.configManager.removeServerInstance(name, index);
         logger.info(`Server instance removed for server: [${name}] at index: ${index}`, LOG_MODULES.HUB_MANAGER);

package/dist/server/src/services/hub-tools/instance-selector.js

@@ -1,5 +1,5 @@
 import { InstanceSelectionStrategy } from '../../models/server.model.js';
-import { mcpConnectionManager } from '../mcp-connection-manager.js';
+import { mcpConnectionManager } from '../connection/index.js';
 /**
  * Error thrown when tag-match-unique instance selection fails.
  * Passes raw data so the error class itself can format the message.

package/dist/server/src/services/hub-tools/resource-generator.d.ts

@@ -1,26 +1,5 @@
 import type { Resource } from '../../../shared/models/resource.model.js';
 import type { ServerStatus } from '../../../shared/types/common.types.js';
-/**
- * Clears the Hub to MCP URI mapping.
- * Should be called before regenerating resources.
- */
-export declare function clearHubToMcpUriMap(): void;
-/**
- * URI for the use guide resource.
- */
-export declare const USE_GUIDE_URI = "hub://use-guide";
-/**
- * Name of the use guide resource.
- */
-export declare const USE_GUIDE_NAME = "MCP Hub Lite Use Guide";
-/**
- * Description of the use guide resource.
- */
-export declare const USE_GUIDE_DESCRIPTION = "Comprehensive guide to using MCP Hub Lite gateway and its features";
-/**
- * MIME type for the use guide resource.
- */
-export declare const USE_GUIDE_MIME_TYPE = "text/markdown";
 /**
  * Server metadata resource content.
  */

package/dist/server/src/services/hub-tools/resource-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-generator.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/resource-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAUlE;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AA6ID;;GAEG;AACH,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,qBAAqB,uEACoC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,IAAI,QAAQ,EAAE,CAqErD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,GAAG,QAAQ,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,CAyGzD"}
+{"version":3,"file":"resource-generator.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/resource-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAiLlE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,IAAI,QAAQ,EAAE,CAqErD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,GAAG,QAAQ,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,CAyGzD"}

package/dist/server/src/services/hub-tools/resource-generator.js

@@ -2,7 +2,7 @@ import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import fs from 'fs';
 import { hubManager } from '../hub-manager.service.js';
-import { mcpConnectionManager } from '../mcp-connection-manager.js';
+import { mcpConnectionManager } from '../connection/index.js';
 import { hasValidId, selectBestInstance, getServerDescription } from './server-selector.js';
 /**
  * Maps Hub URI to original MCP URI for resource forwarding.
@@ -14,7 +14,7 @@ const hubToMcpUriMap = new Map();
  * Clears the Hub to MCP URI mapping.
  * Should be called before regenerating resources.
  */
-export function clearHubToMcpUriMap() {
+function clearHubToMcpUriMap() {
     hubToMcpUriMap.clear();
 }
 /**
@@ -116,34 +116,34 @@ function loadUseGuideContent() {
     }
     catch {
         // Fallback in case the file can't be read
-        return `# MCP Hub Lite Use Guide
-
-## Overview
-
-MCP Hub Lite is a lightweight MCP (Model Context Protocol) gateway that acts as a unified interface between AI assistants and multiple backend MCP servers.
-
-## Note
-
-The complete use guide is currently unavailable. Please check the MCP Hub Lite documentation at https://github.com/your-org/mcp-hub-lite for more information.
+        return `# MCP Hub Lite Use Guide
+
+## Overview
+
+MCP Hub Lite is a lightweight MCP (Model Context Protocol) gateway that acts as a unified interface between AI assistants and multiple backend MCP servers.
+
+## Note
+
+The complete use guide is currently unavailable. Please check the MCP Hub Lite documentation at https://github.com/your-org/mcp-hub-lite for more information.
 `;
     }
 }
 /**
  * URI for the use guide resource.
  */
-export const USE_GUIDE_URI = 'hub://use-guide';
+const USE_GUIDE_URI = 'hub://use-guide';
 /**
  * Name of the use guide resource.
  */
-export const USE_GUIDE_NAME = 'MCP Hub Lite Use Guide';
+const USE_GUIDE_NAME = 'MCP Hub Lite Use Guide';
 /**
  * Description of the use guide resource.
  */
-export const USE_GUIDE_DESCRIPTION = 'Comprehensive guide to using MCP Hub Lite gateway and its features';
+const USE_GUIDE_DESCRIPTION = 'Comprehensive guide to using MCP Hub Lite gateway and its features';
 /**
  * MIME type for the use guide resource.
  */
-export const USE_GUIDE_MIME_TYPE = 'text/markdown';
+const USE_GUIDE_MIME_TYPE = 'text/markdown';
 /**
  * Generates dynamic Hub resources based on currently connected MCP servers.
  *

package/dist/server/src/services/hub-tools/server-selector.js

@@ -1,6 +1,6 @@
 import { hubManager } from '../hub-manager.service.js';
 import { InstanceSelector, TagMatchUniqueError } from './instance-selector.js';
-import { logger } from '../../utils/logger.js';
+import { logger } from '../../utils/logger/index.js';
 import { LOG_MODULES } from '../../utils/logger/log-modules.js';
 /**
  * Gets the description for a server, using the server name as default if none is provided.

package/dist/server/src/services/hub-tools/system-tool-definitions.d.ts

@@ -31,6 +31,7 @@ export interface SystemToolDefinition {
  * - get-tool: Get complete tool schema
  * - call-tool: Call a specific tool from a specific server
  * - update-server-description: Update the description of a specific MCP server
+ * - search-tools: Search for tools across all connected servers
  *
  * @returns {Array<{ name: string; description: string; inputSchema: JsonSchema; annotations?: ToolAnnotations }>}
  * Array of system tool configurations

package/dist/server/src/services/hub-tools/system-tool-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-tool-definitions.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/system-tool-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAW/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,EAAE,CAiKvD"}
+{"version":3,"file":"system-tool-definitions.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/system-tool-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAY/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,EAAE,CAwLvD"}

package/dist/server/src/services/hub-tools/system-tool-definitions.js

@@ -1,4 +1,4 @@
-import { SYSTEM_TOOL_NAMES, LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, LIST_TAGS_TOOL } from '../../models/system-tools.constants.js';
+import { SYSTEM_TOOL_NAMES, LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, LIST_TAGS_TOOL, SEARCH_TOOLS_TOOL } from '../../models/system-tools.constants.js';
 /**
  * Retrieves the complete list of system tools provided by this service.
  *
@@ -12,6 +12,7 @@ import { SYSTEM_TOOL_NAMES, LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, C
  * - get-tool: Get complete tool schema
  * - call-tool: Call a specific tool from a specific server
  * - update-server-description: Update the description of a specific MCP server
+ * - search-tools: Search for tools across all connected servers
  *
  * @returns {Array<{ name: string; description: string; inputSchema: JsonSchema; annotations?: ToolAnnotations }>}
  * Array of system tool configurations
@@ -174,6 +175,29 @@ export function getSystemTools() {
                     }
                 });
                 break;
+            case SEARCH_TOOLS_TOOL:
+                systemTools.push({
+                    name: toolName,
+                    description: 'Search for tools across all connected MCP servers by name or description',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            query: {
+                                type: 'string',
+                                description: 'Search query to match against tool names and descriptions'
+                            }
+                        },
+                        required: ['query']
+                    },
+                    annotations: {
+                        title: 'Search Tools',
+                        readOnlyHint: true,
+                        destructiveHint: false,
+                        idempotentHint: true,
+                        openWorldHint: false
+                    }
+                });
+                break;
             default:
                 // This should never happen due to TypeScript type checking
                 throw new Error(`Unknown system tool: ${toolName}`);

package/dist/server/src/services/hub-tools.service.d.ts

@@ -1,7 +1,7 @@
 import type { Tool, ToolSummary } from '../../shared/models/tool.model.js';
 import type { Resource } from '../../shared/models/resource.model.js';
-import { LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, LIST_TAGS_TOOL } from '../models/system-tools.constants.js';
-import type { SystemToolName, ListServersParams, ListToolsInServerParams, GetToolParams, CallToolParams, UpdateServerDescriptionParams, ListTagsParams } from '../models/system-tools.constants.js';
+import { LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, LIST_TAGS_TOOL, SEARCH_TOOLS_TOOL } from '../models/system-tools.constants.js';
+import type { SystemToolName, ListServersParams, ListToolsInServerParams, GetToolParams, CallToolParams, UpdateServerDescriptionParams, ListTagsParams, SearchToolsParams } from '../models/system-tools.constants.js';
 /**
  * Central service for managing system tools and MCP server interactions in the MCP Hub Lite gateway.
  *
@@ -149,7 +149,7 @@ export declare class HubToolsService {
      * @returns {Promise<ConditionalReturnType>} Tool execution result with accurate type safety matching actual method return types
      * @throws {Error} If the system tool is not found or execution fails
      */
-    callSystemTool<T extends SystemToolName>(toolName: T, toolArgs: T extends typeof LIST_SERVERS_TOOL ? ListServersParams : T extends typeof LIST_TOOLS_TOOL ? ListToolsInServerParams : T extends typeof GET_TOOL_TOOL ? GetToolParams : T extends typeof CALL_TOOL_TOOL ? CallToolParams : T extends typeof UPDATE_SERVER_DESCRIPTION_TOOL ? UpdateServerDescriptionParams : T extends typeof LIST_TAGS_TOOL ? ListTagsParams : never): Promise<T extends typeof LIST_SERVERS_TOOL ? Record<string, string> : T extends typeof LIST_TOOLS_TOOL ? {
+    callSystemTool<T extends SystemToolName>(toolName: T, toolArgs: T extends typeof LIST_SERVERS_TOOL ? ListServersParams : T extends typeof LIST_TOOLS_TOOL ? ListToolsInServerParams : T extends typeof GET_TOOL_TOOL ? GetToolParams : T extends typeof CALL_TOOL_TOOL ? CallToolParams : T extends typeof UPDATE_SERVER_DESCRIPTION_TOOL ? UpdateServerDescriptionParams : T extends typeof LIST_TAGS_TOOL ? ListTagsParams : T extends typeof SEARCH_TOOLS_TOOL ? SearchToolsParams : never): Promise<T extends typeof LIST_SERVERS_TOOL ? Record<string, string> : T extends typeof LIST_TOOLS_TOOL ? {
         serverName: string;
         tools: ToolSummary[];
     } : T extends typeof GET_TOOL_TOOL ? Tool | undefined : T extends typeof CALL_TOOL_TOOL ? unknown : T extends typeof UPDATE_SERVER_DESCRIPTION_TOOL ? {
@@ -163,7 +163,10 @@ export declare class HubToolsService {
             id: string;
             tags: Record<string, string>;
         }>;
-    } : never>;
+    } : T extends typeof SEARCH_TOOLS_TOOL ? Record<string, {
+        description: string;
+        tools: ToolSummary[];
+    }> : never>;
     /**
      * Calls a specific tool from a specific MCP server with comprehensive event tracking.
      *
@@ -189,6 +192,20 @@ export declare class HubToolsService {
     listAllTools(): Promise<Record<string, {
         tools: ToolSummary[];
     }>>;
+    /**
+     * Searches for tools matching the query across all connected MCP servers.
+     *
+     * Results are grouped by server name, and only servers with at least one
+     * matching tool are included. Matching is case-insensitive on tool name and description.
+     *
+     * @param {string} query - Search query string for matching tool names and descriptions
+     * @returns {Promise<Record<string, { description: string; tools: ToolSummary[] }>>}
+     * Object mapping server names to their descriptions and matching tools
+     */
+    searchTools(query: string): Promise<Record<string, {
+        description: string;
+        tools: ToolSummary[];
+    }>>;
     /**
      * Lists all dynamically generated Hub resources based on connected MCP servers.
      *