ghcralph 0.1.0

package/dist/integrations/copilot-agent.js

@@ -0,0 +1,235 @@
+/**
+ * Copilot Agent
+ *
+ * Integration with GitHub Copilot for AI agent capabilities
+ * Uses the @github/copilot-sdk for actual Copilot API access
+ */
+import { CopilotClient } from '@github/copilot-sdk';
+import { debug, error as logError, info, warn } from '../utils/index.js';
+import { getGitHubAuth } from './auth.js';
+import { TokenTracker, estimateTokens } from './tokens.js';
+/**
+ * Default agent configuration
+ */
+const DEFAULT_CONFIG = {
+    model: 'gpt-4.1',
+    maxTokensPerRequest: 4096,
+    maxRetries: 3,
+    retryDelayMs: 1000,
+    cwd: process.cwd(),
+};
+/**
+ * Error types for Copilot API
+ */
+export class CopilotError extends Error {
+    code;
+    retryable;
+    constructor(message, code, retryable = false) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.name = 'CopilotError';
+    }
+}
+/**
+ * Sleep utility for retries
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * CopilotAgent class for interacting with GitHub Copilot
+ */
+export class CopilotAgent {
+    config;
+    tokenTracker;
+    authResult = null;
+    initialized = false;
+    client = null;
+    session = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.tokenTracker = new TokenTracker();
+    }
+    /**
+     * Initialize the agent session
+     */
+    async initialize() {
+        debug('Initializing Copilot agent...');
+        // Get authentication
+        this.authResult = getGitHubAuth();
+        if (!this.authResult.authenticated) {
+            logError(this.authResult.error ?? 'Authentication failed');
+            return false;
+        }
+        try {
+            // Create Copilot client
+            this.client = new CopilotClient({
+                autoStart: true,
+                logLevel: 'error',
+            });
+            // Start the client
+            await this.client.start();
+            debug('Copilot client started');
+            // Create a session with the specified model
+            this.session = await this.client.createSession({
+                model: this.config.model,
+            });
+            debug(`Session created with model: ${this.config.model}`);
+            info(`Copilot agent initialized (model: ${this.config.model})`);
+            this.initialized = true;
+            return true;
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            logError(`Failed to initialize Copilot SDK: ${errorMsg}`);
+            return false;
+        }
+    }
+    /**
+     * Check if the agent is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Execute a prompt and get a response
+     */
+    async execute(prompt) {
+        if (!this.initialized || !this.session) {
+            throw new CopilotError('Agent not initialized', 'NOT_INITIALIZED');
+        }
+        debug(`Executing prompt (${estimateTokens(prompt)} estimated tokens)`);
+        let lastError = null;
+        for (let attempt = 0; attempt < this.config.maxRetries; attempt++) {
+            try {
+                const result = await this.executeWithRetry(prompt);
+                return result;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                if (err instanceof CopilotError && !err.retryable) {
+                    break;
+                }
+                if (attempt < this.config.maxRetries - 1) {
+                    const delay = this.config.retryDelayMs * Math.pow(2, attempt);
+                    debug(`Retry ${attempt + 1}/${this.config.maxRetries} after ${delay}ms`);
+                    await sleep(delay);
+                }
+            }
+        }
+        return {
+            success: false,
+            error: lastError?.message ?? 'Unknown error',
+        };
+    }
+    /**
+     * Execute with retry logic using Copilot SDK
+     */
+    async executeWithRetry(prompt) {
+        if (!this.session) {
+            throw new CopilotError('No active session', 'NO_SESSION');
+        }
+        const promptTokens = estimateTokens(prompt);
+        let responseContent = '';
+        try {
+            // Create a promise that resolves when the session becomes idle
+            const done = new Promise((resolve, reject) => {
+                const timeout = setTimeout(() => {
+                    reject(new CopilotError('Session timeout', 'TIMEOUT', true));
+                }, 120000); // 2 minute timeout
+                this.session?.on((event) => {
+                    if (event.type === 'assistant.message') {
+                        responseContent += event.data.content ?? '';
+                    }
+                    else if (event.type === 'session.idle') {
+                        clearTimeout(timeout);
+                        resolve();
+                    }
+                    else if (event.type === 'session.error') {
+                        clearTimeout(timeout);
+                        reject(new CopilotError(event.data.message ?? 'Unknown error', 'SDK_ERROR', true));
+                    }
+                });
+            });
+            // Send the prompt
+            await this.session.send({ prompt });
+            // Wait for completion
+            await done;
+            const completionTokens = estimateTokens(responseContent);
+            this.tokenTracker.addUsage(promptTokens, completionTokens);
+            return {
+                success: true,
+                content: responseContent,
+                tokenUsage: {
+                    promptTokens,
+                    completionTokens,
+                    totalTokens: promptTokens + completionTokens,
+                },
+            };
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            warn(`Copilot execution error: ${errorMsg}`);
+            throw err;
+        }
+    }
+    /**
+     * Cleanup resources
+     */
+    async destroy() {
+        try {
+            if (this.session) {
+                await this.session.destroy();
+                this.session = null;
+            }
+            if (this.client) {
+                await this.client.stop();
+                this.client = null;
+            }
+            this.initialized = false;
+            debug('Copilot agent destroyed');
+        }
+        catch (err) {
+            warn(`Error during cleanup: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Get total token usage
+     */
+    getTokenUsage() {
+        return this.tokenTracker.getUsage();
+    }
+    /**
+     * Reset token tracking
+     */
+    resetTokenUsage() {
+        this.tokenTracker.reset();
+    }
+    /**
+     * Check if token budget is exceeded
+     */
+    isTokenBudgetExceeded(maxTokens) {
+        return this.tokenTracker.exceedsLimit(maxTokens);
+    }
+    /**
+     * Get the current model
+     */
+    getModel() {
+        return this.config.model;
+    }
+    /**
+     * Set the model
+     */
+    setModel(model) {
+        this.config.model = model;
+        debug(`Model set to: ${model}`);
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=copilot-agent.js.map

package/dist/integrations/copilot-agent.js.map

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

package/dist/integrations/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Integrations
+ *
+ * This module contains integrations with:
+ * - GitHub Copilot SDK
+ * - GitHub API (for Issues)
+ * - Git operations
+ * - MCP Tools
+ */
+export { CopilotAgent, CopilotError } from './copilot-agent.js';
+export type { CopilotModel, CopilotAgentConfig, ExecutionResult } from './copilot-agent.js';
+export { getGitHubAuth, isAuthenticated } from './auth.js';
+export type { AuthResult } from './auth.js';
+export { TokenTracker, estimateTokens } from './tokens.js';
+export type { TokenUsage } from './tokens.js';
+export { MCPToolManager, createMCPToolManager } from './mcp-tools.js';
+export type { MCPServerConfig, MCPTool, MCPToolResult, MCPServerConnection } from './mcp-tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/integrations/index.js

@@ -0,0 +1,14 @@
+/**
+ * Integrations
+ *
+ * This module contains integrations with:
+ * - GitHub Copilot SDK
+ * - GitHub API (for Issues)
+ * - Git operations
+ * - MCP Tools
+ */
+export { CopilotAgent, CopilotError } from './copilot-agent.js';
+export { getGitHubAuth, isAuthenticated } from './auth.js';
+export { TokenTracker, estimateTokens } from './tokens.js';
+export { MCPToolManager, createMCPToolManager } from './mcp-tools.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/integrations/mcp-tools.d.ts

@@ -0,0 +1,129 @@
+/**
+ * MCP Tool Extension Support
+ *
+ * Allows users to extend Ralph with custom MCP (Model Context Protocol) tools.
+ */
+import { type ChildProcess } from 'node:child_process';
+/**
+ * MCP Server configuration
+ */
+export interface MCPServerConfig {
+    /** Name of the MCP server */
+    name: string;
+    /** Command to run the server */
+    command: string;
+    /** Arguments to pass to the command */
+    args?: string[];
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Transport type (stdio or http) */
+    transport?: 'stdio' | 'http';
+    /** HTTP endpoint (for http transport) */
+    endpoint?: string;
+}
+/**
+ * MCP Tool definition
+ */
+export interface MCPTool {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Input schema (JSON Schema) */
+    inputSchema?: Record<string, unknown>;
+    /** Server this tool belongs to */
+    server: string;
+}
+/**
+ * MCP Tool result
+ */
+export interface MCPToolResult {
+    /** Whether the tool execution succeeded */
+    success: boolean;
+    /** Result content */
+    content?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * MCP Server connection
+ */
+export interface MCPServerConnection {
+    /** Server configuration */
+    config: MCPServerConfig;
+    /** Available tools */
+    tools: MCPTool[];
+    /** Whether connected */
+    connected: boolean;
+    /** Server process (for stdio transport) */
+    process?: ChildProcess;
+}
+/**
+ * MCP Tool Manager
+ *
+ * Manages connections to MCP servers and tool execution
+ */
+export declare class MCPToolManager {
+    private servers;
+    /**
+     * Add an MCP server configuration
+     */
+    addServer(config: MCPServerConfig): void;
+    /**
+     * Add multiple servers from configuration
+     */
+    addServers(configs: MCPServerConfig[]): void;
+    /**
+     * Connect to an MCP server and discover tools
+     */
+    connect(serverName: string): Promise<boolean>;
+    /**
+     * Connect via stdio transport
+     */
+    private connectStdio;
+    /**
+     * Connect via HTTP transport
+     */
+    private connectHttp;
+    /**
+     * Connect to all configured servers
+     */
+    connectAll(): Promise<number>;
+    /**
+     * Get all available tools from connected servers
+     */
+    getAvailableTools(): MCPTool[];
+    /**
+     * Execute a tool
+     */
+    executeTool(toolName: string, input: Record<string, unknown>): Promise<MCPToolResult>;
+    /**
+     * Execute a tool on a specific server
+     */
+    private executeOnServer;
+    /**
+     * Execute via stdio
+     */
+    private executeStdio;
+    /**
+     * Execute via HTTP
+     */
+    private executeHttp;
+    /**
+     * Disconnect from all servers
+     */
+    disconnect(): void;
+    /**
+     * Get server names
+     */
+    getServerNames(): string[];
+    /**
+     * Check if a server is connected
+     */
+    isConnected(serverName: string): boolean;
+}
+/**
+ * Create an MCP tool manager
+ */
+export declare function createMCPToolManager(): MCPToolManager;
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/integrations/mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../../src/integrations/mcp-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,sBAAsB;IACtB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,wBAAwB;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA+C;IAE9D;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAcxC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI;IAM5C;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBnD;;OAEG;YACW,YAAY;IAgD1B;;OAEG;YACW,WAAW;IA4BzB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAUnC;;OAEG;IACH,iBAAiB,IAAI,OAAO,EAAE;IAU9B;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAe3F;;OAEG;YACW,eAAe;IAqB7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAmCpB;;OAEG;YACW,WAAW;IAoBzB;;OAEG;IACH,UAAU,IAAI,IAAI;IAWlB;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/integrations/mcp-tools.js

@@ -0,0 +1,272 @@
+/**
+ * MCP Tool Extension Support
+ *
+ * Allows users to extend Ralph with custom MCP (Model Context Protocol) tools.
+ */
+import { spawn } from 'node:child_process';
+import { debug, warn, info } from '../utils/index.js';
+/**
+ * MCP Tool Manager
+ *
+ * Manages connections to MCP servers and tool execution
+ */
+export class MCPToolManager {
+    servers = new Map();
+    /**
+     * Add an MCP server configuration
+     */
+    addServer(config) {
+        if (this.servers.has(config.name)) {
+            warn(`MCP server '${config.name}' already exists, replacing`);
+        }
+        this.servers.set(config.name, {
+            config,
+            tools: [],
+            connected: false,
+        });
+        debug(`Added MCP server: ${config.name}`);
+    }
+    /**
+     * Add multiple servers from configuration
+     */
+    addServers(configs) {
+        for (const config of configs) {
+            this.addServer(config);
+        }
+    }
+    /**
+     * Connect to an MCP server and discover tools
+     */
+    async connect(serverName) {
+        const connection = this.servers.get(serverName);
+        if (!connection) {
+            warn(`MCP server '${serverName}' not found`);
+            return false;
+        }
+        const { config } = connection;
+        try {
+            if (config.transport === 'http') {
+                return await this.connectHttp(connection);
+            }
+            else {
+                return await this.connectStdio(connection);
+            }
+        }
+        catch (err) {
+            warn(`Failed to connect to MCP server '${serverName}': ${err instanceof Error ? err.message : String(err)}`);
+            return false;
+        }
+    }
+    /**
+     * Connect via stdio transport
+     */
+    async connectStdio(connection) {
+        const { config } = connection;
+        const childProcess = spawn(config.command, config.args ?? [], {
+            env: { ...globalThis.process.env, ...config.env },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        connection.process = childProcess;
+        // Wait for initialization
+        return new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                debug(`MCP server '${config.name}' connection timeout`);
+                resolve(false);
+            }, 5000);
+            childProcess.stdout?.once('data', (data) => {
+                clearTimeout(timeout);
+                try {
+                    // Parse initialization response
+                    const response = JSON.parse(data.toString());
+                    if (response.tools) {
+                        connection.tools = response.tools.map((t) => ({
+                            ...t,
+                            server: config.name,
+                        }));
+                    }
+                    connection.connected = true;
+                    info(`Connected to MCP server '${config.name}' with ${connection.tools.length} tools`);
+                    resolve(true);
+                }
+                catch {
+                    debug(`Failed to parse MCP server response`);
+                    resolve(false);
+                }
+            });
+            childProcess.on('error', (err) => {
+                clearTimeout(timeout);
+                debug(`MCP server '${config.name}' error: ${err.message}`);
+                resolve(false);
+            });
+            // Send initialization request
+            childProcess.stdin?.write(JSON.stringify({ method: 'initialize' }) + '\n');
+        });
+    }
+    /**
+     * Connect via HTTP transport
+     */
+    async connectHttp(connection) {
+        const { config } = connection;
+        if (!config.endpoint) {
+            warn(`MCP server '${config.name}' has no endpoint configured`);
+            return false;
+        }
+        try {
+            const response = await fetch(`${config.endpoint}/tools`, {
+                method: 'GET',
+                headers: { 'Content-Type': 'application/json' },
+            });
+            if (!response.ok) {
+                return false;
+            }
+            const data = await response.json();
+            connection.tools = (data.tools ?? []).map(t => ({ ...t, server: config.name }));
+            connection.connected = true;
+            info(`Connected to MCP server '${config.name}' with ${connection.tools.length} tools`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Connect to all configured servers
+     */
+    async connectAll() {
+        let connected = 0;
+        for (const [name] of this.servers) {
+            if (await this.connect(name)) {
+                connected++;
+            }
+        }
+        return connected;
+    }
+    /**
+     * Get all available tools from connected servers
+     */
+    getAvailableTools() {
+        const tools = [];
+        for (const connection of this.servers.values()) {
+            if (connection.connected) {
+                tools.push(...connection.tools);
+            }
+        }
+        return tools;
+    }
+    /**
+     * Execute a tool
+     */
+    async executeTool(toolName, input) {
+        // Find the tool
+        for (const connection of this.servers.values()) {
+            const tool = connection.tools.find(t => t.name === toolName);
+            if (tool && connection.connected) {
+                return this.executeOnServer(connection, toolName, input);
+            }
+        }
+        return {
+            success: false,
+            error: `Tool '${toolName}' not found`,
+        };
+    }
+    /**
+     * Execute a tool on a specific server
+     */
+    async executeOnServer(connection, toolName, input) {
+        const { config } = connection;
+        try {
+            if (config.transport === 'http') {
+                return await this.executeHttp(config, toolName, input);
+            }
+            else {
+                return await this.executeStdio(connection, toolName, input);
+            }
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    /**
+     * Execute via stdio
+     */
+    executeStdio(connection, toolName, input) {
+        return new Promise((resolve) => {
+            if (!connection.process?.stdin || !connection.process?.stdout) {
+                resolve({ success: false, error: 'Server process not available' });
+                return;
+            }
+            const timeout = setTimeout(() => {
+                resolve({ success: false, error: 'Execution timeout' });
+            }, 30000);
+            connection.process.stdout.once('data', (data) => {
+                clearTimeout(timeout);
+                try {
+                    const response = JSON.parse(data.toString());
+                    resolve({
+                        success: !response.error,
+                        content: response.result,
+                        error: response.error,
+                    });
+                }
+                catch {
+                    resolve({ success: false, error: 'Failed to parse response' });
+                }
+            });
+            connection.process.stdin.write(JSON.stringify({ method: 'execute', tool: toolName, input }) + '\n');
+        });
+    }
+    /**
+     * Execute via HTTP
+     */
+    async executeHttp(config, toolName, input) {
+        const response = await fetch(`${config.endpoint}/execute`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ tool: toolName, input }),
+        });
+        const data = await response.json();
+        const result = {
+            success: response.ok && !data.error,
+        };
+        if (data.result !== undefined)
+            result.content = data.result;
+        if (data.error !== undefined)
+            result.error = data.error;
+        return result;
+    }
+    /**
+     * Disconnect from all servers
+     */
+    disconnect() {
+        for (const connection of this.servers.values()) {
+            if (connection.process) {
+                connection.process.kill();
+                delete connection.process;
+            }
+            connection.connected = false;
+        }
+        debug('Disconnected from all MCP servers');
+    }
+    /**
+     * Get server names
+     */
+    getServerNames() {
+        return Array.from(this.servers.keys());
+    }
+    /**
+     * Check if a server is connected
+     */
+    isConnected(serverName) {
+        return this.servers.get(serverName)?.connected ?? false;
+    }
+}
+/**
+ * Create an MCP tool manager
+ */
+export function createMCPToolManager() {
+    return new MCPToolManager();
+}
+//# sourceMappingURL=mcp-tools.js.map