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

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 (100) hide show
  1. package/dist/{_esm-OVVGTKHH.js → _esm-CE7KNONL.js} +4 -4
  2. package/dist/{chunk-AMG4SONW.js → chunk-2E6GVIRP.js} +9 -9
  3. package/dist/{chunk-2SQEFBAM.js → chunk-3BS55ANY.js} +21 -4
  4. package/dist/chunk-3BS55ANY.js.map +1 -0
  5. package/dist/{chunk-XNP6VUAJ.js → chunk-4AS52HUG.js} +3 -3
  6. package/dist/{chunk-LSWVVSFX.js → chunk-4M5FBWT5.js} +18 -50
  7. package/dist/chunk-4M5FBWT5.js.map +1 -0
  8. package/dist/{chunk-ZDKEU2GF.js → chunk-5FYKPQNX.js} +3 -3
  9. package/dist/{chunk-5DOHKQ24.js → chunk-5KD5HRAJ.js} +10 -2
  10. package/dist/{chunk-5DOHKQ24.js.map → chunk-5KD5HRAJ.js.map} +1 -1
  11. package/dist/{chunk-ZTFIQC4C.js → chunk-72UHZRG6.js} +2 -2
  12. package/dist/{chunk-TDGN476R.js → chunk-7ACHDNJA.js} +3 -3
  13. package/dist/{chunk-Y66XUXVI.js → chunk-AWQPGIR6.js} +5 -5
  14. package/dist/{chunk-A6CY6BUW.js → chunk-BTX2QE2Y.js} +3 -3
  15. package/dist/{chunk-UNV4K45L.js → chunk-CCDOV45D.js} +6 -2
  16. package/dist/{chunk-UNV4K45L.js.map → chunk-CCDOV45D.js.map} +1 -1
  17. package/dist/{chunk-AISBL7EY.js → chunk-CXUYCDPX.js} +4 -4
  18. package/dist/{chunk-VFVFVQM6.js → chunk-HH3PDYIG.js} +5 -5
  19. package/dist/{chunk-FPUPBQHX.js → chunk-HPWO4O6S.js} +2 -2
  20. package/dist/{chunk-3VYGDRRL.js → chunk-LI44XLMB.js} +5 -5
  21. package/dist/{chunk-WUU3BH6G.js → chunk-LN2HISWU.js} +2 -2
  22. package/dist/{chunk-6DCELMQA.js → chunk-N35E6CM2.js} +6 -6
  23. package/dist/{chunk-FHBGTOFA.js → chunk-NSG5TVZQ.js} +8 -8
  24. package/dist/{chunk-PZQRSZJV.js → chunk-P42QX3QF.js} +2 -2
  25. package/dist/{chunk-PZQRSZJV.js.map → chunk-P42QX3QF.js.map} +1 -1
  26. package/dist/{chunk-SCAOYGKX.js → chunk-PO4HAXAW.js} +55 -31
  27. package/dist/chunk-PO4HAXAW.js.map +1 -0
  28. package/dist/{chunk-KTAW4KGH.js → chunk-RGVOODF4.js} +5 -5
  29. package/dist/chunk-RPR2C2JO.js +112 -0
  30. package/dist/chunk-RPR2C2JO.js.map +1 -0
  31. package/dist/{chunk-2BKS2FVE.js → chunk-TU7XH3JJ.js} +5 -1
  32. package/dist/chunk-TU7XH3JJ.js.map +1 -0
  33. package/dist/{chunk-XDADPAWW.js → chunk-YEBNE5NW.js} +23 -23
  34. package/dist/{chunk-BG2EXNAA.js → chunk-YREKMJPP.js} +3 -3
  35. package/dist/{cli-456F77ZY.js → cli-XJQYUOHI.js} +32 -24
  36. package/dist/{cli-456F77ZY.js.map → cli-XJQYUOHI.js.map} +1 -1
  37. package/dist/{config-BLUWOH6S.js → config-KMJLFPSI.js} +8 -8
  38. package/dist/{doctor-PS45CR3T.js → doctor-KMN55D7U.js} +23 -23
  39. package/dist/{fund-4SW2ZBWC.js → fund-LT6ZPGEQ.js} +20 -20
  40. package/dist/{hook-command-YTV7X333.js → hook-command-U5XPEHAJ.js} +31 -23
  41. package/dist/hook-command-U5XPEHAJ.js.map +1 -0
  42. package/dist/index.js +5 -2
  43. package/dist/index.js.map +1 -1
  44. package/dist/{install-U4BIDCHH.js → install-MMNXJ5LM.js} +11 -11
  45. package/dist/install-identity-B7FVIWML.js +27 -0
  46. package/dist/{install-wallet-EYHELQMG.js → install-wallet-XMVUBCHS.js} +14 -14
  47. package/dist/{mcp-AC4PIXH5.js → mcp-TUPRIPSI.js} +33 -29
  48. package/dist/{mcp-AC4PIXH5.js.map → mcp-TUPRIPSI.js.map} +1 -1
  49. package/dist/{paths-P2N4JTDZ.js → paths-LRMWNTJP.js} +4 -2
  50. package/dist/{pay-VJOP6TFT.js → pay-XAWW3NV3.js} +19 -19
  51. package/dist/{send-YH75Z6LB.js → send-HESQYRKM.js} +14 -14
  52. package/dist/{status-5CHCDLUE.js → status-ANZPRZJJ.js} +6 -6
  53. package/dist/{status-line-CZAZUOAY.js → status-line-J3TUWVRQ.js} +7 -7
  54. package/dist/{status-line-wiring-2ABDVXSJ.js → status-line-wiring-HSV7DXO5.js} +5 -5
  55. package/dist/tenjin-daemon.mjs +141 -4
  56. package/dist/{uninstall-BYVGAQMO.js → uninstall-GUU34YKP.js} +11 -11
  57. package/dist/{update-7QJDSHST.js → update-KO2NZRJ5.js} +6 -6
  58. package/dist/{viemAdapter-By13KInL-N2GIVMZ7.js → viemAdapter-By13KInL-X2VY6CY3.js} +2 -2
  59. package/dist/{wallet-YZOXIXBC.js → wallet-3URC5QPK.js} +14 -14
  60. package/dist/wallet-3URC5QPK.js.map +1 -0
  61. package/docs/agent-permissions.md +1 -1
  62. package/package.json +1 -1
  63. package/dist/chunk-2BKS2FVE.js.map +0 -1
  64. package/dist/chunk-2SQEFBAM.js.map +0 -1
  65. package/dist/chunk-LSWVVSFX.js.map +0 -1
  66. package/dist/chunk-SCAOYGKX.js.map +0 -1
  67. package/dist/hook-command-YTV7X333.js.map +0 -1
  68. /package/dist/{_esm-OVVGTKHH.js.map → _esm-CE7KNONL.js.map} +0 -0
  69. /package/dist/{chunk-AMG4SONW.js.map → chunk-2E6GVIRP.js.map} +0 -0
  70. /package/dist/{chunk-XNP6VUAJ.js.map → chunk-4AS52HUG.js.map} +0 -0
  71. /package/dist/{chunk-ZDKEU2GF.js.map → chunk-5FYKPQNX.js.map} +0 -0
  72. /package/dist/{chunk-ZTFIQC4C.js.map → chunk-72UHZRG6.js.map} +0 -0
  73. /package/dist/{chunk-TDGN476R.js.map → chunk-7ACHDNJA.js.map} +0 -0
  74. /package/dist/{chunk-Y66XUXVI.js.map → chunk-AWQPGIR6.js.map} +0 -0
  75. /package/dist/{chunk-A6CY6BUW.js.map → chunk-BTX2QE2Y.js.map} +0 -0
  76. /package/dist/{chunk-AISBL7EY.js.map → chunk-CXUYCDPX.js.map} +0 -0
  77. /package/dist/{chunk-VFVFVQM6.js.map → chunk-HH3PDYIG.js.map} +0 -0
  78. /package/dist/{chunk-FPUPBQHX.js.map → chunk-HPWO4O6S.js.map} +0 -0
  79. /package/dist/{chunk-3VYGDRRL.js.map → chunk-LI44XLMB.js.map} +0 -0
  80. /package/dist/{chunk-WUU3BH6G.js.map → chunk-LN2HISWU.js.map} +0 -0
  81. /package/dist/{chunk-6DCELMQA.js.map → chunk-N35E6CM2.js.map} +0 -0
  82. /package/dist/{chunk-FHBGTOFA.js.map → chunk-NSG5TVZQ.js.map} +0 -0
  83. /package/dist/{chunk-KTAW4KGH.js.map → chunk-RGVOODF4.js.map} +0 -0
  84. /package/dist/{chunk-XDADPAWW.js.map → chunk-YEBNE5NW.js.map} +0 -0
  85. /package/dist/{chunk-BG2EXNAA.js.map → chunk-YREKMJPP.js.map} +0 -0
  86. /package/dist/{config-BLUWOH6S.js.map → config-KMJLFPSI.js.map} +0 -0
  87. /package/dist/{doctor-PS45CR3T.js.map → doctor-KMN55D7U.js.map} +0 -0
  88. /package/dist/{fund-4SW2ZBWC.js.map → fund-LT6ZPGEQ.js.map} +0 -0
  89. /package/dist/{install-U4BIDCHH.js.map → install-MMNXJ5LM.js.map} +0 -0
  90. /package/dist/{paths-P2N4JTDZ.js.map → install-identity-B7FVIWML.js.map} +0 -0
  91. /package/dist/{install-wallet-EYHELQMG.js.map → install-wallet-XMVUBCHS.js.map} +0 -0
  92. /package/dist/{pay-VJOP6TFT.js.map → paths-LRMWNTJP.js.map} +0 -0
  93. /package/dist/{status-line-wiring-2ABDVXSJ.js.map → pay-XAWW3NV3.js.map} +0 -0
  94. /package/dist/{send-YH75Z6LB.js.map → send-HESQYRKM.js.map} +0 -0
  95. /package/dist/{status-5CHCDLUE.js.map → status-ANZPRZJJ.js.map} +0 -0
  96. /package/dist/{status-line-CZAZUOAY.js.map → status-line-J3TUWVRQ.js.map} +0 -0
  97. /package/dist/{viemAdapter-By13KInL-N2GIVMZ7.js.map → status-line-wiring-HSV7DXO5.js.map} +0 -0
  98. /package/dist/{uninstall-BYVGAQMO.js.map → uninstall-GUU34YKP.js.map} +0 -0
  99. /package/dist/{update-7QJDSHST.js.map → update-KO2NZRJ5.js.map} +0 -0
  100. /package/dist/{wallet-YZOXIXBC.js.map → viemAdapter-By13KInL-X2VY6CY3.js.map} +0 -0
