@snoai/memory 0.0.0-stage → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (478) hide show
  1. package/LICENSE +176 -0
  2. package/README.md +33 -2
  3. package/config/b-profile-section-registry.json +118 -0
  4. package/config/llm/compiled/2026-05-19T230932Z/manifest.json +25 -0
  5. package/config/llm/compiled/2026-05-19T230932Z/registry-root.json +67 -0
  6. package/config/llm/compiled/2026-05-19T230932Z/resolved/mem_claw/openai_gpt_5_nano.json +5 -0
  7. package/config/llm/compiled/2026-05-19T230932Z/resolved/mem_claw/openrouter_auto.json +5 -0
  8. package/config/llm/compiled/2026-05-19T230932Z/resolved/mem_claw/sno_ai_extract.json +5 -0
  9. package/config/llm/compiled/2026-05-19T230932Z/source/mem_claw/openai_gpt_5_nano.mda +24 -0
  10. package/config/llm/compiled/2026-05-19T230932Z/source/mem_claw/openrouter_auto.mda +24 -0
  11. package/config/llm/compiled/2026-05-19T230932Z/source/mem_claw/sno_ai_extract.mda +24 -0
  12. package/config/llm/compiled/2026-07-21T001311Z/manifest.json +43 -0
  13. package/config/llm/compiled/2026-07-21T001311Z/registry-root.json +97 -0
  14. package/config/llm/compiled/2026-07-21T001311Z/resolved/mem_claw/openai_gpt_5_nano.json +5 -0
  15. package/config/llm/compiled/2026-07-21T001311Z/resolved/mem_claw/openrouter_auto.json +5 -0
  16. package/config/llm/compiled/2026-07-21T001311Z/resolved/mem_claw/sno_ai_extract.json +5 -0
  17. package/config/llm/compiled/2026-07-21T001311Z/resolved/mem_claw/sno_conflict_verdict.json +10 -0
  18. package/config/llm/compiled/2026-07-21T001311Z/resolved/mem_claw/sno_extract_chat.json +10 -0
  19. package/config/llm/compiled/2026-07-21T001311Z/resolved/mem_claw/sno_extract_profile.json +10 -0
  20. package/config/llm/compiled/2026-07-21T001311Z/source/mem_claw/openai_gpt_5_nano.mda +24 -0
  21. package/config/llm/compiled/2026-07-21T001311Z/source/mem_claw/openrouter_auto.mda +24 -0
  22. package/config/llm/compiled/2026-07-21T001311Z/source/mem_claw/sno_ai_extract.mda +24 -0
  23. package/config/llm/compiled/2026-07-21T001311Z/source/mem_claw/sno_conflict_verdict.mda +27 -0
  24. package/config/llm/compiled/2026-07-21T001311Z/source/mem_claw/sno_extract_chat.mda +27 -0
  25. package/config/llm/compiled/2026-07-21T001311Z/source/mem_claw/sno_extract_profile.mda +27 -0
  26. package/config/llm/compiled/2026-08-29T060335Z/manifest.json +43 -0
  27. package/config/llm/compiled/2026-08-29T060335Z/registry-root.json +97 -0
  28. package/config/llm/compiled/2026-08-29T060335Z/resolved/mem_claw/openai_gpt_5_nano.json +5 -0
  29. package/config/llm/compiled/2026-08-29T060335Z/resolved/mem_claw/openrouter_auto.json +5 -0
  30. package/config/llm/compiled/2026-08-29T060335Z/resolved/mem_claw/sno_ai_extract.json +5 -0
  31. package/config/llm/compiled/2026-08-29T060335Z/resolved/mem_claw/sno_conflict_verdict.json +10 -0
  32. package/config/llm/compiled/2026-08-29T060335Z/resolved/mem_claw/sno_extract_chat.json +10 -0
  33. package/config/llm/compiled/2026-08-29T060335Z/resolved/mem_claw/sno_extract_profile.json +10 -0
  34. package/config/llm/compiled/2026-08-29T060335Z/source/mem_claw/openai_gpt_5_nano.mda +24 -0
  35. package/config/llm/compiled/2026-08-29T060335Z/source/mem_claw/openrouter_auto.mda +24 -0
  36. package/config/llm/compiled/2026-08-29T060335Z/source/mem_claw/sno_ai_extract.mda +24 -0
  37. package/config/llm/compiled/2026-08-29T060335Z/source/mem_claw/sno_conflict_verdict.mda +27 -0
  38. package/config/llm/compiled/2026-08-29T060335Z/source/mem_claw/sno_extract_chat.mda +27 -0
  39. package/config/llm/compiled/2026-08-29T060335Z/source/mem_claw/sno_extract_profile.mda +27 -0
  40. package/config/llm/compiled/2026-09-04T004828Z/manifest.json +43 -0
  41. package/config/llm/compiled/2026-09-04T004828Z/registry-root.json +97 -0
  42. package/config/llm/compiled/2026-09-04T004828Z/resolved/mem_claw/openai_gpt_5_nano.json +5 -0
  43. package/config/llm/compiled/2026-09-04T004828Z/resolved/mem_claw/openrouter_auto.json +5 -0
  44. package/config/llm/compiled/2026-09-04T004828Z/resolved/mem_claw/sno_ai_extract.json +5 -0
  45. package/config/llm/compiled/2026-09-04T004828Z/resolved/mem_claw/sno_conflict_verdict.json +10 -0
  46. package/config/llm/compiled/2026-09-04T004828Z/resolved/mem_claw/sno_extract_chat.json +10 -0
  47. package/config/llm/compiled/2026-09-04T004828Z/resolved/mem_claw/sno_extract_profile.json +10 -0
  48. package/config/llm/compiled/2026-09-04T004828Z/source/mem_claw/openai_gpt_5_nano.mda +24 -0
  49. package/config/llm/compiled/2026-09-04T004828Z/source/mem_claw/openrouter_auto.mda +24 -0
  50. package/config/llm/compiled/2026-09-04T004828Z/source/mem_claw/sno_ai_extract.mda +24 -0
  51. package/config/llm/compiled/2026-09-04T004828Z/source/mem_claw/sno_conflict_verdict.mda +27 -0
  52. package/config/llm/compiled/2026-09-04T004828Z/source/mem_claw/sno_extract_chat.mda +27 -0
  53. package/config/llm/compiled/2026-09-04T004828Z/source/mem_claw/sno_extract_profile.mda +27 -0
  54. package/config/llm/current.json +4 -0
  55. package/config/llm/source/mem_claw/openai_gpt_5_nano.mda +24 -0
  56. package/config/llm/source/mem_claw/openrouter_auto.mda +24 -0
  57. package/config/llm/source/mem_claw/sno_ai_extract.mda +24 -0
  58. package/config/llm/source/mem_claw/sno_conflict_verdict.mda +27 -0
  59. package/config/llm/source/mem_claw/sno_extract_chat.mda +27 -0
  60. package/config/llm/source/mem_claw/sno_extract_profile.mda +27 -0
  61. package/config/llm.trust.json +37 -0
  62. package/dist/_types-CUKHSRkS.d.ts +103 -0
  63. package/dist/access-tracker-BbEvEocb.d.ts +110 -0
  64. package/dist/adapter-B7Jox9-6.d.ts +69 -0
  65. package/dist/adapter-XaRHZWZ2.js +333 -0
  66. package/dist/agent-llm-port-5oXgBpzJ.d.ts +53 -0
  67. package/dist/all-resources-BQK2ugjB.js +6379 -0
  68. package/dist/all-resources-Dij6l5h0.d.ts +18 -0
  69. package/dist/ambient-learning-text-normalizer-CxjATmMp.js +170 -0
  70. package/dist/ambient-learning-text-normalizer-_fH3LeuK.d.ts +10 -0
  71. package/dist/atomic-extraction-reply-BJ9XV_9s.js +863 -0
  72. package/dist/atomic-extraction-skill-CcXmuCqL.js +56 -0
  73. package/dist/atomic-memory-extraction-C5rmogoY.js +3605 -0
  74. package/dist/atomic-memory-extraction-d9EG-4ti.d.ts +327 -0
  75. package/dist/b-profile-section-dictionary-provider-BHkoNqgk.js +1812 -0
  76. package/dist/b-profile-section-dictionary-provider-BxbksLj3.d.ts +62 -0
  77. package/dist/best-effort-BPZSzKk0.d.ts +9 -0
  78. package/dist/calendar-instruction-CzqZbAPG.js +194 -0
  79. package/dist/capture-policy-detector-CxbHPkMX.d.ts +53 -0
  80. package/dist/capture-policy-detector-DaMfy9CZ.js +357 -0
  81. package/dist/classifier-DnbbtwTS.d.ts +272 -0
  82. package/dist/client.d.ts +34 -0
  83. package/dist/client.js +306 -0
  84. package/dist/coding-skin.d.ts +51 -0
  85. package/dist/coding-skin.js +55 -0
  86. package/dist/config-CL90qYva.js +2576 -0
  87. package/dist/connection-3IVXpuPE.d.ts +391 -0
  88. package/dist/connection-C9YD5sgm.js +297 -0
  89. package/dist/daily-log-generator-CH_KuWHs.js +469 -0
  90. package/dist/daily-log-generator-CsQPHl4A.d.ts +73 -0
  91. package/dist/daily-spend-estimator-DiwzBlo1.d.ts +8 -0
  92. package/dist/data-bootstrap-Bl3lthzE.d.ts +30 -0
  93. package/dist/data-bootstrap-P8sie9WA.js +172 -0
  94. package/dist/data-paths-C7sNdqvP.d.ts +22 -0
  95. package/dist/derived-suppression-cache-CI0durYx.d.ts +36 -0
  96. package/dist/diagnostic-encoder.d.ts +6 -0
  97. package/dist/diagnostic-encoder.js +29 -0
  98. package/dist/embedding-provider-client-Q_hJonK9.js +294 -0
  99. package/dist/embedding-provider-client-vynZMuit.d.ts +94 -0
  100. package/dist/entry-metadata-parser-BIVSMCIk.js +20 -0
  101. package/dist/error-D-wb-rZw.js +23 -0
  102. package/dist/error-signals-D8_3vYu4.d.ts +28 -0
  103. package/dist/error-signals-lMH2uAdV.js +134 -0
  104. package/dist/errors-CeVRxf9V.d.ts +49 -0
  105. package/dist/extraction-text-sanitizer-B_AhIecT.d.ts +32 -0
  106. package/dist/i18n-text-DbD6Qify.d.ts +13 -0
  107. package/dist/index-0aqS8pVF.d.ts +351 -0
  108. package/dist/index-BO4RU_mc.d.ts +650 -0
  109. package/dist/index-DL8AVj0Z.d.ts +571 -0
  110. package/dist/index.d.ts +65 -0
  111. package/dist/index.js +1201 -0
  112. package/dist/intent-analyzer-B5XVrWwe.d.ts +28 -0
  113. package/dist/internal/config/index.d.ts +2 -0
  114. package/dist/internal/config/index.js +581 -0
  115. package/dist/internal/config/plugin-config-schema.d.ts +2 -0
  116. package/dist/internal/config/plugin-config-schema.js +2 -0
  117. package/dist/internal/config/product-mode.d.ts +2 -0
  118. package/dist/internal/config/product-mode.js +36 -0
  119. package/dist/internal/config/settings.d.ts +2 -0
  120. package/dist/internal/config/settings.js +265 -0
  121. package/dist/internal/config/skill-categories.d.ts +4 -0
  122. package/dist/internal/config/skill-categories.js +68 -0
  123. package/dist/internal/config/skin-defaults.d.ts +6 -0
  124. package/dist/internal/config/skin-defaults.js +6 -0
  125. package/dist/internal/contract/discovery.d.ts +10 -0
  126. package/dist/internal/contract/discovery.js +53 -0
  127. package/dist/internal/contract/profile.d.ts +2 -0
  128. package/dist/internal/contract/profile.js +44 -0
  129. package/dist/internal/contract/routes.d.ts +2 -0
  130. package/dist/internal/contract/routes.js +62 -0
  131. package/dist/internal/engine/bindings/memory-cli-shared.d.ts +47 -0
  132. package/dist/internal/engine/bindings/memory-cli-shared.js +84 -0
  133. package/dist/internal/engine/bindings/memory-forget-tool.d.ts +5 -0
  134. package/dist/internal/engine/bindings/memory-forget-tool.js +66 -0
  135. package/dist/internal/engine/bindings/memory-list-tool.d.ts +5 -0
  136. package/dist/internal/engine/bindings/memory-list-tool.js +57 -0
  137. package/dist/internal/engine/bindings/memory-recall-tool.d.ts +10 -0
  138. package/dist/internal/engine/bindings/memory-recall-tool.js +283 -0
  139. package/dist/internal/engine/bindings/memory-reflection-resolve-tool.d.ts +5 -0
  140. package/dist/internal/engine/bindings/memory-reflection-resolve-tool.js +150 -0
  141. package/dist/internal/engine/bindings/memory-stats-tool.d.ts +5 -0
  142. package/dist/internal/engine/bindings/memory-stats-tool.js +43 -0
  143. package/dist/internal/engine/bindings/memory-store-tool.d.ts +5 -0
  144. package/dist/internal/engine/bindings/memory-store-tool.js +165 -0
  145. package/dist/internal/engine/bindings/memory-tool-access.d.ts +16 -0
  146. package/dist/internal/engine/bindings/memory-tool-access.js +46 -0
  147. package/dist/internal/engine/bindings/memory-tool-formatting.d.ts +62 -0
  148. package/dist/internal/engine/bindings/memory-tool-formatting.js +106 -0
  149. package/dist/internal/engine/bindings/memory-tool-results.d.ts +8 -0
  150. package/dist/internal/engine/bindings/memory-tool-results.js +41 -0
  151. package/dist/internal/engine/bindings/memory-tool-schemas.d.ts +109 -0
  152. package/dist/internal/engine/bindings/memory-tool-schemas.js +75 -0
  153. package/dist/internal/engine/bindings/memory-update-tool.d.ts +5 -0
  154. package/dist/internal/engine/bindings/memory-update-tool.js +127 -0
  155. package/dist/internal/engine/bindings/sno-station-mem-ambient-learning-hook.d.ts +14 -0
  156. package/dist/internal/engine/bindings/sno-station-mem-ambient-learning-hook.js +248 -0
  157. package/dist/internal/engine/bindings/sno-station-mem-auto-recall-hook.d.ts +12 -0
  158. package/dist/internal/engine/bindings/sno-station-mem-auto-recall-hook.js +324 -0
  159. package/dist/internal/engine/bindings/sno-station-mem-hook-types.d.ts +56 -0
  160. package/dist/internal/engine/bindings/sno-station-mem-hook-types.js +1 -0
  161. package/dist/internal/engine/bindings/sno-station-mem-insight-distill-factory.d.ts +14 -0
  162. package/dist/internal/engine/bindings/sno-station-mem-insight-distill-factory.js +119 -0
  163. package/dist/internal/engine/bindings/sno-station-mem-message-transcript.d.ts +52 -0
  164. package/dist/internal/engine/bindings/sno-station-mem-message-transcript.js +145 -0
  165. package/dist/internal/engine/bindings/sno-station-mem-reset-hook.d.ts +10 -0
  166. package/dist/internal/engine/bindings/sno-station-mem-reset-hook.js +9 -0
  167. package/dist/internal/engine/bindings/sno-station-mem-runtime-mode.d.ts +36 -0
  168. package/dist/internal/engine/bindings/sno-station-mem-runtime-mode.js +104 -0
  169. package/dist/internal/engine/bindings/sno-station-mem-session-state.d.ts +10 -0
  170. package/dist/internal/engine/bindings/sno-station-mem-session-state.js +27 -0
  171. package/dist/internal/engine/eval/trace.d.ts +2 -0
  172. package/dist/internal/engine/eval/trace.js +151 -0
  173. package/dist/internal/engine/extraction/ambient-learning-text-normalizer.d.ts +2 -0
  174. package/dist/internal/engine/extraction/ambient-learning-text-normalizer.js +2 -0
  175. package/dist/internal/engine/extraction/atomic-memory-extraction.d.ts +2 -0
  176. package/dist/internal/engine/extraction/atomic-memory-extraction.js +2 -0
  177. package/dist/internal/engine/extraction/b-profile-section-dictionary-provider.d.ts +2 -0
  178. package/dist/internal/engine/extraction/b-profile-section-dictionary-provider.js +2 -0
  179. package/dist/internal/engine/extraction/b-profile-section-rekey.d.ts +49 -0
  180. package/dist/internal/engine/extraction/b-profile-section-rekey.js +730 -0
  181. package/dist/internal/engine/extraction/capture-policy-detector.d.ts +2 -0
  182. package/dist/internal/engine/extraction/capture-policy-detector.js +2 -0
  183. package/dist/internal/engine/extraction/embedding-provider-client.d.ts +2 -0
  184. package/dist/internal/engine/extraction/embedding-provider-client.js +2 -0
  185. package/dist/internal/engine/extraction/extraction-text-sanitizer.d.ts +2 -0
  186. package/dist/internal/engine/extraction/extraction-text-sanitizer.js +114 -0
  187. package/dist/internal/engine/extraction/memory-metadata-codec.d.ts +3 -0
  188. package/dist/internal/engine/extraction/memory-metadata-codec.js +2 -0
  189. package/dist/internal/engine/extraction/memory-temporality-classifier.d.ts +2 -0
  190. package/dist/internal/engine/extraction/memory-temporality-classifier.js +2 -0
  191. package/dist/internal/engine/i18n/all-resources.d.ts +2 -0
  192. package/dist/internal/engine/i18n/all-resources.js +2 -0
  193. package/dist/internal/engine/i18n/locales.d.ts +2 -0
  194. package/dist/internal/engine/i18n/locales.js +19 -0
  195. package/dist/internal/engine/i18n/res/_types.d.ts +2 -0
  196. package/dist/internal/engine/i18n/res/_types.js +11 -0
  197. package/dist/internal/engine/observability/adapter.d.ts +2 -0
  198. package/dist/internal/engine/observability/adapter.js +2 -0
  199. package/dist/internal/engine/observability/best-effort.d.ts +2 -0
  200. package/dist/internal/engine/observability/best-effort.js +41 -0
  201. package/dist/internal/engine/observability/early-diagnostics.js +2 -0
  202. package/dist/internal/engine/observability/memory-snapshot.d.ts +2 -0
  203. package/dist/internal/engine/observability/memory-snapshot.js +44 -0
  204. package/dist/internal/engine/observability/observable-embedder.d.ts +2 -0
  205. package/dist/internal/engine/observability/observable-embedder.js +43 -0
  206. package/dist/internal/engine/observability/observable-llm-client.d.ts +2 -0
  207. package/dist/internal/engine/observability/observable-llm-client.js +98 -0
  208. package/dist/internal/engine/observability/observable-memory-store.d.ts +2 -0
  209. package/dist/internal/engine/observability/observable-memory-store.js +701 -0
  210. package/dist/internal/engine/observability/observable-retriever.d.ts +2 -0
  211. package/dist/internal/engine/observability/observable-retriever.js +95 -0
  212. package/dist/internal/engine/observability/runtime-diagnostics.d.ts +13 -0
  213. package/dist/internal/engine/observability/runtime-diagnostics.js +96 -0
  214. package/dist/internal/engine/observability/session-registry.d.ts +2 -0
  215. package/dist/internal/engine/observability/session-registry.js +58 -0
  216. package/dist/internal/engine/observability/version-metadata.d.ts +7 -0
  217. package/dist/internal/engine/observability/version-metadata.js +59 -0
  218. package/dist/internal/engine/operations/daily-spend-estimator.d.ts +2 -0
  219. package/dist/internal/engine/operations/daily-spend-estimator.js +97 -0
  220. package/dist/internal/engine/operations/learning-file-maintenance.d.ts +2 -0
  221. package/dist/internal/engine/operations/learning-file-maintenance.js +255 -0
  222. package/dist/internal/engine/operations/memory-tier-promoter.d.ts +2 -0
  223. package/dist/internal/engine/operations/memory-tier-promoter.js +95 -0
  224. package/dist/internal/engine/operations/runtime-audit-log.d.ts +3 -0
  225. package/dist/internal/engine/operations/runtime-audit-log.js +3 -0
  226. package/dist/internal/engine/provider/canonical-memory-corpus.d.ts +38 -0
  227. package/dist/internal/engine/provider/canonical-memory-corpus.js +253 -0
  228. package/dist/internal/engine/provider/provider-registration.d.ts +39 -0
  229. package/dist/internal/engine/provider/provider-registration.js +2 -0
  230. package/dist/internal/engine/provider/provider-row-renderer.d.ts +7 -0
  231. package/dist/internal/engine/provider/provider-row-renderer.js +53 -0
  232. package/dist/internal/engine/provider/provider-types.d.ts +2 -0
  233. package/dist/internal/engine/provider/provider-types.js +1 -0
  234. package/dist/internal/engine/reflection/daily-log-generator.d.ts +2 -0
  235. package/dist/internal/engine/reflection/daily-log-generator.js +2 -0
  236. package/dist/internal/engine/reflection/reflection-command-hooks.d.ts +2 -0
  237. package/dist/internal/engine/reflection/reflection-command-hooks.js +2 -0
  238. package/dist/internal/engine/reflection/reflection-deps.d.ts +2 -0
  239. package/dist/internal/engine/reflection/reflection-deps.js +1 -0
  240. package/dist/internal/engine/reflection/reflection-embedded-generator.d.ts +2 -0
  241. package/dist/internal/engine/reflection/reflection-embedded-generator.js +2 -0
  242. package/dist/internal/engine/reflection/reflection-injection-hooks.d.ts +2 -0
  243. package/dist/internal/engine/reflection/reflection-injection-hooks.js +219 -0
  244. package/dist/internal/engine/reflection/reflection-lifecycle-hooks.d.ts +2 -0
  245. package/dist/internal/engine/reflection/reflection-lifecycle-hooks.js +63 -0
  246. package/dist/internal/engine/reflection/strategy-hook-runner.d.ts +4 -0
  247. package/dist/internal/engine/reflection/strategy-hook-runner.js +3 -0
  248. package/dist/internal/engine/rem/classifier.d.ts +2 -0
  249. package/dist/internal/engine/rem/classifier.js +180 -0
  250. package/dist/internal/engine/rem/index.d.ts +4 -0
  251. package/dist/internal/engine/rem/index.js +2551 -0
  252. package/dist/internal/engine/rem/types.d.ts +2 -0
  253. package/dist/internal/engine/rem/types.js +40 -0
  254. package/dist/internal/engine/retrieval/access-tracker.d.ts +2 -0
  255. package/dist/internal/engine/retrieval/access-tracker.js +314 -0
  256. package/dist/internal/engine/retrieval/intent-analyzer.d.ts +2 -0
  257. package/dist/internal/engine/retrieval/intent-analyzer.js +27 -0
  258. package/dist/internal/engine/retrieval/retrieval-gate.d.ts +2 -0
  259. package/dist/internal/engine/retrieval/retrieval-gate.js +47 -0
  260. package/dist/internal/engine/retrieval/retriever.d.ts +2 -0
  261. package/dist/internal/engine/retrieval/retriever.js +2 -0
  262. package/dist/internal/engine/security/memory-scope-policy.d.ts +2 -0
  263. package/dist/internal/engine/security/memory-scope-policy.js +2 -0
  264. package/dist/internal/engine/security/redact.d.ts +2 -0
  265. package/dist/internal/engine/security/redact.js +34 -0
  266. package/dist/internal/engine/security/scopes.d.ts +3 -0
  267. package/dist/internal/engine/security/scopes.js +3 -0
  268. package/dist/internal/engine/shared/errors.d.ts +2 -0
  269. package/dist/internal/engine/shared/errors.js +66 -0
  270. package/dist/internal/engine/shared/i18n-text.d.ts +2 -0
  271. package/dist/internal/engine/shared/i18n-text.js +58 -0
  272. package/dist/internal/engine/shared/iso-date-time.d.ts +16 -0
  273. package/dist/internal/engine/shared/iso-date-time.js +40 -0
  274. package/dist/internal/engine/shared/lru.d.ts +2 -0
  275. package/dist/internal/engine/shared/lru.js +30 -0
  276. package/dist/internal/engine/shared/memory-kind-policy.d.ts +2 -0
  277. package/dist/internal/engine/shared/memory-kind-policy.js +64 -0
  278. package/dist/internal/engine/shared/paths.d.ts +3 -0
  279. package/dist/internal/engine/shared/paths.js +2 -0
  280. package/dist/internal/engine/shared/types.d.ts +3 -0
  281. package/dist/internal/engine/shared/types.js +25 -0
  282. package/dist/internal/engine/shared/utils.d.ts +2 -0
  283. package/dist/internal/engine/shared/utils.js +175 -0
  284. package/dist/internal/engine/telemetry/memory-telemetry-api.d.ts +134 -0
  285. package/dist/internal/engine/telemetry/memory-telemetry-api.js +730 -0
  286. package/dist/internal/engine/telemetry/memory-telemetry-observability.d.ts +24 -0
  287. package/dist/internal/engine/telemetry/memory-telemetry-observability.js +133 -0
  288. package/dist/internal/engine/telemetry/memory-telemetry-outbox.d.ts +2 -0
  289. package/dist/internal/engine/telemetry/memory-telemetry-outbox.js +443 -0
  290. package/dist/internal/engine/telemetry/memory-telemetry-types.d.ts +2 -0
  291. package/dist/internal/engine/telemetry/memory-telemetry-types.js +21 -0
  292. package/dist/internal/engine/telemetry/observe-ledger.d.ts +30 -0
  293. package/dist/internal/engine/telemetry/observe-ledger.js +111 -0
  294. package/dist/internal/model/agent-llm-port.d.ts +2 -0
  295. package/dist/internal/model/agent-llm-port.js +1 -0
  296. package/dist/internal/model/llm-client.d.ts +3 -0
  297. package/dist/internal/model/llm-client.js +3 -0
  298. package/dist/internal/model/llm-failure.d.ts +26 -0
  299. package/dist/internal/model/llm-failure.js +63 -0
  300. package/dist/internal/model/llm-mode-routing.d.ts +22 -0
  301. package/dist/internal/model/llm-mode-routing.js +37 -0
  302. package/dist/internal/store/atomic-memory-cutover-sql.d.ts +13 -0
  303. package/dist/internal/store/atomic-memory-cutover-sql.js +237 -0
  304. package/dist/internal/store/connection.d.ts +2 -0
  305. package/dist/internal/store/connection.js +2 -0
  306. package/dist/internal/store/data-bootstrap.d.ts +2 -0
  307. package/dist/internal/store/data-bootstrap.js +2 -0
  308. package/dist/internal/store/data-paths.d.ts +2 -0
  309. package/dist/internal/store/data-paths.js +65 -0
  310. package/dist/internal/store/maintenance.d.ts +75 -0
  311. package/dist/internal/store/maintenance.js +1401 -0
  312. package/dist/internal/store/memory-kinds-cutover-migrator.d.ts +28 -0
  313. package/dist/internal/store/memory-kinds-cutover-migrator.js +415 -0
  314. package/dist/internal/store/migrations.d.ts +27 -0
  315. package/dist/internal/store/migrations.js +201 -0
  316. package/dist/internal/store/sqlite-runtime.d.ts +2 -0
  317. package/dist/internal/store/sqlite-runtime.js +109 -0
  318. package/dist/internal/store/store.d.ts +3 -0
  319. package/dist/internal/store/store.js +2 -0
  320. package/dist/learning-file-maintenance-9b-Ut6Kv.d.ts +30 -0
  321. package/dist/llm-client-BSYUAcUb.js +1374 -0
  322. package/dist/llm-client-DOTSGzhe.d.ts +51 -0
  323. package/dist/locales-JxGmkG6t.d.ts +7 -0
  324. package/dist/log-site-catalog.generated-BMKWj-Nx.js +2321 -0
  325. package/dist/log-site-catalog.json +1 -0
  326. package/dist/lru-DyoaTyIs.d.ts +14 -0
  327. package/dist/memdump.d.ts +52 -0
  328. package/dist/memdump.js +163 -0
  329. package/dist/memory-entry-projector-DHo8jH10.js +1015 -0
  330. package/dist/memory-kind-policy-BiuRjSJc.d.ts +23 -0
  331. package/dist/memory-metadata-codec-DL1sbJiN.js +577 -0
  332. package/dist/memory-metadata-codec-DUvsYe_X.d.ts +68 -0
  333. package/dist/memory-runtime-DqUS4cWi.js +19459 -0
  334. package/dist/memory-scope-policy-1gg5QlWZ.d.ts +67 -0
  335. package/dist/memory-scope-policy-DICSCURA.js +283 -0
  336. package/dist/memory-snapshot-CqY1BUUA.d.ts +16 -0
  337. package/dist/memory-source-order-YMRoeDLd.js +134 -0
  338. package/dist/memory-store-base-CQ_bHlYA.d.ts +1094 -0
  339. package/dist/memory-store-shared-DqpWJXZZ.js +158 -0
  340. package/dist/memory-store-write-validation-B_hDG2zf.js +243 -0
  341. package/dist/memory-telemetry-incidents-BWA9kcZx.js +8 -0
  342. package/dist/memory-telemetry-metadata-CA7W8tK6.js +77 -0
  343. package/dist/memory-telemetry-outbox-ddTdImt7.d.ts +74 -0
  344. package/dist/memory-telemetry-receipts-MAJecvXQ.d.ts +34 -0
  345. package/dist/memory-telemetry-receipts-YsxbwOAf.js +91 -0
  346. package/dist/memory-telemetry-types-CufVmrCs.d.ts +14 -0
  347. package/dist/memory-temporality-classifier-BUjXG5o7.js +184 -0
  348. package/dist/memory-temporality-classifier-Brht5jyK.d.ts +43 -0
  349. package/dist/memory-tier-promoter-CqGxCkue.d.ts +43 -0
  350. package/dist/memory-tool-dependencies-CatGzI9R.d.ts +14 -0
  351. package/dist/memory-tool-dependencies-DjUoelnm.js +19 -0
  352. package/dist/model-call-table-CspopkBg.js +563 -0
  353. package/dist/model-reply-text-CKopStP2.js +334 -0
  354. package/dist/observable-embedder-CNNe9gkg.d.ts +17 -0
  355. package/dist/observable-llm-client-CRuKlefQ.d.ts +21 -0
  356. package/dist/observable-memory-store-CnGDpOY5.d.ts +73 -0
  357. package/dist/observable-retriever-Cooc62Qw.d.ts +23 -0
  358. package/dist/operation-cancellation-CTKWwNHk.js +81 -0
  359. package/dist/paths-qVF-5uBq.d.ts +1 -0
  360. package/dist/plugin-config-schema-C0UUbOmG.d.ts +413 -0
  361. package/dist/plugin-config-schema-YJLyIIcJ.js +361 -0
  362. package/dist/profile-TWPJ_myr.d.ts +13 -0
  363. package/dist/profile-section-writer-BhGKPBjw.js +2149 -0
  364. package/dist/provider-registration-CF1tg8Xy.js +721 -0
  365. package/dist/provider-runtime-types-DFhtdA6d.d.ts +134 -0
  366. package/dist/provider-types-CZGm6v88.d.ts +23 -0
  367. package/dist/redact-BTIZcHQL.d.ts +5 -0
  368. package/dist/reflection-command-hooks-ClUl-iv6.js +644 -0
  369. package/dist/reflection-command-hooks-G1-dI2Av.d.ts +32 -0
  370. package/dist/reflection-deps-Ccm2Jf5W.d.ts +19 -0
  371. package/dist/reflection-embedded-generator-BRvqV5N-.js +130 -0
  372. package/dist/reflection-embedded-generator-kfQfKEYV.d.ts +14 -0
  373. package/dist/reflection-injection-hooks-CS_uhjoD.d.ts +43 -0
  374. package/dist/reflection-lifecycle-hooks-CRSpUdLi.d.ts +27 -0
  375. package/dist/relation-dictionary-Cev1kyLe.js +4248 -0
  376. package/dist/release-download.d.ts +8 -0
  377. package/dist/release-download.js +32 -0
  378. package/dist/relevant-memories-context-m8nuFZcM.js +23 -0
  379. package/dist/rem-batch-executor-Dg2HgROM.js +2 -0
  380. package/dist/rem-batch-executor-DuC4nYyf.js +31640 -0
  381. package/dist/rem-consumer-retrieval-CR0dtcHR.js +246 -0
  382. package/dist/rem-trigger-Hn6od8IV.js +730 -0
  383. package/dist/resolver-Dy-hnjCR.js +103 -0
  384. package/dist/results-C3ZLroMb.js +140 -0
  385. package/dist/retrieval-gate-Bx2Zg7jD.d.ts +31 -0
  386. package/dist/retriever-Dxss5fRv.d.ts +469 -0
  387. package/dist/retriever-ZoLvPRHq.js +1757 -0
  388. package/dist/rolldown-runtime-D7D4PA-g.js +13 -0
  389. package/dist/routes-DLHT__Ay.js +60 -0
  390. package/dist/runtime-audit-log-BCeujlEp.js +430 -0
  391. package/dist/runtime-audit-log-zpQiR9HT.d.ts +149 -0
  392. package/dist/scopes-CSOn6zdd.js +71 -0
  393. package/dist/scopes-CtrY-YQ3.d.ts +23 -0
  394. package/dist/server-CSvxchqg.js +1412 -0
  395. package/dist/session-registry-DBoE7AvZ.d.ts +14 -0
  396. package/dist/sidecar/main.d.ts +1 -0
  397. package/dist/sidecar/main.js +56 -0
  398. package/dist/signed-registry-constants-Bv0fgZ8Q.d.ts +12 -0
  399. package/dist/signed-registry-constants-yq3DlG3B.js +82 -0
  400. package/dist/sno-station-mem-runtime-dependencies-CoWqUMbK.js +30 -0
  401. package/dist/sno-station-mem-runtime-dependencies-DHESIuPn.d.ts +31 -0
  402. package/dist/sqlite-runtime-L_ywirTm.d.ts +58 -0
  403. package/dist/store-C8sUTssE.d.ts +27 -0
  404. package/dist/store-nPql26YM.js +5830 -0
  405. package/dist/strategy-hook-runner-Bxy851Xx.d.ts +16 -0
  406. package/dist/strategy-hook-runner-Djify5Rw.js +110 -0
  407. package/dist/token-counter-BD1f48Km.js +73 -0
  408. package/dist/trace-C1JxMfs-.d.ts +86 -0
  409. package/dist/types-CWdhXLxr.d.ts +477 -0
  410. package/dist/types-pVomjzqR.d.ts +132 -0
  411. package/dist/unplaced-candidate-migration-CbQHzcEM.js +940 -0
  412. package/dist/utils-Ctb9aevJ.d.ts +34 -0
  413. package/drizzle/0000_initial.sql +10 -0
  414. package/drizzle/0001_virtual_tables.sql +34 -0
  415. package/drizzle/0002_add_indexes.sql +11 -0
  416. package/drizzle/0003_content_hash_lookup_index.sql +2 -0
  417. package/drizzle/0004_chunk_swap.sql +60 -0
  418. package/drizzle/0005_drop_legacy_vec_fts.sql +10 -0
  419. package/drizzle/0006_fts_simple.sql +45 -0
  420. package/drizzle/0007_restore_simple_fts.sql +40 -0
  421. package/drizzle/0008_widen_memory_hash_unique_index.sql +4 -0
  422. package/drizzle/0009_memory_telemetry.sql +109 -0
  423. package/drizzle/0010_provider_mappings.sql +27 -0
  424. package/drizzle/0011_db_optimization.sql +82 -0
  425. package/drizzle/0012_b_profile_lanes.sql +9 -0
  426. package/drizzle/0013_extraction_timestamps.sql +6 -0
  427. package/drizzle/0014_extraction_timestamp_source.sql +3 -0
  428. package/drizzle/0015_task_lifecycle_state.sql +101 -0
  429. package/drizzle/0016_task_lifecycle_legacy_migration.sql +144 -0
  430. package/drizzle/0017_unplaced_candidates.sql +15 -0
  431. package/drizzle/0018_rem_batch_chassis.sql +71 -0
  432. package/drizzle/0019_profile_recovery_entries.sql +17 -0
  433. package/drizzle/0020_rem_scan_retry_progress.down.sql +14 -0
  434. package/drizzle/0020_rem_scan_retry_progress.sql +24 -0
  435. package/drizzle/0021_rem_two_facet_storage.down.sql +14 -0
  436. package/drizzle/0021_rem_two_facet_storage.sql +42 -0
  437. package/drizzle/0022_rem_facet_chunk_versions.down.sql +4 -0
  438. package/drizzle/0022_rem_facet_chunk_versions.sql +4 -0
  439. package/drizzle/0023_rem_defect_ledger.sql +40 -0
  440. package/drizzle/0024_rem_unbuilt_foundations.down.sql +13 -0
  441. package/drizzle/0024_rem_unbuilt_foundations.sql +65 -0
  442. package/drizzle/0025_rem_journal_operation_constraint.sql +28 -0
  443. package/drizzle/0026_rem_journal_detail.sql +1 -0
  444. package/drizzle/0027_legacy_nodix_namespace.sql +3 -0
  445. package/drizzle/0028_memory_timezone.sql +23 -0
  446. package/drizzle/0029_rem_write_hash_symmetry.sql +17 -0
  447. package/drizzle/0030_atomic_memory_additive.sql +105 -0
  448. package/drizzle/0031_atomic_extraction_ledger.sql +23 -0
  449. package/drizzle/0032_atomic_memory_entities.sql +12 -0
  450. package/drizzle/0033_todo_own_store.sql +99 -0
  451. package/drizzle/meta/0000_snapshot.json +87 -0
  452. package/drizzle/meta/_journal.json +244 -0
  453. package/generated/rem-operations.json +1 -0
  454. package/package.json +126 -4
  455. package/scripts/download-simple-tokenizer.mjs +254 -0
  456. package/settings.default.json +243 -0
  457. package/skills/extract-atomic-memory/SKILL.md +298 -0
  458. package/skills/extract-atomic-memory/references/account-for-turns.md +9 -0
  459. package/skills/extract-atomic-memory/references/calendar-meaning.md +64 -0
  460. package/skills/extract-atomic-memory/references/capture.md +120 -0
  461. package/skills/extract-atomic-memory/references/enrichment.md +92 -0
  462. package/skills/extract-atomic-memory/references/missing-durable-half.md +6 -0
  463. package/skills/extract-atomic-memory/references/progress-classification.md +21 -0
  464. package/skills/extract-atomic-memory/references/resolve-subject.md +19 -0
  465. package/skills/extract-atomic-memory/references/surrounding-context.md +10 -0
  466. package/skills/extract-atomic-memory/references/user-subject-guard.md +29 -0
  467. package/skills/judge-group-closure/SKILL.md +25 -0
  468. package/skills/judge-rem-memory-updates/SKILL.md +56 -0
  469. package/skills/judge-rem-memory-updates/agents/openai.yaml +4 -0
  470. package/skills/judge-retired-position/SKILL.md +25 -0
  471. package/skills/judge-task-lifecycle/SKILL.md +45 -0
  472. package/skills/key-state-attribute/SKILL.md +16 -0
  473. package/skills/resolve-entity-identity/SKILL.md +24 -0
  474. package/skills/resolve-relative-time/SKILL.md +22 -0
  475. package/sqlite-extensions/LICENSE-simple-tokenizer +28 -0
  476. package/sqlite-extensions/LICENSE-sqlite-vec +21 -0
  477. package/sqlite-extensions/linux-arm64/vec0.so +0 -0
  478. package/sqlite-extensions/linux-x64/vec0.so +0 -0
