agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/workers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,0BAA0B,CAAC;AAIzC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,cAAc,EACd,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,WAAW,IAAI,iBAAiB,EAChC,SAAS,EACV,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kCAAkC,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAGzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACxI,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/workers/index.js

@@ -0,0 +1,52 @@
+/**
+ * Background Workers Module
+ * Non-blocking workers triggered by keywords that run silently
+ *
+ * REFACTORED: Consolidated phase system eliminates duplication
+ * - consolidated-phases.ts: Single source of truth for all phases
+ * - phase-executors.ts: Backwards-compatible wrapper + specialized phases
+ * - ruvector-native-integration.ts: Native runner using consolidated phases
+ *
+ * Integrates with RuVector ecosystem:
+ * - SONA: Self-learning trajectory tracking
+ * - ReasoningBank: Pattern storage and retrieval
+ * - HNSW: Vector indexing for semantic search
+ */
+// Core types and modules
+export * from './types.js';
+export * from './trigger-detector.js';
+export * from './worker-registry.js';
+export * from './resource-governor.js';
+export * from './dispatch-service.js';
+export * from './ruvector-integration.js';
+export * from './hooks-integration.js';
+export * from './mcp-tools.js';
+// Consolidated phase system (primary)
+export * from './consolidated-phases.js';
+// Custom worker system (uses consolidated phases)
+// Note: Exclude PhaseResult to avoid conflict with types.ts
+export { DEFAULT_CAPABILITIES, DEFAULT_FILE_FILTER, DEFAULT_OUTPUT, WORKER_PRESETS, EXAMPLE_CONFIG, validateWorkerDefinition } from './custom-worker-config.js';
+// Phase executors - exclude PhaseContext to avoid conflict
+export { createPhaseContext, registerPhaseExecutor, getPhaseExecutor, executePhasePipeline } from './phase-executors.js';
+export * from './custom-worker-factory.js';
+// Worker-Agent integration and benchmarks
+export * from './worker-agent-integration.js';
+export * from './worker-benchmarks.js';
+// RuVector native integration (uses consolidated phases)
+export * from './ruvector-native-integration.js';
+// Re-export singletons
+export { getTriggerDetector } from './trigger-detector.js';
+export { getWorkerRegistry } from './worker-registry.js';
+export { getResourceGovernor } from './resource-governor.js';
+export { getWorkerDispatchService } from './dispatch-service.js';
+export { getRuVectorWorkerIntegration } from './ruvector-integration.js';
+// Re-export custom worker singleton
+export { customWorkerManager } from './custom-worker-factory.js';
+// Re-export integration singletons
+export { workerAgentIntegration, getIntegrationStats, getAgentForTrigger, recordAgentPerformance } from './worker-agent-integration.js';
+export { workerBenchmarks, runBenchmarks } from './worker-benchmarks.js';
+// Re-export useful utilities
+export { formatWorkerInfo, formatPresetList } from './custom-worker-factory.js';
+export { listPhaseExecutors } from './phase-executors.js'; // Dedicated export for this utility
+export { listUnifiedPhases, runUnifiedPipeline } from './consolidated-phases.js';
+//# sourceMappingURL=index.js.map

