agentic-flow 3.0.0-alpha.2 → 3.1.0

package/dist/mcp/fastmcp/tools/attention-tools.js

@@ -1,313 +0,0 @@
-/**
- * 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/mcp/fastmcp/tools/attention-tools.js.map

@@ -1 +0,0 @@
-{"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/mcp/fastmcp/tools/autopilot-tools.d.ts

@@ -1,9 +0,0 @@
-/**
- * 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/mcp/fastmcp/tools/autopilot-tools.d.ts.map

@@ -1 +0,0 @@
-{"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"}