@remnic/core 10.0.5 → 10.0.7

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 (373) hide show
  1. package/dist/access-admin-ops-surface.js +57 -56
  2. package/dist/access-authorization-probe.js +58 -57
  3. package/dist/access-boundary.js +57 -56
  4. package/dist/access-cli.js +108 -107
  5. package/dist/access-cli.js.map +1 -1
  6. package/dist/access-extraction-force-flush.js +57 -56
  7. package/dist/access-http-briefing.js +58 -57
  8. package/dist/access-http-query.js +59 -58
  9. package/dist/access-http.js +77 -76
  10. package/dist/access-idempotency.d.ts.map +1 -1
  11. package/dist/access-idempotency.js +2 -1
  12. package/dist/access-identity-continuity-surface.js +57 -56
  13. package/dist/access-lcm-surface.js +57 -56
  14. package/dist/access-mcp.js +69 -68
  15. package/dist/access-namespace-preflight.js +57 -56
  16. package/dist/access-observe-write-category.js +12 -11
  17. package/dist/access-observe-write-surface.js +57 -56
  18. package/dist/access-offline-manifest.js +11 -10
  19. package/dist/access-operations-batch.js +61 -60
  20. package/dist/access-operations.js +68 -67
  21. package/dist/access-recall-concurrency.js +57 -56
  22. package/dist/access-recall-response.js +57 -56
  23. package/dist/access-recall-surface.js +57 -56
  24. package/dist/access-schema.js +7 -6
  25. package/dist/access-service.js +57 -56
  26. package/dist/access-surface-catalog.js +59 -58
  27. package/dist/access-surface-catalog.js.map +1 -1
  28. package/dist/active-recall.js +23 -22
  29. package/dist/active-recall.js.map +1 -1
  30. package/dist/{auto-sync-FN7E3OTO.js → auto-sync-WSJAOLOP.js} +8 -7
  31. package/dist/{auto-sync-FN7E3OTO.js.map → auto-sync-WSJAOLOP.js.map} +1 -1
  32. package/dist/briefing.js +16 -15
  33. package/dist/buffer.js +11 -10
  34. package/dist/calibration.d.ts +31 -3
  35. package/dist/calibration.d.ts.map +1 -1
  36. package/dist/calibration.js +67 -16
  37. package/dist/calibration.js.map +1 -1
  38. package/dist/{capsule-merge-42GJGDUC.js → capsule-merge-M4HETD27.js} +5 -4
  39. package/dist/{capsule-merge-42GJGDUC.js.map → capsule-merge-M4HETD27.js.map} +1 -1
  40. package/dist/causal-behavior.js +2 -2
  41. package/dist/causal-chain.js +2 -2
  42. package/dist/causal-consolidation.js +19 -18
  43. package/dist/causal-consolidation.js.map +1 -1
  44. package/dist/causal-retrieval.js +2 -2
  45. package/dist/causal-trajectory-graph.js +4 -3
  46. package/dist/causal-trajectory-graph.js.map +1 -1
  47. package/dist/causal-trajectory.js +1 -1
  48. package/dist/{chunk-OZABSIOV.js → chunk-2AFHZTPI.js} +2 -2
  49. package/dist/{chunk-UK5EH7AI.js → chunk-2CXQZXWM.js} +3 -3
  50. package/dist/{chunk-RIEGCK2W.js → chunk-2KRNPFPK.js} +2 -2
  51. package/dist/{chunk-N7QV3CMX.js → chunk-2NCBDGND.js} +2 -2
  52. package/dist/{chunk-FLV7M7CT.js → chunk-2PBZBNY7.js} +2 -2
  53. package/dist/{chunk-KSUOM3YU.js → chunk-2SKI5ZSH.js} +11 -11
  54. package/dist/{chunk-SUAX5JWY.js → chunk-3DSRYRGR.js} +2 -2
  55. package/dist/{chunk-JA72X46J.js → chunk-3GLQUOL2.js} +2 -2
  56. package/dist/{chunk-CLCMDKTB.js → chunk-3I3U6FFT.js} +2 -2
  57. package/dist/{chunk-BNMI3JBV.js → chunk-4EHA327M.js} +3 -3
  58. package/dist/{chunk-QWUJWBZ5.js → chunk-4G4B3Z2B.js} +2 -2
  59. package/dist/{chunk-R7QY5ZVB.js → chunk-4NDWE44P.js} +2 -2
  60. package/dist/{chunk-U6HWKOGD.js → chunk-5GN5LRQW.js} +2 -2
  61. package/dist/{chunk-VFUEZZBS.js → chunk-5JMI26Q7.js} +5 -4
  62. package/dist/chunk-5JMI26Q7.js.map +1 -0
  63. package/dist/{chunk-MQNOIH2C.js → chunk-5O4UJ6PM.js} +3 -3
  64. package/dist/{chunk-HRZZJ4XB.js → chunk-645A37SC.js} +2 -2
  65. package/dist/{chunk-JA54KIYD.js → chunk-65FYHYBE.js} +2 -2
  66. package/dist/{chunk-CHDGJJV6.js → chunk-6VAHJ2F6.js} +2 -2
  67. package/dist/chunk-7LEQREP2.js +9 -0
  68. package/dist/chunk-7LEQREP2.js.map +1 -0
  69. package/dist/{chunk-TZQOCQXB.js → chunk-AL6EHLB5.js} +2 -2
  70. package/dist/{chunk-NBQIFCJE.js → chunk-B2UK6O2O.js} +5 -11
  71. package/dist/chunk-B2UK6O2O.js.map +1 -0
  72. package/dist/{chunk-VZBW6CDG.js → chunk-BOOFTFFE.js} +1 -1
  73. package/dist/{chunk-YJEUHGZZ.js → chunk-BR75HFPC.js} +2 -2
  74. package/dist/{chunk-GF4H3B3R.js → chunk-BSWHZJSP.js} +3 -3
  75. package/dist/{chunk-2U3R3DDH.js → chunk-BTJ6CAIA.js} +2 -2
  76. package/dist/{chunk-SNXBXYUE.js → chunk-CG2E6WT5.js} +3 -3
  77. package/dist/{chunk-GE6HETIF.js → chunk-CRYAYFUE.js} +2 -2
  78. package/dist/{chunk-GEGUBU3D.js → chunk-D6C4JWSN.js} +3 -3
  79. package/dist/{chunk-WRICYGYG.js → chunk-DSVRW5BD.js} +15 -15
  80. package/dist/{chunk-7LYRFI5A.js → chunk-E3OSDZ6M.js} +2 -2
  81. package/dist/{chunk-2COXDQ6C.js → chunk-E6KXJSMA.js} +2 -2
  82. package/dist/{chunk-6KHF6PAB.js → chunk-EBQCVOGC.js} +3 -3
  83. package/dist/{chunk-FFAZ2XFU.js → chunk-EHRE7ZG3.js} +5 -6
  84. package/dist/chunk-EHRE7ZG3.js.map +1 -0
  85. package/dist/{chunk-SZXPKUMN.js → chunk-ETGXRGSR.js} +4 -4
  86. package/dist/{chunk-KQI2PKYP.js → chunk-F2QIPGTG.js} +2 -2
  87. package/dist/{chunk-XVC7JU2N.js → chunk-FQD2KPQH.js} +2 -2
  88. package/dist/{chunk-QMFKW4OU.js → chunk-FRRR4KOW.js} +3 -3
  89. package/dist/{chunk-FRH2UC7Q.js → chunk-GH5R5BIH.js} +2 -2
  90. package/dist/{chunk-JMF5Q4JY.js → chunk-GTSQJTNS.js} +7 -7
  91. package/dist/{chunk-I56MTWE7.js → chunk-HHE57I2Z.js} +2 -2
  92. package/dist/{chunk-MULNBSPP.js → chunk-HT2C4EXO.js} +2 -2
  93. package/dist/{chunk-EMVJU7WC.js → chunk-IE2J3V5N.js} +2 -2
  94. package/dist/{chunk-L34W4W4I.js → chunk-IJU2ZWPE.js} +2 -2
  95. package/dist/{chunk-U6OXJQEH.js → chunk-J5QL66XK.js} +2 -2
  96. package/dist/{chunk-AJ6ORARY.js → chunk-JALYQUYO.js} +2 -2
  97. package/dist/chunk-JALYQUYO.js.map +1 -0
  98. package/dist/{chunk-FC6RCOIU.js → chunk-JFGX2DKT.js} +2 -2
  99. package/dist/{chunk-ANZXWOYD.js → chunk-JH4XB3RX.js} +2 -2
  100. package/dist/{chunk-N4PYB235.js → chunk-KI6UOSNR.js} +2 -2
  101. package/dist/{chunk-4K2H4KTR.js → chunk-KMAHEIOH.js} +3 -3
  102. package/dist/{chunk-EQUD7FP4.js → chunk-KYY4EACB.js} +2 -2
  103. package/dist/{chunk-46WM6JX2.js → chunk-LZKOVXMX.js} +2 -2
  104. package/dist/{chunk-I25RQA65.js → chunk-M4MAVJJX.js} +2 -2
  105. package/dist/{chunk-V32NHP2R.js → chunk-M6PEFWJ4.js} +2 -2
  106. package/dist/{chunk-XPRAOTJY.js → chunk-MHGHEBTR.js} +2 -2
  107. package/dist/{chunk-VC4J4UTI.js → chunk-NJTW2MUV.js} +2 -2
  108. package/dist/{chunk-4CWUZBPF.js → chunk-OCIJYYCA.js} +7 -7
  109. package/dist/{chunk-5CQO6LVM.js → chunk-ODGXQUPR.js} +2 -2
  110. package/dist/{chunk-5AYUHSAU.js → chunk-OFCHT2TN.js} +2 -2
  111. package/dist/{chunk-5BY3IA2U.js → chunk-OH75RBYF.js} +5 -5
  112. package/dist/{chunk-37HCPM56.js → chunk-OX5LMCEQ.js} +10 -10
  113. package/dist/{chunk-SWRN6U7Q.js → chunk-PBYY4WYM.js} +2 -2
  114. package/dist/{chunk-QRZMJ2WN.js → chunk-PO6MNTWH.js} +2 -2
  115. package/dist/{chunk-2CP577K6.js → chunk-PPIASWWR.js} +2 -2
  116. package/dist/{chunk-OGVJXIHX.js → chunk-PXTZOU5F.js} +2 -2
  117. package/dist/{chunk-IJ4FEGZR.js → chunk-Q67D4JYB.js} +2 -2
  118. package/dist/{chunk-GVUW5XK5.js → chunk-QF7XX74D.js} +39 -39
  119. package/dist/chunk-QF7XX74D.js.map +1 -0
  120. package/dist/{chunk-I25RINZK.js → chunk-QHL33ZDS.js} +2 -2
  121. package/dist/{chunk-MFZACYZ6.js → chunk-QUNDYIYZ.js} +3 -3
  122. package/dist/{chunk-TGF43K66.js → chunk-QWDH4QNA.js} +4 -4
  123. package/dist/{chunk-W5XWHTDO.js → chunk-QZZPUREO.js} +3 -3
  124. package/dist/{chunk-M47Q6566.js → chunk-RVJPY6E4.js} +2 -2
  125. package/dist/{chunk-KE5PWLI6.js → chunk-T5XG6GQI.js} +3 -3
  126. package/dist/{chunk-EP5WXE2G.js → chunk-TCYLCPC6.js} +2 -2
  127. package/dist/{chunk-WWLAKRMX.js → chunk-TPNCVFVI.js} +2 -2
  128. package/dist/{chunk-WG4TMZJ2.js → chunk-TVRTJZQ5.js} +2 -2
  129. package/dist/{chunk-DST7HRSG.js → chunk-UL7WKKGZ.js} +2 -2
  130. package/dist/{chunk-5LNPW7NE.js → chunk-UTXWLTX5.js} +2 -2
  131. package/dist/{chunk-YJAOYEWI.js → chunk-V4ACBX3C.js} +2 -2
  132. package/dist/{chunk-DJMVSUPK.js → chunk-VBNIQ6H2.js} +4 -4
  133. package/dist/{chunk-PO7NXNGC.js → chunk-VFTK5WKI.js} +2 -2
  134. package/dist/{chunk-L2VS27PZ.js → chunk-VIPGYPEG.js} +4 -4
  135. package/dist/{chunk-ENNC3RZ6.js → chunk-VQBGV44L.js} +2 -2
  136. package/dist/{chunk-5BPXMAUP.js → chunk-VUQDJ3JB.js} +4 -4
  137. package/dist/{chunk-7CXL25AA.js → chunk-W4RLOZOG.js} +3 -3
  138. package/dist/{chunk-LHRQBMJN.js → chunk-WADSXS4K.js} +2 -2
  139. package/dist/{chunk-NHSVW7UT.js → chunk-WUUE2I2A.js} +6 -6
  140. package/dist/{chunk-IM2GO42H.js → chunk-WVHRNAXL.js} +4 -4
  141. package/dist/chunk-WVHRNAXL.js.map +1 -0
  142. package/dist/{chunk-TDMNADPI.js → chunk-XKEDESWC.js} +2 -2
  143. package/dist/{chunk-UXIZ5XN5.js → chunk-XLIK2VDE.js} +3 -3
  144. package/dist/{chunk-2UPTRDGM.js → chunk-Y6DZ33PA.js} +4 -4
  145. package/dist/{chunk-HPAOMYKM.js → chunk-Y6IHIORY.js} +50 -50
  146. package/dist/{chunk-63UNVGZW.js → chunk-YBSWXKCH.js} +4 -4
  147. package/dist/{chunk-IFCKHPY4.js → chunk-YDH2FSDI.js} +2 -2
  148. package/dist/{chunk-L3PWXD73.js → chunk-YMVLPVQP.js} +2 -2
  149. package/dist/{chunk-52CQKST6.js → chunk-YNSHGVXT.js} +26 -26
  150. package/dist/{chunk-L6GNS5GB.js → chunk-YS7SA4HD.js} +2 -2
  151. package/dist/{chunk-RSMIRLKM.js → chunk-YV54LYEB.js} +2 -2
  152. package/dist/{chunk-EIFYYHAF.js → chunk-YYO447A7.js} +4 -4
  153. package/dist/{chunk-S5TGRZWY.js → chunk-Z2ZUV6FE.js} +3 -3
  154. package/dist/{chunk-XQSJXNWC.js → chunk-Z4CETAL7.js} +2 -2
  155. package/dist/{chunk-AXC7UTLM.js → chunk-Z5IQTRDN.js} +2 -2
  156. package/dist/{chunk-SIYZDT2V.js → chunk-ZBDTSFRA.js} +2 -2
  157. package/dist/{chunk-75PT4N7Q.js → chunk-ZI7LMSNI.js} +2 -2
  158. package/dist/{chunk-EUT2WCWS.js → chunk-ZQ3WU6JO.js} +2 -2
  159. package/dist/{chunk-JYG2334B.js → chunk-ZSJGYC3C.js} +2 -2
  160. package/dist/cli.js +92 -91
  161. package/dist/coding/export-okf-codegraph.js +16 -15
  162. package/dist/coding/export-okf-codegraph.js.map +1 -1
  163. package/dist/coding/pre-action-gate.js +2 -2
  164. package/dist/compounding/engine.d.ts.map +1 -1
  165. package/dist/compounding/engine.js +17 -16
  166. package/dist/config.js +23 -22
  167. package/dist/connectors/codex-materialize-runner.js +16 -15
  168. package/dist/connectors/index.js +16 -15
  169. package/dist/consolidation-provenance-check.js +5 -4
  170. package/dist/consolidation-undo.js +4 -3
  171. package/dist/consolidation-undo.js.map +1 -1
  172. package/dist/contradiction/index.js +6 -5
  173. package/dist/convergence-refresh.js +18 -17
  174. package/dist/corpus-watermark.js +18 -17
  175. package/dist/deep-recall-http-glue.js +8 -7
  176. package/dist/embedding-fallback.js +4 -3
  177. package/dist/embedding-generation-lock.js +3 -2
  178. package/dist/entity-retrieval.js +16 -15
  179. package/dist/explicit-capture.js +8 -7
  180. package/dist/external-wiki-access.js +58 -57
  181. package/dist/extraction.js +25 -24
  182. package/dist/{forget-SZ2BXDGF.js → forget-OHAJ6PSU.js} +4 -3
  183. package/dist/{forget-SZ2BXDGF.js.map → forget-OHAJ6PSU.js.map} +1 -1
  184. package/dist/{graph-edge-decay-PVKDKLQK.js → graph-edge-decay-CZ3SYLM4.js} +7 -6
  185. package/dist/graph-jsonl.js +5 -4
  186. package/dist/graph-snapshot.js +5 -4
  187. package/dist/graph-write-lock.js +3 -2
  188. package/dist/graph.js +4 -3
  189. package/dist/harmonic-retrieval.js +16 -15
  190. package/dist/http-retry.d.ts.map +1 -1
  191. package/dist/http-retry.js +6 -8
  192. package/dist/http-retry.js.map +1 -1
  193. package/dist/index.js +108 -107
  194. package/dist/location/index.js +19 -18
  195. package/dist/maintenance/memory-governance.js +16 -15
  196. package/dist/maintenance/rebuild-memory-lifecycle-ledger.js +16 -15
  197. package/dist/maintenance/rebuild-memory-projection-runner.js +18 -17
  198. package/dist/maintenance/rebuild-memory-projection.js +17 -16
  199. package/dist/memory-browse-operations.js +58 -57
  200. package/dist/memory-browse.js +6 -5
  201. package/dist/memory-subject.js +4 -3
  202. package/dist/namespaces/migrate.js +17 -16
  203. package/dist/namespaces/search.js +5 -4
  204. package/dist/namespaces/storage.js +16 -15
  205. package/dist/offline-sync-changeset-generations.js +5 -4
  206. package/dist/offline-sync-embedding-generation.js +4 -3
  207. package/dist/offline-sync-impression-drain.js +4 -3
  208. package/dist/offline-sync-snapshot-stream.js +7 -6
  209. package/dist/offline-sync.js +6 -5
  210. package/dist/operator-doctor-corpus.js +19 -18
  211. package/dist/operator-toolkit.js +35 -34
  212. package/dist/orchestration/maintenance.js +26 -25
  213. package/dist/orchestrator.js +108 -107
  214. package/dist/page-versioning.js +4 -3
  215. package/dist/procedural/procedure-miner.d.ts.map +1 -1
  216. package/dist/qmd-daemon-session.d.ts.map +1 -1
  217. package/dist/qmd-daemon-session.js +2 -1
  218. package/dist/qmd.d.ts.map +1 -1
  219. package/dist/qmd.js +3 -2
  220. package/dist/recall-navigation-operations.js +58 -57
  221. package/dist/recall-navigation.js +57 -56
  222. package/dist/recall-state-view-admission.js +6 -5
  223. package/dist/recall-state.js +3 -2
  224. package/dist/recall-why-service.js +6 -5
  225. package/dist/reconcile/manifest.js +4 -3
  226. package/dist/{resolution-TV3F7ZTH.js → resolution-E4GLHLY6.js} +7 -6
  227. package/dist/resume-bundles.js +24 -23
  228. package/dist/salvage-envelope.js +6 -5
  229. package/dist/search/factory.js +4 -3
  230. package/dist/search/index.js +4 -3
  231. package/dist/semantic-consolidation.js +17 -16
  232. package/dist/semantic-rule-promotion.js +16 -15
  233. package/dist/semantic-rule-verifier.js +16 -15
  234. package/dist/source-agent-qualifier.js +20 -19
  235. package/dist/standup/build.js +16 -15
  236. package/dist/storage.js +15 -14
  237. package/dist/subject-config.js +5 -4
  238. package/dist/summarizer.js +4 -3
  239. package/dist/summary-snapshot.js +3 -2
  240. package/dist/support-passport/index.js +60 -59
  241. package/dist/testing/orchestrator-lite.d.ts +1 -2
  242. package/dist/testing/orchestrator-lite.d.ts.map +1 -1
  243. package/dist/transfer/capsule-import.js +5 -4
  244. package/dist/transfer/export-okf.js +16 -15
  245. package/dist/utils/serialize-mutations.d.ts.map +1 -1
  246. package/dist/utils/serialize-mutations.js +2 -1
  247. package/dist/utils/sleep.d.ts +3 -0
  248. package/dist/utils/sleep.d.ts.map +1 -0
  249. package/dist/verified-recall.js +16 -15
  250. package/dist/who-knows-cli.js +17 -16
  251. package/dist/who-knows.js +16 -15
  252. package/dist/write-envelope.js +5 -4
  253. package/package.json +2 -2
  254. package/src/access-idempotency.ts +1 -4
  255. package/src/calibration-local-llm.test.ts +361 -0
  256. package/src/calibration.ts +109 -26
  257. package/src/compounding/engine.ts +2 -8
  258. package/src/http-retry.ts +2 -6
  259. package/src/memory-projection-batch.test.ts +55 -0
  260. package/src/offline-sync-digest-cache.test.ts +45 -0
  261. package/src/procedural/procedure-miner.ts +1 -4
  262. package/src/qmd-daemon-session.ts +1 -4
  263. package/src/qmd.ts +0 -4
  264. package/src/testing/orchestrator-lite.ts +2 -7
  265. package/src/utils/serialize-mutations.ts +1 -13
  266. package/src/utils/sleep.test.ts +32 -0
  267. package/src/utils/sleep.ts +5 -0
  268. package/dist/chunk-AJ6ORARY.js.map +0 -1
  269. package/dist/chunk-FFAZ2XFU.js.map +0 -1
  270. package/dist/chunk-GVUW5XK5.js.map +0 -1
  271. package/dist/chunk-IM2GO42H.js.map +0 -1
  272. package/dist/chunk-NBQIFCJE.js.map +0 -1
  273. package/dist/chunk-VFUEZZBS.js.map +0 -1
  274. /package/dist/{chunk-OZABSIOV.js.map → chunk-2AFHZTPI.js.map} +0 -0
  275. /package/dist/{chunk-UK5EH7AI.js.map → chunk-2CXQZXWM.js.map} +0 -0
  276. /package/dist/{chunk-RIEGCK2W.js.map → chunk-2KRNPFPK.js.map} +0 -0
  277. /package/dist/{chunk-N7QV3CMX.js.map → chunk-2NCBDGND.js.map} +0 -0
  278. /package/dist/{chunk-FLV7M7CT.js.map → chunk-2PBZBNY7.js.map} +0 -0
  279. /package/dist/{chunk-KSUOM3YU.js.map → chunk-2SKI5ZSH.js.map} +0 -0
  280. /package/dist/{chunk-SUAX5JWY.js.map → chunk-3DSRYRGR.js.map} +0 -0
  281. /package/dist/{chunk-JA72X46J.js.map → chunk-3GLQUOL2.js.map} +0 -0
  282. /package/dist/{chunk-CLCMDKTB.js.map → chunk-3I3U6FFT.js.map} +0 -0
  283. /package/dist/{chunk-BNMI3JBV.js.map → chunk-4EHA327M.js.map} +0 -0
  284. /package/dist/{chunk-QWUJWBZ5.js.map → chunk-4G4B3Z2B.js.map} +0 -0
  285. /package/dist/{chunk-R7QY5ZVB.js.map → chunk-4NDWE44P.js.map} +0 -0
  286. /package/dist/{chunk-U6HWKOGD.js.map → chunk-5GN5LRQW.js.map} +0 -0
  287. /package/dist/{chunk-MQNOIH2C.js.map → chunk-5O4UJ6PM.js.map} +0 -0
  288. /package/dist/{chunk-HRZZJ4XB.js.map → chunk-645A37SC.js.map} +0 -0
  289. /package/dist/{chunk-JA54KIYD.js.map → chunk-65FYHYBE.js.map} +0 -0
  290. /package/dist/{chunk-CHDGJJV6.js.map → chunk-6VAHJ2F6.js.map} +0 -0
  291. /package/dist/{chunk-TZQOCQXB.js.map → chunk-AL6EHLB5.js.map} +0 -0
  292. /package/dist/{chunk-VZBW6CDG.js.map → chunk-BOOFTFFE.js.map} +0 -0
  293. /package/dist/{chunk-YJEUHGZZ.js.map → chunk-BR75HFPC.js.map} +0 -0
  294. /package/dist/{chunk-GF4H3B3R.js.map → chunk-BSWHZJSP.js.map} +0 -0
  295. /package/dist/{chunk-2U3R3DDH.js.map → chunk-BTJ6CAIA.js.map} +0 -0
  296. /package/dist/{chunk-SNXBXYUE.js.map → chunk-CG2E6WT5.js.map} +0 -0
  297. /package/dist/{chunk-GE6HETIF.js.map → chunk-CRYAYFUE.js.map} +0 -0
  298. /package/dist/{chunk-GEGUBU3D.js.map → chunk-D6C4JWSN.js.map} +0 -0
  299. /package/dist/{chunk-WRICYGYG.js.map → chunk-DSVRW5BD.js.map} +0 -0
  300. /package/dist/{chunk-7LYRFI5A.js.map → chunk-E3OSDZ6M.js.map} +0 -0
  301. /package/dist/{chunk-2COXDQ6C.js.map → chunk-E6KXJSMA.js.map} +0 -0
  302. /package/dist/{chunk-6KHF6PAB.js.map → chunk-EBQCVOGC.js.map} +0 -0
  303. /package/dist/{chunk-SZXPKUMN.js.map → chunk-ETGXRGSR.js.map} +0 -0
  304. /package/dist/{chunk-KQI2PKYP.js.map → chunk-F2QIPGTG.js.map} +0 -0
  305. /package/dist/{chunk-XVC7JU2N.js.map → chunk-FQD2KPQH.js.map} +0 -0
  306. /package/dist/{chunk-QMFKW4OU.js.map → chunk-FRRR4KOW.js.map} +0 -0
  307. /package/dist/{chunk-FRH2UC7Q.js.map → chunk-GH5R5BIH.js.map} +0 -0
  308. /package/dist/{chunk-JMF5Q4JY.js.map → chunk-GTSQJTNS.js.map} +0 -0
  309. /package/dist/{chunk-I56MTWE7.js.map → chunk-HHE57I2Z.js.map} +0 -0
  310. /package/dist/{chunk-MULNBSPP.js.map → chunk-HT2C4EXO.js.map} +0 -0
  311. /package/dist/{chunk-EMVJU7WC.js.map → chunk-IE2J3V5N.js.map} +0 -0
  312. /package/dist/{chunk-L34W4W4I.js.map → chunk-IJU2ZWPE.js.map} +0 -0
  313. /package/dist/{chunk-U6OXJQEH.js.map → chunk-J5QL66XK.js.map} +0 -0
  314. /package/dist/{chunk-FC6RCOIU.js.map → chunk-JFGX2DKT.js.map} +0 -0
  315. /package/dist/{chunk-ANZXWOYD.js.map → chunk-JH4XB3RX.js.map} +0 -0
  316. /package/dist/{chunk-N4PYB235.js.map → chunk-KI6UOSNR.js.map} +0 -0
  317. /package/dist/{chunk-4K2H4KTR.js.map → chunk-KMAHEIOH.js.map} +0 -0
  318. /package/dist/{chunk-EQUD7FP4.js.map → chunk-KYY4EACB.js.map} +0 -0
  319. /package/dist/{chunk-46WM6JX2.js.map → chunk-LZKOVXMX.js.map} +0 -0
  320. /package/dist/{chunk-I25RQA65.js.map → chunk-M4MAVJJX.js.map} +0 -0
  321. /package/dist/{chunk-V32NHP2R.js.map → chunk-M6PEFWJ4.js.map} +0 -0
  322. /package/dist/{chunk-XPRAOTJY.js.map → chunk-MHGHEBTR.js.map} +0 -0
  323. /package/dist/{chunk-VC4J4UTI.js.map → chunk-NJTW2MUV.js.map} +0 -0
  324. /package/dist/{chunk-4CWUZBPF.js.map → chunk-OCIJYYCA.js.map} +0 -0
  325. /package/dist/{chunk-5CQO6LVM.js.map → chunk-ODGXQUPR.js.map} +0 -0
  326. /package/dist/{chunk-5AYUHSAU.js.map → chunk-OFCHT2TN.js.map} +0 -0
  327. /package/dist/{chunk-5BY3IA2U.js.map → chunk-OH75RBYF.js.map} +0 -0
  328. /package/dist/{chunk-37HCPM56.js.map → chunk-OX5LMCEQ.js.map} +0 -0
  329. /package/dist/{chunk-SWRN6U7Q.js.map → chunk-PBYY4WYM.js.map} +0 -0
  330. /package/dist/{chunk-QRZMJ2WN.js.map → chunk-PO6MNTWH.js.map} +0 -0
  331. /package/dist/{chunk-2CP577K6.js.map → chunk-PPIASWWR.js.map} +0 -0
  332. /package/dist/{chunk-OGVJXIHX.js.map → chunk-PXTZOU5F.js.map} +0 -0
  333. /package/dist/{chunk-IJ4FEGZR.js.map → chunk-Q67D4JYB.js.map} +0 -0
  334. /package/dist/{chunk-I25RINZK.js.map → chunk-QHL33ZDS.js.map} +0 -0
  335. /package/dist/{chunk-MFZACYZ6.js.map → chunk-QUNDYIYZ.js.map} +0 -0
  336. /package/dist/{chunk-TGF43K66.js.map → chunk-QWDH4QNA.js.map} +0 -0
  337. /package/dist/{chunk-W5XWHTDO.js.map → chunk-QZZPUREO.js.map} +0 -0
  338. /package/dist/{chunk-M47Q6566.js.map → chunk-RVJPY6E4.js.map} +0 -0
  339. /package/dist/{chunk-KE5PWLI6.js.map → chunk-T5XG6GQI.js.map} +0 -0
  340. /package/dist/{chunk-EP5WXE2G.js.map → chunk-TCYLCPC6.js.map} +0 -0
  341. /package/dist/{chunk-WWLAKRMX.js.map → chunk-TPNCVFVI.js.map} +0 -0
  342. /package/dist/{chunk-WG4TMZJ2.js.map → chunk-TVRTJZQ5.js.map} +0 -0
  343. /package/dist/{chunk-DST7HRSG.js.map → chunk-UL7WKKGZ.js.map} +0 -0
  344. /package/dist/{chunk-5LNPW7NE.js.map → chunk-UTXWLTX5.js.map} +0 -0
  345. /package/dist/{chunk-YJAOYEWI.js.map → chunk-V4ACBX3C.js.map} +0 -0
  346. /package/dist/{chunk-DJMVSUPK.js.map → chunk-VBNIQ6H2.js.map} +0 -0
  347. /package/dist/{chunk-PO7NXNGC.js.map → chunk-VFTK5WKI.js.map} +0 -0
  348. /package/dist/{chunk-L2VS27PZ.js.map → chunk-VIPGYPEG.js.map} +0 -0
  349. /package/dist/{chunk-ENNC3RZ6.js.map → chunk-VQBGV44L.js.map} +0 -0
  350. /package/dist/{chunk-5BPXMAUP.js.map → chunk-VUQDJ3JB.js.map} +0 -0
  351. /package/dist/{chunk-7CXL25AA.js.map → chunk-W4RLOZOG.js.map} +0 -0
  352. /package/dist/{chunk-LHRQBMJN.js.map → chunk-WADSXS4K.js.map} +0 -0
  353. /package/dist/{chunk-NHSVW7UT.js.map → chunk-WUUE2I2A.js.map} +0 -0
  354. /package/dist/{chunk-TDMNADPI.js.map → chunk-XKEDESWC.js.map} +0 -0
  355. /package/dist/{chunk-UXIZ5XN5.js.map → chunk-XLIK2VDE.js.map} +0 -0
  356. /package/dist/{chunk-2UPTRDGM.js.map → chunk-Y6DZ33PA.js.map} +0 -0
  357. /package/dist/{chunk-HPAOMYKM.js.map → chunk-Y6IHIORY.js.map} +0 -0
  358. /package/dist/{chunk-63UNVGZW.js.map → chunk-YBSWXKCH.js.map} +0 -0
  359. /package/dist/{chunk-IFCKHPY4.js.map → chunk-YDH2FSDI.js.map} +0 -0
  360. /package/dist/{chunk-L3PWXD73.js.map → chunk-YMVLPVQP.js.map} +0 -0
  361. /package/dist/{chunk-52CQKST6.js.map → chunk-YNSHGVXT.js.map} +0 -0
  362. /package/dist/{chunk-L6GNS5GB.js.map → chunk-YS7SA4HD.js.map} +0 -0
  363. /package/dist/{chunk-RSMIRLKM.js.map → chunk-YV54LYEB.js.map} +0 -0
  364. /package/dist/{chunk-EIFYYHAF.js.map → chunk-YYO447A7.js.map} +0 -0
  365. /package/dist/{chunk-S5TGRZWY.js.map → chunk-Z2ZUV6FE.js.map} +0 -0
  366. /package/dist/{chunk-XQSJXNWC.js.map → chunk-Z4CETAL7.js.map} +0 -0
  367. /package/dist/{chunk-AXC7UTLM.js.map → chunk-Z5IQTRDN.js.map} +0 -0
  368. /package/dist/{chunk-SIYZDT2V.js.map → chunk-ZBDTSFRA.js.map} +0 -0
  369. /package/dist/{chunk-75PT4N7Q.js.map → chunk-ZI7LMSNI.js.map} +0 -0
  370. /package/dist/{chunk-EUT2WCWS.js.map → chunk-ZQ3WU6JO.js.map} +0 -0
  371. /package/dist/{chunk-JYG2334B.js.map → chunk-ZSJGYC3C.js.map} +0 -0
  372. /package/dist/{graph-edge-decay-PVKDKLQK.js.map → graph-edge-decay-CZ3SYLM4.js.map} +0 -0
  373. /package/dist/{resolution-TV3F7ZTH.js.map → resolution-E4GLHLY6.js.map} +0 -0
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/active-recall.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { DEFAULT_REASONING_MODEL } from \"./config.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\nimport type {\n ActiveRecallChatType,\n ActiveRecallModelFallbackPolicy,\n ActiveRecallPromptStyle,\n ActiveRecallQueryMode,\n ActiveRecallThinking,\n} from \"./types.js\";\n\nexport interface ActiveRecallTurn {\n role: \"user\" | \"assistant\";\n content: string;\n}\n\nexport interface ActiveRecallInput {\n sessionKey: string;\n agentId: string;\n chatType: ActiveRecallChatType;\n recentTurns: ActiveRecallTurn[];\n currentMessage: string;\n}\n\nexport interface ActiveRecallConfig {\n enabled: boolean;\n agents: string[] | null;\n allowedChatTypes: ActiveRecallChatType[];\n queryMode: ActiveRecallQueryMode;\n promptStyle: ActiveRecallPromptStyle;\n customInstruction: string | null;\n promptReplacement: string | null;\n promptAppend: string | null;\n maxSummaryChars: number;\n recentUserTurns: number;\n recentAssistantTurns: number;\n recentUserChars: number;\n recentAssistantChars: number;\n thinking: ActiveRecallThinking;\n timeoutMs: number;\n cacheTtlMs: number;\n persistTranscripts: boolean;\n transcriptDir: string;\n entityGraphDepth: number;\n includeCausalTrajectories: boolean;\n includeDaySummary: boolean;\n attachRecallExplain: boolean;\n modelOverride: string | null;\n modelFallbackPolicy: ActiveRecallModelFallbackPolicy;\n}\n\nexport interface ActiveRecallResult {\n summary: string | null;\n citations: Array<{ memoryId: string; relevance: number }>;\n latencyMs: number;\n cacheHit: boolean;\n modelUsed: string;\n transcriptPath: string | null;\n}\n\nexport interface ActiveRecallDependencies {\n recall(query: string, sessionKey: string): Promise<string | null>;\n getLastRecallSnapshot?(sessionKey: string): { memoryIds?: string[] } | null;\n walkEntityGraph?(params: {\n sessionKey: string;\n query: string;\n depth: number;\n }): Promise<string[]>;\n loadCausalTrajectories?(params: {\n sessionKey: string;\n query: string;\n }): Promise<string[]>;\n loadDaySummary?(sessionKey: string): Promise<string | null>;\n explainLastRecall?(sessionKey: string): Promise<string | null>;\n generateSummary?(params: {\n prompt: string;\n sessionKey: string;\n agentId: string;\n model: string;\n timeoutMs: number;\n thinking: ActiveRecallThinking;\n fallbackPolicy: ActiveRecallModelFallbackPolicy;\n }): Promise<{ text: string | null; modelUsed?: string; cacheHit?: boolean }>;\n now?: () => number;\n}\n\ninterface CachedRecallResult {\n expiresAt: number;\n value: ActiveRecallResult;\n}\n\ninterface ActiveRecallTurnWithIndex {\n index: number;\n role: ActiveRecallTurn[\"role\"];\n content: string;\n}\n\nconst ACTIVE_RECALL_CACHE_MAX_ENTRIES = 256;\n\nconst NONE_SET = new Set([\n \"\",\n \"none\",\n \"no_reply\",\n \"nothing useful\",\n \"no relevant memory\",\n \"timeout\",\n \"[]\",\n \"{}\",\n \"null\",\n \"n/a\",\n]);\n\nconst STYLE_INSTRUCTIONS: Record<ActiveRecallPromptStyle, string> = {\n balanced: \"Summarize the most relevant memory context in a compact, neutral way.\",\n strict: \"Only include memory that is directly supported by the retrieved context.\",\n contextual: \"Prefer concise context that helps the next reply stay grounded in recent work.\",\n \"recall-heavy\": \"Bias toward richer recall coverage when multiple retrieved items reinforce each other.\",\n \"precision-heavy\": \"Bias toward precision. Omit anything uncertain or weakly supported.\",\n \"preference-only\": \"Only surface user preference or operating-style memory when present.\",\n};\n\nfunction cloneRecallResult(value: ActiveRecallResult): ActiveRecallResult {\n return {\n ...value,\n citations: [...value.citations],\n };\n}\n\nfunction buildCacheKey(input: ActiveRecallInput, config: ActiveRecallConfig, queryBundle: string): string {\n return JSON.stringify({\n sessionKey: input.sessionKey,\n agentId: input.agentId,\n queryMode: config.queryMode,\n promptStyle: config.promptStyle,\n customInstruction: config.customInstruction,\n promptReplacement: config.promptReplacement,\n promptAppend: config.promptAppend,\n maxSummaryChars: config.maxSummaryChars,\n entityGraphDepth: config.entityGraphDepth,\n includeCausalTrajectories: config.includeCausalTrajectories,\n includeDaySummary: config.includeDaySummary,\n attachRecallExplain: config.attachRecallExplain,\n modelOverride: config.modelOverride,\n modelFallbackPolicy: config.modelFallbackPolicy,\n thinking: config.thinking,\n queryBundle,\n });\n}\n\nfunction pruneExpiredCache(\n cache: Map<string, CachedRecallResult>,\n currentTime: number,\n): void {\n for (const [key, entry] of cache.entries()) {\n if (entry.expiresAt <= currentTime) {\n cache.delete(key);\n }\n }\n}\n\nfunction enforceCacheLimit(cache: Map<string, CachedRecallResult>): void {\n while (cache.size > ACTIVE_RECALL_CACHE_MAX_ENTRIES) {\n const oldestKey = cache.keys().next().value;\n if (typeof oldestKey !== \"string\") {\n break;\n }\n cache.delete(oldestKey);\n }\n}\n\nfunction cropTurns(\n turns: ActiveRecallTurn[],\n role: \"user\" | \"assistant\",\n maxTurns: number,\n maxChars: number,\n): ActiveRecallTurnWithIndex[] {\n if (maxTurns <= 0) {\n return [];\n }\n\n const selected: ActiveRecallTurnWithIndex[] = [];\n for (let index = turns.length - 1; index >= 0 && selected.length < maxTurns; index -= 1) {\n const turn = turns[index];\n if (turn?.role === role) {\n selected.push({\n index,\n role: turn.role,\n content: collapseWhitespace(truncateCodePointSafe(turn.content, maxChars)),\n });\n }\n }\n\n return selected.reverse();\n}\n\nfunction mergeChronologicalTurns(\n userTurns: ActiveRecallTurnWithIndex[],\n assistantTurns: ActiveRecallTurnWithIndex[],\n): ActiveRecallTurnWithIndex[] {\n return [...userTurns, ...assistantTurns]\n .sort((left, right) => left.index - right.index)\n .filter((value) => value.content.length > 0);\n}\n\nexport function buildActiveRecallQueryBundle(\n input: ActiveRecallInput,\n config: ActiveRecallConfig,\n): string {\n if (config.queryMode === \"message\") {\n return collapseWhitespace(input.currentMessage);\n }\n\n const userTurns = cropTurns(\n input.recentTurns,\n \"user\",\n config.recentUserTurns,\n config.recentUserChars,\n );\n const assistantTurns = cropTurns(\n input.recentTurns,\n \"assistant\",\n config.recentAssistantTurns,\n config.recentAssistantChars,\n );\n const mergedTurns = mergeChronologicalTurns(userTurns, assistantTurns);\n\n const parts = [\n ...mergedTurns.map((turn) => `${turn.role}: ${turn.content}`),\n ];\n\n if (config.queryMode === \"full\") {\n return [...parts, `current: ${collapseWhitespace(input.currentMessage)}`]\n .filter((value) => value.trim().length > 0)\n .join(\"\\n\");\n }\n\n return [`current: ${collapseWhitespace(input.currentMessage)}`, ...parts]\n .filter((value) => value.trim().length > 0)\n .join(\"\\n\");\n}\n\nexport function normalizeActiveRecallSummary(value: string | null, maxChars: number): string | null {\n if (value == null) return null;\n const compact = collapseWhitespace(value);\n if (NONE_SET.has(compact.toLowerCase())) return null;\n return truncateCodePointSafe(compact, maxChars);\n}\n\nfunction sanitizeTranscriptPathSegment(value: string): string {\n const normalized = collapseWhitespace(value);\n return encodeURIComponent(normalized.length > 0 ? normalized : \"unknown\").replaceAll(\n \".\",\n \"%2E\",\n );\n}\n\nexport function buildActiveRecallPrompt(params: {\n config: ActiveRecallConfig;\n queryBundle: string;\n recallContext: string | null;\n graphContext: string[];\n causalContext: string[];\n daySummary: string | null;\n recallExplain: string | null;\n}): string {\n const promptReplacement = params.config.promptReplacement?.trim();\n if (promptReplacement) {\n return promptReplacement;\n }\n\n const sections = [\n params.config.customInstruction?.trim() || STYLE_INSTRUCTIONS[params.config.promptStyle],\n `Query bundle:\\n${params.queryBundle}`,\n params.recallContext ? `Retrieved memory:\\n${params.recallContext}` : null,\n params.graphContext.length > 0 ? `Entity graph:\\n${params.graphContext.join(\"\\n\")}` : null,\n params.causalContext.length > 0 ? `Causal trajectories:\\n${params.causalContext.join(\"\\n\")}` : null,\n params.daySummary ? `Day summary:\\n${params.daySummary}` : null,\n params.recallExplain ? `Recall explain:\\n${params.recallExplain}` : null,\n params.config.promptAppend?.trim() || null,\n \"Return either NONE or a compact summary grounded only in the supplied context.\",\n ];\n return sections.filter((value): value is string => !!value && value.trim().length > 0).join(\"\\n\\n\");\n}\n\nasync function appendActiveRecallTranscript(\n transcriptRoot: string,\n input: ActiveRecallInput,\n config: ActiveRecallConfig,\n result: ActiveRecallResult,\n queryBundle: string,\n): Promise<string> {\n const date = new Date().toISOString().slice(0, 10);\n const filePath = path.join(\n transcriptRoot,\n \"agents\",\n sanitizeTranscriptPathSegment(input.agentId),\n date,\n `${sanitizeTranscriptPathSegment(input.sessionKey)}.jsonl`,\n );\n await mkdir(path.dirname(filePath), { recursive: true });\n await appendFile(\n filePath,\n `${JSON.stringify({\n ts: new Date().toISOString(),\n sessionKey: input.sessionKey,\n agentId: input.agentId,\n queryMode: config.queryMode,\n promptStyle: config.promptStyle,\n queryBundle,\n summary: result.summary,\n citations: result.citations,\n latencyMs: result.latencyMs,\n cacheHit: result.cacheHit,\n modelUsed: result.modelUsed,\n })}\\n`,\n \"utf8\",\n );\n return filePath;\n}\n\nexport function createActiveRecallEngine(\n deps: ActiveRecallDependencies,\n config: ActiveRecallConfig,\n) {\n const cache = new Map<string, CachedRecallResult>();\n const now = deps.now ?? (() => Date.now());\n\n return {\n async run(input: ActiveRecallInput): Promise<ActiveRecallResult> {\n if (!config.enabled) {\n return {\n summary: null,\n citations: [],\n latencyMs: 0,\n cacheHit: false,\n modelUsed: config.modelOverride ?? \"disabled\",\n transcriptPath: null,\n };\n }\n if (config.agents && !config.agents.includes(input.agentId)) {\n return {\n summary: null,\n citations: [],\n latencyMs: 0,\n cacheHit: false,\n modelUsed: config.modelOverride ?? \"filtered\",\n transcriptPath: null,\n };\n }\n if (!config.allowedChatTypes.includes(input.chatType)) {\n return {\n summary: null,\n citations: [],\n latencyMs: 0,\n cacheHit: false,\n modelUsed: config.modelOverride ?? \"filtered\",\n transcriptPath: null,\n };\n }\n\n const queryBundle = buildActiveRecallQueryBundle(input, config);\n const cacheKey = buildCacheKey(input, config, queryBundle);\n const currentTime = now();\n const cacheEnabled = config.cacheTtlMs > 0;\n if (cacheEnabled) {\n pruneExpiredCache(cache, currentTime);\n }\n const cached = cache.get(cacheKey);\n if (cacheEnabled && cached) {\n const result: ActiveRecallResult = {\n ...cloneRecallResult(cached.value),\n latencyMs: Math.max(0, now() - currentTime),\n cacheHit: true,\n };\n result.transcriptPath = null;\n if (config.persistTranscripts) {\n try {\n result.transcriptPath = await appendActiveRecallTranscript(\n config.transcriptDir,\n input,\n config,\n result,\n queryBundle,\n );\n } catch {\n result.transcriptPath = null;\n }\n }\n return result;\n }\n\n const start = currentTime;\n const recallContext = await deps.recall(queryBundle, input.sessionKey);\n const graphContext =\n config.entityGraphDepth > 0 && deps.walkEntityGraph\n ? await deps.walkEntityGraph({\n sessionKey: input.sessionKey,\n query: queryBundle,\n depth: config.entityGraphDepth,\n })\n : [];\n const causalContext =\n config.includeCausalTrajectories && deps.loadCausalTrajectories\n ? await deps.loadCausalTrajectories({\n sessionKey: input.sessionKey,\n query: queryBundle,\n })\n : [];\n const daySummary =\n config.includeDaySummary && deps.loadDaySummary\n ? await deps.loadDaySummary(input.sessionKey)\n : null;\n const recallExplain =\n config.attachRecallExplain && deps.explainLastRecall\n ? await deps.explainLastRecall(input.sessionKey)\n : null;\n const prompt = buildActiveRecallPrompt({\n config,\n queryBundle,\n recallContext,\n graphContext,\n causalContext,\n daySummary,\n recallExplain,\n });\n\n const generated = deps.generateSummary\n ? await deps.generateSummary({\n prompt,\n sessionKey: input.sessionKey,\n agentId: input.agentId,\n model: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n timeoutMs: config.timeoutMs,\n thinking: config.thinking,\n fallbackPolicy: config.modelFallbackPolicy,\n })\n : {\n text: recallContext,\n modelUsed: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n cacheHit: false,\n };\n const summary = normalizeActiveRecallSummary(\n generated.text,\n config.maxSummaryChars,\n );\n const snapshot = deps.getLastRecallSnapshot?.(input.sessionKey);\n const citations = (snapshot?.memoryIds ?? []).map((memoryId, index) => ({\n memoryId,\n relevance: Number((1 / (index + 1)).toFixed(3)),\n }));\n const result: ActiveRecallResult = {\n summary,\n citations,\n latencyMs: Math.max(0, now() - start),\n cacheHit: generated.cacheHit === true,\n modelUsed: generated.modelUsed ?? config.modelOverride ?? DEFAULT_REASONING_MODEL,\n transcriptPath: null,\n };\n if (config.persistTranscripts) {\n try {\n result.transcriptPath = await appendActiveRecallTranscript(\n config.transcriptDir,\n input,\n config,\n result,\n queryBundle,\n );\n } catch {\n result.transcriptPath = null;\n }\n }\n\n if (cacheEnabled) {\n const completedAt = now();\n const cachedValue = cloneRecallResult(result);\n cachedValue.transcriptPath = null;\n cache.set(cacheKey, {\n expiresAt: completedAt + config.cacheTtlMs,\n value: cachedValue,\n });\n enforceCacheLimit(cache);\n }\n return result;\n },\n };\n}\n"],"mappings":"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","names":["result"]}
1
+ {"version":3,"sources":["../src/active-recall.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { DEFAULT_REASONING_MODEL } from \"./config.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\nimport type {\n ActiveRecallChatType,\n ActiveRecallModelFallbackPolicy,\n ActiveRecallPromptStyle,\n ActiveRecallQueryMode,\n ActiveRecallThinking,\n} from \"./types.js\";\n\nexport interface ActiveRecallTurn {\n role: \"user\" | \"assistant\";\n content: string;\n}\n\nexport interface ActiveRecallInput {\n sessionKey: string;\n agentId: string;\n chatType: ActiveRecallChatType;\n recentTurns: ActiveRecallTurn[];\n currentMessage: string;\n}\n\nexport interface ActiveRecallConfig {\n enabled: boolean;\n agents: string[] | null;\n allowedChatTypes: ActiveRecallChatType[];\n queryMode: ActiveRecallQueryMode;\n promptStyle: ActiveRecallPromptStyle;\n customInstruction: string | null;\n promptReplacement: string | null;\n promptAppend: string | null;\n maxSummaryChars: number;\n recentUserTurns: number;\n recentAssistantTurns: number;\n recentUserChars: number;\n recentAssistantChars: number;\n thinking: ActiveRecallThinking;\n timeoutMs: number;\n cacheTtlMs: number;\n persistTranscripts: boolean;\n transcriptDir: string;\n entityGraphDepth: number;\n includeCausalTrajectories: boolean;\n includeDaySummary: boolean;\n attachRecallExplain: boolean;\n modelOverride: string | null;\n modelFallbackPolicy: ActiveRecallModelFallbackPolicy;\n}\n\nexport interface ActiveRecallResult {\n summary: string | null;\n citations: Array<{ memoryId: string; relevance: number }>;\n latencyMs: number;\n cacheHit: boolean;\n modelUsed: string;\n transcriptPath: string | null;\n}\n\nexport interface ActiveRecallDependencies {\n recall(query: string, sessionKey: string): Promise<string | null>;\n getLastRecallSnapshot?(sessionKey: string): { memoryIds?: string[] } | null;\n walkEntityGraph?(params: {\n sessionKey: string;\n query: string;\n depth: number;\n }): Promise<string[]>;\n loadCausalTrajectories?(params: {\n sessionKey: string;\n query: string;\n }): Promise<string[]>;\n loadDaySummary?(sessionKey: string): Promise<string | null>;\n explainLastRecall?(sessionKey: string): Promise<string | null>;\n generateSummary?(params: {\n prompt: string;\n sessionKey: string;\n agentId: string;\n model: string;\n timeoutMs: number;\n thinking: ActiveRecallThinking;\n fallbackPolicy: ActiveRecallModelFallbackPolicy;\n }): Promise<{ text: string | null; modelUsed?: string; cacheHit?: boolean }>;\n now?: () => number;\n}\n\ninterface CachedRecallResult {\n expiresAt: number;\n value: ActiveRecallResult;\n}\n\ninterface ActiveRecallTurnWithIndex {\n index: number;\n role: ActiveRecallTurn[\"role\"];\n content: string;\n}\n\nconst ACTIVE_RECALL_CACHE_MAX_ENTRIES = 256;\n\nconst NONE_SET = new Set([\n \"\",\n \"none\",\n \"no_reply\",\n \"nothing useful\",\n \"no relevant memory\",\n \"timeout\",\n \"[]\",\n \"{}\",\n \"null\",\n \"n/a\",\n]);\n\nconst STYLE_INSTRUCTIONS: Record<ActiveRecallPromptStyle, string> = {\n balanced: \"Summarize the most relevant memory context in a compact, neutral way.\",\n strict: \"Only include memory that is directly supported by the retrieved context.\",\n contextual: \"Prefer concise context that helps the next reply stay grounded in recent work.\",\n \"recall-heavy\": \"Bias toward richer recall coverage when multiple retrieved items reinforce each other.\",\n \"precision-heavy\": \"Bias toward precision. Omit anything uncertain or weakly supported.\",\n \"preference-only\": \"Only surface user preference or operating-style memory when present.\",\n};\n\nfunction cloneRecallResult(value: ActiveRecallResult): ActiveRecallResult {\n return {\n ...value,\n citations: [...value.citations],\n };\n}\n\nfunction buildCacheKey(input: ActiveRecallInput, config: ActiveRecallConfig, queryBundle: string): string {\n return JSON.stringify({\n sessionKey: input.sessionKey,\n agentId: input.agentId,\n queryMode: config.queryMode,\n promptStyle: config.promptStyle,\n customInstruction: config.customInstruction,\n promptReplacement: config.promptReplacement,\n promptAppend: config.promptAppend,\n maxSummaryChars: config.maxSummaryChars,\n entityGraphDepth: config.entityGraphDepth,\n includeCausalTrajectories: config.includeCausalTrajectories,\n includeDaySummary: config.includeDaySummary,\n attachRecallExplain: config.attachRecallExplain,\n modelOverride: config.modelOverride,\n modelFallbackPolicy: config.modelFallbackPolicy,\n thinking: config.thinking,\n queryBundle,\n });\n}\n\nfunction pruneExpiredCache(\n cache: Map<string, CachedRecallResult>,\n currentTime: number,\n): void {\n for (const [key, entry] of cache.entries()) {\n if (entry.expiresAt <= currentTime) {\n cache.delete(key);\n }\n }\n}\n\nfunction enforceCacheLimit(cache: Map<string, CachedRecallResult>): void {\n while (cache.size > ACTIVE_RECALL_CACHE_MAX_ENTRIES) {\n const oldestKey = cache.keys().next().value;\n if (typeof oldestKey !== \"string\") {\n break;\n }\n cache.delete(oldestKey);\n }\n}\n\nfunction cropTurns(\n turns: ActiveRecallTurn[],\n role: \"user\" | \"assistant\",\n maxTurns: number,\n maxChars: number,\n): ActiveRecallTurnWithIndex[] {\n if (maxTurns <= 0) {\n return [];\n }\n\n const selected: ActiveRecallTurnWithIndex[] = [];\n for (let index = turns.length - 1; index >= 0 && selected.length < maxTurns; index -= 1) {\n const turn = turns[index];\n if (turn?.role === role) {\n selected.push({\n index,\n role: turn.role,\n content: collapseWhitespace(truncateCodePointSafe(turn.content, maxChars)),\n });\n }\n }\n\n return selected.reverse();\n}\n\nfunction mergeChronologicalTurns(\n userTurns: ActiveRecallTurnWithIndex[],\n assistantTurns: ActiveRecallTurnWithIndex[],\n): ActiveRecallTurnWithIndex[] {\n return [...userTurns, ...assistantTurns]\n .sort((left, right) => left.index - right.index)\n .filter((value) => value.content.length > 0);\n}\n\nexport function buildActiveRecallQueryBundle(\n input: ActiveRecallInput,\n config: ActiveRecallConfig,\n): string {\n if (config.queryMode === \"message\") {\n return collapseWhitespace(input.currentMessage);\n }\n\n const userTurns = cropTurns(\n input.recentTurns,\n \"user\",\n config.recentUserTurns,\n config.recentUserChars,\n );\n const assistantTurns = cropTurns(\n input.recentTurns,\n \"assistant\",\n config.recentAssistantTurns,\n config.recentAssistantChars,\n );\n const mergedTurns = mergeChronologicalTurns(userTurns, assistantTurns);\n\n const parts = [\n ...mergedTurns.map((turn) => `${turn.role}: ${turn.content}`),\n ];\n\n if (config.queryMode === \"full\") {\n return [...parts, `current: ${collapseWhitespace(input.currentMessage)}`]\n .filter((value) => value.trim().length > 0)\n .join(\"\\n\");\n }\n\n return [`current: ${collapseWhitespace(input.currentMessage)}`, ...parts]\n .filter((value) => value.trim().length > 0)\n .join(\"\\n\");\n}\n\nexport function normalizeActiveRecallSummary(value: string | null, maxChars: number): string | null {\n if (value == null) return null;\n const compact = collapseWhitespace(value);\n if (NONE_SET.has(compact.toLowerCase())) return null;\n return truncateCodePointSafe(compact, maxChars);\n}\n\nfunction sanitizeTranscriptPathSegment(value: string): string {\n const normalized = collapseWhitespace(value);\n return encodeURIComponent(normalized.length > 0 ? normalized : \"unknown\").replaceAll(\n \".\",\n \"%2E\",\n );\n}\n\nexport function buildActiveRecallPrompt(params: {\n config: ActiveRecallConfig;\n queryBundle: string;\n recallContext: string | null;\n graphContext: string[];\n causalContext: string[];\n daySummary: string | null;\n recallExplain: string | null;\n}): string {\n const promptReplacement = params.config.promptReplacement?.trim();\n if (promptReplacement) {\n return promptReplacement;\n }\n\n const sections = [\n params.config.customInstruction?.trim() || STYLE_INSTRUCTIONS[params.config.promptStyle],\n `Query bundle:\\n${params.queryBundle}`,\n params.recallContext ? `Retrieved memory:\\n${params.recallContext}` : null,\n params.graphContext.length > 0 ? `Entity graph:\\n${params.graphContext.join(\"\\n\")}` : null,\n params.causalContext.length > 0 ? `Causal trajectories:\\n${params.causalContext.join(\"\\n\")}` : null,\n params.daySummary ? `Day summary:\\n${params.daySummary}` : null,\n params.recallExplain ? `Recall explain:\\n${params.recallExplain}` : null,\n params.config.promptAppend?.trim() || null,\n \"Return either NONE or a compact summary grounded only in the supplied context.\",\n ];\n return sections.filter((value): value is string => !!value && value.trim().length > 0).join(\"\\n\\n\");\n}\n\nasync function appendActiveRecallTranscript(\n transcriptRoot: string,\n input: ActiveRecallInput,\n config: ActiveRecallConfig,\n result: ActiveRecallResult,\n queryBundle: string,\n): Promise<string> {\n const date = new Date().toISOString().slice(0, 10);\n const filePath = path.join(\n transcriptRoot,\n \"agents\",\n sanitizeTranscriptPathSegment(input.agentId),\n date,\n `${sanitizeTranscriptPathSegment(input.sessionKey)}.jsonl`,\n );\n await mkdir(path.dirname(filePath), { recursive: true });\n await appendFile(\n filePath,\n `${JSON.stringify({\n ts: new Date().toISOString(),\n sessionKey: input.sessionKey,\n agentId: input.agentId,\n queryMode: config.queryMode,\n promptStyle: config.promptStyle,\n queryBundle,\n summary: result.summary,\n citations: result.citations,\n latencyMs: result.latencyMs,\n cacheHit: result.cacheHit,\n modelUsed: result.modelUsed,\n })}\\n`,\n \"utf8\",\n );\n return filePath;\n}\n\nexport function createActiveRecallEngine(\n deps: ActiveRecallDependencies,\n config: ActiveRecallConfig,\n) {\n const cache = new Map<string, CachedRecallResult>();\n const now = deps.now ?? (() => Date.now());\n\n return {\n async run(input: ActiveRecallInput): Promise<ActiveRecallResult> {\n if (!config.enabled) {\n return {\n summary: null,\n citations: [],\n latencyMs: 0,\n cacheHit: false,\n modelUsed: config.modelOverride ?? \"disabled\",\n transcriptPath: null,\n };\n }\n if (config.agents && !config.agents.includes(input.agentId)) {\n return {\n summary: null,\n citations: [],\n latencyMs: 0,\n cacheHit: false,\n modelUsed: config.modelOverride ?? \"filtered\",\n transcriptPath: null,\n };\n }\n if (!config.allowedChatTypes.includes(input.chatType)) {\n return {\n summary: null,\n citations: [],\n latencyMs: 0,\n cacheHit: false,\n modelUsed: config.modelOverride ?? \"filtered\",\n transcriptPath: null,\n };\n }\n\n const queryBundle = buildActiveRecallQueryBundle(input, config);\n const cacheKey = buildCacheKey(input, config, queryBundle);\n const currentTime = now();\n const cacheEnabled = config.cacheTtlMs > 0;\n if (cacheEnabled) {\n pruneExpiredCache(cache, currentTime);\n }\n const cached = cache.get(cacheKey);\n if (cacheEnabled && cached) {\n const result: ActiveRecallResult = {\n ...cloneRecallResult(cached.value),\n latencyMs: Math.max(0, now() - currentTime),\n cacheHit: true,\n };\n result.transcriptPath = null;\n if (config.persistTranscripts) {\n try {\n result.transcriptPath = await appendActiveRecallTranscript(\n config.transcriptDir,\n input,\n config,\n result,\n queryBundle,\n );\n } catch {\n result.transcriptPath = null;\n }\n }\n return result;\n }\n\n const start = currentTime;\n const recallContext = await deps.recall(queryBundle, input.sessionKey);\n const graphContext =\n config.entityGraphDepth > 0 && deps.walkEntityGraph\n ? await deps.walkEntityGraph({\n sessionKey: input.sessionKey,\n query: queryBundle,\n depth: config.entityGraphDepth,\n })\n : [];\n const causalContext =\n config.includeCausalTrajectories && deps.loadCausalTrajectories\n ? await deps.loadCausalTrajectories({\n sessionKey: input.sessionKey,\n query: queryBundle,\n })\n : [];\n const daySummary =\n config.includeDaySummary && deps.loadDaySummary\n ? await deps.loadDaySummary(input.sessionKey)\n : null;\n const recallExplain =\n config.attachRecallExplain && deps.explainLastRecall\n ? await deps.explainLastRecall(input.sessionKey)\n : null;\n const prompt = buildActiveRecallPrompt({\n config,\n queryBundle,\n recallContext,\n graphContext,\n causalContext,\n daySummary,\n recallExplain,\n });\n\n const generated = deps.generateSummary\n ? await deps.generateSummary({\n prompt,\n sessionKey: input.sessionKey,\n agentId: input.agentId,\n model: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n timeoutMs: config.timeoutMs,\n thinking: config.thinking,\n fallbackPolicy: config.modelFallbackPolicy,\n })\n : {\n text: recallContext,\n modelUsed: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n cacheHit: false,\n };\n const summary = normalizeActiveRecallSummary(\n generated.text,\n config.maxSummaryChars,\n );\n const snapshot = deps.getLastRecallSnapshot?.(input.sessionKey);\n const citations = (snapshot?.memoryIds ?? []).map((memoryId, index) => ({\n memoryId,\n relevance: Number((1 / (index + 1)).toFixed(3)),\n }));\n const result: ActiveRecallResult = {\n summary,\n citations,\n latencyMs: Math.max(0, now() - start),\n cacheHit: generated.cacheHit === true,\n modelUsed: generated.modelUsed ?? config.modelOverride ?? DEFAULT_REASONING_MODEL,\n transcriptPath: null,\n };\n if (config.persistTranscripts) {\n try {\n result.transcriptPath = await appendActiveRecallTranscript(\n config.transcriptDir,\n input,\n config,\n result,\n queryBundle,\n );\n } catch {\n result.transcriptPath = null;\n }\n }\n\n if (cacheEnabled) {\n const completedAt = now();\n const cachedValue = cloneRecallResult(result);\n cachedValue.transcriptPath = null;\n cache.set(cacheKey, {\n expiresAt: completedAt + config.cacheTtlMs,\n value: cachedValue,\n });\n enforceCacheLimit(cache);\n }\n return result;\n },\n };\n}\n"],"mappings":"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","names":["result"]}
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  dateInTimezone,
3
3
  defaultTimezone
