agentic-flow 3.0.0-alpha.2 → 3.1.0

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

@@ -1,353 +0,0 @@
-/**
- * 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

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

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

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

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

@@ -1,162 +0,0 @@
-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

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

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

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

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