tenjin-cli 0.1.0-alpha.14 → 0.1.0-alpha.16

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 (253) hide show
  1. package/NOTICE.md +54 -7
  2. package/README.md +41 -295
  3. package/dist/{_esm-N4KAVXQR.js → _esm-CE7KNONL.js} +9 -10
  4. package/dist/{ccip-ZGGWQN4X.js → ccip-7RMRLAGV.js} +4 -4
  5. package/dist/{ccip-RPPPKTJR.js → ccip-NLCSCHKI.js} +5 -5
  6. package/dist/chunk-25TJPVBF.js +353 -0
  7. package/dist/chunk-25TJPVBF.js.map +1 -0
  8. package/dist/chunk-2BKS2FVE.js +93 -0
  9. package/dist/chunk-2BKS2FVE.js.map +1 -0
  10. package/dist/chunk-2QYORQBF.js +55 -0
  11. package/dist/chunk-2QYORQBF.js.map +1 -0
  12. package/dist/{chunk-ACBEHJAH.js → chunk-2U5ZVEV3.js} +14 -16
  13. package/dist/chunk-2U5ZVEV3.js.map +1 -0
  14. package/dist/{chunk-MJSXP4LW.js → chunk-3AJS6LLN.js} +11 -8
  15. package/dist/chunk-3AJS6LLN.js.map +1 -0
  16. package/dist/{chunk-OWVVI4VQ.js → chunk-3AUDA53C.js} +7650 -7361
  17. package/dist/chunk-3AUDA53C.js.map +1 -0
  18. package/dist/{chunk-MJZZTKCC.js → chunk-56MOAIP5.js} +5 -10
  19. package/dist/chunk-56MOAIP5.js.map +1 -0
  20. package/dist/{chunk-U5S527PP.js → chunk-5IEP5EGE.js} +3 -3
  21. package/dist/chunk-5X4SZ5BF.js +227 -0
  22. package/dist/chunk-5X4SZ5BF.js.map +1 -0
  23. package/dist/chunk-7WEQQJLG.js +68 -0
  24. package/dist/chunk-7WEQQJLG.js.map +1 -0
  25. package/dist/{chunk-7FK2UN2T.js → chunk-AWQPGIR6.js} +65 -67
  26. package/dist/{chunk-7FK2UN2T.js.map → chunk-AWQPGIR6.js.map} +1 -1
  27. package/dist/{chunk-PAOVPSP6.js → chunk-BBVUVBUO.js} +517 -138
  28. package/dist/chunk-BBVUVBUO.js.map +1 -0
  29. package/dist/{chunk-ETKZWJ4B.js → chunk-BFFM2WFK.js} +8 -8
  30. package/dist/chunk-BFFM2WFK.js.map +1 -0
  31. package/dist/{chunk-KYQVEKP5.js → chunk-BPMWXTFX.js} +8 -8
  32. package/dist/chunk-DMZZLPZN.js +205 -0
  33. package/dist/chunk-DMZZLPZN.js.map +1 -0
  34. package/dist/{chunk-47PP7TAG.js → chunk-EGELTSPU.js} +1356 -1356
  35. package/dist/chunk-EGELTSPU.js.map +1 -0
  36. package/dist/chunk-GULLJQXA.js +698 -0
  37. package/dist/chunk-GULLJQXA.js.map +1 -0
  38. package/dist/{chunk-S5RYMCV6.js → chunk-HPWO4O6S.js} +3 -3
  39. package/dist/chunk-HVRC33OL.js +174 -0
  40. package/dist/chunk-HVRC33OL.js.map +1 -0
  41. package/dist/{chunk-W6R3HAAG.js → chunk-JRGFKVAZ.js} +2 -2
  42. package/dist/{chunk-XJN5WUKL.js → chunk-KG3D7FIF.js} +2 -2
  43. package/dist/chunk-L3PVMIYQ.js +10328 -0
  44. package/dist/chunk-L3PVMIYQ.js.map +1 -0
  45. package/dist/{chunk-QW2Q2KAH.js → chunk-LHHMV4GU.js} +2 -2
  46. package/dist/{chunk-ZOBNS7CX.js → chunk-MEFB5KHA.js} +4 -18
  47. package/dist/chunk-MEFB5KHA.js.map +1 -0
  48. package/dist/{chunk-M2O56UK7.js → chunk-N35E6CM2.js} +293 -163
  49. package/dist/chunk-N35E6CM2.js.map +1 -0
  50. package/dist/chunk-OCBHUHWB.js +69 -0
  51. package/dist/chunk-OCBHUHWB.js.map +1 -0
  52. package/dist/chunk-OIM4HLN6.js +1405 -0
  53. package/dist/chunk-OIM4HLN6.js.map +1 -0
  54. package/dist/{chunk-PKW3H26Z.js → chunk-OJLYNM4Z.js} +56 -33
  55. package/dist/chunk-OJLYNM4Z.js.map +1 -0
  56. package/dist/{chunk-POJRB2AE.js → chunk-POUWHWID.js} +2 -2
  57. package/dist/chunk-PZEN5PHN.js +285 -0
  58. package/dist/chunk-PZEN5PHN.js.map +1 -0
  59. package/dist/chunk-SKAHDQH7.js +1785 -0
  60. package/dist/chunk-SKAHDQH7.js.map +1 -0
  61. package/dist/{chunk-KZAAWQNP.js → chunk-TTNESUPQ.js} +3 -3
  62. package/dist/{chunk-QWBUKIP2.js → chunk-U5DXNFJC.js} +23 -94
  63. package/dist/chunk-U5DXNFJC.js.map +1 -0
  64. package/dist/chunk-USS336NF.js +165 -0
  65. package/dist/chunk-USS336NF.js.map +1 -0
  66. package/dist/{chunk-UO22YNY4.js → chunk-WH7OWT6G.js} +49 -1
  67. package/dist/chunk-WH7OWT6G.js.map +1 -0
  68. package/dist/chunk-WXC57XGG.js +29 -0
  69. package/dist/chunk-WXC57XGG.js.map +1 -0
  70. package/dist/{chunk-YLYINX2H.js → chunk-XZKD7DIF.js} +3 -3
  71. package/dist/{chunk-7GJQ5RGA.js → chunk-YEETV6IW.js} +1077 -1039
  72. package/dist/chunk-YEETV6IW.js.map +1 -0
  73. package/dist/{chunk-B676GPS2.js → chunk-YJHHCWM3.js} +39 -16
  74. package/dist/chunk-YJHHCWM3.js.map +1 -0
  75. package/dist/{cli-U2BEUA55.js → cli-M3XCSOU6.js} +295 -349
  76. package/dist/cli-M3XCSOU6.js.map +1 -0
  77. package/dist/config-MXOX7XDR.js +41 -0
  78. package/dist/{dist-U4M6QCKE.js → dist-3LOO6M4U.js} +10 -10
  79. package/dist/doctor-LU4YIZWM.js +349 -0
  80. package/dist/doctor-LU4YIZWM.js.map +1 -0
  81. package/dist/{ethersCompat-Df4a6QIZ-WHYKB6HA.js → ethersCompat-Df4a6QIZ-THAVUGIJ.js} +5 -5
  82. package/dist/{chunk-3ZW7HPY5.js → fund-A54P2QFK.js} +81 -22
  83. package/dist/fund-A54P2QFK.js.map +1 -0
  84. package/dist/hook-command-U6KWPEDQ.js +377 -0
  85. package/dist/hook-command-U6KWPEDQ.js.map +1 -0
  86. package/dist/index.js +8 -3
  87. package/dist/index.js.map +1 -1
  88. package/dist/install-XUM2XSHW.js +53 -0
  89. package/dist/install-wallet-QIOFORTX.js +105 -0
  90. package/dist/install-wallet-QIOFORTX.js.map +1 -0
  91. package/dist/{run-CJWPGMIQ.js → mcp-HJC2PLRV.js} +3725 -10661
  92. package/dist/mcp-HJC2PLRV.js.map +1 -0
  93. package/dist/paths-P2N4JTDZ.js +49 -0
  94. package/dist/pay-SBXZEPEP.js +37 -0
  95. package/dist/redact-46ZHF2NH.js +17 -0
  96. package/dist/{secp256k1-XRPVBC6V.js → secp256k1-ZZZT2CAX.js} +3 -3
  97. package/dist/{send-C5EOKXOU.js → send-ASD2ZXJD.js} +28 -30
  98. package/dist/send-ASD2ZXJD.js.map +1 -0
  99. package/dist/{chunk-NAAMHWSI.js → skill-placement-NFVHY6A3.js} +159 -12
  100. package/dist/skill-placement-NFVHY6A3.js.map +1 -0
  101. package/dist/status-T2SDB57A.js +63 -0
  102. package/dist/status-T2SDB57A.js.map +1 -0
  103. package/dist/status-line-CGPUSDMC.js +71 -0
  104. package/dist/status-line-CGPUSDMC.js.map +1 -0
  105. package/dist/status-line-wiring-BYPHTYZE.js +30 -0
  106. package/dist/tenjin-daemon.mjs +20060 -0
  107. package/dist/tenjin-shim.mjs +251 -0
  108. package/dist/tenjin-vitest-reporter.mjs +49 -0
  109. package/dist/uninstall-FKYZHAM3.js +144 -0
  110. package/dist/uninstall-FKYZHAM3.js.map +1 -0
  111. package/dist/{update-24Y2CQTT.js → update-ANJ2AOTN.js} +133 -17
  112. package/dist/update-ANJ2AOTN.js.map +1 -0
  113. package/dist/{viemAdapter-By13KInL-TUQJBMHM.js → viemAdapter-By13KInL-X2VY6CY3.js} +5 -5
  114. package/dist/wallet-PWAHVKWW.js +31 -0
  115. package/dist/wallet-kdf-worker.mjs +980 -0
  116. package/docs/agent-permissions.md +68 -342
  117. package/docs/safety-model.md +25 -6
  118. package/package.json +8 -7
  119. package/LICENSE +0 -21
  120. package/dist/buy-2JBYPHAI.js +0 -46
  121. package/dist/chunk-3P3ES4XU.js +0 -144
  122. package/dist/chunk-3P3ES4XU.js.map +0 -1
  123. package/dist/chunk-3ZW7HPY5.js.map +0 -1
  124. package/dist/chunk-47PP7TAG.js.map +0 -1
  125. package/dist/chunk-4UHNXY6B.js +0 -786
  126. package/dist/chunk-4UHNXY6B.js.map +0 -1
  127. package/dist/chunk-4Y53PDH6.js +0 -213
  128. package/dist/chunk-4Y53PDH6.js.map +0 -1
  129. package/dist/chunk-54AJIO3E.js +0 -198
  130. package/dist/chunk-54AJIO3E.js.map +0 -1
  131. package/dist/chunk-736DW4V3.js +0 -65
  132. package/dist/chunk-736DW4V3.js.map +0 -1
  133. package/dist/chunk-7GJQ5RGA.js.map +0 -1
  134. package/dist/chunk-7NADDA2V.js +0 -161
  135. package/dist/chunk-7NADDA2V.js.map +0 -1
  136. package/dist/chunk-ACBEHJAH.js.map +0 -1
  137. package/dist/chunk-B676GPS2.js.map +0 -1
  138. package/dist/chunk-DAZAXFSF.js +0 -1357
  139. package/dist/chunk-DAZAXFSF.js.map +0 -1
  140. package/dist/chunk-DTCXO7HS.js +0 -791
  141. package/dist/chunk-DTCXO7HS.js.map +0 -1
  142. package/dist/chunk-ETKZWJ4B.js.map +0 -1
  143. package/dist/chunk-FDUD3W5V.js +0 -317
  144. package/dist/chunk-FDUD3W5V.js.map +0 -1
  145. package/dist/chunk-GEHL43VE.js +0 -711
  146. package/dist/chunk-GEHL43VE.js.map +0 -1
  147. package/dist/chunk-IU2HVT3Y.js +0 -313
  148. package/dist/chunk-IU2HVT3Y.js.map +0 -1
  149. package/dist/chunk-IUQZ4Z7M.js +0 -162
  150. package/dist/chunk-IUQZ4Z7M.js.map +0 -1
  151. package/dist/chunk-IXZJ3JOO.js +0 -614
  152. package/dist/chunk-IXZJ3JOO.js.map +0 -1
  153. package/dist/chunk-J6FUAIRR.js +0 -205
  154. package/dist/chunk-J6FUAIRR.js.map +0 -1
  155. package/dist/chunk-L6G35FU5.js +0 -105
  156. package/dist/chunk-L6G35FU5.js.map +0 -1
  157. package/dist/chunk-LSWP7MU2.js +0 -290
  158. package/dist/chunk-LSWP7MU2.js.map +0 -1
  159. package/dist/chunk-M2O56UK7.js.map +0 -1
  160. package/dist/chunk-MJSXP4LW.js.map +0 -1
  161. package/dist/chunk-MJZZTKCC.js.map +0 -1
  162. package/dist/chunk-NAAMHWSI.js.map +0 -1
  163. package/dist/chunk-O75FOHXS.js +0 -372
  164. package/dist/chunk-O75FOHXS.js.map +0 -1
  165. package/dist/chunk-OWVVI4VQ.js.map +0 -1
  166. package/dist/chunk-PAOVPSP6.js.map +0 -1
  167. package/dist/chunk-PCX2JQ2J.js +0 -233
  168. package/dist/chunk-PCX2JQ2J.js.map +0 -1
  169. package/dist/chunk-PKW3H26Z.js.map +0 -1
  170. package/dist/chunk-PQZVDCCA.js +0 -125
  171. package/dist/chunk-PQZVDCCA.js.map +0 -1
  172. package/dist/chunk-QWBUKIP2.js.map +0 -1
  173. package/dist/chunk-SGK2B724.js +0 -67
  174. package/dist/chunk-SGK2B724.js.map +0 -1
  175. package/dist/chunk-UHTVXQ2O.js +0 -140
  176. package/dist/chunk-UHTVXQ2O.js.map +0 -1
  177. package/dist/chunk-UO22YNY4.js.map +0 -1
  178. package/dist/chunk-VEAERJVJ.js +0 -43
  179. package/dist/chunk-VEAERJVJ.js.map +0 -1
  180. package/dist/chunk-VRPLZERE.js +0 -1421
  181. package/dist/chunk-VRPLZERE.js.map +0 -1
  182. package/dist/chunk-W4VW5XYB.js +0 -149
  183. package/dist/chunk-W4VW5XYB.js.map +0 -1
  184. package/dist/chunk-WU5CZPLD.js +0 -145
  185. package/dist/chunk-WU5CZPLD.js.map +0 -1
  186. package/dist/chunk-WYLMJQVH.js +0 -240
  187. package/dist/chunk-WYLMJQVH.js.map +0 -1
  188. package/dist/chunk-XGZ5EVMB.js +0 -35
  189. package/dist/chunk-XGZ5EVMB.js.map +0 -1
  190. package/dist/chunk-XVPQGCH4.js +0 -176
  191. package/dist/chunk-XVPQGCH4.js.map +0 -1
  192. package/dist/chunk-ZOBNS7CX.js.map +0 -1
  193. package/dist/chunk-ZQIQ55KK.js +0 -51
  194. package/dist/chunk-ZQIQ55KK.js.map +0 -1
  195. package/dist/cli-U2BEUA55.js.map +0 -1
  196. package/dist/config-CNUIX23Q.js +0 -32
  197. package/dist/doctor-QJJXRWTO.js +0 -31
  198. package/dist/edit-HJ44P44P.js +0 -40
  199. package/dist/fund-Y5IAHZ5D.js +0 -40
  200. package/dist/inspect-NFQ6SQQQ.js +0 -37
  201. package/dist/install-DXX7PVUP.js +0 -854
  202. package/dist/install-DXX7PVUP.js.map +0 -1
  203. package/dist/outcome-ANV4QIED.js +0 -24
  204. package/dist/publish-PCBTCXCZ.js +0 -42
  205. package/dist/read-W7QVRBVD.js +0 -160
  206. package/dist/read-W7QVRBVD.js.map +0 -1
  207. package/dist/run-CJWPGMIQ.js.map +0 -1
  208. package/dist/search-JGAVKTYJ.js +0 -25
  209. package/dist/secp256k1-XRPVBC6V.js.map +0 -1
  210. package/dist/send-C5EOKXOU.js.map +0 -1
  211. package/dist/session-OBCUUIFX.js +0 -89
  212. package/dist/session-OBCUUIFX.js.map +0 -1
  213. package/dist/skill-heal-D6EPLPS6.js +0 -84
  214. package/dist/skill-heal-D6EPLPS6.js.map +0 -1
  215. package/dist/uninstall-OWJNJ5LI.js +0 -73
  216. package/dist/uninstall-OWJNJ5LI.js.map +0 -1
  217. package/dist/update-24Y2CQTT.js.map +0 -1
  218. package/dist/usdc-4VCDHFWX.js +0 -38
  219. package/dist/usdc-4VCDHFWX.js.map +0 -1
  220. package/dist/viemAdapter-By13KInL-TUQJBMHM.js.map +0 -1
  221. package/dist/wallet-OFXDIIGP.js +0 -33
  222. package/dist/wallet-OFXDIIGP.js.map +0 -1
  223. package/dist/wallet-SLRIYJ2U.js +0 -42
  224. package/dist/wallet-SLRIYJ2U.js.map +0 -1
  225. package/docs/command-reference.md +0 -261
  226. package/skills/tenjin/SKILL.md +0 -364
  227. package/skills/tenjin-publish/SKILL.md +0 -224
  228. package/skills/tenjin-publish/references/maintain.md +0 -39
  229. package/skills/tenjin-search/SKILL.md +0 -149
  230. package/skills/tenjin-search/references/permissions.md +0 -106
  231. /package/dist/{_esm-N4KAVXQR.js.map → _esm-CE7KNONL.js.map} +0 -0
  232. /package/dist/{buy-2JBYPHAI.js.map → ccip-7RMRLAGV.js.map} +0 -0
  233. /package/dist/{ccip-RPPPKTJR.js.map → ccip-NLCSCHKI.js.map} +0 -0
  234. /package/dist/{chunk-U5S527PP.js.map → chunk-5IEP5EGE.js.map} +0 -0
  235. /package/dist/{chunk-KYQVEKP5.js.map → chunk-BPMWXTFX.js.map} +0 -0
  236. /package/dist/{chunk-S5RYMCV6.js.map → chunk-HPWO4O6S.js.map} +0 -0
  237. /package/dist/{chunk-W6R3HAAG.js.map → chunk-JRGFKVAZ.js.map} +0 -0
  238. /package/dist/{chunk-XJN5WUKL.js.map → chunk-KG3D7FIF.js.map} +0 -0
  239. /package/dist/{chunk-QW2Q2KAH.js.map → chunk-LHHMV4GU.js.map} +0 -0
  240. /package/dist/{chunk-POJRB2AE.js.map → chunk-POUWHWID.js.map} +0 -0
  241. /package/dist/{chunk-KZAAWQNP.js.map → chunk-TTNESUPQ.js.map} +0 -0
  242. /package/dist/{chunk-YLYINX2H.js.map → chunk-XZKD7DIF.js.map} +0 -0
  243. /package/dist/{ccip-ZGGWQN4X.js.map → config-MXOX7XDR.js.map} +0 -0
  244. /package/dist/{dist-U4M6QCKE.js.map → dist-3LOO6M4U.js.map} +0 -0
  245. /package/dist/{config-CNUIX23Q.js.map → ethersCompat-Df4a6QIZ-THAVUGIJ.js.map} +0 -0
  246. /package/dist/{doctor-QJJXRWTO.js.map → install-XUM2XSHW.js.map} +0 -0
  247. /package/dist/{edit-HJ44P44P.js.map → paths-P2N4JTDZ.js.map} +0 -0
  248. /package/dist/{ethersCompat-Df4a6QIZ-WHYKB6HA.js.map → pay-SBXZEPEP.js.map} +0 -0
  249. /package/dist/{fund-Y5IAHZ5D.js.map → redact-46ZHF2NH.js.map} +0 -0
  250. /package/dist/{inspect-NFQ6SQQQ.js.map → secp256k1-ZZZT2CAX.js.map} +0 -0
  251. /package/dist/{outcome-ANV4QIED.js.map → status-line-wiring-BYPHTYZE.js.map} +0 -0
  252. /package/dist/{publish-PCBTCXCZ.js.map → viemAdapter-By13KInL-X2VY6CY3.js.map} +0 -0
  253. /package/dist/{search-JGAVKTYJ.js.map → wallet-PWAHVKWW.js.map} +0 -0
