@nexus-cortex/core 4.26.0

package/dist/mcp/McpClientManager.js

@@ -0,0 +1,366 @@
+/**
+ * MCP Client Manager for Nexus Cortex
+ *
+ * Manages multiple MCP server connections and aggregates their tools/resources.
+ * Provides centralized connection lifecycle management.
+ */
+import { McpClient, McpConnectionStatus } from './McpClient.js';
+/**
+ * Discovery state for MCP tools
+ */
+export var McpDiscoveryState;
+(function (McpDiscoveryState) {
+    McpDiscoveryState["NOT_STARTED"] = "not_started";
+    McpDiscoveryState["IN_PROGRESS"] = "in_progress";
+    McpDiscoveryState["COMPLETED"] = "completed";
+    McpDiscoveryState["ERROR"] = "error";
+})(McpDiscoveryState || (McpDiscoveryState = {}));
+/**
+ * MCP Client Manager
+ *
+ * Manages multiple MCP server connections and provides:
+ * - Centralized connection management
+ * - Tool/resource/prompt aggregation across all servers
+ * - Discovery state tracking
+ * - Error handling and logging
+ */
+export class McpClientManager {
+    debugMode;
+    clients = new Map();
+    configs = new Map();
+    discoveryState = McpDiscoveryState.NOT_STARTED;
+    discoveryPromise;
+    // R15 (race serialization): concurrent connectToServer(name) calls share
+    // one in-flight connect instead of each tearing down the prior client.
+    connectInFlight = new Map();
+    constructor(debugMode = false) {
+        this.debugMode = debugMode;
+    }
+    /**
+     * Add an MCP server configuration
+     */
+    addServerConfig(name, config) {
+        // Ensure name matches config
+        const serverConfig = {
+            ...config,
+            name,
+        };
+        this.configs.set(name, serverConfig);
+    }
+    /**
+     * Remove an MCP server configuration
+     */
+    removeServerConfig(name) {
+        this.configs.delete(name);
+    }
+    /**
+     * Get all configured server names
+     */
+    getServerNames() {
+        return Array.from(this.configs.keys());
+    }
+    /**
+     * Get server configuration
+     */
+    getServerConfig(name) {
+        return this.configs.get(name);
+    }
+    /**
+     * Connect to a specific MCP server
+     */
+    async connectToServer(name) {
+        // R15: serialize concurrent connects to the same server — share the
+        // in-flight promise so a racing second caller doesn't tear down the
+        // first's client mid-connect. Sequential calls (after resolution) still
+        // start a fresh connect because the entry is cleared on settle.
+        const existing = this.connectInFlight.get(name);
+        if (existing)
+            return existing;
+        const p = this._doConnectToServer(name).finally(() => {
+            this.connectInFlight.delete(name);
+        });
+        this.connectInFlight.set(name, p);
+        return p;
+    }
+    async _doConnectToServer(name) {
+        const config = this.configs.get(name);
+        if (!config) {
+            throw new Error(`No configuration found for MCP server '${name}'`);
+        }
+        // Disconnect existing client if present
+        await this.disconnectFromServer(name);
+        // Create and connect new client
+        const client = new McpClient(config, this.debugMode);
+        this.clients.set(name, client);
+        try {
+            await client.connect();
+            if (this.debugMode) {
+                console.log(`[MCP Manager] Connected to server '${name}'`);
+            }
+        }
+        catch (error) {
+            this.clients.delete(name);
+            throw error;
+        }
+    }
+    /**
+     * Disconnect from a specific MCP server
+     */
+    async disconnectFromServer(name) {
+        const client = this.clients.get(name);
+        if (client) {
+            try {
+                await client.disconnect();
+                if (this.debugMode) {
+                    console.log(`[MCP Manager] Disconnected from server '${name}'`);
+                }
+            }
+            catch (error) {
+                console.error(`[MCP Manager] Error disconnecting from server '${name}':`, error);
+            }
+            finally {
+                this.clients.delete(name);
+            }
+        }
+    }
+    /**
+     * Connect to all configured MCP servers
+     */
+    async connectToAllServers() {
+        const names = this.getServerNames();
+        if (this.debugMode) {
+            console.log(`[MCP Manager] Connecting to ${names.length} server(s)...`);
+        }
+        const results = await Promise.allSettled(names.map((name) => this.connectToServer(name)));
+        // Log any failures
+        results.forEach((result, index) => {
+            if (result.status === 'rejected') {
+                const name = names[index];
+                console.error(`[MCP Manager] Failed to connect to '${name}':`, result.reason);
+            }
+        });
+    }
+    /**
+     * Disconnect from all MCP servers
+     */
+    async disconnectFromAllServers() {
+        const names = Array.from(this.clients.keys());
+        if (this.debugMode) {
+            console.log(`[MCP Manager] Disconnecting from ${names.length} server(s)...`);
+        }
+        await Promise.all(names.map((name) => this.disconnectFromServer(name)));
+    }
+    /**
+     * Discover tools from a specific MCP server
+     */
+    async discoverServerTools(name) {
+        const client = this.clients.get(name);
+        if (!client) {
+            throw new Error(`MCP server '${name}' is not connected`);
+        }
+        return await client.discoverTools();
+    }
+    /**
+     * Discover resources from a specific MCP server
+     */
+    async discoverServerResources(name) {
+        const client = this.clients.get(name);
+        if (!client) {
+            throw new Error(`MCP server '${name}' is not connected`);
+        }
+        return await client.discoverResources();
+    }
+    /**
+     * Discover prompts from a specific MCP server
+     */
+    async discoverServerPrompts(name) {
+        const client = this.clients.get(name);
+        if (!client) {
+            throw new Error(`MCP server '${name}' is not connected`);
+        }
+        return await client.discoverPrompts();
+    }
+    /**
+     * Discover all tools, resources, and prompts from all connected servers
+     */
+    async discoverAll() {
+        if (this.discoveryPromise) {
+            // Discovery already in progress, wait for it
+            return this.discoveryPromise;
+        }
+        this.discoveryState = McpDiscoveryState.IN_PROGRESS;
+        this.discoveryPromise = (async () => {
+            try {
+                const serverNames = Array.from(this.clients.keys());
+                if (this.debugMode) {
+                    console.log(`[MCP Manager] Discovering tools from ${serverNames.length} server(s)...`);
+                }
+                // Discover from all servers in parallel
+                await Promise.all(serverNames.map(async (name) => {
+                    try {
+                        const client = this.clients.get(name);
+                        if (!client)
+                            return;
+                        await Promise.all([
+                            client.discoverTools(),
+                            client.discoverResources(),
+                            client.discoverPrompts(),
+                        ]);
+                        if (this.debugMode) {
+                            const tools = client.getDiscoveredTools();
+                            const resources = client.getDiscoveredResources();
+                            const prompts = client.getDiscoveredPrompts();
+                            console.log(`[MCP Manager] Server '${name}': ${tools.length} tools, ${resources.length} resources, ${prompts.length} prompts`);
+                        }
+                    }
+                    catch (error) {
+                        console.error(`[MCP Manager] Discovery failed for server '${name}':`, error);
+                    }
+                }));
+                this.discoveryState = McpDiscoveryState.COMPLETED;
+            }
+            catch (error) {
+                this.discoveryState = McpDiscoveryState.ERROR;
+                throw error;
+            }
+            finally {
+                this.discoveryPromise = undefined;
+            }
+        })();
+        return this.discoveryPromise;
+    }
+    /**
+     * Get all tools from all connected servers
+     */
+    getAllTools() {
+        const allTools = [];
+        for (const [serverName, client] of this.clients.entries()) {
+            const tools = client.getDiscoveredTools();
+            tools.forEach((tool) => {
+                allTools.push({
+                    ...tool,
+                    serverName,
+                });
+            });
+        }
+        return allTools;
+    }
+    /**
+     * Get all resources from all connected servers
+     */
+    getAllResources() {
+        const allResources = [];
+        for (const [serverName, client] of this.clients.entries()) {
+            const resources = client.getDiscoveredResources();
+            resources.forEach((resource) => {
+                allResources.push({
+                    ...resource,
+                    serverName,
+                });
+            });
+        }
+        return allResources;
+    }
+    /**
+     * Get all prompts from all connected servers
+     */
+    getAllPrompts() {
+        const allPrompts = [];
+        for (const [serverName, client] of this.clients.entries()) {
+            const prompts = client.getDiscoveredPrompts();
+            prompts.forEach((prompt) => {
+                allPrompts.push({
+                    ...prompt,
+                    serverName,
+                });
+            });
+        }
+        return allPrompts;
+    }
+    /**
+     * Call a tool on a specific MCP server
+     */
+    async callTool(serverName, toolName, args) {
+        const client = this.clients.get(serverName);
+        if (!client) {
+            throw new Error(`MCP server '${serverName}' is not connected`);
+        }
+        return await client.callTool(toolName, args);
+    }
+    /**
+     * Read a resource from a specific MCP server
+     */
+    async readResource(serverName, uri) {
+        const client = this.clients.get(serverName);
+        if (!client) {
+            throw new Error(`MCP server '${serverName}' is not connected`);
+        }
+        return await client.readResource(uri);
+    }
+    /**
+     * Get information about all connected servers
+     */
+    getServerInfo() {
+        const info = [];
+        for (const [name, config] of this.configs.entries()) {
+            const client = this.clients.get(name);
+            if (client) {
+                info.push({
+                    name,
+                    config,
+                    client,
+                    status: client.getStatus(),
+                    toolCount: client.getDiscoveredTools().length,
+                    resourceCount: client.getDiscoveredResources().length,
+                    promptCount: client.getDiscoveredPrompts().length,
+                });
+            }
+            else {
+                info.push({
+                    name,
+                    config,
+                    client: null,
+                    status: McpConnectionStatus.DISCONNECTED,
+                    toolCount: 0,
+                    resourceCount: 0,
+                    promptCount: 0,
+                });
+            }
+        }
+        return info;
+    }
+    /**
+     * Get the current discovery state
+     */
+    getDiscoveryState() {
+        return this.discoveryState;
+    }
+    /**
+     * Get a specific client by name
+     */
+    getClient(name) {
+        return this.clients.get(name);
+    }
+    /**
+     * Check if a server is connected
+     */
+    isServerConnected(name) {
+        const client = this.clients.get(name);
+        return client?.isConnected() ?? false;
+    }
+    /**
+     * Get count of connected servers
+     */
+    getConnectedServerCount() {
+        return Array.from(this.clients.values()).filter((client) => client.isConnected()).length;
+    }
+    /**
+     * Cleanup all connections (call on shutdown)
+     */
+    async cleanup() {
+        await this.disconnectFromAllServers();
+        this.configs.clear();
+        this.discoveryState = McpDiscoveryState.NOT_STARTED;
+    }
+}
+//# sourceMappingURL=McpClientManager.js.map

