agentdb 1.6.1 → 2.0.0-alpha.2

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 (918) hide show
  1. package/README.md +1098 -350
  2. package/dist/agentdb-advanced.js +2110 -0
  3. package/dist/agentdb-advanced.min.js +1 -0
  4. package/dist/agentdb.min.js +4 -4
  5. package/dist/backends/GraphBackend.d.ts +196 -0
  6. package/dist/backends/GraphBackend.d.ts.map +1 -0
  7. package/dist/backends/GraphBackend.js +33 -0
  8. package/dist/backends/GraphBackend.js.map +1 -0
  9. package/dist/backends/LearningBackend.d.ts +148 -0
  10. package/dist/backends/LearningBackend.d.ts.map +1 -0
  11. package/dist/backends/LearningBackend.js +27 -0
  12. package/dist/backends/LearningBackend.js.map +1 -0
  13. package/dist/backends/VectorBackend.d.ts +119 -0
  14. package/dist/backends/VectorBackend.d.ts.map +1 -0
  15. package/dist/backends/VectorBackend.js +14 -0
  16. package/dist/backends/VectorBackend.js.map +1 -0
  17. package/dist/backends/detector.d.ts +81 -0
  18. package/dist/backends/detector.d.ts.map +1 -0
  19. package/dist/backends/detector.js +192 -0
  20. package/dist/backends/detector.js.map +1 -0
  21. package/dist/backends/factory.d.ts +50 -0
  22. package/dist/backends/factory.d.ts.map +1 -0
  23. package/dist/backends/factory.js +161 -0
  24. package/dist/backends/factory.js.map +1 -0
  25. package/dist/backends/graph/GraphDatabaseAdapter.d.ts +139 -0
  26. package/dist/backends/graph/GraphDatabaseAdapter.d.ts.map +1 -0
  27. package/dist/backends/graph/GraphDatabaseAdapter.js +194 -0
  28. package/dist/backends/graph/GraphDatabaseAdapter.js.map +1 -0
  29. package/dist/backends/hnswlib/HNSWLibBackend.d.ts +92 -0
  30. package/dist/backends/hnswlib/HNSWLibBackend.d.ts.map +1 -0
  31. package/dist/backends/hnswlib/HNSWLibBackend.js +316 -0
  32. package/dist/backends/hnswlib/HNSWLibBackend.js.map +1 -0
  33. package/dist/backends/hnswlib/index.d.ts +7 -0
  34. package/dist/backends/hnswlib/index.d.ts.map +1 -0
  35. package/dist/backends/hnswlib/index.js +7 -0
  36. package/dist/backends/hnswlib/index.js.map +1 -0
  37. package/dist/backends/index.d.ts +14 -0
  38. package/dist/backends/index.d.ts.map +1 -0
  39. package/dist/backends/index.js +13 -0
  40. package/dist/backends/index.js.map +1 -0
  41. package/dist/backends/ruvector/RuVectorBackend.d.ts +75 -0
  42. package/dist/backends/ruvector/RuVectorBackend.d.ts.map +1 -0
  43. package/dist/backends/ruvector/RuVectorBackend.js +198 -0
  44. package/dist/backends/ruvector/RuVectorBackend.js.map +1 -0
  45. package/dist/backends/ruvector/RuVectorLearning.d.ts +104 -0
  46. package/dist/backends/ruvector/RuVectorLearning.d.ts.map +1 -0
  47. package/dist/backends/ruvector/RuVectorLearning.js +177 -0
  48. package/dist/backends/ruvector/RuVectorLearning.js.map +1 -0
  49. package/dist/backends/ruvector/index.d.ts +9 -0
  50. package/dist/backends/ruvector/index.d.ts.map +1 -0
  51. package/dist/backends/ruvector/index.js +8 -0
  52. package/dist/backends/ruvector/index.js.map +1 -0
  53. package/dist/browser/AdvancedFeatures.d.ts +144 -0
  54. package/dist/browser/AdvancedFeatures.d.ts.map +1 -0
  55. package/dist/browser/AdvancedFeatures.js +430 -0
  56. package/dist/browser/AdvancedFeatures.js.map +1 -0
  57. package/dist/browser/HNSWIndex.d.ts +117 -0
  58. package/dist/browser/HNSWIndex.d.ts.map +1 -0
  59. package/dist/browser/HNSWIndex.js +402 -0
  60. package/dist/browser/HNSWIndex.js.map +1 -0
  61. package/dist/browser/ProductQuantization.d.ts +107 -0
  62. package/dist/browser/ProductQuantization.d.ts.map +1 -0
  63. package/dist/browser/ProductQuantization.js +337 -0
  64. package/dist/browser/ProductQuantization.js.map +1 -0
  65. package/dist/browser/browser/AdvancedFeatures.d.ts +144 -0
  66. package/dist/browser/browser/AdvancedFeatures.d.ts.map +1 -0
  67. package/dist/browser/browser/AdvancedFeatures.js +427 -0
  68. package/dist/browser/browser/HNSWIndex.d.ts +117 -0
  69. package/dist/browser/browser/HNSWIndex.d.ts.map +1 -0
  70. package/dist/browser/browser/HNSWIndex.js +402 -0
  71. package/dist/browser/browser/ProductQuantization.d.ts +107 -0
  72. package/dist/browser/browser/ProductQuantization.d.ts.map +1 -0
  73. package/dist/browser/browser/ProductQuantization.js +348 -0
  74. package/dist/browser/browser/index.d.ts +223 -0
  75. package/dist/browser/browser/index.d.ts.map +1 -0
  76. package/dist/browser/browser/index.js +233 -0
  77. package/dist/browser/index.d.ts +223 -0
  78. package/dist/browser/index.d.ts.map +1 -0
  79. package/dist/browser/index.js +225 -0
  80. package/dist/browser/index.js.map +1 -0
  81. package/dist/cli/agentdb-cli.d.ts.map +1 -1
  82. package/dist/cli/agentdb-cli.js +130 -8
  83. package/dist/cli/agentdb-cli.js.map +1 -1
  84. package/dist/cli/agentdb.db +0 -0
  85. package/dist/cli/commands/init.d.ts +12 -0
  86. package/dist/cli/commands/init.d.ts.map +1 -0
  87. package/dist/cli/commands/init.js +115 -0
  88. package/dist/cli/commands/init.js.map +1 -0
  89. package/dist/cli/commands/install-embeddings.d.ts +10 -0
  90. package/dist/cli/commands/install-embeddings.d.ts.map +1 -0
  91. package/dist/cli/commands/install-embeddings.js +68 -0
  92. package/dist/cli/commands/install-embeddings.js.map +1 -0
  93. package/dist/cli/commands/migrate.d.ts +15 -0
  94. package/dist/cli/commands/migrate.d.ts.map +1 -0
  95. package/dist/cli/commands/migrate.js +425 -0
  96. package/dist/cli/commands/migrate.js.map +1 -0
  97. package/dist/cli/commands/status.d.ts +10 -0
  98. package/dist/cli/commands/status.d.ts.map +1 -0
  99. package/dist/cli/commands/status.js +129 -0
  100. package/dist/cli/commands/status.js.map +1 -0
  101. package/dist/controllers/CausalRecall.d.ts +3 -1
  102. package/dist/controllers/CausalRecall.d.ts.map +1 -1
  103. package/dist/controllers/CausalRecall.js +35 -4
  104. package/dist/controllers/CausalRecall.js.map +1 -1
  105. package/dist/controllers/ExplainableRecall.d.ts +24 -0
  106. package/dist/controllers/ExplainableRecall.d.ts.map +1 -1
  107. package/dist/controllers/ExplainableRecall.js +102 -5
  108. package/dist/controllers/ExplainableRecall.js.map +1 -1
  109. package/dist/controllers/NightlyLearner.d.ts.map +1 -1
  110. package/dist/controllers/NightlyLearner.js +7 -4
  111. package/dist/controllers/NightlyLearner.js.map +1 -1
  112. package/dist/controllers/ReasoningBank.d.ts +101 -2
  113. package/dist/controllers/ReasoningBank.d.ts.map +1 -1
  114. package/dist/controllers/ReasoningBank.js +196 -4
  115. package/dist/controllers/ReasoningBank.js.map +1 -1
  116. package/dist/controllers/ReflexionMemory.d.ts +41 -1
  117. package/dist/controllers/ReflexionMemory.d.ts.map +1 -1
  118. package/dist/controllers/ReflexionMemory.js +282 -5
  119. package/dist/controllers/ReflexionMemory.js.map +1 -1
  120. package/dist/controllers/SkillLibrary.d.ts +27 -9
  121. package/dist/controllers/SkillLibrary.d.ts.map +1 -1
  122. package/dist/controllers/SkillLibrary.js +136 -47
  123. package/dist/controllers/SkillLibrary.js.map +1 -1
  124. package/dist/db-fallback.d.ts.map +1 -1
  125. package/dist/db-fallback.js +100 -29
  126. package/dist/db-fallback.js.map +1 -1
  127. package/dist/db-test.d.ts +13 -0
  128. package/dist/db-test.d.ts.map +1 -0
  129. package/dist/db-test.js +55 -0
  130. package/dist/db-test.js.map +1 -0
  131. package/dist/db-unified.d.ts +76 -0
  132. package/dist/db-unified.d.ts.map +1 -0
  133. package/dist/db-unified.js +278 -0
  134. package/dist/db-unified.js.map +1 -0
  135. package/dist/malp/core/ccc.d.ts +99 -0
  136. package/dist/malp/core/ccc.d.ts.map +1 -0
  137. package/dist/malp/core/ccc.js +181 -0
  138. package/dist/malp/core/ccc.js.map +1 -0
  139. package/dist/malp/core/index.d.ts +9 -0
  140. package/dist/malp/core/index.d.ts.map +1 -0
  141. package/dist/malp/core/index.js +9 -0
  142. package/dist/malp/core/index.js.map +1 -0
  143. package/dist/malp/core/linalg.d.ts +101 -0
  144. package/dist/malp/core/linalg.d.ts.map +1 -0
  145. package/dist/malp/core/linalg.js +278 -0
  146. package/dist/malp/core/linalg.js.map +1 -0
  147. package/dist/malp/core/optimizer.d.ts +68 -0
  148. package/dist/malp/core/optimizer.d.ts.map +1 -0
  149. package/dist/malp/core/optimizer.js +160 -0
  150. package/dist/malp/core/optimizer.js.map +1 -0
  151. package/dist/malp/index.d.ts +33 -0
  152. package/dist/malp/index.d.ts.map +1 -0
  153. package/dist/malp/index.js +37 -0
  154. package/dist/malp/index.js.map +1 -0
  155. package/dist/malp/metrics/agreement.d.ts +106 -0
  156. package/dist/malp/metrics/agreement.d.ts.map +1 -0
  157. package/dist/malp/metrics/agreement.js +199 -0
  158. package/dist/malp/metrics/agreement.js.map +1 -0
  159. package/dist/malp/metrics/comparison.d.ts +93 -0
  160. package/dist/malp/metrics/comparison.d.ts.map +1 -0
  161. package/dist/malp/metrics/comparison.js +256 -0
  162. package/dist/malp/metrics/comparison.js.map +1 -0
  163. package/dist/malp/metrics/index.d.ts +8 -0
  164. package/dist/malp/metrics/index.d.ts.map +1 -0
  165. package/dist/malp/metrics/index.js +8 -0
  166. package/dist/malp/metrics/index.js.map +1 -0
  167. package/dist/malp/metrics/performance.d.ts +61 -0
  168. package/dist/malp/metrics/performance.d.ts.map +1 -0
  169. package/dist/malp/metrics/performance.js +190 -0
  170. package/dist/malp/metrics/performance.js.map +1 -0
  171. package/dist/malp/models/index.d.ts +7 -0
  172. package/dist/malp/models/index.d.ts.map +1 -0
  173. package/dist/malp/models/index.js +7 -0
  174. package/dist/malp/models/index.js.map +1 -0
  175. package/dist/malp/models/malp.d.ts +116 -0
  176. package/dist/malp/models/malp.d.ts.map +1 -0
  177. package/dist/malp/models/malp.js +206 -0
  178. package/dist/malp/models/malp.js.map +1 -0
  179. package/dist/malp/models/regressor.d.ts +80 -0
  180. package/dist/malp/models/regressor.d.ts.map +1 -0
  181. package/dist/malp/models/regressor.js +229 -0
  182. package/dist/malp/models/regressor.js.map +1 -0
  183. package/dist/malp/reasoningbank_validator.d.ts +187 -0
  184. package/dist/malp/reasoningbank_validator.d.ts.map +1 -0
  185. package/dist/malp/reasoningbank_validator.js +246 -0
  186. package/dist/malp/reasoningbank_validator.js.map +1 -0
  187. package/dist/malp/wasm_bindings.d.ts +344 -0
  188. package/dist/malp/wasm_bindings.d.ts.map +1 -0
  189. package/dist/malp/wasm_bindings.js +9 -0
  190. package/dist/malp/wasm_bindings.js.map +1 -0
  191. package/dist/mcp/agentdb-mcp-server.js +512 -33
  192. package/dist/mcp/agentdb-mcp-server.js.map +1 -1
  193. package/dist/optimizations/BatchOperations.d.ts +42 -0
  194. package/dist/optimizations/BatchOperations.d.ts.map +1 -1
  195. package/dist/optimizations/BatchOperations.js +181 -0
  196. package/dist/optimizations/BatchOperations.js.map +1 -1
  197. package/dist/optimizations/ToolCache.d.ts +137 -0
  198. package/dist/optimizations/ToolCache.d.ts.map +1 -0
  199. package/dist/optimizations/ToolCache.js +281 -0
  200. package/dist/optimizations/ToolCache.js.map +1 -0
  201. package/dist/security/input-validation.d.ts +24 -0
  202. package/dist/security/input-validation.d.ts.map +1 -1
  203. package/dist/security/input-validation.js +106 -0
  204. package/dist/security/input-validation.js.map +1 -1
  205. package/dist/security/limits.d.ts +150 -0
  206. package/dist/security/limits.d.ts.map +1 -0
  207. package/dist/security/limits.js +288 -0
  208. package/dist/security/limits.js.map +1 -0
  209. package/dist/security/path-security.d.ts +100 -0
  210. package/dist/security/path-security.d.ts.map +1 -0
  211. package/dist/security/path-security.js +337 -0
  212. package/dist/security/path-security.js.map +1 -0
  213. package/dist/security/validation.d.ts +95 -0
  214. package/dist/security/validation.d.ts.map +1 -0
  215. package/dist/security/validation.js +315 -0
  216. package/dist/security/validation.js.map +1 -0
  217. package/dist/simulation/cli.d.ts +9 -0
  218. package/dist/simulation/cli.d.ts.map +1 -0
  219. package/dist/simulation/cli.js +68 -0
  220. package/dist/simulation/cli.js.map +1 -0
  221. package/dist/simulation/runner.d.ts +21 -0
  222. package/dist/simulation/runner.d.ts.map +1 -0
  223. package/dist/simulation/runner.js +241 -0
  224. package/dist/simulation/runner.js.map +1 -0
  225. package/dist/simulation/scenarios/aidefence-integration.d.ts +24 -0
  226. package/dist/simulation/scenarios/aidefence-integration.d.ts.map +1 -0
  227. package/dist/simulation/scenarios/aidefence-integration.js +124 -0
  228. package/dist/simulation/scenarios/aidefence-integration.js.map +1 -0
  229. package/dist/simulation/scenarios/bmssp-integration.d.ts +23 -0
  230. package/dist/simulation/scenarios/bmssp-integration.d.ts.map +1 -0
  231. package/dist/simulation/scenarios/bmssp-integration.js +104 -0
  232. package/dist/simulation/scenarios/bmssp-integration.js.map +1 -0
  233. package/dist/simulation/scenarios/causal-reasoning.d.ts +16 -0
  234. package/dist/simulation/scenarios/causal-reasoning.d.ts.map +1 -0
  235. package/dist/simulation/scenarios/causal-reasoning.js +108 -0
  236. package/dist/simulation/scenarios/causal-reasoning.js.map +1 -0
  237. package/dist/simulation/scenarios/consciousness-explorer.d.ts +25 -0
  238. package/dist/simulation/scenarios/consciousness-explorer.d.ts.map +1 -0
  239. package/dist/simulation/scenarios/consciousness-explorer.js +108 -0
  240. package/dist/simulation/scenarios/consciousness-explorer.js.map +1 -0
  241. package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.d.ts +135 -0
  242. package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.d.ts.map +1 -0
  243. package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.js +158 -0
  244. package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.js.map +1 -0
  245. package/dist/simulation/scenarios/domain-examples/index.d.ts +14 -0
  246. package/dist/simulation/scenarios/domain-examples/index.d.ts.map +1 -0
  247. package/dist/simulation/scenarios/domain-examples/index.js +14 -0
  248. package/dist/simulation/scenarios/domain-examples/index.js.map +1 -0
  249. package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.d.ts +178 -0
  250. package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.d.ts.map +1 -0
  251. package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.js +218 -0
  252. package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.js.map +1 -0
  253. package/dist/simulation/scenarios/domain-examples/medical-imaging.d.ts +122 -0
  254. package/dist/simulation/scenarios/domain-examples/medical-imaging.d.ts.map +1 -0
  255. package/dist/simulation/scenarios/domain-examples/medical-imaging.js +129 -0
  256. package/dist/simulation/scenarios/domain-examples/medical-imaging.js.map +1 -0
  257. package/dist/simulation/scenarios/domain-examples/robotics-navigation.d.ts +166 -0
  258. package/dist/simulation/scenarios/domain-examples/robotics-navigation.d.ts.map +1 -0
  259. package/dist/simulation/scenarios/domain-examples/robotics-navigation.js +161 -0
  260. package/dist/simulation/scenarios/domain-examples/robotics-navigation.js.map +1 -0
  261. package/dist/simulation/scenarios/domain-examples/scientific-research.d.ts +151 -0
  262. package/dist/simulation/scenarios/domain-examples/scientific-research.d.ts.map +1 -0
  263. package/dist/simulation/scenarios/domain-examples/scientific-research.js +187 -0
  264. package/dist/simulation/scenarios/domain-examples/scientific-research.js.map +1 -0
  265. package/dist/simulation/scenarios/domain-examples/trading-systems.d.ts +102 -0
  266. package/dist/simulation/scenarios/domain-examples/trading-systems.d.ts.map +1 -0
  267. package/dist/simulation/scenarios/domain-examples/trading-systems.js +100 -0
  268. package/dist/simulation/scenarios/domain-examples/trading-systems.js.map +1 -0
  269. package/dist/simulation/scenarios/goalie-integration.d.ts +24 -0
  270. package/dist/simulation/scenarios/goalie-integration.d.ts.map +1 -0
  271. package/dist/simulation/scenarios/goalie-integration.js +121 -0
  272. package/dist/simulation/scenarios/goalie-integration.js.map +1 -0
  273. package/dist/simulation/scenarios/graph-traversal.d.ts +17 -0
  274. package/dist/simulation/scenarios/graph-traversal.d.ts.map +1 -0
  275. package/dist/simulation/scenarios/graph-traversal.js +101 -0
  276. package/dist/simulation/scenarios/graph-traversal.js.map +1 -0
  277. package/dist/simulation/scenarios/latent-space/attention-analysis.d.ts +45 -0
  278. package/dist/simulation/scenarios/latent-space/attention-analysis.d.ts.map +1 -0
  279. package/dist/simulation/scenarios/latent-space/attention-analysis.js +435 -0
  280. package/dist/simulation/scenarios/latent-space/attention-analysis.js.map +1 -0
  281. package/dist/simulation/scenarios/latent-space/clustering-analysis.d.ts +55 -0
  282. package/dist/simulation/scenarios/latent-space/clustering-analysis.d.ts.map +1 -0
  283. package/dist/simulation/scenarios/latent-space/clustering-analysis.js +606 -0
  284. package/dist/simulation/scenarios/latent-space/clustering-analysis.js.map +1 -0
  285. package/dist/simulation/scenarios/latent-space/hnsw-exploration.d.ts +74 -0
  286. package/dist/simulation/scenarios/latent-space/hnsw-exploration.d.ts.map +1 -0
  287. package/dist/simulation/scenarios/latent-space/hnsw-exploration.js +391 -0
  288. package/dist/simulation/scenarios/latent-space/hnsw-exploration.js.map +1 -0
  289. package/dist/simulation/scenarios/latent-space/hypergraph-exploration.d.ts +51 -0
  290. package/dist/simulation/scenarios/latent-space/hypergraph-exploration.d.ts.map +1 -0
  291. package/dist/simulation/scenarios/latent-space/hypergraph-exploration.js +536 -0
  292. package/dist/simulation/scenarios/latent-space/hypergraph-exploration.js.map +1 -0
  293. package/dist/simulation/scenarios/latent-space/index.d.ts +35 -0
  294. package/dist/simulation/scenarios/latent-space/index.d.ts.map +1 -0
  295. package/dist/simulation/scenarios/latent-space/index.js +35 -0
  296. package/dist/simulation/scenarios/latent-space/index.js.map +1 -0
  297. package/dist/simulation/scenarios/latent-space/neural-augmentation.d.ts +52 -0
  298. package/dist/simulation/scenarios/latent-space/neural-augmentation.d.ts.map +1 -0
  299. package/dist/simulation/scenarios/latent-space/neural-augmentation.js +472 -0
  300. package/dist/simulation/scenarios/latent-space/neural-augmentation.js.map +1 -0
  301. package/dist/simulation/scenarios/latent-space/quantum-hybrid.d.ts +53 -0
  302. package/dist/simulation/scenarios/latent-space/quantum-hybrid.d.ts.map +1 -0
  303. package/dist/simulation/scenarios/latent-space/quantum-hybrid.js +391 -0
  304. package/dist/simulation/scenarios/latent-space/quantum-hybrid.js.map +1 -0
  305. package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.d.ts +52 -0
  306. package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.d.ts.map +1 -0
  307. package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.js +514 -0
  308. package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.js.map +1 -0
  309. package/dist/simulation/scenarios/latent-space/traversal-optimization.d.ts +53 -0
  310. package/dist/simulation/scenarios/latent-space/traversal-optimization.d.ts.map +1 -0
  311. package/dist/simulation/scenarios/latent-space/traversal-optimization.js +595 -0
  312. package/dist/simulation/scenarios/latent-space/traversal-optimization.js.map +1 -0
  313. package/dist/simulation/scenarios/lean-agentic-swarm.d.ts +18 -0
  314. package/dist/simulation/scenarios/lean-agentic-swarm.d.ts.map +1 -0
  315. package/dist/simulation/scenarios/lean-agentic-swarm.js +132 -0
  316. package/dist/simulation/scenarios/lean-agentic-swarm.js.map +1 -0
  317. package/dist/simulation/scenarios/multi-agent-swarm.d.ts +17 -0
  318. package/dist/simulation/scenarios/multi-agent-swarm.d.ts.map +1 -0
  319. package/dist/simulation/scenarios/multi-agent-swarm.js +111 -0
  320. package/dist/simulation/scenarios/multi-agent-swarm.js.map +1 -0
  321. package/dist/simulation/scenarios/psycho-symbolic-reasoner.d.ts +23 -0
  322. package/dist/simulation/scenarios/psycho-symbolic-reasoner.d.ts.map +1 -0
  323. package/dist/simulation/scenarios/psycho-symbolic-reasoner.js +98 -0
  324. package/dist/simulation/scenarios/psycho-symbolic-reasoner.js.map +1 -0
  325. package/dist/simulation/scenarios/reflexion-learning.d.ts +16 -0
  326. package/dist/simulation/scenarios/reflexion-learning.d.ts.map +1 -0
  327. package/dist/simulation/scenarios/reflexion-learning.js +98 -0
  328. package/dist/simulation/scenarios/reflexion-learning.js.map +1 -0
  329. package/dist/simulation/scenarios/research-swarm.d.ts +24 -0
  330. package/dist/simulation/scenarios/research-swarm.d.ts.map +1 -0
  331. package/dist/simulation/scenarios/research-swarm.js +146 -0
  332. package/dist/simulation/scenarios/research-swarm.js.map +1 -0
  333. package/dist/simulation/scenarios/skill-evolution.d.ts +16 -0
  334. package/dist/simulation/scenarios/skill-evolution.d.ts.map +1 -0
  335. package/dist/simulation/scenarios/skill-evolution.js +109 -0
  336. package/dist/simulation/scenarios/skill-evolution.js.map +1 -0
  337. package/dist/simulation/scenarios/stock-market-emergence.d.ts +33 -0
  338. package/dist/simulation/scenarios/stock-market-emergence.d.ts.map +1 -0
  339. package/dist/simulation/scenarios/stock-market-emergence.js +246 -0
  340. package/dist/simulation/scenarios/stock-market-emergence.js.map +1 -0
  341. package/dist/simulation/scenarios/strange-loops.d.ts +18 -0
  342. package/dist/simulation/scenarios/strange-loops.d.ts.map +1 -0
  343. package/dist/simulation/scenarios/strange-loops.js +133 -0
  344. package/dist/simulation/scenarios/strange-loops.js.map +1 -0
  345. package/dist/simulation/scenarios/sublinear-solver.d.ts +22 -0
  346. package/dist/simulation/scenarios/sublinear-solver.d.ts.map +1 -0
  347. package/dist/simulation/scenarios/sublinear-solver.js +82 -0
  348. package/dist/simulation/scenarios/sublinear-solver.js.map +1 -0
  349. package/dist/simulation/scenarios/temporal-lead-solver.d.ts +23 -0
  350. package/dist/simulation/scenarios/temporal-lead-solver.d.ts.map +1 -0
  351. package/dist/simulation/scenarios/temporal-lead-solver.js +90 -0
  352. package/dist/simulation/scenarios/temporal-lead-solver.js.map +1 -0
  353. package/dist/simulation/scenarios/voting-system-consensus.d.ts +27 -0
  354. package/dist/simulation/scenarios/voting-system-consensus.d.ts.map +1 -0
  355. package/dist/simulation/scenarios/voting-system-consensus.js +175 -0
  356. package/dist/simulation/scenarios/voting-system-consensus.js.map +1 -0
  357. package/dist/simulation/types.d.ts +162 -0
  358. package/dist/simulation/types.d.ts.map +1 -0
  359. package/dist/simulation/types.js +5 -0
  360. package/dist/simulation/types.js.map +1 -0
  361. package/dist/simulation/utils/PerformanceOptimizer.d.ts +115 -0
  362. package/dist/simulation/utils/PerformanceOptimizer.d.ts.map +1 -0
  363. package/dist/simulation/utils/PerformanceOptimizer.js +223 -0
  364. package/dist/simulation/utils/PerformanceOptimizer.js.map +1 -0
  365. package/dist/src/backends/GraphBackend.d.ts +196 -0
  366. package/dist/src/backends/GraphBackend.d.ts.map +1 -0
  367. package/dist/src/backends/GraphBackend.js +33 -0
  368. package/dist/src/backends/GraphBackend.js.map +1 -0
  369. package/dist/src/backends/LearningBackend.d.ts +148 -0
  370. package/dist/src/backends/LearningBackend.d.ts.map +1 -0
  371. package/dist/src/backends/LearningBackend.js +27 -0
  372. package/dist/src/backends/LearningBackend.js.map +1 -0
  373. package/dist/src/backends/VectorBackend.d.ts +119 -0
  374. package/dist/src/backends/VectorBackend.d.ts.map +1 -0
  375. package/dist/src/backends/VectorBackend.js +14 -0
  376. package/dist/src/backends/VectorBackend.js.map +1 -0
  377. package/dist/src/backends/detector.d.ts +81 -0
  378. package/dist/src/backends/detector.d.ts.map +1 -0
  379. package/dist/src/backends/detector.js +192 -0
  380. package/dist/src/backends/detector.js.map +1 -0
  381. package/dist/src/backends/factory.d.ts +50 -0
  382. package/dist/src/backends/factory.d.ts.map +1 -0
  383. package/dist/src/backends/factory.js +161 -0
  384. package/dist/src/backends/factory.js.map +1 -0
  385. package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts +151 -0
  386. package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts.map +1 -0
  387. package/dist/src/backends/graph/GraphDatabaseAdapter.js +224 -0
  388. package/dist/src/backends/graph/GraphDatabaseAdapter.js.map +1 -0
  389. package/dist/src/backends/hnswlib/HNSWLibBackend.d.ts +92 -0
  390. package/dist/src/backends/hnswlib/HNSWLibBackend.d.ts.map +1 -0
  391. package/dist/src/backends/hnswlib/HNSWLibBackend.js +316 -0
  392. package/dist/src/backends/hnswlib/HNSWLibBackend.js.map +1 -0
  393. package/dist/src/backends/hnswlib/index.d.ts +7 -0
  394. package/dist/src/backends/hnswlib/index.d.ts.map +1 -0
  395. package/dist/src/backends/hnswlib/index.js +7 -0
  396. package/dist/src/backends/hnswlib/index.js.map +1 -0
  397. package/dist/src/backends/index.d.ts +14 -0
  398. package/dist/src/backends/index.d.ts.map +1 -0
  399. package/dist/src/backends/index.js +13 -0
  400. package/dist/src/backends/index.js.map +1 -0
  401. package/dist/src/backends/ruvector/RuVectorBackend.d.ts +75 -0
  402. package/dist/src/backends/ruvector/RuVectorBackend.d.ts.map +1 -0
  403. package/dist/src/backends/ruvector/RuVectorBackend.js +198 -0
  404. package/dist/src/backends/ruvector/RuVectorBackend.js.map +1 -0
  405. package/dist/src/backends/ruvector/RuVectorLearning.d.ts +104 -0
  406. package/dist/src/backends/ruvector/RuVectorLearning.d.ts.map +1 -0
  407. package/dist/src/backends/ruvector/RuVectorLearning.js +177 -0
  408. package/dist/src/backends/ruvector/RuVectorLearning.js.map +1 -0
  409. package/dist/src/backends/ruvector/index.d.ts +9 -0
  410. package/dist/src/backends/ruvector/index.d.ts.map +1 -0
  411. package/dist/src/backends/ruvector/index.js +8 -0
  412. package/dist/src/backends/ruvector/index.js.map +1 -0
  413. package/dist/src/benchmarks/wasm-vector-benchmark.d.ts +10 -0
  414. package/dist/src/benchmarks/wasm-vector-benchmark.d.ts.map +1 -0
  415. package/dist/src/benchmarks/wasm-vector-benchmark.js +196 -0
  416. package/dist/src/benchmarks/wasm-vector-benchmark.js.map +1 -0
  417. package/dist/src/browser/AdvancedFeatures.d.ts +144 -0
  418. package/dist/src/browser/AdvancedFeatures.d.ts.map +1 -0
  419. package/dist/src/browser/AdvancedFeatures.js +430 -0
  420. package/dist/src/browser/AdvancedFeatures.js.map +1 -0
  421. package/dist/src/browser/HNSWIndex.d.ts +117 -0
  422. package/dist/src/browser/HNSWIndex.d.ts.map +1 -0
  423. package/dist/src/browser/HNSWIndex.js +402 -0
  424. package/dist/src/browser/HNSWIndex.js.map +1 -0
  425. package/dist/src/browser/ProductQuantization.d.ts +107 -0
  426. package/dist/src/browser/ProductQuantization.d.ts.map +1 -0
  427. package/dist/src/browser/ProductQuantization.js +337 -0
  428. package/dist/src/browser/ProductQuantization.js.map +1 -0
  429. package/dist/src/browser/index.d.ts +223 -0
  430. package/dist/src/browser/index.d.ts.map +1 -0
  431. package/dist/src/browser/index.js +225 -0
  432. package/dist/src/browser/index.js.map +1 -0
  433. package/dist/src/cli/agentdb-cli.d.ts +154 -0
  434. package/dist/src/cli/agentdb-cli.d.ts.map +1 -0
  435. package/dist/src/cli/agentdb-cli.js +2273 -0
  436. package/dist/src/cli/agentdb-cli.js.map +1 -0
  437. package/dist/src/cli/commands/init.d.ts +12 -0
  438. package/dist/src/cli/commands/init.d.ts.map +1 -0
  439. package/dist/src/cli/commands/init.js +115 -0
  440. package/dist/src/cli/commands/init.js.map +1 -0
  441. package/dist/src/cli/commands/install-embeddings.d.ts +10 -0
  442. package/dist/src/cli/commands/install-embeddings.d.ts.map +1 -0
  443. package/dist/src/cli/commands/install-embeddings.js +68 -0
  444. package/dist/src/cli/commands/install-embeddings.js.map +1 -0
  445. package/dist/src/cli/commands/migrate.d.ts +15 -0
  446. package/dist/src/cli/commands/migrate.d.ts.map +1 -0
  447. package/dist/src/cli/commands/migrate.js +425 -0
  448. package/dist/src/cli/commands/migrate.js.map +1 -0
  449. package/dist/src/cli/commands/simulate-custom.d.ts +26 -0
  450. package/dist/src/cli/commands/simulate-custom.d.ts.map +1 -0
  451. package/dist/src/cli/commands/simulate-custom.js +207 -0
  452. package/dist/src/cli/commands/simulate-custom.js.map +1 -0
  453. package/dist/src/cli/commands/simulate-report.d.ts +15 -0
  454. package/dist/src/cli/commands/simulate-report.d.ts.map +1 -0
  455. package/dist/src/cli/commands/simulate-report.js +136 -0
  456. package/dist/src/cli/commands/simulate-report.js.map +1 -0
  457. package/dist/src/cli/commands/simulate-wizard.d.ts +6 -0
  458. package/dist/src/cli/commands/simulate-wizard.d.ts.map +1 -0
  459. package/dist/src/cli/commands/simulate-wizard.js +352 -0
  460. package/dist/src/cli/commands/simulate-wizard.js.map +1 -0
  461. package/dist/src/cli/commands/simulate.d.ts +7 -0
  462. package/dist/src/cli/commands/simulate.d.ts.map +1 -0
  463. package/dist/src/cli/commands/simulate.js +100 -0
  464. package/dist/src/cli/commands/simulate.js.map +1 -0
  465. package/dist/src/cli/commands/status.d.ts +10 -0
  466. package/dist/src/cli/commands/status.d.ts.map +1 -0
  467. package/dist/src/cli/commands/status.js +129 -0
  468. package/dist/src/cli/commands/status.js.map +1 -0
  469. package/dist/src/cli/lib/config-manager.d.ts +110 -0
  470. package/dist/src/cli/lib/config-manager.d.ts.map +1 -0
  471. package/dist/src/cli/lib/config-manager.js +512 -0
  472. package/dist/src/cli/lib/config-manager.js.map +1 -0
  473. package/dist/src/cli/lib/config-validator.d.ts +43 -0
  474. package/dist/src/cli/lib/config-validator.d.ts.map +1 -0
  475. package/dist/src/cli/lib/config-validator.js +217 -0
  476. package/dist/src/cli/lib/config-validator.js.map +1 -0
  477. package/dist/src/cli/lib/health-monitor.d.ts +149 -0
  478. package/dist/src/cli/lib/health-monitor.d.ts.map +1 -0
  479. package/dist/src/cli/lib/health-monitor.js +380 -0
  480. package/dist/src/cli/lib/health-monitor.js.map +1 -0
  481. package/dist/src/cli/lib/help-formatter.d.ts +38 -0
  482. package/dist/src/cli/lib/help-formatter.d.ts.map +1 -0
  483. package/dist/src/cli/lib/help-formatter.js +357 -0
  484. package/dist/src/cli/lib/help-formatter.js.map +1 -0
  485. package/dist/src/cli/lib/history-tracker.d.ts +103 -0
  486. package/dist/src/cli/lib/history-tracker.d.ts.map +1 -0
  487. package/dist/src/cli/lib/history-tracker.js +352 -0
  488. package/dist/src/cli/lib/history-tracker.js.map +1 -0
  489. package/dist/src/cli/lib/report-generator.d.ts +24 -0
  490. package/dist/src/cli/lib/report-generator.d.ts.map +1 -0
  491. package/dist/src/cli/lib/report-generator.js +417 -0
  492. package/dist/src/cli/lib/report-generator.js.map +1 -0
  493. package/dist/src/cli/lib/report-store.d.ts +116 -0
  494. package/dist/src/cli/lib/report-store.d.ts.map +1 -0
  495. package/dist/src/cli/lib/report-store.js +464 -0
  496. package/dist/src/cli/lib/report-store.js.map +1 -0
  497. package/dist/src/cli/lib/simulation-registry.d.ts +165 -0
  498. package/dist/src/cli/lib/simulation-registry.d.ts.map +1 -0
  499. package/dist/src/cli/lib/simulation-registry.js +332 -0
  500. package/dist/src/cli/lib/simulation-registry.js.map +1 -0
  501. package/dist/src/cli/lib/simulation-runner.d.ts +90 -0
  502. package/dist/src/cli/lib/simulation-runner.d.ts.map +1 -0
  503. package/dist/src/cli/lib/simulation-runner.js +211 -0
  504. package/dist/src/cli/lib/simulation-runner.js.map +1 -0
  505. package/dist/src/controllers/CausalMemoryGraph.d.ts +127 -0
  506. package/dist/src/controllers/CausalMemoryGraph.d.ts.map +1 -0
  507. package/dist/src/controllers/CausalMemoryGraph.js +354 -0
  508. package/dist/src/controllers/CausalMemoryGraph.js.map +1 -0
  509. package/dist/src/controllers/CausalRecall.d.ts +139 -0
  510. package/dist/src/controllers/CausalRecall.d.ts.map +1 -0
  511. package/dist/src/controllers/CausalRecall.js +356 -0
  512. package/dist/src/controllers/CausalRecall.js.map +1 -0
  513. package/dist/src/controllers/ContextSynthesizer.d.ts +65 -0
  514. package/dist/src/controllers/ContextSynthesizer.d.ts.map +1 -0
  515. package/dist/src/controllers/ContextSynthesizer.js +208 -0
  516. package/dist/src/controllers/ContextSynthesizer.js.map +1 -0
  517. package/dist/src/controllers/EmbeddingService.d.ts +37 -0
  518. package/dist/src/controllers/EmbeddingService.d.ts.map +1 -0
  519. package/dist/src/controllers/EmbeddingService.js +136 -0
  520. package/dist/src/controllers/EmbeddingService.js.map +1 -0
  521. package/dist/src/controllers/EnhancedEmbeddingService.d.ts +50 -0
  522. package/dist/src/controllers/EnhancedEmbeddingService.d.ts.map +1 -0
  523. package/dist/src/controllers/EnhancedEmbeddingService.js +119 -0
  524. package/dist/src/controllers/EnhancedEmbeddingService.js.map +1 -0
  525. package/dist/src/controllers/ExplainableRecall.d.ts +163 -0
  526. package/dist/src/controllers/ExplainableRecall.d.ts.map +1 -0
  527. package/dist/src/controllers/ExplainableRecall.js +485 -0
  528. package/dist/src/controllers/ExplainableRecall.js.map +1 -0
  529. package/dist/src/controllers/HNSWIndex.d.ts +128 -0
  530. package/dist/src/controllers/HNSWIndex.d.ts.map +1 -0
  531. package/dist/src/controllers/HNSWIndex.js +361 -0
  532. package/dist/src/controllers/HNSWIndex.js.map +1 -0
  533. package/dist/src/controllers/LearningSystem.d.ts +195 -0
  534. package/dist/src/controllers/LearningSystem.d.ts.map +1 -0
  535. package/dist/src/controllers/LearningSystem.js +929 -0
  536. package/dist/src/controllers/LearningSystem.js.map +1 -0
  537. package/dist/src/controllers/MMRDiversityRanker.d.ts +50 -0
  538. package/dist/src/controllers/MMRDiversityRanker.d.ts.map +1 -0
  539. package/dist/src/controllers/MMRDiversityRanker.js +130 -0
  540. package/dist/src/controllers/MMRDiversityRanker.js.map +1 -0
  541. package/dist/src/controllers/MetadataFilter.d.ts +70 -0
  542. package/dist/src/controllers/MetadataFilter.d.ts.map +1 -0
  543. package/dist/src/controllers/MetadataFilter.js +243 -0
  544. package/dist/src/controllers/MetadataFilter.js.map +1 -0
  545. package/dist/src/controllers/NightlyLearner.d.ts +114 -0
  546. package/dist/src/controllers/NightlyLearner.d.ts.map +1 -0
  547. package/dist/src/controllers/NightlyLearner.js +394 -0
  548. package/dist/src/controllers/NightlyLearner.js.map +1 -0
  549. package/dist/src/controllers/QUICClient.d.ts +109 -0
  550. package/dist/src/controllers/QUICClient.d.ts.map +1 -0
  551. package/dist/src/controllers/QUICClient.js +299 -0
  552. package/dist/src/controllers/QUICClient.js.map +1 -0
  553. package/dist/src/controllers/QUICServer.d.ts +121 -0
  554. package/dist/src/controllers/QUICServer.d.ts.map +1 -0
  555. package/dist/src/controllers/QUICServer.js +383 -0
  556. package/dist/src/controllers/QUICServer.js.map +1 -0
  557. package/dist/src/controllers/ReasoningBank.d.ts +196 -0
  558. package/dist/src/controllers/ReasoningBank.d.ts.map +1 -0
  559. package/dist/src/controllers/ReasoningBank.js +494 -0
  560. package/dist/src/controllers/ReasoningBank.js.map +1 -0
  561. package/dist/src/controllers/ReflexionMemory.d.ts +125 -0
  562. package/dist/src/controllers/ReflexionMemory.d.ts.map +1 -0
  563. package/dist/src/controllers/ReflexionMemory.js +654 -0
  564. package/dist/src/controllers/ReflexionMemory.js.map +1 -0
  565. package/dist/src/controllers/SkillLibrary.d.ts +150 -0
  566. package/dist/src/controllers/SkillLibrary.d.ts.map +1 -0
  567. package/dist/src/controllers/SkillLibrary.js +608 -0
  568. package/dist/src/controllers/SkillLibrary.js.map +1 -0
  569. package/dist/src/controllers/SyncCoordinator.d.ts +120 -0
  570. package/dist/src/controllers/SyncCoordinator.d.ts.map +1 -0
  571. package/dist/src/controllers/SyncCoordinator.js +441 -0
  572. package/dist/src/controllers/SyncCoordinator.js.map +1 -0
  573. package/dist/src/controllers/WASMVectorSearch.d.ts +89 -0
  574. package/dist/src/controllers/WASMVectorSearch.d.ts.map +1 -0
  575. package/dist/src/controllers/WASMVectorSearch.js +234 -0
  576. package/dist/src/controllers/WASMVectorSearch.js.map +1 -0
  577. package/dist/src/controllers/frontier-index.d.ts +14 -0
  578. package/dist/src/controllers/frontier-index.d.ts.map +1 -0
  579. package/dist/src/controllers/frontier-index.js +10 -0
  580. package/dist/src/controllers/frontier-index.js.map +1 -0
  581. package/dist/src/controllers/index.d.ts +30 -0
  582. package/dist/src/controllers/index.d.ts.map +1 -0
  583. package/dist/src/controllers/index.js +18 -0
  584. package/dist/src/controllers/index.js.map +1 -0
  585. package/dist/src/db-fallback.d.ts +26 -0
  586. package/dist/src/db-fallback.d.ts.map +1 -0
  587. package/dist/src/db-fallback.js +264 -0
  588. package/dist/src/db-fallback.js.map +1 -0
  589. package/dist/src/db-test.d.ts +13 -0
  590. package/dist/src/db-test.d.ts.map +1 -0
  591. package/dist/src/db-test.js +55 -0
  592. package/dist/src/db-test.js.map +1 -0
  593. package/dist/src/db-unified.d.ts +76 -0
  594. package/dist/src/db-unified.d.ts.map +1 -0
  595. package/dist/src/db-unified.js +279 -0
  596. package/dist/src/db-unified.js.map +1 -0
  597. package/dist/src/examples/quic-sync-example.d.ts +9 -0
  598. package/dist/src/examples/quic-sync-example.d.ts.map +1 -0
  599. package/dist/src/examples/quic-sync-example.js +169 -0
  600. package/dist/src/examples/quic-sync-example.js.map +1 -0
  601. package/dist/src/examples/wasm-vector-usage.d.ts +12 -0
  602. package/dist/src/examples/wasm-vector-usage.d.ts.map +1 -0
  603. package/dist/src/examples/wasm-vector-usage.js +190 -0
  604. package/dist/src/examples/wasm-vector-usage.js.map +1 -0
  605. package/dist/src/index.d.ts +28 -0
  606. package/dist/src/index.d.ts.map +1 -0
  607. package/dist/src/index.js +35 -0
  608. package/dist/src/index.js.map +1 -0
  609. package/dist/src/mcp/agentdb-mcp-server.d.ts +8 -0
  610. package/dist/src/mcp/agentdb-mcp-server.d.ts.map +1 -0
  611. package/dist/src/mcp/agentdb-mcp-server.js +2116 -0
  612. package/dist/src/mcp/agentdb-mcp-server.js.map +1 -0
  613. package/dist/src/mcp/learning-tools-handlers.d.ts +16 -0
  614. package/dist/src/mcp/learning-tools-handlers.d.ts.map +1 -0
  615. package/dist/src/mcp/learning-tools-handlers.js +105 -0
  616. package/dist/src/mcp/learning-tools-handlers.js.map +1 -0
  617. package/dist/src/optimizations/BatchOperations.d.ts +109 -0
  618. package/dist/src/optimizations/BatchOperations.d.ts.map +1 -0
  619. package/dist/src/optimizations/BatchOperations.js +407 -0
  620. package/dist/src/optimizations/BatchOperations.js.map +1 -0
  621. package/dist/src/optimizations/QueryOptimizer.d.ts +83 -0
  622. package/dist/src/optimizations/QueryOptimizer.d.ts.map +1 -0
  623. package/dist/src/optimizations/QueryOptimizer.js +228 -0
  624. package/dist/src/optimizations/QueryOptimizer.js.map +1 -0
  625. package/dist/src/optimizations/ToolCache.d.ts +137 -0
  626. package/dist/src/optimizations/ToolCache.d.ts.map +1 -0
  627. package/dist/src/optimizations/ToolCache.js +281 -0
  628. package/dist/src/optimizations/ToolCache.js.map +1 -0
  629. package/dist/src/optimizations/index.d.ts +10 -0
  630. package/dist/src/optimizations/index.d.ts.map +1 -0
  631. package/dist/src/optimizations/index.js +8 -0
  632. package/dist/src/optimizations/index.js.map +1 -0
  633. package/dist/src/security/input-validation.d.ts +109 -0
  634. package/dist/src/security/input-validation.d.ts.map +1 -0
  635. package/dist/src/security/input-validation.js +398 -0
  636. package/dist/src/security/input-validation.js.map +1 -0
  637. package/dist/src/security/limits.d.ts +150 -0
  638. package/dist/src/security/limits.d.ts.map +1 -0
  639. package/dist/src/security/limits.js +288 -0
  640. package/dist/src/security/limits.js.map +1 -0
  641. package/dist/src/security/path-security.d.ts +100 -0
  642. package/dist/src/security/path-security.d.ts.map +1 -0
  643. package/dist/src/security/path-security.js +337 -0
  644. package/dist/src/security/path-security.js.map +1 -0
  645. package/dist/src/security/validation.d.ts +95 -0
  646. package/dist/src/security/validation.d.ts.map +1 -0
  647. package/dist/src/security/validation.js +315 -0
  648. package/dist/src/security/validation.js.map +1 -0
  649. package/dist/src/services/LLMRouter.d.ts +84 -0
  650. package/dist/src/services/LLMRouter.d.ts.map +1 -0
  651. package/dist/src/services/LLMRouter.js +329 -0
  652. package/dist/src/services/LLMRouter.js.map +1 -0
  653. package/dist/src/types/quic.d.ts +518 -0
  654. package/dist/src/types/quic.d.ts.map +1 -0
  655. package/dist/src/types/quic.js +272 -0
  656. package/dist/src/types/quic.js.map +1 -0
  657. package/dist/src/utils/NodeIdMapper.d.ts +38 -0
  658. package/dist/src/utils/NodeIdMapper.d.ts.map +1 -0
  659. package/dist/src/utils/NodeIdMapper.js +57 -0
  660. package/dist/src/utils/NodeIdMapper.js.map +1 -0
  661. package/examples/README.md +105 -0
  662. package/examples/quickstart.js +43 -0
  663. package/package.json +17 -3
  664. package/scripts/README.md +314 -0
  665. package/simulation/.claude-flow/metrics/agent-metrics.json +1 -0
  666. package/simulation/.claude-flow/metrics/performance.json +87 -0
  667. package/simulation/.claude-flow/metrics/task-metrics.json +10 -0
  668. package/simulation/COMPLETION-STATUS.md +139 -0
  669. package/simulation/FINAL-RESULTS.md +414 -0
  670. package/simulation/FINAL-STATUS.md +281 -0
  671. package/simulation/INTEGRATION-COMPLETE.md +452 -0
  672. package/simulation/MIGRATION-STATUS.md +231 -0
  673. package/simulation/OPTIMIZATION-RESULTS.md +397 -0
  674. package/simulation/PHASE1-COMPLETE.md +163 -0
  675. package/simulation/README.md +848 -0
  676. package/simulation/SIMULATION-RESULTS.md +239 -0
  677. package/simulation/cli.ts +78 -0
  678. package/simulation/configs/default.json +37 -0
  679. package/simulation/data/advanced/aidefence.graph +0 -0
  680. package/simulation/data/advanced/bmssp.graph +0 -0
  681. package/simulation/data/advanced/consciousness.graph +0 -0
  682. package/simulation/data/advanced/goalie.graph +0 -0
  683. package/simulation/data/advanced/psycho-symbolic.graph +0 -0
  684. package/simulation/data/advanced/research-swarm.graph +0 -0
  685. package/simulation/data/advanced/sublinear.graph +0 -0
  686. package/simulation/data/advanced/temporal.graph +0 -0
  687. package/simulation/data/causal.graph +0 -0
  688. package/simulation/data/graph-traversal.graph +0 -0
  689. package/simulation/data/lean-agentic.graph +0 -0
  690. package/simulation/data/reflexion.graph +0 -0
  691. package/simulation/data/skills.graph +0 -0
  692. package/simulation/data/stock-market.graph +0 -0
  693. package/simulation/data/strange-loops.graph +0 -0
  694. package/simulation/data/swarm.graph +0 -0
  695. package/simulation/data/voting-consensus.graph +0 -0
  696. package/simulation/docs/CLI-INTEGRATION-PLAN.md +1038 -0
  697. package/simulation/docs/COMPREHENSIVE-LATENT-SPACE-COMPLETION.md +354 -0
  698. package/simulation/docs/DOCUMENTATION-INDEX.md +226 -0
  699. package/simulation/docs/IMPLEMENTATION-COMPLETE.md +521 -0
  700. package/simulation/docs/OPTIMIZATION-SUMMARY.md +279 -0
  701. package/simulation/docs/README.md +229 -0
  702. package/simulation/docs/SWARM-5-INTEGRATION-SUMMARY.md +528 -0
  703. package/simulation/docs/TESTING-SUMMARY.md +304 -0
  704. package/simulation/docs/architecture/EXTENSION-API.md +868 -0
  705. package/simulation/docs/architecture/INTEGRATION-ARCHITECTURE.md +1138 -0
  706. package/simulation/docs/architecture/OPTIMIZATION-STRATEGY.md +778 -0
  707. package/simulation/docs/architecture/SIMULATION-ARCHITECTURE.md +892 -0
  708. package/simulation/docs/guides/CLI-REFERENCE.md +896 -0
  709. package/simulation/docs/guides/CUSTOM-SIMULATIONS.md +931 -0
  710. package/simulation/docs/guides/DEPLOYMENT.md +832 -0
  711. package/simulation/docs/guides/IMPLEMENTATION-SUMMARY.md +544 -0
  712. package/simulation/docs/guides/MIGRATION-GUIDE.md +591 -0
  713. package/simulation/docs/guides/QUICK-START.md +361 -0
  714. package/simulation/docs/guides/README.md +736 -0
  715. package/simulation/docs/guides/TROUBLESHOOTING.md +817 -0
  716. package/simulation/docs/guides/WIZARD-GUIDE.md +869 -0
  717. package/simulation/docs/reports/latent-space/MASTER-SYNTHESIS.md +345 -0
  718. package/simulation/docs/reports/latent-space/README.md +132 -0
  719. package/simulation/docs/reports/latent-space/attention-analysis-RESULTS.md +238 -0
  720. package/simulation/docs/reports/latent-space/clustering-analysis-RESULTS.md +210 -0
  721. package/simulation/docs/reports/latent-space/hnsw-exploration-RESULTS.md +332 -0
  722. package/simulation/docs/reports/latent-space/hypergraph-exploration-RESULTS.md +37 -0
  723. package/simulation/docs/reports/latent-space/neural-augmentation-RESULTS.md +69 -0
  724. package/simulation/docs/reports/latent-space/quantum-hybrid-RESULTS.md +91 -0
  725. package/simulation/docs/reports/latent-space/self-organizing-hnsw-RESULTS.md +51 -0
  726. package/simulation/docs/reports/latent-space/traversal-optimization-RESULTS.md +238 -0
  727. package/simulation/reports/README.md +397 -0
  728. package/simulation/reports/advanced-simulations-performance.md +1241 -0
  729. package/simulation/reports/aidefence-integration-2025-11-30T01-36-53-486Z.json +30 -0
  730. package/simulation/reports/architecture-analysis.md +1396 -0
  731. package/simulation/reports/basic-scenarios-performance.md +1840 -0
  732. package/simulation/reports/bmssp-integration-2025-11-30T01-36-27-193Z.json +30 -0
  733. package/simulation/reports/bmssp-integration-2025-11-30T03-38-12-887Z.json +30 -0
  734. package/simulation/reports/causal-reasoning-2025-11-29T23-35-21-795Z.json +36 -0
  735. package/simulation/reports/causal-reasoning-2025-11-30T00-58-42-862Z.json +30 -0
  736. package/simulation/reports/causal-reasoning-2025-11-30T00-59-12-546Z.json +40 -0
  737. package/simulation/reports/consciousness-explorer-2025-11-30T01-36-51-269Z.json +31 -0
  738. package/simulation/reports/core-benchmarks.md +727 -0
  739. package/simulation/reports/goalie-integration-2025-11-30T01-36-52-377Z.json +30 -0
  740. package/simulation/reports/graph-traversal-2025-11-29T23-35-35-279Z.json +78 -0
  741. package/simulation/reports/graph-traversal-2025-11-29T23-37-36-697Z.json +30 -0
  742. package/simulation/reports/graph-traversal-2025-11-30T01-03-59-716Z.json +30 -0
  743. package/simulation/reports/graph-traversal-2025-11-30T01-05-10-984Z.json +30 -0
  744. package/simulation/reports/graph-traversal-2025-11-30T01-06-16-334Z.json +30 -0
  745. package/simulation/reports/graph-traversal-2025-11-30T01-06-53-312Z.json +30 -0
  746. package/simulation/reports/graph-traversal-2025-11-30T01-07-51-075Z.json +24 -0
  747. package/simulation/reports/graph-traversal-2025-11-30T01-08-22-179Z.json +42 -0
  748. package/simulation/reports/lean-agentic-swarm-2025-11-29T23-37-23-804Z.json +148 -0
  749. package/simulation/reports/lean-agentic-swarm-2025-11-30T01-31-24-401Z.json +31 -0
  750. package/simulation/reports/lean-agentic-swarm-2025-11-30T03-38-01-470Z.json +31 -0
  751. package/simulation/reports/multi-agent-swarm-2025-11-29T23-35-28-093Z.json +78 -0
  752. package/simulation/reports/multi-agent-swarm-2025-11-30T01-03-54-062Z.json +42 -0
  753. package/simulation/reports/multi-agent-swarm-2025-11-30T01-05-06-092Z.json +42 -0
  754. package/simulation/reports/psycho-symbolic-reasoner-2025-11-30T01-36-50-180Z.json +30 -0
  755. package/simulation/reports/quality-metrics.md +727 -0
  756. package/simulation/reports/reflexion-learning-2025-11-29T23-35-09-774Z.json +48 -0
  757. package/simulation/reports/reflexion-learning-2025-11-29T23-37-16-934Z.json +36 -0
  758. package/simulation/reports/reflexion-learning-2025-11-30T00-07-49-259Z.json +30 -0
  759. package/simulation/reports/reflexion-learning-2025-11-30T00-09-29-319Z.json +51 -0
  760. package/simulation/reports/reflexion-learning-2025-11-30T00-28-37-659Z.json +51 -0
  761. package/simulation/reports/reflexion-learning-2025-11-30T01-31-30-690Z.json +29 -0
  762. package/simulation/reports/reflexion-learning-2025-11-30T03-38-06-937Z.json +29 -0
  763. package/simulation/reports/research-foundations.md +2004 -0
  764. package/simulation/reports/research-swarm-2025-11-30T01-36-54-647Z.json +30 -0
  765. package/simulation/reports/scalability-deployment.md +2404 -0
  766. package/simulation/reports/skill-evolution-2025-11-29T23-35-15-945Z.json +36 -0
  767. package/simulation/reports/skill-evolution-2025-11-30T01-03-17-995Z.json +30 -0
  768. package/simulation/reports/skill-evolution-2025-11-30T01-03-48-441Z.json +30 -0
  769. package/simulation/reports/skill-evolution-2025-11-30T01-05-00-554Z.json +30 -0
  770. package/simulation/reports/skill-evolution-2025-11-30T01-06-11-436Z.json +30 -0
  771. package/simulation/reports/skill-evolution-2025-11-30T01-06-51-979Z.json +30 -0
  772. package/simulation/reports/skill-evolution-2025-11-30T01-07-32-695Z.json +40 -0
  773. package/simulation/reports/stock-market-emergence-2025-11-30T00-11-43-865Z.json +56 -0
  774. package/simulation/reports/stock-market-emergence-2025-11-30T00-28-57-495Z.json +56 -0
  775. package/simulation/reports/strange-loops-2025-11-29T23-37-30-621Z.json +78 -0
  776. package/simulation/reports/strange-loops-2025-11-30T00-07-55-415Z.json +30 -0
  777. package/simulation/reports/strange-loops-2025-11-30T00-09-35-133Z.json +30 -0
  778. package/simulation/reports/strange-loops-2025-11-30T00-48-50-744Z.json +24 -0
  779. package/simulation/reports/strange-loops-2025-11-30T00-54-48-044Z.json +24 -0
  780. package/simulation/reports/strange-loops-2025-11-30T00-57-27-633Z.json +24 -0
  781. package/simulation/reports/strange-loops-2025-11-30T00-57-59-135Z.json +42 -0
  782. package/simulation/reports/sublinear-solver-2025-11-30T01-36-33-134Z.json +30 -0
  783. package/simulation/reports/temporal-lead-solver-2025-11-30T01-36-38-628Z.json +30 -0
  784. package/simulation/reports/use-cases-applications.md +2212 -0
  785. package/simulation/reports/voting-system-consensus-2025-11-30T00-11-37-199Z.json +58 -0
  786. package/simulation/reports/voting-system-consensus-2025-11-30T00-28-47-735Z.json +58 -0
  787. package/simulation/runner.ts +300 -0
  788. package/simulation/scenarios/README-advanced/aidefence-integration.md +63 -0
  789. package/simulation/scenarios/README-advanced/bmssp-integration.md +58 -0
  790. package/simulation/scenarios/README-advanced/consciousness-explorer.md +53 -0
  791. package/simulation/scenarios/README-advanced/goalie-integration.md +61 -0
  792. package/simulation/scenarios/README-advanced/psycho-symbolic-reasoner.md +55 -0
  793. package/simulation/scenarios/README-advanced/research-swarm.md +63 -0
  794. package/simulation/scenarios/README-advanced/sublinear-solver.md +58 -0
  795. package/simulation/scenarios/README-advanced/temporal-lead-solver.md +55 -0
  796. package/simulation/scenarios/README-basic/causal-reasoning.md +39 -0
  797. package/simulation/scenarios/README-basic/graph-traversal.md +41 -0
  798. package/simulation/scenarios/README-basic/lean-agentic-swarm.md +122 -0
  799. package/simulation/scenarios/README-basic/multi-agent-swarm.md +34 -0
  800. package/simulation/scenarios/README-basic/reflexion-learning.md +41 -0
  801. package/simulation/scenarios/README-basic/skill-evolution.md +38 -0
  802. package/simulation/scenarios/README-basic/stock-market-emergence.md +28 -0
  803. package/simulation/scenarios/README-basic/strange-loops.md +36 -0
  804. package/simulation/scenarios/README-basic/voting-system-consensus.md +28 -0
  805. package/simulation/scenarios/README.md +438 -0
  806. package/simulation/scenarios/aidefence-integration.ts +165 -0
  807. package/simulation/scenarios/bmssp-integration.ts +137 -0
  808. package/simulation/scenarios/causal-reasoning.ts +143 -0
  809. package/simulation/scenarios/consciousness-explorer.ts +139 -0
  810. package/simulation/scenarios/domain-examples/.claude-flow/metrics/agent-metrics.json +1 -0
  811. package/simulation/scenarios/domain-examples/.claude-flow/metrics/performance.json +87 -0
  812. package/simulation/scenarios/domain-examples/.claude-flow/metrics/task-metrics.json +10 -0
  813. package/simulation/scenarios/domain-examples/README.md +525 -0
  814. package/simulation/scenarios/domain-examples/e-commerce-recommendations.ts +220 -0
  815. package/simulation/scenarios/domain-examples/index.ts +81 -0
  816. package/simulation/scenarios/domain-examples/iot-sensor-networks.ts +290 -0
  817. package/simulation/scenarios/domain-examples/medical-imaging.ts +181 -0
  818. package/simulation/scenarios/domain-examples/robotics-navigation.ts +214 -0
  819. package/simulation/scenarios/domain-examples/scientific-research.ts +250 -0
  820. package/simulation/scenarios/domain-examples/trading-systems.ts +138 -0
  821. package/simulation/scenarios/goalie-integration.ts +161 -0
  822. package/simulation/scenarios/graph-traversal.ts +129 -0
  823. package/simulation/scenarios/latent-space/OPTIMIZATION-COMPLETE.md +287 -0
  824. package/simulation/scenarios/latent-space/README-attention-analysis.md +170 -0
  825. package/simulation/scenarios/latent-space/README-clustering-analysis.md +239 -0
  826. package/simulation/scenarios/latent-space/README-hnsw-exploration.md +199 -0
  827. package/simulation/scenarios/latent-space/README-hypergraph-exploration.md +279 -0
  828. package/simulation/scenarios/latent-space/README-neural-augmentation.md +267 -0
  829. package/simulation/scenarios/latent-space/README-quantum-hybrid.md +276 -0
  830. package/simulation/scenarios/latent-space/README-self-organizing-hnsw.md +244 -0
  831. package/simulation/scenarios/latent-space/README-traversal-optimization.md +212 -0
  832. package/simulation/scenarios/latent-space/attention-analysis.ts +598 -0
  833. package/simulation/scenarios/latent-space/clustering-analysis.ts +796 -0
  834. package/simulation/scenarios/latent-space/hnsw-exploration.ts +526 -0
  835. package/simulation/scenarios/latent-space/hypergraph-exploration.ts +706 -0
  836. package/simulation/scenarios/latent-space/index.ts +47 -0
  837. package/simulation/scenarios/latent-space/neural-augmentation.ts +604 -0
  838. package/simulation/scenarios/latent-space/quantum-hybrid.ts +508 -0
  839. package/simulation/scenarios/latent-space/self-organizing-hnsw.ts +680 -0
  840. package/simulation/scenarios/latent-space/traversal-optimization.ts +782 -0
  841. package/simulation/scenarios/lean-agentic-swarm.ts +182 -0
  842. package/simulation/scenarios/multi-agent-swarm.ts +146 -0
  843. package/simulation/scenarios/psycho-symbolic-reasoner.ts +136 -0
  844. package/simulation/scenarios/reflexion-learning.ts +132 -0
  845. package/simulation/scenarios/research-swarm.ts +187 -0
  846. package/simulation/scenarios/skill-evolution.ts +135 -0
  847. package/simulation/scenarios/stock-market-emergence.ts +323 -0
  848. package/simulation/scenarios/strange-loops.ts +175 -0
  849. package/simulation/scenarios/sublinear-solver.ts +108 -0
  850. package/simulation/scenarios/temporal-lead-solver.ts +121 -0
  851. package/simulation/scenarios/voting-system-consensus.ts +251 -0
  852. package/simulation/tests/latent-space/attention-analysis.test.ts +204 -0
  853. package/simulation/tests/latent-space/clustering-analysis.test.ts +281 -0
  854. package/simulation/tests/latent-space/hnsw-exploration.test.ts +253 -0
  855. package/simulation/tests/latent-space/hypergraph-exploration.test.ts +295 -0
  856. package/simulation/tests/latent-space/neural-augmentation.test.ts +326 -0
  857. package/simulation/tests/latent-space/quantum-hybrid.test.ts +307 -0
  858. package/simulation/tests/latent-space/self-organizing-hnsw.test.ts +291 -0
  859. package/simulation/tests/latent-space/traversal-optimization.test.ts +261 -0
  860. package/simulation/types.ts +177 -0
  861. package/simulation/utils/PerformanceOptimizer.ts +269 -0
  862. package/src/backends/GraphBackend.ts +290 -0
  863. package/src/backends/LearningBackend.ts +210 -0
  864. package/src/backends/README.md +389 -0
  865. package/src/backends/VectorBackend.ts +145 -0
  866. package/src/backends/detector.ts +283 -0
  867. package/src/backends/factory.ts +193 -0
  868. package/src/backends/graph/GraphDatabaseAdapter.ts +334 -0
  869. package/src/backends/hnswlib/HNSWLibBackend.ts +413 -0
  870. package/src/backends/hnswlib/index.ts +7 -0
  871. package/src/backends/index.ts +32 -0
  872. package/src/backends/ruvector/RuVectorBackend.ts +232 -0
  873. package/src/backends/ruvector/RuVectorLearning.ts +242 -0
  874. package/src/backends/ruvector/index.ts +9 -0
  875. package/src/backends/ruvector/types.d.ts +64 -0
  876. package/src/browser/AdvancedFeatures.ts +565 -0
  877. package/src/browser/HNSWIndex.ts +494 -0
  878. package/src/browser/ProductQuantization.ts +419 -0
  879. package/src/browser/index.ts +301 -0
  880. package/src/cli/agentdb-cli.ts +131 -8
  881. package/src/cli/commands/init.ts +148 -0
  882. package/src/cli/commands/install-embeddings.ts +81 -0
  883. package/src/cli/commands/migrate.ts +545 -0
  884. package/src/cli/commands/simulate-custom.ts +232 -0
  885. package/src/cli/commands/simulate-report.ts +171 -0
  886. package/src/cli/commands/simulate-wizard.ts +379 -0
  887. package/src/cli/commands/simulate.ts +115 -0
  888. package/src/cli/commands/status.ts +156 -0
  889. package/src/cli/lib/config-manager.ts +627 -0
  890. package/src/cli/lib/config-validator.ts +261 -0
  891. package/src/cli/lib/health-monitor.ts +513 -0
  892. package/src/cli/lib/help-formatter.ts +406 -0
  893. package/src/cli/lib/history-tracker.ts +503 -0
  894. package/src/cli/lib/report-generator.ts +455 -0
  895. package/src/cli/lib/report-store.ts +582 -0
  896. package/src/cli/lib/simulation-registry.ts +502 -0
  897. package/src/cli/lib/simulation-runner.ts +291 -0
  898. package/src/cli/tests/agentdb-cli.test.ts +58 -0
  899. package/src/controllers/CausalMemoryGraph.ts +42 -2
  900. package/src/controllers/CausalRecall.ts +41 -4
  901. package/src/controllers/ExplainableRecall.ts +123 -5
  902. package/src/controllers/NightlyLearner.ts +8 -4
  903. package/src/controllers/ReasoningBank.ts +268 -5
  904. package/src/controllers/ReflexionMemory.ts +531 -6
  905. package/src/controllers/SkillLibrary.ts +234 -60
  906. package/src/db-fallback.ts +103 -35
  907. package/src/db-test.ts +59 -0
  908. package/src/db-unified.ts +327 -0
  909. package/src/mcp/agentdb-mcp-server.ts +544 -38
  910. package/src/optimizations/BatchOperations.ts +270 -0
  911. package/src/optimizations/ToolCache.ts +355 -0
  912. package/src/security/input-validation.ts +166 -0
  913. package/src/security/limits.ts +375 -0
  914. package/src/security/path-security.ts +436 -0
  915. package/src/security/validation.ts +556 -0
  916. package/src/services/LLMRouter.ts +406 -0
  917. package/src/types/xenova-transformers.d.ts +26 -0
  918. package/src/utils/NodeIdMapper.ts +64 -0
