@dikolab/kbdb 0.3.2 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (523) hide show
  1. package/README.md +92 -90
  2. package/dist/chunk-BJXEVALU.mjs +337 -0
  3. package/dist/chunk-BJXEVALU.mjs.map +7 -0
  4. package/dist/cli.cjs +1398 -378
  5. package/dist/cli.cjs.map +4 -4
  6. package/dist/cli.d.ts +9 -0
  7. package/dist/cli.mjs +1138 -342
  8. package/dist/cli.mjs.map +4 -4
  9. package/dist/kbdb-worker.cjs +1115 -135
  10. package/dist/kbdb-worker.cjs.map +4 -4
  11. package/dist/mod.cjs +351 -69
  12. package/dist/mod.cjs.map +4 -4
  13. package/dist/mod.d.ts +23 -2
  14. package/dist/mod.mjs +349 -68
  15. package/dist/mod.mjs.map +4 -4
  16. package/dist/src/shared/cli/functions/dispatch-command.function.d.ts +2 -1
  17. package/dist/src/shared/cli/functions/find-db.function.d.ts +7 -8
  18. package/dist/src/shared/cli/functions/handle-mcp.function.d.ts +1 -1
  19. package/dist/src/shared/cli/functions/parse-args.function.d.ts +4 -3
  20. package/dist/src/shared/cli/functions/resolve-kbid-prefix.function.d.ts +27 -0
  21. package/dist/src/shared/cli/functions/resolve-raw-db-path.function.d.ts +10 -0
  22. package/dist/src/shared/cli/functions/run-cli.function.d.ts +3 -1
  23. package/dist/src/shared/cli/functions/run-content.function.d.ts +8 -3
  24. package/dist/src/shared/cli/functions/run-import.function.d.ts +27 -0
  25. package/dist/src/shared/cli/functions/run-recall.function.d.ts +10 -4
  26. package/dist/src/shared/cli/functions/run-search.function.d.ts +7 -0
  27. package/dist/src/shared/cli/functions/run-unlearn.function.d.ts +9 -4
  28. package/dist/src/shared/cli/functions/run-worker-restart.function.d.ts +11 -0
  29. package/dist/src/shared/cli/functions/run-worker-stop.function.d.ts +11 -0
  30. package/dist/src/shared/cli/index.d.ts +2 -0
  31. package/dist/src/shared/cli/typings/cli-deps.interface.d.ts +4 -1
  32. package/dist/src/shared/cli/typings/cli-options.interface.d.ts +22 -0
  33. package/dist/src/shared/cli/typings/dispatch-client.type.d.ts +2 -1
  34. package/dist/src/shared/cli/typings/search-display.model.d.ts +6 -0
  35. package/dist/src/shared/embedding/classes/api-embedding-provider.class.d.ts +33 -0
  36. package/dist/src/shared/embedding/classes/onnx-embedding-provider.class.d.ts +33 -0
  37. package/dist/src/shared/embedding/classes/tfidf-embedding-provider.class.d.ts +28 -0
  38. package/dist/src/shared/embedding/constants/tfidf-defaults.constant.d.ts +4 -0
  39. package/dist/src/shared/embedding/functions/append-vector-entry.function.d.ts +14 -0
  40. package/dist/src/shared/embedding/functions/create-embedding-provider.function.d.ts +15 -0
  41. package/dist/src/shared/embedding/functions/detect-stale-vectors.function.d.ts +16 -0
  42. package/dist/src/shared/embedding/functions/parse-api-embedding-response.function.d.ts +11 -0
  43. package/dist/src/shared/embedding/functions/rebuild-vectors.function.d.ts +15 -0
  44. package/dist/src/shared/embedding/functions/scan-semantic-contradictions.function.d.ts +13 -0
  45. package/dist/src/shared/embedding/index.d.ts +9 -0
  46. package/dist/src/shared/embedding/typings/semantic-contradiction.model.d.ts +21 -0
  47. package/dist/src/shared/embedding/typings/stale-vectors-report.model.d.ts +16 -0
  48. package/dist/src/shared/log/constants/log-colors.constant.d.ts +5 -0
  49. package/dist/src/shared/log/constants/log-defaults.constant.d.ts +3 -0
  50. package/dist/src/shared/log/constants/log-icons.constant.d.ts +3 -0
  51. package/dist/src/shared/log/functions/configure-log.function.d.ts +12 -0
  52. package/dist/src/shared/log/functions/log.function.d.ts +28 -0
  53. package/dist/src/shared/log/functions/parse-log-level.function.d.ts +10 -0
  54. package/dist/src/shared/log/functions/resolve-log-level.function.d.ts +12 -0
  55. package/dist/src/shared/log/functions/write-stderr.function.d.ts +10 -0
  56. package/dist/src/shared/log/index.d.ts +10 -0
  57. package/dist/src/shared/log/typings/log-config.interface.d.ts +7 -0
  58. package/dist/src/shared/log/typings/log-level.type.d.ts +7 -0
  59. package/dist/src/shared/log/typings/log-output.interface.d.ts +4 -0
  60. package/dist/src/shared/mcp/classes/mcp-server.class.d.ts +22 -2
  61. package/dist/src/shared/mcp/functions/create-mcp-server.function.d.ts +6 -1
  62. package/dist/src/shared/mcp/functions/has-sampling-capability.function.d.ts +8 -0
  63. package/dist/src/shared/mcp/functions/run-auto-capture.function.d.ts +26 -0
  64. package/dist/src/shared/mcp/typings/mcp-client.interface.d.ts +2 -0
  65. package/dist/src/shared/mcp/typings/mcp-integrity-check-result.model.d.ts +24 -0
  66. package/dist/src/shared/mcp/typings/mcp-worker-client.interface.d.ts +3 -1
  67. package/dist/src/shared/version/constants/version.constant.d.ts +1 -1
  68. package/dist/src/shared/wasm-codec/typings/paged-search-result.model.d.ts +2 -0
  69. package/dist/src/shared/worker-client/classes/worker-client.class.d.ts +38 -1
  70. package/dist/src/shared/worker-client/constants/request-timeout.constant.d.ts +2 -0
  71. package/dist/src/shared/worker-client/constants/retry-defaults.constant.d.ts +2 -0
  72. package/dist/src/shared/worker-client/functions/get-or-create-client.function.d.ts +20 -0
  73. package/dist/src/shared/worker-client/functions/retry-on-timeout.function.d.ts +18 -0
  74. package/dist/src/shared/worker-client/index.d.ts +4 -1
  75. package/dist/src/shared/worker-client/typings/import-result.model.d.ts +16 -0
  76. package/dist/src/shared/worker-client/typings/integrity-check-result.model.d.ts +24 -0
  77. package/dist/src/shared/worker-client/typings/search-params.model.d.ts +4 -0
  78. package/dist/src/shared/worker-client/typings/search-result.model.d.ts +6 -0
  79. package/dist/src/shared/worker-client/typings/worker-client-options.interface.d.ts +7 -0
  80. package/dist/src/shared/worker-daemon/classes/worker-daemon.class.d.ts +6 -0
  81. package/dist/src/shared/worker-daemon/functions/create-ipc-server.function.d.ts +11 -11
  82. package/dist/src/shared/worker-daemon/functions/embed-after-learn.function.d.ts +13 -0
  83. package/dist/src/shared/worker-daemon/functions/handle-hybrid-search.function.d.ts +44 -0
  84. package/dist/src/shared/worker-daemon/functions/handle-import.function.d.ts +14 -0
  85. package/dist/src/shared/worker-daemon/functions/handle-read-ops.function.d.ts +7 -1
  86. package/dist/src/shared/worker-daemon/functions/handle-write-ops.function.d.ts +9 -4
  87. package/dist/src/shared/worker-daemon/functions/run-worker.function.d.ts +6 -1
  88. package/dist/src/shared/worker-daemon/typings/handler-context.interface.d.ts +3 -0
  89. package/dist/src/shared/worker-daemon/typings/wasm-modules.interface.d.ts +5 -0
  90. package/dist/wasm/default-embedding/kbdb_default_embedding.d.ts +55 -0
  91. package/dist/wasm/default-embedding/kbdb_default_embedding.js +156 -0
  92. package/{src/wasm/query-parser/kbdb_query_parser_bg.wasm → dist/wasm/default-embedding/kbdb_default_embedding_bg.wasm} +0 -0
  93. package/dist/wasm/default-embedding/kbdb_default_embedding_bg.wasm.d.ts +12 -0
  94. package/dist/wasm/default-embedding/package.json +13 -0
  95. package/dist/wasm/fs-database/kbdb_fs_database.d.ts +16 -85
  96. package/dist/wasm/fs-database/kbdb_fs_database.js +16 -85
  97. package/dist/wasm/fs-database/kbdb_fs_database_bg.wasm +0 -0
  98. package/dist/wasm/fs-migration/kbdb_fs_migration.d.ts +38 -0
  99. package/dist/wasm/fs-migration/kbdb_fs_migration.js +130 -0
  100. package/dist/wasm/fs-migration/kbdb_fs_migration_bg.wasm +0 -0
  101. package/dist/wasm/fs-migration/kbdb_fs_migration_bg.wasm.d.ts +9 -0
  102. package/dist/wasm/fs-migration/package.json +13 -0
  103. package/dist/wasm/kb-worker/kbdb_worker.d.ts +20 -115
  104. package/dist/wasm/kb-worker/kbdb_worker.js +20 -115
  105. package/dist/wasm/kb-worker/kbdb_worker_bg.wasm +0 -0
  106. package/dist/wasm/query-parser/kbdb_query_parser_bg.wasm +0 -0
  107. package/dist/worker.d.ts +8 -0
  108. package/dist/worker.mjs +899 -143
  109. package/dist/worker.mjs.map +4 -4
  110. package/docs/details/README.md +4 -0
  111. package/docs/details/agent-tooling.md +132 -0
  112. package/docs/details/cli.md +91 -18
  113. package/docs/details/knowledge-base.md +180 -0
  114. package/docs/details/library-api.md +42 -2
  115. package/docs/details/mcp-server.md +53 -7
  116. package/docs/details/search-and-ranking.md +16 -11
  117. package/docs/goals/cli.md +142 -37
  118. package/docs/goals/content-parser.md +1 -1
  119. package/docs/goals/hybrid-search.md +71 -42
  120. package/docs/goals/mcp.md +24 -19
  121. package/docs/goals/overview.md +1 -1
  122. package/docs/goals/query-parser.md +8 -0
  123. package/docs/goals/semantic-dedup.md +7 -3
  124. package/docs/goals/worker-client.md +62 -1
  125. package/docs/goals/worker-daemon.md +83 -30
  126. package/docs/modules/overview.md +43 -22
  127. package/docs/modules/rust/embedding/module.md +91 -0
  128. package/docs/modules/rust/overview.md +56 -21
  129. package/docs/modules/rust/query-parser/functions/module.md +7 -5
  130. package/docs/modules/rust/query-parser/functions/pipeline.md +6 -138
  131. package/docs/modules/rust/query-parser/module.md +16 -22
  132. package/docs/modules/rust/query-parser/types/module.md +5 -4
  133. package/docs/modules/rust/query-parser/types/token.md +5 -1
  134. package/docs/modules/rust/shared/content-parser/functions.md +1 -1
  135. package/docs/modules/rust/shared/memory/module.md +1 -1
  136. package/docs/modules/rust/shared/module.md +33 -5
  137. package/docs/modules/rust/shared/pipeline/functions.md +141 -0
  138. package/docs/modules/rust/shared/pipeline/module.md +62 -0
  139. package/docs/modules/rust/shared/pipeline/types.md +43 -0
  140. package/docs/modules/rust/shared/section/module.md +1 -1
  141. package/docs/modules/rust/shared/section/types.md +1 -1
  142. package/docs/modules/typescript/cli.md +5 -3
  143. package/docs/modules/typescript/kbdb-worker.md +20 -5
  144. package/docs/modules/typescript/overview.md +28 -6
  145. package/docs/modules/typescript/shared/cli/functions.md +131 -17
  146. package/docs/modules/typescript/shared/cli/module.md +33 -20
  147. package/docs/modules/typescript/shared/cli/typings.md +25 -0
  148. package/docs/modules/typescript/shared/embedding/functions.md +125 -19
  149. package/docs/modules/typescript/shared/embedding/module.md +10 -4
  150. package/docs/modules/typescript/shared/embedding/typings.md +7 -5
  151. package/docs/modules/typescript/shared/log/constants.md +82 -0
  152. package/docs/modules/typescript/shared/log/functions.md +131 -0
  153. package/docs/modules/typescript/shared/log/module.md +153 -0
  154. package/docs/modules/typescript/shared/log/typings.md +82 -0
  155. package/docs/modules/typescript/shared/mcp/module.md +1 -1
  156. package/docs/modules/typescript/shared/mcp/typings.md +8 -1
  157. package/docs/modules/typescript/shared/module.md +22 -6
  158. package/docs/modules/typescript/shared/worker-client/module.md +9 -1
  159. package/docs/modules/typescript/shared/worker-client/typings.md +3 -0
  160. package/docs/modules/typescript/shared/worker-daemon/functions.md +19 -6
  161. package/docs/modules/typescript/shared/worker-daemon/module.md +11 -5
  162. package/docs/modules/typescript/shared/worker-daemon/typings.md +13 -7
  163. package/docs/overview.md +1 -2
  164. package/docs/release-notes/0.4.0.md +80 -0
  165. package/docs/release-notes/0.4.1.md +149 -0
  166. package/docs/release-notes/README.md +1 -0
  167. package/mod.ts +33 -15
  168. package/package.json +12 -11
  169. package/dist/chunk-JG2UCKLI.mjs +0 -95
  170. package/dist/chunk-JG2UCKLI.mjs.map +0 -7
  171. package/src/cli.ts +0 -71
  172. package/src/shared/auto-capture/classes/auto-capture-controller.class.ts +0 -62
  173. package/src/shared/auto-capture/constants/auto-capture-defaults.constant.ts +0 -15
  174. package/src/shared/auto-capture/functions/build-capture-prompt.function.ts +0 -27
  175. package/src/shared/auto-capture/functions/evaluate-trigger.function.ts +0 -50
  176. package/src/shared/auto-capture/index.ts +0 -7
  177. package/src/shared/auto-capture/typings/auto-capture-config.interface.ts +0 -13
  178. package/src/shared/auto-capture/typings/auto-capture-state.interface.ts +0 -13
  179. package/src/shared/auto-capture/typings/auto-capture-trigger.interface.ts +0 -7
  180. package/src/shared/cli/constants/defaults.constant.ts +0 -19
  181. package/src/shared/cli/constants/global-help.constant.ts +0 -73
  182. package/src/shared/cli/constants/help-text.constant.ts +0 -4
  183. package/src/shared/cli/constants/leaf-help.constant.ts +0 -219
  184. package/src/shared/cli/constants/memory-protocol-body.constant.ts +0 -39
  185. package/src/shared/cli/constants/query-guidance-body.constant.ts +0 -37
  186. package/src/shared/cli/constants/subcommand-help.constant.ts +0 -195
  187. package/src/shared/cli/functions/collect-files.function.ts +0 -55
  188. package/src/shared/cli/functions/compute-section-kbid.function.ts +0 -49
  189. package/src/shared/cli/functions/dispatch-command.function.ts +0 -390
  190. package/src/shared/cli/functions/ensure-db.function.ts +0 -21
  191. package/src/shared/cli/functions/error-to-message.function.ts +0 -9
  192. package/src/shared/cli/functions/find-db.function.ts +0 -20
  193. package/src/shared/cli/functions/format-mcp-output.function.ts +0 -41
  194. package/src/shared/cli/functions/format-output.function.ts +0 -95
  195. package/src/shared/cli/functions/format-text-output.function.ts +0 -42
  196. package/src/shared/cli/functions/generate-group-help.function.ts +0 -41
  197. package/src/shared/cli/functions/generate-help.function.ts +0 -654
  198. package/src/shared/cli/functions/handle-data-command.function.ts +0 -67
  199. package/src/shared/cli/functions/handle-mcp.function.ts +0 -56
  200. package/src/shared/cli/functions/handle-migrate.function.ts +0 -64
  201. package/src/shared/cli/functions/hydrate-search-previews.function.ts +0 -29
  202. package/src/shared/cli/functions/install-default-skills.function.ts +0 -296
  203. package/src/shared/cli/functions/is-stdin-tty.function.ts +0 -12
  204. package/src/shared/cli/functions/parse-args.function.ts +0 -156
  205. package/src/shared/cli/functions/prompt-user.function.ts +0 -36
  206. package/src/shared/cli/functions/resolve-skill-names.function.ts +0 -43
  207. package/src/shared/cli/functions/run-agent-create.function.ts +0 -114
  208. package/src/shared/cli/functions/run-agent-delete.function.ts +0 -47
  209. package/src/shared/cli/functions/run-agent-get.function.ts +0 -166
  210. package/src/shared/cli/functions/run-agent-list.function.ts +0 -58
  211. package/src/shared/cli/functions/run-check.function.ts +0 -159
  212. package/src/shared/cli/functions/run-cli.function.ts +0 -299
  213. package/src/shared/cli/functions/run-content.function.ts +0 -47
  214. package/src/shared/cli/functions/run-db-init.function.ts +0 -44
  215. package/src/shared/cli/functions/run-db-migrate.function.ts +0 -40
  216. package/src/shared/cli/functions/run-export.function.ts +0 -40
  217. package/src/shared/cli/functions/run-gc.function.ts +0 -51
  218. package/src/shared/cli/functions/run-init.function.ts +0 -93
  219. package/src/shared/cli/functions/run-learn.function.ts +0 -223
  220. package/src/shared/cli/functions/run-migrate.function.ts +0 -85
  221. package/src/shared/cli/functions/run-rebuild.function.ts +0 -47
  222. package/src/shared/cli/functions/run-recall.function.ts +0 -66
  223. package/src/shared/cli/functions/run-search.function.ts +0 -133
  224. package/src/shared/cli/functions/run-skill-delete.function.ts +0 -47
  225. package/src/shared/cli/functions/run-skill-get.function.ts +0 -90
  226. package/src/shared/cli/functions/run-skill-learn.function.ts +0 -70
  227. package/src/shared/cli/functions/run-skill-list.function.ts +0 -74
  228. package/src/shared/cli/functions/run-status.function.ts +0 -29
  229. package/src/shared/cli/functions/run-unlearn.function.ts +0 -58
  230. package/src/shared/cli/functions/version-gate.function.ts +0 -44
  231. package/src/shared/cli/functions/wrap-command.function.ts +0 -34
  232. package/src/shared/cli/index.ts +0 -55
  233. package/src/shared/cli/typings/agent-create-client.interface.ts +0 -47
  234. package/src/shared/cli/typings/agent-get-client.interface.ts +0 -39
  235. package/src/shared/cli/typings/check-client.interface.ts +0 -66
  236. package/src/shared/cli/typings/cli-deps.interface.ts +0 -54
  237. package/src/shared/cli/typings/cli-options.interface.ts +0 -72
  238. package/src/shared/cli/typings/command-result.model.ts +0 -15
  239. package/src/shared/cli/typings/disconnectable-client.interface.ts +0 -29
  240. package/src/shared/cli/typings/dispatch-client.type.ts +0 -46
  241. package/src/shared/cli/typings/learn-client.interface.ts +0 -53
  242. package/src/shared/cli/typings/learn-io.interface.ts +0 -5
  243. package/src/shared/cli/typings/learn-result.model.ts +0 -27
  244. package/src/shared/cli/typings/search-client.interface.ts +0 -73
  245. package/src/shared/cli/typings/search-display.model.ts +0 -54
  246. package/src/shared/dir-resolver/functions/join-path.function.ts +0 -13
  247. package/src/shared/dir-resolver/functions/resolve-base-dir.function.ts +0 -25
  248. package/src/shared/dir-resolver/functions/resolve-wasm-dir.function.ts +0 -5
  249. package/src/shared/dir-resolver/functions/resolve-worker-script.function.ts +0 -13
  250. package/src/shared/dir-resolver/index.ts +0 -11
  251. package/src/shared/dir-resolver/typings/base-dir.interface.ts +0 -4
  252. package/src/shared/embedding/classes/null-embedding-provider.class.ts +0 -29
  253. package/src/shared/embedding/constants/near-duplicate-thresholds.constant.ts +0 -17
  254. package/src/shared/embedding/functions/build-vector-index.function.ts +0 -79
  255. package/src/shared/embedding/functions/cosine-similarity.function.ts +0 -31
  256. package/src/shared/embedding/functions/detect-near-duplicates.function.ts +0 -69
  257. package/src/shared/embedding/functions/jaccard-coefficient.function.ts +0 -26
  258. package/src/shared/embedding/functions/read-vector-index-meta.function.ts +0 -44
  259. package/src/shared/embedding/functions/rrf-fuse.function.ts +0 -33
  260. package/src/shared/embedding/functions/search-vectors.function.ts +0 -59
  261. package/src/shared/embedding/index.ts +0 -20
  262. package/src/shared/embedding/typings/embedding-config.interface.ts +0 -23
  263. package/src/shared/embedding/typings/embedding-provider.interface.ts +0 -25
  264. package/src/shared/embedding/typings/near-duplicate-candidate.model.ts +0 -25
  265. package/src/shared/embedding/typings/near-duplicate-result.model.ts +0 -26
  266. package/src/shared/embedding/typings/vector-index-entry.model.ts +0 -13
  267. package/src/shared/embedding/typings/vector-index-meta.model.ts +0 -14
  268. package/src/shared/embedding/typings/vector-search-result.model.ts +0 -8
  269. package/src/shared/hash/functions/compute-sha256.ts +0 -17
  270. package/src/shared/hash/index.ts +0 -1
  271. package/src/shared/mcp/classes/mcp-server.class.ts +0 -480
  272. package/src/shared/mcp/constants/mcp-error-codes.constant.ts +0 -30
  273. package/src/shared/mcp/constants/tool-agent-create.constant.ts +0 -39
  274. package/src/shared/mcp/constants/tool-agent-delete.constant.ts +0 -26
  275. package/src/shared/mcp/constants/tool-agent-get.constant.ts +0 -24
  276. package/src/shared/mcp/constants/tool-agent-list.constant.ts +0 -18
  277. package/src/shared/mcp/constants/tool-auto-capture-review.constant.ts +0 -32
  278. package/src/shared/mcp/constants/tool-check.constant.ts +0 -21
  279. package/src/shared/mcp/constants/tool-content.constant.ts +0 -29
  280. package/src/shared/mcp/constants/tool-export.constant.ts +0 -27
  281. package/src/shared/mcp/constants/tool-gc.constant.ts +0 -21
  282. package/src/shared/mcp/constants/tool-learn.constant.ts +0 -58
  283. package/src/shared/mcp/constants/tool-rebuild.constant.ts +0 -21
  284. package/src/shared/mcp/constants/tool-recall.constant.ts +0 -36
  285. package/src/shared/mcp/constants/tool-retrieve.constant.ts +0 -31
  286. package/src/shared/mcp/constants/tool-search.constant.ts +0 -51
  287. package/src/shared/mcp/constants/tool-skill-delete.constant.ts +0 -24
  288. package/src/shared/mcp/constants/tool-skill-get.constant.ts +0 -27
  289. package/src/shared/mcp/constants/tool-skill-learn.constant.ts +0 -37
  290. package/src/shared/mcp/constants/tool-skill-list.constant.ts +0 -18
  291. package/src/shared/mcp/constants/tool-status.constant.ts +0 -20
  292. package/src/shared/mcp/constants/tool-unlearn.constant.ts +0 -25
  293. package/src/shared/mcp/functions/as-boolean-or-undefined.function.ts +0 -11
  294. package/src/shared/mcp/functions/as-string-array-or-undefined.function.ts +0 -17
  295. package/src/shared/mcp/functions/as-string-array.function.ts +0 -15
  296. package/src/shared/mcp/functions/as-string.function.ts +0 -10
  297. package/src/shared/mcp/functions/build-skills-text.function.ts +0 -43
  298. package/src/shared/mcp/functions/create-mcp-server.function.ts +0 -14
  299. package/src/shared/mcp/functions/create-prompt-definitions.function.ts +0 -102
  300. package/src/shared/mcp/functions/create-resource-templates.function.ts +0 -23
  301. package/src/shared/mcp/functions/create-tool-definitions.function.ts +0 -530
  302. package/src/shared/mcp/functions/extract-skill-arguments.function.ts +0 -27
  303. package/src/shared/mcp/functions/handle-agent-create.function.ts +0 -116
  304. package/src/shared/mcp/functions/handle-agent-delete.function.ts +0 -50
  305. package/src/shared/mcp/functions/handle-agent-get.function.ts +0 -160
  306. package/src/shared/mcp/functions/handle-agent-list.function.ts +0 -50
  307. package/src/shared/mcp/functions/handle-agent-prompt.function.ts +0 -68
  308. package/src/shared/mcp/functions/handle-completion.function.ts +0 -114
  309. package/src/shared/mcp/functions/handle-mcp-request.function.ts +0 -202
  310. package/src/shared/mcp/functions/handle-prompt-get.function.ts +0 -220
  311. package/src/shared/mcp/functions/handle-recall.function.ts +0 -66
  312. package/src/shared/mcp/functions/handle-resource-read.function.ts +0 -56
  313. package/src/shared/mcp/functions/handle-roots-list.function.ts +0 -29
  314. package/src/shared/mcp/functions/handle-skill-prompt.function.ts +0 -44
  315. package/src/shared/mcp/functions/handle-tool-auto-capture-review.function.ts +0 -24
  316. package/src/shared/mcp/functions/handle-tool-call.function.ts +0 -560
  317. package/src/shared/mcp/functions/handle-tool-check.function.ts +0 -21
  318. package/src/shared/mcp/functions/handle-tool-content.function.ts +0 -23
  319. package/src/shared/mcp/functions/handle-tool-export.function.ts +0 -25
  320. package/src/shared/mcp/functions/handle-tool-gc.function.ts +0 -21
  321. package/src/shared/mcp/functions/handle-tool-learn.function.ts +0 -69
  322. package/src/shared/mcp/functions/handle-tool-rebuild.function.ts +0 -21
  323. package/src/shared/mcp/functions/handle-tool-retrieve.function.ts +0 -40
  324. package/src/shared/mcp/functions/handle-tool-search.function.ts +0 -47
  325. package/src/shared/mcp/functions/handle-tool-skill-delete.function.ts +0 -34
  326. package/src/shared/mcp/functions/handle-tool-skill-get.function.ts +0 -59
  327. package/src/shared/mcp/functions/handle-tool-skill-learn.function.ts +0 -61
  328. package/src/shared/mcp/functions/handle-tool-skill-list.function.ts +0 -39
  329. package/src/shared/mcp/functions/handle-tool-status.function.ts +0 -21
  330. package/src/shared/mcp/functions/handle-tool-unlearn.function.ts +0 -24
  331. package/src/shared/mcp/functions/parse-agent-meta.function.ts +0 -27
  332. package/src/shared/mcp/functions/parse-skill-arguments.function.ts +0 -36
  333. package/src/shared/mcp/functions/parse-skill-content.function.ts +0 -38
  334. package/src/shared/mcp/functions/read-agent-meta.function.ts +0 -41
  335. package/src/shared/mcp/functions/resolve-skill-refs.function.ts +0 -50
  336. package/src/shared/mcp/functions/run-startup-health-check.function.ts +0 -34
  337. package/src/shared/mcp/functions/serialize-skill-content.function.ts +0 -12
  338. package/src/shared/mcp/functions/should-emit-log.function.ts +0 -38
  339. package/src/shared/mcp/index.ts +0 -28
  340. package/src/shared/mcp/typings/agent-types.interface.ts +0 -39
  341. package/src/shared/mcp/typings/log-types.interface.ts +0 -26
  342. package/src/shared/mcp/typings/mcp-capabilities.interface.ts +0 -16
  343. package/src/shared/mcp/typings/mcp-client.interface.ts +0 -317
  344. package/src/shared/mcp/typings/mcp-completion.interface.ts +0 -45
  345. package/src/shared/mcp/typings/mcp-content-result.model.ts +0 -9
  346. package/src/shared/mcp/typings/mcp-export-result.model.ts +0 -11
  347. package/src/shared/mcp/typings/mcp-gc-result.model.ts +0 -15
  348. package/src/shared/mcp/typings/mcp-integrity-check-result.model.ts +0 -17
  349. package/src/shared/mcp/typings/mcp-integrity-error.model.ts +0 -15
  350. package/src/shared/mcp/typings/mcp-notification.interface.ts +0 -9
  351. package/src/shared/mcp/typings/mcp-rebuild-result.model.ts +0 -9
  352. package/src/shared/mcp/typings/mcp-request.interface.ts +0 -11
  353. package/src/shared/mcp/typings/mcp-resource-result.interface.ts +0 -12
  354. package/src/shared/mcp/typings/mcp-resource-template.interface.ts +0 -11
  355. package/src/shared/mcp/typings/mcp-response.interface.ts +0 -18
  356. package/src/shared/mcp/typings/mcp-server-info.interface.ts +0 -7
  357. package/src/shared/mcp/typings/mcp-server-state.interface.ts +0 -17
  358. package/src/shared/mcp/typings/mcp-tool-annotations.interface.ts +0 -32
  359. package/src/shared/mcp/typings/mcp-tool-definition.interface.ts +0 -16
  360. package/src/shared/mcp/typings/mcp-tool-result.interface.ts +0 -19
  361. package/src/shared/mcp/typings/mcp-types.interface.ts +0 -158
  362. package/src/shared/mcp/typings/mcp-worker-client.interface.ts +0 -243
  363. package/src/shared/mcp/typings/prompt-types.interface.ts +0 -39
  364. package/src/shared/mcp/typings/remove-section-result.model.ts +0 -10
  365. package/src/shared/mcp/typings/sampling-types.interface.ts +0 -48
  366. package/src/shared/mcp/typings/skill-types.interface.ts +0 -29
  367. package/src/shared/mcp/typings/tool-call-result.model.ts +0 -18
  368. package/src/shared/mod.ts +0 -1
  369. package/src/shared/platform/functions/get-ipc-path.function.ts +0 -19
  370. package/src/shared/platform/functions/get-tmpdir.function.ts +0 -8
  371. package/src/shared/platform/functions/is-process-alive.function.ts +0 -17
  372. package/src/shared/platform/index.ts +0 -3
  373. package/src/shared/runtime/functions/detect-runtime.ts +0 -14
  374. package/src/shared/runtime/functions/get-args.ts +0 -16
  375. package/src/shared/runtime/index.ts +0 -3
  376. package/src/shared/runtime/typings/runtime.ts +0 -2
  377. package/src/shared/sync/functions/build-import-report.function.ts +0 -40
  378. package/src/shared/sync/functions/parse-export-entry.function.ts +0 -45
  379. package/src/shared/sync/functions/resolve-conflict.function.ts +0 -31
  380. package/src/shared/sync/functions/serialize-export-entry.function.ts +0 -18
  381. package/src/shared/sync/index.ts +0 -9
  382. package/src/shared/sync/typings/conflict-resolution.type.ts +0 -8
  383. package/src/shared/sync/typings/export-entry.interface.ts +0 -13
  384. package/src/shared/sync/typings/export-options.interface.ts +0 -9
  385. package/src/shared/sync/typings/import-options.interface.ts +0 -7
  386. package/src/shared/sync/typings/import-report.interface.ts +0 -15
  387. package/src/shared/version/constants/version.constant.ts +0 -2
  388. package/src/shared/version/index.ts +0 -1
  389. package/src/shared/wasm-codec/functions/decode-add-section-result.function.ts +0 -112
  390. package/src/shared/wasm-codec/functions/decode-compose-output.function.ts +0 -16
  391. package/src/shared/wasm-codec/functions/decode-document-manifest-list.function.ts +0 -70
  392. package/src/shared/wasm-codec/functions/decode-document-manifest.function.ts +0 -87
  393. package/src/shared/wasm-codec/functions/decode-f32.function.ts +0 -16
  394. package/src/shared/wasm-codec/functions/decode-key-value-text.function.ts +0 -15
  395. package/src/shared/wasm-codec/functions/decode-one-recall-result.function.ts +0 -86
  396. package/src/shared/wasm-codec/functions/decode-option-string.function.ts +0 -24
  397. package/src/shared/wasm-codec/functions/decode-recall-document.function.ts +0 -59
  398. package/src/shared/wasm-codec/functions/decode-recall-reference.function.ts +0 -52
  399. package/src/shared/wasm-codec/functions/decode-recall-result.function.ts +0 -267
  400. package/src/shared/wasm-codec/functions/decode-recall-sibling.function.ts +0 -43
  401. package/src/shared/wasm-codec/functions/decode-remove-flag.function.ts +0 -3
  402. package/src/shared/wasm-codec/functions/decode-scored-results.function.ts +0 -194
  403. package/src/shared/wasm-codec/functions/decode-section-match.function.ts +0 -80
  404. package/src/shared/wasm-codec/functions/decode-section-record-list.function.ts +0 -20
  405. package/src/shared/wasm-codec/functions/decode-section-record-trailing.function.ts +0 -75
  406. package/src/shared/wasm-codec/functions/decode-section-record.function.ts +0 -85
  407. package/src/shared/wasm-codec/functions/decode-section-records.function.ts +0 -249
  408. package/src/shared/wasm-codec/functions/decode-section-type.function.ts +0 -30
  409. package/src/shared/wasm-codec/functions/decode-string.function.ts +0 -22
  410. package/src/shared/wasm-codec/functions/decode-u32.function.ts +0 -16
  411. package/src/shared/wasm-codec/functions/decode-u64.function.ts +0 -16
  412. package/src/shared/wasm-codec/functions/decode-wasm-list.function.ts +0 -31
  413. package/src/shared/wasm-codec/functions/encode-add-section-params.function.ts +0 -102
  414. package/src/shared/wasm-codec/functions/encode-group-params.function.ts +0 -28
  415. package/src/shared/wasm-codec/functions/encode-identifier-list.function.ts +0 -17
  416. package/src/shared/wasm-codec/functions/encode-kbid-list.function.ts +0 -17
  417. package/src/shared/wasm-codec/functions/encode-option-string.function.ts +0 -14
  418. package/src/shared/wasm-codec/functions/encode-recall-params.function.ts +0 -68
  419. package/src/shared/wasm-codec/functions/encode-search-params.function.ts +0 -12
  420. package/src/shared/wasm-codec/functions/encode-section-type.function.ts +0 -18
  421. package/src/shared/wasm-codec/functions/encode-string.function.ts +0 -9
  422. package/src/shared/wasm-codec/functions/encode-type-filter-param.function.ts +0 -13
  423. package/src/shared/wasm-codec/functions/encode-u32.function.ts +0 -5
  424. package/src/shared/wasm-codec/functions/encode-update-section-params.function.ts +0 -16
  425. package/src/shared/wasm-codec/index.ts +0 -49
  426. package/src/shared/wasm-codec/typings/add-section-input.model.ts +0 -45
  427. package/src/shared/wasm-codec/typings/add-section-result.model.ts +0 -28
  428. package/src/shared/wasm-codec/typings/document-manifest.model.ts +0 -20
  429. package/src/shared/wasm-codec/typings/document-section.model.ts +0 -12
  430. package/src/shared/wasm-codec/typings/item-decoder.type.ts +0 -10
  431. package/src/shared/wasm-codec/typings/near-duplicate.model.ts +0 -16
  432. package/src/shared/wasm-codec/typings/paged-search-result.model.ts +0 -22
  433. package/src/shared/wasm-codec/typings/section-match.model.ts +0 -31
  434. package/src/shared/wasm-codec/typings/section-record-trailing.model.ts +0 -38
  435. package/src/shared/wasm-codec/typings/section-record.model.ts +0 -66
  436. package/src/shared/wasm-codec/typings/section-type-result.model.ts +0 -12
  437. package/src/shared/worker-client/classes/worker-client.class.ts +0 -466
  438. package/src/shared/worker-client/functions/compute-context-id.function.ts +0 -18
  439. package/src/shared/worker-client/functions/create-worker-client.function.ts +0 -70
  440. package/src/shared/worker-client/functions/discover-daemon.function.ts +0 -47
  441. package/src/shared/worker-client/functions/handle-ipc-data.function.ts +0 -49
  442. package/src/shared/worker-client/functions/resolve-db-path.function.ts +0 -21
  443. package/src/shared/worker-client/functions/send-ipc-request.function.ts +0 -39
  444. package/src/shared/worker-client/functions/spawn-daemon.function.ts +0 -35
  445. package/src/shared/worker-client/functions/wait-for-daemon.function.ts +0 -34
  446. package/src/shared/worker-client/index.ts +0 -44
  447. package/src/shared/worker-client/typings/add-section-result.model.ts +0 -39
  448. package/src/shared/worker-client/typings/content-result.model.ts +0 -12
  449. package/src/shared/worker-client/typings/daemon-info.model.ts +0 -7
  450. package/src/shared/worker-client/typings/export-result.model.ts +0 -14
  451. package/src/shared/worker-client/typings/gc-result.model.ts +0 -18
  452. package/src/shared/worker-client/typings/integrity-check-result.model.ts +0 -43
  453. package/src/shared/worker-client/typings/json-rpc-response.interface.ts +0 -17
  454. package/src/shared/worker-client/typings/migrate-result.model.ts +0 -11
  455. package/src/shared/worker-client/typings/pending-call.interface.ts +0 -7
  456. package/src/shared/worker-client/typings/rebuild-result.model.ts +0 -12
  457. package/src/shared/worker-client/typings/recall-document.model.ts +0 -16
  458. package/src/shared/worker-client/typings/recall-params.model.ts +0 -15
  459. package/src/shared/worker-client/typings/recall-reference.model.ts +0 -32
  460. package/src/shared/worker-client/typings/recall-result.model.ts +0 -98
  461. package/src/shared/worker-client/typings/recall-sibling.model.ts +0 -11
  462. package/src/shared/worker-client/typings/recall-single-result.model.ts +0 -41
  463. package/src/shared/worker-client/typings/remove-section-result.model.ts +0 -7
  464. package/src/shared/worker-client/typings/search-params.model.ts +0 -14
  465. package/src/shared/worker-client/typings/search-result.model.ts +0 -43
  466. package/src/shared/worker-client/typings/section.model.ts +0 -43
  467. package/src/shared/worker-client/typings/status-result.model.ts +0 -14
  468. package/src/shared/worker-client/typings/version-status.model.ts +0 -28
  469. package/src/shared/worker-client/typings/worker-client-error.interface.ts +0 -8
  470. package/src/shared/worker-client/typings/worker-client-options.interface.ts +0 -30
  471. package/src/shared/worker-daemon/classes/ipc-error.class.ts +0 -22
  472. package/src/shared/worker-daemon/classes/worker-daemon.class.ts +0 -1291
  473. package/src/shared/worker-daemon/constants/daemon-defaults.constant.ts +0 -29
  474. package/src/shared/worker-daemon/constants/wasm-method-map.constant.ts +0 -69
  475. package/src/shared/worker-daemon/functions/build-ipc-error-response.function.ts +0 -16
  476. package/src/shared/worker-daemon/functions/check-catalog-version.function.ts +0 -54
  477. package/src/shared/worker-daemon/functions/check-preconditions.function.ts +0 -28
  478. package/src/shared/worker-daemon/functions/create-host-imports.function.ts +0 -328
  479. package/src/shared/worker-daemon/functions/create-ipc-server.function.ts +0 -87
  480. package/src/shared/worker-daemon/functions/detect-stale-pid.function.ts +0 -33
  481. package/src/shared/worker-daemon/functions/dispatch-request.function.ts +0 -190
  482. package/src/shared/worker-daemon/functions/handle-check-version.function.ts +0 -74
  483. package/src/shared/worker-daemon/functions/handle-config-method.function.ts +0 -27
  484. package/src/shared/worker-daemon/functions/handle-read-ops.function.ts +0 -236
  485. package/src/shared/worker-daemon/functions/handle-write-ops.function.ts +0 -257
  486. package/src/shared/worker-daemon/functions/load-wasm-modules.function.ts +0 -95
  487. package/src/shared/worker-daemon/functions/parse-auto-capture-section.function.ts +0 -51
  488. package/src/shared/worker-daemon/functions/parse-catalog-version.function.ts +0 -20
  489. package/src/shared/worker-daemon/functions/parse-embedding-section.function.ts +0 -38
  490. package/src/shared/worker-daemon/functions/parse-worker-toml.function.ts +0 -104
  491. package/src/shared/worker-daemon/functions/read-config.function.ts +0 -83
  492. package/src/shared/worker-daemon/functions/run-startup-integrity-check.function.ts +0 -55
  493. package/src/shared/worker-daemon/functions/run-worker.function.ts +0 -57
  494. package/src/shared/worker-daemon/functions/scan-near-duplicates.function.ts +0 -92
  495. package/src/shared/worker-daemon/functions/start-daemon.function.ts +0 -74
  496. package/src/shared/worker-daemon/functions/wasm-bridge.function.ts +0 -144
  497. package/src/shared/worker-daemon/functions/wasm-memory-helpers.function.ts +0 -41
  498. package/src/shared/worker-daemon/functions/write-lock.function.ts +0 -49
  499. package/src/shared/worker-daemon/index.ts +0 -16
  500. package/src/shared/worker-daemon/typings/allocator-ref.interface.ts +0 -16
  501. package/src/shared/worker-daemon/typings/daemon-config.interface.ts +0 -20
  502. package/src/shared/worker-daemon/typings/fs-adapter.interface.ts +0 -22
  503. package/src/shared/worker-daemon/typings/handler-context.interface.ts +0 -19
  504. package/src/shared/worker-daemon/typings/ipc-handler.interface.ts +0 -39
  505. package/src/shared/worker-daemon/typings/memory-ref.interface.ts +0 -13
  506. package/src/shared/worker-daemon/typings/wasm-fn.type.ts +0 -2
  507. package/src/shared/worker-daemon/typings/wasm-modules.interface.ts +0 -7
  508. package/src/shared/worker-daemon/typings/write-lock.interface.ts +0 -13
  509. package/src/wasm/fs-database/kbdb_fs_database.d.ts +0 -259
  510. package/src/wasm/fs-database/kbdb_fs_database.js +0 -515
  511. package/src/wasm/fs-database/kbdb_fs_database_bg.wasm +0 -0
  512. package/src/wasm/fs-database/kbdb_fs_database_bg.wasm.d.ts +0 -35
  513. package/src/wasm/fs-database/package.json +0 -13
  514. package/src/wasm/kb-worker/kbdb_worker.d.ts +0 -650
  515. package/src/wasm/kb-worker/kbdb_worker.js +0 -1181
  516. package/src/wasm/kb-worker/kbdb_worker_bg.wasm +0 -0
  517. package/src/wasm/kb-worker/kbdb_worker_bg.wasm.d.ts +0 -77
  518. package/src/wasm/kb-worker/package.json +0 -13
  519. package/src/wasm/query-parser/kbdb_query_parser.d.ts +0 -195
  520. package/src/wasm/query-parser/kbdb_query_parser.js +0 -403
  521. package/src/wasm/query-parser/kbdb_query_parser_bg.wasm.d.ts +0 -25
  522. package/src/wasm/query-parser/package.json +0 -13
  523. package/src/worker.ts +0 -42
