@nexus-cortex/core 4.26.0

package/dist/mcp/McpClient.js

@@ -0,0 +1,349 @@
+/**
+ * Minimal MCP Client for Nexus Cortex
+ *
+ * Supports stdio and StreamableHTTP transports. No OAuth/auth complexity;
+ * HTTP servers can supply auth via static headers or rely on server-side
+ * auto-provisioning at connect time.
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Defaults for HTTP-MCP reconnection. The SDK's own defaults (maxRetries: 2)
+ * are far too low for long-running cortex sessions where the SSE channel may
+ * drop during a multi-minute tool sequence. We default to 10 retries with
+ * exponential backoff capped at 30 seconds.
+ */
+const DEFAULT_HTTP_RECONNECTION_OPTIONS = {
+    maxRetries: 10,
+    initialReconnectionDelay: 1_000,
+    maxReconnectionDelay: 30_000,
+    reconnectionDelayGrowFactor: 1.5,
+};
+export var McpConnectionStatus;
+(function (McpConnectionStatus) {
+    McpConnectionStatus["DISCONNECTED"] = "disconnected";
+    McpConnectionStatus["CONNECTING"] = "connecting";
+    McpConnectionStatus["CONNECTED"] = "connected";
+    /** Transient stream drop; the SDK is auto-reconnecting, client still usable. */
+    McpConnectionStatus["RECONNECTING"] = "reconnecting";
+    McpConnectionStatus["DISCONNECTING"] = "disconnecting";
+    McpConnectionStatus["ERROR"] = "error";
+})(McpConnectionStatus || (McpConnectionStatus = {}));
+/**
+ * Minimal MCP Client for connecting to and interacting with MCP servers
+ */
+export class McpClient {
+    config;
+    debugMode;
+    client;
+    transport;
+    status = McpConnectionStatus.DISCONNECTED;
+    discoveredTools = [];
+    discoveredResources = [];
+    discoveredPrompts = [];
+    constructor(config, debugMode = false) {
+        this.config = config;
+        this.debugMode = debugMode;
+    }
+    /**
+     * Connect to the MCP server
+     */
+    async connect() {
+        if (this.status !== McpConnectionStatus.DISCONNECTED) {
+            throw new Error(`Cannot connect when status is ${this.status}. Current status must be DISCONNECTED.`);
+        }
+        this.status = McpConnectionStatus.CONNECTING;
+        try {
+            // Create MCP client
+            this.client = new Client({
+                name: 'nexus-cortex-mcp-client',
+                version: '1.0.0',
+            });
+            // Resolve transport type — default to 'http' when url is set, else 'stdio'
+            const transportType = this.config.transport ?? (this.config.url ? 'http' : 'stdio');
+            if (transportType === 'http') {
+                if (!this.config.url) {
+                    throw new Error('http transport requires a url to be specified');
+                }
+                // Disable undici's response body-inactivity timeout for the long-lived
+                // SSE stream. Without this, an idle server->client stream (no messages
+                // between tool calls) is terminated after undici's default (~300s),
+                // surfacing as "SSE stream disconnected: TypeError: terminated" and a
+                // needless reconnect every few minutes. The SDK's reconnection still
+                // covers genuine drops; this just stops the idle-timeout churn.
+                const dispatcher = await this.createNoIdleTimeoutDispatcher();
+                const requestInit = {
+                    ...(this.config.headers ? { headers: this.config.headers } : {}),
+                    ...(dispatcher ? { dispatcher } : {}),
+                };
+                this.transport = new StreamableHTTPClientTransport(new URL(this.config.url), {
+                    ...(Object.keys(requestInit).length > 0
+                        ? { requestInit: requestInit }
+                        : {}),
+                    reconnectionOptions: this.getResolvedReconnectionOptions(),
+                });
+            }
+            else {
+                if (!this.config.command) {
+                    throw new Error('stdio transport requires a command to be specified');
+                }
+                this.transport = new StdioClientTransport({
+                    command: this.config.command,
+                    args: this.config.args || [],
+                    env: {
+                        ...process.env,
+                        ...(this.config.env || {}),
+                    },
+                    cwd: this.config.cwd,
+                    stderr: 'pipe',
+                });
+                // Log stderr if debug mode (stdio only)
+                if (this.debugMode && 'stderr' in this.transport) {
+                    const stderr = this.transport.stderr;
+                    if (stderr) {
+                        stderr.on('data', (data) => {
+                            console.error(`[MCP STDERR (${this.config.name})]:`, data.toString().trim());
+                        });
+                    }
+                }
+            }
+            // Setup error handler. HTTP/SSE transports drop the long-lived stream
+            // periodically (idle timeouts, key rotation, network blips); the SDK
+            // auto-reconnects per reconnectionOptions. Treat those as recoverable —
+            // a gated debug note, NOT a console.error stack that corrupts the TUI,
+            // and NOT a permanent ERROR state (which would make isConnected() throw
+            // mid-reconnect). Only a terminal "max retries exceeded" or a genuine
+            // protocol error flips the client to ERROR.
+            this.client.onerror = (error) => {
+                const msg = error instanceof Error ? error.message : String(error);
+                // Errors fired while we are intentionally tearing the connection down
+                // (the SSE stream aborts on close) are expected noise — ignore them.
+                if (this.status === McpConnectionStatus.DISCONNECTING ||
+                    this.status === McpConnectionStatus.DISCONNECTED) {
+                    logger.debug(`[MCP ${this.config.name}] error during teardown (ignored): ${msg}`);
+                    return;
+                }
+                if (this.isRecoverableStreamError(msg)) {
+                    this.status = McpConnectionStatus.RECONNECTING;
+                    logger.debug(`[MCP ${this.config.name}] stream drop; auto-reconnecting: ${msg}`);
+                }
+                else {
+                    this.status = McpConnectionStatus.ERROR;
+                    logger.warn(`[MCP ${this.config.name}] ${msg}`);
+                }
+            };
+            // Setup close handler
+            this.client.onclose = () => {
+                this.status = McpConnectionStatus.DISCONNECTED;
+            };
+            // Connect to server
+            await this.client.connect(this.transport, {
+                timeout: this.config.timeout ?? 10000, // 10 second default
+            });
+            this.status = McpConnectionStatus.CONNECTED;
+        }
+        catch (error) {
+            this.status = McpConnectionStatus.ERROR;
+            throw new Error(`Failed to connect to MCP server '${this.config.name}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Disconnect from the MCP server
+     */
+    async disconnect() {
+        if (this.status === McpConnectionStatus.DISCONNECTED) {
+            return;
+        }
+        this.status = McpConnectionStatus.DISCONNECTING;
+        try {
+            if (this.client) {
+                await this.client.close();
+            }
+            if (this.transport) {
+                await this.transport.close();
+            }
+        }
+        finally {
+            this.status = McpConnectionStatus.DISCONNECTED;
+            this.client = undefined;
+            this.transport = undefined;
+        }
+    }
+    /**
+     * Discover tools from the MCP server
+     */
+    async discoverTools() {
+        this.assertConnected();
+        try {
+            const response = await this.client.listTools();
+            this.discoveredTools = response.tools || [];
+            return this.discoveredTools;
+        }
+        catch (error) {
+            throw new Error(`Failed to discover tools from MCP server '${this.config.name}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Discover resources from the MCP server
+     * Returns empty array if server doesn't support resources (Method not found -32601)
+     */
+    async discoverResources() {
+        this.assertConnected();
+        try {
+            const response = await this.client.listResources();
+            this.discoveredResources = response.resources || [];
+            return this.discoveredResources;
+        }
+        catch (error) {
+            // MCP error -32601 means "Method not found" - server doesn't implement this capability
+            // This is expected for servers that only provide tools (like filesystem server)
+            if (error?.code === -32601 || error?.message?.includes('-32601') || error?.message?.includes('Method not found')) {
+                this.discoveredResources = [];
+                return this.discoveredResources;
+            }
+            throw new Error(`Failed to discover resources from MCP server '${this.config.name}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Discover prompts from the MCP server
+     * Returns empty array if server doesn't support prompts (Method not found -32601)
+     */
+    async discoverPrompts() {
+        this.assertConnected();
+        try {
+            const response = await this.client.listPrompts();
+            this.discoveredPrompts = response.prompts || [];
+            return this.discoveredPrompts;
+        }
+        catch (error) {
+            // MCP error -32601 means "Method not found" - server doesn't implement this capability
+            // This is expected for servers that only provide tools (like filesystem server)
+            if (error?.code === -32601 || error?.message?.includes('-32601') || error?.message?.includes('Method not found')) {
+                this.discoveredPrompts = [];
+                return this.discoveredPrompts;
+            }
+            throw new Error(`Failed to discover prompts from MCP server '${this.config.name}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Call a tool on the MCP server
+     */
+    async callTool(toolName, args) {
+        this.assertConnected();
+        try {
+            const result = await this.client.callTool({
+                name: toolName,
+                arguments: args,
+            });
+            // A successful call means the stream recovered — self-heal the status.
+            if (this.status === McpConnectionStatus.RECONNECTING) {
+                this.status = McpConnectionStatus.CONNECTED;
+            }
+            return result;
+        }
+        catch (error) {
+            throw new Error(`Failed to call tool '${toolName}' on MCP server '${this.config.name}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Read a resource from the MCP server
+     */
+    async readResource(uri) {
+        this.assertConnected();
+        try {
+            const result = await this.client.readResource({
+                uri,
+            });
+            return result;
+        }
+        catch (error) {
+            throw new Error(`Failed to read resource '${uri}' from MCP server '${this.config.name}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get discovered tools
+     */
+    getDiscoveredTools() {
+        return [...this.discoveredTools];
+    }
+    /**
+     * Get discovered resources
+     */
+    getDiscoveredResources() {
+        return [...this.discoveredResources];
+    }
+    /**
+     * Get discovered prompts
+     */
+    getDiscoveredPrompts() {
+        return [...this.discoveredPrompts];
+    }
+    /**
+     * Get connection status
+     */
+    getStatus() {
+        return this.status;
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        // RECONNECTING is a transient SSE drop the SDK is recovering from — the
+        // client is still usable (tool POSTs succeed and trigger reconnect), so
+        // it counts as connected. Only DISCONNECTED/ERROR/CONNECTING do not.
+        return (this.status === McpConnectionStatus.CONNECTED ||
+            this.status === McpConnectionStatus.RECONNECTING);
+    }
+    /**
+     * Return the reconnection options that will be (or were) supplied to the
+     * HTTP transport. Returns undefined for stdio transport. Useful for tests
+     * and operational introspection.
+     */
+    getReconnectionOptions() {
+        const transportType = this.config.transport ?? (this.config.url ? 'http' : 'stdio');
+        if (transportType !== 'http')
+            return undefined;
+        return this.getResolvedReconnectionOptions();
+    }
+    getResolvedReconnectionOptions() {
+        return this.config.reconnectionOptions ?? DEFAULT_HTTP_RECONNECTION_OPTIONS;
+    }
+    /**
+     * Recoverable transport errors: transient SSE/network drops that the SDK's
+     * reconnection loop handles on its own. A terminal "Maximum reconnection
+     * attempts exceeded" is NOT recoverable and must surface as ERROR.
+     */
+    isRecoverableStreamError(msg) {
+        if (/maximum reconnection attempts/i.test(msg))
+            return false;
+        return /sse stream disconnected|failed to reconnect sse|terminated|socket hang ?up|econnreset|etimedout|epipe|other side closed|fetch failed|network|operation was aborted|aborted/i.test(msg);
+    }
+    /**
+     * Build an undici dispatcher with the response body-inactivity timeout
+     * disabled (bodyTimeout: 0), so a long-lived idle SSE stream is not
+     * terminated mid-session. Returns undefined when undici is unavailable
+     * (e.g. a non-Node runtime) — the transport then uses the default fetch and
+     * relies on the SDK's reconnection.
+     */
+    async createNoIdleTimeoutDispatcher() {
+        try {
+            const undici = await import('undici');
+            return new undici.Agent({ bodyTimeout: 0 });
+        }
+        catch (err) {
+            logger.debug(`[MCP ${this.config.name}] undici unavailable; SSE keep-alive dispatcher skipped: ${err instanceof Error ? err.message : String(err)}`);
+            return undefined;
+        }
+    }
+    /**
+     * Assert that the client is connected
+     */
+    assertConnected() {
+        if (!this.isConnected() || !this.client) {
+            throw new Error(`MCP client for '${this.config.name}' is not connected. Current status: ${this.status}`);
+        }
+    }
+}
+//# sourceMappingURL=McpClient.js.map

package/dist/mcp/McpClient.js.map

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

package/dist/mcp/McpClientManager.d.ts

@@ -0,0 +1,148 @@
+/**
+ * MCP Client Manager for Nexus Cortex
+ *
+ * Manages multiple MCP server connections and aggregates their tools/resources.
+ * Provides centralized connection lifecycle management.
+ */
+import { McpClient, type McpServerConfig, McpConnectionStatus } from './McpClient.js';
+import type { Tool, Resource, Prompt } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Discovery state for MCP tools
+ */
+export declare enum McpDiscoveryState {
+    NOT_STARTED = "not_started",
+    IN_PROGRESS = "in_progress",
+    COMPLETED = "completed",
+    ERROR = "error"
+}
+/**
+ * MCP server connection info
+ */
+export interface McpServerInfo {
+    name: string;
+    config: McpServerConfig;
+    client: McpClient;
+    status: McpConnectionStatus;
+    toolCount: number;
+    resourceCount: number;
+    promptCount: number;
+    lastError?: string;
+}
+/**
+ * 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 declare class McpClientManager {
+    private readonly debugMode;
+    private clients;
+    private configs;
+    private discoveryState;
+    private discoveryPromise;
+    private connectInFlight;
+    constructor(debugMode?: boolean);
+    /**
+     * Add an MCP server configuration
+     */
+    addServerConfig(name: string, config: McpServerConfig): void;
+    /**
+     * Remove an MCP server configuration
+     */
+    removeServerConfig(name: string): void;
+    /**
+     * Get all configured server names
+     */
+    getServerNames(): string[];
+    /**
+     * Get server configuration
+     */
+    getServerConfig(name: string): McpServerConfig | undefined;
+    /**
+     * Connect to a specific MCP server
+     */
+    connectToServer(name: string): Promise<void>;
+    private _doConnectToServer;
+    /**
+     * Disconnect from a specific MCP server
+     */
+    disconnectFromServer(name: string): Promise<void>;
+    /**
+     * Connect to all configured MCP servers
+     */
+    connectToAllServers(): Promise<void>;
+    /**
+     * Disconnect from all MCP servers
+     */
+    disconnectFromAllServers(): Promise<void>;
+    /**
+     * Discover tools from a specific MCP server
+     */
+    discoverServerTools(name: string): Promise<Tool[]>;
+    /**
+     * Discover resources from a specific MCP server
+     */
+    discoverServerResources(name: string): Promise<Resource[]>;
+    /**
+     * Discover prompts from a specific MCP server
+     */
+    discoverServerPrompts(name: string): Promise<Prompt[]>;
+    /**
+     * Discover all tools, resources, and prompts from all connected servers
+     */
+    discoverAll(): Promise<void>;
+    /**
+     * Get all tools from all connected servers
+     */
+    getAllTools(): Array<Tool & {
+        serverName: string;
+    }>;
+    /**
+     * Get all resources from all connected servers
+     */
+    getAllResources(): Array<Resource & {
+        serverName: string;
+    }>;
+    /**
+     * Get all prompts from all connected servers
+     */
+    getAllPrompts(): Array<Prompt & {
+        serverName: string;
+    }>;
+    /**
+     * Call a tool on a specific MCP server
+     */
+    callTool(serverName: string, toolName: string, args: Record<string, unknown>): Promise<any>;
+    /**
+     * Read a resource from a specific MCP server
+     */
+    readResource(serverName: string, uri: string): Promise<any>;
+    /**
+     * Get information about all connected servers
+     */
+    getServerInfo(): McpServerInfo[];
+    /**
+     * Get the current discovery state
+     */
+    getDiscoveryState(): McpDiscoveryState;
+    /**
+     * Get a specific client by name
+     */
+    getClient(name: string): McpClient | undefined;
+    /**
+     * Check if a server is connected
+     */
+    isServerConnected(name: string): boolean;
+    /**
+     * Get count of connected servers
+     */
+    getConnectedServerCount(): number;
+    /**
+     * Cleanup all connections (call on shutdown)
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=McpClientManager.d.ts.map

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

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