@defai.digital/ax-cli 4.4.7 → 4.4.10

package/dist/mcp/content-length-transport.js

@@ -1,413 +0,0 @@
-/**
- * Content-Length framing transport for MCP SDK
- *
- * The MCP SDK uses NDJSON (newline-delimited JSON) format by default,
- * but some MCP servers (like AutomatosX) use Content-Length framing
- * (similar to LSP - Language Server Protocol).
- *
- * This transport wrapper converts between the two formats:
- * - Outgoing: Wraps JSON messages with Content-Length headers
- * - Incoming: Parses Content-Length framed messages
- */
-import { spawn } from "child_process";
-import { JSONRPCMessageSchema } from "@modelcontextprotocol/sdk/types.js";
-import { EventEmitter } from "events";
-import { MCP_TIMEOUTS, MCP_LIMITS } from "./constants.js";
-/**
- * Stdio transport that uses Content-Length framing instead of NDJSON.
- *
- * Message format:
- * ```
- * Content-Length: <byte-length>\r\n
- * \r\n
- * <JSON-RPC message>
- * ```
- */
-export class ContentLengthStdioTransport extends EventEmitter {
-    process;
-    buffer = Buffer.alloc(0);
-    config;
-    _started = false;
-    // Transport callbacks (required by Transport interface)
-    onmessage;
-    onerror;
-    onclose;
-    constructor(config) {
-        super();
-        this.config = config;
-    }
-    /**
-     * Start the transport (spawn the subprocess)
-     * Includes startup timeout to prevent hanging on slow npx/npm commands
-     */
-    async start() {
-        if (this._started) {
-            throw new Error("Transport already started");
-        }
-        this._started = true;
-        const startupTimeout = this.config.startupTimeout ?? MCP_TIMEOUTS.STARTUP;
-        return new Promise((resolve, reject) => {
-            let resolved = false;
-            let timeoutId;
-            const cleanup = () => {
-                if (timeoutId) {
-                    clearTimeout(timeoutId);
-                    timeoutId = undefined;
-                }
-            };
-            const handleResolve = () => {
-                if (resolved)
-                    return;
-                resolved = true;
-                cleanup();
-                resolve();
-            };
-            const handleReject = (error) => {
-                if (resolved)
-                    return;
-                resolved = true;
-                cleanup();
-                // Kill the process if it was spawned but timed out
-                if (this.process && !this.process.killed) {
-                    try {
-                        this.process.kill();
-                    }
-                    catch {
-                        // Ignore kill errors
-                    }
-                }
-                reject(error);
-            };
-            // Set up startup timeout
-            timeoutId = setTimeout(() => {
-                handleReject(new Error(`Process startup timeout after ${startupTimeout}ms: ${this.config.command}`));
-            }, startupTimeout);
-            try {
-                // Use "pipe" for stderr in quiet mode to suppress INFO/DEBUG logs
-                // Use "inherit" otherwise to show all output (default behavior)
-                const stderrOption = this.config.quiet ? "pipe" : "inherit";
-                this.process = spawn(this.config.command, this.config.args || [], {
-                    stdio: ["pipe", "pipe", stderrOption],
-                    env: {
-                        ...process.env,
-                        ...this.config.env,
-                    },
-                    cwd: this.config.cwd,
-                });
-                this.process.on("error", (error) => {
-                    this.onerror?.(error);
-                    handleReject(error);
-                });
-                this.process.on("spawn", () => {
-                    handleResolve();
-                });
-                this.process.on("close", (code) => {
-                    // If process exits before spawn event, reject
-                    if (!resolved) {
-                        handleReject(new Error(`Process exited with code ${code} before starting`));
-                    }
-                    this.onclose?.();
-                    this.emit("close", code);
-                });
-                this.process.stdout?.on("data", (chunk) => {
-                    this.handleData(chunk);
-                });
-                this.process.stdout?.on("error", (error) => {
-                    this.onerror?.(error);
-                });
-                this.process.stdin?.on("error", (error) => {
-                    this.onerror?.(error);
-                });
-            }
-            catch (error) {
-                handleReject(error instanceof Error ? error : new Error(String(error)));
-            }
-        });
-    }
-    /**
-     * Handle incoming data with Content-Length framing
-     */
-    handleData(chunk) {
-        const maxBufferSize = this.config.maxBufferSize ?? MCP_LIMITS.MAX_BUFFER_SIZE;
-        // BUG FIX: Check buffer size limit before appending to prevent memory exhaustion
-        if (this.buffer.length + chunk.length > maxBufferSize) {
-            this.onerror?.(new Error(`Buffer size limit exceeded (${maxBufferSize} bytes). ` +
-                `This may indicate a malformed message or malicious server.`));
-            // Reset buffer to recover
-            this.buffer = Buffer.alloc(0);
-            return;
-        }
-        // Append to buffer
-        this.buffer = Buffer.concat([this.buffer, chunk]);
-        // Process all complete messages in buffer
-        while (true) {
-            const message = this.readMessage();
-            if (!message)
-                break;
-            try {
-                // Validate and emit message
-                const parsed = JSONRPCMessageSchema.parse(message);
-                this.onmessage?.(parsed);
-            }
-            catch (error) {
-                this.onerror?.(error instanceof Error ? error : new Error(String(error)));
-            }
-        }
-    }
-    /**
-     * Read a single Content-Length framed message from buffer
-     *
-     * BUG FIX: Now supports both Content-Length framing (LSP-style) and NDJSON fallback.
-     * This handles community MCP servers that don't implement proper JSON-RPC 2.0 stdio spec.
-     *
-     * Supported formats:
-     * 1. Content-Length framing: `Content-Length: N\r\n\r\n{...json...}`
-     * 2. NDJSON fallback: `{...json...}\n` (newline-delimited JSON)
-     */
-    readMessage() {
-        // Skip any leading whitespace/newlines (common in NDJSON streams)
-        while (this.buffer.length > 0) {
-            const firstByte = this.buffer[0];
-            // Skip whitespace: space (32), tab (9), CR (13), LF (10)
-            if (firstByte === 32 || firstByte === 9 || firstByte === 13 || firstByte === 10) {
-                this.buffer = this.buffer.subarray(1);
-            }
-            else {
-                break;
-            }
-        }
-        if (this.buffer.length === 0) {
-            return null;
-        }
-        // Check if this looks like Content-Length framing or raw JSON
-        const bufferStr = this.buffer.toString("utf8", 0, Math.min(50, this.buffer.length));
-        const startsWithContentLength = /^Content-Length:\s*\d+/i.test(bufferStr);
-        const startsWithJson = bufferStr.trimStart().startsWith("{");
-        if (startsWithContentLength) {
-            // Content-Length framing (LSP-style)
-            return this.readContentLengthMessage();
-        }
-        else if (startsWithJson) {
-            // NDJSON fallback - try to parse as newline-delimited JSON
-            return this.readNdjsonMessage();
-        }
-        else {
-            // Unknown format - skip until we find something parseable
-            // Look for either Content-Length or { character
-            const nextContentLength = this.buffer.indexOf("Content-Length:");
-            const nextJsonStart = this.buffer.indexOf("{");
-            let skipTo = -1;
-            if (nextContentLength >= 0 && nextJsonStart >= 0) {
-                skipTo = Math.min(nextContentLength, nextJsonStart);
-            }
-            else if (nextContentLength >= 0) {
-                skipTo = nextContentLength;
-            }
-            else if (nextJsonStart >= 0) {
-                skipTo = nextJsonStart;
-            }
-            if (skipTo > 0) {
-                // Skip to the next potentially valid message
-                this.buffer = this.buffer.subarray(skipTo);
-                return null; // Caller will retry
-            }
-            else {
-                // No valid message found - clear buffer (corrupted data)
-                this.buffer = Buffer.alloc(0);
-                return null;
-            }
-        }
-    }
-    /**
-     * Read a Content-Length framed message (LSP-style)
-     */
-    readContentLengthMessage() {
-        const headerEnd = this.buffer.indexOf("\r\n\r\n");
-        if (headerEnd === -1)
-            return null;
-        // Parse headers
-        const headerSection = this.buffer.toString("utf8", 0, headerEnd);
-        const contentLengthMatch = headerSection.match(/Content-Length:\s*(\d+)/i);
-        if (!contentLengthMatch) {
-            // Invalid format - skip header section
-            this.buffer = this.buffer.subarray(headerEnd + 4);
-            return null;
-        }
-        const contentLength = parseInt(contentLengthMatch[1], 10);
-        // Validate content-length is a reasonable positive number
-        const maxBufferSize = this.config.maxBufferSize ?? MCP_LIMITS.MAX_BUFFER_SIZE;
-        if (isNaN(contentLength) || contentLength < 0 || contentLength > maxBufferSize) {
-            // Invalid content-length - skip this message
-            this.buffer = this.buffer.subarray(headerEnd + 4);
-            return null;
-        }
-        const messageStart = headerEnd + 4; // Skip \r\n\r\n
-        const messageEnd = messageStart + contentLength;
-        // Check if we have the complete message
-        if (this.buffer.length < messageEnd) {
-            return null; // Wait for more data
-        }
-        // Extract message
-        const messageBuffer = this.buffer.subarray(messageStart, messageEnd);
-        const messageStr = messageBuffer.toString("utf8");
-        // Remove processed data from buffer
-        this.buffer = this.buffer.subarray(messageEnd);
-        try {
-            return JSON.parse(messageStr);
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Read a NDJSON (newline-delimited JSON) message
-     *
-     * BUG FIX: Fallback for MCP servers that don't use Content-Length framing
-     * (e.g., community mcp-figma package)
-     */
-    readNdjsonMessage() {
-        // Find end of JSON object by looking for newline after complete JSON
-        // We need to handle nested braces properly
-        const bufferStr = this.buffer.toString("utf8");
-        let braceCount = 0;
-        let inString = false;
-        let escaped = false;
-        let endIndex = -1;
-        for (let i = 0; i < bufferStr.length; i++) {
-            const char = bufferStr[i];
-            if (escaped) {
-                escaped = false;
-                continue;
-            }
-            if (char === '\\' && inString) {
-                escaped = true;
-                continue;
-            }
-            if (char === '"') {
-                inString = !inString;
-                continue;
-            }
-            if (inString)
-                continue;
-            if (char === '{') {
-                braceCount++;
-            }
-            else if (char === '}') {
-                braceCount--;
-                if (braceCount === 0) {
-                    endIndex = i + 1;
-                    break;
-                }
-            }
-        }
-        if (endIndex === -1) {
-            return null; // Incomplete JSON - wait for more data
-        }
-        const jsonStr = bufferStr.substring(0, endIndex);
-        // Remove processed data from buffer
-        this.buffer = this.buffer.subarray(Buffer.byteLength(jsonStr, "utf8"));
-        try {
-            return JSON.parse(jsonStr);
-        }
-        catch {
-            // JSON parse error - skip this malformed message
-            return null;
-        }
-    }
-    /**
-     * Send a message with Content-Length framing
-     * BUG FIX: Only resolve when write callback completes, not when write() returns true
-     * This ensures the message was actually transmitted, not just buffered
-     */
-    send(message) {
-        return new Promise((resolve, reject) => {
-            if (!this.process?.stdin?.writable) {
-                reject(new Error("Not connected"));
-                return;
-            }
-            // Serialize message
-            const body = JSON.stringify(message);
-            const contentLength = Buffer.byteLength(body, "utf8");
-            // Format with Content-Length header
-            const framed = `Content-Length: ${contentLength}\r\n\r\n${body}`;
-            // BUG FIX: Track if already resolved to prevent double-resolution
-            let resolved = false;
-            // Write to stdin - only resolve on callback completion
-            this.process.stdin.write(framed, (error) => {
-                if (resolved)
-                    return; // Prevent double-resolution
-                resolved = true;
-                if (error) {
-                    reject(error);
-                }
-                else {
-                    resolve();
-                }
-            });
-            // BUG FIX: Removed early resolve on success=true
-            // The callback ensures the write completed, not just that it was buffered
-        });
-    }
-    /**
-     * Close the transport
-     *
-     * BUG FIX: Now properly waits for process to terminate before resolving.
-     * This prevents resource leaks and zombie processes.
-     */
-    async close() {
-        if (this.process) {
-            const proc = this.process;
-            this.process = undefined;
-            // BUG FIX: Wait for the process to actually exit, not just send kill signal
-            await new Promise((resolve) => {
-                // Set up close handler first
-                const onClose = () => {
-                    clearTimeout(forceKillTimeout);
-                    resolve();
-                };
-                // If already exited, resolve immediately
-                if (proc.exitCode !== null || proc.killed) {
-                    resolve();
-                    return;
-                }
-                proc.once('close', onClose);
-                proc.once('exit', onClose);
-                // Send SIGTERM first for graceful shutdown
-                proc.kill('SIGTERM');
-                // Force kill after 5 seconds if process doesn't exit
-                const forceKillTimeout = setTimeout(() => {
-                    try {
-                        proc.kill('SIGKILL');
-                    }
-                    catch {
-                        // Process may have already exited
-                    }
-                    // Resolve anyway after force kill attempt
-                    setTimeout(resolve, 100);
-                }, 5000);
-            });
-        }
-        this.buffer = Buffer.alloc(0);
-        this._started = false;
-    }
-    /**
-     * Get the process ID
-     */
-    get pid() {
-        return this.process?.pid;
-    }
-    /**
-     * Clean up resources and remove all event listeners.
-     * Required for EventEmitter-extending classes to prevent memory leaks.
-     */
-    destroy() {
-        this.removeAllListeners();
-    }
-}
-/**
- * Factory function to create Content-Length transport
- */
-export function createContentLengthTransport(config) {
-    return new ContentLengthStdioTransport(config);
-}
-//# sourceMappingURL=content-length-transport.js.map

package/dist/mcp/content-length-transport.js.map

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

package/dist/mcp/debug.d.ts

@@ -1,211 +0,0 @@
-/**
- * MCP Debug Mode
- *
- * Comprehensive diagnostic utilities for troubleshooting MCP server connections,
- * tool calls, and configuration issues.
- *
- * @module mcp/debug
- */
-import { EventEmitter } from 'events';
-import type { ServerName, ToolName, ConnectionState, MCPTool, MCPPrompt } from './client-v2.js';
-import type { TransportType } from './transports.js';
-import { Result } from './type-safety.js';
-/**
- * Types of debug events that can be emitted
- */
-export type DebugEventType = 'connection:start' | 'connection:success' | 'connection:failure' | 'connection:disconnect' | 'tool:call:start' | 'tool:call:success' | 'tool:call:failure' | 'tool:call:timeout' | 'transport:created' | 'transport:error' | 'health:check' | 'health:failure' | 'reconnection:scheduled' | 'reconnection:attempt' | 'reconnection:success' | 'reconnection:failure' | 'schema:validation' | 'resource:updated' | 'progress:update';
-/**
- * Debug event structure
- */
-export interface DebugEvent {
-    type: DebugEventType;
-    timestamp: Date;
-    serverName?: ServerName;
-    toolName?: ToolName;
-    data: Record<string, unknown>;
-    duration?: number;
-    error?: Error;
-}
-/**
- * Server diagnostic information
- */
-export interface ServerDiagnostics {
-    serverName: ServerName;
-    status: ConnectionState['status'];
-    transportType?: TransportType;
-    connectedAt?: number;
-    failedAt?: number;
-    lastError?: string;
-    toolCount: number;
-    tools: string[];
-    promptCount: number;
-    prompts: string[];
-    reconnectionAttempts: number;
-    healthCheckStatus?: 'healthy' | 'unhealthy' | 'unknown';
-    lastHealthCheck?: Date;
-}
-/**
- * Overall MCP diagnostic summary
- */
-export interface MCPDiagnostics {
-    timestamp: Date;
-    totalServers: number;
-    connectedServers: number;
-    failedServers: number;
-    connectingServers: number;
-    totalTools: number;
-    totalPrompts: number;
-    servers: ServerDiagnostics[];
-    recentEvents: DebugEvent[];
-    healthCheckEnabled: boolean;
-    reconnectionEnabled: boolean;
-}
-/**
- * Debug log level
- */
-export type DebugLogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';
-/**
- * Debug logger configuration
- */
-export interface DebugLoggerConfig {
-    enabled: boolean;
-    level: DebugLogLevel;
-    maxEvents: number;
-    includeTimestamps: boolean;
-    formatOutput: boolean;
-}
-/**
- * Default debug logger configuration
- */
-export declare const DEFAULT_DEBUG_CONFIG: DebugLoggerConfig;
-/**
- * MCP Debug Logger
- *
- * Captures and formats debug events for MCP operations.
- * Can be enabled/disabled at runtime.
- */
-export declare class MCPDebugLogger extends EventEmitter {
-    private config;
-    private events;
-    private serverHealthStatus;
-    constructor(config?: Partial<DebugLoggerConfig>);
-    /**
-     * Enable debug mode
-     */
-    enable(): void;
-    /**
-     * Disable debug mode
-     */
-    disable(): void;
-    /**
-     * Check if debug mode is enabled
-     */
-    isEnabled(): boolean;
-    /**
-     * Set debug level
-     */
-    setLevel(level: DebugLogLevel): void;
-    /**
-     * Log a debug event
-     */
-    log(type: DebugEventType, data: Record<string, unknown>, options?: {
-        serverName?: ServerName;
-        toolName?: ToolName;
-        duration?: number;
-        error?: Error;
-    }): void;
-    /**
-     * Check if event type should be logged at current level
-     */
-    private shouldLog;
-    /**
-     * Get log level for event type
-     */
-    private getEventLevel;
-    /**
-     * Format and output an event
-     */
-    private outputEvent;
-    /**
-     * Record health check result
-     */
-    recordHealthCheck(serverName: ServerName, healthy: boolean): void;
-    /**
-     * Get recent events
-     */
-    getRecentEvents(count?: number): DebugEvent[];
-    /**
-     * Get events for a specific server
-     */
-    getServerEvents(serverName: ServerName): DebugEvent[];
-    /**
-     * Get events for a specific tool
-     */
-    getToolEvents(toolName: ToolName): DebugEvent[];
-    /**
-     * Get events by type
-     */
-    getEventsByType(type: DebugEventType): DebugEvent[];
-    /**
-     * Get health status for a server
-     */
-    getHealthStatus(serverName: ServerName): {
-        status: 'healthy' | 'unhealthy' | 'unknown';
-        lastCheck?: Date;
-    };
-    /**
-     * Clear all recorded events
-     */
-    clearEvents(): void;
-    /**
-     * Clear health status
-     */
-    clearHealthStatus(): void;
-    /**
-     * Get configuration
-     */
-    getConfig(): DebugLoggerConfig;
-    /**
-     * Update configuration
-     */
-    updateConfig(config: Partial<DebugLoggerConfig>): void;
-    /**
-     * Clean up resources and remove all event listeners.
-     */
-    destroy(): void;
-}
-/**
- * Get the singleton debug logger instance
- */
-export declare function getMCPDebugLogger(): MCPDebugLogger;
-/**
- * Reset the debug logger instance (for testing)
- */
-export declare function resetMCPDebugLogger(): void;
-/**
- * Collect diagnostics from MCPManagerV2
- *
- * @param manager - The MCP manager instance
- * @returns Diagnostic summary
- */
-export declare function collectMCPDiagnostics(manager: {
-    getServers(): ServerName[];
-    getConnectionState(serverName: ServerName): ConnectionState | undefined;
-    getTools(): MCPTool[];
-    getPrompts(): MCPPrompt[];
-    getTransportType(serverName: ServerName): Result<TransportType, Error>;
-    getConnectionStatus(): {
-        connected: number;
-        failed: number;
-        connecting: number;
-        total: number;
-    };
-}): Promise<MCPDiagnostics>;
-/**
- * Format diagnostics for display
- */
-export declare function formatMCPDiagnostics(diagnostics: MCPDiagnostics): string;
-/**
- * Create a debug session that instruments MCP manager events
- */
-export declare function createDebugSession(manager: EventEmitter, options?: Partial<DebugLoggerConfig>): MCPDebugLogger;