tenjin-cli 0.1.0-alpha.20 → 0.1.0-alpha.22

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 (107) hide show
  1. package/README.md +18 -3
  2. package/dist/{chunk-LI44XLMB.js → chunk-2RMXTNLT.js} +5 -5
  3. package/dist/{chunk-5FYKPQNX.js → chunk-3Q3UBMVB.js} +3 -3
  4. package/dist/{chunk-3BS55ANY.js → chunk-AG4DWNHO.js} +50 -4
  5. package/dist/{chunk-3BS55ANY.js.map → chunk-AG4DWNHO.js.map} +1 -1
  6. package/dist/{chunk-P42QX3QF.js → chunk-B4GA3HAK.js} +2 -2
  7. package/dist/{chunk-P42QX3QF.js.map → chunk-B4GA3HAK.js.map} +1 -1
  8. package/dist/{chunk-NSG5TVZQ.js → chunk-CYEUVU3F.js} +14 -10
  9. package/dist/chunk-CYEUVU3F.js.map +1 -0
  10. package/dist/{chunk-RPR2C2JO.js → chunk-DA53QKTD.js} +5 -5
  11. package/dist/{chunk-YEBNE5NW.js → chunk-DHCOGDJB.js} +5 -5
  12. package/dist/{chunk-BTX2QE2Y.js → chunk-F4IJQBGP.js} +4 -4
  13. package/dist/chunk-GONDQ27X.js +337 -0
  14. package/dist/chunk-GONDQ27X.js.map +1 -0
  15. package/dist/{chunk-TU7XH3JJ.js → chunk-K6AXXYCG.js} +14 -2
  16. package/dist/chunk-K6AXXYCG.js.map +1 -0
  17. package/dist/{chunk-2G2WLVHB.js → chunk-LAIZ2AQA.js} +9 -4
  18. package/dist/chunk-LAIZ2AQA.js.map +1 -0
  19. package/dist/{chunk-YREKMJPP.js → chunk-NYJCBQL5.js} +65 -6
  20. package/dist/chunk-NYJCBQL5.js.map +1 -0
  21. package/dist/{chunk-HH3PDYIG.js → chunk-NZYVSZNF.js} +5 -5
  22. package/dist/{chunk-4M5FBWT5.js → chunk-QF4SSCQV.js} +10 -1
  23. package/dist/chunk-QF4SSCQV.js.map +1 -0
  24. package/dist/{chunk-CCDOV45D.js → chunk-SAN5PFTL.js} +126 -12
  25. package/dist/chunk-SAN5PFTL.js.map +1 -0
  26. package/dist/{chunk-LN2HISWU.js → chunk-TU3IK7KK.js} +2 -2
  27. package/dist/{chunk-4AS52HUG.js → chunk-U5FFVIIF.js} +138 -28
  28. package/dist/chunk-U5FFVIIF.js.map +1 -0
  29. package/dist/{chunk-PO4HAXAW.js → chunk-UAT3Q7VF.js} +112 -26
  30. package/dist/chunk-UAT3Q7VF.js.map +1 -0
  31. package/dist/chunk-UFCN7NCE.js +130 -0
  32. package/dist/chunk-UFCN7NCE.js.map +1 -0
  33. package/dist/{chunk-72UHZRG6.js → chunk-UGLTSPXQ.js} +2 -2
  34. package/dist/{chunk-5KD5HRAJ.js → chunk-UHEMZEGW.js} +3 -2
  35. package/dist/chunk-UHEMZEGW.js.map +1 -0
  36. package/dist/{chunk-2E6GVIRP.js → chunk-UIOZRILX.js} +47 -9
  37. package/dist/chunk-UIOZRILX.js.map +1 -0
  38. package/dist/{chunk-7ACHDNJA.js → chunk-WXFVJPZD.js} +13 -4
  39. package/dist/chunk-WXFVJPZD.js.map +1 -0
  40. package/dist/{chunk-CXUYCDPX.js → chunk-XBYTP4SP.js} +4 -4
  41. package/dist/{cli-XJQYUOHI.js → cli-5WM56Y7K.js} +43 -30
  42. package/dist/{cli-XJQYUOHI.js.map → cli-5WM56Y7K.js.map} +1 -1
  43. package/dist/{config-KMJLFPSI.js → config-JBF5BZNO.js} +10 -8
  44. package/dist/{doctor-KMN55D7U.js → doctor-6KHBE77P.js} +25 -16
  45. package/dist/{doctor-KMN55D7U.js.map → doctor-6KHBE77P.js.map} +1 -1
  46. package/dist/{fund-LT6ZPGEQ.js → fund-GSFCXEF7.js} +10 -11
  47. package/dist/{fund-LT6ZPGEQ.js.map → fund-GSFCXEF7.js.map} +1 -1
  48. package/dist/{hook-command-U5XPEHAJ.js → hook-command-UQZ4DVDL.js} +373 -82
  49. package/dist/hook-command-UQZ4DVDL.js.map +1 -0
  50. package/dist/index.js +4 -4
  51. package/dist/{install-MMNXJ5LM.js → install-TDYC22KI.js} +13 -11
  52. package/dist/{install-identity-B7FVIWML.js → install-identity-QS4UFF27.js} +7 -7
  53. package/dist/{install-wallet-XMVUBCHS.js → install-wallet-T737X74E.js} +9 -10
  54. package/dist/{install-wallet-XMVUBCHS.js.map → install-wallet-T737X74E.js.map} +1 -1
  55. package/dist/{mcp-TUPRIPSI.js → mcp-JWOOSKLX.js} +624 -69
  56. package/dist/mcp-JWOOSKLX.js.map +1 -0
  57. package/dist/{paths-LRMWNTJP.js → paths-MUXHUOCM.js} +8 -2
  58. package/dist/{pay-XAWW3NV3.js → pay-TDYQFSKY.js} +17 -16
  59. package/dist/payments-26NVMFR2.js +47 -0
  60. package/dist/payments-26NVMFR2.js.map +1 -0
  61. package/dist/{send-HESQYRKM.js → send-4RUBQQKP.js} +9 -10
  62. package/dist/{send-HESQYRKM.js.map → send-4RUBQQKP.js.map} +1 -1
  63. package/dist/{status-ANZPRZJJ.js → status-CEHZKHBU.js} +6 -6
  64. package/dist/{status-line-J3TUWVRQ.js → status-line-QRAO3Y2E.js} +7 -7
  65. package/dist/{status-line-wiring-HSV7DXO5.js → status-line-wiring-XKUVI5UW.js} +5 -5
  66. package/dist/tenjin-daemon.mjs +61 -7
  67. package/dist/{uninstall-GUU34YKP.js → uninstall-SJ6R2W2M.js} +11 -11
  68. package/dist/{update-KO2NZRJ5.js → update-N2NZS3AA.js} +6 -6
  69. package/dist/{wallet-3URC5QPK.js → wallet-IB2EFAUP.js} +9 -10
  70. package/docs/agent-permissions.md +11 -9
  71. package/docs/safety-model.md +3 -3
  72. package/package.json +1 -1
  73. package/dist/chunk-2E6GVIRP.js.map +0 -1
  74. package/dist/chunk-2G2WLVHB.js.map +0 -1
  75. package/dist/chunk-3KKKB2AQ.js +0 -40
  76. package/dist/chunk-3KKKB2AQ.js.map +0 -1
  77. package/dist/chunk-4AS52HUG.js.map +0 -1
  78. package/dist/chunk-4M5FBWT5.js.map +0 -1
  79. package/dist/chunk-5KD5HRAJ.js.map +0 -1
  80. package/dist/chunk-7ACHDNJA.js.map +0 -1
  81. package/dist/chunk-CCDOV45D.js.map +0 -1
  82. package/dist/chunk-NSG5TVZQ.js.map +0 -1
  83. package/dist/chunk-PO4HAXAW.js.map +0 -1
  84. package/dist/chunk-TU7XH3JJ.js.map +0 -1
  85. package/dist/chunk-YREKMJPP.js.map +0 -1
  86. package/dist/hook-command-U5XPEHAJ.js.map +0 -1
  87. package/dist/mcp-TUPRIPSI.js.map +0 -1
  88. /package/dist/{chunk-LI44XLMB.js.map → chunk-2RMXTNLT.js.map} +0 -0
  89. /package/dist/{chunk-5FYKPQNX.js.map → chunk-3Q3UBMVB.js.map} +0 -0
  90. /package/dist/{chunk-RPR2C2JO.js.map → chunk-DA53QKTD.js.map} +0 -0
  91. /package/dist/{chunk-YEBNE5NW.js.map → chunk-DHCOGDJB.js.map} +0 -0
  92. /package/dist/{chunk-BTX2QE2Y.js.map → chunk-F4IJQBGP.js.map} +0 -0
  93. /package/dist/{chunk-HH3PDYIG.js.map → chunk-NZYVSZNF.js.map} +0 -0
  94. /package/dist/{chunk-LN2HISWU.js.map → chunk-TU3IK7KK.js.map} +0 -0
  95. /package/dist/{chunk-72UHZRG6.js.map → chunk-UGLTSPXQ.js.map} +0 -0
  96. /package/dist/{chunk-CXUYCDPX.js.map → chunk-XBYTP4SP.js.map} +0 -0
  97. /package/dist/{config-KMJLFPSI.js.map → config-JBF5BZNO.js.map} +0 -0
  98. /package/dist/{install-MMNXJ5LM.js.map → install-TDYC22KI.js.map} +0 -0
  99. /package/dist/{install-identity-B7FVIWML.js.map → install-identity-QS4UFF27.js.map} +0 -0
  100. /package/dist/{paths-LRMWNTJP.js.map → paths-MUXHUOCM.js.map} +0 -0
  101. /package/dist/{pay-XAWW3NV3.js.map → pay-TDYQFSKY.js.map} +0 -0
  102. /package/dist/{status-ANZPRZJJ.js.map → status-CEHZKHBU.js.map} +0 -0
  103. /package/dist/{status-line-J3TUWVRQ.js.map → status-line-QRAO3Y2E.js.map} +0 -0
  104. /package/dist/{status-line-wiring-HSV7DXO5.js.map → status-line-wiring-XKUVI5UW.js.map} +0 -0
  105. /package/dist/{uninstall-GUU34YKP.js.map → uninstall-SJ6R2W2M.js.map} +0 -0
  106. /package/dist/{update-KO2NZRJ5.js.map → update-N2NZS3AA.js.map} +0 -0
  107. /package/dist/{wallet-3URC5QPK.js.map → wallet-IB2EFAUP.js.map} +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/paths.ts"],"sourcesContent":["import { homedir } from 'node:os';\nimport { join, resolve } from 'node:path';\n\n/**\n * Where the CLI keeps its config and wallet. Defaults to ~/.tenjin, overridable\n * via TENJIN_DATA_DIR (CI, ephemeral agents, and every test — which point it at\n * a temp dir so the real home is never touched).\n */\nexport function dataDir(env: NodeJS.ProcessEnv = process.env): string {\n const override = env.TENJIN_DATA_DIR;\n // Absolute, always: the daemon compares this string against its own\n // `data_dir` and is spawned with it as `cwd`, so a relative override must\n // mean the same directory from every process.\n if (override !== undefined && override.length > 0) return resolve(override);\n return defaultDataDir();\n}\n\n/**\n * The data dir a run with no override resolves. Split out of {@link dataDir} so\n * a caller holding a home directory can ask whether some other profile IS the\n * default one, without a second copy of the `.tenjin` literal.\n */\nexport function defaultDataDir(home: string = homedir()): string {\n return join(home, '.tenjin');\n}\n\nexport function configPath(dir: string = dataDir()): string {\n return join(dir, 'config.json');\n}\n\nexport function walletPath(dir: string = dataDir()): string {\n return join(dir, 'wallet.json');\n}\n\n/**\n * The anonymous install id sent to Tenjin as `X-Tenjin-Install` (lib/install-identity).\n * Under the data dir so it survives upgrades and reinstalls of the CLI itself.\n */\nexport function installIdPath(dir: string = dataDir()): string {\n return join(dir, 'install-id');\n}\n\n/**\n * Where the delegated P-256 session key + its wallet-signed SIWX delegation are\n * cached (B3, D35). A short-lived (≤24h) hot key: lower stakes than wallet.json,\n * but still written 0600 and address-bound so a wallet change invalidates it.\n */\nexport function sessionPath(dir: string = dataDir()): string {\n return join(dir, 'session.json');\n}\n\n/**\n * Where the client-side rolling spend ledger lives (lib/wallet/spend.ts).\n *\n * Its own file, NOT session.json: the two schemas are incompatible and both\n * readers treat a parse failure as \"absent\", so a shared path meant each writer\n * silently destroyed the other's file — a session key wiped the spend window, and\n * the next spend wiped the session key.\n */\nexport function spendLedgerPath(dir: string = dataDir()): string {\n return join(dir, 'spend.json');\n}\n\n/**\n * The wallet's last USDC balance read (lib/usdc-balance). A pure cache, a\n * minute long: an unreadable file is simply read again from the chain.\n */\nexport function balanceCachePath(dir: string = dataDir()): string {\n return join(dir, 'balance.json');\n}\n\n/**\n * Where the once-a-day \"a newer tenjin-cli exists\" check caches the registry\n * answer. A pure cache: nothing here is authoritative, so an unreadable file is\n * simply re-fetched.\n */\nexport function updateCheckPath(dir: string = dataDir()): string {\n return join(dir, 'update-check.json');\n}\n\n/**\n * Where `install` writes the standalone harness hook scripts. Under the data dir\n * rather than the harness's own config directory: the scripts are ours, a harness\n * only ever holds the path to them, and one location serves every harness.\n */\nexport function hooksDir(dir: string = dataDir()): string {\n return join(dir, 'hooks');\n}\n\n/**\n * How the marketplace has been answering the dispatch hook lately, so a run of\n * failures stops the arm instead of paying the fetch budget per subagent through\n * an outage. Hook-written, unlocked, and cheap to lose, since a missing file\n * reads as \"healthy\". Its own file because two hooks writing one unlocked file\n * would erase each other.\n */\nexport function hookHealthPath(dir: string = dataDir()): string {\n return join(dir, 'hook-health.json');\n}\n\n/**\n * Where the LEGACY (pre-per-wallet) Windows DPAPI passphrase blob lives. The\n * file holds a DPAPI CurrentUser ciphertext, not the passphrase in plaintext.\n * New writes go to the per-wallet path below; this one is only read as a\n * migration fallback and removed after a verified per-wallet copy exists.\n */\nexport function passphraseBlobPath(dir: string = dataDir()): string {\n return join(dir, 'passphrase.dpapi');\n}\n\n/**\n * The per-wallet Windows DPAPI passphrase blob: one file per wallet address\n * (lowercase), so creating a new wallet never clobbers an old wallet's blob.\n * Only ever written on win32; other platforms use their own OS store.\n */\nexport function passphraseBlobPathFor(account: string, dir: string = dataDir()): string {\n return join(dir, `passphrase.${account}.dpapi`);\n}\n\n/**\n * Where `wallet create --replace` parks the outgoing wallet's keystore, keyed by\n * its lowercase address so successive replaces can never collide. Together with\n * the wallet's per-address passphrase entry in the OS store, this file keeps the\n * replaced wallet's funds recoverable; it is never read by the active-wallet\n * path.\n */\nexport function archivedWalletPath(account: string, dir: string = dataDir()): string {\n return join(dir, `wallet.${account}.json.bak`);\n}\n\n/**\n * The loop daemon's own state, all under the data dir (tenjin-notes\n * loop-redesign/02-redesign.md §4, §10).\n */\nexport function loopDbPath(dir: string = dataDir()): string {\n return join(dir, 'loop.db');\n}\n\n/** 32 random bytes, hex, 0600. Minted by `tenjin daemon start`, rotated only by\n * reinstall, NEVER deleted by the daemon: every transport reads it, and an idle\n * exit that removed it would strand them all. */\nexport function daemonTokenPath(dir: string = dataDir()): string {\n return join(dir, 'daemon.token');\n}\n\n/** `{ pid, port, started_at, data_dir }`, advisory: written after the bind,\n * removed at exit only by the process whose pid it names. Liveness is\n * `GET /health`, never this file alone. */\nexport function daemonPidPath(dir: string = dataDir()): string {\n return join(dir, 'daemon.pid');\n}\n\n/** Where a detached daemon's stdout and stderr go, and where the shim writes its\n * one `daemon-down` line when it cannot reach one. */\nexport function daemonLogPath(dir: string = dataDir()): string {\n return join(dir, 'daemon.log');\n}\n\n/** An empty file whose mtime is the last spawn attempt; the shim's backoff. */\nexport function daemonSpawnPath(dir: string = dataDir()): string {\n return join(dir, 'daemon.spawn');\n}\n\n/** The single-file daemon bundle `tenjin daemon start` copies from `dist`. */\nexport function daemonBundlePath(dir: string = dataDir()): string {\n return join(hooksDir(dir), 'tenjin-daemon.mjs');\n}\n\n/** The ensure-and-forward shim the two `command` hook entries run. */\nexport function shimBundlePath(dir: string = dataDir()): string {\n return join(hooksDir(dir), 'tenjin-shim.mjs');\n}\n\n/** Tenjin's own vitest reporter, copied beside the bundles. NOT A HOOK ENTRY\n * and never spawned: a repo's own `vitest.config.ts` imports it by this\n * absolute path, which is why `doctor` can hint at it verbatim. */\nexport const VITEST_REPORTER_FILE = 'tenjin-vitest-reporter.mjs';\n\nexport function vitestReporterPath(dir: string = dataDir()): string {\n return join(hooksDir(dir), VITEST_REPORTER_FILE);\n}\n\n/**\n * Where a router lookup that bought a file (a sound, an image) saves it. The\n * bytes cannot ride in the tool result, so the result names this file instead.\n */\nexport function downloadsDir(dir: string = dataDir()): string {\n return join(dir, 'downloads');\n}\n\n/**\n * One JSON line per paid router call: what was bought, from whom, for how much,\n * the settlement it carried and the files it saved. The user's own record; only\n * reconcile reads it back (`tenjin payments reconcile`, and the `request` tool's\n * pass beside each lookup), to settle what was left unknown.\n */\nexport function paidLedgerPath(dir: string = dataDir()): string {\n return join(dir, 'paid', 'ledger.jsonl');\n}\n"],"mappings":";;;AAAA,SAAS,eAAe;AACxB,SAAS,MAAM,eAAe;AAOvB,SAAS,QAAQ,MAAyB,QAAQ,KAAa;AACpE,QAAM,WAAW,IAAI;AAIrB,MAAI,aAAa,UAAa,SAAS,SAAS,EAAG,QAAO,QAAQ,QAAQ;AAC1E,SAAO,eAAe;AACxB;AAOO,SAAS,eAAe,OAAe,QAAQ,GAAW;AAC/D,SAAO,KAAK,MAAM,SAAS;AAC7B;AAEO,SAAS,WAAW,MAAc,QAAQ,GAAW;AAC1D,SAAO,KAAK,KAAK,aAAa;AAChC;AAEO,SAAS,WAAW,MAAc,QAAQ,GAAW;AAC1D,SAAO,KAAK,KAAK,aAAa;AAChC;AAMO,SAAS,cAAc,MAAc,QAAQ,GAAW;AAC7D,SAAO,KAAK,KAAK,YAAY;AAC/B;AAOO,SAAS,YAAY,MAAc,QAAQ,GAAW;AAC3D,SAAO,KAAK,KAAK,cAAc;AACjC;AAUO,SAAS,gBAAgB,MAAc,QAAQ,GAAW;AAC/D,SAAO,KAAK,KAAK,YAAY;AAC/B;AAMO,SAAS,iBAAiB,MAAc,QAAQ,GAAW;AAChE,SAAO,KAAK,KAAK,cAAc;AACjC;AAOO,SAAS,gBAAgB,MAAc,QAAQ,GAAW;AAC/D,SAAO,KAAK,KAAK,mBAAmB;AACtC;AAOO,SAAS,SAAS,MAAc,QAAQ,GAAW;AACxD,SAAO,KAAK,KAAK,OAAO;AAC1B;AASO,SAAS,eAAe,MAAc,QAAQ,GAAW;AAC9D,SAAO,KAAK,KAAK,kBAAkB;AACrC;AAQO,SAAS,mBAAmB,MAAc,QAAQ,GAAW;AAClE,SAAO,KAAK,KAAK,kBAAkB;AACrC;AAOO,SAAS,sBAAsB,SAAiB,MAAc,QAAQ,GAAW;AACtF,SAAO,KAAK,KAAK,cAAc,OAAO,QAAQ;AAChD;AASO,SAAS,mBAAmB,SAAiB,MAAc,QAAQ,GAAW;AACnF,SAAO,KAAK,KAAK,UAAU,OAAO,WAAW;AAC/C;AAMO,SAAS,WAAW,MAAc,QAAQ,GAAW;AAC1D,SAAO,KAAK,KAAK,SAAS;AAC5B;AAKO,SAAS,gBAAgB,MAAc,QAAQ,GAAW;AAC/D,SAAO,KAAK,KAAK,cAAc;AACjC;AAKO,SAAS,cAAc,MAAc,QAAQ,GAAW;AAC7D,SAAO,KAAK,KAAK,YAAY;AAC/B;AAIO,SAAS,cAAc,MAAc,QAAQ,GAAW;AAC7D,SAAO,KAAK,KAAK,YAAY;AAC/B;AAGO,SAAS,gBAAgB,MAAc,QAAQ,GAAW;AAC/D,SAAO,KAAK,KAAK,cAAc;AACjC;AAGO,SAAS,iBAAiB,MAAc,QAAQ,GAAW;AAChE,SAAO,KAAK,SAAS,GAAG,GAAG,mBAAmB;AAChD;AAGO,SAAS,eAAe,MAAc,QAAQ,GAAW;AAC9D,SAAO,KAAK,SAAS,GAAG,GAAG,iBAAiB;AAC9C;AAKO,IAAM,uBAAuB;AAE7B,SAAS,mBAAmB,MAAc,QAAQ,GAAW;AAClE,SAAO,KAAK,SAAS,GAAG,GAAG,oBAAoB;AACjD;AAMO,SAAS,aAAa,MAAc,QAAQ,GAAW;AAC5D,SAAO,KAAK,KAAK,WAAW;AAC9B;AAQO,SAAS,eAAe,MAAc,QAAQ,GAAW;AAC9D,SAAO,KAAK,KAAK,QAAQ,cAAc;AACzC;","names":[]}
@@ -69,9 +69,12 @@ function assertPublicHttpsUrl(raw) {
69
69
  return url;
70
70
  }
71
71
  async function assertPublicDestination(raw, options = {}) {
72
+ return (await resolvePublicDestination(raw, options)).url;
73
+ }
74
+ async function resolvePublicDestination(raw, options = {}) {
72
75
  const url = assertPublicHttpsUrl(raw);
73
76
  const host = url.hostname.replace(/^\[|\]$/g, "");
74
- if (isIP(host) !== 0) return url;
77
+ if (isIP(host) !== 0) return { url, address: host, family: isIP(host) === 6 ? 6 : 4 };
75
78
  const resolve = options.resolveHostname ?? ((name) => lookup(name, { all: true }));
76
79
  const signal = AbortSignal.timeout(options.timeoutMs ?? 5e3);
77
80
  let addresses;
@@ -92,11 +95,13 @@ async function assertPublicDestination(raw, options = {}) {
92
95
  if (addresses.length === 0 || addresses.some((entry) => !isPublicAddress(entry.address))) {
93
96
  refuse(`The endpoint host ${host} resolves to a private or unsupported network address.`);
94
97
  }
95
- return url;
98
+ const first = addresses[0];
99
+ return { url, address: first.address, family: isIP(first.address) === 6 ? 6 : 4 };
96
100
  }
97
101
 
98
102
  export {
99
103
  isPublicAddress,
100
- assertPublicDestination
104
+ assertPublicDestination,
105
+ resolvePublicDestination
101
106
  };
102
- //# sourceMappingURL=chunk-2G2WLVHB.js.map
107
+ //# sourceMappingURL=chunk-LAIZ2AQA.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/destination.ts"],"sourcesContent":["import { lookup } from 'node:dns/promises';\nimport { BlockList, isIP } from 'node:net';\nimport { CliError } from './errors';\n\n/**\n * Where this CLI is willing to send a paid request. Ported from the draft\n * auto-mode experiment (PR #369 `execution.ts`) into a shared path, so the\n * router's provider call and `tenjin pay` answer the question the same way.\n *\n * TWO CHECKS, BOTH NEEDED. The lexical one refuses a URL shape that cannot be a\n * public endpoint (a scheme, credentials, a fragment, a literal private\n * address). The DNS one refuses a public-looking NAME that resolves onto the\n * local network, which is the shape a hostile registry listing or a hostile\n * routing decision would take.\n *\n * WHAT IT IS NOT. A resolved address is checked, NOT PINNED. `fetch` resolves\n * the name again on its own, so a host that answers publicly here and privately\n * a moment later is not closed by this, and neither is a remote scraper\n * following its own redirects on its own server. Closing the first needs a\n * transport that connects to the address it validated (`node:https` with a\n * `lookup` override, as the draft experiment's `safeHttpsTransport` did), which\n * the plan for this release left unported for the paid leg. The router's media\n * download does connect that way: it pins its socket to the address\n * {@link resolvePublicDestination} validated (`router/paid.ts`). What this does remove\n * is the easy local target: `http://`, credentials, a custom port, a literal\n * private address, a `.localhost`/`.internal` name, and a public name whose\n * only answers are private. Documented in docs/safety-model.md as a bound.\n */\n\nconst blockedV4 = new BlockList();\nfor (const [base, prefix] of [\n ['0.0.0.0', 8],\n ['10.0.0.0', 8],\n ['100.64.0.0', 10],\n ['127.0.0.0', 8],\n ['169.254.0.0', 16],\n ['172.16.0.0', 12],\n ['192.0.0.0', 24],\n ['192.0.2.0', 24],\n ['192.168.0.0', 16],\n ['198.18.0.0', 15],\n ['198.51.100.0', 24],\n ['203.0.113.0', 24],\n ['224.0.0.0', 4],\n ['240.0.0.0', 4],\n] as const) {\n blockedV4.addSubnet(base, prefix, 'ipv4');\n}\n\nconst blockedV6 = new BlockList();\nfor (const [base, prefix] of [\n ['::', 128],\n ['::1', 128],\n ['64:ff9b::', 96],\n ['100::', 64],\n ['2001:db8::', 32],\n ['fc00::', 7],\n ['fe80::', 10],\n ['ff00::', 8],\n] as const) {\n blockedV6.addSubnet(base, prefix, 'ipv6');\n}\n\n/** Is this literal address one a paid request may be sent to? IPv6 additionally\n * has to sit in the globally routable 2000::/3 range. */\nexport function isPublicAddress(value: string): boolean {\n const kind = isIP(value);\n if (kind === 4) return !blockedV4.check(value, 'ipv4');\n return kind === 6 && /^[23]/i.test(value) && !blockedV6.check(value, 'ipv6');\n}\n\nconst LOCAL_SUFFIX = /(?:^|\\.)(?:localhost|local|internal|home|lan)$/i;\n\nfunction refuse(message: string, details?: Record<string, unknown>): never {\n throw new CliError('USAGE', message, {\n fix: 'Paid requests go to public HTTPS endpoints only; nothing was signed.',\n ...(details !== undefined ? { details } : {}),\n });\n}\n\n/** The lexical half: the URL shape alone, no network. Returns the parsed URL. */\nexport function assertPublicHttpsUrl(raw: string): URL {\n let url: URL;\n try {\n url = new URL(raw);\n } catch {\n return refuse(`Invalid URL: ${JSON.stringify(raw.slice(0, 200))}`);\n }\n if (\n url.protocol !== 'https:' ||\n url.username !== '' ||\n url.password !== '' ||\n url.hash !== '' ||\n (url.port !== '' && url.port !== '443') ||\n raw.length > 16_384\n ) {\n refuse('Only public HTTPS endpoints without credentials, fragments or custom ports are paid.');\n }\n const host = url.hostname.replace(/^\\[|\\]$/g, '');\n if (!host.includes('.') && isIP(host) === 0) refuse('The endpoint host is not a public name.');\n if (LOCAL_SUFFIX.test(host)) refuse('Private or local destinations are not paid.');\n if (isIP(host) !== 0 && !isPublicAddress(host)) {\n refuse('Private or reserved IP destinations are not paid.');\n }\n return url;\n}\n\nexport interface DestinationOptions {\n /** Resolver seam; production leaves it unset and uses `dns.lookup`. */\n resolveHostname?: (hostname: string) => Promise<{ address: string; family: number }[]>;\n /** One deadline for the whole resolution, not per address. */\n timeoutMs?: number;\n}\n\n/**\n * The full preflight: the lexical check, then DNS. A literal address answered\n * the DNS question already and skips the lookup.\n */\nexport async function assertPublicDestination(\n raw: string,\n options: DestinationOptions = {},\n): Promise<URL> {\n return (await resolvePublicDestination(raw, options)).url;\n}\n\n/**\n * The same preflight, returning the ONE address it validated, for a transport\n * that connects to exactly that address instead of resolving the name again\n * (see the module comment). Every answer must be public, as above; the first\n * is the one to pin.\n */\nexport async function resolvePublicDestination(\n raw: string,\n options: DestinationOptions = {},\n): Promise<{ url: URL; address: string; family: 4 | 6 }> {\n const url = assertPublicHttpsUrl(raw);\n const host = url.hostname.replace(/^\\[|\\]$/g, '');\n if (isIP(host) !== 0) return { url, address: host, family: isIP(host) === 6 ? 6 : 4 };\n const resolve = options.resolveHostname ?? ((name: string) => lookup(name, { all: true }));\n const signal = AbortSignal.timeout(options.timeoutMs ?? 5_000);\n let addresses: { address: string; family: number }[];\n try {\n addresses = await Promise.race([\n resolve(host),\n new Promise<never>((_, reject) => {\n signal.addEventListener('abort', () => reject(new Error('DNS lookup timed out.')), {\n once: true,\n });\n }),\n ]);\n } catch (err) {\n return refuse(`The endpoint host ${host} could not be resolved.`, {\n cause: err instanceof Error ? err.message : String(err),\n });\n }\n if (addresses.length === 0 || addresses.some((entry) => !isPublicAddress(entry.address))) {\n refuse(`The endpoint host ${host} resolves to a private or unsupported network address.`);\n }\n const first = addresses[0]!;\n return { url, address: first.address, family: isIP(first.address) === 6 ? 6 : 4 };\n}\n"],"mappings":"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","names":[]}
@@ -6,7 +6,7 @@ import {
6
6
  evaluateSpendPolicy,
7
7
  readLedger,
8
8
  spentOf
9
- } from "./chunk-7ACHDNJA.js";
9
+ } from "./chunk-WXFVJPZD.js";
10
10
  import {
11
11
  withFileLock
12
12
  } from "./chunk-MEFB5KHA.js";
@@ -15,7 +15,7 @@ import {
15
15
  } from "./chunk-JLEF5WHM.js";
16
16
  import {
17
17
  spendLedgerPath
18
- } from "./chunk-TU7XH3JJ.js";
18
+ } from "./chunk-K6AXXYCG.js";
19
19
 
