agentic-flow 2.0.7 → 3.0.0-alpha.2

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

@@ -0,0 +1,353 @@
+/**
+ * MCP Tools for Hierarchical Memory System
+ *
+ * 6 tools for 3-tier memory (working, episodic, semantic)
+ * with consolidation and spaced repetition.
+ *
+ * ADR-066 Phase P2-3
+ */
+import { getAgentDBService } from '../../../services/agentdb-service.js';
+/**
+ * Store a memory in the hierarchical memory system
+ */
+export function registerMemoryStore(mcp) {
+    mcp.addTool({
+        name: 'memory_hierarchical_store',
+        description: 'Store a memory in the 3-tier hierarchical memory system (working/episodic/semantic)',
+        parameters: {
+            content: {
+                type: 'string',
+                description: 'Memory content to store',
+                required: true,
+            },
+            importance: {
+                type: 'number',
+                description: 'Importance score (0-1, higher = more important)',
+                required: false,
+            },
+            tier: {
+                type: 'string',
+                description: 'Memory tier: working (default), episodic, or semantic',
+                required: false,
+            },
+            tags: {
+                type: 'string',
+                description: 'Comma-separated tags for categorization',
+                required: false,
+            },
+            context: {
+                type: 'string',
+                description: 'JSON string of contextual metadata',
+                required: false,
+            },
+        },
+        execute: async (args) => {
+            try {
+                const agentdb = await getAgentDBService();
+                if (!agentdb) {
+                    throw new Error('AgentDB service not initialized');
+                }
+                const hierarchicalMemory = agentdb.hierarchicalMemory;
+                if (!hierarchicalMemory) {
+                    throw new Error('HierarchicalMemory not initialized in AgentDB');
+                }
+                const importance = args.importance !== undefined ? parseFloat(args.importance) : 0.5;
+                const tier = args.tier || 'working';
+                const tags = args.tags ? args.tags.split(',').map((t) => t.trim()) : undefined;
+                const context = args.context ? JSON.parse(args.context) : undefined;
+                const memoryId = await hierarchicalMemory.store(args.content, importance, tier, { tags, context });
+                return {
+                    success: true,
+                    memoryId,
+                    tier,
+                    importance,
+                    message: `Memory stored successfully in ${tier} tier`,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error.message,
+                };
+            }
+        },
+    });
+}
+/**
+ * Recall memories from hierarchical memory
+ */
+export function registerMemoryRecall(mcp) {
+    mcp.addTool({
+        name: 'memory_hierarchical_recall',
+        description: 'Recall memories from the hierarchical system with context-dependent retrieval',
+        parameters: {
+            query: {
+                type: 'string',
+                description: 'Query to search for memories',
+                required: true,
+            },
+            tier: {
+                type: 'string',
+                description: 'Tier to search: working, episodic, semantic, or "all" (default)',
+                required: false,
+            },
+            k: {
+                type: 'number',
+                description: 'Number of memories to retrieve (default: 10)',
+                required: false,
+            },
+            threshold: {
+                type: 'number',
+                description: 'Similarity threshold (0-1, default: 0.5)',
+                required: false,
+            },
+            context: {
+                type: 'string',
+                description: 'JSON string of context for context-dependent recall',
+                required: false,
+            },
+            includeDecayed: {
+                type: 'boolean',
+                description: 'Include memories below retention threshold (default: false)',
+                required: false,
+            },
+        },
+        execute: async (args) => {
+            try {
+                const agentdb = await getAgentDBService();
+                if (!agentdb) {
+                    throw new Error('AgentDB service not initialized');
+                }
+                const hierarchicalMemory = agentdb.hierarchicalMemory;
+                if (!hierarchicalMemory) {
+                    throw new Error('HierarchicalMemory not initialized in AgentDB');
+                }
+                const tier = args.tier && args.tier !== 'all' ? args.tier : undefined;
+                const k = args.k ? parseInt(args.k) : 10;
+                const threshold = args.threshold !== undefined ? parseFloat(args.threshold) : 0.5;
+                const context = args.context ? JSON.parse(args.context) : undefined;
+                const includeDecayed = args.includeDecayed === true;
+                const memories = await hierarchicalMemory.recall({
+                    query: args.query,
+                    tier,
+                    k,
+                    threshold,
+                    context,
+                    includeDecayed,
+                });
+                return {
+                    success: true,
+                    count: memories.length,
+                    memories: memories.map((m) => ({
+                        id: m.id,
+                        tier: m.tier,
+                        content: m.content,
+                        importance: m.importance,
+                        accessCount: m.accessCount,
+                        similarity: m.metadata?.similarity,
+                        createdAt: new Date(m.createdAt).toISOString(),
+                        lastAccessedAt: new Date(m.lastAccessedAt).toISOString(),
+                    })),
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error.message,
+                };
+            }
+        },
+    });
+}
+/**
+ * Promote memory to higher tier
+ */
+export function registerMemoryPromote(mcp) {
+    mcp.addTool({
+        name: 'memory_hierarchical_promote',
+        description: 'Promote a memory to a higher tier (working → episodic → semantic)',
+        parameters: {
+            memoryId: {
+                type: 'string',
+                description: 'Memory ID to promote',
+                required: true,
+            },
+        },
+        execute: async (args) => {
+            try {
+                const agentdb = await getAgentDBService();
+                if (!agentdb) {
+                    throw new Error('AgentDB service not initialized');
+                }
+                const hierarchicalMemory = agentdb.hierarchicalMemory;
+                if (!hierarchicalMemory) {
+                    throw new Error('HierarchicalMemory not initialized in AgentDB');
+                }
+                const promoted = await hierarchicalMemory.promote(args.memoryId);
+                return {
+                    success: true,
+                    promoted,
+                    message: promoted
+                        ? `Memory ${args.memoryId} promoted to higher tier`
+                        : `Memory ${args.memoryId} does not meet promotion criteria`,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error.message,
+                };
+            }
+        },
+    });
+}
+/**
+ * Rehearse a memory to strengthen retention
+ */
+export function registerMemoryRehearse(mcp) {
+    mcp.addTool({
+        name: 'memory_hierarchical_rehearse',
+        description: 'Rehearse a memory to strengthen retention and delay forgetting',
+        parameters: {
+            memoryId: {
+                type: 'string',
+                description: 'Memory ID to rehearse',
+                required: true,
+            },
+        },
+        execute: async (args) => {
+            try {
+                const agentdb = await getAgentDBService();
+                if (!agentdb) {
+                    throw new Error('AgentDB service not initialized');
+                }
+                const hierarchicalMemory = agentdb.hierarchicalMemory;
+                if (!hierarchicalMemory) {
+                    throw new Error('HierarchicalMemory not initialized in AgentDB');
+                }
+                await hierarchicalMemory.rehearse(args.memoryId);
+                return {
+                    success: true,
+                    memoryId: args.memoryId,
+                    message: 'Memory rehearsed successfully',
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error.message,
+                };
+            }
+        },
+    });
+}
+/**
+ * Get hierarchical memory statistics
+ */
+export function registerMemoryStats(mcp) {
+    mcp.addTool({
+        name: 'memory_hierarchical_stats',
+        description: 'Get statistics about the hierarchical memory system',
+        parameters: {},
+        execute: async () => {
+            try {
+                const agentdb = await getAgentDBService();
+                if (!agentdb) {
+                    throw new Error('AgentDB service not initialized');
+                }
+                const hierarchicalMemory = agentdb.hierarchicalMemory;
+                if (!hierarchicalMemory) {
+                    throw new Error('HierarchicalMemory not initialized in AgentDB');
+                }
+                const stats = await hierarchicalMemory.getStats();
+                return {
+                    success: true,
+                    stats: {
+                        working: {
+                            count: stats.working.count,
+                            sizeMB: (stats.working.sizeBytes / (1024 * 1024)).toFixed(2),
+                            avgImportance: stats.working.avgImportance.toFixed(3),
+                            avgAccessCount: stats.working.avgAccessCount.toFixed(1),
+                        },
+                        episodic: {
+                            count: stats.episodic.count,
+                            sizeMB: (stats.episodic.sizeBytes / (1024 * 1024)).toFixed(2),
+                            avgImportance: stats.episodic.avgImportance.toFixed(3),
+                            avgAgeDays: (stats.episodic.avgAge / (24 * 60 * 60 * 1000)).toFixed(1),
+                        },
+                        semantic: {
+                            count: stats.semantic.count,
+                            sizeMB: (stats.semantic.sizeBytes / (1024 * 1024)).toFixed(2),
+                            avgImportance: stats.semantic.avgImportance.toFixed(3),
+                            consolidationRate: (stats.semantic.consolidationRate * 100).toFixed(1) + '%',
+                        },
+                        totalMemories: stats.totalMemories,
+                        forgottenCount: stats.forgottenCount,
+                        promotionRate: (stats.promotionRate * 100).toFixed(1) + '%',
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error.message,
+                };
+            }
+        },
+    });
+}
+/**
+ * Run memory consolidation process
+ */
+export function registerMemoryConsolidate(mcp) {
+    mcp.addTool({
+        name: 'memory_hierarchical_consolidate',
+        description: 'Run nightly memory consolidation (episodic → semantic) with spaced repetition',
+        parameters: {},
+        execute: async () => {
+            try {
+                const agentdb = await getAgentDBService();
+                if (!agentdb) {
+                    throw new Error('AgentDB service not initialized');
+                }
+                const memoryConsolidation = agentdb.memoryConsolidation;
+                if (!memoryConsolidation) {
+                    throw new Error('MemoryConsolidation not initialized in AgentDB');
+                }
+                const report = await memoryConsolidation.consolidate();
+                return {
+                    success: true,
+                    report: {
+                        timestamp: new Date(report.timestamp).toISOString(),
+                        executionTimeMs: report.executionTimeMs,
+                        episodicProcessed: report.episodicProcessed,
+                        semanticCreated: report.semanticCreated,
+                        memoriesForgotten: report.memoriesForgotten,
+                        clustersFormed: report.clustersFormed,
+                        avgImportance: report.avgImportance.toFixed(3),
+                        retentionRate: (report.retentionRate * 100).toFixed(1) + '%',
+                        recommendations: report.recommendations,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error.message,
+                };
+            }
+        },
+    });
+}
+/**
+ * Register all memory tools
+ */
+export function registerMemoryTools(mcp) {
+    registerMemoryStore(mcp);
+    registerMemoryRecall(mcp);
+    registerMemoryPromote(mcp);
+    registerMemoryRehearse(mcp);
+    registerMemoryStats(mcp);
+    registerMemoryConsolidate(mcp);
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/mcp/fastmcp/tools/memory-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.js","sourceRoot":"","sources":["../../../../src/mcp/fastmcp/tools/memory-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP Tools for Hierarchical Memory System\n *\n * 6 tools for 3-tier memory (working, episodic, semantic)\n * with consolidation and spaced repetition.\n *\n * ADR-066 Phase P2-3\n */\n\nimport { FastMCP } from '../../fastmcp-fixes.js';\nimport { getAgentDBService } from '../../../services/agentdb-service.js';\n\n/**\n * Store a memory in the hierarchical memory system\n */\nexport function registerMemoryStore(mcp: FastMCP): void {\n  mcp.addTool({\n    name: 'memory_hierarchical_store',\n    description: 'Store a memory in the 3-tier hierarchical memory system (working/episodic/semantic)',\n    parameters: {\n      content: {\n        type: 'string',\n        description: 'Memory content to store',\n        required: true,\n      },\n      importance: {\n        type: 'number',\n        description: 'Importance score (0-1, higher = more important)',\n        required: false,\n      },\n      tier: {\n        type: 'string',\n        description: 'Memory tier: working (default), episodic, or semantic',\n        required: false,\n      },\n      tags: {\n        type: 'string',\n        description: 'Comma-separated tags for categorization',\n        required: false,\n      },\n      context: {\n        type: 'string',\n        description: 'JSON string of contextual metadata',\n        required: false,\n      },\n    },\n    execute: async (args: any) => {\n      try {\n        const agentdb = await getAgentDBService();\n        if (!agentdb) {\n          throw new Error('AgentDB service not initialized');\n        }\n\n        const hierarchicalMemory = (agentdb as any).hierarchicalMemory;\n        if (!hierarchicalMemory) {\n          throw new Error('HierarchicalMemory not initialized in AgentDB');\n        }\n\n        const importance = args.importance !== undefined ? parseFloat(args.importance) : 0.5;\n        const tier = args.tier || 'working';\n        const tags = args.tags ? args.tags.split(',').map((t: string) => t.trim()) : undefined;\n        const context = args.context ? JSON.parse(args.context) : undefined;\n\n        const memoryId = await hierarchicalMemory.store(\n          args.content,\n          importance,\n          tier,\n          { tags, context }\n        );\n\n        return {\n          success: true,\n          memoryId,\n          tier,\n          importance,\n          message: `Memory stored successfully in ${tier} tier`,\n        };\n      } catch (error: any) {\n        return {\n          success: false,\n          error: error.message,\n        };\n      }\n    },\n  });\n}\n\n/**\n * Recall memories from hierarchical memory\n */\nexport function registerMemoryRecall(mcp: FastMCP): void {\n  mcp.addTool({\n    name: 'memory_hierarchical_recall',\n    description: 'Recall memories from the hierarchical system with context-dependent retrieval',\n    parameters: {\n      query: {\n        type: 'string',\n        description: 'Query to search for memories',\n        required: true,\n      },\n      tier: {\n        type: 'string',\n        description: 'Tier to search: working, episodic, semantic, or \"all\" (default)',\n        required: false,\n      },\n      k: {\n        type: 'number',\n        description: 'Number of memories to retrieve (default: 10)',\n        required: false,\n      },\n      threshold: {\n        type: 'number',\n        description: 'Similarity threshold (0-1, default: 0.5)',\n        required: false,\n      },\n      context: {\n        type: 'string',\n        description: 'JSON string of context for context-dependent recall',\n        required: false,\n      },\n      includeDecayed: {\n        type: 'boolean',\n        description: 'Include memories below retention threshold (default: false)',\n        required: false,\n      },\n    },\n    execute: async (args: any) => {\n      try {\n        const agentdb = await getAgentDBService();\n        if (!agentdb) {\n          throw new Error('AgentDB service not initialized');\n        }\n\n        const hierarchicalMemory = (agentdb as any).hierarchicalMemory;\n        if (!hierarchicalMemory) {\n          throw new Error('HierarchicalMemory not initialized in AgentDB');\n        }\n\n        const tier = args.tier && args.tier !== 'all' ? args.tier : undefined;\n        const k = args.k ? parseInt(args.k) : 10;\n        const threshold = args.threshold !== undefined ? parseFloat(args.threshold) : 0.5;\n        const context = args.context ? JSON.parse(args.context) : undefined;\n        const includeDecayed = args.includeDecayed === true;\n\n        const memories = await hierarchicalMemory.recall({\n          query: args.query,\n          tier,\n          k,\n          threshold,\n          context,\n          includeDecayed,\n        });\n\n        return {\n          success: true,\n          count: memories.length,\n          memories: memories.map((m: any) => ({\n            id: m.id,\n            tier: m.tier,\n            content: m.content,\n            importance: m.importance,\n            accessCount: m.accessCount,\n            similarity: m.metadata?.similarity,\n            createdAt: new Date(m.createdAt).toISOString(),\n            lastAccessedAt: new Date(m.lastAccessedAt).toISOString(),\n          })),\n        };\n      } catch (error: any) {\n        return {\n          success: false,\n          error: error.message,\n        };\n      }\n    },\n  });\n}\n\n/**\n * Promote memory to higher tier\n */\nexport function registerMemoryPromote(mcp: FastMCP): void {\n  mcp.addTool({\n    name: 'memory_hierarchical_promote',\n    description: 'Promote a memory to a higher tier (working → episodic → semantic)',\n    parameters: {\n      memoryId: {\n        type: 'string',\n        description: 'Memory ID to promote',\n        required: true,\n      },\n    },\n    execute: async (args: any) => {\n      try {\n        const agentdb = await getAgentDBService();\n        if (!agentdb) {\n          throw new Error('AgentDB service not initialized');\n        }\n\n        const hierarchicalMemory = (agentdb as any).hierarchicalMemory;\n        if (!hierarchicalMemory) {\n          throw new Error('HierarchicalMemory not initialized in AgentDB');\n        }\n\n        const promoted = await hierarchicalMemory.promote(args.memoryId);\n\n        return {\n          success: true,\n          promoted,\n          message: promoted\n            ? `Memory ${args.memoryId} promoted to higher tier`\n            : `Memory ${args.memoryId} does not meet promotion criteria`,\n        };\n      } catch (error: any) {\n        return {\n          success: false,\n          error: error.message,\n        };\n      }\n    },\n  });\n}\n\n/**\n * Rehearse a memory to strengthen retention\n */\nexport function registerMemoryRehearse(mcp: FastMCP): void {\n  mcp.addTool({\n    name: 'memory_hierarchical_rehearse',\n    description: 'Rehearse a memory to strengthen retention and delay forgetting',\n    parameters: {\n      memoryId: {\n        type: 'string',\n        description: 'Memory ID to rehearse',\n        required: true,\n      },\n    },\n    execute: async (args: any) => {\n      try {\n        const agentdb = await getAgentDBService();\n        if (!agentdb) {\n          throw new Error('AgentDB service not initialized');\n        }\n\n        const hierarchicalMemory = (agentdb as any).hierarchicalMemory;\n        if (!hierarchicalMemory) {\n          throw new Error('HierarchicalMemory not initialized in AgentDB');\n        }\n\n        await hierarchicalMemory.rehearse(args.memoryId);\n\n        return {\n          success: true,\n          memoryId: args.memoryId,\n          message: 'Memory rehearsed successfully',\n        };\n      } catch (error: any) {\n        return {\n          success: false,\n          error: error.message,\n        };\n      }\n    },\n  });\n}\n\n/**\n * Get hierarchical memory statistics\n */\nexport function registerMemoryStats(mcp: FastMCP): void {\n  mcp.addTool({\n    name: 'memory_hierarchical_stats',\n    description: 'Get statistics about the hierarchical memory system',\n    parameters: {},\n    execute: async () => {\n      try {\n        const agentdb = await getAgentDBService();\n        if (!agentdb) {\n          throw new Error('AgentDB service not initialized');\n        }\n\n        const hierarchicalMemory = (agentdb as any).hierarchicalMemory;\n        if (!hierarchicalMemory) {\n          throw new Error('HierarchicalMemory not initialized in AgentDB');\n        }\n\n        const stats = await hierarchicalMemory.getStats();\n\n        return {\n          success: true,\n          stats: {\n            working: {\n              count: stats.working.count,\n              sizeMB: (stats.working.sizeBytes / (1024 * 1024)).toFixed(2),\n              avgImportance: stats.working.avgImportance.toFixed(3),\n              avgAccessCount: stats.working.avgAccessCount.toFixed(1),\n            },\n            episodic: {\n              count: stats.episodic.count,\n              sizeMB: (stats.episodic.sizeBytes / (1024 * 1024)).toFixed(2),\n              avgImportance: stats.episodic.avgImportance.toFixed(3),\n              avgAgeDays: (stats.episodic.avgAge / (24 * 60 * 60 * 1000)).toFixed(1),\n            },\n            semantic: {\n              count: stats.semantic.count,\n              sizeMB: (stats.semantic.sizeBytes / (1024 * 1024)).toFixed(2),\n              avgImportance: stats.semantic.avgImportance.toFixed(3),\n              consolidationRate: (stats.semantic.consolidationRate * 100).toFixed(1) + '%',\n            },\n            totalMemories: stats.totalMemories,\n            forgottenCount: stats.forgottenCount,\n            promotionRate: (stats.promotionRate * 100).toFixed(1) + '%',\n          },\n        };\n      } catch (error: any) {\n        return {\n          success: false,\n          error: error.message,\n        };\n      }\n    },\n  });\n}\n\n/**\n * Run memory consolidation process\n */\nexport function registerMemoryConsolidate(mcp: FastMCP): void {\n  mcp.addTool({\n    name: 'memory_hierarchical_consolidate',\n    description: 'Run nightly memory consolidation (episodic → semantic) with spaced repetition',\n    parameters: {},\n    execute: async () => {\n      try {\n        const agentdb = await getAgentDBService();\n        if (!agentdb) {\n          throw new Error('AgentDB service not initialized');\n        }\n\n        const memoryConsolidation = (agentdb as any).memoryConsolidation;\n        if (!memoryConsolidation) {\n          throw new Error('MemoryConsolidation not initialized in AgentDB');\n        }\n\n        const report = await memoryConsolidation.consolidate();\n\n        return {\n          success: true,\n          report: {\n            timestamp: new Date(report.timestamp).toISOString(),\n            executionTimeMs: report.executionTimeMs,\n            episodicProcessed: report.episodicProcessed,\n            semanticCreated: report.semanticCreated,\n            memoriesForgotten: report.memoriesForgotten,\n            clustersFormed: report.clustersFormed,\n            avgImportance: report.avgImportance.toFixed(3),\n            retentionRate: (report.retentionRate * 100).toFixed(1) + '%',\n            recommendations: report.recommendations,\n          },\n        };\n      } catch (error: any) {\n        return {\n          success: false,\n          error: error.message,\n        };\n      }\n    },\n  });\n}\n\n/**\n * Register all memory tools\n */\nexport function registerMemoryTools(mcp: FastMCP): void {\n  registerMemoryStore(mcp);\n  registerMemoryRecall(mcp);\n  registerMemoryPromote(mcp);\n  registerMemoryRehearse(mcp);\n  registerMemoryStats(mcp);\n  registerMemoryConsolidate(mcp);\n}\n"]}

package/dist/mcp/fastmcp/tools/neural-tools.d.ts

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

package/dist/mcp/fastmcp/tools/neural-tools.d.ts.map

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

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

@@ -0,0 +1,162 @@
+import { z } from 'zod';
+import { AgentDBService } from '../../../services/agentdb-service.js';
+export function registerNeuralTools(server) {
+    // Tool: neural_train
+    server.addTool({
+        name: 'neural_train',
+        description: 'Train the learning system on trajectory data (state-action-reward sequences)',
+        parameters: z.object({
+            steps: z.array(z.object({
+                state: z.string().describe('State description'),
+                action: z.string().describe('Action taken'),
+                reward: z.number().describe('Reward signal'),
+                nextState: z.string().optional().describe('Resulting state'),
+            })).min(1).describe('Training trajectory steps'),
+            totalReward: z.number().describe('Total trajectory reward'),
+        }),
+        execute: async ({ steps, totalReward }) => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                await svc.recordTrajectory(steps, totalReward);
+                return JSON.stringify({
+                    success: true,
+                    data: { stepsProcessed: steps.length, totalReward, trained: true },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: neural_predict
+    server.addTool({
+        name: 'neural_predict',
+        description: 'Predict the optimal next action for a given state using learned policy',
+        parameters: z.object({
+            state: z.string().min(1).describe('Current state description to predict action for'),
+        }),
+        execute: async ({ state }) => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                const prediction = await svc.predictAction(state);
+                return JSON.stringify({ success: true, data: prediction, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: neural_status
+    server.addTool({
+        name: 'neural_status',
+        description: 'Get the current status of the neural learning system',
+        parameters: z.object({}),
+        execute: async () => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                const metrics = await svc.getMetrics();
+                return JSON.stringify({
+                    success: true,
+                    data: {
+                        backend: metrics.backend,
+                        episodesLearned: metrics.episodes,
+                        skillsAvailable: metrics.skills,
+                        patternsDiscovered: metrics.patterns,
+                        uptime: metrics.uptime,
+                        status: 'operational',
+                    },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: neural_explain
+    server.addTool({
+        name: 'neural_explain',
+        description: 'Get an explanation for a neural decision using causal recall',
+        parameters: z.object({
+            decisionId: z.string().min(1).describe('Decision/query ID to explain'),
+        }),
+        execute: async ({ decisionId }) => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                const explanation = await svc.explainDecision(decisionId);
+                return JSON.stringify({ success: true, data: explanation, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: neural_trajectory_record
+    server.addTool({
+        name: 'neural_trajectory_record',
+        description: 'Record a complete trajectory with steps and total reward for learning',
+        parameters: z.object({
+            sessionId: z.string().min(1).describe('Session identifier for the trajectory'),
+            steps: z.array(z.object({
+                state: z.string(),
+                action: z.string(),
+                reward: z.number(),
+                nextState: z.string().optional(),
+            })).min(1).describe('Trajectory steps'),
+            totalReward: z.number().describe('Total trajectory reward'),
+            metadata: z.record(z.unknown()).optional().describe('Additional trajectory metadata'),
+        }),
+        execute: async ({ sessionId, steps, totalReward, metadata }) => {
+            try {
+                const svc = await AgentDBService.getInstance();
+                await svc.recordTrajectory(steps, totalReward);
+                // Also store as an episode for cross-referencing
+                await svc.storeEpisode({
+                    sessionId,
+                    task: `trajectory-${steps.length}-steps`,
+                    reward: totalReward,
+                    success: totalReward > 0,
+                    tags: ['trajectory', 'neural'],
+                    metadata: { ...metadata, stepsCount: steps.length },
+                });
+                return JSON.stringify({
+                    success: true,
+                    data: { sessionId, stepsRecorded: steps.length, totalReward },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: neural_reset
+    server.addTool({
+        name: 'neural_reset',
+        description: 'Reset the neural learning state (clears learned trajectories and predictions)',
+        parameters: z.object({
+            confirm: z.boolean().describe('Must be true to confirm reset'),
+        }),
+        execute: async ({ confirm }) => {
+            try {
+                if (!confirm) {
+                    return JSON.stringify({ success: false, error: 'Reset not confirmed. Set confirm: true to proceed.', timestamp: new Date().toISOString() }, null, 2);
+                }
+                // Reset by recreating the service instance
+                AgentDBService.resetInstance();
+                const svc = await AgentDBService.getInstance();
+                const metrics = await svc.getMetrics();
+                return JSON.stringify({
+                    success: true,
+                    data: { message: 'Neural learning state reset', newMetrics: metrics },
+                    timestamp: new Date().toISOString(),
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+}
+//# sourceMappingURL=neural-tools.js.map

package/dist/mcp/fastmcp/tools/neural-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neural-tools.js","sourceRoot":"","sources":["../../../../src/mcp/fastmcp/tools/neural-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { AgentDBService } from '../../../services/agentdb-service.js';\nimport type { TrajectoryStep } from '../../../services/agentdb-service.js';\n\nexport function registerNeuralTools(server: any): void {\n  // Tool: neural_train\n  server.addTool({\n    name: 'neural_train',\n    description: 'Train the learning system on trajectory data (state-action-reward sequences)',\n    parameters: z.object({\n      steps: z.array(z.object({\n        state: z.string().describe('State description'),\n        action: z.string().describe('Action taken'),\n        reward: z.number().describe('Reward signal'),\n        nextState: z.string().optional().describe('Resulting state'),\n      })).min(1).describe('Training trajectory steps'),\n      totalReward: z.number().describe('Total trajectory reward'),\n    }),\n    execute: async ({ steps, totalReward }: { steps: TrajectoryStep[]; totalReward: number }) => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        await svc.recordTrajectory(steps, totalReward);\n        return JSON.stringify({\n          success: true,\n          data: { stepsProcessed: steps.length, totalReward, trained: true },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);\n      }\n    }\n  });\n\n  // Tool: neural_predict\n  server.addTool({\n    name: 'neural_predict',\n    description: 'Predict the optimal next action for a given state using learned policy',\n    parameters: z.object({\n      state: z.string().min(1).describe('Current state description to predict action for'),\n    }),\n    execute: async ({ state }: { state: string }) => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        const prediction = await svc.predictAction(state);\n        return JSON.stringify({ success: true, data: prediction, timestamp: new Date().toISOString() }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);\n      }\n    }\n  });\n\n  // Tool: neural_status\n  server.addTool({\n    name: 'neural_status',\n    description: 'Get the current status of the neural learning system',\n    parameters: z.object({}),\n    execute: async () => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        const metrics = await svc.getMetrics();\n        return JSON.stringify({\n          success: true,\n          data: {\n            backend: metrics.backend,\n            episodesLearned: metrics.episodes,\n            skillsAvailable: metrics.skills,\n            patternsDiscovered: metrics.patterns,\n            uptime: metrics.uptime,\n            status: 'operational',\n          },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);\n      }\n    }\n  });\n\n  // Tool: neural_explain\n  server.addTool({\n    name: 'neural_explain',\n    description: 'Get an explanation for a neural decision using causal recall',\n    parameters: z.object({\n      decisionId: z.string().min(1).describe('Decision/query ID to explain'),\n    }),\n    execute: async ({ decisionId }: { decisionId: string }) => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        const explanation = await svc.explainDecision(decisionId);\n        return JSON.stringify({ success: true, data: explanation, timestamp: new Date().toISOString() }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);\n      }\n    }\n  });\n\n  // Tool: neural_trajectory_record\n  server.addTool({\n    name: 'neural_trajectory_record',\n    description: 'Record a complete trajectory with steps and total reward for learning',\n    parameters: z.object({\n      sessionId: z.string().min(1).describe('Session identifier for the trajectory'),\n      steps: z.array(z.object({\n        state: z.string(),\n        action: z.string(),\n        reward: z.number(),\n        nextState: z.string().optional(),\n      })).min(1).describe('Trajectory steps'),\n      totalReward: z.number().describe('Total trajectory reward'),\n      metadata: z.record(z.unknown()).optional().describe('Additional trajectory metadata'),\n    }),\n    execute: async ({ sessionId, steps, totalReward, metadata }: { sessionId: string; steps: TrajectoryStep[]; totalReward: number; metadata?: Record<string, unknown> }) => {\n      try {\n        const svc = await AgentDBService.getInstance();\n        await svc.recordTrajectory(steps, totalReward);\n        // Also store as an episode for cross-referencing\n        await svc.storeEpisode({\n          sessionId,\n          task: `trajectory-${steps.length}-steps`,\n          reward: totalReward,\n          success: totalReward > 0,\n          tags: ['trajectory', 'neural'],\n          metadata: { ...metadata, stepsCount: steps.length },\n        });\n        return JSON.stringify({\n          success: true,\n          data: { sessionId, stepsRecorded: steps.length, totalReward },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);\n      }\n    }\n  });\n\n  // Tool: neural_reset\n  server.addTool({\n    name: 'neural_reset',\n    description: 'Reset the neural learning state (clears learned trajectories and predictions)',\n    parameters: z.object({\n      confirm: z.boolean().describe('Must be true to confirm reset'),\n    }),\n    execute: async ({ confirm }: { confirm: boolean }) => {\n      try {\n        if (!confirm) {\n          return JSON.stringify({ success: false, error: 'Reset not confirmed. Set confirm: true to proceed.', timestamp: new Date().toISOString() }, null, 2);\n        }\n        // Reset by recreating the service instance\n        AgentDBService.resetInstance();\n        const svc = await AgentDBService.getInstance();\n        const metrics = await svc.getMetrics();\n        return JSON.stringify({\n          success: true,\n          data: { message: 'Neural learning state reset', newMetrics: metrics },\n          timestamp: new Date().toISOString(),\n        }, null, 2);\n      } catch (error: any) {\n        return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);\n      }\n    }\n  });\n}\n"]}

package/dist/mcp/fastmcp/tools/performance-tools.d.ts

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

package/dist/mcp/fastmcp/tools/performance-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-tools.d.ts","sourceRoot":"","sources":["../../../../src/mcp/fastmcp/tools/performance-tools.ts"],"names":[],"mappings":"AAgBA,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CA+jB1D"}