@@ -0,0 +1,402 @@
1
+ /**
2
+ * HNSW (Hierarchical Navigable Small World) Index for Browser
3
+ *
4
+ * JavaScript implementation of HNSW algorithm for fast approximate nearest neighbor search.
5
+ * Achieves O(log n) search complexity vs O(n) for linear scan.
6
+ *
7
+ * Features:
8
+ * - Multi-layer graph structure
9
+ * - Probabilistic layer assignment
10
+ * - Greedy search algorithm
11
+ * - Dynamic insertion
12
+ * - Configurable M (connections per node)
13
+ * - Configurable efConstruction and efSearch
14
+ *
15
+ * Performance:
16
+ * - 10-20x faster than linear scan (vs 150x for native HNSW)
17
+ * - Memory: ~16 bytes per edge + vector storage
18
+ * - Suitable for datasets up to 100K vectors in browser
19
+ */
20
+ class MinHeap {
21
+ items = [];
22
+ push(item, priority) {
23
+ this.items.push({ item, priority });
24
+ this.bubbleUp(this.items.length - 1);
25
+ }
26
+ pop() {
27
+ if (this.items.length === 0)
28
+ return undefined;
29
+ const result = this.items[0].item;
30
+ const last = this.items.pop();
31
+ if (this.items.length > 0) {
32
+ this.items[0] = last;
33
+ this.bubbleDown(0);
34
+ }
35
+ return result;
36
+ }
37
+ peek() {
38
+ return this.items[0]?.item;
39
+ }
40
+ size() {
41
+ return this.items.length;
42
+ }
43
+ bubbleUp(index) {
44
+ while (index > 0) {
45
+ const parentIndex = Math.floor((index - 1) / 2);
46
+ if (this.items[index].priority >= this.items[parentIndex].priority)
47
+ break;
48
+ [this.items[index], this.items[parentIndex]] = [this.items[parentIndex], this.items[index]];
49
+ index = parentIndex;
50
+ }
51
+ }
52
+ bubbleDown(index) {
53
+ while (true) {
54
+ const leftChild = 2 * index + 1;
55
+ const rightChild = 2 * index + 2;
56
+ let smallest = index;
57
+ if (leftChild < this.items.length && this.items[leftChild].priority < this.items[smallest].priority) {
58
+ smallest = leftChild;
59
+ }
60
+ if (rightChild < this.items.length && this.items[rightChild].priority < this.items[smallest].priority) {
61
+ smallest = rightChild;
62
+ }
63
+ if (smallest === index)
64
+ break;
65
+ [this.items[index], this.items[smallest]] = [this.items[smallest], this.items[index]];
66
+ index = smallest;
67
+ }
68
+ }
69
+ }
70
+ export class HNSWIndex {
71
+ config;
72
+ nodes = new Map();
73
+ entryPoint = null;
74
+ currentId = 0;
75
+ ml;
76
+ constructor(config = {}) {
77
+ this.config = {
78
+ dimension: config.dimension || 384,
79
+ M: config.M || 16,
80
+ efConstruction: config.efConstruction || 200,
81
+ efSearch: config.efSearch || 50,
82
+ ml: config.ml || 1 / Math.log(2),
83
+ maxLayers: config.maxLayers || 16,
84
+ distanceFunction: config.distanceFunction || 'cosine'
85
+ };
86
+ this.ml = this.config.ml;
87
+ }
88
+ /**
89
+ * Add vector to index
90
+ */
91
+ add(vector, id) {
92
+ const nodeId = id !== undefined ? id : this.currentId++;
93
+ const level = this.randomLevel();
94
+ const node = {
95
+ id: nodeId,
96
+ vector,
97
+ level,
98
+ connections: new Map()
99
+ };
100
+ // Initialize connections for each layer
101
+ for (let l = 0; l <= level; l++) {
102
+ node.connections.set(l, []);
103
+ }
104
+ if (this.entryPoint === null) {
105
+ // First node
106
+ this.entryPoint = nodeId;
107
+ this.nodes.set(nodeId, node);
108
+ return nodeId;
109
+ }
110
+ // Find nearest neighbors at each layer
111
+ const ep = this.entryPoint;
112
+ let nearest = ep;
113
+ // Search from top layer to target layer + 1
114
+ for (let lc = this.nodes.get(ep).level; lc > level; lc--) {
115
+ nearest = this.searchLayer(vector, nearest, 1, lc)[0];
116
+ }
117
+ // Insert node at layers 0 to level
118
+ for (let lc = Math.min(level, this.nodes.get(ep).level); lc >= 0; lc--) {
119
+ const candidates = this.searchLayer(vector, nearest, this.config.efConstruction, lc);
120
+ // Select M neighbors
121
+ const M = lc === 0 ? this.config.M * 2 : this.config.M;
122
+ const neighbors = this.selectNeighbors(vector, candidates, M);
123
+ // Add bidirectional connections
124
+ for (const neighbor of neighbors) {
125
+ this.connect(nodeId, neighbor, lc);
126
+ this.connect(neighbor, nodeId, lc);
127
+ // Prune connections if necessary
128
+ const neighborNode = this.nodes.get(neighbor);
129
+ const neighborConnections = neighborNode.connections.get(lc);
130
+ if (neighborConnections.length > M) {
131
+ const newNeighbors = this.selectNeighbors(neighborNode.vector, neighborConnections, M);
132
+ neighborNode.connections.set(lc, newNeighbors);
133
+ }
134
+ }
135
+ nearest = candidates[0];
136
+ }
137
+ // Update entry point if necessary
138
+ if (level > this.nodes.get(this.entryPoint).level) {
139
+ this.entryPoint = nodeId;
140
+ }
141
+ this.nodes.set(nodeId, node);
142
+ return nodeId;
143
+ }
144
+ /**
145
+ * Search for k nearest neighbors
146
+ */
147
+ search(query, k, ef) {
148
+ if (this.entryPoint === null)
149
+ return [];
150
+ ef = ef || Math.max(this.config.efSearch, k);
151
+ let ep = this.entryPoint;
152
+ let nearest = ep;
153
+ // Search from top to layer 1
154
+ for (let lc = this.nodes.get(ep).level; lc > 0; lc--) {
155
+ nearest = this.searchLayer(query, nearest, 1, lc)[0];
156
+ }
157
+ // Search at layer 0
158
+ const candidates = this.searchLayer(query, nearest, ef, 0);
159
+ // Convert to SearchResult and return top k
160
+ return candidates
161
+ .slice(0, k)
162
+ .map(id => ({
163
+ id,
164
+ distance: this.distance(query, this.nodes.get(id).vector),
165
+ vector: this.nodes.get(id).vector
166
+ }));
167
+ }
168
+ /**
169
+ * Search at specific layer
170
+ */
171
+ searchLayer(query, ep, ef, layer) {
172
+ const visited = new Set();
173
+ const candidates = new MinHeap();
174
+ const w = new MinHeap();
175
+ const dist = this.distance(query, this.nodes.get(ep).vector);
176
+ candidates.push(ep, dist);
177
+ w.push(ep, -dist); // Max heap (negate for min heap)
178
+ visited.add(ep);
179
+ while (candidates.size() > 0) {
180
+ const c = candidates.pop();
181
+ const fDist = -w.peek(); // Furthest point distance
182
+ const cDist = this.distance(query, this.nodes.get(c).vector);
183
+ if (cDist > fDist)
184
+ break;
185
+ const neighbors = this.nodes.get(c).connections.get(layer) || [];
186
+ for (const e of neighbors) {
187
+ if (visited.has(e))
188
+ continue;
189
+ visited.add(e);
190
+ const eDist = this.distance(query, this.nodes.get(e).vector);
191
+ const fDist = -w.peek();
192
+ if (eDist < fDist || w.size() < ef) {
193
+ candidates.push(e, eDist);
194
+ w.push(e, -eDist);
195
+ if (w.size() > ef) {
196
+ w.pop();
197
+ }
198
+ }
199
+ }
200
+ }
201
+ // Return ef nearest neighbors
202
+ const result = [];
203
+ while (w.size() > 0) {
204
+ result.unshift(w.pop());
205
+ }
206
+ return result;
207
+ }
208
+ /**
209
+ * Select best neighbors using heuristic
210
+ */
211
+ selectNeighbors(base, candidates, M) {
212
+ if (candidates.length <= M)
213
+ return candidates;
214
+ // Sort by distance
215
+ const sorted = candidates
216
+ .map(id => ({
217
+ id,
218
+ distance: this.distance(base, this.nodes.get(id).vector)
219
+ }))
220
+ .sort((a, b) => a.distance - b.distance);
221
+ return sorted.slice(0, M).map(x => x.id);
222
+ }
223
+ /**
224
+ * Connect two nodes at layer
225
+ */
226
+ connect(from, to, layer) {
227
+ const node = this.nodes.get(from);
228
+ const connections = node.connections.get(layer);
229
+ if (!connections.includes(to)) {
230
+ connections.push(to);
231
+ }
232
+ }
233
+ /**
234
+ * Random level assignment
235
+ */
236
+ randomLevel() {
237
+ let level = 0;
238
+ while (Math.random() < this.ml && level < this.config.maxLayers - 1) {
239
+ level++;
240
+ }
241
+ return level;
242
+ }
243
+ /**
244
+ * Distance function
245
+ */
246
+ distance(a, b) {
247
+ switch (this.config.distanceFunction) {
248
+ case 'cosine':
249
+ return 1 - this.cosineSimilarity(a, b);
250
+ case 'euclidean':
251
+ return this.euclideanDistance(a, b);
252
+ case 'manhattan':
253
+ return this.manhattanDistance(a, b);
254
+ default:
255
+ return 1 - this.cosineSimilarity(a, b);
256
+ }
257
+ }
258
+ cosineSimilarity(a, b) {
259
+ let dotProduct = 0;
260
+ let normA = 0;
261
+ let normB = 0;
262
+ for (let i = 0; i < a.length; i++) {
263
+ dotProduct += a[i] * b[i];
264
+ normA += a[i] * a[i];
265
+ normB += b[i] * b[i];
266
+ }
267
+ return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
268
+ }
269
+ euclideanDistance(a, b) {
270
+ let sum = 0;
271
+ for (let i = 0; i < a.length; i++) {
272
+ const diff = a[i] - b[i];
273
+ sum += diff * diff;
274
+ }
275
+ return Math.sqrt(sum);
276
+ }
277
+ manhattanDistance(a, b) {
278
+ let sum = 0;
279
+ for (let i = 0; i < a.length; i++) {
280
+ sum += Math.abs(a[i] - b[i]);
281
+ }
282
+ return sum;
283
+ }
284
+ /**
285
+ * Get index statistics
286
+ */
287
+ getStats() {
288
+ if (this.nodes.size === 0) {
289
+ return {
290
+ numNodes: 0,
291
+ numLayers: 0,
292
+ avgConnections: 0,
293
+ entryPointLevel: 0,
294
+ memoryBytes: 0
295
+ };
296
+ }
297
+ const maxLevel = Math.max(...Array.from(this.nodes.values()).map(n => n.level));
298
+ let totalConnections = 0;
299
+ for (const node of this.nodes.values()) {
300
+ for (const connections of node.connections.values()) {
301
+ totalConnections += connections.length;
302
+ }
303
+ }
304
+ const avgConnections = totalConnections / this.nodes.size;
305
+ // Estimate memory: vector + connections + metadata
306
+ const vectorBytes = this.config.dimension * 4; // Float32Array
307
+ const connectionBytes = avgConnections * 4; // number array
308
+ const metadataBytes = 100; // rough estimate for node object
309
+ const memoryBytes = this.nodes.size * (vectorBytes + connectionBytes + metadataBytes);
310
+ return {
311
+ numNodes: this.nodes.size,
312
+ numLayers: maxLevel + 1,
313
+ avgConnections,
314
+ entryPointLevel: this.entryPoint ? this.nodes.get(this.entryPoint).level : 0,
315
+ memoryBytes
316
+ };
317
+ }
318
+ /**
319
+ * Export index for persistence
320
+ */
321
+ export() {
322
+ const data = {
323
+ config: this.config,
324
+ entryPoint: this.entryPoint,
325
+ currentId: this.currentId,
326
+ nodes: Array.from(this.nodes.entries()).map(([id, node]) => ({
327
+ id,
328
+ vector: Array.from(node.vector),
329
+ level: node.level,
330
+ connections: Array.from(node.connections.entries())
331
+ }))
332
+ };
333
+ return JSON.stringify(data);
334
+ }
335
+ /**
336
+ * Import index from JSON
337
+ */
338
+ import(json) {
339
+ const data = JSON.parse(json);
340
+ this.config = data.config;
341
+ this.entryPoint = data.entryPoint;
342
+ this.currentId = data.currentId;
343
+ this.nodes.clear();
344
+ for (const nodeData of data.nodes) {
345
+ const node = {
346
+ id: nodeData.id,
347
+ vector: new Float32Array(nodeData.vector),
348
+ level: nodeData.level,
349
+ connections: new Map(nodeData.connections)
350
+ };
351
+ this.nodes.set(nodeData.id, node);
352
+ }
353
+ }
354
+ /**
355
+ * Clear index
356
+ */
357
+ clear() {
358
+ this.nodes.clear();
359
+ this.entryPoint = null;
360
+ this.currentId = 0;
361
+ }
362
+ /**
363
+ * Get number of nodes
364
+ */
365
+ size() {
366
+ return this.nodes.size;
367
+ }
368
+ }
369
+ /**
370
+ * Helper function to create HNSW index with default settings
371
+ */
372
+ export function createHNSW(dimension) {
373
+ return new HNSWIndex({
374
+ dimension,
375
+ M: 16,
376
+ efConstruction: 200,
377
+ efSearch: 50
378
+ });
379
+ }
380
+ /**
381
+ * Helper function to create fast HNSW (lower quality, faster build)
382
+ */
383
+ export function createFastHNSW(dimension) {
384
+ return new HNSWIndex({
385
+ dimension,
386
+ M: 8,
387
+ efConstruction: 100,
388
+ efSearch: 30
389
+ });
390
+ }
391
+ /**
392
+ * Helper function to create accurate HNSW (higher quality, slower build)
393
+ */
394
+ export function createAccurateHNSW(dimension) {
395
+ return new HNSWIndex({
396
+ dimension,
397
+ M: 32,
398
+ efConstruction: 400,
399
+ efSearch: 100
400
+ });
401
+ }
402
+ //# sourceMappingURL=HNSWIndex.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"HNSWIndex.js","sourceRoot":"","sources":["../../../src/browser/HNSWIndex.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Product Quantization for Browser
3
+ *
4
+ * Compresses high-dimensional vectors using product quantization.
5
+ * Achieves 4-32x memory reduction with minimal accuracy loss.
6
+ *
7
+ * Features:
8
+ * - PQ8: 8 subvectors, 256 centroids each (4x compression)
9
+ * - PQ16: 16 subvectors, 256 centroids each (8x compression)
10
+ * - Asymmetric distance computation (ADC)
11
+ * - K-means clustering for codebook training
12
+ *
13
+ * Performance:
14
+ * - Memory: Float32 (4 bytes) → uint8 (1 byte) per subvector
15
+ * - Speed: ~1.5x slower search vs uncompressed
16
+ * - Accuracy: 95-99% recall@10
17
+ */
18
+ export interface PQConfig {
19
+ dimension: number;
20
+ numSubvectors: number;
21
+ numCentroids: number;
22
+ maxIterations?: number;
23
+ convergenceThreshold?: number;
24
+ }
25
+ export interface PQCodebook {
26
+ subvectorDim: number;
27
+ numSubvectors: number;
28
+ numCentroids: number;
29
+ centroids: Float32Array[];
30
+ }
31
+ export interface CompressedVector {
32
+ codes: Uint8Array;
33
+ norm: number;
34
+ }
35
+ export declare class ProductQuantization {
36
+ private config;
37
+ private codebook;
38
+ private trained;
39
+ constructor(config: PQConfig);
40
+ /**
41
+ * Train codebook using k-means on training vectors
42
+ */
43
+ train(vectors: Float32Array[]): Promise<void>;
44
+ /**
45
+ * K-means clustering for centroids
46
+ */
47
+ private kMeans;
48
+ /**
49
+ * K-means++ initialization for better centroid selection
50
+ */
51
+ private kMeansPlusPlus;
52
+ /**
53
+ * Compress a vector using trained codebook
54
+ */
55
+ compress(vector: Float32Array): CompressedVector;
56
+ /**
57
+ * Decompress a vector (approximate reconstruction)
58
+ */
59
+ decompress(compressed: CompressedVector): Float32Array;
60
+ /**
61
+ * Asymmetric Distance Computation (ADC)
62
+ * Computes distance from query vector to compressed vector
63
+ */
64
+ asymmetricDistance(query: Float32Array, compressed: CompressedVector): number;
65
+ /**
66
+ * Batch compression for multiple vectors
67
+ */
68
+ batchCompress(vectors: Float32Array[]): CompressedVector[];
69
+ /**
70
+ * Get memory savings
71
+ */
72
+ getCompressionRatio(): number;
73
+ /**
74
+ * Export codebook for persistence
75
+ */
76
+ exportCodebook(): string;
77
+ /**
78
+ * Import codebook
79
+ */
80
+ importCodebook(json: string): void;
81
+ /**
82
+ * Utility: Squared Euclidean distance
83
+ */
84
+ private squaredDistance;
85
+ /**
86
+ * Get statistics
87
+ */
88
+ getStats(): {
89
+ trained: boolean;
90
+ compressionRatio: number;
91
+ memoryPerVector: number;
92
+ codebookSize: number;
93
+ };
94
+ }
95
+ /**
96
+ * Helper function to create PQ8 (8 subvectors, 4x compression)
97
+ */
98
+ export declare function createPQ8(dimension: number): ProductQuantization;
99
+ /**
100
+ * Helper function to create PQ16 (16 subvectors, 8x compression)
101
+ */
102
+ export declare function createPQ16(dimension: number): ProductQuantization;
103
+ /**
104
+ * Helper function to create PQ32 (32 subvectors, 16x compression)
105
+ */
106
+ export declare function createPQ32(dimension: number): ProductQuantization;
107
+ //# sourceMappingURL=ProductQuantization.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ProductQuantization.d.ts","sourceRoot":"","sources":["../../../src/browser/ProductQuantization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,QAAQ;IAe5B;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCnD;;OAEG;YACW,MAAM;IA0DpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuCtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB;IAwChD;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,gBAAgB,GAAG,YAAY;IAsBtD;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,GAAG,MAAM;IAsB7E;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,gBAAgB,EAAE;IAI1D;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAQ7B;;OAEG;IACH,cAAc,IAAI,MAAM;IAgBxB;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYlC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,QAAQ,IAAI;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;KACtB;CAcF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAOhE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAOjE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAOjE"}