agentdb 1.6.0 → 2.0.0-alpha.1

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 (734) 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/HNSWIndex.d.ts +128 -0
  110. package/dist/controllers/HNSWIndex.d.ts.map +1 -0
  111. package/dist/controllers/HNSWIndex.js +361 -0
  112. package/dist/controllers/HNSWIndex.js.map +1 -0
  113. package/dist/controllers/NightlyLearner.d.ts.map +1 -1
  114. package/dist/controllers/NightlyLearner.js +7 -4
  115. package/dist/controllers/NightlyLearner.js.map +1 -1
  116. package/dist/controllers/ReasoningBank.d.ts +101 -2
  117. package/dist/controllers/ReasoningBank.d.ts.map +1 -1
  118. package/dist/controllers/ReasoningBank.js +196 -4
  119. package/dist/controllers/ReasoningBank.js.map +1 -1
  120. package/dist/controllers/ReflexionMemory.d.ts +41 -1
  121. package/dist/controllers/ReflexionMemory.d.ts.map +1 -1
  122. package/dist/controllers/ReflexionMemory.js +282 -5
  123. package/dist/controllers/ReflexionMemory.js.map +1 -1
  124. package/dist/controllers/SkillLibrary.d.ts +27 -9
  125. package/dist/controllers/SkillLibrary.d.ts.map +1 -1
  126. package/dist/controllers/SkillLibrary.js +136 -47
  127. package/dist/controllers/SkillLibrary.js.map +1 -1
  128. package/dist/controllers/index.d.ts +2 -0
  129. package/dist/controllers/index.d.ts.map +1 -1
  130. package/dist/controllers/index.js +1 -0
  131. package/dist/controllers/index.js.map +1 -1
  132. package/dist/db-fallback.d.ts.map +1 -1
  133. package/dist/db-fallback.js +100 -29
  134. package/dist/db-fallback.js.map +1 -1
  135. package/dist/db-test.d.ts +13 -0
  136. package/dist/db-test.d.ts.map +1 -0
  137. package/dist/db-test.js +55 -0
  138. package/dist/db-test.js.map +1 -0
  139. package/dist/db-unified.d.ts +76 -0
  140. package/dist/db-unified.d.ts.map +1 -0
  141. package/dist/db-unified.js +278 -0
  142. package/dist/db-unified.js.map +1 -0
  143. package/dist/index.d.ts +1 -0
  144. package/dist/index.d.ts.map +1 -1
  145. package/dist/index.js +2 -1
  146. package/dist/index.js.map +1 -1
  147. package/dist/malp/core/ccc.d.ts +99 -0
  148. package/dist/malp/core/ccc.d.ts.map +1 -0
  149. package/dist/malp/core/ccc.js +181 -0
  150. package/dist/malp/core/ccc.js.map +1 -0
  151. package/dist/malp/core/index.d.ts +9 -0
  152. package/dist/malp/core/index.d.ts.map +1 -0
  153. package/dist/malp/core/index.js +9 -0
  154. package/dist/malp/core/index.js.map +1 -0
  155. package/dist/malp/core/linalg.d.ts +101 -0
  156. package/dist/malp/core/linalg.d.ts.map +1 -0
  157. package/dist/malp/core/linalg.js +278 -0
  158. package/dist/malp/core/linalg.js.map +1 -0
  159. package/dist/malp/core/optimizer.d.ts +68 -0
  160. package/dist/malp/core/optimizer.d.ts.map +1 -0
  161. package/dist/malp/core/optimizer.js +160 -0
  162. package/dist/malp/core/optimizer.js.map +1 -0
  163. package/dist/malp/index.d.ts +33 -0
  164. package/dist/malp/index.d.ts.map +1 -0
  165. package/dist/malp/index.js +37 -0
  166. package/dist/malp/index.js.map +1 -0
  167. package/dist/malp/metrics/agreement.d.ts +106 -0
  168. package/dist/malp/metrics/agreement.d.ts.map +1 -0
  169. package/dist/malp/metrics/agreement.js +199 -0
  170. package/dist/malp/metrics/agreement.js.map +1 -0
  171. package/dist/malp/metrics/comparison.d.ts +93 -0
  172. package/dist/malp/metrics/comparison.d.ts.map +1 -0
  173. package/dist/malp/metrics/comparison.js +256 -0
  174. package/dist/malp/metrics/comparison.js.map +1 -0
  175. package/dist/malp/metrics/index.d.ts +8 -0
  176. package/dist/malp/metrics/index.d.ts.map +1 -0
  177. package/dist/malp/metrics/index.js +8 -0
  178. package/dist/malp/metrics/index.js.map +1 -0
  179. package/dist/malp/metrics/performance.d.ts +61 -0
  180. package/dist/malp/metrics/performance.d.ts.map +1 -0
  181. package/dist/malp/metrics/performance.js +190 -0
  182. package/dist/malp/metrics/performance.js.map +1 -0
  183. package/dist/malp/models/index.d.ts +7 -0
  184. package/dist/malp/models/index.d.ts.map +1 -0
  185. package/dist/malp/models/index.js +7 -0
  186. package/dist/malp/models/index.js.map +1 -0
  187. package/dist/malp/models/malp.d.ts +116 -0
  188. package/dist/malp/models/malp.d.ts.map +1 -0
  189. package/dist/malp/models/malp.js +206 -0
  190. package/dist/malp/models/malp.js.map +1 -0
  191. package/dist/malp/models/regressor.d.ts +80 -0
  192. package/dist/malp/models/regressor.d.ts.map +1 -0
  193. package/dist/malp/models/regressor.js +229 -0
  194. package/dist/malp/models/regressor.js.map +1 -0
  195. package/dist/malp/reasoningbank_validator.d.ts +187 -0
  196. package/dist/malp/reasoningbank_validator.d.ts.map +1 -0
  197. package/dist/malp/reasoningbank_validator.js +246 -0
  198. package/dist/malp/reasoningbank_validator.js.map +1 -0
  199. package/dist/malp/wasm_bindings.d.ts +344 -0
  200. package/dist/malp/wasm_bindings.d.ts.map +1 -0
  201. package/dist/malp/wasm_bindings.js +9 -0
  202. package/dist/malp/wasm_bindings.js.map +1 -0
  203. package/dist/mcp/agentdb-mcp-server.js +512 -33
  204. package/dist/mcp/agentdb-mcp-server.js.map +1 -1
  205. package/dist/optimizations/BatchOperations.d.ts +42 -0
  206. package/dist/optimizations/BatchOperations.d.ts.map +1 -1
  207. package/dist/optimizations/BatchOperations.js +181 -0
  208. package/dist/optimizations/BatchOperations.js.map +1 -1
  209. package/dist/optimizations/ToolCache.d.ts +137 -0
  210. package/dist/optimizations/ToolCache.d.ts.map +1 -0
  211. package/dist/optimizations/ToolCache.js +281 -0
  212. package/dist/optimizations/ToolCache.js.map +1 -0
  213. package/dist/security/input-validation.d.ts +24 -0
  214. package/dist/security/input-validation.d.ts.map +1 -1
  215. package/dist/security/input-validation.js +106 -0
  216. package/dist/security/input-validation.js.map +1 -1
  217. package/dist/security/limits.d.ts +150 -0
  218. package/dist/security/limits.d.ts.map +1 -0
  219. package/dist/security/limits.js +288 -0
  220. package/dist/security/limits.js.map +1 -0
  221. package/dist/security/path-security.d.ts +100 -0
  222. package/dist/security/path-security.d.ts.map +1 -0
  223. package/dist/security/path-security.js +337 -0
  224. package/dist/security/path-security.js.map +1 -0
  225. package/dist/security/validation.d.ts +95 -0
  226. package/dist/security/validation.d.ts.map +1 -0
  227. package/dist/security/validation.js +315 -0
  228. package/dist/security/validation.js.map +1 -0
  229. package/dist/simulation/cli.d.ts +9 -0
  230. package/dist/simulation/cli.d.ts.map +1 -0
  231. package/dist/simulation/cli.js +68 -0
  232. package/dist/simulation/cli.js.map +1 -0
  233. package/dist/simulation/runner.d.ts +21 -0
  234. package/dist/simulation/runner.d.ts.map +1 -0
  235. package/dist/simulation/runner.js +241 -0
  236. package/dist/simulation/runner.js.map +1 -0
  237. package/dist/simulation/scenarios/aidefence-integration.d.ts +24 -0
  238. package/dist/simulation/scenarios/aidefence-integration.d.ts.map +1 -0
  239. package/dist/simulation/scenarios/aidefence-integration.js +124 -0
  240. package/dist/simulation/scenarios/aidefence-integration.js.map +1 -0
  241. package/dist/simulation/scenarios/bmssp-integration.d.ts +23 -0
  242. package/dist/simulation/scenarios/bmssp-integration.d.ts.map +1 -0
  243. package/dist/simulation/scenarios/bmssp-integration.js +104 -0
  244. package/dist/simulation/scenarios/bmssp-integration.js.map +1 -0
  245. package/dist/simulation/scenarios/causal-reasoning.d.ts +16 -0
  246. package/dist/simulation/scenarios/causal-reasoning.d.ts.map +1 -0
  247. package/dist/simulation/scenarios/causal-reasoning.js +108 -0
  248. package/dist/simulation/scenarios/causal-reasoning.js.map +1 -0
  249. package/dist/simulation/scenarios/consciousness-explorer.d.ts +25 -0
  250. package/dist/simulation/scenarios/consciousness-explorer.d.ts.map +1 -0
  251. package/dist/simulation/scenarios/consciousness-explorer.js +108 -0
  252. package/dist/simulation/scenarios/consciousness-explorer.js.map +1 -0
  253. package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.d.ts +135 -0
  254. package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.d.ts.map +1 -0
  255. package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.js +158 -0
  256. package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.js.map +1 -0
  257. package/dist/simulation/scenarios/domain-examples/index.d.ts +14 -0
  258. package/dist/simulation/scenarios/domain-examples/index.d.ts.map +1 -0
  259. package/dist/simulation/scenarios/domain-examples/index.js +14 -0
  260. package/dist/simulation/scenarios/domain-examples/index.js.map +1 -0
  261. package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.d.ts +178 -0
  262. package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.d.ts.map +1 -0
  263. package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.js +218 -0
  264. package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.js.map +1 -0
  265. package/dist/simulation/scenarios/domain-examples/medical-imaging.d.ts +122 -0
  266. package/dist/simulation/scenarios/domain-examples/medical-imaging.d.ts.map +1 -0
  267. package/dist/simulation/scenarios/domain-examples/medical-imaging.js +129 -0
  268. package/dist/simulation/scenarios/domain-examples/medical-imaging.js.map +1 -0
  269. package/dist/simulation/scenarios/domain-examples/robotics-navigation.d.ts +166 -0
  270. package/dist/simulation/scenarios/domain-examples/robotics-navigation.d.ts.map +1 -0
  271. package/dist/simulation/scenarios/domain-examples/robotics-navigation.js +161 -0
  272. package/dist/simulation/scenarios/domain-examples/robotics-navigation.js.map +1 -0
  273. package/dist/simulation/scenarios/domain-examples/scientific-research.d.ts +151 -0
  274. package/dist/simulation/scenarios/domain-examples/scientific-research.d.ts.map +1 -0
  275. package/dist/simulation/scenarios/domain-examples/scientific-research.js +187 -0
  276. package/dist/simulation/scenarios/domain-examples/scientific-research.js.map +1 -0
  277. package/dist/simulation/scenarios/domain-examples/trading-systems.d.ts +102 -0
  278. package/dist/simulation/scenarios/domain-examples/trading-systems.d.ts.map +1 -0
  279. package/dist/simulation/scenarios/domain-examples/trading-systems.js +100 -0
  280. package/dist/simulation/scenarios/domain-examples/trading-systems.js.map +1 -0
  281. package/dist/simulation/scenarios/goalie-integration.d.ts +24 -0
  282. package/dist/simulation/scenarios/goalie-integration.d.ts.map +1 -0
  283. package/dist/simulation/scenarios/goalie-integration.js +121 -0
  284. package/dist/simulation/scenarios/goalie-integration.js.map +1 -0
  285. package/dist/simulation/scenarios/graph-traversal.d.ts +17 -0
  286. package/dist/simulation/scenarios/graph-traversal.d.ts.map +1 -0
  287. package/dist/simulation/scenarios/graph-traversal.js +101 -0
  288. package/dist/simulation/scenarios/graph-traversal.js.map +1 -0
  289. package/dist/simulation/scenarios/latent-space/attention-analysis.d.ts +45 -0
  290. package/dist/simulation/scenarios/latent-space/attention-analysis.d.ts.map +1 -0
  291. package/dist/simulation/scenarios/latent-space/attention-analysis.js +435 -0
  292. package/dist/simulation/scenarios/latent-space/attention-analysis.js.map +1 -0
  293. package/dist/simulation/scenarios/latent-space/clustering-analysis.d.ts +55 -0
  294. package/dist/simulation/scenarios/latent-space/clustering-analysis.d.ts.map +1 -0
  295. package/dist/simulation/scenarios/latent-space/clustering-analysis.js +606 -0
  296. package/dist/simulation/scenarios/latent-space/clustering-analysis.js.map +1 -0
  297. package/dist/simulation/scenarios/latent-space/hnsw-exploration.d.ts +74 -0
  298. package/dist/simulation/scenarios/latent-space/hnsw-exploration.d.ts.map +1 -0
  299. package/dist/simulation/scenarios/latent-space/hnsw-exploration.js +391 -0
  300. package/dist/simulation/scenarios/latent-space/hnsw-exploration.js.map +1 -0
  301. package/dist/simulation/scenarios/latent-space/hypergraph-exploration.d.ts +51 -0
  302. package/dist/simulation/scenarios/latent-space/hypergraph-exploration.d.ts.map +1 -0
  303. package/dist/simulation/scenarios/latent-space/hypergraph-exploration.js +536 -0
  304. package/dist/simulation/scenarios/latent-space/hypergraph-exploration.js.map +1 -0
  305. package/dist/simulation/scenarios/latent-space/index.d.ts +35 -0
  306. package/dist/simulation/scenarios/latent-space/index.d.ts.map +1 -0
  307. package/dist/simulation/scenarios/latent-space/index.js +35 -0
  308. package/dist/simulation/scenarios/latent-space/index.js.map +1 -0
  309. package/dist/simulation/scenarios/latent-space/neural-augmentation.d.ts +52 -0
  310. package/dist/simulation/scenarios/latent-space/neural-augmentation.d.ts.map +1 -0
  311. package/dist/simulation/scenarios/latent-space/neural-augmentation.js +472 -0
  312. package/dist/simulation/scenarios/latent-space/neural-augmentation.js.map +1 -0
  313. package/dist/simulation/scenarios/latent-space/quantum-hybrid.d.ts +53 -0
  314. package/dist/simulation/scenarios/latent-space/quantum-hybrid.d.ts.map +1 -0
  315. package/dist/simulation/scenarios/latent-space/quantum-hybrid.js +391 -0
  316. package/dist/simulation/scenarios/latent-space/quantum-hybrid.js.map +1 -0
  317. package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.d.ts +52 -0
  318. package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.d.ts.map +1 -0
  319. package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.js +514 -0
  320. package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.js.map +1 -0
  321. package/dist/simulation/scenarios/latent-space/traversal-optimization.d.ts +53 -0
  322. package/dist/simulation/scenarios/latent-space/traversal-optimization.d.ts.map +1 -0
  323. package/dist/simulation/scenarios/latent-space/traversal-optimization.js +595 -0
  324. package/dist/simulation/scenarios/latent-space/traversal-optimization.js.map +1 -0
  325. package/dist/simulation/scenarios/lean-agentic-swarm.d.ts +18 -0
  326. package/dist/simulation/scenarios/lean-agentic-swarm.d.ts.map +1 -0
  327. package/dist/simulation/scenarios/lean-agentic-swarm.js +132 -0
  328. package/dist/simulation/scenarios/lean-agentic-swarm.js.map +1 -0
  329. package/dist/simulation/scenarios/multi-agent-swarm.d.ts +17 -0
  330. package/dist/simulation/scenarios/multi-agent-swarm.d.ts.map +1 -0
  331. package/dist/simulation/scenarios/multi-agent-swarm.js +111 -0
  332. package/dist/simulation/scenarios/multi-agent-swarm.js.map +1 -0
  333. package/dist/simulation/scenarios/psycho-symbolic-reasoner.d.ts +23 -0
  334. package/dist/simulation/scenarios/psycho-symbolic-reasoner.d.ts.map +1 -0
  335. package/dist/simulation/scenarios/psycho-symbolic-reasoner.js +98 -0
  336. package/dist/simulation/scenarios/psycho-symbolic-reasoner.js.map +1 -0
  337. package/dist/simulation/scenarios/reflexion-learning.d.ts +16 -0
  338. package/dist/simulation/scenarios/reflexion-learning.d.ts.map +1 -0
  339. package/dist/simulation/scenarios/reflexion-learning.js +98 -0
  340. package/dist/simulation/scenarios/reflexion-learning.js.map +1 -0
  341. package/dist/simulation/scenarios/research-swarm.d.ts +24 -0
  342. package/dist/simulation/scenarios/research-swarm.d.ts.map +1 -0
  343. package/dist/simulation/scenarios/research-swarm.js +146 -0
  344. package/dist/simulation/scenarios/research-swarm.js.map +1 -0
  345. package/dist/simulation/scenarios/skill-evolution.d.ts +16 -0
  346. package/dist/simulation/scenarios/skill-evolution.d.ts.map +1 -0
  347. package/dist/simulation/scenarios/skill-evolution.js +109 -0
  348. package/dist/simulation/scenarios/skill-evolution.js.map +1 -0
  349. package/dist/simulation/scenarios/stock-market-emergence.d.ts +33 -0
  350. package/dist/simulation/scenarios/stock-market-emergence.d.ts.map +1 -0
  351. package/dist/simulation/scenarios/stock-market-emergence.js +246 -0
  352. package/dist/simulation/scenarios/stock-market-emergence.js.map +1 -0
  353. package/dist/simulation/scenarios/strange-loops.d.ts +18 -0
  354. package/dist/simulation/scenarios/strange-loops.d.ts.map +1 -0
  355. package/dist/simulation/scenarios/strange-loops.js +133 -0
  356. package/dist/simulation/scenarios/strange-loops.js.map +1 -0
  357. package/dist/simulation/scenarios/sublinear-solver.d.ts +22 -0
  358. package/dist/simulation/scenarios/sublinear-solver.d.ts.map +1 -0
  359. package/dist/simulation/scenarios/sublinear-solver.js +82 -0
  360. package/dist/simulation/scenarios/sublinear-solver.js.map +1 -0
  361. package/dist/simulation/scenarios/temporal-lead-solver.d.ts +23 -0
  362. package/dist/simulation/scenarios/temporal-lead-solver.d.ts.map +1 -0
  363. package/dist/simulation/scenarios/temporal-lead-solver.js +90 -0
  364. package/dist/simulation/scenarios/temporal-lead-solver.js.map +1 -0
  365. package/dist/simulation/scenarios/voting-system-consensus.d.ts +27 -0
  366. package/dist/simulation/scenarios/voting-system-consensus.d.ts.map +1 -0
  367. package/dist/simulation/scenarios/voting-system-consensus.js +175 -0
  368. package/dist/simulation/scenarios/voting-system-consensus.js.map +1 -0
  369. package/dist/simulation/types.d.ts +162 -0
  370. package/dist/simulation/types.d.ts.map +1 -0
  371. package/dist/simulation/types.js +5 -0
  372. package/dist/simulation/types.js.map +1 -0
  373. package/dist/simulation/utils/PerformanceOptimizer.d.ts +115 -0
  374. package/dist/simulation/utils/PerformanceOptimizer.d.ts.map +1 -0
  375. package/dist/simulation/utils/PerformanceOptimizer.js +223 -0
  376. package/dist/simulation/utils/PerformanceOptimizer.js.map +1 -0
  377. package/dist/src/backends/GraphBackend.d.ts +196 -0
  378. package/dist/src/backends/GraphBackend.d.ts.map +1 -0
  379. package/dist/src/backends/GraphBackend.js +33 -0
  380. package/dist/src/backends/GraphBackend.js.map +1 -0
  381. package/dist/src/backends/LearningBackend.d.ts +148 -0
  382. package/dist/src/backends/LearningBackend.d.ts.map +1 -0
  383. package/dist/src/backends/LearningBackend.js +27 -0
  384. package/dist/src/backends/LearningBackend.js.map +1 -0
  385. package/dist/src/backends/VectorBackend.d.ts +119 -0
  386. package/dist/src/backends/VectorBackend.d.ts.map +1 -0
  387. package/dist/src/backends/VectorBackend.js +14 -0
  388. package/dist/src/backends/VectorBackend.js.map +1 -0
  389. package/dist/src/backends/detector.d.ts +81 -0
  390. package/dist/src/backends/detector.d.ts.map +1 -0
  391. package/dist/src/backends/detector.js +192 -0
  392. package/dist/src/backends/detector.js.map +1 -0
  393. package/dist/src/backends/factory.d.ts +50 -0
  394. package/dist/src/backends/factory.d.ts.map +1 -0
  395. package/dist/src/backends/factory.js +161 -0
  396. package/dist/src/backends/factory.js.map +1 -0
  397. package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts +151 -0
  398. package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts.map +1 -0
  399. package/dist/src/backends/graph/GraphDatabaseAdapter.js +224 -0
  400. package/dist/src/backends/graph/GraphDatabaseAdapter.js.map +1 -0
  401. package/dist/src/backends/hnswlib/HNSWLibBackend.d.ts +92 -0
  402. package/dist/src/backends/hnswlib/HNSWLibBackend.d.ts.map +1 -0
  403. package/dist/src/backends/hnswlib/HNSWLibBackend.js +316 -0
  404. package/dist/src/backends/hnswlib/HNSWLibBackend.js.map +1 -0
  405. package/dist/src/backends/hnswlib/index.d.ts +7 -0
  406. package/dist/src/backends/hnswlib/index.d.ts.map +1 -0
  407. package/dist/src/backends/hnswlib/index.js +7 -0
  408. package/dist/src/backends/hnswlib/index.js.map +1 -0
  409. package/dist/src/backends/index.d.ts +14 -0
  410. package/dist/src/backends/index.d.ts.map +1 -0
  411. package/dist/src/backends/index.js +13 -0
  412. package/dist/src/backends/index.js.map +1 -0
  413. package/dist/src/backends/ruvector/RuVectorBackend.d.ts +75 -0
  414. package/dist/src/backends/ruvector/RuVectorBackend.d.ts.map +1 -0
  415. package/dist/src/backends/ruvector/RuVectorBackend.js +198 -0
  416. package/dist/src/backends/ruvector/RuVectorBackend.js.map +1 -0
  417. package/dist/src/backends/ruvector/RuVectorLearning.d.ts +104 -0
  418. package/dist/src/backends/ruvector/RuVectorLearning.d.ts.map +1 -0
  419. package/dist/src/backends/ruvector/RuVectorLearning.js +177 -0
  420. package/dist/src/backends/ruvector/RuVectorLearning.js.map +1 -0
  421. package/dist/src/backends/ruvector/index.d.ts +9 -0
  422. package/dist/src/backends/ruvector/index.d.ts.map +1 -0
  423. package/dist/src/backends/ruvector/index.js +8 -0
  424. package/dist/src/backends/ruvector/index.js.map +1 -0
  425. package/dist/src/benchmarks/wasm-vector-benchmark.d.ts +10 -0
  426. package/dist/src/benchmarks/wasm-vector-benchmark.d.ts.map +1 -0
  427. package/dist/src/benchmarks/wasm-vector-benchmark.js +196 -0
  428. package/dist/src/benchmarks/wasm-vector-benchmark.js.map +1 -0
  429. package/dist/src/browser/AdvancedFeatures.d.ts +144 -0
  430. package/dist/src/browser/AdvancedFeatures.d.ts.map +1 -0
  431. package/dist/src/browser/AdvancedFeatures.js +430 -0
  432. package/dist/src/browser/AdvancedFeatures.js.map +1 -0
  433. package/dist/src/browser/HNSWIndex.d.ts +117 -0
  434. package/dist/src/browser/HNSWIndex.d.ts.map +1 -0
  435. package/dist/src/browser/HNSWIndex.js +402 -0
  436. package/dist/src/browser/HNSWIndex.js.map +1 -0
  437. package/dist/src/browser/ProductQuantization.d.ts +107 -0
  438. package/dist/src/browser/ProductQuantization.d.ts.map +1 -0
  439. package/dist/src/browser/ProductQuantization.js +337 -0
  440. package/dist/src/browser/ProductQuantization.js.map +1 -0
  441. package/dist/src/browser/index.d.ts +223 -0
  442. package/dist/src/browser/index.d.ts.map +1 -0
  443. package/dist/src/browser/index.js +225 -0
  444. package/dist/src/browser/index.js.map +1 -0
  445. package/dist/src/cli/agentdb-cli.d.ts +154 -0
  446. package/dist/src/cli/agentdb-cli.d.ts.map +1 -0
  447. package/dist/src/cli/agentdb-cli.js +2273 -0
  448. package/dist/src/cli/agentdb-cli.js.map +1 -0
  449. package/dist/src/cli/commands/init.d.ts +12 -0
  450. package/dist/src/cli/commands/init.d.ts.map +1 -0
  451. package/dist/src/cli/commands/init.js +115 -0
  452. package/dist/src/cli/commands/init.js.map +1 -0
  453. package/dist/src/cli/commands/install-embeddings.d.ts +10 -0
  454. package/dist/src/cli/commands/install-embeddings.d.ts.map +1 -0
  455. package/dist/src/cli/commands/install-embeddings.js +68 -0
  456. package/dist/src/cli/commands/install-embeddings.js.map +1 -0
  457. package/dist/src/cli/commands/migrate.d.ts +15 -0
  458. package/dist/src/cli/commands/migrate.d.ts.map +1 -0
  459. package/dist/src/cli/commands/migrate.js +425 -0
  460. package/dist/src/cli/commands/migrate.js.map +1 -0
  461. package/dist/src/cli/commands/simulate-custom.d.ts +26 -0
  462. package/dist/src/cli/commands/simulate-custom.d.ts.map +1 -0
  463. package/dist/src/cli/commands/simulate-custom.js +207 -0
  464. package/dist/src/cli/commands/simulate-custom.js.map +1 -0
  465. package/dist/src/cli/commands/simulate-report.d.ts +15 -0
  466. package/dist/src/cli/commands/simulate-report.d.ts.map +1 -0
  467. package/dist/src/cli/commands/simulate-report.js +136 -0
  468. package/dist/src/cli/commands/simulate-report.js.map +1 -0
  469. package/dist/src/cli/commands/simulate-wizard.d.ts +6 -0
  470. package/dist/src/cli/commands/simulate-wizard.d.ts.map +1 -0
  471. package/dist/src/cli/commands/simulate-wizard.js +352 -0
  472. package/dist/src/cli/commands/simulate-wizard.js.map +1 -0
  473. package/dist/src/cli/commands/simulate.d.ts +7 -0
  474. package/dist/src/cli/commands/simulate.d.ts.map +1 -0
  475. package/dist/src/cli/commands/simulate.js +100 -0
  476. package/dist/src/cli/commands/simulate.js.map +1 -0
  477. package/dist/src/cli/commands/status.d.ts +10 -0
  478. package/dist/src/cli/commands/status.d.ts.map +1 -0
  479. package/dist/src/cli/commands/status.js +129 -0
  480. package/dist/src/cli/commands/status.js.map +1 -0
  481. package/dist/src/cli/lib/config-manager.d.ts +110 -0
  482. package/dist/src/cli/lib/config-manager.d.ts.map +1 -0
  483. package/dist/src/cli/lib/config-manager.js +512 -0
  484. package/dist/src/cli/lib/config-manager.js.map +1 -0
  485. package/dist/src/cli/lib/config-validator.d.ts +43 -0
  486. package/dist/src/cli/lib/config-validator.d.ts.map +1 -0
  487. package/dist/src/cli/lib/config-validator.js +217 -0
  488. package/dist/src/cli/lib/config-validator.js.map +1 -0
  489. package/dist/src/cli/lib/health-monitor.d.ts +149 -0
  490. package/dist/src/cli/lib/health-monitor.d.ts.map +1 -0
  491. package/dist/src/cli/lib/health-monitor.js +380 -0
  492. package/dist/src/cli/lib/health-monitor.js.map +1 -0
  493. package/dist/src/cli/lib/help-formatter.d.ts +38 -0
  494. package/dist/src/cli/lib/help-formatter.d.ts.map +1 -0
  495. package/dist/src/cli/lib/help-formatter.js +357 -0
  496. package/dist/src/cli/lib/help-formatter.js.map +1 -0
  497. package/dist/src/cli/lib/history-tracker.d.ts +103 -0
  498. package/dist/src/cli/lib/history-tracker.d.ts.map +1 -0
  499. package/dist/src/cli/lib/history-tracker.js +346 -0
  500. package/dist/src/cli/lib/history-tracker.js.map +1 -0
  501. package/dist/src/cli/lib/report-generator.d.ts +24 -0
  502. package/dist/src/cli/lib/report-generator.d.ts.map +1 -0
  503. package/dist/src/cli/lib/report-generator.js +417 -0
  504. package/dist/src/cli/lib/report-generator.js.map +1 -0
  505. package/dist/src/cli/lib/report-store.d.ts +116 -0
  506. package/dist/src/cli/lib/report-store.d.ts.map +1 -0
  507. package/dist/src/cli/lib/report-store.js +464 -0
  508. package/dist/src/cli/lib/report-store.js.map +1 -0
  509. package/dist/src/cli/lib/simulation-registry.d.ts +165 -0
  510. package/dist/src/cli/lib/simulation-registry.d.ts.map +1 -0
  511. package/dist/src/cli/lib/simulation-registry.js +332 -0
  512. package/dist/src/cli/lib/simulation-registry.js.map +1 -0
  513. package/dist/src/cli/lib/simulation-runner.d.ts +90 -0
  514. package/dist/src/cli/lib/simulation-runner.d.ts.map +1 -0
  515. package/dist/src/cli/lib/simulation-runner.js +211 -0
  516. package/dist/src/cli/lib/simulation-runner.js.map +1 -0
  517. package/dist/src/controllers/CausalMemoryGraph.d.ts +127 -0
  518. package/dist/src/controllers/CausalMemoryGraph.d.ts.map +1 -0
  519. package/dist/src/controllers/CausalMemoryGraph.js +354 -0
  520. package/dist/src/controllers/CausalMemoryGraph.js.map +1 -0
  521. package/dist/src/controllers/CausalRecall.d.ts +139 -0
  522. package/dist/src/controllers/CausalRecall.d.ts.map +1 -0
  523. package/dist/src/controllers/CausalRecall.js +356 -0
  524. package/dist/src/controllers/CausalRecall.js.map +1 -0
  525. package/dist/src/controllers/ContextSynthesizer.d.ts +65 -0
  526. package/dist/src/controllers/ContextSynthesizer.d.ts.map +1 -0
  527. package/dist/src/controllers/ContextSynthesizer.js +208 -0
  528. package/dist/src/controllers/ContextSynthesizer.js.map +1 -0
  529. package/dist/src/controllers/EmbeddingService.d.ts +37 -0
  530. package/dist/src/controllers/EmbeddingService.d.ts.map +1 -0
  531. package/dist/src/controllers/EmbeddingService.js +136 -0
  532. package/dist/src/controllers/EmbeddingService.js.map +1 -0
  533. package/dist/src/controllers/EnhancedEmbeddingService.d.ts +50 -0
  534. package/dist/src/controllers/EnhancedEmbeddingService.d.ts.map +1 -0
  535. package/dist/src/controllers/EnhancedEmbeddingService.js +119 -0
  536. package/dist/src/controllers/EnhancedEmbeddingService.js.map +1 -0
  537. package/dist/src/controllers/ExplainableRecall.d.ts +163 -0
  538. package/dist/src/controllers/ExplainableRecall.d.ts.map +1 -0
  539. package/dist/src/controllers/ExplainableRecall.js +485 -0
  540. package/dist/src/controllers/ExplainableRecall.js.map +1 -0
  541. package/dist/src/controllers/HNSWIndex.d.ts +128 -0
  542. package/dist/src/controllers/HNSWIndex.d.ts.map +1 -0
  543. package/dist/src/controllers/HNSWIndex.js +361 -0
  544. package/dist/src/controllers/HNSWIndex.js.map +1 -0
  545. package/dist/src/controllers/LearningSystem.d.ts +195 -0
  546. package/dist/src/controllers/LearningSystem.d.ts.map +1 -0
  547. package/dist/src/controllers/LearningSystem.js +929 -0
  548. package/dist/src/controllers/LearningSystem.js.map +1 -0
  549. package/dist/src/controllers/MMRDiversityRanker.d.ts +50 -0
  550. package/dist/src/controllers/MMRDiversityRanker.d.ts.map +1 -0
  551. package/dist/src/controllers/MMRDiversityRanker.js +130 -0
  552. package/dist/src/controllers/MMRDiversityRanker.js.map +1 -0
  553. package/dist/src/controllers/MetadataFilter.d.ts +70 -0
  554. package/dist/src/controllers/MetadataFilter.d.ts.map +1 -0
  555. package/dist/src/controllers/MetadataFilter.js +243 -0
  556. package/dist/src/controllers/MetadataFilter.js.map +1 -0
  557. package/dist/src/controllers/NightlyLearner.d.ts +114 -0
  558. package/dist/src/controllers/NightlyLearner.d.ts.map +1 -0
  559. package/dist/src/controllers/NightlyLearner.js +394 -0
  560. package/dist/src/controllers/NightlyLearner.js.map +1 -0
  561. package/dist/src/controllers/QUICClient.d.ts +109 -0
  562. package/dist/src/controllers/QUICClient.d.ts.map +1 -0
  563. package/dist/src/controllers/QUICClient.js +299 -0
  564. package/dist/src/controllers/QUICClient.js.map +1 -0
  565. package/dist/src/controllers/QUICServer.d.ts +121 -0
  566. package/dist/src/controllers/QUICServer.d.ts.map +1 -0
  567. package/dist/src/controllers/QUICServer.js +383 -0
  568. package/dist/src/controllers/QUICServer.js.map +1 -0
  569. package/dist/src/controllers/ReasoningBank.d.ts +196 -0
  570. package/dist/src/controllers/ReasoningBank.d.ts.map +1 -0
  571. package/dist/src/controllers/ReasoningBank.js +494 -0
  572. package/dist/src/controllers/ReasoningBank.js.map +1 -0
  573. package/dist/src/controllers/ReflexionMemory.d.ts +125 -0
  574. package/dist/src/controllers/ReflexionMemory.d.ts.map +1 -0
  575. package/dist/src/controllers/ReflexionMemory.js +654 -0
  576. package/dist/src/controllers/ReflexionMemory.js.map +1 -0
  577. package/dist/src/controllers/SkillLibrary.d.ts +150 -0
  578. package/dist/src/controllers/SkillLibrary.d.ts.map +1 -0
  579. package/dist/src/controllers/SkillLibrary.js +608 -0
  580. package/dist/src/controllers/SkillLibrary.js.map +1 -0
  581. package/dist/src/controllers/SyncCoordinator.d.ts +120 -0
  582. package/dist/src/controllers/SyncCoordinator.d.ts.map +1 -0
  583. package/dist/src/controllers/SyncCoordinator.js +441 -0
  584. package/dist/src/controllers/SyncCoordinator.js.map +1 -0
  585. package/dist/src/controllers/WASMVectorSearch.d.ts +89 -0
  586. package/dist/src/controllers/WASMVectorSearch.d.ts.map +1 -0
  587. package/dist/src/controllers/WASMVectorSearch.js +234 -0
  588. package/dist/src/controllers/WASMVectorSearch.js.map +1 -0
  589. package/dist/src/controllers/frontier-index.d.ts +14 -0
  590. package/dist/src/controllers/frontier-index.d.ts.map +1 -0
  591. package/dist/src/controllers/frontier-index.js +10 -0
  592. package/dist/src/controllers/frontier-index.js.map +1 -0
  593. package/dist/src/controllers/index.d.ts +30 -0
  594. package/dist/src/controllers/index.d.ts.map +1 -0
  595. package/dist/src/controllers/index.js +18 -0
  596. package/dist/src/controllers/index.js.map +1 -0
  597. package/dist/src/db-fallback.d.ts +26 -0
  598. package/dist/src/db-fallback.d.ts.map +1 -0
  599. package/dist/src/db-fallback.js +264 -0
  600. package/dist/src/db-fallback.js.map +1 -0
  601. package/dist/src/db-test.d.ts +13 -0
  602. package/dist/src/db-test.d.ts.map +1 -0
  603. package/dist/src/db-test.js +55 -0
  604. package/dist/src/db-test.js.map +1 -0
  605. package/dist/src/db-unified.d.ts +76 -0
  606. package/dist/src/db-unified.d.ts.map +1 -0
  607. package/dist/src/db-unified.js +279 -0
  608. package/dist/src/db-unified.js.map +1 -0
  609. package/dist/src/examples/quic-sync-example.d.ts +9 -0
  610. package/dist/src/examples/quic-sync-example.d.ts.map +1 -0
  611. package/dist/src/examples/quic-sync-example.js +169 -0
  612. package/dist/src/examples/quic-sync-example.js.map +1 -0
  613. package/dist/src/examples/wasm-vector-usage.d.ts +12 -0
  614. package/dist/src/examples/wasm-vector-usage.d.ts.map +1 -0
  615. package/dist/src/examples/wasm-vector-usage.js +190 -0
  616. package/dist/src/examples/wasm-vector-usage.js.map +1 -0
  617. package/dist/src/index.d.ts +28 -0
  618. package/dist/src/index.d.ts.map +1 -0
  619. package/dist/src/index.js +35 -0
  620. package/dist/src/index.js.map +1 -0
  621. package/dist/src/mcp/agentdb-mcp-server.d.ts +8 -0
  622. package/dist/src/mcp/agentdb-mcp-server.d.ts.map +1 -0
  623. package/dist/src/mcp/agentdb-mcp-server.js +2116 -0
  624. package/dist/src/mcp/agentdb-mcp-server.js.map +1 -0
  625. package/dist/src/mcp/learning-tools-handlers.d.ts +16 -0
  626. package/dist/src/mcp/learning-tools-handlers.d.ts.map +1 -0
  627. package/dist/src/mcp/learning-tools-handlers.js +105 -0
  628. package/dist/src/mcp/learning-tools-handlers.js.map +1 -0
  629. package/dist/src/optimizations/BatchOperations.d.ts +109 -0
  630. package/dist/src/optimizations/BatchOperations.d.ts.map +1 -0
  631. package/dist/src/optimizations/BatchOperations.js +407 -0
  632. package/dist/src/optimizations/BatchOperations.js.map +1 -0
  633. package/dist/src/optimizations/QueryOptimizer.d.ts +83 -0
  634. package/dist/src/optimizations/QueryOptimizer.d.ts.map +1 -0
  635. package/dist/src/optimizations/QueryOptimizer.js +228 -0
  636. package/dist/src/optimizations/QueryOptimizer.js.map +1 -0
  637. package/dist/src/optimizations/ToolCache.d.ts +137 -0
  638. package/dist/src/optimizations/ToolCache.d.ts.map +1 -0
  639. package/dist/src/optimizations/ToolCache.js +281 -0
  640. package/dist/src/optimizations/ToolCache.js.map +1 -0
  641. package/dist/src/optimizations/index.d.ts +10 -0
  642. package/dist/src/optimizations/index.d.ts.map +1 -0
  643. package/dist/src/optimizations/index.js +8 -0
  644. package/dist/src/optimizations/index.js.map +1 -0
  645. package/dist/src/security/input-validation.d.ts +109 -0
  646. package/dist/src/security/input-validation.d.ts.map +1 -0
  647. package/dist/src/security/input-validation.js +398 -0
  648. package/dist/src/security/input-validation.js.map +1 -0
  649. package/dist/src/security/limits.d.ts +150 -0
  650. package/dist/src/security/limits.d.ts.map +1 -0
  651. package/dist/src/security/limits.js +288 -0
  652. package/dist/src/security/limits.js.map +1 -0
  653. package/dist/src/security/path-security.d.ts +100 -0
  654. package/dist/src/security/path-security.d.ts.map +1 -0
  655. package/dist/src/security/path-security.js +337 -0
  656. package/dist/src/security/path-security.js.map +1 -0
  657. package/dist/src/security/validation.d.ts +95 -0
  658. package/dist/src/security/validation.d.ts.map +1 -0
  659. package/dist/src/security/validation.js +315 -0
  660. package/dist/src/security/validation.js.map +1 -0
  661. package/dist/src/services/LLMRouter.d.ts +84 -0
  662. package/dist/src/services/LLMRouter.d.ts.map +1 -0
  663. package/dist/src/services/LLMRouter.js +329 -0
  664. package/dist/src/services/LLMRouter.js.map +1 -0
  665. package/dist/src/types/quic.d.ts +518 -0
  666. package/dist/src/types/quic.d.ts.map +1 -0
  667. package/dist/src/types/quic.js +272 -0
  668. package/dist/src/types/quic.js.map +1 -0
  669. package/dist/src/utils/NodeIdMapper.d.ts +38 -0
  670. package/dist/src/utils/NodeIdMapper.d.ts.map +1 -0
  671. package/dist/src/utils/NodeIdMapper.js +57 -0
  672. package/dist/src/utils/NodeIdMapper.js.map +1 -0
  673. package/package.json +15 -3
  674. package/scripts/README.md +314 -0
  675. package/src/backends/GraphBackend.ts +290 -0
  676. package/src/backends/LearningBackend.ts +210 -0
  677. package/src/backends/README.md +389 -0
  678. package/src/backends/VectorBackend.ts +145 -0
  679. package/src/backends/detector.ts +283 -0
  680. package/src/backends/factory.ts +193 -0
  681. package/src/backends/graph/GraphDatabaseAdapter.ts +334 -0
  682. package/src/backends/hnswlib/HNSWLibBackend.ts +413 -0
  683. package/src/backends/hnswlib/index.ts +7 -0
  684. package/src/backends/index.ts +32 -0
  685. package/src/backends/ruvector/RuVectorBackend.ts +232 -0
  686. package/src/backends/ruvector/RuVectorLearning.ts +242 -0
  687. package/src/backends/ruvector/index.ts +9 -0
  688. package/src/backends/ruvector/types.d.ts +64 -0
  689. package/src/browser/AdvancedFeatures.ts +565 -0
  690. package/src/browser/HNSWIndex.ts +494 -0
  691. package/src/browser/ProductQuantization.ts +419 -0
  692. package/src/browser/index.ts +301 -0
  693. package/src/cli/agentdb-cli.ts +131 -8
  694. package/src/cli/commands/init.ts +148 -0
  695. package/src/cli/commands/install-embeddings.ts +81 -0
  696. package/src/cli/commands/migrate.ts +545 -0
  697. package/src/cli/commands/simulate-custom.ts +232 -0
  698. package/src/cli/commands/simulate-report.ts +171 -0
  699. package/src/cli/commands/simulate-wizard.ts +379 -0
  700. package/src/cli/commands/simulate.ts +115 -0
  701. package/src/cli/commands/status.ts +156 -0
  702. package/src/cli/lib/config-manager.ts +627 -0
  703. package/src/cli/lib/config-validator.ts +261 -0
  704. package/src/cli/lib/health-monitor.ts +513 -0
  705. package/src/cli/lib/help-formatter.ts +406 -0
  706. package/src/cli/lib/history-tracker.ts +497 -0
  707. package/src/cli/lib/report-generator.ts +455 -0
  708. package/src/cli/lib/report-store.ts +582 -0
  709. package/src/cli/lib/simulation-registry.ts +502 -0
  710. package/src/cli/lib/simulation-runner.ts +291 -0
  711. package/src/cli/tests/agentdb-cli.test.ts +58 -0
  712. package/src/controllers/CausalMemoryGraph.ts +42 -2
  713. package/src/controllers/CausalRecall.ts +41 -4
  714. package/src/controllers/ExplainableRecall.ts +123 -5
  715. package/src/controllers/HNSWIndex.ts +495 -0
  716. package/src/controllers/NightlyLearner.ts +8 -4
  717. package/src/controllers/ReasoningBank.ts +268 -5
  718. package/src/controllers/ReflexionMemory.ts +531 -6
  719. package/src/controllers/SkillLibrary.ts +234 -60
  720. package/src/controllers/index.ts +2 -0
  721. package/src/db-fallback.ts +103 -35
  722. package/src/db-test.ts +59 -0
  723. package/src/db-unified.ts +327 -0
  724. package/src/index.ts +2 -1
  725. package/src/mcp/agentdb-mcp-server.ts +544 -38
  726. package/src/optimizations/BatchOperations.ts +270 -0
  727. package/src/optimizations/ToolCache.ts +355 -0
  728. package/src/security/input-validation.ts +166 -0
  729. package/src/security/limits.ts +375 -0
  730. package/src/security/path-security.ts +436 -0
  731. package/src/security/validation.ts +556 -0
  732. package/src/services/LLMRouter.ts +406 -0
  733. package/src/types/xenova-transformers.d.ts +26 -0
  734. package/src/utils/NodeIdMapper.ts +64 -0
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Gradient Ascent Optimizer for MALP
3
+ *
4
+ * Maximizes concordance correlation coefficient through iterative optimization.
5
+ * Uses adaptive learning rate and convergence detection.
6
+ */
7
+ export interface OptimizerConfig {
8
+ learningRate: number;
9
+ maxIterations: number;
10
+ tolerance: number;
11
+ momentum?: number;
12
+ adaptive?: boolean;
13
+ verbose?: boolean;
14
+ }
15
+ export interface OptimizationStep {
16
+ iteration: number;
17
+ ccc: number;
18
+ gradientNorm: number;
19
+ learningRate: number;
20
+ }
21
+ export interface OptimizerResult {
22
+ weights: number[];
23
+ finalCCC: number;
24
+ iterations: number;
25
+ converged: boolean;
26
+ history: OptimizationStep[];
27
+ }
28
+ export interface OptimizationResult extends OptimizerResult {
29
+ }
30
+ export declare const DEFAULT_OPTIMIZER_CONFIG: Required<OptimizerConfig>;
31
+ export declare class MALPOptimizer {
32
+ private config;
33
+ constructor(config?: Partial<OptimizerConfig>);
34
+ /**
35
+ * Optimize weights to maximize CCC between predictions and targets
36
+ * @param X Feature matrix (n_samples × n_features)
37
+ * @param y Target values (n_samples)
38
+ * @param initialWeights Starting weights (optional)
39
+ */
40
+ optimize(X: number[][], y: number[], initialWeights?: number[]): OptimizerResult;
41
+ /**
42
+ * Compute gradient of CCC with respect to weights
43
+ * Uses finite differences for numerical gradient
44
+ */
45
+ private computeGradient;
46
+ /**
47
+ * Compute predictions from features and weights
48
+ */
49
+ private predict;
50
+ /**
51
+ * Set new configuration
52
+ */
53
+ setConfig(config: Partial<OptimizerConfig>): void;
54
+ }
55
+ /**
56
+ * Perform line search to find optimal learning rate
57
+ */
58
+ export declare function lineSearch(X: number[][], y: number[], weights: number[], gradient: number[], maxLR?: number, nSteps?: number): number;
59
+ /**
60
+ * Alias for MALPOptimizer for backward compatibility
61
+ */
62
+ export declare class GradientAscentOptimizer extends MALPOptimizer {
63
+ }
64
+ /**
65
+ * Convenience function to optimize MALP weights
66
+ */
67
+ export declare function optimizeMALP(X: number[][], y: number[], config?: Partial<OptimizerConfig>): OptimizerResult;
68
+ //# sourceMappingURL=optimizer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../../src/malp/core/optimizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;CAAG;AAE9D,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,eAAe,CAO9D,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAWjD;;;;;OAKG;IACH,QAAQ,CACN,CAAC,EAAE,MAAM,EAAE,EAAE,EACb,CAAC,EAAE,MAAM,EAAE,EACX,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,eAAe;IAqFlB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;CAGlD;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,CAAC,EAAE,MAAM,EAAE,EAAE,EACb,CAAC,EAAE,MAAM,EAAE,EACX,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,GAAE,MAAY,EACnB,MAAM,GAAE,MAAW,GAClB,MAAM,CAmBR;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;CAAG;AAE7D;;GAEG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,MAAM,EAAE,EAAE,EACb,CAAC,EAAE,MAAM,EAAE,EACX,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,GACpC,eAAe,CAGjB"}
@@ -0,0 +1,160 @@
1
+ /**
2
+ * Gradient Ascent Optimizer for MALP
3
+ *
4
+ * Maximizes concordance correlation coefficient through iterative optimization.
5
+ * Uses adaptive learning rate and convergence detection.
6
+ */
7
+ import { calculateCCC } from './ccc';
8
+ export const DEFAULT_OPTIMIZER_CONFIG = {
9
+ learningRate: 0.01,
10
+ maxIterations: 1000,
11
+ tolerance: 1e-6,
12
+ momentum: 0.9,
13
+ adaptive: true,
14
+ verbose: false
15
+ };
16
+ export class MALPOptimizer {
17
+ config;
18
+ constructor(config = {}) {
19
+ this.config = {
20
+ learningRate: config.learningRate ?? 0.01,
21
+ maxIterations: config.maxIterations ?? 1000,
22
+ tolerance: config.tolerance ?? 1e-6,
23
+ momentum: config.momentum ?? 0.9,
24
+ adaptive: config.adaptive ?? true,
25
+ verbose: config.verbose ?? false
26
+ };
27
+ }
28
+ /**
29
+ * Optimize weights to maximize CCC between predictions and targets
30
+ * @param X Feature matrix (n_samples × n_features)
31
+ * @param y Target values (n_samples)
32
+ * @param initialWeights Starting weights (optional)
33
+ */
34
+ optimize(X, y, initialWeights) {
35
+ const nSamples = X.length;
36
+ const nFeatures = X[0].length;
37
+ // Initialize weights
38
+ let weights = initialWeights ?? Array(nFeatures).fill(0).map(() => (Math.random() - 0.5) * 0.01);
39
+ // Velocity for momentum
40
+ let velocity = Array(nFeatures).fill(0);
41
+ const history = [];
42
+ let learningRate = this.config.learningRate;
43
+ let prevCCC = -Infinity;
44
+ for (let iter = 0; iter < this.config.maxIterations; iter++) {
45
+ // Compute predictions
46
+ const predictions = this.predict(X, weights);
47
+ // Compute CCC and gradient
48
+ const cccResult = calculateCCC(predictions, y);
49
+ const gradient = this.computeGradient(X, y, predictions, cccResult);
50
+ const gradientNorm = Math.sqrt(gradient.reduce((sum, g) => sum + g * g, 0));
51
+ // Record history
52
+ history.push({
53
+ iteration: iter,
54
+ ccc: cccResult.ccc,
55
+ gradientNorm,
56
+ learningRate
57
+ });
58
+ if (this.config.verbose && iter % 100 === 0) {
59
+ console.log(`Iteration ${iter}: CCC = ${cccResult.ccc.toFixed(6)}, ` +
60
+ `Gradient Norm = ${gradientNorm.toFixed(6)}`);
61
+ }
62
+ // Check convergence
63
+ if (gradientNorm < this.config.tolerance) {
64
+ return {
65
+ weights,
66
+ finalCCC: cccResult.ccc,
67
+ iterations: iter + 1,
68
+ converged: true,
69
+ history
70
+ };
71
+ }
72
+ // Adaptive learning rate
73
+ if (this.config.adaptive) {
74
+ if (cccResult.ccc < prevCCC) {
75
+ learningRate *= 0.5; // Reduce if CCC decreased
76
+ }
77
+ else if (iter > 0 && cccResult.ccc > prevCCC) {
78
+ learningRate *= 1.05; // Increase if improving
79
+ }
80
+ }
81
+ // Update weights with momentum
82
+ for (let j = 0; j < nFeatures; j++) {
83
+ velocity[j] = this.config.momentum * velocity[j] +
84
+ learningRate * gradient[j];
85
+ weights[j] += velocity[j];
86
+ }
87
+ prevCCC = cccResult.ccc;
88
+ }
89
+ // Max iterations reached
90
+ const finalPredictions = this.predict(X, weights);
91
+ const finalCCC = calculateCCC(finalPredictions, y).ccc;
92
+ return {
93
+ weights,
94
+ finalCCC,
95
+ iterations: this.config.maxIterations,
96
+ converged: false,
97
+ history
98
+ };
99
+ }
100
+ /**
101
+ * Compute gradient of CCC with respect to weights
102
+ * Uses finite differences for numerical gradient
103
+ */
104
+ computeGradient(X, y, predictions, cccResult) {
105
+ const nFeatures = X[0].length;
106
+ const gradient = Array(nFeatures).fill(0);
107
+ const epsilon = 1e-5;
108
+ // Numerical gradient via finite differences
109
+ for (let j = 0; j < nFeatures; j++) {
110
+ // Perturb feature contribution
111
+ const perturbedPreds = predictions.map((pred, i) => pred + epsilon * X[i][j]);
112
+ const perturbedCCC = calculateCCC(perturbedPreds, y).ccc;
113
+ gradient[j] = (perturbedCCC - cccResult.ccc) / epsilon;
114
+ }
115
+ return gradient;
116
+ }
117
+ /**
118
+ * Compute predictions from features and weights
119
+ */
120
+ predict(X, weights) {
121
+ return X.map(row => row.reduce((sum, val, j) => sum + val * weights[j], 0));
122
+ }
123
+ /**
124
+ * Set new configuration
125
+ */
126
+ setConfig(config) {
127
+ this.config = { ...this.config, ...config };
128
+ }
129
+ }
130
+ /**
131
+ * Perform line search to find optimal learning rate
132
+ */
133
+ export function lineSearch(X, y, weights, gradient, maxLR = 1.0, nSteps = 10) {
134
+ let bestLR = 0;
135
+ let bestCCC = -Infinity;
136
+ for (let i = 0; i <= nSteps; i++) {
137
+ const lr = (i / nSteps) * maxLR;
138
+ const testWeights = weights.map((w, j) => w + lr * gradient[j]);
139
+ const predictions = X.map(row => row.reduce((sum, val, j) => sum + val * testWeights[j], 0));
140
+ const ccc = calculateCCC(predictions, y).ccc;
141
+ if (ccc > bestCCC) {
142
+ bestCCC = ccc;
143
+ bestLR = lr;
144
+ }
145
+ }
146
+ return bestLR;
147
+ }
148
+ /**
149
+ * Alias for MALPOptimizer for backward compatibility
150
+ */
151
+ export class GradientAscentOptimizer extends MALPOptimizer {
152
+ }
153
+ /**
154
+ * Convenience function to optimize MALP weights
155
+ */
156
+ export function optimizeMALP(X, y, config = {}) {
157
+ const optimizer = new MALPOptimizer(config);
158
+ return optimizer.optimize(X, y);
159
+ }
160
+ //# sourceMappingURL=optimizer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"optimizer.js","sourceRoot":"","sources":["../../../src/malp/core/optimizer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ /**
2
+ * MALP - Maximum Agreement Linear Predictor
3
+ *
4
+ * A regression library that maximizes the Concordance Correlation Coefficient (CCC)
5
+ * instead of minimizing squared error. Optimized for measurement validation,
6
+ * method comparison, and scenarios requiring high agreement between predictions
7
+ * and observations.
8
+ *
9
+ * @module malp
10
+ *
11
+ * @example
12
+ * ```typescript
13
+ * import { MALPRegressor, compareMALPvsOLS } from 'agentdb/malp';
14
+ *
15
+ * // Fit MALP model
16
+ * const model = new MALPRegressor();
17
+ * model.fit(X, y);
18
+ * const predictions = model.predict(X);
19
+ * const cccScore = model.score(X, y);
20
+ *
21
+ * // Compare with OLS
22
+ * const comparison = compareMALPvsOLS(X_train, y_train, X_test, y_test);
23
+ * console.log(comparison.summary);
24
+ * ```
25
+ */
26
+ export { type Matrix, type Vector, createMatrix, createVector, matVecMultiply, matMatMultiply, transpose, leastSquares, mean, std, variance, covariance, pearsonCorr, dot, norm, vectorAdd, vectorSubtract, scalarMultiply, addIntercept, EPSILON } from './core/linalg';
27
+ export { type CCCComponents, computeCCC, computeCCCGradient, computeCCCHessianDiagonal, cccLoss, interpretCCC, validateCCC } from './core/ccc';
28
+ export { type OptimizerConfig, type OptimizationStep, type OptimizationResult, GradientAscentOptimizer, optimizeMALP, DEFAULT_OPTIMIZER_CONFIG } from './core/optimizer';
29
+ export { type MALPConfig, type MALPRegressorConfig, type FitResult, MALPRegressor, fitMALP, crossValidateMALP, DEFAULT_MALP_CONFIG } from './models/regressor';
30
+ export { type AgreementMetrics, type BlandAltmanAnalysis, computeAgreementMetrics, blandAltmanAnalysis, computePrecisionMetrics, computeBiasMetrics, isAgreementAcceptable, generateAgreementReport } from './metrics/agreement';
31
+ export { type RegressionMetrics, type ComparisonResults, OLSRegressor, computeRegressionMetrics, compareMALPvsOLS, crossValidateComparison } from './metrics/comparison';
32
+ export declare const MALP_VERSION = "1.0.0";
33
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/malp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,MAAM,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,YAAY,EACZ,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,UAAU,EACV,WAAW,EACX,GAAG,EACH,IAAI,EACJ,SAAS,EACT,cAAc,EACd,cAAc,EACd,YAAY,EACZ,OAAO,EACR,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,KAAK,aAAa,EAClB,UAAU,EACV,kBAAkB,EAClB,yBAAyB,EACzB,OAAO,EACP,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,uBAAuB,EACvB,YAAY,EACZ,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAG9B,eAAO,MAAM,YAAY,UAAU,CAAC"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * MALP - Maximum Agreement Linear Predictor
3
+ *
4
+ * A regression library that maximizes the Concordance Correlation Coefficient (CCC)
5
+ * instead of minimizing squared error. Optimized for measurement validation,
6
+ * method comparison, and scenarios requiring high agreement between predictions
7
+ * and observations.
8
+ *
9
+ * @module malp
10
+ *
11
+ * @example
12
+ * ```typescript
13
+ * import { MALPRegressor, compareMALPvsOLS } from 'agentdb/malp';
14
+ *
15
+ * // Fit MALP model
16
+ * const model = new MALPRegressor();
17
+ * model.fit(X, y);
18
+ * const predictions = model.predict(X);
19
+ * const cccScore = model.score(X, y);
20
+ *
21
+ * // Compare with OLS
22
+ * const comparison = compareMALPvsOLS(X_train, y_train, X_test, y_test);
23
+ * console.log(comparison.summary);
24
+ * ```
25
+ */
26
+ // Core functionality
27
+ export { createMatrix, createVector, matVecMultiply, matMatMultiply, transpose, leastSquares, mean, std, variance, covariance, pearsonCorr, dot, norm, vectorAdd, vectorSubtract, scalarMultiply, addIntercept, EPSILON } from './core/linalg';
28
+ export { computeCCC, computeCCCGradient, computeCCCHessianDiagonal, cccLoss, interpretCCC, validateCCC } from './core/ccc';
29
+ export { GradientAscentOptimizer, optimizeMALP, DEFAULT_OPTIMIZER_CONFIG } from './core/optimizer';
30
+ // Models
31
+ export { MALPRegressor, fitMALP, crossValidateMALP, DEFAULT_MALP_CONFIG } from './models/regressor';
32
+ // Metrics
33
+ export { computeAgreementMetrics, blandAltmanAnalysis, computePrecisionMetrics, computeBiasMetrics, isAgreementAcceptable, generateAgreementReport } from './metrics/agreement';
34
+ export { OLSRegressor, computeRegressionMetrics, compareMALPvsOLS, crossValidateComparison } from './metrics/comparison';
35
+ // Version info
36
+ export const MALP_VERSION = '1.0.0';
37
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/malp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,qBAAqB;AACrB,OAAO,EAIL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,YAAY,EACZ,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,UAAU,EACV,WAAW,EACX,GAAG,EACH,IAAI,EACJ,SAAS,EACT,cAAc,EACd,cAAc,EACd,YAAY,EACZ,OAAO,EACR,MAAM,eAAe,CAAC;AAEvB,OAAO,EAGL,UAAU,EACV,kBAAkB,EAClB,yBAAyB,EACzB,OAAO,EACP,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAKL,uBAAuB,EACvB,YAAY,EACZ,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAE1B,SAAS;AACT,OAAO,EAIL,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,UAAU;AACV,OAAO,EAGL,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAGL,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,eAAe;AACf,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC"}
@@ -0,0 +1,106 @@
1
+ /**
2
+ * Agreement Metrics for Method Comparison
3
+ *
4
+ * Provides comprehensive metrics for assessing agreement between two measurement methods,
5
+ * with focus on CCC and related statistics.
6
+ */
7
+ import { Vector } from '../core/linalg';
8
+ import { CCCComponents } from '../core/ccc';
9
+ /**
10
+ * Complete agreement metrics suite
11
+ */
12
+ export interface AgreementMetrics {
13
+ /** Concordance Correlation Coefficient */
14
+ ccc: number;
15
+ /** CCC interpretation */
16
+ cccInterpretation: string;
17
+ /** Pearson correlation coefficient */
18
+ pearsonCorr: number;
19
+ /** Mean difference (bias) */
20
+ meanDifference: number;
21
+ /** Standard deviation of differences */
22
+ sdDifference: number;
23
+ /** 95% Limits of Agreement (Bland-Altman) */
24
+ limitsOfAgreement: [number, number];
25
+ /** Mean of the two methods */
26
+ overallMean: number;
27
+ /** Coefficient of variation */
28
+ coefficientOfVariation: number;
29
+ /** Total Deviation Index (TDI) at 90% coverage */
30
+ tdi90: number;
31
+ /** Coverage Probability (CP) */
32
+ coverageProbability: number;
33
+ /** CCC components breakdown */
34
+ cccComponents: CCCComponents;
35
+ }
36
+ /**
37
+ * Bland-Altman analysis results
38
+ */
39
+ export interface BlandAltmanAnalysis {
40
+ /** Mean difference (bias) */
41
+ meanDifference: number;
42
+ /** Standard deviation of differences */
43
+ sdDifference: number;
44
+ /** Lower limit of agreement (mean - 1.96*SD) */
45
+ lowerLimit: number;
46
+ /** Upper limit of agreement (mean + 1.96*SD) */
47
+ upperLimit: number;
48
+ /** Differences vector */
49
+ differences: number[];
50
+ /** Means vector */
51
+ means: number[];
52
+ /** Whether differences are within acceptable range */
53
+ withinLimits: boolean[];
54
+ }
55
+ /**
56
+ * Compute comprehensive agreement metrics
57
+ *
58
+ * @param x - First method (reference/gold standard)
59
+ * @param y - Second method (new/test method)
60
+ * @param acceptableLimit - Optional acceptable difference limit
61
+ * @returns Complete set of agreement metrics
62
+ */
63
+ export declare function computeAgreementMetrics(x: number[] | Vector, y: number[] | Vector, acceptableLimit?: number): AgreementMetrics;
64
+ /**
65
+ * Perform Bland-Altman analysis
66
+ *
67
+ * @param x - First method measurements
68
+ * @param y - Second method measurements
69
+ * @param acceptableLimit - Optional acceptable difference limit
70
+ * @returns Bland-Altman analysis results
71
+ */
72
+ export declare function blandAltmanAnalysis(x: number[] | Vector, y: number[] | Vector, acceptableLimit?: number): BlandAltmanAnalysis;
73
+ /**
74
+ * Compute precision (repeatability) metrics
75
+ */
76
+ export declare function computePrecisionMetrics(x: Vector, y: Vector): {
77
+ withinSubjectSD: number;
78
+ repeatabilityCoefficient: number;
79
+ withinSubjectCV: number;
80
+ };
81
+ /**
82
+ * Compute bias and accuracy metrics
83
+ */
84
+ export declare function computeBiasMetrics(x: Vector, y: Vector): {
85
+ meanBias: number;
86
+ proportionalBias: number;
87
+ fixedBias: number;
88
+ relativeAccuracy: number;
89
+ };
90
+ /**
91
+ * Check if agreement is acceptable based on predefined criteria
92
+ */
93
+ export declare function isAgreementAcceptable(metrics: AgreementMetrics, criteria?: {
94
+ minCCC?: number;
95
+ maxMeanDifference?: number;
96
+ maxSDDifference?: number;
97
+ minCoverageProbability?: number;
98
+ }): {
99
+ acceptable: boolean;
100
+ reasons: string[];
101
+ };
102
+ /**
103
+ * Generate agreement report
104
+ */
105
+ export declare function generateAgreementReport(metrics: AgreementMetrics): string;
106
+ //# sourceMappingURL=agreement.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agreement.d.ts","sourceRoot":"","sources":["../../../src/malp/metrics/agreement.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAqC,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAc,aAAa,EAAgB,MAAM,aAAa,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+BAA+B;IAC/B,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sDAAsD;IACtD,YAAY,EAAE,OAAO,EAAE,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACpB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,GACvB,gBAAgB,CAqDlB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACpB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,GACvB,mBAAmB,CAwCrB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,wBAAwB,EAAE,MAAM,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB,CAmBA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAqBA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,GAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC5B,GACL;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyB5C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA2BzE"}
@@ -0,0 +1,199 @@
1
+ /**
2
+ * Agreement Metrics for Method Comparison
3
+ *
4
+ * Provides comprehensive metrics for assessing agreement between two measurement methods,
5
+ * with focus on CCC and related statistics.
6
+ */
7
+ import { createVector, mean, std } from '../core/linalg';
8
+ import { computeCCC, interpretCCC } from '../core/ccc';
9
+ /**
10
+ * Compute comprehensive agreement metrics
11
+ *
12
+ * @param x - First method (reference/gold standard)
13
+ * @param y - Second method (new/test method)
14
+ * @param acceptableLimit - Optional acceptable difference limit
15
+ * @returns Complete set of agreement metrics
16
+ */
17
+ export function computeAgreementMetrics(x, y, acceptableLimit) {
18
+ const xVec = Array.isArray(x) ? createVector(x) : x;
19
+ const yVec = Array.isArray(y) ? createVector(y) : y;
20
+ if (xVec.length !== yVec.length) {
21
+ throw new Error(`Vector length mismatch: ${xVec.length} !== ${yVec.length}`);
22
+ }
23
+ // Compute CCC and components
24
+ const { ccc, components } = computeCCC(xVec, yVec);
25
+ const cccInterpretation = interpretCCC(ccc);
26
+ // Compute differences
27
+ const differences = xVec.data.map((val, i) => val - yVec.data[i]);
28
+ const diffVec = createVector(differences);
29
+ // Bland-Altman metrics
30
+ const meanDifference = mean(diffVec);
31
+ const sdDifference = std(diffVec, meanDifference);
32
+ const limitsOfAgreement = [
33
+ meanDifference - 1.96 * sdDifference,
34
+ meanDifference + 1.96 * sdDifference
35
+ ];
36
+ // Overall statistics
37
+ const overallMean = (components.muX + components.muY) / 2;
38
+ const coefficientOfVariation = (Math.sqrt((components.sigmaX ** 2 + components.sigmaY ** 2) / 2) / overallMean) * 100;
39
+ // Total Deviation Index (TDI) - 90th percentile of absolute differences
40
+ const sortedAbsDiffs = differences.map(Math.abs).sort((a, b) => a - b);
41
+ const tdi90Index = Math.floor(0.9 * sortedAbsDiffs.length);
42
+ const tdi90 = sortedAbsDiffs[tdi90Index];
43
+ // Coverage Probability - proportion within acceptable limit
44
+ let coverageProbability = 1.0;
45
+ if (acceptableLimit !== undefined) {
46
+ const withinLimit = differences.filter(d => Math.abs(d) <= acceptableLimit).length;
47
+ coverageProbability = withinLimit / differences.length;
48
+ }
49
+ return {
50
+ ccc,
51
+ cccInterpretation,
52
+ pearsonCorr: components.rho,
53
+ meanDifference,
54
+ sdDifference,
55
+ limitsOfAgreement,
56
+ overallMean,
57
+ coefficientOfVariation,
58
+ tdi90,
59
+ coverageProbability,
60
+ cccComponents: components
61
+ };
62
+ }
63
+ /**
64
+ * Perform Bland-Altman analysis
65
+ *
66
+ * @param x - First method measurements
67
+ * @param y - Second method measurements
68
+ * @param acceptableLimit - Optional acceptable difference limit
69
+ * @returns Bland-Altman analysis results
70
+ */
71
+ export function blandAltmanAnalysis(x, y, acceptableLimit) {
72
+ const xVec = Array.isArray(x) ? createVector(x) : x;
73
+ const yVec = Array.isArray(y) ? createVector(y) : y;
74
+ if (xVec.length !== yVec.length) {
75
+ throw new Error(`Vector length mismatch: ${xVec.length} !== ${yVec.length}`);
76
+ }
77
+ // Compute differences and means
78
+ const differences = [];
79
+ const means = [];
80
+ const withinLimits = [];
81
+ for (let i = 0; i < xVec.length; i++) {
82
+ const diff = xVec.data[i] - yVec.data[i];
83
+ const mean = (xVec.data[i] + yVec.data[i]) / 2;
84
+ differences.push(diff);
85
+ means.push(mean);
86
+ if (acceptableLimit !== undefined) {
87
+ withinLimits.push(Math.abs(diff) <= acceptableLimit);
88
+ }
89
+ else {
90
+ withinLimits.push(true);
91
+ }
92
+ }
93
+ const diffVec = createVector(differences);
94
+ const meanDifference = mean(diffVec);
95
+ const sdDifference = std(diffVec, meanDifference);
96
+ return {
97
+ meanDifference,
98
+ sdDifference,
99
+ lowerLimit: meanDifference - 1.96 * sdDifference,
100
+ upperLimit: meanDifference + 1.96 * sdDifference,
101
+ differences,
102
+ means,
103
+ withinLimits
104
+ };
105
+ }
106
+ /**
107
+ * Compute precision (repeatability) metrics
108
+ */
109
+ export function computePrecisionMetrics(x, y) {
110
+ const differences = x.data.map((val, i) => val - y.data[i]);
111
+ const diffVec = createVector(differences);
112
+ // Within-subject standard deviation (SD of differences / sqrt(2))
113
+ const withinSubjectSD = std(diffVec) / Math.sqrt(2);
114
+ // Repeatability coefficient (1.96 * sqrt(2) * SD_within)
115
+ const repeatabilityCoefficient = 1.96 * Math.sqrt(2) * withinSubjectSD;
116
+ // Within-subject coefficient of variation
117
+ const overallMean = (mean(x) + mean(y)) / 2;
118
+ const withinSubjectCV = (withinSubjectSD / overallMean) * 100;
119
+ return {
120
+ withinSubjectSD,
121
+ repeatabilityCoefficient,
122
+ withinSubjectCV
123
+ };
124
+ }
125
+ /**
126
+ * Compute bias and accuracy metrics
127
+ */
128
+ export function computeBiasMetrics(x, y) {
129
+ const { components } = computeCCC(x, y);
130
+ // Mean bias (average difference)
131
+ const meanBias = components.muX - components.muY;
132
+ // Proportional bias (slope of regression line - 1)
133
+ const proportionalBias = (components.sigmaY / components.sigmaX) * components.rho - 1;
134
+ // Fixed bias (intercept of regression line)
135
+ const fixedBias = components.muY - (components.muY / components.muX) * components.muX;
136
+ // Relative accuracy (ratio of means)
137
+ const relativeAccuracy = components.muY / components.muX;
138
+ return {
139
+ meanBias,
140
+ proportionalBias,
141
+ fixedBias,
142
+ relativeAccuracy
143
+ };
144
+ }
145
+ /**
146
+ * Check if agreement is acceptable based on predefined criteria
147
+ */
148
+ export function isAgreementAcceptable(metrics, criteria = {}) {
149
+ const reasons = [];
150
+ let acceptable = true;
151
+ if (criteria.minCCC !== undefined && metrics.ccc < criteria.minCCC) {
152
+ acceptable = false;
153
+ reasons.push(`CCC (${metrics.ccc.toFixed(3)}) below minimum (${criteria.minCCC})`);
154
+ }
155
+ if (criteria.maxMeanDifference !== undefined && Math.abs(metrics.meanDifference) > criteria.maxMeanDifference) {
156
+ acceptable = false;
157
+ reasons.push(`Mean difference (${metrics.meanDifference.toFixed(3)}) exceeds maximum (${criteria.maxMeanDifference})`);
158
+ }
159
+ if (criteria.maxSDDifference !== undefined && metrics.sdDifference > criteria.maxSDDifference) {
160
+ acceptable = false;
161
+ reasons.push(`SD of differences (${metrics.sdDifference.toFixed(3)}) exceeds maximum (${criteria.maxSDDifference})`);
162
+ }
163
+ if (criteria.minCoverageProbability !== undefined && metrics.coverageProbability < criteria.minCoverageProbability) {
164
+ acceptable = false;
165
+ reasons.push(`Coverage probability (${metrics.coverageProbability.toFixed(3)}) below minimum (${criteria.minCoverageProbability})`);
166
+ }
167
+ return { acceptable, reasons };
168
+ }
169
+ /**
170
+ * Generate agreement report
171
+ */
172
+ export function generateAgreementReport(metrics) {
173
+ const lines = [
174
+ '=== Agreement Analysis Report ===',
175
+ '',
176
+ 'Primary Metrics:',
177
+ ` CCC: ${metrics.ccc.toFixed(4)} (${metrics.cccInterpretation})`,
178
+ ` Pearson r: ${metrics.pearsonCorr.toFixed(4)}`,
179
+ '',
180
+ 'Bland-Altman Analysis:',
181
+ ` Mean Difference (Bias): ${metrics.meanDifference.toFixed(4)}`,
182
+ ` SD of Differences: ${metrics.sdDifference.toFixed(4)}`,
183
+ ` 95% Limits of Agreement: [${metrics.limitsOfAgreement[0].toFixed(4)}, ${metrics.limitsOfAgreement[1].toFixed(4)}]`,
184
+ '',
185
+ 'Precision Metrics:',
186
+ ` Coefficient of Variation: ${metrics.coefficientOfVariation.toFixed(2)}%`,
187
+ ` TDI (90%): ${metrics.tdi90.toFixed(4)}`,
188
+ ` Coverage Probability: ${(metrics.coverageProbability * 100).toFixed(2)}%`,
189
+ '',
190
+ 'CCC Components:',
191
+ ` Location Shift: ${metrics.cccComponents.locationShift.toFixed(4)}`,
192
+ ` Scale Shift: ${metrics.cccComponents.scaleShift.toFixed(4)}`,
193
+ ` Precision: ${metrics.cccComponents.precision.toFixed(4)}`,
194
+ ` Accuracy: ${metrics.cccComponents.accuracy.toFixed(4)}`,
195
+ ''
196
+ ];
197
+ return lines.join('\n');
198
+ }
199
+ //# sourceMappingURL=agreement.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agreement.js","sourceRoot":"","sources":["../../../src/malp/metrics/agreement.ts"],"names":[],"mappings":"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"}