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
@@ -0,0 +1,10 @@
1
+ /**
2
+ * AgentDB Frontier Features
3
+ *
4
+ * State-of-the-art memory capabilities
5
+ */
6
+ export { CausalMemoryGraph } from './CausalMemoryGraph';
7
+ export { ExplainableRecall } from './ExplainableRecall';
8
+ export { CausalRecall } from './CausalRecall';
9
+ export { NightlyLearner } from './NightlyLearner';
10
+ //# sourceMappingURL=frontier-index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frontier-index.js","sourceRoot":"","sources":["../../../src/controllers/frontier-index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
@@ -5,7 +5,7 @@
5
5
  */
6
6
  export { ReflexionMemory } from './ReflexionMemory.js';
7
7
  export { SkillLibrary } from './SkillLibrary.js';
8
- export { EmbeddingService } from './EmbeddingService.js';
8
+ export { EmbeddingService, registerEmbeddingModelRolePolicy } from './EmbeddingService.js';
9
9
  export { WASMVectorSearch } from './WASMVectorSearch.js';
10
10
  export { HNSWIndex } from './HNSWIndex.js';
11
11
  export { EnhancedEmbeddingService } from './EnhancedEmbeddingService.js';
@@ -16,6 +16,8 @@ export { QUICServer } from './QUICServer.js';
16
16
  export { QUICClient } from './QUICClient.js';
17
17
  export { SyncCoordinator } from './SyncCoordinator.js';
18
18
  export { AttentionService } from './AttentionService.js';
19
+ export { SparsificationService } from './SparsificationService.js';
20
+ export { MincutService } from './MincutService.js';
19
21
  export { MemoryController } from './MemoryController.js';
20
22
  export { SelfAttentionController } from './attention/SelfAttentionController.js';
21
23
  export { CrossAttentionController } from './attention/CrossAttentionController.js';
@@ -33,8 +35,12 @@ export type { QUICServerConfig, SyncRequest, SyncResponse } from './QUICServer.j
33
35
  export type { QUICClientConfig, SyncOptions, SyncResult, SyncProgress } from './QUICClient.js';
34
36
  export type { SyncCoordinatorConfig, SyncState, SyncReport } from './SyncCoordinator.js';
35
37
  export type { AttentionConfig, AttentionResult, AttentionStats } from './AttentionService.js';
38
+ export type { GraphEdges, SparsificationConfig, SparsificationResult } from './SparsificationService.js';
39
+ export type { MincutConfig, MincutResult, Partition } from './MincutService.js';
36
40
  export type { MemoryControllerConfig, Memory, SearchOptions, SearchResult, AttentionRetrievalResult } from './MemoryController.js';
37
41
  export type { SelfAttentionConfig, AttentionScore, SelfAttentionResult, SelfAttentionMemoryEntry } from './attention/index.js';
38
42
  export type { CrossAttentionConfig, CrossAttentionScore, CrossAttentionResult, ContextEntry } from './attention/index.js';
39
43
  export type { MultiHeadAttentionConfig, HeadAttentionOutput, MultiHeadAttentionResult, MultiHeadMemoryEntry } from './attention/index.js';
44
+ export { controllerPrerequisites, noArgControllers, getControllerPrerequisite, filterBySafety } from './prerequisites.js';
45
+ export type { ControllerPrerequisite, ControllerRequirement, ControllerSafety } from './prerequisites.js';
40
46
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controllers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAE3F,YAAY,EAAE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACjG,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACxG,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/F,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG9F,YAAY,EACV,sBAAsB,EACtB,MAAM,EACN,aAAa,EACb,YAAY,EACZ,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controllers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,gCAAgC,EACjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAE3F,YAAY,EAAE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACjG,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACxG,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/F,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC9F,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,EACV,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,sBAAsB,EACtB,MAAM,EACN,aAAa,EACb,YAAY,EACZ,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC"}
@@ -5,7 +5,7 @@
5
5
  */
6
6
  export { ReflexionMemory } from './ReflexionMemory.js';
7
7
  export { SkillLibrary } from './SkillLibrary.js';
8
- export { EmbeddingService } from './EmbeddingService.js';
8
+ export { EmbeddingService, registerEmbeddingModelRolePolicy } from './EmbeddingService.js';
9
9
  export { WASMVectorSearch } from './WASMVectorSearch.js';
