ft-scout 9.0.7 → 9.0.8

package/bin/src/mcp/transport.js

@@ -0,0 +1,328 @@
+/**
+ * Scout MCP Ecosystem - Transports
+ * Implements Streamable HTTP and stdio local process transports for MCP JSON-RPC 2.0.
+ */
+import { spawn } from 'child_process';
+/**
+ * Streamable HTTP Transport
+ * Communicates with remote or local HTTP MCP servers using JSON-RPC 2.0 over HTTP.
+ */
+export class HttpMcpTransport {
+    endpoint;
+    headers;
+    connected = false;
+    requestId = 1;
+    notificationListeners = [];
+    constructor(endpoint, headers = {}) {
+        this.endpoint = endpoint.trim().replace(/\/+$/, '');
+        this.headers = {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json, text/event-stream',
+            ...headers,
+        };
+    }
+    getTransportType() {
+        return 'http';
+    }
+    isConnected() {
+        return this.connected;
+    }
+    onNotification(listener) {
+        this.notificationListeners.push(listener);
+    }
+    async connect() {
+        // Ping or check reachability
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 10000);
+            const res = await fetch(this.endpoint, {
+                method: 'GET',
+                headers: this.headers,
+                signal: controller.signal,
+            }).catch(() => null);
+            clearTimeout(timeout);
+            // Accept standard HTTP status codes (200, 404/405 for GET on POST endpoint is fine for connect check)
+            if (res && res.status >= 500) {
+                throw new Error(`MCP HTTP Server returned status ${res.status} ${res.statusText}`);
+            }
+            this.connected = true;
+        }
+        catch (err) {
+            this.connected = false;
+            throw new Error(`Failed to connect to MCP HTTP endpoint at ${this.endpoint}: ${err?.message || String(err)}`);
+        }
+    }
+    async disconnect() {
+        this.connected = false;
+    }
+    async sendRequest(method, params, timeoutMs = 30000) {
+        const id = this.requestId++;
+        const requestPayload = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            ...(params !== undefined ? { params } : {}),
+        };
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: this.headers,
+                body: JSON.stringify(requestPayload),
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            if (!response.ok) {
+                const text = await response.text().catch(() => '');
+                throw new Error(`HTTP ${response.status} ${response.statusText}: ${text || 'Empty response'}`);
+            }
+            const contentType = response.headers.get('content-type') || '';
+            let data;
+            if (contentType.includes('text/event-stream')) {
+                // Parse SSE response
+                const text = await response.text();
+                const lines = text.split('\n');
+                for (const line of lines) {
+                    if (line.startsWith('data:')) {
+                        const jsonStr = line.slice(5).trim();
+                        if (jsonStr) {
+                            try {
+                                data = JSON.parse(jsonStr);
+                                break;
+                            }
+                            catch { }
+                        }
+                    }
+                }
+                if (!data) {
+                    throw new Error(`Invalid SSE response from MCP server: ${text.slice(0, 200)}`);
+                }
+            }
+            else {
+                data = await response.json();
+            }
+            if (data.error) {
+                throw new Error(data.error.message || `MCP Error code ${data.error.code}`);
+            }
+            return data.result;
+        }
+        catch (err) {
+            clearTimeout(timer);
+            if (err.name === 'AbortError') {
+                throw new Error(`MCP Request timed out after ${timeoutMs}ms for method "${method}"`);
+            }
+            throw err;
+        }
+    }
+    async sendNotification(method, params) {
+        const notificationPayload = {
+            jsonrpc: '2.0',
+            method,
+            ...(params !== undefined ? { params } : {}),
+        };
+        try {
+            await fetch(this.endpoint, {
+                method: 'POST',
+                headers: this.headers,
+                body: JSON.stringify(notificationPayload),
+            });
+        }
+        catch {
+            // Notifications do not wait for responses
+        }
+    }
+}
+/**
+ * stdio Local Process Transport
+ * Spawns a local MCP server child process communicating over stdin/stdout with newline-delimited JSON-RPC 2.0.
+ */
+export class StdioMcpTransport {
+    command;
+    args;
+    env;
+    process = null;
+    connected = false;
+    requestId = 1;
+    pendingRequests = new Map();
+    notificationListeners = [];
+    stdoutBuffer = '';
+    stderrBuffer = '';
+    constructor(command, args = [], env = {}) {
+        this.command = command;
+        this.args = args;
+        this.env = env;
+    }
+    getTransportType() {
+        return 'stdio';
+    }
+    isConnected() {
+        return this.connected && this.process !== null && !this.process.killed;
+    }
+    onNotification(listener) {
+        this.notificationListeners.push(listener);
+    }
+    getStderrDiagnostics() {
+        return this.stderrBuffer.slice(-2000);
+    }
+    async connect() {
+        return new Promise((resolve, reject) => {
+            try {
+                const fullEnv = {
+                    ...process.env,
+                    ...this.env,
+                };
+                this.process = spawn(this.command, this.args, {
+                    env: fullEnv,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    shell: process.platform === 'win32',
+                });
+                let spawnErrorOccurred = false;
+                this.process.on('error', (err) => {
+                    spawnErrorOccurred = true;
+                    this.connected = false;
+                    reject(new Error(`Failed to spawn MCP process "${this.command}": ${err.message}`));
+                });
+                this.process.stdout?.on('data', (chunk) => {
+                    this.handleStdoutData(chunk.toString('utf-8'));
+                });
+                this.process.stderr?.on('data', (chunk) => {
+                    this.stderrBuffer += chunk.toString('utf-8');
+                    if (this.stderrBuffer.length > 10000) {
+                        this.stderrBuffer = this.stderrBuffer.slice(-5000);
+                    }
+                });
+                this.process.on('exit', (code, signal) => {
+                    this.connected = false;
+                    for (const [id, req] of this.pendingRequests.entries()) {
+                        clearTimeout(req.timer);
+                        req.reject(new Error(`MCP process exited with code ${code ?? signal}`));
+                        this.pendingRequests.delete(id);
+                    }
+                });
+                // Short settle delay to ensure process didn't immediately crash on start
+                setTimeout(() => {
+                    if (!spawnErrorOccurred && this.process && !this.process.killed) {
+                        this.connected = true;
+                        resolve();
+                    }
+                }, 100);
+            }
+            catch (err) {
+                this.connected = false;
+                reject(err);
+            }
+        });
+    }
+    async disconnect() {
+        this.connected = false;
+        if (this.process) {
+            for (const [id, req] of this.pendingRequests.entries()) {
+                clearTimeout(req.timer);
+                req.reject(new Error('MCP process disconnected'));
+                this.pendingRequests.delete(id);
+            }
+            try {
+                this.process.kill('SIGTERM');
+            }
+            catch {
+                try {
+                    this.process.kill();
+                }
+                catch { }
+            }
+            this.process = null;
+        }
+    }
+    handleStdoutData(data) {
+        this.stdoutBuffer += data;
+        let newlineIndex;
+        while ((newlineIndex = this.stdoutBuffer.indexOf('\n')) !== -1) {
+            const line = this.stdoutBuffer.slice(0, newlineIndex).trim();
+            this.stdoutBuffer = this.stdoutBuffer.slice(newlineIndex + 1);
+            if (line) {
+                this.parseJsonRpcLine(line);
+            }
+        }
+    }
+    parseJsonRpcLine(line) {
+        try {
+            // Support Content-Length prefix if sent by some standard language servers
+            let payload = line;
+            if (line.startsWith('Content-Length:')) {
+                const headerEnd = line.indexOf('\r\n\r\n');
+                if (headerEnd !== -1) {
+                    payload = line.slice(headerEnd + 4);
+                }
+                else {
+                    return;
+                }
+            }
+            const parsed = JSON.parse(payload);
+            // Handle Response to pending request
+            if (parsed.id !== undefined && this.pendingRequests.has(parsed.id)) {
+                const pending = this.pendingRequests.get(parsed.id);
+                clearTimeout(pending.timer);
+                this.pendingRequests.delete(parsed.id);
+                if (parsed.error) {
+                    pending.reject(new Error(parsed.error.message || `MCP Error code ${parsed.error.code}`));
+                }
+                else {
+                    pending.resolve(parsed.result);
+                }
+                return;
+            }
+            // Handle Notification
+            if (parsed.method) {
+                for (const listener of this.notificationListeners) {
+                    try {
+                        listener(parsed.method, parsed.params);
+                    }
+                    catch { }
+                }
+            }
+        }
+        catch {
+            // Ignore non-JSON lines (e.g. startup banner text output by child process)
+        }
+    }
+    sendRequest(method, params, timeoutMs = 30000) {
+        return new Promise((resolve, reject) => {
+            if (!this.isConnected() || !this.process?.stdin) {
+                return reject(new Error(`MCP stdio transport is not connected for "${this.command}"`));
+            }
+            const id = this.requestId++;
+            const payload = {
+                jsonrpc: '2.0',
+                id,
+                method,
+                ...(params !== undefined ? { params } : {}),
+            };
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error(`MCP stdio request timed out after ${timeoutMs}ms for method "${method}"`));
+            }, timeoutMs);
+            this.pendingRequests.set(id, { resolve, reject, timer });
+            const jsonStr = JSON.stringify(payload) + '\n';
+            this.process.stdin.write(jsonStr, 'utf-8', (err) => {
+                if (err) {
+                    clearTimeout(timer);
+                    this.pendingRequests.delete(id);
+                    reject(new Error(`Failed to write to MCP process stdin: ${err.message}`));
+                }
+            });
+        });
+    }
+    async sendNotification(method, params) {
+        if (!this.isConnected() || !this.process?.stdin)
+            return;
+        const payload = {
+            jsonrpc: '2.0',
+            method,
+            ...(params !== undefined ? { params } : {}),
+        };
+        const jsonStr = JSON.stringify(payload) + '\n';
+        this.process.stdin.write(jsonStr, 'utf-8');
+    }
+}
+//# sourceMappingURL=transport.js.map

