@dikolab/kbdb 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (428) hide show
  1. package/README.md +89 -120
  2. package/dist/bench/constants/corpus-defaults.constant.d.ts +3 -0
  3. package/dist/bench/functions/format-report.function.d.ts +11 -0
  4. package/dist/bench/functions/generate-corpus.function.d.ts +12 -0
  5. package/dist/bench/functions/measure-operation.function.d.ts +14 -0
  6. package/dist/bench/functions/seeded-rng.function.d.ts +11 -0
  7. package/dist/bench/functions/zipf-word.function.d.ts +13 -0
  8. package/dist/bench/index.d.ts +10 -0
  9. package/dist/bench/typings/bench-result.interface.d.ts +11 -0
  10. package/dist/bench/typings/bench-suite-result.interface.d.ts +10 -0
  11. package/dist/bench/typings/corpus-config.interface.d.ts +11 -0
  12. package/dist/bench/typings/corpus-section.interface.d.ts +9 -0
  13. package/dist/cli.cjs +63 -9
  14. package/dist/cli.cjs.map +2 -2
  15. package/dist/cli.mjs +63 -9
  16. package/dist/cli.mjs.map +2 -2
  17. package/dist/src/shared/auto-capture/classes/auto-capture-controller.class.d.ts +33 -0
  18. package/dist/src/shared/auto-capture/constants/auto-capture-defaults.constant.d.ts +8 -0
  19. package/dist/src/shared/auto-capture/functions/build-capture-prompt.function.d.ts +11 -0
  20. package/dist/src/shared/auto-capture/functions/evaluate-trigger.function.d.ts +12 -0
  21. package/dist/src/shared/auto-capture/index.d.ts +7 -0
  22. package/dist/src/shared/auto-capture/typings/auto-capture-config.interface.d.ts +13 -0
  23. package/dist/src/shared/auto-capture/typings/auto-capture-state.interface.d.ts +13 -0
  24. package/dist/src/shared/auto-capture/typings/auto-capture-trigger.interface.d.ts +7 -0
  25. package/dist/src/shared/cli/constants/global-help.constant.d.ts +8 -0
  26. package/dist/src/shared/cli/constants/leaf-help.constant.d.ts +7 -0
  27. package/dist/src/shared/cli/constants/memory-protocol-body.constant.d.ts +7 -0
  28. package/dist/src/shared/cli/constants/query-guidance-body.constant.d.ts +7 -0
  29. package/dist/src/shared/cli/constants/subcommand-help.constant.d.ts +8 -0
  30. package/dist/src/shared/cli/functions/collect-files.function.d.ts +13 -0
  31. package/dist/src/shared/cli/functions/compute-section-kbid.function.d.ts +15 -0
  32. package/dist/src/shared/cli/functions/format-mcp-output.function.d.ts +9 -0
  33. package/dist/src/shared/cli/functions/format-text-output.function.d.ts +9 -0
  34. package/dist/src/shared/cli/functions/generate-group-help.function.d.ts +11 -0
  35. package/dist/src/shared/cli/functions/handle-data-command.function.d.ts +16 -0
  36. package/dist/src/shared/cli/functions/handle-mcp.function.d.ts +15 -0
  37. package/dist/src/shared/cli/functions/handle-migrate.function.d.ts +15 -0
  38. package/dist/src/shared/cli/functions/hydrate-search-previews.function.d.ts +14 -0
  39. package/dist/src/shared/cli/functions/resolve-skill-names.function.d.ts +16 -0
  40. package/dist/src/shared/cli/functions/run-search.function.d.ts +1 -0
  41. package/dist/src/shared/cli/functions/version-gate.function.d.ts +15 -0
  42. package/dist/src/shared/cli/functions/wrap-command.function.d.ts +15 -0
  43. package/dist/src/shared/cli/typings/agent-create-client.interface.d.ts +42 -0
  44. package/dist/src/shared/cli/typings/agent-get-client.interface.d.ts +36 -0
  45. package/dist/src/shared/cli/typings/check-client.interface.d.ts +58 -0
  46. package/dist/src/shared/cli/typings/cli-deps.interface.d.ts +48 -0
  47. package/dist/src/shared/cli/typings/cli-options.interface.d.ts +2 -0
  48. package/dist/src/shared/cli/typings/disconnectable-client.interface.d.ts +26 -0
  49. package/dist/src/shared/cli/typings/dispatch-client.type.d.ts +27 -0
  50. package/dist/src/shared/cli/typings/learn-client.interface.d.ts +52 -0
  51. package/dist/src/shared/cli/typings/learn-io.interface.d.ts +5 -0
  52. package/dist/src/shared/cli/typings/search-client.interface.d.ts +71 -0
  53. package/dist/src/shared/embedding/classes/null-embedding-provider.class.d.ts +20 -0
  54. package/dist/src/shared/embedding/constants/near-duplicate-thresholds.constant.d.ts +15 -0
  55. package/dist/src/shared/embedding/functions/build-vector-index.function.d.ts +14 -0
  56. package/dist/src/shared/embedding/functions/cosine-similarity.function.d.ts +10 -0
  57. package/dist/src/shared/embedding/functions/detect-near-duplicates.function.d.ts +18 -0
  58. package/dist/src/shared/embedding/functions/jaccard-coefficient.function.d.ts +9 -0
  59. package/dist/src/shared/embedding/functions/read-vector-index-meta.function.d.ts +10 -0
  60. package/dist/src/shared/embedding/functions/rrf-fuse.function.d.ts +14 -0
  61. package/dist/src/shared/embedding/functions/search-vectors.function.d.ts +14 -0
  62. package/dist/src/shared/embedding/index.d.ts +16 -0
  63. package/dist/src/shared/embedding/typings/embedding-config.interface.d.ts +20 -0
  64. package/dist/src/shared/embedding/typings/embedding-provider.interface.d.ts +23 -0
  65. package/dist/src/shared/embedding/typings/near-duplicate-candidate.model.d.ts +23 -0
  66. package/dist/src/shared/embedding/typings/near-duplicate-result.model.d.ts +24 -0
  67. package/dist/src/shared/embedding/typings/vector-index-entry.model.d.ts +12 -0
  68. package/dist/src/shared/embedding/typings/vector-index-meta.model.d.ts +11 -0
  69. package/dist/src/shared/embedding/typings/vector-search-result.model.d.ts +7 -0
  70. package/dist/src/shared/mcp/constants/tool-agent-create.constant.d.ts +3 -0
  71. package/dist/src/shared/mcp/constants/tool-agent-delete.constant.d.ts +3 -0
  72. package/dist/src/shared/mcp/constants/tool-agent-get.constant.d.ts +3 -0
  73. package/dist/src/shared/mcp/constants/tool-agent-list.constant.d.ts +3 -0
  74. package/dist/src/shared/mcp/constants/tool-auto-capture-review.constant.d.ts +8 -0
  75. package/dist/src/shared/mcp/constants/tool-check.constant.d.ts +3 -0
  76. package/dist/src/shared/mcp/constants/tool-content.constant.d.ts +3 -0
  77. package/dist/src/shared/mcp/constants/tool-export.constant.d.ts +3 -0
  78. package/dist/src/shared/mcp/constants/tool-gc.constant.d.ts +3 -0
  79. package/dist/src/shared/mcp/constants/tool-learn.constant.d.ts +3 -0
  80. package/dist/src/shared/mcp/constants/tool-rebuild.constant.d.ts +3 -0
  81. package/dist/src/shared/mcp/constants/tool-recall.constant.d.ts +3 -0
  82. package/dist/src/shared/mcp/constants/tool-retrieve.constant.d.ts +3 -0
  83. package/dist/src/shared/mcp/constants/tool-search.constant.d.ts +3 -0
  84. package/dist/src/shared/mcp/constants/tool-skill-delete.constant.d.ts +3 -0
  85. package/dist/src/shared/mcp/constants/tool-skill-get.constant.d.ts +3 -0
  86. package/dist/src/shared/mcp/constants/tool-skill-learn.constant.d.ts +3 -0
  87. package/dist/src/shared/mcp/constants/tool-skill-list.constant.d.ts +3 -0
  88. package/dist/src/shared/mcp/constants/tool-status.constant.d.ts +3 -0
  89. package/dist/src/shared/mcp/constants/tool-unlearn.constant.d.ts +3 -0
  90. package/dist/src/shared/mcp/functions/as-boolean-or-undefined.function.d.ts +7 -0
  91. package/dist/src/shared/mcp/functions/as-string-array-or-undefined.function.d.ts +7 -0
  92. package/dist/src/shared/mcp/functions/as-string-array.function.d.ts +7 -0
  93. package/dist/src/shared/mcp/functions/as-string.function.d.ts +8 -0
  94. package/dist/src/shared/mcp/functions/build-skills-text.function.d.ts +18 -0
  95. package/dist/src/shared/mcp/functions/handle-agent-prompt.function.d.ts +14 -0
  96. package/dist/src/shared/mcp/functions/handle-mcp-request.function.d.ts +14 -0
  97. package/dist/src/shared/mcp/functions/handle-prompt-get.function.d.ts +4 -3
  98. package/dist/src/shared/mcp/functions/handle-skill-prompt.function.d.ts +16 -0
  99. package/dist/src/shared/mcp/functions/handle-tool-auto-capture-review.function.d.ts +12 -0
  100. package/dist/src/shared/mcp/functions/handle-tool-check.function.d.ts +11 -0
  101. package/dist/src/shared/mcp/functions/handle-tool-content.function.d.ts +12 -0
  102. package/dist/src/shared/mcp/functions/handle-tool-export.function.d.ts +12 -0
  103. package/dist/src/shared/mcp/functions/handle-tool-gc.function.d.ts +11 -0
  104. package/dist/src/shared/mcp/functions/handle-tool-learn.function.d.ts +12 -0
  105. package/dist/src/shared/mcp/functions/handle-tool-rebuild.function.d.ts +11 -0
  106. package/dist/src/shared/mcp/functions/handle-tool-retrieve.function.d.ts +12 -0
  107. package/dist/src/shared/mcp/functions/handle-tool-search.function.d.ts +13 -0
  108. package/dist/src/shared/mcp/functions/handle-tool-skill-delete.function.d.ts +12 -0
  109. package/dist/src/shared/mcp/functions/handle-tool-skill-get.function.d.ts +13 -0
  110. package/dist/src/shared/mcp/functions/handle-tool-skill-learn.function.d.ts +13 -0
  111. package/dist/src/shared/mcp/functions/handle-tool-skill-list.function.d.ts +11 -0
  112. package/dist/src/shared/mcp/functions/handle-tool-status.function.d.ts +11 -0
  113. package/dist/src/shared/mcp/functions/handle-tool-unlearn.function.d.ts +12 -0
  114. package/dist/src/shared/mcp/functions/parse-agent-meta.function.d.ts +14 -0
  115. package/dist/src/shared/mcp/functions/parse-skill-arguments.function.d.ts +11 -0
  116. package/dist/src/shared/mcp/functions/read-agent-meta.function.d.ts +17 -0
  117. package/dist/src/shared/mcp/functions/resolve-skill-refs.function.d.ts +23 -0
  118. package/dist/src/shared/mcp/functions/run-startup-health-check.function.d.ts +14 -0
  119. package/dist/src/shared/mcp/typings/mcp-capabilities.interface.d.ts +16 -0
  120. package/dist/src/shared/mcp/typings/mcp-client.interface.d.ts +2 -0
  121. package/dist/src/shared/mcp/typings/mcp-completion.interface.d.ts +43 -0
  122. package/dist/src/shared/mcp/typings/mcp-content-result.model.d.ts +9 -0
  123. package/dist/src/shared/mcp/typings/mcp-export-result.model.d.ts +11 -0
  124. package/dist/src/shared/mcp/typings/mcp-gc-result.model.d.ts +15 -0
  125. package/dist/src/shared/mcp/typings/mcp-integrity-check-result.model.d.ts +16 -0
  126. package/dist/src/shared/mcp/typings/mcp-integrity-error.model.d.ts +9 -0
  127. package/dist/src/shared/mcp/typings/mcp-notification.interface.d.ts +9 -0
  128. package/dist/src/shared/mcp/typings/mcp-rebuild-result.model.d.ts +9 -0
  129. package/dist/src/shared/mcp/typings/mcp-request.interface.d.ts +11 -0
  130. package/dist/src/shared/mcp/typings/mcp-resource-result.interface.d.ts +12 -0
  131. package/dist/src/shared/mcp/typings/mcp-resource-template.interface.d.ts +11 -0
  132. package/dist/src/shared/mcp/typings/mcp-response.interface.d.ts +18 -0
  133. package/dist/src/shared/mcp/typings/mcp-server-info.interface.d.ts +7 -0
  134. package/dist/src/shared/mcp/typings/mcp-server-state.interface.d.ts +16 -0
  135. package/dist/src/shared/mcp/typings/mcp-tool-annotations.interface.d.ts +32 -0
  136. package/dist/src/shared/mcp/typings/mcp-tool-definition.interface.d.ts +15 -0
  137. package/dist/src/shared/mcp/typings/mcp-tool-result.interface.d.ts +19 -0
  138. package/dist/src/shared/mcp/typings/mcp-worker-client.interface.d.ts +220 -0
  139. package/dist/src/shared/mcp/typings/tool-call-result.model.d.ts +17 -0
  140. package/dist/src/shared/sync/functions/build-import-report.function.d.ts +18 -0
  141. package/dist/src/shared/sync/functions/parse-export-entry.function.d.ts +11 -0
  142. package/dist/src/shared/sync/functions/resolve-conflict.function.d.ts +13 -0
  143. package/dist/src/shared/sync/functions/serialize-export-entry.function.d.ts +8 -0
  144. package/dist/src/shared/sync/index.d.ts +9 -0
  145. package/dist/src/shared/sync/typings/conflict-resolution.type.d.ts +8 -0
  146. package/dist/src/shared/sync/typings/export-entry.interface.d.ts +13 -0
  147. package/dist/src/shared/sync/typings/export-options.interface.d.ts +9 -0
  148. package/dist/src/shared/sync/typings/import-options.interface.d.ts +7 -0
  149. package/dist/src/shared/sync/typings/import-report.interface.d.ts +15 -0
  150. package/dist/src/shared/wasm-codec/functions/decode-one-recall-result.function.d.ts +14 -0
  151. package/dist/src/shared/wasm-codec/functions/decode-option-string.function.d.ts +12 -0
  152. package/dist/src/shared/wasm-codec/functions/decode-recall-document.function.d.ts +14 -0
  153. package/dist/src/shared/wasm-codec/functions/decode-recall-reference.function.d.ts +14 -0
  154. package/dist/src/shared/wasm-codec/functions/decode-recall-sibling.function.d.ts +13 -0
  155. package/dist/src/shared/wasm-codec/functions/decode-section-match.function.d.ts +15 -0
  156. package/dist/src/shared/wasm-codec/functions/decode-section-record-trailing.function.d.ts +14 -0
  157. package/dist/src/shared/wasm-codec/functions/decode-section-record.function.d.ts +14 -0
  158. package/dist/src/shared/wasm-codec/functions/decode-section-type.function.d.ts +13 -0
  159. package/dist/src/shared/wasm-codec/functions/decode-wasm-list.function.d.ts +17 -0
  160. package/dist/src/shared/wasm-codec/typings/add-section-input.model.d.ts +45 -0
  161. package/dist/src/shared/wasm-codec/typings/add-section-result.model.d.ts +27 -0
  162. package/dist/src/shared/wasm-codec/typings/document-manifest.model.d.ts +19 -0
  163. package/dist/src/shared/wasm-codec/typings/document-section.model.d.ts +12 -0
  164. package/dist/src/shared/wasm-codec/typings/item-decoder.type.d.ts +6 -0
  165. package/dist/src/shared/wasm-codec/typings/near-duplicate.model.d.ts +16 -0
  166. package/dist/src/shared/wasm-codec/typings/paged-search-result.model.d.ts +21 -0
  167. package/dist/src/shared/wasm-codec/typings/section-match.model.d.ts +31 -0
  168. package/dist/src/shared/wasm-codec/typings/section-record-trailing.model.d.ts +38 -0
  169. package/dist/src/shared/wasm-codec/typings/section-record.model.d.ts +66 -0
  170. package/dist/src/shared/wasm-codec/typings/section-type-result.model.d.ts +12 -0
  171. package/dist/src/shared/worker-client/functions/handle-ipc-data.function.d.ts +16 -0
  172. package/dist/src/shared/worker-client/functions/send-ipc-request.function.d.ts +19 -0
  173. package/dist/src/shared/worker-client/typings/add-section-result.model.d.ts +2 -0
  174. package/dist/src/shared/worker-client/typings/json-rpc-response.interface.d.ts +16 -0
  175. package/dist/src/shared/worker-client/typings/pending-call.interface.d.ts +7 -0
  176. package/dist/src/shared/worker-client/typings/recall-document.model.d.ts +16 -0
  177. package/dist/src/shared/worker-client/typings/recall-params.model.d.ts +15 -0
  178. package/dist/src/shared/worker-client/typings/recall-reference.model.d.ts +32 -0
  179. package/dist/src/shared/worker-client/typings/recall-sibling.model.d.ts +11 -0
  180. package/dist/src/shared/worker-client/typings/recall-single-result.model.d.ts +40 -0
  181. package/dist/src/shared/worker-daemon/classes/ipc-error.class.d.ts +17 -0
  182. package/dist/src/shared/worker-daemon/constants/wasm-method-map.constant.d.ts +16 -0
  183. package/dist/src/shared/worker-daemon/functions/build-ipc-error-response.function.d.ts +9 -0
  184. package/dist/src/shared/worker-daemon/functions/check-catalog-version.function.d.ts +9 -0
  185. package/dist/src/shared/worker-daemon/functions/check-preconditions.function.d.ts +10 -0
  186. package/dist/src/shared/worker-daemon/functions/detect-stale-pid.function.d.ts +15 -0
  187. package/dist/src/shared/worker-daemon/functions/dispatch-request.function.d.ts +35 -0
  188. package/dist/src/shared/worker-daemon/functions/handle-check-version.function.d.ts +23 -0
  189. package/dist/src/shared/worker-daemon/functions/handle-config-method.function.d.ts +11 -0
  190. package/dist/src/shared/worker-daemon/functions/handle-read-ops.function.d.ts +52 -0
  191. package/dist/src/shared/worker-daemon/functions/handle-write-ops.function.d.ts +44 -0
  192. package/dist/src/shared/worker-daemon/functions/parse-auto-capture-section.function.d.ts +14 -0
  193. package/dist/src/shared/worker-daemon/functions/parse-catalog-version.function.d.ts +10 -0
  194. package/dist/src/shared/worker-daemon/functions/parse-embedding-section.function.d.ts +13 -0
  195. package/dist/src/shared/worker-daemon/functions/parse-worker-toml.function.d.ts +11 -0
  196. package/dist/src/shared/worker-daemon/functions/run-startup-integrity-check.function.d.ts +18 -0
  197. package/dist/src/shared/worker-daemon/functions/scan-near-duplicates.function.d.ts +21 -0
  198. package/dist/src/shared/worker-daemon/functions/wasm-bridge.function.d.ts +51 -0
  199. package/dist/src/shared/worker-daemon/functions/wasm-memory-helpers.function.d.ts +22 -0
  200. package/dist/src/shared/worker-daemon/functions/write-lock.function.d.ts +32 -0
  201. package/dist/src/shared/worker-daemon/typings/allocator-ref.interface.d.ts +16 -0
  202. package/dist/src/shared/worker-daemon/typings/daemon-config.interface.d.ts +6 -0
  203. package/dist/src/shared/worker-daemon/typings/fs-adapter.interface.d.ts +22 -0
  204. package/dist/src/shared/worker-daemon/typings/handler-context.interface.d.ts +18 -0
  205. package/dist/src/shared/worker-daemon/typings/memory-ref.interface.d.ts +13 -0
  206. package/dist/src/shared/worker-daemon/typings/wasm-fn.type.d.ts +2 -0
  207. package/dist/src/shared/worker-daemon/typings/write-lock.interface.d.ts +15 -0
  208. package/dist/wasm/fs-database/kbdb_fs_database_bg.wasm +0 -0
  209. package/dist/wasm/kb-worker/kbdb_worker_bg.wasm +0 -0
  210. package/docs/details/cli.md +9 -0
  211. package/docs/details/mcp-server.md +5 -3
  212. package/docs/details/search-and-ranking.md +55 -0
  213. package/docs/goals/auto-capture.md +378 -0
  214. package/docs/goals/benchmarking.md +296 -0
  215. package/docs/goals/concurrency.md +259 -0
  216. package/docs/goals/hybrid-search.md +436 -0
  217. package/docs/goals/semantic-dedup.md +229 -0
  218. package/docs/goals/sync.md +217 -0
  219. package/docs/modules/rust/fs-database/indexes/vectors.md +110 -0
  220. package/docs/modules/typescript/shared/auto-capture/module.md +73 -0
  221. package/docs/modules/typescript/shared/embedding/functions.md +94 -0
  222. package/docs/modules/typescript/shared/embedding/module.md +71 -0
  223. package/docs/modules/typescript/shared/embedding/typings.md +122 -0
  224. package/docs/overview.md +171 -167
  225. package/docs/release-notes/0.2.0.md +3 -3
  226. package/docs/release-notes/0.3.0.md +89 -0
  227. package/docs/release-notes/0.3.1.md +121 -0
  228. package/docs/release-notes/0.3.2.md +64 -0
  229. package/docs/release-notes/README.md +3 -0
  230. package/package.json +1 -1
  231. package/src/shared/auto-capture/classes/auto-capture-controller.class.ts +62 -0
  232. package/src/shared/auto-capture/constants/auto-capture-defaults.constant.ts +15 -0
  233. package/src/shared/auto-capture/functions/build-capture-prompt.function.ts +27 -0
  234. package/src/shared/auto-capture/functions/evaluate-trigger.function.ts +50 -0
  235. package/src/shared/auto-capture/index.ts +7 -0
  236. package/src/shared/auto-capture/typings/auto-capture-config.interface.ts +13 -0
  237. package/src/shared/auto-capture/typings/auto-capture-state.interface.ts +13 -0
  238. package/src/shared/auto-capture/typings/auto-capture-trigger.interface.ts +7 -0
  239. package/src/shared/cli/constants/global-help.constant.ts +73 -0
  240. package/src/shared/cli/constants/leaf-help.constant.ts +219 -0
  241. package/src/shared/cli/constants/memory-protocol-body.constant.ts +39 -0
  242. package/src/shared/cli/constants/query-guidance-body.constant.ts +37 -0
  243. package/src/shared/cli/constants/subcommand-help.constant.ts +195 -0
  244. package/src/shared/cli/functions/collect-files.function.ts +55 -0
  245. package/src/shared/cli/functions/compute-section-kbid.function.ts +49 -0
  246. package/src/shared/cli/functions/format-mcp-output.function.ts +41 -0
  247. package/src/shared/cli/functions/format-text-output.function.ts +42 -0
  248. package/src/shared/cli/functions/generate-group-help.function.ts +41 -0
  249. package/src/shared/cli/functions/handle-data-command.function.ts +67 -0
  250. package/src/shared/cli/functions/handle-mcp.function.ts +56 -0
  251. package/src/shared/cli/functions/handle-migrate.function.ts +64 -0
  252. package/src/shared/cli/functions/hydrate-search-previews.function.ts +29 -0
  253. package/src/shared/cli/functions/parse-args.function.ts +3 -0
  254. package/src/shared/cli/functions/resolve-skill-names.function.ts +43 -0
  255. package/src/shared/cli/functions/run-search.function.ts +2 -0
  256. package/src/shared/cli/functions/version-gate.function.ts +44 -0
  257. package/src/shared/cli/functions/wrap-command.function.ts +34 -0
  258. package/src/shared/cli/typings/agent-create-client.interface.ts +47 -0
  259. package/src/shared/cli/typings/agent-get-client.interface.ts +39 -0
  260. package/src/shared/cli/typings/check-client.interface.ts +66 -0
  261. package/src/shared/cli/typings/cli-deps.interface.ts +54 -0
  262. package/src/shared/cli/typings/cli-options.interface.ts +2 -0
  263. package/src/shared/cli/typings/disconnectable-client.interface.ts +29 -0
  264. package/src/shared/cli/typings/dispatch-client.type.ts +46 -0
  265. package/src/shared/cli/typings/learn-client.interface.ts +53 -0
  266. package/src/shared/cli/typings/learn-io.interface.ts +5 -0
  267. package/src/shared/cli/typings/search-client.interface.ts +73 -0
  268. package/src/shared/embedding/classes/null-embedding-provider.class.ts +29 -0
  269. package/src/shared/embedding/constants/near-duplicate-thresholds.constant.ts +17 -0
  270. package/src/shared/embedding/functions/build-vector-index.function.ts +79 -0
  271. package/src/shared/embedding/functions/cosine-similarity.function.ts +31 -0
  272. package/src/shared/embedding/functions/detect-near-duplicates.function.ts +69 -0
  273. package/src/shared/embedding/functions/jaccard-coefficient.function.ts +26 -0
  274. package/src/shared/embedding/functions/read-vector-index-meta.function.ts +44 -0
  275. package/src/shared/embedding/functions/rrf-fuse.function.ts +33 -0
  276. package/src/shared/embedding/functions/search-vectors.function.ts +59 -0
  277. package/src/shared/embedding/index.ts +20 -0
  278. package/src/shared/embedding/typings/embedding-config.interface.ts +23 -0
  279. package/src/shared/embedding/typings/embedding-provider.interface.ts +25 -0
  280. package/src/shared/embedding/typings/near-duplicate-candidate.model.ts +25 -0
  281. package/src/shared/embedding/typings/near-duplicate-result.model.ts +26 -0
  282. package/src/shared/embedding/typings/vector-index-entry.model.ts +13 -0
  283. package/src/shared/embedding/typings/vector-index-meta.model.ts +14 -0
  284. package/src/shared/embedding/typings/vector-search-result.model.ts +8 -0
  285. package/src/shared/mcp/classes/mcp-server.class.ts +6 -3
  286. package/src/shared/mcp/constants/tool-agent-create.constant.ts +39 -0
  287. package/src/shared/mcp/constants/tool-agent-delete.constant.ts +26 -0
  288. package/src/shared/mcp/constants/tool-agent-get.constant.ts +24 -0
  289. package/src/shared/mcp/constants/tool-agent-list.constant.ts +18 -0
  290. package/src/shared/mcp/constants/tool-auto-capture-review.constant.ts +32 -0
  291. package/src/shared/mcp/constants/tool-check.constant.ts +21 -0
  292. package/src/shared/mcp/constants/tool-content.constant.ts +29 -0
  293. package/src/shared/mcp/constants/tool-export.constant.ts +27 -0
  294. package/src/shared/mcp/constants/tool-gc.constant.ts +21 -0
  295. package/src/shared/mcp/constants/tool-learn.constant.ts +58 -0
  296. package/src/shared/mcp/constants/tool-rebuild.constant.ts +21 -0
  297. package/src/shared/mcp/constants/tool-recall.constant.ts +36 -0
  298. package/src/shared/mcp/constants/tool-retrieve.constant.ts +31 -0
  299. package/src/shared/mcp/constants/tool-search.constant.ts +51 -0
  300. package/src/shared/mcp/constants/tool-skill-delete.constant.ts +24 -0
  301. package/src/shared/mcp/constants/tool-skill-get.constant.ts +27 -0
  302. package/src/shared/mcp/constants/tool-skill-learn.constant.ts +37 -0
  303. package/src/shared/mcp/constants/tool-skill-list.constant.ts +18 -0
  304. package/src/shared/mcp/constants/tool-status.constant.ts +20 -0
  305. package/src/shared/mcp/constants/tool-unlearn.constant.ts +25 -0
  306. package/src/shared/mcp/functions/as-boolean-or-undefined.function.ts +11 -0
  307. package/src/shared/mcp/functions/as-string-array-or-undefined.function.ts +17 -0
  308. package/src/shared/mcp/functions/as-string-array.function.ts +15 -0
  309. package/src/shared/mcp/functions/as-string.function.ts +10 -0
  310. package/src/shared/mcp/functions/build-skills-text.function.ts +43 -0
  311. package/src/shared/mcp/functions/create-tool-definitions.function.ts +28 -0
  312. package/src/shared/mcp/functions/handle-agent-create.function.ts +1 -1
  313. package/src/shared/mcp/functions/handle-agent-prompt.function.ts +68 -0
  314. package/src/shared/mcp/functions/handle-mcp-request.function.ts +202 -0
  315. package/src/shared/mcp/functions/handle-prompt-get.function.ts +18 -12
  316. package/src/shared/mcp/functions/handle-skill-prompt.function.ts +44 -0
  317. package/src/shared/mcp/functions/handle-tool-auto-capture-review.function.ts +24 -0
  318. package/src/shared/mcp/functions/handle-tool-call.function.ts +18 -0
  319. package/src/shared/mcp/functions/handle-tool-check.function.ts +21 -0
  320. package/src/shared/mcp/functions/handle-tool-content.function.ts +23 -0
  321. package/src/shared/mcp/functions/handle-tool-export.function.ts +25 -0
  322. package/src/shared/mcp/functions/handle-tool-gc.function.ts +21 -0
  323. package/src/shared/mcp/functions/handle-tool-learn.function.ts +69 -0
  324. package/src/shared/mcp/functions/handle-tool-rebuild.function.ts +21 -0
  325. package/src/shared/mcp/functions/handle-tool-retrieve.function.ts +40 -0
  326. package/src/shared/mcp/functions/handle-tool-search.function.ts +47 -0
  327. package/src/shared/mcp/functions/handle-tool-skill-delete.function.ts +34 -0
  328. package/src/shared/mcp/functions/handle-tool-skill-get.function.ts +59 -0
  329. package/src/shared/mcp/functions/handle-tool-skill-learn.function.ts +61 -0
  330. package/src/shared/mcp/functions/handle-tool-skill-list.function.ts +39 -0
  331. package/src/shared/mcp/functions/handle-tool-status.function.ts +21 -0
  332. package/src/shared/mcp/functions/handle-tool-unlearn.function.ts +24 -0
  333. package/src/shared/mcp/functions/parse-agent-meta.function.ts +27 -0
  334. package/src/shared/mcp/functions/parse-skill-arguments.function.ts +36 -0
  335. package/src/shared/mcp/functions/read-agent-meta.function.ts +41 -0
  336. package/src/shared/mcp/functions/resolve-skill-refs.function.ts +50 -0
  337. package/src/shared/mcp/functions/run-startup-health-check.function.ts +34 -0
  338. package/src/shared/mcp/typings/mcp-capabilities.interface.ts +16 -0
  339. package/src/shared/mcp/typings/mcp-client.interface.ts +2 -0
  340. package/src/shared/mcp/typings/mcp-completion.interface.ts +45 -0
  341. package/src/shared/mcp/typings/mcp-content-result.model.ts +9 -0
  342. package/src/shared/mcp/typings/mcp-export-result.model.ts +11 -0
  343. package/src/shared/mcp/typings/mcp-gc-result.model.ts +15 -0
  344. package/src/shared/mcp/typings/mcp-integrity-check-result.model.ts +17 -0
  345. package/src/shared/mcp/typings/mcp-integrity-error.model.ts +15 -0
  346. package/src/shared/mcp/typings/mcp-notification.interface.ts +9 -0
  347. package/src/shared/mcp/typings/mcp-rebuild-result.model.ts +9 -0
  348. package/src/shared/mcp/typings/mcp-request.interface.ts +11 -0
  349. package/src/shared/mcp/typings/mcp-resource-result.interface.ts +12 -0
  350. package/src/shared/mcp/typings/mcp-resource-template.interface.ts +11 -0
  351. package/src/shared/mcp/typings/mcp-response.interface.ts +18 -0
  352. package/src/shared/mcp/typings/mcp-server-info.interface.ts +7 -0
  353. package/src/shared/mcp/typings/mcp-server-state.interface.ts +17 -0
  354. package/src/shared/mcp/typings/mcp-tool-annotations.interface.ts +32 -0
  355. package/src/shared/mcp/typings/mcp-tool-definition.interface.ts +16 -0
  356. package/src/shared/mcp/typings/mcp-tool-result.interface.ts +19 -0
  357. package/src/shared/mcp/typings/mcp-worker-client.interface.ts +243 -0
  358. package/src/shared/mcp/typings/tool-call-result.model.ts +18 -0
  359. package/src/shared/sync/functions/build-import-report.function.ts +40 -0
  360. package/src/shared/sync/functions/parse-export-entry.function.ts +45 -0
  361. package/src/shared/sync/functions/resolve-conflict.function.ts +31 -0
  362. package/src/shared/sync/functions/serialize-export-entry.function.ts +18 -0
  363. package/src/shared/sync/index.ts +9 -0
  364. package/src/shared/sync/typings/conflict-resolution.type.ts +8 -0
  365. package/src/shared/sync/typings/export-entry.interface.ts +13 -0
  366. package/src/shared/sync/typings/export-options.interface.ts +9 -0
  367. package/src/shared/sync/typings/import-options.interface.ts +7 -0
  368. package/src/shared/sync/typings/import-report.interface.ts +15 -0
  369. package/src/shared/wasm-codec/functions/decode-one-recall-result.function.ts +86 -0
  370. package/src/shared/wasm-codec/functions/decode-option-string.function.ts +24 -0
  371. package/src/shared/wasm-codec/functions/decode-recall-document.function.ts +59 -0
  372. package/src/shared/wasm-codec/functions/decode-recall-reference.function.ts +52 -0
  373. package/src/shared/wasm-codec/functions/decode-recall-sibling.function.ts +43 -0
  374. package/src/shared/wasm-codec/functions/decode-section-match.function.ts +80 -0
  375. package/src/shared/wasm-codec/functions/decode-section-record-trailing.function.ts +75 -0
  376. package/src/shared/wasm-codec/functions/decode-section-record.function.ts +85 -0
  377. package/src/shared/wasm-codec/functions/decode-section-type.function.ts +30 -0
  378. package/src/shared/wasm-codec/functions/decode-wasm-list.function.ts +31 -0
  379. package/src/shared/wasm-codec/typings/add-section-input.model.ts +45 -0
  380. package/src/shared/wasm-codec/typings/add-section-result.model.ts +28 -0
  381. package/src/shared/wasm-codec/typings/document-manifest.model.ts +20 -0
  382. package/src/shared/wasm-codec/typings/document-section.model.ts +12 -0
  383. package/src/shared/wasm-codec/typings/item-decoder.type.ts +10 -0
  384. package/src/shared/wasm-codec/typings/near-duplicate.model.ts +16 -0
  385. package/src/shared/wasm-codec/typings/paged-search-result.model.ts +22 -0
  386. package/src/shared/wasm-codec/typings/section-match.model.ts +31 -0
  387. package/src/shared/wasm-codec/typings/section-record-trailing.model.ts +38 -0
  388. package/src/shared/wasm-codec/typings/section-record.model.ts +66 -0
  389. package/src/shared/wasm-codec/typings/section-type-result.model.ts +12 -0
  390. package/src/shared/worker-client/functions/handle-ipc-data.function.ts +49 -0
  391. package/src/shared/worker-client/functions/send-ipc-request.function.ts +39 -0
  392. package/src/shared/worker-client/typings/add-section-result.model.ts +2 -0
  393. package/src/shared/worker-client/typings/json-rpc-response.interface.ts +17 -0
  394. package/src/shared/worker-client/typings/pending-call.interface.ts +7 -0
  395. package/src/shared/worker-client/typings/recall-document.model.ts +16 -0
  396. package/src/shared/worker-client/typings/recall-params.model.ts +15 -0
  397. package/src/shared/worker-client/typings/recall-reference.model.ts +32 -0
  398. package/src/shared/worker-client/typings/recall-sibling.model.ts +11 -0
  399. package/src/shared/worker-client/typings/recall-single-result.model.ts +41 -0
  400. package/src/shared/worker-daemon/classes/ipc-error.class.ts +22 -0
  401. package/src/shared/worker-daemon/constants/wasm-method-map.constant.ts +69 -0
  402. package/src/shared/worker-daemon/functions/build-ipc-error-response.function.ts +16 -0
  403. package/src/shared/worker-daemon/functions/check-catalog-version.function.ts +54 -0
  404. package/src/shared/worker-daemon/functions/check-preconditions.function.ts +28 -0
  405. package/src/shared/worker-daemon/functions/detect-stale-pid.function.ts +33 -0
  406. package/src/shared/worker-daemon/functions/dispatch-request.function.ts +190 -0
  407. package/src/shared/worker-daemon/functions/handle-check-version.function.ts +74 -0
  408. package/src/shared/worker-daemon/functions/handle-config-method.function.ts +27 -0
  409. package/src/shared/worker-daemon/functions/handle-read-ops.function.ts +236 -0
  410. package/src/shared/worker-daemon/functions/handle-write-ops.function.ts +257 -0
  411. package/src/shared/worker-daemon/functions/parse-auto-capture-section.function.ts +51 -0
  412. package/src/shared/worker-daemon/functions/parse-catalog-version.function.ts +20 -0
  413. package/src/shared/worker-daemon/functions/parse-embedding-section.function.ts +38 -0
  414. package/src/shared/worker-daemon/functions/parse-worker-toml.function.ts +104 -0
  415. package/src/shared/worker-daemon/functions/run-startup-integrity-check.function.ts +55 -0
  416. package/src/shared/worker-daemon/functions/scan-near-duplicates.function.ts +92 -0
  417. package/src/shared/worker-daemon/functions/wasm-bridge.function.ts +144 -0
  418. package/src/shared/worker-daemon/functions/wasm-memory-helpers.function.ts +41 -0
  419. package/src/shared/worker-daemon/functions/write-lock.function.ts +49 -0
  420. package/src/shared/worker-daemon/typings/allocator-ref.interface.ts +16 -0
  421. package/src/shared/worker-daemon/typings/daemon-config.interface.ts +7 -0
  422. package/src/shared/worker-daemon/typings/fs-adapter.interface.ts +22 -0
  423. package/src/shared/worker-daemon/typings/handler-context.interface.ts +19 -0
  424. package/src/shared/worker-daemon/typings/memory-ref.interface.ts +13 -0
  425. package/src/shared/worker-daemon/typings/wasm-fn.type.ts +2 -0
  426. package/src/shared/worker-daemon/typings/write-lock.interface.ts +13 -0
  427. package/src/wasm/fs-database/kbdb_fs_database_bg.wasm +0 -0
  428. package/src/wasm/kb-worker/kbdb_worker_bg.wasm +0 -0
