@loop_ouroboros/mcp-hub-lite 1.2.9 → 1.3.1

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;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"}
+{"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;
     }

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.
  */
@@ -79,5 +58,5 @@ export declare function generateDynamicResources(): Resource[];
  * const tools = await readResource('hub://servers/my-mcp-server/tools');
  * ```
  */
-export declare function readResource(uri: string): Promise<ServerMetadata | Resource[] | string | unknown>;
+export declare function readResource(uri: string, language?: string): Promise<ServerMetadata | Resource[] | string | unknown>;
 //# sourceMappingURL=resource-generator.d.ts.map

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;AAmLlE;;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,EACX,QAAQ,CAAC,EAAE,MAAM,GAChB,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();
 }
 /**
@@ -104,46 +104,48 @@ function parseHubUri(uri) {
  */
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const USE_GUIDE_PATH = join(__dirname, 'use-guide.md');
+const USE_GUIDE_PATH_ZH = join(__dirname, 'use-guide-zh.md');
+const USE_GUIDE_PATH_EN = join(__dirname, 'use-guide-en.md');
 /**
  * Loads the use guide content from the Markdown file.
  *
- * @returns {string} Markdown formatted use guide content
+ * @param language - Language code ('zh' for Chinese, defaults to 'en')
+ * @returns Markdown formatted use guide content
  */
-function loadUseGuideContent() {
+function loadUseGuideContent(language) {
+    const path = language === 'zh' ? USE_GUIDE_PATH_ZH : USE_GUIDE_PATH_EN;
     try {
-        return fs.readFileSync(USE_GUIDE_PATH, 'utf-8');
+        return fs.readFileSync(path, 'utf-8');
     }
     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.
+
+Use \`resources/list\` to discover servers, then \`list_tools\` / \`get_tool\` / \`call_tool\` to interact with them.
+
+The complete use guide is currently unavailable. Please check the documentation 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.
  *
@@ -248,14 +250,14 @@ export function generateDynamicResources() {
  * const tools = await readResource('hub://servers/my-mcp-server/tools');
  * ```
  */
-export async function readResource(uri) {
+export async function readResource(uri, language) {
     // Validate URI format
     if (!uri.startsWith('hub://')) {
         throw new Error(`Invalid Hub resource URI: ${uri}. Must start with 'hub://'`);
     }
     // Check for use-guide resource first
     if (uri === USE_GUIDE_URI) {
-        return loadUseGuideContent();
+        return loadUseGuideContent(language);
     }
     // Parse URI
     const parsed = parseHubUri(uri);

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.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hub-tools.service.d.ts","sourceRoot":"","sources":["../../../../src/services/hub-tools.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hub-tools.service.d.ts","sourceRoot":"","sources":["../../../../src/services/hub-tools.service.ts"],"names":[],"mappings":"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"}

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

@@ -1,8 +1,9 @@
 import { hubManager } from './hub-manager.service.js';
-import { mcpConnectionManager } from './mcp-connection-manager.js';
+import { mcpConnectionManager } from './connection/index.js';
+import { configManager } from '../config/config-manager.js';
 import { eventBus, EventTypes } from './event-bus.service.js';
-import { gateway } from './gateway.service.js';
-import { logger, LOG_MODULES } from '../utils/logger.js';
+import { generateGatewayToolsList } from './gateway/tool-list-generator.js';
+import { logger, LOG_MODULES } from '../utils/logger/index.js';
 import { stringifyForLogging } from '../utils/json-utils.js';
 import { normalizeToolName } from '../utils/name-converter.js';
 import { McpError } from '@modelcontextprotocol/sdk/types.js';
@@ -96,12 +97,6 @@ export class HubToolsService {
             if (indexes.length === 0) {
                 continue;
             }
-            // Use non-strict mode for management operations to avoid tag-match-unique errors
-            const serverInfo = selectBestInstance(server.name, undefined, false);
-            if (!serverInfo) {
-                // Skip servers that can't be selected (e.g., tag-match-unique without tags)
-                continue;
-            }
             const description = getServerDescription(server.config, server.name);
             result[server.name] = description;
         }
@@ -127,7 +122,7 @@ export class HubToolsService {
         if (typeof args.serverName === 'string' && args.serverName === MCP_HUB_LITE_SERVER) {
             // Generate tool list using the same logic as tools/list
             const toolMap = new Map();
-            const gatewayTools = gateway.generateGatewayToolsList(toolMap);
+            const gatewayTools = generateGatewayToolsList(toolMap);
             // Convert to ToolSummary format (without inputSchema)
             const toolSummaries = gatewayTools.map((tool) => ({
                 name: tool.name,
@@ -344,8 +339,17 @@ export class HubToolsService {
     async callTool(args) {
         let { serverName, toolName } = args;
         // Support both toolArgs and arguments for backward compatibility
-        const toolArgs = (args.toolArgs || args.arguments || {});
-        const { requestOptions } = args;
+        let toolArgs = (args.toolArgs || args.arguments || {});
+        let { requestOptions } = args;
+        // Unwrap gateway-wrapped arguments: if toolArgs itself contains a nested
+        // toolArgs property (the wrapped schema), extract the real tool arguments.
+        if (toolArgs && typeof toolArgs.toolArgs === 'object' && toolArgs.toolArgs !== null) {
+            const wrapped = toolArgs;
+            toolArgs = wrapped.toolArgs;
+            if (wrapped.requestOptions && !requestOptions) {
+                requestOptions = wrapped.requestOptions;
+            }
+        }
         // Parse prefixed tool names (like mcp__mcp-hub-lite__xxx) if applicable
         const parsedTool = ToolArgsParser.parsePrefixedToolName(toolName);
         if (parsedTool) {
@@ -665,7 +669,8 @@ export class HubToolsService {
      * @throws {Error} If URI format is invalid, server not found, or resource type unknown
      */
     async readResource(uri) {
-        return readResourceUtil(uri);
+        const language = configManager.getConfig().system.language;
+        return readResourceUtil(uri, language);
     }
 }
 export const hubToolsService = new HubToolsService();

package/dist/server/src/services/log-storage.service.js

@@ -1,4 +1,4 @@
-import { logger, LOG_MODULES } from '../utils/logger.js';
+import { logger, LOG_MODULES } from '../utils/logger/index.js';
 import { eventBus, EventTypes } from './event-bus.service.js';
 /**
  * Service for managing and storing log entries for MCP servers.