20
20
  // src/lib/wallet/spend.ts
21
21
  import { mkdir } from "node:fs/promises";
@@ -103,12 +103,26 @@ function createLocalSpendAuthorizer(deps) {
103
103
  const exposure = reservation !== void 0 ? BigInt(reservation.amountAtomic) : amountAtomic;
104
104
  const settled = opts.settledAtomic ?? exposure;
105
105
  const settledSoFar = BigInt(ledger.settledAtomic ?? ledger.committedAtomic);
106
+ const mode = reservation ? reservation.mode ?? "automatic" : opts.mode ?? "automatic";
106
107
  await persist({
107
108
  ...ledger,
108
109
  committedAtomic: (BigInt(ledger.committedAtomic) + exposure).toString(),
109
- automaticCommittedAtomic: (BigInt(ledger.automaticCommittedAtomic ?? ledger.committedAtomic) + ((reservation ? reservation.mode ?? "automatic" : opts.mode ?? "automatic") === "manual" ? 0n : exposure)).toString(),
110
+ automaticCommittedAtomic: (BigInt(ledger.automaticCommittedAtomic ?? ledger.committedAtomic) + (mode === "manual" ? 0n : exposure)).toString(),
110
111
  settledAtomic: (settledSoFar + settled).toString(),
111
- reservations: reservationId !== void 0 ? ledger.reservations.filter((r) => r.id !== reservationId) : ledger.reservations
112
+ reservations: reservationId !== void 0 ? ledger.reservations.filter((r) => r.id !== reservationId) : ledger.reservations,
113
+ // Keyed by the authorization's nonce, so a reconcile that proves it
114
+ // was never charged can release this amount and nothing else.
115
+ ...opts.nonce !== void 0 ? {
116
+ exposures: [
117
+ ...ledger.exposures ?? [],
118
+ {
119
+ nonce: opts.nonce.toLowerCase(),
120
+ amountAtomic: exposure.toString(),
121
+ atMs: now(),
122
+ mode
123
+ }
124
+ ]
125
+ } : {}
112
126
  });
113
127
  });