@@ -93,7 +93,7 @@ import {
93
93
  withTimeout,
94
94
  zeroAddress,
95
95
  zeroHash
96
- } from "./chunk-Y66XUXVI.js";
96
+ } from "./chunk-AWQPGIR6.js";
97
97
  import {
98
98
  InvalidDomainError,
99
99
  InvalidPrimaryTypeError,
@@ -127,7 +127,8 @@ import {
127
127
  toPrefixedMessage,
128
128
  toRlp,
129
129
  validateTypedData
130
- } from "./chunk-6DCELMQA.js";
130
+ } from "./chunk-N35E6CM2.js";
131
+ import "./chunk-JRGFKVAZ.js";
131
132
  import {
132
133
  AccountStateConflictError,
133
134
  AtomicReadyWalletRejectedUpgradeError,
@@ -433,7 +434,6 @@ import {
433
434
  weiUnits
434
435
  } from "./chunk-EGELTSPU.js";
435
436
  import "./chunk-KG3D7FIF.js";
436
- import "./chunk-JRGFKVAZ.js";
437
437
  import "./chunk-RBJPAZFI.js";
438
438
  import "./chunk-BPMWXTFX.js";
439
439
  import "./chunk-ZXTAQYNA.js";
@@ -877,4 +877,4 @@ export {
877
877
  zeroAddress,
878
878
  zeroHash
879
879
  };
880
- //# sourceMappingURL=_esm-OVVGTKHH.js.map
880
+ //# sourceMappingURL=_esm-CE7KNONL.js.map
@@ -9,18 +9,18 @@ import {
9
9
  LockTimeoutError,
10
10
  withFileLock
11
11
  } from "./chunk-MEFB5KHA.js";
12
- import {
13
- hasCode
14
- } from "./chunk-2I4QTOLB.js";
15
12
  import {
16
13
  projectRouterPath,
17
14
  readProjectRouterFile,
18
15
  routerSettings
19
- } from "./chunk-AISBL7EY.js";
16
+ } from "./chunk-CXUYCDPX.js";
17
+ import {
18
+ hasCode
19
+ } from "./chunk-2I4QTOLB.js";
20
20
  import {
21
21
  isTeamShelfOrigin,
22
22
  loadProjectConfig
23
- } from "./chunk-5DOHKQ24.js";
23
+ } from "./chunk-5KD5HRAJ.js";
24
24
  import {
25
25
  parseUsdToAtomic,
26
26
  toMoney
@@ -47,7 +47,7 @@ import {
47
47
  parseUpdateModeFlag,
48
48
  resolveSettings,
49
49
  retiredPaymentKeys
50
- } from "./chunk-UNV4K45L.js";
50
+ } from "./chunk-CCDOV45D.js";
51
51
  import {
52
52
  ADAPTERS,
53
53
  MODE_GATED_RULES,
@@ -55,14 +55,14 @@ import {
55
55
  registeredHooks,
56
56
  retractModeGatedRules,
57
57
  wireFreeVerbAllowlist
58
- } from "./chunk-ZDKEU2GF.js";
58
+ } from "./chunk-5FYKPQNX.js";
59
59
  import {
60
60
  CliError,
61
61
  writeFileAtomic
62
62
  } from "./chunk-JLEF5WHM.js";
63
63
  import {
64
64
  configPath
65
- } from "./chunk-2BKS2FVE.js";
65
+ } from "./chunk-TU7XH3JJ.js";
66
66
 
67
67
  // src/commands/config.ts
68
68
  import { mkdir } from "node:fs/promises";
@@ -885,4 +885,4 @@ export {
885
885
  persistInstallHarness,
886
886
  persistGrantDeclined
887
887
  };
888
- //# sourceMappingURL=chunk-AMG4SONW.js.map
888
+ //# sourceMappingURL=chunk-2E6GVIRP.js.map
@@ -1,10 +1,10 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
2
  import {
3
3
  PRODUCTION_ORIGIN
4
- } from "./chunk-UNV4K45L.js";
4
+ } from "./chunk-CCDOV45D.js";
5
5
  import {
6
6
  package_default
7
- } from "./chunk-PZQRSZJV.js";
7
+ } from "./chunk-P42QX3QF.js";
8
8
  import {
9
9
  CliError
10
10
  } from "./chunk-JLEF5WHM.js";
