@loop_ouroboros/mcp-hub-lite 1.0.2 → 1.1.1

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

@@ -1,7 +1,7 @@
-import type { Tool } from '../../shared/models/tool.model.js';
+import type { Tool, ToolSummary } from '../../shared/models/tool.model.js';
 import type { Resource } from '../../shared/models/resource.model.js';
-import { LIST_SERVERS_TOOL, FIND_SERVERS_TOOL, LIST_ALL_TOOLS_IN_SERVER_TOOL, FIND_TOOLS_IN_SERVER_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, FIND_TOOLS_TOOL } from '../models/system-tools.constants.js';
-import type { SystemToolName, ListServersParams, FindServersParams, ListAllToolsInServerParams, FindToolsInServerParams, GetToolParams, CallToolParams, FindToolsParams } from '../models/system-tools.constants.js';
+import { LIST_SERVERS_TOOL, LIST_TOOLS_IN_SERVER_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL } from '../models/system-tools.constants.js';
+import type { SystemToolName, ListServersParams, ListToolsInServerParams, GetToolParams, CallToolParams, UpdateServerDescriptionParams } from '../models/system-tools.constants.js';
 /**
  * Central service for managing system tools and MCP server interactions in the MCP Hub Lite gateway.
  *
@@ -13,7 +13,7 @@ import type { SystemToolName, ListServersParams, FindServersParams, ListAllTools
  * ## Core Responsibilities
  *
  * - **System Tool Management**: Exposes a standardized set of system tools for server discovery and management
- * - **Tool Discovery**: Enables searching and listing tools across all connected MCP servers
+ * - **Tool Discovery**: Enables listing tools across all connected MCP servers
  * - **Tool Execution**: Provides safe, monitored execution of tools with comprehensive event tracking
  * - **Resource Management**: Dynamically generates and serves virtual resources representing server state
  * - **Instance Selection**: Handles intelligent server instance selection for multi-instance scenarios
@@ -23,12 +23,9 @@ import type { SystemToolName, ListServersParams, FindServersParams, ListAllTools
  *
  * The service exposes the following system tools through the `getSystemTools()` method:
  * - `list-servers`: Retrieve all connected server names
- * - `find-servers`: Search servers by pattern matching
- * - `list-all-tools-in-server`: List all tools from a specific server
- * - `find-tools-in-server`: Search tools within a specific server
+ * - `list-tools-in-server`: List all tools from a specific server
  * - `get-tool`: Retrieve complete schema for a specific tool
  * - `call-tool`: Execute a tool on a specific server
- * - `find-tools`: Search tools across all connected servers
  *
  * ## Architecture Integration
  *
@@ -50,9 +47,6 @@ import type { SystemToolName, ListServersParams, FindServersParams, ListAllTools
  *
  * // Call a tool on a specific server
  * const result = await hubTools.callTool('file-system-server', 'list-files', { directory: '/home' });
- *
- * // Search for tools across all servers
- * const matchingTools = await hubTools.findTools('search');
  * ```
  */
 export declare class HubToolsService {
@@ -73,26 +67,16 @@ export declare class HubToolsService {
      */
     getSystemTools(): import("./hub-tools/system-tool-definitions.js").SystemToolDefinition[];
     /**
-     * Lists all connected MCP servers by name.
+     * Lists all connected MCP servers with their descriptions.
      *
      * This method retrieves all configured servers from the hub manager, filters out
-     * invalid entries using the hasValidId type guard, and returns an array of server names.
-     * It provides a simple way to discover available servers in the system.
-     *
-     * @returns {Promise<string[]>} Array of connected server names
-     */
-    listServers(): Promise<string[]>;
-    /**
-     * Finds servers matching a specified regex pattern.
-     *
-     * This method searches through all configured servers using the provided regex pattern,
-     * supporting flexible search options including case sensitivity and search scope
-     * (name, description, or both). It returns an array of matching server names.
+     * invalid entries using the hasValidId type guard, and returns a Record mapping
+     * server names to their descriptions. If a server doesn't have a description,
+     * a default description is provided.
      *
-     * @param {FindServersParams} args - Search parameters
-     * @returns {Promise<string[]>} Array of matching server names
+     * @returns {Promise<Record<string, string>>} Record mapping server names to descriptions
      */
-    findServers(args: FindServersParams): Promise<string[]>;
+    listServers(): Promise<Record<string, string>>;
     /**
      * Lists all tools available from a specific MCP server.
      *
@@ -101,29 +85,13 @@ export declare class HubToolsService {
      * It uses the selectBestInstance function to resolve server names to instances
      * and leverages the MCP connection manager for tool retrieval.
      *
-     * @param {ListAllToolsInServerParams} args - Server name and request options
-     * @returns {Promise<{ serverName: string; tools: Tool[] }>} Object containing server name and tools array
-     * @throws {Error} If the specified server is not found or not connected
-     */
-    listAllToolsInServer(args: ListAllToolsInServerParams): Promise<{
-        serverName: string;
-        tools: Tool[];
-    }>;
-    /**
-     * Finds tools matching a pattern within a specific MCP server.
-     *
-     * This method searches through all tools available from the specified server using
-     * the provided regex pattern, supporting flexible search options including case
-     * sensitivity and search scope (name, description, or both). It returns matching
-     * tools grouped by server name.
-     *
-     * @param {FindToolsInServerParams} args - Search parameters
-     * @returns {Promise<{ serverName: string; tools: Tool[] }>} Object containing server name and matching tools
+     * @param {ListToolsInServerParams} args - Server name and request options
+     * @returns {Promise<{ serverName: string; tools: ToolSummary[] }>} Object containing server name and tools array
      * @throws {Error} If the specified server is not found or not connected
      */
-    findToolsInServer(args: FindToolsInServerParams): Promise<{
+    listToolsInServer(args: ListToolsInServerParams): Promise<{
         serverName: string;
-        tools: Tool[];
+        tools: ToolSummary[];
     }>;
     /**
      * Retrieves the complete schema for a specific tool from a specific server.
@@ -137,6 +105,22 @@ export declare class HubToolsService {
      * @throws {Error} If the specified server is not found or not connected
      */
     getTool(args: GetToolParams): Promise<Tool | undefined>;
+    /**
+     * Updates the description of a specific MCP server.
+     *
+     * This method validates the server exists, updates its description in the configuration,
+     * and persists the change to disk. It leverages the existing hubManager.updateServer()
+     * method which handles configuration persistence and event publishing.
+     *
+     * @param {UpdateServerDescriptionParams} args - Server name and new description
+     * @returns {Promise<{ success: boolean; serverName: string; description: string }>} Confirmation of successful update
+     * @throws {Error} If the server is not found or update fails
+     */
+    updateServerDescription(args: UpdateServerDescriptionParams): Promise<{
+        success: boolean;
+        serverName: string;
+        description: string;
+    }>;
     /**
      * Calls a specific system tool directly with type-safe conditional return types.
      *
@@ -149,15 +133,14 @@ 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 FIND_SERVERS_TOOL ? FindServersParams : T extends typeof LIST_ALL_TOOLS_IN_SERVER_TOOL ? ListAllToolsInServerParams : T extends typeof FIND_TOOLS_IN_SERVER_TOOL ? FindToolsInServerParams : T extends typeof GET_TOOL_TOOL ? GetToolParams : T extends typeof CALL_TOOL_TOOL ? CallToolParams : T extends typeof FIND_TOOLS_TOOL ? FindToolsParams : never): Promise<T extends typeof LIST_SERVERS_TOOL ? string[] : T extends typeof FIND_SERVERS_TOOL ? string[] : T extends typeof LIST_ALL_TOOLS_IN_SERVER_TOOL ? {
+    callSystemTool<T extends SystemToolName>(toolName: T, toolArgs: T extends typeof LIST_SERVERS_TOOL ? ListServersParams : T extends typeof LIST_TOOLS_IN_SERVER_TOOL ? ListToolsInServerParams : T extends typeof GET_TOOL_TOOL ? GetToolParams : T extends typeof CALL_TOOL_TOOL ? CallToolParams : T extends typeof UPDATE_SERVER_DESCRIPTION_TOOL ? UpdateServerDescriptionParams : never): Promise<T extends typeof LIST_SERVERS_TOOL ? Record<string, string> : T extends typeof LIST_TOOLS_IN_SERVER_TOOL ? {
         serverName: string;
-        tools: Tool[];
-    } : T extends typeof FIND_TOOLS_IN_SERVER_TOOL ? {
+        tools: ToolSummary[];
+    } : T extends typeof GET_TOOL_TOOL ? Tool | undefined : T extends typeof CALL_TOOL_TOOL ? unknown : T extends typeof UPDATE_SERVER_DESCRIPTION_TOOL ? {
+        success: boolean;
         serverName: string;
-        tools: Tool[];
-    } : T extends typeof GET_TOOL_TOOL ? Tool | undefined : T extends typeof CALL_TOOL_TOOL ? unknown : T extends typeof FIND_TOOLS_TOOL ? Record<string, {
-        tools: Tool[];
-    }> : never>;
+        description: string;
+    } : never>;
     /**
      * Calls a specific tool from a specific MCP server with comprehensive event tracking.
      *
@@ -178,24 +161,10 @@ export declare class HubToolsService {
      * the system tools provided by the MCP Hub Lite server itself. It returns a structured
      * object mapping server names to their respective tool arrays.
      *
-     * @returns {Promise<Record<string, { tools: Tool[] }>>} Object mapping server names to tool arrays
+     * @returns {Promise<Record<string, { tools: ToolSummary[] }>>} Object mapping server names to tool arrays
      */
     listAllTools(): Promise<Record<string, {
-        tools: Tool[];
-    }>>;
-    /**
-     * Finds tools matching a pattern across all connected MCP servers.
-     *
-     * This method searches through all available tools from all connected servers using the
-     * provided regex pattern, supporting flexible search options including case sensitivity
-     * and search scope (name, description, or both). It returns matching tools grouped by
-     * their originating server names.
-     *
-     * @param {FindToolsParams} args - Search parameters
-     * @returns {Promise<Record<string, { tools: Tool[] }>>} Object mapping server names to matching tools
-     */
-    findTools(args: FindToolsParams): Promise<Record<string, {
-        tools: Tool[];
+        tools: ToolSummary[];
     }>>;
     /**
      * Lists all dynamically generated Hub resources based on connected MCP servers.
@@ -218,18 +187,20 @@ export declare class HubToolsService {
      * - Resources list: hub://servers/{serverName}/resources
      *
      * @param {string} uri - Resource URI to read (e.g., hub://servers/server-name)
-     * @returns {Promise<ServerMetadata | Tool[] | Resource[]>} Resource content based on URI type
+     * @returns {Promise<ServerMetadata | Tool[] | Resource[] | string>} Resource content based on URI type
      * @throws {Error} If URI format is invalid, server not found, or resource type unknown
      */
     readResource(uri: string): Promise<{
         name: string;
         status: unknown;
         toolsCount: number;
+        tools: Record<string, string>;
         resourcesCount: number;
         tags: Record<string, string>;
         lastHeartbeat: number;
         uptime: number;
-    } | Tool[] | Resource[]>;
+        description: string;
+    } | Tool[] | Resource[] | string>;
 }
 export declare const hubToolsService: HubToolsService;
 //# sourceMappingURL=hub-tools.service.d.ts.map

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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"}