tenjin-cli 0.1.0-alpha.2 → 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 (215) hide show
  1. package/NOTICE.md +54 -7
  2. package/README.md +161 -257
  3. package/dist/{_esm-FEASBWRP.js → _esm-CE7KNONL.js} +9 -10
  4. package/dist/{ccip-NQXCEK2U.js → ccip-7RMRLAGV.js} +4 -4
  5. package/dist/{ccip-XR5NE5QK.js → ccip-NLCSCHKI.js} +5 -5
  6. package/dist/chunk-2E6GVIRP.js +888 -0
  7. package/dist/chunk-2E6GVIRP.js.map +1 -0
  8. package/dist/chunk-2G2WLVHB.js +102 -0
  9. package/dist/chunk-2G2WLVHB.js.map +1 -0
  10. package/dist/chunk-2QYORQBF.js +55 -0
  11. package/dist/chunk-2QYORQBF.js.map +1 -0
  12. package/dist/chunk-3BS55ANY.js +245 -0
  13. package/dist/chunk-3BS55ANY.js.map +1 -0
  14. package/dist/chunk-3KKKB2AQ.js +40 -0
  15. package/dist/chunk-3KKKB2AQ.js.map +1 -0
  16. package/dist/chunk-4AS52HUG.js +165 -0
  17. package/dist/chunk-4AS52HUG.js.map +1 -0
  18. package/dist/chunk-4M5FBWT5.js +368 -0
  19. package/dist/chunk-4M5FBWT5.js.map +1 -0
  20. package/dist/chunk-5FYKPQNX.js +1784 -0
  21. package/dist/chunk-5FYKPQNX.js.map +1 -0
  22. package/dist/{chunk-ZMHYXMO6.js → chunk-5IEP5EGE.js} +3 -3
  23. package/dist/chunk-5KD5HRAJ.js +241 -0
  24. package/dist/chunk-5KD5HRAJ.js.map +1 -0
  25. package/dist/chunk-72UHZRG6.js +231 -0
  26. package/dist/chunk-72UHZRG6.js.map +1 -0
  27. package/dist/chunk-7ACHDNJA.js +155 -0
  28. package/dist/chunk-7ACHDNJA.js.map +1 -0
  29. package/dist/chunk-7QKHZQKW.js +1680 -0
  30. package/dist/chunk-7QKHZQKW.js.map +1 -0
  31. package/dist/chunk-A36LQPHV.js +29 -0
  32. package/dist/chunk-A36LQPHV.js.map +1 -0
  33. package/dist/{chunk-UGX7YPX2.js → chunk-AWQPGIR6.js} +7 -9
  34. package/dist/{chunk-UGX7YPX2.js.map → chunk-AWQPGIR6.js.map} +1 -1
  35. package/dist/{chunk-5CLSD5YN.js → chunk-BPMWXTFX.js} +2 -2
  36. package/dist/{chunk-XJIW7USF.js → chunk-BTX2QE2Y.js} +115 -11
  37. package/dist/chunk-BTX2QE2Y.js.map +1 -0
  38. package/dist/{chunk-OYMYCW7J.js → chunk-CCDOV45D.js} +588 -97
  39. package/dist/chunk-CCDOV45D.js.map +1 -0
  40. package/dist/chunk-CXUYCDPX.js +127 -0
  41. package/dist/chunk-CXUYCDPX.js.map +1 -0
  42. package/dist/{chunk-YALGASEU.js → chunk-EGELTSPU.js} +2 -2
  43. package/dist/chunk-HH3PDYIG.js +194 -0
  44. package/dist/chunk-HH3PDYIG.js.map +1 -0
  45. package/dist/{chunk-CYOF7ROH.js → chunk-HPWO4O6S.js} +3 -3
  46. package/dist/chunk-JLEF5WHM.js +132 -0
  47. package/dist/chunk-JLEF5WHM.js.map +1 -0
  48. package/dist/{chunk-QVX5MWJZ.js → chunk-JRGFKVAZ.js} +2 -2
  49. package/dist/{chunk-HIVZG55D.js → chunk-KG3D7FIF.js} +2 -2
  50. package/dist/chunk-LHHMV4GU.js +27 -0
  51. package/dist/chunk-LHHMV4GU.js.map +1 -0
  52. package/dist/chunk-LI44XLMB.js +242 -0
  53. package/dist/chunk-LI44XLMB.js.map +1 -0
  54. package/dist/chunk-LN2HISWU.js +172 -0
  55. package/dist/chunk-LN2HISWU.js.map +1 -0
  56. package/dist/{chunk-YBMMV4Y4.js → chunk-MEFB5KHA.js} +13 -5
  57. package/dist/chunk-MEFB5KHA.js.map +1 -0
  58. package/dist/{chunk-NCE5NSN6.js → chunk-N35E6CM2.js} +140 -10
  59. package/dist/chunk-N35E6CM2.js.map +1 -0
  60. package/dist/chunk-NSG5TVZQ.js +447 -0
  61. package/dist/chunk-NSG5TVZQ.js.map +1 -0
  62. package/dist/chunk-O2JYBOUO.js +47 -0
  63. package/dist/chunk-O2JYBOUO.js.map +1 -0
  64. package/dist/{chunk-N62ROTMC.js → chunk-P42QX3QF.js} +14 -10
  65. package/dist/chunk-P42QX3QF.js.map +1 -0
  66. package/dist/chunk-PO4HAXAW.js +10528 -0
  67. package/dist/chunk-PO4HAXAW.js.map +1 -0
  68. package/dist/{chunk-ZABPQJ3M.js → chunk-POUWHWID.js} +2 -2
  69. package/dist/{chunk-S3IGX57D.js → chunk-RGVOODF4.js} +7703 -7475
  70. package/dist/chunk-RGVOODF4.js.map +1 -0
  71. package/dist/chunk-RPR2C2JO.js +112 -0
  72. package/dist/chunk-RPR2C2JO.js.map +1 -0
  73. package/dist/chunk-S2NRVRPF.js +171 -0
  74. package/dist/chunk-S2NRVRPF.js.map +1 -0
  75. package/dist/chunk-TGLKKLQG.js +11 -0
  76. package/dist/chunk-TGLKKLQG.js.map +1 -0
  77. package/dist/{chunk-RRN3YTK7.js → chunk-TTNESUPQ.js} +3 -3
  78. package/dist/chunk-TU7XH3JJ.js +97 -0
  79. package/dist/chunk-TU7XH3JJ.js.map +1 -0
  80. package/dist/{chunk-HSDCI7OV.js → chunk-XZKD7DIF.js} +3 -3
  81. package/dist/{chunk-Z6MFJV5Z.js → chunk-YEBNE5NW.js} +851 -500
  82. package/dist/chunk-YEBNE5NW.js.map +1 -0
  83. package/dist/chunk-YREKMJPP.js +131 -0
  84. package/dist/chunk-YREKMJPP.js.map +1 -0
  85. package/dist/{cli-4NNBEQYH.js → cli-XJQYUOHI.js} +355 -217
  86. package/dist/cli-XJQYUOHI.js.map +1 -0
  87. package/dist/config-KMJLFPSI.js +39 -0
  88. package/dist/dist-3LOO6M4U.js +2842 -0
  89. package/dist/dist-3LOO6M4U.js.map +1 -0
  90. package/dist/doctor-KMN55D7U.js +444 -0
  91. package/dist/doctor-KMN55D7U.js.map +1 -0
  92. package/dist/{ethersCompat-Df4a6QIZ-3YZIAXDK.js → ethersCompat-Df4a6QIZ-THAVUGIJ.js} +5 -5
  93. package/dist/fund-LT6ZPGEQ.js +298 -0
  94. package/dist/fund-LT6ZPGEQ.js.map +1 -0
  95. package/dist/hook-command-U5XPEHAJ.js +1052 -0
  96. package/dist/hook-command-U5XPEHAJ.js.map +1 -0
  97. package/dist/index.js +11 -3
  98. package/dist/index.js.map +1 -1
  99. package/dist/install-MMNXJ5LM.js +61 -0
  100. package/dist/install-identity-B7FVIWML.js +27 -0
  101. package/dist/install-wallet-XMVUBCHS.js +107 -0
  102. package/dist/install-wallet-XMVUBCHS.js.map +1 -0
  103. package/dist/mcp-TUPRIPSI.js +10000 -0
  104. package/dist/mcp-TUPRIPSI.js.map +1 -0
  105. package/dist/paths-LRMWNTJP.js +51 -0
  106. package/dist/pay-XAWW3NV3.js +44 -0
  107. package/dist/redact-6W23GGJC.js +15 -0
  108. package/dist/{secp256k1-N3ZHU7LB.js → secp256k1-ZZZT2CAX.js} +3 -3
  109. package/dist/secp256k1-ZZZT2CAX.js.map +1 -0
  110. package/dist/send-HESQYRKM.js +225 -0
  111. package/dist/send-HESQYRKM.js.map +1 -0
  112. package/dist/status-ANZPRZJJ.js +71 -0
  113. package/dist/status-ANZPRZJJ.js.map +1 -0
  114. package/dist/status-line-J3TUWVRQ.js +87 -0
  115. package/dist/status-line-J3TUWVRQ.js.map +1 -0
  116. package/dist/status-line-wiring-HSV7DXO5.js +29 -0
  117. package/dist/status-line-wiring-HSV7DXO5.js.map +1 -0
  118. package/dist/tenjin-daemon.mjs +20547 -0
  119. package/dist/tenjin-shim.mjs +251 -0
  120. package/dist/tenjin-vitest-reporter.mjs +49 -0
  121. package/dist/uninstall-GUU34YKP.js +165 -0
  122. package/dist/uninstall-GUU34YKP.js.map +1 -0
  123. package/dist/update-KO2NZRJ5.js +433 -0
  124. package/dist/update-KO2NZRJ5.js.map +1 -0
  125. package/dist/{viemAdapter-By13KInL-ZZE6UV4Y.js → viemAdapter-By13KInL-X2VY6CY3.js} +5 -5
  126. package/dist/viemAdapter-By13KInL-X2VY6CY3.js.map +1 -0
  127. package/dist/wallet-3URC5QPK.js +33 -0
  128. package/dist/wallet-3URC5QPK.js.map +1 -0
  129. package/dist/wallet-kdf-worker.mjs +980 -0
  130. package/docs/agent-permissions.md +139 -0
  131. package/docs/safety-model.md +70 -0
  132. package/package.json +14 -9
  133. package/LICENSE +0 -21
  134. package/dist/buy-U35DQ6XM.js +0 -1598
  135. package/dist/buy-U35DQ6XM.js.map +0 -1
  136. package/dist/candidate-RLYCQMF5.js +0 -127
  137. package/dist/candidate-RLYCQMF5.js.map +0 -1
  138. package/dist/chunk-27ONARHV.js +0 -171
  139. package/dist/chunk-27ONARHV.js.map +0 -1
  140. package/dist/chunk-3OV7E5G5.js +0 -18
  141. package/dist/chunk-3OV7E5G5.js.map +0 -1
  142. package/dist/chunk-7KUW4MJD.js +0 -59
  143. package/dist/chunk-7KUW4MJD.js.map +0 -1
  144. package/dist/chunk-7PHSZKQS.js +0 -333
  145. package/dist/chunk-7PHSZKQS.js.map +0 -1
  146. package/dist/chunk-IYLHQMT5.js +0 -211
  147. package/dist/chunk-IYLHQMT5.js.map +0 -1
  148. package/dist/chunk-JPHG2JW3.js +0 -96
  149. package/dist/chunk-JPHG2JW3.js.map +0 -1
  150. package/dist/chunk-MUBUQVC3.js +0 -67
  151. package/dist/chunk-MUBUQVC3.js.map +0 -1
  152. package/dist/chunk-N62ROTMC.js.map +0 -1
  153. package/dist/chunk-NCE5NSN6.js.map +0 -1
  154. package/dist/chunk-OYMYCW7J.js.map +0 -1
  155. package/dist/chunk-QNP7H47L.js +0 -152
  156. package/dist/chunk-QNP7H47L.js.map +0 -1
  157. package/dist/chunk-RY4XKNV3.js +0 -140
  158. package/dist/chunk-RY4XKNV3.js.map +0 -1
  159. package/dist/chunk-S3IGX57D.js.map +0 -1
  160. package/dist/chunk-TFGSOPWR.js +0 -261
  161. package/dist/chunk-TFGSOPWR.js.map +0 -1
  162. package/dist/chunk-TLCMMYLY.js +0 -126
  163. package/dist/chunk-TLCMMYLY.js.map +0 -1
  164. package/dist/chunk-UO22YNY4.js +0 -69
  165. package/dist/chunk-UO22YNY4.js.map +0 -1
  166. package/dist/chunk-UPIEAMGH.js +0 -160
  167. package/dist/chunk-UPIEAMGH.js.map +0 -1
  168. package/dist/chunk-XJIW7USF.js.map +0 -1
  169. package/dist/chunk-YBMMV4Y4.js.map +0 -1
  170. package/dist/chunk-YIYQ2ZNT.js +0 -286
  171. package/dist/chunk-YIYQ2ZNT.js.map +0 -1
  172. package/dist/chunk-YN5SHIXQ.js +0 -126
  173. package/dist/chunk-YN5SHIXQ.js.map +0 -1
  174. package/dist/chunk-Z52RA3NC.js +0 -137
  175. package/dist/chunk-Z52RA3NC.js.map +0 -1
  176. package/dist/chunk-Z6MFJV5Z.js.map +0 -1
  177. package/dist/cli-4NNBEQYH.js.map +0 -1
  178. package/dist/config-2VSXWWHK.js +0 -21
  179. package/dist/doctor-JJPNIBYH.js +0 -20
  180. package/dist/inspect-JGYJWFDP.js +0 -96
  181. package/dist/inspect-JGYJWFDP.js.map +0 -1
  182. package/dist/install-ZQRMSRGW.js +0 -378
  183. package/dist/install-ZQRMSRGW.js.map +0 -1
  184. package/dist/lookup-WYVTOMVY.js +0 -113
  185. package/dist/lookup-WYVTOMVY.js.map +0 -1
  186. package/dist/outcome-HKKT6QIA.js +0 -66
  187. package/dist/outcome-HKKT6QIA.js.map +0 -1
  188. package/dist/publish-D76B3MBK.js +0 -1480
  189. package/dist/publish-D76B3MBK.js.map +0 -1
  190. package/dist/usdc-JIAJW4SV.js +0 -22
  191. package/dist/wallet-6QKS6UHW.js +0 -179
  192. package/dist/wallet-6QKS6UHW.js.map +0 -1
  193. package/dist/wallet-PA54CRBL.js +0 -30
  194. package/skills/tenjin/SKILL.md +0 -199
  195. package/skills/tenjin-publish/SKILL.md +0 -96
  196. package/skills/tenjin-search/SKILL.md +0 -122
  197. /package/dist/{_esm-FEASBWRP.js.map → _esm-CE7KNONL.js.map} +0 -0
  198. /package/dist/{ccip-NQXCEK2U.js.map → ccip-7RMRLAGV.js.map} +0 -0
  199. /package/dist/{ccip-XR5NE5QK.js.map → ccip-NLCSCHKI.js.map} +0 -0
  200. /package/dist/{chunk-ZMHYXMO6.js.map → chunk-5IEP5EGE.js.map} +0 -0
  201. /package/dist/{chunk-5CLSD5YN.js.map → chunk-BPMWXTFX.js.map} +0 -0
  202. /package/dist/{chunk-YALGASEU.js.map → chunk-EGELTSPU.js.map} +0 -0
  203. /package/dist/{chunk-CYOF7ROH.js.map → chunk-HPWO4O6S.js.map} +0 -0
  204. /package/dist/{chunk-QVX5MWJZ.js.map → chunk-JRGFKVAZ.js.map} +0 -0
  205. /package/dist/{chunk-HIVZG55D.js.map → chunk-KG3D7FIF.js.map} +0 -0
  206. /package/dist/{chunk-ZABPQJ3M.js.map → chunk-POUWHWID.js.map} +0 -0
  207. /package/dist/{chunk-RRN3YTK7.js.map → chunk-TTNESUPQ.js.map} +0 -0
  208. /package/dist/{chunk-HSDCI7OV.js.map → chunk-XZKD7DIF.js.map} +0 -0
  209. /package/dist/{config-2VSXWWHK.js.map → config-KMJLFPSI.js.map} +0 -0
  210. /package/dist/{doctor-JJPNIBYH.js.map → ethersCompat-Df4a6QIZ-THAVUGIJ.js.map} +0 -0
  211. /package/dist/{ethersCompat-Df4a6QIZ-3YZIAXDK.js.map → install-MMNXJ5LM.js.map} +0 -0
  212. /package/dist/{secp256k1-N3ZHU7LB.js.map → install-identity-B7FVIWML.js.map} +0 -0
  213. /package/dist/{usdc-JIAJW4SV.js.map → paths-LRMWNTJP.js.map} +0 -0
  214. /package/dist/{viemAdapter-By13KInL-ZZE6UV4Y.js.map → pay-XAWW3NV3.js.map} +0 -0
  215. /package/dist/{wallet-PA54CRBL.js.map → redact-6W23GGJC.js.map} +0 -0
