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,157 @@
1
+ /**
2
+ * AgentCoordinationStrategy - Strategy interface for agent coordination
3
+ *
4
+ * Handles event emission, message passing, and swarm coordination.
5
+ * Part of Phase 2 layered architecture refactoring.
6
+ *
7
+ * @module core/strategies/AgentCoordinationStrategy
8
+ * @version 1.0.0
9
+ */
10
+ import type { EventEmitter } from 'events';
11
+ import type { AgentId, QEEvent, MessageType } from '../../types';
12
+ /**
13
+ * Simple event handler function type for coordination
14
+ */
15
+ export type CoordinationEventHandler<T = unknown> = (data: T) => void | Promise<void>;
16
+ /**
17
+ * Agent message for inter-agent communication
18
+ */
19
+ export interface AgentMessage {
20
+ id?: string;
21
+ type: MessageType | string;
22
+ sender: AgentId;
23
+ target?: AgentId;
24
+ payload: unknown;
25
+ timestamp?: Date;
26
+ priority?: 'low' | 'medium' | 'high' | 'critical';
27
+ correlationId?: string;
28
+ metadata?: Record<string, unknown>;
29
+ }
30
+ /**
31
+ * Message handler function
32
+ */
33
+ export type MessageHandler = (message: AgentMessage) => void | Promise<void>;
34
+ /**
35
+ * Swarm membership info
36
+ */
37
+ export interface SwarmMembership {
38
+ swarmId: string;
39
+ role: 'coordinator' | 'worker' | 'observer';
40
+ joinedAt: Date;
41
+ topology: 'mesh' | 'hierarchical' | 'ring' | 'star';
42
+ peers: AgentId[];
43
+ }
44
+ /**
45
+ * Coordination metrics
46
+ */
47
+ export interface CoordinationMetrics {
48
+ eventsEmitted: number;
49
+ eventsReceived: number;
50
+ messagesSent: number;
51
+ messagesReceived: number;
52
+ broadcastsSent: number;
53
+ averageLatency: number;
54
+ activeSubscriptions: number;
55
+ }
56
+ /**
57
+ * AgentCoordinationStrategy interface
58
+ *
59
+ * Implementations:
60
+ * - DefaultCoordinationStrategy: EventEmitter-based
61
+ * - SwarmCoordinationStrategy: Claude Flow integration
62
+ * - DistributedCoordinationStrategy: QUIC-based (Phase 4)
63
+ */
64
+ export interface AgentCoordinationStrategy {
65
+ /**
66
+ * Emit an event to the event bus
67
+ * @param event - Event to emit
68
+ */
69
+ emit(event: QEEvent): void;
70
+ /**
71
+ * Subscribe to events of a specific type
72
+ * @param eventType - Event type to subscribe to
73
+ * @param handler - Handler function
74
+ */
75
+ on<T = unknown>(eventType: string, handler: CoordinationEventHandler<T>): void;
76
+ /**
77
+ * Unsubscribe from events
78
+ * @param eventType - Event type
79
+ * @param handler - Handler function to remove
80
+ */
81
+ off<T = unknown>(eventType: string, handler: CoordinationEventHandler<T>): void;
82
+ /**
83
+ * Subscribe to a single event occurrence
84
+ * @param eventType - Event type
85
+ * @param handler - Handler function
86
+ */
87
+ once<T = unknown>(eventType: string, handler: CoordinationEventHandler<T>): void;
88
+ /**
89
+ * Broadcast a message to all agents
90
+ * @param message - Message to broadcast
91
+ */
92
+ broadcast(message: AgentMessage): Promise<void>;
93
+ /**
94
+ * Send a message to a specific agent
95
+ * @param targetAgent - Target agent ID
96
+ * @param message - Message to send
97
+ */
98
+ send(targetAgent: AgentId, message: AgentMessage): Promise<void>;
99
+ /**
100
+ * Subscribe to messages
101
+ * @param handler - Message handler
102
+ */
103
+ onMessage(handler: MessageHandler): void;
104
+ /**
105
+ * Unsubscribe from messages
106
+ * @param handler - Handler to remove
107
+ */
108
+ offMessage(handler: MessageHandler): void;
109
+ /**
110
+ * Request-response pattern
111
+ * @param targetAgent - Target agent
112
+ * @param message - Request message
113
+ * @param timeout - Response timeout
114
+ */
115
+ request<T = unknown>(targetAgent: AgentId, message: AgentMessage, timeout?: number): Promise<T>;
116
+ /**
117
+ * Join a swarm
118
+ * @param swarmId - Swarm identifier
119
+ * @param role - Role in the swarm
120
+ */
121
+ joinSwarm?(swarmId: string, role?: 'coordinator' | 'worker'): Promise<void>;
122
+ /**
123
+ * Leave the current swarm
124
+ */
125
+ leaveSwarm?(): Promise<void>;
126
+ /**
127
+ * Get current swarm membership
128
+ */
129
+ getSwarmMembership?(): SwarmMembership | null;
130
+ /**
131
+ * Discover peers in the swarm
132
+ */
133
+ discoverPeers?(): Promise<AgentId[]>;
134
+ /**
135
+ * Initialize the coordination strategy
136
+ * @param eventBus - Event bus to use
137
+ * @param agentId - This agent's ID
138
+ */
139
+ initialize(eventBus: EventEmitter, agentId: AgentId): void;
140
+ /**
141
+ * Shutdown coordination
142
+ */
143
+ shutdown(): Promise<void>;
144
+ /**
145
+ * Get coordination metrics
146
+ */
147
+ getMetrics(): CoordinationMetrics;
148
+ /**
149
+ * Check if coordination is healthy
150
+ */
151
+ isHealthy(): boolean;
152
+ }
153
+ /**
154
+ * Factory function type for creating coordination strategies
155
+ */
156
+ export type CoordinationStrategyFactory = (config?: Record<string, unknown>) => AgentCoordinationStrategy;
157
+ //# sourceMappingURL=AgentCoordinationStrategy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AgentCoordinationStrategy.d.ts","sourceRoot":"","sources":["../../../src/core/strategies/AgentCoordinationStrategy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ /**
3
+ * AgentCoordinationStrategy - Strategy interface for agent coordination
4
+ *
5
+ * Handles event emission, message passing, and swarm coordination.
6
+ * Part of Phase 2 layered architecture refactoring.
7
+ *
8
+ * @module core/strategies/AgentCoordinationStrategy
9
+ * @version 1.0.0
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ //# sourceMappingURL=AgentCoordinationStrategy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AgentCoordinationStrategy.js","sourceRoot":"","sources":["../../../src/core/strategies/AgentCoordinationStrategy.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}
@@ -0,0 +1,200 @@
1
+ /**
2
+ * AgentLearningStrategy - Strategy interface for agent learning and adaptation
3
+ *
4
+ * Handles pattern learning, strategy recommendation, and performance tracking.
5
+ * Integrates with LearningEngine and PerformanceTracker.
6
+ * Part of Phase 2 (B1.3c) layered architecture refactoring.
7
+ *
8
+ * @module core/strategies/AgentLearningStrategy
9
+ * @version 1.0.0
10
+ */
11
+ import type { QETask } from '../../types';
12
+ /**
13
+ * Learned pattern from experience
14
+ */
15
+ export interface LearnedPattern {
16
+ id: string;
17
+ type: string;
18
+ domain: string;
19
+ embedding?: number[];
20
+ content: string;
21
+ confidence: number;
22
+ usageCount: number;
23
+ successRate: number;
24
+ createdAt: Date;
25
+ updatedAt: Date;
26
+ metadata?: Record<string, unknown>;
27
+ }
28
+ /**
29
+ * Pattern query options
30
+ */
31
+ export interface PatternQuery {
32
+ /** Filter by pattern type */
33
+ type?: string;
34
+ /** Filter by domain */
35
+ domain?: string;
36
+ /** Minimum confidence threshold */
37
+ minConfidence?: number;
38
+ /** Maximum results */
39
+ limit?: number;
40
+ /** Semantic search query */
41
+ semanticQuery?: string;
42
+ /** Vector for similarity search */
43
+ embedding?: number[];
44
+ }
45
+ /**
46
+ * Strategy recommendation from learning engine
47
+ */
48
+ export interface StrategyRecommendation {
49
+ strategy: string;
50
+ confidence: number;
51
+ reasoning: string;
52
+ alternatives?: Array<{
53
+ strategy: string;
54
+ confidence: number;
55
+ }>;
56
+ metadata?: Record<string, unknown>;
57
+ }
58
+ /**
59
+ * Task execution event for learning
60
+ */
61
+ export interface ExecutionEvent {
62
+ task: QETask;
63
+ result?: unknown;
64
+ error?: Error;
65
+ success: boolean;
66
+ duration: number;
67
+ resourceUsage?: {
68
+ memory: number;
69
+ cpu: number;
70
+ };
71
+ metadata?: Record<string, unknown>;
72
+ }
73
+ /**
74
+ * Training result
75
+ */
76
+ export interface TrainingResult {
77
+ iterations: number;
78
+ improvement: number;
79
+ patternsLearned: number;
80
+ duration: number;
81
+ metrics: {
82
+ accuracy: number;
83
+ loss: number;
84
+ recall: number;
85
+ };
86
+ }
87
+ /**
88
+ * Learning status
89
+ */
90
+ export interface LearningStatus {
91
+ enabled: boolean;
92
+ initialized: boolean;
93
+ patternsCount: number;
94
+ executionsRecorded: number;
95
+ lastTraining?: Date;
96
+ accuracy: number;
97
+ modelVersion?: string;
98
+ }
99
+ /**
100
+ * Learning metrics
101
+ */
102
+ export interface LearningMetrics {
103
+ totalExecutions: number;
104
+ successfulExecutions: number;
105
+ failedExecutions: number;
106
+ patternsStored: number;
107
+ recommendationsGiven: number;
108
+ recommendationAccuracy: number;
109
+ averageConfidence: number;
110
+ trainingIterations: number;
111
+ lastActivity: Date;
112
+ }
113
+ /**
114
+ * AgentLearningStrategy interface
115
+ *
116
+ * Implementations:
117
+ * - DefaultLearningStrategy: PerformanceTracker + LearningEngine
118
+ * - AcceleratedLearningStrategy: Binary cache for patterns
119
+ * - DisabledLearningStrategy: No-op for benchmarks/testing
120
+ */
121
+ export interface AgentLearningStrategy {
122
+ /**
123
+ * Store a learned pattern
124
+ * @param pattern - Pattern to store
125
+ */
126
+ storePattern(pattern: LearnedPattern): Promise<void>;
127
+ /**
128
+ * Query learned patterns
129
+ * @param query - Query options
130
+ */
131
+ getPatterns(query: PatternQuery): Promise<LearnedPattern[]>;
132
+ /**
133
+ * Find similar patterns using vector similarity
134
+ * @param embedding - Query embedding
135
+ * @param limit - Maximum results
136
+ */
137
+ findSimilarPatterns(embedding: number[], limit?: number): Promise<LearnedPattern[]>;
138
+ /**
139
+ * Update pattern confidence based on feedback
140
+ * @param patternId - Pattern ID
141
+ * @param success - Whether the pattern was successful
142
+ */
143
+ updatePatternConfidence(patternId: string, success: boolean): Promise<void>;
144
+ /**
145
+ * Recommend a strategy based on task state
146
+ * @param taskState - Current task state/context
147
+ */
148
+ recommendStrategy(taskState: unknown): Promise<StrategyRecommendation | null>;
149
+ /**
150
+ * Record whether a recommendation was successful
151
+ * @param recommendation - The recommendation that was used
152
+ * @param success - Whether it succeeded
153
+ */
154
+ recordRecommendationOutcome(recommendation: StrategyRecommendation, success: boolean): Promise<void>;
155
+ /**
156
+ * Record a task execution for learning
157
+ * @param event - Execution event
158
+ */
159
+ recordExecution(event: ExecutionEvent): Promise<void>;
160
+ /**
161
+ * Get execution history
162
+ * @param limit - Maximum results
163
+ */
164
+ getExecutionHistory(limit?: number): Promise<ExecutionEvent[]>;
165
+ /**
166
+ * Train the learning model
167
+ * @param iterations - Number of training iterations
168
+ */
169
+ train(iterations?: number): Promise<TrainingResult>;
170
+ /**
171
+ * Export learned patterns for transfer
172
+ */
173
+ exportPatterns(): Promise<LearnedPattern[]>;
174
+ /**
175
+ * Import patterns from another agent
176
+ * @param patterns - Patterns to import
177
+ */
178
+ importPatterns(patterns: LearnedPattern[]): Promise<number>;
179
+ /**
180
+ * Initialize the learning strategy
181
+ */
182
+ initialize(): Promise<void>;
183
+ /**
184
+ * Get learning status
185
+ */
186
+ getStatus(): LearningStatus;
187
+ /**
188
+ * Get learning metrics
189
+ */
190
+ getMetrics(): Promise<LearningMetrics>;
191
+ /**
192
+ * Reset learning state (use with caution)
193
+ */
194
+ reset?(): Promise<void>;
195
+ }
196
+ /**
197
+ * Factory function type for creating learning strategies
198
+ */
199
+ export type LearningStrategyFactory = (config?: Record<string, unknown>) => AgentLearningStrategy;
200
+ //# sourceMappingURL=AgentLearningStrategy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AgentLearningStrategy.d.ts","sourceRoot":"","sources":["../../../src/core/strategies/AgentLearningStrategy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ "use strict";
2
+ /**
3
+ * AgentLearningStrategy - Strategy interface for agent learning and adaptation
4
+ *
5
+ * Handles pattern learning, strategy recommendation, and performance tracking.
6
+ * Integrates with LearningEngine and PerformanceTracker.
7
+ * Part of Phase 2 (B1.3c) layered architecture refactoring.
8
+ *
9
+ * @module core/strategies/AgentLearningStrategy
10
+ * @version 1.0.0
11
+ */
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ //# sourceMappingURL=AgentLearningStrategy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AgentLearningStrategy.js","sourceRoot":"","sources":["../../../src/core/strategies/AgentLearningStrategy.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}
@@ -0,0 +1,116 @@
1
+ /**
2
+ * AgentLifecycleStrategy - Strategy interface for agent lifecycle management
3
+ *
4
+ * Handles initialization, state transitions, hooks, and cleanup.
5
+ * Part of Phase 2 (B1.3a) layered architecture refactoring.
6
+ *
7
+ * @module core/strategies/AgentLifecycleStrategy
8
+ * @version 1.0.0
9
+ */
10
+ import type { AgentStatus, PreTaskData, PostTaskData, TaskErrorData } from '../../types';
11
+ /**
12
+ * Agent configuration subset needed for lifecycle
13
+ */
14
+ export interface LifecycleConfig {
15
+ agentId: string;
16
+ agentType: string;
17
+ enableHooks?: boolean;
18
+ initializationTimeout?: number;
19
+ shutdownTimeout?: number;
20
+ }
21
+ /**
22
+ * Lifecycle state change event
23
+ */
24
+ export interface LifecycleEvent {
25
+ previousStatus: AgentStatus;
26
+ newStatus: AgentStatus;
27
+ timestamp: Date;
28
+ reason?: string;
29
+ }
30
+ /**
31
+ * AgentLifecycleStrategy interface
32
+ *
33
+ * Implementations:
34
+ * - DefaultLifecycleStrategy: Standard initialization flow
35
+ * - PooledLifecycleStrategy: For agent pooling (reusable agents)
36
+ * - DistributedLifecycleStrategy: For distributed deployments
37
+ */
38
+ export interface AgentLifecycleStrategy {
39
+ /**
40
+ * Initialize the agent lifecycle
41
+ * @param config - Lifecycle configuration
42
+ */
43
+ initialize(config: LifecycleConfig): Promise<void>;
44
+ /**
45
+ * Get current agent status
46
+ */
47
+ getStatus(): AgentStatus;
48
+ /**
49
+ * Transition to a new status
50
+ * @param status - Target status
51
+ * @param reason - Optional reason for transition
52
+ */
53
+ transitionTo(status: AgentStatus, reason?: string): Promise<void>;
54
+ /**
55
+ * Wait for agent to reach a specific status
56
+ * @param status - Target status to wait for
57
+ * @param timeout - Timeout in milliseconds
58
+ */
59
+ waitForStatus(status: AgentStatus, timeout: number): Promise<void>;
60
+ /**
61
+ * Wait for agent to be ready (initialized)
62
+ * @param timeout - Timeout in milliseconds
63
+ */
64
+ waitForReady(timeout: number): Promise<void>;
65
+ /**
66
+ * Shutdown the agent
67
+ */
68
+ shutdown(): Promise<void>;
69
+ /**
70
+ * Reset agent state for reuse (pooled lifecycle only)
71
+ */
72
+ reset?(): Promise<void>;
73
+ /**
74
+ * Called before task execution
75
+ * @param data - Pre-task data
76
+ */
77
+ onPreTask?(data: PreTaskData): Promise<void>;
78
+ /**
79
+ * Called after successful task execution
80
+ * @param data - Post-task data
81
+ */
82
+ onPostTask?(data: PostTaskData): Promise<void>;
83
+ /**
84
+ * Called when task execution fails
85
+ * @param data - Error data
86
+ */
87
+ onTaskError?(data: TaskErrorData): Promise<void>;
88
+ /**
89
+ * Subscribe to lifecycle events
90
+ * @param handler - Event handler
91
+ */
92
+ onLifecycleChange?(handler: (event: LifecycleEvent) => void): void;
93
+ /**
94
+ * Check if agent can accept new tasks
95
+ */
96
+ canAcceptTask(): boolean;
97
+ /**
98
+ * Get lifecycle metrics
99
+ */
100
+ getMetrics?(): LifecycleMetrics;
101
+ }
102
+ /**
103
+ * Lifecycle metrics
104
+ */
105
+ export interface LifecycleMetrics {
106
+ initializationTime: number;
107
+ uptime: number;
108
+ stateTransitions: number;
109
+ tasksExecuted: number;
110
+ lastActivity: Date;
111
+ }
112
+ /**
113
+ * Factory function type for creating lifecycle strategies
114
+ */
115
+ export type LifecycleStrategyFactory = (config?: Partial<LifecycleConfig>) => AgentLifecycleStrategy;
116
+ //# sourceMappingURL=AgentLifecycleStrategy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AgentLifecycleStrategy.d.ts","sourceRoot":"","sources":["../../../src/core/strategies/AgentLifecycleStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,WAAW,CAAC;IAC5B,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,SAAS,IAAI,WAAW,CAAC;IAEzB;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;OAEG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAIxB;;;OAGG;IACH,SAAS,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,UAAU,CAAC,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;OAGG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;OAGG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI,CAAC;IAEnE;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;OAEG;IACH,UAAU,CAAC,IAAI,gBAAgB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,sBAAsB,CAAC"}
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ /**
3
+ * AgentLifecycleStrategy - Strategy interface for agent lifecycle management
4
+ *
5
+ * Handles initialization, state transitions, hooks, and cleanup.
6
+ * Part of Phase 2 (B1.3a) layered architecture refactoring.
7
+ *
8
+ * @module core/strategies/AgentLifecycleStrategy
9
+ * @version 1.0.0
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ //# sourceMappingURL=AgentLifecycleStrategy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AgentLifecycleStrategy.js","sourceRoot":"","sources":["../../../src/core/strategies/AgentLifecycleStrategy.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}