package/dist/workers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,yBAAyB;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAE/B,sCAAsC;AACtC,cAAc,0BAA0B,CAAC;AAEzC,kDAAkD;AAClD,4DAA4D;AAC5D,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,cAAc,EACd,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAYnC,2DAA2D;AAC3D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,cAAc,4BAA4B,CAAC;AAE3C,0CAA0C;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AAEvC,yDAAyD;AACzD,cAAc,kCAAkC,CAAC;AAEjD,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAEzE,oCAAoC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,mCAAmC;AACnC,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACxI,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEzE,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC,CAAE,oCAAoC;AAChG,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["/**\n * Background Workers Module\n * Non-blocking workers triggered by keywords that run silently\n *\n * REFACTORED: Consolidated phase system eliminates duplication\n * - consolidated-phases.ts: Single source of truth for all phases\n * - phase-executors.ts: Backwards-compatible wrapper + specialized phases\n * - ruvector-native-integration.ts: Native runner using consolidated phases\n *\n * Integrates with RuVector ecosystem:\n * - SONA: Self-learning trajectory tracking\n * - ReasoningBank: Pattern storage and retrieval\n * - HNSW: Vector indexing for semantic search\n */\n\n// Core types and modules\nexport * from './types.js';\nexport * from './trigger-detector.js';\nexport * from './worker-registry.js';\nexport * from './resource-governor.js';\nexport * from './dispatch-service.js';\nexport * from './ruvector-integration.js';\nexport * from './hooks-integration.js';\nexport * from './mcp-tools.js';\n\n// Consolidated phase system (primary)\nexport * from './consolidated-phases.js';\n\n// Custom worker system (uses consolidated phases)\n// Note: Exclude PhaseResult to avoid conflict with types.ts\nexport {\n  DEFAULT_CAPABILITIES,\n  DEFAULT_FILE_FILTER,\n  DEFAULT_OUTPUT,\n  WORKER_PRESETS,\n  EXAMPLE_CONFIG,\n  validateWorkerDefinition\n} from './custom-worker-config.js';\nexport type {\n  PhaseConfig,\n  CustomWorkerDefinition,\n  CapabilityConfig,\n  FileFilterConfig,\n  OutputConfig,\n  WorkerConfigFile,\n  PhaseResult as CustomPhaseResult,\n  PhaseType\n} from './custom-worker-config.js';\n\n// Phase executors - exclude PhaseContext to avoid conflict\nexport {\n  createPhaseContext,\n  registerPhaseExecutor,\n  getPhaseExecutor,\n  executePhasePipeline\n} from './phase-executors.js';\n\nexport * from './custom-worker-factory.js';\n\n// Worker-Agent integration and benchmarks\nexport * from './worker-agent-integration.js';\nexport * from './worker-benchmarks.js';\n\n// RuVector native integration (uses consolidated phases)\nexport * from './ruvector-native-integration.js';\n\n// Re-export singletons\nexport { getTriggerDetector } from './trigger-detector.js';\nexport { getWorkerRegistry } from './worker-registry.js';\nexport { getResourceGovernor } from './resource-governor.js';\nexport { getWorkerDispatchService } from './dispatch-service.js';\nexport { getRuVectorWorkerIntegration } from './ruvector-integration.js';\n\n// Re-export custom worker singleton\nexport { customWorkerManager } from './custom-worker-factory.js';\n\n// Re-export integration singletons\nexport { workerAgentIntegration, getIntegrationStats, getAgentForTrigger, recordAgentPerformance } from './worker-agent-integration.js';\nexport { workerBenchmarks, runBenchmarks } from './worker-benchmarks.js';\n\n// Re-export useful utilities\nexport { formatWorkerInfo, formatPresetList } from './custom-worker-factory.js';\nexport { listPhaseExecutors } from './phase-executors.js';  // Dedicated export for this utility\nexport { listUnifiedPhases, runUnifiedPipeline } from './consolidated-phases.js';\n"]}

package/dist/workers/mcp-tools.d.ts

@@ -0,0 +1,56 @@
+/**
+ * MCP Tools for Background Workers
+ * Exposes worker functionality via MCP protocol
+ */
+interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    execute: (params: Record<string, unknown>, context?: any) => Promise<unknown>;
+}
+/**
+ * Worker dispatch tool
+ */
+export declare const workerDispatchTool: MCPTool;
+/**
+ * Worker status tool
+ */
+export declare const workerStatusTool: MCPTool;
+/**
+ * Worker cancel tool
+ */
+export declare const workerCancelTool: MCPTool;
+/**
+ * Worker triggers list tool
+ */
+export declare const workerTriggersTool: MCPTool;
+/**
+ * Worker results tool
+ */
+export declare const workerResultsTool: MCPTool;
+/**
+ * Worker detect triggers tool
+ */
+export declare const workerDetectTool: MCPTool;
+/**
+ * Worker stats tool
+ */
+export declare const workerStatsTool: MCPTool;
+/**
+ * Worker context inject tool
+ */
+export declare const workerContextTool: MCPTool;
+/**
+ * Get all MCP tools
+ */
+export declare function getWorkerMCPTools(): MCPTool[];
+/**
+ * Register tools with MCP server
+ */
+export declare function registerWorkerTools(server: any): void;
+export {};
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/workers/mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../../src/workers/mcp-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAwChC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAuD9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAyB9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OA2BhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAgD/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OA6B9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAyC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAqE/B,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,EAAE,CAW7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAWrD"}