@@ -1,650 +0,0 @@
1
- declare namespace wasm_bindgen {
2
- /* tslint:disable */
3
- /* eslint-disable */
4
-
5
- /**
6
- * Adds a section. `ptr`/`len` point to an encoded `AddSectionParams`.
7
- *
8
- * On success: writes an encoded `AddSectionResult` to the return slot and
9
- * returns 0. When `params.replace` is true and a section with the same
10
- * `source_key` exists, the superseded section's index entries are removed
11
- * and the returned `AddSectionResult.superseded` is set to its kbid.
12
- * On error: writes error message to return slot, returns -1.
13
- */
14
- export function db_add_section(ptr: number, len: number): number;
15
-
16
- /**
17
- * Adds a section's terms to the inverted and positional indexes.
18
- * `ptr`/`len` point to encoded
19
- * (kbid_str, term_count, [(term_str, pos_count, [positions], heading_tf, body_tf, code_tf)]).
20
- */
21
- export function db_add_to_index(ptr: number, len: number): number;
22
-
23
- /**
24
- * Checks database integrity. Returns 0 on success.
25
- * On success a summary string is placed in the return slot.
26
- */
27
- export function db_check_integrity(_ptr: number, _len: number): number;
28
-
29
- /**
30
- * Reads `catalog.toml` from the path at `ptr`/`len` and returns the version
31
- * status without modifying state.
32
- *
33
- * On success, the return slot contains 8 bytes:
34
- * - bytes 0-3: `catalog_version` as little-endian u32
35
- * - bytes 4-7: `required_version` (DB_FORMAT_VERSION) as little-endian u32
36
- *
37
- * Return value:
38
- * - 0: compatible (versions match)
39
- * - 1: needs migration (catalog version < required)
40
- * - 2: too new (catalog version > required)
41
- * - -1: I/O or parse error (message in return slot)
42
- *
43
- * Note: this export accepts a path directly and does NOT require `db_init`
44
- * to have been called first.
45
- */
46
- export function db_check_version(ptr: number, len: number): number;
47
-
48
- /**
49
- * Exports the database to a target directory.
50
- *
51
- * `ptr`/`len` point to a UTF-8 string containing the target path.
52
- *
53
- * Copies `sections/`, `documents/`, and `catalog.toml` to the target.
54
- * Indexes are not copied because they can be rebuilt from the data.
55
- *
56
- * The target path may be absolute or relative. It is an external output
57
- * destination, not a database-internal path, so no path validation is
58
- * applied to it.
59
- *
60
- * On success a summary string is placed in the return slot:
61
- * `path={target}\nsections_exported={N}\ndocuments_exported={M}`
62
- */
63
- export function db_export(ptr: number, len: number): number;
64
-
65
- /**
66
- * Runs garbage collection. Returns 0 on success.
67
- * On success a summary string is placed in the return slot.
68
- */
69
- export function db_gc(_ptr: number, _len: number): number;
70
-
71
- /**
72
- * Returns back-references pointing to a section.
73
- * `ptr`/`len` point to a UTF-8 kbid string.
74
- * On success encodes `u32 count` followed by entries (peer_id, marker_type,
75
- * context_snippet) into the return slot.
76
- */
77
- export function db_get_back_refs(ptr: number, len: number): number;
78
-
79
- /**
80
- * Returns forward references for a section.
81
- * `ptr`/`len` point to a UTF-8 kbid string.
82
- * On success encodes `u32 count` followed by entries (peer_id, marker_type,
83
- * context_snippet) into the return slot.
84
- */
85
- export function db_get_forward_refs(ptr: number, len: number): number;
86
-
87
- /**
88
- * Initialises the database context path.
89
- *
90
- * The JS host must call this before any other function.
91
- * `ptr`/`len` point to a UTF-8 context path string in WASM memory.
92
- */
93
- export function db_init(ptr: number, len: number): number;
94
-
95
- /**
96
- * Initialises a new empty catalog at the current context path.
97
- * Writes the default catalog to disk and returns 0 on success.
98
- */
99
- export function db_init_catalog(_ptr: number, _len: number): number;
100
-
101
- /**
102
- * Creates the full directory scaffold for a new database at `ptr`/`len` path.
103
- *
104
- * Creates directories, seeds `catalog.toml` (stamped with `DB_FORMAT_VERSION`),
105
- * empty index files, `worker.toml`, and `.gitignore`.
106
- *
107
- * Returns 0 on success. Returns -1 with an error message in the return slot
108
- * if the directory already exists or any I/O fails.
109
- *
110
- * Note: this export accepts a path directly and does NOT require `db_init`
111
- * to have been called first.
112
- */
113
- export function db_init_directory(ptr: number, len: number): number;
114
-
115
- /**
116
- * Lists all document manifests. No input parameters (`ptr`/`len` are ignored).
117
- *
118
- * On success encodes a `u32 count` followed by each `DocumentManifest` into
119
- * the return slot and returns 0. On error writes an error message and returns -1.
120
- */
121
- export function db_list_documents(_ptr: number, _len: number): number;
122
-
123
- /**
124
- * Lists all section records. No input parameters (`ptr`/`len` are ignored).
125
- *
126
- * On success encodes a `u32 count` followed by each `SectionRecord` into the
127
- * return slot and returns 0. On error writes an error message and returns -1.
128
- */
129
- export function db_list_sections(_ptr: number, _len: number): number;
130
-
131
- /**
132
- * Executes a query plan against the loaded indexes.
133
- * `ptr`/`len` point to an encoded `QueryPlan`.
134
- * On success writes encoded `Vec<RawMatch>` to the return slot.
135
- */
136
- export function db_query(ptr: number, len: number): number;
137
-
138
- /**
139
- * Reads the catalog. Returns 0 on success.
140
- * On success the serialised catalog TOML text is in the return slot.
141
- */
142
- export function db_read_catalog(_ptr: number, _len: number): number;
143
-
144
- /**
145
- * Reads corpus statistics from `<ctx>/corpus.bin`.
146
- * On success places encoded `CorpusStats` bytes in the return slot.
147
- */
148
- export function db_read_corpus_stats(_ptr: number, _len: number): number;
149
-
150
- /**
151
- * Reads a document manifest. `ptr`/`len` point to a UTF-8 docid string.
152
- */
153
- export function db_read_document(ptr: number, len: number): number;
154
-
155
- /**
156
- * Reads a section by kbid. `ptr`/`len` point to a UTF-8 kbid string.
157
- */
158
- export function db_read_section(ptr: number, len: number): number;
159
-
160
- /**
161
- * Reads multiple sections. `ptr`/`len` point to encoded `Vec<KbId>` (count + kbids).
162
- */
163
- export function db_read_sections(ptr: number, len: number): number;
164
-
165
- /**
166
- * Rebuilds indexes from scratch.
167
- *
168
- * Clears the existing inverted and positional indexes, then drives the
169
- * section-scan rebuild loop. Full per-field tokenization is handled by
170
- * `kb-worker.wasm` orchestration; this function provides the read-pass
171
- * scaffolding and the final index write.
172
- */
173
- export function db_rebuild_index(_ptr: number, _len: number): number;
174
-
175
- /**
176
- * Removes a document manifest. `ptr`/`len` point to a UTF-8 docid string.
177
- */
178
- export function db_remove_document(ptr: number, len: number): number;
179
-
180
- /**
181
- * Removes a section's entries from the indexes.
182
- * `ptr`/`len` point to a UTF-8 kbid string.
183
- */
184
- export function db_remove_from_index(ptr: number, len: number): number;
185
-
186
- /**
187
- * Removes a section by kbid. `ptr`/`len` point to a UTF-8 kbid string.
188
- */
189
- export function db_remove_section(ptr: number, len: number): number;
190
-
191
- /**
192
- * Updates a section. `ptr`/`len` point to encoded (old_kbid_str, AddSectionParams).
193
- */
194
- export function db_update_section(ptr: number, len: number): number;
195
-
196
- /**
197
- * Writes/updates the catalog. `ptr`/`len` point to encoded catalog TOML text.
198
- */
199
- export function db_write_catalog(ptr: number, len: number): number;
200
-
201
- /**
202
- * Writes corpus statistics to `<ctx>/corpus.bin`.
203
- * `ptr`/`len` point to 12 bytes of encoded `CorpusStats`.
204
- */
205
- export function db_write_corpus_stats(ptr: number, len: number): number;
206
-
207
- /**
208
- * Writes a document manifest. `ptr`/`len` point to an encoded `DocumentManifest`.
209
- */
210
- export function db_write_document(ptr: number, len: number): number;
211
-
212
- /**
213
- * Clear all entries from the query cache. Returns 1 always.
214
- */
215
- export function qp_cache_clear(): number;
216
-
217
- /**
218
- * Retrieve the bytes cached under the UTF-8 key at `(ptr, len)`.
219
- *
220
- * On hit: writes the bytes via `set_return` and returns 1.
221
- * On miss: calls `set_return(null, 0)` and returns 0.
222
- */
223
- export function qp_cache_get(ptr: number, len: number): number;
224
-
225
- /**
226
- * Cache the bytes at `(val_ptr, val_len)` under the UTF-8 key at
227
- * `(key_ptr, key_len)`. Returns 1 always.
228
- */
229
- export function qp_cache_insert(key_ptr: number, key_len: number, val_ptr: number, val_len: number): number;
230
-
231
- /**
232
- * Compute per-field TF values from raw field occurrence and token counts.
233
- *
234
- * The buffer at `(ptr, len)` contains:
235
- * - u32 heading_count, u32 body_count, u32 code_count
236
- * - u32 heading_tokens, u32 body_tokens, u32 code_tokens
237
- *
238
- * The result is 3 × f32 (heading_tf, body_tf, code_tf) written via
239
- * `set_return`. Returns 1 on success, 0 if buffer is too short.
240
- */
241
- export function qp_compute_field_tf(ptr: number, len: number): number;
242
-
243
- /**
244
- * Compute TF-IDF for a term.
245
- *
246
- * The buffer at `(ptr, len)` contains:
247
- * - u32 term_count (occurrences in document)
248
- * - u32 total_terms (all terms in document)
249
- * - u32 doc_freq (documents containing the term)
250
- * - u32 total_docs (documents in corpus)
251
- *
252
- * The result is a single f32 TF-IDF score written via `set_return`.
253
- * Returns 1 on success, 0 if the buffer is too short.
254
- */
255
- export function qp_compute_tfidf(ptr: number, len: number): number;
256
-
257
- /**
258
- * Extract keyphrases from the UTF-8 text at `(ptr, len)`.
259
- *
260
- * `n_top` — maximum number of keyphrases to return.
261
- *
262
- * Encodes result as:
263
- * - u32 count
264
- * - for each keyphrase: String phrase, f32 score
265
- *
266
- * Returns 1 on success, 0 on error.
267
- */
268
- export function qp_extract_keyphrases(ptr: number, len: number, n_top: number): number;
269
-
270
- /**
271
- * Extract bigrams and trigrams from the token stream of the text at
272
- * `(ptr, len)`.
273
- *
274
- * Encodes the result as:
275
- * - u32 bigram count, then each bigram as a String
276
- * - u32 trigram count, then each trigram as a String
277
- *
278
- * Returns 1 on success.
279
- */
280
- export function qp_extract_ngrams(ptr: number, len: number): number;
281
-
282
- /**
283
- * Parse the UTF-8 query string at `(ptr, len)` into a `QueryPlan`.
284
- *
285
- * The result is encoded using `QueryPlan`'s `Encode` implementation.
286
- * Returns 1 on success, 0 on parse error.
287
- */
288
- export function qp_parse_query(ptr: number, len: number): number;
289
-
290
- /**
291
- * Compute BM25F score for all matched terms in a `RawMatch`.
292
- *
293
- * The buffer at `(ptr, len)` contains an encoded `RawMatch` followed
294
- * immediately by an encoded `CorpusStats`. Default BM25F parameters are
295
- * used (k1=1.2, b=0.75, heading=2.0, body=1.0, code=1.5).
296
- *
297
- * The result is a single f32 written via `set_return`.
298
- * Returns 1 on success, 0 if the buffer cannot be decoded.
299
- */
300
- export function qp_score_bm25f(ptr: number, len: number): number;
301
-
302
- /**
303
- * Compute BM25F score for a single term/field using explicit document frequency.
304
- *
305
- * Parameters are passed as a packed binary buffer at `(ptr, len)`:
306
- * - f32 tf, u32 df, u32 total_docs, f32 avg_dl, f32 dl, f32 k1, f32 b
307
- *
308
- * The result is a single f32 written via `set_return`.
309
- * Returns 1 on success, 0 if the buffer is too short.
310
- */
311
- export function qp_score_bm25f_field(ptr: number, len: number): number;
312
-
313
- /**
314
- * Compute freshness weight.
315
- *
316
- * The buffer at `(ptr, len)` contains:
317
- * - u64 created_at (ms)
318
- * - u64 now (ms)
319
- * - u64 half_life_ms
320
- *
321
- * Returns 1 on success, 0 if buffer is too short.
322
- */
323
- export function qp_score_freshness(ptr: number, len: number): number;
324
-
325
- /**
326
- * Compute a proximity score.
327
- *
328
- * The buffer at `(ptr, len)` contains:
329
- * - u32 count of pairs
330
- * - count × (u32 pos_a, u32 pos_b)
331
- *
332
- * Returns 1 on success, 0 on error.
333
- */
334
- export function qp_score_proximity(ptr: number, len: number): number;
335
-
336
- /**
337
- * Apply zone weighting.
338
- *
339
- * The buffer at `(ptr, len)` contains:
340
- * - u8 is_heading (0/1)
341
- * - u8 is_first_para (0/1)
342
- * - f32 base_score
343
- *
344
- * Returns 1 on success, 0 if buffer is too short.
345
- */
346
- export function qp_score_zone(ptr: number, len: number): number;
347
-
348
- /**
349
- * Tokenise the UTF-8 text at `(ptr, len)`.
350
- *
351
- * Encodes the result as a length-prefixed list of `(original, stemmed,
352
- * position)` records using the shared binary encoding:
353
- * - u32 count
354
- * - for each token: String original, String stemmed, u32 position
355
- *
356
- * Returns 1 on success, 0 on error.
357
- */
358
- export function qp_tokenize(ptr: number, len: number): number;
359
-
360
- /**
361
- * Return the crate version string.
362
- */
363
- export function version(): string;
364
-
365
- /**
366
- * Adds a section. Returns 0 on success, -1 on error.
367
- *
368
- * On success the return slot holds the binary-encoded `AddSectionResult`
369
- * (kbid + indexed_terms_count + elapsed_ms + superseded + warnings +
370
- * near_duplicates) using the `Encode` trait wire format.
371
- */
372
- export function worker_add_section(ptr: number, len: number): number;
373
-
374
- /**
375
- * Runs a database integrity check.
376
- */
377
- export function worker_check_integrity(): number;
378
-
379
- /**
380
- * Composes a Markdown document from an ordered list of identifiers.
381
- *
382
- * The identifier list is encoded as `u32 count + String` entries in shared
383
- * memory at `(ptr, len)`. Each identifier is tried first as a kbid (section),
384
- * then as a docid (document). Missing identifiers are silently skipped.
385
- *
386
- * On success the composed markdown and total character count are encoded into
387
- * the return slot (String markdown + u64 total_chars), and 0 is returned.
388
- * On error -1 is returned and an error message is in the return slot.
389
- */
390
- export function worker_compose(ptr: number, len: number): number;
391
-
392
- /**
393
- * Exports the database to a target directory.
394
- *
395
- * `ptr`/`len` point to a UTF-8 string containing the target path.
396
- *
397
- * Delegates directly to `db_export` in `kbdb-fs-database`. Does not require
398
- * the worker to have been initialised because the target path is given
399
- * explicitly by the caller.
400
- *
401
- * Returns 0 on success, -1 on error (message in return slot).
402
- */
403
- export function worker_export(ptr: number, len: number): number;
404
-
405
- /**
406
- * Runs garbage collection and invalidates all cache entries.
407
- *
408
- * After GC the set of valid sections may have changed; the whole cache is
409
- * invalidated to prevent stale reads.
410
- */
411
- export function worker_garbage_collect(): number;
412
-
413
- /**
414
- * Retrieves and removes the result for `token`.
415
- *
416
- * Result bytes are written to the return slot. Returns 0 on success, -1 if
417
- * the token is not found or has an error.
418
- */
419
- export function worker_get_result(token: number): number;
420
-
421
- /**
422
- * Creates a document grouping. Returns 0 on success, -1 on error.
423
- */
424
- export function worker_group_sections(ptr: number, len: number): number;
425
-
426
- /**
427
- * Initialises the worker context from an encoded config in shared memory.
428
- *
429
- * Format: UTF-8 context path string (the rest of the config uses defaults).
430
- *
431
- * Returns 0 on success, -1 on error (error message in return slot).
432
- */
433
- export function worker_init(ptr: number, len: number): number;
434
-
435
- /**
436
- * Creates the full directory scaffold for a new database at `ptr`/`len` path.
437
- *
438
- * Delegates to `db_init_directory` in `kbdb-fs-database`. Does not require
439
- * `worker_init` to have been called first.
440
- *
441
- * Returns 0 on success, -1 on error (message in return slot).
442
- */
443
- export function worker_init_directory(ptr: number, len: number): number;
444
-
445
- /**
446
- * Invalidates the cache entry for the kbid at `(ptr, len)`.
447
- */
448
- export function worker_invalidate(ptr: number, len: number): number;
449
-
450
- /**
451
- * Clears all cache entries.
452
- */
453
- export function worker_invalidate_all(): number;
454
-
455
- /**
456
- * Lists all sections whose `type_name` matches the UTF-8 string at `(ptr, len)`.
457
- *
458
- * On success encodes `u32 count + SectionRecord[]` into the return slot and
459
- * returns 0. On error writes an error message and returns -1.
460
- */
461
- export function worker_list_by_type(ptr: number, len: number): number;
462
-
463
- /**
464
- * Lists all document manifests whose `doc_type` matches the UTF-8 string at
465
- * `(ptr, len)`.
466
- *
467
- * On success encodes `u32 count + DocumentManifest[]` into the return slot and
468
- * returns 0. On error writes an error message and returns -1.
469
- */
470
- export function worker_list_docs_by_type(ptr: number, len: number): number;
471
-
472
- /**
473
- * Async query returning a token. The result can be polled via `worker_result_status`.
474
- */
475
- export function worker_query(ptr: number, len: number): number;
476
-
477
- /**
478
- * Reads sections by kbid list. Returns 0 on success, -1 on error.
479
- */
480
- export function worker_read_sections(ptr: number, len: number): number;
481
-
482
- /**
483
- * Rebuilds all database indexes.
484
- *
485
- * First clears the existing inverted, positional, and reference indexes via
486
- * `db_rebuild_index`. Then re-tokenizes every stored section and re-populates
487
- * the indexes via `rebuild_all_section_indexes`.
488
- *
489
- * On success the return slot holds the number of reindexed sections as a
490
- * little-endian `u32`, and 0 is returned. On error -1 is returned and an
491
- * error message is in the return slot.
492
- */
493
- export function worker_rebuild_indexes(): number;
494
-
495
- /**
496
- * Recalls section content with optional progressive context expansion.
497
- *
498
- * Input format (binary):
499
- * - `u8 tag`: 0 = single kbid, 1 = batch kbids
500
- * - If tag=0: `String kbid`
501
- * - If tag=1: `u32 count` + `String[]` kbids
502
- * - `u32 depth` (0-3, values above 3 are clamped to 3)
503
- *
504
- * On success writes the encoded result to the return slot and returns 0.
505
- * On error writes an error message to the return slot and returns -1.
506
- */
507
- export function worker_recall(ptr: number, len: number): number;
508
-
509
- /**
510
- * Removes a document grouping. Returns 0 on success, -1 on error.
511
- */
512
- export function worker_remove_grouping(ptr: number, len: number): number;
513
-
514
- /**
515
- * Removes a section. Returns 0 on success, -1 on error.
516
- */
517
- export function worker_remove_section(ptr: number, len: number): number;
518
-
519
- /**
520
- * Returns a numeric status code for a token:
521
- * - 0 = unknown token
522
- * - 1 = pending
523
- * - 2 = ready
524
- * - 3 = error
525
- */
526
- export function worker_result_status(token: number): number;
527
-
528
- /**
529
- * Reads a document manifest. Returns 0 on success, -1 on error.
530
- */
531
- export function worker_retrieve_doc(ptr: number, len: number): number;
532
-
533
- /**
534
- * Performs a search, returning an async result token.
535
- *
536
- * Input format: `"query\nmode\nlimit\noffset"` (offset is optional,
537
- * defaults to 0).
538
- *
539
- * The result is a `PagedSearchResult` envelope encoded as binary.
540
- */
541
- export function worker_search(ptr: number, len: number): number;
542
-
543
- /**
544
- * Returns worker status. Always returns 0.
545
- *
546
- * As a side effect, evicts any expired cache entries using the
547
- * configured TTL. The status string is written to the return slot.
548
- */
549
- export function worker_status(): number;
550
-
551
- /**
552
- * Updates a section. Returns 0 on success, -1 on error.
553
- */
554
- export function worker_update_section(ptr: number, len: number): number;
555
-
556
- /**
557
- * Crate version.
558
- */
559
- export function worker_version(): string;
560
-
561
- }
562
- declare type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
563
-
564
- declare interface InitOutput {
565
- readonly memory: WebAssembly.Memory;
566
- readonly kbdb_free: (a: number, b: number) => void;
567
- readonly get_return_ptr: () => number;
568
- readonly get_return_len: () => number;
569
- readonly set_return: (a: number, b: number) => void;
570
- readonly worker_add_section: (a: number, b: number) => number;
571
- readonly worker_check_integrity: () => number;
572
- readonly worker_compose: (a: number, b: number) => number;
573
- readonly worker_export: (a: number, b: number) => number;
574
- readonly worker_garbage_collect: () => number;
575
- readonly worker_get_result: (a: number) => number;
576
- readonly worker_group_sections: (a: number, b: number) => number;
577
- readonly worker_init: (a: number, b: number) => number;
578
- readonly worker_init_directory: (a: number, b: number) => number;
579
- readonly worker_invalidate: (a: number, b: number) => number;
580
- readonly worker_invalidate_all: () => number;
581
- readonly worker_list_by_type: (a: number, b: number) => number;
582
- readonly worker_list_docs_by_type: (a: number, b: number) => number;
583
- readonly worker_query: (a: number, b: number) => number;
584
- readonly worker_read_sections: (a: number, b: number) => number;
585
- readonly worker_rebuild_indexes: () => number;
586
- readonly worker_recall: (a: number, b: number) => number;
587
- readonly worker_remove_grouping: (a: number, b: number) => number;
588
- readonly worker_remove_section: (a: number, b: number) => number;
589
- readonly worker_result_status: (a: number) => number;
590
- readonly worker_retrieve_doc: (a: number, b: number) => number;
591
- readonly worker_status: () => number;
592
- readonly worker_update_section: (a: number, b: number) => number;
593
- readonly worker_version: (a: number) => void;
594
- readonly worker_search: (a: number, b: number) => number;
595
- readonly qp_cache_get: (a: number, b: number) => number;
596
- readonly qp_cache_insert: (a: number, b: number, c: number, d: number) => number;
597
- readonly qp_compute_field_tf: (a: number, b: number) => number;
598
- readonly qp_compute_tfidf: (a: number, b: number) => number;
599
- readonly qp_extract_keyphrases: (a: number, b: number, c: number) => number;
600
- readonly qp_extract_ngrams: (a: number, b: number) => number;
601
- readonly qp_parse_query: (a: number, b: number) => number;
602
- readonly qp_score_bm25f: (a: number, b: number) => number;
603
- readonly qp_score_bm25f_field: (a: number, b: number) => number;
604
- readonly qp_score_freshness: (a: number, b: number) => number;
605
- readonly qp_score_proximity: (a: number, b: number) => number;
606
- readonly qp_score_zone: (a: number, b: number) => number;
607
- readonly qp_tokenize: (a: number, b: number) => number;
608
- readonly version: (a: number) => void;
609
- readonly qp_cache_clear: () => number;
610
- readonly db_add_section: (a: number, b: number) => number;
611
- readonly db_add_to_index: (a: number, b: number) => number;
612
- readonly db_check_integrity: (a: number, b: number) => number;
613
- readonly db_check_version: (a: number, b: number) => number;
614
- readonly db_export: (a: number, b: number) => number;
615
- readonly db_gc: (a: number, b: number) => number;
616
- readonly db_get_back_refs: (a: number, b: number) => number;
617
- readonly db_get_forward_refs: (a: number, b: number) => number;
618
- readonly db_init: (a: number, b: number) => number;
619
- readonly db_init_catalog: (a: number, b: number) => number;
620
- readonly db_init_directory: (a: number, b: number) => number;
621
- readonly db_list_documents: (a: number, b: number) => number;
622
- readonly db_list_sections: (a: number, b: number) => number;
623
- readonly db_query: (a: number, b: number) => number;
624
- readonly db_read_catalog: (a: number, b: number) => number;
625
- readonly db_read_corpus_stats: (a: number, b: number) => number;
626
- readonly db_read_document: (a: number, b: number) => number;
627
- readonly db_read_section: (a: number, b: number) => number;
628
- readonly db_read_sections: (a: number, b: number) => number;
629
- readonly db_rebuild_index: (a: number, b: number) => number;
630
- readonly db_remove_document: (a: number, b: number) => number;
631
- readonly db_remove_from_index: (a: number, b: number) => number;
632
- readonly db_remove_section: (a: number, b: number) => number;
633
- readonly db_update_section: (a: number, b: number) => number;
634
- readonly db_write_catalog: (a: number, b: number) => number;
635
- readonly db_write_corpus_stats: (a: number, b: number) => number;
636
- readonly db_write_document: (a: number, b: number) => number;
637
- readonly kbdb_alloc: (a: number) => number;
638
- readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
639
- readonly __wbindgen_export: (a: number, b: number, c: number) => void;
640
- }
641
-
642
- /**
643
- * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
644
- * for everything else, calls `WebAssembly.instantiate` directly.
645
- *
646
- * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
647
- *
648
- * @returns {Promise<InitOutput>}
649
- */
650
- declare function wasm_bindgen (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;