@claude-flow/mcp 3.0.0-alpha.1

package/dist/task-manager.js

@@ -0,0 +1,337 @@
+/**
+ * @claude-flow/mcp - Task Manager
+ *
+ * MCP 2025-11-25 compliant async task management
+ * Supports: task tracking, progress reporting, cancellation
+ */
+import { EventEmitter } from 'events';
+export class TaskManager extends EventEmitter {
+    logger;
+    tasks = new Map();
+    runningCount = 0;
+    taskCounter = 0;
+    cleanupTimer;
+    options;
+    constructor(logger, options = {}) {
+        super();
+        this.logger = logger;
+        this.options = {
+            maxConcurrentTasks: options.maxConcurrentTasks ?? 10,
+            taskTimeout: options.taskTimeout ?? 300000, // 5 minutes
+            cleanupInterval: options.cleanupInterval ?? 60000, // 1 minute
+            taskRetentionTime: options.taskRetentionTime ?? 3600000, // 1 hour
+        };
+        this.startCleanupTimer();
+    }
+    /**
+     * Create a new task
+     */
+    createTask(executor, metadata) {
+        const taskId = `task-${++this.taskCounter}-${Date.now()}`;
+        const now = new Date();
+        const task = {
+            id: taskId,
+            state: 'pending',
+            createdAt: now,
+            updatedAt: now,
+            metadata,
+            executor: executor,
+        };
+        this.tasks.set(taskId, task);
+        this.logger.debug('Task created', { taskId });
+        this.emit('task:created', { taskId });
+        // Auto-start if we have capacity
+        if (this.runningCount < this.options.maxConcurrentTasks) {
+            this.startTask(taskId);
+        }
+        return taskId;
+    }
+    /**
+     * Start a pending task
+     */
+    async startTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task || task.state !== 'pending') {
+            return;
+        }
+        if (this.runningCount >= this.options.maxConcurrentTasks) {
+            return;
+        }
+        task.state = 'running';
+        task.updatedAt = new Date();
+        task.abortController = new AbortController();
+        this.runningCount++;
+        this.logger.debug('Task started', { taskId });
+        this.emit('task:started', { taskId });
+        // Set up timeout
+        const timeoutId = setTimeout(() => {
+            this.cancelTask(taskId, 'Task timeout');
+        }, this.options.taskTimeout);
+        // Progress reporter
+        const reportProgress = (progress) => {
+            task.progress = progress;
+            task.updatedAt = new Date();
+            this.emit('task:progress', { taskId, progress });
+        };
+        try {
+            const result = await task.executor(reportProgress, task.abortController.signal);
+            clearTimeout(timeoutId);
+            if (task.state === 'running') {
+                task.state = 'completed';
+                task.result = result;
+                task.updatedAt = new Date();
+                task.progress = { progress: 100, total: 100 };
+                this.logger.debug('Task completed', { taskId });
+                this.emit('task:completed', { taskId, result });
+            }
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (task.state === 'running') {
+                if (task.abortController.signal.aborted) {
+                    task.state = 'cancelled';
+                    this.logger.debug('Task cancelled', { taskId });
+                    this.emit('task:cancelled', { taskId });
+                }
+                else {
+                    task.state = 'failed';
+                    task.error = {
+                        code: -32603,
+                        message: error instanceof Error ? error.message : 'Task failed',
+                    };
+                    this.logger.error('Task failed', { taskId, error });
+                    this.emit('task:failed', { taskId, error: task.error });
+                }
+                task.updatedAt = new Date();
+            }
+        }
+        finally {
+            this.runningCount--;
+            task.abortController = undefined;
+            // Start next pending task
+            this.startNextPendingTask();
+        }
+    }
+    /**
+     * Start next pending task if available
+     */
+    startNextPendingTask() {
+        for (const [taskId, task] of this.tasks) {
+            if (task.state === 'pending') {
+                this.startTask(taskId);
+                break;
+            }
+        }
+    }
+    /**
+     * Cancel a task
+     */
+    cancelTask(taskId, reason) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return false;
+        }
+        if (task.state !== 'pending' && task.state !== 'running') {
+            return false;
+        }
+        if (task.abortController) {
+            task.abortController.abort(reason);
+        }
+        if (task.state === 'pending') {
+            task.state = 'cancelled';
+            task.updatedAt = new Date();
+            task.error = { code: -32800, message: reason || 'Cancelled' };
+            this.emit('task:cancelled', { taskId, reason });
+        }
+        this.logger.debug('Task cancel requested', { taskId, reason });
+        return true;
+    }
+    /**
+     * Get task status
+     */
+    getTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return undefined;
+        }
+        return {
+            taskId: task.id,
+            state: task.state,
+            progress: task.progress,
+            result: task.result,
+            error: task.error,
+        };
+    }
+    /**
+     * Get all tasks
+     */
+    getAllTasks() {
+        return Array.from(this.tasks.values()).map((task) => ({
+            taskId: task.id,
+            state: task.state,
+            progress: task.progress,
+            result: task.result,
+            error: task.error,
+        }));
+    }
+    /**
+     * Get tasks by state
+     */
+    getTasksByState(state) {
+        return Array.from(this.tasks.values())
+            .filter((task) => task.state === state)
+            .map((task) => ({
+            taskId: task.id,
+            state: task.state,
+            progress: task.progress,
+            result: task.result,
+            error: task.error,
+        }));
+    }
+    /**
+     * Wait for task completion
+     */
+    async waitForTask(taskId, timeout) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        const effectiveTimeout = timeout ?? this.options.taskTimeout;
+        return new Promise((resolve, reject) => {
+            const checkState = () => {
+                const result = this.getTask(taskId);
+                if (!result) {
+                    reject(new Error(`Task not found: ${taskId}`));
+                    return true;
+                }
+                if (result.state === 'completed' || result.state === 'failed' || result.state === 'cancelled') {
+                    resolve(result);
+                    return true;
+                }
+                return false;
+            };
+            if (checkState())
+                return;
+            const timeoutId = setTimeout(() => {
+                this.off('task:completed', onComplete);
+                this.off('task:failed', onFail);
+                this.off('task:cancelled', onCancel);
+                reject(new Error(`Wait timeout for task: ${taskId}`));
+            }, effectiveTimeout);
+            const cleanup = () => {
+                clearTimeout(timeoutId);
+                this.off('task:completed', onComplete);
+                this.off('task:failed', onFail);
+                this.off('task:cancelled', onCancel);
+            };
+            const onComplete = (event) => {
+                if (event.taskId === taskId) {
+                    cleanup();
+                    resolve(this.getTask(taskId));
+                }
+            };
+            const onFail = (event) => {
+                if (event.taskId === taskId) {
+                    cleanup();
+                    resolve(this.getTask(taskId));
+                }
+            };
+            const onCancel = (event) => {
+                if (event.taskId === taskId) {
+                    cleanup();
+                    resolve(this.getTask(taskId));
+                }
+            };
+            this.on('task:completed', onComplete);
+            this.on('task:failed', onFail);
+            this.on('task:cancelled', onCancel);
+        });
+    }
+    /**
+     * Get stats
+     */
+    getStats() {
+        let pending = 0;
+        let running = 0;
+        let completed = 0;
+        let failed = 0;
+        let cancelled = 0;
+        for (const task of this.tasks.values()) {
+            switch (task.state) {
+                case 'pending':
+                    pending++;
+                    break;
+                case 'running':
+                    running++;
+                    break;
+                case 'completed':
+                    completed++;
+                    break;
+                case 'failed':
+                    failed++;
+                    break;
+                case 'cancelled':
+                    cancelled++;
+                    break;
+            }
+        }
+        return {
+            totalTasks: this.tasks.size,
+            pendingTasks: pending,
+            runningTasks: running,
+            completedTasks: completed,
+            failedTasks: failed,
+            cancelledTasks: cancelled,
+        };
+    }
+    /**
+     * Start cleanup timer
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanupOldTasks();
+        }, this.options.cleanupInterval);
+    }
+    /**
+     * Cleanup old completed/failed/cancelled tasks
+     */
+    cleanupOldTasks() {
+        const now = Date.now();
+        const toDelete = [];
+        for (const [taskId, task] of this.tasks) {
+            if ((task.state === 'completed' || task.state === 'failed' || task.state === 'cancelled') &&
+                now - task.updatedAt.getTime() > this.options.taskRetentionTime) {
+                toDelete.push(taskId);
+            }
+        }
+        for (const taskId of toDelete) {
+            this.tasks.delete(taskId);
+            this.logger.debug('Task cleaned up', { taskId });
+        }
+        if (toDelete.length > 0) {
+            this.emit('tasks:cleaned', { count: toDelete.length });
+        }
+    }
+    /**
+     * Destroy the task manager
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        // Cancel all running tasks
+        for (const task of this.tasks.values()) {
+            if (task.abortController) {
+                task.abortController.abort('Task manager destroyed');
+            }
+        }
+        this.tasks.clear();
+        this.removeAllListeners();
+        this.logger.debug('Task manager destroyed');
+    }
+}
+export function createTaskManager(logger, options) {
+    return new TaskManager(logger, options);
+}
+//# sourceMappingURL=task-manager.js.map

package/dist/task-manager.js.map

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

package/dist/tool-registry.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @claude-flow/mcp - Tool Registry
+ *
+ * High-performance tool management with O(1) lookup
+ */
+import { EventEmitter } from 'events';
+import type { MCPTool, JSONSchema, ToolHandler, ToolContext, ToolCallResult, ToolRegistrationOptions, ILogger } from './types.js';
+interface ToolMetadata {
+    tool: MCPTool;
+    registeredAt: Date;
+    callCount: number;
+    lastCalled?: Date;
+    avgExecutionTime: number;
+    errorCount: number;
+}
+interface ToolSearchOptions {
+    category?: string;
+    tags?: string[];
+    deprecated?: boolean;
+    cacheable?: boolean;
+}
+export declare class ToolRegistry extends EventEmitter {
+    private readonly logger;
+    private readonly tools;
+    private readonly categoryIndex;
+    private readonly tagIndex;
+    private defaultContext?;
+    private totalRegistrations;
+    private totalLookups;
+    private totalExecutions;
+    constructor(logger: ILogger);
+    register(tool: MCPTool, options?: ToolRegistrationOptions): boolean;
+    registerBatch(tools: MCPTool[], options?: ToolRegistrationOptions): {
+        registered: number;
+        failed: string[];
+    };
+    unregister(name: string): boolean;
+    getTool(name: string): MCPTool | undefined;
+    hasTool(name: string): boolean;
+    getToolCount(): number;
+    getToolNames(): string[];
+    listTools(): Array<{
+        name: string;
+        description: string;
+        category?: string;
+        tags?: string[];
+        deprecated?: boolean;
+    }>;
+    search(options: ToolSearchOptions): MCPTool[];
+    getByCategory(category: string): MCPTool[];
+    getByTag(tag: string): MCPTool[];
+    getCategories(): string[];
+    getTags(): string[];
+    execute(name: string, input: Record<string, unknown>, context?: ToolContext): Promise<ToolCallResult>;
+    setDefaultContext(context: ToolContext): void;
+    getMetadata(name: string): ToolMetadata | undefined;
+    getStats(): {
+        totalTools: number;
+        totalCategories: number;
+        totalTags: number;
+        totalRegistrations: number;
+        totalLookups: number;
+        totalExecutions: number;
+        topTools: Array<{
+            name: string;
+            calls: number;
+        }>;
+    };
+    validateTool(tool: MCPTool): {
+        valid: boolean;
+        errors: string[];
+    };
+    private validateSchema;
+    private updateAverageExecutionTime;
+    clear(): void;
+}
+export declare function createToolRegistry(logger: ILogger): ToolRegistry;
+export declare function defineTool<TInput = Record<string, unknown>, TOutput = unknown>(name: string, description: string, inputSchema: JSONSchema, handler: ToolHandler<TInput, TOutput>, options?: {
+    category?: string;
+    tags?: string[];
+    version?: string;
+    deprecated?: boolean;
+    cacheable?: boolean;
+    cacheTTL?: number;
+    timeout?: number;
+}): MCPTool<TInput, TOutput>;
+export {};
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,OAAO,EACR,MAAM,YAAY,CAAC;AAGpB,UAAU,YAAY;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,YAAa,SAAQ,YAAY;IAUhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwC;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,OAAO,CAAC,cAAc,CAAC,CAAc;IAErC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAK;gBAEC,MAAM,EAAE,OAAO;IAI5C,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO;IAyDvE,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,uBAA4B,GAAG;QACtE,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAwBD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IA+BjC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAK1C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,YAAY,IAAI,MAAM;IAItB,YAAY,IAAI,MAAM,EAAE;IAIxB,SAAS,IAAI,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IAUF,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,EAAE;IA+C7C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAS1C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE;IAShC,aAAa,IAAI,MAAM,EAAE;IAIzB,OAAO,IAAI,MAAM,EAAE;IAIb,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC;IA4E1B,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAI7C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAInD,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClD;IAiBD,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA8BjE,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,0BAA0B;IAMlC,KAAK,IAAI,IAAI;CAOd;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAEhE;AAED,wBAAgB,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAC5E,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,UAAU,EACvB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ1B"}