package/dist/workers/mcp-tools.js

@@ -0,0 +1,359 @@
+/**
+ * MCP Tools for Background Workers
+ * Exposes worker functionality via MCP protocol
+ */
+import { getWorkerDispatchService } from './dispatch-service.js';
+import { getTriggerDetector } from './trigger-detector.js';
+import { getWorkerRegistry } from './worker-registry.js';
+import { getResourceGovernor } from './resource-governor.js';
+/**
+ * Worker dispatch tool
+ */
+export const workerDispatchTool = {
+    name: 'worker_dispatch',
+    description: 'Dispatch a background worker to run silently while conversation continues',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            trigger: {
+                type: 'string',
+                description: 'Worker trigger type',
+                enum: ['ultralearn', 'optimize', 'consolidate', 'predict', 'audit', 'map', 'preload', 'deepdive', 'document', 'refactor', 'benchmark', 'testgaps']
+            },
+            topic: {
+                type: 'string',
+                description: 'Optional topic or focus area for the worker'
+            },
+            sessionId: {
+                type: 'string',
+                description: 'Session identifier'
+            }
+        },
+        required: ['trigger', 'sessionId']
+    },
+    async execute(params) {
+        const { trigger, topic, sessionId } = params;
+        const dispatcher = getWorkerDispatchService();
+        const workerId = await dispatcher.dispatch(trigger, topic || null, sessionId);
+        return {
+            success: true,
+            workerId,
+            trigger,
+            topic,
+            message: `Background worker spawned: ${trigger}${topic ? ` for "${topic}"` : ''}`
+        };
+    }
+};
+/**
+ * Worker status tool
+ */
+export const workerStatusTool = {
+    name: 'worker_status',
+    description: 'Get status of background workers',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workerId: {
+                type: 'string',
+                description: 'Specific worker ID to check (optional)'
+            },
+            sessionId: {
+                type: 'string',
+                description: 'Filter by session ID (optional)'
+            },
+            activeOnly: {
+                type: 'boolean',
+                description: 'Only show active workers'
+            }
+        }
+    },
+    async execute(params) {
+        const { workerId, sessionId, activeOnly } = params;
+        const registry = getWorkerRegistry();
+        const governor = getResourceGovernor();
+        if (workerId) {
+            const worker = registry.get(workerId);
+            if (!worker) {
+                return { success: false, error: 'Worker not found' };
+            }
+            return { success: true, worker };
+        }
+        const workers = activeOnly
+            ? registry.getActive(sessionId)
+            : registry.getAll({ sessionId, limit: 20 });
+        const stats = governor.getStats();
+        const availability = governor.getAvailability();
+        return {
+            success: true,
+            workers,
+            stats: {
+                activeWorkers: stats.activeWorkers,
+                availableSlots: availability.availableSlots,
+                totalSlots: availability.totalSlots
+            }
+        };
+    }
+};
+/**
+ * Worker cancel tool
+ */
+export const workerCancelTool = {
+    name: 'worker_cancel',
+    description: 'Cancel a running background worker',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workerId: {
+                type: 'string',
+                description: 'Worker ID to cancel'
+            }
+        },
+        required: ['workerId']
+    },
+    async execute(params) {
+        const { workerId } = params;
+        const dispatcher = getWorkerDispatchService();
+        const cancelled = dispatcher.cancel(workerId);
+        return {
+            success: cancelled,
+            workerId,
+            message: cancelled ? 'Worker cancelled' : 'Could not cancel worker'
+        };
+    }
+};
+/**
+ * Worker triggers list tool
+ */
+export const workerTriggersTool = {
+    name: 'worker_triggers',
+    description: 'List available background worker triggers and their status',
+    inputSchema: {
+        type: 'object',
+        properties: {}
+    },
+    async execute() {
+        const detector = getTriggerDetector();
+        const configs = detector.getAllConfigs();
+        const stats = detector.getStats();
+        const triggers = Array.from(configs.entries()).map(([keyword, config]) => ({
+            keyword,
+            description: config.description,
+            priority: config.priority,
+            maxAgents: config.maxAgents,
+            timeout: config.timeout,
+            cooldownRemaining: stats.cooldowns[keyword] || 0
+        }));
+        return {
+            success: true,
+            triggers,
+            cooldowns: stats.cooldowns
+        };
+    }
+};
+/**
+ * Worker results tool
+ */
+export const workerResultsTool = {
+    name: 'worker_results',
+    description: 'Get results from a completed background worker',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workerId: {
+                type: 'string',
+                description: 'Worker ID to get results from'
+            }
+        },
+        required: ['workerId']
+    },
+    async execute(params) {
+        const { workerId } = params;
+        const registry = getWorkerRegistry();
+        const worker = registry.get(workerId);
+        if (!worker) {
+            return { success: false, error: 'Worker not found' };
+        }
+        if (worker.status !== 'complete') {
+            return {
+                success: false,
+                status: worker.status,
+                progress: worker.progress,
+                error: 'Worker has not completed yet'
+            };
+        }
+        const metrics = registry.getMetrics(workerId);
+        return {
+            success: true,
+            worker: {
+                id: worker.id,
+                trigger: worker.trigger,
+                topic: worker.topic,
+                status: worker.status,
+                duration: (worker.completedAt - worker.startedAt) / 1000,
+                memoryDeposits: worker.memoryDeposits,
+                resultKeys: worker.resultKeys
+            },
+            metrics
+        };
+    }
+};
+/**
+ * Worker detect triggers tool
+ */
+export const workerDetectTool = {
+    name: 'worker_detect',
+    description: 'Detect background worker triggers in a prompt without dispatching',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            prompt: {
+                type: 'string',
+                description: 'Prompt to analyze for triggers'
+            }
+        },
+        required: ['prompt']
+    },
+    async execute(params) {
+        const { prompt } = params;
+        const detector = getTriggerDetector();
+        const triggers = detector.detect(prompt);
+        return {
+            success: true,
+            hasTriggers: triggers.length > 0,
+            triggers: triggers.map(t => ({
+                keyword: t.keyword,
+                topic: t.topic,
+                priority: t.config.priority
+            }))
+        };
+    }
+};
+/**
+ * Worker stats tool
+ */
+export const workerStatsTool = {
+    name: 'worker_stats',
+    description: 'Get aggregated statistics about background workers',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            timeframe: {
+                type: 'string',
+                description: 'Timeframe for stats',
+                enum: ['1h', '24h', '7d']
+            }
+        }
+    },
+    async execute(params) {
+        const { timeframe = '24h' } = params;
+        const registry = getWorkerRegistry();
+        const governor = getResourceGovernor();
+        const registryStats = registry.getStats(timeframe);
+        const resourceStats = governor.getStats();
+        const availability = governor.getAvailability();
+        return {
+            success: true,
+            timeframe,
+            stats: {
+                total: registryStats.total,
+                byStatus: registryStats.byStatus,
+                byTrigger: registryStats.byTrigger,
+                avgDuration: registryStats.avgDuration,
+                activeWorkers: resourceStats.activeWorkers,
+                memoryUsageMB: resourceStats.memoryUsage.heapUsed / (1024 * 1024),
+                availability: {
+                    used: availability.usedSlots,
+                    available: availability.availableSlots,
+                    total: availability.totalSlots
+                }
+            }
+        };
+    }
+};
+/**
+ * Worker context inject tool
+ */
+export const workerContextTool = {
+    name: 'worker_context',
+    description: 'Get relevant background worker results for context injection',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Query to find relevant worker results'
+            },
+            sessionId: {
+                type: 'string',
+                description: 'Session ID to filter results'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results'
+            }
+        },
+        required: ['query']
+    },
+    async execute(params) {
+        const { query, sessionId, limit = 5 } = params;
+        const registry = getWorkerRegistry();
+        const completed = registry.getAll({
+            sessionId,
+            status: 'complete',
+            limit: 50
+        });
+        // Simple keyword matching
+        const keywords = query.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+        const scored = [];
+        for (const worker of completed) {
+            const workerText = `${worker.trigger} ${worker.topic || ''}`.toLowerCase();
+            let score = 0;
+            for (const keyword of keywords) {
+                if (workerText.includes(keyword)) {
+                    score += 1;
+                }
+            }
+            if (score > 0) {
+                scored.push({ worker, score });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        const relevant = scored.slice(0, limit);
+        return {
+            success: true,
+            results: relevant.map(({ worker, score }) => ({
+                workerId: worker.id,
+                trigger: worker.trigger,
+                topic: worker.topic,
+                relevance: score / Math.max(keywords.length, 1),
+                memoryKeys: worker.resultKeys,
+                completedAt: worker.completedAt
+            }))
+        };
+    }
+};
+/**
+ * Get all MCP tools
+ */
+export function getWorkerMCPTools() {
+    return [
+        workerDispatchTool,
+        workerStatusTool,
+        workerCancelTool,
+        workerTriggersTool,
+        workerResultsTool,
+        workerDetectTool,
+        workerStatsTool,
+        workerContextTool
+    ];
+}
+/**
+ * Register tools with MCP server
+ */
+export function registerWorkerTools(server) {
+    const tools = getWorkerMCPTools();
+    for (const tool of tools) {
+        server.tool(tool.name, tool.description, tool.inputSchema, tool.execute);
+    }
+}
+//# sourceMappingURL=mcp-tools.js.map

package/dist/workers/mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../../src/workers/mcp-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAe7D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAY;IACzC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,2EAA2E;IACxF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;gBAClC,IAAI,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC;aACnJ;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;KACnC;IACD,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAIrC,CAAC;QAEF,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,SAAS,CAAC,CAAC;QAE9E,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,OAAO;YACP,KAAK;YACL,OAAO,EAAE,8BAA8B,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;SAClF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,kCAAkC;IAC/C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0BAA0B;aACxC;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAI3C,CAAC;QAEF,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;QAEvC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;YACvD,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnC,CAAC;QAED,MAAM,OAAO,GAAG,UAAU;YACxB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC;YAC/B,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAE9C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;QAEhD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO;YACP,KAAK,EAAE;gBACL,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,cAAc,EAAE,YAAY,CAAC,cAAc;gBAC3C,UAAU,EAAE,YAAY,CAAC,UAAU;aACpC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,oCAAoC;IACjD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;IACD,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAA8B,CAAC;QAEpD,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE9C,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,QAAQ;YACR,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,yBAAyB;SACpE,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAY;IACzC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,4DAA4D;IACzE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;IACD,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAElC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YACzE,OAAO;YACP,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;SACjD,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAY;IACxC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,gDAAgD;IAC7D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;IACD,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAA8B,CAAC;QAEpD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QACvD,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK,EAAE,8BAA8B;aACtC,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE9C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,CAAC,MAAM,CAAC,WAAY,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;gBACzD,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B;YACD,OAAO;SACR,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,mEAAmE;IAChF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,EAAE,MAAM,EAAE,GAAG,MAA4B,CAAC;QAEhD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEzC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC;YAChC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC3B,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ;aAC5B,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,oDAAoD;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;gBAClC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC;aAC1B;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,MAA6C,CAAC;QAE5E,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;QAEvC,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;QAEhD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS;YACT,KAAK,EAAE;gBACL,KAAK,EAAE,aAAa,CAAC,KAAK;gBAC1B,QAAQ,EAAE,aAAa,CAAC,QAAQ;gBAChC,SAAS,EAAE,aAAa,CAAC,SAAS;gBAClC,WAAW,EAAE,aAAa,CAAC,WAAW;gBACtC,aAAa,EAAE,aAAa,CAAC,aAAa;gBAC1C,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjE,YAAY,EAAE;oBACZ,IAAI,EAAE,YAAY,CAAC,SAAS;oBAC5B,SAAS,EAAE,YAAY,CAAC,cAAc;oBACtC,KAAK,EAAE,YAAY,CAAC,UAAU;iBAC/B;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAY;IACxC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,8DAA8D;IAC3E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,MAIvC,CAAC;QAEF,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC;YAChC,SAAS;YACT,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAiD,EAAE,CAAC;QAEhE,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3E,IAAI,KAAK,GAAG,CAAC,CAAC;YAEd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBACjC,KAAK,IAAI,CAAC,CAAC;gBACb,CAAC;YACH,CAAC;YAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAExC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC5C,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC/C,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,kBAAkB;QAClB,gBAAgB;QAChB,gBAAgB;QAChB,kBAAkB;QAClB,iBAAiB;QACjB,gBAAgB;QAChB,eAAe;QACf,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAW;IAC7C,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,OAAO,CACb,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["/**\n * MCP Tools for Background Workers\n * Exposes worker functionality via MCP protocol\n */\n\nimport { getWorkerDispatchService } from './dispatch-service.js';\nimport { getTriggerDetector } from './trigger-detector.js';\nimport { getWorkerRegistry } from './worker-registry.js';\nimport { getResourceGovernor } from './resource-governor.js';\nimport { WorkerTrigger, WorkerInfo } from './types.js';\n\n// MCP Tool definition interface\ninterface MCPTool {\n  name: string;\n  description: string;\n  inputSchema: {\n    type: 'object';\n    properties: Record<string, unknown>;\n    required?: string[];\n  };\n  execute: (params: Record<string, unknown>, context?: any) => Promise<unknown>;\n}\n\n/**\n * Worker dispatch tool\n */\nexport const workerDispatchTool: MCPTool = {\n  name: 'worker_dispatch',\n  description: 'Dispatch a background worker to run silently while conversation continues',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      trigger: {\n        type: 'string',\n        description: 'Worker trigger type',\n        enum: ['ultralearn', 'optimize', 'consolidate', 'predict', 'audit', 'map', 'preload', 'deepdive', 'document', 'refactor', 'benchmark', 'testgaps']\n      },\n      topic: {\n        type: 'string',\n        description: 'Optional topic or focus area for the worker'\n      },\n      sessionId: {\n        type: 'string',\n        description: 'Session identifier'\n      }\n    },\n    required: ['trigger', 'sessionId']\n  },\n  async execute(params) {\n    const { trigger, topic, sessionId } = params as {\n      trigger: WorkerTrigger;\n      topic?: string;\n      sessionId: string;\n    };\n\n    const dispatcher = getWorkerDispatchService();\n    const workerId = await dispatcher.dispatch(trigger, topic || null, sessionId);\n\n    return {\n      success: true,\n      workerId,\n      trigger,\n      topic,\n      message: `Background worker spawned: ${trigger}${topic ? ` for \"${topic}\"` : ''}`\n    };\n  }\n};\n\n/**\n * Worker status tool\n */\nexport const workerStatusTool: MCPTool = {\n  name: 'worker_status',\n  description: 'Get status of background workers',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      workerId: {\n        type: 'string',\n        description: 'Specific worker ID to check (optional)'\n      },\n      sessionId: {\n        type: 'string',\n        description: 'Filter by session ID (optional)'\n      },\n      activeOnly: {\n        type: 'boolean',\n        description: 'Only show active workers'\n      }\n    }\n  },\n  async execute(params) {\n    const { workerId, sessionId, activeOnly } = params as {\n      workerId?: string;\n      sessionId?: string;\n      activeOnly?: boolean;\n    };\n\n    const registry = getWorkerRegistry();\n    const governor = getResourceGovernor();\n\n    if (workerId) {\n      const worker = registry.get(workerId);\n      if (!worker) {\n        return { success: false, error: 'Worker not found' };\n      }\n      return { success: true, worker };\n    }\n\n    const workers = activeOnly\n      ? registry.getActive(sessionId)\n      : registry.getAll({ sessionId, limit: 20 });\n\n    const stats = governor.getStats();\n    const availability = governor.getAvailability();\n\n    return {\n      success: true,\n      workers,\n      stats: {\n        activeWorkers: stats.activeWorkers,\n        availableSlots: availability.availableSlots,\n        totalSlots: availability.totalSlots\n      }\n    };\n  }\n};\n\n/**\n * Worker cancel tool\n */\nexport const workerCancelTool: MCPTool = {\n  name: 'worker_cancel',\n  description: 'Cancel a running background worker',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      workerId: {\n        type: 'string',\n        description: 'Worker ID to cancel'\n      }\n    },\n    required: ['workerId']\n  },\n  async execute(params) {\n    const { workerId } = params as { workerId: string };\n\n    const dispatcher = getWorkerDispatchService();\n    const cancelled = dispatcher.cancel(workerId);\n\n    return {\n      success: cancelled,\n      workerId,\n      message: cancelled ? 'Worker cancelled' : 'Could not cancel worker'\n    };\n  }\n};\n\n/**\n * Worker triggers list tool\n */\nexport const workerTriggersTool: MCPTool = {\n  name: 'worker_triggers',\n  description: 'List available background worker triggers and their status',\n  inputSchema: {\n    type: 'object',\n    properties: {}\n  },\n  async execute() {\n    const detector = getTriggerDetector();\n    const configs = detector.getAllConfigs();\n    const stats = detector.getStats();\n\n    const triggers = Array.from(configs.entries()).map(([keyword, config]) => ({\n      keyword,\n      description: config.description,\n      priority: config.priority,\n      maxAgents: config.maxAgents,\n      timeout: config.timeout,\n      cooldownRemaining: stats.cooldowns[keyword] || 0\n    }));\n\n    return {\n      success: true,\n      triggers,\n      cooldowns: stats.cooldowns\n    };\n  }\n};\n\n/**\n * Worker results tool\n */\nexport const workerResultsTool: MCPTool = {\n  name: 'worker_results',\n  description: 'Get results from a completed background worker',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      workerId: {\n        type: 'string',\n        description: 'Worker ID to get results from'\n      }\n    },\n    required: ['workerId']\n  },\n  async execute(params) {\n    const { workerId } = params as { workerId: string };\n\n    const registry = getWorkerRegistry();\n    const worker = registry.get(workerId);\n\n    if (!worker) {\n      return { success: false, error: 'Worker not found' };\n    }\n\n    if (worker.status !== 'complete') {\n      return {\n        success: false,\n        status: worker.status,\n        progress: worker.progress,\n        error: 'Worker has not completed yet'\n      };\n    }\n\n    const metrics = registry.getMetrics(workerId);\n\n    return {\n      success: true,\n      worker: {\n        id: worker.id,\n        trigger: worker.trigger,\n        topic: worker.topic,\n        status: worker.status,\n        duration: (worker.completedAt! - worker.startedAt) / 1000,\n        memoryDeposits: worker.memoryDeposits,\n        resultKeys: worker.resultKeys\n      },\n      metrics\n    };\n  }\n};\n\n/**\n * Worker detect triggers tool\n */\nexport const workerDetectTool: MCPTool = {\n  name: 'worker_detect',\n  description: 'Detect background worker triggers in a prompt without dispatching',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      prompt: {\n        type: 'string',\n        description: 'Prompt to analyze for triggers'\n      }\n    },\n    required: ['prompt']\n  },\n  async execute(params) {\n    const { prompt } = params as { prompt: string };\n\n    const detector = getTriggerDetector();\n    const triggers = detector.detect(prompt);\n\n    return {\n      success: true,\n      hasTriggers: triggers.length > 0,\n      triggers: triggers.map(t => ({\n        keyword: t.keyword,\n        topic: t.topic,\n        priority: t.config.priority\n      }))\n    };\n  }\n};\n\n/**\n * Worker stats tool\n */\nexport const workerStatsTool: MCPTool = {\n  name: 'worker_stats',\n  description: 'Get aggregated statistics about background workers',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      timeframe: {\n        type: 'string',\n        description: 'Timeframe for stats',\n        enum: ['1h', '24h', '7d']\n      }\n    }\n  },\n  async execute(params) {\n    const { timeframe = '24h' } = params as { timeframe?: '1h' | '24h' | '7d' };\n\n    const registry = getWorkerRegistry();\n    const governor = getResourceGovernor();\n\n    const registryStats = registry.getStats(timeframe);\n    const resourceStats = governor.getStats();\n    const availability = governor.getAvailability();\n\n    return {\n      success: true,\n      timeframe,\n      stats: {\n        total: registryStats.total,\n        byStatus: registryStats.byStatus,\n        byTrigger: registryStats.byTrigger,\n        avgDuration: registryStats.avgDuration,\n        activeWorkers: resourceStats.activeWorkers,\n        memoryUsageMB: resourceStats.memoryUsage.heapUsed / (1024 * 1024),\n        availability: {\n          used: availability.usedSlots,\n          available: availability.availableSlots,\n          total: availability.totalSlots\n        }\n      }\n    };\n  }\n};\n\n/**\n * Worker context inject tool\n */\nexport const workerContextTool: MCPTool = {\n  name: 'worker_context',\n  description: 'Get relevant background worker results for context injection',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      query: {\n        type: 'string',\n        description: 'Query to find relevant worker results'\n      },\n      sessionId: {\n        type: 'string',\n        description: 'Session ID to filter results'\n      },\n      limit: {\n        type: 'number',\n        description: 'Maximum number of results'\n      }\n    },\n    required: ['query']\n  },\n  async execute(params) {\n    const { query, sessionId, limit = 5 } = params as {\n      query: string;\n      sessionId?: string;\n      limit?: number;\n    };\n\n    const registry = getWorkerRegistry();\n    const completed = registry.getAll({\n      sessionId,\n      status: 'complete',\n      limit: 50\n    });\n\n    // Simple keyword matching\n    const keywords = query.toLowerCase().split(/\\s+/).filter(w => w.length > 3);\n    const scored: Array<{ worker: WorkerInfo; score: number }> = [];\n\n    for (const worker of completed) {\n      const workerText = `${worker.trigger} ${worker.topic || ''}`.toLowerCase();\n      let score = 0;\n\n      for (const keyword of keywords) {\n        if (workerText.includes(keyword)) {\n          score += 1;\n        }\n      }\n\n      if (score > 0) {\n        scored.push({ worker, score });\n      }\n    }\n\n    scored.sort((a, b) => b.score - a.score);\n    const relevant = scored.slice(0, limit);\n\n    return {\n      success: true,\n      results: relevant.map(({ worker, score }) => ({\n        workerId: worker.id,\n        trigger: worker.trigger,\n        topic: worker.topic,\n        relevance: score / Math.max(keywords.length, 1),\n        memoryKeys: worker.resultKeys,\n        completedAt: worker.completedAt\n      }))\n    };\n  }\n};\n\n/**\n * Get all MCP tools\n */\nexport function getWorkerMCPTools(): MCPTool[] {\n  return [\n    workerDispatchTool,\n    workerStatusTool,\n    workerCancelTool,\n    workerTriggersTool,\n    workerResultsTool,\n    workerDetectTool,\n    workerStatsTool,\n    workerContextTool\n  ];\n}\n\n/**\n * Register tools with MCP server\n */\nexport function registerWorkerTools(server: any): void {\n  const tools = getWorkerMCPTools();\n\n  for (const tool of tools) {\n    server.tool(\n      tool.name,\n      tool.description,\n      tool.inputSchema,\n      tool.execute\n    );\n  }\n}\n"]}

