agentdb 1.0.11 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (503) hide show
  1. package/README.md +196 -838
  2. package/dist/benchmarks/comprehensive-benchmark.js +664 -0
  3. package/dist/benchmarks/frontier-benchmark.js +419 -0
  4. package/dist/benchmarks/reflexion-benchmark.js +370 -0
  5. package/dist/cli/agentdb-cli.d.ts +117 -0
  6. package/dist/cli/agentdb-cli.d.ts.map +1 -0
  7. package/dist/cli/agentdb-cli.js +718 -0
  8. package/dist/cli/agentdb-cli.js.map +1 -0
  9. package/dist/controllers/CausalMemoryGraph.d.ts +125 -0
  10. package/dist/controllers/CausalMemoryGraph.d.ts.map +1 -0
  11. package/dist/controllers/CausalMemoryGraph.js +323 -0
  12. package/dist/controllers/CausalMemoryGraph.js.map +1 -0
  13. package/dist/controllers/CausalRecall.d.ts +111 -0
  14. package/dist/controllers/CausalRecall.d.ts.map +1 -0
  15. package/dist/controllers/CausalRecall.js +282 -0
  16. package/dist/controllers/CausalRecall.js.map +1 -0
  17. package/dist/controllers/EmbeddingService.d.ts +37 -0
  18. package/dist/controllers/EmbeddingService.d.ts.map +1 -0
  19. package/dist/controllers/EmbeddingService.js +119 -0
  20. package/dist/controllers/EmbeddingService.js.map +1 -0
  21. package/dist/controllers/ExplainableRecall.d.ts +138 -0
  22. package/dist/controllers/ExplainableRecall.d.ts.map +1 -0
  23. package/dist/controllers/ExplainableRecall.js +388 -0
  24. package/dist/controllers/ExplainableRecall.js.map +1 -0
  25. package/dist/controllers/NightlyLearner.d.ts +113 -0
  26. package/dist/controllers/NightlyLearner.d.ts.map +1 -0
  27. package/dist/controllers/NightlyLearner.js +383 -0
  28. package/dist/controllers/NightlyLearner.js.map +1 -0
  29. package/dist/controllers/ReflexionMemory.d.ts +84 -0
  30. package/dist/controllers/ReflexionMemory.d.ts.map +1 -0
  31. package/dist/controllers/ReflexionMemory.js +240 -0
  32. package/dist/controllers/ReflexionMemory.js.map +1 -0
  33. package/dist/controllers/SkillLibrary.d.ts +96 -0
  34. package/dist/controllers/SkillLibrary.d.ts.map +1 -0
  35. package/dist/controllers/SkillLibrary.js +277 -0
  36. package/dist/controllers/SkillLibrary.js.map +1 -0
  37. package/dist/controllers/frontier-index.d.ts +14 -0
  38. package/dist/controllers/frontier-index.d.ts.map +1 -0
  39. package/dist/controllers/frontier-index.js +10 -0
  40. package/dist/controllers/frontier-index.js.map +1 -0
  41. package/dist/controllers/index.d.ts +12 -0
  42. package/dist/controllers/index.d.ts.map +1 -0
  43. package/dist/controllers/index.js +9 -0
  44. package/dist/controllers/index.js.map +1 -0
  45. package/dist/optimizations/BatchOperations.d.ts +61 -0
  46. package/dist/optimizations/BatchOperations.d.ts.map +1 -0
  47. package/dist/optimizations/BatchOperations.js +199 -0
  48. package/dist/optimizations/BatchOperations.js.map +1 -0
  49. package/dist/optimizations/QueryOptimizer.d.ts +82 -0
  50. package/dist/optimizations/QueryOptimizer.d.ts.map +1 -0
  51. package/dist/optimizations/QueryOptimizer.js +226 -0
  52. package/dist/optimizations/QueryOptimizer.js.map +1 -0
  53. package/dist/optimizations/index.d.ts +10 -0
  54. package/dist/optimizations/index.d.ts.map +1 -0
  55. package/dist/optimizations/index.js +8 -0
  56. package/dist/optimizations/index.js.map +1 -0
  57. package/dist/schemas/frontier-schema.sql +341 -0
  58. package/dist/schemas/schema.sql +382 -0
  59. package/dist/tests/frontier-features.test.js +665 -0
  60. package/package.json +54 -117
  61. package/src/cli/agentdb-cli.ts +861 -0
  62. package/src/cli/examples.sh +83 -0
  63. package/src/controllers/CausalMemoryGraph.ts +504 -0
  64. package/src/controllers/CausalRecall.ts +395 -0
  65. package/src/controllers/EmbeddingService.ts +141 -0
  66. package/src/controllers/ExplainableRecall.ts +577 -0
  67. package/src/controllers/NightlyLearner.ts +475 -0
  68. package/src/controllers/ReflexionMemory.ts +349 -0
  69. package/src/controllers/SkillLibrary.ts +391 -0
  70. package/src/controllers/frontier-index.ts +35 -0
  71. package/src/controllers/index.ts +13 -0
  72. package/src/optimizations/BatchOperations.ts +292 -0
  73. package/src/optimizations/QueryOptimizer.ts +294 -0
  74. package/src/optimizations/index.ts +11 -0
  75. package/src/schemas/frontier-schema.sql +341 -0
  76. package/src/schemas/schema.sql +382 -0
  77. package/CHANGELOG.md +0 -166
  78. package/LICENSE +0 -38
  79. package/LICENSE-APACHE +0 -190
  80. package/LICENSE-MIT +0 -21
  81. package/bin/agentdb.js +0 -733
  82. package/bin/benchmark.js +0 -162
  83. package/bin/plugin-cli-wrapper.mjs +0 -21
  84. package/dist/agentdb.js +0 -5352
  85. package/dist/agentdb.js.map +0 -7
  86. package/dist/agentdb.min.js +0 -143
  87. package/dist/agentdb.min.js.map +0 -7
  88. package/dist/cache/query-cache.d.ts +0 -105
  89. package/dist/cache/query-cache.d.ts.map +0 -1
  90. package/dist/cache/query-cache.js +0 -224
  91. package/dist/cache/query-cache.js.map +0 -1
  92. package/dist/cache/query-cache.mjs +0 -219
  93. package/dist/cli/cache/query-cache.d.ts +0 -104
  94. package/dist/cli/cache/query-cache.js +0 -244
  95. package/dist/cli/cli/db-commands.d.ts +0 -48
  96. package/dist/cli/cli/db-commands.js +0 -613
  97. package/dist/cli/commands.d.ts +0 -7
  98. package/dist/cli/commands.d.ts.map +0 -1
  99. package/dist/cli/commands.js +0 -113
  100. package/dist/cli/commands.js.map +0 -1
  101. package/dist/cli/commands.mjs +0 -104
  102. package/dist/cli/core/backend-interface.d.ts +0 -70
  103. package/dist/cli/core/backend-interface.js +0 -15
  104. package/dist/cli/core/native-backend.d.ts +0 -140
  105. package/dist/cli/core/native-backend.js +0 -432
  106. package/dist/cli/core/vector-db.d.ts +0 -126
  107. package/dist/cli/core/vector-db.js +0 -338
  108. package/dist/cli/core/wasm-backend.d.ts +0 -95
  109. package/dist/cli/core/wasm-backend.js +0 -418
  110. package/dist/cli/db-commands.d.ts +0 -49
  111. package/dist/cli/db-commands.d.ts.map +0 -1
  112. package/dist/cli/db-commands.js +0 -533
  113. package/dist/cli/db-commands.js.map +0 -1
  114. package/dist/cli/db-commands.mjs +0 -522
  115. package/dist/cli/generator.d.ts +0 -11
  116. package/dist/cli/generator.d.ts.map +0 -1
  117. package/dist/cli/generator.js +0 -567
  118. package/dist/cli/generator.js.map +0 -1
  119. package/dist/cli/generator.mjs +0 -527
  120. package/dist/cli/help.d.ts +0 -18
  121. package/dist/cli/help.d.ts.map +0 -1
  122. package/dist/cli/help.js +0 -676
  123. package/dist/cli/help.js.map +0 -1
  124. package/dist/cli/help.mjs +0 -667
  125. package/dist/cli/index/hnsw.d.ts +0 -164
  126. package/dist/cli/index/hnsw.js +0 -558
  127. package/dist/cli/plugin-cli.d.ts +0 -7
  128. package/dist/cli/plugin-cli.d.ts.map +0 -1
  129. package/dist/cli/plugin-cli.js +0 -295
  130. package/dist/cli/plugin-cli.js.map +0 -1
  131. package/dist/cli/plugin-cli.mjs +0 -289
  132. package/dist/cli/quantization/product-quantization.d.ts +0 -108
  133. package/dist/cli/quantization/product-quantization.js +0 -350
  134. package/dist/cli/query/query-builder.d.ts +0 -322
  135. package/dist/cli/query/query-builder.js +0 -600
  136. package/dist/cli/templates.d.ts +0 -14
  137. package/dist/cli/templates.d.ts.map +0 -1
  138. package/dist/cli/templates.js +0 -182
  139. package/dist/cli/templates.js.map +0 -1
  140. package/dist/cli/templates.mjs +0 -176
  141. package/dist/cli/types/index.d.ts +0 -116
  142. package/dist/cli/types/index.js +0 -5
  143. package/dist/cli/types.d.ts +0 -91
  144. package/dist/cli/types.d.ts.map +0 -1
  145. package/dist/cli/types.js +0 -6
  146. package/dist/cli/types.js.map +0 -1
  147. package/dist/cli/types.mjs +0 -4
  148. package/dist/cli/wizard/index.d.ts +0 -6
  149. package/dist/cli/wizard/index.d.ts.map +0 -1
  150. package/dist/cli/wizard/index.js +0 -138
  151. package/dist/cli/wizard/index.js.map +0 -1
  152. package/dist/cli/wizard/index.mjs +0 -131
  153. package/dist/cli/wizard/prompts.d.ts +0 -11
  154. package/dist/cli/wizard/prompts.d.ts.map +0 -1
  155. package/dist/cli/wizard/prompts.js +0 -482
  156. package/dist/cli/wizard/prompts.js.map +0 -1
  157. package/dist/cli/wizard/prompts.mjs +0 -470
  158. package/dist/cli/wizard/validator.d.ts +0 -13
  159. package/dist/cli/wizard/validator.d.ts.map +0 -1
  160. package/dist/cli/wizard/validator.js +0 -234
  161. package/dist/cli/wizard/validator.js.map +0 -1
  162. package/dist/cli/wizard/validator.mjs +0 -224
  163. package/dist/core/backend-interface.d.ts +0 -71
  164. package/dist/core/backend-interface.d.ts.map +0 -1
  165. package/dist/core/backend-interface.js +0 -16
  166. package/dist/core/backend-interface.js.map +0 -1
  167. package/dist/core/backend-interface.mjs +0 -12
  168. package/dist/core/native-backend.d.ts +0 -141
  169. package/dist/core/native-backend.d.ts.map +0 -1
  170. package/dist/core/native-backend.js +0 -457
  171. package/dist/core/native-backend.js.map +0 -1
  172. package/dist/core/native-backend.mjs +0 -449
  173. package/dist/core/vector-db.d.ts +0 -127
  174. package/dist/core/vector-db.d.ts.map +0 -1
  175. package/dist/core/vector-db.js +0 -270
  176. package/dist/core/vector-db.js.map +0 -1
  177. package/dist/core/vector-db.mjs +0 -265
  178. package/dist/core/wasm-backend.d.ts +0 -96
  179. package/dist/core/wasm-backend.d.ts.map +0 -1
  180. package/dist/core/wasm-backend.js +0 -393
  181. package/dist/core/wasm-backend.js.map +0 -1
  182. package/dist/core/wasm-backend.mjs +0 -385
  183. package/dist/index/hnsw-optimized.d.ts +0 -75
  184. package/dist/index/hnsw-optimized.d.ts.map +0 -1
  185. package/dist/index/hnsw-optimized.js +0 -412
  186. package/dist/index/hnsw-optimized.js.map +0 -1
  187. package/dist/index/hnsw-optimized.mjs +0 -407
  188. package/dist/index/hnsw.d.ts +0 -165
  189. package/dist/index/hnsw.d.ts.map +0 -1
  190. package/dist/index/hnsw.js +0 -521
  191. package/dist/index/hnsw.js.map +0 -1
  192. package/dist/index/hnsw.mjs +0 -516
  193. package/dist/index.browser.d.ts +0 -47
  194. package/dist/index.browser.d.ts.map +0 -1
  195. package/dist/index.browser.js +0 -72
  196. package/dist/index.browser.js.map +0 -1
  197. package/dist/index.browser.mjs +0 -54
  198. package/dist/index.d.ts +0 -59
  199. package/dist/index.d.ts.map +0 -1
  200. package/dist/index.js +0 -84
  201. package/dist/index.js.map +0 -1
  202. package/dist/index.mjs +0 -65
  203. package/dist/mcp/learning/core/experience-buffer.d.ts +0 -61
  204. package/dist/mcp/learning/core/experience-buffer.d.ts.map +0 -1
  205. package/dist/mcp/learning/core/experience-buffer.js +0 -175
  206. package/dist/mcp/learning/core/experience-buffer.js.map +0 -1
  207. package/dist/mcp/learning/core/experience-buffer.mjs +0 -170
  208. package/dist/mcp/learning/core/experience-recorder.d.ts +0 -40
  209. package/dist/mcp/learning/core/experience-recorder.d.ts.map +0 -1
  210. package/dist/mcp/learning/core/experience-recorder.js +0 -200
  211. package/dist/mcp/learning/core/experience-recorder.js.map +0 -1
  212. package/dist/mcp/learning/core/experience-recorder.mjs +0 -195
  213. package/dist/mcp/learning/core/learning-manager.d.ts +0 -66
  214. package/dist/mcp/learning/core/learning-manager.d.ts.map +0 -1
  215. package/dist/mcp/learning/core/learning-manager.js +0 -252
  216. package/dist/mcp/learning/core/learning-manager.js.map +0 -1
  217. package/dist/mcp/learning/core/learning-manager.mjs +0 -247
  218. package/dist/mcp/learning/core/policy-optimizer.d.ts +0 -53
  219. package/dist/mcp/learning/core/policy-optimizer.d.ts.map +0 -1
  220. package/dist/mcp/learning/core/policy-optimizer.js +0 -251
  221. package/dist/mcp/learning/core/policy-optimizer.js.map +0 -1
  222. package/dist/mcp/learning/core/policy-optimizer.mjs +0 -246
  223. package/dist/mcp/learning/core/reward-estimator.d.ts +0 -44
  224. package/dist/mcp/learning/core/reward-estimator.d.ts.map +0 -1
  225. package/dist/mcp/learning/core/reward-estimator.js +0 -158
  226. package/dist/mcp/learning/core/reward-estimator.js.map +0 -1
  227. package/dist/mcp/learning/core/reward-estimator.mjs +0 -153
  228. package/dist/mcp/learning/core/session-manager.d.ts +0 -63
  229. package/dist/mcp/learning/core/session-manager.d.ts.map +0 -1
  230. package/dist/mcp/learning/core/session-manager.js +0 -202
  231. package/dist/mcp/learning/core/session-manager.js.map +0 -1
  232. package/dist/mcp/learning/core/session-manager.mjs +0 -197
  233. package/dist/mcp/learning/index.d.ts +0 -19
  234. package/dist/mcp/learning/index.d.ts.map +0 -1
  235. package/dist/mcp/learning/index.js +0 -30
  236. package/dist/mcp/learning/index.js.map +0 -1
  237. package/dist/mcp/learning/index.mjs +0 -19
  238. package/dist/mcp/learning/tools/mcp-learning-tools.d.ts +0 -369
  239. package/dist/mcp/learning/tools/mcp-learning-tools.d.ts.map +0 -1
  240. package/dist/mcp/learning/tools/mcp-learning-tools.js +0 -361
  241. package/dist/mcp/learning/tools/mcp-learning-tools.js.map +0 -1
  242. package/dist/mcp/learning/tools/mcp-learning-tools.mjs +0 -356
  243. package/dist/mcp/learning/types/index.d.ts +0 -138
  244. package/dist/mcp/learning/types/index.d.ts.map +0 -1
  245. package/dist/mcp/learning/types/index.js +0 -6
  246. package/dist/mcp/learning/types/index.js.map +0 -1
  247. package/dist/mcp/learning/types/index.mjs +0 -4
  248. package/dist/mcp-server.d.ts +0 -29
  249. package/dist/mcp-server.d.ts.map +0 -1
  250. package/dist/mcp-server.js +0 -862
  251. package/dist/mcp-server.js.map +0 -1
  252. package/dist/mcp-server.mjs +0 -857
  253. package/dist/plugins/base-plugin.d.ts +0 -114
  254. package/dist/plugins/base-plugin.d.ts.map +0 -1
  255. package/dist/plugins/base-plugin.js +0 -313
  256. package/dist/plugins/base-plugin.js.map +0 -1
  257. package/dist/plugins/base-plugin.mjs +0 -275
  258. package/dist/plugins/implementations/active-learning.d.ts +0 -135
  259. package/dist/plugins/implementations/active-learning.d.ts.map +0 -1
  260. package/dist/plugins/implementations/active-learning.js +0 -372
  261. package/dist/plugins/implementations/active-learning.js.map +0 -1
  262. package/dist/plugins/implementations/active-learning.mjs +0 -367
  263. package/dist/plugins/implementations/actor-critic.d.ts +0 -64
  264. package/dist/plugins/implementations/actor-critic.d.ts.map +0 -1
  265. package/dist/plugins/implementations/actor-critic.js +0 -363
  266. package/dist/plugins/implementations/actor-critic.js.map +0 -1
  267. package/dist/plugins/implementations/actor-critic.mjs +0 -358
  268. package/dist/plugins/implementations/adversarial-training.d.ts +0 -133
  269. package/dist/plugins/implementations/adversarial-training.d.ts.map +0 -1
  270. package/dist/plugins/implementations/adversarial-training.js +0 -409
  271. package/dist/plugins/implementations/adversarial-training.js.map +0 -1
  272. package/dist/plugins/implementations/adversarial-training.mjs +0 -404
  273. package/dist/plugins/implementations/curriculum-learning.d.ts +0 -132
  274. package/dist/plugins/implementations/curriculum-learning.d.ts.map +0 -1
  275. package/dist/plugins/implementations/curriculum-learning.js +0 -354
  276. package/dist/plugins/implementations/curriculum-learning.js.map +0 -1
  277. package/dist/plugins/implementations/curriculum-learning.mjs +0 -349
  278. package/dist/plugins/implementations/decision-transformer.d.ts +0 -77
  279. package/dist/plugins/implementations/decision-transformer.d.ts.map +0 -1
  280. package/dist/plugins/implementations/decision-transformer.js +0 -422
  281. package/dist/plugins/implementations/decision-transformer.js.map +0 -1
  282. package/dist/plugins/implementations/decision-transformer.mjs +0 -417
  283. package/dist/plugins/implementations/federated-learning.d.ts +0 -126
  284. package/dist/plugins/implementations/federated-learning.d.ts.map +0 -1
  285. package/dist/plugins/implementations/federated-learning.js +0 -436
  286. package/dist/plugins/implementations/federated-learning.js.map +0 -1
  287. package/dist/plugins/implementations/federated-learning.mjs +0 -431
  288. package/dist/plugins/implementations/index.d.ts +0 -30
  289. package/dist/plugins/implementations/index.d.ts.map +0 -1
  290. package/dist/plugins/implementations/index.js +0 -45
  291. package/dist/plugins/implementations/index.js.map +0 -1
  292. package/dist/plugins/implementations/index.mjs +0 -31
  293. package/dist/plugins/implementations/multi-task-learning.d.ts +0 -115
  294. package/dist/plugins/implementations/multi-task-learning.d.ts.map +0 -1
  295. package/dist/plugins/implementations/multi-task-learning.js +0 -369
  296. package/dist/plugins/implementations/multi-task-learning.js.map +0 -1
  297. package/dist/plugins/implementations/multi-task-learning.mjs +0 -364
  298. package/dist/plugins/implementations/neural-architecture-search.d.ts +0 -148
  299. package/dist/plugins/implementations/neural-architecture-search.d.ts.map +0 -1
  300. package/dist/plugins/implementations/neural-architecture-search.js +0 -379
  301. package/dist/plugins/implementations/neural-architecture-search.js.map +0 -1
  302. package/dist/plugins/implementations/neural-architecture-search.mjs +0 -374
  303. package/dist/plugins/implementations/q-learning.d.ts +0 -98
  304. package/dist/plugins/implementations/q-learning.d.ts.map +0 -1
  305. package/dist/plugins/implementations/q-learning.js +0 -435
  306. package/dist/plugins/implementations/q-learning.js.map +0 -1
  307. package/dist/plugins/implementations/q-learning.mjs +0 -430
  308. package/dist/plugins/implementations/sarsa.d.ts +0 -103
  309. package/dist/plugins/implementations/sarsa.d.ts.map +0 -1
  310. package/dist/plugins/implementations/sarsa.js +0 -347
  311. package/dist/plugins/implementations/sarsa.js.map +0 -1
  312. package/dist/plugins/implementations/sarsa.mjs +0 -342
  313. package/dist/plugins/index.d.ts +0 -107
  314. package/dist/plugins/index.d.ts.map +0 -1
  315. package/dist/plugins/index.js +0 -179
  316. package/dist/plugins/index.js.map +0 -1
  317. package/dist/plugins/index.mjs +0 -168
  318. package/dist/plugins/interface.d.ts +0 -439
  319. package/dist/plugins/interface.d.ts.map +0 -1
  320. package/dist/plugins/interface.js +0 -12
  321. package/dist/plugins/interface.js.map +0 -1
  322. package/dist/plugins/interface.mjs +0 -10
  323. package/dist/plugins/learning-plugin.interface.d.ts +0 -257
  324. package/dist/plugins/learning-plugin.interface.d.ts.map +0 -1
  325. package/dist/plugins/learning-plugin.interface.js +0 -7
  326. package/dist/plugins/learning-plugin.interface.js.map +0 -1
  327. package/dist/plugins/learning-plugin.interface.mjs +0 -5
  328. package/dist/plugins/plugin-exports.d.ts +0 -71
  329. package/dist/plugins/plugin-exports.d.ts.map +0 -1
  330. package/dist/plugins/plugin-exports.js +0 -78
  331. package/dist/plugins/plugin-exports.js.map +0 -1
  332. package/dist/plugins/plugin-exports.mjs +0 -69
  333. package/dist/plugins/registry.d.ts +0 -206
  334. package/dist/plugins/registry.d.ts.map +0 -1
  335. package/dist/plugins/registry.js +0 -365
  336. package/dist/plugins/registry.js.map +0 -1
  337. package/dist/plugins/registry.mjs +0 -356
  338. package/dist/plugins/validator.d.ts +0 -63
  339. package/dist/plugins/validator.d.ts.map +0 -1
  340. package/dist/plugins/validator.js +0 -464
  341. package/dist/plugins/validator.js.map +0 -1
  342. package/dist/plugins/validator.mjs +0 -458
  343. package/dist/presets.d.ts +0 -65
  344. package/dist/presets.d.ts.map +0 -1
  345. package/dist/presets.js +0 -145
  346. package/dist/presets.js.map +0 -1
  347. package/dist/presets.mjs +0 -140
  348. package/dist/quantization/binary-quantization.d.ts +0 -104
  349. package/dist/quantization/binary-quantization.d.ts.map +0 -1
  350. package/dist/quantization/binary-quantization.js +0 -246
  351. package/dist/quantization/binary-quantization.js.map +0 -1
  352. package/dist/quantization/binary-quantization.mjs +0 -240
  353. package/dist/quantization/optimized-pq.d.ts +0 -138
  354. package/dist/quantization/optimized-pq.d.ts.map +0 -1
  355. package/dist/quantization/optimized-pq.js +0 -320
  356. package/dist/quantization/optimized-pq.js.map +0 -1
  357. package/dist/quantization/optimized-pq.mjs +0 -313
  358. package/dist/quantization/product-quantization.d.ts +0 -109
  359. package/dist/quantization/product-quantization.d.ts.map +0 -1
  360. package/dist/quantization/product-quantization.js +0 -287
  361. package/dist/quantization/product-quantization.js.map +0 -1
  362. package/dist/quantization/product-quantization.mjs +0 -282
  363. package/dist/quantization/scalar-quantization.d.ts +0 -100
  364. package/dist/quantization/scalar-quantization.d.ts.map +0 -1
  365. package/dist/quantization/scalar-quantization.js +0 -324
  366. package/dist/quantization/scalar-quantization.js.map +0 -1
  367. package/dist/quantization/scalar-quantization.mjs +0 -319
  368. package/dist/query/index.d.ts +0 -6
  369. package/dist/query/index.d.ts.map +0 -1
  370. package/dist/query/index.js +0 -9
  371. package/dist/query/index.js.map +0 -1
  372. package/dist/query/index.mjs +0 -4
  373. package/dist/query/query-builder.d.ts +0 -323
  374. package/dist/query/query-builder.d.ts.map +0 -1
  375. package/dist/query/query-builder.js +0 -524
  376. package/dist/query/query-builder.js.map +0 -1
  377. package/dist/query/query-builder.mjs +0 -519
  378. package/dist/reasoning/context-synthesizer.d.ts +0 -57
  379. package/dist/reasoning/context-synthesizer.d.ts.map +0 -1
  380. package/dist/reasoning/context-synthesizer.js +0 -224
  381. package/dist/reasoning/context-synthesizer.js.map +0 -1
  382. package/dist/reasoning/context-synthesizer.mjs +0 -219
  383. package/dist/reasoning/experience-curator.d.ts +0 -66
  384. package/dist/reasoning/experience-curator.d.ts.map +0 -1
  385. package/dist/reasoning/experience-curator.js +0 -288
  386. package/dist/reasoning/experience-curator.js.map +0 -1
  387. package/dist/reasoning/experience-curator.mjs +0 -283
  388. package/dist/reasoning/memory-optimizer.d.ts +0 -69
  389. package/dist/reasoning/memory-optimizer.d.ts.map +0 -1
  390. package/dist/reasoning/memory-optimizer.js +0 -331
  391. package/dist/reasoning/memory-optimizer.js.map +0 -1
  392. package/dist/reasoning/memory-optimizer.mjs +0 -326
  393. package/dist/reasoning/pattern-matcher.d.ts +0 -59
  394. package/dist/reasoning/pattern-matcher.d.ts.map +0 -1
  395. package/dist/reasoning/pattern-matcher.js +0 -229
  396. package/dist/reasoning/pattern-matcher.js.map +0 -1
  397. package/dist/reasoning/pattern-matcher.mjs +0 -224
  398. package/dist/reasoningbank/adapter/agentdb-adapter.d.ts +0 -118
  399. package/dist/reasoningbank/adapter/agentdb-adapter.d.ts.map +0 -1
  400. package/dist/reasoningbank/adapter/agentdb-adapter.js +0 -477
  401. package/dist/reasoningbank/adapter/agentdb-adapter.js.map +0 -1
  402. package/dist/reasoningbank/adapter/types.d.ts +0 -113
  403. package/dist/reasoningbank/adapter/types.d.ts.map +0 -1
  404. package/dist/reasoningbank/adapter/types.js +0 -9
  405. package/dist/reasoningbank/adapter/types.js.map +0 -1
  406. package/dist/reasoningbank/cli/commands.d.ts +0 -16
  407. package/dist/reasoningbank/cli/commands.d.ts.map +0 -1
  408. package/dist/reasoningbank/cli/commands.js +0 -272
  409. package/dist/reasoningbank/cli/commands.js.map +0 -1
  410. package/dist/reasoningbank/mcp/agentdb-tools.d.ts +0 -319
  411. package/dist/reasoningbank/mcp/agentdb-tools.d.ts.map +0 -1
  412. package/dist/reasoningbank/mcp/agentdb-tools.js +0 -301
  413. package/dist/reasoningbank/mcp/agentdb-tools.js.map +0 -1
  414. package/dist/reasoningbank/migration/migrate.d.ts +0 -25
  415. package/dist/reasoningbank/migration/migrate.d.ts.map +0 -1
  416. package/dist/reasoningbank/migration/migrate.js +0 -178
  417. package/dist/reasoningbank/migration/migrate.js.map +0 -1
  418. package/dist/reasoningbank/reasoning/context-synthesizer.d.ts +0 -37
  419. package/dist/reasoningbank/reasoning/context-synthesizer.d.ts.map +0 -1
  420. package/dist/reasoningbank/reasoning/context-synthesizer.js +0 -114
  421. package/dist/reasoningbank/reasoning/context-synthesizer.js.map +0 -1
  422. package/dist/reasoningbank/reasoning/experience-curator.d.ts +0 -39
  423. package/dist/reasoningbank/reasoning/experience-curator.d.ts.map +0 -1
  424. package/dist/reasoningbank/reasoning/experience-curator.js +0 -98
  425. package/dist/reasoningbank/reasoning/experience-curator.js.map +0 -1
  426. package/dist/reasoningbank/reasoning/memory-optimizer.d.ts +0 -44
  427. package/dist/reasoningbank/reasoning/memory-optimizer.d.ts.map +0 -1
  428. package/dist/reasoningbank/reasoning/memory-optimizer.js +0 -184
  429. package/dist/reasoningbank/reasoning/memory-optimizer.js.map +0 -1
  430. package/dist/reasoningbank/reasoning/pattern-matcher.d.ts +0 -40
  431. package/dist/reasoningbank/reasoning/pattern-matcher.d.ts.map +0 -1
  432. package/dist/reasoningbank/reasoning/pattern-matcher.js +0 -87
  433. package/dist/reasoningbank/reasoning/pattern-matcher.js.map +0 -1
  434. package/dist/reasoningbank/sync/quic-sync.d.ts +0 -77
  435. package/dist/reasoningbank/sync/quic-sync.d.ts.map +0 -1
  436. package/dist/reasoningbank/sync/quic-sync.js +0 -165
  437. package/dist/reasoningbank/sync/quic-sync.js.map +0 -1
  438. package/dist/sync/conflict.d.ts +0 -78
  439. package/dist/sync/conflict.d.ts.map +0 -1
  440. package/dist/sync/conflict.js +0 -202
  441. package/dist/sync/conflict.js.map +0 -1
  442. package/dist/sync/conflict.mjs +0 -196
  443. package/dist/sync/coordinator.d.ts +0 -111
  444. package/dist/sync/coordinator.d.ts.map +0 -1
  445. package/dist/sync/coordinator.js +0 -256
  446. package/dist/sync/coordinator.js.map +0 -1
  447. package/dist/sync/coordinator.mjs +0 -250
  448. package/dist/sync/delta.d.ts +0 -81
  449. package/dist/sync/delta.d.ts.map +0 -1
  450. package/dist/sync/delta.js +0 -245
  451. package/dist/sync/delta.js.map +0 -1
  452. package/dist/sync/delta.mjs +0 -238
  453. package/dist/sync/index.d.ts +0 -11
  454. package/dist/sync/index.d.ts.map +0 -1
  455. package/dist/sync/index.js +0 -22
  456. package/dist/sync/index.js.map +0 -1
  457. package/dist/sync/index.mjs +0 -9
  458. package/dist/sync/quic-sync.d.ts +0 -81
  459. package/dist/sync/quic-sync.d.ts.map +0 -1
  460. package/dist/sync/quic-sync.js +0 -329
  461. package/dist/sync/quic-sync.js.map +0 -1
  462. package/dist/sync/quic-sync.mjs +0 -323
  463. package/dist/sync/types.d.ts +0 -168
  464. package/dist/sync/types.d.ts.map +0 -1
  465. package/dist/sync/types.js +0 -8
  466. package/dist/sync/types.js.map +0 -1
  467. package/dist/sync/types.mjs +0 -6
  468. package/dist/types/index.d.ts +0 -117
  469. package/dist/types/index.d.ts.map +0 -1
  470. package/dist/types/index.js +0 -6
  471. package/dist/types/index.js.map +0 -1
  472. package/dist/types/index.mjs +0 -4
  473. package/dist/wasm/sql-wasm-debug.js +0 -6989
  474. package/dist/wasm/sql-wasm-debug.wasm +0 -0
  475. package/dist/wasm/sql-wasm.js +0 -188
  476. package/dist/wasm/sql-wasm.wasm +0 -0
  477. package/dist/wasm-loader.d.ts +0 -32
  478. package/dist/wasm-loader.d.ts.map +0 -1
  479. package/dist/wasm-loader.js +0 -78
  480. package/dist/wasm-loader.js.map +0 -1
  481. package/dist/wasm-loader.mjs +0 -67
  482. package/examples/adaptive-learning.ts +0 -284
  483. package/examples/browser/README.md +0 -732
  484. package/examples/browser/adaptive-recommendations/index.html +0 -427
  485. package/examples/browser/collaborative-filtering/index.html +0 -310
  486. package/examples/browser/continual-learning/index.html +0 -736
  487. package/examples/browser/experience-replay/index.html +0 -616
  488. package/examples/browser/index.html +0 -369
  489. package/examples/browser/meta-learning/index.html +0 -789
  490. package/examples/browser/neuro-symbolic/index.html +0 -692
  491. package/examples/browser/pattern-learning/index.html +0 -620
  492. package/examples/browser/quantum-inspired/index.html +0 -728
  493. package/examples/browser/rag/index.html +0 -624
  494. package/examples/browser/swarm-intelligence/index.html +0 -811
  495. package/examples/browser-basic.html +0 -170
  496. package/examples/browser-wasm-real.html +0 -231
  497. package/examples/hnsw-example.ts +0 -148
  498. package/examples/mcp-learning-example.ts +0 -220
  499. package/examples/node-basic.js +0 -70
  500. package/examples/quic-sync-example.ts +0 -310
  501. package/examples/quick-start.js +0 -68
  502. package/examples/test-v1.0.7-cdn.html +0 -190
  503. package/examples/wasm-example.ts +0 -222
