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
@@ -1 +1 @@
1
- {"version":3,"file":"AgentLifecycleManager.js","sourceRoot":"","sources":["../../../src/agents/lifecycle/AgentLifecycleManager.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"AgentLifecycleManager.js","sourceRoot":"","sources":["../../../src/agents/lifecycle/AgentLifecycleManager.ts"],"names":[],"mappings":"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"}
@@ -78,7 +78,7 @@ async function copyAgentTemplates(config, force = false) {
78
78
  }
79
79
  if (!sourcePath) {
80
80
  console.warn(chalk_1.default.yellow(' ⚠️ No agent templates found in package paths'));
81
- console.warn(chalk_1.default.yellow(' ℹ️ Falling back to programmatic generation (all 19 agents)'));
81
+ console.warn(chalk_1.default.yellow(' ℹ️ Falling back to programmatic generation (all 20 agents)'));
82
82
  await createBasicAgents(force);
83
83
  return;
84
84
  }
@@ -189,7 +189,7 @@ function getAQEHooks() {
189
189
  hooks: [
190
190
  {
191
191
  type: "command",
192
- command: `/bin/bash -c 'echo "🔄 PreCompact: Review CLAUDE.md for 19 QE agents, skills, and learning protocols"'`
192
+ command: `/bin/bash -c 'echo "🔄 PreCompact: Review CLAUDE.md for 20 QE agents, skills, and learning protocols"'`
193
193
  }
194
194
  ]
195
195
  },
@@ -198,7 +198,7 @@ function getAQEHooks() {
198
198
  hooks: [
199
199
  {
200
200
  type: "command",
201
- command: `/bin/bash -c 'echo "🔄 Auto-Compact: 19 QE agents available. Use: npx aqe learn status"'`
201
+ command: `/bin/bash -c 'echo "🔄 Auto-Compact: 20 QE agents available. Use: npx aqe learn status"'`
202
202
  }
203
203
  ]
204
204
  }
@@ -97,7 +97,7 @@ async function initializeMemoryDatabase() {
97
97
  console.log(chalk_1.default.gray(` • Database: ${getSharedMemoryManagerPath()}`));
98
98
  console.log(chalk_1.default.gray(` • Tables: 20+ tables (memory_entries, patterns, learning_experiences, q_values, etc.)`));
99
99
  console.log(chalk_1.default.gray(` • Access control: 5 levels (private, team, swarm, public, system)`));
100
- console.log(chalk_1.default.gray(` • Used by: CLI, MCP server, all 19 QE agents`));
100
+ console.log(chalk_1.default.gray(` • Used by: CLI, MCP server, all 20 QE agents`));
101
101
  }
102
102
  // DEPRECATED (v2.2.0): AgentDB initialization removed
103
103
  // All learning data now persists to the unified memory.db via SwarmMemoryManager.
@@ -0,0 +1,84 @@
1
+ /**
2
+ * Binary Cache Builder - Cache Generation from SQLite
3
+ *
4
+ * Builds binary cache from pattern data with:
5
+ * - Index pre-computation
6
+ * - Atomic file writes
7
+ * - Checksum generation
8
+ *
9
+ * Performance:
10
+ * - Build time: ~50-100ms for 1000 patterns
11
+ * - Atomic writes prevent corruption
12
+ * - Optimized index generation
13
+ *
14
+ * @module core/cache/BinaryCacheBuilder
15
+ * @version 1.0.0
16
+ */
17
+ import type { BinaryCacheBuilder, CacheBuildResult, CacheIndexData, PatternEntry, AgentConfigEntry } from './BinaryMetadataCache';
18
+ import type { TestPattern } from '../memory/IPatternStore';
19
+ /**
20
+ * Implementation of BinaryCacheBuilder interface
21
+ *
22
+ * Builds binary cache with:
23
+ * - Pattern serialization from SQLite data
24
+ * - Pre-computed indexes for fast lookup
25
+ * - Atomic file writes with temporary files
26
+ * - Checksum computation for validation
27
+ */
28
+ export declare class BinaryMetadataCacheBuilder implements BinaryCacheBuilder {
29
+ private serializer;
30
+ private currentVersion;
31
+ constructor();
32
+ /**
33
+ * Build cache from SQLite patterns
34
+ *
35
+ * Process:
36
+ * 1. Convert TestPatterns to PatternEntries
37
+ * 2. Build search indexes
38
+ * 3. Serialize to binary format
39
+ * 4. Compute checksum
40
+ * 5. Write atomically to disk
41
+ *
42
+ * @param patterns - Array of test patterns from SQLite
43
+ * @param agentConfigs - Array of agent configurations
44
+ * @param outputPath - Cache file output path
45
+ * @returns Build result with metrics
46
+ */
47
+ buildCache(patterns: TestPattern[], agentConfigs: AgentConfigEntry[], outputPath: string): Promise<CacheBuildResult>;
48
+ /**
49
+ * Build cache indexes
50
+ *
51
+ * Pre-computes indexes for:
52
+ * - Domain → pattern IDs
53
+ * - Type → pattern IDs
54
+ * - Framework → pattern IDs
55
+ *
56
+ * Enables O(1) filtering by domain/type/framework.
57
+ *
58
+ * @param patterns - Array of pattern entries
59
+ * @returns Index data structure
60
+ */
61
+ buildIndexes(patterns: PatternEntry[]): CacheIndexData;
62
+ /**
63
+ * Write cache to disk atomically
64
+ *
65
+ * Atomic write pattern:
66
+ * 1. Write to temporary file (*.tmp)
67
+ * 2. Verify write success
68
+ * 3. Rename to final path (atomic operation)
69
+ *
70
+ * Prevents partial writes and corruption.
71
+ *
72
+ * @param buffer - Binary cache buffer
73
+ * @param outputPath - Target file path
74
+ * @returns True if write successful
75
+ */
76
+ writeAtomic(buffer: Uint8Array, outputPath: string): Promise<boolean>;
77
+ }
78
+ /**
79
+ * Create a new BinaryCacheBuilder instance
80
+ *
81
+ * @returns BinaryCacheBuilder instance
82
+ */
83
+ export declare function createCacheBuilder(): BinaryMetadataCacheBuilder;
84
+ //# sourceMappingURL=BinaryCacheBuilder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BinaryCacheBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/cache/BinaryCacheBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3D;;;;;;;;GAQG;AACH,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,cAAc,CAAkD;;IAMxE;;;;;;;;;;;;;;OAcG;IACG,UAAU,CACd,QAAQ,EAAE,WAAW,EAAE,EACvB,YAAY,EAAE,gBAAgB,EAAE,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC;IAmF5B;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,cAAc;IAgCtD;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CA2C5E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,0BAA0B,CAE/D"}
@@ -0,0 +1,225 @@
1
+ "use strict";
2
+ /**
3
+ * Binary Cache Builder - Cache Generation from SQLite
4
+ *
5
+ * Builds binary cache from pattern data with:
6
+ * - Index pre-computation
7
+ * - Atomic file writes
8
+ * - Checksum generation
9
+ *
10
+ * Performance:
11
+ * - Build time: ~50-100ms for 1000 patterns
12
+ * - Atomic writes prevent corruption
13
+ * - Optimized index generation
14
+ *
15
+ * @module core/cache/BinaryCacheBuilder
16
+ * @version 1.0.0
17
+ */
18
+ Object.defineProperty(exports, "__esModule", { value: true });
19
+ exports.BinaryMetadataCacheBuilder = void 0;
20
+ exports.createCacheBuilder = createCacheBuilder;
21
+ const fs_1 = require("fs");
22
+ const path_1 = require("path");
23
+ const MessagePackSerializer_1 = require("./MessagePackSerializer");
24
+ const BinaryMetadataCache_1 = require("./BinaryMetadataCache");
25
+ /**
26
+ * Implementation of BinaryCacheBuilder interface
27
+ *
28
+ * Builds binary cache with:
29
+ * - Pattern serialization from SQLite data
30
+ * - Pre-computed indexes for fast lookup
31
+ * - Atomic file writes with temporary files
32
+ * - Checksum computation for validation
33
+ */
34
+ class BinaryMetadataCacheBuilder {
35
+ constructor() {
36
+ this.currentVersion = { major: 1, minor: 0, patch: 0 };
37
+ this.serializer = new MessagePackSerializer_1.MessagePackSerializer();
38
+ }
39
+ /**
40
+ * Build cache from SQLite patterns
41
+ *
42
+ * Process:
43
+ * 1. Convert TestPatterns to PatternEntries
44
+ * 2. Build search indexes
45
+ * 3. Serialize to binary format
46
+ * 4. Compute checksum
47
+ * 5. Write atomically to disk
48
+ *
49
+ * @param patterns - Array of test patterns from SQLite
50
+ * @param agentConfigs - Array of agent configurations
51
+ * @param outputPath - Cache file output path
52
+ * @returns Build result with metrics
53
+ */
54
+ async buildCache(patterns, agentConfigs, outputPath) {
55
+ const startTime = Date.now();
56
+ try {
57
+ // 1. Convert patterns to cache entries
58
+ const patternEntries = patterns.map(BinaryMetadataCache_1.testPatternToEntry);
59
+ // 2. Build indexes
60
+ const indexes = this.buildIndexes(patternEntries);
61
+ // 3. Create cache structure (without checksum)
62
+ const cacheWithoutChecksum = {
63
+ version: this.serializer.encodeVersion(this.currentVersion),
64
+ timestamp: Date.now(),
65
+ checksum: '', // Placeholder, will compute after serialization
66
+ patterns: patternEntries,
67
+ agentConfigs,
68
+ indexes,
69
+ };
70
+ // 4. Serialize to binary
71
+ const buffer = this.serializer.encode(cacheWithoutChecksum);
72
+ // 5. Compute checksum
73
+ const checksum = await this.serializer.computeChecksum(buffer);
74
+ // 6. Update cache with actual checksum
75
+ const cacheWithChecksum = {
76
+ ...cacheWithoutChecksum,
77
+ checksum,
78
+ };
79
+ // 7. Serialize again with correct checksum
80
+ const finalBuffer = this.serializer.encode(cacheWithChecksum);
81
+ // 8. Write atomically
82
+ const writeSuccess = await this.writeAtomic(finalBuffer, outputPath);
83
+ if (!writeSuccess) {
84
+ throw new Error('Atomic write failed');
85
+ }
86
+ const duration = Date.now() - startTime;
87
+ console.log('[BinaryCacheBuilder] Cache built successfully:', {
88
+ duration: `${duration}ms`,
89
+ patternCount: patterns.length,
90
+ agentConfigCount: agentConfigs.length,
91
+ cacheFileSize: finalBuffer.length,
92
+ checksum,
93
+ });
94
+ return {
95
+ success: true,
96
+ duration,
97
+ patternCount: patterns.length,
98
+ agentConfigCount: agentConfigs.length,
99
+ cacheFileSize: finalBuffer.length,
100
+ version: this.currentVersion,
101
+ checksum,
102
+ };
103
+ }
104
+ catch (error) {
105
+ const duration = Date.now() - startTime;
106
+ const errorMessage = error instanceof Error ? error.message : 'Unknown error';
107
+ console.error('[BinaryCacheBuilder] Cache build failed:', {
108
+ error: errorMessage,
109
+ duration: `${duration}ms`,
110
+ });
111
+ return {
112
+ success: false,
113
+ duration,
114
+ patternCount: patterns.length,
115
+ agentConfigCount: agentConfigs.length,
116
+ cacheFileSize: 0,
117
+ version: this.currentVersion,
118
+ checksum: '',
119
+ error: errorMessage,
120
+ };
121
+ }
122
+ }
123
+ /**
124
+ * Build cache indexes
125
+ *
126
+ * Pre-computes indexes for:
127
+ * - Domain → pattern IDs
128
+ * - Type → pattern IDs
129
+ * - Framework → pattern IDs
130
+ *
131
+ * Enables O(1) filtering by domain/type/framework.
132
+ *
133
+ * @param patterns - Array of pattern entries
134
+ * @returns Index data structure
135
+ */
136
+ buildIndexes(patterns) {
137
+ const domainIndex = new Map();
138
+ const typeIndex = new Map();
139
+ const frameworkIndex = new Map();
140
+ for (const pattern of patterns) {
141
+ // Domain index
142
+ if (!domainIndex.has(pattern.domain)) {
143
+ domainIndex.set(pattern.domain, []);
144
+ }
145
+ domainIndex.get(pattern.domain).push(pattern.id);
146
+ // Type index
147
+ if (!typeIndex.has(pattern.type)) {
148
+ typeIndex.set(pattern.type, []);
149
+ }
150
+ typeIndex.get(pattern.type).push(pattern.id);
151
+ // Framework index
152
+ if (!frameworkIndex.has(pattern.framework)) {
153
+ frameworkIndex.set(pattern.framework, []);
154
+ }
155
+ frameworkIndex.get(pattern.framework).push(pattern.id);
156
+ }
157
+ return {
158
+ domainIndex,
159
+ typeIndex,
160
+ frameworkIndex,
161
+ };
162
+ }
163
+ /**
164
+ * Write cache to disk atomically
165
+ *
166
+ * Atomic write pattern:
167
+ * 1. Write to temporary file (*.tmp)
168
+ * 2. Verify write success
169
+ * 3. Rename to final path (atomic operation)
170
+ *
171
+ * Prevents partial writes and corruption.
172
+ *
173
+ * @param buffer - Binary cache buffer
174
+ * @param outputPath - Target file path
175
+ * @returns True if write successful
176
+ */
177
+ async writeAtomic(buffer, outputPath) {
178
+ const tempPath = `${outputPath}.tmp`;
179
+ try {
180
+ // 1. Ensure directory exists
181
+ const dir = (0, path_1.dirname)(outputPath);
182
+ await fs_1.promises.mkdir(dir, { recursive: true });
183
+ // 2. Write to temporary file
184
+ await fs_1.promises.writeFile(tempPath, buffer);
185
+ // 3. Verify write (read back and compare size)
186
+ const stats = await fs_1.promises.stat(tempPath);
187
+ if (stats.size !== buffer.length) {
188
+ throw new Error(`Write verification failed: expected ${buffer.length} bytes, got ${stats.size} bytes`);
189
+ }
190
+ // 4. Atomic rename
191
+ await fs_1.promises.rename(tempPath, outputPath);
192
+ // 5. Create backup of previous cache (if exists)
193
+ try {
194
+ await fs_1.promises.access(outputPath);
195
+ const backupPath = `${outputPath}.bak`;
196
+ await fs_1.promises.copyFile(outputPath, backupPath);
197
+ }
198
+ catch {
199
+ // No previous cache, skip backup
200
+ }
201
+ return true;
202
+ }
203
+ catch (error) {
204
+ console.error('[BinaryCacheBuilder] Atomic write failed:', error);
205
+ // Clean up temporary file
206
+ try {
207
+ await fs_1.promises.unlink(tempPath);
208
+ }
209
+ catch {
210
+ // Ignore cleanup errors
211
+ }
212
+ return false;
213
+ }
214
+ }
215
+ }
216
+ exports.BinaryMetadataCacheBuilder = BinaryMetadataCacheBuilder;
217
+ /**
218
+ * Create a new BinaryCacheBuilder instance
219
+ *
220
+ * @returns BinaryCacheBuilder instance
221
+ */
222
+ function createCacheBuilder() {
223
+ return new BinaryMetadataCacheBuilder();
224
+ }
225
+ //# sourceMappingURL=BinaryCacheBuilder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BinaryCacheBuilder.js","sourceRoot":"","sources":["../../../src/core/cache/BinaryCacheBuilder.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,161 @@
1
+ /**
2
+ * Binary Metadata Cache - Implementation
3
+ *
4
+ * High-performance binary caching for pattern metadata.
5
+ * Achieves 10x faster test discovery (500ms → 50ms) through:
6
+ * - Binary serialization (MessagePack-based, not FlatBuffers for simplicity)
7
+ * - Zero-copy Float32Array embeddings
8
+ * - Pre-built indexes for O(1) lookup
9
+ * - Atomic writes with checksum validation
10
+ *
11
+ * @module core/cache/BinaryCacheImpl
12
+ */
13
+ import { type BinaryCache, type PatternEntry, type AgentConfigEntry, type CacheIndexData, type CacheVersion, type CacheSerializer, type CacheValidator, type CacheInvalidator, type CacheInvalidation, type ValidationResult, type BinaryCacheConfig, type CacheMetrics, type BinaryCacheReader, type BinaryCacheBuilder, type CacheBuildResult, type TRMPatternEntry, type TRMCacheIndexData } from './BinaryMetadataCache';
14
+ import type { TestPattern } from '../memory/IPatternStore';
15
+ /**
16
+ * Binary Cache Serializer Implementation
17
+ *
18
+ * Uses a simple binary format:
19
+ * - Header (64 bytes): magic, version, timestamp, checksum offset, data length
20
+ * - Data: MessagePack-like encoding of cache structure
21
+ * - Checksum: SHA-256 at end
22
+ */
23
+ export declare class BinaryCacheSerializerImpl implements CacheSerializer {
24
+ private textEncoder;
25
+ private textDecoder;
26
+ encode(cache: BinaryCache): Uint8Array;
27
+ decode(buffer: Uint8Array): BinaryCache;
28
+ computeChecksum(buffer: Uint8Array): Promise<string>;
29
+ encodeVersion(version: CacheVersion): number;
30
+ decodeVersion(encoded: number): CacheVersion;
31
+ private serializeCache;
32
+ private deserializeCache;
33
+ }
34
+ /**
35
+ * Binary Cache Validator Implementation
36
+ */
37
+ export declare class BinaryCacheValidatorImpl implements CacheValidator {
38
+ private serializer;
39
+ validate(buffer: Uint8Array, expectedChecksum: string): Promise<ValidationResult>;
40
+ isVersionCompatible(cacheVersion: CacheVersion, codeVersion: CacheVersion): boolean;
41
+ isValidPatternEntry(entry: PatternEntry): boolean;
42
+ }
43
+ /**
44
+ * Binary Cache Invalidator Implementation
45
+ */
46
+ export declare class BinaryCacheInvalidatorImpl implements CacheInvalidator {
47
+ private staleEvents;
48
+ private lastRebuildTime;
49
+ markStale(event: CacheInvalidation): void;
50
+ isCacheValid(cacheTimestamp: number): boolean;
51
+ isCacheFresh(cacheTimestamp: number, ttl: number): boolean;
52
+ shouldBackgroundRebuild(cacheTimestamp: number, ttl: number): boolean;
53
+ scheduleCacheRebuild(background: boolean): void;
54
+ getStaleEvents(): CacheInvalidation[];
55
+ }
56
+ /**
57
+ * Binary Cache Reader Implementation
58
+ */
59
+ export declare class BinaryCacheReaderImpl implements BinaryCacheReader {
60
+ private cache;
61
+ private config;
62
+ private patternMap;
63
+ private agentConfigMap;
64
+ private fileSize;
65
+ private loadTime;
66
+ initialize(cachePath: string, config: BinaryCacheConfig): Promise<boolean>;
67
+ getPattern(id: string): PatternEntry | null;
68
+ getPatternsByDomain(domain: string): PatternEntry[];
69
+ getPatternsByType(type: string): PatternEntry[];
70
+ getPatternsByFramework(framework: string): PatternEntry[];
71
+ getAllPatterns(): PatternEntry[];
72
+ getAgentConfig(agentId: string): AgentConfigEntry | null;
73
+ getCacheMetadata(): {
74
+ version: CacheVersion;
75
+ timestamp: number;
76
+ patternCount: number;
77
+ agentConfigCount: number;
78
+ fileSize: number;
79
+ };
80
+ isValid(): boolean;
81
+ close(): void;
82
+ getLoadTime(): number;
83
+ }
84
+ /**
85
+ * Binary Cache Builder Implementation
86
+ */
87
+ export declare class BinaryCacheBuilderImpl implements BinaryCacheBuilder {
88
+ private serializer;
89
+ buildCache(patterns: TestPattern[], agentConfigs: AgentConfigEntry[], outputPath: string): Promise<CacheBuildResult>;
90
+ buildIndexes(patterns: PatternEntry[]): CacheIndexData;
91
+ writeAtomic(buffer: Uint8Array, outputPath: string): Promise<boolean>;
92
+ }
93
+ /**
94
+ * TRM Binary Cache Builder Implementation
95
+ */
96
+ export declare class TRMBinaryCacheBuilderImpl extends BinaryCacheBuilderImpl {
97
+ buildTRMIndexes(patterns: TRMPatternEntry[]): TRMCacheIndexData;
98
+ }
99
+ /**
100
+ * Binary Cache Manager - High-level API
101
+ *
102
+ * Provides a unified interface for cache operations with automatic
103
+ * fallback to SQLite on errors.
104
+ */
105
+ export declare class BinaryCacheManager {
106
+ private reader;
107
+ private builder;
108
+ private validator;
109
+ private invalidator;
110
+ private config;
111
+ private metrics;
112
+ constructor(config?: Partial<BinaryCacheConfig>);
113
+ private initializeMetrics;
114
+ /**
115
+ * Load cache from disk
116
+ */
117
+ load(): Promise<boolean>;
118
+ /**
119
+ * Build and save cache from patterns
120
+ */
121
+ buildAndSave(patterns: TestPattern[], agentConfigs?: AgentConfigEntry[]): Promise<CacheBuildResult>;
122
+ /**
123
+ * Get pattern by ID
124
+ */
125
+ getPattern(id: string): PatternEntry | null;
126
+ /**
127
+ * Get patterns by domain
128
+ */
129
+ getPatternsByDomain(domain: string): PatternEntry[];
130
+ /**
131
+ * Get patterns by type
132
+ */
133
+ getPatternsByType(type: string): PatternEntry[];
134
+ /**
135
+ * Get all patterns
136
+ */
137
+ getAllPatterns(): PatternEntry[];
138
+ /**
139
+ * Check if cache is valid and fresh
140
+ */
141
+ isValid(): boolean;
142
+ /**
143
+ * Invalidate cache
144
+ */
145
+ invalidate(trigger: CacheInvalidation['trigger']): void;
146
+ /**
147
+ * Check if background rebuild is recommended
148
+ */
149
+ shouldRebuild(): boolean;
150
+ /**
151
+ * Get cache metrics
152
+ */
153
+ getMetrics(): CacheMetrics;
154
+ /**
155
+ * Close cache and release resources
156
+ */
157
+ close(): void;
158
+ private updateHitRate;
159
+ }
160
+ export declare function createBinaryCacheManager(config?: Partial<BinaryCacheConfig>): BinaryCacheManager;
161
+ //# sourceMappingURL=BinaryCacheImpl.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BinaryCacheImpl.d.ts","sourceRoot":"","sources":["../../../src/core/cache/BinaryCacheImpl.ts"],"names":[],"mappings":"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"}