4
- } from "./chunk-7CXL25AA.js";
4
+ } from "./chunk-W4RLOZOG.js";
5
5
  import "./chunk-UCJINCZT.js";
6
6
  import "./chunk-UOBPK2OS.js";
7
7
  import "./chunk-CIO7GCWE.js";
@@ -21,22 +21,23 @@ import "./chunk-EP6BA7VV.js";
21
21
  import "./chunk-E2AWJ7KQ.js";
22
22
  import "./chunk-YCVB7X56.js";
23
23
  import "./chunk-YBA52OKG.js";
24
- import "./chunk-CLCMDKTB.js";
24
+ import "./chunk-3I3U6FFT.js";
25
25
  import "./chunk-353C5UNV.js";
26
- import "./chunk-5AYUHSAU.js";
26
+ import "./chunk-OFCHT2TN.js";
27
27
  import "./chunk-BT7NVCML.js";
28
- import "./chunk-PO7NXNGC.js";
28
+ import "./chunk-VFTK5WKI.js";
29
29
  import "./chunk-RL6NEVXT.js";
30
30
  import "./chunk-C7HJ3NEI.js";
31
- import "./chunk-N4PYB235.js";
31
+ import "./chunk-KI6UOSNR.js";
32
32
  import "./chunk-BTNNL7ZW.js";
