agentic-qe 2.3.5 → 2.5.0

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 (326) hide show
  1. package/.claude/agents/qe-a11y-ally.md +751 -0
  2. package/.claude/agents/qx-partner.md +120 -4
  3. package/.claude/skills/testability-scoring/SKILL.md +107 -6
  4. package/CHANGELOG.md +133 -0
  5. package/README.md +7 -6
  6. package/dist/agents/AccessibilityAllyAgent.d.ts +168 -0
  7. package/dist/agents/AccessibilityAllyAgent.d.ts.map +1 -0
  8. package/dist/agents/AccessibilityAllyAgent.js +462 -0
  9. package/dist/agents/AccessibilityAllyAgent.js.map +1 -0
  10. package/dist/agents/BaseAgent.d.ts +56 -49
  11. package/dist/agents/BaseAgent.d.ts.map +1 -1
  12. package/dist/agents/BaseAgent.js +208 -604
  13. package/dist/agents/BaseAgent.js.map +1 -1
  14. package/dist/agents/FlakyTestHunterAgent.d.ts +2 -2
  15. package/dist/agents/FlakyTestHunterAgent.d.ts.map +1 -1
  16. package/dist/agents/FlakyTestHunterAgent.js +8 -104
  17. package/dist/agents/FlakyTestHunterAgent.js.map +1 -1
  18. package/dist/agents/SONAIntegration.d.ts +109 -0
  19. package/dist/agents/SONAIntegration.d.ts.map +1 -0
  20. package/dist/agents/SONAIntegration.js +167 -0
  21. package/dist/agents/SONAIntegration.js.map +1 -0
  22. package/dist/agents/TestExecutorAgent.d.ts +1 -1
  23. package/dist/agents/TestExecutorAgent.d.ts.map +1 -1
  24. package/dist/agents/TestExecutorAgent.js +4 -46
  25. package/dist/agents/TestExecutorAgent.js.map +1 -1
  26. package/dist/agents/TestGeneratorAgent.d.ts.map +1 -1
  27. package/dist/agents/TestGeneratorAgent.js +15 -35
  28. package/dist/agents/TestGeneratorAgent.js.map +1 -1
  29. package/dist/agents/adapters/CoordinatorAdapter.d.ts +47 -0
  30. package/dist/agents/adapters/CoordinatorAdapter.d.ts.map +1 -0
  31. package/dist/agents/adapters/CoordinatorAdapter.js +266 -0
  32. package/dist/agents/adapters/CoordinatorAdapter.js.map +1 -0
  33. package/dist/agents/adapters/LearningEngineAdapter.d.ts +45 -0
  34. package/dist/agents/adapters/LearningEngineAdapter.d.ts.map +1 -0
  35. package/dist/agents/adapters/LearningEngineAdapter.js +279 -0
  36. package/dist/agents/adapters/LearningEngineAdapter.js.map +1 -0
  37. package/dist/agents/adapters/LifecycleManagerAdapter.d.ts +45 -0
  38. package/dist/agents/adapters/LifecycleManagerAdapter.d.ts.map +1 -0
  39. package/dist/agents/adapters/LifecycleManagerAdapter.js +128 -0
  40. package/dist/agents/adapters/LifecycleManagerAdapter.js.map +1 -0
  41. package/dist/agents/adapters/MemoryServiceAdapter.d.ts +96 -0
  42. package/dist/agents/adapters/MemoryServiceAdapter.d.ts.map +1 -0
  43. package/dist/agents/adapters/MemoryServiceAdapter.js +266 -0
  44. package/dist/agents/adapters/MemoryServiceAdapter.js.map +1 -0
  45. package/dist/agents/adapters/index.d.ts +14 -0
  46. package/dist/agents/adapters/index.d.ts.map +1 -0
  47. package/dist/agents/adapters/index.js +25 -0
  48. package/dist/agents/adapters/index.js.map +1 -0
  49. package/dist/agents/index.d.ts +3 -0
  50. package/dist/agents/index.d.ts.map +1 -1
  51. package/dist/agents/index.js +93 -2
  52. package/dist/agents/index.js.map +1 -1
  53. package/dist/agents/lifecycle/AgentLifecycleManager.d.ts.map +1 -1
  54. package/dist/agents/lifecycle/AgentLifecycleManager.js +12 -6
  55. package/dist/agents/lifecycle/AgentLifecycleManager.js.map +1 -1
  56. package/dist/cli/init/agents.js +1 -1
  57. package/dist/cli/init/claude-config.js +2 -2
  58. package/dist/cli/init/database-init.js +1 -1
  59. package/dist/core/cache/BinaryCacheBuilder.d.ts +84 -0
  60. package/dist/core/cache/BinaryCacheBuilder.d.ts.map +1 -0
  61. package/dist/core/cache/BinaryCacheBuilder.js +225 -0
  62. package/dist/core/cache/BinaryCacheBuilder.js.map +1 -0
  63. package/dist/core/cache/BinaryCacheImpl.d.ts +161 -0
  64. package/dist/core/cache/BinaryCacheImpl.d.ts.map +1 -0
  65. package/dist/core/cache/BinaryCacheImpl.js +685 -0
  66. package/dist/core/cache/BinaryCacheImpl.js.map +1 -0
  67. package/dist/core/cache/BinaryCacheManager.d.ts +142 -0
  68. package/dist/core/cache/BinaryCacheManager.d.ts.map +1 -0
  69. package/dist/core/cache/BinaryCacheManager.js +354 -0
  70. package/dist/core/cache/BinaryCacheManager.js.map +1 -0
  71. package/dist/core/cache/BinaryCacheReader.d.ts +129 -0
  72. package/dist/core/cache/BinaryCacheReader.d.ts.map +1 -0
  73. package/dist/core/cache/BinaryCacheReader.js +243 -0
  74. package/dist/core/cache/BinaryCacheReader.js.map +1 -0
  75. package/dist/core/cache/BinaryMetadataCache.d.ts +777 -0
  76. package/dist/core/cache/BinaryMetadataCache.d.ts.map +1 -0
  77. package/dist/core/cache/BinaryMetadataCache.js +204 -0
  78. package/dist/core/cache/BinaryMetadataCache.js.map +1 -0
  79. package/dist/core/cache/CacheInvalidator.d.ts +103 -0
  80. package/dist/core/cache/CacheInvalidator.d.ts.map +1 -0
  81. package/dist/core/cache/CacheInvalidator.js +152 -0
  82. package/dist/core/cache/CacheInvalidator.js.map +1 -0
  83. package/dist/core/cache/CacheValidator.d.ts +69 -0
  84. package/dist/core/cache/CacheValidator.d.ts.map +1 -0
  85. package/dist/core/cache/CacheValidator.js +189 -0
  86. package/dist/core/cache/CacheValidator.js.map +1 -0
  87. package/dist/core/cache/MessagePackSerializer.d.ts +163 -0
  88. package/dist/core/cache/MessagePackSerializer.d.ts.map +1 -0
  89. package/dist/core/cache/MessagePackSerializer.js +274 -0
  90. package/dist/core/cache/MessagePackSerializer.js.map +1 -0
  91. package/dist/core/cache/index.d.ts +59 -0
  92. package/dist/core/cache/index.d.ts.map +1 -0
  93. package/dist/core/cache/index.js +111 -0
  94. package/dist/core/cache/index.js.map +1 -0
  95. package/dist/core/index.d.ts +2 -0
  96. package/dist/core/index.d.ts.map +1 -1
  97. package/dist/core/index.js +18 -0
  98. package/dist/core/index.js.map +1 -1
  99. package/dist/core/memory/AgentDBService.d.ts +30 -4
  100. package/dist/core/memory/AgentDBService.d.ts.map +1 -1
  101. package/dist/core/memory/AgentDBService.js +122 -12
  102. package/dist/core/memory/AgentDBService.js.map +1 -1
  103. package/dist/core/memory/CachedHNSWVectorMemory.d.ts +153 -0
  104. package/dist/core/memory/CachedHNSWVectorMemory.d.ts.map +1 -0
  105. package/dist/core/memory/CachedHNSWVectorMemory.js +329 -0
  106. package/dist/core/memory/CachedHNSWVectorMemory.js.map +1 -0
  107. package/dist/core/memory/HNSWVectorMemory.js +1 -1
  108. package/dist/core/memory/PatternStoreFactory.d.ts +28 -0
  109. package/dist/core/memory/PatternStoreFactory.d.ts.map +1 -1
  110. package/dist/core/memory/PatternStoreFactory.js +68 -3
  111. package/dist/core/memory/PatternStoreFactory.js.map +1 -1
  112. package/dist/core/memory/RuVectorPatternStore.d.ts.map +1 -1
  113. package/dist/core/memory/RuVectorPatternStore.js +8 -2
  114. package/dist/core/memory/RuVectorPatternStore.js.map +1 -1
  115. package/dist/core/memory/UnifiedMemoryCoordinator.d.ts +50 -0
  116. package/dist/core/memory/UnifiedMemoryCoordinator.d.ts.map +1 -1
  117. package/dist/core/memory/UnifiedMemoryCoordinator.js +206 -0
  118. package/dist/core/memory/UnifiedMemoryCoordinator.js.map +1 -1
  119. package/dist/core/memory/index.d.ts +2 -0
  120. package/dist/core/memory/index.d.ts.map +1 -1
  121. package/dist/core/memory/index.js +8 -1
  122. package/dist/core/memory/index.js.map +1 -1
  123. package/dist/core/optimization/RecursiveOptimizer.d.ts +233 -0
  124. package/dist/core/optimization/RecursiveOptimizer.d.ts.map +1 -0
  125. package/dist/core/optimization/RecursiveOptimizer.js +509 -0
  126. package/dist/core/optimization/RecursiveOptimizer.js.map +1 -0
  127. package/dist/core/platform/FileOperations.d.ts +124 -0
  128. package/dist/core/platform/FileOperations.d.ts.map +1 -0
  129. package/dist/core/platform/FileOperations.js +371 -0
  130. package/dist/core/platform/FileOperations.js.map +1 -0
  131. package/dist/core/platform/PlatformDetector.d.ts +53 -0
  132. package/dist/core/platform/PlatformDetector.d.ts.map +1 -0
  133. package/dist/core/platform/PlatformDetector.js +251 -0
  134. package/dist/core/platform/PlatformDetector.js.map +1 -0
  135. package/dist/core/platform/index.d.ts +12 -0
  136. package/dist/core/platform/index.d.ts.map +1 -0
  137. package/dist/core/platform/index.js +28 -0
  138. package/dist/core/platform/index.js.map +1 -0
  139. package/dist/core/strategies/AcceleratedLearningStrategy.d.ts +74 -0
  140. package/dist/core/strategies/AcceleratedLearningStrategy.d.ts.map +1 -0
  141. package/dist/core/strategies/AcceleratedLearningStrategy.js +200 -0
  142. package/dist/core/strategies/AcceleratedLearningStrategy.js.map +1 -0
  143. package/dist/core/strategies/AgentCoordinationStrategy.d.ts +157 -0
  144. package/dist/core/strategies/AgentCoordinationStrategy.d.ts.map +1 -0
  145. package/dist/core/strategies/AgentCoordinationStrategy.js +12 -0
  146. package/dist/core/strategies/AgentCoordinationStrategy.js.map +1 -0
  147. package/dist/core/strategies/AgentLearningStrategy.d.ts +200 -0
  148. package/dist/core/strategies/AgentLearningStrategy.d.ts.map +1 -0
  149. package/dist/core/strategies/AgentLearningStrategy.js +13 -0
  150. package/dist/core/strategies/AgentLearningStrategy.js.map +1 -0
  151. package/dist/core/strategies/AgentLifecycleStrategy.d.ts +116 -0
  152. package/dist/core/strategies/AgentLifecycleStrategy.d.ts.map +1 -0
  153. package/dist/core/strategies/AgentLifecycleStrategy.js +12 -0
  154. package/dist/core/strategies/AgentLifecycleStrategy.js.map +1 -0
  155. package/dist/core/strategies/AgentMemoryStrategy.d.ts +154 -0
  156. package/dist/core/strategies/AgentMemoryStrategy.d.ts.map +1 -0
  157. package/dist/core/strategies/AgentMemoryStrategy.js +13 -0
  158. package/dist/core/strategies/AgentMemoryStrategy.js.map +1 -0
  159. package/dist/core/strategies/DefaultCoordinationStrategy.d.ts +105 -0
  160. package/dist/core/strategies/DefaultCoordinationStrategy.d.ts.map +1 -0
  161. package/dist/core/strategies/DefaultCoordinationStrategy.js +332 -0
  162. package/dist/core/strategies/DefaultCoordinationStrategy.js.map +1 -0
  163. package/dist/core/strategies/DefaultLearningStrategy.d.ts +120 -0
  164. package/dist/core/strategies/DefaultLearningStrategy.d.ts.map +1 -0
  165. package/dist/core/strategies/DefaultLearningStrategy.js +365 -0
  166. package/dist/core/strategies/DefaultLearningStrategy.js.map +1 -0
  167. package/dist/core/strategies/DefaultLifecycleStrategy.d.ts +129 -0
  168. package/dist/core/strategies/DefaultLifecycleStrategy.d.ts.map +1 -0
  169. package/dist/core/strategies/DefaultLifecycleStrategy.js +297 -0
  170. package/dist/core/strategies/DefaultLifecycleStrategy.js.map +1 -0
  171. package/dist/core/strategies/DefaultMemoryStrategy.d.ts +91 -0
  172. package/dist/core/strategies/DefaultMemoryStrategy.d.ts.map +1 -0
  173. package/dist/core/strategies/DefaultMemoryStrategy.js +257 -0
  174. package/dist/core/strategies/DefaultMemoryStrategy.js.map +1 -0
  175. package/dist/core/strategies/DistributedMemoryStrategy.d.ts +85 -0
  176. package/dist/core/strategies/DistributedMemoryStrategy.d.ts.map +1 -0
  177. package/dist/core/strategies/DistributedMemoryStrategy.js +126 -0
  178. package/dist/core/strategies/DistributedMemoryStrategy.js.map +1 -0
  179. package/dist/core/strategies/SONALearningStrategy.d.ts +115 -0
  180. package/dist/core/strategies/SONALearningStrategy.d.ts.map +1 -0
  181. package/dist/core/strategies/SONALearningStrategy.js +656 -0
  182. package/dist/core/strategies/SONALearningStrategy.js.map +1 -0
  183. package/dist/core/strategies/TRMLearningStrategy.d.ts +162 -0
  184. package/dist/core/strategies/TRMLearningStrategy.d.ts.map +1 -0
  185. package/dist/core/strategies/TRMLearningStrategy.js +670 -0
  186. package/dist/core/strategies/TRMLearningStrategy.js.map +1 -0
  187. package/dist/core/strategies/index.d.ts +104 -0
  188. package/dist/core/strategies/index.d.ts.map +1 -0
  189. package/dist/core/strategies/index.js +68 -0
  190. package/dist/core/strategies/index.js.map +1 -0
  191. package/dist/learning/PerformanceOptimizer.js +2 -2
  192. package/dist/learning/PerformanceOptimizer.js.map +1 -1
  193. package/dist/learning/SONAFeedbackLoop.d.ts +168 -0
  194. package/dist/learning/SONAFeedbackLoop.d.ts.map +1 -0
  195. package/dist/learning/SONAFeedbackLoop.js +344 -0
  196. package/dist/learning/SONAFeedbackLoop.js.map +1 -0
  197. package/dist/learning/baselines/BaselineCollector.d.ts +1 -1
  198. package/dist/learning/baselines/BaselineCollector.js +1 -1
  199. package/dist/learning/baselines/StandardTaskSuite.d.ts +1 -1
  200. package/dist/learning/baselines/StandardTaskSuite.js +1 -1
  201. package/dist/learning/index.d.ts +2 -0
  202. package/dist/learning/index.d.ts.map +1 -1
  203. package/dist/learning/index.js +6 -1
  204. package/dist/learning/index.js.map +1 -1
  205. package/dist/mcp/handlers/base-handler.d.ts +28 -1
  206. package/dist/mcp/handlers/base-handler.d.ts.map +1 -1
  207. package/dist/mcp/handlers/base-handler.js +41 -0
  208. package/dist/mcp/handlers/base-handler.js.map +1 -1
  209. package/dist/mcp/server-instructions.d.ts +1 -1
  210. package/dist/mcp/server-instructions.js +1 -1
  211. package/dist/mcp/server.d.ts.map +1 -1
  212. package/dist/mcp/server.js +23 -16
  213. package/dist/mcp/server.js.map +1 -1
  214. package/dist/mcp/services/AgentRegistry.d.ts.map +1 -1
  215. package/dist/mcp/services/AgentRegistry.js +6 -1
  216. package/dist/mcp/services/AgentRegistry.js.map +1 -1
  217. package/dist/mcp/tools/qe/accessibility/accname-computation.d.ts +114 -0
  218. package/dist/mcp/tools/qe/accessibility/accname-computation.d.ts.map +1 -0
  219. package/dist/mcp/tools/qe/accessibility/accname-computation.js +566 -0
  220. package/dist/mcp/tools/qe/accessibility/accname-computation.js.map +1 -0
  221. package/dist/mcp/tools/qe/accessibility/apg-patterns.d.ts +103 -0
  222. package/dist/mcp/tools/qe/accessibility/apg-patterns.d.ts.map +1 -0
  223. package/dist/mcp/tools/qe/accessibility/apg-patterns.js +1028 -0
  224. package/dist/mcp/tools/qe/accessibility/apg-patterns.js.map +1 -0
  225. package/dist/mcp/tools/qe/accessibility/en-301-549-mapping.d.ts +48 -0
  226. package/dist/mcp/tools/qe/accessibility/en-301-549-mapping.d.ts.map +1 -0
  227. package/dist/mcp/tools/qe/accessibility/en-301-549-mapping.js +565 -0
  228. package/dist/mcp/tools/qe/accessibility/en-301-549-mapping.js.map +1 -0
  229. package/dist/mcp/tools/qe/accessibility/eu-accessibility-act.d.ts +117 -0
  230. package/dist/mcp/tools/qe/accessibility/eu-accessibility-act.d.ts.map +1 -0
  231. package/dist/mcp/tools/qe/accessibility/eu-accessibility-act.js +571 -0
  232. package/dist/mcp/tools/qe/accessibility/eu-accessibility-act.js.map +1 -0
  233. package/dist/mcp/tools/qe/accessibility/html-report-generator.d.ts +23 -0
  234. package/dist/mcp/tools/qe/accessibility/html-report-generator.d.ts.map +1 -0
  235. package/dist/mcp/tools/qe/accessibility/html-report-generator.js +1152 -0
  236. package/dist/mcp/tools/qe/accessibility/html-report-generator.js.map +1 -0
  237. package/dist/mcp/tools/qe/accessibility/index.d.ts +22 -0
  238. package/dist/mcp/tools/qe/accessibility/index.d.ts.map +1 -0
  239. package/dist/mcp/tools/qe/accessibility/index.js +38 -0
  240. package/dist/mcp/tools/qe/accessibility/index.js.map +1 -0
  241. package/dist/mcp/tools/qe/accessibility/markdown-report-generator.d.ts +18 -0
  242. package/dist/mcp/tools/qe/accessibility/markdown-report-generator.d.ts.map +1 -0
  243. package/dist/mcp/tools/qe/accessibility/markdown-report-generator.js +549 -0
  244. package/dist/mcp/tools/qe/accessibility/markdown-report-generator.js.map +1 -0
  245. package/dist/mcp/tools/qe/accessibility/remediation-code-generator.d.ts +139 -0
  246. package/dist/mcp/tools/qe/accessibility/remediation-code-generator.d.ts.map +1 -0
  247. package/dist/mcp/tools/qe/accessibility/remediation-code-generator.js +1300 -0
  248. package/dist/mcp/tools/qe/accessibility/remediation-code-generator.js.map +1 -0
  249. package/dist/mcp/tools/qe/accessibility/scan-comprehensive.d.ts +138 -0
  250. package/dist/mcp/tools/qe/accessibility/scan-comprehensive.d.ts.map +1 -0
  251. package/dist/mcp/tools/qe/accessibility/scan-comprehensive.js +1326 -0
  252. package/dist/mcp/tools/qe/accessibility/scan-comprehensive.js.map +1 -0
  253. package/dist/mcp/tools/qe/accessibility/video-vision-analyzer.d.ts +50 -0
  254. package/dist/mcp/tools/qe/accessibility/video-vision-analyzer.d.ts.map +1 -0
  255. package/dist/mcp/tools/qe/accessibility/video-vision-analyzer.js +469 -0
  256. package/dist/mcp/tools/qe/accessibility/video-vision-analyzer.js.map +1 -0
  257. package/dist/mcp/tools/qe/accessibility/webvtt-generator.d.ts +193 -0
  258. package/dist/mcp/tools/qe/accessibility/webvtt-generator.d.ts.map +1 -0
  259. package/dist/mcp/tools/qe/accessibility/webvtt-generator.js +511 -0
  260. package/dist/mcp/tools/qe/accessibility/webvtt-generator.js.map +1 -0
  261. package/dist/mcp/tools.d.ts +1 -0
  262. package/dist/mcp/tools.d.ts.map +1 -1
  263. package/dist/mcp/tools.js +61 -0
  264. package/dist/mcp/tools.js.map +1 -1
  265. package/dist/output/AIActionSuggester.d.ts +98 -0
  266. package/dist/output/AIActionSuggester.d.ts.map +1 -0
  267. package/dist/output/AIActionSuggester.js +499 -0
  268. package/dist/output/AIActionSuggester.js.map +1 -0
  269. package/dist/output/CLIOutputHelper.d.ts +169 -0
  270. package/dist/output/CLIOutputHelper.d.ts.map +1 -0
  271. package/dist/output/CLIOutputHelper.js +320 -0
  272. package/dist/output/CLIOutputHelper.js.map +1 -0
  273. package/dist/output/OutputFormatter.d.ts +764 -0
  274. package/dist/output/OutputFormatter.d.ts.map +1 -0
  275. package/dist/output/OutputFormatter.js +125 -0
  276. package/dist/output/OutputFormatter.js.map +1 -0
  277. package/dist/output/OutputFormatterImpl.d.ts +131 -0
  278. package/dist/output/OutputFormatterImpl.d.ts.map +1 -0
  279. package/dist/output/OutputFormatterImpl.js +556 -0
  280. package/dist/output/OutputFormatterImpl.js.map +1 -0
  281. package/dist/output/examples.d.ts +38 -0
  282. package/dist/output/examples.d.ts.map +1 -0
  283. package/dist/output/examples.js +503 -0
  284. package/dist/output/examples.js.map +1 -0
  285. package/dist/output/index.d.ts +16 -0
  286. package/dist/output/index.d.ts.map +1 -0
  287. package/dist/output/index.js +58 -0
  288. package/dist/output/index.js.map +1 -0
  289. package/dist/providers/HybridRouter.d.ts +34 -3
  290. package/dist/providers/HybridRouter.d.ts.map +1 -1
  291. package/dist/providers/HybridRouter.js +69 -4
  292. package/dist/providers/HybridRouter.js.map +1 -1
  293. package/dist/providers/LLMProviderFactory.d.ts +68 -1
  294. package/dist/providers/LLMProviderFactory.d.ts.map +1 -1
  295. package/dist/providers/LLMProviderFactory.js +173 -6
  296. package/dist/providers/LLMProviderFactory.js.map +1 -1
  297. package/dist/providers/OpenRouterProvider.d.ts +150 -0
  298. package/dist/providers/OpenRouterProvider.d.ts.map +1 -0
  299. package/dist/providers/OpenRouterProvider.js +545 -0
  300. package/dist/providers/OpenRouterProvider.js.map +1 -0
  301. package/dist/providers/RuvllmProvider.d.ts +130 -16
  302. package/dist/providers/RuvllmProvider.d.ts.map +1 -1
  303. package/dist/providers/RuvllmProvider.js +399 -83
  304. package/dist/providers/RuvllmProvider.js.map +1 -1
  305. package/dist/providers/index.d.ts +33 -4
  306. package/dist/providers/index.d.ts.map +1 -1
  307. package/dist/providers/index.js +72 -21
  308. package/dist/providers/index.js.map +1 -1
  309. package/dist/telemetry/instrumentation/agent.d.ts +1 -1
  310. package/dist/telemetry/instrumentation/agent.js +1 -1
  311. package/dist/telemetry/instrumentation/index.d.ts +1 -1
  312. package/dist/telemetry/instrumentation/index.js +1 -1
  313. package/dist/types/index.d.ts +2 -1
  314. package/dist/types/index.d.ts.map +1 -1
  315. package/dist/types/index.js +2 -0
  316. package/dist/types/index.js.map +1 -1
  317. package/dist/types/ruvllm.d.ts +97 -0
  318. package/dist/types/ruvllm.d.ts.map +1 -0
  319. package/dist/types/ruvllm.js +46 -0
  320. package/dist/types/ruvllm.js.map +1 -0
  321. package/dist/utils/ruvllm-loader.d.ts +94 -0
  322. package/dist/utils/ruvllm-loader.d.ts.map +1 -0
  323. package/dist/utils/ruvllm-loader.js +87 -0
  324. package/dist/utils/ruvllm-loader.js.map +1 -0
  325. package/docs/reference/agents.md +36 -1
  326. package/package.json +7 -2
