@loop_ouroboros/mcp-hub-lite 1.0.1 → 1.1.0

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

@@ -1,95 +1,32 @@
-import { ConfigManager, ServerConfig, ServerInstanceConfig } from '../config/config-manager.js';
+import { ConfigManager, ServerConfig, ServerInstance, ServerTemplate } from '../config/config-manager.js';
+import type { ServerRuntimeConfig, InstanceSelectionStrategy } from '../../shared/models/server.model.js';
 /**
  * Manages MCP server configurations and lifecycle operations through the configuration manager.
  *
  * This service provides a comprehensive interface for CRUD operations on MCP servers,
  * including batch operations for performance optimization, instance management, and
- * event-driven communication with other system components. It serves as the primary
- * entry point for server management operations in the MCP Hub Lite system.
- *
- * The service integrates with the configuration manager for persistence and the
- * MCP connection manager for automatic connection handling, while publishing
- * events to notify other components of state changes.
- *
- * @example
- * ```typescript
- * const hubManager = new HubManagerService();
- * await hubManager.addServer('my-server', { type: 'stdio', command: 'npx my-mcp' });
- * await hubManager.removeServer('my-server');
- * ```
+ * event-driven communication with other system components.
  */
 export declare class HubManagerService {
     private configManager;
     constructor(manager?: ConfigManager);
     /**
      * Adds multiple server configurations in a single batch operation without auto-starting.
-     *
-     * This method optimizes performance for bulk server addition by batching configuration
-     * updates and saving the configuration only once at the end. It publishes SERVER_ADDED
-     * events for each newly added server to notify other system components.
-     *
-     * @param {Array<{ name: string; config: Partial<ServerConfig> }>} servers - Array of server configurations to add
-     * @returns {Promise<void>} Resolves when all servers are added and configuration is saved
-     *
-     * @example
-     * ```typescript
-     * await hubManager.addServersWithoutAutoStart([
-     *   { name: 'server1', config: { type: 'stdio', command: 'npx server1' } },
-     *   { name: 'server2', config: { type: 'http', url: 'http://localhost:8080' } }
-     * ]);
-     * ```
      */
     addServersWithoutAutoStart(servers: Array<{
         name: string;
-        config: Partial<ServerConfig>;
+        config: Partial<ServerTemplate>;
     }>): Promise<void>;
     /**
      * Creates server instances for multiple servers without automatically connecting them.
-     *
-     * This method iterates through the provided server names and creates a new instance
-     * for each server using the configuration manager. It publishes SERVER_INSTANCE_ADDED
-     * events for each created instance to notify other system components.
-     *
-     * @param {string[]} serverNames - Array of server names to create instances for
-     * @returns {Promise<void>} Resolves when all instances are created
-     *
-     * @example
-     * ```typescript
-     * await hubManager.addServerInstancesWithoutConnect(['server1', 'server2']);
-     * ```
      */
     addServerInstancesWithoutConnect(serverNames: string[]): Promise<void>;
     /**
-     * Concurrently connects to multiple server instances using Promise.all for efficiency.
-     *
-     * This method iterates through the provided server names, retrieves their configurations
-     * and instances, and attempts to connect to each instance concurrently. It only attempts
-     * to connect to servers that are enabled in their configuration. Errors during connection
-     * are logged but don't prevent other connections from proceeding.
-     *
-     * @param {string[]} serverNames - Array of server names to connect instances for
-     * @returns {Promise<void>} Resolves when all connection attempts complete
-     *
-     * @example
-     * ```typescript
-     * await hubManager.connectServerInstances(['server1', 'server2']);
-     * ```
+     * Concurrently connects to multiple server instances.
      */
     connectServerInstances(serverNames: string[]): Promise<void>;
     /**
-     * Retrieves all configured servers with their names and configurations.
-     *
-     * This method delegates to the configuration manager to return a complete list of
-     * all servers that have been configured in the system, including their full
-     * configuration objects.
-     *
-     * @returns {Array<{ name: string; config: ServerConfig }>} Array of all configured servers
-     *
-     * @example
-     * ```typescript
-     * const servers = hubManager.getAllServers();
-     * console.log(`Total servers: ${servers.length}`);
-     * ```
+     * Retrieves all configured servers.
      */
     getAllServers(): Array<{
         name: string;
@@ -97,203 +34,60 @@ export declare class HubManagerService {
     }>;
     /**
      * Retrieves a server configuration and instance by its unique instance ID.
-     *
-     * This method performs an O(n) search across all servers and their instances to find
-     * the matching instance ID. It returns a composite object containing the server name,
-     * full configuration, and specific instance configuration.
-     *
-     * @param {string} id - Unique instance ID to search for
-     * @returns {{ name: string; config: ServerConfig; instance: ServerInstanceConfig } | undefined}
-     * Composite server/instance object or undefined if not found
-     *
-     * @example
-     * ```typescript
-     * const serverInfo = hubManager.getServerById('instance-123');
-     * if (serverInfo) {
-     *   console.log(`Found server: ${serverInfo.name}`);
-     * }
-     * ```
      */
     getServerById(id: string): {
         name: string;
         config: ServerConfig;
-        instance: ServerInstanceConfig;
+        instance: ServerInstance;
     } | undefined;
     /**
-     * Retrieves a server configuration by its name.
-     *
-     * This method delegates to the configuration manager to return the full configuration
-     * for a server with the specified name, or undefined if no such server exists.
-     *
-     * @param {string} name - Server name to look up
-     * @returns {ServerConfig | undefined} Full server configuration or undefined if not found
-     *
-     * @example
-     * ```typescript
-     * const config = hubManager.getServerByName('my-server');
-     * if (config) {
-     *   console.log(`Server type: ${config.type}`);
-     * }
-     * ```
+     * Retrieves a server configuration by name.
      */
     getServerByName(name: string): ServerConfig | undefined;
+    /**
+     * Retrieves all instances for a specific server by name.
+     */
+    getServerInstancesByName(name: string): ServerInstance[];
     /**
      * Retrieves all server instances grouped by server name.
-     *
-     * This method returns a record mapping server names to arrays of their instance configurations,
-     * providing a complete view of all server instances in the system.
-     *
-     * @returns {Record<string, ServerInstanceConfig[]>} Object mapping server names to instance arrays
-     *
-     * @example
-     * ```typescript
-     * const instances = hubManager.getServerInstances();
-     * Object.entries(instances).forEach(([name, instances]) => {
-     *   console.log(`${name} has ${instances.length} instances`);
-     * });
-     * ```
      */
-    getServerInstances(): Record<string, ServerInstanceConfig[]>;
+    getServerInstances(): Record<string, ServerInstance[]>;
     /**
-     * Retrieves all instances for a specific server by name.
-     *
-     * This method returns an array of all instance configurations for the specified server,
-     * or an empty array if the server doesn't exist or has no instances.
-     *
-     * @param {string} name - Server name to get instances for
-     * @returns {ServerInstanceConfig[]} Array of instance configurations for the server
-     *
-     * @example
-     * ```typescript
-     * const instances = hubManager.getServerInstanceByName('my-server');
-     * console.log(`Server has ${instances.length} instances`);
-     * ```
+     * Gets the resolved server configuration by merging template and instance.
      */
-    getServerInstanceByName(name: string): ServerInstanceConfig[];
+    getResolvedServerConfig(name: string, instanceId?: string): ServerRuntimeConfig | null;
     /**
      * Adds a new server configuration to the system.
-     *
-     * This method creates a new server with the specified name and configuration,
-     * logs the addition, and publishes a SERVER_ADDED event to notify other system components.
-     * The method returns the complete server configuration after validation and normalization.
-     *
-     * @param {string} name - Unique name for the new server
-     * @param {Partial<ServerConfig>} config - Partial server configuration to merge with defaults
-     * @returns {Promise<ServerConfig>} Complete server configuration after creation
-     *
-     * @example
-     * ```typescript
-     * const config = await hubManager.addServer('my-server', {
-     *   type: 'stdio',
-     *   command: 'npx my-mcp-server'
-     * });
-     * console.log('Server added successfully');
-     * ```
      */
-    addServer(name: string, config: Partial<ServerConfig>): Promise<ServerConfig>;
+    addServer(name: string, config: Partial<ServerTemplate>): Promise<ServerConfig>;
     /**
-     * Adds a new instance to an existing server and optionally connects to it.
-     *
-     * This method creates a new instance for the specified server, and if the server is enabled,
-     * automatically attempts to connect to the new instance. It publishes a SERVER_INSTANCE_ADDED
-     * event to notify other system components and returns the complete instance configuration.
-     *
-     * @param {string} name - Name of the existing server to add an instance to
-     * @param {Partial<ServerInstanceConfig>} instance - Partial instance configuration to merge with defaults
-     * @returns {Promise<ServerInstanceConfig>} Complete instance configuration after creation
-     * @throws {Error} If the server doesn't exist or connection fails (logged but not thrown)
-     *
-     * @example
-     * ```typescript
-     * const instance = await hubManager.addServerInstance('my-server', {
-     *   cwd: '/path/to/working/directory'
-     * });
-     * console.log('Server instance added successfully');
-     * ```
+     * Adds a new instance to an existing server.
      */
-    addServerInstance(name: string, instance: Partial<ServerInstanceConfig>): Promise<ServerInstanceConfig>;
+    addServerInstance(name: string, instance: Partial<ServerInstance>): Promise<ServerInstance>;
     /**
-     * Updates an existing server configuration with new values.
-     *
-     * This method validates that the server exists before applying updates, logs the operation,
-     * and publishes a SERVER_UPDATED event to notify other system components. It returns the
-     * updated server configuration or null if the server doesn't exist.
-     *
-     * @param {string} name - Name of the server to update
-     * @param {Partial<ServerConfig>} updates - Partial configuration updates to apply
-     * @returns {Promise<ServerConfig | null>} Updated server configuration or null if not found
-     *
-     * @example
-     * ```typescript
-     * const updated = await hubManager.updateServer('my-server', {
-     *   enabled: false
-     * });
-     * if (updated) {
-     *   console.log('Server updated successfully');
-     * }
-     * ```
+     * Updates an existing server template configuration.
      */
-    updateServer(name: string, updates: Partial<ServerConfig>): Promise<ServerConfig | null>;
+    updateServer(name: string, updates: Partial<ServerTemplate>): Promise<ServerConfig | null>;
     /**
-     * Updates a specific server instance at the given index.
-     *
-     * This method applies updates to the server instance at the specified index within the
-     * server's instance array, logs the operation, and publishes a SERVER_INSTANCE_UPDATED
-     * event to notify other system components.
-     *
-     * @param {string} name - Name of the server containing the instance to update
-     * @param {number} index - Index of the instance within the server's instance array
-     * @param {Partial<ServerInstanceConfig>} updates - Partial instance configuration updates to apply
-     * @returns {Promise<void>} Resolves when the update is complete
-     * @throws {Error} If the server or instance index doesn't exist
-     *
-     * @example
-     * ```typescript
-     * await hubManager.updateServerInstance('my-server', 0, {
-     *   cwd: '/new/working/directory'
-     * });
-     * console.log('Server instance updated successfully');
-     * ```
+     * Updates a specific server instance.
      */
-    updateServerInstance(name: string, index: number, updates: Partial<ServerInstanceConfig>): Promise<void>;
+    updateServerInstance(name: string, index: number, updates: Partial<ServerInstance>): Promise<void>;
     /**
-     * Removes a server and all its instances from the system.
-     *
-     * This method performs a graceful shutdown by first disconnecting all instances of the server,
-     * then removing the server configuration from the system. It publishes a SERVER_DELETED event
-     * to notify other system components and returns true if the server existed and was removed.
-     *
-     * @param {string} name - Name of the server to remove
-     * @returns {Promise<boolean>} True if server existed and was removed, false if not found
-     *
-     * @example
-     * ```typescript
-     * const removed = await hubManager.removeServer('my-server');
-     * if (removed) {
-     *   console.log('Server removed successfully');
-     * }
-     * ```
+     * Removes a server and all its instances.
      */
     removeServer(name: string): Promise<boolean>;
     /**
-     * Removes a specific server instance at the given index.
-     *
-     * This method performs a graceful shutdown by first disconnecting the specified instance,
-     * then removing it from the server's instance array. It publishes a SERVER_INSTANCE_DELETED
-     * event to notify other system components and logs the operation.
-     *
-     * @param {string} name - Name of the server containing the instance to remove
-     * @param {number} index - Index of the instance within the server's instance array
-     * @returns {Promise<void>} Resolves when the instance is removed
-     * @throws {Error} If the server doesn't exist or the index is out of bounds
-     *
-     * @example
-     * ```typescript
-     * await hubManager.removeServerInstance('my-server', 0);
-     * console.log('Server instance removed successfully');
-     * ```
+     * Removes a specific server instance.
      */
     removeServerInstance(name: string, index: number): Promise<void>;
+    /**
+     * Reassigns server instance indexes.
+     */
+    reassignInstanceIndexes(name: string): Promise<boolean>;
+    /**
+     * Updates the instance selection strategy for a server.
+     */
+    updateServerInstanceSelectionStrategy(name: string, strategy: InstanceSelectionStrategy): Promise<ServerConfig | null>;
 }
 export declare const hubManager: HubManagerService;
 //# sourceMappingURL=hub-manager.service.d.ts.map

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,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAKnC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,GAAE,aAA6B;IAIlD;;;;;;;;;;;;;;;;;OAiBG;IACG,0BAA0B,CAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC,GAC9D,OAAO,CAAC,IAAI,CAAC;IAWhB;;;;;;;;;;;;;;OAcG;IACG,gCAAgC,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E;;;;;;;;;;;;;;;OAeG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBlE;;;;;;;;;;;;;;OAcG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC;IAI9D;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CACX,EAAE,EAAE,MAAM,GACT;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,oBAAoB,CAAA;KAAE,GAAG,SAAS;IAmBrF;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIvD;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAI5D;;;;;;;;;;;;;;OAcG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAI7D;;;;;;;;;;;;;;;;;;;OAmBG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAUnF;;;;;;;;;;;;;;;;;;;OAmBG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACtC,OAAO,CAAC,oBAAoB,CAAC;IAsBhC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAkB9F;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBlD;;;;;;;;;;;;;;;;;OAiBG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBvE;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;IAS5E;;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;;OAEG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC;IAwB1B;;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"}