33
33
  import "./chunk-5FVVY2EB.js";
34
34
  import "./chunk-JDSVLVCG.js";
35
35
  import "./chunk-5GKPFL3S.js";
36
36
  import "./chunk-JAKIDQB2.js";
37
- import "./chunk-FFAZ2XFU.js";
37
+ import "./chunk-EHRE7ZG3.js";
38
38
  import "./chunk-P7FMDTKL.js";
39
39
  import "./chunk-2EMROIXS.js";
40
+ import "./chunk-7LEQREP2.js";
40
41
  import "./chunk-ZEFVK7XC.js";
41
42
  import "./chunk-6KH5NLQS.js";
42
43
  import "./chunk-P2QRMMVQ.js";
@@ -97,4 +98,4 @@ function startWearablesAutoSync(settings, deps) {
97
98
  export {
98
99
  startWearablesAutoSync
99
100
  };
100
- //# sourceMappingURL=auto-sync-FN7E3OTO.js.map
101
+ //# sourceMappingURL=auto-sync-WSJAOLOP.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/wearables/auto-sync.ts"],"sourcesContent":["/**\n * Wearables auto-sync — in-process periodic transcript refresh.\n *\n * Every tick re-syncs a short rolling window ending today for ALL\n * enabled sources, so the current day's transcript keeps growing while\n * the wearable records and provider-side revisions of recent days flow\n * in without operator action. Once per local day the window deepens to\n * `autoSyncDeepDays` to pick up late uploads and provider reprocessing\n * further back (phones syncing hours later, re-diarized transcripts).\n *\n * Day fetches are unconditional within the window — existing day files\n * are always re-fetched and re-composed; the content-hash skip in the\n * pipeline keeps unchanged days write-free, so a tick on a quiet day\n * is read-only. The timer is unref'd: it never keeps a one-shot CLI\n * process alive, and long-lived hosts stop it via the returned handle.\n */\n\nimport { describeErrorForOperator } from \"./errors.js\";\nimport { dateInTimezone, defaultTimezone } from \"./pipeline.js\";\n\nexport interface WearablesAutoSyncSettings {\n /** Minutes between ticks. */\n intervalMinutes: number;\n /** Rolling window (days ending today) refreshed on a normal tick. */\n days: number;\n /**\n * Window for the once-per-local-day deep pass. 0 disables the deep\n * pass; otherwise must be >= `days` (validated at config parse).\n */\n deepDays: number;\n /** IANA timezone used to detect the local-day rollover. */\n timezone?: string;\n}\n\nexport interface WearablesAutoSyncDeps {\n /** Run a sync across all enabled sources (WearablesService.sync). */\n sync(options: { days: number; signal?: AbortSignal }): Promise<unknown>;\n log: { info(message: string): void; warn(message: string): void };\n /** Clock injection for tests. */\n now?: () => Date;\n}\n\nexport interface WearablesAutoSyncHandle {\n /** Run one scheduler tick now (first-run hook and test seam). */\n tick(): Promise<void>;\n /**\n * Stop the scheduler: clears the timer, aborts the in-flight sync's\n * provider fetches via AbortSignal, and resolves once the in-flight\n * tick has fully settled — after `await stop()` nothing is writing\n * or reindexing anymore. The handle is single-use; a restarted host\n * starts a fresh one.\n */\n stop(): Promise<void>;\n}\n\n/**\n * Start the periodic refresh. The first tick fires after one full\n * interval rather than at start — gateways on low-power hardware can\n * restart-loop during setup (issue #462), and an immediate fetch on\n * every restart would hammer provider APIs. Operators who want an\n * instant refresh run `wearables sync` (or call `tick()`).\n */\nexport function startWearablesAutoSync(\n settings: WearablesAutoSyncSettings,\n deps: WearablesAutoSyncDeps,\n): WearablesAutoSyncHandle {\n let inFlight: Promise<void> | null = null;\n let stopped = false;\n let lastDeepDate: string | null = null;\n // Aborting cancels the in-flight sync's provider fetches promptly on\n // shutdown — without it, a slow tick would keep writing/reindexing\n // after orchestrator.destroy() while a restarted host starts a\n // second scheduler (Kilo review on PR #1464).\n const abortController = new AbortController();\n\n const tick = async (): Promise<void> => {\n // Overlap guard: a slow provider or large deep window must never\n // stack a second sync on top of a running one. The skipped call\n // resolves immediately — it must NOT await the running tick, or a\n // caller holding both promises could deadlock itself.\n if (inFlight || stopped) return;\n const run = (async () => {\n try {\n const now = deps.now ? deps.now() : new Date();\n const today = dateInTimezone(now, settings.timezone ?? defaultTimezone());\n const deep = settings.deepDays > 0 && lastDeepDate !== today;\n const days = deep ? settings.deepDays : settings.days;\n await deps.sync({ days, signal: abortController.signal });\n // Mark the deep pass done only AFTER it succeeded — a failed\n // deep pass retries on the next tick instead of silently\n // waiting for tomorrow (CLAUDE.md rule 25's \"confirm before\n // consuming the one-shot\" shape).\n if (deep) lastDeepDate = today;\n deps.log.info(\n `wearables auto-sync: refreshed ${days}-day window${deep ? \" (daily deep pass)\" : \"\"}`,\n );\n } catch (err) {\n // An abort raised by stop() is intentional shutdown, not a\n // failure — warning about it would be noise in every clean\n // shutdown log.\n if (!stopped) {\n deps.log.warn(\n `wearables auto-sync failed: ${describeErrorForOperator(err)} — retrying on the next tick`,\n );\n }\n } finally {\n inFlight = null;\n }\n })();\n inFlight = run;\n await run;\n };\n\n const timer = setInterval(() => {\n void tick();\n }, settings.intervalMinutes * 60_000);\n timer.unref?.();\n\n return {\n tick,\n stop: async () => {\n stopped = true;\n clearInterval(timer);\n abortController.abort();\n // tick() never rejects (all paths caught), so this only waits.\n if (inFlight) await inFlight;\n },\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DO,SAAS,uBACd,UACA,MACyB;AACzB,MAAI,WAAiC;AACrC,MAAI,UAAU;AACd,MAAI,eAA8B;AAKlC,QAAM,kBAAkB,IAAI,gBAAgB;AAE5C,QAAM,OAAO,YAA2B;AAKtC,QAAI,YAAY,QAAS;AACzB,UAAM,OAAO,YAAY;AACvB,UAAI;AACF,cAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,oBAAI,KAAK;AAC7C,cAAM,QAAQ,eAAe,KAAK,SAAS,YAAY,gBAAgB,CAAC;AACxE,cAAM,OAAO,SAAS,WAAW,KAAK,iBAAiB;AACvD,cAAM,OAAO,OAAO,SAAS,WAAW,SAAS;AACjD,cAAM,KAAK,KAAK,EAAE,MAAM,QAAQ,gBAAgB,OAAO,CAAC;AAKxD,YAAI,KAAM,gBAAe;AACzB,aAAK,IAAI;AAAA,UACP,kCAAkC,IAAI,cAAc,OAAO,uBAAuB,EAAE;AAAA,QACtF;AAAA,MACF,SAAS,KAAK;AAIZ,YAAI,CAAC,SAAS;AACZ,eAAK,IAAI;AAAA,YACP,+BAA+B,yBAAyB,GAAG,CAAC;AAAA,UAC9D;AAAA,QACF;AAAA,MACF,UAAE;AACA,mBAAW;AAAA,MACb;AAAA,IACF,GAAG;AACH,eAAW;AACX,UAAM;AAAA,EACR;AAEA,QAAM,QAAQ,YAAY,MAAM;AAC9B,SAAK,KAAK;AAAA,EACZ,GAAG,SAAS,kBAAkB,GAAM;AACpC,QAAM,QAAQ;AAEd,SAAO;AAAA,IACL;AAAA,IACA,MAAM,YAAY;AAChB,gBAAU;AACV,oBAAc,KAAK;AACnB,sBAAgB,MAAM;AAEtB,UAAI,SAAU,OAAM;AAAA,IACtB;AAAA,EACF;AACF;","names":[]}
1
+ {"version":3,"sources":["../src/wearables/auto-sync.ts"],"sourcesContent":["/**\n * Wearables auto-sync — in-process periodic transcript refresh.\n *\n * Every tick re-syncs a short rolling window ending today for ALL\n * enabled sources, so the current day's transcript keeps growing while\n * the wearable records and provider-side revisions of recent days flow\n * in without operator action. Once per local day the window deepens to\n * `autoSyncDeepDays` to pick up late uploads and provider reprocessing\n * further back (phones syncing hours later, re-diarized transcripts).\n *\n * Day fetches are unconditional within the window — existing day files\n * are always re-fetched and re-composed; the content-hash skip in the\n * pipeline keeps unchanged days write-free, so a tick on a quiet day\n * is read-only. The timer is unref'd: it never keeps a one-shot CLI\n * process alive, and long-lived hosts stop it via the returned handle.\n */\n\nimport { describeErrorForOperator } from \"./errors.js\";\nimport { dateInTimezone, defaultTimezone } from \"./pipeline.js\";\n\nexport interface WearablesAutoSyncSettings {\n /** Minutes between ticks. */\n intervalMinutes: number;\n /** Rolling window (days ending today) refreshed on a normal tick. */\n days: number;\n /**\n * Window for the once-per-local-day deep pass. 0 disables the deep\n * pass; otherwise must be >= `days` (validated at config parse).\n */\n deepDays: number;\n /** IANA timezone used to detect the local-day rollover. */\n timezone?: string;\n}\n\nexport interface WearablesAutoSyncDeps {\n /** Run a sync across all enabled sources (WearablesService.sync). */\n sync(options: { days: number; signal?: AbortSignal }): Promise<unknown>;\n log: { info(message: string): void; warn(message: string): void };\n /** Clock injection for tests. */\n now?: () => Date;\n}\n\nexport interface WearablesAutoSyncHandle {\n /** Run one scheduler tick now (first-run hook and test seam). */\n tick(): Promise<void>;\n /**\n * Stop the scheduler: clears the timer, aborts the in-flight sync's\n * provider fetches via AbortSignal, and resolves once the in-flight\n * tick has fully settled — after `await stop()` nothing is writing\n * or reindexing anymore. The handle is single-use; a restarted host\n * starts a fresh one.\n */\n stop(): Promise<void>;\n}\n\n/**\n * Start the periodic refresh. The first tick fires after one full\n * interval rather than at start — gateways on low-power hardware can\n * restart-loop during setup (issue #462), and an immediate fetch on\n * every restart would hammer provider APIs. Operators who want an\n * instant refresh run `wearables sync` (or call `tick()`).\n */\nexport function startWearablesAutoSync(\n settings: WearablesAutoSyncSettings,\n deps: WearablesAutoSyncDeps,\n): WearablesAutoSyncHandle {\n let inFlight: Promise<void> | null = null;\n let stopped = false;\n let lastDeepDate: string | null = null;\n // Aborting cancels the in-flight sync's provider fetches promptly on\n // shutdown — without it, a slow tick would keep writing/reindexing\n // after orchestrator.destroy() while a restarted host starts a\n // second scheduler (Kilo review on PR #1464).\n const abortController = new AbortController();\n\n const tick = async (): Promise<void> => {\n // Overlap guard: a slow provider or large deep window must never\n // stack a second sync on top of a running one. The skipped call\n // resolves immediately — it must NOT await the running tick, or a\n // caller holding both promises could deadlock itself.\n if (inFlight || stopped) return;\n const run = (async () => {\n try {\n const now = deps.now ? deps.now() : new Date();\n const today = dateInTimezone(now, settings.timezone ?? defaultTimezone());\n const deep = settings.deepDays > 0 && lastDeepDate !== today;\n const days = deep ? settings.deepDays : settings.days;\n await deps.sync({ days, signal: abortController.signal });\n // Mark the deep pass done only AFTER it succeeded — a failed\n // deep pass retries on the next tick instead of silently\n // waiting for tomorrow (CLAUDE.md rule 25's \"confirm before\n // consuming the one-shot\" shape).\n if (deep) lastDeepDate = today;\n deps.log.info(\n `wearables auto-sync: refreshed ${days}-day window${deep ? \" (daily deep pass)\" : \"\"}`,\n );\n } catch (err) {\n // An abort raised by stop() is intentional shutdown, not a\n // failure — warning about it would be noise in every clean\n // shutdown log.\n if (!stopped) {\n deps.log.warn(\n `wearables auto-sync failed: ${describeErrorForOperator(err)} — retrying on the next tick`,\n );\n }\n } finally {\n inFlight = null;\n }\n })();\n inFlight = run;\n await run;\n };\n\n const timer = setInterval(() => {\n void tick();\n }, settings.intervalMinutes * 60_000);\n timer.unref?.();\n\n return {\n tick,\n stop: async () => {\n stopped = true;\n clearInterval(timer);\n abortController.abort();\n // tick() never rejects (all paths caught), so this only waits.\n if (inFlight) await inFlight;\n },\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DO,SAAS,uBACd,UACA,MACyB;AACzB,MAAI,WAAiC;AACrC,MAAI,UAAU;AACd,MAAI,eAA8B;AAKlC,QAAM,kBAAkB,IAAI,gBAAgB;AAE5C,QAAM,OAAO,YAA2B;AAKtC,QAAI,YAAY,QAAS;AACzB,UAAM,OAAO,YAAY;AACvB,UAAI;AACF,cAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,oBAAI,KAAK;AAC7C,cAAM,QAAQ,eAAe,KAAK,SAAS,YAAY,gBAAgB,CAAC;AACxE,cAAM,OAAO,SAAS,WAAW,KAAK,iBAAiB;AACvD,cAAM,OAAO,OAAO,SAAS,WAAW,SAAS;AACjD,cAAM,KAAK,KAAK,EAAE,MAAM,QAAQ,gBAAgB,OAAO,CAAC;AAKxD,YAAI,KAAM,gBAAe;AACzB,aAAK,IAAI;AAAA,UACP,kCAAkC,IAAI,cAAc,OAAO,uBAAuB,EAAE;AAAA,QACtF;AAAA,MACF,SAAS,KAAK;AAIZ,YAAI,CAAC,SAAS;AACZ,eAAK,IAAI;AAAA,YACP,+BAA+B,yBAAyB,GAAG,CAAC;AAAA,UAC9D;AAAA,QACF;AAAA,MACF,UAAE;AACA,mBAAW;AAAA,MACb;AAAA,IACF,GAAG;AACH,eAAW;AACX,UAAM;AAAA,EACR;AAEA,QAAM,QAAQ,YAAY,MAAM;AAC9B,SAAK,KAAK;AAAA,EACZ,GAAG,SAAS,kBAAkB,GAAM;AACpC,QAAM,QAAQ;AAEd,SAAO;AAAA,IACL;AAAA,IACA,MAAM,YAAY;AAChB,gBAAU;AACV,oBAAc,KAAK;AACnB,sBAAgB,MAAM;AAEtB,UAAI,SAAU,OAAM;AAAA,IACtB;AAAA,EACF;AACF;","names":[]}
package/dist/briefing.js CHANGED
@@ -18,15 +18,15 @@ import {
18
18
  renderBriefingMarkdown,
19
19
  resolveBriefingSaveDir,
20
20
  validateBriefingFormat
21
- } from "./chunk-GF4H3B3R.js";
21
+ } from "./chunk-BSWHZJSP.js";
22
22
  import "./chunk-GZFKCLRC.js";
23
23
  import "./chunk-6JMQR72P.js";
24
- import "./chunk-37HCPM56.js";
25
- import "./chunk-46WM6JX2.js";
24
+ import "./chunk-OX5LMCEQ.js";
25
+ import "./chunk-LZKOVXMX.js";
26
26
  import "./chunk-UHVXE24Y.js";
27
27
  import "./chunk-V4JZCTMK.js";
28
- import "./chunk-RSMIRLKM.js";
29
- import "./chunk-U6OXJQEH.js";
28
+ import "./chunk-YV54LYEB.js";
29
+ import "./chunk-J5QL66XK.js";
30
30
  import "./chunk-T3FMRLWQ.js";
31
31
  import "./chunk-7VO6E5UD.js";
32
32
  import "./chunk-5BUCKFRE.js";
@@ -48,7 +48,7 @@ import "./chunk-LDXUBPMO.js";
48
48
  import "./chunk-FF6N7BXC.js";
49
49
  import "./chunk-2DT7PIDZ.js";
50
50
  import "./chunk-AAD2ZS6P.js";
51
- import "./chunk-EIFYYHAF.js";
51
+ import "./chunk-YYO447A7.js";
52
52
  import "./chunk-ZIKENA2C.js";
53
53
  import "./chunk-3OUGSOJP.js";
54
54
  import "./chunk-SCU65EZI.js";
@@ -56,18 +56,18 @@ import "./chunk-3ONXXHQO.js";
56
56
  import "./chunk-YXZG5TVN.js";
57
57
  import "./chunk-3WU7XOFN.js";
58
58
  import "./chunk-6MKLMEBE.js";
59
- import "./chunk-W5XWHTDO.js";
59
+ import "./chunk-QZZPUREO.js";
60
60
  import "./chunk-M5GVCJSJ.js";
61
61
  import "./chunk-RBOJCG4T.js";
62
- import "./chunk-R7QY5ZVB.js";
62
+ import "./chunk-4NDWE44P.js";
63
63
  import "./chunk-5WITETWU.js";
64
64
  import "./chunk-6CIAGZ6X.js";
65
65
  import "./chunk-7CT3AI52.js";
66
66
  import "./chunk-G7D6GZ5J.js";
67
- import "./chunk-AJ6ORARY.js";
67
+ import "./chunk-JALYQUYO.js";
68
68
  import "./chunk-IUM3VSHI.js";
69
69
  import "./chunk-G26YNEOC.js";
70
- import "./chunk-IM2GO42H.js";
70
+ import "./chunk-WVHRNAXL.js";
71
71
  import "./chunk-TPSLVZHS.js";
72
72
  import "./chunk-SIGAGKNE.js";
73
73
  import "./chunk-23G5P7TA.js";
@@ -87,30 +87,31 @@ import "./chunk-PJKTFXE2.js";
87
87
  import "./chunk-W5BIQOAJ.js";
88
88
  import "./chunk-QWWMS4AE.js";
89
89
  import "./chunk-YBA52OKG.js";
90
- import "./chunk-5AYUHSAU.js";
90
+ import "./chunk-OFCHT2TN.js";
91
91
  import "./chunk-BT7NVCML.js";
92
- import "./chunk-PO7NXNGC.js";
92
+ import "./chunk-VFTK5WKI.js";
93
93
  import "./chunk-BJMBJZ2Y.js";
94
94
  import "./chunk-UKJAGEXH.js";
95
95
  import "./chunk-FP2373TW.js";
96
96
  import "./chunk-L272A5QW.js";
97
- import "./chunk-XVC7JU2N.js";
97
+ import "./chunk-FQD2KPQH.js";
98
98
  import "./chunk-ZA53AZND.js";
99
99
  import "./chunk-7RJUVTVF.js";
100
100
  import "./chunk-AL3UYZ5N.js";
101
101
  import "./chunk-RL6NEVXT.js";
102
102
  import "./chunk-PWPIERBM.js";
103
103
  import "./chunk-C7HJ3NEI.js";
104
- import "./chunk-N4PYB235.js";
104
+ import "./chunk-KI6UOSNR.js";
105
105
  import "./chunk-BTNNL7ZW.js";
106
106
  import "./chunk-5FVVY2EB.js";
107
107
  import "./chunk-JDSVLVCG.js";
108
108
  import "./chunk-5GKPFL3S.js";
109
109
  import "./chunk-JAKIDQB2.js";
110
- import "./chunk-FFAZ2XFU.js";
110
+ import "./chunk-EHRE7ZG3.js";
111
111
  import "./chunk-P7FMDTKL.js";
112
112
  import "./chunk-VUFL7X3H.js";
113
113
  import "./chunk-2EMROIXS.js";
114
+ import "./chunk-7LEQREP2.js";
114
115
  import "./chunk-ZEFVK7XC.js";
115
116
  import "./chunk-6KH5NLQS.js";
116
117
  import "./chunk-P2QRMMVQ.js";
package/dist/buffer.js CHANGED
@@ -1,43 +1,44 @@
1
1
  import {
2
2
  SmartBuffer
3
- } from "./chunk-I25RQA65.js";
3
+ } from "./chunk-M4MAVJJX.js";
4
4
  import "./chunk-T5IF2ZCE.js";
