musonda 1.0.0

package/dist/plugins/mcp/mcpClient.js

@@ -0,0 +1,309 @@
+import { spawn } from 'node:child_process';
+import readline from 'node:readline';
+import { logger } from '../../utils/logger.js';
+import { createSanitizedChildEnv } from '../../security/childProcessEnv.js';
+export class McpStdioClient {
+    server;
+    child = null;
+    pendingRequests = new Map();
+    nextRequestId = 1;
+    isConnected = false;
+    constructor(server) {
+        this.server = server;
+    }
+    async connect() {
+        const config = this.server.config;
+        const command = this.server.resolvedCommand || config.command;
+        const args = this.server.resolvedArgs || [];
+        const cwd = this.server.resolvedCwd;
+        // Explicitly configured server environment from mcp.json overlays safe system environment
+        const env = createSanitizedChildEnv(process.env, this.server.resolvedEnv || {});
+        // Ensure client provides PLUGIN_ROOT and PLUGIN_DATA
+        if (cwd) {
+            env['PLUGIN_ROOT'] = pathResolved(cwd);
+        }
+        // Set resolved root and data from server info if available
+        const pluginRoot = this.server.pluginRoot;
+        const pluginData = this.server.pluginData;
+        if (pluginRoot)
+            env['PLUGIN_ROOT'] = pluginRoot;
+        if (pluginData)
+            env['PLUGIN_DATA'] = pluginData;
+        logger.info(`[MCP: ${this.server.pluginName}/${this.server.name}] Launching stdio server: ${command} ${args.join(' ')}`);
+        try {
+            this.child = spawn(command, args, {
+                cwd,
+                env,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                shell: false,
+            });
+        }
+        catch (err) {
+            throw new Error(`Failed to spawn MCP server "${this.server.name}": ${err.message}`);
+        }
+        if (!this.child || !this.child.stdin || !this.child.stdout) {
+            throw new Error(`Failed to open stdio streams for MCP server "${this.server.name}".`);
+        }
+        this.child.on('error', (err) => {
+            logger.error(`[MCP: ${this.server.pluginName}/${this.server.name}] Process error:`, err);
+        });
+        this.child.on('exit', (code, signal) => {
+            logger.info(`[MCP: ${this.server.pluginName}/${this.server.name}] Process exited with code ${code}, signal ${signal}`);
+            this.isConnected = false;
+            for (const [id, req] of this.pendingRequests.entries()) {
+                clearTimeout(req.timer);
+                req.reject(new Error(`MCP server process terminated (exit code: ${code}).`));
+            }
+            this.pendingRequests.clear();
+        });
+        // Read lines from stdout
+        const rl = readline.createInterface({
+            input: this.child.stdout,
+            terminal: false,
+        });
+        rl.on('line', (line) => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return;
+            try {
+                const msg = JSON.parse(trimmed);
+                this.handleMessage(msg);
+            }
+            catch (err) {
+                logger.warn(`[MCP: ${this.server.pluginName}/${this.server.name}] Non-JSON line from stdout: ${trimmed.substring(0, 100)}`);
+            }
+        });
+        // Capture stderr for logging
+        if (this.child.stderr) {
+            this.child.stderr.on('data', (chunk) => {
+                logger.warn(`[MCP: ${this.server.pluginName}/${this.server.name} STDERR] ${chunk.toString().trim()}`);
+            });
+        }
+        // Step 1: initialize handshake
+        const initResult = await this.sendRequest('initialize', {
+            protocolVersion: '2024-11-05',
+            clientInfo: {
+                name: 'musonda',
+                version: '1.0.0',
+            },
+            capabilities: {},
+        });
+        logger.info(`[MCP: ${this.server.pluginName}/${this.server.name}] Initialized: ${JSON.stringify(initResult?.serverInfo || {})}`);
+        // Step 2: initialized notification
+        this.sendNotification('notifications/initialized', {});
+        this.isConnected = true;
+    }
+    handleMessage(msg) {
+        if (msg.id !== undefined && this.pendingRequests.has(msg.id)) {
+            const pending = this.pendingRequests.get(msg.id);
+            this.pendingRequests.delete(msg.id);
+            clearTimeout(pending.timer);
+            if (msg.error) {
+                pending.reject(new Error(`MCP Error ${msg.error.code || ''}: ${msg.error.message || JSON.stringify(msg.error)}`));
+            }
+            else {
+                pending.resolve(msg.result);
+            }
+        }
+    }
+    async sendRequest(method, params, timeoutMs = 15000) {
+        if (!this.child || !this.child.stdin || this.child.killed) {
+            throw new Error(`MCP server "${this.server.name}" is not running.`);
+        }
+        const id = this.nextRequestId++;
+        const payload = JSON.stringify({
+            jsonrpc: '2.0',
+            id,
+            method,
+            params: params || {},
+        });
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                if (this.pendingRequests.has(id)) {
+                    this.pendingRequests.delete(id);
+                    reject(new Error(`MCP request "${method}" timed out after ${timeoutMs}ms.`));
+                }
+            }, timeoutMs);
+            this.pendingRequests.set(id, { resolve, reject, timer });
+            try {
+                this.child.stdin.write(payload + '\n');
+            }
+            catch (err) {
+                clearTimeout(timer);
+                this.pendingRequests.delete(id);
+                reject(err);
+            }
+        });
+    }
+    sendNotification(method, params) {
+        if (!this.child || !this.child.stdin || this.child.killed)
+            return;
+        const payload = JSON.stringify({
+            jsonrpc: '2.0',
+            method,
+            params: params || {},
+        });
+        try {
+            this.child.stdin.write(payload + '\n');
+        }
+        catch {
+            // Best effort for notifications
+        }
+    }
+    async listTools() {
+        const res = await this.sendRequest('tools/list', {});
+        if (res && Array.isArray(res.tools)) {
+            return res.tools;
+        }
+        return [];
+    }
+    async callTool(name, args) {
+        const res = await this.sendRequest('tools/call', {
+            name,
+            arguments: args,
+        });
+        if (!res) {
+            return { output: '', isError: false };
+        }
+        let outputStr = '';
+        if (Array.isArray(res.content)) {
+            outputStr = res.content
+                .map((c) => (typeof c.text === 'string' ? c.text : JSON.stringify(c)))
+                .join('\n');
+        }
+        else if (res.content) {
+            outputStr = typeof res.content === 'string' ? res.content : JSON.stringify(res.content);
+        }
+        else {
+            outputStr = JSON.stringify(res, null, 2);
+        }
+        return {
+            output: outputStr,
+            isError: !!res.isError,
+        };
+    }
+    async close() {
+        this.isConnected = false;
+        for (const [id, req] of this.pendingRequests.entries()) {
+            clearTimeout(req.timer);
+            req.reject(new Error('MCP client closed.'));
+        }
+        this.pendingRequests.clear();
+        if (this.child && !this.child.killed) {
+            logger.info(`[MCP: ${this.server.pluginName}/${this.server.name}] Stopping server process...`);
+            await new Promise((resolve) => {
+                let resolved = false;
+                const done = () => {
+                    if (!resolved) {
+                        resolved = true;
+                        resolve();
+                    }
+                };
+                this.child.once('exit', done);
+                this.child.once('close', done);
+                try {
+                    if (this.child.stdin && !this.child.stdin.destroyed) {
+                        this.child.stdin.end();
+                    }
+                    this.child.kill('SIGTERM');
+                }
+                catch {
+                    done();
+                }
+                // Force kill fallback after 1000ms
+                setTimeout(() => {
+                    if (!resolved && this.child && !this.child.killed) {
+                        try {
+                            this.child.kill('SIGKILL');
+                        }
+                        catch { }
+                    }
+                    done();
+                }, 1000);
+            });
+        }
+    }
+}
+export class McpHttpClient {
+    server;
+    url;
+    headers;
+    nextRequestId = 1;
+    constructor(server) {
+        this.server = server;
+        const cfg = server.config;
+        this.url = cfg.url;
+        this.headers = cfg.headers || {};
+    }
+    async connect() {
+        // Perform initialize handshake over HTTP
+        await this.sendRequest('initialize', {
+            protocolVersion: '2024-11-05',
+            clientInfo: {
+                name: 'musonda',
+                version: '1.0.0',
+            },
+            capabilities: {},
+        });
+    }
+    async sendRequest(method, params) {
+        const id = this.nextRequestId++;
+        const body = JSON.stringify({
+            jsonrpc: '2.0',
+            id,
+            method,
+            params: params || {},
+        });
+        const resp = await fetch(this.url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.headers,
+            },
+            body,
+        });
+        if (!resp.ok) {
+            throw new Error(`HTTP MCP error (${resp.status} ${resp.statusText})`);
+        }
+        const data = await resp.json();
+        if (data.error) {
+            throw new Error(`MCP Error: ${data.error.message || JSON.stringify(data.error)}`);
+        }
+        return data.result;
+    }
+    async listTools() {
+        const res = await this.sendRequest('tools/list', {});
+        if (res && Array.isArray(res.tools)) {
+            return res.tools;
+        }
+        return [];
+    }
+    async callTool(name, args) {
+        const res = await this.sendRequest('tools/call', {
+            name,
+            arguments: args,
+        });
+        if (!res)
+            return { output: '', isError: false };
+        let outputStr = '';
+        if (Array.isArray(res.content)) {
+            outputStr = res.content
+                .map((c) => (typeof c.text === 'string' ? c.text : JSON.stringify(c)))
+                .join('\n');
+        }
+        else {
+            outputStr = typeof res === 'string' ? res : JSON.stringify(res, null, 2);
+        }
+        return {
+            output: outputStr,
+            isError: !!res.isError,
+        };
+    }
+    async close() {
+        // HTTP stateless client does not require long-running process teardown
+    }
+}
+function pathResolved(p) {
+    return p;
+}
+//# sourceMappingURL=mcpClient.js.map