package/dist/mcp/McpClientManager.js.map

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

package/dist/mcp/McpConfigManager.d.ts

@@ -0,0 +1,125 @@
+/**
+ * MCP Config Manager
+ *
+ * Manages MCP_CONFIG.md files for opt-in auto-injection.
+ * Handles parsing, writing, and merging of project/global configurations.
+ *
+ * Phase 2.5 Day 4.5: MCP Auto-Injection System
+ */
+import { McpServerConfig, McpTransportType } from './McpClient.js';
+/**
+ * Server status in MCP_CONFIG.md
+ */
+export type McpConfigStatus = 'enabled' | 'available' | 'disabled';
+/**
+ * Server entry in MCP_CONFIG.md
+ */
+export interface McpConfigServerEntry {
+    name: string;
+    status: McpConfigStatus;
+    description: string;
+    /** Transport — defaults to 'http' when url is set, else 'stdio' */
+    transport?: McpTransportType;
+    /** Command (stdio transport) */
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    /** URL (http transport) */
+    url?: string;
+    /** Static HTTP headers (http transport) */
+    headers?: Record<string, string>;
+    autoStart?: boolean;
+    workingDir?: string;
+    timeout?: number;
+}
+/**
+ * Parsed MCP_CONFIG.md structure
+ */
+export interface McpConfig {
+    servers: McpConfigServerEntry[];
+    notes?: string;
+}
+/**
+ * MCP Config Manager
+ */
+export declare class McpConfigManager {
+    private projectPath?;
+    private globalConfigPath;
+    constructor(projectPath?: string);
+    /**
+     * Get config file path for given scope
+     */
+    private getConfigPath;
+    /**
+     * Check if config exists
+     */
+    configExists(scope: 'project' | 'global'): Promise<boolean>;
+    /**
+     * Read and parse MCP_CONFIG.md
+     */
+    readConfig(scope: 'project' | 'global'): Promise<McpConfig | null>;
+    /**
+     * Write MCP_CONFIG.md
+     */
+    writeConfig(scope: 'project' | 'global', config: McpConfig): Promise<void>;
+    /**
+     * Parse markdown into McpConfig
+     */
+    private parseConfig;
+    /**
+     * Parse args field (comma-separated or backtick-wrapped)
+     */
+    private parseArgs;
+    /**
+     * Parse env field (KEY=value, comma-separated). Values may reference
+     * environment variables via `${VAR}` syntax — substituted at parse time
+     * from `process.env`. Unresolved placeholders are left verbatim so a
+     * misconfig surfaces at connect time rather than as a bogus "Bearer "
+     * header that the server only rejects with a 401.
+     */
+    private parseEnv;
+    /**
+     * Replace `${VAR}` placeholders with `process.env[VAR]`. Leaves the
+     * placeholder verbatim when the env var is unset (intentional — see
+     * parseEnv() docstring).
+     */
+    private interpolateEnvVars;
+    /**
+     * Generate markdown from McpConfig
+     */
+    private generateMarkdown;
+    /**
+     * Generate markdown for a single server entry
+     */
+    private generateServerEntry;
+    /**
+     * Merge project and global configs
+     * Project config overrides global config
+     */
+    mergeConfigs(projectConfig: McpConfig | null, globalConfig: McpConfig | null): McpConfig | null;
+    /**
+     * Convert McpConfigServerEntry to McpServerConfig
+     */
+    toServerConfig(entry: McpConfigServerEntry): McpServerConfig;
+    /**
+     * Get enabled servers from config
+     */
+    getEnabledServers(config: McpConfig): McpConfigServerEntry[];
+    /**
+     * Get auto-start servers from config
+     */
+    getAutoStartServers(config: McpConfig): McpConfigServerEntry[];
+    /**
+     * Add or update a server in config
+     */
+    upsertServer(config: McpConfig, server: McpConfigServerEntry): McpConfig;
+    /**
+     * Remove a server from config
+     */
+    removeServer(config: McpConfig, serverName: string): McpConfig;
+    /**
+     * Update server status
+     */
+    updateServerStatus(config: McpConfig, serverName: string, status: McpConfigStatus): McpConfig;
+}
+//# sourceMappingURL=McpConfigManager.d.ts.map

package/dist/mcp/McpConfigManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpConfigManager.d.ts","sourceRoot":"","sources":["../../src/mcp/McpConfigManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,WAAW,CAAC,EAAE,MAAM;IAUhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAUjE;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAYxE;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAchF;;OAEG;IACH,OAAO,CAAC,WAAW;IA6InB;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IAkBhB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmDxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4D3B;;;OAGG;IACH,YAAY,CAAC,aAAa,EAAE,SAAS,GAAG,IAAI,EAAE,YAAY,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IA2C/F;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe;IAc5D;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,oBAAoB,EAAE;IAI5D;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,oBAAoB,EAAE;IAI9D;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,GAAG,SAAS;IAcxE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS;IAK9D;;OAEG;IACH,kBAAkB,CAChB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,GACtB,SAAS;CAOb"}