network-ai 5.10.1 → 5.11.0

package/dist/esm/lib/mcp-bridge.js

@@ -0,0 +1,357 @@
+"use strict";
+/**
+ * MCP Blackboard Bridge — Phase 5 Part 7: MCP Networking
+ *
+ * Exposes any `IBlackboard` (or `BlackboardMCPTools` instance) as a
+ * JSON-RPC 2.0 Model Context Protocol endpoint, enabling cross-machine
+ * agent communication with no external runtime dependencies.
+ *
+ * Architecture:
+ *
+ *   ┌─────────────────────────┐        ┌─────────────────────────┐
+ *   │   McpBridgeClient       │        │   McpBlackboardBridge   │
+ *   │  (remote agent side)    │        │   (server side)         │
+ *   │                         │        │                         │
+ *   │  listTools()            │──────► │  handleRPC()            │
+ *   │  callTool(name, args)   │        │   ├─ tools/list         │
+ *   │                         │◄────── │   └─ tools/call         │
+ *   └─────────────────────────┘        │         │               │
+ *           │                          │         ▼               │
+ *   McpTransport interface             │   BlackboardMCPTools    │
+ *   (in-process or future SSE/WS)      │   (read/write/list...)  │
+ *                                      └─────────────────────────┘
+ *
+ * `McpInProcessTransport` wires a client directly to a bridge instance
+ * (zero I/O, ideal for testing and single-machine multi-board setups).
+ * Any transport that satisfies `McpTransport` can be substituted for
+ * network delivery (SSE, WebSocket, stdio) without changing callers.
+ *
+ * `McpBridgeRouter` manages multiple named bridges (one per blackboard)
+ * and routes calls to the correct bridge by board name.
+ *
+ * @example
+ * ```typescript
+ * import { McpBlackboardBridge, McpBridgeClient, McpInProcessTransport } from 'network-ai';
+ *
+ * // Server side
+ * const bridge = new McpBlackboardBridge(myBlackboard);
+ *
+ * // Client side (in-process)
+ * const client = new McpBridgeClient(new McpInProcessTransport(bridge));
+ *
+ * const tools  = await client.listTools();
+ * const result = await client.callTool('blackboard_read', { key: 'status', agent_id: 'agent-1' });
+ * ```
+ *
+ * @example Multi-board router
+ * ```typescript
+ * const router = new McpBridgeRouter();
+ * router.register('prod',    new McpBlackboardBridge(prodBoard));
+ * router.register('staging', new McpBlackboardBridge(stagingBoard));
+ *
+ * const prodClient = router.getClient('prod');
+ * await prodClient.callTool('blackboard_write', { key: 'deploy', value: '"ok"', agent_id: 'ci' });
+ * ```
+ *
+ * @module McpBridge
+ * @version 1.0.0
+ * @license MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpBridgeRouter = exports.McpBridgeClient = exports.McpInProcessTransport = exports.McpBlackboardBridge = void 0;
+const mcp_blackboard_tools_1 = require("./mcp-blackboard-tools");
+/**
+ * MCP server bridge that exposes a blackboard via JSON-RPC 2.0.
+ *
+ * Wraps a `BlackboardMCPTools` instance and handles:
+ *   - `tools/list`  → returns all five tool definitions
+ *   - `tools/call`  → dispatches to the appropriate tool handler
+ *
+ * The bridge is transport-agnostic: pass a `McpJsonRpcRequest` to
+ * `handleRPC()` and receive a `McpJsonRpcResponse`.
+ */
+class McpBlackboardBridge {
+    _tools;
+    name;
+    /**
+     * @param blackboard  Any object satisfying `IBlackboard`, or a
+     *                    pre-built `BlackboardMCPTools` instance.
+     * @param options     Optional configuration.
+     */
+    constructor(blackboard, options = {}) {
+        this._tools =
+            blackboard instanceof mcp_blackboard_tools_1.BlackboardMCPTools
+                ? blackboard
+                : new mcp_blackboard_tools_1.BlackboardMCPTools(blackboard);
+        this.name = options.name ?? 'blackboard';
+    }
+    // --------------------------------------------------------------------------
+    // JSON-RPC 2.0 ENTRY POINT
+    // --------------------------------------------------------------------------
+    /**
+     * Handle a single JSON-RPC 2.0 request and return the matching response.
+     * Never rejects — errors are encoded as `{ error: { code, message } }`.
+     */
+    async handleRPC(request) {
+        if (!request || request.jsonrpc !== '2.0') {
+            return this._error(null, -32600 /* McpErrorCode.InvalidRequest */, 'Invalid JSON-RPC 2.0 request');
+        }
+        const { id, method } = request;
+        try {
+            switch (method) {
+                case 'tools/list':
+                    return this._ok(id, await this._handleListTools());
+                case 'tools/call':
+                    return this._ok(id, await this._handleCallTool(request.params));
+                default:
+                    return this._error(id, -32601 /* McpErrorCode.MethodNotFound */, `Method not found: "${method}"`);
+            }
+        }
+        catch (err) {
+            return this._error(id, -32603 /* McpErrorCode.InternalError */, err instanceof Error ? err.message : String(err));
+        }
+    }
+    // --------------------------------------------------------------------------
+    // CONVENIENCE — direct access without JSON-RPC wrapping
+    // --------------------------------------------------------------------------
+    /** Returns all tool definitions exposed by this bridge. */
+    listTools() {
+        return this._tools.getDefinitions();
+    }
+    /**
+     * Call a specific tool directly (bypasses JSON-RPC framing).
+     * Useful when the bridge and caller share the same process.
+     */
+    async callTool(name, args) {
+        return this._tools.call(name, args);
+    }
+    // --------------------------------------------------------------------------
+    // PRIVATE — method handlers
+    // --------------------------------------------------------------------------
+    async _handleListTools() {
+        return { tools: this._tools.getDefinitions() };
+    }
+    async _handleCallTool(params) {
+        if (!params || typeof params !== 'object') {
+            throw Object.assign(new Error('tools/call requires params object with "name" and "arguments"'), { code: -32602 /* McpErrorCode.InvalidParams */ });
+        }
+        const p = params;
+        const toolName = p['name'];
+        const toolArgs = p['arguments'] ?? {};
+        if (typeof toolName !== 'string' || !toolName) {
+            throw Object.assign(new Error('tools/call: "name" must be a non-empty string'), { code: -32602 /* McpErrorCode.InvalidParams */ });
+        }
+        if (typeof toolArgs !== 'object' || toolArgs === null || Array.isArray(toolArgs)) {
+            throw Object.assign(new Error('tools/call: "arguments" must be an object'), { code: -32602 /* McpErrorCode.InvalidParams */ });
+        }
+        const result = await this._tools.call(toolName, toolArgs);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+            isError: !result.ok,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // PRIVATE — response helpers
+    // --------------------------------------------------------------------------
+    _ok(id, result) {
+        return { jsonrpc: '2.0', id, result };
+    }
+    _error(id, code, message, data) {
+        return {
+            jsonrpc: '2.0',
+            id,
+            error: { code, message, ...(data !== undefined ? { data } : {}) },
+        };
+    }
+}
+exports.McpBlackboardBridge = McpBlackboardBridge;
+// ============================================================================
+// IN-PROCESS TRANSPORT
+// ============================================================================
+/**
+ * Zero-I/O transport that routes calls directly to a `McpBlackboardBridge`.
+ *
+ * Use this when the client and server share the same process — no
+ * serialization, no network, instant responses. Ideal for:
+ *   - Unit and integration tests
+ *   - Single-machine multi-board setups
+ *   - Development and debugging
+ *
+ * Replace with a network transport (SSE, WebSocket, stdio pipe) when you
+ * need cross-machine communication.
+ */
+class McpInProcessTransport {
+    bridge;
+    _idCounter = 0;
+    constructor(bridge) {
+        this.bridge = bridge;
+    }
+    async send(request) {
+        return this.bridge.handleRPC(request);
+    }
+    /**
+     * Generate a unique numeric request ID suitable for `McpJsonRpcRequest.id`.
+     * Useful when callers don't need to track IDs manually.
+     */
+    nextId() {
+        return ++this._idCounter;
+    }
+}
+exports.McpInProcessTransport = McpInProcessTransport;
+// ============================================================================
+// MCP BRIDGE CLIENT
+// ============================================================================
+/**
+ * Client that communicates with a `McpBlackboardBridge` via any `McpTransport`.
+ *
+ * Provides high-level methods (`listTools`, `callTool`) so callers never
+ * have to construct raw JSON-RPC requests.
+ */
+class McpBridgeClient {
+    transport;
+    _idCounter = 0;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    // --------------------------------------------------------------------------
+    // HIGH-LEVEL API
+    // --------------------------------------------------------------------------
+    /**
+     * List all tools exposed by the connected bridge.
+     *
+     * @returns Array of `MCPToolDefinition` objects.
+     * @throws  If the transport returns an RPC error.
+     */
+    async listTools() {
+        const response = await this._send('tools/list', undefined);
+        const result = response.result;
+        return result.tools;
+    }
+    /**
+     * Call a named tool on the connected bridge.
+     *
+     * @param name  Tool name (e.g. `'blackboard_read'`).
+     * @param args  Tool arguments matching the tool's `inputSchema`.
+     * @returns     Parsed `BlackboardToolResult` from the content block.
+     * @throws      If the transport returns a JSON-RPC protocol error.
+     */
+    async callTool(name, args) {
+        const response = await this._send('tools/call', { name, arguments: args });
+        const callResult = response.result;
+        const text = callResult.content[0]?.text ?? '{}';
+        return JSON.parse(text);
+    }
+    /**
+     * Send a raw JSON-RPC request and return the response.
+     * The `id` is auto-assigned if not provided.
+     *
+     * @throws If the server returns a JSON-RPC error response.
+     */
+    async sendRaw(method, params) {
+        return this._send(method, params);
+    }
+    // --------------------------------------------------------------------------
+    // PRIVATE
+    // --------------------------------------------------------------------------
+    async _send(method, params) {
+        const id = ++this._idCounter;
+        const request = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            ...(params !== undefined ? { params } : {}),
+        };
+        const response = await this.transport.send(request);
+        if (response.error) {
+            const { code, message, data } = response.error;
+            const err = new Error(`MCP error ${code}: ${message}`);
+            Object.assign(err, { code, data });
+            throw err;
+        }
+        return response;
+    }
+}
+exports.McpBridgeClient = McpBridgeClient;
+// ============================================================================
+// MCP BRIDGE ROUTER
+// ============================================================================
+/**
+ * Routes MCP calls across multiple named `McpBlackboardBridge` instances
+ * (one per blackboard).
+ *
+ * Agents address a specific blackboard by name:
+ * ```typescript
+ * const client = router.getClient('prod');
+ * await client.callTool('blackboard_write', { ... });
+ * ```
+ *
+ * The router also supports direct RPC routing without creating a client:
+ * ```typescript
+ * await router.route('prod', { jsonrpc: '2.0', id: 1, method: 'tools/list' });
+ * ```
+ */
+class McpBridgeRouter {
+    _bridges = new Map();
+    /**
+     * Register a bridge under `name`.
+     * @throws If `name` is already registered.
+     */
+    register(name, bridge) {
+        if (typeof name !== 'string' || !name) {
+            throw new TypeError('McpBridgeRouter.register: name must be a non-empty string');
+        }
+        if (this._bridges.has(name)) {
+            throw new Error(`McpBridgeRouter: bridge "${name}" is already registered`);
+        }
+        this._bridges.set(name, bridge);
+    }
+    /**
+     * Unregister a bridge by name. No-op if not found.
+     * @returns `true` if a bridge was removed, `false` otherwise.
+     */
+    unregister(name) {
+        return this._bridges.delete(name);
+    }
+    /**
+     * Returns `true` if a bridge with `name` is registered.
+     */
+    has(name) {
+        return this._bridges.has(name);
+    }
+    /**
+     * List all registered bridge names.
+     */
+    listBridges() {
+        return Array.from(this._bridges.keys());
+    }
+    /**
+     * Get the `McpBlackboardBridge` registered under `name`.
+     * @throws If `name` is not registered.
+     */
+    getBridge(name) {
+        const bridge = this._bridges.get(name);
+        if (!bridge) {
+            throw new Error(`McpBridgeRouter: no bridge registered for "${name}"`);
+        }
+        return bridge;
+    }
+    /**
+     * Route a raw JSON-RPC request to the bridge named `boardName`.
+     * @throws If `boardName` is not registered.
+     */
+    async route(boardName, request) {
+        return this.getBridge(boardName).handleRPC(request);
+    }
+    /**
+     * Get a `McpBridgeClient` backed by an in-process transport to the bridge
+     * registered under `boardName`.
+     *
+     * @throws If `boardName` is not registered.
+     */
+    getClient(boardName) {
+        const bridge = this.getBridge(boardName);
+        return new McpBridgeClient(new McpInProcessTransport(bridge));
+    }
+}
+exports.McpBridgeRouter = McpBridgeRouter;
+//# sourceMappingURL=mcp-bridge.js.map

