@claude-flow/shared 3.0.0-alpha.1

package/dist/mcp/tool-registry.js

@@ -0,0 +1,439 @@
+/**
+ * V3 MCP Tool Registry
+ *
+ * High-performance tool management with:
+ * - Fast O(1) lookup using Map
+ * - Category-based organization
+ * - Tool validation on registration
+ * - Dynamic registration/unregistration
+ * - Caching for frequently used tools
+ *
+ * Performance Targets:
+ * - Tool registration: <10ms
+ * - Tool lookup: <1ms
+ * - Tool validation: <5ms
+ */
+import { EventEmitter } from 'events';
+/**
+ * Tool Registry
+ *
+ * Manages registration, lookup, and execution of MCP tools
+ */
+export class ToolRegistry extends EventEmitter {
+    logger;
+    tools = new Map();
+    categoryIndex = new Map();
+    tagIndex = new Map();
+    defaultContext;
+    // Performance tracking
+    totalRegistrations = 0;
+    totalLookups = 0;
+    totalExecutions = 0;
+    constructor(logger) {
+        super();
+        this.logger = logger;
+    }
+    /**
+     * Register a tool
+     */
+    register(tool, options = {}) {
+        const startTime = performance.now();
+        // Check for existing tool
+        if (this.tools.has(tool.name) && !options.override) {
+            this.logger.warn('Tool already registered', { name: tool.name });
+            return false;
+        }
+        // Validate tool if requested
+        if (options.validate !== false) {
+            const validation = this.validateTool(tool);
+            if (!validation.valid) {
+                this.logger.error('Tool validation failed', {
+                    name: tool.name,
+                    errors: validation.errors,
+                });
+                return false;
+            }
+        }
+        // Create metadata
+        const metadata = {
+            tool,
+            registeredAt: new Date(),
+            callCount: 0,
+            avgExecutionTime: 0,
+            errorCount: 0,
+        };
+        // Register tool
+        this.tools.set(tool.name, metadata);
+        this.totalRegistrations++;
+        // Update category index
+        if (tool.category) {
+            if (!this.categoryIndex.has(tool.category)) {
+                this.categoryIndex.set(tool.category, new Set());
+            }
+            this.categoryIndex.get(tool.category).add(tool.name);
+        }
+        // Update tag index
+        if (tool.tags) {
+            for (const tag of tool.tags) {
+                if (!this.tagIndex.has(tag)) {
+                    this.tagIndex.set(tag, new Set());
+                }
+                this.tagIndex.get(tag).add(tool.name);
+            }
+        }
+        const duration = performance.now() - startTime;
+        this.logger.debug('Tool registered', {
+            name: tool.name,
+            category: tool.category,
+            duration: `${duration.toFixed(2)}ms`,
+        });
+        this.emit('tool:registered', tool.name);
+        return true;
+    }
+    /**
+     * Register multiple tools at once
+     */
+    registerBatch(tools, options = {}) {
+        const startTime = performance.now();
+        const failed = [];
+        let registered = 0;
+        for (const tool of tools) {
+            if (this.register(tool, options)) {
+                registered++;
+            }
+            else {
+                failed.push(tool.name);
+            }
+        }
+        const duration = performance.now() - startTime;
+        this.logger.info('Batch registration complete', {
+            total: tools.length,
+            registered,
+            failed: failed.length,
+            duration: `${duration.toFixed(2)}ms`,
+        });
+        return { registered, failed };
+    }
+    /**
+     * Unregister a tool
+     */
+    unregister(name) {
+        const metadata = this.tools.get(name);
+        if (!metadata) {
+            return false;
+        }
+        // Remove from category index
+        if (metadata.tool.category) {
+            const categoryTools = this.categoryIndex.get(metadata.tool.category);
+            categoryTools?.delete(name);
+            if (categoryTools?.size === 0) {
+                this.categoryIndex.delete(metadata.tool.category);
+            }
+        }
+        // Remove from tag index
+        if (metadata.tool.tags) {
+            for (const tag of metadata.tool.tags) {
+                const tagTools = this.tagIndex.get(tag);
+                tagTools?.delete(name);
+                if (tagTools?.size === 0) {
+                    this.tagIndex.delete(tag);
+                }
+            }
+        }
+        this.tools.delete(name);
+        this.logger.debug('Tool unregistered', { name });
+        this.emit('tool:unregistered', name);
+        return true;
+    }
+    /**
+     * Get a tool by name
+     */
+    getTool(name) {
+        this.totalLookups++;
+        return this.tools.get(name)?.tool;
+    }
+    /**
+     * Check if a tool exists
+     */
+    hasTool(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get tool count
+     */
+    getToolCount() {
+        return this.tools.size;
+    }
+    /**
+     * Get all tool names
+     */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * List all tools with metadata
+     */
+    listTools() {
+        return Array.from(this.tools.values()).map(({ tool }) => ({
+            name: tool.name,
+            description: tool.description,
+            category: tool.category,
+            tags: tool.tags,
+            deprecated: tool.deprecated,
+        }));
+    }
+    /**
+     * Search tools by criteria
+     */
+    search(options) {
+        let results;
+        // Filter by category
+        if (options.category) {
+            const categoryTools = this.categoryIndex.get(options.category);
+            if (!categoryTools)
+                return [];
+            results = new Set(categoryTools);
+        }
+        // Filter by tags (intersection)
+        if (options.tags && options.tags.length > 0) {
+            for (const tag of options.tags) {
+                const tagTools = this.tagIndex.get(tag);
+                if (!tagTools)
+                    return [];
+                if (results) {
+                    results = new Set([...results].filter((name) => tagTools.has(name)));
+                }
+                else {
+                    results = new Set(tagTools);
+                }
+            }
+        }
+        // Get all tools if no filters applied
+        if (!results) {
+            results = new Set(this.tools.keys());
+        }
+        // Convert to tools and apply additional filters
+        const tools = [];
+        for (const name of results) {
+            const metadata = this.tools.get(name);
+            if (!metadata)
+                continue;
+            const tool = metadata.tool;
+            // Filter by deprecated status
+            if (options.deprecated !== undefined && tool.deprecated !== options.deprecated) {
+                continue;
+            }
+            // Filter by cacheable status
+            if (options.cacheable !== undefined && tool.cacheable !== options.cacheable) {
+                continue;
+            }
+            tools.push(tool);
+        }
+        return tools;
+    }
+    /**
+     * Get tools by category
+     */
+    getByCategory(category) {
+        const toolNames = this.categoryIndex.get(category);
+        if (!toolNames)
+            return [];
+        return Array.from(toolNames)
+            .map((name) => this.tools.get(name)?.tool)
+            .filter((tool) => tool !== undefined);
+    }
+    /**
+     * Get tools by tag
+     */
+    getByTag(tag) {
+        const toolNames = this.tagIndex.get(tag);
+        if (!toolNames)
+            return [];
+        return Array.from(toolNames)
+            .map((name) => this.tools.get(name)?.tool)
+            .filter((tool) => tool !== undefined);
+    }
+    /**
+     * Get all categories
+     */
+    getCategories() {
+        return Array.from(this.categoryIndex.keys());
+    }
+    /**
+     * Get all tags
+     */
+    getTags() {
+        return Array.from(this.tagIndex.keys());
+    }
+    /**
+     * Execute a tool
+     */
+    async execute(name, input, context) {
+        const startTime = performance.now();
+        const metadata = this.tools.get(name);
+        if (!metadata) {
+            return {
+                content: [{ type: 'text', text: `Tool not found: ${name}` }],
+                isError: true,
+            };
+        }
+        // Build execution context with required sessionId
+        const execContext = {
+            sessionId: context?.sessionId || this.defaultContext?.sessionId || 'default-session',
+            ...this.defaultContext,
+            ...context,
+        };
+        this.totalExecutions++;
+        metadata.callCount++;
+        metadata.lastCalled = new Date();
+        try {
+            this.emit('tool:called', { name, input });
+            const result = await metadata.tool.handler(input, execContext);
+            const duration = performance.now() - startTime;
+            this.updateAverageExecutionTime(metadata, duration);
+            this.logger.debug('Tool executed', {
+                name,
+                duration: `${duration.toFixed(2)}ms`,
+                success: true,
+            });
+            this.emit('tool:completed', { name, duration, success: true });
+            // Format result
+            return {
+                content: [{
+                        type: 'text',
+                        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                    }],
+                isError: false,
+            };
+        }
+        catch (error) {
+            const duration = performance.now() - startTime;
+            metadata.errorCount++;
+            this.logger.error('Tool execution failed', { name, error });
+            this.emit('tool:error', { name, error, duration });
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    }],
+                isError: true,
+            };
+        }
+    }
+    /**
+     * Set default execution context
+     */
+    setDefaultContext(context) {
+        this.defaultContext = context;
+    }
+    /**
+     * Get tool metadata
+     */
+    getMetadata(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Get registry statistics
+     */
+    getStats() {
+        // Get top 10 most used tools
+        const topTools = Array.from(this.tools.entries())
+            .map(([name, metadata]) => ({ name, calls: metadata.callCount }))
+            .sort((a, b) => b.calls - a.calls)
+            .slice(0, 10);
+        return {
+            totalTools: this.tools.size,
+            totalCategories: this.categoryIndex.size,
+            totalTags: this.tagIndex.size,
+            totalRegistrations: this.totalRegistrations,
+            totalLookups: this.totalLookups,
+            totalExecutions: this.totalExecutions,
+            topTools,
+        };
+    }
+    /**
+     * Validate a tool definition
+     */
+    validateTool(tool) {
+        const errors = [];
+        if (!tool.name || typeof tool.name !== 'string') {
+            errors.push('Tool name is required and must be a string');
+        }
+        else if (!/^[a-zA-Z][a-zA-Z0-9_/:-]*$/.test(tool.name)) {
+            errors.push('Tool name must start with a letter and contain only alphanumeric characters, underscores, slashes, colons, and hyphens');
+        }
+        if (!tool.description || typeof tool.description !== 'string') {
+            errors.push('Tool description is required and must be a string');
+        }
+        if (!tool.inputSchema || typeof tool.inputSchema !== 'object') {
+            errors.push('Tool inputSchema is required and must be an object');
+        }
+        else {
+            const schemaErrors = this.validateSchema(tool.inputSchema);
+            errors.push(...schemaErrors);
+        }
+        if (typeof tool.handler !== 'function') {
+            errors.push('Tool handler is required and must be a function');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Validate JSON Schema
+     */
+    validateSchema(schema, path = '') {
+        const errors = [];
+        if (!schema.type) {
+            errors.push(`${path || 'schema'}: type is required`);
+        }
+        if (schema.type === 'object' && schema.properties) {
+            for (const [key, propSchema] of Object.entries(schema.properties)) {
+                const propPath = path ? `${path}.${key}` : key;
+                errors.push(...this.validateSchema(propSchema, propPath));
+            }
+        }
+        if (schema.type === 'array' && schema.items) {
+            errors.push(...this.validateSchema(schema.items, `${path}[]`));
+        }
+        return errors;
+    }
+    /**
+     * Update average execution time
+     */
+    updateAverageExecutionTime(metadata, duration) {
+        const n = metadata.callCount;
+        metadata.avgExecutionTime =
+            ((metadata.avgExecutionTime * (n - 1)) + duration) / n;
+    }
+    /**
+     * Clear all tools
+     */
+    clear() {
+        this.tools.clear();
+        this.categoryIndex.clear();
+        this.tagIndex.clear();
+        this.logger.info('Tool registry cleared');
+        this.emit('registry:cleared');
+    }
+}
+/**
+ * Create a tool registry
+ */
+export function createToolRegistry(logger) {
+    return new ToolRegistry(logger);
+}
+/**
+ * Helper to create a tool definition
+ */
+export function defineTool(name, description, inputSchema, handler, options) {
+    return {
+        name,
+        description,
+        inputSchema,
+        handler,
+        ...options,
+    };
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/mcp/tool-registry.js.map

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

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

@@ -0,0 +1,104 @@
+/**
+ * V3 MCP HTTP Transport
+ *
+ * HTTP/REST transport for MCP communication:
+ * - Express-based with optimized middleware
+ * - WebSocket support for real-time notifications
+ * - Connection pooling for client connections
+ * - Security headers with helmet
+ *
+ * Performance Targets:
+ * - Request handling: <20ms overhead
+ * - WebSocket message: <5ms
+ */
+import { EventEmitter } from 'events';
+import { ITransport, TransportType, MCPNotification, RequestHandler, NotificationHandler, TransportHealthStatus, ILogger, AuthConfig } from '../types.js';
+/**
+ * HTTP Transport Configuration
+ */
+export interface HttpTransportConfig {
+    host: string;
+    port: number;
+    tlsEnabled?: boolean;
+    tlsCert?: string;
+    tlsKey?: string;
+    corsEnabled?: boolean;
+    corsOrigins?: string[];
+    auth?: AuthConfig;
+    maxRequestSize?: string;
+    requestTimeout?: number;
+}
+/**
+ * HTTP Transport Implementation
+ */
+export declare class HttpTransport extends EventEmitter implements ITransport {
+    private readonly logger;
+    private readonly config;
+    readonly type: TransportType;
+    private requestHandler?;
+    private notificationHandler?;
+    private app;
+    private server?;
+    private wss?;
+    private running;
+    private activeConnections;
+    private messagesReceived;
+    private messagesSent;
+    private errors;
+    private httpRequests;
+    private wsMessages;
+    constructor(logger: ILogger, config: HttpTransportConfig);
+    /**
+     * 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>;
+    /**
+     * Send notification to all connected WebSocket clients
+     */
+    sendNotification(notification: MCPNotification): Promise<void>;
+    /**
+     * Setup Express middleware
+     */
+    private setupMiddleware;
+    /**
+     * Setup Express routes
+     */
+    private setupRoutes;
+    /**
+     * Setup WebSocket handlers
+     */
+    private setupWebSocketHandlers;
+    /**
+     * Handle HTTP request
+     */
+    private handleHttpRequest;
+    /**
+     * Handle WebSocket message
+     */
+    private handleWebSocketMessage;
+    /**
+     * Validate authentication
+     */
+    private validateAuth;
+}
+/**
+ * Create HTTP transport
+ */
+export declare function createHttpTransport(logger: ILogger, config: HttpTransportConfig): HttpTransport;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,OAAO,EACL,UAAU,EACV,aAAa,EAGb,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,OAAO,EACP,UAAU,EACX,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAa,YAAW,UAAU;IAmBjE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAnBzB,SAAgB,IAAI,EAAE,aAAa,CAAU;IAE7C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,GAAG,CAAC,CAAkB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAwB;IAGjD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAK;gBAGJ,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,mBAAmB;IAQ9C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC3B;;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;IAcvD;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpE;;OAEG;IACH,OAAO,CAAC,eAAe;IA6EvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAqDnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,iBAAiB;IAqF/B;;OAEG;YACW,sBAAsB;IAyDpC;;OAEG;IACH,OAAO,CAAC,YAAY;CAsBrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CAEf"}