10
10
  export { HNSWIndex } from './HNSWIndex.js';
11
11
  export { EnhancedEmbeddingService } from './EnhancedEmbeddingService.js';
@@ -16,10 +16,14 @@ export { QUICServer } from './QUICServer.js';
16
16
  export { QUICClient } from './QUICClient.js';
17
17
  export { SyncCoordinator } from './SyncCoordinator.js';
18
18
  export { AttentionService } from './AttentionService.js';
19
+ export { SparsificationService } from './SparsificationService.js';
20
+ export { MincutService } from './MincutService.js';
19
21
  // Memory Controller with Attention Integration
20
22
  export { MemoryController } from './MemoryController.js';
21
23
  // Attention Controllers
22
24
  export { SelfAttentionController } from './attention/SelfAttentionController.js';
23
25
  export { CrossAttentionController } from './attention/CrossAttentionController.js';
24
26
  export { MultiHeadAttentionController } from './attention/MultiHeadAttentionController.js';
27
+ // Controller activation registry (issue #146 Gap 2)
28
+ export { controllerPrerequisites, noArgControllers, getControllerPrerequisite, filterBySafety } from './prerequisites.js';
25
29
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/controllers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,+CAA+C;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,wBAAwB;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/controllers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,gCAAgC,EACjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,+CAA+C;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,wBAAwB;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAyD3F,oDAAoD;AACpD,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACf,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,76 @@
1
+ /**
2
+ * Controller Prerequisites Registry
3
+ *
4
+ * Documents which agentdb controllers can be auto-activated by downstream
5
+ * consumers (e.g. ruflo's memory bridge) versus which require external
6
+ * dependencies that the embedding host has to supply.
7
+ *
8
+ * Issue #146 Gap 2 — downstream consumers were reading dist source to discover
9
+ * which controllers were safe to default-construct. This module hoists that
10
+ * information into the public API so callers can do:
11
+ *
12
+ * ```ts
13
+ * import { controllerPrerequisites } from 'agentdb';
14
+ *
15
+ * const safe = controllerPrerequisites.filter(c => c.requirements.length === 0);
16
+ * // → controllers whose constructor needs no external resources
17
+ * ```
18
+ *
19
+ * The data is hand-curated and tracked alongside controller source files so
20
+ * adding a new controller forces a registry update in the same change.
21
+ */
22
+ /**
23
+ * What a controller needs at construction time. Anything in `requirements`
24
+ * has to be produced by the host before the controller can be instantiated.
25
+ */
26
+ export type ControllerRequirement = 'database' | 'embedder' | 'vectorBackend' | 'graphBackend' | 'learningBackend' | 'config' | 'wasm' | 'networkEndpoint';
27
+ /** Activation safety: what happens when this controller is constructed. */
28
+ export type ControllerSafety =
29
+ /** Constructor itself is pure — no I/O, threads, or network. */
30
+ 'pure'
31
+ /** Constructor opens a file handle / WASM module / process resource. */
32
+ | 'opens-resource'
33
+ /** Constructor performs a network operation (e.g. binds a socket). */
34
+ | 'opens-network';
35
+ export interface ControllerPrerequisite {
36
+ /** Controller class name as exported from `agentdb`. */
37
+ name: string;
38
+ /**
39
+ * Required external resources. When empty, the controller can be
40
+ * default-constructed with no host-supplied arguments.
41
+ */
42
+ requirements: ControllerRequirement[];
43
+ /** Optional resources — controller works without them but is degraded. */
44
+ optional: ControllerRequirement[];
45
+ /** Constructor arity (positional args). Useful for reflection-style wiring. */
46
+ arity: number;
47
+ /** What happens when this controller is instantiated. */
48
+ safety: ControllerSafety;
49
+ /** Short human description for tooling output. */
50
+ description: string;
51
+ }
52
+ /**
53
+ * Authoritative list of agentdb controllers and their construction needs.
54
+ *
55
+ * Order is alphabetical for easy diffs. Entries match the export names from
56
+ * `controllers/index.ts`.
57
+ */
58
+ export declare const controllerPrerequisites: readonly ControllerPrerequisite[];
59
+ /**
60
+ * Convenience: controllers safe to default-construct (no required resources).
61
+ * These are what downstream "auto-activate" passes can enable without host
62
+ * cooperation.
63
+ */
64
+ export declare const noArgControllers: readonly ControllerPrerequisite[];
65
+ /** Look up a controller's prerequisites by name. Returns null if unknown. */
66
+ export declare function getControllerPrerequisite(name: string): ControllerPrerequisite | null;
67
+ /**
68
+ * Filter controllers by safety class. Useful for hosts that want to enable
69
+ * everything except network-touching controllers, for example:
70
+ *
71
+ * ```ts
72
+ * const offlineSafe = filterBySafety(['pure', 'opens-resource']);
73
+ * ```
74
+ */
75
+ export declare function filterBySafety(safety: readonly ControllerSafety[]): readonly ControllerPrerequisite[];
76
+ //# sourceMappingURL=prerequisites.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prerequisites.d.ts","sourceRoot":"","sources":["../../../src/controllers/prerequisites.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,UAAU,GACV,eAAe,GACf,cAAc,GACd,iBAAiB,GACjB,QAAQ,GACR,MAAM,GACN,iBAAiB,CAAC;AAEtB,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB;AAC1B,gEAAgE;AAC9D,MAAM;AACR,wEAAwE;GACtE,gBAAgB;AAClB,sEAAsE;GACpE,eAAe,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,YAAY,EAAE,qBAAqB,EAAE,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,EAAE,gBAAgB,CAAC;IACzB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,sBAAsB,EAyLnE,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,sBAAsB,EAE7D,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAErF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,SAAS,sBAAsB,EAAE,CAEnC"}
@@ -0,0 +1,235 @@
1
+ /**
2
+ * Controller Prerequisites Registry
3
+ *
4
+ * Documents which agentdb controllers can be auto-activated by downstream
5
+ * consumers (e.g. ruflo's memory bridge) versus which require external
6
+ * dependencies that the embedding host has to supply.
7
+ *
8
+ * Issue #146 Gap 2 — downstream consumers were reading dist source to discover
9
+ * which controllers were safe to default-construct. This module hoists that
10
+ * information into the public API so callers can do:
11
+ *
12
+ * ```ts
13
+ * import { controllerPrerequisites } from 'agentdb';
14
+ *
15
+ * const safe = controllerPrerequisites.filter(c => c.requirements.length === 0);
16
+ * // → controllers whose constructor needs no external resources
17
+ * ```
18
+ *
19
+ * The data is hand-curated and tracked alongside controller source files so
20
+ * adding a new controller forces a registry update in the same change.
21
+ */
22
+ /**
23
+ * Authoritative list of agentdb controllers and their construction needs.
24
+ *
25
+ * Order is alphabetical for easy diffs. Entries match the export names from
26
+ * `controllers/index.ts`.
27
+ */
28
+ export const controllerPrerequisites = Object.freeze([
29
+ {
30
+ name: 'AttentionService',
31
+ requirements: ['config'],
32
+ optional: ['wasm'],
33
+ arity: 1,
34
+ safety: 'opens-resource',
35
+ description: 'Self / cross / multi-head attention over embeddings (uses @ruvector/attention WASM when present).'
36
+ },
37
+ {
38
+ name: 'CausalMemoryGraph',
39
+ requirements: ['database'],
40
+ optional: ['embedder', 'graphBackend', 'vectorBackend', 'config'],
41
+ arity: 5,
42
+ safety: 'opens-resource',
43
+ description: 'Causal edge graph over memories. Needs a database; graphBackend lets you swap to an external graph DB.'
44
+ },
45
+ {
46
+ name: 'CausalRecall',
47
+ requirements: ['database', 'embedder'],
48
+ optional: ['vectorBackend', 'config'],
49
+ arity: 4,
50
+ safety: 'pure',
51
+ description: 'Causal-uplift reranker for recall queries.'
52
+ },
53
+ {
54
+ name: 'ContextSynthesizer',
55
+ requirements: ['database'],
56
+ optional: ['embedder', 'config'],
57
+ arity: 3,
58
+ safety: 'pure',
59
+ description: 'Synthesises retrieved memories into a coherent context window.'
60
+ },
61
+ {
62
+ name: 'CrossAttentionController',
63
+ requirements: ['config'],
64
+ optional: ['wasm'],
65
+ arity: 1,
66
+ safety: 'opens-resource',
67
+ description: 'Cross-attention controller (per-head context fusion).'
68
+ },
69
+ {
70
+ name: 'EmbeddingService',
71
+ requirements: ['config'],
72
+ optional: [],
73
+ arity: 1,
74
+ safety: 'pure',
75
+ description: 'Text → vector embedder (transformers.js / OpenAI / local).'
76
+ },
77
+ {
78
+ name: 'EnhancedEmbeddingService',
79
+ requirements: ['config'],
80
+ optional: [],
81
+ arity: 1,
82
+ safety: 'pure',
83
+ description: 'EmbeddingService with caching, batching, and provider fallback.'
84
+ },
85
+ {
86
+ name: 'ExplainableRecall',
87
+ requirements: ['database', 'embedder'],
88
+ optional: ['vectorBackend'],
89
+ arity: 3,
90
+ safety: 'pure',
91
+ description: 'Recall layer that emits feature attributions per match.'
92
+ },
93
+ {
94
+ name: 'HNSWIndex',
95
+ requirements: ['database'],
96
+ optional: ['config'],
97
+ arity: 2,
98
+ safety: 'opens-resource',
99
+ description: 'On-disk HNSW vector index. Loads native hnswlib when available.'
100
+ },
101
+ {
102
+ name: 'LearningSystem',
103
+ requirements: ['database', 'embedder'],
104
+ optional: ['vectorBackend', 'config'],
105
+ arity: 4,
106
+ safety: 'pure',
107
+ description: 'Online learner that consolidates patterns and skills.'
108
+ },
109
+ {
110
+ name: 'MMRDiversityRanker',
111
+ requirements: [],
112
+ optional: ['config'],
113
+ arity: 1,
114
+ safety: 'pure',
115
+ description: 'Maximal Marginal Relevance diversity reranker.'
116
+ },
117
+ {
118
+ name: 'MemoryController',
119
+ requirements: [],
120
+ optional: ['vectorBackend', 'config'],
121
+ arity: 2,
122
+ safety: 'pure',
123
+ description: 'High-level memory orchestration over a vector backend (works in-memory if backend omitted).'
124
+ },
125
+ {
126
+ name: 'MetadataFilter',
127
+ requirements: [],
128
+ optional: [],
129
+ arity: 0,
130
+ safety: 'pure',
131
+ description: 'Pure utility for filtering memories by metadata predicates.'
132
+ },
133
+ {
134
+ name: 'MultiHeadAttentionController',
135
+ requirements: ['config'],
136
+ optional: ['wasm'],
137
+ arity: 1,
138
+ safety: 'opens-resource',
139
+ description: 'Multi-head attention controller built on AttentionService.'
140
+ },
141
+ {
142
+ name: 'NightlyLearner',
143
+ requirements: ['database', 'embedder'],
144
+ optional: ['config'],
145
+ arity: 3,
146
+ safety: 'pure',
147
+ description: 'Background consolidation pipeline (causal edges, A/B uplift, skill distillation).'
148
+ },
149
+ {
150
+ name: 'QUICClient',
151
+ requirements: ['config', 'networkEndpoint'],
152
+ optional: [],
153
+ arity: 1,
154
+ safety: 'opens-network',
155
+ description: 'QUIC sync client. Reaches out to a peer at construction time.'
156
+ },
157
+ {
158
+ name: 'QUICServer',
159
+ requirements: ['config'],
160
+ optional: [],
161
+ arity: 1,
162
+ safety: 'opens-network',
163
+ description: 'QUIC sync server. Binds a UDP socket at construction time.'
164
+ },
165
+ {
166
+ name: 'ReasoningBank',
167
+ requirements: ['database', 'embedder'],
168
+ optional: ['vectorBackend', 'graphBackend', 'config'],
169
+ arity: 5,
170
+ safety: 'pure',
171
+ description: 'Top-level reasoning memory facade combining reflexion / causal / skill controllers.'
172
+ },
173
+ {
174
+ name: 'ReflexionMemory',
175
+ requirements: ['database', 'embedder'],
176
+ optional: ['vectorBackend', 'learningBackend', 'graphBackend'],
177
+ arity: 5,
178
+ safety: 'pure',
179
+ description: 'Episodic replay memory (Reflexion paper). Stores critiques + outcomes.'
180
+ },
181
+ {
182
+ name: 'SelfAttentionController',
183
+ requirements: ['config'],
184
+ optional: ['wasm'],
185
+ arity: 1,
186
+ safety: 'opens-resource',
187
+ description: 'Self-attention controller (intra-context salience).'
188
+ },
189
+ {
190
+ name: 'SkillLibrary',
191
+ requirements: ['database', 'embedder'],
192
+ optional: ['vectorBackend', 'graphBackend', 'config'],
193
+ arity: 5,
194
+ safety: 'pure',
195
+ description: 'Reusable skill registry with similarity-based retrieval.'
196
+ },
197
+ {
198
+ name: 'SyncCoordinator',
199
+ requirements: ['config'],
200
+ optional: ['networkEndpoint'],
201
+ arity: 1,
202
+ safety: 'opens-network',
203
+ description: 'Coordinates multi-peer QUIC sync.'
204
+ },
205
+ {
206
+ name: 'WASMVectorSearch',
207
+ requirements: ['wasm'],
208
+ optional: ['config'],
209
+ arity: 1,
210
+ safety: 'opens-resource',
211
+ description: 'Pure-WASM vector search index (no native deps).'
212
+ }
213
+ ]);
214
+ /**
215
+ * Convenience: controllers safe to default-construct (no required resources).
216
+ * These are what downstream "auto-activate" passes can enable without host
217
+ * cooperation.
218
+ */
219
+ export const noArgControllers = Object.freeze(controllerPrerequisites.filter(c => c.requirements.length === 0));
220
+ /** Look up a controller's prerequisites by name. Returns null if unknown. */
221
+ export function getControllerPrerequisite(name) {
222
+ return controllerPrerequisites.find(c => c.name === name) ?? null;
223
+ }
224
+ /**
225
+ * Filter controllers by safety class. Useful for hosts that want to enable
226
+ * everything except network-touching controllers, for example:
227
+ *
228
+ * ```ts
229
+ * const offlineSafe = filterBySafety(['pure', 'opens-resource']);
230
+ * ```
231
+ */
232
+ export function filterBySafety(safety) {
233
+ return controllerPrerequisites.filter(c => safety.includes(c.safety));
234
+ }
235
+ //# sourceMappingURL=prerequisites.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prerequisites.js","sourceRoot":"","sources":["../../../src/controllers/prerequisites.ts"],"names":[],"mappings":"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"}
@@ -1,30 +1,14 @@
1
- /**
2
- * AgentDB - Main database wrapper class
3
- *
4
- * Provides a unified interface to all AgentDB controllers with:
5
- * - sql.js WASM for relational storage (with better-sqlite3 fallback)
6
- * - RuVector for optimized vector search (150x faster than SQLite)
7
- * - Unified integration passing vector backend to all controllers
8
- *
9
- * Unified single-file mode (vectorBackend='rvf', the default):
10
- * One sql.js Database instance holds BOTH relational tables (episodes,
11
- * skills, causal edges — 21+ tables) AND vector tables (rvf_vectors,
12
- * rvf_meta). Everything persists to a single .rvf file.
13
- */
14
- import { ReflexionMemory } from '../controllers/ReflexionMemory.js';
15
- import { SkillLibrary } from '../controllers/SkillLibrary.js';
16
- import { CausalMemoryGraph } from '../controllers/CausalMemoryGraph.js';
17
1
  import type { VectorBackend } from '../backends/VectorBackend.js';