@@ -0,0 +1,245 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ PRODUCTION_ORIGIN
4
+ } from "./chunk-CCDOV45D.js";
5
+ import {
6
+ package_default
7
+ } from "./chunk-P42QX3QF.js";
8
+ import {
9
+ CliError
10
+ } from "./chunk-JLEF5WHM.js";
11
+
12
+ // src/lib/client-meta.ts
13
+ var TENJIN_PRODUCT = `tenjin-cli/${package_default.version}`;
14
+ var TENJIN_PRODUCT_NAME = "tenjin-cli";
15
+ var WEBSEARCH_HOOK_PRODUCT_NAME = "tenjin-websearch-hook";
16
+ var WEBSEARCH_HOOK_PRODUCT = `${WEBSEARCH_HOOK_PRODUCT_NAME}/${package_default.version}`;
17
+ var OWN_PRODUCT_NAMES = [TENJIN_PRODUCT_NAME, WEBSEARCH_HOOK_PRODUCT_NAME];
18
+ var TENJIN_COMMENT = `(+${PRODUCTION_ORIGIN})`;
19
+ var TENJIN_USER_AGENT = `${TENJIN_PRODUCT} ${TENJIN_COMMENT}`;
20
+ var WEBSEARCH_HOOK_USER_AGENT = `${WEBSEARCH_HOOK_PRODUCT} ${TENJIN_COMMENT}`;
21
+ var CALLER_USER_AGENT_ENV = "TENJIN_CALLER_USER_AGENT";
22
+ var USER_AGENT_MAX_LENGTH = 512;
23
+ var PRODUCT_RE = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+(?:\/[!#$%&'*+.^_`|~0-9A-Za-z-]+)?$/;
24
+ var PRINTABLE_ASCII_RE = /^[\x20-\x7e]*$/;
25
+ function composeUserAgent(input = {}) {
26
+ const product = input.product ?? TENJIN_PRODUCT;
27
+ const alone = `${product} ${TENJIN_COMMENT}`;
28
+ const raw = input.caller ?? (input.env ?? process.env)[CALLER_USER_AGENT_ENV];
29
+ const products = callerProducts(raw);
30
+ if (products.length === 0) return alone;
31
+ const composed = `${product} ${products.join(" ")} ${TENJIN_COMMENT}`;
32
+ return composed.length <= USER_AGENT_MAX_LENGTH ? composed : alone;
33
+ }
34
+ function callerProducts(raw) {
35
+ if (raw === void 0 || !PRINTABLE_ASCII_RE.test(raw)) return [];
36
+ const tokens = raw.split(" ").filter((token) => token.length > 0 && !isOwnIdentity(token));
37
+ return tokens.every((token) => PRODUCT_RE.test(token)) ? tokens : [];
38
+ }
39
+ function isOwnIdentity(token) {
40
+ const lower = token.toLowerCase();
41
+ if (lower === TENJIN_COMMENT.toLowerCase()) return true;
42
+ return OWN_PRODUCT_NAMES.some((name) => {
43
+ const own = name.toLowerCase();
44
+ return lower === own || lower.startsWith(`${own}/`);
45
+ });
46
+ }
47
+
48
+ // src/lib/http.ts
49
+ var SHELF_BYPASS_HEADER = "x-vercel-protection-bypass";
50
+ function shelfBypassHeaders(url, bypass) {
51
+ if (bypass === void 0 || bypass.secret.length === 0) return {};
52
+ let origin;
53
+ try {
54
+ origin = new URL(url).origin;
55
+ } catch {
56
+ return {};
57
+ }
58
+ if (origin !== bypass.origin) return {};
59
+ return { [SHELF_BYPASS_HEADER]: bypass.secret };
60
+ }
61
+ function carriesBypassKey(headers) {
62
+ return Object.keys(headers).some((name) => name.toLowerCase() === SHELF_BYPASS_HEADER);
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
+ }
80
+ function applyUserAgent(headers, callerUserAgent) {
81
+ headers.set("user-agent", composeUserAgent({ caller: callerUserAgent }));
82
+ return headers;
83
+ }
84
+ var CREDENTIAL_HEADERS = /* @__PURE__ */ new Set([
85
+ "sign-in-with-x",
86
+ "payment-signature",
87
+ "x-payment",
88
+ "tenjin-session-delegation"
89
+ ]);
90
+ function carriesSignedMaterial(headers) {
91
+ return Object.keys(headers).some((name) => CREDENTIAL_HEADERS.has(name.toLowerCase()));
92
+ }
93
+ function timeoutFailure(url, timeoutMs) {
94
+ return {
95
+ ok: false,
96
+ kind: "timeout",
97
+ message: `Request to ${url} timed out after ${timeoutMs}ms`
98
+ };
99
+ }
100
+ function prepareRequest(url, opts) {
101
+ try {
102
+ let body;
103
+ const merged = new Headers({ ...opts.headers, ...shelfBypassHeaders(url, opts.bypass) });
104
+ if (opts.jsonBody !== void 0) {
105
+ body = JSON.stringify(opts.jsonBody);
106
+ merged.set("content-type", "application/json");
107
+ } else if (opts.rawBody !== void 0) {
108
+ body = opts.rawBody;
109
+ }
110
+ const wantsAccept = opts.method === "POST" || opts.method === "PUT" || body !== void 0;
111
+ if (wantsAccept && !merged.has("accept")) merged.set("accept", "application/json");
112
+ const headers = Object.fromEntries(applyUserAgent(merged, opts.callerUserAgent).entries());
113
+ const signed = carriesSignedMaterial(headers);
114
+ const bypassed = carriesBypassKey(headers);
115
+ return {
116
+ ok: true,
117
+ headers,
118
+ body,
119
+ signed,
120
+ bypassed,
121
+ pinned: signed || bypassed || opts.blockRedirects === true
122
+ };
123
+ } catch (err) {
124
+ return {
125
+ ok: false,
126
+ kind: "network",
127
+ message: `Request to ${url} failed: ${errorMessage(err)}`
128
+ };
129
+ }
130
+ }
131
+ async function httpRequest(url, opts) {
132
+ const doFetch = opts.fetchImpl ?? fetch;
133
+ const controller = new AbortController();
134
+ let timedOut = false;
135
+ const timer = setTimeout(() => {
136
+ timedOut = true;
137
+ controller.abort();
138
+ }, opts.timeoutMs);
139
+ const signal = opts.signal === void 0 ? controller.signal : AbortSignal.any([controller.signal, opts.signal]);
140
+ try {
141
+ const prepared = prepareRequest(url, opts);
142
+ if (!prepared.ok) return prepared;
143
+ const { headers, body, signed, bypassed, pinned } = prepared;
144
+ let res;
145
+ try {
146
+ res = await doFetch(url, {
147
+ method: opts.method ?? "GET",
148
+ headers: { ...headers, ...await tenjinIdentityHeaders(url) },
149
+ body,
150
+ signal,
151
+ ...pinned ? { redirect: "manual" } : {}
152
+ });
153
+ } catch (err) {
154
+ if (timedOut) return timeoutFailure(url, opts.timeoutMs);
155
+ if (isHeaderOverflow(err)) return oversizedHeaderFailure(url);
156
+ return {
157
+ ok: false,
158
+ kind: "network",
159
+ message: `Request to ${url} failed: ${errorMessage(err)}`
160
+ };
161
+ }
162
+ const requestId = res.headers.get("x-request-id") ?? void 0;
163
+ if (pinned && res.status >= 300 && res.status < 400) {
164
+ return {
165
+ ok: false,
166
+ kind: "blocked-redirect",
167
+ status: res.status,
168
+ ...requestId !== void 0 ? { requestId } : {},
169
+ message: signed ? `Request to ${url} was redirected (${res.status}) while carrying a signed header; refusing to follow it, because the signature is bound to the configured origin.` : bypassed ? `Request to ${url} was redirected (${res.status}) while carrying the team shelf's bypass key; refusing to follow it, because the key opens only the configured origin.` : `Request to ${url} was redirected (${res.status}); refusing to follow it, because the response must come from the configured origin.`
170
+ };
171
+ }
172
+ let text;
173
+ try {
174
+ text = await res.text();
175
+ } catch (err) {
176
+ if (timedOut) return timeoutFailure(url, opts.timeoutMs);
177
+ return {
178
+ ok: false,
179
+ kind: "network",
180
+ status: res.status,
181
+ ...requestId !== void 0 ? { requestId } : {},
182
+ message: `Request to ${url} failed while reading the response body: ${errorMessage(err)}`
183
+ };
184
+ }
185
+ let json;
186
+ if (text.length > 0) {
187
+ try {
188
+ json = JSON.parse(text);
189
+ } catch {
190
+ json = void 0;
191
+ }
192
+ }
193
+ return {
194
+ ok: true,
195
+ status: res.status,
196
+ header: (name) => res.headers.get(name) ?? void 0,
197
+ json,
198
+ text,
199
+ ...requestId !== void 0 ? { requestId } : {}
200
+ };
201
+ } finally {
202
+ clearTimeout(timer);
203
+ }
204
+ }
205
+ function fetchFailureToCliError(failure, opts = {}) {
206
+ const code = failure.kind === "network" || failure.kind === "timeout" ? "NETWORK_ERROR" : failure.kind === "invalid-json" ? "CONTRACT_MISMATCH" : failure.kind === "oversized-header" ? "CHALLENGE_TOO_LARGE" : "API_UNREACHABLE";
207
+ const fix = opts.fix ?? (failure.kind === "oversized-header" ? "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." : void 0);
208
+ return new CliError(code, failure.message, {
209
+ ...fix !== void 0 ? { fix } : {},
210
+ ...opts.details !== void 0 ? { details: opts.details } : {}
211
+ });
212
+ }
213
+ function errorMessage(err) {
214
+ return err instanceof Error ? err.message : String(err);
215
+ }
216
+ function isHeaderOverflow(err) {
217
+ const seen = [err, err?.cause];
218
+ return seen.some((candidate) => {
219
+ if (candidate === null || typeof candidate !== "object") return false;
220
+ const code = candidate.code;
221
+ if (code === "UND_ERR_HEADERS_OVERFLOW" || code === "HPE_HEADER_OVERFLOW") return true;
222
+ const message = candidate.message;
223
+ return typeof message === "string" && /headers overflow|header overflow/i.test(message);
224
+ });
225
+ }
226
+ function oversizedHeaderFailure(url) {
227
+ let origin = url;
228
+ try {
229
+ origin = new URL(url).origin;
230
+ } catch {
231
+ }
232
+ return {
233
+ ok: false,
234
+ kind: "oversized-header",
235
+ message: `${origin} answered with a response header block larger than this process will read. An x402 challenge travels in a header, and a seller that embeds its whole output schema in one can exceed the limit, so the response could not be read.`
236
+ };
237
+ }
238
+
239
+ export {
240
+ composeUserAgent,
241
+ setTenjinIdentity,
242
+ httpRequest,
243
+ fetchFailureToCliError
244
+ };
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":[]}
@@ -0,0 +1,40 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+
3
+ // src/lib/usdc-balance.ts
4
+ var USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
5
+ var BALANCE_OF_SELECTOR = "0x70a08231";
6
+ var ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
7
+ var WORD_RE = /^0x[0-9a-fA-F]{64}$/;
8
+ async function readUsdcBalance(address, rpcUrl, opts) {
9
+ if (!ADDRESS_RE.test(address) || opts.timeoutMs <= 0) return null;
10
+ try {
11
+ const res = await (opts.fetchImpl ?? fetch)(rpcUrl, {
12
+ method: "POST",
13
+ headers: { "content-type": "application/json" },
14
+ body: JSON.stringify({
15
+ jsonrpc: "2.0",
16
+ id: 1,
17
+ method: "eth_call",
18
+ params: [
19
+ {
20
+ to: USDC_ADDRESS,
21
+ data: `${BALANCE_OF_SELECTOR}${address.slice(2).toLowerCase().padStart(64, "0")}`
22
+ },
23
+ "latest"
24
+ ]
25
+ }),
26
+ signal: AbortSignal.timeout(opts.timeoutMs)
27
+ });
28
+ if (!res.ok) return null;
29
+ const result = (await res.json())?.result;
30
+ return typeof result === "string" && WORD_RE.test(result) ? BigInt(result) : null;
31
+ } catch {
32
+ return null;
33
+ }
34
+ }
35
+
36
+ export {
37
+ USDC_ADDRESS,
38
+ readUsdcBalance
39
+ };
40
+ //# sourceMappingURL=chunk-3KKKB2AQ.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/usdc-balance.ts"],"sourcesContent":["/**\n * Base USDC's address and one `balanceOf` over plain JSON-RPC. No viem on\n * purpose: the router hooks read a balance before they redirect a call, and\n * their chunk graph must stay free of it (`src/router/dist-chunks.test.ts`).\n * One `eth_call` needs nothing viem adds. `usdc.ts` keeps the viem client for\n * the send path and re-exports the address from here.\n */\n\n// Values mirror the app's lib/chain.ts Base mainnet entry (chain 8453).\nexport const USDC_ADDRESS = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';\n\n/** `balanceOf(address)`: the first four bytes of its keccak-256. */\nconst BALANCE_OF_SELECTOR = '0x70a08231';\nconst ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;\n/** One ABI word: what `balanceOf` returns. */\nconst WORD_RE = /^0x[0-9a-fA-F]{64}$/;\n\n/**\n * The address's USDC balance in atomic units, or null when it could not be\n * read inside `timeoutMs`: a transport failure, a non-2xx, an RPC error, or an\n * answer that is not one word. Never throws, so the caller picks which way an\n * unreadable balance falls.\n */\nexport async function readUsdcBalance(\n address: string,\n rpcUrl: string,\n opts: { timeoutMs: number; fetchImpl?: typeof fetch },\n): Promise<bigint | null> {\n if (!ADDRESS_RE.test(address) || opts.timeoutMs <= 0) return null;\n try {\n const res = await (opts.fetchImpl ?? fetch)(rpcUrl, {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify({\n jsonrpc: '2.0',\n id: 1,\n method: 'eth_call',\n params: [\n {\n to: USDC_ADDRESS,\n data: `${BALANCE_OF_SELECTOR}${address.slice(2).toLowerCase().padStart(64, '0')}`,\n },\n 'latest',\n ],\n }),\n signal: AbortSignal.timeout(opts.timeoutMs),\n });\n if (!res.ok) return null;\n const result = ((await res.json()) as { result?: unknown } | null)?.result;\n return typeof result === 'string' && WORD_RE.test(result) ? BigInt(result) : null;\n } catch {\n return null;\n }\n}\n"],"mappings":";;;AASO,IAAM,eAAe;AAG5B,IAAM,sBAAsB;AAC5B,IAAM,aAAa;AAEnB,IAAM,UAAU;AAQhB,eAAsB,gBACpB,SACA,QACA,MACwB;AACxB,MAAI,CAAC,WAAW,KAAK,OAAO,KAAK,KAAK,aAAa,EAAG,QAAO;AAC7D,MAAI;AACF,UAAM,MAAM,OAAO,KAAK,aAAa,OAAO,QAAQ;AAAA,MAClD,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU;AAAA,QACnB,SAAS;AAAA,QACT,IAAI;AAAA,QACJ,QAAQ;AAAA,QACR,QAAQ;AAAA,UACN;AAAA,YACE,IAAI;AAAA,YACJ,MAAM,GAAG,mBAAmB,GAAG,QAAQ,MAAM,CAAC,EAAE,YAAY,EAAE,SAAS,IAAI,GAAG,CAAC;AAAA,UACjF;AAAA,UACA;AAAA,QACF;AAAA,MACF,CAAC;AAAA,MACD,QAAQ,YAAY,QAAQ,KAAK,SAAS;AAAA,IAC5C,CAAC;AACD,QAAI,CAAC,IAAI,GAAI,QAAO;AACpB,UAAM,UAAW,MAAM,IAAI,KAAK,IAAoC;AACpE,WAAO,OAAO,WAAW,YAAY,QAAQ,KAAK,MAAM,IAAI,OAAO,MAAM,IAAI;AAAA,EAC/E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}
@@ -0,0 +1,165 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ fetchFailureToCliError,
4
+ httpRequest
5
+ } from "./chunk-3BS55ANY.js";
6
+ import {
7
+ external_exports
8
+ } from "./chunk-CCDOV45D.js";
9
+
10
+ // src/router/decision.ts
11
+ var ROUTER_PATH = "/api/x402-router";
12
+ var RequestSchema = external_exports.object({
13
+ url: external_exports.string().min(1).max(16384),
14
+ method: external_exports.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]),
15
+ headers: external_exports.record(external_exports.string(), external_exports.string()),
16
+ body: external_exports.string().max(256 * 1024).optional()
17
+ });
18
+ var ContractSchema = external_exports.object({
19
+ /** Flat, for display and for the result check; never re-encoded into a call:
20
+ * the server built `request` from them and this client sends that verbatim. */
21
+ arguments: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
22
+ resultSchema: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
23
+ request: RequestSchema
24
+ });
25
+ var DiagnosticsSchema = external_exports.object({
26
+ reasonCode: external_exports.string().min(1).max(64),
27
+ stage: external_exports.string().min(1).max(32),
28
+ missing: external_exports.array(external_exports.string().max(200)).max(60),
29
+ nextAction: external_exports.string().max(500)
30
+ });
31
+ var IdSchema = external_exports.string().regex(/^[A-Za-z0-9_-]{8,64}$/).describe(
32
+ "The turn id, an OPAQUE HANDLE: it is the one piece of server text this client puts in a model-facing line, so the alphabet is pinned here rather than escaped later."
33
+ );
34
+ var RefusedSchema = external_exports.strictObject({
35
+ reason: external_exports.string().max(2e3).optional(),
36
+ diagnostics: DiagnosticsSchema
37
+ });
38
+ var CapabilityFields = {
39
+ capabilityId: external_exports.string().min(1).max(200),
40
+ category: external_exports.string().min(1).max(64),
41
+ /** The service's own name, not the x402 reseller in front of it. */
42
+ provider: external_exports.string().min(1).max(120),
43
+ capabilityDescription: external_exports.string().min(1).max(500),
44
+ /** What the provider charges, atomic USDC. The `request` tool refuses a live
45
+ * 402 above it; `gateSpend` still caps the amount actually signed. */
46
+ providerPriceAtomic: external_exports.string().regex(/^\d+$/)
47
+ };
48
+ var HookDecisionSchema = external_exports.discriminatedUnion("action", [
49
+ external_exports.strictObject({
50
+ action: external_exports.literal("execute"),
51
+ id: IdSchema,
52
+ ...CapabilityFields,
53
+ /** The x402 URL a lookup would pay, for the line the server writes. */
54
+ endpoint: external_exports.string().min(1).max(2048),
55
+ /** What to pass in `query`, in the service's own terms. */
56
+ usage: external_exports.string().min(1).max(300),
57
+ /**
58
+ * THE LINE, FINISHED. The server writes it with the real id in it and, on a
59
+ * native call, the exact search or URL that was denied. The client injects
60
+ * it and composes nothing, which is why there is no hint builder here any
61
+ * more: two sides writing the same sentence is how they drift.
62
+ */
63
+ hint: external_exports.string().min(1).max(1e3)
64
+ }).superRefine((decision, ctx) => {
65
+ if (/[\p{Cc}\p{Cf}]/u.test(decision.hint)) {
66
+ ctx.addIssue({ code: "custom", path: ["hint"], message: "a hint is one plain line" });
67
+ }
68
+ if (!decision.hint.includes("request({")) {
69
+ ctx.addIssue({ code: "custom", path: ["hint"], message: "a hint names the call to make" });
70
+ }
71
+ if (!decision.hint.includes(decision.id)) {
72
+ ctx.addIssue({
73
+ code: "custom",
74
+ path: ["hint"],
75
+ message: "a hint carries this answer's own id"
76
+ });
77
+ }
78
+ }),
79
+ RefusedSchema.extend({ action: external_exports.literal("native") }),
80
+ RefusedSchema.extend({ action: external_exports.literal("needs_input") })
81
+ ]);
82
+ var ToolDecisionSchema = external_exports.discriminatedUnion("action", [
83
+ external_exports.strictObject({
84
+ action: external_exports.literal("execute"),
85
+ ...CapabilityFields,
86
+ contract: ContractSchema
87
+ }),
88
+ RefusedSchema.extend({ action: external_exports.literal("native") }),
89
+ RefusedSchema.extend({ action: external_exports.literal("needs_input") })
90
+ ]);
91
+ function envelope(decision) {
92
+ return external_exports.strictObject({
93
+ schemaVersion: external_exports.literal(1),
94
+ routerVersion: external_exports.string().min(1).max(64),
95
+ decision,
96
+ /** A plain sentence about the CALL, such as an id that had expired. Never a
97
+ * failure: the decision beside it ran anyway. */
98
+ note: external_exports.string().max(500).optional(),
99
+ jev: external_exports.object({ calls: external_exports.number(), latencyMs: external_exports.number() }).optional()
100
+ });
101
+ }
102
+ var HookResponseSchema = envelope(HookDecisionSchema);
103
+ var ToolResponseSchema = envelope(ToolDecisionSchema);
104
+ function buildHookBody(packet) {
105
+ return { schemaVersion: 1, packet };
106
+ }
107
+ function buildToolBody(request) {
108
+ return {
109
+ schemaVersion: 1,
110
+ query: request.query,
111
+ ...request.id !== void 0 ? { id: request.id } : {},
112
+ ...request.gateHint !== void 0 ? { gateHint: request.gateHint } : {}
113
+ };
114
+ }
115
+ async function requestDecision(kind, request, deps) {
116
+ const url = new URL(ROUTER_PATH, deps.baseUrl).toString();
117
+ const options = {
118
+ method: "POST",
119
+ timeoutMs: deps.timeoutMs ?? deps.ctx.flags.timeout,
120
+ blockRedirects: true,
121
+ jsonBody: kind === "hook" ? buildHookBody(request.packet) : buildToolBody({
122
+ query: request.query,
123
+ ...request.id !== void 0 ? { id: request.id } : {},
124
+ ...request.gateHint !== void 0 ? { gateHint: request.gateHint } : {}
125
+ }),
126
+ ...deps.fetchImpl !== void 0 ? { fetchImpl: deps.fetchImpl } : {}
127
+ };
128
+ return readDecision(
129
+ await httpRequest(url, options),
130
+ kind === "hook" ? HookResponseSchema : ToolResponseSchema
131
+ );
132
+ }
133
+ function readDecision(response, schema) {
134
+ if (!response.ok) return { status: "failed", reason: fetchFailureToCliError(response).message };
135
+ if (response.status < 200 || response.status >= 300) {
136
+ const named = errorOf(response.json);
137
+ return {
138
+ status: "failed",
139
+ // The backend's own code and message, never a bare status line: a typed
140
+ // refusal the host could act on was arriving as "answered 400".
141
+ reason: named === null ? `The router endpoint answered ${response.status}.` : `The router endpoint answered ${response.status} (${named.code}): ${named.message}`,
142
+ ...named !== null ? { errorCode: named.code } : {}
143
+ };
144
+ }
145
+ const parsed = schema.safeParse(response.json);
146
+ if (!parsed.success) {
147
+ return { status: "failed", reason: "The router returned a decision this build cannot read." };
148
+ }
149
+ return { status: "decided", decision: parsed.data };
150
+ }
151
+ function errorOf(body) {
152
+ if (body === null || typeof body !== "object") return null;
153
+ const error = body.error;
154
+ if (error === null || typeof error !== "object") return null;
155
+ const { code, message } = error;
156
+ if (typeof code !== "string" || code.length === 0 || code.length > 64) return null;
157
+ const text = typeof message === "string" ? message.slice(0, 500) : "";
158
+ return { code, message: text };
159
+ }
160
+
161
+ export {
162
+ ROUTER_PATH,
163
+ requestDecision
164
+ };
165
+ //# sourceMappingURL=chunk-4AS52HUG.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/router/decision.ts"],"sourcesContent":["import { z } from 'zod';\nimport { fetchFailureToCliError, httpRequest } from '../lib/http';\nimport type { HttpRequestOptions, HttpResult } from '../lib/http';\nimport type { CommandContext } from '../context';\nimport type { Packet } from './context';\n\n/**\n * `POST /api/x402-router`: ONE FREE DECISION PER LOOKUP.\n *\n * The routing decision costs nothing and nobody signs for it. The hook asks for\n * it from the user's own words, the backend answers with what it would do and\n * what the provider charges, and the only payment on the wire is the one\n * `runPay` makes to that provider. That deletes the router fee and everything\n * built to carry it: the 402 probe, the requirements cache, the stale-quote\n * retry, the settlement accounting and one Base settlement of about 1.5 s from\n * every paid lookup.\n *\n * NOTHING IS STORED LOCALLY. The bounded packet travels with the request and\n * the backend keeps it against the decision id until that id expires, which is\n * how `request({query})` reaches the same calibrated input with no session\n * file, no timestamp latch and no guess about which window this process serves.\n */\n\nexport const ROUTER_PATH = '/api/x402-router';\n\n/**\n * The request the server builds and this client sends verbatim. Query assembly,\n * body encoding and header choice are the server's; what stays here is every\n * check that decides whether to send it at all.\n */\nconst RequestSchema = z.object({\n url: z.string().min(1).max(16_384),\n method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']),\n headers: z.record(z.string(), z.string()),\n body: z\n .string()\n .max(256 * 1024)\n .optional(),\n});\n\nconst ContractSchema = z.object({\n /** Flat, for display and for the result check; never re-encoded into a call:\n * the server built `request` from them and this client sends that verbatim. */\n arguments: z.record(z.string(), z.unknown()).optional(),\n resultSchema: z.record(z.string(), z.unknown()).optional(),\n request: RequestSchema,\n});\nexport type DecisionContract = z.infer<typeof ContractSchema>;\n\n/**\n * What stopped an outcome this client cannot execute, in terms the host can act\n * on: a stable reason code, the stage that stopped, the fields or scope choices\n * the user can supply, and one concrete next action.\n */\nconst DiagnosticsSchema = z.object({\n reasonCode: z.string().min(1).max(64),\n stage: z.string().min(1).max(32),\n missing: z.array(z.string().max(200)).max(60),\n nextAction: z.string().max(500),\n});\nexport type DecisionDiagnostics = z.infer<typeof DiagnosticsSchema>;\n\n/**\n * ONE VARIANT PER ANSWER, DISCRIMINATED ON THE ACTION. Optional fields made\n * every shape legal: an `execute` with no contract parsed and came back to the\n * host as a routine `needs_input`, a non-execute with no diagnostics parsed\n * with nothing to act on, and a hook answer carrying a contract parsed as\n * though the hook had quoted a price. Each of those is drift the shared\n * fixtures exist to catch, so each is now a parse failure that names itself.\n *\n * The two calls ask different questions and get different answers, so they get\n * different parsers. The HOOK asks whether a paid lookup is worth offering: an\n * id, or a reason it is not. The TOOL asks for the decision: the capability,\n * its price and the contract together, so a caller cannot approve one offer and\n * receive another.\n */\nconst IdSchema = z\n .string()\n .regex(/^[A-Za-z0-9_-]{8,64}$/)\n .describe(\n 'The turn id, an OPAQUE HANDLE: it is the one piece of server text this ' +\n 'client puts in a model-facing line, so the alphabet is pinned here ' +\n 'rather than escaped later.',\n );\n\n/** Every non-execute answer carries these, beside the action they explain. */\nconst RefusedSchema = z.strictObject({\n reason: z.string().max(2_000).optional(),\n diagnostics: DiagnosticsSchema,\n});\n\n/**\n * WHAT THE SERVICE IS, AND WHAT IT DOES. The hook answer used to be an id and\n * nothing else, so the line the host injected could only say \"a paid lookup is\n * available\", which a model follows 8 to 20 times in 40 where a line naming the\n * task and the service is followed 40 in 40. The gate knows which capability\n * serves the category it chose, so it now says so; the CONTRACT is still not\n * here, because the task the host will run does not exist yet.\n */\nconst CapabilityFields = {\n capabilityId: z.string().min(1).max(200),\n category: z.string().min(1).max(64),\n /** The service's own name, not the x402 reseller in front of it. */\n provider: z.string().min(1).max(120),\n capabilityDescription: z.string().min(1).max(500),\n /** What the provider charges, atomic USDC. The `request` tool refuses a live\n * 402 above it; `gateSpend` still caps the amount actually signed. */\n providerPriceAtomic: z.string().regex(/^\\d+$/),\n};\n\nconst HookDecisionSchema = z.discriminatedUnion('action', [\n z\n .strictObject({\n action: z.literal('execute'),\n id: IdSchema,\n ...CapabilityFields,\n /** The x402 URL a lookup would pay, for the line the server writes. */\n endpoint: z.string().min(1).max(2_048),\n /** What to pass in `query`, in the service's own terms. */\n usage: z.string().min(1).max(300),\n /**\n * THE LINE, FINISHED. The server writes it with the real id in it and, on a\n * native call, the exact search or URL that was denied. The client injects\n * it and composes nothing, which is why there is no hint builder here any\n * more: two sides writing the same sentence is how they drift.\n */\n hint: z.string().min(1).max(1_000),\n })\n .superRefine((decision, ctx) => {\n // STRUCTURE, NEVER WORDING. This line lands in the model's context\n // verbatim, so the shape is checked the way the id's alphabet is: one\n // line, no control characters, and it has to be the call it claims to be,\n // naming the id this same answer carries. A hint that fails any of these\n // is a protocol error and the turn falls back to the generic line; nothing\n // here rewrites a word of a hint that passes.\n if (/[\\p{Cc}\\p{Cf}]/u.test(decision.hint)) {\n ctx.addIssue({ code: 'custom', path: ['hint'], message: 'a hint is one plain line' });\n }\n if (!decision.hint.includes('request({')) {\n ctx.addIssue({ code: 'custom', path: ['hint'], message: 'a hint names the call to make' });\n }\n if (!decision.hint.includes(decision.id)) {\n ctx.addIssue({\n code: 'custom',\n path: ['hint'],\n message: \"a hint carries this answer's own id\",\n });\n }\n }),\n RefusedSchema.extend({ action: z.literal('native') }),\n RefusedSchema.extend({ action: z.literal('needs_input') }),\n]);\n\nconst ToolDecisionSchema = z.discriminatedUnion('action', [\n z.strictObject({\n action: z.literal('execute'),\n ...CapabilityFields,\n contract: ContractSchema,\n }),\n RefusedSchema.extend({ action: z.literal('native') }),\n RefusedSchema.extend({ action: z.literal('needs_input') }),\n]);\n\nfunction envelope<T extends z.ZodTypeAny>(decision: T) {\n return z.strictObject({\n schemaVersion: z.literal(1),\n routerVersion: z.string().min(1).max(64),\n decision,\n /** A plain sentence about the CALL, such as an id that had expired. Never a\n * failure: the decision beside it ran anyway. */\n note: z.string().max(500).optional(),\n jev: z.object({ calls: z.number(), latencyMs: z.number() }).optional(),\n });\n}\n\nconst HookResponseSchema = envelope(HookDecisionSchema);\nconst ToolResponseSchema = envelope(ToolDecisionSchema);\n\nexport type HookResponse = z.infer<typeof HookResponseSchema>;\nexport type ToolResponse = z.infer<typeof ToolResponseSchema>;\nexport type HookDecision = HookResponse['decision'];\nexport type ToolDecision = ToolResponse['decision'];\n\n/** Which call this is, and therefore which answer is legal for it. */\nexport type CallKind = 'hook' | 'tool';\n\n/**\n * The exact body the hook call sends, spelled once and pinned to the shared\n * fixtures. The route reads it with a strict object, so an extra field is a\n * 400, and a 400 is a turn with no hint.\n *\n * ONE BODY FOR BOTH HOOKS. Which hook is asking is not a field: the route reads\n * it from `packet.pendingCall`, which the native hook sets and the prompt hook\n * does not. A `source` beside the packet was the `/prepare` route's shape, and\n * that route is gone.\n */\nexport function buildHookBody(packet: Packet): Record<string, unknown> {\n return { schemaVersion: 1, packet };\n}\n\n/** The exact body the tool call sends. `id` is the turn whose packet decides\n * with this query; `gateHint` is evidence, never authority. */\nexport function buildToolBody(request: {\n query: string;\n id?: string;\n gateHint?: GateHint;\n}): Record<string, unknown> {\n return {\n schemaVersion: 1,\n query: request.query,\n ...(request.id !== undefined ? { id: request.id } : {}),\n ...(request.gateHint !== undefined ? { gateHint: request.gateHint } : {}),\n };\n}\n\n/** The parsers, exposed so the shared wire fixtures are checked against the\n * same schemas production parses with rather than against a copy of them. */\nexport function parseForTests(kind: CallKind, value: unknown): { success: boolean } {\n const schema = kind === 'hook' ? HookResponseSchema : ToolResponseSchema;\n return { success: schema.safeParse(value).success };\n}\n\n/**\n * The gate's own reading of this turn, travelling as EVIDENCE for the lookup it\n * was produced for. The backend may refine or reject it, and it authorizes no\n * money: the local spend policy does that. Optional on both call forms.\n */\nexport interface GateHint {\n category: string;\n turnId: string;\n lookupId: string;\n}\n\nexport interface DecisionDeps {\n ctx: CommandContext;\n baseUrl: string;\n fetchImpl?: typeof fetch;\n /** Overrides the per-call deadline; the hook passes its own, smaller one. */\n timeoutMs?: number;\n}\n\nexport type DecisionOutcome<T> =\n | { status: 'decided'; decision: T }\n /** Nothing was paid and nothing could be: the endpoint is free, so a failure\n * here costs the turn a routing answer and nothing else. */\n | { status: 'failed'; reason: string; errorCode?: string };\n\n/**\n * ONE FREE CALL, IN TWO FORMS. The hook sends `{ packet }`: the backend runs\n * the gate, and on `execute` stores that packet under an id. The tool sends\n * `{ query, id? }`: the backend makes THE decision from that query plus the\n * packet it stored, and answers with the contract to run.\n *\n * The tool never sends a packet of its own. The turn's context lives on the\n * backend against the id, and the query the model wrote is what the routing\n * corpus is calibrated against: 55 of 56 for query plus packet, 53 of 56 for\n * the raw prompt, measured on jev-1.13.0.\n */\nexport async function requestDecision(\n kind: 'hook',\n request: { packet: Packet },\n deps: DecisionDeps,\n): Promise<DecisionOutcome<HookResponse>>;\nexport async function requestDecision(\n kind: 'tool',\n request: { query: string; id?: string; gateHint?: GateHint },\n deps: DecisionDeps,\n): Promise<DecisionOutcome<ToolResponse>>;\nexport async function requestDecision(\n kind: CallKind,\n request: {\n query?: string;\n packet?: Packet;\n id?: string;\n gateHint?: GateHint;\n },\n deps: DecisionDeps,\n): Promise<DecisionOutcome<HookResponse | ToolResponse>> {\n const url = new URL(ROUTER_PATH, deps.baseUrl).toString();\n const options: HttpRequestOptions = {\n method: 'POST',\n timeoutMs: deps.timeoutMs ?? deps.ctx.flags.timeout,\n blockRedirects: true,\n jsonBody:\n kind === 'hook'\n ? buildHookBody(request.packet as Packet)\n : buildToolBody({\n query: request.query as string,\n ...(request.id !== undefined ? { id: request.id } : {}),\n ...(request.gateHint !== undefined ? { gateHint: request.gateHint } : {}),\n }),\n ...(deps.fetchImpl !== undefined ? { fetchImpl: deps.fetchImpl } : {}),\n };\n return readDecision(\n await httpRequest(url, options),\n kind === 'hook' ? HookResponseSchema : ToolResponseSchema,\n );\n}\n\nfunction readDecision<T extends z.ZodTypeAny>(\n response: HttpResult,\n schema: T,\n): DecisionOutcome<z.infer<T>> {\n // A transport failure says its own reason; nothing was paid either way,\n // because there is nothing to pay for on this route.\n if (!response.ok) return { status: 'failed', reason: fetchFailureToCliError(response).message };\n if (response.status < 200 || response.status >= 300) {\n const named = errorOf(response.json);\n return {\n status: 'failed',\n // The backend's own code and message, never a bare status line: a typed\n // refusal the host could act on was arriving as \"answered 400\".\n reason:\n named === null\n ? `The router endpoint answered ${response.status}.`\n : `The router endpoint answered ${response.status} (${named.code}): ${named.message}`,\n ...(named !== null ? { errorCode: named.code } : {}),\n };\n }\n const parsed = schema.safeParse(response.json);\n if (!parsed.success) {\n return { status: 'failed', reason: 'The router returned a decision this build cannot read.' };\n }\n return { status: 'decided', decision: parsed.data as z.infer<T> };\n}\n\n/** `{ error: { code, message } }`, the envelope every Tenjin route answers a\n * refusal with. Anything else reads as no code rather than as a guess. */\nfunction errorOf(body: unknown): { code: string; message: string } | null {\n if (body === null || typeof body !== 'object') return null;\n const error = (body as { error?: unknown }).error;\n if (error === null || typeof error !== 'object') return null;\n const { code, message } = error as { code?: unknown; message?: unknown };\n if (typeof code !== 'string' || code.length === 0 || code.length > 64) return null;\n const text = typeof message === 'string' ? message.slice(0, 500) : '';\n return { code, message: text };\n}\n"],"mappings":"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","names":[]}