agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/mcp/fastmcp/tools/agent/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../../../src/mcp/fastmcp/tools/agent/list.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { ToolDefinition, ToolContext } from '../../types/index.js';\nimport { execSync } from 'child_process';\n\nconst listAgentsSchema = z.object({\n  format: z.enum(['summary', 'detailed', 'json']).optional().default('summary')\n    .describe('Output format for agent list')\n});\n\nexport const listAgentsTool: ToolDefinition = {\n  name: 'agent_list',\n  description: 'List all available agents (equivalent to --list CLI command)',\n  parameters: listAgentsSchema,\n\n  async execute({ format }: z.infer<typeof listAgentsSchema>, { onProgress }: ToolContext) {\n    try {\n      onProgress?.({ progress: 0.3, message: 'Loading available agents...' });\n\n      // Execute list command\n      const result = execSync('npx agentic-flow --list', {\n        encoding: 'utf8',\n        maxBuffer: 5 * 1024 * 1024,\n        timeout: 30000\n      });\n\n      onProgress?.({ progress: 0.8, message: 'Processing agent list...' });\n\n      // Parse the output to extract agent info\n      const agents: any[] = [];\n      const lines = result.split('\\n');\n\n      let currentCategory = '';\n      for (const line of lines) {\n        if (line.includes(':') && line.trim().endsWith(':')) {\n          currentCategory = line.replace(':', '').trim();\n        } else if (line.trim().startsWith('•') || /^\\s{2,}\\w/.test(line)) {\n          const match = line.match(/^\\s*[•\\s]*(\\S+)\\s+(.+)$/);\n          if (match) {\n            agents.push({\n              name: match[1],\n              description: match[2].trim(),\n              category: currentCategory\n            });\n          }\n        }\n      }\n\n      onProgress?.({ progress: 1.0, message: `Found ${agents.length} agents` });\n\n      let output;\n      if (format === 'json') {\n        output = JSON.stringify({ agents, count: agents.length }, null, 2);\n      } else if (format === 'detailed') {\n        output = result;\n      } else {\n        output = JSON.stringify({\n          success: true,\n          count: agents.length,\n          agents: agents.map(a => ({\n            name: a.name,\n            category: a.category,\n            description: a.description.substring(0, 100) + (a.description.length > 100 ? '...' : '')\n          })),\n          timestamp: new Date().toISOString()\n        }, null, 2);\n      }\n\n      return {\n        content: [{\n          type: 'text',\n          text: output\n        }]\n      };\n    } catch (error: any) {\n      return {\n        content: [{\n          type: 'text',\n          text: JSON.stringify({\n            success: false,\n            error: error.message,\n            stderr: error.stderr?.toString(),\n            timestamp: new Date().toISOString()\n          }, null, 2)\n        }],\n        isError: true\n      };\n    }\n  }\n};\n"]}

package/dist/agentic-flow/src/mcp/fastmcp/tools/agent/parallel.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../../types/index.js';
+export declare const parallelModeTool: ToolDefinition;
+//# sourceMappingURL=parallel.d.ts.map

package/dist/agentic-flow/src/mcp/fastmcp/tools/agent/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../../../../../src/mcp/fastmcp/tools/agent/parallel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAe,MAAM,sBAAsB,CAAC;AAUnE,eAAO,MAAM,gBAAgB,EAAE,cA2D9B,CAAC"}

package/dist/agentic-flow/src/mcp/fastmcp/tools/agent/parallel.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import { execSync } from 'child_process';
+const parallelModeSchema = z.object({
+    topic: z.string().optional().describe('Research topic for parallel mode'),
+    diff: z.string().optional().describe('Code diff for review'),
+    dataset: z.string().optional().describe('Dataset hint for analysis'),
+    streaming: z.boolean().optional().default(false).describe('Enable streaming output')
+});
+export const parallelModeTool = {
+    name: 'agent_parallel',
+    description: 'Run parallel mode with 3 agents (research, code review, data analysis)',
+    parameters: parallelModeSchema,
+    async execute({ topic, diff, dataset, streaming }, { onProgress }) {
+        try {
+            onProgress?.({ progress: 0.1, message: 'Starting parallel agent execution' });
+            // Set environment variables
+            const env = {
+                ...process.env,
+                ...(topic && { TOPIC: topic }),
+                ...(diff && { DIFF: diff }),
+                ...(dataset && { DATASET: dataset }),
+                ...(streaming && { ENABLE_STREAMING: 'true' })
+            };
+            onProgress?.({ progress: 0.3, message: 'Executing 3 agents in parallel...' });
+            // Execute parallel mode
+            const result = execSync('npx agentic-flow', {
+                encoding: 'utf8',
+                maxBuffer: 10 * 1024 * 1024,
+                timeout: 300000,
+                env
+            });
+            onProgress?.({ progress: 1.0, message: 'Parallel execution completed' });
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            mode: 'parallel',
+                            agents: ['research', 'code_review', 'data'],
+                            config: { topic, diff, dataset, streaming },
+                            output: result,
+                            timestamp: new Date().toISOString()
+                        }, null, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            mode: 'parallel',
+                            error: error.message,
+                            stderr: error.stderr?.toString(),
+                            timestamp: new Date().toISOString()
+                        }, null, 2)
+                    }],
+                isError: true
+            };
+        }
+    }
+};
+//# sourceMappingURL=parallel.js.map

