synapsexcoder 6.0.0

package/dist/mcp/mcp-manager.d.ts

@@ -0,0 +1,181 @@
+/**
+ * MCP Manager — Centralized MCP Server Lifecycle Management
+ *
+ * Provides registration, start/stop/restart lifecycle, health checking,
+ * configuration persistence, capability discovery, and event-based
+ * status tracking for all MCP servers in the system.
+ *
+ * Integrates with NativeWorkspaceEngine for existing server configs.
+ *
+ * @module mcp-manager
+ */
+import { EventEmitter } from "events";
+import type { McpServerConfig, McpServerInfo, McpServerAdapter, McpServerFactory, HealthCheckResult, McpManagerOptions } from "./mcp-types.js";
+import { McpServerStatus } from "./mcp-types.js";
+/**
+ * Centralized MCP server lifecycle manager.
+ *
+ * Capabilities:
+ * - Register/unregister server configurations and adapter factories
+ * - Start, stop, restart individual or all servers
+ * - Periodic health checking with configurable intervals
+ * - Configuration persistence (load/save to JSON file)
+ * - Event-driven status notifications
+ * - Integration with workspace engine MCPs
+ */
+export declare class McpManager extends EventEmitter {
+    private servers;
+    private factories;
+    private adapters;
+    private options;
+    private healthCheckTimer;
+    private initialized;
+    constructor(options?: Partial<McpManagerOptions>);
+    /**
+     * Initialize the MCP manager — load config, register built-ins, auto-start.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Dispose the manager — stop all servers and clean up.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Register an MCP server config. If the ID already exists, it is updated.
+     * Returns the registered server info.
+     */
+    registerConfig(config: McpServerConfig): McpServerInfo;
+    /**
+     * Register a server with an adapter factory for creating its runtime adapter.
+     * The server must already be registered via registerConfig first.
+     */
+    registerAdapterFactory(serverId: string, factory: McpServerFactory): void;
+    /**
+     * Unregister a server. Stops it first if running, then removes all traces.
+     */
+    unregister(serverId: string): Promise<void>;
+    /**
+     * Update a server config without changing its ID.
+     */
+    updateConfig(serverId: string, updates: Partial<McpServerConfig>): McpServerInfo | null;
+    /**
+     * Start an MCP server. Creates its adapter if a factory is registered.
+     */
+    start(serverId: string): Promise<boolean>;
+    /**
+     * Stop an MCP server.
+     */
+    stop(serverId: string): Promise<void>;
+    /**
+     * Restart an MCP server (stop then start).
+     */
+    restart(serverId: string): Promise<boolean>;
+    /**
+     * Start all enabled MCP servers.
+     */
+    startAll(): Promise<Map<string, boolean>>;
+    /**
+     * Stop all MCP servers.
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Get server info by ID.
+     */
+    get(serverId: string): McpServerInfo | undefined;
+    /**
+     * List all registered servers.
+     */
+    list(): McpServerInfo[];
+    /**
+     * List servers by status.
+     */
+    listByStatus(status: McpServerStatus): McpServerInfo[];
+    /**
+     * List servers by type.
+     */
+    listByType(type: string): McpServerInfo[];
+    /**
+     * List servers by category.
+     */
+    listByCategory(category: string): McpServerInfo[];
+    /**
+     * List enabled servers.
+     */
+    listEnabled(): McpServerInfo[];
+    /**
+     * Get the current status of a server.
+     */
+    getStatus(serverId: string): McpServerStatus;
+    /**
+     * Get a map of all server IDs to their status.
+     */
+    getStatusMap(): Record<string, McpServerStatus>;
+    /**
+     * Get the number of registered servers.
+     */
+    get serverCount(): number;
+    /**
+     * Get the number of running servers.
+     */
+    get runningCount(): number;
+    /**
+     * Get the number of errored servers.
+     */
+    get errorCount(): number;
+    /**
+     * Check if the manager has been initialized.
+     */
+    get isInitialized(): boolean;
+    /**
+     * Perform a health check on a specific server.
+     */
+    healthCheck(serverId: string): Promise<HealthCheckResult>;
+    /**
+     * Perform health checks on all running servers.
+     */
+    healthCheckAll(): Promise<HealthCheckResult[]>;
+    /**
+     * Find servers that provide a specific tool capability.
+     */
+    findByTool(toolName: string): McpServerInfo[];
+    /**
+     * Find servers by category.
+     */
+    findByCategory(category: string): McpServerInfo[];
+    /**
+     * Get all tool capabilities across all servers.
+     */
+    getAllTools(): string[];
+    /**
+     * Serialize server configurations to JSON for persistence.
+     */
+    serializeConfig(): McpServerConfig[];
+    /**
+     * Save server configurations to a file.
+     */
+    saveConfig(): Promise<void>;
+    /**
+     * Load server configurations from a file.
+     */
+    loadConfig(): Promise<number>;
+    /**
+     * Get the adapter for a server, if one exists.
+     */
+    getAdapter(serverId: string): McpServerAdapter | undefined;
+    /**
+     * Get all registered adapter factory IDs.
+     */
+    getRegisteredFactoryIds(): string[];
+    /**
+     * Get a formatted status report as a string.
+     */
+    getStatusReport(): string;
+    private setStatus;
+    private startHealthChecks;
+    private stopHealthChecks;
+}
+/**
+ * Create and initialize an MCP manager in one call.
+ */
+export declare function createMcpManager(options?: Partial<McpManagerOptions>): Promise<McpManager>;
+export default McpManager;
+//# sourceMappingURL=mcp-manager.d.ts.map

package/dist/mcp/mcp-manager.d.ts.map

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