beth-copilot 1.0.17 → 1.1.0

package/dist/tools/mcp/client.js

@@ -1,263 +0,0 @@
-/**
- * MCP Client
- *
- * Minimal Model Context Protocol client that communicates with
- * MCP servers over stdio transport using JSON-RPC 2.0.
- */
-import { spawn } from 'node:child_process';
-import { createInterface } from 'node:readline';
-/** Default timeout for MCP requests in milliseconds */
-const DEFAULT_TIMEOUT_MS = 10_000;
-/** MCP protocol version */
-const PROTOCOL_VERSION = '2024-11-05';
-/** Client info sent during initialization */
-const CLIENT_INFO = { name: 'beth-cli', version: '1.0.15' };
-// =============================================================================
-// MCP Client
-// =============================================================================
-/**
- * MCP protocol client for stdio-based MCP servers.
- *
- * Handles the JSON-RPC 2.0 transport, initialization handshake,
- * tool listing, and tool invocation.
- *
- * @example
- * ```typescript
- * const client = new MCPClient('shadcn', {
- *   command: 'npx',
- *   args: ['shadcn@3.7.0', 'mcp'],
- * });
- * await client.connect();
- * const tools = await client.listTools();
- * const result = await client.callTool('search', { query: 'button' });
- * await client.disconnect();
- * ```
- */
-export class MCPClient {
-    /** Server name (for logging/namespacing) */
-    name;
-    /** Server configuration */
-    config;
-    /** Spawn function (injectable for testing) */
-    spawnFn;
-    /** Request timeout in milliseconds */
-    timeoutMs;
-    /** The spawned server process */
-    process = null;
-    /** Readline interface for reading stdout line by line */
-    reader = null;
-    /** Incrementing request ID counter */
-    nextId = 1;
-    /** Whether the initialization handshake has completed */
-    initialized = false;
-    /** Pending request resolvers keyed by request ID */
-    pending = new Map();
-    constructor(name, config, options) {
-        this.name = name;
-        this.config = config;
-        this.spawnFn = options?.spawnFn ?? spawn;
-        this.timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    }
-    /**
-     * Whether the client is connected and initialized.
-     */
-    get connected() {
-        return this.initialized && this.process !== null;
-    }
-    /**
-     * Start the MCP server process and perform the initialization handshake.
-     *
-     * @throws Error if the process fails to start or initialization times out
-     */
-    async connect() {
-        if (this.process) {
-            throw new Error(`MCP client "${this.name}" is already connected`);
-        }
-        const env = this.config.env
-            ? { ...process.env, ...this.config.env }
-            : process.env;
-        this.process = this.spawnFn(this.config.command, this.config.args, {
-            stdio: ['pipe', 'pipe', 'pipe'],
-            env,
-        });
-        // Handle unexpected process exit
-        this.process.on('error', (err) => {
-            this.rejectAllPending(new Error(`MCP server "${this.name}" process error: ${err.message}`));
-            this.cleanup();
-        });
-        this.process.on('close', () => {
-            this.rejectAllPending(new Error(`MCP server "${this.name}" process exited unexpectedly`));
-            this.cleanup();
-        });
-        // Set up line-delimited JSON reader on stdout
-        if (!this.process.stdout) {
-            throw new Error(`MCP server "${this.name}" has no stdout`);
-        }
-        this.reader = createInterface({ input: this.process.stdout });
-        this.reader.on('line', (line) => this.handleLine(line));
-        // Perform initialization handshake
-        await this.sendRequest('initialize', {
-            protocolVersion: PROTOCOL_VERSION,
-            capabilities: {},
-            clientInfo: CLIENT_INFO,
-        });
-        this.sendNotification('notifications/initialized');
-        this.initialized = true;
-    }
-    /**
-     * List available tools from the MCP server.
-     *
-     * @returns Array of tool information
-     * @throws Error if not connected
-     */
-    async listTools() {
-        this.ensureConnected();
-        const result = await this.sendRequest('tools/list', {});
-        const tools = result.tools;
-        if (!Array.isArray(tools)) {
-            return [];
-        }
-        return tools.map((t) => ({
-            name: String(t.name ?? ''),
-            description: String(t.description ?? ''),
-            inputSchema: t.inputSchema ?? {},
-        }));
-    }
-    /**
-     * Call a tool on the MCP server.
-     *
-     * @param toolName - Name of the tool to call
-     * @param args - Arguments to pass to the tool
-     * @returns Tool execution result
-     * @throws Error if not connected or the tool call fails
-     */
-    async callTool(toolName, args) {
-        this.ensureConnected();
-        return this.sendRequest('tools/call', {
-            name: toolName,
-            arguments: args,
-        });
-    }
-    /**
-     * Shut down the MCP server process.
-     */
-    async disconnect() {
-        this.rejectAllPending(new Error(`MCP client "${this.name}" disconnecting`));
-        this.cleanup();
-    }
-    // ===========================================================================
-    // Internal: JSON-RPC transport
-    // ===========================================================================
-    /**
-     * Send a JSON-RPC request and wait for the matching response.
-     */
-    sendRequest(method, params) {
-        const id = this.nextId++;
-        const message = {
-            jsonrpc: '2.0',
-            id,
-            method,
-            params,
-        };
-        return new Promise((resolve, reject) => {
-            // Set up timeout
-            const timer = setTimeout(() => {
-                this.pending.delete(id);
-                reject(new Error(`MCP request "${method}" timed out after ${this.timeoutMs}ms`));
-            }, this.timeoutMs);
-            this.pending.set(id, {
-                resolve: (value) => {
-                    clearTimeout(timer);
-                    resolve(value);
-                },
-                reject: (reason) => {
-                    clearTimeout(timer);
-                    reject(reason);
-                },
-            });
-            this.writeMessage(JSON.stringify(message));
-        });
-    }
-    /**
-     * Send a JSON-RPC notification (no response expected).
-     */
-    sendNotification(method, params) {
-        const message = {
-            jsonrpc: '2.0',
-            method,
-            ...(params !== undefined ? { params } : {}),
-        };
-        this.writeMessage(JSON.stringify(message));
-    }
-    /**
-     * Write a line-delimited JSON message to the process stdin.
-     */
-    writeMessage(json) {
-        if (!this.process?.stdin?.writable) {
-            throw new Error(`MCP server "${this.name}" stdin is not writable`);
-        }
-        this.process.stdin.write(json + '\n');
-    }
-    /**
-     * Handle a line of JSON from the server's stdout.
-     */
-    handleLine(line) {
-        const trimmed = line.trim();
-        if (!trimmed)
-            return;
-        let parsed;
-        try {
-            parsed = JSON.parse(trimmed);
-        }
-        catch {
-            // Ignore malformed lines (e.g., server logging to stdout)
-            return;
-        }
-        // Only handle responses with an id that we're waiting for
-        if (parsed.id === undefined || parsed.id === null)
-            return;
-        const pending = this.pending.get(parsed.id);
-        if (!pending)
-            return;
-        this.pending.delete(parsed.id);
-        if (parsed.error) {
-            pending.reject(new Error(`MCP error (${parsed.error.code}): ${parsed.error.message}`));
-        }
-        else {
-            pending.resolve(parsed.result);
-        }
-    }
-    /**
-     * Assert that the client is connected.
-     */
-    ensureConnected() {
-        if (!this.connected) {
-            throw new Error(`MCP client "${this.name}" is not connected`);
-        }
-    }
-    /**
-     * Reject all pending requests.
-     */
-    rejectAllPending(error) {
-        for (const [id, pending] of this.pending) {
-            pending.reject(error);
-            this.pending.delete(id);
-        }
-    }
-    /**
-     * Clean up the process and reader.
-     */
-    cleanup() {
-        this.initialized = false;
-        if (this.reader) {
-            this.reader.close();
-            this.reader = null;
-        }
-        if (this.process) {
-            this.process.stdin?.end();
-            this.process.kill();
-            this.process = null;
-        }
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/tools/mcp/client.js.map

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

package/dist/tools/mcp/client.test.d.ts

@@ -1,8 +0,0 @@
-/**
- * MCP Client Tests
- *
- * Tests for the MCP protocol client including JSON-RPC message
- * formatting, request lifecycle, and timeout handling.
- */
-export {};
-//# sourceMappingURL=client.test.d.ts.map

package/dist/tools/mcp/client.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../../src/tools/mcp/client.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/tools/mcp/client.test.js

@@ -1,390 +0,0 @@
-/**
- * MCP Client Tests
- *
- * Tests for the MCP protocol client including JSON-RPC message
- * formatting, request lifecycle, and timeout handling.
- */
-import { describe, it } from 'node:test';
-import assert from 'node:assert';
-import { EventEmitter } from 'node:events';
-import { PassThrough } from 'node:stream';
-import { MCPClient } from './client.js';
-/**
- * Create a mock child process with controllable stdin/stdout.
- */
-function createMockProcess() {
-    const proc = new EventEmitter();
-    proc.stdin = new PassThrough();
-    proc.stdout = new PassThrough();
-    proc.stderr = new PassThrough();
-    proc.killed = false;
-    proc.kill = () => { proc.killed = true; };
-    return proc;
-}
-/**
- * Collect all messages written to a PassThrough stream as parsed JSON-RPC.
- */
-function collectMessages(stream) {
-    const messages = [];
-    let buffer = '';
-    stream.on('data', (chunk) => {
-        buffer += chunk.toString();
-        const lines = buffer.split('\n');
-        // Keep the last incomplete line in the buffer
-        buffer = lines.pop() ?? '';
-        for (const line of lines) {
-            if (line.trim()) {
-                messages.push(JSON.parse(line));
-            }
-        }
-    });
-    return messages;
-}
-/**
- * Create a spawn function that returns the given mock process.
- */
-function createMockSpawn(proc) {
-    return (() => proc);
-}
-/**
- * Respond to pending requests on a mock process's stdout.
- * Reads from stdin, auto-responds with matching id.
- */
-function autoRespond(proc, handler) {
-    let buffer = '';
-    proc.stdin.on('data', (chunk) => {
-        buffer += chunk.toString();
-        const lines = buffer.split('\n');
-        buffer = lines.pop() ?? '';
-        for (const line of lines) {
-            if (!line.trim())
-                continue;
-            const msg = JSON.parse(line);
-            // Only respond to requests (those with an id), not notifications
-            if (msg.id !== undefined) {
-                const result = handler(msg);
-                const response = JSON.stringify({ jsonrpc: '2.0', id: msg.id, result });
-                proc.stdout.push(response + '\n');
-            }
-        }
-    });
-}
-// =============================================================================
-// Tests
-// =============================================================================
-describe('MCPClient', () => {
-    describe('construction', () => {
-        it('should create a client with name and config', () => {
-            const client = new MCPClient('test-server', {
-                command: 'npx',
-                args: ['-y', 'some-server'],
-            });
-            assert.strictEqual(client.name, 'test-server');
-            assert.strictEqual(client.connected, false);
-        });
-        it('should accept custom timeout', () => {
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                timeoutMs: 5000,
-            });
-            assert.strictEqual(client.name, 'test');
-        });
-    });
-    describe('connect', () => {
-        it('should spawn the server process and perform handshake', async () => {
-            const proc = createMockProcess();
-            let spawnCalled = false;
-            let spawnCmd = '';
-            let spawnArgs = [];
-            const mockSpawn = ((cmd, args) => {
-                spawnCalled = true;
-                spawnCmd = cmd;
-                spawnArgs = args;
-                return proc;
-            });
-            autoRespond(proc, (msg) => {
-                if (msg.method === 'initialize') {
-                    return { protocolVersion: '2024-11-05', capabilities: {} };
-                }
-                return {};
-            });
-            const client = new MCPClient('test', {
-                command: 'npx',
-                args: ['-y', 'test-server'],
-            }, { spawnFn: mockSpawn });
-            await client.connect();
-            assert.strictEqual(spawnCalled, true);
-            assert.strictEqual(spawnCmd, 'npx');
-            assert.deepStrictEqual(spawnArgs, ['-y', 'test-server']);
-            assert.strictEqual(client.connected, true);
-            await client.disconnect();
-        });
-        it('should throw if already connected', async () => {
-            const proc = createMockProcess();
-            autoRespond(proc, () => ({ protocolVersion: '2024-11-05', capabilities: {} }));
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            await client.connect();
-            await assert.rejects(() => client.connect(), (err) => {
-                assert.ok(err.message.includes('already connected'));
-                return true;
-            });
-            await client.disconnect();
-        });
-        it('should send initialize request with correct params', async () => {
-            const proc = createMockProcess();
-            const messages = collectMessages(proc.stdin);
-            autoRespond(proc, () => ({ protocolVersion: '2024-11-05', capabilities: {} }));
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            await client.connect();
-            // First message should be the initialize request
-            const initMsg = messages[0];
-            assert.strictEqual(initMsg.jsonrpc, '2.0');
-            assert.strictEqual(initMsg.method, 'initialize');
-            assert.strictEqual(initMsg.id, 1);
-            const params = initMsg.params;
-            assert.strictEqual(params.protocolVersion, '2024-11-05');
-            assert.deepStrictEqual(params.clientInfo, { name: 'beth-cli', version: '1.0.15' });
-            await client.disconnect();
-        });
-        it('should send initialized notification after handshake', async () => {
-            const proc = createMockProcess();
-            const messages = collectMessages(proc.stdin);
-            autoRespond(proc, () => ({ protocolVersion: '2024-11-05', capabilities: {} }));
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            await client.connect();
-            // Second message should be the initialized notification (no id)
-            const notifMsg = messages[1];
-            assert.strictEqual(notifMsg.jsonrpc, '2.0');
-            assert.strictEqual(notifMsg.method, 'notifications/initialized');
-            assert.strictEqual(notifMsg.id, undefined);
-            await client.disconnect();
-        });
-    });
-    describe('request IDs', () => {
-        it('should increment request IDs', async () => {
-            const proc = createMockProcess();
-            const messages = collectMessages(proc.stdin);
-            autoRespond(proc, () => ({ protocolVersion: '2024-11-05', capabilities: {}, tools: [] }));
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            await client.connect(); // id: 1 (initialize)
-            await client.listTools(); // id: 2 (tools/list)
-            const initMsg = messages[0];
-            assert.strictEqual(initMsg.id, 1);
-            // messages[1] is the notification (no id), messages[2] is tools/list
-            const listMsg = messages[2];
-            assert.strictEqual(listMsg.id, 2);
-            await client.disconnect();
-        });
-    });
-    describe('listTools', () => {
-        it('should return tool info from server', async () => {
-            const proc = createMockProcess();
-            autoRespond(proc, (msg) => {
-                if (msg.method === 'initialize') {
-                    return { protocolVersion: '2024-11-05', capabilities: {} };
-                }
-                if (msg.method === 'tools/list') {
-                    return {
-                        tools: [
-                            {
-                                name: 'search',
-                                description: 'Search for components',
-                                inputSchema: { type: 'object', properties: { query: { type: 'string' } } },
-                            },
-                            {
-                                name: 'install',
-                                description: 'Install a component',
-                                inputSchema: { type: 'object', properties: { name: { type: 'string' } } },
-                            },
-                        ],
-                    };
-                }
-                return {};
-            });
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            await client.connect();
-            const tools = await client.listTools();
-            assert.strictEqual(tools.length, 2);
-            assert.strictEqual(tools[0].name, 'search');
-            assert.strictEqual(tools[0].description, 'Search for components');
-            assert.deepStrictEqual(tools[0].inputSchema, {
-                type: 'object',
-                properties: { query: { type: 'string' } },
-            });
-            assert.strictEqual(tools[1].name, 'install');
-            await client.disconnect();
-        });
-        it('should return empty array when server returns no tools', async () => {
-            const proc = createMockProcess();
-            autoRespond(proc, (msg) => {
-                if (msg.method === 'initialize') {
-                    return { protocolVersion: '2024-11-05', capabilities: {} };
-                }
-                return { tools: [] };
-            });
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            await client.connect();
-            const tools = await client.listTools();
-            assert.deepStrictEqual(tools, []);
-            await client.disconnect();
-        });
-        it('should throw if not connected', async () => {
-            const client = new MCPClient('test', { command: 'node', args: [] });
-            await assert.rejects(() => client.listTools(), (err) => {
-                assert.ok(err.message.includes('not connected'));
-                return true;
-            });
-        });
-    });
-    describe('callTool', () => {
-        it('should send tools/call request with name and arguments', async () => {
-            const proc = createMockProcess();
-            const messages = collectMessages(proc.stdin);
-            autoRespond(proc, (msg) => {
-                if (msg.method === 'initialize') {
-                    return { protocolVersion: '2024-11-05', capabilities: {} };
-                }
-                if (msg.method === 'tools/call') {
-                    return { content: [{ type: 'text', text: 'result data' }] };
-                }
-                return {};
-            });
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            await client.connect();
-            const result = await client.callTool('search', { query: 'button' });
-            // Verify the request format (messages[2] is the callTool request)
-            const callMsg = messages[2];
-            assert.strictEqual(callMsg.method, 'tools/call');
-            const params = callMsg.params;
-            assert.strictEqual(params.name, 'search');
-            assert.deepStrictEqual(params.arguments, { query: 'button' });
-            // Verify the result
-            assert.deepStrictEqual(result, { content: [{ type: 'text', text: 'result data' }] });
-            await client.disconnect();
-        });
-        it('should throw if not connected', async () => {
-            const client = new MCPClient('test', { command: 'node', args: [] });
-            await assert.rejects(() => client.callTool('search', {}), (err) => {
-                assert.ok(err.message.includes('not connected'));
-                return true;
-            });
-        });
-    });
-    describe('disconnect', () => {
-        it('should set connected to false', async () => {
-            const proc = createMockProcess();
-            autoRespond(proc, () => ({ protocolVersion: '2024-11-05', capabilities: {} }));
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            await client.connect();
-            assert.strictEqual(client.connected, true);
-            await client.disconnect();
-            assert.strictEqual(client.connected, false);
-        });
-        it('should be safe to call when not connected', async () => {
-            const client = new MCPClient('test', { command: 'node', args: [] });
-            // Should not throw
-            await client.disconnect();
-            assert.strictEqual(client.connected, false);
-        });
-    });
-    describe('timeout handling', () => {
-        it('should reject request on timeout', async () => {
-            const proc = createMockProcess();
-            // Don't auto-respond to anything — let it time out
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-                timeoutMs: 50, // Very short timeout for test
-            });
-            await assert.rejects(() => client.connect(), // initialize will time out
-            (err) => {
-                assert.ok(err.message.includes('timed out'));
-                return true;
-            });
-            await client.disconnect();
-        });
-    });
-    describe('error responses', () => {
-        it('should reject on JSON-RPC error response', async () => {
-            const proc = createMockProcess();
-            let initDone = false;
-            // Custom handler: respond to initialize, error on tools/list
-            let buffer = '';
-            proc.stdin.on('data', (chunk) => {
-                buffer += chunk.toString();
-                const lines = buffer.split('\n');
-                buffer = lines.pop() ?? '';
-                for (const line of lines) {
-                    if (!line.trim())
-                        continue;
-                    const msg = JSON.parse(line);
-                    if (msg.id === undefined)
-                        continue;
-                    if (msg.method === 'initialize') {
-                        const resp = JSON.stringify({
-                            jsonrpc: '2.0',
-                            id: msg.id,
-                            result: { protocolVersion: '2024-11-05', capabilities: {} },
-                        });
-                        proc.stdout.push(resp + '\n');
-                        initDone = true;
-                    }
-                    else if (msg.method === 'tools/list' && initDone) {
-                        const resp = JSON.stringify({
-                            jsonrpc: '2.0',
-                            id: msg.id,
-                            error: { code: -32600, message: 'Not supported' },
-                        });
-                        proc.stdout.push(resp + '\n');
-                    }
-                }
-            });
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            await client.connect();
-            await assert.rejects(() => client.listTools(), (err) => {
-                assert.ok(err.message.includes('Not supported'));
-                return true;
-            });
-            await client.disconnect();
-        });
-    });
-    describe('malformed responses', () => {
-        it('should ignore non-JSON lines from server', async () => {
-            const proc = createMockProcess();
-            // Send garbage before the real response
-            autoRespond(proc, (msg) => {
-                if (msg.method === 'initialize') {
-                    // Push garbage first
-                    proc.stdout.push('This is not JSON\n');
-                    proc.stdout.push('DEBUG: server starting\n');
-                    return { protocolVersion: '2024-11-05', capabilities: {} };
-                }
-                return {};
-            });
-            const client = new MCPClient('test', { command: 'node', args: [] }, {
-                spawnFn: createMockSpawn(proc),
-            });
-            // Should not throw despite garbage lines
-            await client.connect();
-            assert.strictEqual(client.connected, true);
-            await client.disconnect();
-        });
-    });
-});
-//# sourceMappingURL=client.test.js.map