5
5
  import "./chunk-H3FZVNRN.js";
6
- import "./chunk-KE5PWLI6.js";
7
- import "./chunk-OGVJXIHX.js";
6
+ import "./chunk-T5XG6GQI.js";
7
+ import "./chunk-PXTZOU5F.js";
8
8
  import "./chunk-CSAKJVXW.js";
9
9
  import "./chunk-K2XUWZBM.js";
10
10
  import "./chunk-OD4FM2U7.js";
11
11
  import "./chunk-TBBDFYXW.js";
12
12
  import "./chunk-ZJP66Q4I.js";
13
- import "./chunk-AJ6ORARY.js";
13
+ import "./chunk-JALYQUYO.js";
14
14
  import "./chunk-IUM3VSHI.js";
15
15
  import "./chunk-G26YNEOC.js";
16
- import "./chunk-IM2GO42H.js";
16
+ import "./chunk-WVHRNAXL.js";
17
17
  import "./chunk-TPSLVZHS.js";
18
18
  import "./chunk-SIGAGKNE.js";
19
19
  import "./chunk-23G5P7TA.js";
20
20
  import "./chunk-C64XATK7.js";
21
21
  import "./chunk-42JKGUFJ.js";
22
- import "./chunk-CLCMDKTB.js";
22
+ import "./chunk-3I3U6FFT.js";
23
23
  import "./chunk-353C5UNV.js";