package/dist/plugins/mcp/mcpClient.js.map

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

package/dist/plugins/mcp/mcpConfig.d.ts

@@ -0,0 +1,34 @@
+import { McpDocument, ResolvedMcpServer } from './types.js';
+export interface McpLoadResult {
+    valid: boolean;
+    servers: ResolvedMcpServer[];
+    errors: string[];
+    warnings: string[];
+}
+export declare class McpConfigValidator {
+    /**
+     * Expands ${PLUGIN_ROOT} and ${PLUGIN_DATA} in a string value.
+     * Single-pass, non-recursive textual replacement.
+     */
+    static expandVariables(value: string, pluginRoot: string, pluginData: string): string;
+    /**
+     * Validates top-level mcp.json document structure.
+     */
+    static validateTopLevel(data: unknown): {
+        valid: boolean;
+        doc?: McpDocument;
+        errors: string[];
+    };
+    /**
+     * Validates and resolves an individual server entry from mcpServers.
+     */
+    static validateServer(serverName: string, rawConfig: any, pluginName: string, pluginRoot: string, pluginData: string): {
+        valid: boolean;
+        server?: ResolvedMcpServer;
+        errors: string[];
+    };
+    /**
+     * Discovers and parses mcp.json from a plugin directory.
+     */
+    static loadFromDirectory(pluginRootDir: string, pluginName: string, pluginDataDir: string): McpLoadResult;
+}