package/dist/workers/phase-executors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Phase Executors - Composable analysis phases for custom workers
+ *
+ * REFACTORED: Core phases are now in consolidated-phases.ts to eliminate duplication.
+ * This module provides backwards compatibility and additional specialized phases.
+ */
+import { WorkerContext } from './types.js';
+import { PhaseConfig, PhaseResult } from './custom-worker-config.js';
+import { UnifiedPhaseContext, createUnifiedContext } from './consolidated-phases.js';
+export type PhaseContext = UnifiedPhaseContext;
+export declare const createPhaseContext: typeof createUnifiedContext;
+export type PhaseExecutor = (workerContext: WorkerContext, phaseContext: PhaseContext, options: Record<string, unknown>) => Promise<PhaseResult>;
+export declare function registerPhaseExecutor(type: string, executor: PhaseExecutor): void;
+export declare function getPhaseExecutor(type: string): PhaseExecutor | undefined;
+export declare function listPhaseExecutors(): string[];
+export declare function executePhasePipeline(workerContext: WorkerContext, phases: PhaseConfig[], onProgress?: (phase: string, progress: number) => void): Promise<{
+    success: boolean;
+    phaseContext: PhaseContext;
+    results: Map<string, PhaseResult>;
+    errors: string[];
+}>;
+//# sourceMappingURL=phase-executors.d.ts.map

package/dist/workers/phase-executors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-executors.d.ts","sourceRoot":"","sources":["../../src/workers/phase-executors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EAGrB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAC/C,eAAO,MAAM,kBAAkB,6BAAuB,CAAC;AAMvD,MAAM,MAAM,aAAa,GAAG,CAC1B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,WAAW,CAAC,CAAC;AAI1B,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAEjF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAMxE;AAED,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAI7C;AA2bD,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,WAAW,EAAE,EACrB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GACrD,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAwDD"}