24
- import "./chunk-5AYUHSAU.js";
24
+ import "./chunk-OFCHT2TN.js";
25
25
  import "./chunk-BT7NVCML.js";
26
- import "./chunk-PO7NXNGC.js";
26
+ import "./chunk-VFTK5WKI.js";
27
27
  import "./chunk-E5H4TM4Y.js";
28
28
  import "./chunk-C7HJ3NEI.js";
29
- import "./chunk-N4PYB235.js";
29
+ import "./chunk-KI6UOSNR.js";
30
30
  import "./chunk-BTNNL7ZW.js";
31
31
  import "./chunk-5FVVY2EB.js";
32
32
  import "./chunk-JDSVLVCG.js";
33
33
  import "./chunk-5GKPFL3S.js";
34
34
  import "./chunk-JAKIDQB2.js";
35
- import "./chunk-FFAZ2XFU.js";
35
+ import "./chunk-EHRE7ZG3.js";
36
36
  import "./chunk-P7FMDTKL.js";
37
37
  import "./chunk-OEIA4IHU.js";
38
38
  import "./chunk-PCXDUHQH.js";
39
39
  import "./chunk-VUFL7X3H.js";
40
40
  import "./chunk-2EMROIXS.js";
41
+ import "./chunk-7LEQREP2.js";
41
42
  import "./chunk-3Q3N35W7.js";
