agentic-qe 2.8.0 → 2.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/CHANGELOG.md +105 -0
  2. package/README.md +1 -1
  3. package/dist/agents/BaseAgent.d.ts +128 -0
  4. package/dist/agents/BaseAgent.d.ts.map +1 -1
  5. package/dist/agents/BaseAgent.js +256 -0
  6. package/dist/agents/BaseAgent.js.map +1 -1
  7. package/dist/cli/commands/supabase/index.d.ts +20 -0
  8. package/dist/cli/commands/supabase/index.d.ts.map +1 -0
  9. package/dist/cli/commands/supabase/index.js +632 -0
  10. package/dist/cli/commands/supabase/index.js.map +1 -0
  11. package/dist/cli/index.js +3 -0
  12. package/dist/cli/index.js.map +1 -1
  13. package/dist/core/memory/HNSWVectorMemory.js +1 -1
  14. package/dist/mcp/handlers/NewDomainToolsHandler.d.ts +8 -8
  15. package/dist/mcp/handlers/NewDomainToolsHandler.d.ts.map +1 -1
  16. package/dist/mcp/handlers/NewDomainToolsHandler.js.map +1 -1
  17. package/dist/mcp/handlers/ruvector/RuVectorHandler.d.ts +54 -0
  18. package/dist/mcp/handlers/ruvector/RuVectorHandler.d.ts.map +1 -0
  19. package/dist/mcp/handlers/ruvector/RuVectorHandler.js +325 -0
  20. package/dist/mcp/handlers/ruvector/RuVectorHandler.js.map +1 -0
  21. package/dist/mcp/handlers/ruvector/index.d.ts +5 -0
  22. package/dist/mcp/handlers/ruvector/index.d.ts.map +1 -0
  23. package/dist/mcp/handlers/ruvector/index.js +9 -0
  24. package/dist/mcp/handlers/ruvector/index.js.map +1 -0
  25. package/dist/mcp/server-instructions.d.ts +1 -1
  26. package/dist/mcp/server-instructions.js +1 -1
  27. package/dist/mcp/server.d.ts.map +1 -1
  28. package/dist/mcp/server.js +100 -22
  29. package/dist/mcp/server.js.map +1 -1
  30. package/dist/nervous-system/adapters/BTSPAdapter.d.ts +342 -0
  31. package/dist/nervous-system/adapters/BTSPAdapter.d.ts.map +1 -0
  32. package/dist/nervous-system/adapters/BTSPAdapter.js +494 -0
  33. package/dist/nervous-system/adapters/BTSPAdapter.js.map +1 -0
  34. package/dist/nervous-system/adapters/CircadianController.d.ts +560 -0
  35. package/dist/nervous-system/adapters/CircadianController.d.ts.map +1 -0
  36. package/dist/nervous-system/adapters/CircadianController.js +882 -0
  37. package/dist/nervous-system/adapters/CircadianController.js.map +1 -0
  38. package/dist/nervous-system/adapters/GlobalWorkspaceAdapter.d.ts +337 -0
  39. package/dist/nervous-system/adapters/GlobalWorkspaceAdapter.d.ts.map +1 -0
  40. package/dist/nervous-system/adapters/GlobalWorkspaceAdapter.js +532 -0
  41. package/dist/nervous-system/adapters/GlobalWorkspaceAdapter.js.map +1 -0
  42. package/dist/nervous-system/adapters/HdcMemoryAdapter.d.ts +444 -0
  43. package/dist/nervous-system/adapters/HdcMemoryAdapter.d.ts.map +1 -0
  44. package/dist/nervous-system/adapters/HdcMemoryAdapter.js +715 -0
  45. package/dist/nervous-system/adapters/HdcMemoryAdapter.js.map +1 -0
  46. package/dist/nervous-system/adapters/ReflexLayer.d.ts +231 -0
  47. package/dist/nervous-system/adapters/ReflexLayer.d.ts.map +1 -0
  48. package/dist/nervous-system/adapters/ReflexLayer.js +309 -0
  49. package/dist/nervous-system/adapters/ReflexLayer.js.map +1 -0
  50. package/dist/nervous-system/index.d.ts +25 -0
  51. package/dist/nervous-system/index.d.ts.map +1 -0
  52. package/dist/nervous-system/index.js +80 -0
  53. package/dist/nervous-system/index.js.map +1 -0
  54. package/dist/nervous-system/integration/BTSPLearningEngine.d.ts +266 -0
  55. package/dist/nervous-system/integration/BTSPLearningEngine.d.ts.map +1 -0
  56. package/dist/nervous-system/integration/BTSPLearningEngine.js +587 -0
  57. package/dist/nervous-system/integration/BTSPLearningEngine.js.map +1 -0
  58. package/dist/nervous-system/integration/CircadianAgent.d.ts +389 -0
  59. package/dist/nervous-system/integration/CircadianAgent.d.ts.map +1 -0
  60. package/dist/nervous-system/integration/CircadianAgent.js +696 -0
  61. package/dist/nervous-system/integration/CircadianAgent.js.map +1 -0
  62. package/dist/nervous-system/integration/HybridPatternStore.d.ts +244 -0
  63. package/dist/nervous-system/integration/HybridPatternStore.d.ts.map +1 -0
  64. package/dist/nervous-system/integration/HybridPatternStore.js +622 -0
  65. package/dist/nervous-system/integration/HybridPatternStore.js.map +1 -0
  66. package/dist/nervous-system/integration/NervousSystemEnhancement.d.ts +459 -0
  67. package/dist/nervous-system/integration/NervousSystemEnhancement.d.ts.map +1 -0
  68. package/dist/nervous-system/integration/NervousSystemEnhancement.js +921 -0
  69. package/dist/nervous-system/integration/NervousSystemEnhancement.js.map +1 -0
  70. package/dist/nervous-system/integration/WorkspaceAgent.d.ts +398 -0
  71. package/dist/nervous-system/integration/WorkspaceAgent.d.ts.map +1 -0
  72. package/dist/nervous-system/integration/WorkspaceAgent.js +722 -0
  73. package/dist/nervous-system/integration/WorkspaceAgent.js.map +1 -0
  74. package/dist/nervous-system/integration/index.d.ts +22 -0
  75. package/dist/nervous-system/integration/index.d.ts.map +1 -0
  76. package/dist/nervous-system/integration/index.js +44 -0
  77. package/dist/nervous-system/integration/index.js.map +1 -0
  78. package/dist/nervous-system/persistence/BTSPSerializer.d.ts +96 -0
  79. package/dist/nervous-system/persistence/BTSPSerializer.d.ts.map +1 -0
  80. package/dist/nervous-system/persistence/BTSPSerializer.js +223 -0
  81. package/dist/nervous-system/persistence/BTSPSerializer.js.map +1 -0
  82. package/dist/nervous-system/persistence/CircadianSerializer.d.ts +90 -0
  83. package/dist/nervous-system/persistence/CircadianSerializer.d.ts.map +1 -0
  84. package/dist/nervous-system/persistence/CircadianSerializer.js +239 -0
  85. package/dist/nervous-system/persistence/CircadianSerializer.js.map +1 -0
  86. package/dist/nervous-system/persistence/HdcSerializer.d.ts +100 -0
  87. package/dist/nervous-system/persistence/HdcSerializer.d.ts.map +1 -0
  88. package/dist/nervous-system/persistence/HdcSerializer.js +259 -0
  89. package/dist/nervous-system/persistence/HdcSerializer.js.map +1 -0
  90. package/dist/nervous-system/persistence/INervousSystemStore.d.ts +208 -0
  91. package/dist/nervous-system/persistence/INervousSystemStore.d.ts.map +1 -0
  92. package/dist/nervous-system/persistence/INervousSystemStore.js +11 -0
  93. package/dist/nervous-system/persistence/INervousSystemStore.js.map +1 -0
  94. package/dist/nervous-system/persistence/NervousSystemPersistenceManager.d.ts +187 -0
  95. package/dist/nervous-system/persistence/NervousSystemPersistenceManager.d.ts.map +1 -0
  96. package/dist/nervous-system/persistence/NervousSystemPersistenceManager.js +411 -0
  97. package/dist/nervous-system/persistence/NervousSystemPersistenceManager.js.map +1 -0
  98. package/dist/nervous-system/persistence/SQLiteNervousSystemStore.d.ts +98 -0
  99. package/dist/nervous-system/persistence/SQLiteNervousSystemStore.d.ts.map +1 -0
  100. package/dist/nervous-system/persistence/SQLiteNervousSystemStore.js +510 -0
  101. package/dist/nervous-system/persistence/SQLiteNervousSystemStore.js.map +1 -0
  102. package/dist/nervous-system/persistence/index.d.ts +22 -0
  103. package/dist/nervous-system/persistence/index.d.ts.map +1 -0
  104. package/dist/nervous-system/persistence/index.js +45 -0
  105. package/dist/nervous-system/persistence/index.js.map +1 -0
  106. package/dist/nervous-system/wasm-loader.d.ts +52 -0
  107. package/dist/nervous-system/wasm-loader.d.ts.map +1 -0
  108. package/dist/nervous-system/wasm-loader.js +188 -0
  109. package/dist/nervous-system/wasm-loader.js.map +1 -0
  110. package/dist/persistence/HybridPersistenceProvider.d.ts +184 -0
  111. package/dist/persistence/HybridPersistenceProvider.d.ts.map +1 -0
  112. package/dist/persistence/HybridPersistenceProvider.js +1086 -0
  113. package/dist/persistence/HybridPersistenceProvider.js.map +1 -0
  114. package/dist/persistence/IPersistenceProvider.d.ts +657 -0
  115. package/dist/persistence/IPersistenceProvider.d.ts.map +1 -0
  116. package/dist/persistence/IPersistenceProvider.js +11 -0
  117. package/dist/persistence/IPersistenceProvider.js.map +1 -0
  118. package/dist/persistence/SupabaseConfig.d.ts +176 -0
  119. package/dist/persistence/SupabaseConfig.d.ts.map +1 -0
  120. package/dist/persistence/SupabaseConfig.js +277 -0
  121. package/dist/persistence/SupabaseConfig.js.map +1 -0
  122. package/dist/persistence/SupabasePersistenceProvider.d.ts +143 -0
  123. package/dist/persistence/SupabasePersistenceProvider.d.ts.map +1 -0
  124. package/dist/persistence/SupabasePersistenceProvider.js +955 -0
  125. package/dist/persistence/SupabasePersistenceProvider.js.map +1 -0
  126. package/dist/persistence/adapters/CodeIntelligenceSyncAdapter.d.ts +213 -0
  127. package/dist/persistence/adapters/CodeIntelligenceSyncAdapter.d.ts.map +1 -0
  128. package/dist/persistence/adapters/CodeIntelligenceSyncAdapter.js +468 -0
  129. package/dist/persistence/adapters/CodeIntelligenceSyncAdapter.js.map +1 -0
  130. package/dist/persistence/adapters/MemorySyncAdapter.d.ts +115 -0
  131. package/dist/persistence/adapters/MemorySyncAdapter.d.ts.map +1 -0
  132. package/dist/persistence/adapters/MemorySyncAdapter.js +291 -0
  133. package/dist/persistence/adapters/MemorySyncAdapter.js.map +1 -0
  134. package/dist/persistence/adapters/index.d.ts +11 -0
  135. package/dist/persistence/adapters/index.d.ts.map +1 -0
  136. package/dist/persistence/adapters/index.js +20 -0
  137. package/dist/persistence/adapters/index.js.map +1 -0
  138. package/dist/persistence/index.d.ts +14 -0
  139. package/dist/persistence/index.d.ts.map +1 -1
  140. package/dist/persistence/index.js +36 -1
  141. package/dist/persistence/index.js.map +1 -1
  142. package/package.json +3 -1