114
128
  },
@@ -124,8 +138,53 @@ function createLocalSpendAuthorizer(deps) {
124
138
  }
125
139
  };
126
140
  }
141
+ async function releaseUnchargedExposure(dir, nonce, opts = {}) {
142
+ const path = spendLedgerPath(dir);
143
+ const nowMs = (opts.now ?? Date.now)();
144
+ try {
145
+ return await withFileLock(`${path}.lock`, async () => {
146
+ const { ledger } = await readLedger(path);
147
+ if (ledger === null || nowMs - ledger.windowStartMs >= (opts.windowMs ?? DEFAULT_WINDOW_MS)) {
148
+ return 0n;
149
+ }
150
+ const key = nonce.toLowerCase();
151
+ const entry = (ledger.exposures ?? []).find((e) => e.nonce === key);
152
+ if (entry === void 0) return 0n;
153
+ const amount = BigInt(entry.amountAtomic);
154
+ const less = (value, fallback) => {
155
+ const current = BigInt(value ?? fallback);
156
+ return (current > amount ? current - amount : 0n).toString();
157
+ };
158
+ await writeFileAtomic(
159
+ path,
160
+ `${JSON.stringify(
161
+ {
162
+ ...ledger,
163
+ committedAtomic: less(ledger.committedAtomic, "0"),
164
+ ...entry.mode === "manual" ? {} : {
165
+ automaticCommittedAtomic: less(
166
+ ledger.automaticCommittedAtomic,
167
+ ledger.committedAtomic
168
+ )
169
+ },
170
+ settledAtomic: less(ledger.settledAtomic, ledger.committedAtomic),
171
+ exposures: (ledger.exposures ?? []).filter((e) => e.nonce !== key)
172
+ },
173
+ null,
174
+ 2
175
+ )}
176
+ `,
177
+ { mode: 384, dirMode: 448 }
178
+ );
179
+ return amount;
180
+ });
181
+ } catch {
182
+ return null;
183
+ }
184
+ }
127
185
 
