network-ai 4.15.3 → 5.1.0

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

@@ -0,0 +1,320 @@
+"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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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 Promise.resolve().then(() => __importStar(require('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.0.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/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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"}

package/dist/lib/metrics.d.ts

@@ -0,0 +1,119 @@
+/**
+ * MetricsRegistry — Zero-dependency Prometheus-compatible metrics.
+ *
+ * Provides Counter, Gauge, and Histogram metric types with label support.
+ * Exports metrics in Prometheus text exposition format for scraping.
+ *
+ * No runtime dependencies — drop-in for any HTTP server or the MCP endpoint.
+ *
+ * @module Metrics
+ */
+/** Supported metric types */
+export type MetricType = 'counter' | 'gauge' | 'histogram';
+/** A set of label key-value pairs */
+export type Labels = Record<string, string>;
+/** Configuration for a histogram */
+export interface HistogramBuckets {
+    /** Upper bounds for each bucket (must be sorted ascending) */
+    boundaries: number[];
+}
+/** Monotonically increasing counter */
+export declare class Counter {
+    readonly name: string;
+    readonly help: string;
+    private series;
+    private labelMap;
+    constructor(name: string, help: string);
+    inc(labels?: Labels, amount?: number): void;
+    get(labels?: Labels): number;
+    /** Prometheus text lines */
+    expose(): string;
+}
+/** Gauge — can go up or down */
+export declare class Gauge {
+    readonly name: string;
+    readonly help: string;
+    private series;
+    private labelMap;
+    constructor(name: string, help: string);
+    set(labels: Labels, value: number): void;
+    set(value: number): void;
+    inc(labels?: Labels, amount?: number): void;
+    dec(labels?: Labels, amount?: number): void;
+    get(labels?: Labels): number;
+    expose(): string;
+}
+/** Histogram with configurable buckets */
+export declare class Histogram {
+    readonly name: string;
+    readonly help: string;
+    readonly boundaries: number[];
+    private series;
+    private labelMap;
+    constructor(name: string, help: string, buckets?: HistogramBuckets);
+    observe(labels: Labels, value: number): void;
+    observe(value: number): void;
+    expose(): string;
+}
+/**
+ * Central metrics registry. Collects all metrics and exposes them in
+ * Prometheus text format.
+ *
+ * @example
+ * ```ts
+ * const registry = new MetricsRegistry();
+ * const delegations = registry.counter('nai_delegations_total', 'Total delegations');
+ * const activeAgents = registry.gauge('nai_active_agents', 'Currently active agents');
+ * const latency = registry.histogram('nai_delegation_duration_ms', 'Delegation latency');
+ *
+ * delegations.inc({ agent: 'planner' });
+ * activeAgents.set(5);
+ * latency.observe({ agent: 'planner' }, 142);
+ *
+ * const text = registry.expose(); // Prometheus text exposition format
+ * ```
+ */
+export declare class MetricsRegistry {
+    private counters;
+    private gauges;
+    private histograms;
+    /** Create or retrieve a counter */
+    counter(name: string, help: string): Counter;
+    /** Create or retrieve a gauge */
+    gauge(name: string, help: string): Gauge;
+    /** Create or retrieve a histogram */
+    histogram(name: string, help: string, buckets?: HistogramBuckets): Histogram;
+    /**
+     * Export all registered metrics in Prometheus text exposition format.
+     */
+    expose(): string;
+    /** Get a specific counter by name */
+    getCounter(name: string): Counter | undefined;
+    /** Get a specific gauge by name */
+    getGauge(name: string): Gauge | undefined;
+    /** Get a specific histogram by name */
+    getHistogram(name: string): Histogram | undefined;
+    /** Total number of registered metrics */
+    get size(): number;
+}
+/**
+ * Create a pre-configured MetricsRegistry with standard orchestrator metrics.
+ *
+ * Returns the registry and named handles to the individual metrics.
+ */
+export declare function createOrchestratorMetrics(): {
+    registry: MetricsRegistry;
+    delegationsTotal: Counter;
+    delegationErrors: Counter;
+    permissionChecks: Counter;
+    permissionDenials: Counter;
+    injectionBlocks: Counter;
+    qualityRejections: Counter;
+    blackboardWrites: Counter;
+    activeAgents: Gauge;
+    blackboardSize: Gauge;
+    budgetUsedPercent: Gauge;
+    delegationDurationMs: Histogram;
+    adapterDurationMs: Histogram;
+};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/lib/metrics.d.ts.map

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