@@ -0,0 +1,664 @@
1
+ /**
2
+ * Comprehensive AgentDB Benchmark Suite
3
+ *
4
+ * Tests all 5 SOTA memory patterns with production workloads:
5
+ * 1. Reflexion episodic replay
6
+ * 2. Skill library operations
7
+ * 3. Mixed memory (facts + notes)
8
+ * 4. Event consolidation
9
+ * 5. Graph-aware recall
10
+ *
11
+ * Metrics tracked:
12
+ * - Latency (p50, p95, p99)
13
+ * - Throughput (ops/sec)
14
+ * - Memory usage (RSS, heap)
15
+ * - Hit rates and accuracy
16
+ * - Concurrency performance
17
+ */
18
+ import Database from 'better-sqlite3';
19
+ import { ReflexionMemory } from '../controllers/ReflexionMemory';
20
+ import { SkillLibrary } from '../controllers/SkillLibrary';
21
+ import { EmbeddingService } from '../controllers/EmbeddingService';
22
+ import * as fs from 'fs';
23
+ import * as path from 'path';
24
+ export class ComprehensiveBenchmark {
25
+ db;
26
+ reflexion;
27
+ skills;
28
+ embedder;
29
+ results = [];
30
+ constructor(dbPath = ':memory:') {
31
+ this.db = new Database(dbPath);
32
+ // Configure for performance
33
+ this.db.pragma('journal_mode = WAL');
34
+ this.db.pragma('synchronous = NORMAL');
35
+ this.db.pragma('cache_size = -64000'); // 64MB cache
36
+ this.db.pragma('temp_store = MEMORY');
37
+ this.db.pragma('mmap_size = 268435456'); // 256MB mmap
38
+ this.embedder = new EmbeddingService({
39
+ model: 'all-MiniLM-L6-v2',
40
+ dimension: 384,
41
+ provider: 'transformers'
42
+ });
43
+ this.reflexion = new ReflexionMemory(this.db, this.embedder);
44
+ this.skills = new SkillLibrary(this.db, this.embedder);
45
+ }
46
+ async initialize() {
47
+ console.log('šŸ”§ Initializing AgentDB Benchmark Suite...\n');
48
+ // Load schema
49
+ const schemaPath = path.join(__dirname, '../schemas/schema.sql');
50
+ const schema = fs.readFileSync(schemaPath, 'utf-8');
51
+ this.db.exec(schema);
52
+ // Initialize embedder
53
+ await this.embedder.initialize();
54
+ console.log('āœ… Initialization complete\n');
55
+ }
56
+ /**
57
+ * Run all benchmarks
58
+ */
59
+ async runAll() {
60
+ console.log('╔════════════════════════════════════════════════════════════════╗');
61
+ console.log('ā•‘ AgentDB Comprehensive Benchmark Suite ā•‘');
62
+ console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•\n');
63
+ // Core performance tests
64
+ await this.benchmarkEpisodeInsertion();
65
+ await this.benchmarkEpisodeRetrieval();
66
+ await this.benchmarkSkillConsolidation();
67
+ await this.benchmarkConcurrentWrites();
68
+ await this.benchmarkConcurrentReads();
69
+ await this.benchmarkMixedWorkload();
70
+ // Scalability tests
71
+ await this.benchmarkLargeDataset();
72
+ await this.benchmarkMemoryPressure();
73
+ // Production scenarios
74
+ await this.benchmarkRealtimeAgent();
75
+ await this.benchmarkBatchProcessing();
76
+ this.printSummary();
77
+ this.generateReport();
78
+ return this.results;
79
+ }
80
+ /**
81
+ * Benchmark 1: Episode Insertion Performance
82
+ */
83
+ async benchmarkEpisodeInsertion() {
84
+ console.log('\nšŸ“Š Benchmark 1: Episode Insertion Performance');
85
+ console.log('━'.repeat(70));
86
+ console.log('Testing: Bulk episode storage with embeddings\n');
87
+ const count = 10000;
88
+ const latencies = [];
89
+ const memStart = process.memoryUsage();
90
+ console.log(`Inserting ${count} episodes...`);
91
+ const startTime = Date.now();
92
+ for (let i = 0; i < count; i++) {
93
+ const episodeStart = Date.now();
94
+ await this.reflexion.storeEpisode({
95
+ sessionId: `session-${Math.floor(i / 100)}`,
96
+ task: `task_${i % 50}`,
97
+ input: `Input data for episode ${i}`,
98
+ output: `Generated output ${i}`,
99
+ critique: this.generateCritique(i),
100
+ reward: Math.random(),
101
+ success: Math.random() > 0.3,
102
+ latencyMs: Math.floor(Math.random() * 500),
103
+ tokensUsed: Math.floor(Math.random() * 1000)
104
+ });
105
+ latencies.push(Date.now() - episodeStart);
106
+ if ((i + 1) % 2500 === 0) {
107
+ const progress = ((i + 1) / count * 100).toFixed(1);
108
+ const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
109
+ console.log(` ${progress}% complete (${elapsed}s)`);
110
+ }
111
+ }
112
+ const duration = Date.now() - startTime;
113
+ const memEnd = process.memoryUsage();
114
+ this.recordMetrics('Episode Insertion', {
115
+ duration,
116
+ operations: count,
117
+ latencies,
118
+ memStart,
119
+ memEnd,
120
+ passed: duration < 60000 // Should complete in < 60s
121
+ });
122
+ }
123
+ /**
124
+ * Benchmark 2: Episode Retrieval Performance
125
+ */
126
+ async benchmarkEpisodeRetrieval() {
127
+ console.log('\nšŸ“Š Benchmark 2: Episode Retrieval Performance');
128
+ console.log('━'.repeat(70));
129
+ console.log('Testing: Semantic search with k-NN over episodes\n');
130
+ const queries = 1000;
131
+ const latencies = [];
132
+ const memStart = process.memoryUsage();
133
+ console.log(`Running ${queries} retrieval queries...`);
134
+ const startTime = Date.now();
135
+ for (let i = 0; i < queries; i++) {
136
+ const queryStart = Date.now();
137
+ await this.reflexion.retrieveRelevant({
138
+ task: `task_${Math.floor(Math.random() * 50)}`,
139
+ k: 5,
140
+ timeWindowDays: 7
141
+ });
142
+ latencies.push(Date.now() - queryStart);
143
+ if ((i + 1) % 250 === 0) {
144
+ const progress = ((i + 1) / queries * 100).toFixed(1);
145
+ console.log(` ${progress}% complete`);
146
+ }
147
+ }
148
+ const duration = Date.now() - startTime;
149
+ const memEnd = process.memoryUsage();
150
+ this.recordMetrics('Episode Retrieval', {
151
+ duration,
152
+ operations: queries,
153
+ latencies,
154
+ memStart,
155
+ memEnd,
156
+ passed: this.calculateP95(latencies) <= 50 // p95 ≤ 50ms
157
+ });
158
+ }
159
+ /**
160
+ * Benchmark 3: Skill Consolidation
161
+ */
162
+ async benchmarkSkillConsolidation() {
163
+ console.log('\nšŸ“Š Benchmark 3: Skill Consolidation');
164
+ console.log('━'.repeat(70));
165
+ console.log('Testing: Episode → Skill transformation\n');
166
+ const memStart = process.memoryUsage();
167
+ const startTime = Date.now();
168
+ console.log('Running consolidation job...');
169
+ const created = this.skills.consolidateEpisodesIntoSkills({
170
+ minAttempts: 3,
171
+ minReward: 0.5,
172
+ timeWindowDays: 30
173
+ });
174
+ const duration = Date.now() - startTime;
175
+ const memEnd = process.memoryUsage();
176
+ console.log(`āœ“ Created ${created} skills in ${duration}ms`);
177
+ this.recordMetrics('Skill Consolidation', {
178
+ duration,
179
+ operations: created,
180
+ latencies: [duration],
181
+ memStart,
182
+ memEnd,
183
+ passed: duration < 5000 && created > 0 // < 5s, creates skills
184
+ });
185
+ }
186
+ /**
187
+ * Benchmark 4: Concurrent Writes
188
+ */
189
+ async benchmarkConcurrentWrites() {
190
+ console.log('\nšŸ“Š Benchmark 4: Concurrent Write Performance');
191
+ console.log('━'.repeat(70));
192
+ console.log('Testing: Multiple agents writing simultaneously\n');
193
+ const writers = 10;
194
+ const writesPerWriter = 100;
195
+ const allLatencies = [];
196
+ const memStart = process.memoryUsage();
197
+ console.log(`Running ${writers} concurrent writers...`);
198
+ const startTime = Date.now();
199
+ const writerPromises = Array.from({ length: writers }, async (_, writerIdx) => {
200
+ const latencies = [];
201
+ for (let i = 0; i < writesPerWriter; i++) {
202
+ const writeStart = Date.now();
203
+ await this.reflexion.storeEpisode({
204
+ sessionId: `concurrent-session-${writerIdx}`,
205
+ task: `concurrent_task_${i}`,
206
+ input: `Writer ${writerIdx} input ${i}`,
207
+ output: `Writer ${writerIdx} output ${i}`,
208
+ critique: 'Concurrent write test',
209
+ reward: Math.random(),
210
+ success: true
211
+ });
212
+ latencies.push(Date.now() - writeStart);
213
+ }
214
+ return latencies;
215
+ });
216
+ const results = await Promise.all(writerPromises);
217
+ results.forEach(latencies => allLatencies.push(...latencies));
218
+ const duration = Date.now() - startTime;
219
+ const memEnd = process.memoryUsage();
220
+ this.recordMetrics('Concurrent Writes', {
221
+ duration,
222
+ operations: writers * writesPerWriter,
223
+ latencies: allLatencies,
224
+ memStart,
225
+ memEnd,
226
+ passed: this.calculateP95(allLatencies) <= 100 // p95 ≤ 100ms under concurrency
227
+ });
228
+ }
229
+ /**
230
+ * Benchmark 5: Concurrent Reads
231
+ */
232
+ async benchmarkConcurrentReads() {
233
+ console.log('\nšŸ“Š Benchmark 5: Concurrent Read Performance');
234
+ console.log('━'.repeat(70));
235
+ console.log('Testing: Multiple agents reading simultaneously\n');
236
+ const readers = 20;
237
+ const readsPerReader = 50;
238
+ const allLatencies = [];
239
+ const memStart = process.memoryUsage();
240
+ console.log(`Running ${readers} concurrent readers...`);
241
+ const startTime = Date.now();
242
+ const readerPromises = Array.from({ length: readers }, async () => {
243
+ const latencies = [];
244
+ for (let i = 0; i < readsPerReader; i++) {
245
+ const readStart = Date.now();
246
+ await this.reflexion.retrieveRelevant({
247
+ task: `task_${Math.floor(Math.random() * 50)}`,
248
+ k: 5
249
+ });
250
+ latencies.push(Date.now() - readStart);
251
+ }
252
+ return latencies;
253
+ });
254
+ const results = await Promise.all(readerPromises);
255
+ results.forEach(latencies => allLatencies.push(...latencies));
256
+ const duration = Date.now() - startTime;
257
+ const memEnd = process.memoryUsage();
258
+ this.recordMetrics('Concurrent Reads', {
259
+ duration,
260
+ operations: readers * readsPerReader,
261
+ latencies: allLatencies,
262
+ memStart,
263
+ memEnd,
264
+ passed: this.calculateP95(allLatencies) <= 75 // p95 ≤ 75ms
265
+ });
266
+ }
267
+ /**
268
+ * Benchmark 6: Mixed Workload (Read + Write)
269
+ */
270
+ async benchmarkMixedWorkload() {
271
+ console.log('\nšŸ“Š Benchmark 6: Mixed Workload Performance');
272
+ console.log('━'.repeat(70));
273
+ console.log('Testing: Simultaneous reads and writes\n');
274
+ const workers = 10;
275
+ const opsPerWorker = 100;
276
+ const allLatencies = [];
277
+ const memStart = process.memoryUsage();
278
+ console.log(`Running ${workers} workers with mixed operations...`);
279
+ const startTime = Date.now();
280
+ const workerPromises = Array.from({ length: workers }, async (_, idx) => {
281
+ const latencies = [];
282
+ for (let i = 0; i < opsPerWorker; i++) {
283
+ const opStart = Date.now();
284
+ // Alternate between reads and writes
285
+ if (i % 2 === 0) {
286
+ await this.reflexion.storeEpisode({
287
+ sessionId: `mixed-${idx}`,
288
+ task: `mixed_task_${i}`,
289
+ input: 'input',
290
+ output: 'output',
291
+ critique: 'critique',
292
+ reward: Math.random(),
293
+ success: true
294
+ });
295
+ }
296
+ else {
297
+ await this.reflexion.retrieveRelevant({
298
+ task: `mixed_task_${Math.floor(Math.random() * 50)}`,
299
+ k: 3
300
+ });
301
+ }
302
+ latencies.push(Date.now() - opStart);
303
+ }
304
+ return latencies;
305
+ });
306
+ const results = await Promise.all(workerPromises);
307
+ results.forEach(latencies => allLatencies.push(...latencies));
308
+ const duration = Date.now() - startTime;
309
+ const memEnd = process.memoryUsage();
310
+ this.recordMetrics('Mixed Workload', {
311
+ duration,
312
+ operations: workers * opsPerWorker,
313
+ latencies: allLatencies,
314
+ memStart,
315
+ memEnd,
316
+ passed: this.calculateP95(allLatencies) <= 80 // p95 ≤ 80ms
317
+ });
318
+ }
319
+ /**
320
+ * Benchmark 7: Large Dataset Performance
321
+ */
322
+ async benchmarkLargeDataset() {
323
+ console.log('\nšŸ“Š Benchmark 7: Large Dataset Scalability');
324
+ console.log('━'.repeat(70));
325
+ console.log('Testing: Performance at 50k+ memories\n');
326
+ const targetSize = 50000;
327
+ const currentSize = this.db.prepare('SELECT COUNT(*) as count FROM episodes').get();
328
+ const needed = Math.max(0, targetSize - currentSize.count);
329
+ if (needed > 0) {
330
+ console.log(`Adding ${needed} episodes to reach ${targetSize} target...`);
331
+ const batchSize = 1000;
332
+ const batches = Math.ceil(needed / batchSize);
333
+ for (let batch = 0; batch < batches; batch++) {
334
+ const transaction = this.db.transaction((episodes) => {
335
+ const stmt = this.db.prepare(`
336
+ INSERT INTO episodes (session_id, task, input, output, reward, success)
337
+ VALUES (?, ?, ?, ?, ?, ?)
338
+ `);
339
+ for (const ep of episodes) {
340
+ stmt.run(ep.session_id, ep.task, ep.input, ep.output, ep.reward, ep.success);
341
+ }
342
+ });
343
+ const episodes = Array.from({ length: Math.min(batchSize, needed - batch * batchSize) }, (_, i) => ({
344
+ session_id: `batch-${batch}`,
345
+ task: `task_${i % 100}`,
346
+ input: `input ${i}`,
347
+ output: `output ${i}`,
348
+ reward: Math.random(),
349
+ success: Math.random() > 0.5 ? 1 : 0
350
+ }));
351
+ transaction(episodes);
352
+ if ((batch + 1) % 10 === 0) {
353
+ console.log(` Progress: ${((batch + 1) / batches * 100).toFixed(1)}%`);
354
+ }
355
+ }
356
+ }
357
+ // Now test retrieval at scale
358
+ const queries = 100;
359
+ const latencies = [];
360
+ const memStart = process.memoryUsage();
361
+ console.log(`\nTesting retrieval over ${targetSize} memories...`);
362
+ const startTime = Date.now();
363
+ for (let i = 0; i < queries; i++) {
364
+ const queryStart = Date.now();
365
+ await this.reflexion.retrieveRelevant({
366
+ task: `task_${Math.floor(Math.random() * 100)}`,
367
+ k: 5
368
+ });
369
+ latencies.push(Date.now() - queryStart);
370
+ }
371
+ const duration = Date.now() - startTime;
372
+ const memEnd = process.memoryUsage();
373
+ this.recordMetrics('Large Dataset (50k+)', {
374
+ duration,
375
+ operations: queries,
376
+ latencies,
377
+ memStart,
378
+ memEnd,
379
+ passed: this.calculateP95(latencies) <= 100 // p95 ≤ 100ms at scale
380
+ });
381
+ }
382
+ /**
383
+ * Benchmark 8: Memory Pressure
384
+ */
385
+ async benchmarkMemoryPressure() {
386
+ console.log('\nšŸ“Š Benchmark 8: Memory Pressure Test');
387
+ console.log('━'.repeat(70));
388
+ console.log('Testing: System stability under memory constraints\n');
389
+ const operations = 1000;
390
+ const latencies = [];
391
+ const memStart = process.memoryUsage();
392
+ console.log(`Running ${operations} operations with cache pressure...`);
393
+ // Force garbage collection if available
394
+ if (global.gc) {
395
+ global.gc();
396
+ }
397
+ const startTime = Date.now();
398
+ for (let i = 0; i < operations; i++) {
399
+ const opStart = Date.now();
400
+ // Mix of memory-intensive operations
401
+ if (i % 3 === 0) {
402
+ await this.reflexion.storeEpisode({
403
+ sessionId: `mem-pressure-${i}`,
404
+ task: `task_${i}`,
405
+ input: 'A'.repeat(1000), // Large input
406
+ output: 'B'.repeat(1000), // Large output
407
+ critique: 'C'.repeat(500),
408
+ reward: Math.random(),
409
+ success: true
410
+ });
411
+ }
412
+ else {
413
+ await this.reflexion.retrieveRelevant({
414
+ task: `task_${Math.floor(Math.random() * 100)}`,
415
+ k: 10 // Higher k for more memory use
416
+ });
417
+ }
418
+ latencies.push(Date.now() - opStart);
419
+ if ((i + 1) % 250 === 0) {
420
+ console.log(` ${((i + 1) / operations * 100).toFixed(1)}% complete`);
421
+ }
422
+ }
423
+ const duration = Date.now() - startTime;
424
+ const memEnd = process.memoryUsage();
425
+ const memoryGrowth = (memEnd.heapUsed - memStart.heapUsed) / 1024 / 1024;
426
+ this.recordMetrics('Memory Pressure', {
427
+ duration,
428
+ operations,
429
+ latencies,
430
+ memStart,
431
+ memEnd,
432
+ passed: memoryGrowth < 200 && this.calculateP95(latencies) <= 150, // < 200MB growth
433
+ details: `Memory growth: ${memoryGrowth.toFixed(2)}MB`
434
+ });
435
+ }
436
+ /**
437
+ * Benchmark 9: Realtime Agent Simulation
438
+ */
439
+ async benchmarkRealtimeAgent() {
440
+ console.log('\nšŸ“Š Benchmark 9: Realtime Agent Simulation');
441
+ console.log('━'.repeat(70));
442
+ console.log('Testing: Agent making real-time decisions with memory\n');
443
+ const tasks = 50;
444
+ const attemptsPerTask = 5;
445
+ const allLatencies = [];
446
+ const memStart = process.memoryUsage();
447
+ console.log(`Simulating ${tasks} tasks with ${attemptsPerTask} attempts each...`);
448
+ const startTime = Date.now();
449
+ for (let taskIdx = 0; taskIdx < tasks; taskIdx++) {
450
+ const task = `realtime_task_${taskIdx}`;
451
+ for (let attempt = 0; attempt < attemptsPerTask; attempt++) {
452
+ const cycleStart = Date.now();
453
+ // 1. Retrieve relevant memories
454
+ const memories = await this.reflexion.retrieveRelevant({
455
+ task,
456
+ k: 3,
457
+ onlyFailures: attempt > 0
458
+ });
459
+ // 2. Simulate task execution
460
+ const executionTime = Math.random() * 100;
461
+ await new Promise(resolve => setTimeout(resolve, executionTime));
462
+ // 3. Store result
463
+ const reward = Math.min(0.3 + attempt * 0.15, 1.0); // Improvement over attempts
464
+ await this.reflexion.storeEpisode({
465
+ sessionId: `realtime-${taskIdx}`,
466
+ task,
467
+ input: `Attempt ${attempt}`,
468
+ output: `Result ${attempt}`,
469
+ critique: attempt < 3 ? 'Needs improvement' : 'Good progress',
470
+ reward,
471
+ success: reward > 0.7
472
+ });
473
+ allLatencies.push(Date.now() - cycleStart);
474
+ }
475
+ if ((taskIdx + 1) % 10 === 0) {
476
+ console.log(` Task ${taskIdx + 1}/${tasks} complete`);
477
+ }
478
+ }
479
+ const duration = Date.now() - startTime;
480
+ const memEnd = process.memoryUsage();
481
+ this.recordMetrics('Realtime Agent', {
482
+ duration,
483
+ operations: tasks * attemptsPerTask,
484
+ latencies: allLatencies,
485
+ memStart,
486
+ memEnd,
487
+ passed: this.calculateP95(allLatencies) <= 200 // p95 ≤ 200ms for full cycle
488
+ });
489
+ }
490
+ /**
491
+ * Benchmark 10: Batch Processing
492
+ */
493
+ async benchmarkBatchProcessing() {
494
+ console.log('\nšŸ“Š Benchmark 10: Batch Processing Performance');
495
+ console.log('━'.repeat(70));
496
+ console.log('Testing: High-throughput batch operations\n');
497
+ const batchSize = 100;
498
+ const batches = 50;
499
+ const allLatencies = [];
500
+ const memStart = process.memoryUsage();
501
+ console.log(`Processing ${batches} batches of ${batchSize} episodes...`);
502
+ const startTime = Date.now();
503
+ for (let batchIdx = 0; batchIdx < batches; batchIdx++) {
504
+ const batchStart = Date.now();
505
+ // Use transaction for batch
506
+ const transaction = this.db.transaction((episodes) => {
507
+ for (const ep of episodes) {
508
+ this.reflexion.storeEpisode(ep);
509
+ }
510
+ });
511
+ const episodes = Array.from({ length: batchSize }, (_, i) => ({
512
+ sessionId: `batch-${batchIdx}`,
513
+ task: `batch_task_${i}`,
514
+ input: `batch input ${i}`,
515
+ output: `batch output ${i}`,
516
+ critique: 'Batch processed',
517
+ reward: Math.random(),
518
+ success: Math.random() > 0.5
519
+ }));
520
+ await Promise.all(episodes.map(ep => this.reflexion.storeEpisode(ep)));
521
+ allLatencies.push(Date.now() - batchStart);
522
+ if ((batchIdx + 1) % 10 === 0) {
523
+ console.log(` ${((batchIdx + 1) / batches * 100).toFixed(1)}% complete`);
524
+ }
525
+ }
526
+ const duration = Date.now() - startTime;
527
+ const memEnd = process.memoryUsage();
528
+ const throughput = (batches * batchSize) / (duration / 1000);
529
+ this.recordMetrics('Batch Processing', {
530
+ duration,
531
+ operations: batches * batchSize,
532
+ latencies: allLatencies,
533
+ memStart,
534
+ memEnd,
535
+ passed: throughput >= 100, // ≄ 100 episodes/sec
536
+ details: `Throughput: ${throughput.toFixed(0)} eps/sec`
537
+ });
538
+ }
539
+ // ========================================================================
540
+ // Helper Methods
541
+ // ========================================================================
542
+ recordMetrics(testName, data) {
543
+ const { duration, operations, latencies, memStart, memEnd, passed, details } = data;
544
+ latencies.sort((a, b) => a - b);
545
+ const metrics = {
546
+ testName,
547
+ duration,
548
+ operations,
549
+ opsPerSecond: (operations / duration) * 1000,
550
+ latency: {
551
+ min: latencies[0] || 0,
552
+ max: latencies[latencies.length - 1] || 0,
553
+ avg: latencies.reduce((a, b) => a + b, 0) / latencies.length || 0,
554
+ p50: latencies[Math.floor(latencies.length * 0.50)] || 0,
555
+ p95: latencies[Math.floor(latencies.length * 0.95)] || 0,
556
+ p99: latencies[Math.floor(latencies.length * 0.99)] || 0
557
+ },
558
+ memory: {
559
+ heapUsed: memEnd.heapUsed - memStart.heapUsed,
560
+ heapTotal: memEnd.heapTotal - memStart.heapTotal,
561
+ rss: memEnd.rss - memStart.rss
562
+ },
563
+ passed,
564
+ details
565
+ };
566
+ this.results.push(metrics);
567
+ console.log(`\nšŸ“ˆ Results:`);
568
+ console.log(` Duration: ${duration.toFixed(0)}ms`);
569
+ console.log(` Operations: ${operations}`);
570
+ console.log(` Throughput: ${metrics.opsPerSecond.toFixed(1)} ops/sec`);
571
+ console.log(` Latency p50: ${metrics.latency.p50.toFixed(1)}ms`);
572
+ console.log(` Latency p95: ${metrics.latency.p95.toFixed(1)}ms`);
573
+ console.log(` Latency p99: ${metrics.latency.p99.toFixed(1)}ms`);
574
+ console.log(` Memory Ī”: ${(metrics.memory.heapUsed / 1024 / 1024).toFixed(2)}MB`);
575
+ if (details)
576
+ console.log(` ${details}`);
577
+ console.log(`\n${passed ? 'āœ… PASSED' : 'āŒ FAILED'}`);
578
+ }
579
+ calculateP95(latencies) {
580
+ const sorted = [...latencies].sort((a, b) => a - b);
581
+ return sorted[Math.floor(sorted.length * 0.95)] || 0;
582
+ }
583
+ generateCritique(index) {
584
+ const critiques = [
585
+ 'Edge case: empty input not handled',
586
+ 'Performance: could optimize query',
587
+ 'Bug: off-by-one error in loop',
588
+ 'Missing: input validation needed',
589
+ 'Improvement: add error handling',
590
+ 'Success: all edge cases covered',
591
+ 'Optimization: reduced time complexity',
592
+ 'Enhancement: added comprehensive tests'
593
+ ];
594
+ return critiques[index % critiques.length];
595
+ }
596
+ printSummary() {
597
+ console.log('\n' + '═'.repeat(70));
598
+ console.log('\nšŸ“Š BENCHMARK SUMMARY\n');
599
+ console.log('═'.repeat(70));
600
+ const passed = this.results.filter(r => r.passed).length;
601
+ const total = this.results.length;
602
+ console.log('\n╔════════════════════════════════════════════════════════════════╗');
603
+ console.log('ā•‘ Test Name │ Result │ p95 Latency ā•‘');
604
+ console.log('╠════════════════════════════════════════════════════════════════╣');
605
+ this.results.forEach(result => {
606
+ const status = result.passed ? 'āœ… PASS' : 'āŒ FAIL';
607
+ const name = result.testName.padEnd(33);
608
+ const latency = `${result.latency.p95.toFixed(1)}ms`.padStart(12);
609
+ console.log(`ā•‘ ${name}│ ${status} │ ${latency} ā•‘`);
610
+ });
611
+ console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
612
+ console.log(`\nšŸŽÆ Overall: ${passed}/${total} tests passed (${((passed / total) * 100).toFixed(1)}%)`);
613
+ // Calculate aggregate metrics
614
+ const totalOps = this.results.reduce((sum, r) => sum + r.operations, 0);
615
+ const totalDuration = this.results.reduce((sum, r) => sum + r.duration, 0);
616
+ const avgThroughput = (totalOps / totalDuration) * 1000;
617
+ console.log(`\nšŸ“Š Aggregate Metrics:`);
618
+ console.log(` Total Operations: ${totalOps.toLocaleString()}`);
619
+ console.log(` Total Duration: ${(totalDuration / 1000).toFixed(1)}s`);
620
+ console.log(` Avg Throughput: ${avgThroughput.toFixed(1)} ops/sec`);
621
+ if (passed === total) {
622
+ console.log('\n✨ All benchmarks passed! AgentDB is production-ready.\n');
623
+ }
624
+ else {
625
+ console.log('\nāš ļø Some benchmarks failed. Review optimizations needed.\n');
626
+ }
627
+ }
628
+ generateReport() {
629
+ const report = {
630
+ timestamp: new Date().toISOString(),
631
+ summary: {
632
+ totalTests: this.results.length,
633
+ passed: this.results.filter(r => r.passed).length,
634
+ failed: this.results.filter(r => !r.passed).length
635
+ },
636
+ results: this.results,
637
+ environment: {
638
+ nodeVersion: process.version,
639
+ platform: process.platform,
640
+ arch: process.arch,
641
+ memory: process.memoryUsage()
642
+ }
643
+ };
644
+ const reportPath = path.join(__dirname, 'benchmark-results.json');
645
+ fs.writeFileSync(reportPath, JSON.stringify(report, null, 2));
646
+ console.log(`šŸ“„ Detailed report saved to: ${reportPath}`);
647
+ }
648
+ close() {
649
+ this.db.close();
650
+ }
651
+ }
652
+ // Run if called directly
653
+ if (require.main === module) {
654
+ (async () => {
655
+ const benchmark = new ComprehensiveBenchmark();
656
+ await benchmark.initialize();
657
+ await benchmark.runAll();
658
+ benchmark.close();
659
+ process.exit(0);
660
+ })().catch(err => {
661
+ console.error('Benchmark failed:', err);
662
+ process.exit(1);
663
+ });
664
+ }