18
2
  import type { IDatabaseConnection } from '../types/database.types.js';
19
3
  export interface AgentDBConfig {
20
4
  dbPath?: string;
21
5
  namespace?: string;
22
6
  enableAttention?: boolean;
23
- attentionConfig?: Record<string, unknown>;
7
+ attentionConfig?: Record<string, any>;
24
8
  /** Force use of sql.js WASM even if better-sqlite3 is available */
25
9
  forceWasm?: boolean;
26
- /** Vector backend type: 'auto' | 'ruvector' | 'rvf' | 'hnswlib' */
27
- vectorBackend?: 'auto' | 'ruvector' | 'rvf' | 'hnswlib';
10
+ /** Vector backend type: 'auto' | 'ruvector' | 'hnswlib' */
11
+ vectorBackend?: 'auto' | 'ruvector' | 'hnswlib';
28
12
  /** Vector dimension (default: 384 for MiniLM) */
29
13
  vectorDimension?: number;
30
14
  }
@@ -38,19 +22,8 @@ export declare class AgentDB {
38
22
  private initialized;
39
23
  private config;
40
24
  private usingWasm;
41
- /** True when vectors + relational share one sql.js database */
42
- private unifiedMode;
43
- /** Reference to the rvf backend when in unified mode (for save/close) */
44
- private rvfBackendRef;
45
25
  constructor(config?: AgentDBConfig);
46
26
  initialize(): Promise<void>;
47
- /**
48
- * Save the database to disk.
49
- * In unified mode, delegates to SqlJsRvfBackend.save() which exports the
50
- * entire database (vectors + relational) to a single .rvf file.
51
- * In legacy mode, saves the relational database via the wrapper's save().
52
- */
53
- save(savePath?: string): Promise<void>;
54
27
  /**
55
28
  * Initialize database with automatic fallback:
56
29
  * 1. Try better-sqlite3 (native, fastest)
@@ -62,17 +35,19 @@ export declare class AgentDB {
62
35
  */
63
36
  private initializeSqlJsWasm;
64
37
  /**
65
- * Load database schemas
38
+ * Load database schemas.
39
+ *
40
+ * Uses inlined SQL constants (src/schemas/inline.ts, generated from the .sql
41
+ * files at build time) so this works in:
42
+ * - the browser (no `fs` available) — fixes #2
43
+ * - globally-installed CLIs where __dirname resolution misses dist/schemas
44
+ * (the "Schema file not found" warning at install time) — fixes #1
66
45
  */
67
46
  private loadSchemas;
68
- getController(name: string): ReflexionMemory | SkillLibrary | CausalMemoryGraph;
69
- /**
70
- * Close the database. In unified mode, auto-saves before closing.
71
- */
47
+ getController(name: string): any;
72
48
  close(): Promise<void>;
73
49
  get database(): IDatabaseConnection;
74
50
  get isWasm(): boolean;
75
- get isUnifiedMode(): boolean;
76
51
  get vectorBackendName(): string;
77
52
  }
