hippo-memory 2.0.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (970) hide show
  1. package/README.md +14 -10
  2. package/bin/hippo.js +5 -1
  3. package/dist/agent-memories/apply.d.ts +7 -5
  4. package/dist/agent-memories/apply.js +66 -39
  5. package/dist/agent-memories/claude-code.d.ts +8 -2
  6. package/dist/agent-memories/claude-code.js +26 -7
  7. package/dist/agent-memories/copilot.js +2 -1
  8. package/dist/agent-memories/files.js +2 -1
  9. package/dist/agent-memories/legacy.d.ts +6 -3
  10. package/dist/agent-memories/legacy.js +35 -14
  11. package/dist/agent-memories/markdown.d.ts +3 -1
  12. package/dist/agent-memories/markdown.js +3 -1
  13. package/dist/agent-memories/openclaw.js +5 -2
  14. package/dist/agent-memories/plan.js +11 -1
  15. package/dist/agent-memories/project-folds.js +2 -1
  16. package/dist/agent-memories/report.d.ts +4 -1
  17. package/dist/agent-memories/report.js +43 -9
  18. package/dist/agent-memories/source.d.ts +8 -2
  19. package/dist/agent-memories/source.js +11 -3
  20. package/dist/agent-memories/sync.d.ts +7 -2
  21. package/dist/agent-memories/sync.js +141 -101
  22. package/dist/api/assemble.d.ts +6 -4
  23. package/dist/api/assemble.js +11 -6
  24. package/dist/api/{audit.d.ts → auth/audit.d.ts} +18 -16
  25. package/dist/api/{audit.js → auth/audit.js} +11 -11
  26. package/dist/api/{auth.d.ts → auth/auth.d.ts} +19 -15
  27. package/dist/api/{auth.js → auth/auth.js} +46 -29
  28. package/dist/api/{quarantine.d.ts → auth/quarantine.d.ts} +8 -7
  29. package/dist/api/{quarantine.js → auth/quarantine.js} +8 -8
  30. package/dist/api/auth/session-owners.d.ts +10 -0
  31. package/dist/api/auth/session-owners.js +35 -0
  32. package/dist/api/availability.d.ts +3 -1
  33. package/dist/api/availability.js +3 -1
  34. package/dist/api/busy.d.ts +2 -0
  35. package/dist/api/busy.js +2 -0
  36. package/dist/api/cli-surface.d.ts +6 -0
  37. package/dist/api/cli-surface.js +6 -0
  38. package/dist/api/config-of.d.ts +5 -0
  39. package/dist/api/config-of.js +6 -0
  40. package/dist/api/context-auto.d.ts +4 -1
  41. package/dist/api/context-auto.js +10 -2
  42. package/dist/api/context-render.d.ts +3 -1
  43. package/dist/api/context-render.js +38 -9
  44. package/dist/api/context-select.d.ts +4 -1
  45. package/dist/api/context-select.js +23 -14
  46. package/dist/api/context-types.d.ts +47 -14
  47. package/dist/api/context.d.ts +8 -5
  48. package/dist/api/context.js +151 -69
  49. package/dist/api/continuity.d.ts +24 -21
  50. package/dist/api/continuity.js +18 -20
  51. package/dist/api/correction-latency.d.ts +3 -1
  52. package/dist/api/correction-latency.js +3 -1
  53. package/dist/api/error-reply.d.ts +4 -1
  54. package/dist/api/error-reply.js +12 -3
  55. package/dist/api/index.d.ts +39 -23
  56. package/dist/api/index.js +21 -23
  57. package/dist/api/instruction-detect.d.ts +4 -1
  58. package/dist/api/instruction-detect.js +75 -20
  59. package/dist/api/ledger-db.d.ts +15 -11
  60. package/dist/api/ledger-db.js +21 -23
  61. package/dist/api/memories/conflicts.d.ts +33 -0
  62. package/dist/api/memories/conflicts.js +67 -0
  63. package/dist/api/{forget.d.ts → memories/forget.d.ts} +11 -9
  64. package/dist/api/{forget.js → memories/forget.js} +22 -15
  65. package/dist/api/memories/memories.d.ts +27 -0
  66. package/dist/api/{memories.js → memories/memories.js} +16 -21
  67. package/dist/api/memories/outcome.d.ts +22 -0
  68. package/dist/api/{outcome.js → memories/outcome.js} +14 -8
  69. package/dist/api/memories/promote.d.ts +40 -0
  70. package/dist/api/{promote.js → memories/promote.js} +35 -22
  71. package/dist/api/memories/refine.d.ts +10 -0
  72. package/dist/api/memories/refine.js +12 -0
  73. package/dist/api/{remember-local.d.ts → memories/remember-local.d.ts} +16 -11
  74. package/dist/api/{remember-local.js → memories/remember-local.js} +34 -20
  75. package/dist/api/{remember.d.ts → memories/remember.d.ts} +19 -13
  76. package/dist/api/{remember.js → memories/remember.js} +42 -26
  77. package/dist/api/objects/cards.d.ts +39 -0
  78. package/dist/api/{cards.js → objects/cards.js} +12 -14
  79. package/dist/api/{drill-down.d.ts → objects/drill-down.d.ts} +12 -10
  80. package/dist/api/{drill-down.js → objects/drill-down.js} +7 -8
  81. package/dist/api/objects/goals.d.ts +18 -0
  82. package/dist/api/{goals.js → objects/goals.js} +12 -12
  83. package/dist/api/objects/graph.d.ts +11 -0
  84. package/dist/api/objects/graph.js +16 -0
  85. package/dist/api/objects/objects.d.ts +9 -0
  86. package/dist/api/{objects.js → objects/objects.js} +2 -4
  87. package/dist/api/objects/predictions.d.ts +11 -0
  88. package/dist/api/{predictions.js → objects/predictions.js} +7 -6
  89. package/dist/api/{projects.d.ts → objects/projects.d.ts} +8 -5
  90. package/dist/api/{projects.js → objects/projects.js} +8 -4
  91. package/dist/api/pilot-arm.d.ts +8 -4
  92. package/dist/api/pilot-arm.js +5 -4
  93. package/dist/api/prompt-hook.d.ts +34 -19
  94. package/dist/api/prompt-hook.js +68 -46
  95. package/dist/api/provenance-coverage.d.ts +3 -1
  96. package/dist/api/provenance-coverage.js +3 -1
  97. package/dist/api/recall/finish.d.ts +185 -0
  98. package/dist/api/recall/finish.js +301 -0
  99. package/dist/api/{recall-pipeline.d.ts → recall/pipeline.d.ts} +12 -8
  100. package/dist/api/{recall-pipeline.js → recall/pipeline.js} +176 -92
  101. package/dist/api/recall/recall.d.ts +6 -0
  102. package/dist/api/{recall.js → recall/recall.js} +101 -60
  103. package/dist/api/recall/render.d.ts +39 -0
  104. package/dist/api/recall/render.js +60 -0
  105. package/dist/api/{recall-request.d.ts → recall/request.d.ts} +7 -5
  106. package/dist/api/recall/request.js +261 -0
  107. package/dist/api/{recall-cli.d.ts → recall/rows.d.ts} +18 -12
  108. package/dist/api/{recall-cli.js → recall/rows.js} +28 -27
  109. package/dist/api/{recall-types.d.ts → recall/types.d.ts} +95 -70
  110. package/dist/api/{recall-types.js → recall/types.js} +1 -1
  111. package/dist/api/session-end.d.ts +16 -12
  112. package/dist/api/session-end.js +46 -30
  113. package/dist/api/{auto-sleep.d.ts → sleep/auto-sleep.d.ts} +9 -5
  114. package/dist/api/{auto-sleep.js → sleep/auto-sleep.js} +7 -12
  115. package/dist/api/sleep/dormant.d.ts +25 -0
  116. package/dist/api/sleep/dormant.js +64 -0
  117. package/dist/api/{learn.d.ts → sleep/learn.d.ts} +5 -4
  118. package/dist/api/sleep/learn.js +138 -0
  119. package/dist/api/sleep/sleep-run.d.ts +38 -0
  120. package/dist/api/{sleep-run.js → sleep/sleep-run.js} +51 -43
  121. package/dist/api/{sleep.d.ts → sleep/sleep.d.ts} +17 -11
  122. package/dist/api/sleep/sleep.js +9 -0
  123. package/dist/api/status.d.ts +3 -1
  124. package/dist/api/status.js +3 -1
  125. package/dist/api/store-init.d.ts +4 -1
  126. package/dist/api/store-init.js +4 -1
  127. package/dist/api/tokens.d.ts +10 -9
  128. package/dist/api/tokens.js +9 -10
  129. package/dist/api/types.d.ts +28 -7
  130. package/dist/api/types.js +13 -4
  131. package/dist/capture/caller-session.d.ts +8 -2
  132. package/dist/capture/caller-session.js +16 -6
  133. package/dist/capture/capture-error.d.ts +3 -1
  134. package/dist/capture/capture-error.js +3 -1
  135. package/dist/capture/codex-patch.js +7 -2
  136. package/dist/capture/command.d.ts +4 -2
  137. package/dist/capture/command.js +33 -14
  138. package/dist/capture/compact-resume-caller.js +15 -8
  139. package/dist/capture/compact.d.ts +8 -5
  140. package/dist/capture/compact.js +34 -23
  141. package/dist/capture/compaction-items-caller.js +9 -3
  142. package/dist/capture/compaction-record.d.ts +4 -3
  143. package/dist/capture/compaction-record.js +20 -12
  144. package/dist/capture/compaction-spool.d.ts +15 -4
  145. package/dist/capture/compaction-spool.js +64 -17
  146. package/dist/capture/copilot-transcript.d.ts +11 -4
  147. package/dist/capture/copilot-transcript.js +17 -8
  148. package/dist/capture/extract.js +20 -8
  149. package/dist/capture/failure-caller.js +23 -12
  150. package/dist/capture/failure-reading.d.ts +10 -3
  151. package/dist/capture/failure-reading.js +24 -7
  152. package/dist/capture/pre-compact-caller.js +11 -4
  153. package/dist/capture/session-digest.d.ts +15 -4
  154. package/dist/capture/session-digest.js +39 -13
  155. package/dist/capture/session-end-caller.d.ts +4 -1
  156. package/dist/capture/session-end-caller.js +20 -8
  157. package/dist/capture/session-texts.d.ts +6 -2
  158. package/dist/capture/session-texts.js +22 -7
  159. package/dist/capture/session-worker.d.ts +4 -2
  160. package/dist/capture/session-worker.js +46 -18
  161. package/dist/capture/transcript.d.ts +13 -4
  162. package/dist/capture/transcript.js +32 -10
  163. package/dist/capture/working-state.d.ts +13 -4
  164. package/dist/capture/working-state.js +50 -56
  165. package/dist/cli/api-context.d.ts +14 -2
  166. package/dist/cli/api-context.js +45 -2
  167. package/dist/cli/audit.js +23 -23
  168. package/dist/cli/auth.js +19 -27
  169. package/dist/cli/briefs.d.ts +1 -1
  170. package/dist/cli/briefs.js +20 -15
  171. package/dist/cli/card.d.ts +1 -1
  172. package/dist/cli/card.js +56 -73
  173. package/dist/cli/client.d.ts +12 -4
  174. package/dist/cli/client.js +43 -13
  175. package/dist/cli/compact-resume-payload.d.ts +4 -1
  176. package/dist/cli/compact-resume-payload.js +12 -5
  177. package/dist/cli/context.js +48 -21
  178. package/dist/cli/continuity.d.ts +5 -5
  179. package/dist/cli/continuity.js +90 -107
  180. package/dist/cli/curate.d.ts +4 -3
  181. package/dist/cli/curate.js +46 -68
  182. package/dist/cli/dag.d.ts +1 -1
  183. package/dist/cli/dag.js +14 -17
  184. package/dist/cli/decisions.js +27 -26
  185. package/dist/cli/eval.js +16 -21
  186. package/dist/cli/exit.d.ts +4 -1
  187. package/dist/cli/exit.js +10 -2
  188. package/dist/cli/explain.js +12 -11
  189. package/dist/cli/flag-values.d.ts +1 -1
  190. package/dist/cli/flag-values.js +9 -18
  191. package/dist/cli/github.d.ts +6 -0
  192. package/dist/cli/github.js +25 -13
  193. package/dist/cli/goals.d.ts +1 -1
  194. package/dist/cli/goals.js +39 -56
  195. package/dist/cli/graph.d.ts +1 -1
  196. package/dist/cli/graph.js +15 -11
  197. package/dist/cli/hook-runtime.d.ts +31 -9
  198. package/dist/cli/hook-runtime.js +40 -15
  199. package/dist/cli/incidents.d.ts +1 -1
  200. package/dist/cli/incidents.js +25 -25
  201. package/dist/cli/init.js +26 -11
  202. package/dist/cli/install-steps.d.ts +12 -3
  203. package/dist/cli/install-steps.js +42 -18
  204. package/dist/cli/last-sleep.d.ts +4 -1
  205. package/dist/cli/last-sleep.js +9 -4
  206. package/dist/cli/maintenance.d.ts +1 -1
  207. package/dist/cli/maintenance.js +11 -12
  208. package/dist/cli/notes.d.ts +1 -1
  209. package/dist/cli/notes.js +8 -5
  210. package/dist/cli/object-verbs.d.ts +4 -4
  211. package/dist/cli/object-verbs.js +10 -13
  212. package/dist/cli/open-browser.js +11 -2
  213. package/dist/cli/playbooks.d.ts +3 -3
  214. package/dist/cli/playbooks.js +40 -32
  215. package/dist/cli/predictions.js +15 -19
  216. package/dist/cli/print.js +4 -2
  217. package/dist/cli/projects.js +21 -11
  218. package/dist/cli/quality-repair-once.js +5 -4
  219. package/dist/cli/recall.js +129 -93
  220. package/dist/cli/refine-llm.d.ts +15 -4
  221. package/dist/cli/refine-llm.js +16 -7
  222. package/dist/cli/remember.js +46 -50
  223. package/dist/cli/scheduler.d.ts +4 -1
  224. package/dist/cli/scheduler.js +9 -5
  225. package/dist/cli/serve.js +22 -17
  226. package/dist/cli/session-hooks.d.ts +2 -2
  227. package/dist/cli/session-hooks.js +89 -51
  228. package/dist/cli/setup.js +54 -32
  229. package/dist/cli/shared.d.ts +3 -1
  230. package/dist/cli/shared.js +24 -9
  231. package/dist/cli/slack.js +15 -24
  232. package/dist/cli/sleep-render.d.ts +3 -1
  233. package/dist/cli/sleep-render.js +8 -5
  234. package/dist/cli/sleep.js +14 -6
  235. package/dist/cli/status.d.ts +4 -4
  236. package/dist/cli/status.js +32 -27
  237. package/dist/cli/stdin.d.ts +10 -3
  238. package/dist/cli/stdin.js +10 -3
  239. package/dist/cli/transfer.d.ts +1 -1
  240. package/dist/cli/transfer.js +71 -75
  241. package/dist/cli/verbs/memory.js +8 -6
  242. package/dist/cli/verbs/objects.js +10 -4
  243. package/dist/cli/versioned-verbs.d.ts +8 -7
  244. package/dist/cli/versioned-verbs.js +31 -21
  245. package/dist/cli.js +13 -16
  246. package/dist/connectors/dlq.d.ts +6 -6
  247. package/dist/connectors/dlq.js +12 -8
  248. package/dist/connectors/github/backfill.d.ts +4 -4
  249. package/dist/connectors/github/backfill.js +6 -4
  250. package/dist/connectors/github/deletion.d.ts +6 -4
  251. package/dist/connectors/github/deletion.js +5 -5
  252. package/dist/connectors/github/dlq.d.ts +8 -6
  253. package/dist/connectors/github/dlq.js +11 -5
  254. package/dist/connectors/github/ingest.d.ts +2 -2
  255. package/dist/connectors/github/ingest.js +9 -6
  256. package/dist/connectors/github/octokit-client.d.ts +3 -1
  257. package/dist/connectors/github/octokit-client.js +7 -2
  258. package/dist/connectors/github/ratelimit.d.ts +6 -2
  259. package/dist/connectors/github/ratelimit.js +6 -2
  260. package/dist/connectors/github/signature.d.ts +14 -3
  261. package/dist/connectors/github/signature.js +17 -3
  262. package/dist/connectors/github/tenant-routing.d.ts +6 -4
  263. package/dist/connectors/github/tenant-routing.js +6 -6
  264. package/dist/connectors/github/transform.js +50 -67
  265. package/dist/connectors/github/types.d.ts +10 -3
  266. package/dist/connectors/github/types.js +6 -2
  267. package/dist/connectors/github/webhook.d.ts +5 -5
  268. package/dist/connectors/github/webhook.js +34 -23
  269. package/dist/connectors/ingest.d.ts +5 -3
  270. package/dist/connectors/ingest.js +3 -4
  271. package/dist/connectors/slack/backfill.d.ts +5 -5
  272. package/dist/connectors/slack/backfill.js +3 -3
  273. package/dist/connectors/slack/deletion.d.ts +4 -4
  274. package/dist/connectors/slack/deletion.js +6 -6
  275. package/dist/connectors/slack/dlq.d.ts +4 -4
  276. package/dist/connectors/slack/dlq.js +6 -6
  277. package/dist/connectors/slack/ingest.d.ts +6 -4
  278. package/dist/connectors/slack/ingest.js +5 -5
  279. package/dist/connectors/slack/signature.d.ts +4 -1
  280. package/dist/connectors/slack/tenant-routing.d.ts +6 -4
  281. package/dist/connectors/slack/tenant-routing.js +6 -6
  282. package/dist/connectors/slack/transform.d.ts +6 -2
  283. package/dist/connectors/slack/transform.js +6 -2
  284. package/dist/connectors/slack/types.d.ts +3 -1
  285. package/dist/connectors/slack/web-client.js +8 -3
  286. package/dist/connectors/slack/webhook.d.ts +5 -5
  287. package/dist/connectors/slack/webhook.js +19 -11
  288. package/dist/connectors/slack/workspaces.d.ts +7 -3
  289. package/dist/connectors/slack/workspaces.js +7 -3
  290. package/dist/connectors/store.d.ts +8 -0
  291. package/dist/connectors/store.js +2 -0
  292. package/dist/consolidate/conflicts.js +23 -9
  293. package/dist/consolidate/dag-summary.js +2 -1
  294. package/dist/consolidate/dag.d.ts +10 -5
  295. package/dist/consolidate/dag.js +37 -36
  296. package/dist/consolidate/decay.js +19 -6
  297. package/dist/consolidate/dedupe.d.ts +14 -5
  298. package/dist/consolidate/dedupe.js +27 -16
  299. package/dist/consolidate/flush-units.d.ts +4 -1
  300. package/dist/consolidate/flush-units.js +4 -1
  301. package/dist/consolidate/half-life-migration.d.ts +18 -8
  302. package/dist/consolidate/half-life-migration.js +48 -18
  303. package/dist/consolidate/llm-passes.js +27 -11
  304. package/dist/consolidate/memory-value-weights.d.ts +6 -2
  305. package/dist/consolidate/memory-value-weights.js +6 -2
  306. package/dist/consolidate/memory-value.d.ts +30 -10
  307. package/dist/consolidate/memory-value.js +36 -13
  308. package/dist/consolidate/merge.d.ts +4 -1
  309. package/dist/consolidate/merge.js +42 -32
  310. package/dist/consolidate/overlap-index.d.ts +8 -2
  311. package/dist/consolidate/overlap-index.js +11 -4
  312. package/dist/consolidate/physics-pass.d.ts +3 -1
  313. package/dist/consolidate/physics-pass.js +10 -7
  314. package/dist/consolidate/replay.d.ts +11 -4
  315. package/dist/consolidate/replay.js +19 -7
  316. package/dist/consolidate/run.d.ts +13 -5
  317. package/dist/consolidate/run.js +4 -4
  318. package/dist/consolidate/sleep.d.ts +14 -6
  319. package/dist/consolidate/sleep.js +41 -38
  320. package/dist/consolidate/trace.d.ts +7 -2
  321. package/dist/consolidate/trace.js +7 -2
  322. package/dist/consolidate/traces.js +26 -29
  323. package/dist/core/ablation.d.ts +9 -3
  324. package/dist/core/ablation.js +14 -4
  325. package/dist/core/active-scope.d.ts +3 -1
  326. package/dist/core/active-scope.js +3 -1
  327. package/dist/core/agent-memory-tools.d.ts +2 -0
  328. package/dist/core/agent-memory-tools.js +2 -0
  329. package/dist/core/ambient.d.ts +4 -3
  330. package/dist/core/ambient.js +8 -6
  331. package/dist/core/api-errors.d.ts +9 -3
  332. package/dist/core/api-errors.js +9 -3
  333. package/dist/core/capture-contract.d.ts +4 -1
  334. package/dist/core/capture-contract.js +27 -8
  335. package/dist/core/compare.d.ts +24 -8
  336. package/dist/core/compare.js +24 -8
  337. package/dist/core/config.d.ts +18 -9
  338. package/dist/core/config.js +24 -14
  339. package/dist/core/cosine.d.ts +4 -1
  340. package/dist/core/cosine.js +4 -1
  341. package/dist/core/handoff.d.ts +7 -2
  342. package/dist/core/handoff.js +4 -1
  343. package/dist/core/markdown.js +21 -16
  344. package/dist/core/memory-audit.js +14 -3
  345. package/dist/core/memory-quality.d.ts +12 -3
  346. package/dist/core/memory-quality.js +57 -21
  347. package/dist/core/memory.d.ts +84 -27
  348. package/dist/core/memory.js +73 -29
  349. package/dist/core/merged-row.d.ts +8 -2
  350. package/dist/core/merged-row.js +10 -3
  351. package/dist/core/package-root.d.ts +3 -1
  352. package/dist/core/package-root.js +3 -1
  353. package/dist/core/particle-refresh.d.ts +8 -0
  354. package/dist/core/particle-refresh.js +22 -0
  355. package/dist/core/physics-config.d.ts +4 -1
  356. package/dist/core/physics-config.js +6 -2
  357. package/dist/core/physics.d.ts +37 -11
  358. package/dist/core/physics.js +55 -20
  359. package/dist/core/project-identity.d.ts +34 -17
  360. package/dist/core/project-identity.js +33 -17
  361. package/dist/core/project-remote.d.ts +8 -4
  362. package/dist/core/project-remote.js +31 -14
  363. package/dist/core/recall-scope.d.ts +33 -11
  364. package/dist/core/recall-scope.js +42 -15
  365. package/dist/core/rejection-digest.d.ts +7 -0
  366. package/dist/core/rejection-digest.js +13 -0
  367. package/dist/core/salience.d.ts +3 -1
  368. package/dist/core/salience.js +10 -4
  369. package/dist/core/search-types.d.ts +15 -2
  370. package/dist/core/search-types.js +11 -0
  371. package/dist/dashboard/dashboard-actions.js +13 -2
  372. package/dist/dashboard/dashboard-snapshot.d.ts +2 -2
  373. package/dist/dashboard/dashboard-snapshot.js +4 -4
  374. package/dist/dashboard/dashboard.js +6 -3
  375. package/dist/db/backup.js +2 -2
  376. package/dist/db/busy.d.ts +10 -3
  377. package/dist/db/busy.js +27 -5
  378. package/dist/db/connect.d.ts +10 -3
  379. package/dist/db/connect.js +8 -3
  380. package/dist/db/continuity.d.ts +1 -1
  381. package/dist/db/continuity.js +27 -11
  382. package/dist/db/meta.d.ts +4 -1
  383. package/dist/db/meta.js +4 -1
  384. package/dist/db/migrate.d.ts +10 -5
  385. package/dist/db/migrate.js +26 -13
  386. package/dist/db/migrations/index.d.ts +1 -1
  387. package/dist/db/migrations/index.js +3 -1
  388. package/dist/db/migrations/types.d.ts +2 -1
  389. package/dist/db/migrations/v12.js +2 -1
  390. package/dist/db/migrations/v14.js +2 -1
  391. package/dist/db/migrations/v15.js +4 -2
  392. package/dist/db/migrations/v16.js +6 -3
  393. package/dist/db/migrations/v17.js +2 -1
  394. package/dist/db/migrations/v19.js +4 -2
  395. package/dist/db/migrations/v20.js +2 -1
  396. package/dist/db/migrations/v22.js +12 -6
  397. package/dist/db/migrations/v23.js +6 -3
  398. package/dist/db/migrations/v24.js +6 -3
  399. package/dist/db/migrations/v25.js +4 -2
  400. package/dist/db/migrations/v26.js +4 -2
  401. package/dist/db/migrations/v27.js +6 -3
  402. package/dist/db/migrations/v28.js +4 -2
  403. package/dist/db/migrations/v29.js +4 -2
  404. package/dist/db/migrations/v30.js +6 -3
  405. package/dist/db/migrations/v31.js +4 -2
  406. package/dist/db/migrations/v32.js +6 -3
  407. package/dist/db/migrations/v33.js +4 -2
  408. package/dist/db/migrations/v34.js +2 -1
  409. package/dist/db/migrations/v35.js +2 -1
  410. package/dist/db/migrations/v36.js +2 -1
  411. package/dist/db/migrations/v37.js +10 -5
  412. package/dist/db/migrations/v38.js +10 -5
  413. package/dist/db/migrations/v39.js +14 -6
  414. package/dist/db/migrations/v40.js +4 -2
  415. package/dist/db/migrations/v41.js +4 -2
  416. package/dist/db/migrations/v42.js +2 -1
  417. package/dist/db/migrations/v44.js +4 -2
  418. package/dist/db/migrations/v45.js +4 -2
  419. package/dist/db/migrations/v49.js +2 -1
  420. package/dist/db/migrations/v50.js +4 -2
  421. package/dist/db/migrations/v51.js +4 -2
  422. package/dist/db/migrations/v52.js +2 -1
  423. package/dist/db/migrations/v53.js +8 -4
  424. package/dist/db/migrations/v54.js +2 -1
  425. package/dist/db/migrations/v55.js +4 -2
  426. package/dist/db/migrations/v56.d.ts +3 -0
  427. package/dist/db/migrations/v56.js +28 -0
  428. package/dist/db/open.d.ts +24 -12
  429. package/dist/db/open.js +25 -13
  430. package/dist/db/physics-state.d.ts +8 -4
  431. package/dist/db/physics-state.js +13 -20
  432. package/dist/db/raw-archive-mirror-cleanup.d.ts +4 -2
  433. package/dist/db/raw-archive-mirror-cleanup.js +6 -4
  434. package/dist/db/request-stores.d.ts +19 -5
  435. package/dist/db/request-stores.js +14 -5
  436. package/dist/db/tables.d.ts +2 -1
  437. package/dist/db/tables.js +12 -4
  438. package/dist/db/vector-store.d.ts +13 -4
  439. package/dist/db/vector-store.js +34 -14
  440. package/dist/db/wal-checkpointer.d.ts +2 -1
  441. package/dist/db/wal-checkpointer.js +19 -7
  442. package/dist/doctor.d.ts +4 -1
  443. package/dist/doctor.js +121 -39
  444. package/dist/embeddings/local.d.ts +8 -4
  445. package/dist/embeddings/local.js +9 -5
  446. package/dist/embeddings/provider.d.ts +19 -10
  447. package/dist/embeddings/provider.js +31 -17
  448. package/dist/embeddings/transformers.d.ts +16 -4
  449. package/dist/embeddings/transformers.js +32 -15
  450. package/dist/entry/json-hooks.d.ts +1 -1
  451. package/dist/entry/json-hooks.js +1 -1
  452. package/dist/entry/project-identity.js +2 -1
  453. package/dist/entry/session-text.d.ts +1 -1
  454. package/dist/entry/session-text.js +1 -1
  455. package/dist/entry/sqlite-handles.d.ts +10 -0
  456. package/dist/entry/sqlite-handles.js +9 -0
  457. package/dist/entry/store-kit.d.ts +19 -6
  458. package/dist/entry/store-kit.js +6 -4
  459. package/dist/eval/eval-stats.d.ts +27 -8
  460. package/dist/eval/eval-stats.js +17 -5
  461. package/dist/eval/eval-suite.d.ts +3 -1
  462. package/dist/eval/eval-suite.js +409 -187
  463. package/dist/eval/eval.d.ts +8 -2
  464. package/dist/eval/eval.js +8 -2
  465. package/dist/eval/judgment.js +16 -6
  466. package/dist/graph/delta.d.ts +9 -42
  467. package/dist/graph/delta.js +17 -11
  468. package/dist/graph/extract.d.ts +10 -7
  469. package/dist/graph/extract.js +57 -25
  470. package/dist/graph/recall.d.ts +12 -4
  471. package/dist/graph/recall.js +30 -13
  472. package/dist/graph/stream.d.ts +18 -6
  473. package/dist/graph/stream.js +32 -10
  474. package/dist/graph/view.d.ts +19 -6
  475. package/dist/graph/view.js +42 -17
  476. package/dist/hooks/codex-session.js +2 -2
  477. package/dist/hooks/codex-wrapper.d.ts +3 -1
  478. package/dist/hooks/codex-wrapper.js +9 -4
  479. package/dist/hooks/copilot.d.ts +19 -5
  480. package/dist/hooks/copilot.js +54 -15
  481. package/dist/hooks/hook-blocks.d.ts +4 -1
  482. package/dist/hooks/hook-blocks.js +17 -10
  483. package/dist/hooks/json-hooks.d.ts +9 -5
  484. package/dist/hooks/json-hooks.js +69 -34
  485. package/dist/hooks/opencode.js +15 -5
  486. package/dist/hooks/shared.d.ts +27 -8
  487. package/dist/hooks/shared.js +57 -16
  488. package/dist/importers/core.d.ts +12 -4
  489. package/dist/importers/core.js +8 -7
  490. package/dist/importers/markdown-parse.d.ts +15 -5
  491. package/dist/importers/markdown-parse.js +16 -7
  492. package/dist/importers/markdown.js +6 -9
  493. package/dist/importers/sources.js +10 -23
  494. package/dist/importers/vault.d.ts +2 -2
  495. package/dist/importers/vault.js +43 -27
  496. package/dist/index.d.ts +32 -6
  497. package/dist/index.js +25 -7
  498. package/dist/learn/autolearn.d.ts +17 -6
  499. package/dist/learn/autolearn.js +53 -24
  500. package/dist/learn/churn-git.d.ts +4 -1
  501. package/dist/learn/churn-git.js +29 -5
  502. package/dist/learn/extract.d.ts +4 -1
  503. package/dist/learn/extract.js +16 -9
  504. package/dist/learn/forward-claim-detector.d.ts +17 -5
  505. package/dist/learn/forward-claim-detector.js +34 -15
  506. package/dist/learn/invalidation.d.ts +12 -7
  507. package/dist/learn/invalidation.js +56 -27
  508. package/dist/learn/roots.d.ts +3 -0
  509. package/dist/learn/roots.js +5 -0
  510. package/dist/mcp/admin-tools.d.ts +5 -5
  511. package/dist/mcp/admin-tools.js +28 -23
  512. package/dist/mcp/format.d.ts +1 -1
  513. package/dist/mcp/format.js +7 -4
  514. package/dist/mcp/framing.d.ts +3 -1
  515. package/dist/mcp/framing.js +20 -8
  516. package/dist/mcp/memory-tools.d.ts +3 -3
  517. package/dist/mcp/memory-tools.js +18 -14
  518. package/dist/mcp/protocol.d.ts +32 -16
  519. package/dist/mcp/protocol.js +12 -9
  520. package/dist/mcp/recall-tools.d.ts +3 -3
  521. package/dist/mcp/recall-tools.js +62 -74
  522. package/dist/mcp/request.d.ts +7 -5
  523. package/dist/mcp/request.js +57 -74
  524. package/dist/mcp/server.d.ts +3 -1
  525. package/dist/mcp/server.js +8 -3
  526. package/dist/mcp/session-state.d.ts +1 -1
  527. package/dist/mcp/session-state.js +4 -3
  528. package/dist/mcp/shared-gate.d.ts +3 -2
  529. package/dist/mcp/shared-gate.js +3 -2
  530. package/dist/mcp/stdio.d.ts +6 -3
  531. package/dist/mcp/stdio.js +52 -21
  532. package/dist/mcp/tool-args.d.ts +4 -1
  533. package/dist/mcp/tool-args.js +8 -3
  534. package/dist/mcp/tools.js +76 -32
  535. package/dist/objects/customer-notes.d.ts +12 -10
  536. package/dist/objects/customer-notes.js +21 -15
  537. package/dist/objects/decisions.d.ts +18 -10
  538. package/dist/objects/decisions.js +23 -17
  539. package/dist/objects/descriptor.js +2 -1
  540. package/dist/objects/fields.d.ts +4 -1
  541. package/dist/objects/fields.js +6 -2
  542. package/dist/objects/incidents.d.ts +14 -16
  543. package/dist/objects/incidents.js +29 -30
  544. package/dist/objects/lifecycle.d.ts +0 -4
  545. package/dist/objects/lifecycle.js +21 -24
  546. package/dist/objects/policies.d.ts +12 -16
  547. package/dist/objects/policies.js +17 -21
  548. package/dist/objects/processes.d.ts +16 -10
  549. package/dist/objects/processes.js +20 -15
  550. package/dist/objects/project-briefs.d.ts +13 -14
  551. package/dist/objects/project-briefs.js +33 -39
  552. package/dist/objects/skills.d.ts +10 -12
  553. package/dist/objects/skills.js +17 -22
  554. package/dist/postinstall.js +15 -7
  555. package/dist/predictions/planning-fallacy.d.ts +19 -6
  556. package/dist/predictions/planning-fallacy.js +4 -2
  557. package/dist/rerankers/clef.d.ts +8 -2
  558. package/dist/rerankers/clef.js +14 -9
  559. package/dist/rerankers/cross-encoder.d.ts +2 -1
  560. package/dist/rerankers/cross-encoder.js +9 -6
  561. package/dist/rerankers/index.js +2 -1
  562. package/dist/rerankers/jev.js +2 -1
  563. package/dist/rerankers/llm.d.ts +6 -2
  564. package/dist/rerankers/llm.js +8 -3
  565. package/dist/rerankers/remote.d.ts +3 -1
  566. package/dist/rerankers/remote.js +5 -2
  567. package/dist/rerankers/types.d.ts +6 -2
  568. package/dist/search/bm25-search.d.ts +3 -1
  569. package/dist/search/bm25-search.js +15 -2
  570. package/dist/search/boosts.js +4 -3
  571. package/dist/search/embed-memories.d.ts +10 -5
  572. package/dist/search/embed-memories.js +62 -36
  573. package/dist/search/engine.d.ts +4 -1
  574. package/dist/search/engine.js +6 -2
  575. package/dist/search/goal-boost.d.ts +10 -3
  576. package/dist/search/goal-boost.js +13 -6
  577. package/dist/search/hybrid-score.d.ts +4 -1
  578. package/dist/search/hybrid-score.js +4 -1
  579. package/dist/search/hybrid.d.ts +23 -8
  580. package/dist/search/hybrid.js +12 -7
  581. package/dist/search/multihop.js +14 -13
  582. package/dist/search/path-context.d.ts +10 -3
  583. package/dist/search/path-context.js +10 -3
  584. package/dist/search/physics-search.d.ts +9 -4
  585. package/dist/search/physics-search.js +38 -14
  586. package/dist/search/rerank.d.ts +2 -1
  587. package/dist/search/rerank.js +2 -1
  588. package/dist/search/rrf.d.ts +14 -5
  589. package/dist/search/rrf.js +11 -4
  590. package/dist/search/vector.d.ts +8 -2
  591. package/dist/search/vector.js +9 -3
  592. package/dist/server/auth.d.ts +18 -14
  593. package/dist/server/auth.js +69 -38
  594. package/dist/server/boot.d.ts +3 -1
  595. package/dist/server/boot.js +95 -56
  596. package/dist/server/client-ip.d.ts +11 -4
  597. package/dist/server/client-ip.js +27 -10
  598. package/dist/server/cursor.d.ts +10 -3
  599. package/dist/server/cursor.js +10 -3
  600. package/dist/server/deadline.d.ts +5 -2
  601. package/dist/server/deadline.js +10 -3
  602. package/dist/server/key-check-bounds.js +12 -4
  603. package/dist/server/lifecycle.d.ts +4 -1
  604. package/dist/server/lifecycle.js +10 -4
  605. package/dist/server/mcp-http.d.ts +2 -1
  606. package/dist/server/mcp-http.js +37 -22
  607. package/dist/server/rate-limit.d.ts +17 -5
  608. package/dist/server/rate-limit.js +55 -26
  609. package/dist/server/ready.js +7 -4
  610. package/dist/server/request.d.ts +15 -4
  611. package/dist/server/request.js +42 -15
  612. package/dist/server/route-checks.d.ts +4 -1
  613. package/dist/server/route-checks.js +8 -3
  614. package/dist/server/route-table.d.ts +8 -6
  615. package/dist/server/route-table.js +547 -93
  616. package/dist/server/routes/admin.d.ts +7 -7
  617. package/dist/server/routes/admin.js +36 -15
  618. package/dist/server/routes/customer-notes.d.ts +5 -5
  619. package/dist/server/routes/customer-notes.js +5 -4
  620. package/dist/server/routes/decisions.d.ts +5 -5
  621. package/dist/server/routes/decisions.js +12 -6
  622. package/dist/server/routes/incidents.d.ts +5 -5
  623. package/dist/server/routes/incidents.js +10 -4
  624. package/dist/server/routes/memories.d.ts +8 -8
  625. package/dist/server/routes/memories.js +12 -19
  626. package/dist/server/routes/object-routes.d.ts +8 -5
  627. package/dist/server/routes/object-routes.js +4 -2
  628. package/dist/server/routes/policies.d.ts +6 -6
  629. package/dist/server/routes/policies.js +11 -4
  630. package/dist/server/routes/predictions.d.ts +5 -5
  631. package/dist/server/routes/predictions.js +9 -4
  632. package/dist/server/routes/processes.d.ts +5 -5
  633. package/dist/server/routes/processes.js +15 -6
  634. package/dist/server/routes/project-briefs.d.ts +6 -6
  635. package/dist/server/routes/project-briefs.js +3 -2
  636. package/dist/server/routes/recall.d.ts +3 -3
  637. package/dist/server/routes/recall.js +21 -10
  638. package/dist/server/routes/skills.d.ts +6 -6
  639. package/dist/server/routes/skills.js +12 -4
  640. package/dist/server/server-detect.d.ts +24 -8
  641. package/dist/server/server-detect.js +57 -22
  642. package/dist/server/sleep-child.js +16 -10
  643. package/dist/server/sleep-offload.d.ts +8 -5
  644. package/dist/server/sleep-offload.js +41 -19
  645. package/dist/server/tls.d.ts +4 -1
  646. package/dist/server/tls.js +13 -5
  647. package/dist/server/types.d.ts +38 -26
  648. package/dist/server/validation.d.ts +4 -1
  649. package/dist/server/validation.js +22 -9
  650. package/dist/server.d.ts +15 -10
  651. package/dist/server.js +32 -12
  652. package/dist/sharing/global-store.d.ts +5 -10
  653. package/dist/sharing/global-store.js +8 -43
  654. package/dist/sharing/global-sync.d.ts +3 -1
  655. package/dist/sharing/global-sync.js +16 -6
  656. package/dist/sharing/project-merge.d.ts +25 -7
  657. package/dist/sharing/project-merge.js +49 -17
  658. package/dist/sharing/search-both.d.ts +8 -4
  659. package/dist/sharing/search-both.js +19 -12
  660. package/dist/sharing/share.d.ts +8 -4
  661. package/dist/sharing/share.js +39 -15
  662. package/dist/store/ambient.js +9 -5
  663. package/dist/store/audit-event.d.ts +2 -2
  664. package/dist/store/audit-event.js +8 -3
  665. package/dist/store/audit.d.ts +6 -3
  666. package/dist/store/audit.js +16 -6
  667. package/dist/store/auth.d.ts +4 -2
  668. package/dist/store/auth.js +63 -20
  669. package/dist/store/busy.d.ts +9 -0
  670. package/dist/store/busy.js +16 -0
  671. package/dist/store/candidates.d.ts +12 -5
  672. package/dist/store/candidates.js +75 -36
  673. package/dist/store/capture-write.d.ts +2 -1
  674. package/dist/store/capture-write.js +2 -1
  675. package/dist/store/card-detail.d.ts +4 -4
  676. package/dist/store/card-detail.js +15 -8
  677. package/dist/store/cards.d.ts +24 -10
  678. package/dist/store/cards.js +93 -60
  679. package/dist/store/compaction-caller.d.ts +2 -1
  680. package/dist/store/compaction-caller.js +2 -1
  681. package/dist/store/compactions-record.d.ts +14 -8
  682. package/dist/store/compactions-record.js +95 -32
  683. package/dist/store/compactions.js +35 -15
  684. package/dist/store/conflicts.d.ts +9 -4
  685. package/dist/store/conflicts.js +100 -45
  686. package/dist/store/connectors/dlq.d.ts +17 -5
  687. package/dist/store/connectors/dlq.js +56 -5
  688. package/dist/store/connectors/event-log.d.ts +111 -2
  689. package/dist/store/connectors/event-log.js +2 -1
  690. package/dist/store/connectors/github.d.ts +6 -3
  691. package/dist/store/connectors/github.js +24 -40
  692. package/dist/store/connectors/slack.d.ts +2 -1
  693. package/dist/store/connectors/slack.js +25 -37
  694. package/dist/store/dashboard-reads.d.ts +7 -3
  695. package/dist/store/dashboard-reads.js +32 -11
  696. package/dist/store/delete-and-batch.d.ts +17 -11
  697. package/dist/store/delete-and-batch.js +67 -26
  698. package/dist/store/delivery-recorder.d.ts +8 -5
  699. package/dist/store/delivery-recorder.js +70 -32
  700. package/dist/store/descendant-page.d.ts +2 -1
  701. package/dist/store/descendant-page.js +24 -9
  702. package/dist/store/diagnostics.d.ts +2 -1
  703. package/dist/store/diagnostics.js +2 -1
  704. package/dist/store/doctor-reads.d.ts +2 -1
  705. package/dist/store/doctor-reads.js +13 -5
  706. package/dist/store/dormant.d.ts +19 -11
  707. package/dist/store/dormant.js +40 -18
  708. package/dist/store/embeddings/index.d.ts +13 -9
  709. package/dist/store/embeddings/index.js +19 -12
  710. package/dist/store/entry-reads.d.ts +49 -20
  711. package/dist/store/entry-reads.js +181 -66
  712. package/dist/store/entry-row.d.ts +10 -6
  713. package/dist/store/entry-row.js +17 -12
  714. package/dist/store/entry-writes.d.ts +22 -10
  715. package/dist/store/entry-writes.js +41 -14
  716. package/dist/store/failure-log-at.js +1 -1
  717. package/dist/store/failure-log.d.ts +4 -2
  718. package/dist/store/failure-log.js +13 -6
  719. package/dist/store/gated-write.d.ts +3 -3
  720. package/dist/store/gated-write.js +3 -3
  721. package/dist/store/goals.d.ts +5 -4
  722. package/dist/store/goals.js +8 -10
  723. package/dist/store/graph-apply.d.ts +21 -0
  724. package/dist/{graph/write.js → store/graph-apply.js} +31 -11
  725. package/dist/store/graph-queue.d.ts +9 -6
  726. package/dist/store/graph-queue.js +15 -10
  727. package/dist/store/graph-reads.d.ts +16 -11
  728. package/dist/store/graph-reads.js +24 -15
  729. package/dist/store/graph-rows.d.ts +41 -3
  730. package/dist/store/graph-rows.js +10 -7
  731. package/dist/store/graph-view-rows.js +14 -7
  732. package/dist/store/graph-writes.d.ts +16 -10
  733. package/dist/store/graph-writes.js +59 -36
  734. package/dist/store/handoffs.d.ts +4 -4
  735. package/dist/store/handoffs.js +40 -19
  736. package/dist/store/index-and-stats.d.ts +2 -2
  737. package/dist/store/index-and-stats.js +6 -5
  738. package/dist/store/index.d.ts +3 -1
  739. package/dist/store/index.js +1 -0
  740. package/dist/store/key-audit.d.ts +2 -1
  741. package/dist/store/key-audit.js +2 -1
  742. package/dist/store/key-writes.d.ts +2 -1
  743. package/dist/store/key-writes.js +9 -2
  744. package/dist/store/ledger-turn.d.ts +4 -1
  745. package/dist/store/ledger-turn.js +7 -2
  746. package/dist/store/mirrors.d.ts +11 -4
  747. package/dist/store/mirrors.js +88 -16
  748. package/dist/store/narrow.d.ts +6 -0
  749. package/dist/store/narrow.js +11 -0
  750. package/dist/store/open.d.ts +4 -2
  751. package/dist/store/open.js +18 -9
  752. package/dist/store/pilot-arm.d.ts +2 -1
  753. package/dist/store/pilot-arm.js +18 -6
  754. package/dist/store/planning-fallacy-evidence.d.ts +2 -2
  755. package/dist/store/planning-fallacy-evidence.js +8 -5
  756. package/dist/store/port/agent-import.d.ts +62 -0
  757. package/dist/store/port/agent-import.js +2 -0
  758. package/dist/store/port/consolidation.d.ts +129 -0
  759. package/dist/store/port/consolidation.js +2 -0
  760. package/dist/store/port/learning.d.ts +19 -0
  761. package/dist/store/port/learning.js +2 -0
  762. package/dist/store/port/local-files.d.ts +18 -0
  763. package/dist/store/port/local-files.js +2 -0
  764. package/dist/store/port/promotion.d.ts +20 -0
  765. package/dist/store/port/promotion.js +3 -0
  766. package/dist/store/port-groups.d.ts +160 -0
  767. package/dist/store/port-groups.js +2 -0
  768. package/dist/store/port.d.ts +215 -229
  769. package/dist/store/port.js +3 -9
  770. package/dist/store/predictions.d.ts +14 -10
  771. package/dist/store/predictions.js +37 -17
  772. package/dist/store/project-tags.d.ts +4 -1
  773. package/dist/store/project-tags.js +16 -5
  774. package/dist/store/quality-repair.d.ts +8 -4
  775. package/dist/store/quality-repair.js +53 -20
  776. package/dist/store/quarantine.d.ts +1 -0
  777. package/dist/store/quarantine.js +23 -9
  778. package/dist/store/raw-archive.d.ts +5 -4
  779. package/dist/store/raw-archive.js +11 -10
  780. package/dist/store/recall-trace.d.ts +22 -17
  781. package/dist/store/recall-trace.js +126 -63
  782. package/dist/store/rejected-values.d.ts +15 -10
  783. package/dist/store/rejected-values.js +33 -12
  784. package/dist/store/rejection.d.ts +12 -11
  785. package/dist/store/rejection.js +18 -19
  786. package/dist/store/report-reads.d.ts +2 -1
  787. package/dist/store/report-reads.js +2 -1
  788. package/dist/store/rows.d.ts +7 -5
  789. package/dist/store/rows.js +18 -11
  790. package/dist/store/rule-sql.d.ts +6 -4
  791. package/dist/store/rule-sql.js +16 -9
  792. package/dist/store/search-rows.d.ts +14 -9
  793. package/dist/store/search-rows.js +48 -23
  794. package/dist/store/sessions.d.ts +12 -10
  795. package/dist/store/sessions.js +40 -21
  796. package/dist/store/set-aside.d.ts +2 -2
  797. package/dist/store/set-aside.js +18 -5
  798. package/dist/store/sqlite/agent-import.d.ts +3 -0
  799. package/dist/store/sqlite/agent-import.js +77 -0
  800. package/dist/store/sqlite/cards-group.d.ts +6 -0
  801. package/dist/store/sqlite/cards-group.js +37 -0
  802. package/dist/store/sqlite/conflicts-group.d.ts +6 -0
  803. package/dist/store/sqlite/conflicts-group.js +18 -0
  804. package/dist/store/sqlite/connector-events-group.d.ts +2 -1
  805. package/dist/store/sqlite/connector-events-group.js +17 -6
  806. package/dist/store/sqlite/connector-writes-group.d.ts +2 -1
  807. package/dist/store/sqlite/connector-writes-group.js +9 -4
  808. package/dist/store/sqlite/consolidation-group.d.ts +4 -0
  809. package/dist/store/sqlite/consolidation-group.js +64 -0
  810. package/dist/store/sqlite/dag-reads-group.js +1 -1
  811. package/dist/store/sqlite/dormant-group.d.ts +6 -0
  812. package/dist/store/sqlite/dormant-group.js +29 -0
  813. package/dist/store/sqlite/entry-writes-group.d.ts +6 -3
  814. package/dist/store/sqlite/entry-writes-group.js +37 -14
  815. package/dist/store/sqlite/error-codec.d.ts +4 -2
  816. package/dist/store/sqlite/error-codec.js +32 -10
  817. package/dist/store/sqlite/executor-counts.js +2 -1
  818. package/dist/store/sqlite/executor.d.ts +8 -3
  819. package/dist/store/sqlite/executor.js +56 -18
  820. package/dist/store/sqlite/global-promote.d.ts +5 -0
  821. package/dist/store/sqlite/global-promote.js +48 -0
  822. package/dist/store/sqlite/goals-group.d.ts +6 -0
  823. package/dist/store/sqlite/goals-group.js +23 -0
  824. package/dist/store/sqlite/graph-reads-group.d.ts +2 -1
  825. package/dist/store/sqlite/graph-reads-group.js +2 -1
  826. package/dist/store/sqlite/held-connection.d.ts +7 -1
  827. package/dist/store/sqlite/held-connection.js +34 -7
  828. package/dist/store/sqlite/last-recall-group.d.ts +4 -2
  829. package/dist/store/sqlite/last-recall-group.js +9 -4
  830. package/dist/store/sqlite/learning-group.d.ts +4 -0
  831. package/dist/store/sqlite/learning-group.js +17 -0
  832. package/dist/store/sqlite/maintenance-groups.js +2 -1
  833. package/dist/store/sqlite/object-rows.d.ts +6 -3
  834. package/dist/store/sqlite/object-rows.js +34 -5
  835. package/dist/store/sqlite/objects-group.d.ts +5 -4
  836. package/dist/store/sqlite/objects-group.js +84 -33
  837. package/dist/store/sqlite/predictions-group.d.ts +2 -1
  838. package/dist/store/sqlite/predictions-group.js +4 -2
  839. package/dist/store/sqlite/promotion-group.d.ts +3 -0
  840. package/dist/store/sqlite/promotion-group.js +10 -0
  841. package/dist/store/sqlite/quarantine-group.d.ts +2 -1
  842. package/dist/store/sqlite/quarantine-group.js +4 -2
  843. package/dist/store/sqlite/reports-group.d.ts +6 -0
  844. package/dist/store/sqlite/reports-group.js +33 -0
  845. package/dist/store/sqlite/request-scope.d.ts +6 -0
  846. package/dist/store/sqlite/request-scope.js +18 -0
  847. package/dist/store/sqlite/sessions-group.d.ts +6 -0
  848. package/dist/store/sqlite/sessions-group.js +46 -0
  849. package/dist/store/sqlite/store.d.ts +22 -11
  850. package/dist/store/sqlite/store.js +84 -11
  851. package/dist/store/sqlite/vector-pack.js +2 -1
  852. package/dist/store/sqlite/vector-reads-group.js +2 -1
  853. package/dist/store/sqlite/worker-jobs.d.ts +2 -1
  854. package/dist/store/sqlite/worker-jobs.js +19 -7
  855. package/dist/store/sqlite/worker-ops.d.ts +10 -5
  856. package/dist/store/sqlite/worker-ops.js +6 -3
  857. package/dist/store/sqlite/worker-store.d.ts +4 -3
  858. package/dist/store/sqlite/worker-store.js +24 -14
  859. package/dist/store/summaries.d.ts +19 -12
  860. package/dist/store/summaries.js +36 -21
  861. package/dist/store/summary-dirty.d.ts +2 -1
  862. package/dist/store/summary-dirty.js +2 -1
  863. package/dist/store/tenant.d.ts +3 -2
  864. package/dist/store/tenant.js +5 -4
  865. package/dist/store/token-ledger-rows.js +6 -3
  866. package/dist/store/token-ledger.d.ts +19 -13
  867. package/dist/store/token-ledger.js +27 -14
  868. package/dist/store/tombstone-checks.d.ts +4 -1
  869. package/dist/store/tombstone-checks.js +10 -1
  870. package/dist/store/usage-reports.js +2 -1
  871. package/dist/store/vector-index.d.ts +8 -5
  872. package/dist/store/vector-index.js +24 -10
  873. package/dist/store/working-memory.d.ts +6 -4
  874. package/dist/store/working-memory.js +14 -9
  875. package/dist/support-bundle.js +10 -5
  876. package/dist/trust/quarantine.d.ts +1 -2
  877. package/dist/trust/quarantine.js +1 -5
  878. package/dist/trust/reject-flow.d.ts +12 -3
  879. package/dist/trust/reject-flow.js +12 -4
  880. package/dist/util/anthropic-messages.d.ts +4 -1
  881. package/dist/util/anthropic-messages.js +14 -5
  882. package/dist/util/atomic-write.d.ts +4 -2
  883. package/dist/util/atomic-write.js +25 -14
  884. package/dist/util/compaction-items.d.ts +4 -1
  885. package/dist/util/compaction-items.js +8 -2
  886. package/dist/util/crash-handlers.d.ts +7 -2
  887. package/dist/util/crash-handlers.js +13 -4
  888. package/dist/util/env.d.ts +16 -4
  889. package/dist/util/env.js +78 -25
  890. package/dist/util/home-path.js +12 -6
  891. package/dist/util/hook-payload.d.ts +3 -1
  892. package/dist/util/hook-payload.js +3 -1
  893. package/dist/util/http-retry.d.ts +12 -6
  894. package/dist/util/http-retry.js +16 -6
  895. package/dist/util/http-util.d.ts +20 -5
  896. package/dist/util/http-util.js +28 -9
  897. package/dist/util/json.d.ts +4 -1
  898. package/dist/util/json.js +4 -1
  899. package/dist/util/keyset.js +2 -1
  900. package/dist/util/limits.js +4 -2
  901. package/dist/util/log.d.ts +13 -5
  902. package/dist/util/log.js +29 -6
  903. package/dist/util/net.d.ts +5 -0
  904. package/dist/util/net.js +19 -0
  905. package/dist/util/real-path.d.ts +2 -1
  906. package/dist/util/real-path.js +4 -3
  907. package/dist/util/request-scope.d.ts +11 -3
  908. package/dist/util/request-scope.js +13 -4
  909. package/dist/util/same-text.d.ts +10 -3
  910. package/dist/util/same-text.js +10 -3
  911. package/dist/util/secret-detect.d.ts +24 -7
  912. package/dist/util/secret-detect.js +49 -14
  913. package/dist/util/session-id.d.ts +4 -0
  914. package/dist/util/session-id.js +6 -0
  915. package/dist/util/spawn-argv.d.ts +3 -1
  916. package/dist/util/spawn-argv.js +13 -4
  917. package/dist/util/sqlite-blocked.d.ts +15 -4
  918. package/dist/util/sqlite-blocked.js +19 -6
  919. package/dist/util/stored-json.d.ts +4 -1
  920. package/dist/util/stored-json.js +6 -2
  921. package/dist/util/stream-tee.d.ts +2 -1
  922. package/dist/util/stream-tee.js +8 -5
  923. package/dist/util/transcript-tail.d.ts +4 -1
  924. package/dist/util/transcript-tail.js +4 -1
  925. package/dist/util/version.d.ts +8 -3
  926. package/dist/util/version.js +8 -3
  927. package/dist/util/write-budget.d.ts +7 -2
  928. package/dist/util/write-budget.js +5 -2
  929. package/dist/util/yaml.d.ts +4 -1
  930. package/dist/util/yaml.js +4 -1
  931. package/extensions/openclaw-plugin/openclaw.plugin.json +1 -1
  932. package/extensions/openclaw-plugin/package.json +1 -1
  933. package/openclaw.plugin.json +1 -1
  934. package/package.json +2 -1
  935. package/scripts/postinstall.cjs +3 -1
  936. package/dist/api/cards.d.ts +0 -42
  937. package/dist/api/conflicts.d.ts +0 -28
  938. package/dist/api/conflicts.js +0 -61
  939. package/dist/api/dormant.d.ts +0 -14
  940. package/dist/api/dormant.js +0 -58
  941. package/dist/api/goals.d.ts +0 -18
  942. package/dist/api/graph.d.ts +0 -8
  943. package/dist/api/graph.js +0 -8
  944. package/dist/api/learn.js +0 -125
  945. package/dist/api/memories.d.ts +0 -25
  946. package/dist/api/objects.d.ts +0 -9
  947. package/dist/api/outcome.d.ts +0 -19
  948. package/dist/api/predictions.d.ts +0 -11
  949. package/dist/api/promote.d.ts +0 -36
  950. package/dist/api/recall-core.d.ts +0 -4
  951. package/dist/api/recall-core.js +0 -125
  952. package/dist/api/recall-finish.d.ts +0 -53
  953. package/dist/api/recall-finish.js +0 -30
  954. package/dist/api/recall-history.d.ts +0 -64
  955. package/dist/api/recall-history.js +0 -159
  956. package/dist/api/recall-record.d.ts +0 -43
  957. package/dist/api/recall-record.js +0 -78
  958. package/dist/api/recall-request.js +0 -121
  959. package/dist/api/recall.d.ts +0 -6
  960. package/dist/api/refine.d.ts +0 -7
  961. package/dist/api/refine.js +0 -10
  962. package/dist/api/session-owners.d.ts +0 -4
  963. package/dist/api/session-owners.js +0 -17
  964. package/dist/api/sleep-run.d.ts +0 -26
  965. package/dist/api/sleep.js +0 -11
  966. package/dist/graph/write.d.ts +0 -14
  967. package/dist/store/sqlite/busy.d.ts +0 -3
  968. package/dist/store/sqlite/busy.js +0 -8
  969. package/dist/store/sqlite/local.d.ts +0 -4
  970. package/dist/store/sqlite/local.js +0 -8