@@ -0,0 +1,236 @@
1
+ import {
2
+ encodeSearchParams,
3
+ encodeKbidList,
4
+ encodeIdentifierList,
5
+ encodeTypeFilterParam,
6
+ encodeRecallParams,
7
+ decodePagedSearchResult,
8
+ decodeSectionRecords,
9
+ decodeSectionRecordList,
10
+ decodeDocumentManifest,
11
+ decodeDocumentManifestList,
12
+ decodeComposeOutput,
13
+ decodeKeyValueText,
14
+ decodeRecallResult,
15
+ } from '../../wasm-codec/index.ts';
16
+ import type { HandlerContext } from '../typings/handler-context.interface.ts';
17
+ import { IpcError } from '../classes/ipc-error.class.ts';
18
+ import {
19
+ getWasmExport,
20
+ wasmAlloc,
21
+ wasmWrite,
22
+ wasmFree,
23
+ readReturnSlot,
24
+ callWasmSync,
25
+ callWasmZeroArg,
26
+ } from './wasm-bridge.function.ts';
27
+
28
+ /**
29
+ * Handles `search` and `query` IPC methods.
30
+ *
31
+ * Encodes parameters, invokes the `worker_search` token pipeline,
32
+ * waits synchronously for the result, and decodes the paged result.
33
+ */
34
+ export function handleSearch(
35
+ ctx: HandlerContext,
36
+ params: Record<string, unknown>,
37
+ ): unknown {
38
+ const query = (params['query'] as string | undefined) ?? '';
39
+ const mode = (params['mode'] as string | undefined) ?? 'and';
40
+ const limit = Number(params['limit'] ?? 20);
41
+ const offset = Number(params['offset'] ?? 0);
42
+ const encoded = encodeSearchParams(query, mode, limit, offset);
43
+
44
+ const searchFn = getWasmExport(ctx.modules, 'worker_search');
45
+ const ptr = wasmAlloc(ctx.modules, encoded.length);
46
+ wasmWrite(ctx.modules, ptr, encoded);
47
+ const token = searchFn(ptr, encoded.length) as number;
48
+ wasmFree(ctx.modules, ptr, encoded.length);
49
+
50
+ const statusFn = getWasmExport(ctx.modules, 'worker_result_status');
51
+ const status = statusFn(token) as number;
52
+ if (status === 3) {
53
+ getWasmExport(ctx.modules, 'worker_get_result')(token);
54
+ const errBytes = readReturnSlot(ctx.modules);
55
+ throw new IpcError(-32000, new TextDecoder().decode(errBytes));
56
+ }
57
+
58
+ const getResultFn = getWasmExport(ctx.modules, 'worker_get_result');
59
+ const rc = getResultFn(token) as number;
60
+ if (rc === -1) {
61
+ const errBytes = readReturnSlot(ctx.modules);
62
+ throw new IpcError(-32000, new TextDecoder().decode(errBytes));
63
+ }
64
+ return decodePagedSearchResult(readReturnSlot(ctx.modules));
65
+ }
66
+
67
+ /**
68
+ * Handles the `get_result_status` IPC method.
69
+ */
70
+ export function handleResultStatus(
71
+ ctx: HandlerContext,
72
+ params: Record<string, unknown>,
73
+ ): unknown {
74
+ const token = Number(params['token'] ?? 0);
75
+ const fn = getWasmExport(ctx.modules, 'worker_result_status');
76
+ return { status: fn(token) as number };
77
+ }
78
+
79
+ /**
80
+ * Handles the `get_result` IPC method.
81
+ */
82
+ export function handleGetResult(
83
+ ctx: HandlerContext,
84
+ params: Record<string, unknown>,
85
+ ): unknown {
86
+ const token = Number(params['token'] ?? 0);
87
+ const fn = getWasmExport(ctx.modules, 'worker_get_result');
88
+ const rc = fn(token) as number;
89
+ if (rc === -1) {
90
+ const errBytes = readReturnSlot(ctx.modules);
91
+ throw new IpcError(-32000, new TextDecoder().decode(errBytes));
92
+ }
93
+ return decodePagedSearchResult(readReturnSlot(ctx.modules));
94
+ }
95
+
96
+ /**
97
+ * Handles the `readSections` IPC method.
98
+ */
99
+ export function handleReadSections(
100
+ ctx: HandlerContext,
101
+ params: Record<string, unknown>,
102
+ ): unknown {
103
+ const kbids = (params['kbids'] ?? []) as string[];
104
+ const encoded = encodeKbidList(kbids);
105
+ const bytes = callWasmSync(
106
+ ctx.modules,
107
+ 'worker_read_sections',
108
+ encoded,
109
+ );
110
+ return decodeSectionRecords(bytes);
111
+ }
112
+
113
+ /**
114
+ * Handles the `retrieveDocument` IPC method.
115
+ */
116
+ export function handleRetrieveDoc(
117
+ ctx: HandlerContext,
118
+ params: Record<string, unknown>,
119
+ ): unknown {
120
+ const docid = (params['docid'] as string | undefined) ?? '';
121
+ const encoded = new TextEncoder().encode(docid);
122
+ const bytes = callWasmSync(
123
+ ctx.modules,
124
+ 'worker_retrieve_doc',
125
+ encoded,
126
+ );
127
+ return decodeDocumentManifest(bytes);
128
+ }
129
+
130
+ /**
131
+ * Handles the `content` and `compose` IPC methods.
132
+ */
133
+ export function handleCompose(
134
+ ctx: HandlerContext,
135
+ params: Record<string, unknown>,
136
+ ): unknown {
137
+ const ids = (params['ids'] ?? []) as string[];
138
+ const encoded = encodeIdentifierList(ids);
139
+ const bytes = callWasmSync(ctx.modules, 'worker_compose', encoded);
140
+ const output = decodeComposeOutput(bytes);
141
+ return { data: output.markdown, total: Number(output.totalChars) };
142
+ }
143
+
144
+ /**
145
+ * Handles the `integrityCheck` IPC method.
146
+ */
147
+ export function handleIntegrityCheck(ctx: HandlerContext): unknown {
148
+ callWasmZeroArg(ctx.modules, 'worker_check_integrity');
149
+ const bytes = readReturnSlot(ctx.modules);
150
+ return decodeKeyValueText(new TextDecoder().decode(bytes));
151
+ }
152
+
153
+ /**
154
+ * Handles the `dbStatus` IPC method.
155
+ */
156
+ export function handleDbStatus(ctx: HandlerContext): unknown {
157
+ callWasmZeroArg(ctx.modules, 'worker_status');
158
+ const bytes = readReturnSlot(ctx.modules);
159
+ return decodeKeyValueText(new TextDecoder().decode(bytes));
160
+ }
161
+
162
+ /**
163
+ * Handles the `listByType` IPC method.
164
+ */
165
+ export function handleListByType(
166
+ ctx: HandlerContext,
167
+ params: Record<string, unknown>,
168
+ ): unknown {
169
+ const typeStr = (params['sectionType'] as string | undefined) ?? '';
170
+ const encoded = encodeTypeFilterParam(typeStr);
171
+ const bytes = callWasmSync(
172
+ ctx.modules,
173
+ 'worker_list_by_type',
174
+ encoded,
175
+ );
176
+ return decodeSectionRecordList(bytes);
177
+ }
178
+
179
+ /**
180
+ * Handles the `listDocumentsByType` IPC method.
181
+ */
182
+ export function handleListDocsByType(
183
+ ctx: HandlerContext,
184
+ params: Record<string, unknown>,
185
+ ): unknown {
186
+ const typeStr = (params['docType'] as string | undefined) ?? '';
187
+ const encoded = encodeTypeFilterParam(typeStr);
188
+ const bytes = callWasmSync(
189
+ ctx.modules,
190
+ 'worker_list_docs_by_type',
191
+ encoded,
192
+ );
193
+ return decodeDocumentManifestList(bytes);
194
+ }
195
+
196
+ /**
197
+ * Handles the `recall` IPC method.
198
+ */
199
+ export function handleRecall(
200
+ ctx: HandlerContext,
201
+ params: Record<string, unknown>,
202
+ ): unknown {
203
+ const kbid =
204
+ typeof params['kbid'] === 'string' ? params['kbid'] : undefined;
205
+ const kbids = Array.isArray(params['kbids'])
206
+ ? (params['kbids'] as string[])
207
+ : undefined;
208
+ const depth = Number(params['depth'] ?? 0);
209
+ const encoded = encodeRecallParams({ kbid, kbids, depth });
210
+ const bytes = callWasmSync(ctx.modules, 'worker_recall', encoded);
211
+ return decodeRecallResult(bytes);
212
+ }
213
+
214
+ /**
215
+ * Handles the `export` and `exportDb` IPC methods.
216
+ */
217
+ export function handleExport(
218
+ ctx: HandlerContext,
219
+ params: Record<string, unknown>,
220
+ ): unknown {
221
+ const targetPath =
222
+ (params['targetPath'] as string | undefined) ??
223
+ (params['path'] as string | undefined) ??
224
+ './kbdb-export/';
225
+ const encoded = new TextEncoder().encode(targetPath);
226
+ const start = Date.now();
227
+ const bytes = callWasmSync(ctx.modules, 'worker_export', encoded);
228
+ const elapsed = Date.now() - start;
229
+ const kv = decodeKeyValueText(new TextDecoder().decode(bytes));
230
+ return {
231
+ path: kv['path'] ?? targetPath,
232
+ sections_exported: Number(kv['sections_exported'] ?? 0),
233
+ documents_exported: Number(kv['documents_exported'] ?? 0),
234
+ elapsed_ms: elapsed,
235
+ };
236
+ }
@@ -0,0 +1,257 @@
1
+ import {
2
+ encodeAddSectionParams,
3
+ encodeUpdateSectionParams,
4
+ encodeGroupParams,
5
+ decodeKeyValueText,
6
+ decodeRemoveFlag,
7
+ decodeAddSectionResult,
8
+ } from '../../wasm-codec/index.ts';
9
+ import type { AddSectionInput } from '../../wasm-codec/index.ts';
10
+ import type { HandlerContext } from '../typings/handler-context.interface.ts';
11
+ import { IpcError } from '../classes/ipc-error.class.ts';
12
+ import {
13
+ getWasmExport,
14
+ wasmAlloc,
15
+ wasmWrite,
16
+ wasmFree,
17
+ readReturnSlot,
18
+ callWasmSync,
19
+ callWasmZeroArg,
20
+ } from './wasm-bridge.function.ts';
21
+ import { scanNearDuplicates } from './scan-near-duplicates.function.ts';
22
+
23
+ /**
24
+ * Handles the `addSection` IPC method.
25
+ *
26
+ * Encodes the section input, delegates to `worker_add_section`, and
27
+ * runs a near-duplicate scan when the WASM result reports none.
28
+ */
29
+ export function handleAddSection(
30
+ ctx: HandlerContext,
31
+ params: Record<string, unknown>,
32
+ ): unknown {
33
+ const sectionType = (params['sectionType'] ?? 'text') as string;
34
+ const semanticType =
35
+ sectionType === 'text' ||
36
+ sectionType === 'code' ||
37
+ sectionType === 'image'
38
+ ? sectionType
39
+ : 'text';
40
+ const typeName = sectionType !== semanticType ? sectionType : null;
41
+ const tags = Array.isArray(params['tags'])
42
+ ? (params['tags'] as string[])
43
+ : [];
44
+ const content = (params['content'] as string | undefined) ?? '';
45
+ const input: AddSectionInput = {
46
+ sectionType: semanticType,
47
+ mimeType: params['mimeType'] as string | undefined,
48
+ content,
49
+ title: (params['title'] as string | null) ?? null,
50
+ description: (params['description'] as string | null) ?? null,
51
+ docid: (params['docid'] as string | null) ?? null,
52
+ typeName,
53
+ sourcePath:
54
+ typeof params['sourcePath'] === 'string'
55
+ ? params['sourcePath']
56
+ : undefined,
57
+ sourceMtime:
58
+ typeof params['sourceMtime'] === 'string'
59
+ ? params['sourceMtime']
60
+ : undefined,
61
+ tags,
62
+ replace: params['replace'] === true,
63
+ };
64
+ const encoded = encodeAddSectionParams(input);
65
+ const bytes = callWasmSync(
66
+ ctx.modules,
67
+ 'worker_add_section',
68
+ encoded,
69
+ );
70
+ const decoded = decodeAddSectionResult(bytes);
71
+ const nearDups =
72
+ decoded.nearDuplicates.length > 0
73
+ ? decoded.nearDuplicates
74
+ : scanNearDuplicates(ctx.targetDir, content, decoded.kbid);
75
+ return {
76
+ kbid: decoded.kbid,
77
+ indexed_terms_count: decoded.indexedTermsCount,
78
+ elapsed_ms: decoded.elapsedMs,
79
+ superseded: decoded.superseded,
80
+ warnings: decoded.warnings,
81
+ near_duplicates: nearDups,
82
+ };
83
+ }
84
+
85
+ /**
86
+ * Handles the `updateSection` IPC method.
87
+ */
88
+ export function handleUpdateSection(
89
+ ctx: HandlerContext,
90
+ params: Record<string, unknown>,
91
+ ): unknown {
92
+ const oldKbid = (params['kbid'] as string | undefined) ?? '';
93
+ const updSectionType = (params['sectionType'] ?? 'text') as string;
94
+ const updSemanticType =
95
+ updSectionType === 'text' ||
96
+ updSectionType === 'code' ||
97
+ updSectionType === 'image'
98
+ ? updSectionType
99
+ : 'text';
100
+ const updTypeName =
101
+ updSectionType !== updSemanticType ? updSectionType : null;
102
+ const input: AddSectionInput = {
103
+ sectionType: updSemanticType,
104
+ mimeType: params['mimeType'] as string | undefined,
105
+ content: (params['content'] as string | undefined) ?? '',
106
+ title: (params['title'] as string | null) ?? null,
107
+ description: (params['description'] as string | null) ?? null,
108
+ docid: (params['docid'] as string | null) ?? null,
109
+ typeName: updTypeName,
110
+ };
111
+ const encoded = encodeUpdateSectionParams(oldKbid, input);
112
+ const bytes = callWasmSync(
113
+ ctx.modules,
114
+ 'worker_update_section',
115
+ encoded,
116
+ );
117
+ return { kbid: new TextDecoder().decode(bytes) };
118
+ }
119
+
120
+ /**
121
+ * Handles the `removeSection` IPC method.
122
+ */
123
+ export function handleRemoveSection(
124
+ ctx: HandlerContext,
125
+ params: Record<string, unknown>,
126
+ ): unknown {
127
+ const kbid = (params['kbid'] as string | undefined) ?? '';
128
+ const encoded = new TextEncoder().encode(kbid);
129
+ const bytes = callWasmSync(
130
+ ctx.modules,
131
+ 'worker_remove_section',
132
+ encoded,
133
+ );
134
+ return { removed: decodeRemoveFlag(bytes) };
135
+ }
136
+
137
+ /**
138
+ * Handles the `groupSections` IPC method.
139
+ */
140
+ export function handleGroupSections(
141
+ ctx: HandlerContext,
142
+ params: Record<string, unknown>,
143
+ ): unknown {
144
+ const title = (params['title'] as string | undefined) ?? '';
145
+ const kbids = (params['kbids'] ?? []) as string[];
146
+ const docType = (params['docType'] as string | undefined) ?? '';
147
+ const encoded = encodeGroupParams(title, kbids, docType);
148
+ const bytes = callWasmSync(
149
+ ctx.modules,
150
+ 'worker_group_sections',
151
+ encoded,
152
+ );
153
+ return { docid: new TextDecoder().decode(bytes) };
154
+ }
155
+
156
+ /**
157
+ * Handles the `removeGrouping` IPC method.
158
+ */
159
+ export function handleRemoveGrouping(
160
+ ctx: HandlerContext,
161
+ params: Record<string, unknown>,
162
+ ): unknown {
163
+ const docid = (params['docid'] as string | undefined) ?? '';
164
+ callWasmSync(
165
+ ctx.modules,
166
+ 'worker_remove_grouping',
167
+ new TextEncoder().encode(docid),
168
+ );
169
+ return { ok: true };
170
+ }
171
+
172
+ /**
173
+ * Handles the `initDirectory` IPC method.
174
+ */
175
+ export function handleInitDirectory(
176
+ ctx: HandlerContext,
177
+ params: Record<string, unknown>,
178
+ ): unknown {
179
+ const path = (params['path'] as string | undefined) ?? ctx.targetDir;
180
+ callWasmSync(
181
+ ctx.modules,
182
+ 'worker_init_directory',
183
+ new TextEncoder().encode(path),
184
+ );
185
+ return { ok: true };
186
+ }
187
+
188
+ /**
189
+ * Handles the `invalidate` IPC method.
190
+ */
191
+ export function handleInvalidate(
192
+ ctx: HandlerContext,
193
+ params: Record<string, unknown>,
194
+ ): unknown {
195
+ const kbid = (params['kbid'] as string | undefined) ?? '';
196
+ const encoded = new TextEncoder().encode(kbid);
197
+ const fn = getWasmExport(ctx.modules, 'worker_invalidate');
198
+ const ptr = wasmAlloc(ctx.modules, encoded.length);
199
+ wasmWrite(ctx.modules, ptr, encoded);
200
+ const rc = fn(ptr, encoded.length) as number;
201
+ wasmFree(ctx.modules, ptr, encoded.length);
202
+ if (rc === -1) {
203
+ const errBytes = readReturnSlot(ctx.modules);
204
+ throw new IpcError(
205
+ -32000,
206
+ new TextDecoder().decode(errBytes) || 'invalidate failed',
207
+ );
208
+ }
209
+ return { ok: true };
210
+ }
211
+
212
+ /**
213
+ * Handles the `invalidateAll` IPC method.
214
+ */
215
+ export function handleInvalidateAll(ctx: HandlerContext): unknown {
216
+ callWasmZeroArg(ctx.modules, 'worker_invalidate_all');
217
+ return { ok: true };
218
+ }
219
+
220
+ /**
221
+ * Handles the `gc` IPC method.
222
+ */
223
+ export function handleGc(ctx: HandlerContext): unknown {
224
+ const start = Date.now();
225
+ callWasmZeroArg(ctx.modules, 'worker_garbage_collect');
226
+ const bytes = readReturnSlot(ctx.modules);
227
+ const kv = decodeKeyValueText(new TextDecoder().decode(bytes));
228
+ return {
229
+ removed_sections: Number(kv['removed'] ?? 0),
230
+ removed_bytes: 0,
231
+ elapsed_ms: Date.now() - start,
232
+ stale_sources: Number(kv['stale_sources'] ?? 0),
233
+ };
234
+ }
235
+
236
+ /**
237
+ * Handles the `rebuildIndexes` IPC method.
238
+ */
239
+ export function handleRebuild(ctx: HandlerContext): unknown {
240
+ const fn = getWasmExport(ctx.modules, 'worker_rebuild_indexes');
241
+ const rc = fn() as number;
242
+ if (rc === -1) {
243
+ const errBytes = readReturnSlot(ctx.modules);
244
+ const errMsg = new TextDecoder().decode(errBytes);
245
+ throw new IpcError(-32000, errMsg || 'rebuild failed');
246
+ }
247
+ const resultBytes = readReturnSlot(ctx.modules);
248
+ const reindexed =
249
+ resultBytes.length >= 4
250
+ ? new DataView(
251
+ resultBytes.buffer,
252
+ resultBytes.byteOffset,
253
+ resultBytes.byteLength,
254
+ ).getUint32(0, true)
255
+ : 0;
256
+ return { ok: true, sections_reindexed: reindexed };
257
+ }
@@ -0,0 +1,51 @@
1
+ import type { AutoCaptureConfig } from '../../auto-capture/typings/auto-capture-config.interface.ts';
2
+ import { AUTO_CAPTURE_DEFAULTS } from '../../auto-capture/constants/auto-capture-defaults.constant.ts';
3
+
4
+ /**
5
+ * Parses key-value pairs from an `[auto_capture]` TOML section
6
+ * into an `AutoCaptureConfig`.
7
+ *
8
+ * Recognised keys: `enabled`, `trigger_after_tool_calls`,
9
+ * `min_interval_ms`, `max_captures_per_session`, `dry_run`.
10
+ * Unknown keys are silently ignored. Falls back to
11
+ * `AUTO_CAPTURE_DEFAULTS` for any absent key.
12
+ *
13
+ * @param entries - key-value pairs from inside the
14
+ * `[auto_capture]` section
15
+ */
16
+ export function parseAutoCaptureSection(
17
+ entries: ReadonlyMap<string, string>,
18
+ ): AutoCaptureConfig {
19
+ const enabled = entries.has('enabled')
20
+ ? entries.get('enabled') === 'true'
21
+ : AUTO_CAPTURE_DEFAULTS.enabled;
22
+
23
+ const dryRun = entries.has('dry_run')
24
+ ? entries.get('dry_run') === 'true'
25
+ : AUTO_CAPTURE_DEFAULTS.dryRun;
26
+
27
+ const triggerRaw = entries.get('trigger_after_tool_calls');
28
+ const triggerAfterToolCalls = triggerRaw
29
+ ? parseInt(triggerRaw, 10) ||
30
+ AUTO_CAPTURE_DEFAULTS.triggerAfterToolCalls
31
+ : AUTO_CAPTURE_DEFAULTS.triggerAfterToolCalls;
32
+
33
+ const intervalRaw = entries.get('min_interval_ms');
34
+ const minIntervalMs = intervalRaw
35
+ ? parseInt(intervalRaw, 10) || AUTO_CAPTURE_DEFAULTS.minIntervalMs
36
+ : AUTO_CAPTURE_DEFAULTS.minIntervalMs;
37
+
38
+ const capRaw = entries.get('max_captures_per_session');
39
+ const maxCapturesPerSession = capRaw
40
+ ? parseInt(capRaw, 10) ||
41
+ AUTO_CAPTURE_DEFAULTS.maxCapturesPerSession
42
+ : AUTO_CAPTURE_DEFAULTS.maxCapturesPerSession;
43
+
44
+ return {
45
+ enabled,
46
+ triggerAfterToolCalls,
47
+ minIntervalMs,
48
+ maxCapturesPerSession,
49
+ dryRun,
50
+ };
51
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Parses the `version` field from a minimal TOML string.
3
+ *
4
+ * Supports only `version = <integer>` syntax. Comment lines are
5
+ * skipped. Returns `null` when no `version` field is present.
6
+ *
7
+ * @param text - raw TOML text from `catalog.toml`
8
+ * @returns the integer version, or `null` if absent
9
+ */
10
+ export function parseCatalogVersion(text: string): number | null {
11
+ for (const line of text.split('\n')) {
12
+ const trimmed = line.trim();
13
+ if (trimmed.startsWith('#')) continue;
14
+ const match = /^version\s*=\s*(\d+)/.exec(trimmed);
15
+ if (match?.[1] !== undefined) {
16
+ return parseInt(match[1], 10);
17
+ }
18
+ }
19
+ return null;
20
+ }
@@ -0,0 +1,38 @@
1
+ import type { EmbeddingConfig } from '../../embedding/typings/embedding-config.interface.ts';
2
+
3
+ /**
4
+ * Parses key-value pairs from a `[embedding]` TOML section into an
5
+ * `EmbeddingConfig`.
6
+ *
7
+ * Recognises: `provider`, `model`, `endpoint`, `dimensions`.
8
+ * Unknown keys are silently ignored. Returns `undefined` when the
9
+ * `provider` key is absent from the supplied entries.
10
+ *
11
+ * @param entries - key-value pairs from inside the `[embedding]`
12
+ * section
13
+ */
14
+ export function parseEmbeddingSection(
15
+ entries: ReadonlyMap<string, string>,
16
+ ): EmbeddingConfig | undefined {
17
+ const provider = entries.get('provider') as
18
+ | EmbeddingConfig['provider']
19
+ | undefined;
20
+
21
+ if (!provider) {
22
+ return undefined;
23
+ }
24
+
25
+ const model = entries.get('model');
26
+ const endpoint = entries.get('endpoint');
27
+ const dimensionsRaw = entries.get('dimensions');
28
+ const dimensions = dimensionsRaw
29
+ ? parseInt(dimensionsRaw, 10) || undefined
30
+ : undefined;
31
+
32
+ return {
33
+ provider,
34
+ ...(model !== undefined ? { model } : {}),
35
+ ...(endpoint !== undefined ? { endpoint } : {}),
36
+ ...(dimensions !== undefined ? { dimensions } : {}),
37
+ };
38
+ }
@@ -0,0 +1,104 @@
1
+ import type { DaemonConfig } from '../typings/daemon-config.interface.ts';
2
+ import {
3
+ DEFAULT_ITEM_LIMIT,
4
+ DEFAULT_INDEX_LIMIT,
5
+ DEFAULT_TIMEOUT_MS,
6
+ DEFAULT_ITEM_TTL_MS,
7
+ } from '../constants/daemon-defaults.constant.ts';
8
+ import { parseEmbeddingSection } from './parse-embedding-section.function.ts';
9
+ import { parseAutoCaptureSection } from './parse-auto-capture-section.function.ts';
10
+
11
+ interface RootAccum {
12
+ itemLimit: number;
13
+ indexLimit: number;
14
+ timeoutMs: number;
15
+ itemTtlMs: number;
16
+ }
17
+
18
+ function applyRootKey(
19
+ acc: RootAccum,
20
+ key: string,
21
+ value: string,
22
+ ): void {
23
+ switch (key) {
24
+ case 'item_limit':
25
+ acc.itemLimit = parseInt(value, 10) || DEFAULT_ITEM_LIMIT;
26
+ break;
27
+ case 'index_limit':
28
+ acc.indexLimit = parseInt(value, 10) || DEFAULT_INDEX_LIMIT;
29
+ break;
30
+ case 'timeout_ms':
31
+ acc.timeoutMs = parseInt(value, 10) || DEFAULT_TIMEOUT_MS;
32
+ break;
33
+ case 'item_ttl_ms':
34
+ acc.itemTtlMs = parseInt(value, 10) || DEFAULT_ITEM_TTL_MS;
35
+ break;
36
+ default:
37
+ break;
38
+ }
39
+ }
40
+
41
+ /**
42
+ * Parses a `worker.toml` file body into a partial `DaemonConfig`.
43
+ *
44
+ * Handles `[embedding]` sub-sections and root key-value pairs.
45
+ * Unknown keys are silently ignored.
46
+ *
47
+ * @param text - raw content of `worker.toml`
48
+ * @param contextPath - daemon context directory path
49
+ */
50
+ export function parseWorkerToml(
51
+ text: string,
52
+ contextPath: string,
53
+ ): DaemonConfig {
54
+ let section = '';
55
+ const embeddingEntries = new Map<string, string>();
56
+ const autoCaptureEntries = new Map<string, string>();
57
+ const acc: RootAccum = {
58
+ itemLimit: DEFAULT_ITEM_LIMIT,
59
+ indexLimit: DEFAULT_INDEX_LIMIT,
60
+ timeoutMs: DEFAULT_TIMEOUT_MS,
61
+ itemTtlMs: DEFAULT_ITEM_TTL_MS,
62
+ };
63
+
64
+ for (const line of text.split('\n')) {
65
+ const trimmed = line.trim();
66
+ if (trimmed === '[embedding]') {
67
+ section = 'embedding';
68
+ continue;
69
+ }
70
+ if (trimmed === '[auto_capture]') {
71
+ section = 'auto_capture';
72
+ continue;
73
+ }
74
+ if (trimmed.startsWith('[')) {
75
+ section = '';
76
+ continue;
77
+ }
78
+ if (trimmed.startsWith('#') || !trimmed.includes('=')) continue;
79
+ const eqIdx = trimmed.indexOf('=');
80
+ const key = trimmed.slice(0, eqIdx).trim();
81
+ const value = trimmed.slice(eqIdx + 1).trim();
82
+ if (section === 'embedding') {
83
+ embeddingEntries.set(key, value);
84
+ continue;
85
+ }
86
+ if (section === 'auto_capture') {
87
+ autoCaptureEntries.set(key, value);
88
+ continue;
89
+ }
90
+ applyRootKey(acc, key, value);
91
+ }
92
+
93
+ const embedding = parseEmbeddingSection(embeddingEntries);
94
+ const autoCapture =
95
+ autoCaptureEntries.size > 0
96
+ ? parseAutoCaptureSection(autoCaptureEntries)
97
+ : undefined;
98
+ return {
99
+ contextPath,
100
+ ...acc,
101
+ ...(embedding !== undefined ? { embedding } : {}),
102
+ ...(autoCapture !== undefined ? { autoCapture } : {}),
103
+ };
104
+ }