package/bin/src/mcp/transport.js.map

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

package/bin/src/mcp/types.d.ts.map

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

package/bin/src/mcp/types.js

@@ -0,0 +1,6 @@
+/**
+ * Scout MCP Ecosystem - Type Definitions
+ * Standards-compliant Model Context Protocol (MCP) types and internal Scout representations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/src/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/bin/src/server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AA8ExB,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,MAAqB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA8uB/G"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AA+ExB,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,MAAqB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAk8B/G"}

package/bin/src/server/server.js

@@ -13,6 +13,7 @@ import dotenv from 'dotenv';
 import { TaskStateManager } from '../engine/agentState.js';
 import { ApprovalManager } from '../engine/safety.js';
 import { AgentExecutionLoop } from '../engine/agentEngine.js';
+import { getMCPManager, MCPTelemetry } from '../mcp/index.js';
 let activeAgentLoop = null;
 const serverStateManager = new TaskStateManager(process.cwd());
 const DEFAULT_PORT = 9120;
@@ -724,6 +725,212 @@ export function startDashboardServer(port = DEFAULT_PORT) {
                     });
                     return;
                 }
+                // ==========================================
+                // MCP ECOSYSTEM REST API
+                // ==========================================
+                // GET /api/mcp/servers - List all configured MCP servers
+                if (pathname === '/api/mcp/servers' && req.method === 'GET') {
+                    try {
+                        const manager = getMCPManager();
+                        const servers = manager.listServers();
+                        res.writeHead(200);
+                        res.end(JSON.stringify({ success: true, servers }));
+                    }
+                    catch (err) {
+                        res.writeHead(500);
+                        res.end(JSON.stringify({ success: false, error: err.message || 'Failed to list MCP servers' }));
+                    }
+                    return;
+                }
+                // POST /api/mcp/servers - Add a new MCP server
+                if (pathname === '/api/mcp/servers' && req.method === 'POST') {
+                    let body = '';
+                    req.on('data', chunk => body += chunk);
+                    req.on('end', async () => {
+                        try {
+                            const data = JSON.parse(body || '{}');
+                            if (!data.name || !data.transport) {
+                                res.writeHead(400);
+                                res.end(JSON.stringify({ success: false, error: 'Name and transport (http|stdio) are required.' }));
+                                return;
+                            }
+                            const manager = getMCPManager();
+                            const server = await manager.addServer({
+                                name: data.name,
+                                transport: data.transport,
+                                endpoint: data.endpoint,
+                                command: data.command,
+                                args: data.args,
+                                authType: data.authType || (data.token ? 'bearer' : 'none'),
+                                authHeader: data.headerKey,
+                                permissions: data.permissions,
+                            }, data.token);
+                            if (data.autoConnect) {
+                                try {
+                                    await manager.connectServer(server.id);
+                                }
+                                catch {
+                                    // Log but return created server with its status
+                                }
+                            }
+                            const updated = manager.getServer(server.id) || server;
+                            res.writeHead(201);
+                            res.end(JSON.stringify({ success: true, server: updated }));
+                        }
+                        catch (err) {
+                            res.writeHead(400);
+                            res.end(JSON.stringify({ success: false, error: err.message || 'Failed to add MCP server' }));
+                        }
+                    });
+                    return;
+                }
+                // GET /api/mcp/health - Check health across all MCP servers
+                if (pathname === '/api/mcp/health' && req.method === 'GET') {
+                    try {
+                        const manager = getMCPManager();
+                        const health = await manager.checkHealth();
+                        res.writeHead(200);
+                        res.end(JSON.stringify({ success: true, health }));
+                    }
+                    catch (err) {
+                        res.writeHead(500);
+                        res.end(JSON.stringify({ success: false, error: err.message || 'Failed to check MCP health' }));
+                    }
+                    return;
+                }
+                // GET /api/mcp/activity - Retrieve MCP activity audit trail
+                if (pathname === '/api/mcp/activity' && req.method === 'GET') {
+                    try {
+                        const limit = parseInt(parsedUrl.searchParams.get('limit') || '50', 10);
+                        const activity = MCPTelemetry.loadActivity(limit);
+                        res.writeHead(200);
+                        res.end(JSON.stringify({ success: true, activity }));
+                    }
+                    catch (err) {
+                        res.writeHead(500);
+                        res.end(JSON.stringify({ success: false, error: err.message || 'Failed to load MCP activity' }));
+                    }
+                    return;
+                }
+                // Server-specific routes: /api/mcp/servers/:id...
+                const mcpServerMatch = pathname.match(/^\/api\/mcp\/servers\/([^/]+)(\/(.*))?$/);
+                if (mcpServerMatch) {
+                    const serverId = decodeURIComponent(mcpServerMatch[1] || '');
+                    const subPath = mcpServerMatch[3] || '';
+                    const manager = getMCPManager();
+                    // DELETE /api/mcp/servers/:id
+                    if (req.method === 'DELETE' && !subPath) {
+                        try {
+                            const success = await manager.removeServer(serverId);
+                            res.writeHead(200);
+                            res.end(JSON.stringify({ success, message: success ? 'Server removed' : 'Server not found' }));
+                        }
+                        catch (err) {
+                            res.writeHead(500);
+                            res.end(JSON.stringify({ success: false, error: err.message || 'Failed to remove server' }));
+                        }
+                        return;
+                    }
+                    // GET /api/mcp/servers/:id
+                    if (req.method === 'GET' && !subPath) {
+                        const server = manager.getServer(serverId);
+                        if (!server) {
+                            res.writeHead(404);
+                            res.end(JSON.stringify({ success: false, error: 'Server not found' }));
+                            return;
+                        }
+                        res.writeHead(200);
+                        res.end(JSON.stringify({ success: true, server }));
+                        return;
+                    }
+                    // POST /api/mcp/servers/:id/connect
+                    if (req.method === 'POST' && subPath === 'connect') {
+                        try {
+                            const server = await manager.connectServer(serverId);
+                            res.writeHead(200);
+                            res.end(JSON.stringify({ success: true, server }));
+                        }
+                        catch (err) {
+                            res.writeHead(500);
+                            res.end(JSON.stringify({ success: false, error: err.message || 'Failed to connect server' }));
+                        }
+                        return;
+                    }
+                    // POST /api/mcp/servers/:id/disconnect
+                    if (req.method === 'POST' && subPath === 'disconnect') {
+                        try {
+                            const server = await manager.disconnectServer(serverId);
+                            res.writeHead(200);
+                            res.end(JSON.stringify({ success: true, server }));
+                        }
+                        catch (err) {
+                            res.writeHead(500);
+                            res.end(JSON.stringify({ success: false, error: err.message || 'Failed to disconnect server' }));
+                        }
+                        return;
+                    }
+                    // GET /api/mcp/servers/:id/tools
+                    if (req.method === 'GET' && subPath === 'tools') {
+                        const server = manager.getServer(serverId);
+                        if (!server) {
+                            res.writeHead(404);
+                            res.end(JSON.stringify({ success: false, error: 'Server not found' }));
+                            return;
+                        }
+                        res.writeHead(200);
+                        res.end(JSON.stringify({ success: true, tools: server.tools }));
+                        return;
+                    }
+                    // POST /api/mcp/servers/:id/tools/:toolName/toggle
+                    const toggleMatch = subPath.match(/^tools\/([^/]+)\/toggle$/);
+                    if (req.method === 'POST' && toggleMatch) {
+                        const toolName = decodeURIComponent(toggleMatch[1] || '');
+                        let body = '';
+                        req.on('data', chunk => body += chunk);
+                        req.on('end', () => {
+                            try {
+                                const data = JSON.parse(body || '{}');
+                                const server = manager.toggleTool(serverId, toolName, data.enabled);
+                                if (!server) {
+                                    res.writeHead(404);
+                                    res.end(JSON.stringify({ success: false, error: 'Server or tool not found' }));
+                                    return;
+                                }
+                                res.writeHead(200);
+                                res.end(JSON.stringify({ success: true, server }));
+                            }
+                            catch (err) {
+                                res.writeHead(400);
+                                res.end(JSON.stringify({ success: false, error: err.message || 'Failed to toggle tool' }));
+                            }
+                        });
+                        return;
+                    }
+                    // POST /api/mcp/servers/:id/permissions
+                    if (req.method === 'POST' && subPath === 'permissions') {
+                        let body = '';
+                        req.on('data', chunk => body += chunk);
+                        req.on('end', () => {
+                            try {
+                                const data = JSON.parse(body || '{}');
+                                const ok = manager.setServerPermissions(serverId, data.permissions || {});
+                                if (!ok) {
+                                    res.writeHead(404);
+                                    res.end(JSON.stringify({ success: false, error: 'Server not found' }));
+                                    return;
+                                }
+                                const server = manager.getServer(serverId);
+                                res.writeHead(200);
+                                res.end(JSON.stringify({ success: true, server }));
+                            }
+                            catch (err) {
+                                res.writeHead(400);
+                                res.end(JSON.stringify({ success: false, error: err.message || 'Failed to update permissions' }));
+                            }
+                        });
+                        return;
+                    }
+                }
                 res.writeHead(404);
                 res.end(JSON.stringify({ error: 'API route not found' }));
                 return;