128
186
  export {
129
- createLocalSpendAuthorizer
187
+ createLocalSpendAuthorizer,
188
+ releaseUnchargedExposure
130
189
  };
131
- //# sourceMappingURL=chunk-YREKMJPP.js.map
190
+ //# sourceMappingURL=chunk-NYJCBQL5.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/wallet/spend.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { randomUUID } from 'node:crypto';\nimport { writeFileAtomic } from '../atomic-json';\nimport { withFileLock } from '../lock';\nimport { spendLedgerPath } from '../paths';\nimport {\n DEFAULT_WINDOW_MS,\n emptyLedger,\n readLedger,\n RESERVATION_TTL_MS,\n spentOf,\n type Ledger,\n type Reservation,\n} from '../spend-ledger';\nimport {\n evaluateSpendPolicy,\n type PolicyReason,\n type SpendDecision,\n type SpendPolicy,\n type PaymentMode,\n} from '../policy';\nimport type { PolicyEnforcement } from './provider';\n\n/**\n * The spend-policy enforcement seam, deliberately in the WALLET PROVIDER layer,\n * BEFORE any signing/payment path, so a future hosted provider (Privy, B5)\n * inherits it: policy moves provider-side by swapping this local authorizer for\n * one the hosted signer enforces. The local authorizer is `client-only` (any\n * process that runs the CLI can edit config or the ledger), and it says so.\n *\n * sessionBudget is enforced ATOMICALLY across the per-command CLI processes an\n * agent spawns: `authorize` takes the file lock and, when a spend may proceed,\n * writes a pending RESERVATION that counts against the budget immediately. Two\n * concurrent authorizations therefore each see the other's reservation and the\n * second is denied, closing the check-then-pay TOCTOU. `commit` finalizes a\n * reservation into committed spend after settlement; `release` drops an unused\n * one (a decline or a failed payment). A reservation left dangling (a crash\n * between authorize and commit) self-expires after RESERVATION_TTL_MS.\n */\n\nexport interface SpendRequest {\n mode?: PaymentMode;\n amountAtomic: bigint;\n creator: string;\n /** The caller's `--max-price` cap, if any. */\n maxPriceAtomic?: bigint;\n /**\n * THE SAME-TURN DUPLICATE GUARD. An opaque identity for the request being\n * paid for (its destination and its exact arguments), recorded on the\n * reservation. A second authorization carrying a key an unexpired reservation\n * already holds is DENIED rather than reserved, so one in-flight payment can\n * never become two because a caller retried, a harness re-fired, or a second\n * process asked for the same thing. Same lock and same file as the budget, so\n * the check is atomic across the per-command processes an agent spawns; the\n * reservation TTL is what bounds \"same turn\". Omit it and nothing changes.\n */\n requestKey?: string;\n}\n\nexport interface SpendAuthorization {\n decision: SpendDecision;\n reason: PolicyReason;\n message: string;\n amountAtomic: bigint;\n sessionSpentAtomic: bigint;\n sessionBudgetAtomic: bigint | null;\n policyEnforcement: PolicyEnforcement;\n /** The pending reservation to commit (on settlement) or release (on abort).\n * Present when the spend may proceed, including an unlimited budget. */\n reservationId?: string;\n}\n\nexport interface SpendAuthorizer {\n policyEnforcement: PolicyEnforcement;\n /** Evaluate a spend against policy + the rolling session ledger, atomically\n * reserving budget when the spend may proceed. */\n authorize(req: SpendRequest): Promise<SpendAuthorization>;\n /**\n * Finalize a reservation into committed spend after settlement. Runs only\n * post-settlement, so `amountAtomic` is authoritative: if the reservation\n * TTL-expired mid-confirm (a human can out-wait RESERVATION_TTL_MS at the\n * prompt), the settled amount is still recorded rather than silently lost\n * from the rolling budget.\n */\n commit(\n reservationId: string | undefined,\n amountAtomic: bigint,\n /** What the counterparty reported actually taking, when it said so at all.\n * Omitted means \"assume it took what was authorized\", the conservative\n * reading every caller had before the router began waiving fees. */\n opts?: { settledAtomic?: bigint; mode?: PaymentMode; nonce?: string },\n ): Promise<void>;\n /** Drop an unused reservation (a decline, a 409, or a failed payment). */\n release(reservationId: string | undefined): Promise<void>;\n}\n\nexport interface LocalSpendAuthorizerDeps {\n dir: string;\n policy: SpendPolicy;\n /** Rolling window length (ms); default 24h. Injectable for tests. */\n windowMs?: number;\n /** Clock seam for deterministic window tests. */\n now?: () => number;\n /**\n * Called at most ONCE per authorizer when the ledger file exists but cannot be\n * read back. The reset below is fail-open by design, and a silent one hands back\n * budget the operator believes is already spent — so the caller gets to say so.\n */\n onCorrupt?: (reason: string) => void;\n}\n\nexport function createLocalSpendAuthorizer(deps: LocalSpendAuthorizerDeps): SpendAuthorizer {\n const windowMs = deps.windowMs ?? DEFAULT_WINDOW_MS;\n const now = deps.now ?? Date.now;\n const path = spendLedgerPath(deps.dir);\n const lockPath = `${path}.lock`;\n // One notice per authorizer: authorize and commit each read the file, and the\n // reset is not persisted until something is written, so an unlatched warning\n // would fire twice for the same broken file within one command.\n let warnedCorrupt = false;\n\n // Roll the window and drop expired reservations; returns the live ledger.\n const freshen = (ledger: Ledger | null, nowMs: number): Ledger => {\n if (ledger === null || nowMs - ledger.windowStartMs >= windowMs) return emptyLedger(nowMs);\n return {\n ...ledger,\n reservations: ledger.reservations.filter((r) => nowMs - r.atMs < RESERVATION_TTL_MS),\n };\n };\n\n const persist = async (ledger: Ledger): Promise<void> => {\n await writeFileAtomic(path, `${JSON.stringify(ledger, null, 2)}\\n`, {\n mode: 0o600,\n dirMode: 0o700,\n });\n };\n\n async function withLedger<T>(fn: (ledger: Ledger, nowMs: number) => Promise<T> | T): Promise<T> {\n await mkdir(deps.dir, { recursive: true, mode: 0o700 });\n return withFileLock(lockPath, async () => {\n const nowMs = now();\n const read = await readLedger(path);\n if (read.corrupt !== undefined && !warnedCorrupt) {\n warnedCorrupt = true;\n deps.onCorrupt?.(read.corrupt);\n }\n const ledger = freshen(read.ledger, nowMs);\n return fn(ledger, nowMs);\n });\n }\n\n return {\n policyEnforcement: 'client-only',\n async authorize(req: SpendRequest): Promise<SpendAuthorization> {\n return withLedger(async (ledger) => {\n const sessionSpentAtomic = spentOf(ledger);\n if (\n req.requestKey !== undefined &&\n ledger.reservations.some((r) => r.requestKey === req.requestKey)\n ) {\n return {\n decision: 'deny',\n reason: 'duplicate_in_flight',\n message:\n 'An identical request already holds a reservation in this turn. No second payment was made.',\n amountAtomic: req.amountAtomic,\n sessionSpentAtomic,\n sessionBudgetAtomic: deps.policy.sessionBudgetAtomic,\n policyEnforcement: 'client-only',\n };\n }\n const evaluation = evaluateSpendPolicy(deps.policy, {\n mode: req.mode ?? 'automatic',\n amountAtomic: req.amountAtomic,\n creator: req.creator,\n ...(req.maxPriceAtomic !== undefined ? { maxPriceAtomic: req.maxPriceAtomic } : {}),\n sessionSpentAtomic,\n });\n const base: SpendAuthorization = {\n ...evaluation,\n amountAtomic: req.amountAtomic,\n sessionSpentAtomic,\n sessionBudgetAtomic: deps.policy.sessionBudgetAtomic,\n policyEnforcement: 'client-only',\n };\n // Unlimited budgets still reserve to prevent identical in-flight requests.\n if (evaluation.decision === 'deny') {\n return base;\n }\n const reservation: Reservation = {\n id: randomUUID(),\n mode: req.mode ?? 'automatic',\n amountAtomic: req.amountAtomic.toString(),\n atMs: now(),\n ...(req.requestKey !== undefined ? { requestKey: req.requestKey } : {}),\n };\n await persist({ ...ledger, reservations: [...ledger.reservations, reservation] });\n return { ...base, reservationId: reservation.id };\n });\n },\n async commit(\n reservationId: string | undefined,\n amountAtomic: bigint,\n opts: { settledAtomic?: bigint; mode?: PaymentMode; nonce?: string } = {},\n ): Promise<void> {\n // Record transmitted exposure even if its reservation has expired.\n await withLedger(async (ledger) => {\n const reservation =\n reservationId !== undefined\n ? ledger.reservations.find((r) => r.id === reservationId)\n : undefined;\n const exposure =\n reservation !== undefined ? BigInt(reservation.amountAtomic) : amountAtomic;\n // TWO NUMBERS, ON PURPOSE. The budget keeps counting what left; the\n // settled total records what was taken, and they differ whenever a\n // counterparty waives a fee against an authorization already sent.\n const settled = opts.settledAtomic ?? exposure;\n const settledSoFar = BigInt(ledger.settledAtomic ?? ledger.committedAtomic);\n const mode = reservation ? (reservation.mode ?? 'automatic') : (opts.mode ?? 'automatic');\n await persist({\n ...ledger,\n committedAtomic: (BigInt(ledger.committedAtomic) + exposure).toString(),\n automaticCommittedAtomic: (\n BigInt(ledger.automaticCommittedAtomic ?? ledger.committedAtomic) +\n (mode === 'manual' ? 0n : exposure)\n ).toString(),\n settledAtomic: (settledSoFar + settled).toString(),\n reservations:\n reservationId !== undefined\n ? ledger.reservations.filter((r) => r.id !== reservationId)\n : ledger.reservations,\n // Keyed by the authorization's nonce, so a reconcile that proves it\n // was never charged can release this amount and nothing else.\n ...(opts.nonce !== undefined\n ? {\n exposures: [\n ...(ledger.exposures ?? []),\n {\n nonce: opts.nonce.toLowerCase(),\n amountAtomic: exposure.toString(),\n atMs: now(),\n mode,\n },\n ],\n }\n : {}),\n });\n });\n },\n async release(reservationId: string | undefined): Promise<void> {\n if (reservationId === undefined) return;\n await withLedger(async (ledger) => {\n if (!ledger.reservations.some((r) => r.id === reservationId)) return;\n await persist({\n ...ledger,\n reservations: ledger.reservations.filter((r) => r.id !== reservationId),\n });\n });\n },\n };\n}\n\n/**\n * GIVE BACK A PAYMENT THE CHAIN PROVED WAS NEVER CHARGED: its authorization\n * expired unused. Exactly the exposure recorded under that nonce comes off the\n * committed totals, once; a nonce from an earlier window, from a ledger an\n * older build wrote, or one already released finds nothing and changes\n * nothing. Returns the amount released, or null when the ledger could not be\n * updated, so the caller keeps the payment open and asks again.\n */\nexport async function releaseUnchargedExposure(\n dir: string,\n nonce: string,\n opts: { now?: () => number; windowMs?: number } = {},\n): Promise<bigint | null> {\n const path = spendLedgerPath(dir);\n const nowMs = (opts.now ?? Date.now)();\n try {\n return await withFileLock(`${path}.lock`, async () => {\n const { ledger } = await readLedger(path);\n if (ledger === null || nowMs - ledger.windowStartMs >= (opts.windowMs ?? DEFAULT_WINDOW_MS)) {\n return 0n;\n }\n const key = nonce.toLowerCase();\n const entry = (ledger.exposures ?? []).find((e) => e.nonce === key);\n if (entry === undefined) return 0n;\n const amount = BigInt(entry.amountAtomic);\n const less = (value: string | undefined, fallback: string): string => {\n const current = BigInt(value ?? fallback);\n return (current > amount ? current - amount : 0n).toString();\n };\n await writeFileAtomic(\n path,\n `${JSON.stringify(\n {\n ...ledger,\n committedAtomic: less(ledger.committedAtomic, '0'),\n ...(entry.mode === 'manual'\n ? {}\n : {\n automaticCommittedAtomic: less(\n ledger.automaticCommittedAtomic,\n ledger.committedAtomic,\n ),\n }),\n settledAtomic: less(ledger.settledAtomic, ledger.committedAtomic),\n exposures: (ledger.exposures ?? []).filter((e) => e.nonce !== key),\n },\n null,\n 2,\n )}\\n`,\n { mode: 0o600, dirMode: 0o700 },\n );\n return amount;\n });\n } catch {\n return null;\n }\n}\n\nexport { readSpendSummary, type SpendSummary } from '../spend-ledger';\n"],"mappings":"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","names":[]}
@@ -1,20 +1,20 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
2
  import {
3
3
  emitNotice
4
- } from "./chunk-72UHZRG6.js";
4
+ } from "./chunk-UGLTSPXQ.js";
5
5
  import {
6
6
  external_exports,
7
7
  loadConfig
8
- } from "./chunk-CCDOV45D.js";
8
+ } from "./chunk-SAN5PFTL.js";
9
9
  import {
10
10
  package_default
11
- } from "./chunk-P42QX3QF.js";
11
+ } from "./chunk-B4GA3HAK.js";
12
12
  import {
13
13
  writeFileAtomic
14
14
  } from "./chunk-JLEF5WHM.js";
