@claude-flow/shared 3.0.0-alpha.1

package/dist/mcp/transport/index.js

@@ -0,0 +1,238 @@
+/**
+ * V3 MCP Transport Factory
+ *
+ * Central factory for creating transport instances:
+ * - Unified transport creation API
+ * - Transport type validation
+ * - Configuration defaults
+ * - Multi-transport support
+ *
+ * Supported transports:
+ * - stdio: Standard I/O (default for CLI)
+ * - http: HTTP/REST with WebSocket upgrade
+ * - websocket: Standalone WebSocket
+ * - in-process: Direct function calls (fastest)
+ */
+import { createStdioTransport } from './stdio.js';
+import { createHttpTransport } from './http.js';
+import { createWebSocketTransport } from './websocket.js';
+// Re-export transport classes (values)
+export { StdioTransport } from './stdio.js';
+export { HttpTransport } from './http.js';
+export { WebSocketTransport } from './websocket.js';
+/**
+ * Create a transport instance based on type
+ */
+export function createTransport(type, logger, config) {
+    switch (type) {
+        case 'stdio':
+            return createStdioTransport(logger, config);
+        case 'http':
+            if (!config || !('host' in config) || !('port' in config)) {
+                throw new Error('HTTP transport requires host and port configuration');
+            }
+            return createHttpTransport(logger, {
+                host: config.host,
+                port: config.port,
+                ...config,
+            });
+        case 'websocket':
+            if (!config || !('host' in config) || !('port' in config)) {
+                throw new Error('WebSocket transport requires host and port configuration');
+            }
+            return createWebSocketTransport(logger, {
+                host: config.host,
+                port: config.port,
+                ...config,
+            });
+        case 'in-process':
+            // In-process transport is handled directly by the server
+            // Return a no-op transport wrapper
+            return createInProcessTransport(logger);
+        default:
+            throw new Error(`Unknown transport type: ${type}`);
+    }
+}
+/**
+ * In-process transport (no-op wrapper)
+ *
+ * Used when tools are executed directly without network transport
+ */
+class InProcessTransport {
+    logger;
+    type = 'in-process';
+    constructor(logger) {
+        this.logger = logger;
+    }
+    async start() {
+        this.logger.debug('In-process transport started');
+    }
+    async stop() {
+        this.logger.debug('In-process transport stopped');
+    }
+    onRequest() {
+        // No-op - requests are handled directly
+    }
+    onNotification() {
+        // No-op - notifications are handled directly
+    }
+    async getHealthStatus() {
+        return {
+            healthy: true,
+            metrics: {
+                latency: 0,
+                connections: 1,
+            },
+        };
+    }
+}
+/**
+ * Create in-process transport
+ */
+export function createInProcessTransport(logger) {
+    return new InProcessTransport(logger);
+}
+/**
+ * Transport manager for multi-transport scenarios
+ */
+export class TransportManager {
+    logger;
+    transports = new Map();
+    running = false;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Add a transport
+     */
+    addTransport(name, transport) {
+        if (this.transports.has(name)) {
+            throw new Error(`Transport "${name}" already exists`);
+        }
+        this.transports.set(name, transport);
+        this.logger.debug('Transport added', { name, type: transport.type });
+    }
+    /**
+     * Remove a transport
+     */
+    async removeTransport(name) {
+        const transport = this.transports.get(name);
+        if (!transport) {
+            return false;
+        }
+        await transport.stop();
+        this.transports.delete(name);
+        this.logger.debug('Transport removed', { name });
+        return true;
+    }
+    /**
+     * Get a transport by name
+     */
+    getTransport(name) {
+        return this.transports.get(name);
+    }
+    /**
+     * Get all transport names
+     */
+    getTransportNames() {
+        return Array.from(this.transports.keys());
+    }
+    /**
+     * Start all transports
+     */
+    async startAll() {
+        if (this.running) {
+            throw new Error('TransportManager already running');
+        }
+        this.logger.info('Starting all transports', { count: this.transports.size });
+        const startPromises = Array.from(this.transports.entries()).map(async ([name, transport]) => {
+            try {
+                await transport.start();
+                this.logger.info('Transport started', { name, type: transport.type });
+            }
+            catch (error) {
+                this.logger.error('Failed to start transport', { name, error });
+                throw error;
+            }
+        });
+        await Promise.all(startPromises);
+        this.running = true;
+        this.logger.info('All transports started');
+    }
+    /**
+     * Stop all transports
+     */
+    async stopAll() {
+        if (!this.running) {
+            return;
+        }
+        this.logger.info('Stopping all transports');
+        const stopPromises = Array.from(this.transports.entries()).map(async ([name, transport]) => {
+            try {
+                await transport.stop();
+                this.logger.info('Transport stopped', { name });
+            }
+            catch (error) {
+                this.logger.error('Error stopping transport', { name, error });
+            }
+        });
+        await Promise.all(stopPromises);
+        this.running = false;
+        this.logger.info('All transports stopped');
+    }
+    /**
+     * Get health status of all transports
+     */
+    async getHealthStatus() {
+        const results = {};
+        for (const [name, transport] of this.transports) {
+            try {
+                const status = await transport.getHealthStatus();
+                results[name] = { healthy: status.healthy, error: status.error };
+            }
+            catch (error) {
+                results[name] = {
+                    healthy: false,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                };
+            }
+        }
+        return results;
+    }
+    /**
+     * Check if any transport is running
+     */
+    isRunning() {
+        return this.running;
+    }
+}
+/**
+ * Create a transport manager
+ */
+export function createTransportManager(logger) {
+    return new TransportManager(logger);
+}
+/**
+ * Default transport configurations
+ */
+export const DEFAULT_TRANSPORT_CONFIGS = {
+    stdio: {},
+    http: {
+        host: 'localhost',
+        port: 3000,
+        corsEnabled: true,
+        corsOrigins: ['*'],
+        maxRequestSize: '10mb',
+        requestTimeout: 30000,
+    },
+    websocket: {
+        host: 'localhost',
+        port: 3001,
+        path: '/ws',
+        maxConnections: 100,
+        heartbeatInterval: 30000,
+        heartbeatTimeout: 10000,
+        maxMessageSize: 10 * 1024 * 1024,
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/mcp/transport/index.js.map

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

package/dist/mcp/transport/stdio.d.ts

@@ -0,0 +1,104 @@
+/**
+ * V3 MCP Stdio Transport
+ *
+ * Standard I/O transport for MCP communication:
+ * - Optimized JSON parsing with streaming
+ * - Buffer management for large messages
+ * - Graceful shutdown handling
+ *
+ * Performance Targets:
+ * - Message parsing: <5ms
+ * - Response sending: <2ms
+ */
+import { EventEmitter } from 'events';
+import { ITransport, TransportType, MCPNotification, RequestHandler, NotificationHandler, TransportHealthStatus, ILogger } from '../types.js';
+/**
+ * Stdio Transport Configuration
+ */
+export interface StdioTransportConfig {
+    inputStream?: NodeJS.ReadableStream;
+    outputStream?: NodeJS.WritableStream;
+    maxMessageSize?: number;
+}
+/**
+ * Stdio Transport Implementation
+ *
+ * Uses readline for efficient line-by-line processing of JSON-RPC messages
+ */
+export declare class StdioTransport extends EventEmitter implements ITransport {
+    private readonly logger;
+    readonly type: TransportType;
+    private requestHandler?;
+    private notificationHandler?;
+    private rl?;
+    private running;
+    private messageBuffer;
+    private messagesReceived;
+    private messagesSent;
+    private errors;
+    private readonly inputStream;
+    private readonly outputStream;
+    private readonly maxMessageSize;
+    constructor(logger: ILogger, config?: StdioTransportConfig);
+    /**
+     * Start the transport
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the transport
+     */
+    stop(): Promise<void>;
+    /**
+     * Register request handler
+     */
+    onRequest(handler: RequestHandler): void;
+    /**
+     * Register notification handler
+     */
+    onNotification(handler: NotificationHandler): void;
+    /**
+     * Get health status
+     */
+    getHealthStatus(): Promise<TransportHealthStatus>;
+    /**
+     * Handle incoming line
+     */
+    private handleLine;
+    /**
+     * Handle MCP request
+     */
+    private handleRequest;
+    /**
+     * Handle MCP notification
+     */
+    private handleNotification;
+    /**
+     * Send response to stdout
+     */
+    private sendResponse;
+    /**
+     * Send error response
+     */
+    private sendError;
+    /**
+     * Send notification to stdout
+     */
+    sendNotification(notification: MCPNotification): Promise<void>;
+    /**
+     * Write to output stream
+     */
+    private write;
+    /**
+     * Handle stream close
+     */
+    private handleClose;
+    /**
+     * Handle stream error
+     */
+    private handleError;
+}
+/**
+ * Create stdio transport
+ */
+export declare function createStdioTransport(logger: ILogger, config?: StdioTransportConfig): StdioTransport;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/mcp/transport/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/stdio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EACL,UAAU,EACV,aAAa,EAGb,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,OAAO,EACR,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,YAAa,YAAW,UAAU;IAmBlE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAlBzB,SAAgB,IAAI,EAAE,aAAa,CAAW;IAE9C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,EAAE,CAAC,CAAqB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAM;IAG3B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAK;IAEnB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGrB,MAAM,EAAE,OAAO,EAChC,MAAM,GAAE,oBAAyB;IAQnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAIlD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAWvD;;OAEG;YACW,UAAU;IA+CxB;;OAEG;YACW,aAAa;IA4B3B;;OAEG;YACW,kBAAkB;IAchC;;OAEG;YACW,YAAY;IAM1B;;OAEG;YACW,SAAS;IAUvB;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE;;OAEG;IACH,OAAO,CAAC,KAAK;IAab;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,WAAW;CAKpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,EACf,MAAM,GAAE,oBAAyB,GAChC,cAAc,CAEhB"}

package/dist/mcp/transport/stdio.js

@@ -0,0 +1,263 @@
+/**
+ * V3 MCP Stdio Transport
+ *
+ * Standard I/O transport for MCP communication:
+ * - Optimized JSON parsing with streaming
+ * - Buffer management for large messages
+ * - Graceful shutdown handling
+ *
+ * Performance Targets:
+ * - Message parsing: <5ms
+ * - Response sending: <2ms
+ */
+import { EventEmitter } from 'events';
+import * as readline from 'readline';
+/**
+ * Stdio Transport Implementation
+ *
+ * Uses readline for efficient line-by-line processing of JSON-RPC messages
+ */
+export class StdioTransport extends EventEmitter {
+    logger;
+    type = 'stdio';
+    requestHandler;
+    notificationHandler;
+    rl;
+    running = false;
+    messageBuffer = '';
+    // Statistics
+    messagesReceived = 0;
+    messagesSent = 0;
+    errors = 0;
+    inputStream;
+    outputStream;
+    maxMessageSize;
+    constructor(logger, config = {}) {
+        super();
+        this.logger = logger;
+        this.inputStream = config.inputStream || process.stdin;
+        this.outputStream = config.outputStream || process.stdout;
+        this.maxMessageSize = config.maxMessageSize || 10 * 1024 * 1024; // 10MB default
+    }
+    /**
+     * Start the transport
+     */
+    async start() {
+        if (this.running) {
+            throw new Error('Stdio transport already running');
+        }
+        this.logger.info('Starting stdio transport');
+        // Create readline interface for efficient line processing
+        this.rl = readline.createInterface({
+            input: this.inputStream,
+            crlfDelay: Infinity,
+        });
+        // Handle incoming lines
+        this.rl.on('line', (line) => {
+            this.handleLine(line);
+        });
+        // Handle close
+        this.rl.on('close', () => {
+            this.handleClose();
+        });
+        // Handle errors on input stream
+        this.inputStream.on('error', (error) => {
+            this.handleError(error);
+        });
+        this.running = true;
+        this.logger.info('Stdio transport started');
+    }
+    /**
+     * Stop the transport
+     */
+    async stop() {
+        if (!this.running) {
+            return;
+        }
+        this.logger.info('Stopping stdio transport');
+        this.running = false;
+        if (this.rl) {
+            this.rl.close();
+            this.rl = undefined;
+        }
+        this.logger.info('Stdio transport stopped');
+    }
+    /**
+     * Register request handler
+     */
+    onRequest(handler) {
+        this.requestHandler = handler;
+    }
+    /**
+     * Register notification handler
+     */
+    onNotification(handler) {
+        this.notificationHandler = handler;
+    }
+    /**
+     * Get health status
+     */
+    async getHealthStatus() {
+        return {
+            healthy: this.running,
+            metrics: {
+                messagesReceived: this.messagesReceived,
+                messagesSent: this.messagesSent,
+                errors: this.errors,
+            },
+        };
+    }
+    /**
+     * Handle incoming line
+     */
+    async handleLine(line) {
+        if (!line.trim()) {
+            return;
+        }
+        // Check message size
+        if (line.length > this.maxMessageSize) {
+            this.logger.error('Message exceeds maximum size', {
+                size: line.length,
+                max: this.maxMessageSize,
+            });
+            this.errors++;
+            return;
+        }
+        try {
+            const message = JSON.parse(line);
+            this.messagesReceived++;
+            // Validate JSON-RPC format
+            if (message.jsonrpc !== '2.0') {
+                this.logger.warn('Invalid JSON-RPC version', { received: message.jsonrpc });
+                await this.sendError(message.id, -32600, 'Invalid JSON-RPC version');
+                return;
+            }
+            if (!message.method) {
+                this.logger.warn('Missing method in request');
+                await this.sendError(message.id, -32600, 'Missing method');
+                return;
+            }
+            // Determine if this is a request or notification
+            if (message.id !== undefined) {
+                // Request - needs response
+                await this.handleRequest(message);
+            }
+            else {
+                // Notification - no response needed
+                await this.handleNotification(message);
+            }
+        }
+        catch (error) {
+            this.errors++;
+            this.logger.error('Failed to parse message', { error, line: line.substring(0, 100) });
+            await this.sendError(null, -32700, 'Parse error');
+        }
+    }
+    /**
+     * Handle MCP request
+     */
+    async handleRequest(request) {
+        if (!this.requestHandler) {
+            this.logger.warn('No request handler registered');
+            await this.sendError(request.id, -32603, 'No request handler');
+            return;
+        }
+        try {
+            const startTime = performance.now();
+            const response = await this.requestHandler(request);
+            const duration = performance.now() - startTime;
+            this.logger.debug('Request processed', {
+                method: request.method,
+                duration: `${duration.toFixed(2)}ms`,
+            });
+            await this.sendResponse(response);
+        }
+        catch (error) {
+            this.logger.error('Request handler error', { method: request.method, error });
+            await this.sendError(request.id, -32603, error instanceof Error ? error.message : 'Internal error');
+        }
+    }
+    /**
+     * Handle MCP notification
+     */
+    async handleNotification(notification) {
+        if (!this.notificationHandler) {
+            this.logger.debug('Notification received but no handler', { method: notification.method });
+            return;
+        }
+        try {
+            await this.notificationHandler(notification);
+        }
+        catch (error) {
+            this.logger.error('Notification handler error', { method: notification.method, error });
+            // Notifications don't send error responses
+        }
+    }
+    /**
+     * Send response to stdout
+     */
+    async sendResponse(response) {
+        const json = JSON.stringify(response);
+        await this.write(json);
+        this.messagesSent++;
+    }
+    /**
+     * Send error response
+     */
+    async sendError(id, code, message) {
+        const response = {
+            jsonrpc: '2.0',
+            id,
+            error: { code, message },
+        };
+        await this.sendResponse(response);
+        this.errors++;
+    }
+    /**
+     * Send notification to stdout
+     */
+    async sendNotification(notification) {
+        const json = JSON.stringify(notification);
+        await this.write(json);
+        this.messagesSent++;
+    }
+    /**
+     * Write to output stream
+     */
+    write(data) {
+        return new Promise((resolve, reject) => {
+            this.outputStream.write(data + '\n', (error) => {
+                if (error) {
+                    this.errors++;
+                    reject(error);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Handle stream close
+     */
+    handleClose() {
+        this.logger.info('Stdio stream closed');
+        this.running = false;
+        this.emit('close');
+    }
+    /**
+     * Handle stream error
+     */
+    handleError(error) {
+        this.logger.error('Stdio stream error', error);
+        this.errors++;
+        this.emit('error', error);
+    }
+}
+/**
+ * Create stdio transport
+ */
+export function createStdioTransport(logger, config = {}) {
+    return new StdioTransport(logger, config);
+}
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/transport/stdio.js.map

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