@@ -0,0 +1,279 @@
1
+ "use strict";
2
+ /**
3
+ * LearningEngineAdapter - Adapts LearningEngine to AgentLearningStrategy
4
+ *
5
+ * Provides backward compatibility during the B1.2 migration.
6
+ * Wraps the existing LearningEngine to implement the strategy interface.
7
+ *
8
+ * @module agents/adapters/LearningEngineAdapter
9
+ * @version 1.0.0
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.LearningEngineAdapter = void 0;
13
+ exports.createLearningAdapter = createLearningAdapter;
14
+ /**
15
+ * Adapts LearningEngine to AgentLearningStrategy interface
16
+ */
17
+ class LearningEngineAdapter {
18
+ constructor(engine) {
19
+ this.initialized = false;
20
+ this.executionHistory = [];
21
+ this.recommendationsGiven = 0;
22
+ this.recommendationSuccesses = 0;
23
+ this.engine = engine;
24
+ }
25
+ // === Pattern Management ===
26
+ async storePattern(pattern) {
27
+ // LearningEngine stores patterns internally via updatePatterns()
28
+ // which is called during learnFromExecution()
29
+ // For direct pattern storage, we use the memoryStore if available
30
+ const memoryStore = this.engine.memoryStore;
31
+ if (memoryStore && typeof memoryStore.storePattern === 'function') {
32
+ await memoryStore.storePattern({
33
+ id: pattern.id,
34
+ pattern: `${pattern.type}:${pattern.domain}`,
35
+ confidence: pattern.confidence,
36
+ usageCount: pattern.usageCount,
37
+ metadata: {
38
+ content: pattern.content,
39
+ success_rate: pattern.successRate,
40
+ embedding: pattern.embedding,
41
+ created_at: pattern.createdAt,
42
+ updated_at: pattern.updatedAt,
43
+ ...pattern.metadata,
44
+ },
45
+ });
46
+ }
47
+ }
48
+ async getPatterns(query) {
49
+ const enginePatterns = await this.engine.getPatterns();
50
+ // Filter by query criteria
51
+ let filtered = enginePatterns;
52
+ if (query.minConfidence !== undefined) {
53
+ filtered = filtered.filter(p => p.confidence >= query.minConfidence);
54
+ }
55
+ if (query.limit !== undefined) {
56
+ filtered = filtered.slice(0, query.limit);
57
+ }
58
+ // Convert to strategy format
59
+ return filtered.map(p => this.convertPattern(p));
60
+ }
61
+ async findSimilarPatterns(embedding, limit = 10) {
62
+ // LearningEngine doesn't natively support vector similarity
63
+ // Return patterns sorted by confidence as fallback
64
+ const patterns = await this.engine.getPatterns();
65
+ const sorted = patterns.sort((a, b) => b.confidence - a.confidence);
66
+ return sorted.slice(0, limit).map(p => this.convertPattern(p));
67
+ }
68
+ async updatePatternConfidence(patternId, success) {
69
+ // Pattern confidence is updated automatically during learnFromExecution
70
+ // For direct updates, we need to update via memoryStore
71
+ const memoryStore = this.engine.memoryStore;
72
+ if (memoryStore && typeof memoryStore.queryPatternsByAgent === 'function') {
73
+ const agentId = this.engine.agentId;
74
+ const patterns = await memoryStore.queryPatternsByAgent(agentId, 0);
75
+ const pattern = patterns.find((p) => p.id === patternId);
76
+ if (pattern) {
77
+ const newConfidence = success
78
+ ? Math.min(0.99, pattern.confidence + 0.01)
79
+ : Math.max(0.01, pattern.confidence - 0.02);
80
+ await memoryStore.storePattern({
81
+ ...pattern,
82
+ confidence: newConfidence,
83
+ });
84
+ }
85
+ }
86
+ }
87
+ // === Strategy Recommendation ===
88
+ async recommendStrategy(taskState) {
89
+ // Convert taskState to TaskState format
90
+ const state = this.convertToTaskState(taskState);
91
+ const engineRec = await this.engine.recommendStrategy(state);
92
+ if (!engineRec || engineRec.confidence < 0.1) {
93
+ return null;
94
+ }
95
+ this.recommendationsGiven++;
96
+ return {
97
+ strategy: engineRec.strategy,
98
+ confidence: engineRec.confidence,
99
+ reasoning: engineRec.reasoning,
100
+ alternatives: engineRec.alternatives,
101
+ metadata: {
102
+ expectedImprovement: engineRec.expectedImprovement,
103
+ },
104
+ };
105
+ }
106
+ async recordRecommendationOutcome(recommendation, success) {
107
+ if (success) {
108
+ this.recommendationSuccesses++;
109
+ }
110
+ }
111
+ // === Execution Recording ===
112
+ async recordExecution(event) {
113
+ // Store in history
114
+ this.executionHistory.push(event);
115
+ // Keep history bounded
116
+ if (this.executionHistory.length > 1000) {
117
+ this.executionHistory = this.executionHistory.slice(-1000);
118
+ }
119
+ // Convert to TaskResult format for LearningEngine
120
+ const taskResult = {
121
+ success: event.success,
122
+ executionTime: event.duration,
123
+ errors: event.error ? [event.error.message] : undefined,
124
+ strategy: 'default',
125
+ ...(event.result || {}),
126
+ };
127
+ // Learn from the execution
128
+ await this.engine.learnFromExecution(event.task, taskResult);
129
+ }
130
+ async getExecutionHistory(limit = 100) {
131
+ return this.executionHistory.slice(-limit);
132
+ }
133
+ // === Training ===
134
+ async train(iterations = 10) {
135
+ const startTime = Date.now();
136
+ // LearningEngine trains incrementally during learnFromExecution
137
+ // For explicit training, we trigger batch updates
138
+ const engineAny = this.engine;
139
+ // Perform batch updates if experiences exist
140
+ if (engineAny.experiences && engineAny.experiences.length > 0) {
141
+ for (let i = 0; i < iterations; i++) {
142
+ await engineAny.performBatchUpdate?.();
143
+ }
144
+ }
145
+ const patterns = await this.engine.getPatterns();
146
+ const duration = Date.now() - startTime;
147
+ // Calculate improvement from recent experiences
148
+ const improvement = this.calculateImprovement();
149
+ return {
150
+ iterations,
151
+ improvement,
152
+ patternsLearned: patterns.length,
153
+ duration,
154
+ metrics: {
155
+ accuracy: this.recommendationsGiven > 0
156
+ ? this.recommendationSuccesses / this.recommendationsGiven
157
+ : 0,
158
+ loss: 1 - improvement,
159
+ recall: patterns.length > 0 ? Math.min(1, patterns.length / 100) : 0,
160
+ },
161
+ };
162
+ }
163
+ async exportPatterns() {
164
+ const patterns = await this.engine.getPatterns();
165
+ return patterns.map(p => this.convertPattern(p));
166
+ }
167
+ async importPatterns(patterns) {
168
+ let imported = 0;
169
+ for (const pattern of patterns) {
170
+ try {
171
+ await this.storePattern(pattern);
172
+ imported++;
173
+ }
174
+ catch {
175
+ // Skip failed imports
176
+ }
177
+ }
178
+ return imported;
179
+ }
180
+ // === Lifecycle ===
181
+ async initialize() {
182
+ await this.engine.initialize();
183
+ this.initialized = true;
184
+ }
185
+ getStatus() {
186
+ const stats = this.engine.getAlgorithmStats();
187
+ return {
188
+ enabled: this.engine.isEnabled(),
189
+ initialized: this.initialized,
190
+ patternsCount: stats.stats?.tableSize || 0,
191
+ executionsRecorded: this.engine.getTotalExperiences(),
192
+ accuracy: this.recommendationsGiven > 0
193
+ ? this.recommendationSuccesses / this.recommendationsGiven
194
+ : 0,
195
+ modelVersion: stats.algorithm,
196
+ };
197
+ }
198
+ async getMetrics() {
199
+ const patterns = await this.engine.getPatterns();
200
+ const successfulExecutions = this.executionHistory.filter(e => e.success).length;
201
+ return {
202
+ totalExecutions: this.executionHistory.length,
203
+ successfulExecutions,
204
+ failedExecutions: this.executionHistory.length - successfulExecutions,
205
+ patternsStored: patterns.length,
206
+ recommendationsGiven: this.recommendationsGiven,
207
+ recommendationAccuracy: this.recommendationsGiven > 0
208
+ ? this.recommendationSuccesses / this.recommendationsGiven
209
+ : 0,
210
+ averageConfidence: patterns.length > 0
211
+ ? patterns.reduce((sum, p) => sum + p.confidence, 0) / patterns.length
212
+ : 0,
213
+ trainingIterations: this.engine.getTotalExperiences(),
214
+ lastActivity: new Date(),
215
+ };
216
+ }
217
+ async reset() {
218
+ this.executionHistory = [];
219
+ this.recommendationsGiven = 0;
220
+ this.recommendationSuccesses = 0;
221
+ // Note: LearningEngine doesn't have a public reset method
222
+ // Full reset would require reinitializing the engine
223
+ }
224
+ // === Private Helpers ===
225
+ convertPattern(p) {
226
+ const parts = p.pattern.split(':');
227
+ return {
228
+ id: p.id,
229
+ type: parts[0] || 'unknown',
230
+ domain: parts[1] || 'default',
231
+ content: p.pattern,
232
+ confidence: p.confidence,
233
+ usageCount: p.usageCount,
234
+ successRate: p.successRate,
235
+ createdAt: p.createdAt,
236
+ updatedAt: p.lastUsedAt,
237
+ };
238
+ }
239
+ convertToTaskState(taskState) {
240
+ if (typeof taskState !== 'object' || taskState === null) {
241
+ return {
242
+ taskComplexity: 0.5,
243
+ requiredCapabilities: [],
244
+ contextFeatures: {},
245
+ previousAttempts: 0,
246
+ availableResources: 1,
247
+ };
248
+ }
249
+ const state = taskState;
250
+ return {
251
+ taskComplexity: state.complexity || 0.5,
252
+ requiredCapabilities: state.capabilities || [],
253
+ contextFeatures: state.context || {},
254
+ previousAttempts: state.attempts || 0,
255
+ availableResources: state.resources || 1,
256
+ timeConstraint: state.timeout,
257
+ };
258
+ }
259
+ calculateImprovement() {
260
+ if (this.executionHistory.length < 10) {
261
+ return 0;
262
+ }
263
+ const recent = this.executionHistory.slice(-20);
264
+ const baseline = this.executionHistory.slice(0, 20);
265
+ const recentSuccess = recent.filter(e => e.success).length / recent.length;
266
+ const baselineSuccess = baseline.filter(e => e.success).length / baseline.length;
267
+ return baselineSuccess > 0
268
+ ? (recentSuccess - baselineSuccess) / baselineSuccess
269
+ : recentSuccess > 0 ? 1 : 0;
270
+ }
271
+ }
272
+ exports.LearningEngineAdapter = LearningEngineAdapter;
273
+ /**
274
+ * Create a learning strategy adapter from an existing engine
275
+ */
276
+ function createLearningAdapter(engine) {
277
+ return new LearningEngineAdapter(engine);
278
+ }
279
+ //# sourceMappingURL=LearningEngineAdapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LearningEngineAdapter.js","sourceRoot":"","sources":["../../../src/agents/adapters/LearningEngineAdapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * LifecycleManagerAdapter - Adapts AgentLifecycleManager to AgentLifecycleStrategy
3
+ *
4
+ * Provides backward compatibility during the B1.2 migration.
5
+ * Wraps the existing AgentLifecycleManager to implement the strategy interface.
6
+ *
7
+ * @module agents/adapters/LifecycleManagerAdapter
8
+ * @version 1.0.0
9
+ */
10
+ import type { AgentLifecycleStrategy, LifecycleConfig, LifecycleEvent, LifecycleMetrics } from '../../core/strategies';
11
+ import type { AgentStatus, PreTaskData, PostTaskData, TaskErrorData } from '../../types';
12
+ import { AgentLifecycleManager } from '../lifecycle/AgentLifecycleManager';
13
+ /**
14
+ * Adapts AgentLifecycleManager to AgentLifecycleStrategy interface
15
+ *
16
+ * This adapter allows BaseAgent to use the strategy interface while
17
+ * maintaining backward compatibility with existing AgentLifecycleManager.
18
+ */
19
+ export declare class LifecycleManagerAdapter implements AgentLifecycleStrategy {
20
+ private readonly manager;
21
+ private config?;
22
+ private lifecycleHandler?;
23
+ private tasksExecuted;
24
+ private initTime;
25
+ private startTime;
26
+ constructor(manager: AgentLifecycleManager);
27
+ initialize(config: LifecycleConfig): Promise<void>;
28
+ getStatus(): AgentStatus;
29
+ transitionTo(status: AgentStatus, reason?: string): Promise<void>;
30
+ waitForStatus(status: AgentStatus, timeout: number): Promise<void>;
31
+ waitForReady(timeout: number): Promise<void>;
32
+ shutdown(): Promise<void>;
33
+ reset(): Promise<void>;
34
+ onPreTask(_data: PreTaskData): Promise<void>;
35
+ onPostTask(_data: PostTaskData): Promise<void>;
36
+ onTaskError(_data: TaskErrorData): Promise<void>;
37
+ onLifecycleChange(handler: (event: LifecycleEvent) => void): void;
38
+ canAcceptTask(): boolean;
39
+ getMetrics(): LifecycleMetrics;
40
+ }
41
+ /**
42
+ * Create a lifecycle strategy adapter from an existing manager
43
+ */
44
+ export declare function createLifecycleAdapter(manager: AgentLifecycleManager): AgentLifecycleStrategy;
45
+ //# sourceMappingURL=LifecycleManagerAdapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LifecycleManagerAdapter.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/LifecycleManagerAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG3E;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,gBAAgB,CAAC,CAAkC;IAC3D,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAc;gBAEnB,OAAO,EAAE,qBAAqB;IAIpC,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD,SAAS,IAAI,WAAW;IAIlB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BjE,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,iBAAiB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAIjE,aAAa,IAAI,OAAO;IAKxB,UAAU,IAAI,gBAAgB;CAS/B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,qBAAqB,GAC7B,sBAAsB,CAExB"}
@@ -0,0 +1,128 @@
1
+ "use strict";
2
+ /**
3
+ * LifecycleManagerAdapter - Adapts AgentLifecycleManager to AgentLifecycleStrategy
4
+ *
5
+ * Provides backward compatibility during the B1.2 migration.
6
+ * Wraps the existing AgentLifecycleManager to implement the strategy interface.
7
+ *
8
+ * @module agents/adapters/LifecycleManagerAdapter
9
+ * @version 1.0.0
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.LifecycleManagerAdapter = void 0;
13
+ exports.createLifecycleAdapter = createLifecycleAdapter;
14
+ const types_1 = require("../../types");
15
+ /**
16
+ * Adapts AgentLifecycleManager to AgentLifecycleStrategy interface
17
+ *
18
+ * This adapter allows BaseAgent to use the strategy interface while
19
+ * maintaining backward compatibility with existing AgentLifecycleManager.
20
+ */
21
+ class LifecycleManagerAdapter {
22
+ constructor(manager) {
23
+ this.tasksExecuted = 0;
24
+ this.initTime = 0;
25
+ this.startTime = Date.now();
26
+ this.manager = manager;
27
+ }
28
+ async initialize(config) {
29
+ this.config = config;
30
+ this.initTime = Date.now();
31
+ // Manager is already initialized by BaseAgent constructor
32
+ // This is called when using the strategy pattern
33
+ }
34
+ getStatus() {
35
+ return this.manager.getStatus();
36
+ }
37
+ async transitionTo(status, reason) {
38
+ const previousStatus = this.getStatus();
39
+ // Map to manager methods
40
+ switch (status) {
41
+ case types_1.AgentStatus.ACTIVE:
42
+ this.manager.markActive();
43
+ break;
44
+ case types_1.AgentStatus.IDLE:
45
+ this.manager.markIdle();
46
+ break;
47
+ case types_1.AgentStatus.ERROR:
48
+ this.manager.markError(reason || 'Unknown error');
49
+ break;
50
+ default:
51
+ // Use the manager's transitionTo for other statuses
52
+ this.manager.transitionTo(status, reason);
53
+ }
54
+ // Emit lifecycle event if handler registered
55
+ if (this.lifecycleHandler) {
56
+ this.lifecycleHandler({
57
+ previousStatus,
58
+ newStatus: status,
59
+ timestamp: new Date(),
60
+ reason,
61
+ });
62
+ }
63
+ }
64
+ async waitForStatus(status, timeout) {
65
+ // Poll for status change
66
+ const start = Date.now();
67
+ while (Date.now() - start < timeout) {
68
+ if (this.getStatus() === status) {
69
+ return;
70
+ }
71
+ await new Promise(resolve => setTimeout(resolve, 50));
72
+ }
73
+ throw new Error(`Timeout waiting for status ${status} after ${timeout}ms`);
74
+ }
75
+ async waitForReady(timeout) {
76
+ // Wait for ACTIVE or IDLE status
77
+ const start = Date.now();
78
+ while (Date.now() - start < timeout) {
79
+ const current = this.getStatus();
80
+ if (current === types_1.AgentStatus.ACTIVE || current === types_1.AgentStatus.IDLE) {
81
+ return;
82
+ }
83
+ await new Promise(resolve => setTimeout(resolve, 50));
84
+ }
85
+ throw new Error(`Timeout waiting for ready state after ${timeout}ms`);
86
+ }
87
+ async shutdown() {
88
+ await this.manager.terminate({});
89
+ }
90
+ async reset() {
91
+ this.manager.reset(false);
92
+ this.tasksExecuted = 0;
93
+ }
94
+ // Lifecycle hooks - these can be overridden by subclasses
95
+ async onPreTask(_data) {
96
+ // Default: no-op, can be overridden
97
+ }
98
+ async onPostTask(_data) {
99
+ this.tasksExecuted++;
100
+ }
101
+ async onTaskError(_data) {
102
+ // Default: no-op, can be overridden
103
+ }
104
+ onLifecycleChange(handler) {
105
+ this.lifecycleHandler = handler;
106
+ }
107
+ canAcceptTask() {
108
+ const status = this.getStatus();
109
+ return status === types_1.AgentStatus.ACTIVE || status === types_1.AgentStatus.IDLE;
110
+ }
111
+ getMetrics() {
112
+ return {
113
+ initializationTime: this.initTime ? Date.now() - this.initTime : 0,
114
+ uptime: Date.now() - this.startTime,
115
+ stateTransitions: 0, // Would need manager to expose this
116
+ tasksExecuted: this.tasksExecuted,
117
+ lastActivity: new Date(),
118
+ };
119
+ }
120
+ }
121
+ exports.LifecycleManagerAdapter = LifecycleManagerAdapter;
122
+ /**
123
+ * Create a lifecycle strategy adapter from an existing manager
124
+ */
125
+ function createLifecycleAdapter(manager) {
126
+ return new LifecycleManagerAdapter(manager);
127
+ }
128
+ //# sourceMappingURL=LifecycleManagerAdapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LifecycleManagerAdapter.js","sourceRoot":"","sources":["../../../src/agents/adapters/LifecycleManagerAdapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA6IH,wDAIC;AAvID,uCAAoD;AAEpD;;;;;GAKG;AACH,MAAa,uBAAuB;IAQlC,YAAY,OAA8B;QAJlC,kBAAa,GAAG,CAAC,CAAC;QAClB,aAAQ,GAAG,CAAC,CAAC;QACb,cAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAG7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAuB;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,0DAA0D;QAC1D,iDAAiD;IACnD,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAmB,EAAE,MAAe;QACrD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAExC,yBAAyB;QACzB,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,mBAAM,CAAC,MAAM;gBAChB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC1B,MAAM;YACR,KAAK,mBAAM,CAAC,IAAI;gBACd,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACxB,MAAM;YACR,KAAK,mBAAM,CAAC,KAAK;gBACf,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC;gBAClD,MAAM;YACR;gBACE,oDAAoD;gBACpD,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QAED,6CAA6C;QAC7C,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC,gBAAgB,CAAC;gBACpB,cAAc;gBACd,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,MAAM;aACP,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAmB,EAAE,OAAe;QACtD,yBAAyB;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;gBAChC,OAAO;YACT,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,UAAU,OAAO,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,iCAAiC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,OAAO,KAAK,mBAAM,CAAC,MAAM,IAAI,OAAO,KAAK,mBAAM,CAAC,IAAI,EAAE,CAAC;gBACzD,OAAO;YACT,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,SAAS,CAAC,KAAkB;QAChC,oCAAoC;IACtC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAmB;QAClC,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAoB;QACpC,oCAAoC;IACtC,CAAC;IAED,iBAAiB,CAAC,OAAwC;QACxD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,aAAa;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,KAAK,mBAAM,CAAC,MAAM,IAAI,MAAM,KAAK,mBAAM,CAAC,IAAI,CAAC;IAC5D,CAAC;IAED,UAAU;QACR,OAAO;YACL,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YACnC,gBAAgB,EAAE,CAAC,EAAE,oCAAoC;YACzD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,IAAI,EAAE;SACzB,CAAC;IACJ,CAAC;CACF;AAtHD,0DAsHC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CACpC,OAA8B;IAE9B,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC"}
@@ -0,0 +1,96 @@
1
+ /**
2
+ * MemoryServiceAdapter - Adapts AgentMemoryService to AgentMemoryStrategy
3
+ *
4
+ * Provides backward compatibility during the B1.2 migration.
5
+ * Wraps the existing AgentMemoryService to implement the strategy interface.
6
+ *
7
+ * Phase 2 Update: Added agentId support for automatic namespace prefixing
8
+ * to maintain backward compatibility with BaseAgent's memory operations.
9
+ *
10
+ * @module agents/adapters/MemoryServiceAdapter
11
+ * @version 1.1.0
12
+ */
13
+ import type { AgentMemoryStrategy, MemoryOptions, MemoryEntry, MemoryQueryOptions, MemoryStats } from '../../core/strategies';
14
+ import type { QEAgentType, MemoryStore, AgentId } from '../../types';
15
+ import { AgentMemoryService } from '../memory/AgentMemoryService';
16
+ /**
17
+ * Adapts AgentMemoryService to AgentMemoryStrategy interface
18
+ *
19
+ * Supports two namespace formats for backward compatibility:
20
+ * - Agent-local: aqe/{agentType}/{key}
21
+ * - Shared: aqe/shared/{agentType}/{key}
22
+ */
23
+ export declare class MemoryServiceAdapter implements AgentMemoryStrategy {
24
+ private readonly service;
25
+ private readonly memoryStore;
26
+ private readonly agentId?;
27
+ private initialized;
28
+ private stats;
29
+ constructor(service: AgentMemoryService, memoryStore: MemoryStore, agentId?: AgentId);
30
+ /**
31
+ * Create agent-local namespace key: aqe/{agentType}/{key}
32
+ * Used for agent-private storage
33
+ */
34
+ private getLocalKey;
35
+ /**
36
+ * Create shared namespace key: aqe/shared/{agentType}/{key}
37
+ * Used for cross-agent shared storage
38
+ */
39
+ private getSharedKey;
40
+ store(key: string, value: unknown, options?: MemoryOptions): Promise<void>;
41
+ retrieve<T = unknown>(key: string): Promise<T | undefined>;
42
+ delete(key: string): Promise<boolean>;
43
+ exists(key: string): Promise<boolean>;
44
+ /**
45
+ * Store in shared memory using aqe/shared/{agentType}/{key} namespace
46
+ * Makes data accessible to other agents of the specified type
47
+ */
48
+ storeShared(agentType: QEAgentType, key: string, value: unknown, options?: MemoryOptions): Promise<void>;
49
+ /**
50
+ * Retrieve from shared memory using aqe/shared/{agentType}/{key} namespace
51
+ * Shared memory uses partition: 'shared'
52
+ */
53
+ retrieveShared<T = unknown>(agentType: QEAgentType, key: string): Promise<T | undefined>;
54
+ /**
55
+ * Store in agent-local memory using aqe/{agentType}/{key} namespace
56
+ * Maintains backward compatibility with BaseAgent.storeMemory()
57
+ */
58
+ storeLocal(key: string, value: unknown, ttl?: number): Promise<void>;
59
+ /**
60
+ * Retrieve from agent-local memory using aqe/{agentType}/{key} namespace
61
+ * Maintains backward compatibility with BaseAgent.retrieveMemory()
62
+ */
63
+ retrieveLocal<T = unknown>(key: string): Promise<T | undefined>;
64
+ /**
65
+ * Store in shared memory for this agent's type
66
+ * Convenience method matching BaseAgent.storeSharedMemory()
67
+ */
68
+ storeSharedLocal(key: string, value: unknown, ttl?: number): Promise<void>;
69
+ bulkStore(entries: MemoryEntry[]): Promise<void>;
70
+ bulkRetrieve<T = unknown>(keys: string[]): Promise<Map<string, T>>;
71
+ bulkDelete(keys: string[]): Promise<number>;
72
+ query<T = unknown>(options: MemoryQueryOptions): Promise<MemoryEntry[]>;
73
+ listKeys(_pattern?: string): Promise<string[]>;
74
+ initialize(): Promise<void>;
75
+ close(): Promise<void>;
76
+ clear(): Promise<void>;
77
+ getStats(): Promise<MemoryStats>;
78
+ }
79
+ /**
80
+ * Create a memory strategy adapter from an existing service
81
+ *
82
+ * @param service - AgentMemoryService instance
83
+ * @param memoryStore - MemoryStore (typically SwarmMemoryManager)
84
+ * @param agentId - Optional agent ID for namespace prefixing
85
+ */
86
+ export declare function createMemoryAdapter(service: AgentMemoryService, memoryStore: MemoryStore, agentId?: AgentId): MemoryServiceAdapter;
87
+ /**
88
+ * Extended interface for agent-local memory operations
89
+ * Used internally by BaseAgent for backward compatibility
90
+ */
91
+ export interface AgentLocalMemoryStrategy extends AgentMemoryStrategy {
92
+ storeLocal(key: string, value: unknown, ttl?: number): Promise<void>;
93
+ retrieveLocal<T = unknown>(key: string): Promise<T | undefined>;
94
+ storeSharedLocal(key: string, value: unknown, ttl?: number): Promise<void>;
95
+ }
96
+ //# sourceMappingURL=MemoryServiceAdapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MemoryServiceAdapter.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/MemoryServiceAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAU;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAOX;gBAEU,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO;IAQpF;;;OAGG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAMd,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1E,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAU1D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO3C;;;OAGG;IACG,WAAW,CACf,SAAS,EAAE,WAAW,EACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC;IAehB;;;OAGG;IACG,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9B,SAAS,EAAE,WAAW,EACtB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAmBzB;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1E;;;OAGG;IACG,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAWrE;;;OAGG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAalE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3C,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoBvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS9C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;CAGvC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,OAAO,GAChB,oBAAoB,CAEtB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAChE,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E"}