package/dist/esm/lib/mcp-bridge.js.map

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

package/dist/esm/lib/mcp-tool-consumer.js

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * MCPToolConsumer — Connect to external MCP servers and consume their tools.
+ *
+ * Implements `MCPServerConnection` for the MCPAdapter, providing:
+ * - Stdio-based client transport (spawn child process)
+ * - SSE-based client transport (HTTP long-poll)
+ * - Auto-discovery of remote tools with caching
+ * - Permission-gated remote tool execution
+ *
+ * BYOC: No external MCP client library required.
+ *
+ * @module MCPToolConsumer
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPToolConsumer = exports.HttpClientTransport = exports.StdioClientTransport = void 0;
+const events_1 = require("events");
+// ============================================================================
+// STDIO CLIENT TRANSPORT
+// ============================================================================
+/**
+ * Stdio-based MCP client transport.
+ * Spawns a child process and communicates via stdin/stdout JSON-RPC.
+ *
+ * @example
+ * ```ts
+ * const transport = new StdioClientTransport('npx', ['some-mcp-server']);
+ * const consumer = new MCPToolConsumer({ transport });
+ * ```
+ */
+class StdioClientTransport {
+    command;
+    args;
+    process = null;
+    pendingRequests = new Map();
+    nextId = 1;
+    buffer = '';
+    spawnFn = null;
+    constructor(command, args = []) {
+        this.command = command;
+        this.args = args;
+    }
+    async send(request) {
+        if (!this.process)
+            await this.start();
+        const id = this.nextId++;
+        const req = { ...request, id };
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(id, { resolve, reject });
+            this.process.stdin.write(JSON.stringify(req) + '\n');
+        });
+    }
+    async close() {
+        if (this.process) {
+            this.process.kill();
+            this.process = null;
+        }
+        for (const { reject } of this.pendingRequests.values()) {
+            reject(new Error('Transport closed'));
+        }
+        this.pendingRequests.clear();
+    }
+    async start() {
+        if (!this.spawnFn) {
+            // Dynamic import to avoid bundling child_process in browser contexts
+            const cp = await import('child_process');
+            this.spawnFn = cp.spawn;
+        }
+        this.process = this.spawnFn(this.command, this.args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.process.stdout.on('data', (chunk) => {
+            this.buffer += chunk.toString();
+            this.processBuffer();
+        });
+        this.process.on('exit', () => {
+            for (const { reject } of this.pendingRequests.values()) {
+                reject(new Error('MCP server process exited'));
+            }
+            this.pendingRequests.clear();
+        });
+    }
+    processBuffer() {
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const response = JSON.parse(trimmed);
+                if (response.id !== undefined && this.pendingRequests.has(response.id)) {
+                    const { resolve } = this.pendingRequests.get(response.id);
+                    this.pendingRequests.delete(response.id);
+                    resolve(response);
+                }
+            }
+            catch {
+                // Not valid JSON — skip
+            }
+        }
+    }
+}
+exports.StdioClientTransport = StdioClientTransport;
+// ============================================================================
+// HTTP CLIENT TRANSPORT
+// ============================================================================
+/**
+ * HTTP-based MCP client transport.
+ * Sends JSON-RPC over HTTP POST requests to an MCP server endpoint.
+ */
+class HttpClientTransport {
+    url;
+    headers;
+    nextId = 1;
+    constructor(url, headers = {}) {
+        this.url = url;
+        this.headers = headers;
+    }
+    async send(request) {
+        const id = this.nextId++;
+        const req = { ...request, id };
+        const response = await fetch(this.url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...this.headers },
+            body: JSON.stringify(req),
+        });
+        if (!response.ok) {
+            throw new Error(`MCP HTTP error: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async close() {
+        // HTTP is stateless — nothing to close
+    }
+}
+exports.HttpClientTransport = HttpClientTransport;
+// ============================================================================
+// MCP TOOL CONSUMER
+// ============================================================================
+/**
+ * Consume tools from an external MCP server.
+ * Implements MCPServerConnection for use with MCPAdapter.
+ *
+ * @example
+ * ```ts
+ * const transport = new HttpClientTransport('http://localhost:3001/mcp');
+ * const consumer = new MCPToolConsumer({ transport });
+ *
+ * // Use with MCPAdapter:
+ * const adapter = new MCPAdapter();
+ * adapter.initialize({ options: { serverConnection: consumer } });
+ * await adapter.discoverServerTools();
+ * ```
+ */
+class MCPToolConsumer extends events_1.EventEmitter {
+    transport;
+    toolCache = null;
+    toolCacheTime = 0;
+    toolCacheTtlMs;
+    callTimeoutMs;
+    prefix;
+    toolInfo = new Map();
+    initialized = false;
+    constructor(options) {
+        super();
+        this.transport = options.transport;
+        this.toolCacheTtlMs = options.toolCacheTtlMs ?? 60_000;
+        this.callTimeoutMs = options.callTimeoutMs ?? 30_000;
+        this.prefix = options.prefix ?? 'mcp';
+    }
+    /**
+     * Initialize the MCP connection (send initialize handshake).
+     */
+    async initialize(clientInfo) {
+        if (this.initialized)
+            return;
+        const response = await this.transport.send({
+            jsonrpc: '2.0',
+            id: 0,
+            method: 'initialize',
+            params: {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: clientInfo ?? { name: 'network-ai', version: '5.4.0' },
+            },
+        });
+        if (response.error) {
+            throw new Error(`MCP initialize failed: ${response.error.message}`);
+        }
+        this.initialized = true;
+    }
+    /**
+     * List available tools from the remote MCP server.
+     * Results are cached for `toolCacheTtlMs`.
+     */
+    async listTools() {
+        if (!this.initialized)
+            await this.initialize();
+        const now = Date.now();
+        if (this.toolCache && (now - this.toolCacheTime) < this.toolCacheTtlMs) {
+            return this.toolCache;
+        }
+        const response = await this.transport.send({
+            jsonrpc: '2.0',
+            id: 0,
+            method: 'tools/list',
+        });
+        if (response.error) {
+            throw new Error(`tools/list failed: ${response.error.message}`);
+        }
+        const result = response.result;
+        const tools = result?.tools ?? [];
+        this.toolCache = tools;
+        this.toolCacheTime = now;
+        // Update tool info registry
+        for (const tool of tools) {
+            if (!this.toolInfo.has(tool.name)) {
+                this.toolInfo.set(tool.name, {
+                    tool,
+                    serverPrefix: this.prefix,
+                    lastDiscovered: now,
+                    callCount: 0,
+                    errorCount: 0,
+                });
+            }
+        }
+        this.emit('tools-discovered', tools);
+        return tools;
+    }
+    /**
+     * Call a tool on the remote MCP server.
+     */
+    async callTool(name, args) {
+        if (!this.initialized)
+            await this.initialize();
+        const info = this.toolInfo.get(name);
+        if (info)
+            info.callCount++;
+        const resultPromise = this.transport.send({
+            jsonrpc: '2.0',
+            id: 0,
+            method: 'tools/call',
+            params: { name, arguments: args },
+        });
+        const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error(`Tool call timeout: ${name}`)), this.callTimeoutMs));
+        try {
+            const response = await Promise.race([resultPromise, timeoutPromise]);
+            if (response.error) {
+                if (info)
+                    info.errorCount++;
+                return {
+                    content: [{ type: 'text', text: response.error.message }],
+                    isError: true,
+                };
+            }
+            const result = response.result;
+            return result ?? { content: [{ type: 'text', text: 'No result' }] };
+        }
+        catch (err) {
+            if (info)
+                info.errorCount++;
+            throw err;
+        }
+    }
+    /** Close the transport connection */
+    async close() {
+        await this.transport.close();
+        this.toolCache = null;
+        this.initialized = false;
+    }
+    /** Get info about discovered tools */
+    getToolInfo() {
+        return [...this.toolInfo.values()];
+    }
+    /** Invalidate the tool cache to force re-discovery */
+    invalidateCache() {
+        this.toolCache = null;
+        this.toolCacheTime = 0;
+    }
+    /** Get the prefix used for agent naming */
+    getPrefix() {
+        return this.prefix;
+    }
+}
+exports.MCPToolConsumer = MCPToolConsumer;
+//# sourceMappingURL=mcp-tool-consumer.js.map

package/dist/esm/lib/mcp-tool-consumer.js.map

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