@@ -0,0 +1,285 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ writeFileAtomic
4
+ } from "./chunk-7WEQQJLG.js";
5
+
6
+ // src/router/progress.ts
7
+ import { createHash, randomUUID } from "node:crypto";
8
+ import { constants } from "node:fs";
9
+ import { open, opendir, rm } from "node:fs/promises";
10
+ import { join } from "node:path";
11
+ var PROGRESS_DIR = "progress";
12
+ var BINDING_PREFIX = "id-";
13
+ var SESSION_FILE = "session.json";
14
+ var CALL_FILE_RE = /^[a-f0-9]{64}\.json$/;
15
+ var STALE_AFTER_MS = 9e4;
16
+ var RECENT_MS = 1e4;
17
+ var EXPIRY_MS = 10 * 6e4;
18
+ var SESSION_ACTIVE_MS = 10 * 6e4;
19
+ var MAX_RECORDS = 256;
20
+ var MAX_SESSIONS = 4096;
21
+ var MAX_RECORD_BYTES = 4096;
22
+ var digest = (value) => createHash("sha256").update(value).digest("hex");
23
+ function bounded(value, limit) {
24
+ const chars = Array.from(value);
25
+ return chars.length <= limit ? value : `${chars.slice(0, limit - 1).join("")}\u2026`;
26
+ }
27
+ function sanitize(value, limit) {
28
+ return bounded(
29
+ value.replace(/[\p{Cc}\p{Cf}]/gu, " ").replace(/\s+/g, " ").trim(),
30
+ limit
31
+ );
32
+ }
33
+ async function clean(value, limit) {
34
+ const { mask } = await import("./redact-46ZHF2NH.js");
35
+ return sanitize(mask(value), limit);
36
+ }
37
+ async function endpointOf(value) {
38
+ let url;
39
+ try {
40
+ url = new URL(value);
41
+ } catch {
42
+ return "invalid endpoint";
43
+ }
44
+ if (url.username !== "" || url.password !== "") return "invalid endpoint";
45
+ return clean(`${url.host}${url.pathname === "/" ? "" : url.pathname}`, 110);
46
+ }
47
+ async function parametersOf(value) {
48
+ let json;
49
+ try {
50
+ json = JSON.stringify(value);
51
+ } catch {
52
+ return void 0;
53
+ }
54
+ return json === void 0 ? void 0 : clean(json, 180);
55
+ }
56
+ function sessionDir(dataDir, sessionId) {
57
+ return join(dataDir, PROGRESS_DIR, digest(sessionId));
58
+ }
59
+ function newCallId() {
60
+ return randomUUID();
61
+ }
62
+ async function noteSession(dataDir, sessionId, now = Date.now()) {
63
+ await write(join(sessionDir(dataDir, sessionId), SESSION_FILE), { version: 1, at: now });
64
+ }
65
+ async function bindDecision(dataDir, sessionId, decisionId, now = Date.now()) {
66
+ await write(join(sessionDir(dataDir, sessionId), `${BINDING_PREFIX}${digest(decisionId)}.json`), {
67
+ version: 1,
68
+ at: now
69
+ });
70
+ }
71
+ async function resolveProgressSession(dataDir, opts = {}) {
72
+ const now = opts.now ?? Date.now();
73
+ const root = join(dataDir, PROGRESS_DIR);
74
+ let names;
75
+ try {
76
+ const directory = await opendir(root);
77
+ names = [];
78
+ for await (const entry of directory) {
79
+ if (entry.isDirectory() && /^[a-f0-9]{64}$/.test(entry.name)) names.push(entry.name);
80
+ if (names.length >= MAX_SESSIONS) break;
81
+ }
82
+ } catch {
83
+ return null;
84
+ }
85
+ if (opts.id !== void 0 && opts.id.length > 0) {
86
+ const marker = `${BINDING_PREFIX}${digest(opts.id)}.json`;
87
+ for (const name of names) {
88
+ const bound = await readStamp(join(root, name, marker));
89
+ if (bound !== null && now - bound.at <= EXPIRY_MS) return join(root, name);
90
+ }
91
+ }
92
+ const live = [];
93
+ for (const name of names) {
94
+ const touched = await readStamp(join(root, name, SESSION_FILE));
95
+ if (touched !== null && now - touched.at <= SESSION_ACTIVE_MS) live.push(name);
96
+ if (live.length > 1) return null;
97
+ }
98
+ return live.length === 1 ? join(root, live[0]) : null;
99
+ }
100
+ async function writeProgress(directory, callId, step, now = Date.now()) {
101
+ const endpoint = step.provider === void 0 ? void 0 : await endpointOf(step.provider);
102
+ const parameters = step.parameters === void 0 ? void 0 : await parametersOf(step.parameters);
103
+ const saved = {
104
+ version: 1,
105
+ at: now,
106
+ phase: step.phase,
107
+ operation: sanitize(step.operation ?? "request", 24) || "request",
108
+ ...step.outcome !== void 0 ? { outcome: sanitize(step.outcome, 40) } : {},
109
+ ...endpoint !== void 0 ? { endpoint } : {},
110
+ ...parameters !== void 0 ? { parameters } : {},
111
+ ...step.price !== void 0 ? { price: sanitize(step.price, 24) } : {}
112
+ };
113
+ await write(join(directory, `${digest(callId)}.json`), saved);
114
+ }
115
+ var SILENT = {
116
+ routing: async () => void 0,
117
+ calling: async () => void 0,
118
+ done: async () => void 0
119
+ };
120
+ async function openLookupFooter(dataDir, opts = {}) {
121
+ const now = opts.now ?? Date.now;
122
+ const directory = await resolveProgressSession(dataDir, {
123
+ ...opts.id !== void 0 ? { id: opts.id } : {},
124
+ now: now()
125
+ }).catch(() => null);
126
+ if (directory === null) return SILENT;
127
+ const callId = newCallId();
128
+ const operation = opts.operation ?? "request";
129
+ const step = async (patch) => {
130
+ await writeProgress(directory, callId, { operation, ...patch }, now());
131
+ };
132
+ return {
133
+ routing: async () => {
134
+ await step({ phase: "routing" });
135
+ await pruneProgress(directory, now());
136
+ },
137
+ calling: async (calling) => step({ phase: "calling", ...calling }),
138
+ done: async (outcome, detail) => step({ phase: "done", outcome, ...detail })
139
+ };
140
+ }
141
+ async function pruneProgress(directory, now = Date.now()) {
142
+ try {
143
+ const dir = await opendir(directory);
144
+ let count = 0;
145
+ for await (const entry of dir) {
146
+ if (++count > MAX_RECORDS) return;
147
+ if (!entry.isFile() || entry.name === SESSION_FILE) continue;
148
+ const record = await readStamp(join(directory, entry.name));
149
+ if (record === null || now - record.at > EXPIRY_MS) {
150
+ await rm(join(directory, entry.name), { force: true }).catch(() => void 0);
151
+ }
152
+ }
153
+ } catch {
154
+ }
155
+ }
156
+ async function pruneSessions(dataDir, now = Date.now()) {
157
+ const root = join(dataDir, PROGRESS_DIR);
158
+ try {
159
+ const directory = await opendir(root);
160
+ let seen = 0;
161
+ for await (const entry of directory) {
162
+ if (++seen > MAX_SESSIONS) return;
163
+ if (!entry.isDirectory() || !/^[a-f0-9]{64}$/.test(entry.name)) continue;
164
+ const path = join(root, entry.name);
165
+ const session = await readStamp(join(path, SESSION_FILE));
166
+ if (session !== null && now - session.at <= SESSION_ACTIVE_MS) continue;
167
+ if (await hasLiveRecord(path, now)) continue;
168
+ await rm(path, { recursive: true, force: true }).catch(() => void 0);
169
+ }
170
+ } catch {
171
+ }
172
+ }
173
+ async function hasLiveRecord(directory, now) {
174
+ try {
175
+ const dir = await opendir(directory);
176
+ let count = 0;
177
+ for await (const entry of dir) {
178
+ if (++count > MAX_RECORDS) return true;
179
+ if (!entry.isFile() || entry.name === SESSION_FILE) continue;
180
+ const record = await readStamp(join(directory, entry.name));
181
+ if (record !== null && now - record.at <= EXPIRY_MS) return true;
182
+ }
183
+ } catch {
184
+ return true;
185
+ }
186
+ return false;
187
+ }
188
+ async function renderProgress(dataDir, sessionId, options = {}) {
189
+ const now = options.now ?? Date.now();
190
+ const columns = Math.max(45, Math.min(400, options.columns || 160));
191
+ const directory = sessionDir(dataDir, sessionId);
192
+ const records = [];
193
+ try {
194
+ const dir = await opendir(directory);
195
+ let count = 0;
196
+ for await (const entry of dir) {
197
+ if (++count > MAX_RECORDS) return bounded("x402 \xB7 activity exceeds display limit", columns);
198
+ if (!entry.isFile() || !CALL_FILE_RE.test(entry.name)) continue;
199
+ const record = await readCall(join(directory, entry.name));
200
+ if (record !== null && now - record.at <= EXPIRY_MS) records.push(record);
201
+ }
202
+ } catch (error) {
203
+ return error.code === "ENOENT" ? READY : "";
204
+ }
205
+ const running = records.filter((row) => row.phase !== "done" && now - row.at <= holdMs(row)).sort((a, b) => b.at - a.at);
206
+ const stale = records.filter(
207
+ (row) => row.phase !== "done" && now - row.at > holdMs(row) && row.operation === "request"
208
+ );
209
+ const finished = records.filter((row) => row.phase === "done" && now - row.at <= RECENT_MS).sort((a, b) => b.at - a.at);
210
+ const head = running[0] ?? finished[0] ?? stale.sort((a, b) => b.at - a.at)[0];
211
+ if (head === void 0) return READY;
212
+ const alsoRunning = running.length - (running[0] === head ? 1 : 0);
213
+ const suffix = alsoRunning > 0 ? ` \xB7 +${alsoRunning} more` : "";
214
+ return bounded(`${line(head, now)}${suffix}`, columns);
215
+ }
216
+ var READY = "x402 \xB7 ready";
217
+ function holdMs(row) {
218
+ return row.phase !== "done" && row.operation === "request" ? STALE_AFTER_MS : RECENT_MS;
219
+ }
220
+ function line(row, now) {
221
+ const operation = sanitize(row.operation, 24) || "request";
222
+ if (row.phase !== "done" && now - row.at > STALE_AFTER_MS) {
223
+ return `x402 \xB7 ${operation}: stale, no outcome recorded`;
224
+ }
225
+ const state = row.phase === "routing" ? sanitize(row.outcome ?? "selecting service", 40) : row.phase === "calling" ? "calling" : sanitize(row.outcome ?? "done", 40);
226
+ return `x402 \xB7 ${operation}: ${state}` + (row.endpoint !== void 0 ? ` ${sanitize(row.endpoint, 110)}` : "") + (row.parameters !== void 0 ? ` \xB7 ${sanitize(row.parameters, 180)}` : "") + (row.price !== void 0 ? ` \xB7 ${sanitize(row.price, 24)}` : "");
227
+ }
228
+ async function write(path, body) {
229
+ try {
230
+ await writeFileAtomic(path, JSON.stringify(body), { mode: 384, dirMode: 448 });
231
+ } catch {
232
+ }
233
+ }
234
+ async function readStamp(path) {
235
+ return stampOf(await readJson(path));
236
+ }
237
+ function stampOf(row) {
238
+ if (row === null) return null;
239
+ return row.version === 1 && typeof row.at === "number" && Number.isFinite(row.at) ? { version: 1, at: row.at } : null;
240
+ }
241
+ async function readCall(path) {
242
+ const row = await readJson(path);
243
+ const stamp = stampOf(row);
244
+ if (row === null || stamp === null || typeof row.operation !== "string") return null;
245
+ if (!["routing", "calling", "done"].includes(row.phase)) return null;
246
+ const optional = ["outcome", "endpoint", "parameters", "price"];
247
+ if (!optional.every((key) => row[key] === void 0 || typeof row[key] === "string")) return null;
248
+ return {
249
+ ...stamp,
250
+ phase: row.phase,
251
+ operation: row.operation,
252
+ ...Object.fromEntries(
253
+ optional.filter((key) => row[key] !== void 0).map((key) => [key, row[key]])
254
+ )
255
+ };
256
+ }
257
+ async function readJson(path) {
258
+ const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW).catch(() => void 0);
259
+ if (file === void 0) return null;
260
+ try {
261
+ if ((await file.stat()).size > MAX_RECORD_BYTES) return null;
262
+ const buffer = Buffer.alloc(MAX_RECORD_BYTES + 1);
263
+ const { bytesRead } = await file.read(buffer, 0, buffer.length, 0);
264
+ if (bytesRead > MAX_RECORD_BYTES) return null;
265
+ const parsed = JSON.parse(buffer.subarray(0, bytesRead).toString("utf8"));
266
+ return parsed === null || typeof parsed !== "object" || Array.isArray(parsed) ? null : parsed;
267
+ } catch {
268
+ return null;
269
+ } finally {
270
+ await file.close().catch(() => void 0);
271
+ }
272
+ }
273
+
274
+ export {
275
+ sessionDir,
276
+ newCallId,
277
+ noteSession,
278
+ bindDecision,
279
+ writeProgress,
280
+ openLookupFooter,
281
+ pruneProgress,
282
+ pruneSessions,
283
+ renderProgress
284
+ };
285
+ //# sourceMappingURL=chunk-PZEN5PHN.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/router/progress.ts"],"sourcesContent":["import { createHash, randomUUID } from 'node:crypto';\nimport { constants } from 'node:fs';\nimport { open, opendir, rm } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { writeFileAtomic } from '../lib/atomic-json';\n\n/**\n * The live status line's evidence: what this session is looking up right now,\n * which provider is actually being called, and what it cost.\n *\n * DISPLAY ONLY, AND STRICTLY DOWNSTREAM. Nothing here is read by the gate, the\n * decision, the spend policy or the paying leg; every write is best effort and\n * every failure is swallowed, so a full disk or a read-only data dir loses the\n * footer and changes no routing or payment outcome. That is the whole contract\n * this module has to keep.\n *\n * KEYED TO THE SESSION, NEVER GUESSED FROM IT. A record lives under the SHA-256\n * of the harness's own `session_id`, so the renderer for one session cannot see\n * another's. The hook knows that id; the tool, which runs inside the MCP server\n * process, does not, so it resolves the session in one of exactly two ways:\n *\n * - BY BINDING. An `execute` decision leaves an `id-<hash>.json` marker in the\n * session that produced it, and the model passes that id back on the tool\n * call. Resolving through the marker is proof, not inference.\n * - BY SOLE ACTIVITY. With no id, the request belongs to the only session that\n * has been active recently, and when two have been, it belongs to neither as\n * far as this module is concerned: {@link resolveProgressSession} returns\n * null and nothing is written. A missing footer is the correct failure;\n * showing one session's lookup in another session's terminal is not.\n */\n\nconst PROGRESS_DIR = 'progress';\n/** The binding marker's prefix, so it can never be read back as a call record. */\nconst BINDING_PREFIX = 'id-';\n/** The session's own liveness touch, likewise outside the call-record pattern. */\nconst SESSION_FILE = 'session.json';\n/** Call records are named by a 64-hex digest and nothing else is read as one. */\nconst CALL_FILE_RE = /^[a-f0-9]{64}\\.json$/;\n\n/** An in-flight call older than this is shown as stale, never as running. */\nexport const STALE_AFTER_MS = 90_000;\n/**\n * How long a state stays on the footer once nothing has replaced it. The demo\n * holds each one for about ten seconds, which is what makes a decision that\n * takes a second readable at a one-second refresh; after that the line is\n * `x402 · ready` again.\n */\nexport const RECENT_MS = 10_000;\n/** Older than this and a record is ignored by the renderer and pruned on write. */\nexport const EXPIRY_MS = 10 * 60_000;\n/** How recently a session must have been touched to claim an id-less request. */\nexport const SESSION_ACTIVE_MS = 10 * 60_000;\n/** Above this many files a session directory is reported rather than scanned. */\nconst MAX_RECORDS = 256;\n/** A ceiling on the root scan. {@link pruneSessions} keeps it far below this:\n * a directory is one LIVE session, not one session this machine ever had. */\nconst MAX_SESSIONS = 4_096;\n/** A record larger than this is damaged or not ours; it is skipped unread. */\nconst MAX_RECORD_BYTES = 4_096;\n\nexport type ProgressPhase = 'routing' | 'calling' | 'done';\n\n/** The two markers: a session's liveness touch and a decision-id binding. */\ninterface Stamp {\n version: 1;\n at: number;\n}\n\n/** What one call looks like on disk. Every string is already masked and bounded. */\ninterface SavedProgress extends Stamp {\n phase: ProgressPhase;\n /** The tool whose activity this is, as the footer names it. */\n operation: string;\n /** What the state SAYS: the outcome on `done`, and on an in-flight record the\n * stage, when it is not the tool's own `selecting service`. */\n outcome?: string;\n /** Host plus path of the provider actually called, without a scheme. */\n endpoint?: string;\n /** The call's parameters as compact JSON. */\n parameters?: string;\n /** What the provider was paid, as USD. */\n price?: string;\n}\n\nexport interface ProgressStep {\n phase: ProgressPhase;\n operation?: string;\n outcome?: string;\n /** The executed provider's URL. It can differ from the hint's suggestion. */\n provider?: string;\n parameters?: unknown;\n price?: string;\n}\n\nconst digest = (value: string): string => createHash('sha256').update(value).digest('hex');\n\nfunction bounded(value: string, limit: number): string {\n const chars = Array.from(value);\n return chars.length <= limit ? value : `${chars.slice(0, limit - 1).join('')}…`;\n}\n\n/**\n * Provider text reaches a terminal here, so it is treated as hostile: control\n * characters, format characters and directional overrides are replaced before\n * anything is written, and again before anything is printed. A footer that can\n * be made to repaint the line above it is a spoofing surface, not a display.\n */\nexport function sanitize(value: string, limit: number): string {\n return bounded(\n value\n .replace(/[\\p{Cc}\\p{Cf}]/gu, ' ')\n .replace(/\\s+/g, ' ')\n .trim(),\n limit,\n );\n}\n\n/**\n * The CLI's own redaction, behind a dynamic import ON PURPOSE: the rule corpus\n * and the BIP-39 wordlist are a real parse cost, the renderer runs once a\n * second, and only the write path needs them. `dist-chunks.test.ts` pins it.\n */\nasync function clean(value: string, limit: number): Promise<string> {\n const { mask } = await import('../lib/redact');\n return sanitize(mask(value), limit);\n}\n\n/** Host plus path, which is what names a provider to a person watching. */\nasync function endpointOf(value: string): Promise<string> {\n let url: URL;\n try {\n url = new URL(value);\n } catch {\n return 'invalid endpoint';\n }\n if (url.username !== '' || url.password !== '') return 'invalid endpoint';\n return clean(`${url.host}${url.pathname === '/' ? '' : url.pathname}`, 110);\n}\n\nasync function parametersOf(value: unknown): Promise<string | undefined> {\n let json: string | undefined;\n try {\n json = JSON.stringify(value);\n } catch {\n return undefined;\n }\n return json === undefined ? undefined : clean(json, 180);\n}\n\nexport function sessionDir(dataDir: string, sessionId: string): string {\n return join(dataDir, PROGRESS_DIR, digest(sessionId));\n}\n\n/** A fresh key for one call, so two overlapping lookups never share a record. */\nexport function newCallId(): string {\n return randomUUID();\n}\n\n/**\n * Mark this session live, so an id-less tool call made from it can be\n * attributed. Written on every hook event, including the ones that route\n * nothing: an open session has to be distinguishable from a closed one.\n */\nexport async function noteSession(\n dataDir: string,\n sessionId: string,\n now = Date.now(),\n): Promise<void> {\n await write(join(sessionDir(dataDir, sessionId), SESSION_FILE), { version: 1, at: now });\n}\n\n/** Record that this decision id was produced in this session. */\nexport async function bindDecision(\n dataDir: string,\n sessionId: string,\n decisionId: string,\n now = Date.now(),\n): Promise<void> {\n await write(join(sessionDir(dataDir, sessionId), `${BINDING_PREFIX}${digest(decisionId)}.json`), {\n version: 1,\n at: now,\n });\n}\n\n/**\n * Which session directory a tool call belongs to, or null for \"cannot tell\".\n * Null is a normal answer and its only consequence is a footer that stays quiet.\n */\nexport async function resolveProgressSession(\n dataDir: string,\n opts: { id?: string; now?: number } = {},\n): Promise<string | null> {\n const now = opts.now ?? Date.now();\n const root = join(dataDir, PROGRESS_DIR);\n let names: string[];\n try {\n const directory = await opendir(root);\n names = [];\n for await (const entry of directory) {\n if (entry.isDirectory() && /^[a-f0-9]{64}$/.test(entry.name)) names.push(entry.name);\n if (names.length >= MAX_SESSIONS) break;\n }\n } catch {\n return null;\n }\n if (opts.id !== undefined && opts.id.length > 0) {\n const marker = `${BINDING_PREFIX}${digest(opts.id)}.json`;\n for (const name of names) {\n const bound = await readStamp(join(root, name, marker));\n if (bound !== null && now - bound.at <= EXPIRY_MS) return join(root, name);\n }\n // A stale or unknown id says nothing about which session asked, so the\n // sole-activity rule below still applies rather than a wrong attribution.\n }\n const live: string[] = [];\n for (const name of names) {\n const touched = await readStamp(join(root, name, SESSION_FILE));\n if (touched !== null && now - touched.at <= SESSION_ACTIVE_MS) live.push(name);\n if (live.length > 1) return null;\n }\n return live.length === 1 ? join(root, live[0] as string) : null;\n}\n\n/**\n * Record one step of one call. The caller holds the directory (from\n * {@link sessionDir} or {@link resolveProgressSession}) and the call id, so a\n * step never has to re-resolve anything on the hot path.\n */\nexport async function writeProgress(\n directory: string,\n callId: string,\n step: ProgressStep,\n now = Date.now(),\n): Promise<void> {\n const endpoint = step.provider === undefined ? undefined : await endpointOf(step.provider);\n const parameters =\n step.parameters === undefined ? undefined : await parametersOf(step.parameters);\n const saved: SavedProgress = {\n version: 1,\n at: now,\n phase: step.phase,\n operation: sanitize(step.operation ?? 'request', 24) || 'request',\n ...(step.outcome !== undefined ? { outcome: sanitize(step.outcome, 40) } : {}),\n ...(endpoint !== undefined ? { endpoint } : {}),\n ...(parameters !== undefined ? { parameters } : {}),\n ...(step.price !== undefined ? { price: sanitize(step.price, 24) } : {}),\n };\n await write(join(directory, `${digest(callId)}.json`), saved);\n}\n\nexport interface LookupFooter {\n /** A decision is in flight. */\n routing(): Promise<void>;\n /** The EXECUTED provider, which can differ from what the hint suggested. */\n calling(step: { provider: string; parameters?: unknown }): Promise<void>;\n /** The outcome, and what the provider was paid for it. */\n done(\n outcome: string,\n step?: { provider?: string; parameters?: unknown; price?: string },\n ): Promise<void>;\n}\n\n/** A footer for a session this call cannot be attributed to: it writes nothing. */\nconst SILENT: LookupFooter = {\n routing: async () => undefined,\n calling: async () => undefined,\n done: async () => undefined,\n};\n\n/**\n * The `request` tool's footer: the session is resolved ONCE, at the top of the\n * call, and each later step is one small write. An unresolvable session yields\n * {@link SILENT}, and the lookup runs exactly as it would have.\n */\nexport async function openLookupFooter(\n dataDir: string,\n opts: { id?: string; operation?: string; now?: () => number } = {},\n): Promise<LookupFooter> {\n const now = opts.now ?? Date.now;\n const directory = await resolveProgressSession(dataDir, {\n ...(opts.id !== undefined ? { id: opts.id } : {}),\n now: now(),\n }).catch(() => null);\n if (directory === null) return SILENT;\n const callId = newCallId();\n const operation = opts.operation ?? 'request';\n const step = async (patch: ProgressStep): Promise<void> => {\n await writeProgress(directory, callId, { operation, ...patch }, now());\n };\n return {\n routing: async () => {\n await step({ phase: 'routing' });\n await pruneProgress(directory, now());\n },\n calling: async (calling) => step({ phase: 'calling', ...calling }),\n done: async (outcome, detail) => step({ phase: 'done', outcome, ...detail }),\n };\n}\n\n/**\n * Remove records past {@link EXPIRY_MS}. Run from a writer, never from the\n * renderer: the footer refreshes once a second and must stay read-only.\n */\nexport async function pruneProgress(directory: string, now = Date.now()): Promise<void> {\n try {\n const dir = await opendir(directory);\n let count = 0;\n for await (const entry of dir) {\n if (++count > MAX_RECORDS) return;\n if (!entry.isFile() || entry.name === SESSION_FILE) continue;\n const record = await readStamp(join(directory, entry.name));\n if (record === null || now - record.at > EXPIRY_MS) {\n await rm(join(directory, entry.name), { force: true }).catch(() => undefined);\n }\n }\n } catch {\n // Housekeeping only. Nothing downstream depends on it having run.\n }\n}\n\n/**\n * Remove the directories of sessions that are over.\n *\n * WITHOUT THIS THE ROOT ONLY GROWS, one directory per session this machine has\n * ever had, and a root big enough to hit {@link MAX_SESSIONS} would leave\n * {@link resolveProgressSession} scanning an arbitrary subset that need not\n * contain the session asking. Run from the hook, which is the one writer that\n * fires on every turn; a directory whose session is still live is never touched.\n */\nexport async function pruneSessions(dataDir: string, now = Date.now()): Promise<void> {\n const root = join(dataDir, PROGRESS_DIR);\n try {\n const directory = await opendir(root);\n let seen = 0;\n for await (const entry of directory) {\n if (++seen > MAX_SESSIONS) return;\n if (!entry.isDirectory() || !/^[a-f0-9]{64}$/.test(entry.name)) continue;\n const path = join(root, entry.name);\n const session = await readStamp(join(path, SESSION_FILE));\n if (session !== null && now - session.at <= SESSION_ACTIVE_MS) continue;\n // The touch is gone or old, so the only thing that can keep this\n // directory is a record still inside the renderer's window.\n if (await hasLiveRecord(path, now)) continue;\n await rm(path, { recursive: true, force: true }).catch(() => undefined);\n }\n } catch {\n // Housekeeping only. Nothing downstream depends on it having run.\n }\n}\n\nasync function hasLiveRecord(directory: string, now: number): Promise<boolean> {\n try {\n const dir = await opendir(directory);\n let count = 0;\n for await (const entry of dir) {\n if (++count > MAX_RECORDS) return true;\n if (!entry.isFile() || entry.name === SESSION_FILE) continue;\n const record = await readStamp(join(directory, entry.name));\n if (record !== null && now - record.at <= EXPIRY_MS) return true;\n }\n } catch {\n return true;\n }\n return false;\n}\n\n/**\n * The footer for one session: one line, bounded, sanitized, and empty of\n * everything but this session's own calls. Read-only by construction.\n */\nexport async function renderProgress(\n dataDir: string,\n sessionId: string,\n options: { now?: number; columns?: number } = {},\n): Promise<string> {\n const now = options.now ?? Date.now();\n // The harness truncates to the real terminal width, and `COLUMNS` rarely\n // survives into a status-line process, so the default is a wide terminal\n // rather than a narrow one: cutting a provider's path off at 80 columns on a\n // 200-column terminal loses exactly the part worth reading.\n const columns = Math.max(45, Math.min(400, options.columns || 160));\n const directory = sessionDir(dataDir, sessionId);\n const records: SavedProgress[] = [];\n try {\n const dir = await opendir(directory);\n let count = 0;\n for await (const entry of dir) {\n if (++count > MAX_RECORDS) return bounded('x402 · activity exceeds display limit', columns);\n if (!entry.isFile() || !CALL_FILE_RE.test(entry.name)) continue;\n const record = await readCall(join(directory, entry.name));\n if (record !== null && now - record.at <= EXPIRY_MS) records.push(record);\n }\n } catch (error) {\n // A SESSION WITH NO DIRECTORY IS IDLE, not broken: it has simply not looked\n // anything up yet, and the router being on is the thing the idle line says.\n // Any OTHER read failure is this display failing, and a display that failed\n // prints nothing rather than a status it did not read.\n return (error as NodeJS.ErrnoException).code === 'ENOENT' ? READY : '';\n }\n const running = records\n .filter((row) => row.phase !== 'done' && now - row.at <= holdMs(row))\n .sort((a, b) => b.at - a.at);\n // Only a LOOKUP goes stale out loud. A hook decision has a five-second budget,\n // so one still in flight after its hold is a dead hook, and the footer says\n // ready rather than naming a stage nothing is working on.\n const stale = records.filter(\n (row) => row.phase !== 'done' && now - row.at > holdMs(row) && row.operation === 'request',\n );\n const finished = records\n .filter((row) => row.phase === 'done' && now - row.at <= RECENT_MS)\n .sort((a, b) => b.at - a.at);\n const head = running[0] ?? finished[0] ?? stale.sort((a, b) => b.at - a.at)[0];\n if (head === undefined) return READY;\n // OVERLAPPING CALLS ARE COUNTED, NOT HIDDEN. The newest running call is the\n // one worth naming; the rest are a count, because a second endpoint and its\n // parameters do not fit a line beside the first.\n const alsoRunning = running.length - (running[0] === head ? 1 : 0);\n const suffix = alsoRunning > 0 ? ` · +${alsoRunning} more` : '';\n return bounded(`${line(head, now)}${suffix}`, columns);\n}\n\n/** What the footer says when this session has nothing running or just finished.\n * It is the visible proof that the router is on, so it is never blank. */\nconst READY = 'x402 · ready';\n\n/**\n * How long this state holds the line. A lookup in flight holds it until it\n * lands, because a provider call can take a minute; everything else holds it\n * for {@link RECENT_MS}, which is how the demo reads: one state per second or\n * so, each one still there when the next arrives.\n */\nfunction holdMs(row: SavedProgress): number {\n return row.phase !== 'done' && row.operation === 'request' ? STALE_AFTER_MS : RECENT_MS;\n}\n\n/**\n * One call, as the footer says it: `x402 · <tool>: <state> <host/path> ·\n * <parameters> · <price>`. Every field is sanitized AGAIN here, because what is\n * on disk is input to this process even when this process wrote it.\n */\nfunction line(row: SavedProgress, now: number): string {\n const operation = sanitize(row.operation, 24) || 'request';\n if (row.phase !== 'done' && now - row.at > STALE_AFTER_MS) {\n return `x402 · ${operation}: stale, no outcome recorded`;\n }\n // `selecting service` is the demo's own word for a decision in flight, and a\n // stage the hook names for itself wins over it.\n const state =\n row.phase === 'routing'\n ? sanitize(row.outcome ?? 'selecting service', 40)\n : row.phase === 'calling'\n ? 'calling'\n : sanitize(row.outcome ?? 'done', 40);\n return (\n `x402 · ${operation}: ${state}` +\n (row.endpoint !== undefined ? ` ${sanitize(row.endpoint, 110)}` : '') +\n (row.parameters !== undefined ? ` · ${sanitize(row.parameters, 180)}` : '') +\n (row.price !== undefined ? ` · ${sanitize(row.price, 24)}` : '')\n );\n}\n\nasync function write(path: string, body: Stamp | SavedProgress): Promise<void> {\n try {\n await writeFileAtomic(path, JSON.stringify(body), { mode: 0o600, dirMode: 0o700 });\n } catch {\n // The footer is the only thing that can be lost here, by design.\n }\n}\n\n/** A marker's timestamp, or null for absent, damaged or not ours. */\nasync function readStamp(path: string): Promise<Stamp | null> {\n return stampOf(await readJson(path));\n}\n\nfunction stampOf(row: Record<string, unknown> | null): Stamp | null {\n if (row === null) return null;\n return row.version === 1 && typeof row.at === 'number' && Number.isFinite(row.at)\n ? { version: 1, at: row.at }\n : null;\n}\n\n/** A call record, or null. Every field is re-checked: what is on disk is input. */\nasync function readCall(path: string): Promise<SavedProgress | null> {\n const row = await readJson(path);\n const stamp = stampOf(row);\n if (row === null || stamp === null || typeof row.operation !== 'string') return null;\n if (!['routing', 'calling', 'done'].includes(row.phase as string)) return null;\n const optional = ['outcome', 'endpoint', 'parameters', 'price'] as const;\n if (!optional.every((key) => row[key] === undefined || typeof row[key] === 'string')) return null;\n return {\n ...stamp,\n phase: row.phase as ProgressPhase,\n operation: row.operation,\n ...Object.fromEntries(\n optional.filter((key) => row[key] !== undefined).map((key) => [key, row[key]]),\n ),\n };\n}\n\n/**\n * One bounded JSON object, or null. `O_NOFOLLOW` because these files live under\n * a directory the user can write: a symlink planted here must not turn a footer\n * read into a read of something else.\n */\nasync function readJson(path: string): Promise<Record<string, unknown> | null> {\n const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW).catch(() => undefined);\n if (file === undefined) return null;\n try {\n if ((await file.stat()).size > MAX_RECORD_BYTES) return null;\n const buffer = Buffer.alloc(MAX_RECORD_BYTES + 1);\n const { bytesRead } = await file.read(buffer, 0, buffer.length, 0);\n if (bytesRead > MAX_RECORD_BYTES) return null;\n const parsed: unknown = JSON.parse(buffer.subarray(0, bytesRead).toString('utf8'));\n return parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)\n ? null\n : (parsed as Record<string, unknown>);\n } catch {\n return null;\n } finally {\n await file.close().catch(() => undefined);\n }\n}\n"],"mappings":"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","names":[]}