@@ -0,0 +1,80 @@
1
+ "use strict";
2
+ /**
3
+ * RuVector Nervous System Integration
4
+ *
5
+ * Bio-inspired neural components for QE agents:
6
+ * - HDC: Hyperdimensional Computing for pattern storage (<100ns)
7
+ * - BTSP: One-shot learning from single examples
8
+ * - K-WTA: Sub-microsecond reflex decisions
9
+ * - Global Workspace: Agent attention coordination (4-7 items)
10
+ * - Circadian: Duty cycling for compute efficiency
11
+ *
12
+ * @module nervous-system
13
+ */
14
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
15
+ if (k2 === undefined) k2 = k;
16
+ var desc = Object.getOwnPropertyDescriptor(m, k);
17
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
18
+ desc = { enumerable: true, get: function() { return m[k]; } };
19
+ }
20
+ Object.defineProperty(o, k2, desc);
21
+ }) : (function(o, m, k, k2) {
22
+ if (k2 === undefined) k2 = k;
23
+ o[k2] = m[k];
24
+ }));
25
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
26
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
27
+ };
28
+ var __importDefault = (this && this.__importDefault) || function (mod) {
29
+ return (mod && mod.__esModule) ? mod : { "default": mod };
30
+ };
31
+ Object.defineProperty(exports, "__esModule", { value: true });
32
+ exports.getWasmInfo = exports.ensureInitialized = exports.isWasmInitialized = exports.initWasm = exports.NervousSystemFleetCoordinator = exports.WithNervousSystem = exports.enhanceWithNervousSystem = exports.createBTSPLearningEngine = exports.BTSPLearningEngine = exports.CircadianAgentManager = exports.createExpandedCoordinator = exports.createFocusedCoordinator = exports.createWorkspaceCoordinator = exports.WorkspaceAgentCoordinator = exports.createHighPerformanceHybridStore = exports.createHybridPatternStore = exports.HybridPatternStore = exports.biological_references = exports.performance_targets = exports.available_mechanisms = exports.nervousSystemVersion = exports.WorkspaceItem = exports.GlobalWorkspace = exports.KWTALayer = exports.WTALayer = exports.HdcMemory = exports.Hypervector = exports.BTSPSynapse = exports.BTSPAssociativeMemory = exports.BTSPLayer = exports.initNervousSystem = void 0;
33
+ // Re-export core WASM components
34
+ var nervous_system_wasm_1 = require("@ruvector/nervous-system-wasm");
35
+ Object.defineProperty(exports, "initNervousSystem", { enumerable: true, get: function () { return __importDefault(nervous_system_wasm_1).default; } });
36
+ Object.defineProperty(exports, "BTSPLayer", { enumerable: true, get: function () { return nervous_system_wasm_1.BTSPLayer; } });
37
+ Object.defineProperty(exports, "BTSPAssociativeMemory", { enumerable: true, get: function () { return nervous_system_wasm_1.BTSPAssociativeMemory; } });
38
+ Object.defineProperty(exports, "BTSPSynapse", { enumerable: true, get: function () { return nervous_system_wasm_1.BTSPSynapse; } });
39
+ Object.defineProperty(exports, "Hypervector", { enumerable: true, get: function () { return nervous_system_wasm_1.Hypervector; } });
40
+ Object.defineProperty(exports, "HdcMemory", { enumerable: true, get: function () { return nervous_system_wasm_1.HdcMemory; } });
41
+ Object.defineProperty(exports, "WTALayer", { enumerable: true, get: function () { return nervous_system_wasm_1.WTALayer; } });
42
+ Object.defineProperty(exports, "KWTALayer", { enumerable: true, get: function () { return nervous_system_wasm_1.KWTALayer; } });
43
+ Object.defineProperty(exports, "GlobalWorkspace", { enumerable: true, get: function () { return nervous_system_wasm_1.GlobalWorkspace; } });
44
+ Object.defineProperty(exports, "WorkspaceItem", { enumerable: true, get: function () { return nervous_system_wasm_1.WorkspaceItem; } });
45
+ Object.defineProperty(exports, "nervousSystemVersion", { enumerable: true, get: function () { return nervous_system_wasm_1.version; } });
46
+ Object.defineProperty(exports, "available_mechanisms", { enumerable: true, get: function () { return nervous_system_wasm_1.available_mechanisms; } });
47
+ Object.defineProperty(exports, "performance_targets", { enumerable: true, get: function () { return nervous_system_wasm_1.performance_targets; } });
48
+ Object.defineProperty(exports, "biological_references", { enumerable: true, get: function () { return nervous_system_wasm_1.biological_references; } });
49
+ // Export adapters (to be implemented)
50
+ __exportStar(require("./adapters/HdcMemoryAdapter.js"), exports);
51
+ __exportStar(require("./adapters/BTSPAdapter.js"), exports);
52
+ __exportStar(require("./adapters/ReflexLayer.js"), exports);
53
+ __exportStar(require("./adapters/GlobalWorkspaceAdapter.js"), exports);
54
+ __exportStar(require("./adapters/CircadianController.js"), exports);
55
+ // Export integration components (named to avoid conflicts with adapters)
56
+ var HybridPatternStore_js_1 = require("./integration/HybridPatternStore.js");
57
+ Object.defineProperty(exports, "HybridPatternStore", { enumerable: true, get: function () { return HybridPatternStore_js_1.HybridPatternStore; } });
58
+ Object.defineProperty(exports, "createHybridPatternStore", { enumerable: true, get: function () { return HybridPatternStore_js_1.createHybridPatternStore; } });
59
+ Object.defineProperty(exports, "createHighPerformanceHybridStore", { enumerable: true, get: function () { return HybridPatternStore_js_1.createHighPerformanceHybridStore; } });
60
+ var WorkspaceAgent_js_1 = require("./integration/WorkspaceAgent.js");
61
+ Object.defineProperty(exports, "WorkspaceAgentCoordinator", { enumerable: true, get: function () { return WorkspaceAgent_js_1.WorkspaceAgentCoordinator; } });
62
+ Object.defineProperty(exports, "createWorkspaceCoordinator", { enumerable: true, get: function () { return WorkspaceAgent_js_1.createWorkspaceCoordinator; } });
63
+ Object.defineProperty(exports, "createFocusedCoordinator", { enumerable: true, get: function () { return WorkspaceAgent_js_1.createFocusedCoordinator; } });
64
+ Object.defineProperty(exports, "createExpandedCoordinator", { enumerable: true, get: function () { return WorkspaceAgent_js_1.createExpandedCoordinator; } });
65
+ var CircadianAgent_js_1 = require("./integration/CircadianAgent.js");
66
+ Object.defineProperty(exports, "CircadianAgentManager", { enumerable: true, get: function () { return CircadianAgent_js_1.CircadianAgentManager; } });
67
+ var BTSPLearningEngine_js_1 = require("./integration/BTSPLearningEngine.js");
68
+ Object.defineProperty(exports, "BTSPLearningEngine", { enumerable: true, get: function () { return BTSPLearningEngine_js_1.BTSPLearningEngine; } });
69
+ Object.defineProperty(exports, "createBTSPLearningEngine", { enumerable: true, get: function () { return BTSPLearningEngine_js_1.createBTSPLearningEngine; } });
70
+ var NervousSystemEnhancement_js_1 = require("./integration/NervousSystemEnhancement.js");
71
+ Object.defineProperty(exports, "enhanceWithNervousSystem", { enumerable: true, get: function () { return NervousSystemEnhancement_js_1.enhanceWithNervousSystem; } });
72
+ Object.defineProperty(exports, "WithNervousSystem", { enumerable: true, get: function () { return NervousSystemEnhancement_js_1.WithNervousSystem; } });
73
+ Object.defineProperty(exports, "NervousSystemFleetCoordinator", { enumerable: true, get: function () { return NervousSystemEnhancement_js_1.NervousSystemFleetCoordinator; } });
74
+ // Export wasm-loader utilities
75
+ var wasm_loader_js_1 = require("./wasm-loader.js");
76
+ Object.defineProperty(exports, "initWasm", { enumerable: true, get: function () { return wasm_loader_js_1.initNervousSystem; } });
77
+ Object.defineProperty(exports, "isWasmInitialized", { enumerable: true, get: function () { return wasm_loader_js_1.isWasmInitialized; } });
78
+ Object.defineProperty(exports, "ensureInitialized", { enumerable: true, get: function () { return wasm_loader_js_1.ensureInitialized; } });
79
+ Object.defineProperty(exports, "getWasmInfo", { enumerable: true, get: function () { return wasm_loader_js_1.getWasmInfo; } });
80
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nervous-system/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;AAEH,iCAAiC;AACjC,qEAeuC;AAdrC,yIAAA,OAAO,OAAqB;AAC5B,gHAAA,SAAS,OAAA;AACT,4HAAA,qBAAqB,OAAA;AACrB,kHAAA,WAAW,OAAA;AACX,kHAAA,WAAW,OAAA;AACX,gHAAA,SAAS,OAAA;AACT,+GAAA,QAAQ,OAAA;AACR,gHAAA,SAAS,OAAA;AACT,sHAAA,eAAe,OAAA;AACf,oHAAA,aAAa,OAAA;AACb,2HAAA,OAAO,OAAwB;AAC/B,2HAAA,oBAAoB,OAAA;AACpB,0HAAA,mBAAmB,OAAA;AACnB,4HAAA,qBAAqB,OAAA;AAGvB,sCAAsC;AACtC,iEAA+C;AAC/C,4DAA0C;AAC1C,4DAA0C;AAC1C,uEAAqD;AACrD,oEAAkD;AAElD,yEAAyE;AACzE,6EAK6C;AAJ3C,2HAAA,kBAAkB,OAAA;AAElB,iIAAA,wBAAwB,OAAA;AACxB,yIAAA,gCAAgC,OAAA;AAGlC,qEASyC;AARvC,8HAAA,yBAAyB,OAAA;AAKzB,+HAAA,0BAA0B,OAAA;AAC1B,6HAAA,wBAAwB,OAAA;AACxB,8HAAA,yBAAyB,OAAA;AAG3B,qEAOyC;AANvC,0HAAA,qBAAqB,OAAA;AAQvB,6EAM6C;AAL3C,2HAAA,kBAAkB,OAAA;AAIlB,iIAAA,wBAAwB,OAAA;AAG1B,yFAQmD;AAPjD,uIAAA,wBAAwB,OAAA;AACxB,gIAAA,iBAAiB,OAAA;AACjB,4IAAA,6BAA6B,OAAA;AAO/B,+BAA+B;AAC/B,mDAK0B;AAJxB,0GAAA,iBAAiB,OAAY;AAC7B,mHAAA,iBAAiB,OAAA;AACjB,mHAAA,iBAAiB,OAAA;AACjB,6GAAA,WAAW,OAAA"}
@@ -0,0 +1,266 @@
1
+ /**
2
+ * BTSPLearningEngine - One-shot Learning Integration
3
+ *
4
+ * Integrates BTSPAdapter with the existing LearningEngine to enable
5
+ * one-shot learning from single failures (vs 10+ examples with traditional RL).
6
+ *
7
+ * Key capabilities:
8
+ * - Learn from single failure (one-shot BTSP association)
9
+ * - BTSP pattern recall before Q-learning fallback
10
+ * - Plateau detection for stability monitoring
11
+ * - EWC consolidation to prevent catastrophic forgetting
12
+ *
13
+ * Architecture:
14
+ * - Wraps LearningEngine for hybrid learning
15
+ * - Uses BTSP for negative reward (failure) learning
16
+ * - Falls back to Q-learning for positive reward learning
17
+ * - Consolidates periodically to prevent forgetting
18
+ *
19
+ * @module nervous-system/integration/BTSPLearningEngine
20
+ */
21
+ import { BTSPAdapter, BTSPAdapterConfig, PlateauDetectionResult } from '../adapters/BTSPAdapter.js';
22
+ import { ExtendedLearningConfig } from '../../learning/LearningEngine.js';
23
+ import { SwarmMemoryManager } from '../../core/memory/SwarmMemoryManager.js';
24
+ import type { TaskState, LearningFeedback, LearningOutcome, LearnedPattern, StrategyRecommendation } from '../../learning/types.js';
25
+ /**
26
+ * Configuration for BTSPLearningEngine
27
+ */
28
+ export interface BTSPLearningEngineConfig {
29
+ /** BTSP adapter configuration */
30
+ btsp?: Partial<BTSPAdapterConfig>;
31
+ /** Learning engine configuration */
32
+ learning?: Partial<ExtendedLearningConfig>;
33
+ /** Threshold for using BTSP one-shot learning (reward below this triggers BTSP) */
34
+ oneShotThreshold: number;
35
+ /** Confidence threshold for trusting BTSP recall results */
36
+ recallConfidenceThreshold: number;
37
+ /** Consolidation interval (number of experiences before consolidation) */
38
+ consolidationInterval: number;
39
+ /** Enable automatic consolidation */
40
+ autoConsolidate: boolean;
41
+ /** Weight for BTSP recommendations vs Q-learning (0-1, higher = more BTSP influence) */
42
+ btspWeight: number;
43
+ }
44
+ /**
45
+ * BTSP learning outcome with additional metrics
46
+ */
47
+ export interface BTSPLearningOutcome extends LearningOutcome {
48
+ /** Whether BTSP one-shot learning was used */
49
+ usedBTSP: boolean;
50
+ /** BTSP plateau detection result */
51
+ plateauResult?: PlateauDetectionResult;
52
+ /** BTSP confidence for this learning event */
53
+ btspConfidence?: number;
54
+ /** Whether consolidation was triggered */
55
+ consolidationTriggered: boolean;
56
+ }
57
+ /**
58
+ * Enhanced strategy recommendation with BTSP context
59
+ */
60
+ export interface BTSPStrategyRecommendation extends StrategyRecommendation {
61
+ /** Source of recommendation */
62
+ source: 'btsp' | 'q-learning' | 'hybrid' | 'default';
63
+ /** BTSP recall confidence */
64
+ btspConfidence?: number;
65
+ /** Q-learning confidence */
66
+ qLearningConfidence?: number;
67
+ /** Whether BTSP associations were found */
68
+ hasBTSPAssociations: boolean;
69
+ }
70
+ /**
71
+ * Metrics for BTSPLearningEngine
72
+ */
73
+ export interface BTSPLearningMetrics {
74
+ /** Total experiences processed */
75
+ totalExperiences: number;
76
+ /** Experiences learned via BTSP one-shot */
77
+ btspLearningCount: number;
78
+ /** Experiences learned via Q-learning */
79
+ qLearningCount: number;
80
+ /** Number of consolidations performed */
81
+ consolidationCount: number;
82
+ /** Average BTSP recall confidence */
83
+ avgBTSPRecallConfidence: number;
84
+ /** Number of plateau detections */
85
+ plateauDetectionCount: number;
86
+ /** BTSP capacity utilization */
87
+ btspCapacityUtilization: number;
88
+ /** Last consolidation timestamp */
89
+ lastConsolidation?: Date;
90
+ }
91
+ /**
92
+ * BTSPLearningEngine - Hybrid one-shot + RL learning
93
+ *
94
+ * Provides bio-inspired one-shot learning for failures while maintaining
95
+ * Q-learning for positive reinforcement. This enables learning from
96
+ * single test failures instead of requiring 10+ examples.
97
+ *
98
+ * @example
99
+ * ```typescript
100
+ * const engine = new BTSPLearningEngine('agent-1', memoryStore, {
101
+ * oneShotThreshold: 0,
102
+ * recallConfidenceThreshold: 0.6
103
+ * });
104
+ * await engine.initialize();
105
+ *
106
+ * // Learn from execution - BTSP for failures, Q-learning for success
107
+ * const outcome = await engine.learnFromExecution(task, result, feedback);
108
+ *
109
+ * // Get recommendation - checks BTSP associations first
110
+ * const recommendation = await engine.recommendWithBTSP(state);
111
+ * ```
112
+ */
113
+ export declare class BTSPLearningEngine {
114
+ private readonly logger;
115
+ private readonly config;
116
+ private readonly agentId;
117
+ /** BTSP adapter for one-shot learning */
118
+ private btspAdapter;
119
+ /** Base learning engine with Q-learning */
120
+ private baseLearningEngine;
121
+ /** Memory store reference */
122
+ private readonly memoryStore;
123
+ /** Initialization state */
124
+ private initialized;
125
+ /** Metrics tracking */
126
+ private metrics;
127
+ /** Accumulated recall confidences for averaging */
128
+ private recallConfidences;
129
+ /** Experience count since last consolidation */
130
+ private experiencesSinceConsolidation;
131
+ constructor(agentId: string, memoryStore: SwarmMemoryManager, config?: Partial<BTSPLearningEngineConfig>);
132
+ /**
133
+ * Initialize both BTSP adapter and base learning engine
134
+ */
135
+ initialize(): Promise<void>;
136
+ /**
137
+ * Ensure engine is initialized
138
+ */
139
+ private ensureInitialized;
140
+ /**
141
+ * Learn from task execution with hybrid BTSP/Q-learning
142
+ *
143
+ * Uses BTSP one-shot learning for failures (reward < threshold) and
144
+ * Q-learning for positive experiences. This enables learning from
145
+ * single failures instead of requiring many examples.
146
+ *
147
+ * @param task - Task that was executed
148
+ * @param result - Execution result
149
+ * @param feedback - Optional user/system feedback
150
+ * @returns Learning outcome with BTSP-specific metrics
151
+ */
152
+ learnFromExecution(task: unknown, result: unknown, feedback?: LearningFeedback): Promise<BTSPLearningOutcome>;
153
+ /**
154
+ * Recommend strategy with BTSP association check first
155
+ *
156
+ * Checks BTSP associations for the state before falling back to
157
+ * Q-learning. This provides faster recommendations from one-shot
158
+ * learned patterns.
159
+ *
160
+ * @param state - Current task state
161
+ * @returns Strategy recommendation with source information
162
+ */
163
+ recommendWithBTSP(state: TaskState): Promise<BTSPStrategyRecommendation>;
164
+ /**
165
+ * Get patterns from both BTSP and Q-learning
166
+ *
167
+ * Combines BTSP-learned associations with patterns from the base
168
+ * learning engine for a complete view of learned knowledge.
169
+ */
170
+ getPatterns(): Promise<LearnedPattern[]>;
171
+ /**
172
+ * Perform EWC consolidation to prevent catastrophic forgetting
173
+ *
174
+ * This should be called periodically (automatically if autoConsolidate is enabled)
175
+ * to preserve important synaptic weights.
176
+ */
177
+ consolidate(): Promise<void>;
178
+ /**
179
+ * Check if BTSP learning has reached a plateau (stable state)
180
+ *
181
+ * Returns true if recent learning signals have stabilized, indicating
182
+ * the model has converged on important associations.
183
+ */
184
+ isPlateauReached(): boolean;
185
+ /**
186
+ * Get comprehensive metrics for the BTSP learning engine
187
+ */
188
+ getMetrics(): BTSPLearningMetrics;
189
+ /**
190
+ * Get BTSP adapter statistics
191
+ */
192
+ getBTSPStats(): ReturnType<BTSPAdapter['getStats']> | null;
193
+ /**
194
+ * Get BTSP adapter for direct access (for serialization/persistence)
195
+ */
196
+ getBTSPAdapter(): BTSPAdapter;
197
+ /**
198
+ * Get base learning engine statistics
199
+ */
200
+ getBaseLearningStats(): {
201
+ algorithm: import("../../learning/LearningEngine.js").RLAlgorithmType;
202
+ algorithmStats: {
203
+ algorithm: import("../../learning/LearningEngine.js").RLAlgorithmType;
204
+ stats?: ReturnType<import("../../index.js").AbstractRLLearner["getStatistics"]>;
205
+ };
206
+ totalExperiences: number;
207
+ explorationRate: number;
208
+ qLearningStats: {
209
+ enabled: boolean;
210
+ stats?: {
211
+ steps: number;
212
+ episodes: number;
213
+ tableSize: number;
214
+ explorationRate: number;
215
+ avgQValue: number;
216
+ maxQValue: number;
217
+ minQValue: number;
218
+ };
219
+ };
220
+ };
221
+ /**
222
+ * Check if the engine is initialized
223
+ */
224
+ isInitialized(): boolean;
225
+ /**
226
+ * Reset BTSP adapter (clears one-shot associations)
227
+ */
228
+ resetBTSP(): void;
229
+ /**
230
+ * Dispose of resources
231
+ */
232
+ dispose(): void;
233
+ /**
234
+ * Calculate reward from execution result and feedback
235
+ */
236
+ private calculateReward;
237
+ /**
238
+ * Convert task and result to a fixed-size pattern for BTSP
239
+ */
240
+ private taskToPattern;
241
+ /**
242
+ * Convert task state to pattern for BTSP recall
243
+ */
244
+ private stateToPattern;
245
+ /**
246
+ * Convert BTSP pattern to strategy recommendation
247
+ */
248
+ private patternToStrategy;
249
+ /**
250
+ * Calculate average recall confidence
251
+ */
252
+ private calculateAverageConfidence;
253
+ /**
254
+ * Simple hash function for string to number
255
+ */
256
+ private simpleHash;
257
+ }
258
+ /**
259
+ * Factory function to create a pre-configured BTSPLearningEngine
260
+ */
261
+ export declare function createBTSPLearningEngine(agentId: string, memoryStore: SwarmMemoryManager, config?: Partial<BTSPLearningEngineConfig>): BTSPLearningEngine;
262
+ /**
263
+ * Default export
264
+ */
265
+ export default BTSPLearningEngine;
266
+ //# sourceMappingURL=BTSPLearningEngine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BTSPLearningEngine.d.ts","sourceRoot":"","sources":["../../../src/nervous-system/integration/BTSPLearningEngine.ts"],"names":[],"mappings":"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"}