42
43
  import "./chunk-ZEFVK7XC.js";
43
44
  import "./chunk-6KH5NLQS.js";
@@ -11,8 +11,7 @@
11
11
  * - Temporal difference learning (dopamine signals prediction error)
12
12
  * - Tesla FSD shadow mode (divergence between prediction and reality = training signal)
13
13
  */
14
- import { FallbackLlmClient } from "./fallback-llm.js";
15
- import type { AgentPersonaModelConfig, GatewayConfig } from "./types.js";
14
+ import type { AgentPersonaModelConfig, GatewayConfig, PluginConfig } from "./types.js";
16
15
  export interface CalibrationRule {
17
16
  id: string;
18
17
  ruleType: "model_tendency" | "user_expectation" | "scope_boundary" | "verification_required";
@@ -48,12 +47,38 @@ export interface CorrectionMemory {
48
47
  */
49
48
  export declare function readCalibrationCorrections(memoryDir: string): Promise<CorrectionMemory[]>;
50
49
  export declare const CLUSTER_PROMPT = "You are analyzing user corrections to an AI assistant. Each correction represents a moment where the assistant's prediction of what the user wanted was WRONG.\n\nYour job: Group these corrections into clusters where the SAME TYPE of misunderstanding is happening. Then for each cluster, synthesize a CalibrationRule.\n\nA CalibrationRule describes:\n- condition: When does this type of mistake happen?\n- modelTendency: What does the model tend to assume or do wrong?\n- userExpectation: What does the user actually want instead?\n- calibration: How should the model adjust its behavior?\n- ruleType: One of \"model_tendency\", \"user_expectation\", \"scope_boundary\", \"verification_required\"\n\nFocus on PATTERNS, not individual corrections. A cluster needs at least 2 corrections to be worth a rule.\nOutput language: write facts, profile updates, entity names and aliases, tags, questions, and any rewritten or merged memory content in the source language of the conversation or input memories. Never translate into English or another language unless the user explicitly asked for a translation.\n\nOutput valid JSON only:\n{\n \"rules\": [\n {\n \"ruleType\": \"model_tendency\",\n \"condition\": \"When discussing project scope or task boundaries\",\n \"modelTendency\": \"The model tends to assume broader scope than the user intends\",\n \"userExpectation\": \"The user prefers narrow, specific task definitions and wants to be asked before scope expansion\",\n \"calibration\": \"When uncertain about scope, ask for clarification rather than assuming. Default to the narrower interpretation.\",\n \"confidence\": 0.85,\n \"evidenceIds\": [\"correction-id-1\", \"correction-id-2\"]\n }\n ]\n}";
51
- export declare function synthesizeCalibrationRules(corrections: CorrectionMemory[], llm: FallbackLlmClient, existingRules: CalibrationRule[], agentId?: string, modelChain?: AgentPersonaModelConfig): Promise<CalibrationRule[]>;
50
+ interface CalibrationChatClient {
51
+ chatCompletion(messages: Array<{
52
+ role: "system" | "user" | "assistant";
53
+ content: string;
54
+ }>, options?: {
55
+ temperature?: number;
56
+ maxTokens?: number;
57
+ agentId?: string;
58
+ modelChain?: AgentPersonaModelConfig;
59
+ }): Promise<{
60
+ content?: string | null;
61
+ } | null>;
62
+ }
63
+ export declare function synthesizeCalibrationRules(corrections: CorrectionMemory[], llm: CalibrationChatClient, existingRules: CalibrationRule[], agentId?: string, modelChain?: AgentPersonaModelConfig): Promise<CalibrationRule[]>;
52
64
  /**
53
65
  * Build a recall section from calibration rules relevant to the current query.
54
66
  * Uses the LLM to select which rules apply to the current context.
55
67
  */
56
68
  export declare function buildCalibrationRecallSection(rules: CalibrationRule[], query: string, maxChars?: number): string | null;
69
+ /**
70
+ * Options weekly compounding passes into calibration. Gateway agent and task
71
+ * chain fields stay limited to `modelSource: "gateway"`. `pluginConfig` carries
72
+ * the `localLlm*` settings used when that chain is empty.
73
+ */
74
+ export declare function calibrationConsolidationInput(config: PluginConfig): {
75
+ memoryDir: string;
76
+ gatewayConfig?: GatewayConfig;
77
+ gatewayAgentId?: string;
78
+ modelChain?: AgentPersonaModelConfig;
79
+ workspaceDir?: string;
80
+ pluginConfig: PluginConfig;
81
+ };
57
82
  /**
58
83
  * Run the full calibration pipeline:
59
84
  * 1. Read all corrections
@@ -67,6 +92,7 @@ export declare function runCalibrationConsolidation(options: {
67
92
  gatewayAgentId?: string;
68
93
  modelChain?: AgentPersonaModelConfig;
69
94
  workspaceDir?: string;
95
+ pluginConfig?: PluginConfig;
70
96
  }): Promise<CalibrationRule[]>;
71
97
  /**
72
98
  * Standalone entry point for calibration consolidation that can be called
@@ -82,10 +108,12 @@ export declare function runCalibrationIfEnabled(options: {
82
108
  gatewayAgentId?: string;
83
109
  modelChain?: AgentPersonaModelConfig;
84
110
  workspaceDir?: string;
111
+ pluginConfig?: PluginConfig;
85
112
  }): Promise<CalibrationRule[]>;
86
113
  /**
87
114
  * Get calibration rules for recall injection.
88
115
  * Reads the pre-computed calibration index.
89
116
  */
90
117
  export declare function getCalibrationRulesForRecall(memoryDir: string): Promise<CalibrationRule[]>;
118
+ export {};
91
119
  //# sourceMappingURL=calibration.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"calibration.d.ts","sourceRoot":"","sources":["../src/calibration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AAQrF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;IAC7F,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAYD,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAWvF;AAWD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAyBD;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE/F;AA8ED,eAAO,MAAM,cAAc,stDA2BzB,CAAC;AAEH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,gBAAgB,EAAE,EAC/B,GAAG,EAAE,iBAAiB,EACtB,aAAa,EAAE,eAAe,EAAE,EAChC,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,uBAAuB,GACnC,OAAO,CAAC,eAAe,EAAE,CAAC,CAwE5B;AAID;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,eAAe,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAa,GACtB,MAAM,GAAG,IAAI,CAwBf;AAID;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAmD7B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAW7B;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAG5B"}
1
+ {"version":3,"file":"calibration.d.ts","sourceRoot":"","sources":["../src/calibration.ts"],"names":[],"mappings":"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"}
@@ -2,6 +2,13 @@ import {
2
2
  OUTPUT_LANGUAGE_POLICY
3
3
  } from "./chunk-JLIGUFPF.js";
4
4
  import "./chunk-QW27DOHG.js";
5
+ import {
6
+ LocalLlmClient
7
+ } from "./chunk-JXSYWTFK.js";
8
+ import "./chunk-QM2SPLKQ.js";
9
+ import "./chunk-U4LUIE6Y.js";
10
+ import "./chunk-JUXOTY6J.js";
11
+ import "./chunk-TOTT6S2V.js";
5
12
  import {
6
13
  FallbackLlmClient
7
14
  } from "./chunk-TKC5LZ43.js";
@@ -11,7 +18,9 @@ import "./chunk-45GF7Y3V.js";
11
18
  import "./chunk-EP6BA7VV.js";
12
19
  import "./chunk-E2AWJ7KQ.js";
13
20
  import "./chunk-YBA52OKG.js";
14
- import "./chunk-2EMROIXS.js";
21
+ import {
22
+ resolveLocalLlmCapabilities
23
+ } from "./chunk-2EMROIXS.js";
15
24
  import "./chunk-ZEFVK7XC.js";
16
25
  import "./chunk-6KH5NLQS.js";
17
26
  import "./chunk-P2QRMMVQ.js";
@@ -27,8 +36,8 @@ import "./chunk-PZ5AY32C.js";
27
36
 
28
37
  // src/calibration.ts
29
38
  import { createHash } from "crypto";
30
- import path from "path";
31
39
  import { mkdir, readFile, writeFile } from "fs/promises";
40
+ import path from "path";
32
41
  function calibrationDir(memoryDir) {
33
42
  return path.join(memoryDir, "state", "calibration");
34
43
  }
@@ -151,6 +160,29 @@ Output valid JSON only:
151
160
  }
152
161
  ]