@@ -2,29 +2,31 @@
2
2
  import { DEFAULT_SEARCH_CANDIDATE_LIMIT } from '../store/rows.js';
3
3
  import { freshActiveSnapshot, SNAPSHOT_AMBIENT_MAX_AGE_MS } from '../store/sessions.js';
4
4
  import { estimateTokens } from '../util/token-text.js';
5
+ import { isPointerSafeId } from '../util/session-id.js';
5
6
  import { markRetrieved, COMPACTION_MEMORY_TAG } from '../core/memory.js';
6
7
  import { isWorthSurfacing } from '../core/memory-quality.js';
7
- import { getGlobalRoot } from '../sharing/global-store.js';
8
8
  import { evalNow, strengthAblation } from '../core/ablation.js';
9
9
  import { dropHeldCopies } from '../util/same-text.js';
10
10
  import { BadRequestError } from '../core/api-errors.js';
11
- import { isSharedStore, loadConfig } from '../core/config.js';
11
+ import { isSharedStore } from '../core/config.js';
12
+ import { configOf } from './config-of.js';
12
13
  import { rethrowIfSqliteBlocked } from '../util/sqlite-blocked.js';
13
- import { errorMessage, log } from '../util/log.js';
14
- import { resolveProjectIdentity, classifyOriginProject, isGlobalStoreRoot, isInitialized, projectId, projectNames, } from '../core/project-identity.js';
14
+ import { errorMessage, log, errorFields } from '../util/log.js';
15
+ import { resolveProjectIdentity, classifyOriginProject, projectId, projectNames, } from '../core/project-identity.js';
15
16
  import { promptTokens } from '../core/prompt-recall.js';