15
15
  import {
16
16
  updateCheckPath
17
- } from "./chunk-TU7XH3JJ.js";
17
+ } from "./chunk-K6AXXYCG.js";
18
18
 
19
19
  // src/lib/update-check.ts
20
20
  import { readFile } from "node:fs/promises";
@@ -191,4 +191,4 @@ export {
191
191
  fetchDistTags,
192
192
  isNewer
193
193
  };
194
- //# sourceMappingURL=chunk-HH3PDYIG.js.map
194
+ //# sourceMappingURL=chunk-NZYVSZNF.js.map
@@ -132,6 +132,14 @@ async function claimRedirect(dataDir, sessionId, agentId, target, now = Date.now
132
132
  return false;
133
133
  }
134
134
  }
135
+ async function redirectClaimed(dataDir, sessionId, agentId, target, now = Date.now()) {
136
+ const window = Math.floor(now / EXPIRY_MS);
137
+ for (const at of [window, window - 1]) {
138
+ const stamp = await readStamp(redirectPath(dataDir, sessionId, agentId, target, at));
139
+ if (stamp !== null && now - stamp.at <= EXPIRY_MS) return true;
140
+ }
141
+ return false;
142
+ }
135
143
  async function resolveProgressSession(dataDir, opts = {}) {
136
144
  const now = opts.now ?? Date.now();
137
145
  const root = join(dataDir, PROGRESS_DIR);
@@ -359,10 +367,11 @@ export {
359
367
  augmentOf,
360
368
  claimQuery,
361
369
  claimRedirect,
370
+ redirectClaimed,
362
371
  writeProgress,
363
372
  openLookupFooter,
364
373
  pruneProgress,
365
374
  pruneSessions,
366
375
  renderProgress
367
376
  };
368
- //# sourceMappingURL=chunk-4M5FBWT5.js.map
377
+ //# sourceMappingURL=chunk-QF4SSCQV.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 { lstat, open, opendir, rm } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { writeFileAtomic, writeFileAtomicExclusive } 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. Two markers are read back by the hooks, the offer\n * mark and the redirect claims, and both only ever make a hook say less: losing\n * either routes a call exactly as a session with no record would, and a claim\n * that cannot be written denies nothing. The free-docs\n * records are the same kind: a lost augment marker is a search with no docs\n * added, and a lost query claim is one more free fetch.\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/** A pre-call redirect's marker, keyed by the harness's `tool_use_id`. */\nconst OFFER_PREFIX = 'offer-';\n/** The session's own liveness touch, likewise outside the call-record pattern. */\nconst SESSION_FILE = 'session.json';\n/** A pre-call redirect, one file per agent and target in the session. */\nconst REDIRECT_PREFIX = 'redirect-';\n/** A search the pre-call hook is adding free docs to, keyed by its `tool_use_id`. */\nconst AUGMENT_PREFIX = 'augment-';\n/** What the docs prefetch got, beside its marker. The provider's text sets its\n * size, so it is never read as a record: it ages by its mtime. */\nconst AUGMENT_BODY_SUFFIX = '.docs';\n/** One agent's search query that was augmented, so the same one is not fetched twice. */\nconst QUERY_PREFIX = 'query-';\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/** How long one agent's identical search is not given the same docs again. */\nexport const AUGMENT_REPEAT_MS = 5 * 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\n/** A search being given free docs, and whose docs they are. */\ninterface SavedAugment extends Stamp {\n provider: 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 * ONE ROUTING ANSWER PER LOOKUP. The pre-call hook marks the native call it\n * redirected, by the harness's own `tool_use_id`, and the after-call hook reads\n * the mark before it asks again about the same call. Expires and is pruned like every\n * other record here.\n */\nexport async function markOffered(\n dataDir: string,\n sessionId: string,\n toolUseId: string,\n now = Date.now(),\n): Promise<void> {\n await write(join(sessionDir(dataDir, sessionId), `${OFFER_PREFIX}${digest(toolUseId)}.json`), {\n version: 1,\n at: now,\n });\n}\n\nexport async function wasOffered(\n dataDir: string,\n sessionId: string,\n toolUseId: string,\n now = Date.now(),\n): Promise<boolean> {\n const path = join(sessionDir(dataDir, sessionId), `${OFFER_PREFIX}${digest(toolUseId)}.json`);\n const stamp = await readStamp(path);\n return stamp !== null && now - stamp.at <= EXPIRY_MS;\n}\n\n/**\n * FREE DOCS BESIDE A SEARCH. The pre-call hook marks the search it let run with\n * a free offer, by the harness's own `tool_use_id` and with the provider's name\n * for the line the after-call hook writes, and returns where the prefetch puts\n * what it got: beside the marker, under the same key. Null when the marker could\n * not be written, since nothing could then find the body.\n */\nexport async function markAugment(\n dataDir: string,\n sessionId: string,\n toolUseId: string,\n provider: string,\n now = Date.now(),\n): Promise<string | null> {\n const base = join(sessionDir(dataDir, sessionId), `${AUGMENT_PREFIX}${digest(toolUseId)}`);\n const saved: SavedAugment = { version: 1, at: now, provider: sanitize(provider, 60) };\n return (await write(`${base}.json`, saved)) ? `${base}${AUGMENT_BODY_SUFFIX}` : null;\n}\n\n/** The marker {@link markAugment} left for this call, or null when it left none. */\nexport async function augmentOf(\n dataDir: string,\n sessionId: string,\n toolUseId: string,\n now = Date.now(),\n): Promise<{ at: number; provider: string; body: string } | null> {\n const base = join(sessionDir(dataDir, sessionId), `${AUGMENT_PREFIX}${digest(toolUseId)}`);\n const row = await readJson(`${base}.json`);\n const stamp = stampOf(row);\n if (row === null || stamp === null || now - stamp.at > EXPIRY_MS) return null;\n const provider = typeof row.provider === 'string' ? sanitize(row.provider, 60) : '';\n return { at: stamp.at, provider, body: `${base}${AUGMENT_BODY_SUFFIX}` };\n}\n\n/**\n * ONE FETCH PER QUERY. True when this agent has not had this exact search\n * augmented in the last {@link AUGMENT_REPEAT_MS}, and the claim is now its:\n * the create is exclusive, so two parallel copies of one search fetch once.\n */\nexport async function claimQuery(\n dataDir: string,\n sessionId: string,\n agentId: string | undefined,\n query: string,\n now = Date.now(),\n): Promise<boolean> {\n const key = digest(JSON.stringify([agentId ?? '', query]));\n const path = join(sessionDir(dataDir, sessionId), `${QUERY_PREFIX}${key}.json`);\n const stamp: Stamp = { version: 1, at: now };\n try {\n await writeFileAtomicExclusive(path, JSON.stringify(stamp), { mode: 0o600, dirMode: 0o700 });\n return true;\n } catch {\n // Taken: by a recent search, which wins, or by an old one, which does not.\n }\n const last = await readStamp(path);\n if (last === null || now - last.at <= AUGMENT_REPEAT_MS) return false;\n return write(path, stamp);\n}\n\n/**\n * ONE RECORD PER AGENT, TARGET AND WINDOW. Subagents share the session id, so\n * the agent is in the key, and the main agent's part is the empty string, which\n * no `agent_id` can be: the decoder refuses an empty one. The target is in it\n * too, one file each, so parallel calls never share a record: one call's\n * redirect can be neither overwritten nor spent by another's. And so is the\n * {@link EXPIRY_MS} window the claim was made in, so a claim is only ever\n * created, never replaced: see {@link claimRedirect}.\n */\nfunction redirectPath(\n dataDir: string,\n sessionId: string,\n agentId: string | undefined,\n target: string,\n window: number,\n): string {\n const key = digest(JSON.stringify([agentId ?? '', target, window]));\n return join(sessionDir(dataDir, sessionId), `${REDIRECT_PREFIX}${key}.json`);\n}\n\n/**\n * NEVER REDIRECTED TWICE FOR ONE TARGET. True, once, when this agent has not\n * been redirected on this exact search or URL in the last {@link EXPIRY_MS},\n * and the claim is now its; the pre-call hook denies only on true. So the\n * agent's own retry of a redirected call runs, whether the lookup it was sent\n * to delivered, failed or was never called, and whatever other calls ran in\n * between.\n *\n * ONLY EVER AN EXCLUSIVE CREATE. Replacing an expired claim let two parallel\n * copies of one call both read the old stamp and both write, and both deny.\n * The claim's file is named by its window instead, so the one create per\n * window decides, and the previous window's claim, while it is still inside\n * {@link EXPIRY_MS}, is read and never touched: a claim made just before a\n * boundary still lasts its full span. A claim that cannot be written is false:\n * the call runs.\n */\nexport async function claimRedirect(\n dataDir: string,\n sessionId: string,\n agentId: string | undefined,\n target: string,\n now = Date.now(),\n): Promise<boolean> {\n const window = Math.floor(now / EXPIRY_MS);\n const previous = await readStamp(redirectPath(dataDir, sessionId, agentId, target, window - 1));\n if (previous !== null && now - previous.at <= EXPIRY_MS) return false;\n const stamp: Stamp = { version: 1, at: now };\n try {\n await writeFileAtomicExclusive(\n redirectPath(dataDir, sessionId, agentId, target, window),\n JSON.stringify(stamp),\n { mode: 0o600, dirMode: 0o700 },\n );\n return true;\n } catch {\n // Taken in this window, which is always inside EXPIRY_MS, or not writable.\n return false;\n }\n}\n\n/**\n * THE READ HALF OF {@link claimRedirect}: true when this agent already holds a\n * live claim on this exact search or URL. The pre-call arms ask it BEFORE the\n * router, so the retry of a call they already redirected, which they would\n * only withhold, costs no decision and leaves no offer nobody sees. It never\n * writes and never decides on its own: a false here still goes through the\n * exclusive create, which is what keeps two parallel copies to one deny.\n */\nexport async function redirectClaimed(\n dataDir: string,\n sessionId: string,\n agentId: string | undefined,\n target: string,\n now = Date.now(),\n): Promise<boolean> {\n const window = Math.floor(now / EXPIRY_MS);\n for (const at of [window, window - 1]) {\n const stamp = await readStamp(redirectPath(dataDir, sessionId, agentId, target, at));\n if (stamp !== null && now - stamp.at <= EXPIRY_MS) return true;\n }\n return false;\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 path = join(directory, entry.name);\n const record = agesByMtime(entry.name) ? await mtimeOf(path) : await readStamp(path);\n if (record === null || now - record.at > EXPIRY_MS) {\n await rm(path, { force: true }).catch(() => undefined);\n }\n }\n } catch {\n // Housekeeping only. Nothing downstream depends on it having run.\n }\n}\n\n/**\n * A FILE THAT IS NOT A WHOLE RECORD is aged by its mtime, never read as one: a\n * temp file between its write and its rename (every writer here names them\n * `.<name>.<suffix>`), and a docs body, whose size is the provider's. Read as\n * records they are damaged, and the prune deleted them out from under a\n * parallel hook's rename.\n */\nfunction agesByMtime(name: string): boolean {\n return name.startsWith('.') || (name.startsWith(AUGMENT_PREFIX) && !name.endsWith('.json'));\n}\n\nasync function mtimeOf(path: string): Promise<Stamp | null> {\n try {\n return { version: 1, at: (await lstat(path)).mtimeMs };\n } catch {\n return null;\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\n/** Whether it landed. Every caller but the augment marker ignores the answer. */\nasync function write(path: string, body: Stamp | SavedProgress | SavedAugment): Promise<boolean> {\n try {\n await writeFileAtomic(path, JSON.stringify(body), { mode: 0o600, dirMode: 0o700 });\n return true;\n } catch {\n // The footer is the only thing that can be lost here, by design.\n return false;\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":[]}
@@ -1,11 +1,13 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
2
  import {
3
3
  CliError,
4
- HARNESSES
4
+ HARNESSES,
5
+ writeFileAtomic
5
6
  } from "./chunk-JLEF5WHM.js";
6
7
  import {
8
+ balanceCachePath,
7
9
  configPath
8
- } from "./chunk-TU7XH3JJ.js";
10
+ } from "./chunk-K6AXXYCG.js";
9
11
  import {
10
12
  __export
11
13
  } from "./chunk-ZXTAQYNA.js";