153
162
  }`;
163
+ function resolveCalibrationChatClient(options) {
164
+ const gateway = new FallbackLlmClient(options.gatewayConfig, {
165
+ workspaceDir: options.workspaceDir
166
+ });
167
+ if (gateway.isAvailable({ agentId: options.gatewayAgentId, modelChain: options.modelChain })) {
168
+ return gateway;
169
+ }
170
+ const pluginConfig = options.pluginConfig;
171
+ if (pluginConfig && resolveLocalLlmCapabilities(pluginConfig).localLlm) {
172
+ log.info(`[calibration] using configured local LLM (model=${pluginConfig.localLlmModel})`);
173
+ const local = new LocalLlmClient(pluginConfig);
174
+ return {
175
+ chatCompletion(messages, chatOptions) {
176
+ return local.chatCompletion(messages, {
177
+ temperature: chatOptions?.temperature,
178
+ maxTokens: chatOptions?.maxTokens
179
+ });
180
+ }
181
+ };
182
+ }
183
+ log.warn("[calibration] no LLM available \u2014 skipping consolidation");
184
+ return null;
185
+ }
154
186
  async function synthesizeCalibrationRules(corrections, llm, existingRules, agentId, modelChain) {
155
187
  if (corrections.length < 2) return [];
156
188
  const correctionText = corrections.slice(0, 50).map((c, i) => `[${c.id}] ${c.content}`).join("\n\n");
@@ -161,9 +193,12 @@ ${existingRules.map((r) => `- ${r.condition}: ${r.calibration}`).join("\n")}` :
161
193
  const response = await llm.chatCompletion(
162
194
  [
163
195
  { role: "system", content: CLUSTER_PROMPT },
164
- { role: "user", content: `Here are ${corrections.length} corrections from this user:
196
+ {
197
+ role: "user",
198
+ content: `Here are ${corrections.length} corrections from this user:
165
199
 
166
- ${correctionText}${existingRulesText}` }
200
+ ${correctionText}${existingRulesText}`
201
+ }
167
202
  ],
168
203
  { temperature: 0.3, maxTokens: 3e3, agentId, modelChain }
169
204
  );
