@loop_ouroboros/mcp-hub-lite 1.0.0

package/dist/server/src/services/gateway/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Gateway service type definitions.
+ */
+import type { JsonSchema } from '../../../shared/models/tool.model.js';
+/**
+ * Tool map entry for routing gateway tool calls to actual servers.
+ */
+export interface ToolMapEntry {
+    serverId: string;
+    realToolName: string;
+}
+/**
+ * Gateway tool with annotations support.
+ */
+export interface GatewayTool {
+    name: string;
+    description: string;
+    inputSchema?: JsonSchema;
+    annotations?: {
+        title?: string;
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/services/gateway/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;CACH"}

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

@@ -0,0 +1,4 @@
+/**
+ * Gateway service type definitions.
+ */
+export {};

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

@@ -0,0 +1,7 @@
+/**
+ * Gateway service - Thin wrapper for backward compatibility.
+ * @deprecated Use @services/gateway/index.ts instead
+ */
+export { GatewayService, gateway } from './gateway/index.js';
+export type { ToolMapEntry, GatewayTool } from './gateway/types.js';
+//# sourceMappingURL=gateway.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.service.d.ts","sourceRoot":"","sources":["../../../../src/services/gateway.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Gateway service - Thin wrapper for backward compatibility.
+ * @deprecated Use @services/gateway/index.ts instead
+ */
+// Re-export from the new modular structure
+export { GatewayService, gateway } from './gateway/index.js';

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

@@ -0,0 +1,299 @@
+import { ConfigManager, ServerConfig, ServerInstanceConfig } from '../config/config-manager.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');
+ * ```
+ */
+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>;
+    }>): 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']);
+     * ```
+     */
+    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}`);
+     * ```
+     */
+    getAllServers(): Array<{
+        name: string;
+        config: ServerConfig;
+    }>;
+    /**
+     * 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;
+    } | 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}`);
+     * }
+     * ```
+     */
+    getServerByName(name: string): ServerConfig | undefined;
+    /**
+     * 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[]>;
+    /**
+     * 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`);
+     * ```
+     */
+    getServerInstanceByName(name: string): ServerInstanceConfig[];
+    /**
+     * 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>;
+    /**
+     * 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');
+     * ```
+     */
+    addServerInstance(name: string, instance: Partial<ServerInstanceConfig>): Promise<ServerInstanceConfig>;
+    /**
+     * 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');
+     * }
+     * ```
+     */
+    updateServer(name: string, updates: Partial<ServerConfig>): 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');
+     * ```
+     */
+    updateServerInstance(name: string, index: number, updates: Partial<ServerInstanceConfig>): 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');
+     * }
+     * ```
+     */
+    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');
+     * ```
+     */
+    removeServerInstance(name: string, index: number): Promise<void>;
+}
+export declare const hubManager: HubManagerService;
+//# sourceMappingURL=hub-manager.service.d.ts.map

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

@@ -0,0 +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"}