proofscan 0.9.2 → 0.10.1

package/dist/proxy/mcp-server.js

@@ -0,0 +1,391 @@
+/**
+ * MCP Proxy Server (Phase 5.0+)
+ *
+ * A stdio-based MCP server that aggregates tools from multiple backend
+ * connectors and routes requests accordingly.
+ *
+ * Supported methods:
+ * - initialize
+ * - notifications/initialized
+ * - tools/list
+ * - tools/call
+ */
+import { EventEmitter } from 'events';
+import { join } from 'path';
+import { logger, initializeRingBuffer, isVerbose } from './logger.js';
+import { ToolAggregator } from './tool-aggregator.js';
+import { RequestRouter } from './request-router.js';
+import { RuntimeStateManager, } from './runtime-state.js';
+import { MCP_ERROR, } from './types.js';
+const PROTOCOL_VERSION = '2024-11-05';
+const SERVER_NAME = 'proofscan-proxy';
+const SERVER_VERSION = '0.7.0';
+/** Maximum buffer size in bytes (1MB) - prevents memory exhaustion attacks */
+const MAX_BUFFER_SIZE = 1024 * 1024;
+/** Maximum log lines in ring buffer */
+const MAX_LOG_LINES = 1000;
+/**
+ * MCP Proxy Server
+ *
+ * Reads JSON-RPC from stdin, writes responses to stdout.
+ * All logging goes to stderr.
+ */
+export class McpProxyServer extends EventEmitter {
+    options;
+    aggregator;
+    router;
+    stateManager;
+    buffer = '';
+    initialized = false;
+    running = false;
+    /** Current client info (extracted from initialize) */
+    currentClient = null;
+    constructor(options) {
+        super();
+        this.options = options;
+        this.aggregator = new ToolAggregator(options);
+        this.router = new RequestRouter(options, this.aggregator);
+        this.stateManager = new RuntimeStateManager(options.configDir);
+    }
+    /**
+     * Start the proxy server
+     *
+     * Begins reading from stdin and processing JSON-RPC messages.
+     */
+    async start() {
+        if (this.running) {
+            throw new Error('Server is already running');
+        }
+        this.running = true;
+        logger.info('MCP proxy server starting...', 'server');
+        // Initialize ring buffer for log viewing
+        initializeRingBuffer({
+            maxLines: MAX_LOG_LINES,
+            logPath: join(this.options.configDir, 'proxy-logs.jsonl'),
+            onCountChange: (count) => {
+                this.stateManager.updateLogCount(count);
+            },
+        });
+        // Build connector summaries for status display
+        const connectorSummaries = await this.buildConnectorSummaries();
+        // Initialize runtime state
+        const logLevel = isVerbose() ? 'INFO' : 'WARN';
+        await this.stateManager.initialize(connectorSummaries, logLevel);
+        this.stateManager.startHeartbeat();
+        // Set up stdin
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('data', (chunk) => this.handleData(chunk));
+        process.stdin.on('end', () => this.handleEnd());
+        process.stdin.on('error', (err) => this.handleError(err));
+        // Resume stdin
+        process.stdin.resume();
+        logger.info(`Proxy started with ${connectorSummaries.length} connector(s)`, 'server');
+    }
+    /**
+     * Build connector summaries for status display
+     */
+    async buildConnectorSummaries() {
+        const summaries = [];
+        for (const connector of this.options.connectors) {
+            try {
+                // Try to get tool count - this doesn't actually connect yet
+                // The actual connection happens when tools/list is called
+                summaries.push({
+                    id: connector.id,
+                    toolCount: 0, // Will be updated on first tools/list
+                    healthy: true,
+                });
+            }
+            catch (error) {
+                summaries.push({
+                    id: connector.id,
+                    toolCount: 0,
+                    healthy: false,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return summaries;
+    }
+    /**
+     * Stop the proxy server
+     */
+    stop() {
+        if (!this.running) {
+            return;
+        }
+        this.running = false;
+        logger.info('MCP proxy server stopping...', 'server');
+        // Stop heartbeat
+        this.stateManager.stopHeartbeat();
+        // Mark proxy as stopped (async but we don't wait)
+        this.stateManager.markStopped().catch(() => {
+            // Ignore errors during shutdown
+        });
+        // Clean up stdin
+        process.stdin.pause();
+        process.stdin.removeAllListeners();
+        this.emit('stopped');
+    }
+    /**
+     * Handle incoming data from stdin
+     */
+    handleData(chunk) {
+        this.buffer += chunk;
+        // Prevent memory exhaustion from large messages without newlines
+        if (this.buffer.length > MAX_BUFFER_SIZE) {
+            logger.error(`Buffer overflow: ${this.buffer.length} bytes exceeds ${MAX_BUFFER_SIZE}`, 'server');
+            this.sendError(null, MCP_ERROR.INVALID_REQUEST, 'Message too large');
+            this.buffer = '';
+            return;
+        }
+        this.processBuffer();
+    }
+    /**
+     * Handle stdin end
+     */
+    handleEnd() {
+        logger.info('stdin closed', 'server');
+        // Mark current client as gone
+        if (this.currentClient) {
+            this.stateManager
+                .updateClient(this.currentClient.name, { state: 'gone' })
+                .catch(() => {
+                // Ignore errors during shutdown
+            });
+        }
+        this.stop();
+    }
+    /**
+     * Handle stdin error
+     */
+    handleError(err) {
+        logger.error(`stdin error: ${err.message}`);
+        this.stop();
+    }
+    /**
+     * Process buffered data and extract complete JSON-RPC messages
+     *
+     * Messages are newline-delimited JSON.
+     */
+    processBuffer() {
+        let newlineIndex;
+        while ((newlineIndex = this.buffer.indexOf('\n')) !== -1) {
+            const line = this.buffer.slice(0, newlineIndex).trim();
+            this.buffer = this.buffer.slice(newlineIndex + 1);
+            if (line) {
+                this.processMessage(line).catch((err) => {
+                    logger.error(`Message processing error: ${err instanceof Error ? err.message : err}`);
+                });
+            }
+        }
+    }
+    /**
+     * Process a single JSON-RPC message
+     */
+    async processMessage(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            logger.error('JSON parse error');
+            this.sendError(null, MCP_ERROR.PARSE_ERROR, 'Parse error');
+            return;
+        }
+        // Validate JSON-RPC structure
+        if (typeof parsed !== 'object' || parsed === null) {
+            logger.error('Invalid request: not an object');
+            this.sendError(null, MCP_ERROR.INVALID_REQUEST, 'Invalid Request');
+            return;
+        }
+        const msg = parsed;
+        if (msg.jsonrpc !== '2.0') {
+            logger.error('Invalid request: not JSON-RPC 2.0');
+            this.sendError(null, MCP_ERROR.INVALID_REQUEST, 'Invalid Request');
+            return;
+        }
+        // Check if it's a request (has id) or notification (no id)
+        const hasId = 'id' in msg && msg.id !== undefined;
+        const method = msg.method;
+        if (!method || typeof method !== 'string') {
+            logger.error('Invalid request: missing method');
+            if (hasId) {
+                this.sendError(msg.id, MCP_ERROR.INVALID_REQUEST, 'Invalid Request');
+            }
+            return;
+        }
+        if (hasId) {
+            // It's a request - needs response
+            await this.handleRequest(msg);
+        }
+        else {
+            // It's a notification - no response needed
+            this.handleNotification(msg);
+        }
+    }
+    /**
+     * Handle a JSON-RPC request (requires response)
+     */
+    async handleRequest(request) {
+        // Check if server is still running (prevents race condition on shutdown)
+        if (!this.running) {
+            return;
+        }
+        const { id, method, params } = request;
+        logger.info(`Request: ${method}`);
+        switch (method) {
+            case 'initialize':
+                await this.handleInitialize(id, params);
+                break;
+            case 'tools/list':
+                await this.handleToolsList(id);
+                break;
+            case 'tools/call':
+                await this.handleToolsCall(id, params);
+                break;
+            default:
+                logger.warn(`Unknown method: ${method}`);
+                this.sendError(id, MCP_ERROR.METHOD_NOT_FOUND, `Method not found: ${method}`);
+        }
+    }
+    /**
+     * Handle a JSON-RPC notification (no response)
+     */
+    handleNotification(notification) {
+        const { method } = notification;
+        logger.info(`Notification: ${method}`);
+        switch (method) {
+            case 'notifications/initialized':
+                // Client acknowledged initialization
+                logger.info('Client initialized');
+                break;
+            default:
+                // Unknown notifications are silently ignored per MCP spec
+                logger.info(`Ignoring notification: ${method}`);
+        }
+    }
+    /**
+     * Handle initialize request
+     */
+    async handleInitialize(id, params) {
+        if (this.initialized) {
+            logger.warn('Already initialized', 'init');
+        }
+        const clientVersion = params?.protocolVersion || 'unknown';
+        const clientName = params?.clientInfo?.name || 'unknown';
+        logger.info(`Client: ${clientName} (protocol=${clientVersion})`, 'init');
+        // Track client
+        this.currentClient = {
+            name: clientName,
+            protocolVersion: clientVersion,
+        };
+        // Update client state
+        await this.stateManager.updateClient(clientName, {
+            name: clientName,
+            protocolVersion: clientVersion,
+            state: 'active',
+        });
+        this.initialized = true;
+        const result = {
+            protocolVersion: PROTOCOL_VERSION,
+            capabilities: {
+                tools: {},
+            },
+            serverInfo: {
+                name: SERVER_NAME,
+                version: SERVER_VERSION,
+            },
+        };
+        this.sendResult(id, result);
+    }
+    /**
+     * Handle tools/list request
+     */
+    async handleToolsList(id) {
+        if (!this.initialized) {
+            logger.warn('tools/list before initialize');
+        }
+        try {
+            const tools = await this.aggregator.getAggregatedTools();
+            const result = {
+                tools: tools.map((t) => ({
+                    name: t.namespacedName,
+                    description: t.description,
+                    inputSchema: t.inputSchema,
+                })),
+            };
+            logger.info(`Returning ${tools.length} tool(s)`);
+            this.sendResult(id, result);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error(`tools/list failed: ${errorMessage}`);
+            this.sendError(id, MCP_ERROR.INTERNAL_ERROR, errorMessage);
+        }
+    }
+    /**
+     * Handle tools/call request
+     */
+    async handleToolsCall(id, params) {
+        if (!this.initialized) {
+            logger.warn('tools/call before initialize');
+        }
+        if (!params || typeof params.name !== 'string') {
+            logger.error('tools/call: missing or invalid name');
+            this.sendError(id, MCP_ERROR.INVALID_PARAMS, 'Missing required parameter: name');
+            return;
+        }
+        const { name, arguments: args = {} } = params;
+        logger.info(`tools/call name=${name}`);
+        // Record tool call for client tracking
+        if (this.currentClient) {
+            await this.stateManager.recordToolCall(this.currentClient.name);
+        }
+        const result = await this.router.routeToolCall(name, args);
+        if (!result.success) {
+            // Routing or backend error
+            this.sendError(id, MCP_ERROR.INTERNAL_ERROR, result.error || 'Unknown error');
+            return;
+        }
+        const callResult = {
+            content: result.content,
+            isError: result.isError,
+        };
+        this.sendResult(id, callResult);
+    }
+    /**
+     * Send a JSON-RPC response with result
+     */
+    sendResult(id, result) {
+        const response = {
+            jsonrpc: '2.0',
+            id,
+            result,
+        };
+        this.send(response);
+    }
+    /**
+     * Send a JSON-RPC error response
+     */
+    sendError(id, code, message, data) {
+        const response = {
+            jsonrpc: '2.0',
+            id,
+            error: {
+                code,
+                message,
+                ...(data !== undefined ? { data } : {}),
+            },
+        };
+        this.send(response);
+    }
+    /**
+     * Send a message to stdout
+     */
+    send(message) {
+        const json = JSON.stringify(message);
+        process.stdout.write(json + '\n');
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/proxy/mcp-server.js.map

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

package/dist/proxy/request-router.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Request Router (Phase 5.0)
+ *
+ * Routes tools/call requests to the appropriate backend connector
+ * based on the namespace prefix.
+ */
+import { type ProxyOptions, type RouteResult } from './types.js';
+import { ToolAggregator } from './tool-aggregator.js';
+/**
+ * Routes tool call requests to backend connectors
+ */
+export declare class RequestRouter {
+    private readonly aggregator;
+    private readonly configDir;
+    private readonly timeout;
+    constructor(options: ProxyOptions, aggregator: ToolAggregator);
+    /**
+     * Route a tools/call request to the appropriate backend
+     *
+     * @param namespacedName - Tool name with namespace prefix (e.g., "time__get_current_time")
+     * @param args - Tool arguments
+     * @returns Route result with content or error
+     */
+    routeToolCall(namespacedName: string, args: Record<string, unknown>): Promise<RouteResult>;
+}
+//# sourceMappingURL=request-router.d.ts.map

package/dist/proxy/request-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-router.d.ts","sourceRoot":"","sources":["../../src/proxy/request-router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc;IAM7D;;;;;;OAMG;IACG,aAAa,CACjB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC;CAmExB"}

package/dist/proxy/request-router.js

@@ -0,0 +1,90 @@
+/**
+ * Request Router (Phase 5.0)
+ *
+ * Routes tools/call requests to the appropriate backend connector
+ * based on the namespace prefix.
+ */
+import { callTool } from '../tools/adapter.js';
+import { logger } from './logger.js';
+import { DEFAULT_TIMEOUT } from './types.js';
+/**
+ * Routes tool call requests to backend connectors
+ */
+export class RequestRouter {
+    aggregator;
+    configDir;
+    timeout;
+    constructor(options, aggregator) {
+        this.aggregator = aggregator;
+        this.configDir = options.configDir;
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    }
+    /**
+     * Route a tools/call request to the appropriate backend
+     *
+     * @param namespacedName - Tool name with namespace prefix (e.g., "time__get_current_time")
+     * @param args - Tool arguments
+     * @returns Route result with content or error
+     */
+    async routeToolCall(namespacedName, args) {
+        // Parse namespace
+        const parsed = this.aggregator.parseNamespace(namespacedName);
+        if (!parsed) {
+            logger.error(`Invalid namespace format: ${namespacedName}`);
+            return {
+                success: false,
+                error: `Invalid tool name format. Expected: <connector>__<tool>, got: ${namespacedName}`,
+            };
+        }
+        const { connectorId, toolName } = parsed;
+        logger.info(`Routing → connector=${connectorId} tool=${toolName}`);
+        // Find connector
+        const connector = this.aggregator.findConnector(connectorId);
+        if (!connector) {
+            logger.error(`Connector not found: ${connectorId}`);
+            return {
+                success: false,
+                error: `Connector not found: ${connectorId}`,
+            };
+        }
+        if (!connector.enabled) {
+            logger.error(`Connector disabled: ${connectorId}`);
+            return {
+                success: false,
+                error: `Connector is disabled: ${connectorId}`,
+            };
+        }
+        // Call the backend tool
+        const ctx = {
+            connectorId,
+            configDir: this.configDir,
+        };
+        try {
+            const result = await callTool(ctx, connector, toolName, args, {
+                timeout: this.timeout,
+            });
+            if (result.success) {
+                logger.info(`Result: success sessionId=${result.sessionId.slice(0, 8)}`);
+            }
+            else {
+                logger.error(`Result: failed sessionId=${result.sessionId.slice(0, 8)} error=${result.error}`);
+            }
+            return {
+                success: result.success,
+                content: result.content,
+                isError: result.isError,
+                error: result.error,
+                sessionId: result.sessionId,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error(`Backend call failed: ${errorMessage}`);
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+}
+//# sourceMappingURL=request-router.js.map

package/dist/proxy/request-router.js.map

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

package/dist/proxy/runtime-state.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Runtime State Manager (Phase 5.0+)
+ *
+ * Manages persistent runtime state for IPC between proxy and CLI.
+ * State is written to a JSON file in configDir.
+ */
+/** Client connection state */
+export type ClientState = 'active' | 'idle' | 'gone';
+/** Individual client tracking info */
+export interface ClientInfo {
+    /** Client name from initialize params */
+    name: string;
+    /** Protocol version */
+    protocolVersion: string;
+    /** Current state */
+    state: ClientState;
+    /** When client was first seen (ISO timestamp) */
+    connectedAt: string;
+    /** When client was last active (ISO timestamp) */
+    lastSeen: string;
+    /** Number of sessions (reinitializations) */
+    sessions: number;
+    /** Total tool calls made */
+    toolCalls: number;
+}
+/** Connector summary for status display */
+export interface ConnectorSummary {
+    /** Connector ID */
+    id: string;
+    /** Number of tools published */
+    toolCount: number;
+    /** Whether tools were successfully loaded */
+    healthy: boolean;
+    /** Error message if unhealthy */
+    error?: string;
+}
+/** Proxy runtime state persisted to JSON file */
+export interface ProxyRuntimeState {
+    /** Schema version for forward compatibility */
+    version: 1;
+    /** Proxy state */
+    proxy: {
+        /** Current state */
+        state: 'RUNNING' | 'STOPPED';
+        /** Communication mode */
+        mode: 'stdio';
+        /** When proxy started (ISO timestamp) */
+        startedAt: string;
+        /** Process ID for staleness detection */
+        pid: number;
+        /** Last heartbeat (ISO timestamp) */
+        heartbeat: string;
+    };
+    /** Published connectors */
+    connectors: ConnectorSummary[];
+    /** Connected clients (for stdio mode, typically 1) */
+    clients: Record<string, ClientInfo>;
+    /** Logging configuration */
+    logging: {
+        /** Current log level */
+        level: 'INFO' | 'WARN' | 'ERROR';
+        /** Number of lines in ring buffer */
+        bufferedLines: number;
+        /** Max lines before rotation */
+        maxLines: number;
+    };
+}
+/** Default state when proxy is not running */
+export declare const DEFAULT_RUNTIME_STATE: ProxyRuntimeState;
+/**
+ * Manages proxy runtime state with file-based persistence.
+ *
+ * Used by the proxy process to track state and by CLI commands to read it.
+ */
+export declare class RuntimeStateManager {
+    private readonly statePath;
+    private state;
+    private heartbeatTimer;
+    constructor(configDir: string);
+    /**
+     * Initialize state when proxy starts
+     */
+    initialize(connectors: ConnectorSummary[], logLevel: 'INFO' | 'WARN' | 'ERROR'): Promise<void>;
+    /**
+     * Start heartbeat updates
+     */
+    startHeartbeat(): void;
+    /**
+     * Stop heartbeat on shutdown
+     */
+    stopHeartbeat(): void;
+    /**
+     * Update client state (called on each RPC)
+     */
+    updateClient(clientName: string, update: Partial<ClientInfo>): Promise<void>;
+    /**
+     * Record tool call
+     */
+    recordToolCall(clientName: string): Promise<void>;
+    /**
+     * Mark proxy as stopped
+     */
+    markStopped(): Promise<void>;
+    /**
+     * Update log buffer count
+     */
+    updateLogCount(count: number): Promise<void>;
+    /**
+     * Get current state (for internal use)
+     */
+    getState(): ProxyRuntimeState;
+    /**
+     * Persist state to file (atomic write using rename)
+     */
+    private persist;
+    /**
+     * Read current state (for CLI)
+     *
+     * Static method that can be called without a proxy running.
+     */
+    static read(configDir: string): Promise<ProxyRuntimeState | null>;
+    /**
+     * Check if proxy is likely still running (heartbeat within threshold + PID check)
+     */
+    static isProxyAlive(state: ProxyRuntimeState): boolean;
+    /**
+     * Determine effective client state based on lastSeen timestamp
+     */
+    static determineClientState(client: ClientInfo, idleThresholdMs?: number): ClientState;
+}
+//# sourceMappingURL=runtime-state.d.ts.map

package/dist/proxy/runtime-state.d.ts.map

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