@@ -0,0 +1,701 @@
1
+ import { StorageError } from "../shared/errors.js";
2
+ import { l as runWithMemoryAudit, u as runWithMemoryAuditSync } from "../../../runtime-audit-log-BCeujlEp.js";
3
+ import { getSnoStationMemStateDir } from "../../contract/profile.js";
4
+ import { b as MemoryStore } from "../../../store-nPql26YM.js";
5
+ import { t as countEmbeddingTokens } from "../../../token-counter-BD1f48Km.js";
6
+ import { isAbsolute } from "node:path";
7
+ import { detectProjectId } from "@snoai/observability";
8
+ //#region src/engine/observability/observable-memory-store.ts
9
+ /** @file observable-memory-store.ts
10
+ * @purpose Emits strict runtime audits and best-effort telemetry around memory operations.
11
+ * @boundary Runtime audits fail closed; process telemetry never affects storage.
12
+ */
13
+ const baseFetchMemoriesInOrder = MemoryStore.prototype.fetchMemoriesInOrder;
14
+ const baseDeleteByIds = MemoryStore.prototype.deleteByIds;
15
+ const baseBackfillMissingChunks = MemoryStore.prototype.backfillMissingChunks;
16
+ var ObservableMemoryStore = class extends MemoryStore {
17
+ observability;
18
+ sessionUuidProvider;
19
+ embeddingConfig;
20
+ constructor(config, observability, sessionUuidProvider, embeddingConfig) {
21
+ super(config);
22
+ this.observability = observability;
23
+ this.sessionUuidProvider = sessionUuidProvider;
24
+ this.embeddingConfig = embeddingConfig;
25
+ }
26
+ async store(entry) {
27
+ try {
28
+ const result = await runWithMemoryAudit({
29
+ stateDir: getSnoStationMemStateDir(),
30
+ event: "memory_injected",
31
+ operation: "store",
32
+ scope: entry.projectId,
33
+ startedDetails: {
34
+ scope: entry.projectId,
35
+ category: entry.category,
36
+ count: 1
37
+ },
38
+ run: () => super.store(entry),
39
+ completedDetails: (stored) => ({
40
+ scope: stored.projectId,
41
+ category: stored.category,
42
+ lane: stored.lane,
43
+ count: 1,
44
+ memory_ids: [stored.id],
45
+ write_outcome: stored.storeWriteOutcome,
46
+ created_count: stored.storeWriteOutcome === "created" ? 1 : 0,
47
+ existing_count: stored.storeWriteOutcome === "existing" ? 1 : 0
48
+ })
49
+ });
50
+ if (this.observability.enabled) {
51
+ const sessionUuid = this.sessionUuidProvider();
52
+ this.observability.trackBestEffort("memory.write", () => this.emitWrite(result, sessionUuid));
53
+ }
54
+ return result;
55
+ } catch (error) {
56
+ this.observability.trackBestEffort("memory.write:throw", () => this.observability.emitError("memory.write:throw", error, this.sessionUuidProvider()));
57
+ throw error;
58
+ }
59
+ }
60
+ async storeAtomicExtractionChunk(input) {
61
+ const result = await super.storeAtomicExtractionChunk(input);
62
+ this.emitCreatedWrites(result.cardIds);
63
+ return result;
64
+ }
65
+ async applyTaskLifecycleBatchWithAtomicWrite(input) {
66
+ const result = await super.applyTaskLifecycleBatchWithAtomicWrite(input);
67
+ this.emitCreatedWrites(result.atomicFactWrite.cardIds);
68
+ return result;
69
+ }
70
+ emitCreatedWrites(ids) {
71
+ if (!this.observability.enabled) return;
72
+ const sessionUuid = this.sessionUuidProvider();
73
+ for (const id of ids) {
74
+ const entry = super.getById(id);
75
+ if (!entry) continue;
76
+ this.observability.trackBestEffort("memory.write", () => this.emitWrite(entry, sessionUuid));
77
+ }
78
+ }
79
+ async update(id, changes) {
80
+ try {
81
+ const result = await runWithMemoryAudit({
82
+ stateDir: getSnoStationMemStateDir(),
83
+ event: "memory_updated",
84
+ operation: "update",
85
+ startedDetails: {
86
+ memory_ids: [id],
87
+ requested_count: 1
88
+ },
89
+ run: () => super.update(id, changes),
90
+ completedDetails: (updated) => ({
91
+ memory_ids: updated ? [updated.id] : [],
92
+ requested_count: 1,
93
+ result_count: updated ? 1 : 0,
94
+ outcome: updated ? "updated" : "missing",
95
+ ...updated ? { scope: updated.projectId } : {}
96
+ })
97
+ });
98
+ if (result && this.observability.enabled) {
99
+ const sessionUuid = this.sessionUuidProvider();
100
+ this.observability.trackBestEffort("memory.write", () => this.emitWrite(result, sessionUuid));
101
+ }
102
+ return result;
103
+ } catch (error) {
104
+ this.observability.trackBestEffort("memory.write:throw", () => this.observability.emitError("memory.write:throw", error, this.sessionUuidProvider()));
105
+ throw error;
106
+ }
107
+ }
108
+ async bulkStore(entries) {
109
+ try {
110
+ const requested = entries.filter((entry) => entry != null);
111
+ const results = await runWithMemoryAudit({
112
+ stateDir: getSnoStationMemStateDir(),
113
+ event: "memory_injected",
114
+ operation: "bulkStore",
115
+ startedDetails: { count: requested.length },
116
+ run: async () => await super.bulkStore(entries),
117
+ completedDetails: (stored) => {
118
+ const createdCount = stored.filter((entry) => entry.storeWriteOutcome === "created").length;
119
+ const existingCount = stored.length - createdCount;
120
+ const writeOutcome = createdCount === stored.length ? "created" : existingCount === stored.length ? "existing" : "mixed";
121
+ return {
122
+ scope: uniformValue(stored.map((entry) => entry.projectId)),
123
+ category: uniformValue(stored.map((entry) => entry.category)),
124
+ lane: uniformValue(stored.map((entry) => entry.lane)),
125
+ count: stored.length,
126
+ memory_ids: stored.map((entry) => entry.id),
127
+ write_outcome: writeOutcome,
128
+ created_count: createdCount,
129
+ existing_count: existingCount
130
+ };
131
+ }
132
+ });
133
+ if (this.observability.enabled) for (const entry of results) {
134
+ const sessionUuid = this.sessionUuidProvider();
135
+ this.observability.trackBestEffort("memory.write", () => this.emitWrite(entry, sessionUuid));
136
+ }
137
+ return results;
138
+ } catch (error) {
139
+ this.observability.trackBestEffort("memory.write:throw", () => this.observability.emitError("memory.write:throw", error, this.sessionUuidProvider()));
140
+ throw error;
141
+ }
142
+ }
143
+ async supersede(args) {
144
+ return runWithMemoryAudit({
145
+ stateDir: getSnoStationMemStateDir(),
146
+ event: "memory_superseded",
147
+ operation: "supersede",
148
+ scope: args.create.projectId,
149
+ startedDetails: {
150
+ scope: args.create.projectId,
151
+ closed_memory_ids: args.closes.map((close) => close.id)
152
+ },
153
+ run: () => runWithMemoryAudit({
154
+ stateDir: getSnoStationMemStateDir(),
155
+ event: "memory_injected",
156
+ operation: "supersede",
157
+ scope: args.create.projectId,
158
+ startedDetails: {
159
+ scope: args.create.projectId,
160
+ count: 1
161
+ },
162
+ run: async () => await super.supersede(args),
163
+ completedDetails: (stored) => writeDetails(stored)
164
+ }),
165
+ completedDetails: (stored) => ({
166
+ scope: stored.projectId,
167
+ replacement_memory_id: stored.id,
168
+ closed_memory_ids: args.closes.map((close) => close.id),
169
+ write_outcome: stored.storeWriteOutcome
170
+ })
171
+ });
172
+ }
173
+ async createMergeWithRawLineage(args) {
174
+ const scope = args.rawSource.projectId;
175
+ return runWithMemoryAudit({
176
+ stateDir: getSnoStationMemStateDir(),
177
+ event: "memory_superseded",
178
+ operation: "createMergeWithRawLineage",
179
+ scope,
180
+ startedDetails: {
181
+ scope,
182
+ closed_memory_ids: args.closeExisting.map((close) => close.id)
183
+ },
184
+ run: () => runWithMemoryAudit({
185
+ stateDir: getSnoStationMemStateDir(),
186
+ event: "memory_injected",
187
+ operation: "createMergeWithRawLineage",
188
+ scope,
189
+ startedDetails: {
190
+ scope,
191
+ count: 2
192
+ },
193
+ run: () => super.createMergeWithRawLineage(args),
194
+ completedDetails: (result) => ({
195
+ scope,
196
+ count: 2,
197
+ memory_ids: [result.rawSource.id, result.merged.id],
198
+ write_outcome: "created",
199
+ created_count: 2,
200
+ existing_count: 0
201
+ })
202
+ }),
203
+ completedDetails: (result) => ({
204
+ scope,
205
+ replacement_memory_id: result.merged.id,
206
+ closed_memory_ids: [result.rawSource.id, ...args.closeExisting.map((close) => close.id)],
207
+ write_outcome: "created"
208
+ })
209
+ });
210
+ }
211
+ async createEventAndSupersede(args) {
212
+ const scope = args.replacement.projectId;
213
+ return runWithMemoryAudit({
214
+ stateDir: getSnoStationMemStateDir(),
215
+ event: "memory_superseded",
216
+ operation: "createEventAndSupersede",
217
+ scope,
218
+ startedDetails: {
219
+ scope,
220
+ closed_memory_ids: args.closeExisting.map((close) => close.id)
221
+ },
222
+ run: () => runWithMemoryAudit({
223
+ stateDir: getSnoStationMemStateDir(),
224
+ event: "memory_injected",
225
+ operation: "createEventAndSupersede",
226
+ scope,
227
+ startedDetails: {
228
+ scope,
229
+ count: 2
230
+ },
231
+ run: () => super.createEventAndSupersede(args),
232
+ completedDetails: (result) => ({
233
+ scope,
234
+ count: 2,
235
+ memory_ids: [result.event.id, result.replacement.id],
236
+ write_outcome: "created",
237
+ created_count: 2,
238
+ existing_count: 0
239
+ })
240
+ }),
241
+ completedDetails: (result) => ({
242
+ scope,
243
+ replacement_memory_id: result.replacement.id,
244
+ closed_memory_ids: args.closeExisting.map((close) => close.id),
245
+ write_outcome: "created"
246
+ })
247
+ });
248
+ }
249
+ async importEntry(entry) {
250
+ let existed = false;
251
+ return runWithMemoryAudit({
252
+ stateDir: getSnoStationMemStateDir(),
253
+ event: "memory_injected",
254
+ operation: "importEntry",
255
+ scope: entry.projectId,
256
+ startedDetails: {
257
+ scope: entry.projectId,
258
+ memory_ids: [entry.id],
259
+ count: 1
260
+ },
261
+ run: async () => {
262
+ existed = await super.hasId(entry.id);
263
+ return super.importEntry(entry);
264
+ },
265
+ completedDetails: (stored) => {
266
+ const writeOutcome = existed ? "existing" : "created";
267
+ return {
268
+ scope: stored.projectId,
269
+ category: stored.category,
270
+ lane: stored.lane,
271
+ count: 1,
272
+ memory_ids: [stored.id],
273
+ write_outcome: writeOutcome,
274
+ created_count: existed ? 0 : 1,
275
+ existing_count: existed ? 1 : 0
276
+ };
277
+ }
278
+ });
279
+ }
280
+ async backfillMissingChunks() {
281
+ return runWithMemoryAudit({
282
+ stateDir: getSnoStationMemStateDir(),
283
+ event: "memory_updated",
284
+ operation: "backfillMissingChunks",
285
+ run: () => baseBackfillMissingChunks.call(this),
286
+ completedDetails: (rewrittenRows) => ({
287
+ outcome: rewrittenRows === 0 ? "noop" : "chunks_backfilled",
288
+ rewritten_rows: rewrittenRows
289
+ })
290
+ });
291
+ }
292
+ findByContentHash(hash, projectId) {
293
+ return this.auditEntryReadSync("findByContentHash", projectId, () => super.findByContentHash(hash, projectId));
294
+ }
295
+ findByExtractionIdempotencyKey(projectId, key) {
296
+ return this.auditEntryReadSync("findByExtractionIdempotencyKey", projectId, () => super.findByExtractionIdempotencyKey(projectId, key));
297
+ }
298
+ /**
299
+ * Audited like a write, because it is one — a preserved failure that leaves no
300
+ * audit trail is a write nobody can find afterwards.
301
+ */
302
+ recordUnplacedCandidate(input) {
303
+ return runWithMemoryAuditSync({
304
+ stateDir: getSnoStationMemStateDir(),
305
+ event: "memory_injected",
306
+ operation: "recordUnplacedCandidate",
307
+ scope: input.projectId,
308
+ startedDetails: {
309
+ scope: input.projectId,
310
+ category: input.category,
311
+ count: 1
312
+ },
313
+ run: () => super.recordUnplacedCandidate(input),
314
+ completedDetails: (result) => ({
315
+ scope: input.projectId,
316
+ category: input.category,
317
+ count: 1,
318
+ memory_ids: [result.id],
319
+ write_outcome: result.created ? "created" : "existing",
320
+ created_count: result.created ? 1 : 0,
321
+ existing_count: result.created ? 0 : 1
322
+ })
323
+ });
324
+ }
325
+ getById(id) {
326
+ return this.auditEntryReadSync("getById", void 0, () => super.getById(id), [id]);
327
+ }
328
+ getByFactKey(projectId, factKey) {
329
+ return this.auditEntryReadSync("getByFactKey", projectId, () => super.getByFactKey(projectId, factKey), []);
330
+ }
331
+ async hasId(id) {
332
+ return runWithMemoryAudit({
333
+ stateDir: getSnoStationMemStateDir(),
334
+ event: "memory_read",
335
+ operation: "hasId",
336
+ startedDetails: {
337
+ memory_ids: [id],
338
+ requested_count: 1
339
+ },
340
+ run: () => super.hasId(id),
341
+ completedDetails: (found) => ({
342
+ memory_ids: found ? [id] : [],
343
+ requested_count: 1,
344
+ result_count: found ? 1 : 0,
345
+ found
346
+ })
347
+ });
348
+ }
349
+ async searchChunksSemantic(vector, opts) {
350
+ return this.auditSearch("searchChunksSemantic", opts, () => super.searchChunksSemantic(vector, opts));
351
+ }
352
+ async searchChunksKeyword(query, opts) {
353
+ return this.auditSearch("searchChunksKeyword", opts, () => super.searchChunksKeyword(query, opts));
354
+ }
355
+ async searchSemantic(vector, opts = {}) {
356
+ return this.auditMemorySearch("searchSemantic", opts, () => super.searchSemantic(vector, opts));
357
+ }
358
+ async searchKeyword(query, opts = {}) {
359
+ return this.auditMemorySearch("searchKeyword", opts, () => super.searchKeyword(query, opts));
360
+ }
361
+ fetchMemoriesInOrder(memoryIds, opts = {}) {
362
+ return runWithMemoryAuditSync({
363
+ stateDir: getSnoStationMemStateDir(),
364
+ event: "memory_read",
365
+ operation: "fetchMemoriesInOrder",
366
+ startedDetails: {
367
+ memory_ids: memoryIds,
368
+ requested_count: memoryIds.length
369
+ },
370
+ run: () => baseFetchMemoriesInOrder.call(this, memoryIds, opts),
371
+ completedDetails: (rows) => ({
372
+ memory_ids: rows.map((row) => row.id),
373
+ requested_count: memoryIds.length,
374
+ result_count: rows.length
375
+ })
376
+ });
377
+ }
378
+ getVectorsByIds(ids) {
379
+ return runWithMemoryAuditSync({
380
+ stateDir: getSnoStationMemStateDir(),
381
+ event: "memory_read",
382
+ operation: "getVectorsByIds",
383
+ startedDetails: {
384
+ memory_ids: ids,
385
+ requested_count: ids.length
386
+ },
387
+ run: () => super.getVectorsByIds(ids),
388
+ completedDetails: (vectors) => ({
389
+ memory_ids: [...vectors.keys()],
390
+ requested_count: ids.length,
391
+ result_count: vectors.size
392
+ })
393
+ });
394
+ }
395
+ getChunksByParent(memoryIds, facetPolicy) {
396
+ return runWithMemoryAuditSync({
397
+ stateDir: getSnoStationMemStateDir(),
398
+ event: "memory_read",
399
+ operation: "getChunksByParent",
400
+ startedDetails: {
401
+ memory_ids: memoryIds,
402
+ requested_count: memoryIds.length
403
+ },
404
+ run: () => super.getChunksByParent(memoryIds, facetPolicy),
405
+ completedDetails: (chunks) => ({
406
+ memory_ids: [...chunks.keys()],
407
+ requested_count: memoryIds.length,
408
+ result_count: chunks.size
409
+ })
410
+ });
411
+ }
412
+ async list(opts = {}) {
413
+ return runWithMemoryAudit({
414
+ stateDir: getSnoStationMemStateDir(),
415
+ event: "memory_read",
416
+ operation: "list",
417
+ scope: opts.projectId,
418
+ startedDetails: {
419
+ scope: opts.projectId,
420
+ requested_count: opts.limit
421
+ },
422
+ run: () => super.list(opts),
423
+ completedDetails: (entries) => ({
424
+ ...opts.projectId ? { scope: opts.projectId } : {},
425
+ memory_ids: entries.map((entry) => entry.id),
426
+ result_count: entries.length
427
+ })
428
+ });
429
+ }
430
+ async listReflectionItems(opts) {
431
+ return runWithMemoryAudit({
432
+ stateDir: getSnoStationMemStateDir(),
433
+ event: "memory_read",
434
+ operation: "listReflectionItems",
435
+ startedDetails: { requested_count: opts.limit },
436
+ run: () => super.listReflectionItems(opts),
437
+ completedDetails: (entries) => ({
438
+ memory_ids: entries.map((entry) => entry.id),
439
+ result_count: entries.length
440
+ })
441
+ });
442
+ }
443
+ async getMemoryMetadata(memoryId) {
444
+ return runWithMemoryAudit({
445
+ stateDir: getSnoStationMemStateDir(),
446
+ event: "memory_read",
447
+ operation: "getMemoryMetadata",
448
+ startedDetails: {
449
+ memory_ids: [memoryId],
450
+ requested_count: 1
451
+ },
452
+ run: () => super.getMemoryMetadata(memoryId),
453
+ completedDetails: (metadata) => ({
454
+ memory_ids: metadata ? [memoryId] : [],
455
+ requested_count: 1,
456
+ result_count: metadata ? 1 : 0,
457
+ found: metadata !== void 0
458
+ })
459
+ });
460
+ }
461
+ async updateTier(memoryId, newTier, options) {
462
+ await this.auditMetadataMutation("updateTier", [memoryId], () => super.updateTier(memoryId, newTier, options));
463
+ }
464
+ async updateMetadata(memoryId, patch) {
465
+ await this.auditMetadataMutation("updateMetadata", [memoryId], () => super.updateMetadata(memoryId, patch));
466
+ }
467
+ async applyMetadataDelta(memoryId, deltaFn) {
468
+ await this.auditMetadataMutation("applyMetadataDelta", [memoryId], () => super.applyMetadataDelta(memoryId, deltaFn));
469
+ }
470
+ async applyMetadataDeltas(entries) {
471
+ await this.auditMetadataMutation("applyMetadataDeltas", entries.map((entry) => entry.memoryId), () => super.applyMetadataDeltas(entries));
472
+ }
473
+ async resolveReflectionItem(memoryId, opts) {
474
+ return runWithMemoryAudit({
475
+ stateDir: getSnoStationMemStateDir(),
476
+ event: "memory_updated",
477
+ operation: "resolveReflectionItem",
478
+ startedDetails: {
479
+ memory_ids: [memoryId],
480
+ requested_count: 1
481
+ },
482
+ run: () => super.resolveReflectionItem(memoryId, opts),
483
+ completedDetails: (outcome) => ({
484
+ memory_ids: outcome === "not_found" ? [] : [memoryId],
485
+ requested_count: 1,
486
+ result_count: outcome === "not_found" ? 0 : 1,
487
+ outcome
488
+ })
489
+ });
490
+ }
491
+ async delete(idOrPrefix, options) {
492
+ return (await runWithMemoryAudit({
493
+ stateDir: getSnoStationMemStateDir(),
494
+ event: "memory_deleted",
495
+ operation: "delete",
496
+ startedDetails: { delete_reason: options?.deleteReason },
497
+ run: () => this.writeMutex.runExclusive(() => {
498
+ const ids = this.resolveDeleteIds(idOrPrefix);
499
+ if (ids.length > 0) baseDeleteByIds.call(this, ids, options);
500
+ return ids;
501
+ }),
502
+ completedDetails: (ids) => ({
503
+ deleted_memory_ids: ids,
504
+ delete_reason: options?.deleteReason,
505
+ count: ids.length,
506
+ outcome: deleteOutcome(ids.length)
507
+ })
508
+ })).length;
509
+ }
510
+ async deleteMany(ids, options) {
511
+ return (await runWithMemoryAudit({
512
+ stateDir: getSnoStationMemStateDir(),
513
+ event: "memory_deleted",
514
+ operation: "deleteMany",
515
+ startedDetails: {
516
+ delete_reason: options?.deleteReason,
517
+ count: ids.length
518
+ },
519
+ run: () => this.writeMutex.runExclusive(() => {
520
+ const existingIds = this.readExistingMemoryIds(ids);
521
+ if (existingIds.length > 0) baseDeleteByIds.call(this, existingIds, options);
522
+ return existingIds;
523
+ }),
524
+ completedDetails: (existingIds) => ({
525
+ deleted_memory_ids: existingIds,
526
+ delete_reason: options?.deleteReason,
527
+ count: existingIds.length,
528
+ outcome: deleteOutcome(existingIds.length)
529
+ })
530
+ })).length;
531
+ }
532
+ deleteByIds(ids, options) {
533
+ runWithMemoryAuditSync({
534
+ stateDir: getSnoStationMemStateDir(),
535
+ event: "memory_deleted",
536
+ operation: "deleteByIds",
537
+ startedDetails: {
538
+ deleted_memory_ids: ids,
539
+ count: ids.length
540
+ },
541
+ run: () => {
542
+ const existingIds = ids.filter((id) => super.getById(id) !== void 0);
543
+ baseDeleteByIds.call(this, ids, options);
544
+ return existingIds;
545
+ },
546
+ completedDetails: (deletedIds) => ({
547
+ deleted_memory_ids: deletedIds,
548
+ delete_reason: options?.deleteReason,
549
+ count: deletedIds.length,
550
+ outcome: deleteOutcome(deletedIds.length)
551
+ })
552
+ });
553
+ }
554
+ async bulkDelete(filter, options) {
555
+ return runWithMemoryAudit({
556
+ stateDir: getSnoStationMemStateDir(),
557
+ event: "memory_deleted",
558
+ operation: "bulkDelete",
559
+ scope: filter.projectId,
560
+ startedDetails: {
561
+ scope: filter.projectId,
562
+ delete_reason: options?.deleteReason
563
+ },
564
+ run: () => super.bulkDelete(filter, options),
565
+ completedDetails: (result) => ({
566
+ ...filter.projectId ? { scope: filter.projectId } : {},
567
+ delete_reason: options?.deleteReason,
568
+ count: result.deleted,
569
+ outcome: deleteOutcome(result.deleted)
570
+ })
571
+ });
572
+ }
573
+ auditEntryReadSync(operation, scope, run, requestedIds = []) {
574
+ return runWithMemoryAuditSync({
575
+ stateDir: getSnoStationMemStateDir(),
576
+ event: "memory_read",
577
+ operation,
578
+ scope,
579
+ startedDetails: {
580
+ scope,
581
+ memory_ids: requestedIds,
582
+ requested_count: 1
583
+ },
584
+ run,
585
+ completedDetails: (entry) => ({
586
+ ...entry ? {
587
+ scope: entry.projectId,
588
+ memory_ids: [entry.id]
589
+ } : {},
590
+ requested_count: 1,
591
+ result_count: entry ? 1 : 0,
592
+ found: entry !== void 0
593
+ })
594
+ });
595
+ }
596
+ async auditSearch(operation, opts, run) {
597
+ return runWithMemoryAudit({
598
+ stateDir: getSnoStationMemStateDir(),
599
+ event: "memory_searched",
600
+ operation,
601
+ startedDetails: { requested_count: opts.limit },
602
+ run,
603
+ completedDetails: (results) => ({
604
+ requested_count: opts.limit,
605
+ result_count: results.length,
606
+ memory_ids: results.map((result) => result.parentMemoryId)
607
+ })
608
+ });
609
+ }
610
+ async auditMemorySearch(operation, opts, run) {
611
+ return runWithMemoryAudit({
612
+ stateDir: getSnoStationMemStateDir(),
613
+ event: "memory_searched",
614
+ operation,
615
+ startedDetails: { requested_count: opts.limit },
616
+ run,
617
+ completedDetails: (results) => ({
618
+ requested_count: opts.limit,
619
+ result_count: results.length,
620
+ memory_ids: results.map((result) => result.entry.id)
621
+ })
622
+ });
623
+ }
624
+ async auditMetadataMutation(operation, memoryIds, run) {
625
+ let existingIds = [];
626
+ await runWithMemoryAudit({
627
+ stateDir: getSnoStationMemStateDir(),
628
+ event: "memory_updated",
629
+ operation,
630
+ startedDetails: {
631
+ memory_ids: memoryIds,
632
+ requested_count: memoryIds.length
633
+ },
634
+ run: async () => {
635
+ existingIds = memoryIds.filter((id) => super.getById(id) !== void 0);
636
+ await run();
637
+ },
638
+ completedDetails: () => ({
639
+ memory_ids: existingIds,
640
+ requested_count: memoryIds.length,
641
+ result_count: existingIds.length,
642
+ outcome: existingIds.length === 0 ? "missing" : "updated"
643
+ })
644
+ });
645
+ }
646
+ resolveDeleteIds(idOrPrefix) {
647
+ if (!idOrPrefix.endsWith("*")) return this.readExistingMemoryIds([idOrPrefix]);
648
+ const rawPrefix = idOrPrefix.slice(0, -1);
649
+ if (rawPrefix.length < 4) throw new StorageError(`Wildcard delete prefix too short (min 4 chars): "${rawPrefix}*"`);
650
+ const escapedPrefix = rawPrefix.replace(/[\\%_]/g, "\\$&");
651
+ return this.sqlite.prepare("SELECT id FROM nodix_memories WHERE id LIKE ? ESCAPE '\\'").all(`${escapedPrefix}%`).map((row) => row.id);
652
+ }
653
+ readExistingMemoryIds(ids) {
654
+ const uniqueIds = Array.from(new Set(ids));
655
+ const existingIds = [];
656
+ for (let index = 0; index < uniqueIds.length; index += 500) {
657
+ const batch = uniqueIds.slice(index, index + 500);
658
+ const rows = this.sqlite.prepare("SELECT id FROM nodix_memories WHERE id IN (SELECT value FROM json_each(?))").all(JSON.stringify(batch));
659
+ existingIds.push(...rows.map((row) => row.id));
660
+ }
661
+ return existingIds;
662
+ }
663
+ async emitWrite(entry, sessionUuid) {
664
+ const keyHash = this.observability.hashText(entry.contentHash || entry.id);
665
+ if (!keyHash) return;
666
+ const tokens = await countEmbeddingTokens(entry.text, this.embeddingConfig);
667
+ await this.observability.emit({
668
+ eventType: "memory.write",
669
+ sessionUuid,
670
+ ...isAbsolute(entry.projectId) ? { scope: { project_id: detectProjectId(entry.projectId) } } : {},
671
+ payload: {
672
+ key_hash: keyHash,
673
+ byte_len: Buffer.byteLength(entry.text, "utf8"),
674
+ content_tokens: tokens.count,
675
+ tokens_method: tokens.method
676
+ }
677
+ });
678
+ }
679
+ };
680
+ function uniformValue(values) {
681
+ const first = values[0];
682
+ if (first === void 0) return "mixed";
683
+ return values.every((value) => value === first) ? first : "mixed";
684
+ }
685
+ function deleteOutcome(deletedCount) {
686
+ return deletedCount > 0 ? "deleted" : "noop";
687
+ }
688
+ function writeDetails(entry) {
689
+ return {
690
+ scope: entry.projectId,
691
+ category: entry.category,
692
+ lane: entry.lane,
693
+ count: 1,
694
+ memory_ids: [entry.id],
695
+ write_outcome: entry.storeWriteOutcome,
696
+ created_count: entry.storeWriteOutcome === "created" ? 1 : 0,
697
+ existing_count: entry.storeWriteOutcome === "existing" ? 1 : 0
698
+ };
699
+ }
700
+ //#endregion
701
+ export { ObservableMemoryStore };
@@ -0,0 +1,2 @@
1
+ import { t as ObservableMemoryRetriever } from "../../../observable-retriever-Cooc62Qw.js";
2
+ export { ObservableMemoryRetriever };