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
package/dist/cli/help.js DELETED
@@ -1,676 +0,0 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
- /**
4
- * Comprehensive Help System for SQLite Vector CLI
5
- * Organized with subsections for easy navigation
6
- */
7
- var __importDefault = (this && this.__importDefault) || function (mod) {
8
- return (mod && mod.__esModule) ? mod : { "default": mod };
9
- };
10
- Object.defineProperty(exports, "__esModule", { value: true });
11
- exports.showComprehensiveHelp = showComprehensiveHelp;
12
- exports.getHelpContent = getHelpContent;
13
- exports.showCommandHelp = showCommandHelp;
14
- const chalk_1 = __importDefault(require("chalk"));
15
- const version = '1.0.0'; // Will be replaced with actual version
16
- /**
17
- * Main help display with subsections
18
- */
19
- function showComprehensiveHelp() {
20
- console.log(getHelpContent());
21
- }
22
- /**
23
- * Get the complete help content
24
- */
25
- function getHelpContent() {
26
- return `
27
- ${getBanner()}
28
-
29
- ${getQuickStart()}
30
-
31
- ${getTableOfContents()}
32
-
33
- ${getCoreCommands()}
34
-
35
- ${getPluginCommands()}
36
-
37
- ${getDatabaseCommands()}
38
-
39
- ${getAdvancedCommands()}
40
-
41
- ${getExamples()}
42
-
43
- ${getTemplates()}
44
-
45
- ${getConfigurationGuide()}
46
-
47
- ${getTroubleshooting()}
48
-
49
- ${getResourcesAndDocumentation()}
50
-
51
- ${getFooter()}
52
- `;
53
- }
54
- /**
55
- * ASCII Art Banner
56
- */
57
- function getBanner() {
58
- return chalk_1.default.cyan.bold(`
59
- ╔═══════════════════════════════════════════════════════════════════════════╗
60
- ║ ║
61
- ║ █▀█ █▀▀ █▀▀ █▄░█ ▀█▀ █▀▄ █▄▄ ║
62
- ║ █▀█ █▄█ ██▄ █░▀█ ░█░ █▄▀ █▄█ ║
63
- ║ ║
64
- ║ Agent Memory & Vector Database with ReasoningBank ║
65
- ║ Version ${version.padEnd(62)}║
66
- ║ ║
67
- ╚═══════════════════════════════════════════════════════════════════════════╝
68
- `);
69
- }
70
- /**
71
- * Quick Start Section
72
- */
73
- function getQuickStart() {
74
- return `
75
- ${chalk_1.default.yellow.bold('━━━ QUICK START ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
76
-
77
- ${chalk_1.default.cyan('Get started in 30 seconds:')}
78
-
79
- ${chalk_1.default.gray('1.')} Create a learning plugin
80
- ${chalk_1.default.yellow('$ npx agentdb create-plugin')}
81
-
82
- ${chalk_1.default.gray('2.')} Initialize a vector database
83
- ${chalk_1.default.yellow('$ npx agentdb init ./my-vectors.db')}
84
-
85
- ${chalk_1.default.gray('3.')} Run performance benchmarks
86
- ${chalk_1.default.yellow('$ npx agentdb benchmark')}
87
-
88
- ${chalk_1.default.gray('4.')} Start MCP server for Claude Code
89
- ${chalk_1.default.yellow('$ npx agentdb mcp')}
90
-
91
- ${chalk_1.default.cyan('Need help?')} Run any command with ${chalk_1.default.yellow('--help')} for detailed information.
92
- `;
93
- }
94
- /**
95
- * Table of Contents
96
- */
97
- function getTableOfContents() {
98
- return `
99
- ${chalk_1.default.yellow.bold('━━━ TABLE OF CONTENTS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
100
-
101
- ${chalk_1.default.cyan('1.')} Core Commands ..................... Basic operations
102
- ${chalk_1.default.cyan('2.')} Plugin Commands ................... Learning plugin management
103
- ${chalk_1.default.cyan('3.')} Database Commands ................. Database operations
104
- ${chalk_1.default.cyan('4.')} Advanced Commands ................. Advanced features
105
- ${chalk_1.default.cyan('5.')} Examples .......................... Common usage patterns
106
- ${chalk_1.default.cyan('6.')} Templates ......................... Available plugin templates
107
- ${chalk_1.default.cyan('7.')} Configuration ..................... Configuration guide
108
- ${chalk_1.default.cyan('8.')} Troubleshooting ................... Common issues & solutions
109
- ${chalk_1.default.cyan('9.')} Resources ......................... Documentation & links
110
- `;
111
- }
112
- /**
113
- * Section 1: Core Commands
114
- */
115
- function getCoreCommands() {
116
- return `
117
- ${chalk_1.default.yellow.bold('━━━ 1. CORE COMMANDS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
118
-
119
- ${chalk_1.default.cyan.bold('help')} [command]
120
- ${chalk_1.default.gray('Show this help message or help for a specific command')}
121
-
122
- ${chalk_1.default.yellow('$ npx agentdb help')}
123
- ${chalk_1.default.yellow('$ npx agentdb help create-plugin')}
124
- ${chalk_1.default.yellow('$ npx agentdb create-plugin --help')}
125
-
126
- ${chalk_1.default.cyan.bold('version')}
127
- ${chalk_1.default.gray('Display version information')}
128
-
129
- ${chalk_1.default.yellow('$ npx agentdb version')}
130
-
131
- ${chalk_1.default.gray('Output:')}
132
- ${chalk_1.default.gray(' agentdb v1.0.0')}
133
- ${chalk_1.default.gray(' Node: v20.10.0')}
134
- ${chalk_1.default.gray(' Platform: linux x64')}
135
-
136
- ${chalk_1.default.cyan.bold('mcp')} [options]
137
- ${chalk_1.default.gray('Start Model Context Protocol (MCP) server for Claude Code integration')}
138
-
139
- ${chalk_1.default.yellow('$ npx agentdb mcp')}
140
- ${chalk_1.default.yellow('$ npx agentdb mcp --port 3000')}
141
- ${chalk_1.default.yellow('$ npx agentdb mcp --log debug')}
142
-
143
- ${chalk_1.default.gray('Options:')}
144
- ${chalk_1.default.cyan('--port <number>')} Port to listen on (default: 3000)
145
- ${chalk_1.default.cyan('--host <string>')} Host to bind to (default: localhost)
146
- ${chalk_1.default.cyan('--log <level>')} Log level: debug, info, warn, error
147
- ${chalk_1.default.cyan('--cors')} Enable CORS
148
- ${chalk_1.default.cyan('--auth <token>')} API authentication token
149
-
150
- ${chalk_1.default.gray('Claude Desktop Integration:')}
151
- ${chalk_1.default.gray('Add to ~/.config/claude/config.json:')}
152
- ${chalk_1.default.blue(`{
153
- "mcpServers": {
154
- "agentdb": {
155
- "command": "npx",
156
- "args": ["agentdb", "mcp"]
157
- }
158
- }
159
- }`)}
160
- `;
161
- }
162
- /**
163
- * Section 2: Plugin Commands
164
- */
165
- function getPluginCommands() {
166
- return `
167
- ${chalk_1.default.yellow.bold('━━━ 2. PLUGIN COMMANDS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
168
-
169
- ${chalk_1.default.cyan.bold('create-plugin')} [options]
170
- ${chalk_1.default.gray('Create a new learning plugin with interactive wizard')}
171
- ${chalk_1.default.gray('Supports Decision Transformer, Q-Learning, SARSA, Actor-Critic, and more')}
172
-
173
- ${chalk_1.default.yellow('$ npx agentdb create-plugin')}
174
- ${chalk_1.default.yellow('$ npx agentdb create-plugin --template q-learning --name my-q')}
175
- ${chalk_1.default.yellow('$ npx agentdb create-plugin -t decision-transformer -n my-dt --no-customize')}
176
-
177
- ${chalk_1.default.gray('Options:')}
178
- ${chalk_1.default.cyan('-t, --template <name>')} Use a template (see list-templates)
179
- ${chalk_1.default.cyan('-n, --name <name>')} Plugin name (lowercase, hyphens only)
180
- ${chalk_1.default.cyan('--no-customize')} Skip customization (use defaults)
181
- ${chalk_1.default.cyan('-o, --output <dir>')} Output directory (default: ./plugins)
182
- ${chalk_1.default.cyan('--force')} Overwrite existing plugin
183
- ${chalk_1.default.cyan('--dry-run')} Show what would be generated
184
-
185
- ${chalk_1.default.gray('Generated Structure:')}
186
- ${chalk_1.default.blue(`plugins/my-plugin/
187
- ├── plugin.yaml # Configuration
188
- ├── README.md # Documentation
189
- ├── package.json # Dependencies
190
- ├── tsconfig.json # TypeScript config
191
- ├── src/
192
- │ ├── index.ts # Plugin implementation
193
- │ ├── agent.ts # Learning algorithm
194
- │ ├── reward.ts # Reward function
195
- │ └── policy.ts # Action selection
196
- └── tests/
197
- └── plugin.test.ts # Unit tests`)}
198
-
199
- ${chalk_1.default.cyan.bold('list-plugins')} [options]
200
- ${chalk_1.default.gray('List all available plugins')}
201
-
202
- ${chalk_1.default.yellow('$ npx agentdb list-plugins')}
203
- ${chalk_1.default.yellow('$ npx agentdb list-plugins --verbose')}
204
- ${chalk_1.default.yellow('$ npx agentdb list-plugins --filter "q-*"')}
205
-
206
- ${chalk_1.default.gray('Options:')}
207
- ${chalk_1.default.cyan('-v, --verbose')} Show detailed information
208
- ${chalk_1.default.cyan('--filter <pattern>')} Filter by name pattern
209
- ${chalk_1.default.cyan('--sort <field>')} Sort by: name, version, created
210
- ${chalk_1.default.cyan('--json')} Output as JSON
211
-
212
- ${chalk_1.default.cyan.bold('list-templates')} [options]
213
- ${chalk_1.default.gray('List all available plugin templates')}
214
-
215
- ${chalk_1.default.yellow('$ npx agentdb list-templates')}
216
- ${chalk_1.default.yellow('$ npx agentdb list-templates --detailed')}
217
- ${chalk_1.default.yellow('$ npx agentdb list-templates --category reinforcement-learning')}
218
-
219
- ${chalk_1.default.gray('Options:')}
220
- ${chalk_1.default.cyan('-d, --detailed')} Show detailed information
221
- ${chalk_1.default.cyan('-c, --category <name>')} Filter by category
222
- ${chalk_1.default.cyan('--json')} Output as JSON
223
-
224
- ${chalk_1.default.cyan.bold('plugin-info')} <name> [options]
225
- ${chalk_1.default.gray('Get information about a specific plugin')}
226
-
227
- ${chalk_1.default.yellow('$ npx agentdb plugin-info my-plugin')}
228
- ${chalk_1.default.yellow('$ npx agentdb plugin-info my-plugin --json')}
229
-
230
- ${chalk_1.default.gray('Options:')}
231
- ${chalk_1.default.cyan('--json')} Output as JSON
232
- ${chalk_1.default.cyan('--metrics')} Include performance metrics
233
- ${chalk_1.default.cyan('--dependencies')} Show dependencies
234
-
235
- ${chalk_1.default.cyan.bold('use-plugin')} <name> [options]
236
- ${chalk_1.default.gray('Load and use a plugin in your application')}
237
-
238
- ${chalk_1.default.yellow('$ npx agentdb use-plugin my-plugin')}
239
- ${chalk_1.default.yellow('$ npx agentdb use-plugin my-plugin --config custom.yaml')}
240
-
241
- ${chalk_1.default.gray('Options:')}
242
- ${chalk_1.default.cyan('-c, --config <file>')} Custom configuration file
243
- ${chalk_1.default.cyan('-t, --test')} Run in test mode
244
- ${chalk_1.default.cyan('-v, --verbose')} Verbose output
245
- ${chalk_1.default.cyan('--interactive')} Interactive mode (REPL)
246
-
247
- ${chalk_1.default.cyan.bold('test-plugin')} <name> [options]
248
- ${chalk_1.default.gray('Test a plugin')}
249
-
250
- ${chalk_1.default.yellow('$ npx agentdb test-plugin my-plugin')}
251
- ${chalk_1.default.yellow('$ npx agentdb test-plugin my-plugin --coverage')}
252
- ${chalk_1.default.yellow('$ npx agentdb test-plugin my-plugin --benchmark')}
253
-
254
- ${chalk_1.default.gray('Options:')}
255
- ${chalk_1.default.cyan('--coverage')} Generate coverage report
256
- ${chalk_1.default.cyan('--benchmark')} Run performance benchmarks
257
- ${chalk_1.default.cyan('-v, --verbose')} Verbose output
258
- ${chalk_1.default.cyan('--watch')} Watch mode
259
-
260
- ${chalk_1.default.cyan.bold('validate-plugin')} <name> [options]
261
- ${chalk_1.default.gray('Validate plugin configuration and structure')}
262
-
263
- ${chalk_1.default.yellow('$ npx agentdb validate-plugin my-plugin')}
264
- ${chalk_1.default.yellow('$ npx agentdb validate-plugin my-plugin --fix')}
265
-
266
- ${chalk_1.default.gray('Options:')}
267
- ${chalk_1.default.cyan('--fix')} Attempt to fix validation errors
268
- ${chalk_1.default.cyan('--strict')} Use strict validation
269
- ${chalk_1.default.cyan('--schema <file>')} Custom validation schema
270
- `;
271
- }
272
- /**
273
- * Section 3: Database Commands
274
- */
275
- function getDatabaseCommands() {
276
- return `
277
- ${chalk_1.default.yellow.bold('━━━ 3. DATABASE COMMANDS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
278
-
279
- ${chalk_1.default.cyan.bold('init')} <path> [options]
280
- ${chalk_1.default.gray('Initialize a new vector database')}
281
-
282
- ${chalk_1.default.yellow('$ npx agentdb init ./vectors.db')}
283
- ${chalk_1.default.yellow('$ npx agentdb init ./vectors.db --dimension 1536')}
284
- ${chalk_1.default.yellow('$ npx agentdb init ./vectors.db --preset large')}
285
-
286
- ${chalk_1.default.gray('Options:')}
287
- ${chalk_1.default.cyan('--dimension <number>')} Vector dimension (default: 1536)
288
- ${chalk_1.default.cyan('--preset <name>')} Use preset: small, medium, large
289
- ${chalk_1.default.cyan('--hnsw')} Enable HNSW index (default: true)
290
- ${chalk_1.default.cyan('--quantization <bits>')} Quantization: 8, 16, or none
291
- ${chalk_1.default.cyan('--in-memory')} Create in-memory database
292
- ${chalk_1.default.cyan('--read-only')} Open in read-only mode
293
-
294
- ${chalk_1.default.cyan.bold('import')} <file> [options]
295
- ${chalk_1.default.gray('Import vectors from file (JSON, CSV, NPY)')}
296
-
297
- ${chalk_1.default.yellow('$ npx agentdb import vectors.json --db ./vectors.db')}
298
- ${chalk_1.default.yellow('$ npx agentdb import embeddings.npy --db ./vectors.db --format npy')}
299
-
300
- ${chalk_1.default.gray('Options:')}
301
- ${chalk_1.default.cyan('--db <path>')} Database path
302
- ${chalk_1.default.cyan('--format <type>')} Format: json, csv, npy, parquet
303
- ${chalk_1.default.cyan('--batch-size <number>')} Batch size (default: 1000)
304
- ${chalk_1.default.cyan('--skip-errors')} Continue on errors
305
-
306
- ${chalk_1.default.cyan.bold('export')} <path> [options]
307
- ${chalk_1.default.gray('Export vectors to file')}
308
-
309
- ${chalk_1.default.yellow('$ npx agentdb export ./vectors.db --output vectors.json')}
310
- ${chalk_1.default.yellow('$ npx agentdb export ./vectors.db --format npy -o embeddings.npy')}
311
-
312
- ${chalk_1.default.gray('Options:')}
313
- ${chalk_1.default.cyan('-o, --output <file>')} Output file
314
- ${chalk_1.default.cyan('--format <type>')} Format: json, csv, npy, parquet
315
- ${chalk_1.default.cyan('--filter <query>')} Filter condition
316
- ${chalk_1.default.cyan('--limit <number>')} Limit number of vectors
317
-
318
- ${chalk_1.default.cyan.bold('query')} <database> [options]
319
- ${chalk_1.default.gray('Query vector database')}
320
-
321
- ${chalk_1.default.yellow('$ npx agentdb query ./vectors.db --vector "[0.1, 0.2, ...]"')}
322
- ${chalk_1.default.yellow('$ npx agentdb query ./vectors.db --text "search query"')}
323
-
324
- ${chalk_1.default.gray('Options:')}
325
- ${chalk_1.default.cyan('--vector <json>')} Query vector (JSON array)
326
- ${chalk_1.default.cyan('--text <string>')} Text query (auto-embedded)
327
- ${chalk_1.default.cyan('--k <number>')} Number of results (default: 5)
328
- ${chalk_1.default.cyan('--threshold <number>')} Similarity threshold (0-1)
329
- ${chalk_1.default.cyan('--metric <name>')} Metric: cosine, euclidean, dot
330
-
331
- ${chalk_1.default.cyan.bold('stats')} <database> [options]
332
- ${chalk_1.default.gray('Show database statistics')}
333
-
334
- ${chalk_1.default.yellow('$ npx agentdb stats ./vectors.db')}
335
- ${chalk_1.default.yellow('$ npx agentdb stats ./vectors.db --detailed')}
336
-
337
- ${chalk_1.default.gray('Options:')}
338
- ${chalk_1.default.cyan('--detailed')} Show detailed statistics
339
- ${chalk_1.default.cyan('--json')} Output as JSON
340
- `;
341
- }
342
- /**
343
- * Section 4: Advanced Commands
344
- */
345
- function getAdvancedCommands() {
346
- return `
347
- ${chalk_1.default.yellow.bold('━━━ 4. ADVANCED COMMANDS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
348
-
349
- ${chalk_1.default.cyan.bold('benchmark')} [options]
350
- ${chalk_1.default.gray('Run performance benchmarks')}
351
-
352
- ${chalk_1.default.yellow('$ npx agentdb benchmark')}
353
- ${chalk_1.default.yellow('$ npx agentdb benchmark --suite insertion')}
354
- ${chalk_1.default.yellow('$ npx agentdb benchmark --output report.json')}
355
-
356
- ${chalk_1.default.gray('Options:')}
357
- ${chalk_1.default.cyan('--suite <name>')} Benchmark suite: insertion, search, all
358
- ${chalk_1.default.cyan('--size <number>')} Dataset size (default: 10000)
359
- ${chalk_1.default.cyan('--dimension <number>')} Vector dimension (default: 1536)
360
- ${chalk_1.default.cyan('--output <file>')} Save results to file
361
- ${chalk_1.default.cyan('--compare <file>')} Compare with previous results
362
-
363
- ${chalk_1.default.cyan.bold('optimize')} <database> [options]
364
- ${chalk_1.default.gray('Optimize database performance')}
365
-
366
- ${chalk_1.default.yellow('$ npx agentdb optimize ./vectors.db')}
367
- ${chalk_1.default.yellow('$ npx agentdb optimize ./vectors.db --rebuild-index')}
368
-
369
- ${chalk_1.default.gray('Options:')}
370
- ${chalk_1.default.cyan('--rebuild-index')} Rebuild HNSW index
371
- ${chalk_1.default.cyan('--vacuum')} Vacuum database
372
- ${chalk_1.default.cyan('--analyze')} Update statistics
373
- ${chalk_1.default.cyan('--compact')} Compact database
374
-
375
- ${chalk_1.default.cyan.bold('repl')} [options]
376
- ${chalk_1.default.gray('Start interactive REPL (experimental)')}
377
-
378
- ${chalk_1.default.yellow('$ npx agentdb repl')}
379
- ${chalk_1.default.yellow('$ npx agentdb repl --db ./vectors.db')}
380
-
381
- ${chalk_1.default.gray('Options:')}
382
- ${chalk_1.default.cyan('--db <path>')} Load database on startup
383
- ${chalk_1.default.cyan('--history')} Enable command history
384
- ${chalk_1.default.cyan('--plugin <name>')} Load plugin
385
-
386
- ${chalk_1.default.cyan.bold('train')} <plugin> [options]
387
- ${chalk_1.default.gray('Train a learning plugin')}
388
-
389
- ${chalk_1.default.yellow('$ npx agentdb train my-plugin')}
390
- ${chalk_1.default.yellow('$ npx agentdb train my-plugin --data ./training.json')}
391
-
392
- ${chalk_1.default.gray('Options:')}
393
- ${chalk_1.default.cyan('--data <file>')} Training data file
394
- ${chalk_1.default.cyan('--epochs <number>')} Number of epochs (default: 10)
395
- ${chalk_1.default.cyan('--batch-size <number>')} Batch size (default: 32)
396
- ${chalk_1.default.cyan('--checkpoint <dir>')} Save checkpoints
397
- ${chalk_1.default.cyan('--wandb')} Log to Weights & Biases
398
-
399
- ${chalk_1.default.cyan.bold('deploy')} <plugin> [options]
400
- ${chalk_1.default.gray('Deploy plugin to production')}
401
-
402
- ${chalk_1.default.yellow('$ npx agentdb deploy my-plugin')}
403
- ${chalk_1.default.yellow('$ npx agentdb deploy my-plugin --env production')}
404
-
405
- ${chalk_1.default.gray('Options:')}
406
- ${chalk_1.default.cyan('--env <name>')} Environment: dev, staging, production
407
- ${chalk_1.default.cyan('--registry <url>')} Plugin registry URL
408
- ${chalk_1.default.cyan('--tag <version>')} Version tag
409
- `;
410
- }
411
- /**
412
- * Section 5: Examples
413
- */
414
- function getExamples() {
415
- return `
416
- ${chalk_1.default.yellow.bold('━━━ 5. EXAMPLES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
417
-
418
- ${chalk_1.default.cyan.bold('Example 1: Quick Plugin Setup')}
419
- ${chalk_1.default.gray('# Create Q-Learning plugin')}
420
- ${chalk_1.default.yellow('$ npx agentdb create-plugin -t q-learning -n my-q-agent --no-customize')}
421
-
422
- ${chalk_1.default.gray('# Navigate and install')}
423
- ${chalk_1.default.yellow('$ cd plugins/my-q-agent && npm install')}
424
-
425
- ${chalk_1.default.gray('# Test the plugin')}
426
- ${chalk_1.default.yellow('$ npm test')}
427
-
428
- ${chalk_1.default.cyan.bold('Example 2: Custom Reward Function')}
429
- ${chalk_1.default.gray('# Create plugin with wizard')}
430
- ${chalk_1.default.yellow('$ npx agentdb create-plugin')}
431
- ${chalk_1.default.gray(' ? Base algorithm: Decision Transformer')}
432
- ${chalk_1.default.gray(' ? Reward function: Custom')}
433
- ${chalk_1.default.gray(' ? Enter reward function:')}
434
- ${chalk_1.default.blue(` function computeReward(outcome, context) {
435
- const base = outcome.success ? 1.0 : -1.0;
436
- const timePenalty = -0.1 * (context.duration / 1000);
437
- return base + timePenalty;
438
- }`)}
439
-
440
- ${chalk_1.default.cyan.bold('Example 3: Database Operations')}
441
- ${chalk_1.default.gray('# Initialize database')}
442
- ${chalk_1.default.yellow('$ npx agentdb init ./data/vectors.db --dimension 768')}
443
-
444
- ${chalk_1.default.gray('# Import vectors')}
445
- ${chalk_1.default.yellow('$ npx agentdb import embeddings.json --db ./data/vectors.db')}
446
-
447
- ${chalk_1.default.gray('# Query database')}
448
- ${chalk_1.default.yellow('$ npx agentdb query ./data/vectors.db --text "search query" --k 10')}
449
-
450
- ${chalk_1.default.gray('# Export results')}
451
- ${chalk_1.default.yellow('$ npx agentdb export ./data/vectors.db -o results.json --format json')}
452
-
453
- ${chalk_1.default.cyan.bold('Example 4: A/B Testing Plugins')}
454
- ${chalk_1.default.gray('# Create two plugins')}
455
- ${chalk_1.default.yellow('$ npx agentdb create-plugin -t decision-transformer -n plugin-a')}
456
- ${chalk_1.default.yellow('$ npx agentdb create-plugin -t q-learning -n plugin-b')}
457
-
458
- ${chalk_1.default.gray('# Compare performance')}
459
- ${chalk_1.default.yellow('$ npx agentdb test-plugin plugin-a --benchmark')}
460
- ${chalk_1.default.yellow('$ npx agentdb test-plugin plugin-b --benchmark')}
461
-
462
- ${chalk_1.default.cyan.bold('Example 5: Production Deployment')}
463
- ${chalk_1.default.gray('# Train plugin')}
464
- ${chalk_1.default.yellow('$ npx agentdb train my-plugin --data ./training-data.json --epochs 100')}
465
-
466
- ${chalk_1.default.gray('# Validate')}
467
- ${chalk_1.default.yellow('$ npx agentdb validate-plugin my-plugin --strict')}
468
-
469
- ${chalk_1.default.gray('# Deploy')}
470
- ${chalk_1.default.yellow('$ npx agentdb deploy my-plugin --env production --tag v1.0.0')}
471
- `;
472
- }
473
- /**
474
- * Section 6: Templates
475
- */
476
- function getTemplates() {
477
- return `
478
- ${chalk_1.default.yellow.bold('━━━ 6. TEMPLATES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
479
-
480
- ${chalk_1.default.cyan.bold('decision-transformer')} ${chalk_1.default.green('(Recommended)')}
481
- ${chalk_1.default.gray('Sequence modeling approach to reinforcement learning')}
482
- ${chalk_1.default.gray('Best for: Sequential decision-making tasks')}
483
- ${chalk_1.default.gray('Sample efficiency: ⭐⭐⭐⭐⭐ (5x better than Q-learning)')}
484
-
485
- ${chalk_1.default.yellow('$ npx agentdb create-plugin -t decision-transformer -n my-dt')}
486
-
487
- ${chalk_1.default.cyan.bold('q-learning')}
488
- ${chalk_1.default.gray('Model-free, off-policy, value-based learning')}
489
- ${chalk_1.default.gray('Best for: Discrete action spaces with clear value functions')}
490
- ${chalk_1.default.gray('Sample efficiency: ⭐⭐⭐')}
491
-
492
- ${chalk_1.default.yellow('$ npx agentdb create-plugin -t q-learning -n my-q')}
493
-
494
- ${chalk_1.default.cyan.bold('sarsa')}
495
- ${chalk_1.default.gray('On-policy temporal difference learning')}
496
- ${chalk_1.default.gray('Best for: Safe, conservative learning scenarios')}
497
- ${chalk_1.default.gray('Sample efficiency: ⭐⭐⭐')}
498
-
499
- ${chalk_1.default.yellow('$ npx agentdb create-plugin -t sarsa -n my-sarsa')}
500
-
501
- ${chalk_1.default.cyan.bold('actor-critic')}
502
- ${chalk_1.default.gray('Policy gradient method with value function baseline')}
503
- ${chalk_1.default.gray('Best for: Continuous action spaces, complex policies')}
504
- ${chalk_1.default.gray('Sample efficiency: ⭐⭐⭐⭐')}
505
-
506
- ${chalk_1.default.yellow('$ npx agentdb create-plugin -t actor-critic -n my-ac')}
507
-
508
- ${chalk_1.default.cyan.bold('curiosity-driven')}
509
- ${chalk_1.default.gray('Intrinsic motivation for exploration')}
510
- ${chalk_1.default.gray('Best for: Sparse reward environments requiring exploration')}
511
- ${chalk_1.default.gray('Sample efficiency: ⭐⭐⭐⭐')}
512
-
513
- ${chalk_1.default.yellow('$ npx agentdb create-plugin -t curiosity-driven -n my-curious')}
514
-
515
- ${chalk_1.default.gray('View all templates:')} ${chalk_1.default.yellow('npx agentdb list-templates --detailed')}
516
- `;
517
- }
518
- /**
519
- * Section 7: Configuration Guide
520
- */
521
- function getConfigurationGuide() {
522
- return `
523
- ${chalk_1.default.yellow.bold('━━━ 7. CONFIGURATION ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
524
-
525
- ${chalk_1.default.cyan.bold('Plugin Configuration (plugin.yaml)')}
526
- ${chalk_1.default.blue(`name: my-plugin
527
- version: 1.0.0
528
- description: My custom learning plugin
529
- base_algorithm: decision_transformer
530
-
531
- algorithm:
532
- type: decision_transformer
533
- learning_rate: 0.001
534
- discount_factor: 0.99
535
-
536
- training:
537
- batch_size: 32
538
- epochs: 10
539
- min_experiences: 100
540
-
541
- storage:
542
- path: ./.rl/plugin.db
543
- hnsw:
544
- enabled: true
545
- M: 16`)}
546
-
547
- ${chalk_1.default.cyan.bold('Environment Variables')}
548
- ${chalk_1.default.cyan('SQLITE_VECTOR_DB_PATH')} Database path (default: ./vectors.db)
549
- ${chalk_1.default.cyan('SQLITE_VECTOR_LOG_LEVEL')} Log level: debug, info, warn, error
550
- ${chalk_1.default.cyan('SQLITE_VECTOR_CACHE_SIZE')} Cache size in MB (default: 100)
551
- ${chalk_1.default.cyan('SQLITE_VECTOR_WORKERS')} Number of worker threads (default: 4)
552
-
553
- ${chalk_1.default.cyan.bold('Configuration Files')}
554
- ${chalk_1.default.gray('Global:')} ${chalk_1.default.blue('~/.agentdb/config.yaml')}
555
- ${chalk_1.default.gray('Project:')} ${chalk_1.default.blue('./.agentdb/config.yaml')}
556
- ${chalk_1.default.gray('Plugin:')} ${chalk_1.default.blue('./plugins/<name>/plugin.yaml')}
557
-
558
- ${chalk_1.default.cyan.bold('Configuration Precedence')}
559
- ${chalk_1.default.gray('1. Command-line arguments (highest priority)')}
560
- ${chalk_1.default.gray('2. Environment variables')}
561
- ${chalk_1.default.gray('3. Project config')}
562
- ${chalk_1.default.gray('4. Global config')}
563
- ${chalk_1.default.gray('5. Default values (lowest priority)')}
564
- `;
565
- }
566
- /**
567
- * Section 8: Troubleshooting
568
- */
569
- function getTroubleshooting() {
570
- return `
571
- ${chalk_1.default.yellow.bold('━━━ 8. TROUBLESHOOTING ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
572
-
573
- ${chalk_1.default.cyan.bold('Common Issues')}
574
-
575
- ${chalk_1.default.red('Issue:')} Plugin creation fails
576
- ${chalk_1.default.green('Solution:')} Ensure Node.js >= 18 and all dependencies are installed
577
- ${chalk_1.default.yellow('$ node --version')}
578
- ${chalk_1.default.yellow('$ npm install -g npm@latest')}
579
-
580
- ${chalk_1.default.red('Issue:')} Database locked error
581
- ${chalk_1.default.green('Solution:')} Close other connections or use WAL mode
582
- ${chalk_1.default.yellow('$ npx agentdb optimize ./vectors.db --mode wal')}
583
-
584
- ${chalk_1.default.red('Issue:')} Out of memory during training
585
- ${chalk_1.default.green('Solution:')} Reduce batch size or enable quantization
586
- ${chalk_1.default.gray('In plugin.yaml:')}
587
- ${chalk_1.default.blue(`training:
588
- batch_size: 16 # Reduce from 32
589
- storage:
590
- quantization:
591
- enabled: true
592
- bits: 8`)}
593
-
594
- ${chalk_1.default.red('Issue:')} Slow search performance
595
- ${chalk_1.default.green('Solution:')} Enable HNSW index and optimize
596
- ${chalk_1.default.yellow('$ npx agentdb optimize ./vectors.db --rebuild-index')}
597
-
598
- ${chalk_1.default.red('Issue:')} Plugin tests failing
599
- ${chalk_1.default.green('Solution:')} Check dependencies and rebuild
600
- ${chalk_1.default.yellow('$ cd plugins/my-plugin')}
601
- ${chalk_1.default.yellow('$ rm -rf node_modules && npm install')}
602
- ${chalk_1.default.yellow('$ npm run build && npm test')}
603
-
604
- ${chalk_1.default.cyan.bold('Debug Mode')}
605
- ${chalk_1.default.gray('Enable verbose logging:')}
606
- ${chalk_1.default.yellow('$ DEBUG=agentdb:* npx agentdb <command>')}
607
- ${chalk_1.default.yellow('$ npx agentdb <command> --verbose --log-level debug')}
608
-
609
- ${chalk_1.default.cyan.bold('Getting Help')}
610
- ${chalk_1.default.gray('Report issues:')} ${chalk_1.default.blue('https://github.com/ruvnet/agentic-flow/issues')}
611
- ${chalk_1.default.gray('View logs:')} ${chalk_1.default.yellow('~/.agentdb/logs/')}
612
- ${chalk_1.default.gray('Check status:')} ${chalk_1.default.yellow('npx agentdb version')}
613
- `;
614
- }
615
- /**
616
- * Section 9: Resources and Documentation
617
- */
618
- function getResourcesAndDocumentation() {
619
- return `
620
- ${chalk_1.default.yellow.bold('━━━ 9. RESOURCES & DOCUMENTATION ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
621
-
622
- ${chalk_1.default.cyan.bold('Documentation')}
623
- ${chalk_1.default.blue('📘 Plugin Quick Start')} docs/PLUGIN_QUICKSTART.md
624
- ${chalk_1.default.blue('📕 API Reference')} docs/PLUGIN_API.md
625
- ${chalk_1.default.blue('📗 Architecture Design')} docs/LEARNING_PLUGIN_DESIGN.md
626
- ${chalk_1.default.blue('📙 Decision Transformer')} docs/DECISION_TRANSFORMER.md
627
- ${chalk_1.default.blue('📔 Performance Benchmarks')} docs/RL_BENCHMARKS.md
628
- ${chalk_1.default.blue('📓 Optimization Guide')} docs/PLUGIN_OPTIMIZATION.md
629
-
630
- ${chalk_1.default.cyan.bold('Online Resources')}
631
- ${chalk_1.default.gray('GitHub:')} ${chalk_1.default.blue('https://github.com/ruvnet/agentic-flow')}
632
- ${chalk_1.default.gray('Issues:')} ${chalk_1.default.blue('https://github.com/ruvnet/agentic-flow/issues')}
633
- ${chalk_1.default.gray('Wiki:')} ${chalk_1.default.blue('https://github.com/ruvnet/agentic-flow/wiki')}
634
- ${chalk_1.default.gray('Discussions:')} ${chalk_1.default.blue('https://github.com/ruvnet/agentic-flow/discussions')}
635
-
636
- ${chalk_1.default.cyan.bold('Community')}
637
- ${chalk_1.default.gray('Discord:')} ${chalk_1.default.blue('https://discord.gg/agentic-flow')}
638
- ${chalk_1.default.gray('Twitter:')} ${chalk_1.default.blue('@agentic_flow')}
639
- ${chalk_1.default.gray('Stack Overflow:')} ${chalk_1.default.blue('Tag: agentdb')}
640
-
641
- ${chalk_1.default.cyan.bold('Code Examples')}
642
- ${chalk_1.default.gray('Examples repository:')} ${chalk_1.default.blue('https://github.com/ruvnet/agentic-flow-examples')}
643
- ${chalk_1.default.gray('Tutorials:')} ${chalk_1.default.blue('https://docs.agentic-flow.ai/tutorials')}
644
- ${chalk_1.default.gray('Blog posts:')} ${chalk_1.default.blue('https://blog.agentic-flow.ai')}
645
- `;
646
- }
647
- /**
648
- * Footer
649
- */
650
- function getFooter() {
651
- return `
652
- ${chalk_1.default.yellow.bold('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
653
-
654
- ${chalk_1.default.cyan.bold('License')}
655
- MIT OR Apache-2.0
656
-
657
- ${chalk_1.default.cyan.bold('Contributing')}
658
- Contributions welcome! See CONTRIBUTING.md for guidelines.
659
-
660
- ${chalk_1.default.cyan.bold('Support')}
661
- Found a bug? ${chalk_1.default.yellow('npx agentdb help')} | ${chalk_1.default.blue('https://github.com/ruvnet/agentic-flow/issues')}
662
-
663
- ${chalk_1.default.gray('Run')} ${chalk_1.default.yellow('npx agentdb <command> --help')} ${chalk_1.default.gray('for detailed command information.')}
664
-
665
- ${chalk_1.default.yellow.bold('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
666
- `;
667
- }
668
- /**
669
- * Show help for specific command
670
- */
671
- function showCommandHelp(command) {
672
- // This will be implemented to show command-specific help
673
- console.log(`Detailed help for: ${command}`);
674
- console.log(`Run: npx agentdb ${command} --help`);
675
- }
676
- //# sourceMappingURL=help.js.map