package/dist/agentic-flow/src/mcp/fastmcp/tools/agent/parallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.js","sourceRoot":"","sources":["../../../../../../../src/mcp/fastmcp/tools/agent/parallel.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { ToolDefinition, ToolContext } from '../../types/index.js';\nimport { execSync } from 'child_process';\n\nconst parallelModeSchema = z.object({\n  topic: z.string().optional().describe('Research topic for parallel mode'),\n  diff: z.string().optional().describe('Code diff for review'),\n  dataset: z.string().optional().describe('Dataset hint for analysis'),\n  streaming: z.boolean().optional().default(false).describe('Enable streaming output')\n});\n\nexport const parallelModeTool: ToolDefinition = {\n  name: 'agent_parallel',\n  description: 'Run parallel mode with 3 agents (research, code review, data analysis)',\n  parameters: parallelModeSchema,\n\n  async execute({ topic, diff, dataset, streaming }: z.infer<typeof parallelModeSchema>, { onProgress }: ToolContext) {\n    try {\n      onProgress?.({ progress: 0.1, message: 'Starting parallel agent execution' });\n\n      // Set environment variables\n      const env = {\n        ...process.env,\n        ...(topic && { TOPIC: topic }),\n        ...(diff && { DIFF: diff }),\n        ...(dataset && { DATASET: dataset }),\n        ...(streaming && { ENABLE_STREAMING: 'true' })\n      };\n\n      onProgress?.({ progress: 0.3, message: 'Executing 3 agents in parallel...' });\n\n      // Execute parallel mode\n      const result = execSync('npx agentic-flow', {\n        encoding: 'utf8',\n        maxBuffer: 10 * 1024 * 1024,\n        timeout: 300000,\n        env\n      });\n\n      onProgress?.({ progress: 1.0, message: 'Parallel execution completed' });\n\n      return {\n        content: [{\n          type: 'text',\n          text: JSON.stringify({\n            success: true,\n            mode: 'parallel',\n            agents: ['research', 'code_review', 'data'],\n            config: { topic, diff, dataset, streaming },\n            output: result,\n            timestamp: new Date().toISOString()\n          }, null, 2)\n        }]\n      };\n    } catch (error: any) {\n      return {\n        content: [{\n          type: 'text',\n          text: JSON.stringify({\n            success: false,\n            mode: 'parallel',\n            error: error.message,\n            stderr: error.stderr?.toString(),\n            timestamp: new Date().toISOString()\n          }, null, 2)\n        }],\n        isError: true\n      };\n    }\n  }\n};\n"]}

package/dist/agentic-flow/src/mcp/fastmcp/tools/attention-tools.d.ts

@@ -0,0 +1,2 @@
+export declare function registerAttentionTools(server: any): void;
+//# sourceMappingURL=attention-tools.d.ts.map

package/dist/agentic-flow/src/mcp/fastmcp/tools/attention-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention-tools.d.ts","sourceRoot":"","sources":["../../../../../../src/mcp/fastmcp/tools/attention-tools.ts"],"names":[],"mappings":"AAcA,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAyTxD"}

package/dist/agentic-flow/src/mcp/fastmcp/tools/attention-tools.js

@@ -0,0 +1,313 @@
+/**
+ * Attention MCP Tools - Expose AttentionService via MCP
+ *
+ * Provides 6 tools:
+ * 1. attention_search - Semantic search with attention-enhanced relevance
+ * 2. attention_focus - Multi-head attention on context + memories
+ * 3. attention_stats - Attention mechanism usage statistics
+ * 4. attention_flash - Flash Attention (7.47x speedup) [ADR-064]
+ * 5. attention_multihead - Multi-Head Attention (5x relevance) [ADR-064]
+ * 6. attention_moe - Mixture of Experts dynamic routing [ADR-064]
+ */
+import { z } from 'zod';
+import { AgentDBService } from '../../../services/agentdb-service.js';
+export function registerAttentionTools(server) {
+    // Tool 1: attention_search - Semantic search with attention-enhanced relevance
+    server.addTool({
+        name: 'attention_search',
+        description: 'Semantic search with attention-enhanced relevance scoring. Uses multi-head attention to weight results by contextual importance.',
+        parameters: z.object({
+            query: z.string().min(1).describe('Search query'),
+            namespace: z.string().optional().describe('Memory namespace to search within'),
+            topK: z.number().min(1).max(100).optional().default(10).describe('Number of results (1-100)'),
+            useMultiHead: z.boolean().optional().default(true).describe('Use multi-head attention for better relevance'),
+        }),
+        execute: async ({ query, namespace, topK, useMultiHead }) => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                const attention = svc.getAttentionService();
+                if (!attention) {
+                    // Fallback: use standard episode recall when AttentionService unavailable
+                    const episodes = await svc.recallEpisodes(query, topK);
+                    return JSON.stringify({
+                        success: true,
+                        data: {
+                            query,
+                            count: episodes.length,
+                            results: episodes,
+                            engine: 'fallback',
+                            attentionAvailable: false,
+                        },
+                        timestamp: new Date().toISOString(),
+                    }, null, 2);
+                }
+                // Use AttentionService for enhanced search
+                const searchOpts = { topK };
+                if (namespace)
+                    searchOpts.namespace = namespace;
+                if (useMultiHead)
+                    searchOpts.useMultiHead = true;
+                let results;
+                try {
+                    results = await attention.search(query, searchOpts);
+                }
+                catch {
+                    // If attention search fails, fallback to standard recall
+                    results = await svc.recallEpisodes(query, topK);
+                }
+                return JSON.stringify({
+                    success: true,
+                    data: {
+                        query,
+                        count: results.length,
+                        results,
+                        engine: attention.getEngineType?.() || 'js',
+                        attentionAvailable: true,
+                    },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({
+                    success: false,
+                    error: error.message,
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+        },
+    });
+    // Tool 2: attention_focus - Apply multi-head attention to context
+    server.addTool({
+        name: 'attention_focus',
+        description: 'Apply multi-head attention to a context string against a set of memory keys. Returns attention-weighted relevance scores for focused retrieval.',
+        parameters: z.object({
+            context: z.string().min(1).describe('Context string to focus on'),
+            memories: z.array(z.string()).min(1).describe('Memory keys or content strings to attend to'),
+            heads: z.number().min(1).max(16).optional().default(8).describe('Number of attention heads (1-16)'),
+        }),
+        execute: async ({ context, memories, heads }) => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                const attention = svc.getAttentionService();
+                if (!attention) {
+                    // Fallback: uniform attention scores
+                    const uniformScore = 1.0 / memories.length;
+                    return JSON.stringify({
+                        success: true,
+                        data: {
+                            context: context.substring(0, 200),
+                            memoriesCount: memories.length,
+                            heads,
+                            scores: memories.map((mem, i) => ({
+                                index: i,
+                                key: mem.substring(0, 100),
+                                score: uniformScore,
+                            })),
+                            engine: 'fallback',
+                            attentionAvailable: false,
+                        },
+                        timestamp: new Date().toISOString(),
+                    }, null, 2);
+                }
+                let scores;
+                try {
+                    scores = await attention.focus(context, memories, heads);
+                }
+                catch {
+                    // Fallback on focus failure
+                    const uniformScore = 1.0 / memories.length;
+                    scores = memories.map((_, i) => ({ index: i, score: uniformScore }));
+                }
+                return JSON.stringify({
+                    success: true,
+                    data: {
+                        context: context.substring(0, 200),
+                        memoriesCount: memories.length,
+                        heads,
+                        scores,
+                        engine: attention.getEngineType?.() || 'js',
+                        attentionAvailable: true,
+                    },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({
+                    success: false,
+                    error: error.message,
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+        },
+    });
+    // Tool 3: attention_stats - Get attention mechanism usage statistics
+    server.addTool({
+        name: 'attention_stats',
+        description: 'Get attention mechanism usage statistics including operation counts, execution times, and engine type (WASM/JS)',
+        parameters: z.object({}),
+        execute: async () => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                const attention = svc.getAttentionService();
+                const attentionStats = svc.getAttentionStats();
+                const wasmStats = svc.getWASMStats();
+                return JSON.stringify({
+                    success: true,
+                    data: {
+                        available: attention !== null && attention !== undefined,
+                        engine: attention?.getEngineType?.() || 'none',
+                        attention: attentionStats,
+                        wasm: wasmStats,
+                    },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({
+                    success: false,
+                    error: error.message,
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+        },
+    });
+    // -- ADR-064 Phase 1: Native Flash Attention MCP Tools ----------------------
+    // Tool 4: attention_flash - Apply Flash Attention (7.47x faster)
+    server.addTool({
+        name: 'attention_flash',
+        description: 'Apply Flash Attention to query against context vectors. 7.47x faster with native bindings, automatic JS fallback.',
+        parameters: z.object({
+            query: z.array(z.number()).min(1).describe('Query vector (number[])'),
+            context: z.array(z.array(z.number())).min(1).describe('Context vectors (number[][])'),
+            heads: z.number().min(1).max(32).optional().default(8).describe('Number of attention heads (default: 8)'),
+        }),
+        execute: async ({ query, context, heads }) => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                const attention = svc.getAttentionService();
+                if (!attention) {
+                    return JSON.stringify({
+                        success: false,
+                        error: 'AttentionService not available',
+                        timestamp: new Date().toISOString(),
+                    }, null, 2);
+                }
+                const startMs = Date.now();
+                const result = await attention.applyFlashAttention(query, context, context, { headCount: heads });
+                const elapsedMs = Date.now() - startMs;
+                return JSON.stringify({
+                    success: true,
+                    data: {
+                        attention: result,
+                        dimensions: result.length,
+                        elapsedMs,
+                        engine: attention.getEngineType?.() || 'fallback',
+                        mechanism: 'flash',
+                    },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({
+                    success: false,
+                    error: error.message,
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+        },
+    });
+    // Tool 5: attention_multihead - Multi-Head Attention (5x relevance)
+    server.addTool({
+        name: 'attention_multihead',
+        description: 'Apply Multi-Head Attention for 5x better relevance scoring. Returns attention output and per-head weight matrix.',
+        parameters: z.object({
+            query: z.array(z.number()).min(1).describe('Query vector (number[])'),
+            context: z.array(z.array(z.number())).min(1).describe('Context vectors (number[][])'),
+            heads: z.number().min(1).max(32).optional().default(8).describe('Number of attention heads (default: 8)'),
+        }),
+        execute: async ({ query, context, heads }) => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                const attention = svc.getAttentionService();
+                if (!attention) {
+                    return JSON.stringify({
+                        success: false,
+                        error: 'AttentionService not available',
+                        timestamp: new Date().toISOString(),
+                    }, null, 2);
+                }
+                const startMs = Date.now();
+                const result = await attention.applyMultiHeadAttention(query, context, heads);
+                const elapsedMs = Date.now() - startMs;
+                return JSON.stringify({
+                    success: true,
+                    data: {
+                        attention: result.attention,
+                        weights: result.weights,
+                        heads,
+                        contextSize: context.length,
+                        elapsedMs,
+                        engine: attention.getEngineType?.() || 'fallback',
+                        mechanism: 'multi-head',
+                    },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({
+                    success: false,
+                    error: error.message,
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+        },
+    });
+    // Tool 6: attention_moe - Mixture of Experts dynamic routing
+    server.addTool({
+        name: 'attention_moe',
+        description: 'Apply Mixture of Experts for dynamic routing. Routes input to top-K expert models and returns weighted output.',
+        parameters: z.object({
+            input: z.array(z.number()).min(1).describe('Input vector (number[])'),
+            experts: z.number().min(2).max(64).describe('Number of expert models'),
+            topK: z.number().min(1).max(16).optional().default(2).describe('Top-K experts to activate (default: 2)'),
+        }),
+        execute: async ({ input, experts, topK }) => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                const attention = svc.getAttentionService();
+                if (!attention) {
+                    return JSON.stringify({
+                        success: false,
+                        error: 'AttentionService not available',
+                        timestamp: new Date().toISOString(),
+                    }, null, 2);
+                }
+                const startMs = Date.now();
+                const result = await attention.applyMoE(input, experts, topK);
+                const elapsedMs = Date.now() - startMs;
+                return JSON.stringify({
+                    success: true,
+                    data: {
+                        output: result.output,
+                        expertWeights: result.expertWeights,
+                        experts,
+                        topK,
+                        activeExperts: result.expertWeights.filter((w) => w > 0).length,
+                        elapsedMs,
+                        engine: attention.getEngineType?.() || 'fallback',
+                        mechanism: 'moe',
+                    },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({
+                    success: false,
+                    error: error.message,
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+        },
+    });
+}
+//# sourceMappingURL=attention-tools.js.map

package/dist/agentic-flow/src/mcp/fastmcp/tools/attention-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention-tools.js","sourceRoot":"","sources":["../../../../../../src/mcp/fastmcp/tools/attention-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Attention MCP Tools - Expose AttentionService via MCP\n *\n * Provides 6 tools:\n * 1. attention_search - Semantic search with attention-enhanced relevance\n * 2. attention_focus - Multi-head attention on context + memories\n * 3. attention_stats - Attention mechanism usage statistics\n * 4. attention_flash - Flash Attention (7.47x speedup) [ADR-064]\n * 5. attention_multihead - Multi-Head Attention (5x relevance) [ADR-064]\n * 6. attention_moe - Mixture of Experts dynamic routing [ADR-064]\n */\nimport { z } from 'zod';\nimport { AgentDBService } from '../../../services/agentdb-service.js';\n\nexport function registerAttentionTools(server: any): void {\n  // Tool 1: attention_search - Semantic search with attention-enhanced relevance\n  server.addTool({\n    name: 'attention_search',\n    description: 'Semantic search with attention-enhanced relevance scoring. Uses multi-head attention to weight results by contextual importance.',\n    parameters: z.object({\n      query: z.string().min(1).describe('Search query'),\n      namespace: z.string().optional().describe('Memory namespace to search within'),\n      topK: z.number().min(1).max(100).optional().default(10).describe('Number of results (1-100)'),\n      useMultiHead: z.boolean().optional().default(true).describe('Use multi-head attention for better relevance'),\n    }),\n    execute: async ({ query, namespace, topK, useMultiHead }: { query: string; namespace?: string; topK: number; useMultiHead: boolean }) => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        const attention = svc.getAttentionService();\n\n        if (!attention) {\n          // Fallback: use standard episode recall when AttentionService unavailable\n          const episodes = await svc.recallEpisodes(query, topK);\n          return JSON.stringify({\n            success: true,\n            data: {\n              query,\n              count: episodes.length,\n              results: episodes,\n              engine: 'fallback',\n              attentionAvailable: false,\n            },\n            timestamp: new Date().toISOString(),\n          }, null, 2);\n        }\n\n        // Use AttentionService for enhanced search\n        const searchOpts: any = { topK };\n        if (namespace) searchOpts.namespace = namespace;\n        if (useMultiHead) searchOpts.useMultiHead = true;\n\n        let results: any[];\n        try {\n          results = await attention.search(query, searchOpts);\n        } catch {\n          // If attention search fails, fallback to standard recall\n          results = await svc.recallEpisodes(query, topK);\n        }\n\n        return JSON.stringify({\n          success: true,\n          data: {\n            query,\n            count: results.length,\n            results,\n            engine: attention.getEngineType?.() || 'js',\n            attentionAvailable: true,\n          },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      }\n    },\n  });\n\n  // Tool 2: attention_focus - Apply multi-head attention to context\n  server.addTool({\n    name: 'attention_focus',\n    description: 'Apply multi-head attention to a context string against a set of memory keys. Returns attention-weighted relevance scores for focused retrieval.',\n    parameters: z.object({\n      context: z.string().min(1).describe('Context string to focus on'),\n      memories: z.array(z.string()).min(1).describe('Memory keys or content strings to attend to'),\n      heads: z.number().min(1).max(16).optional().default(8).describe('Number of attention heads (1-16)'),\n    }),\n    execute: async ({ context, memories, heads }: { context: string; memories: string[]; heads: number }) => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        const attention = svc.getAttentionService();\n\n        if (!attention) {\n          // Fallback: uniform attention scores\n          const uniformScore = 1.0 / memories.length;\n          return JSON.stringify({\n            success: true,\n            data: {\n              context: context.substring(0, 200),\n              memoriesCount: memories.length,\n              heads,\n              scores: memories.map((mem, i) => ({\n                index: i,\n                key: mem.substring(0, 100),\n                score: uniformScore,\n              })),\n              engine: 'fallback',\n              attentionAvailable: false,\n            },\n            timestamp: new Date().toISOString(),\n          }, null, 2);\n        }\n\n        let scores: any;\n        try {\n          scores = await attention.focus(context, memories, heads);\n        } catch {\n          // Fallback on focus failure\n          const uniformScore = 1.0 / memories.length;\n          scores = memories.map((_: string, i: number) => ({ index: i, score: uniformScore }));\n        }\n\n        return JSON.stringify({\n          success: true,\n          data: {\n            context: context.substring(0, 200),\n            memoriesCount: memories.length,\n            heads,\n            scores,\n            engine: attention.getEngineType?.() || 'js',\n            attentionAvailable: true,\n          },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      }\n    },\n  });\n\n  // Tool 3: attention_stats - Get attention mechanism usage statistics\n  server.addTool({\n    name: 'attention_stats',\n    description: 'Get attention mechanism usage statistics including operation counts, execution times, and engine type (WASM/JS)',\n    parameters: z.object({}),\n    execute: async () => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        const attention = svc.getAttentionService();\n        const attentionStats = svc.getAttentionStats();\n        const wasmStats = svc.getWASMStats();\n\n        return JSON.stringify({\n          success: true,\n          data: {\n            available: attention !== null && attention !== undefined,\n            engine: attention?.getEngineType?.() || 'none',\n            attention: attentionStats,\n            wasm: wasmStats,\n          },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      }\n    },\n  });\n\n  // -- ADR-064 Phase 1: Native Flash Attention MCP Tools ----------------------\n\n  // Tool 4: attention_flash - Apply Flash Attention (7.47x faster)\n  server.addTool({\n    name: 'attention_flash',\n    description: 'Apply Flash Attention to query against context vectors. 7.47x faster with native bindings, automatic JS fallback.',\n    parameters: z.object({\n      query: z.array(z.number()).min(1).describe('Query vector (number[])'),\n      context: z.array(z.array(z.number())).min(1).describe('Context vectors (number[][])'),\n      heads: z.number().min(1).max(32).optional().default(8).describe('Number of attention heads (default: 8)'),\n    }),\n    execute: async ({ query, context, heads }: { query: number[]; context: number[][]; heads: number }) => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        const attention = svc.getAttentionService();\n\n        if (!attention) {\n          return JSON.stringify({\n            success: false,\n            error: 'AttentionService not available',\n            timestamp: new Date().toISOString(),\n          }, null, 2);\n        }\n\n        const startMs = Date.now();\n        const result = await attention.applyFlashAttention(\n          query, context, context, { headCount: heads }\n        );\n        const elapsedMs = Date.now() - startMs;\n\n        return JSON.stringify({\n          success: true,\n          data: {\n            attention: result,\n            dimensions: result.length,\n            elapsedMs,\n            engine: attention.getEngineType?.() || 'fallback',\n            mechanism: 'flash',\n          },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      }\n    },\n  });\n\n  // Tool 5: attention_multihead - Multi-Head Attention (5x relevance)\n  server.addTool({\n    name: 'attention_multihead',\n    description: 'Apply Multi-Head Attention for 5x better relevance scoring. Returns attention output and per-head weight matrix.',\n    parameters: z.object({\n      query: z.array(z.number()).min(1).describe('Query vector (number[])'),\n      context: z.array(z.array(z.number())).min(1).describe('Context vectors (number[][])'),\n      heads: z.number().min(1).max(32).optional().default(8).describe('Number of attention heads (default: 8)'),\n    }),\n    execute: async ({ query, context, heads }: { query: number[]; context: number[][]; heads: number }) => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        const attention = svc.getAttentionService();\n\n        if (!attention) {\n          return JSON.stringify({\n            success: false,\n            error: 'AttentionService not available',\n            timestamp: new Date().toISOString(),\n          }, null, 2);\n        }\n\n        const startMs = Date.now();\n        const result = await attention.applyMultiHeadAttention(query, context, heads);\n        const elapsedMs = Date.now() - startMs;\n\n        return JSON.stringify({\n          success: true,\n          data: {\n            attention: result.attention,\n            weights: result.weights,\n            heads,\n            contextSize: context.length,\n            elapsedMs,\n            engine: attention.getEngineType?.() || 'fallback',\n            mechanism: 'multi-head',\n          },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      }\n    },\n  });\n\n  // Tool 6: attention_moe - Mixture of Experts dynamic routing\n  server.addTool({\n    name: 'attention_moe',\n    description: 'Apply Mixture of Experts for dynamic routing. Routes input to top-K expert models and returns weighted output.',\n    parameters: z.object({\n      input: z.array(z.number()).min(1).describe('Input vector (number[])'),\n      experts: z.number().min(2).max(64).describe('Number of expert models'),\n      topK: z.number().min(1).max(16).optional().default(2).describe('Top-K experts to activate (default: 2)'),\n    }),\n    execute: async ({ input, experts, topK }: { input: number[]; experts: number; topK: number }) => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        const attention = svc.getAttentionService();\n\n        if (!attention) {\n          return JSON.stringify({\n            success: false,\n            error: 'AttentionService not available',\n            timestamp: new Date().toISOString(),\n          }, null, 2);\n        }\n\n        const startMs = Date.now();\n        const result = await attention.applyMoE(input, experts, topK);\n        const elapsedMs = Date.now() - startMs;\n\n        return JSON.stringify({\n          success: true,\n          data: {\n            output: result.output,\n            expertWeights: result.expertWeights,\n            experts,\n            topK,\n            activeExperts: result.expertWeights.filter((w: number) => w > 0).length,\n            elapsedMs,\n            engine: attention.getEngineType?.() || 'fallback',\n            mechanism: 'moe',\n          },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      }\n    },\n  });\n}\n"]}

package/dist/agentic-flow/src/mcp/fastmcp/tools/autopilot-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Autopilot MCP Tools (ADR-058)
+ *
+ * 10 MCP tools for managing the persistent swarm completion system.
+ * Provides programmatic access to the autopilot loop state,
+ * configuration, task completion tracking, learning, and prediction.
+ */
+export declare function registerAutopilotTools(server: any): void;
+//# sourceMappingURL=autopilot-tools.d.ts.map

package/dist/agentic-flow/src/mcp/fastmcp/tools/autopilot-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autopilot-tools.d.ts","sourceRoot":"","sources":["../../../../../../src/mcp/fastmcp/tools/autopilot-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuHH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAiUxD"}