@@ -14539,8 +14541,100 @@ function knownDeploymentOrigins() {
14539
14541
  return [...KNOWN_DEPLOYMENT_ORIGINS];
14540
14542
  }
14541
14543
 
14542
- // src/lib/config.ts
14544
+ // src/lib/usdc-balance.ts
14543
14545
  import { readFile } from "node:fs/promises";
14546
+ var USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
14547
+ var BALANCE_OF_SELECTOR = "0x70a08231";
14548
+ var ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
14549
+ var WORD_RE = /^0x[0-9a-fA-F]{64}$/;
14550
+ async function readUsdcBalance(address, rpcUrl, opts) {
14551
+ if (!ADDRESS_RE.test(address) || opts.timeoutMs <= 0) return null;
14552
+ try {
14553
+ const res = await (opts.fetchImpl ?? fetch)(rpcUrl, {
14554
+ method: "POST",
14555
+ headers: { "content-type": "application/json" },
14556
+ body: JSON.stringify({
14557
+ jsonrpc: "2.0",
14558
+ id: 1,
14559
+ method: "eth_call",
14560
+ params: [
14561
+ {
14562
+ to: USDC_ADDRESS,
14563
+ data: `${BALANCE_OF_SELECTOR}${address.slice(2).toLowerCase().padStart(64, "0")}`
14564
+ },
14565
+ "latest"
14566
+ ]
14567
+ }),
14568
+ signal: AbortSignal.timeout(opts.timeoutMs)
14569
+ });
14570
+ if (!res.ok) return null;
14571
+ const result = (await res.json())?.result;
14572
+ return typeof result === "string" && WORD_RE.test(result) ? BigInt(result) : null;
14573
+ } catch {
14574
+ return null;
14575
+ }
14576
+ }
14577
+ var DEFAULT_RPC_URL = "https://mainnet.base.org";
14578
+ var FALLBACK_RPC_URLS = [
14579
+ "https://base-rpc.publicnode.com",
14580
+ "https://base.drpc.org"
14581
+ ];
14582
+ async function readUsdcBalanceWithFallback(address, rpcUrl, opts) {
14583
+ const urls = sameUrl(rpcUrl, DEFAULT_RPC_URL) ? [rpcUrl, ...FALLBACK_RPC_URLS] : [rpcUrl];
14584
+ const deadline = Date.now() + opts.timeoutMs;
14585
+ for (const [index, url2] of urls.entries()) {
14586
+ const left = deadline - Date.now();
14587
+ if (left <= 0) return null;
14588
+ const timeoutMs = index === urls.length - 1 ? left : Math.ceil(left / 2);
14589
+ const balance = await readUsdcBalance(address, url2, { ...opts, timeoutMs });
14590
+ if (balance !== null) return balance;
14591
+ }
14592
+ return null;
14593
+ }
14594
+ function sameUrl(a, b) {
14595
+ try {
14596
+ return new URL(a).href === new URL(b).href;
14597
+ } catch {
14598
+ return a === b;
14599
+ }
14600
+ }
14601
+ var LAST_KNOWN_BALANCE_MS = 6e4;
14602
+ function rememberingBalanceReader(dataDir, opts = {}) {
14603
+ const read = opts.read ?? readUsdcBalanceWithFallback;
14604
+ const now = opts.now ?? Date.now;
14605
+ const path = balanceCachePath(dataDir);
14606
+ return async (address, rpcUrl, readOpts) => {
14607
+ const remembered = await recallBalance(path, address, now());
14608
+ if (remembered !== null) return remembered;
14609
+ const live = await read(address, rpcUrl, readOpts);
14610
+ if (live === null) return null;
14611
+ const record2 = {
14612
+ version: 1,
14613
+ address: address.toLowerCase(),
14614
+ atomic: live.toString(),
14615
+ at: now()
14616
+ };
14617
+ try {
14618
+ await writeFileAtomic(path, JSON.stringify(record2), { mode: 384, dirMode: 448 });
14619
+ } catch {
14620
+ }
14621
+ return live;
14622
+ };
14623
+ }
14624
+ async function recallBalance(path, address, now) {
14625
+ try {
14626
+ const row = JSON.parse(await readFile(path, "utf8"));
14627
+ if (row?.version !== 1 || row.address !== address.toLowerCase() || typeof row.atomic !== "string" || !/^\d{1,40}$/.test(row.atomic) || typeof row.at !== "number" || now - row.at < 0 || now - row.at > LAST_KNOWN_BALANCE_MS) {
14628
+ return null;
14629
+ }
14630
+ return BigInt(row.atomic);
14631
+ } catch {
14632
+ return null;
14633
+ }
14634
+ }
14635
+
14636
+ // src/lib/config.ts
14637
+ import { readFile as readFile2 } from "node:fs/promises";
14544
14638
  var atomicString = external_exports.string().regex(/^\d+$/, "expected an atomic USDC integer string");
