agentdb 3.0.0-alpha.2 → 3.0.0-alpha.20

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 (519) hide show
  1. package/README.md +208 -2593
  2. package/dist/src/backends/GraphBackend.d.ts +8 -8
  3. package/dist/src/backends/GraphBackend.d.ts.map +1 -1
  4. package/dist/src/backends/GraphBackend.js +15 -16
  5. package/dist/src/backends/GraphBackend.js.map +1 -1
  6. package/dist/src/backends/LearningBackend.d.ts +2 -2
  7. package/dist/src/backends/LearningBackend.d.ts.map +1 -1
  8. package/dist/src/backends/LearningBackend.js +10 -11
  9. package/dist/src/backends/LearningBackend.js.map +1 -1
  10. package/dist/src/backends/VectorBackend.d.ts +10 -0
  11. package/dist/src/backends/VectorBackend.d.ts.map +1 -1
  12. package/dist/src/backends/detector.d.ts +3 -25
  13. package/dist/src/backends/detector.d.ts.map +1 -1
  14. package/dist/src/backends/detector.js +15 -119
  15. package/dist/src/backends/detector.js.map +1 -1
  16. package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts +55 -1
  17. package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts.map +1 -1
  18. package/dist/src/backends/graph/GraphDatabaseAdapter.js +133 -7
  19. package/dist/src/backends/graph/GraphDatabaseAdapter.js.map +1 -1
  20. package/dist/src/backends/hnswlib/HNSWLibBackend.d.ts +2 -2
  21. package/dist/src/backends/hnswlib/HNSWLibBackend.d.ts.map +1 -1
  22. package/dist/src/backends/hnswlib/HNSWLibBackend.js +12 -21
  23. package/dist/src/backends/hnswlib/HNSWLibBackend.js.map +1 -1
  24. package/dist/src/backends/index.d.ts +3 -25
  25. package/dist/src/backends/index.d.ts.map +1 -1
  26. package/dist/src/backends/index.js +1 -23
  27. package/dist/src/backends/index.js.map +1 -1
  28. package/dist/src/backends/ruvector/RuVectorBackend.d.ts +4 -4
  29. package/dist/src/backends/ruvector/RuVectorBackend.d.ts.map +1 -1
  30. package/dist/src/backends/ruvector/RuVectorBackend.js +2 -2
  31. package/dist/src/backends/ruvector/RuVectorBackend.js.map +1 -1
  32. package/dist/src/backends/ruvector/RuVectorLearning.d.ts.map +1 -1
  33. package/dist/src/backends/ruvector/RuVectorLearning.js +5 -10
  34. package/dist/src/backends/ruvector/RuVectorLearning.js.map +1 -1
  35. package/dist/src/backends/rvf/SelfLearningRvfBackend.d.ts.map +1 -1
  36. package/dist/src/backends/rvf/SelfLearningRvfBackend.js +45 -2
  37. package/dist/src/backends/rvf/SelfLearningRvfBackend.js.map +1 -1
  38. package/dist/src/backends/rvf/SqlJsRvfBackend.d.ts +26 -0
  39. package/dist/src/backends/rvf/SqlJsRvfBackend.d.ts.map +1 -1
  40. package/dist/src/backends/rvf/SqlJsRvfBackend.js +93 -31
  41. package/dist/src/backends/rvf/SqlJsRvfBackend.js.map +1 -1
  42. package/dist/src/benchmark/BenchmarkSuite.d.ts.map +1 -1
  43. package/dist/src/benchmark/BenchmarkSuite.js +0 -2
  44. package/dist/src/benchmark/BenchmarkSuite.js.map +1 -1
  45. package/dist/src/benchmarks/wasm-vector-benchmark.d.ts +10 -0
  46. package/dist/src/benchmarks/wasm-vector-benchmark.d.ts.map +1 -0
  47. package/dist/src/benchmarks/wasm-vector-benchmark.js +196 -0
  48. package/dist/src/benchmarks/wasm-vector-benchmark.js.map +1 -0
  49. package/dist/src/browser/AdvancedFeatures.d.ts.map +1 -1
  50. package/dist/src/browser/AdvancedFeatures.js +10 -3
  51. package/dist/src/browser/AdvancedFeatures.js.map +1 -1
  52. package/dist/src/browser/AttentionBrowser.d.ts.map +1 -1
  53. package/dist/src/browser/AttentionBrowser.js +13 -5
  54. package/dist/src/browser/AttentionBrowser.js.map +1 -1
  55. package/dist/src/browser/HNSWIndex.d.ts +1 -31
  56. package/dist/src/browser/HNSWIndex.d.ts.map +1 -1
  57. package/dist/src/browser/HNSWIndex.js +18 -136
  58. package/dist/src/browser/HNSWIndex.js.map +1 -1
  59. package/dist/src/browser/ProductQuantization.d.ts.map +1 -1
  60. package/dist/src/browser/ProductQuantization.js +1 -0
  61. package/dist/src/browser/ProductQuantization.js.map +1 -1
  62. package/dist/src/browser/index.d.ts +3 -3
  63. package/dist/src/browser/index.d.ts.map +1 -1
  64. package/dist/src/browser/index.js +1 -2
  65. package/dist/src/browser/index.js.map +1 -1
  66. package/dist/src/cli/agentdb-cli.d.ts +2 -3
  67. package/dist/src/cli/agentdb-cli.d.ts.map +1 -1
  68. package/dist/src/cli/agentdb-cli.js +142 -96
  69. package/dist/src/cli/agentdb-cli.js.map +1 -1
  70. package/dist/src/cli/commands/attention.js +15 -5
  71. package/dist/src/cli/commands/attention.js.map +1 -1
  72. package/dist/src/cli/commands/doctor.d.ts +0 -2
  73. package/dist/src/cli/commands/doctor.d.ts.map +1 -1
  74. package/dist/src/cli/commands/doctor.js +6 -111
  75. package/dist/src/cli/commands/doctor.js.map +1 -1
  76. package/dist/src/cli/commands/hyperbolic.d.ts.map +1 -1
  77. package/dist/src/cli/commands/hyperbolic.js +15 -3
  78. package/dist/src/cli/commands/hyperbolic.js.map +1 -1
  79. package/dist/src/cli/commands/init.d.ts +1 -2
  80. package/dist/src/cli/commands/init.d.ts.map +1 -1
  81. package/dist/src/cli/commands/init.js +7 -30
  82. package/dist/src/cli/commands/init.js.map +1 -1
  83. package/dist/src/cli/commands/install-embeddings.d.ts +1 -1
  84. package/dist/src/cli/commands/install-embeddings.d.ts.map +1 -1
  85. package/dist/src/cli/commands/install-embeddings.js +17 -11
  86. package/dist/src/cli/commands/install-embeddings.js.map +1 -1
  87. package/dist/src/cli/commands/learn.d.ts.map +1 -1
  88. package/dist/src/cli/commands/learn.js +12 -6
  89. package/dist/src/cli/commands/learn.js.map +1 -1
  90. package/dist/src/cli/commands/migrate.d.ts.map +1 -1
  91. package/dist/src/cli/commands/migrate.js +31 -10
  92. package/dist/src/cli/commands/migrate.js.map +1 -1
  93. package/dist/src/cli/commands/route.d.ts.map +1 -1
  94. package/dist/src/cli/commands/route.js +6 -1
  95. package/dist/src/cli/commands/route.js.map +1 -1
  96. package/dist/src/cli/commands/simulate-report.js +14 -2
  97. package/dist/src/cli/commands/simulate-report.js.map +1 -1
  98. package/dist/src/cli/commands/simulate-wizard.js.map +1 -1
  99. package/dist/src/cli/commands/simulate.d.ts +7 -0
  100. package/dist/src/cli/commands/simulate.d.ts.map +1 -0
  101. package/dist/src/cli/commands/simulate.js +100 -0
  102. package/dist/src/cli/commands/simulate.js.map +1 -0
  103. package/dist/src/cli/commands/status.js +1 -5
  104. package/dist/src/cli/commands/status.js.map +1 -1
  105. package/dist/src/cli/lib/attention-config.d.ts +2 -2
  106. package/dist/src/cli/lib/attention-config.d.ts.map +1 -1
  107. package/dist/src/cli/lib/attention-config.js +1 -2
  108. package/dist/src/cli/lib/attention-config.js.map +1 -1
  109. package/dist/src/cli/lib/config-manager.d.ts +110 -0
  110. package/dist/src/cli/lib/config-manager.d.ts.map +1 -0
  111. package/dist/src/cli/lib/config-manager.js +512 -0
  112. package/dist/src/cli/lib/config-manager.js.map +1 -0
  113. package/dist/src/cli/lib/config-validator.d.ts +1 -1
  114. package/dist/src/cli/lib/config-validator.d.ts.map +1 -1
  115. package/dist/src/cli/lib/health-monitor.d.ts +149 -0
  116. package/dist/src/cli/lib/health-monitor.d.ts.map +1 -0
  117. package/dist/src/cli/lib/health-monitor.js +380 -0
  118. package/dist/src/cli/lib/health-monitor.js.map +1 -0
  119. package/dist/src/cli/lib/history-tracker.d.ts +103 -0
  120. package/dist/src/cli/lib/history-tracker.d.ts.map +1 -0
  121. package/dist/src/cli/lib/history-tracker.js +352 -0
  122. package/dist/src/cli/lib/history-tracker.js.map +1 -0
  123. package/dist/src/cli/lib/report-store.d.ts.map +1 -1
  124. package/dist/src/cli/lib/report-store.js +3 -5
  125. package/dist/src/cli/lib/report-store.js.map +1 -1
  126. package/dist/src/cli/lib/simulation-registry.d.ts +1 -1
  127. package/dist/src/cli/lib/simulation-registry.d.ts.map +1 -1
  128. package/dist/src/cli/lib/simulation-registry.js +0 -1
  129. package/dist/src/cli/lib/simulation-registry.js.map +1 -1
  130. package/dist/src/cli/lib/simulation-runner.d.ts +1 -1
  131. package/dist/src/cli/lib/simulation-runner.d.ts.map +1 -1
  132. package/dist/src/cli/lib/simulation-runner.js +1 -4
  133. package/dist/src/cli/lib/simulation-runner.js.map +1 -1
  134. package/dist/src/compatibility/DeprecationWarnings.d.ts.map +1 -1
  135. package/dist/src/compatibility/V1toV2Adapter.d.ts +2 -2
  136. package/dist/src/compatibility/V1toV2Adapter.d.ts.map +1 -1
  137. package/dist/src/compatibility/V1toV2Adapter.js +1 -14
  138. package/dist/src/compatibility/V1toV2Adapter.js.map +1 -1
  139. package/dist/src/compatibility/VersionDetector.d.ts +1 -1
  140. package/dist/src/compatibility/VersionDetector.d.ts.map +1 -1
  141. package/dist/src/compatibility/VersionDetector.js +3 -3
  142. package/dist/src/compatibility/VersionDetector.js.map +1 -1
  143. package/dist/src/compatibility/index.d.ts +3 -0
  144. package/dist/src/compatibility/index.d.ts.map +1 -1
  145. package/dist/src/compatibility/index.js +11 -0
  146. package/dist/src/compatibility/index.js.map +1 -1
  147. package/dist/src/controllers/AttentionService.d.ts +98 -122
  148. package/dist/src/controllers/AttentionService.d.ts.map +1 -1
  149. package/dist/src/controllers/AttentionService.js +463 -238
  150. package/dist/src/controllers/AttentionService.js.map +1 -1
  151. package/dist/src/controllers/CausalMemoryGraph.d.ts +4 -4
  152. package/dist/src/controllers/CausalMemoryGraph.d.ts.map +1 -1
  153. package/dist/src/controllers/CausalMemoryGraph.js +7 -8
  154. package/dist/src/controllers/CausalMemoryGraph.js.map +1 -1
  155. package/dist/src/controllers/CausalRecall.d.ts +3 -2
  156. package/dist/src/controllers/CausalRecall.d.ts.map +1 -1
  157. package/dist/src/controllers/CausalRecall.js +21 -10
  158. package/dist/src/controllers/CausalRecall.js.map +1 -1
  159. package/dist/src/controllers/ContextSynthesizer.d.ts +1 -1
  160. package/dist/src/controllers/ContextSynthesizer.d.ts.map +1 -1
  161. package/dist/src/controllers/EmbeddingService.d.ts +29 -0
  162. package/dist/src/controllers/EmbeddingService.d.ts.map +1 -1
  163. package/dist/src/controllers/EmbeddingService.js +149 -34
  164. package/dist/src/controllers/EmbeddingService.js.map +1 -1
  165. package/dist/src/controllers/EnhancedEmbeddingService.d.ts.map +1 -1
  166. package/dist/src/controllers/EnhancedEmbeddingService.js +14 -7
  167. package/dist/src/controllers/EnhancedEmbeddingService.js.map +1 -1
  168. package/dist/src/controllers/ExplainableRecall.d.ts +5 -4
  169. package/dist/src/controllers/ExplainableRecall.d.ts.map +1 -1
  170. package/dist/src/controllers/ExplainableRecall.js +12 -20
  171. package/dist/src/controllers/ExplainableRecall.js.map +1 -1
  172. package/dist/src/controllers/HNSWIndex.d.ts +5 -4
  173. package/dist/src/controllers/HNSWIndex.d.ts.map +1 -1
  174. package/dist/src/controllers/HNSWIndex.js +6 -9
  175. package/dist/src/controllers/HNSWIndex.js.map +1 -1
  176. package/dist/src/controllers/LearningSystem.d.ts +10 -105
  177. package/dist/src/controllers/LearningSystem.d.ts.map +1 -1
  178. package/dist/src/controllers/LearningSystem.js +28 -39
  179. package/dist/src/controllers/LearningSystem.js.map +1 -1
  180. package/dist/src/controllers/MMRDiversityRanker.d.ts +1 -1
  181. package/dist/src/controllers/MMRDiversityRanker.d.ts.map +1 -1
  182. package/dist/src/controllers/MemoryController.d.ts +15 -2
  183. package/dist/src/controllers/MemoryController.d.ts.map +1 -1
  184. package/dist/src/controllers/MemoryController.js +33 -3
  185. package/dist/src/controllers/MemoryController.js.map +1 -1
  186. package/dist/src/controllers/MetadataFilter.d.ts +3 -3
  187. package/dist/src/controllers/MetadataFilter.d.ts.map +1 -1
  188. package/dist/src/controllers/MetadataFilter.js +6 -9
  189. package/dist/src/controllers/MetadataFilter.js.map +1 -1
  190. package/dist/src/controllers/MincutService.d.ts +92 -0
  191. package/dist/src/controllers/MincutService.d.ts.map +1 -0
  192. package/dist/src/controllers/MincutService.js +336 -0
  193. package/dist/src/controllers/MincutService.js.map +1 -0
  194. package/dist/src/controllers/NightlyLearner.d.ts +3 -4
  195. package/dist/src/controllers/NightlyLearner.d.ts.map +1 -1
  196. package/dist/src/controllers/NightlyLearner.js +17 -22
  197. package/dist/src/controllers/NightlyLearner.js.map +1 -1
  198. package/dist/src/controllers/QUICClient.d.ts +7 -10
  199. package/dist/src/controllers/QUICClient.d.ts.map +1 -1
  200. package/dist/src/controllers/QUICClient.js +3 -3
  201. package/dist/src/controllers/QUICClient.js.map +1 -1
  202. package/dist/src/controllers/QUICServer.d.ts +4 -4
  203. package/dist/src/controllers/QUICServer.d.ts.map +1 -1
  204. package/dist/src/controllers/QUICServer.js +14 -22
  205. package/dist/src/controllers/QUICServer.js.map +1 -1
  206. package/dist/src/controllers/ReasoningBank.d.ts +2 -9
  207. package/dist/src/controllers/ReasoningBank.d.ts.map +1 -1
  208. package/dist/src/controllers/ReasoningBank.js +39 -35
  209. package/dist/src/controllers/ReasoningBank.js.map +1 -1
  210. package/dist/src/controllers/ReflexionMemory.d.ts +51 -1
  211. package/dist/src/controllers/ReflexionMemory.d.ts.map +1 -1
  212. package/dist/src/controllers/ReflexionMemory.js +307 -33
  213. package/dist/src/controllers/ReflexionMemory.js.map +1 -1
  214. package/dist/src/controllers/SkillLibrary.d.ts +5 -11
  215. package/dist/src/controllers/SkillLibrary.d.ts.map +1 -1
  216. package/dist/src/controllers/SkillLibrary.js +39 -48
  217. package/dist/src/controllers/SkillLibrary.js.map +1 -1
  218. package/dist/src/controllers/SparsificationService.d.ts +151 -0
  219. package/dist/src/controllers/SparsificationService.d.ts.map +1 -0
  220. package/dist/src/controllers/SparsificationService.js +375 -0
  221. package/dist/src/controllers/SparsificationService.js.map +1 -0
  222. package/dist/src/controllers/SyncCoordinator.d.ts +3 -2
  223. package/dist/src/controllers/SyncCoordinator.d.ts.map +1 -1
  224. package/dist/src/controllers/SyncCoordinator.js +2 -2
  225. package/dist/src/controllers/SyncCoordinator.js.map +1 -1
  226. package/dist/src/controllers/WASMVectorSearch.d.ts +7 -6
  227. package/dist/src/controllers/WASMVectorSearch.d.ts.map +1 -1
  228. package/dist/src/controllers/WASMVectorSearch.js +2 -4
  229. package/dist/src/controllers/WASMVectorSearch.js.map +1 -1
  230. package/dist/src/controllers/attention/AttentionCache.d.ts +38 -0
  231. package/dist/src/controllers/attention/AttentionCache.d.ts.map +1 -0
  232. package/dist/src/controllers/attention/AttentionCache.js +80 -0
  233. package/dist/src/controllers/attention/AttentionCache.js.map +1 -0
  234. package/dist/src/controllers/attention/AttentionConfig.d.ts +127 -0
  235. package/dist/src/controllers/attention/AttentionConfig.d.ts.map +1 -0
  236. package/dist/src/controllers/attention/AttentionConfig.js +124 -0
  237. package/dist/src/controllers/attention/AttentionConfig.js.map +1 -0
  238. package/dist/src/controllers/attention/AttentionCore.d.ts +89 -0
  239. package/dist/src/controllers/attention/AttentionCore.d.ts.map +1 -0
  240. package/dist/src/controllers/attention/AttentionCore.js +289 -0
  241. package/dist/src/controllers/attention/AttentionCore.js.map +1 -0
  242. package/dist/src/controllers/attention/AttentionHelpers.d.ts +55 -0
  243. package/dist/src/controllers/attention/AttentionHelpers.d.ts.map +1 -0
  244. package/dist/src/controllers/attention/AttentionHelpers.js +148 -0
  245. package/dist/src/controllers/attention/AttentionHelpers.js.map +1 -0
  246. package/dist/src/controllers/attention/AttentionMetrics.d.ts +55 -0
  247. package/dist/src/controllers/attention/AttentionMetrics.d.ts.map +1 -0
  248. package/dist/src/controllers/attention/AttentionMetrics.js +72 -0
  249. package/dist/src/controllers/attention/AttentionMetrics.js.map +1 -0
  250. package/dist/src/controllers/attention/AttentionWASM.d.ts +98 -0
  251. package/dist/src/controllers/attention/AttentionWASM.d.ts.map +1 -0
  252. package/dist/src/controllers/attention/AttentionWASM.js +147 -0
  253. package/dist/src/controllers/attention/AttentionWASM.js.map +1 -0
  254. package/dist/src/controllers/attention/CrossAttentionController.d.ts +1 -1
  255. package/dist/src/controllers/attention/CrossAttentionController.d.ts.map +1 -1
  256. package/dist/src/controllers/attention/MultiHeadAttentionController.d.ts +1 -1
  257. package/dist/src/controllers/attention/MultiHeadAttentionController.d.ts.map +1 -1
  258. package/dist/src/controllers/attention/MultiHeadAttentionController.js +5 -8
  259. package/dist/src/controllers/attention/MultiHeadAttentionController.js.map +1 -1
  260. package/dist/src/controllers/attention/SelfAttentionController.d.ts +1 -1
  261. package/dist/src/controllers/attention/SelfAttentionController.d.ts.map +1 -1
  262. package/dist/src/controllers/attention/index.d.ts +9 -0
  263. package/dist/src/controllers/attention/index.d.ts.map +1 -1
  264. package/dist/src/controllers/attention/index.js +8 -0
  265. package/dist/src/controllers/attention/index.js.map +1 -1
  266. package/dist/src/controllers/frontier-index.d.ts +14 -0
  267. package/dist/src/controllers/frontier-index.d.ts.map +1 -0
  268. package/dist/src/controllers/frontier-index.js +10 -0
  269. package/dist/src/controllers/frontier-index.js.map +1 -0
  270. package/dist/src/controllers/index.d.ts +7 -1
  271. package/dist/src/controllers/index.d.ts.map +1 -1
  272. package/dist/src/controllers/index.js +5 -1
  273. package/dist/src/controllers/index.js.map +1 -1
  274. package/dist/src/controllers/prerequisites.d.ts +76 -0
  275. package/dist/src/controllers/prerequisites.d.ts.map +1 -0
  276. package/dist/src/controllers/prerequisites.js +235 -0
  277. package/dist/src/controllers/prerequisites.js.map +1 -0
  278. package/dist/src/core/AgentDB.d.ts +11 -36
  279. package/dist/src/core/AgentDB.d.ts.map +1 -1
  280. package/dist/src/core/AgentDB.js +31 -89
  281. package/dist/src/core/AgentDB.js.map +1 -1
  282. package/dist/src/core/QueryCache.d.ts +1 -1
  283. package/dist/src/core/QueryCache.d.ts.map +1 -1
  284. package/dist/src/core/QueryCache.js +2 -6
  285. package/dist/src/core/QueryCache.js.map +1 -1
  286. package/dist/src/db-fallback.d.ts +40 -3
  287. package/dist/src/db-fallback.d.ts.map +1 -1
  288. package/dist/src/db-fallback.js +308 -84
  289. package/dist/src/db-fallback.js.map +1 -1
  290. package/dist/src/db-test.d.ts +13 -0
  291. package/dist/src/db-test.d.ts.map +1 -0
  292. package/dist/src/db-test.js +55 -0
  293. package/dist/src/db-test.js.map +1 -0
  294. package/dist/src/db-unified.d.ts +76 -0
  295. package/dist/src/db-unified.d.ts.map +1 -0
  296. package/dist/src/db-unified.js +281 -0
  297. package/dist/src/db-unified.js.map +1 -0
  298. package/dist/src/embedding/EmbeddingSpaceIdentity.d.ts +58 -0
  299. package/dist/src/embedding/EmbeddingSpaceIdentity.d.ts.map +1 -0
  300. package/dist/src/embedding/EmbeddingSpaceIdentity.js +137 -0
  301. package/dist/src/embedding/EmbeddingSpaceIdentity.js.map +1 -0
  302. package/dist/src/embedding/index.d.ts +3 -0
  303. package/dist/src/embedding/index.d.ts.map +1 -0
  304. package/dist/src/embedding/index.js +2 -0
  305. package/dist/src/embedding/index.js.map +1 -0
  306. package/dist/src/examples/quic-sync-example.d.ts +9 -0
  307. package/dist/src/examples/quic-sync-example.d.ts.map +1 -0
  308. package/dist/src/examples/quic-sync-example.js +169 -0
  309. package/dist/src/examples/quic-sync-example.js.map +1 -0
  310. package/dist/src/examples/wasm-vector-usage.d.ts +12 -0
  311. package/dist/src/examples/wasm-vector-usage.d.ts.map +1 -0
  312. package/dist/src/examples/wasm-vector-usage.js +190 -0
  313. package/dist/src/examples/wasm-vector-usage.js.map +1 -0
  314. package/dist/src/governance/MetaHarnessGateway.d.ts +55 -0
  315. package/dist/src/governance/MetaHarnessGateway.d.ts.map +1 -0
  316. package/dist/src/governance/MetaHarnessGateway.js +65 -0
  317. package/dist/src/governance/MetaHarnessGateway.js.map +1 -0
  318. package/dist/src/governance/RvfExperimentBranch.d.ts +65 -0
  319. package/dist/src/governance/RvfExperimentBranch.d.ts.map +1 -0
  320. package/dist/src/governance/RvfExperimentBranch.js +115 -0
  321. package/dist/src/governance/RvfExperimentBranch.js.map +1 -0
  322. package/dist/src/index.d.ts +7 -25
  323. package/dist/src/index.d.ts.map +1 -1
  324. package/dist/src/index.js +9 -10
  325. package/dist/src/index.js.map +1 -1
  326. package/dist/src/mcp/agentdb-mcp-server.js +162 -159
  327. package/dist/src/mcp/agentdb-mcp-server.js.map +1 -1
  328. package/dist/src/mcp/learning-tools-handlers.d.ts +16 -0
  329. package/dist/src/mcp/learning-tools-handlers.d.ts.map +1 -0
  330. package/dist/src/mcp/learning-tools-handlers.js +105 -0
  331. package/dist/src/mcp/learning-tools-handlers.js.map +1 -0
  332. package/dist/src/model/ModelCacheLoader.d.ts +24 -0
  333. package/dist/src/model/ModelCacheLoader.d.ts.map +1 -0
  334. package/dist/src/model/ModelCacheLoader.js +123 -0
  335. package/dist/src/model/ModelCacheLoader.js.map +1 -0
  336. package/dist/src/observability/integration.d.ts +3 -3
  337. package/dist/src/observability/integration.d.ts.map +1 -1
  338. package/dist/src/observability/integration.js +2 -0
  339. package/dist/src/observability/integration.js.map +1 -1
  340. package/dist/src/observability/telemetry.d.ts +3 -3
  341. package/dist/src/observability/telemetry.d.ts.map +1 -1
  342. package/dist/src/observability/telemetry.js +3 -5
  343. package/dist/src/observability/telemetry.js.map +1 -1
  344. package/dist/src/optimizations/BatchOperations.d.ts +6 -6
  345. package/dist/src/optimizations/BatchOperations.d.ts.map +1 -1
  346. package/dist/src/optimizations/BatchOperations.js +6 -5
  347. package/dist/src/optimizations/BatchOperations.js.map +1 -1
  348. package/dist/src/optimizations/Quantization.d.ts +330 -0
  349. package/dist/src/optimizations/Quantization.d.ts.map +1 -0
  350. package/dist/src/optimizations/Quantization.js +793 -0
  351. package/dist/src/optimizations/Quantization.js.map +1 -0
  352. package/dist/src/optimizations/QueryOptimizer.d.ts +4 -4
  353. package/dist/src/optimizations/QueryOptimizer.d.ts.map +1 -1
  354. package/dist/src/optimizations/QueryOptimizer.js +1 -3
  355. package/dist/src/optimizations/QueryOptimizer.js.map +1 -1
  356. package/dist/src/optimizations/ToolCache.d.ts +4 -4
  357. package/dist/src/optimizations/ToolCache.d.ts.map +1 -1
  358. package/dist/src/optimizations/ToolCache.js.map +1 -1
  359. package/dist/src/quantization/vector-quantization.d.ts.map +1 -1
  360. package/dist/src/quantization/vector-quantization.js +1 -5
  361. package/dist/src/quantization/vector-quantization.js.map +1 -1
  362. package/dist/src/schemas/inline.d.ts +3 -0
  363. package/dist/src/schemas/inline.d.ts.map +1 -0
  364. package/dist/src/schemas/inline.js +10 -0
  365. package/dist/src/schemas/inline.js.map +1 -0
  366. package/dist/src/search/HybridSearch.d.ts +6 -6
  367. package/dist/src/search/HybridSearch.d.ts.map +1 -1
  368. package/dist/src/search/HybridSearch.js.map +1 -1
  369. package/dist/src/security/input-validation.d.ts +34 -12
  370. package/dist/src/security/input-validation.d.ts.map +1 -1
  371. package/dist/src/security/input-validation.js +46 -1
  372. package/dist/src/security/input-validation.js.map +1 -1
  373. package/dist/src/security/limits.d.ts +150 -0
  374. package/dist/src/security/limits.d.ts.map +1 -0
  375. package/dist/src/security/limits.js +288 -0
  376. package/dist/src/security/limits.js.map +1 -0
  377. package/dist/src/security/mcp-policy.d.ts +13 -0
  378. package/dist/src/security/mcp-policy.d.ts.map +1 -0
  379. package/dist/src/security/mcp-policy.js +66 -0
  380. package/dist/src/security/mcp-policy.js.map +1 -0
  381. package/dist/src/security/path-security.d.ts +100 -0
  382. package/dist/src/security/path-security.d.ts.map +1 -0
  383. package/dist/src/security/path-security.js +339 -0
  384. package/dist/src/security/path-security.js.map +1 -0
  385. package/dist/src/security/validation.d.ts +95 -0
  386. package/dist/src/security/validation.d.ts.map +1 -0
  387. package/dist/src/security/validation.js +315 -0
  388. package/dist/src/security/validation.js.map +1 -0
  389. package/dist/src/services/AttentionService.d.ts.map +1 -1
  390. package/dist/src/services/AttentionService.js +2 -4
  391. package/dist/src/services/AttentionService.js.map +1 -1
  392. package/dist/src/services/LLMRouter.d.ts +2 -2
  393. package/dist/src/services/LLMRouter.d.ts.map +1 -1
  394. package/dist/src/services/LLMRouter.js +3 -9
  395. package/dist/src/services/LLMRouter.js.map +1 -1
  396. package/dist/src/services/audit-logger.service.d.ts +168 -0
  397. package/dist/src/services/audit-logger.service.d.ts.map +1 -0
  398. package/dist/src/services/audit-logger.service.js +331 -0
  399. package/dist/src/services/audit-logger.service.js.map +1 -0
  400. package/dist/src/services/enhanced-embeddings.d.ts +271 -0
  401. package/dist/src/services/enhanced-embeddings.d.ts.map +1 -0
  402. package/dist/src/services/enhanced-embeddings.js +1035 -0
  403. package/dist/src/services/enhanced-embeddings.js.map +1 -0
  404. package/dist/src/services/federated-learning.d.ts +172 -0
  405. package/dist/src/services/federated-learning.d.ts.map +1 -0
  406. package/dist/src/services/federated-learning.js +342 -0
  407. package/dist/src/services/federated-learning.js.map +1 -0
  408. package/dist/src/simd/simd-vector-ops.d.ts.map +1 -1
  409. package/dist/src/simd/simd-vector-ops.js +0 -2
  410. package/dist/src/simd/simd-vector-ops.js.map +1 -1
  411. package/dist/src/types/attention.d.ts +249 -0
  412. package/dist/src/types/attention.d.ts.map +1 -0
  413. package/dist/src/types/attention.js +43 -0
  414. package/dist/src/types/attention.js.map +1 -0
  415. package/dist/src/types/database.types.d.ts +11 -11
  416. package/dist/src/types/database.types.d.ts.map +1 -1
  417. package/dist/src/types/database.types.js +2 -4
  418. package/dist/src/types/database.types.js.map +1 -1
  419. package/dist/src/types/graph.d.ts +29 -0
  420. package/dist/src/types/graph.d.ts.map +1 -0
  421. package/dist/src/types/graph.js +8 -0
  422. package/dist/src/types/graph.js.map +1 -0
  423. package/dist/src/types/quic.d.ts +518 -0
  424. package/dist/src/types/quic.d.ts.map +1 -0
  425. package/dist/src/types/quic.js +272 -0
  426. package/dist/src/types/quic.js.map +1 -0
  427. package/dist/src/utils/attention-metrics.d.ts +76 -0
  428. package/dist/src/utils/attention-metrics.d.ts.map +1 -0
  429. package/dist/src/utils/attention-metrics.js +178 -0
  430. package/dist/src/utils/attention-metrics.js.map +1 -0
  431. package/dist/src/wasm-loader.d.ts +0 -1
  432. package/dist/src/wasm-loader.d.ts.map +1 -1
  433. package/dist/src/wasm-loader.js +0 -2
  434. package/dist/src/wasm-loader.js.map +1 -1
  435. package/dist/src/wrappers/agentdb-fast.d.ts +5 -4
  436. package/dist/src/wrappers/agentdb-fast.d.ts.map +1 -1
  437. package/dist/src/wrappers/agentdb-fast.js +6 -13
  438. package/dist/src/wrappers/agentdb-fast.js.map +1 -1
  439. package/dist/src/wrappers/attention-fallbacks.d.ts +0 -8
  440. package/dist/src/wrappers/attention-fallbacks.d.ts.map +1 -1
  441. package/dist/src/wrappers/attention-fallbacks.js +3 -6
  442. package/dist/src/wrappers/attention-fallbacks.js.map +1 -1
  443. package/dist/src/wrappers/attention-native.d.ts +111 -0
  444. package/dist/src/wrappers/attention-native.d.ts.map +1 -0
  445. package/dist/src/wrappers/attention-native.js +273 -0
  446. package/dist/src/wrappers/attention-native.js.map +1 -0
  447. package/dist/src/wrappers/embedding-service.d.ts +4 -4
  448. package/dist/src/wrappers/embedding-service.d.ts.map +1 -1
  449. package/dist/src/wrappers/embedding-service.js +2 -8
  450. package/dist/src/wrappers/embedding-service.js.map +1 -1
  451. package/dist/src/wrappers/gnn-wrapper.d.ts.map +1 -1
  452. package/dist/src/wrappers/gnn-wrapper.js +3 -7
  453. package/dist/src/wrappers/gnn-wrapper.js.map +1 -1
  454. package/package.json +87 -18
  455. package/scripts/postinstall.cjs +13 -144
  456. package/dist/src/cli/tests/agentdb-cli.test.d.ts +0 -8
  457. package/dist/src/cli/tests/agentdb-cli.test.d.ts.map +0 -1
  458. package/dist/src/cli/tests/agentdb-cli.test.js +0 -50
  459. package/dist/src/cli/tests/agentdb-cli.test.js.map +0 -1
  460. package/dist/src/cli/tests/attention-cli.test.d.ts +0 -5
  461. package/dist/src/cli/tests/attention-cli.test.d.ts.map +0 -1
  462. package/dist/src/cli/tests/attention-cli.test.js +0 -257
  463. package/dist/src/cli/tests/attention-cli.test.js.map +0 -1
  464. package/dist/src/coordination/MultiDatabaseCoordinator.d.ts +0 -348
  465. package/dist/src/coordination/MultiDatabaseCoordinator.d.ts.map +0 -1
  466. package/dist/src/coordination/MultiDatabaseCoordinator.js +0 -803
  467. package/dist/src/coordination/MultiDatabaseCoordinator.js.map +0 -1
  468. package/dist/src/coordination/index.d.ts +0 -10
  469. package/dist/src/coordination/index.d.ts.map +0 -1
  470. package/dist/src/coordination/index.js +0 -10
  471. package/dist/src/coordination/index.js.map +0 -1
  472. package/dist/src/tests/attention-service.test.d.ts +0 -7
  473. package/dist/src/tests/attention-service.test.d.ts.map +0 -1
  474. package/dist/src/tests/attention-service.test.js +0 -401
  475. package/dist/src/tests/attention-service.test.js.map +0 -1
  476. package/dist/src/tests/integration/compatibility/backwards-compat.integration.test.d.ts +0 -7
  477. package/dist/src/tests/integration/compatibility/backwards-compat.integration.test.d.ts.map +0 -1
  478. package/dist/src/tests/integration/compatibility/backwards-compat.integration.test.js +0 -283
  479. package/dist/src/tests/integration/compatibility/backwards-compat.integration.test.js.map +0 -1
  480. package/dist/src/tests/query-cache.test.d.ts +0 -7
  481. package/dist/src/tests/query-cache.test.d.ts.map +0 -1
  482. package/dist/src/tests/query-cache.test.js +0 -343
  483. package/dist/src/tests/query-cache.test.js.map +0 -1
  484. package/dist/src/tests/ruvector-integration.test.d.ts +0 -14
  485. package/dist/src/tests/ruvector-integration.test.d.ts.map +0 -1
  486. package/dist/src/tests/ruvector-integration.test.js +0 -1156
  487. package/dist/src/tests/ruvector-integration.test.js.map +0 -1
  488. package/dist/src/tests/unit/auth/crypto.utils.test.d.ts +0 -6
  489. package/dist/src/tests/unit/auth/crypto.utils.test.d.ts.map +0 -1
  490. package/dist/src/tests/unit/auth/crypto.utils.test.js +0 -310
  491. package/dist/src/tests/unit/auth/crypto.utils.test.js.map +0 -1
  492. package/dist/src/tests/unit/compatibility/deprecation-warnings.test.d.ts +0 -5
  493. package/dist/src/tests/unit/compatibility/deprecation-warnings.test.d.ts.map +0 -1
  494. package/dist/src/tests/unit/compatibility/deprecation-warnings.test.js +0 -207
  495. package/dist/src/tests/unit/compatibility/deprecation-warnings.test.js.map +0 -1
  496. package/dist/src/tests/unit/compatibility/migration-utils.test.d.ts +0 -5
  497. package/dist/src/tests/unit/compatibility/migration-utils.test.d.ts.map +0 -1
  498. package/dist/src/tests/unit/compatibility/migration-utils.test.js +0 -264
  499. package/dist/src/tests/unit/compatibility/migration-utils.test.js.map +0 -1
  500. package/dist/src/tests/unit/compatibility/v1-adapter.test.d.ts +0 -7
  501. package/dist/src/tests/unit/compatibility/v1-adapter.test.d.ts.map +0 -1
  502. package/dist/src/tests/unit/compatibility/v1-adapter.test.js +0 -228
  503. package/dist/src/tests/unit/compatibility/v1-adapter.test.js.map +0 -1
  504. package/dist/src/tests/unit/compatibility/version-detector.test.d.ts +0 -10
  505. package/dist/src/tests/unit/compatibility/version-detector.test.d.ts.map +0 -1
  506. package/dist/src/tests/unit/compatibility/version-detector.test.js +0 -162
  507. package/dist/src/tests/unit/compatibility/version-detector.test.js.map +0 -1
  508. package/dist/src/tests/vector-quantization.test.d.ts +0 -5
  509. package/dist/src/tests/vector-quantization.test.d.ts.map +0 -1
  510. package/dist/src/tests/vector-quantization.test.js +0 -338
  511. package/dist/src/tests/vector-quantization.test.js.map +0 -1
  512. package/dist/src/tests/wasm-vector-search.test.d.ts +0 -7
  513. package/dist/src/tests/wasm-vector-search.test.d.ts.map +0 -1
  514. package/dist/src/tests/wasm-vector-search.test.js +0 -193
  515. package/dist/src/tests/wasm-vector-search.test.js.map +0 -1
  516. package/dist/src/utils/crypto.utils.d.ts +0 -122
  517. package/dist/src/utils/crypto.utils.d.ts.map +0 -1
  518. package/dist/src/utils/crypto.utils.js +0 -296
  519. package/dist/src/utils/crypto.utils.js.map +0 -1