78
53
  //# sourceMappingURL=AgentDB.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"AgentDB.d.ts","sourceRoot":"","sources":["../../../src/core/AgentDB.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAIxE,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,8BAA8B,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAOtE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;IACxD,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAoB;IAC7B,aAAa,EAAG,aAAa,CAAC;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,+DAA+D;IAC/D,OAAO,CAAC,WAAW,CAAS;IAC5B,yEAAyE;IACzE,OAAO,CAAC,aAAa,CAAgC;gBAEzC,MAAM,GAAE,aAAkB;IAIhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiEjC;;;;;OAKG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C;;;;OAIG;YACW,kBAAkB;IAiBhC;;OAEG;YACW,mBAAmB;IAOjC;;OAEG;YACW,WAAW;IAczB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,YAAY,GAAG,iBAAiB;IAmB/E;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,IAAI,QAAQ,IAAI,mBAAmB,CAElC;IAGD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAGD,IAAI,aAAa,IAAI,OAAO,CAE3B;IAGD,IAAI,iBAAiB,IAAI,MAAM,CAE9B;CACF"}
1
+ {"version":3,"file":"AgentDB.d.ts","sourceRoot":"","sources":["../../../src/core/AgentDB.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAOtE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAChD,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAoB;IAC7B,aAAa,EAAG,aAAa,CAAC;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,aAAkB;IAIhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CjC;;;;OAIG;YACW,kBAAkB;IAoBhC;;OAEG;YACW,mBAAmB;IAOjC;;;;;;;;OAQG;YACW,WAAW;IAMzB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IAmB1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,IAAI,QAAQ,IAAI,mBAAmB,CAElC;IAGD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAGD,IAAI,iBAAiB,IAAI,MAAM,CAE9B;CACF"}