16
17
  import { detectSecret } from '../util/secret-detect.js';
17
18
  import { isSessionDigestRow } from '../core/session-digest-row.js';
18
19
  import { addAmbientTallies, ambientStateFromTallies } from '../core/ambient.js';
19
- import { hasGroup, requireGroup, sqliteStore } from '../store/index.js';
20
- import { storeFor } from '../store/sqlite/store.js';
20
+ import { hasGroup } from '../store/index.js';
21
21
  import { passesScopeFilterForRecall, assertScopeRequestAllowed, personalScopeOf } from '../core/recall-scope.js';
22
22
  import { finiteOr, selectBySearch, selectPinned, selectStrongest, } from './context-select.js';
23
- import { strengthenOf } from './recall-record.js';
23
+ import { strengthenOf } from './recall/finish.js';
24
+ import { tokenPurse } from './recall/render.js';
24
25
  import { ownerOrSubject } from './types.js';
25
26
  export { oneCopyPerMemory } from './context-select.js';
26
- /** The single ambient-injection admission policy, shared by getContext and the CLI ambient-state summary so they cannot drift.
27
- * Secret veto is unconditional (flagged rows inject only in their own project); private scopes need `exactScope`, other projects `includeCrossProject`. */
27
+ /** The single ambient-injection admission policy, shared by getContext and the CLI ambient-state summary so they cannot
28
+ * drift. Secret veto is unconditional (flagged rows inject only in their own project); private scopes need
29
+ * `exactScope`, other projects `includeCrossProject`. */
28
30
  function ambientAdmitEntry(e, currentProject, includeCrossProject, exactScope, own) {
29
31
  if (!ambientSecretAdmit(e, currentProject))
30
32
  return false;
@@ -34,7 +36,8 @@ function ambientAdmitEntry(e, currentProject, includeCrossProject, exactScope, o
34
36
  return true;
35
37
  return classifyOriginProject(e.origin_project, currentProject) !== 'cross-project';
36
38
  }
37
- /** The secret half of the ambient policy alone, for callers with their own scope rule: a flagged row is admitted only inside its owning project. */
39
+ /** The secret half of the ambient policy alone, for callers with their own scope rule: a flagged row is admitted only
40
+ * inside its owning project. */
38
41
  export function ambientSecretAdmit(e, currentProject) {
39
42
  if (!detectSecret(e).flagged)
40
43
  return true;
@@ -45,11 +48,13 @@ export function ambientSecretAdmit(e, currentProject) {
45
48
  }
46
49
  /** Tokens a context block may use when the caller sets no budget; the hook command and the CLI default match it. */
47
50
  export const DEFAULT_CONTEXT_BUDGET = 1500;
51
+ // The plan's query when the caller gave none: context then ranks by strength instead of searching.
52
+ export const NO_QUERY = '*';
48
53
  /** Most rows per store a no-query context reads; past it, ranking and ambientState see the strongest by decay. */
49
54
  const CONTEXT_CANDIDATE_CAP = 2000;
50
55
  /** A store's base search and context reads; a store without the group throws StoreNotPortedError. */
51
56
  function sourceOf(store) {
52
- return { store, reads: requireGroup(store, 'contextReads') };
57
+ return { store, reads: store.contextReads };
53
58
  }
54
59
  // The pinned-only branch needs pins and recent-N candidates, not the corpus.
55
60
  async function loadAmbientEntries(source, tenantId, options) {
@@ -79,30 +84,37 @@ async function loadAmbientEntries(source, tenantId, options) {
79
84
  onQualityDrop?.(e);
80
85
  return false;
81
86
  };
82
- const loaded = await source.reads.ambientCandidates(tenantId, { recentNeeded: recent.needed, admit: admitAmbient, recall, origins: recent.origins });
83
- // Pins and recent rows reach core only through the store's own call to admit, so core applies it again with the tenant.
87
+ const loaded = await source.reads.ambientCandidates(tenantId, {
88
+ recentNeeded: recent.needed,
89
+ admit: admitAmbient,
90
+ recall,
91
+ origins: recent.origins,
92
+ });
93
+ // Pins and recent rows reach core only through the store's own
94
+ // call to admit, so core applies it again with the tenant.
84
95
  const entries = loaded.entries.filter((e) => ownTenant(e) && recheck(e));
85
96
  return loaded.recall ? { entries, recall: loaded.recall.filter(ownTenant) } : { entries };
86
97
  }
87
- /** Assembles a budget-bounded, tenant-scoped context bundle; mutates `last_retrieval_ids` and emits a 'recall' audit row for non-pinned, non-'*' queries.
88
- * Returns an empty result when there are no memories, snapshot, handoff or recent events. CLI rendering stays in `cli.ts`. */
98
+ /** Assembles a budget-bounded, tenant-scoped context bundle; mutates `last_retrieval_ids` and emits a 'recall' audit
99
+ * row for non-pinned, non-'*' queries. Returns an empty result when there are no memories, snapshot, handoff or recent
100
+ * events. CLI rendering stays in `cli.ts`. */
89
101
  export async function getContext(ctx, opts = {}) {
90
102
  const budget = opts.budget ?? DEFAULT_CONTEXT_BUDGET;
91
103
  assertScopeRequestAllowed(ctx.actor, opts.exactScope);
92
104
  if (budget <= 0) {
93
105
  return { entries: [], tokens: 0 };
94
106
  }
95
- const plan = planContext(ctx, opts, sourceOf(storeFor(ctx)));
107
+ const plan = planContext(ctx, opts, sourceOf(ctx.store));
96
108
  const sections = await loadTaskSections(ctx, opts, plan, openBlockBudget(plan, opts, budget));
97
109
  const admission = ambientAdmission(opts, plan, sections.shownHandoff);
98
110
  const pools = await loadPools(ctx, plan, admission, promptRecallRequest(opts, plan));
99
111
  const noSections = !sections.shownSnapshot && !sections.shownHandoff && sections.shownEvents.length === 0;
100
- if (!plan.promptRecallPending && pools.local.entries.length === 0 && pools.global.entries.length === 0 && noSections) {
112
+ if (nothingToInject(plan, pools, noSections)) {
101
113
  return { entries: [], tokens: 0 };
102
114
  }
103
115
  const picked = plan.pinnedOnly
104
116
  ? selectPinned(opts, plan, sections.left, pools, admission)
105
- : plan.query === '*'
117
+ : plan.query === NO_QUERY
106
118
  ? selectStrongest(plan, sections.left, pools)
107
119
  : await selectBySearch(ctx, plan, sections.left, pools, admission);
108
120
  if (picked === null) {
@@ -120,17 +132,14 @@ export async function getContext(ctx, opts = {}) {
120
132
  const recorded = plan.pinnedOnly
121
133
  ? { items, ambientState: undefined }
122
134
  : await recordRetrieval(ctx, opts, plan, items, sections.activeSnapshot);
123
- return {
124
- entries: recorded.items,
125
- tokens,
126
- activeSnapshot: sections.shownSnapshot ?? undefined,
127
- sessionHandoff: sections.shownHandoff ?? undefined,
128
- recentEvents: sections.shownEvents.length > 0 ? sections.shownEvents : undefined,
129
- ambientState: recorded.ambientState,
130
- };
135
+ return contextResult(recorded, tokens, sections);
136
+ }
137
+ function nothingToInject(plan, pools, noSections) {
138
+ return (!plan.promptRecallPending && pools.local.entries.length === 0 && pools.global.entries.length === 0 && noSections);
131
139
  }
132
140
  const isolationWarned = new Set();
133
- /** A laptop config copied onto a team store must not open every member's rows to every prompt, so the flag loses there. */
141
+ /** A laptop config copied onto a team store must not open every
142
+ * member's rows to every prompt, so the flag loses there. */
134
143
  function warnIsolationIgnored(hippoRoot) {
135
144
  if (isolationWarned.has(hippoRoot))
136
145
  return;
@@ -140,34 +149,54 @@ function warnIsolationIgnored(hippoRoot) {
140
149
  /** Which stores this read can draw on, and what kind the primary one is. */
141
150
  function storesInReach(ctx, opts, local) {
142
151
  const other = hasGroup(local.store, 'localFiles') ? undefined : local.store;
143
- // Global memories do not establish a project boundary for task state.
144
- const hasLocal = other !== undefined || isInitialized(ctx.hippoRoot);
145
- const globalRoot = getGlobalRoot();
152
+ // No reach means an integrator's own store: one project, no global store beside it.
153
+ const reach = ctx.reach ?? { hasLocal: true, isGlobal: false, shared: isSharedStore(ctx.hippoRoot) };
146
154
  // The store's own flag counts too, so no surface can read a shared store as its owner.
147
- const sharedStore = opts.sharedStore === true || isSharedStore(ctx.hippoRoot);
155
+ const sharedStore = opts.sharedStore === true || reach.shared;
148
156
  // A store serving many people is not its operator's, so the operator's own global store stays out.
149
- const hasGlobal = !sharedStore && other === undefined && isInitialized(globalRoot);
150
- const primaryIsGlobal = isGlobalStoreRoot(ctx.hippoRoot);
151
- return { other, hasLocal, globalRoot, sharedStore, hasGlobal, primaryIsGlobal };
157
+ const hasGlobal = !sharedStore && other === undefined && reach.global !== undefined;
158
+ // Global memories do not establish a project boundary for task state.
159
+ return {
160
+ other,
161
+ hasLocal: other !== undefined || reach.hasLocal,
162
+ globalRoot: reach.global?.root ?? '',
163
+ sharedStore,
164
+ hasGlobal,
165
+ primaryIsGlobal: reach.isGlobal,
166
+ };
167
+ }
168
+ /** The operator's global store, which planContext proved present before it set hasGlobal. */
169
+ function globalSource(ctx) {
170
+ const global = ctx.reach?.global;
171
+ if (global === undefined)
172
+ throw new Error('hasGlobal without a global store in reach');
173
+ return sourceOf(global.store);
152
174
  }
153
175
  /** Prices one entry against the budget: the caller's cost model when it gave one, else a token estimate. */
154
176
  function entryPricer(cost, currentProject) {
155
177
  return (entry, isGlobal, promptRecall) => cost
156
- ? cost.entry({ entry, isGlobal, promptRecall, origin: entry.origin_project ?? null, category: classifyOriginProject(entry.origin_project, currentProject) })
178
+ ? cost.entry({
179
+ entry,
180
+ isGlobal,
181
+ promptRecall,
182
+ origin: entry.origin_project ?? null,
183
+ category: classifyOriginProject(entry.origin_project, currentProject),
184
+ })
157
185
  : estimateTokens(entry.content);
158
186
  }
159
187
  function planContext(ctx, opts, local) {
160
188
  const pinnedOnly = opts.pinnedOnly === true;
161
189
  const { other, hasLocal, globalRoot, sharedStore, hasGlobal, primaryIsGlobal } = storesInReach(ctx, opts, local);
162
- const query = (opts.q ?? '').trim() || '*';
190
+ const query = (opts.q ?? '').trim() || NO_QUERY;
163
191
  // opts.scope is only the tag boost, opts.exactScope the envelope request; other-project memories are
164
192
  // excluded unless the caller asks for them (crossProject) or isolation is disabled.
165
- const config = loadConfig(ctx.hippoRoot);
193
+ const config = configOf(ctx);
166
194
  const isolationEnabled = config.contextProjectIsolation !== false;
167
195
  const currentProject = opts.currentProject ?? resolveProjectIdentity(process.cwd());
168
196
  // A caller with no project reads every row as its own; on a shared store those rows are other people's.
169
- if (sharedStore && projectId(currentProject).trim() === '')
170
- throw new BadRequestError('a shared store needs the caller\'s project');
197
+ if (sharedStore && projectId(currentProject).trim() === '') {
198
+ throw new BadRequestError("a shared store needs the caller's project");
199
+ }
171
200
  if (sharedStore && !isolationEnabled)
172
201
  warnIsolationIgnored(ctx.hippoRoot);
173
202
  const includeCrossProject = opts.crossProject === true || (!isolationEnabled && !sharedStore);
@@ -208,14 +237,22 @@ function promptRecallRequest(opts, plan) {
208
237
  ? Array.from(promptTokens(opts.prompt ?? ''))
209
238
  : [];
210
239
  return promptRecallTerms.length > 0
211
- ? { terms: promptRecallTerms, limit: Math.floor(finiteOr(pinnedInject.promptRecallCandidates, 100, 1)), ownScope: plan.ownScope }
240
+ ? {
241
+ terms: promptRecallTerms,
242
+ limit: Math.floor(finiteOr(pinnedInject.promptRecallCandidates, 100, 1)),
243
+ ownScope: plan.ownScope,
244
+ }
212
245
  : undefined;
213
246
  }
214
247
  /** Reports the block's facts to the observer and returns the budget left after the fixed headers. */
215
248
  function openBlockBudget(plan, opts, budget) {
216
249
  const { config, cost, obs, pinnedOnly, promptRecallPending } = plan;
217
250
  const blockBudget = pinnedOnly && opts.budget === undefined ? config.pinnedInject.budget : budget;
218
- obs?.facts({ projectName: projectId(plan.currentProject), budgetTokens: blockBudget, promptRecall: promptRecallPending });
251
+ obs?.facts({
252
+ projectName: projectId(plan.currentProject),
253
+ budgetTokens: blockBudget,
254
+ promptRecall: promptRecallPending,
255
+ });
219
256
  if (pinnedOnly && !config.pinnedInject.enabled)
220
257
  obs?.disabled();
221
258
  if (!pinnedOnly)
@@ -234,7 +271,8 @@ async function loadRawTaskState(ctx, opts, plan) {
234
271
  if (!plan.hasLocalTaskState)
235
272
  return NO_TASK_STATE;
236
273
  const { store, reads } = plan.local;
237
- // On a shared store task state is one person's, keyed by owner and project so it follows them into their next session.
274
+ // On a shared store task state is one person's, keyed by owner
275
+ // and project so it follows them into their next session.
238
276
  const key = plan.sharedStore
239
277
  ? { owner: ownerOrSubject(ctx.actor), project: projectNames(plan.currentProject) }
240
278
  : null;
@@ -245,36 +283,73 @@ async function loadRawTaskState(ctx, opts, plan) {
245
283
  if (snapshot?.session_id)
246
284
  return { snapshot, handoff: block.sessionHandoff, events: block.recentSessionEvents };
247
285
  // An unfinished handoff's scope is admitted in the read, so a newer denied row can't hide an older eligible one.
248
- return { snapshot, handoff: await reads.unfinishedHandoff(ctx.tenantId, SNAPSHOT_AMBIENT_MAX_AGE_MS, key), events: [] };
286
+ return {
287
+ snapshot,
288
+ handoff: await reads.unfinishedHandoff(ctx.tenantId, SNAPSHOT_AMBIENT_MAX_AGE_MS, key),
289
+ events: [],
290
+ };
249
291
  }
250
- // Sections print ahead of the memories, so they are paid first; one that does not fit is dropped, as an oversize entry is.
292
+ // Sections print ahead of the memories, so they are paid first;
293
+ // one that does not fit is dropped, as an oversize entry is.
251
294
  async function loadTaskSections(ctx, opts, plan, startLeft) {
252
295
  const { exactScope, ownScope, cost } = plan;
253
- let left = startLeft;
254
- const pays = (tokens) => {
255
- if (tokens > left)
256
- return false;
257
- left -= tokens;
258
- return true;
259
- };
296
+ const { pays, left } = tokenPurse(startLeft);
260
297
  const rowScope = (r) => r?.scope ?? null;
261
298
  const raw = await loadRawTaskState(ctx, opts, plan);
262
299
  // The same envelope rule ambientAdmitEntry applies to memory rows.
263
300
  const activeSnapshot = raw.snapshot && passesScopeFilterForRecall(rowScope(raw.snapshot), exactScope, ownScope) ? raw.snapshot : null;
264
301
  const sessionHandoff = raw.handoff && passesScopeFilterForRecall(rowScope(raw.handoff), exactScope, ownScope) ? raw.handoff : null;
265
- const recentSessionEvents = raw.events.filter((e) => passesScopeFilterForRecall(rowScope(e), exactScope, ownScope));
266
- const shownSnapshot = activeSnapshot && (!cost || pays(cost.snapshot(activeSnapshot))) ? activeSnapshot : null;
267
- const shownHandoff = sessionHandoff && (!cost || pays(cost.handoff(sessionHandoff))) ? sessionHandoff : null;
302
+ const snapshotMode = continuityModeFor(opts, plan, activeSnapshot?.session_id, 'pointer');
303
+ const handoffMode = continuityModeFor(opts, plan, sessionHandoff?.sessionId, 'full');
304
+ const shownSnapshot = activeSnapshot && (!cost || pays(cost.snapshot(activeSnapshot, snapshotMode))) ? activeSnapshot : null;
305
+ const shownHandoff = sessionHandoff && (!cost || pays(cost.handoff(sessionHandoff, handoffMode))) ? sessionHandoff : null;
306
+ // The pointer's command prints the snapshot session's events, so they drop only when that pointer is shown.
307
+ const recentSessionEvents = shownSnapshot !== null && snapshotMode === 'pointer'
308
+ ? []
309
+ : raw.events.filter((e) => passesScopeFilterForRecall(rowScope(e), exactScope, ownScope));
268
310
  const shownEvents = recentSessionEvents.length > 0 && (!cost || pays(cost.trail(recentSessionEvents))) ? recentSessionEvents : [];
269
- plan.obs?.sections(Number(shownSnapshot !== null) + Number(shownHandoff !== null) + Number(shownEvents.length > 0), Number(activeSnapshot !== shownSnapshot) + Number(sessionHandoff !== shownHandoff) + Number(recentSessionEvents.length !== shownEvents.length));
270
- return { activeSnapshot, shownSnapshot, shownHandoff, shownEvents, left };
311
+ plan.obs?.sections(Number(shownSnapshot !== null) + Number(shownHandoff !== null) + Number(shownEvents.length > 0), Number(activeSnapshot !== shownSnapshot) +
312
+ Number(sessionHandoff !== shownHandoff) +
313
+ Number(recentSessionEvents.length !== shownEvents.length));
314
+ return { activeSnapshot, shownSnapshot, snapshotMode, shownHandoff, handoffMode, shownEvents, left: left() };
315
+ }
316
+ // The command must return this reader's row, so own, shared-store, unsafe-id print whole; no id: `hippo snapshot show`.
317
+ function continuityModeFor(opts, plan, sessionId, noIdMode) {
318
+ if (opts.continuity !== 'pointer' || plan.sharedStore)
319
+ return 'full';
320
+ if (!sessionId)
321
+ return noIdMode;
322
+ return sessionId === opts.currentSessionId || !isPointerSafeId(sessionId) ? 'full' : 'pointer';
323
+ }
324
+ // The mode is left out of a full print, so every reader's result reads as before.
325
+ function pointerModes(s) {
326
+ const modes = {};
327
+ if (s.shownSnapshot && s.snapshotMode === 'pointer')
328
+ modes.snapshotMode = 'pointer';
329
+ if (s.shownHandoff && s.handoffMode === 'pointer')
330
+ modes.handoffMode = 'pointer';
331
+ return modes;
332
+ }
333
+ function contextResult(recorded, tokens, s) {
334
+ return {
335
+ entries: recorded.items,
336
+ tokens,
337
+ activeSnapshot: s.shownSnapshot ?? undefined,
338
+ sessionHandoff: s.shownHandoff ?? undefined,
339
+ ...pointerModes(s),
340
+ recentEvents: s.shownEvents.length > 0 ? s.shownEvents : undefined,
341
+ ambientState: recorded.ambientState,
342
+ };
271
343
  }
272
344
  function ambientAdmission(opts, plan, shownHandoff) {
273
345
  const transcriptHandoffSession = shownHandoff?.evidence?.derivedFrom === 'transcript' ? shownHandoff.sessionId : null;
274
346
  const ambientAdmit = (e) => {
275
- // A printed handoff already carries the session's closing message, which its digest would print a second time.
276
- if (transcriptHandoffSession !== null && e.source_session_id === transcriptHandoffSession && isSessionDigestRow(e))
347
+ // A shown handoff, whole or as a pointer, stands for the session's closing message; its command prints it.
348
+ if (transcriptHandoffSession !== null &&
349
+ e.source_session_id === transcriptHandoffSession &&
350
+ isSessionDigestRow(e)) {
277
351
  return false;
352
+ }
278
353
  return ambientAdmitEntry(e, plan.currentProject, plan.includeCrossProject, plan.exactScope, plan.ownScope);
279
354
  };
280
355
  const ownSessionId = opts.currentSessionId || '';
@@ -282,13 +357,15 @@ function ambientAdmission(opts, plan, shownHandoff) {
282
357
  const isOwnCompactionItem = (e) => ownSessionId !== '' &&
283
358
  e.source_session_id === ownSessionId &&
284
359
  e.tags.includes(COMPACTION_MEMORY_TAG);
285
- // Superseded rows never inject; which rows reach ambientAdmitEntry matters because it regex-scans content for secrets.
360
+ // Superseded rows never inject; which rows reach ambientAdmitEntry
361
+ // matters because it regex-scans content for secrets.
286
362
  const admit = (e) => !e.superseded_by && !isOwnCompactionItem(e) && ambientAdmit(e);
287
363
  // The two-store search has always ranked a session's own compaction items; only the local search drops them.
288
364
  const bothStoresAdmit = (e) => !e.superseded_by && ambientAdmit(e);
289
365
  return { ambientAdmit, admit, bothStoresAdmit };
290
366
  }
291
- /** Origins the recent backfill may read past its first window; on a shared store, only the caller's own project rows. */
367
+ /** Origins the recent backfill may read past its first window;
368
+ * on a shared store, only the caller's own project rows. */
292
369
  function recentOrigins(plan) {
293
370
  if (plan.sharedStore)
294
371
  return { names: projectNames(plan.currentProject).filter((n) => n !== ''), userGlobal: false };
@@ -297,7 +374,7 @@ function recentOrigins(plan) {
297
374
  async function loadPools(ctx, plan, admission, recallRequest) {
298
375
  const { obs, pinnedOnly, primaryIsGlobal, hasGlobal, exactScope, ownScope } = plan;
299
376
  const recent = { needed: plan.includeRecent, origins: recentOrigins(plan) };
300
- const searches = plan.query !== '*' && !pinnedOnly;
377
+ const searches = plan.query !== NO_QUERY && !pinnedOnly;
301
378
  const searchesBoth = searches && hasGlobal && !primaryIsGlobal;
302
379
  const poolAdmit = searchesBoth ? admission.bothStoresAdmit : admission.admit;
303
380
  const loadAdmit = obs ? obs.watchAdmit(poolAdmit) : poolAdmit;
@@ -318,7 +395,10 @@ async function loadPools(ctx, plan, admission, recallRequest) {
318
395
  ? await loadAmbientEntries(plan.local, ctx.tenantId, { ...read, onQualityDrop: qualityDrop(primaryIsGlobal) })
319
396
  : { entries: [] };
320
397
  const global = hasGlobal && !primaryIsGlobal
321
- ? await loadAmbientEntries(sourceOf(sqliteStore(plan.globalRoot)), ctx.tenantId, { ...read, onQualityDrop: qualityDrop(true) })
398
+ ? await loadAmbientEntries(globalSource(ctx), ctx.tenantId, {
399
+ ...read,
400
+ onQualityDrop: qualityDrop(true),
401
+ })
322
402
  : { entries: [] };
323
403
  return { local, global };
324
404
  }
@@ -327,7 +407,7 @@ function finalizeSelection(picked, plan) {
327
407
  const { obs } = plan;
328
408
  // Ranking reports nothing itself, so its results are offered here and the cuts below can name what they drop.
329
409
  if (!plan.pinnedOnly && obs) {
330
- const pool = plan.query === '*' ? 'strength' : 'search';
410
+ const pool = plan.query === NO_QUERY ? 'strength' : 'search';
331
411
  obs.offer(picked.filter((r) => r.isGlobal !== true).map((r) => r.entry), false, pool);
332
412
  obs.offer(picked.filter((r) => r.isGlobal === true).map((r) => r.entry), true, pool);
333
413
  }
@@ -337,11 +417,13 @@ function finalizeSelection(picked, plan) {
337
417
  obs?.dropMissing(selected.map((r) => r.entry), cut.map((r) => r.entry), 'limit', 'limit');
338
418
  selected = cut;
339
419
  }
340
- const heldDropped = dropHeldCopies(selected, (r) => r.entry); // after the last cut, so a merged row that was cut hides nothing
420
+ // After the last cut, so a merged row that was cut hides nothing.
421
+ const heldDropped = dropHeldCopies(selected, (r) => r.entry);
341
422
  obs?.dropMissing(selected.map((r) => r.entry), heldDropped.map((r) => r.entry), 'limit', 'duplicate');
342
423
  selected = heldDropped;
343
424
  const tokens = selected.reduce((sum, r) => sum + r.tokens, 0);
344
- // Every returned entry carries its origin and how it relates to the active project, so renderers can mark cross-project rows.
425
+ // Every returned entry carries its origin and how it relates to
426
+ // the active project, so renderers can mark cross-project rows.
345
427
  selected = selected.map((r) => ({
346
428
  ...r,
347
429
  origin: r.entry.origin_project ?? null,
@@ -363,11 +445,11 @@ async function traceEmptyContext(ctx, opts, plan) {
363
445
  };
364
446
  // The empty reply is already decided, so a lost trace is logged and the call still answers.
365
447
  try {
366
- await storeFor(ctx).finishRecall({ goalLog: [], audit: [], trace });
448
+ await ctx.store.finishRecall({ goalLog: [], audit: [], trace });
367
449
  }
368
450
  catch (error) {
369
451
  rethrowIfSqliteBlocked(error);
370
- log.error(`recall trace write failed: ${errorMessage(error)}`);
452
+ log.error(`recall trace write failed: ${errorMessage(error)}`, errorFields(error));
371
453
  }
372
454
  }
373
455
  /** Strengthens and marks the returned rows, then writes the trace and index together. */
@@ -388,7 +470,7 @@ async function recordRetrieval(ctx, opts, plan, selected, activeSnapshot) {
388
470
  };
389
471
  const writes = { goalLog: [], audit: [], trace, strengthen: strengthenOf(ctx, retrievedIds) };
390
472
  // The last recall feeds only outcomeForLastRecall, so a store that keeps none still finishes the recall without one.
391
- const store = storeFor(ctx);
473
+ const store = ctx.store;
392
474
  const traceId = store.lastRecall
393
475
  ? await store.lastRecall.finishRecall(writes, plan.hasGlobal ? plan.globalRoot : undefined)
394
476
  : await store.finishRecall(writes).then(() => null);
@@ -413,7 +495,7 @@ async function readAmbientState(ctx, plan) {
413
495
  };
414
496
  const sources = [
415
497
  ...(plan.hasLocal ? [plan.local.reads] : []),
416
- ...(plan.hasGlobal && !plan.primaryIsGlobal ? [sourceOf(sqliteStore(plan.globalRoot)).reads] : []),
498
+ ...(plan.hasGlobal && !plan.primaryIsGlobal ? [globalSource(ctx).reads] : []),
417
499
  ];
418
500
  const tallies = [];
419
501
  for (const reads of sources)
@@ -1,47 +1,50 @@
1
1
  import type { HandoffOutcome, SessionHandoff } from '../core/handoff.js';
2
2
  import type { SessionEvent, TaskSnapshot } from '../store/rows.js';
3
- import { appendSessionEvent, listSessionEvents, saveActiveTaskSnapshot } from '../store/sessions.js';
4
- import { wmClear, wmFlush, wmPush, wmRead, type WorkingMemoryItem } from '../store/working-memory.js';
5
- import type { Context } from './types.js';
3
+ import type { SessionEventInput, SnapshotInput } from '../store/sessions.js';
4
+ import type { Sessions } from '../store/index.js';
5
+ import type { WorkingMemoryItem } from '../store/working-memory.js';
6
+ import type { ContextWith } from './types.js';
7
+ type Ctx = ContextWith<'sessions'>;
6
8
  /** What a snapshot save carries. */
7
- export type SnapshotSaveInput = Parameters<typeof saveActiveTaskSnapshot>[2];
9
+ export type SnapshotSaveInput = SnapshotInput;
8
10
  /** What a session event append carries. */
9
- export type SessionEventAppendInput = Parameters<typeof appendSessionEvent>[2];
11
+ export type SessionEventAppendInput = SessionEventInput;
10
12
  /** What a session event listing filters on. */
11
- export type SessionEventListOpts = NonNullable<Parameters<typeof listSessionEvents>[2]>;
13
+ export type SessionEventListOpts = Parameters<Sessions['listEvents']>[1];
12
14
  /** Save the caller's active task snapshot. */
13
- export declare function snapshotSave(ctx: Context, input: SnapshotSaveInput): TaskSnapshot;
15
+ export declare function snapshotSave(ctx: Ctx, input: SnapshotSaveInput): Promise<TaskSnapshot>;
14
16
  /** Clear the caller's active task snapshot; false when there was none. */
15
- export declare function snapshotClear(ctx: Context, status: string): boolean;
17
+ export declare function snapshotClear(ctx: Ctx, status: string): Promise<boolean>;
16
18
  /** The caller's active task snapshot, or null. */
17
- export declare function snapshotLoad(ctx: Context): TaskSnapshot | null;
19
+ export declare function snapshotLoad(ctx: Ctx): Promise<TaskSnapshot | null>;
18
20
  /** Append a session event in the caller's tenant. */
19
- export declare function sessionEventAppend(ctx: Context, event: SessionEventAppendInput): SessionEvent;
21
+ export declare function sessionEventAppend(ctx: Ctx, event: SessionEventAppendInput): Promise<SessionEvent>;
20
22
  /** List the caller's session events. */
21
- export declare function sessionEventList(ctx: Context, opts: SessionEventListOpts): SessionEvent[];
23
+ export declare function sessionEventList(ctx: Ctx, opts: SessionEventListOpts): Promise<SessionEvent[]>;
22
24
  export interface LatestContinuity {
23
25
  snapshot: TaskSnapshot | null;
24
26
  events: SessionEvent[];
25
27
  }
26
28
  /** The active snapshot plus recent events for `sessionId`, falling back to the snapshot's own session. */
27
- export declare function continuityLatest(ctx: Context, opts: {
29
+ export declare function continuityLatest(ctx: Ctx, opts: {
28
30
  sessionId?: string;
29
31
  limit: number;
30
- }): LatestContinuity;
32
+ }): Promise<LatestContinuity>;
31
33
  /** Stamp the outcome on the caller's handoff for `sessionId`; returns the rows stamped. */
32
- export declare function handoffStampOutcome(ctx: Context, sessionId: string, outcome: HandoffOutcome): number;
34
+ export declare function handoffStampOutcome(ctx: Ctx, sessionId: string, outcome: HandoffOutcome): Promise<number>;
33
35
  /** Save a session handoff in the caller's tenant. */
34
- export declare function handoffSave(ctx: Context, handoff: Omit<SessionHandoff, 'updatedAt'>): SessionHandoff;
36
+ export declare function handoffSave(ctx: Ctx, handoff: Omit<SessionHandoff, 'updatedAt'>): Promise<SessionHandoff>;
35
37
  /** The caller's latest handoff, optionally for one session. */
36
- export declare function handoffLatest(ctx: Context, sessionId?: string): SessionHandoff | null;
38
+ export declare function handoffLatest(ctx: Ctx, sessionId?: string): Promise<SessionHandoff | null>;
37
39
  /** The caller's handoff by id, or null. */
38
- export declare function handoffById(ctx: Context, id: number): SessionHandoff | null;
40
+ export declare function handoffById(ctx: Ctx, id: number): Promise<SessionHandoff | null>;
39
41
  /** Push a working memory entry in the caller's tenant; returns its row id. */
40
- export declare function workingMemoryPush(ctx: Context, opts: Omit<Parameters<typeof wmPush>[1], 'tenantId'>): number;
42
+ export declare function workingMemoryPush(ctx: Ctx, opts: Parameters<Sessions['pushWorkingMemory']>[1]): Promise<number>;
41
43
  /** The caller's working memory entries, most important first. */
42
- export declare function workingMemoryRead(ctx: Context, opts: Omit<NonNullable<Parameters<typeof wmRead>[1]>, 'tenantId'>): WorkingMemoryItem[];
44
+ export declare function workingMemoryRead(ctx: Ctx, opts: Parameters<Sessions['readWorkingMemory']>[1]): Promise<WorkingMemoryItem[]>;
43
45
  /** Delete the caller's working memory entries; returns the count. */
44
- export declare function workingMemoryClear(ctx: Context, opts: Omit<NonNullable<Parameters<typeof wmClear>[1]>, 'tenantId'>): number;
46
+ export declare function workingMemoryClear(ctx: Ctx, opts: Parameters<Sessions['clearWorkingMemory']>[1]): Promise<number>;
45
47
  /** Flush the caller's working memory at session end; returns the count. */
46
- export declare function workingMemoryFlush(ctx: Context, opts: Omit<NonNullable<Parameters<typeof wmFlush>[1]>, 'tenantId'>): number;
48
+ export declare function workingMemoryFlush(ctx: Ctx, opts: Parameters<Sessions['clearWorkingMemory']>[1]): Promise<number>;
49
+ export {};
47
50
  //# sourceMappingURL=continuity.d.ts.map
@@ -1,66 +1,64 @@
1
1
  // Where-you-left-off ops: task snapshot, session events, handoffs and working memory.
2
- import { appendSessionEvent, clearActiveTaskSnapshot, listSessionEvents, loadActiveTaskSnapshot, saveActiveTaskSnapshot, } from '../store/sessions.js';
3
- import { loadHandoffById, loadLatestHandoff, saveSessionHandoff, stampHandoffOutcome } from '../store/handoffs.js';
4
- import { wmClear, wmFlush, wmPush, wmRead } from '../store/working-memory.js';
5
2
  /** Save the caller's active task snapshot. */
6
3
  export function snapshotSave(ctx, input) {
7
- return saveActiveTaskSnapshot(ctx.hippoRoot, ctx.tenantId, input);
4
+ return ctx.store.sessions.saveSnapshot(ctx.tenantId, input, null);
8
5
  }
9
6
  /** Clear the caller's active task snapshot; false when there was none. */
10
7
  export function snapshotClear(ctx, status) {
11
- return clearActiveTaskSnapshot(ctx.hippoRoot, ctx.tenantId, status);
8
+ return ctx.store.sessions.clearSnapshot(ctx.tenantId, status);
12
9
  }
13
10
  /** The caller's active task snapshot, or null. */
14
11
  export function snapshotLoad(ctx) {
15
- return loadActiveTaskSnapshot(ctx.hippoRoot, ctx.tenantId);
12
+ return ctx.store.sessions.loadSnapshot(ctx.tenantId, null);
16
13
  }
17
14
  /** Append a session event in the caller's tenant. */
18
15
  export function sessionEventAppend(ctx, event) {
19
- return appendSessionEvent(ctx.hippoRoot, ctx.tenantId, event);
16
+ return ctx.store.sessions.appendEvent(ctx.tenantId, event);
20
17
  }
21
18
  /** List the caller's session events. */
22
19
  export function sessionEventList(ctx, opts) {
23
- return listSessionEvents(ctx.hippoRoot, ctx.tenantId, opts);
20
+ return ctx.store.sessions.listEvents(ctx.tenantId, opts);
24
21
  }
25
22
  /** The active snapshot plus recent events for `sessionId`, falling back to the snapshot's own session. */
26
- export function continuityLatest(ctx, opts) {
27
- const snapshot = loadActiveTaskSnapshot(ctx.hippoRoot, ctx.tenantId);
28
- const events = listSessionEvents(ctx.hippoRoot, ctx.tenantId, {
29
- session_id: opts.sessionId || snapshot?.session_id || undefined,
23
+ export async function continuityLatest(ctx, opts) {
24
+ const { sessions } = ctx.store;
25
+ const snapshot = await sessions.loadSnapshot(ctx.tenantId, null);
26
+ const events = await sessions.listEvents(ctx.tenantId, {
27
+ sessionId: opts.sessionId || snapshot?.session_id || undefined,
30
28
  limit: opts.limit,
31
29
  });
32
30
  return { snapshot, events };
33
31
  }
34
32
  /** Stamp the outcome on the caller's handoff for `sessionId`; returns the rows stamped. */
35
33
  export function handoffStampOutcome(ctx, sessionId, outcome) {
36
- return stampHandoffOutcome(ctx.hippoRoot, ctx.tenantId, sessionId, outcome);
34
+ return ctx.store.sessions.stampHandoffOutcome(ctx.tenantId, sessionId, outcome);
37
35
  }
38
36
  /** Save a session handoff in the caller's tenant. */
39
37
  export function handoffSave(ctx, handoff) {
40
- return saveSessionHandoff(ctx.hippoRoot, ctx.tenantId, handoff);
38
+ return ctx.store.sessions.saveHandoff(ctx.tenantId, handoff, null);
41
39
  }
42
40
  /** The caller's latest handoff, optionally for one session. */
43
41
  export function handoffLatest(ctx, sessionId) {
44
- return loadLatestHandoff(ctx.hippoRoot, ctx.tenantId, sessionId);
42
+ return ctx.store.sessions.latestHandoff(ctx.tenantId, sessionId ?? null, {}, null);
45
43
  }
46
44
  /** The caller's handoff by id, or null. */
47
45
  export function handoffById(ctx, id) {
48
- return loadHandoffById(ctx.hippoRoot, ctx.tenantId, id);
46
+ return ctx.store.sessions.handoffById(ctx.tenantId, id);
49
47
  }
50
48
  /** Push a working memory entry in the caller's tenant; returns its row id. */
51
49
  export function workingMemoryPush(ctx, opts) {
52
- return wmPush(ctx.hippoRoot, { ...opts, tenantId: ctx.tenantId });
50
+ return ctx.store.sessions.pushWorkingMemory(ctx.tenantId, opts);
53
51
  }
54
52
  /** The caller's working memory entries, most important first. */
55
53
  export function workingMemoryRead(ctx, opts) {
56
- return wmRead(ctx.hippoRoot, { ...opts, tenantId: ctx.tenantId });
54
+ return ctx.store.sessions.readWorkingMemory(ctx.tenantId, opts);
57
55
  }
58
56
  /** Delete the caller's working memory entries; returns the count. */
59
57
  export function workingMemoryClear(ctx, opts) {
60
- return wmClear(ctx.hippoRoot, { ...opts, tenantId: ctx.tenantId });
58
+ return ctx.store.sessions.clearWorkingMemory(ctx.tenantId, opts);
61
59
  }
62
60
  /** Flush the caller's working memory at session end; returns the count. */
63
61
  export function workingMemoryFlush(ctx, opts) {
64
- return wmFlush(ctx.hippoRoot, { ...opts, tenantId: ctx.tenantId });
62
+ return ctx.store.sessions.clearWorkingMemory(ctx.tenantId, opts);
65
63
  }
66
64
  //# sourceMappingURL=continuity.js.map
@@ -18,7 +18,9 @@ export interface CorrectionLatencyReport {
18
18
  maxMs: number | null;
19
19
  pairs: CorrectionPair[];
20
20
  }
21
- /** Correction latency = `new.created` minus the observation time (the extracted-from row's `created`, else `new.created`).
21
+ /**
22
+ * Correction latency = `new.created` minus the observation time (the extracted-from row's `created`, else
23
+ * `new.created`).
22
24
  * Manual supersedes have latency 0 and are excluded from percentiles so they do not mask real lag. */
23
25
  export declare function buildCorrectionLatency(entries: MemoryEntry[]): CorrectionLatencyReport;
24
26
  //# sourceMappingURL=correction-latency.d.ts.map
@@ -10,7 +10,9 @@ function percentile(sorted, q) {
10
10
  return sorted[lo];
11
11
  return sorted[lo] + (sorted[hi] - sorted[lo]) * (idx - lo);
12
12
  }
13
- /** Correction latency = `new.created` minus the observation time (the extracted-from row's `created`, else `new.created`).
13
+ /**
14
+ * Correction latency = `new.created` minus the observation time (the extracted-from row's `created`, else
15
+ * `new.created`).
14
16
  * Manual supersedes have latency 0 and are excluded from percentiles so they do not mask real lag. */
15
17
  export function buildCorrectionLatency(entries) {
16
18
  const byId = new Map();
@@ -3,6 +3,9 @@ export interface ApiErrorReply {
3
3
  status: number;
4
4
  message: string;
5
5
  }
6
- /** Maps by class so rewording a message never moves a status; an untyped error is a 500 whose text stays in the server log. */
6
+ /**
7
+ * Maps by class so rewording a message never moves a status; an untyped error is a 500 whose text stays in the server
8
+ * log.
9
+ */
7
10
  export declare function mapApiError<E>(err: E): ApiErrorReply;
8
11
  //# sourceMappingURL=error-reply.d.ts.map