@@ -61,6 +61,22 @@ function shelfBypassHeaders(url, bypass) {
61
61
  function carriesBypassKey(headers) {
62
62
  return Object.keys(headers).some((name) => name.toLowerCase() === SHELF_BYPASS_HEADER);
63
63
  }
64
+ var INSTALL_ID_HEADER = "tenjin-install-id";
65
+ var tenjinIdentity;
66
+ function setTenjinIdentity(identity) {
67
+ tenjinIdentity = identity;
68
+ }
69
+ async function tenjinIdentityHeaders(url) {
70
+ const identity = tenjinIdentity;
71
+ if (identity === void 0) return {};
72
+ try {
73
+ if (!(await identity.origins()).includes(new URL(url).origin)) return {};
74
+ const id = await identity.installId();
75
+ return id !== void 0 ? { [INSTALL_ID_HEADER]: id } : {};
76
+ } catch {
77
+ return {};
78
+ }
79
+ }
64
80
  function applyUserAgent(headers, callerUserAgent) {
65
81
  headers.set("user-agent", composeUserAgent({ caller: callerUserAgent }));
66
82
  return headers;
@@ -129,7 +145,7 @@ async function httpRequest(url, opts) {
129
145
  try {
130
146
  res = await doFetch(url, {
131
147
  method: opts.method ?? "GET",
132
- headers,
148
+ headers: { ...headers, ...await tenjinIdentityHeaders(url) },
133
149
  body,
134
150
  signal,
135
151
  ...pinned ? { redirect: "manual" } : {}
@@ -222,7 +238,8 @@ function oversizedHeaderFailure(url) {
222
238
 
223
239
  export {
224
240
  composeUserAgent,
241
+ setTenjinIdentity,
225
242
  httpRequest,
226
243
  fetchFailureToCliError
227
244
  };
228
- //# sourceMappingURL=chunk-2SQEFBAM.js.map
245
+ //# sourceMappingURL=chunk-3BS55ANY.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/client-meta.ts","../src/lib/http.ts"],"sourcesContent":["import pkg from '../../package.json';\nimport { PRODUCTION_ORIGIN } from './production-origin';\n\n/**\n * The RFC 9110 product token naming this CLI. It leads every User-Agent the\n * shared transport sends, because the server's `parseUserAgentProduct()` (tenjin\n * PR #544) attributes on the FIRST product only and the CLI is the user agent\n * that constructed and sent the request.\n */\nexport const TENJIN_PRODUCT = `tenjin-cli/${pkg.version}`;\n\n/** The product NAME alone, which is what identifies a copy of us in a handoff. */\nexport const TENJIN_PRODUCT_NAME = 'tenjin-cli';\n\n/**\n * The product the WebSearch hook leads with, so a ridealong query is separable\n * from a deliberate `tenjin search`. Leading is the mechanism: the server\n * attributes on the FIRST User-Agent product, landing here in `client_name`.\n *\n * The separation is the deliverable, not any one consumer: whatever judges hook\n * demand needs these populations distinguishable at ingest (tenjin#704,\n * tenjin-agent#179). A rename breaks no filter today, it merges them again. */\nexport const WEBSEARCH_HOOK_PRODUCT_NAME = 'tenjin-websearch-hook';\nexport const WEBSEARCH_HOOK_PRODUCT = `${WEBSEARCH_HOOK_PRODUCT_NAME}/${pkg.version}`;\n\n/** Every identity of ours a handoff may carry, which composition drops rather\n * than duplicate, whichever product is leading. */\nexport const OWN_PRODUCT_NAMES = [TENJIN_PRODUCT_NAME, WEBSEARCH_HOOK_PRODUCT_NAME];\n\n/**\n * The identifying comment. It rides LAST so a caller's products keep the order\n * they were handed off in, and so stripping it is enough to recover the caller's\n * sequence from an already-composed field (see `composeUserAgent`).\n */\nexport const TENJIN_COMMENT = `(+${PRODUCTION_ORIGIN})`;\n\n/**\n * The CLI's identity on every HTTP request, sent as the standard `User-Agent`\n * header from the shared transport (`http.ts`). `X-Tenjin-Client` is retired and\n * this CLI sends it nowhere.\n */\nexport const TENJIN_USER_AGENT = `${TENJIN_PRODUCT} ${TENJIN_COMMENT}`;\n\n/** The same field for the WebSearch hook, which identifies as its own product. */\nexport const WEBSEARCH_HOOK_USER_AGENT = `${WEBSEARCH_HOOK_PRODUCT} ${TENJIN_COMMENT}`;\n\n/** The handoff seam for an agent that launches the CLI as a subprocess. */\nexport const CALLER_USER_AGENT_ENV = 'TENJIN_CALLER_USER_AGENT';\n\n/** The server's bound: a longer field is discarded whole, never truncated. */\nexport const USER_AGENT_MAX_LENGTH = 512;\n\n/**\n * One RFC 9110 product: a token, optionally `/token`. The handoff accepts a\n * sequence of these and nothing else (no comments, no free text), which is what\n * structurally keeps a user, wallet, session, hostname, or machine identifier\n * out of the field rather than a blocklist that has to guess at one.\n */\nexport const PRODUCT_RE = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+(?:\\/[!#$%&'*+.^_`|~0-9A-Za-z-]+)?$/;\n\n/** Printable ASCII, the only range the server parses; also excludes CR/LF/tab. */\nexport const PRINTABLE_ASCII_RE = /^[\\x20-\\x7e]*$/;\n\nexport interface ComposeUserAgentInput {\n /** A caller's product sequence, passed programmatically; wins over the env. */\n caller?: string | undefined;\n /** Environment seam; defaults to `process.env`. */\n env?: NodeJS.ProcessEnv;\n /** The product to lead with; the WebSearch hook passes its own. */\n product?: string;\n}\n\n/**\n * Compose the field the transport sends: the Tenjin product, then the caller's\n * products in their original order, then the Tenjin comment. The handoff is\n * SELF-REPORTED TELEMETRY and never trusted policy input; nothing here or on the\n * server may read it to decide entitlement, spend, or trust.\n *\n * Idempotent by construction: the caller value is decomposed into tokens, our own\n * product and comment are dropped from it, and the field is rebuilt from\n * `TENJIN_PRODUCT`, so re-composing an already-composed field (a retry, a nested\n * helper, an agent re-exporting the env it received) yields the same string\n * rather than a second `tenjin-cli` token. Caller products survive byte for byte.\n *\n * Rejection is total, never partial: a non-printable, non-product, or overlong\n * handoff is OMITTED and the Tenjin identity travels alone, because truncating a\n * product token would mint a different, false identity.\n */\nexport function composeUserAgent(input: ComposeUserAgentInput = {}): string {\n const product = input.product ?? TENJIN_PRODUCT;\n const alone = `${product} ${TENJIN_COMMENT}`;\n const raw = input.caller ?? (input.env ?? process.env)[CALLER_USER_AGENT_ENV];\n const products = callerProducts(raw);\n if (products.length === 0) return alone;\n const composed = `${product} ${products.join(' ')} ${TENJIN_COMMENT}`;\n return composed.length <= USER_AGENT_MAX_LENGTH ? composed : alone;\n}\n\n/** The caller's products, or none at all when any part of the handoff is unusable. */\nfunction callerProducts(raw: string | undefined): string[] {\n if (raw === undefined || !PRINTABLE_ASCII_RE.test(raw)) return [];\n // Printable ASCII leaves the space as the only whitespace, so it is the only\n // separator a product sequence can have.\n const tokens = raw.split(' ').filter((token) => token.length > 0 && !isOwnIdentity(token));\n return tokens.every((token) => PRODUCT_RE.test(token)) ? tokens : [];\n}\n\n/**\n * Our own identity inside a caller value, matched case-insensitively: a product\n * token is case-sensitive to the server, but a copy of ours in any casing is\n * still a duplicate identity, and dropping it is what makes composition total.\n */\nfunction isOwnIdentity(token: string): boolean {\n const lower = token.toLowerCase();\n // Both sides are lowered: comparing a lowered token against a constant that is\n // merely all-lowercase TODAY would break silently the day either gains a\n // capital, and it fails safe (the stale copy stops matching, then fails\n // PRODUCT_RE, and the whole handoff drops), so nothing would notice.\n if (lower === TENJIN_COMMENT.toLowerCase()) return true;\n return OWN_PRODUCT_NAMES.some((name) => {\n const own = name.toLowerCase();\n return lower === own || lower.startsWith(`${own}/`);\n });\n}\n","import { CliError } from './errors';\nimport { composeUserAgent } from './client-meta';\n\n/**\n * The single JSON client the whole CLI grows on: `doctor` uses it in B1, `search`\n * reuses it in B2. It never throws on a transport/protocol failure — it returns a\n * discriminated result so callers decide how each failure class maps to a check\n * or an error. `fetchImpl` is injectable so tests never touch the network.\n */\nexport interface FetchJsonOptions {\n /** Abort the request after this many milliseconds. */\n timeoutMs: number;\n /** Override global fetch (tests inject a stub returning canned Responses). */\n fetchImpl?: typeof fetch;\n /** Optional request headers, merged onto the User-Agent this module always sends. */\n headers?: Record<string, string>;\n /** The team shelf's bypass secret and its origin; see {@link ShelfBypass}. */\n bypass?: ShelfBypass;\n /**\n * INTERNAL. A caller's own product sequence, composed BEHIND the CLI's\n * identity (see `composeUserAgent`). The package ships a `bin` and no\n * `exports` map, so this is not a supported seam for code outside this repo:\n * the documented handoff is the `TENJIN_CALLER_USER_AGENT` environment\n * variable, which is what a subprocess launcher sets and what this falls back\n * to. Kept as an option so an in-repo caller can pass a value the environment\n * does not carry.\n */\n callerUserAgent?: string;\n}\n\n/**\n * The team shelf's Vercel \"Protection Bypass for Automation\" header.\n *\n * A door key for a protected preview deployment, not a credential of anyone's:\n * it gets a request past Deployment Protection and authenticates nobody. It is\n * NOT in {@link CREDENTIAL_HEADERS}, whose members are wallet-signed material a\n * redirect target could REPLAY — this one cannot be replayed into a signature.\n * It is still a secret, and DISCLOSING it is the whole harm: whoever holds it\n * walks into the team shelf. So it pins redirects exactly as a signed header\n * does (see {@link carriesBypassKey}), and where it may go is decided here and\n * nowhere else.\n */\nexport const SHELF_BYPASS_HEADER = 'x-vercel-protection-bypass';\n\n/**\n * A bypass secret and the origin it belongs to.\n *\n * THE ORIGIN IS PART OF THE VALUE, and that is the whole design. The CLI talks\n * to two shelves in team mode — the team's own deployment and the public\n * marketplace — and a caller that decides \"this request is to the team shelf, so\n * attach the key\" is a caller that eventually gets it wrong once. So callers\n * pass the pair and this transport does the compare: the header is attached from\n * the REQUEST URL, so a request to any other host cannot carry it, whatever the\n * call site believed.\n */\nexport interface ShelfBypass {\n /** `URL.origin` of the shelf the secret opens (the configured `baseUrl`). */\n origin: string;\n secret: string;\n}\n\n/** The bypass header for `url`, or nothing. Exported for the hook-script mirror\n * test, which runs the generated copy of this rule against this one. */\nexport function shelfBypassHeaders(\n url: string,\n bypass: ShelfBypass | undefined,\n): Record<string, string> {\n if (bypass === undefined || bypass.secret.length === 0) return {};\n let origin: string;\n try {\n origin = new URL(url).origin;\n } catch {\n return {};\n }\n if (origin !== bypass.origin) return {};\n return { [SHELF_BYPASS_HEADER]: bypass.secret };\n}\n\n/**\n * Whether the request being assembled actually carries the door key.\n *\n * A request that carries it MUST NOT follow a redirect. `fetch`'s default\n * `redirect: 'follow'` re-sends request headers verbatim to the new host (Node\n * strips only `Authorization`), so a single 3xx anywhere on the shelf origin —\n * the Vercel Authentication interstitial a rotated bypass secret gets, a domain\n * alias, a CDN rule — would hand the team shelf's key to whatever `Location`\n * names. Nothing else is needed to walk in afterwards, so the key never leaves\n * the origin it was paired with, not even one hop.\n *\n * Read off the BUILT headers rather than off `opts.bypass`, for the same reason\n * {@link CREDENTIAL_HEADERS} is matched by name: attaching the secret is what\n * arms the protection, so an off-origin request (which gets no header) keeps\n * ordinary transport and a call site cannot forget to ask for the pin.\n */\nfunction carriesBypassKey(headers: Record<string, string>): boolean {\n return Object.keys(headers).some((name) => name.toLowerCase() === SHELF_BYPASS_HEADER);\n}\n\n/** The anonymous install id: a random UUID minted once per data dir. */\nexport const INSTALL_ID_HEADER = 'tenjin-install-id';\n\n/**\n * Who is using the router, for Tenjin's own request telemetry: an anonymous\n * install id, random and tied to nothing but the data dir.\n *\n * Same shape as {@link ShelfBypass}, for the same reason: the transport decides\n * where it goes, from the REQUEST URL, so a call site cannot send it to a\n * provider by believing it is talking to Tenjin. `pay` runs over this transport\n * to third-party sellers, and none of them gets the header.\n *\n * Process-wide rather than a per-call option because it is not a per-call\n * decision: every request to Tenjin carries it, and threading it through forty\n * call sites is forty chances to forget one. Set only by the two process entries\n * (the CLI's `index.ts` and the daemon), so an in-process test that never sets\n * it sends exactly what it always did.\n *\n * Redirects are left to the request's usual transport: an unpinned request\n * follows them as `fetch` does, headers and all. Tenjin's origins redirect only\n * to Tenjin's own hosts, and the id is not a credential, so it is not worth the\n * redirect pin the bypass key and signed headers get.\n */\nexport interface TenjinIdentity {\n /** The origins that are Tenjin's own for this process. */\n origins: () => Promise<readonly string[]>;\n /** The install id; absent when it could not be read or created. */\n installId: () => Promise<string | undefined>;\n}\n\nlet tenjinIdentity: TenjinIdentity | undefined;\n\nexport function setTenjinIdentity(identity: TenjinIdentity | undefined): void {\n tenjinIdentity = identity;\n}\n\n/**\n * The telemetry headers for `url`, or nothing. NEVER THROWS: a data dir that\n * cannot be read costs the request its telemetry and nothing else.\n */\nexport async function tenjinIdentityHeaders(url: string): Promise<Record<string, string>> {\n const identity = tenjinIdentity;\n if (identity === undefined) return {};\n try {\n if (!(await identity.origins()).includes(new URL(url).origin)) return {};\n const id = await identity.installId();\n return id !== undefined ? { [INSTALL_ID_HEADER]: id } : {};\n } catch {\n return {};\n }\n}\n\n/**\n * The one place the identity is written for anything that can import it; both\n * transports funnel their Headers through it, so a third entry point on this\n * side cannot ship without it. `.set` on a Headers\n * object is what makes this total: a caller header spelled `User-Agent` in any\n * case lands in the same slot and is overwritten, never duplicated, so a\n * call-specific header cannot erase the composed field or add a second one.\n */\nfunction applyUserAgent(headers: Headers, callerUserAgent?: string): Headers {\n headers.set('user-agent', composeUserAgent({ caller: callerUserAgent }));\n return headers;\n}\n\n/** The same write for `fetchJson`'s plain-object headers; Headers.entries() is lowercase-keyed. */\nfunction withUserAgent(\n callerHeaders?: Record<string, string>,\n callerUserAgent?: string,\n): Record<string, string> {\n return Object.fromEntries(\n applyUserAgent(new Headers(callerHeaders ?? {}), callerUserAgent).entries(),\n );\n}\n\n/** A successful 2xx whose body parsed as JSON. */\nexport interface FetchJsonSuccess {\n ok: true;\n status: number;\n json: unknown;\n /** The server's `x-request-id`, when it sent one — useful in error reports. */\n requestId?: string;\n}\n\n/**\n * A failed request, tagged by class so the caller maps it deliberately:\n * `network`/`timeout` (never reached the server or no answer), `http` (a non-2xx\n * status), `invalid-json` (2xx but the body was not JSON).\n */\nexport interface FetchJsonFailure {\n ok: false;\n kind: 'network' | 'timeout' | 'http' | 'invalid-json' | 'blocked-redirect' | 'oversized-header';\n status?: number;\n requestId?: string;\n message: string;\n /**\n * On `invalid-json`, and on `http` when the status is 401/403: the response\n * looks like an access-protection or sign-in page rather than an API answer.\n * See {@link accessGateSignals} for what \"looks like\" means. Callers use it to\n * point at the missing credential instead of at the base URL, which is the one\n * setting that was already correct (#218).\n */\n gateSuspected?: boolean;\n /**\n * Present (true) only where the response left the host that was asked for:\n * `gateSuspected`'s STRONGER signal (the final URL's host differs), or, on\n * `blocked-redirect`, a `Location` that resolves to another host. An HTML\n * content-type alone proves a page came back, not who sent it, and a 3xx\n * alone proves only that the URL moved; leaving the host is what lets a\n * caller name access protection outright.\n */\n gateOffOrigin?: boolean;\n}\n\n/**\n * Does this response read as a protection page rather than as an API answer?\n *\n * Two independent signals, reported separately because they prove different\n * amounts (the caller's wording must not outrun the evidence):\n *\n * - an HTML content-type, because a Vercel Deployment Protection interstitial\n * and every sign-in wall answer with a page;\n * - a final URL whose host is not the one asked for, because a gate that\n * redirects to sign in lands the probe on another host and `fetch` follows it\n * silently on the unpinned requests this function serves.\n *\n * Decided HERE because this transport is the only place holding the `Response`;\n * a caller re-deriving it from the failure message would be guessing. An\n * unreadable final URL is NOT suspicion: `res.url` is empty on a synthesized\n * Response, so only a host that reads AND differs counts.\n */\nfunction accessGateSignals(\n requestedUrl: string,\n res: Response,\n): { gateSuspected: boolean; gateOffOrigin?: true } {\n const html = /^\\s*text\\/html\\b/i.test(res.headers.get('content-type') ?? '');\n let offOrigin = false;\n if (res.url.length > 0) {\n try {\n offOrigin = new URL(requestedUrl).host !== new URL(res.url).host;\n } catch {\n offOrigin = false;\n }\n }\n return {\n gateSuspected: html || offOrigin,\n ...(offOrigin ? { gateOffOrigin: true as const } : {}),\n };\n}\n\n/**\n * Does an unfollowed 3xx point off the host that was asked for?\n *\n * The pinned branch never follows, so `res.url` is still the requested URL and\n * `Location` is the only evidence about where the hop went. That distinction\n * carries the whole verdict downstream: a gate's sign-in interstitial lands on\n * another host, while an `http://` base URL that 301s to https, or a host\n * normalising to its canonical name, does not, and reading either as a refused\n * credential blames the wrong setting. A relative target resolves against the\n * request, so it is same-host by construction; a missing or unparseable one is\n * NOT an off-host claim.\n */\nfunction redirectLeavesHost(requestedUrl: string, location: string | null): boolean {\n if (location === null || location.length === 0) return false;\n try {\n return new URL(requestedUrl).host !== new URL(location, requestedUrl).host;\n } catch {\n return false;\n }\n}\n\n/**\n * Header names that carry wallet-signed material.\n *\n * A request bearing any of these must NEVER follow a redirect. `resource-ref`\n * pins the invariant — \"nothing signed may leave for a host the user did not\n * configure\" — but `assertOnBaseOrigin` only checks the URL the caller asked\n * for, and `fetch`'s default `redirect: 'follow'` re-sends request headers\n * verbatim to the new host (Node strips only `Authorization`). A 3xx anywhere on\n * the configured origin would therefore hand a signature BOUND TO THE REAL\n * DOMAIN to whoever `Location` points at, replayable against it for the\n * signature's lifetime.\n *\n * Detected by header NAME rather than by a caller-supplied \"this is signed\" flag\n * so the protection cannot be forgotten at a call site: attaching the credential\n * is what arms it. Matched case-insensitively. Kept as literals so the base\n * transport keeps its single dependency; `http.test.ts` pins them against the\n * real constants in `lib/siwx` and the x402 payment headers.\n *\n * All three wallet-signed families this CLI sends are here: the SIWX auth\n * header, the x402 payment header (`payment-signature` for x402 v2, plus\n * `x-payment`, the v1 spelling `@x402/core` can emit, as drift insurance even\n * though `read-client` pins v2), and `tenjin-session-delegation` — a REUSABLE\n * session-lifetime SIWX signature `session-key` attaches to every session-signed\n * write, which makes it the most replayable credential of the set. The RFC 9421\n * `Signature`/`Signature-Input` pair riding alongside it is deliberately absent:\n * it covers method, URL, and body digest, so it is not usefully replayable at\n * another host.\n */\nconst CREDENTIAL_HEADERS = new Set([\n 'sign-in-with-x',\n 'payment-signature',\n 'x-payment',\n 'tenjin-session-delegation',\n]);\n\nfunction carriesSignedMaterial(headers: Record<string, string>): boolean {\n return Object.keys(headers).some((name) => CREDENTIAL_HEADERS.has(name.toLowerCase()));\n}\n\nexport type FetchJsonResult = FetchJsonSuccess | FetchJsonFailure;\n\nexport async function fetchJson(url: string, opts: FetchJsonOptions): Promise<FetchJsonResult> {\n const doFetch = opts.fetchImpl ?? fetch;\n const controller = new AbortController();\n let timedOut = false;\n // The timer stays armed until the body is fully consumed (cleared in the outer\n // finally), so a server that sends headers then stalls the body still trips the\n // deadline instead of hanging forever on res.json().\n const timer = setTimeout(() => {\n timedOut = true;\n controller.abort();\n }, opts.timeoutMs);\n\n try {\n let res: Response;\n // `new Headers` throws on a malformed caller header, so building them stays\n // inside the catch that turns any pre-flight refusal into the same\n // discriminated network failure a dead socket gets.\n let pinned = false;\n try {\n const headers = withUserAgent(\n { ...opts.headers, ...shelfBypassHeaders(url, opts.bypass) },\n opts.callerUserAgent,\n );\n // fetchJson sends no signed material — doctor's probes and the contract\n // checks are anonymous — so the door key is the one thing here worth\n // pinning, and it pins the same way it does in httpRequest.\n pinned = carriesBypassKey(headers);\n res = await doFetch(url, {\n signal: controller.signal,\n headers: { ...headers, ...(await tenjinIdentityHeaders(url)) },\n ...(pinned ? { redirect: 'manual' as const } : {}),\n });\n } catch (err) {\n // A timeout is a network failure the AbortController induced; distinguish it\n // from an organic one so the caller can say \"timed out\" rather than a raw\n // AbortError message.\n return timedOut\n ? timeoutFailure(url, opts.timeoutMs)\n : { ok: false, kind: 'network', message: `Request to ${url} failed: ${errorMessage(err)}` };\n }\n\n const requestId = res.headers.get('x-request-id') ?? undefined;\n\n // Fail CLOSED, ahead of the ordinary non-2xx branch, so an unfollowed 3xx is\n // never reported as a plain HTTP status a caller might retry by hand.\n if (pinned && res.status >= 300 && res.status < 400) {\n return {\n ok: false,\n kind: 'blocked-redirect',\n status: res.status,\n ...(requestId !== undefined ? { requestId } : {}),\n // Where it pointed, not that it pointed: only a hop that leaves the host\n // asked for is evidence about the key. Same-host 3xx happens to a base\n // URL that needs fixing, with a perfectly good key.\n ...(redirectLeavesHost(url, res.headers.get('location'))\n ? { gateOffOrigin: true as const }\n : {}),\n message:\n `Request to ${url} was redirected (${res.status}) while carrying the team shelf's ` +\n 'bypass key; refusing to follow it, because the key opens only the configured origin.',\n };\n }\n\n if (!res.ok) {\n return {\n ok: false,\n kind: 'http',\n status: res.status,\n ...(requestId !== undefined ? { requestId } : {}),\n // 401/403 is one of the three shapes deployment protection answers with\n // (200 HTML and a 30x interstitial are the others), so the gate signals\n // ride here too. Other statuses stay unmarked: a 404 or 500 HTML page is\n // an ordinary broken deployment, not a credential problem.\n ...(res.status === 401 || res.status === 403 ? accessGateSignals(url, res) : {}),\n message: `Request to ${url} failed with status ${res.status}`,\n };\n }\n\n let json: unknown;\n try {\n json = await res.json();\n } catch (err) {\n // The body read can fail three ways. A timeout wins first: the abort fires\n // synchronously with `timedOut`, so any abort-induced rejection here is our\n // deadline. Otherwise a SyntaxError is a genuine parse failure (invalid\n // JSON); anything else is a transport failure mid-body (network).\n if (timedOut) return timeoutFailure(url, opts.timeoutMs);\n if (err instanceof SyntaxError) {\n return {\n ok: false,\n kind: 'invalid-json',\n status: res.status,\n ...(requestId !== undefined ? { requestId } : {}),\n ...accessGateSignals(url, res),\n message: `Response from ${url} was not valid JSON`,\n };\n }\n return {\n ok: false,\n kind: 'network',\n status: res.status,\n ...(requestId !== undefined ? { requestId } : {}),\n message: `Request to ${url} failed while reading the response body: ${errorMessage(err)}`,\n };\n }\n\n return {\n ok: true,\n status: res.status,\n json,\n ...(requestId !== undefined ? { requestId } : {}),\n };\n } finally {\n clearTimeout(timer);\n }\n}\n\nfunction timeoutFailure(url: string, timeoutMs: number): FetchJsonFailure {\n return {\n ok: false,\n kind: 'timeout',\n message: `Request to ${url} timed out after ${timeoutMs}ms`,\n };\n}\n\n/**\n * A full HTTP round trip that surfaces the STATUS, headers, and best-effort JSON\n * body for ANY status. Unlike fetchJson (2xx-only), the B2 read/pay flow needs\n * the body on a 402 (the leak-safe preview) and a 409 (the owned-re-pay gate),\n * and search/outcome need a 4xx validation envelope. A transport/timeout failure\n * still returns the discriminated FetchJsonFailure so callers map it uniformly.\n */\nexport interface HttpRequestOptions {\n method?: 'GET' | 'POST' | 'PUT' | 'DELETE';\n timeoutMs: number;\n headers?: Record<string, string>;\n /** The team shelf's bypass secret and its origin; see {@link ShelfBypass}. */\n bypass?: ShelfBypass;\n /** INTERNAL; see `FetchJsonOptions.callerUserAgent`. */\n callerUserAgent?: string;\n /** A JSON body (POST); serialized with a content-type header set automatically. */\n jsonBody?: unknown;\n /**\n * A body the CALLER already encoded, sent byte for byte with no content-type\n * of this transport's choosing: the router's provider leg is handed a request\n * the server built, and re-encoding it would make the bytes signed for and\n * the bytes sent two different things. The caller's own `headers` carry the\n * content type. Ignored when `jsonBody` is set.\n */\n rawBody?: string;\n fetchImpl?: typeof fetch;\n /**\n * A caller's own abort, combined with (never replacing) `timeoutMs`. The loop's\n * legs pass the fire's signal here so a harness that closed its socket stops the\n * request in flight; a caller with no such signal is unchanged.\n */\n signal?: AbortSignal;\n /**\n * Refuse redirects even when the request carries no signed header. For a\n * caller whose response becomes a durable local artifact (`fetchRead`: the\n * 200 is written to the library as an entitlement record under the\n * server-chosen id/slug), following a cross-origin redirect would let\n * another host's bytes be recorded as if the configured origin served them.\n * Off by default so search/outcome/publish/doctor keep normal transport.\n */\n blockRedirects?: boolean;\n}\n\nexport interface HttpResponse {\n ok: true;\n status: number;\n /** Case-insensitive header lookup over the response. */\n header(name: string): string | undefined;\n /** Parsed JSON body, or undefined when the body was empty or not JSON. */\n json: unknown;\n /** The raw body text; what a non-JSON endpoint actually said (`pay` delivers it). */\n text: string;\n requestId?: string;\n}\n\nexport type HttpResult = HttpResponse | FetchJsonFailure;\n\n/** The wire form of one request: what to send, and whether it may follow a redirect. */\ninterface PreparedRequest {\n ok: true;\n headers: Record<string, string>;\n body: string | undefined;\n signed: boolean;\n bypassed: boolean;\n pinned: boolean;\n}\n\n/**\n * Assemble the request and DERIVE its redirect decision from the headers that\n * were actually built, in one place and one pass. The redirect flags are\n * returned rather than assigned, so they have no value until the headers do:\n * there is no state in which `pinned` is readable but not yet computed, which\n * is what would let a signed request follow a 3xx to another host. Anything\n * that refuses here (`new Headers` throws on a malformed caller header) becomes\n * the same discriminated failure a dead socket does, because this transport\n * documents a returned failure for every refusal, not an exception.\n */\nfunction prepareRequest(url: string, opts: HttpRequestOptions): PreparedRequest | FetchJsonFailure {\n try {\n let body: string | undefined;\n // The bypass rides in with the caller's headers rather than being set after\n // them, so a caller cannot spell it a second way and win the slot.\n const merged = new Headers({ ...opts.headers, ...shelfBypassHeaders(url, opts.bypass) });\n if (opts.jsonBody !== undefined) {\n body = JSON.stringify(opts.jsonBody);\n merged.set('content-type', 'application/json');\n } else if (opts.rawBody !== undefined) {\n body = opts.rawBody;\n }\n const wantsAccept = opts.method === 'POST' || opts.method === 'PUT' || body !== undefined;\n if (wantsAccept && !merged.has('accept')) merged.set('accept', 'application/json');\n // An `accept`/`content-type` set here wins the slot regardless of how a\n // caller cased its own copy.\n const headers = Object.fromEntries(applyUserAgent(merged, opts.callerUserAgent).entries());\n\n // Signed requests opt out of redirect following entirely; see CREDENTIAL_HEADERS.\n // So does a request carrying the team shelf's bypass key: it cannot be\n // replayed, but a 3xx would DISCLOSE it, and that is the whole harm (see\n // carriesBypassKey). A caller can also pin an unsigned, keyless request\n // (blockRedirects) when the response it gets back becomes a durable local record.\n const signed = carriesSignedMaterial(headers);\n const bypassed = carriesBypassKey(headers);\n return {\n ok: true,\n headers,\n body,\n signed,\n bypassed,\n pinned: signed || bypassed || opts.blockRedirects === true,\n };\n } catch (err) {\n return {\n ok: false,\n kind: 'network',\n message: `Request to ${url} failed: ${errorMessage(err)}`,\n };\n }\n}\n\nexport async function httpRequest(url: string, opts: HttpRequestOptions): Promise<HttpResult> {\n const doFetch = opts.fetchImpl ?? fetch;\n const controller = new AbortController();\n let timedOut = false;\n const timer = setTimeout(() => {\n timedOut = true;\n controller.abort();\n }, opts.timeoutMs);\n // The caller's abort is combined with the timeout rather than chosen between:\n // whichever fires first ends the request, and `timedOut` still says which.\n const signal =\n opts.signal === undefined\n ? controller.signal\n : AbortSignal.any([controller.signal, opts.signal]);\n\n try {\n const prepared = prepareRequest(url, opts);\n if (!prepared.ok) return prepared;\n const { headers, body, signed, bypassed, pinned } = prepared;\n\n let res: Response;\n try {\n res = await doFetch(url, {\n method: opts.method ?? 'GET',\n headers: { ...headers, ...(await tenjinIdentityHeaders(url)) },\n body,\n signal,\n ...(pinned ? { redirect: 'manual' as const } : {}),\n });\n } catch (err) {\n if (timedOut) return timeoutFailure(url, opts.timeoutMs);\n if (isHeaderOverflow(err)) return oversizedHeaderFailure(url);\n return {\n ok: false,\n kind: 'network',\n message: `Request to ${url} failed: ${errorMessage(err)}`,\n };\n }\n\n const requestId = res.headers.get('x-request-id') ?? undefined;\n\n // Fail CLOSED on a redirect the request was not allowed to follow. This\n // returns a failure rather than the 3xx response so no caller can mistake an\n // unfollowed redirect for a normal status and retry it by hand.\n if (pinned && res.status >= 300 && res.status < 400) {\n return {\n ok: false,\n kind: 'blocked-redirect',\n status: res.status,\n ...(requestId !== undefined ? { requestId } : {}),\n message: signed\n ? `Request to ${url} was redirected (${res.status}) while carrying a signed header; ` +\n 'refusing to follow it, because the signature is bound to the configured origin.'\n : bypassed\n ? `Request to ${url} was redirected (${res.status}) while carrying the team shelf's ` +\n 'bypass key; refusing to follow it, because the key opens only the configured origin.'\n : `Request to ${url} was redirected (${res.status}); ` +\n 'refusing to follow it, because the response must come from the configured origin.',\n };\n }\n // Read the raw text once; parse best-effort. A non-JSON body (empty 202, an\n // HTML error page) yields `undefined` rather than a thrown parse, because a\n // 402/409 caller keys off the STATUS and only some statuses carry JSON.\n let text: string;\n try {\n text = await res.text();\n } catch (err) {\n if (timedOut) return timeoutFailure(url, opts.timeoutMs);\n return {\n ok: false,\n kind: 'network',\n status: res.status,\n ...(requestId !== undefined ? { requestId } : {}),\n message: `Request to ${url} failed while reading the response body: ${errorMessage(err)}`,\n };\n }\n let json: unknown;\n if (text.length > 0) {\n try {\n json = JSON.parse(text);\n } catch {\n json = undefined;\n }\n }\n return {\n ok: true,\n status: res.status,\n header: (name) => res.headers.get(name) ?? undefined,\n json,\n text,\n ...(requestId !== undefined ? { requestId } : {}),\n };\n } finally {\n clearTimeout(timer);\n }\n}\n\nexport interface FailureToCliErrorOptions {\n fix?: string;\n details?: unknown;\n}\n\n/**\n * Normalize a fetch failure into the CLI error contract: network/timeout are a\n * NETWORK_ERROR, an `http` status (server reachable but errored — commonly 5xx)\n * is API_UNREACHABLE, and a 2xx that failed to parse when JSON was required is a\n * CONTRACT_MISMATCH. Callers that need a check-specific code (doctor) build their\n * own CliError; this is the default B2's passthrough leans on.\n */\nexport function fetchFailureToCliError(\n failure: FetchJsonFailure,\n opts: FailureToCliErrorOptions = {},\n): CliError {\n const code =\n failure.kind === 'network' || failure.kind === 'timeout'\n ? 'NETWORK_ERROR'\n : failure.kind === 'invalid-json'\n ? 'CONTRACT_MISMATCH'\n : failure.kind === 'oversized-header'\n ? 'CHALLENGE_TOO_LARGE'\n : 'API_UNREACHABLE';\n // The one failure with a remedy nobody can apply from inside the process, so\n // it names the operator's knob rather than suggesting a retry.\n // The knob, with no claim about payment: a caller that knows its leg passes\n // its own `fix` and says what happened to the money there.\n const fix =\n opts.fix ??\n (failure.kind === 'oversized-header'\n ? 'Raising `--max-http-header-size` on the node process that runs this CLI would let the header be read; that is an operator decision, not a default this build changes.'\n : undefined);\n return new CliError(code, failure.message, {\n ...(fix !== undefined ? { fix } : {}),\n ...(opts.details !== undefined ? { details: opts.details } : {}),\n });\n}\n\nfunction errorMessage(err: unknown): string {\n return err instanceof Error ? err.message : String(err);\n}\n\n/**\n * Does this transport failure mean the response HEADERS were too big for this\n * process to read?\n *\n * Node caps them at 16 KiB unless `--max-http-header-size` says otherwise, and\n * an x402 challenge is a header: a seller that embeds its whole output schema\n * in one can exceed the cap on its own (AnyAPI's is 52 KB, measured\n * 2026-09-22). undici then aborts the request and the generic path reported\n * `fetch failed` with no status and nothing naming the cause, which reads as\n * \"the endpoint is down\" for a seller that is answering perfectly.\n *\n * The message is undici's, matched on its stable text and on the code it\n * attaches; the CAUSE is the one that carries either, so both are checked.\n */\nfunction isHeaderOverflow(err: unknown): boolean {\n const seen = [err, (err as { cause?: unknown } | null)?.cause];\n return seen.some((candidate) => {\n if (candidate === null || typeof candidate !== 'object') return false;\n const code = (candidate as { code?: unknown }).code;\n if (code === 'UND_ERR_HEADERS_OVERFLOW' || code === 'HPE_HEADER_OVERFLOW') return true;\n const message = (candidate as { message?: unknown }).message;\n return typeof message === 'string' && /headers overflow|header overflow/i.test(message);\n });\n}\n\n/**\n * The named refusal for that case. NOT a `network` failure: nothing is wrong\n * with the connection, and a caller that retries gets the same 52 KB again.\n *\n * SAYS NOTHING ABOUT PAYMENT. This transport serves the unpaid probe and the\n * paid retry alike and cannot tell them apart, so a message asserting either\n * way is wrong on one of them: it read as \"nothing was sent\" on a leg where a\n * signed authorization had already left. The leg adds that sentence, because\n * the leg is what knows; see `runPay`.\n */\nfunction oversizedHeaderFailure(url: string): FetchJsonFailure {\n let origin = url;\n try {\n origin = new URL(url).origin;\n } catch {\n // Keep the raw string; this is a diagnostic, not a destination.\n }\n return {\n ok: false,\n kind: 'oversized-header',\n message:\n `${origin} answered with a response header block larger than this process will read. ` +\n 'An x402 challenge travels in a header, and a seller that embeds its whole output ' +\n 'schema in one can exceed the limit, so the response could not be read.',\n };\n}\n"],"mappings":"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","names":[]}
@@ -2,10 +2,10 @@ import { createRequire as __tenjinCreateRequire } from 'node:module'; const requ
2
2
  import {
3
3
  fetchFailureToCliError,
4
4
  httpRequest
5
- } from "./chunk-2SQEFBAM.js";
5
+ } from "./chunk-3BS55ANY.js";
6
6
  import {
7
7
  external_exports
8
- } from "./chunk-UNV4K45L.js";
8
+ } from "./chunk-CCDOV45D.js";
9
9
 
10
10
  // src/router/decision.ts
11
11
  var ROUTER_PATH = "/api/x402-router";
@@ -162,4 +162,4 @@ export {
162
162
  ROUTER_PATH,
163
163
  requestDecision
164
164
  };
165
- //# sourceMappingURL=chunk-XNP6VUAJ.js.map
165
+ //# sourceMappingURL=chunk-4AS52HUG.js.map
@@ -112,50 +112,26 @@ async function claimQuery(dataDir, sessionId, agentId, query, now = Date.now())
112
112
  if (last === null || now - last.at <= AUGMENT_REPEAT_MS) return false;
113
113
  return write(path, stamp);
114
114
  }
115
- function redirectPath(dataDir, sessionId, agentId) {
116
- return join(sessionDir(dataDir, sessionId), `${REDIRECT_PREFIX}${digest(agentId ?? "")}.json`);
117
- }
118
- async function noteRedirect(dataDir, sessionId, agentId, redirect, now = Date.now()) {
119
- const saved = {
120
- version: 1,
121
- at: now,
122
- id: digest(redirect.id),
123
- category: redirect.category,
124
- delivered: false
125
- };
126
- await write(redirectPath(dataDir, sessionId, agentId), saved);
127
- }
128
- async function markDelivered(dataDir, decisionId, now = Date.now()) {
129
- const directory = await resolveProgressSession(dataDir, { id: decisionId, now }).catch(
130
- () => null
131
- );
132
- if (directory === null) return;
133
- const id = digest(decisionId);
115
+ function redirectPath(dataDir, sessionId, agentId, target, window) {
116
+ const key = digest(JSON.stringify([agentId ?? "", target, window]));
117
+ return join(sessionDir(dataDir, sessionId), `${REDIRECT_PREFIX}${key}.json`);
118
+ }
119
+ async function claimRedirect(dataDir, sessionId, agentId, target, now = Date.now()) {
120
+ const window = Math.floor(now / EXPIRY_MS);
121
+ const previous = await readStamp(redirectPath(dataDir, sessionId, agentId, target, window - 1));
122
+ if (previous !== null && now - previous.at <= EXPIRY_MS) return false;
123
+ const stamp = { version: 1, at: now };
134
124
  try {
135
- const dir = await opendir(directory);
136
- let count = 0;
137
- for await (const entry of dir) {
138
- if (!entry.isFile() || !entry.name.startsWith(REDIRECT_PREFIX)) continue;
139
- if (++count > MAX_RECORDS) return;
140
- const path = join(directory, entry.name);
141
- const last = await readRedirect(path);
142
- if (last?.id !== id) continue;
143
- await write(path, { ...last, delivered: true });
144
- return;
145
- }
125
+ await writeFileAtomicExclusive(
126
+ redirectPath(dataDir, sessionId, agentId, target, window),
127
+ JSON.stringify(stamp),
128
+ { mode: 384, dirMode: 448 }
129
+ );
130
+ return true;
146
131
  } catch {
132
+ return false;
147
133
  }
148
134
  }
149
- async function takeUndelivered(dataDir, sessionId, agentId, category, now = Date.now()) {
150
- const path = redirectPath(dataDir, sessionId, agentId);
151
- const last = await readRedirect(path);
152
- if (last === null || last.delivered || last.category !== category) return false;
153
- if (now - last.at > EXPIRY_MS) return false;
154
- return rm(path).then(
155
- () => true,
156
- () => false
157
- );
158
- }
159
135
  async function resolveProgressSession(dataDir, opts = {}) {
160
136
  const now = opts.now ?? Date.now();
161
137
  const root = join(dataDir, PROGRESS_DIR);
@@ -339,12 +315,6 @@ function stampOf(row) {
339
315
  if (row === null) return null;
340
316
  return row.version === 1 && typeof row.at === "number" && Number.isFinite(row.at) ? { version: 1, at: row.at } : null;
341
317
  }
342
- async function readRedirect(path) {
343
- const row = await readJson(path);
344
- const stamp = stampOf(row);
345
- if (row === null || stamp === null) return null;
346
- return typeof row.id === "string" && typeof row.category === "string" && typeof row.delivered === "boolean" ? { ...stamp, id: row.id, category: row.category, delivered: row.delivered } : null;
347
- }
348
318
  async function readCall(path) {
349
319
  const row = await readJson(path);
350
320
  const stamp = stampOf(row);
@@ -388,13 +358,11 @@ export {
388
358
  markAugment,
389
359
  augmentOf,
390
360
  claimQuery,
391
- noteRedirect,
392
- markDelivered,
393
- takeUndelivered,
361
+ claimRedirect,
394
362
  writeProgress,
395
363
  openLookupFooter,
396
364
  pruneProgress,
397
365
  pruneSessions,
398
366
  renderProgress
399
367
  };
400
- //# sourceMappingURL=chunk-LSWVVSFX.js.map
368
+ //# sourceMappingURL=chunk-4M5FBWT5.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 * 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":";;;;;;;AAAA,SAAS,YAAY,kBAAkB;AACvC,SAAS,iBAAiB;AAC1B,SAAS,OAAO,MAAM,SAAS,UAAU;AACzC,SAAS,YAAY;AAiCrB,IAAM,eAAe;AAErB,IAAM,iBAAiB;AAEvB,IAAM,eAAe;AAErB,IAAM,eAAe;AAErB,IAAM,kBAAkB;AAExB,IAAM,iBAAiB;AAGvB,IAAM,sBAAsB;AAE5B,IAAM,eAAe;AAErB,IAAM,eAAe;AAGd,IAAM,iBAAiB;AAOvB,IAAM,YAAY;AAElB,IAAM,YAAY,KAAK;AAEvB,IAAM,oBAAoB,KAAK;AAE/B,IAAM,oBAAoB,IAAI;AAErC,IAAM,cAAc;AAGpB,IAAM,eAAe;AAErB,IAAM,mBAAmB;AAyCzB,IAAM,SAAS,CAAC,UAA0B,WAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AAEzF,SAAS,QAAQ,OAAe,OAAuB;AACrD,QAAM,QAAQ,MAAM,KAAK,KAAK;AAC9B,SAAO,MAAM,UAAU,QAAQ,QAAQ,GAAG,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;AAC9E;AAQO,SAAS,SAAS,OAAe,OAAuB;AAC7D,SAAO;AAAA,IACL,MACG,QAAQ,oBAAoB,GAAG,EAC/B,QAAQ,QAAQ,GAAG,EACnB,KAAK;AAAA,IACR;AAAA,EACF;AACF;AAOA,eAAe,MAAM,OAAe,OAAgC;AAClE,QAAM,EAAE,KAAK,IAAI,MAAM,OAAO,sBAAe;AAC7C,SAAO,SAAS,KAAK,KAAK,GAAG,KAAK;AACpC;AAGA,eAAe,WAAW,OAAgC;AACxD,MAAI;AACJ,MAAI;AACF,UAAM,IAAI,IAAI,KAAK;AAAA,EACrB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,IAAI,aAAa,MAAM,IAAI,aAAa,GAAI,QAAO;AACvD,SAAO,MAAM,GAAG,IAAI,IAAI,GAAG,IAAI,aAAa,MAAM,KAAK,IAAI,QAAQ,IAAI,GAAG;AAC5E;AAEA,eAAe,aAAa,OAA6C;AACvE,MAAI;AACJ,MAAI;AACF,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B,QAAQ;AACN,WAAO;AAAA,EACT;AACA,SAAO,SAAS,SAAY,SAAY,MAAM,MAAM,GAAG;AACzD;AAEO,SAAS,WAAW,SAAiB,WAA2B;AACrE,SAAO,KAAK,SAAS,cAAc,OAAO,SAAS,CAAC;AACtD;AAGO,SAAS,YAAoB;AAClC,SAAO,WAAW;AACpB;AAOA,eAAsB,YACpB,SACA,WACA,MAAM,KAAK,IAAI,GACA;AACf,QAAM,MAAM,KAAK,WAAW,SAAS,SAAS,GAAG,YAAY,GAAG,EAAE,SAAS,GAAG,IAAI,IAAI,CAAC;AACzF;AAGA,eAAsB,aACpB,SACA,WACA,YACA,MAAM,KAAK,IAAI,GACA;AACf,QAAM,MAAM,KAAK,WAAW,SAAS,SAAS,GAAG,GAAG,cAAc,GAAG,OAAO,UAAU,CAAC,OAAO,GAAG;AAAA,IAC/F,SAAS;AAAA,IACT,IAAI;AAAA,EACN,CAAC;AACH;AAQA,eAAsB,YACpB,SACA,WACA,WACA,MAAM,KAAK,IAAI,GACA;AACf,QAAM,MAAM,KAAK,WAAW,SAAS,SAAS,GAAG,GAAG,YAAY,GAAG,OAAO,SAAS,CAAC,OAAO,GAAG;AAAA,IAC5F,SAAS;AAAA,IACT,IAAI;AAAA,EACN,CAAC;AACH;AAEA,eAAsB,WACpB,SACA,WACA,WACA,MAAM,KAAK,IAAI,GACG;AAClB,QAAM,OAAO,KAAK,WAAW,SAAS,SAAS,GAAG,GAAG,YAAY,GAAG,OAAO,SAAS,CAAC,OAAO;AAC5F,QAAM,QAAQ,MAAM,UAAU,IAAI;AAClC,SAAO,UAAU,QAAQ,MAAM,MAAM,MAAM;AAC7C;AASA,eAAsB,YACpB,SACA,WACA,WACA,UACA,MAAM,KAAK,IAAI,GACS;AACxB,QAAM,OAAO,KAAK,WAAW,SAAS,SAAS,GAAG,GAAG,cAAc,GAAG,OAAO,SAAS,CAAC,EAAE;AACzF,QAAM,QAAsB,EAAE,SAAS,GAAG,IAAI,KAAK,UAAU,SAAS,UAAU,EAAE,EAAE;AACpF,SAAQ,MAAM,MAAM,GAAG,IAAI,SAAS,KAAK,IAAK,GAAG,IAAI,GAAG,mBAAmB,KAAK;AAClF;AAGA,eAAsB,UACpB,SACA,WACA,WACA,MAAM,KAAK,IAAI,GACiD;AAChE,QAAM,OAAO,KAAK,WAAW,SAAS,SAAS,GAAG,GAAG,cAAc,GAAG,OAAO,SAAS,CAAC,EAAE;AACzF,QAAM,MAAM,MAAM,SAAS,GAAG,IAAI,OAAO;AACzC,QAAM,QAAQ,QAAQ,GAAG;AACzB,MAAI,QAAQ,QAAQ,UAAU,QAAQ,MAAM,MAAM,KAAK,UAAW,QAAO;AACzE,QAAM,WAAW,OAAO,IAAI,aAAa,WAAW,SAAS,IAAI,UAAU,EAAE,IAAI;AACjF,SAAO,EAAE,IAAI,MAAM,IAAI,UAAU,MAAM,GAAG,IAAI,GAAG,mBAAmB,GAAG;AACzE;AAOA,eAAsB,WACpB,SACA,WACA,SACA,OACA,MAAM,KAAK,IAAI,GACG;AAClB,QAAM,MAAM,OAAO,KAAK,UAAU,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC;AACzD,QAAM,OAAO,KAAK,WAAW,SAAS,SAAS,GAAG,GAAG,YAAY,GAAG,GAAG,OAAO;AAC9E,QAAM,QAAe,EAAE,SAAS,GAAG,IAAI,IAAI;AAC3C,MAAI;AACF,UAAM,yBAAyB,MAAM,KAAK,UAAU,KAAK,GAAG,EAAE,MAAM,KAAO,SAAS,IAAM,CAAC;AAC3F,WAAO;AAAA,EACT,QAAQ;AAAA,EAER;AACA,QAAM,OAAO,MAAM,UAAU,IAAI;AACjC,MAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,kBAAmB,QAAO;AAChE,SAAO,MAAM,MAAM,KAAK;AAC1B;AAWA,SAAS,aACP,SACA,WACA,SACA,QACA,QACQ;AACR,QAAM,MAAM,OAAO,KAAK,UAAU,CAAC,WAAW,IAAI,QAAQ,MAAM,CAAC,CAAC;AAClE,SAAO,KAAK,WAAW,SAAS,SAAS,GAAG,GAAG,eAAe,GAAG,GAAG,OAAO;AAC7E;AAkBA,eAAsB,cACpB,SACA,WACA,SACA,QACA,MAAM,KAAK,IAAI,GACG;AAClB,QAAM,SAAS,KAAK,MAAM,MAAM,SAAS;AACzC,QAAM,WAAW,MAAM,UAAU,aAAa,SAAS,WAAW,SAAS,QAAQ,SAAS,CAAC,CAAC;AAC9F,MAAI,aAAa,QAAQ,MAAM,SAAS,MAAM,UAAW,QAAO;AAChE,QAAM,QAAe,EAAE,SAAS,GAAG,IAAI,IAAI;AAC3C,MAAI;AACF,UAAM;AAAA,MACJ,aAAa,SAAS,WAAW,SAAS,QAAQ,MAAM;AAAA,MACxD,KAAK,UAAU,KAAK;AAAA,MACpB,EAAE,MAAM,KAAO,SAAS,IAAM;AAAA,IAChC;AACA,WAAO;AAAA,EACT,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;AAMA,eAAsB,uBACpB,SACA,OAAsC,CAAC,GACf;AACxB,QAAM,MAAM,KAAK,OAAO,KAAK,IAAI;AACjC,QAAM,OAAO,KAAK,SAAS,YAAY;AACvC,MAAI;AACJ,MAAI;AACF,UAAM,YAAY,MAAM,QAAQ,IAAI;AACpC,YAAQ,CAAC;AACT,qBAAiB,SAAS,WAAW;AACnC,UAAI,MAAM,YAAY,KAAK,iBAAiB,KAAK,MAAM,IAAI,EAAG,OAAM,KAAK,MAAM,IAAI;AACnF,UAAI,MAAM,UAAU,aAAc;AAAA,IACpC;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,KAAK,OAAO,UAAa,KAAK,GAAG,SAAS,GAAG;AAC/C,UAAM,SAAS,GAAG,cAAc,GAAG,OAAO,KAAK,EAAE,CAAC;AAClD,eAAW,QAAQ,OAAO;AACxB,YAAM,QAAQ,MAAM,UAAU,KAAK,MAAM,MAAM,MAAM,CAAC;AACtD,UAAI,UAAU,QAAQ,MAAM,MAAM,MAAM,UAAW,QAAO,KAAK,MAAM,IAAI;AAAA,IAC3E;AAAA,EAGF;AACA,QAAM,OAAiB,CAAC;AACxB,aAAW,QAAQ,OAAO;AACxB,UAAM,UAAU,MAAM,UAAU,KAAK,MAAM,MAAM,YAAY,CAAC;AAC9D,QAAI,YAAY,QAAQ,MAAM,QAAQ,MAAM,kBAAmB,MAAK,KAAK,IAAI;AAC7E,QAAI,KAAK,SAAS,EAAG,QAAO;AAAA,EAC9B;AACA,SAAO,KAAK,WAAW,IAAI,KAAK,MAAM,KAAK,CAAC,CAAW,IAAI;AAC7D;AAOA,eAAsB,cACpB,WACA,QACA,MACA,MAAM,KAAK,IAAI,GACA;AACf,QAAM,WAAW,KAAK,aAAa,SAAY,SAAY,MAAM,WAAW,KAAK,QAAQ;AACzF,QAAM,aACJ,KAAK,eAAe,SAAY,SAAY,MAAM,aAAa,KAAK,UAAU;AAChF,QAAM,QAAuB;AAAA,IAC3B,SAAS;AAAA,IACT,IAAI;AAAA,IACJ,OAAO,KAAK;AAAA,IACZ,WAAW,SAAS,KAAK,aAAa,WAAW,EAAE,KAAK;AAAA,IACxD,GAAI,KAAK,YAAY,SAAY,EAAE,SAAS,SAAS,KAAK,SAAS,EAAE,EAAE,IAAI,CAAC;AAAA,IAC5E,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,IAC7C,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;AAAA,IACjD,GAAI,KAAK,UAAU,SAAY,EAAE,OAAO,SAAS,KAAK,OAAO,EAAE,EAAE,IAAI,CAAC;AAAA,EACxE;AACA,QAAM,MAAM,KAAK,WAAW,GAAG,OAAO,MAAM,CAAC,OAAO,GAAG,KAAK;AAC9D;AAeA,IAAM,SAAuB;AAAA,EAC3B,SAAS,YAAY;AAAA,EACrB,SAAS,YAAY;AAAA,EACrB,MAAM,YAAY;AACpB;AAOA,eAAsB,iBACpB,SACA,OAAgE,CAAC,GAC1C;AACvB,QAAM,MAAM,KAAK,OAAO,KAAK;AAC7B,QAAM,YAAY,MAAM,uBAAuB,SAAS;AAAA,IACtD,GAAI,KAAK,OAAO,SAAY,EAAE,IAAI,KAAK,GAAG,IAAI,CAAC;AAAA,IAC/C,KAAK,IAAI;AAAA,EACX,CAAC,EAAE,MAAM,MAAM,IAAI;AACnB,MAAI,cAAc,KAAM,QAAO;AAC/B,QAAM,SAAS,UAAU;AACzB,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,OAAO,OAAO,UAAuC;AACzD,UAAM,cAAc,WAAW,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;AAAA,EACvE;AACA,SAAO;AAAA,IACL,SAAS,YAAY;AACnB,YAAM,KAAK,EAAE,OAAO,UAAU,CAAC;AAC/B,YAAM,cAAc,WAAW,IAAI,CAAC;AAAA,IACtC;AAAA,IACA,SAAS,OAAO,YAAY,KAAK,EAAE,OAAO,WAAW,GAAG,QAAQ,CAAC;AAAA,IACjE,MAAM,OAAO,SAAS,WAAW,KAAK,EAAE,OAAO,QAAQ,SAAS,GAAG,OAAO,CAAC;AAAA,EAC7E;AACF;AAMA,eAAsB,cAAc,WAAmB,MAAM,KAAK,IAAI,GAAkB;AACtF,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,SAAS;AACnC,QAAI,QAAQ;AACZ,qBAAiB,SAAS,KAAK;AAC7B,UAAI,EAAE,QAAQ,YAAa;AAC3B,UAAI,CAAC,MAAM,OAAO,KAAK,MAAM,SAAS,aAAc;AACpD,YAAM,OAAO,KAAK,WAAW,MAAM,IAAI;AACvC,YAAM,SAAS,YAAY,MAAM,IAAI,IAAI,MAAM,QAAQ,IAAI,IAAI,MAAM,UAAU,IAAI;AACnF,UAAI,WAAW,QAAQ,MAAM,OAAO,KAAK,WAAW;AAClD,cAAM,GAAG,MAAM,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM,MAAM,MAAS;AAAA,MACvD;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AACF;AASA,SAAS,YAAY,MAAuB;AAC1C,SAAO,KAAK,WAAW,GAAG,KAAM,KAAK,WAAW,cAAc,KAAK,CAAC,KAAK,SAAS,OAAO;AAC3F;AAEA,eAAe,QAAQ,MAAqC;AAC1D,MAAI;AACF,WAAO,EAAE,SAAS,GAAG,KAAK,MAAM,MAAM,IAAI,GAAG,QAAQ;AAAA,EACvD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWA,eAAsB,cAAc,SAAiB,MAAM,KAAK,IAAI,GAAkB;AACpF,QAAM,OAAO,KAAK,SAAS,YAAY;AACvC,MAAI;AACF,UAAM,YAAY,MAAM,QAAQ,IAAI;AACpC,QAAI,OAAO;AACX,qBAAiB,SAAS,WAAW;AACnC,UAAI,EAAE,OAAO,aAAc;AAC3B,UAAI,CAAC,MAAM,YAAY,KAAK,CAAC,iBAAiB,KAAK,MAAM,IAAI,EAAG;AAChE,YAAM,OAAO,KAAK,MAAM,MAAM,IAAI;AAClC,YAAM,UAAU,MAAM,UAAU,KAAK,MAAM,YAAY,CAAC;AACxD,UAAI,YAAY,QAAQ,MAAM,QAAQ,MAAM,kBAAmB;AAG/D,UAAI,MAAM,cAAc,MAAM,GAAG,EAAG;AACpC,YAAM,GAAG,MAAM,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC,EAAE,MAAM,MAAM,MAAS;AAAA,IACxE;AAAA,EACF,QAAQ;AAAA,EAER;AACF;AAEA,eAAe,cAAc,WAAmB,KAA+B;AAC7E,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,SAAS;AACnC,QAAI,QAAQ;AACZ,qBAAiB,SAAS,KAAK;AAC7B,UAAI,EAAE,QAAQ,YAAa,QAAO;AAClC,UAAI,CAAC,MAAM,OAAO,KAAK,MAAM,SAAS,aAAc;AACpD,YAAM,SAAS,MAAM,UAAU,KAAK,WAAW,MAAM,IAAI,CAAC;AAC1D,UAAI,WAAW,QAAQ,MAAM,OAAO,MAAM,UAAW,QAAO;AAAA,IAC9D;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAMA,eAAsB,eACpB,SACA,WACA,UAA8C,CAAC,GAC9B;AACjB,QAAM,MAAM,QAAQ,OAAO,KAAK,IAAI;AAKpC,QAAM,UAAU,KAAK,IAAI,IAAI,KAAK,IAAI,KAAK,QAAQ,WAAW,GAAG,CAAC;AAClE,QAAM,YAAY,WAAW,SAAS,SAAS;AAC/C,QAAM,UAA2B,CAAC;AAClC,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,SAAS;AACnC,QAAI,QAAQ;AACZ,qBAAiB,SAAS,KAAK;AAC7B,UAAI,EAAE,QAAQ,YAAa,QAAO,QAAQ,4CAAyC,OAAO;AAC1F,UAAI,CAAC,MAAM,OAAO,KAAK,CAAC,aAAa,KAAK,MAAM,IAAI,EAAG;AACvD,YAAM,SAAS,MAAM,SAAS,KAAK,WAAW,MAAM,IAAI,CAAC;AACzD,UAAI,WAAW,QAAQ,MAAM,OAAO,MAAM,UAAW,SAAQ,KAAK,MAAM;AAAA,IAC1E;AAAA,EACF,SAAS,OAAO;AAKd,WAAQ,MAAgC,SAAS,WAAW,QAAQ;AAAA,EACtE;AACA,QAAM,UAAU,QACb,OAAO,CAAC,QAAQ,IAAI,UAAU,UAAU,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,EACnE,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE;AAI7B,QAAM,QAAQ,QAAQ;AAAA,IACpB,CAAC,QAAQ,IAAI,UAAU,UAAU,MAAM,IAAI,KAAK,OAAO,GAAG,KAAK,IAAI,cAAc;AAAA,EACnF;AACA,QAAM,WAAW,QACd,OAAO,CAAC,QAAQ,IAAI,UAAU,UAAU,MAAM,IAAI,MAAM,SAAS,EACjE,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE;AAC7B,QAAM,OAAO,QAAQ,CAAC,KAAK,SAAS,CAAC,KAAK,MAAM,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC7E,MAAI,SAAS,OAAW,QAAO;AAI/B,QAAM,cAAc,QAAQ,UAAU,QAAQ,CAAC,MAAM,OAAO,IAAI;AAChE,QAAM,SAAS,cAAc,IAAI,UAAO,WAAW,UAAU;AAC7D,SAAO,QAAQ,GAAG,KAAK,MAAM,GAAG,CAAC,GAAG,MAAM,IAAI,OAAO;AACvD;AAIA,IAAM,QAAQ;AAQd,SAAS,OAAO,KAA4B;AAC1C,SAAO,IAAI,UAAU,UAAU,IAAI,cAAc,YAAY,iBAAiB;AAChF;AAOA,SAAS,KAAK,KAAoB,KAAqB;AACrD,QAAM,YAAY,SAAS,IAAI,WAAW,EAAE,KAAK;AACjD,MAAI,IAAI,UAAU,UAAU,MAAM,IAAI,KAAK,gBAAgB;AACzD,WAAO,aAAU,SAAS;AAAA,EAC5B;AAGA,QAAM,QACJ,IAAI,UAAU,YACV,SAAS,IAAI,WAAW,qBAAqB,EAAE,IAC/C,IAAI,UAAU,YACZ,YACA,SAAS,IAAI,WAAW,QAAQ,EAAE;AAC1C,SACE,aAAU,SAAS,KAAK,KAAK,MAC5B,IAAI,aAAa,SAAY,IAAI,SAAS,IAAI,UAAU,GAAG,CAAC,KAAK,OACjE,IAAI,eAAe,SAAY,SAAM,SAAS,IAAI,YAAY,GAAG,CAAC,KAAK,OACvE,IAAI,UAAU,SAAY,SAAM,SAAS,IAAI,OAAO,EAAE,CAAC,KAAK;AAEjE;AAGA,eAAe,MAAM,MAAc,MAA8D;AAC/F,MAAI;AACF,UAAM,gBAAgB,MAAM,KAAK,UAAU,IAAI,GAAG,EAAE,MAAM,KAAO,SAAS,IAAM,CAAC;AACjF,WAAO;AAAA,EACT,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;AAGA,eAAe,UAAU,MAAqC;AAC5D,SAAO,QAAQ,MAAM,SAAS,IAAI,CAAC;AACrC;AAEA,SAAS,QAAQ,KAAmD;AAClE,MAAI,QAAQ,KAAM,QAAO;AACzB,SAAO,IAAI,YAAY,KAAK,OAAO,IAAI,OAAO,YAAY,OAAO,SAAS,IAAI,EAAE,IAC5E,EAAE,SAAS,GAAG,IAAI,IAAI,GAAG,IACzB;AACN;AAGA,eAAe,SAAS,MAA6C;AACnE,QAAM,MAAM,MAAM,SAAS,IAAI;AAC/B,QAAM,QAAQ,QAAQ,GAAG;AACzB,MAAI,QAAQ,QAAQ,UAAU,QAAQ,OAAO,IAAI,cAAc,SAAU,QAAO;AAChF,MAAI,CAAC,CAAC,WAAW,WAAW,MAAM,EAAE,SAAS,IAAI,KAAe,EAAG,QAAO;AAC1E,QAAM,WAAW,CAAC,WAAW,YAAY,cAAc,OAAO;AAC9D,MAAI,CAAC,SAAS,MAAM,CAAC,QAAQ,IAAI,GAAG,MAAM,UAAa,OAAO,IAAI,GAAG,MAAM,QAAQ,EAAG,QAAO;AAC7F,SAAO;AAAA,IACL,GAAG;AAAA,IACH,OAAO,IAAI;AAAA,IACX,WAAW,IAAI;AAAA,IACf,GAAG,OAAO;AAAA,MACR,SAAS,OAAO,CAAC,QAAQ,IAAI,GAAG,MAAM,MAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;AAAA,IAC/E;AAAA,EACF;AACF;AAOA,eAAe,SAAS,MAAuD;AAC7E,QAAM,OAAO,MAAM,KAAK,MAAM,UAAU,WAAW,UAAU,UAAU,EAAE,MAAM,MAAM,MAAS;AAC9F,MAAI,SAAS,OAAW,QAAO;AAC/B,MAAI;AACF,SAAK,MAAM,KAAK,KAAK,GAAG,OAAO,iBAAkB,QAAO;AACxD,UAAM,SAAS,OAAO,MAAM,mBAAmB,CAAC;AAChD,UAAM,EAAE,UAAU,IAAI,MAAM,KAAK,KAAK,QAAQ,GAAG,OAAO,QAAQ,CAAC;AACjE,QAAI,YAAY,iBAAkB,QAAO;AACzC,UAAM,SAAkB,KAAK,MAAM,OAAO,SAAS,GAAG,SAAS,EAAE,SAAS,MAAM,CAAC;AACjF,WAAO,WAAW,QAAQ,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,IACxE,OACC;AAAA,EACP,QAAQ;AACN,WAAO;AAAA,EACT,UAAE;AACA,UAAM,KAAK,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,EAC1C;AACF;","names":[]}
@@ -1,7 +1,7 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
2
  import {
3
3
  package_default
4
- } from "./chunk-PZQRSZJV.js";
4
+ } from "./chunk-P42QX3QF.js";
5
5
  import {
6
6
  CliError,
7
7
  HARNESSES,
@@ -16,7 +16,7 @@ import {
16
16
  hooksDir,
17
17
  shimBundlePath,
18
18
  vitestReporterPath
19
- } from "./chunk-2BKS2FVE.js";
19
+ } from "./chunk-TU7XH3JJ.js";
20
20
 
21
21
  // src/lib/harness-permissions.ts
22
22
  import { chmod, lstat, mkdir, readFile, realpath, stat as stat2 } from "node:fs/promises";
@@ -1781,4 +1781,4 @@ export {
1781
1781
  registeredHooks,
1782
1782
  writeHooks
1783
1783
  };
1784
- //# sourceMappingURL=chunk-ZDKEU2GF.js.map
1784
+ //# sourceMappingURL=chunk-5FYKPQNX.js.map
@@ -11,7 +11,7 @@ import {
11
11
  isSameDeployment,
12
12
  loadRawConfig,
13
13
  resolveSettings
14
- } from "./chunk-UNV4K45L.js";
14
+ } from "./chunk-CCDOV45D.js";
15
15
  import {
16
16
  CliError
17
17
  } from "./chunk-JLEF5WHM.js";
@@ -44,6 +44,13 @@ function isTeamShelfOrigin(origin, publicShelfUrl) {
44
44
  const publicOrigin = tryOrigin(publicShelfUrl);
45
45
  return publicOrigin === void 0 || !isSameDeployment(origin, publicOrigin);
46
46
  }
47
+ function isTeamModeConfig(config) {
48
+ const secret = config.shelfBypassSecret ?? CONFIG_DEFAULTS.shelfBypassSecret;
49
+ if (typeof secret !== "string" || secret === "") return false;
50
+ const origin = tryOrigin(config.baseUrl ?? CONFIG_DEFAULTS.baseUrl);
51
+ if (origin === void 0) return false;
52
+ return isTeamShelfOrigin(origin, config.publicShelfUrl ?? CONFIG_DEFAULTS.publicShelfUrl);
53
+ }
47
54
  async function resolveContextSettings(ctx) {
48
55
  const config = await loadRawConfig(ctx.dataDir);
49
56
  const s = resolveSettings({ config, flags: { baseUrl: ctx.flags.baseUrl }, env: process.env });
@@ -222,6 +229,7 @@ function defaultIsGitignored(filePath) {
222
229
 
223
230
  export {
224
231
  isTeamShelfOrigin,
232
+ isTeamModeConfig,
225
233
  resolveContextSettings,
226
234
  loadProjectConfig,
227
235
  findNearestProjectFiles,
@@ -230,4 +238,4 @@ export {
230
238
  ownedCandidates,
231
239
  projectRoot
232
240
  };
233
- //# sourceMappingURL=chunk-5DOHKQ24.js.map
241
+ //# sourceMappingURL=chunk-5KD5HRAJ.js.map