14545
14639
  var PublishModeSchema = external_exports.enum(["review", "auto", "full-auto"]);
14546
14640
  var AckServerWarningsSchema = external_exports.enum(["mode", "on", "off"]);
@@ -14609,6 +14703,7 @@ var LoopConfigSchema = external_exports.object({
14609
14703
  });
14610
14704
  var PublicFallbackSchema = external_exports.enum(["on", "off"]);
14611
14705
  var TeamConfigSchema = external_exports.object({ publicFallback: PublicFallbackSchema });
14706
+ var ExperimentalConfigSchema = external_exports.object({ bazaar: PublicFallbackSchema });
14612
14707
  function parsePublicFallbackFlag(value, keyName) {
14613
14708
  const parsed = PublicFallbackSchema.safeParse(value);
14614
14709
  if (parsed.success) return parsed.data;
@@ -14731,7 +14826,8 @@ var ConfigSchema = external_exports.object({
14731
14826
  update: UpdateConfigSchema,
14732
14827
  loop: LoopConfigSchema,
14733
14828
  team: TeamConfigSchema,
14734
- router: RouterConfigSchema
14829
+ router: RouterConfigSchema,
14830
+ experimental: ExperimentalConfigSchema
14735
14831
  });
14736
14832
  var RawInstallConfigSchema = InstallConfigSchema.partial().extend({
14737
14833
  harness: RawInstallHarnessSchema.optional(),
@@ -14744,7 +14840,8 @@ var RawConfigSchema = ConfigSchema.partial().extend({
14744
14840
  update: UpdateConfigSchema.partial().passthrough().optional(),
14745
14841
  loop: LoopConfigSchema.partial().passthrough().optional(),
14746
14842
  team: TeamConfigSchema.partial().passthrough().optional(),
14747
- router: RouterLayerSchema.passthrough().optional()
14843
+ router: RouterLayerSchema.passthrough().optional(),
14844
+ experimental: ExperimentalConfigSchema.partial().passthrough().optional()
14748
14845
  }).passthrough();
14749
14846
  function resolveGrantDeclined(value) {
14750
14847
  return value ?? [];
@@ -14770,7 +14867,7 @@ var CONFIG_DEFAULTS = {
14770
14867
  publicShelfUrl: PRODUCTION_ORIGIN,
14771
14868
  // Empty = public mode. Setting it is the whole of "turn on team mode".
14772
14869
  shelfBypassSecret: "",
14773
- rpcUrl: "https://mainnet.base.org",
14870
+ rpcUrl: DEFAULT_RPC_URL,
14774
14871
  evalCohort: false,
14775
14872
  bazaarRegistries: DEFAULT_BAZAAR_REGISTRIES,
14776
14873
  publish: { mode: "review", defaultPrice: "100000", ackServerWarnings: "mode" },
@@ -14796,7 +14893,8 @@ var CONFIG_DEFAULTS = {
14796
14893
  port: null
14797
14894
  },
14798
14895
  team: { publicFallback: "on" },
14799
- router: { enabled: true, context: "session" }
14896
+ router: { enabled: true, context: "session" },
14897
+ experimental: { bazaar: "off" }
14800
14898
  };
14801
14899
  var NESTED_CONFIG_KEYS = /* @__PURE__ */ new Set([
14802
14900
  "publish",
@@ -14805,7 +14903,8 @@ var NESTED_CONFIG_KEYS = /* @__PURE__ */ new Set([
14805
14903
  "update",
14806
14904
  "loop",
14807
14905
  "team",
14808
- "router"
14906
+ "router",
14907
+ "experimental"
14809
14908
  ]);
14810
14909
  var CONFIG_KEYS = Object.keys(CONFIG_DEFAULTS).filter(
14811
14910
  (key) => !NESTED_CONFIG_KEYS.has(key)
@@ -14826,6 +14925,7 @@ var LOOP_CONFIG_KEYS = [
14826
14925
  "loop.port"
14827
14926
  ];
14828
14927
  var TEAM_CONFIG_KEYS = ["team.publicFallback"];
14928
+ var EXPERIMENTAL_CONFIG_KEYS = ["experimental.bazaar"];
14829
14929
  var ROUTER_CONFIG_KEYS = ["router.enabled", "router.context"];
14830
14930
  var RETIRED_PAYMENT_KEYS = ["bazaarPay", "confirm"];
14831
14931
  var RETIRED_PAYMENT_GUIDANCE = "Retired payment settings no longer control payments. Use router.enabled, maxAutoSpend and sessionBudget for automatic routing; manual pay always requires consent. Run tenjin install to remove retired keys.";
@@ -14836,7 +14936,7 @@ async function loadRawConfig(dir) {
14836
14936
  const path = configPath(dir);
14837
14937
  let raw;
14838
14938
  try {
14839
- raw = await readFile(path, "utf8");
14939
+ raw = await readFile2(path, "utf8");
14840
14940
  } catch (err) {
14841
14941
  if (isNotFound(err)) return {};
14842
14942
  throw new CliError("CONFIG_INVALID", `Could not read config at ${path}`, {
@@ -14885,6 +14985,9 @@ async function loadConfig(dir) {
14885
14985
  router: {
14886
14986
  enabled: raw.router?.enabled ?? CONFIG_DEFAULTS.router.enabled,
14887
14987
  context: raw.router?.context ?? CONFIG_DEFAULTS.router.context
14988
+ },
14989
+ experimental: {
14990
+ bazaar: raw.experimental?.bazaar ?? CONFIG_DEFAULTS.experimental.bazaar
14888
14991
  }
14889
14992
  };
14890
14993
  }
@@ -14916,7 +15019,8 @@ function resolveSettings(input) {
14916
15019
  hooks: resolveHookSettings(config2),
14917
15020
  updateMode: resolveUpdateMode(config2),
14918
15021
  loop: resolveLoopSettings(config2),
14919
- teamPublicFallback: resolveTeamPublicFallback(config2)
15022
+ teamPublicFallback: resolveTeamPublicFallback(config2),
15023
+ experimentalBazaar: resolveExperimentalBazaar(config2)
14920
15024
  };
14921
15025
  }
14922
15026
  function resolveLoopSettings(config2) {
@@ -14933,6 +15037,11 @@ function resolveLoopSettings(config2) {
14933
15037
  port: one("port")
14934
15038
  };
14935
15039
  }
15040
+ function resolveExperimentalBazaar(config2) {
15041
+ const fromFile = config2.experimental?.bazaar;
15042
+ if (fromFile !== void 0) return { value: fromFile, source: "file" };
15043
+ return { value: CONFIG_DEFAULTS.experimental.bazaar, source: "default" };
15044
+ }
14936
15045
  function resolveTeamPublicFallback(config2) {
14937
15046
  const fromFile = config2.team?.publicFallback;
14938
15047
  if (fromFile !== void 0) return { value: fromFile, source: "file" };
@@ -15061,6 +15170,9 @@ export {
15061
15170
  PRODUCTION_ORIGIN,
15062
15171
  isSameDeployment,
15063
15172
  knownDeploymentOrigins,
15173
+ USDC_ADDRESS,
15174
+ readUsdcBalanceWithFallback,
15175
+ rememberingBalanceReader,
15064
15176
  PublishModeSchema,
15065
15177
  parseAckServerWarnings,
15066
15178
  ROUTER_CONTEXTS,
@@ -15077,11 +15189,13 @@ export {
15077
15189
  UPDATE_CONFIG_KEYS,
15078
15190
  LOOP_CONFIG_KEYS,
15079
15191
  TEAM_CONFIG_KEYS,
15192
+ EXPERIMENTAL_CONFIG_KEYS,
15080
15193
  ROUTER_CONFIG_KEYS,
15081
15194
  RETIRED_PAYMENT_GUIDANCE,
15082
15195
  retiredPaymentKeys,
15083
15196
  loadRawConfig,
15084
15197
  loadConfig,
15085
- resolveSettings
15198
+ resolveSettings,
15199
+ resolveExperimentalBazaar
15086
15200
  };
15087
- //# sourceMappingURL=chunk-CCDOV45D.js.map
15201
+ //# sourceMappingURL=chunk-SAN5PFTL.js.map