@@ -226,24 +261,36 @@ function buildCalibrationRecallSection(rules, query, maxChars = 1200) {
226
261
  lines.push("");
227
262
  return lines.join("\n");
228
263
  }
264
+ function calibrationConsolidationInput(config) {
265
+ const gateway = config.modelSource === "gateway";
266
+ return {
267
+ memoryDir: config.memoryDir,
268
+ gatewayConfig: config.gatewayConfig,
269
+ gatewayAgentId: gateway ? config.gatewayAgentId || void 0 : void 0,
270
+ modelChain: gateway ? config.taskModelChain : void 0,
271
+ workspaceDir: config.workspaceDir,
272
+ pluginConfig: config
273
+ };
274
+ }
229
275
  async function runCalibrationConsolidation(options) {
230
276
  try {
231
- const llm = new FallbackLlmClient(options.gatewayConfig, {
232
- workspaceDir: options.workspaceDir
233
- });
234
- if (!llm.isAvailable({ agentId: options.gatewayAgentId, modelChain: options.modelChain })) {
235
- log.debug("[calibration] no LLM available \u2014 skipping consolidation");
236
- return [];
237
- }
277
+ const llm = resolveCalibrationChatClient(options);
278
+ if (!llm) return [];
238
279
  const corrections = await readCorrections(options.memoryDir);
239
280
  if (corrections.length < 3) {
240
- log.debug(`[calibration] only ${corrections.length} corrections \u2014 need at least 3`);
281
+ log.info(`[calibration] only ${corrections.length} corrections \u2014 need at least 3`);
241
282
  return [];
242
283
  }
243
284
  const existingIndex = await readCalibrationIndex(options.memoryDir);
244
- const newRules = await synthesizeCalibrationRules(corrections, llm, existingIndex.rules, options.gatewayAgentId, options.modelChain);
285
+ const newRules = await synthesizeCalibrationRules(
286
+ corrections,
287
+ llm,
288
+ existingIndex.rules,
289
+ options.gatewayAgentId,
290
+ options.modelChain
291
+ );
245
292
  if (newRules.length === 0) {
246
- log.debug("[calibration] no new calibration rules synthesized");
293
+ log.info("[calibration] no new calibration rules synthesized");
247
294
  return existingIndex.rules;
248
295
  }
249
296
  const ruleMap = new Map(existingIndex.rules.map((r) => [r.id, r]));
@@ -266,7 +313,9 @@ async function runCalibrationConsolidation(options) {
266
313
  log.debug(`[calibration] synthesized ${newRules.length} new rule(s), ${allRules.length} total`);
267
314
  return allRules;
268
315
  } catch (error) {
269
- log.warn(`[calibration] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);
316
+ log.warn(
317
+ `[calibration] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`
318
+ );
270
319
  return [];
271
320
  }
272
321
  }
@@ -279,7 +328,8 @@ async function runCalibrationIfEnabled(options) {
279
328
  gatewayConfig: options.gatewayConfig,
280
329
  gatewayAgentId: options.gatewayAgentId,
281
330
  modelChain: options.modelChain,
282
- workspaceDir: options.workspaceDir
331
+ workspaceDir: options.workspaceDir,
332
+ pluginConfig: options.pluginConfig
283
333
  });
284
334
  }
285
335
  async function getCalibrationRulesForRecall(memoryDir) {
@@ -289,6 +339,7 @@ async function getCalibrationRulesForRecall(memoryDir) {
289
339
  export {
290
340
  CLUSTER_PROMPT,
291
341
  buildCalibrationRecallSection,
342
+ calibrationConsolidationInput,
292
343
  getCalibrationRulesForRecall,
293
344
  readCalibrationCorrections,
294
345
  readCalibrationIndex,