@@ -1,257 +0,0 @@
1
- /**
2
- * Tests for Attention CLI Commands
3
- */
4
- import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
5
- import * as fs from 'fs/promises';
6
- import * as path from 'path';
7
- import { loadAttentionConfig, saveAttentionConfig, validateConfig, updateMechanismConfig, toggleMechanism, setDefaultMechanism, resetConfig, DEFAULT_ATTENTION_CONFIG, } from '../lib/attention-config.js';
8
- const TEST_CONFIG_DIR = path.join(process.cwd(), '.test-agentdb');
9
- const TEST_CONFIG_PATH = path.join(TEST_CONFIG_DIR, 'attention-config.json');
10
- describe('Attention Configuration', () => {
11
- beforeEach(async () => {
12
- // Create test directory
13
- await fs.mkdir(TEST_CONFIG_DIR, { recursive: true });
14
- });
15
- afterEach(async () => {
16
- // Clean up test directory
17
- try {
18
- await fs.rm(TEST_CONFIG_DIR, { recursive: true, force: true });
19
- }
20
- catch (error) {
21
- // Ignore errors
22
- }
23
- });
24
- describe('loadAttentionConfig', () => {
25
- it('should return default config when file does not exist', async () => {
26
- const config = await loadAttentionConfig(TEST_CONFIG_PATH);
27
- expect(config).toEqual(DEFAULT_ATTENTION_CONFIG);
28
- });
29
- it('should load config from file', async () => {
30
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
31
- const config = await loadAttentionConfig(TEST_CONFIG_PATH);
32
- expect(config).toEqual(DEFAULT_ATTENTION_CONFIG);
33
- });
34
- it('should validate loaded config', async () => {
35
- const invalidConfig = {
36
- defaultMechanism: 'invalid',
37
- mechanisms: {},
38
- featureFlags: {},
39
- };
40
- await fs.writeFile(TEST_CONFIG_PATH, JSON.stringify(invalidConfig));
41
- await expect(loadAttentionConfig(TEST_CONFIG_PATH)).rejects.toThrow();
42
- });
43
- });
44
- describe('saveAttentionConfig', () => {
45
- it('should save config to file', async () => {
46
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
47
- const exists = await fs.access(TEST_CONFIG_PATH).then(() => true).catch(() => false);
48
- expect(exists).toBe(true);
49
- const saved = JSON.parse(await fs.readFile(TEST_CONFIG_PATH, 'utf-8'));
50
- expect(saved).toEqual(DEFAULT_ATTENTION_CONFIG);
51
- });
52
- it('should create directory if it does not exist', async () => {
53
- const nestedPath = path.join(TEST_CONFIG_DIR, 'nested', 'config.json');
54
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, nestedPath);
55
- const exists = await fs.access(nestedPath).then(() => true).catch(() => false);
56
- expect(exists).toBe(true);
57
- });
58
- });
59
- describe('validateConfig', () => {
60
- it('should validate correct config', () => {
61
- const config = validateConfig(DEFAULT_ATTENTION_CONFIG);
62
- expect(config).toEqual(DEFAULT_ATTENTION_CONFIG);
63
- });
64
- it('should throw on invalid default mechanism', () => {
65
- const invalidConfig = {
66
- ...DEFAULT_ATTENTION_CONFIG,
67
- defaultMechanism: 'invalid',
68
- };
69
- expect(() => validateConfig(invalidConfig)).toThrow('Invalid default mechanism');
70
- });
71
- it('should throw on invalid heads', () => {
72
- const invalidConfig = {
73
- ...DEFAULT_ATTENTION_CONFIG,
74
- mechanisms: {
75
- ...DEFAULT_ATTENTION_CONFIG.mechanisms,
76
- flash: {
77
- ...DEFAULT_ATTENTION_CONFIG.mechanisms.flash,
78
- heads: 0,
79
- },
80
- },
81
- };
82
- expect(() => validateConfig(invalidConfig)).toThrow('Invalid heads');
83
- });
84
- it('should throw on invalid dimension', () => {
85
- const invalidConfig = {
86
- ...DEFAULT_ATTENTION_CONFIG,
87
- mechanisms: {
88
- ...DEFAULT_ATTENTION_CONFIG.mechanisms,
89
- flash: {
90
- ...DEFAULT_ATTENTION_CONFIG.mechanisms.flash,
91
- dimension: 32,
92
- },
93
- },
94
- };
95
- expect(() => validateConfig(invalidConfig)).toThrow('Invalid dimension');
96
- });
97
- it('should throw on invalid hyperbolic curvature', () => {
98
- const invalidConfig = {
99
- ...DEFAULT_ATTENTION_CONFIG,
100
- mechanisms: {
101
- ...DEFAULT_ATTENTION_CONFIG.mechanisms,
102
- hyperbolic: {
103
- ...DEFAULT_ATTENTION_CONFIG.mechanisms.hyperbolic,
104
- curvature: 1.0,
105
- },
106
- },
107
- };
108
- expect(() => validateConfig(invalidConfig)).toThrow('Invalid curvature');
109
- });
110
- it('should throw on invalid sparse sparsity', () => {
111
- const invalidConfig = {
112
- ...DEFAULT_ATTENTION_CONFIG,
113
- mechanisms: {
114
- ...DEFAULT_ATTENTION_CONFIG.mechanisms,
115
- sparse: {
116
- ...DEFAULT_ATTENTION_CONFIG.mechanisms.sparse,
117
- sparsity: 1.5,
118
- },
119
- },
120
- };
121
- expect(() => validateConfig(invalidConfig)).toThrow('Invalid sparsity');
122
- });
123
- });
124
- describe('updateMechanismConfig', () => {
125
- it('should update mechanism configuration', async () => {
126
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
127
- const updated = await updateMechanismConfig('flash', { heads: 16 }, TEST_CONFIG_PATH);
128
- expect(updated.mechanisms.flash.heads).toBe(16);
129
- });
130
- it('should throw on unknown mechanism', async () => {
131
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
132
- await expect(updateMechanismConfig('unknown', {}, TEST_CONFIG_PATH)).rejects.toThrow('Unknown mechanism');
133
- });
134
- it('should validate after update', async () => {
135
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
136
- await expect(updateMechanismConfig('flash', { heads: 0 }, TEST_CONFIG_PATH)).rejects.toThrow('Invalid heads');
137
- });
138
- });
139
- describe('toggleMechanism', () => {
140
- it('should enable mechanism', async () => {
141
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
142
- const config = await toggleMechanism('flash', false, TEST_CONFIG_PATH);
143
- expect(config.mechanisms.flash.enabled).toBe(false);
144
- const enabled = await toggleMechanism('flash', true, TEST_CONFIG_PATH);
145
- expect(enabled.mechanisms.flash.enabled).toBe(true);
146
- });
147
- });
148
- describe('setDefaultMechanism', () => {
149
- it('should set default mechanism', async () => {
150
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
151
- const config = await setDefaultMechanism('hyperbolic', TEST_CONFIG_PATH);
152
- expect(config.defaultMechanism).toBe('hyperbolic');
153
- });
154
- it('should throw on invalid mechanism', async () => {
155
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
156
- await expect(setDefaultMechanism('invalid', TEST_CONFIG_PATH)).rejects.toThrow('Invalid mechanism');
157
- });
158
- });
159
- describe('resetConfig', () => {
160
- it('should reset to default configuration', async () => {
161
- // Save modified config
162
- const modified = {
163
- ...DEFAULT_ATTENTION_CONFIG,
164
- defaultMechanism: 'hyperbolic',
165
- };
166
- await saveAttentionConfig(modified, TEST_CONFIG_PATH);
167
- // Reset
168
- const reset = await resetConfig(TEST_CONFIG_PATH);
169
- expect(reset).toEqual(DEFAULT_ATTENTION_CONFIG);
170
- // Verify file was updated
171
- const loaded = await loadAttentionConfig(TEST_CONFIG_PATH);
172
- expect(loaded).toEqual(DEFAULT_ATTENTION_CONFIG);
173
- });
174
- });
175
- });
176
- describe('Attention CLI Commands', () => {
177
- describe('attention init', () => {
178
- it('should initialize default configuration', async () => {
179
- // Test would execute CLI command and verify output
180
- // Requires CLI testing framework setup
181
- expect(true).toBe(true); // Placeholder
182
- });
183
- });
184
- describe('attention compute', () => {
185
- it('should compute attention for query', async () => {
186
- // Test would execute CLI command with query and verify output
187
- expect(true).toBe(true); // Placeholder
188
- });
189
- it('should compute attention from keys file', async () => {
190
- // Test would create test keys file and execute CLI command
191
- expect(true).toBe(true); // Placeholder
192
- });
193
- it('should handle missing inputs', async () => {
194
- // Test would verify error handling for missing query/keys
195
- expect(true).toBe(true); // Placeholder
196
- });
197
- });
198
- describe('attention benchmark', () => {
199
- it('should benchmark single mechanism', async () => {
200
- // Test would execute benchmark command and verify results
201
- expect(true).toBe(true); // Placeholder
202
- });
203
- it('should benchmark all mechanisms', async () => {
204
- // Test would execute benchmark --all and verify results
205
- expect(true).toBe(true); // Placeholder
206
- });
207
- it('should save results to file', async () => {
208
- // Test would execute benchmark with --output and verify file
209
- expect(true).toBe(true); // Placeholder
210
- });
211
- });
212
- describe('attention optimize', () => {
213
- it('should optimize hyperbolic mechanism', async () => {
214
- // Test would execute optimize command for hyperbolic
215
- expect(true).toBe(true); // Placeholder
216
- });
217
- it('should optimize sparse mechanism', async () => {
218
- // Test would execute optimize command for sparse
219
- expect(true).toBe(true); // Placeholder
220
- });
221
- it('should save optimized configuration', async () => {
222
- // Test would execute optimize with --output and verify file
223
- expect(true).toBe(true); // Placeholder
224
- });
225
- });
226
- });
227
- describe('Error Handling', () => {
228
- it('should handle invalid mechanism', async () => {
229
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
230
- await expect(updateMechanismConfig('invalid', {}, TEST_CONFIG_PATH)).rejects.toThrow();
231
- });
232
- it('should handle invalid configuration values', async () => {
233
- await saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, TEST_CONFIG_PATH);
234
- await expect(updateMechanismConfig('flash', { heads: -1 }, TEST_CONFIG_PATH)).rejects.toThrow();
235
- });
236
- it('should handle file system errors gracefully', async () => {
237
- const invalidPath = '/invalid/path/config.json';
238
- await expect(saveAttentionConfig(DEFAULT_ATTENTION_CONFIG, invalidPath)).rejects.toThrow();
239
- });
240
- });
241
- describe('JSON Output Format', () => {
242
- it('should support --json flag for all commands', async () => {
243
- // Tests would verify JSON output format for each command
244
- expect(true).toBe(true); // Placeholder
245
- });
246
- });
247
- describe('Help Text', () => {
248
- it('should display help for attention command', async () => {
249
- // Test would execute --help and verify output
250
- expect(true).toBe(true); // Placeholder
251
- });
252
- it('should display help for subcommands', async () => {
253
- // Test would execute subcommand --help and verify output
254
- expect(true).toBe(true); // Placeholder
255
- });
256
- });
257
- //# sourceMappingURL=attention-cli.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"attention-cli.test.js","sourceRoot":"","sources":["../../../../src/cli/tests/attention-cli.test.ts"],"names":[],"mappings":"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"}
@@ -1,348 +0,0 @@
1
- /**
2
- * MultiDatabaseCoordinator - Cross-Instance Synchronization and Coordination
3
- *
4
- * Orchestrates multiple AgentDB instances for distributed vector database operations.
5
- * Provides:
6
- * - Instance registration and lifecycle management
7
- * - Cross-instance synchronization with conflict resolution
8
- * - Health monitoring and automatic failover
9
- * - Distributed operations (broadcast insert/delete)
10
- * - Configurable replication strategies
11
- *
12
- * @module coordination/MultiDatabaseCoordinator
13
- */
14
- import type { VectorBackend, VectorStats } from '../backends/VectorBackend.js';
15
- /**
16
- * Status of a database instance
17
- */
18
- export type InstanceStatus = 'online' | 'offline' | 'syncing';
19
- /**
20
- * Conflict resolution strategies for synchronization
21
- */
22
- export type ConflictResolutionStrategy = 'last-write-wins' | 'merge' | 'manual';
23
- /**
24
- * Represents a remote database instance
25
- */
26
- export interface DatabaseInstance {
27
- /** Unique identifier for this instance */
28
- id: string;
29
- /** URL or connection string for the instance */
30
- url: string;
31
- /** Current status of the instance */
32
- status: InstanceStatus;
33
- /** Timestamp of last successful sync */
34
- lastSyncAt: number;
35
- /** Number of vectors in this instance */
36
- vectorCount: number;
37
- /** Version string for compatibility checking */
38
- version: string;
39
- /** Optional metadata about the instance */
40
- metadata?: Record<string, unknown>;
41
- }
42
- /**
43
- * Options for synchronization operations
44
- */
45
- export interface SyncOptions {
46
- /** Conflict resolution strategy */
47
- conflictResolution?: ConflictResolutionStrategy;
48
- /** Maximum number of items per batch */
49
- batchSize?: number;
50
- /** Timeout in milliseconds for sync operation */
51
- timeoutMs?: number;
52
- /** Whether to force full sync (ignore lastSyncAt) */
53
- forceFullSync?: boolean;
54
- /** Filter to sync only specific namespaces */
55
- namespaceFilter?: string[];
56
- /** Progress callback */
57
- onProgress?: (progress: SyncProgress) => void;
58
- }
59
- /**
60
- * Progress information during synchronization
61
- */
62
- export interface SyncProgress {
63
- /** Current phase of synchronization */
64
- phase: 'preparing' | 'fetching' | 'comparing' | 'resolving' | 'applying' | 'completed' | 'error';
65
- /** Items processed so far */
66
- current: number;
67
- /** Total items to process */
68
- total: number;
69
- /** Optional message */
70
- message?: string;
71
- /** Error message if phase is 'error' */
72
- error?: string;
73
- }
74
- /**
75
- * Result of a synchronization operation
76
- */
77
- export interface SyncResult {
78
- /** Whether sync completed successfully */
79
- success: boolean;
80
- /** Instance ID that was synced */
81
- instanceId: string;
82
- /** Number of items synced */
83
- itemsSynced: number;
84
- /** Number of conflicts detected */
85
- conflictsDetected: number;
86
- /** Number of conflicts resolved */
87
- conflictsResolved: number;
88
- /** Duration in milliseconds */
89
- durationMs: number;
90
- /** Bytes transferred */
91
- bytesTransferred: number;
92
- /** Error message if failed */
93
- error?: string;
94
- /** Detailed conflict information (for manual resolution) */
95
- unresolvedConflicts?: ConflictInfo[];
96
- }
97
- /**
98
- * Information about a sync conflict
99
- */
100
- export interface ConflictInfo {
101
- /** Vector ID with conflict */
102
- vectorId: string;
103
- /** Local vector data */
104
- local: VectorData;
105
- /** Remote vector data */
106
- remote: VectorData;
107
- /** Suggested resolution */
108
- suggestion: 'keep-local' | 'keep-remote' | 'merge';
109
- }
110
- /**
111
- * Vector data for conflict resolution
112
- */
113
- export interface VectorData {
114
- /** Vector embedding */
115
- embedding: Float32Array;
116
- /** Associated metadata */
117
- metadata?: Record<string, unknown>;
118
- /** Last modified timestamp */
119
- timestamp: number;
120
- }
121
- /**
122
- * Configuration for MultiDatabaseCoordinator
123
- */
124
- export interface MultiDatabaseCoordinatorConfig {
125
- /** Replication factor (how many instances should have each vector) */
126
- replicationFactor?: number;
127
- /** Interval between automatic syncs (0 to disable) */
128
- syncIntervalMs?: number;
129
- /** Default conflict resolution strategy */
130
- conflictResolution?: ConflictResolutionStrategy;
131
- /** Health check interval in milliseconds */
132
- healthCheckIntervalMs?: number;
133
- /** Timeout for health checks */
134
- healthCheckTimeoutMs?: number;
135
- /** Whether to enable automatic failover */
136
- autoFailover?: boolean;
137
- /** Maximum retries for failed operations */
138
- maxRetries?: number;
139
- /** Retry delay in milliseconds */
140
- retryDelayMs?: number;
141
- }
142
- /**
143
- * Callback for instance status changes
144
- */
145
- export type StatusChangeCallback = (instanceId: string, oldStatus: InstanceStatus, newStatus: InstanceStatus) => void;
146
- /**
147
- * Result of an operation executed on all instances
148
- */
149
- export interface DistributedOperationResult<T> {
150
- /** Results keyed by instance ID */
151
- results: Map<string, T>;
152
- /** Errors keyed by instance ID */
153
- errors: Map<string, Error>;
154
- /** Number of successful operations */
155
- successCount: number;
156
- /** Number of failed operations */
157
- failureCount: number;
158
- }
159
- /**
160
- * MultiDatabaseCoordinator - Manages multiple AgentDB instances
161
- *
162
- * Provides coordination, synchronization, and health monitoring for
163
- * distributed vector database deployments.
164
- *
165
- * @example
166
- * ```typescript
167
- * const coordinator = new MultiDatabaseCoordinator(primaryDb, {
168
- * replicationFactor: 2,
169
- * syncIntervalMs: 30000,
170
- * conflictResolution: 'last-write-wins'
171
- * });
172
- *
173
- * // Register secondary instances
174
- * coordinator.registerInstance({
175
- * id: 'secondary-1',
176
- * url: 'http://db1.example.com:8080',
177
- * status: 'online',
178
- * lastSyncAt: 0,
179
- * vectorCount: 0,
180
- * version: '2.0.0'
181
- * });
182
- *
183
- * // Start health monitoring
184
- * coordinator.startHealthCheck(5000);
185
- *
186
- * // Sync all instances
187
- * const results = await coordinator.syncAll();
188
- * ```
189
- */
190
- export declare class MultiDatabaseCoordinator {
191
- private primaryDb;
192
- private instances;
193
- private config;
194
- private healthCheckInterval;
195
- private syncInterval;
196
- private statusChangeCallbacks;
197
- private isSyncing;
198
- private vectorTimestamps;
199
- /**
200
- * Create a new MultiDatabaseCoordinator
201
- *
202
- * @param primaryDb - Primary vector database backend
203
- * @param config - Configuration options
204
- */
205
- constructor(primaryDb: VectorBackend, config?: MultiDatabaseCoordinatorConfig);
206
- /**
207
- * Register a new database instance
208
- *
209
- * @param instance - Instance configuration
210
- * @throws Error if instance with same ID already exists
211
- */
212
- registerInstance(instance: DatabaseInstance): void;
213
- /**
214
- * Unregister a database instance
215
- *
216
- * @param id - Instance ID to unregister
217
- * @throws Error if instance is currently syncing
218
- */
219
- unregisterInstance(id: string): void;
220
- /**
221
- * Get all registered instances
222
- *
223
- * @returns Array of database instances
224
- */
225
- getInstances(): DatabaseInstance[];
226
- /**
227
- * Get a specific instance by ID
228
- *
229
- * @param id - Instance ID
230
- * @returns Instance or null if not found
231
- */
232
- getInstanceStatus(id: string): DatabaseInstance | null;
233
- /**
234
- * Get only online instances
235
- *
236
- * @returns Array of online instances
237
- */
238
- getOnlineInstances(): DatabaseInstance[];
239
- /**
240
- * Update instance status
241
- *
242
- * @param id - Instance ID
243
- * @param status - New status
244
- */
245
- private updateInstanceStatus;
246
- /**
247
- * Synchronize data TO a remote instance
248
- *
249
- * @param targetId - Target instance ID
250
- * @param options - Sync options
251
- * @returns Sync result
252
- */
253
- syncToInstance(targetId: string, options?: SyncOptions): Promise<SyncResult>;
254
- /**
255
- * Synchronize data FROM a remote instance
256
- *
257
- * @param sourceId - Source instance ID
258
- * @param options - Sync options
259
- * @returns Sync result
260
- */
261
- syncFromInstance(sourceId: string, options?: SyncOptions): Promise<SyncResult>;
262
- /**
263
- * Synchronize all registered instances
264
- *
265
- * @param options - Sync options
266
- * @returns Map of instance ID to sync result
267
- */
268
- syncAll(options?: SyncOptions): Promise<Map<string, SyncResult>>;
269
- /**
270
- * Start periodic health checks
271
- *
272
- * @param intervalMs - Check interval in milliseconds (overrides config)
273
- */
274
- startHealthCheck(intervalMs?: number): void;
275
- /**
276
- * Stop periodic health checks
277
- */
278
- stopHealthCheck(): void;
279
- /**
280
- * Perform health check on all instances
281
- */
282
- private performHealthCheck;
283
- /**
284
- * Check if a specific instance is healthy
285
- */
286
- private checkInstanceHealth;
287
- /**
288
- * Register a callback for instance status changes
289
- *
290
- * @param callback - Callback function
291
- * @returns Unsubscribe function
292
- */
293
- onInstanceStatusChange(callback: StatusChangeCallback): () => void;
294
- /**
295
- * Broadcast an insert operation to all online instances
296
- *
297
- * @param id - Vector ID
298
- * @param vector - Vector embedding
299
- * @param metadata - Optional metadata
300
- */
301
- broadcastInsert(id: string, vector: Float32Array, metadata?: Record<string, unknown>): Promise<void>;
302
- /**
303
- * Broadcast a delete operation to all online instances
304
- *
305
- * @param id - Vector ID to delete
306
- */
307
- broadcastDelete(id: string): Promise<void>;
308
- /**
309
- * Execute an operation on all instances (including primary)
310
- *
311
- * @param operation - Operation to execute
312
- * @returns Map of instance ID to result
313
- */
314
- executeOnAll<T>(operation: (db: VectorBackend, instanceId: string) => Promise<T>): Promise<DistributedOperationResult<T>>;
315
- /**
316
- * Get current configuration
317
- */
318
- getConfig(): Readonly<Required<MultiDatabaseCoordinatorConfig>>;
319
- /**
320
- * Update configuration
321
- *
322
- * @param updates - Partial configuration updates
323
- */
324
- updateConfig(updates: Partial<MultiDatabaseCoordinatorConfig>): void;
325
- /**
326
- * Get coordinator statistics
327
- */
328
- getStats(): {
329
- primaryStats: VectorStats;
330
- instanceCount: number;
331
- onlineCount: number;
332
- offlineCount: number;
333
- syncingCount: number;
334
- totalVectors: number;
335
- };
336
- /**
337
- * Stop all background tasks and cleanup
338
- */
339
- close(): void;
340
- private startAutoSync;
341
- private stopAutoSync;
342
- private mergeOptions;
343
- private getLocalVectorIds;
344
- private createBatches;
345
- private selectReplicationTargets;
346
- private delay;
347
- }
348
- //# sourceMappingURL=MultiDatabaseCoordinator.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"MultiDatabaseCoordinator.d.ts","sourceRoot":"","sources":["../../../src/coordination/MultiDatabaseCoordinator.ts"],"names":[],"mappings":"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"}