tenjin-cli 0.1.0-alpha.24 → 0.1.0-alpha.26
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.
- package/README.md +19 -42
- package/dist/{chunk-GPLSNGKX.js → chunk-4HAV6IFE.js} +6 -6
- package/dist/{chunk-UXSF7IFD.js → chunk-5HS54CLI.js} +3 -3
- package/dist/{chunk-RCJ64OXH.js → chunk-5INS5ZZF.js} +36 -7
- package/dist/chunk-5INS5ZZF.js.map +1 -0
- package/dist/{chunk-XZUGRTSV.js → chunk-5NUF4BHR.js} +5 -3
- package/dist/{chunk-XZUGRTSV.js.map → chunk-5NUF4BHR.js.map} +1 -1
- package/dist/{chunk-YZTIYDWU.js → chunk-65EJJVT3.js} +2 -2
- package/dist/{chunk-ZMFDMALH.js → chunk-6JIYGYRB.js} +3 -53
- package/dist/chunk-6JIYGYRB.js.map +1 -0
- package/dist/chunk-7EKYXMUO.js +7536 -0
- package/dist/chunk-7EKYXMUO.js.map +1 -0
- package/dist/chunk-AKWGE6JQ.js +49 -0
- package/dist/chunk-AKWGE6JQ.js.map +1 -0
- package/dist/{chunk-KC24CYGV.js → chunk-ALJRB7NG.js} +14 -9
- package/dist/chunk-ALJRB7NG.js.map +1 -0
- package/dist/{chunk-S2NRVRPF.js → chunk-BOAI23CX.js} +53 -2
- package/dist/chunk-BOAI23CX.js.map +1 -0
- package/dist/{chunk-SQSKVKX6.js → chunk-DI7WHXOZ.js} +20 -16
- package/dist/chunk-DI7WHXOZ.js.map +1 -0
- package/dist/{chunk-UBOFYC6J.js → chunk-EJXIK6WY.js} +1817 -137
- package/dist/chunk-EJXIK6WY.js.map +1 -0
- package/dist/{chunk-RGVOODF4.js → chunk-EL56RW2J.js} +164 -7463
- package/dist/chunk-EL56RW2J.js.map +1 -0
- package/dist/{chunk-ZNZGBUV6.js → chunk-GHR4BTNJ.js} +9 -7
- package/dist/chunk-GHR4BTNJ.js.map +1 -0
- package/dist/chunk-H4BOQLWW.js +99 -0
- package/dist/chunk-H4BOQLWW.js.map +1 -0
- package/dist/{chunk-TMLCEPCD.js → chunk-HII5HOQV.js} +3 -5
- package/dist/chunk-HII5HOQV.js.map +1 -0
- package/dist/chunk-LFZJM56J.js +159 -0
- package/dist/chunk-LFZJM56J.js.map +1 -0
- package/dist/chunk-OBPZ36HG.js +145 -0
- package/dist/chunk-OBPZ36HG.js.map +1 -0
- package/dist/{chunk-NSDZESRS.js → chunk-OZ3LWLCI.js} +3 -3
- package/dist/chunk-PM2MOXJ3.js +66 -0
- package/dist/chunk-PM2MOXJ3.js.map +1 -0
- package/dist/chunk-PZ5N6BAL.js +268 -0
- package/dist/chunk-PZ5N6BAL.js.map +1 -0
- package/dist/{chunk-O2WN732M.js → chunk-UDWGT4FX.js} +2 -2
- package/dist/{chunk-W2ARIOAZ.js → chunk-VNT3CQFV.js} +23 -25
- package/dist/chunk-VNT3CQFV.js.map +1 -0
- package/dist/{chunk-XRW4N23F.js → chunk-W36HL4TB.js} +6 -6
- package/dist/{chunk-IIE65SJC.js → chunk-WT7DHJNJ.js} +4 -4
- package/dist/{chunk-P22ZWXFX.js → chunk-XICKN3CH.js} +49 -4
- package/dist/chunk-XICKN3CH.js.map +1 -0
- package/dist/chunk-XMIVHQ35.js +55 -0
- package/dist/chunk-XMIVHQ35.js.map +1 -0
- package/dist/chunk-YHKXNYTB.js +105 -0
- package/dist/chunk-YHKXNYTB.js.map +1 -0
- package/dist/{chunk-H5UR3GFJ.js → chunk-YHWBDCGS.js} +272 -54
- package/dist/chunk-YHWBDCGS.js.map +1 -0
- package/dist/{hook-command-GMIDXVFK.js → chunk-YLCWI6ZR.js} +231 -40
- package/dist/chunk-YLCWI6ZR.js.map +1 -0
- package/dist/{chunk-FFL5M5BC.js → chunk-YTM7OURD.js} +2 -2
- package/dist/{chunk-EP5P2STS.js → chunk-Z7R2QDX2.js} +67 -10
- package/dist/chunk-Z7R2QDX2.js.map +1 -0
- package/dist/chunk-ZLD6MJVJ.js +30 -0
- package/dist/chunk-ZLD6MJVJ.js.map +1 -0
- package/dist/{cli-GGNOQQEB.js → cli-2U5JB7OQ.js} +38 -36
- package/dist/{cli-GGNOQQEB.js.map → cli-2U5JB7OQ.js.map} +1 -1
- package/dist/{config-XUUFICXK.js → config-44EGO636.js} +14 -9
- package/dist/{doctor-3LGF6CWI.js → doctor-BD42BBEG.js} +231 -97
- package/dist/doctor-BD42BBEG.js.map +1 -0
- package/dist/env-proxy-KEGEMWKX.js +15 -0
- package/dist/{fund-3URFMBMN.js → fund-WQOOUESE.js} +26 -17
- package/dist/fund-WQOOUESE.js.map +1 -0
- package/dist/hook-command-23LC5NRN.js +32 -0
- package/dist/index.js +5 -3
- package/dist/index.js.map +1 -1
- package/dist/{install-FRTG4KHF.js → install-REPLHNU7.js} +25 -16
- package/dist/{install-identity-WNXSYP6N.js → install-identity-4RDWTLJ2.js} +6 -7
- package/dist/{install-wallet-MXLJJP3N.js → install-wallet-USHWL7AX.js} +10 -9
- package/dist/{install-wallet-MXLJJP3N.js.map → install-wallet-USHWL7AX.js.map} +1 -1
- package/dist/{mcp-O2WJ3QBW.js → mcp-T5SYCLP7.js} +778 -83
- package/dist/mcp-T5SYCLP7.js.map +1 -0
- package/dist/{pay-43WUYTW5.js → pay-276DSSYG.js} +16 -14
- package/dist/{payments-7UTMMTIO.js → payments-TZYLJXK3.js} +7 -7
- package/dist/{send-ALHG2RXT.js → send-YHDKZPED.js} +10 -11
- package/dist/{send-ALHG2RXT.js.map → send-YHDKZPED.js.map} +1 -1
- package/dist/{status-CFPNHB6R.js → status-X2INT6VD.js} +8 -9
- package/dist/{status-CFPNHB6R.js.map → status-X2INT6VD.js.map} +1 -1
- package/dist/{status-line-FJ6N7MKJ.js → status-line-QKDJYZGV.js} +4 -5
- package/dist/{status-line-FJ6N7MKJ.js.map → status-line-QKDJYZGV.js.map} +1 -1
- package/dist/{status-line-wiring-GXFNXHPE.js → status-line-wiring-LW4HFRHB.js} +6 -4
- package/dist/status-line-wiring-LW4HFRHB.js.map +1 -0
- package/dist/{uninstall-5P2GFYBY.js → uninstall-NVTGU7JD.js} +43 -33
- package/dist/uninstall-NVTGU7JD.js.map +1 -0
- package/dist/{update-QJ5YHJ7I.js → update-QXVH2DE7.js} +25 -7
- package/dist/update-QXVH2DE7.js.map +1 -0
- package/dist/{wallet-6OJPGNEV.js → wallet-CKKB23D5.js} +10 -9
- package/dist/wallet-CKKB23D5.js.map +1 -0
- package/docs/agent-permissions.md +18 -5
- package/docs/troubleshooting.md +13 -0
- package/package.json +8 -6
- package/dist/chunk-EP5P2STS.js.map +0 -1
- package/dist/chunk-H5UR3GFJ.js.map +0 -1
- package/dist/chunk-KC24CYGV.js.map +0 -1
- package/dist/chunk-O2JYBOUO.js +0 -47
- package/dist/chunk-O2JYBOUO.js.map +0 -1
- package/dist/chunk-P22ZWXFX.js.map +0 -1
- package/dist/chunk-RCJ64OXH.js.map +0 -1
- package/dist/chunk-RGVOODF4.js.map +0 -1
- package/dist/chunk-S2NRVRPF.js.map +0 -1
- package/dist/chunk-SQSKVKX6.js.map +0 -1
- package/dist/chunk-TMLCEPCD.js.map +0 -1
- package/dist/chunk-UBOFYC6J.js.map +0 -1
- package/dist/chunk-W2ARIOAZ.js.map +0 -1
- package/dist/chunk-YXLG7Q6Q.js +0 -140
- package/dist/chunk-YXLG7Q6Q.js.map +0 -1
- package/dist/chunk-ZMFDMALH.js.map +0 -1
- package/dist/chunk-ZNZGBUV6.js.map +0 -1
- package/dist/doctor-3LGF6CWI.js.map +0 -1
- package/dist/fund-3URFMBMN.js.map +0 -1
- package/dist/hook-command-GMIDXVFK.js.map +0 -1
- package/dist/mcp-O2WJ3QBW.js.map +0 -1
- package/dist/uninstall-5P2GFYBY.js.map +0 -1
- package/dist/update-QJ5YHJ7I.js.map +0 -1
- /package/dist/{chunk-GPLSNGKX.js.map → chunk-4HAV6IFE.js.map} +0 -0
- /package/dist/{chunk-UXSF7IFD.js.map → chunk-5HS54CLI.js.map} +0 -0
- /package/dist/{chunk-YZTIYDWU.js.map → chunk-65EJJVT3.js.map} +0 -0
- /package/dist/{chunk-NSDZESRS.js.map → chunk-OZ3LWLCI.js.map} +0 -0
- /package/dist/{chunk-O2WN732M.js.map → chunk-UDWGT4FX.js.map} +0 -0
- /package/dist/{chunk-XRW4N23F.js.map → chunk-W36HL4TB.js.map} +0 -0
- /package/dist/{chunk-IIE65SJC.js.map → chunk-WT7DHJNJ.js.map} +0 -0
- /package/dist/{chunk-FFL5M5BC.js.map → chunk-YTM7OURD.js.map} +0 -0
- /package/dist/{config-XUUFICXK.js.map → config-44EGO636.js.map} +0 -0
- /package/dist/{install-FRTG4KHF.js.map → env-proxy-KEGEMWKX.js.map} +0 -0
- /package/dist/{install-identity-WNXSYP6N.js.map → hook-command-23LC5NRN.js.map} +0 -0
- /package/dist/{pay-43WUYTW5.js.map → install-REPLHNU7.js.map} +0 -0
- /package/dist/{status-line-wiring-GXFNXHPE.js.map → install-identity-4RDWTLJ2.js.map} +0 -0
- /package/dist/{wallet-6OJPGNEV.js.map → pay-276DSSYG.js.map} +0 -0
- /package/dist/{payments-7UTMMTIO.js.map → payments-TZYLJXK3.js.map} +0 -0
package/README.md
CHANGED
|
@@ -35,42 +35,29 @@ Giving your agent good tools is a chore today:
|
|
|
35
35
|
- **Your agent forgets anyway.** It reaches for plain web search out of habit, so you write rules to remind it, and it still slips.
|
|
36
36
|
- **Some tools you need once.** Installing something permanent for a one-off lookup isn't worth the setup.
|
|
37
37
|
|
|
38
|
-
Tenjin handles all of it. Install it once and keep working. The Tenjin router watches the moments where a tool could help: your prompt, your agent's web searches and page fetches,
|
|
38
|
+
Tenjin handles all of it. Install it once and keep working. The Tenjin router watches the moments where a tool could help: your prompt, your agent's web searches and page fetches, the tasks it hands to subagents, and the questions it asks you. When a curated tool beats what your agent was about to do, the router suggests it and your agent calls it. Your wallet pays for each call through [x402](#wallet-and-payments), so you manage no keys and install nothing new.
|
|
39
39
|
|
|
40
40
|
## Quick start
|
|
41
41
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
npm i -g tenjin-cli
|
|
46
|
-
tenjin install # sets up Claude Code and creates your wallet
|
|
47
|
-
tenjin wallet fund 2 # optional: add $2 with a card, via Coinbase
|
|
48
|
-
```
|
|
42
|
+
In Claude Code or Claude Desktop, paste:
|
|
49
43
|
|
|
50
44
|
```text
|
|
51
|
-
|
|
52
|
-
✓ Wallet created: 0x3c0D84055994c3062819Ce8730869D0aDeA4c3Bf
|
|
53
|
-
Automatic router: up to $0.25 per call; daily limit $5 a day
|
|
54
|
-
|
|
55
|
-
Next: tenjin wallet fund, then restart Claude Code
|
|
45
|
+
Install Tenjin from tenjin.sh
|
|
56
46
|
```
|
|
57
47
|
|
|
58
|
-
|
|
48
|
+
Your agent installs it, asks you about spend limits in the session, and helps you fund the wallet.
|
|
59
49
|
|
|
60
|
-
|
|
50
|
+
Or in a terminal (Node.js 24 or newer):
|
|
61
51
|
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
> Integrate x^2 sin(x) dx from 0 to pi.
|
|
52
|
+
```bash
|
|
53
|
+
npm i -g tenjin-cli
|
|
54
|
+
tenjin install # sets up Claude Code and creates your wallet
|
|
55
|
+
tenjin wallet fund 2 # optional: add $2 with a card, via Coinbase
|
|
67
56
|
```
|
|
68
57
|
|
|
69
|
-
Each answer names the provider and the price. Your agent keeps its own tools, and the router steps in only when it has something better.
|
|
70
|
-
|
|
71
58
|
## What it can do
|
|
72
59
|
|
|
73
|
-
The router picks from a catalog we curate and maintain. When nothing in it fits, it can point your agent at a reviewed third-party pay-per-call service from the [Tenjin list](#tenjin-list-and-experimental-bazaar), and your agent decides whether to use it or to ask you first. Routing is free: you pay the provider's price and nothing else.
|
|
60
|
+
The router picks from a catalog we curate and maintain. When nothing in it fits, it can point your agent at a reviewed third-party pay-per-call service from the [Tenjin list](#tenjin-list-and-experimental-bazaar), and your agent decides whether to use it or to ask you first. Routing is free today: you pay the provider's price and nothing else. A flat [routing fee](#routing-fee) of $0.003 per routing call is coming, under the spend limits you approve at install.
|
|
74
61
|
|
|
75
62
|
| Tool | What your agent gets | Price per call |
|
|
76
63
|
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------- |
|
|
@@ -118,7 +105,7 @@ When one fits, your agent sees a one-line suggestion with the tool and its price
|
|
|
118
105
|
x402 · request: calling pro-api.coinmarketcap.com/x402/v3/cryptocurrency/quotes/latest · {"query":{"symbol":"BTC,ETH"}}
|
|
119
106
|
```
|
|
120
107
|
|
|
121
|
-
To pick a tool, the router sends your
|
|
108
|
+
To pick a tool, the router sends your prompt and recent messages with secrets masked, plus the searches, URLs, subagent tasks and questions it routes; tool results stay on your machine. [What it sends, and everything install writes →](./docs/agent-permissions.md#what-the-hooks-send)
|
|
122
109
|
|
|
123
110
|
## Wallet and payments
|
|
124
111
|
|
|
@@ -135,11 +122,15 @@ Tenjin pays for tools with [x402](https://www.x402.org), an open standard that b
|
|
|
135
122
|
| Per lookup | $0.25 | `tenjin config set maxAutoSpend 0.10` |
|
|
136
123
|
| Per day | $5 | `tenjin config set sessionBudget 2` |
|
|
137
124
|
|
|
138
|
-
|
|
125
|
+
`tenjin install` asks you to approve these limits, or tells your agent to ask you when the agent runs it. [How the limits work →](./docs/agent-permissions.md#what-bounds-a-payment)
|
|
126
|
+
|
|
127
|
+
### Routing fee
|
|
128
|
+
|
|
129
|
+
Once Tenjin's server turns it on, each routing call costs a flat $0.003, paid over x402 `batch-settlement` by `tenjin mcp` from a channel deposit of up to $0.25 (less when your per-call limit is lower). A deposit is an automatic payment: it counts against the limits above, and approving them at install approves the fee. The fees come out of the deposit and are not counted again. When a call cannot be paid, it takes the free path, and Claude Code tells you once per session why and what fixes it; `tenjin doctor` says the same. Details are in [docs/agent-permissions.md](docs/agent-permissions.md#what-bounds-a-router-payment-on-top-of-that).
|
|
139
130
|
|
|
140
131
|
### Funding
|
|
141
132
|
|
|
142
|
-
`tenjin wallet fund 2` opens a Coinbase Onramp checkout for your wallet: pay by card, or Apple Pay where your region supports it. Sign in to Coinbase or create an account during checkout. You can also send USDC on Base to the address `tenjin wallet
|
|
133
|
+
`tenjin wallet fund 2` opens a Coinbase Onramp checkout for your wallet: pay by card, or Apple Pay where your region supports it. Sign in to Coinbase or create an account during checkout. You can also send USDC on Base to the address `tenjin wallet address` prints; at a terminal it and `tenjin wallet fund` also draw that address as a QR code for a phone wallet to scan (`--no-qr` skips it).
|
|
143
134
|
|
|
144
135
|
$1–2 goes a long way. $2 covers about 280 web searches, 200 page reads or 100 Wolfram Alpha answers.
|
|
145
136
|
|
|
@@ -162,7 +153,7 @@ tenjin uninstall # remove the Claude Code setup; your wallet stays
|
|
|
162
153
|
|
|
163
154
|
Use `tenjin install --project` to set it up for a single project. Add `--json` to any command for machine-readable output.
|
|
164
155
|
|
|
165
|
-
Every paid lookup is recorded on your machine
|
|
156
|
+
Every paid lookup is recorded on your machine, with the files and full results it returned. [Where they live, and what `payments reconcile` does →](./docs/agent-permissions.md#what-a-paid-lookup-leaves-on-your-machine)
|
|
166
157
|
|
|
167
158
|
<details>
|
|
168
159
|
<summary>Status line: keeping your own</summary>
|
|
@@ -180,21 +171,6 @@ Limits are set only where no setting exists yet, so an update never overwrites y
|
|
|
180
171
|
|
|
181
172
|
</details>
|
|
182
173
|
|
|
183
|
-
<details>
|
|
184
|
-
<summary>Troubleshooting: Claude Code asks about a new project MCP server named <code>x402</code></summary>
|
|
185
|
-
|
|
186
|
-
Updating to `0.1.0-alpha.18` could accidentally register the server in `~/.mcp.json` while refreshing a user install. After upgrading to a release with the fix, check that file. If its `x402` entry runs `tenjin mcp` and you didn't install at project scope in your home directory on purpose, remove just that registration:
|
|
187
|
-
|
|
188
|
-
```bash
|
|
189
|
-
(cd ~ && claude mcp remove x402 -s project)
|
|
190
|
-
```
|
|
191
|
-
|
|
192
|
-
This keeps your other MCP entries and the user registration in `~/.claude.json`. Run `tenjin install`, then restart Claude Code. Don't use `tenjin uninstall --project` from home for this: its settings path is also the user settings path.
|
|
193
|
-
|
|
194
|
-
When refreshing from home, Tenjin keeps the existing user registration if there is one, or preserves a project-only registration; with neither, it defaults to user scope. `tenjin install --refresh --project` selects project scope explicitly.
|
|
195
|
-
|
|
196
|
-
</details>
|
|
197
|
-
|
|
198
174
|
## Request a tool
|
|
199
175
|
|
|
200
176
|
Tenjin is in alpha, and the catalog grows with what people ask for. Missing a service your agent keeps needing? Hit a lookup that went to the wrong place? We want to hear it.
|
|
@@ -206,6 +182,7 @@ Tenjin is in alpha, and the catalog grows with what people ask for. Missing a se
|
|
|
206
182
|
|
|
207
183
|
- [How a lookup runs, what it sends, and what install writes](./docs/agent-permissions.md)
|
|
208
184
|
- [Safety model](./docs/safety-model.md)
|
|
185
|
+
- [Troubleshooting](./docs/troubleshooting.md), including a stray `x402` server in `~/.mcp.json` after `0.1.0-alpha.18`
|
|
209
186
|
|
|
210
187
|
## Developing
|
|
211
188
|
|
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
|
|
2
2
|
import {
|
|
3
3
|
createLocalSpendAuthorizer
|
|
4
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-5NUF4BHR.js";
|
|
5
|
+
import {
|
|
6
|
+
emitNotice
|
|
7
|
+
} from "./chunk-UDWGT4FX.js";
|
|
5
8
|
import {
|
|
6
9
|
hashAuthorization,
|
|
7
10
|
hashMessage,
|
|
@@ -43,15 +46,12 @@ import {
|
|
|
43
46
|
swap32IfBE,
|
|
44
47
|
u32
|
|
45
48
|
} from "./chunk-BPMWXTFX.js";
|
|
46
|
-
import {
|
|
47
|
-
emitNotice
|
|
48
|
-
} from "./chunk-O2WN732M.js";
|
|
49
49
|
import {
|
|
50
50
|
hasCode
|
|
51
51
|
} from "./chunk-2I4QTOLB.js";
|
|
52
52
|
import {
|
|
53
53
|
external_exports
|
|
54
|
-
} from "./chunk-
|
|
54
|
+
} from "./chunk-XICKN3CH.js";
|
|
55
55
|
import {
|
|
56
56
|
CliError,
|
|
57
57
|
fsyncDir,
|
|
@@ -1678,4 +1678,4 @@ export {
|
|
|
1678
1678
|
@noble/ciphers/esm/utils.js:
|
|
1679
1679
|
(*! noble-ciphers - MIT License (c) 2023 Paul Miller (paulmillr.com) *)
|
|
1680
1680
|
*/
|
|
1681
|
-
//# sourceMappingURL=chunk-
|
|
1681
|
+
//# sourceMappingURL=chunk-4HAV6IFE.js.map
|
|
@@ -4,7 +4,7 @@ import {
|
|
|
4
4
|
} from "./chunk-LAIZ2AQA.js";
|
|
5
5
|
import {
|
|
6
6
|
releaseUnchargedExposure
|
|
7
|
-
} from "./chunk-
|
|
7
|
+
} from "./chunk-5NUF4BHR.js";
|
|
8
8
|
import {
|
|
9
9
|
mask
|
|
10
10
|
} from "./chunk-7QKHZQKW.js";
|
|
@@ -16,7 +16,7 @@ import {
|
|
|
16
16
|
} from "./chunk-2I4QTOLB.js";
|
|
17
17
|
import {
|
|
18
18
|
USDC_ADDRESS
|
|
19
|
-
} from "./chunk-
|
|
19
|
+
} from "./chunk-XICKN3CH.js";
|
|
20
20
|
import {
|
|
21
21
|
writeFileAtomic
|
|
22
22
|
} from "./chunk-JLEF5WHM.js";
|
|
@@ -334,4 +334,4 @@ export {
|
|
|
334
334
|
writeAll,
|
|
335
335
|
createUniqueFile
|
|
336
336
|
};
|
|
337
|
-
//# sourceMappingURL=chunk-
|
|
337
|
+
//# sourceMappingURL=chunk-5HS54CLI.js.map
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
|
|
2
|
-
import {
|
|
3
|
-
PRODUCTION_ORIGIN
|
|
4
|
-
} from "./chunk-P22ZWXFX.js";
|
|
5
2
|
import {
|
|
6
3
|
package_default
|
|
7
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-GHR4BTNJ.js";
|
|
5
|
+
import {
|
|
6
|
+
PRODUCTION_ORIGIN
|
|
7
|
+
} from "./chunk-XICKN3CH.js";
|
|
8
8
|
import {
|
|
9
9
|
CliError
|
|
10
10
|
} from "./chunk-JLEF5WHM.js";
|
|
@@ -174,7 +174,7 @@ async function httpRequest(url, opts) {
|
|
|
174
174
|
try {
|
|
175
175
|
res = await doFetch(url, {
|
|
176
176
|
method: opts.method ?? "GET",
|
|
177
|
-
headers: { ...headers, ...await tenjinIdentityHeaders(url) },
|
|
177
|
+
headers: opts.anonymous === true ? headers : { ...headers, ...await tenjinIdentityHeaders(url) },
|
|
178
178
|
body,
|
|
179
179
|
signal,
|
|
180
180
|
...pinned ? { redirect: "manual" } : {}
|
|
@@ -182,10 +182,12 @@ async function httpRequest(url, opts) {
|
|
|
182
182
|
} catch (err) {
|
|
183
183
|
if (timedOut) return timeoutFailure(url, opts.timeoutMs);
|
|
184
184
|
if (isHeaderOverflow(err)) return oversizedHeaderFailure(url);
|
|
185
|
+
const transport = transportFailure(err);
|
|
185
186
|
return {
|
|
186
187
|
ok: false,
|
|
187
188
|
kind: "network",
|
|
188
|
-
message: `Request to ${url} failed: ${errorMessage(err)}
|
|
189
|
+
message: `Request to ${url} failed: ${errorMessage(err)}`,
|
|
190
|
+
...transport !== void 0 ? { transport } : {}
|
|
189
191
|
};
|
|
190
192
|
}
|
|
191
193
|
const requestId = res.headers.get("x-request-id") ?? void 0;
|
|
@@ -269,6 +271,33 @@ function isHeaderOverflow(err) {
|
|
|
269
271
|
return typeof message === "string" && /headers overflow|header overflow/i.test(message);
|
|
270
272
|
});
|
|
271
273
|
}
|
|
274
|
+
var DNS_CODES = /* @__PURE__ */ new Set(["ENOTFOUND", "EAI_AGAIN", "EAI_FAIL", "EAI_NODATA", "EAI_NONAME"]);
|
|
275
|
+
var CONNECT_CODES = /* @__PURE__ */ new Set([
|
|
276
|
+
"ECONNREFUSED",
|
|
277
|
+
"ECONNRESET",
|
|
278
|
+
"EHOSTUNREACH",
|
|
279
|
+
"ENETUNREACH",
|
|
280
|
+
"ETIMEDOUT",
|
|
281
|
+
"UND_ERR_CONNECT_TIMEOUT",
|
|
282
|
+
"UND_ERR_SOCKET"
|
|
283
|
+
]);
|
|
284
|
+
var TLS_CODE = /^(?:ERR_TLS_|ERR_SSL_|CERT_|UNABLE_TO_|SELF_SIGNED_|DEPTH_ZERO_)/;
|
|
285
|
+
var PROXY_REFUSAL = /Proxy response \((\d{3})\)/;
|
|
286
|
+
function transportFailure(err) {
|
|
287
|
+
let link = err;
|
|
288
|
+
for (let depth = 0; depth < 5 && link !== null && typeof link === "object"; depth += 1) {
|
|
289
|
+
const { code, message, cause } = link;
|
|
290
|
+
const proxy = typeof message === "string" ? PROXY_REFUSAL.exec(message) : null;
|
|
291
|
+
if (proxy !== null) return { layer: "proxy", proxyStatus: Number(proxy[1]) };
|
|
292
|
+
if (typeof code === "string") {
|
|
293
|
+
if (DNS_CODES.has(code)) return { layer: "dns", code };
|
|
294
|
+
if (TLS_CODE.test(code)) return { layer: "tls", code };
|
|
295
|
+
if (CONNECT_CODES.has(code)) return { layer: "connect", code };
|
|
296
|
+
}
|
|
297
|
+
link = cause;
|
|
298
|
+
}
|
|
299
|
+
return void 0;
|
|
300
|
+
}
|
|
272
301
|
function oversizedHeaderFailure(url) {
|
|
273
302
|
let origin = url;
|
|
274
303
|
try {
|
|
@@ -288,4 +317,4 @@ export {
|
|
|
288
317
|
httpRequest,
|
|
289
318
|
fetchFailureToCliError
|
|
290
319
|
};
|
|
291
|
-
//# sourceMappingURL=chunk-
|
|
320
|
+
//# sourceMappingURL=chunk-5INS5ZZF.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 * On `network`: the layer the error chain names, when it names one. The\n * origin never answered, so a caller that blames it (or its base URL) gives\n * the wrong fix. See {@link transportFailure}.\n */\n transport?: TransportFailure;\n}\n\n/** Which layer refused a request that never reached the origin. */\nexport interface TransportFailure {\n layer: 'proxy' | 'dns' | 'tls' | 'connect';\n /** The socket's own error code, for every layer but `proxy`. */\n code?: string;\n /** What the proxy answered to `CONNECT`, for `proxy` only. */\n proxyStatus?: number;\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 * Keep a binary body as bytes. A sound, an image or any other non-text\n * payload decoded as text is corrupted, so with this set a response whose\n * content type is not text ({@link isBinaryContentType}) comes back with\n * `bytes` and an empty `text`. The router's provider leg sets it; every other\n * caller reads text as before.\n */\n binaryBody?: boolean;\n /** The cap on such a body; over it the response is a failure, never a\n * buffer that grows without bound. Defaults to {@link MAX_BINARY_BODY_BYTES}. */\n maxBinaryBytes?: number;\n /**\n * Send no install id, and mint none. For a request that checks the network\n * rather than uses Tenjin (the reachability probe), so it never counts as an\n * install in request telemetry.\n */\n anonymous?: boolean;\n}\n\n/** The same cap the router's linked-media download uses. */\nexport const MAX_BINARY_BODY_BYTES = 200 * 1024 * 1024;\n\n/**\n * The body's bytes, read chunk by chunk and abandoned the moment they pass\n * `max`; null over the cap. A declared length over it is refused unread.\n */\nasync function readCapped(res: Response, max: number): Promise<Uint8Array | null> {\n const declared = Number(res.headers.get('content-length') ?? '0');\n if (Number.isFinite(declared) && declared > max) {\n await res.body?.cancel().catch(() => undefined);\n return null;\n }\n if (res.body === null) return new Uint8Array();\n const reader = res.body.getReader();\n const chunks: Uint8Array[] = [];\n let size = 0;\n for (;;) {\n const { done, value } = await reader.read();\n if (done) break;\n size += value.byteLength;\n if (size > max) {\n await reader.cancel().catch(() => undefined);\n return null;\n }\n chunks.push(value);\n }\n return new Uint8Array(Buffer.concat(chunks));\n}\n\n/**\n * A content type whose body is not text: anything that is not `text/*` and\n * not a JSON, XML, JavaScript, YAML or form type. An absent header is text, as\n * it always was here.\n */\nexport function isBinaryContentType(contentType: string | undefined): boolean {\n const type = (contentType ?? '').split(';')[0]!.trim().toLowerCase();\n if (type.length === 0) return false;\n if (type.startsWith('text/')) return false;\n return !/(?:json|xml|javascript|ecmascript|yaml|x-www-form-urlencoded)/.test(type);\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 /** The body's bytes, only for a binary body read with `binaryBody`; `text`\n * is then empty. */\n bytes?: Uint8Array;\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:\n opts.anonymous === true ? 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 const transport = transportFailure(err);\n return {\n ok: false,\n kind: 'network',\n message: `Request to ${url} failed: ${errorMessage(err)}`,\n ...(transport !== undefined ? { transport } : {}),\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 let bytes: Uint8Array | undefined;\n try {\n if (opts.binaryBody === true && isBinaryContentType(res.headers.get('content-type') ?? '')) {\n const read = await readCapped(res, opts.maxBinaryBytes ?? MAX_BINARY_BODY_BYTES);\n if (read === null) {\n return {\n ok: false,\n kind: 'network',\n status: res.status,\n ...(requestId !== undefined ? { requestId } : {}),\n message: `Request to ${url} returned a file over the ${Math.round((opts.maxBinaryBytes ?? MAX_BINARY_BODY_BYTES) / 1_048_576)} MB cap; it was not kept.`,\n };\n }\n bytes = read;\n text = '';\n } else {\n text = await res.text();\n }\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 ...(bytes !== undefined ? { bytes } : {}),\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\nconst DNS_CODES = new Set(['ENOTFOUND', 'EAI_AGAIN', 'EAI_FAIL', 'EAI_NODATA', 'EAI_NONAME']);\nconst CONNECT_CODES = new Set([\n 'ECONNREFUSED',\n 'ECONNRESET',\n 'EHOSTUNREACH',\n 'ENETUNREACH',\n 'ETIMEDOUT',\n 'UND_ERR_CONNECT_TIMEOUT',\n 'UND_ERR_SOCKET',\n]);\nconst TLS_CODE = /^(?:ERR_TLS_|ERR_SSL_|CERT_|UNABLE_TO_|SELF_SIGNED_|DEPTH_ZERO_)/;\n/** undici's text when a proxy answers `CONNECT` with anything but 200. */\nconst PROXY_REFUSAL = /Proxy response \\((\\d{3})\\)/;\n\n/**\n * The layer a `fetch failed` came from, read down the `cause` chain. fetch\n * wraps the real error twice: a proxy refusing the tunnel is\n * `TypeError: fetch failed`, then `Request was cancelled.`, then undici's\n * `UND_ERR_ABORTED` with the proxy's status in its message (Node 24.18,\n * measured 2026-10-05). Undefined when no link names a layer.\n */\nexport function transportFailure(err: unknown): TransportFailure | undefined {\n let link: unknown = err;\n for (let depth = 0; depth < 5 && link !== null && typeof link === 'object'; depth += 1) {\n const { code, message, cause } = link as { code?: unknown; message?: unknown; cause?: unknown };\n const proxy = typeof message === 'string' ? PROXY_REFUSAL.exec(message) : null;\n if (proxy !== null) return { layer: 'proxy', proxyStatus: Number(proxy[1]) };\n if (typeof code === 'string') {\n if (DNS_CODES.has(code)) return { layer: 'dns', code };\n if (TLS_CODE.test(code)) return { layer: 'tls', code };\n if (CONNECT_CODES.has(code)) return { layer: 'connect', code };\n }\n link = cause;\n }\n return undefined;\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":[]}
|
|
@@ -3,13 +3,15 @@ import {
|
|
|
3
3
|
DEFAULT_WINDOW_MS,
|
|
4
4
|
RESERVATION_TTL_MS,
|
|
5
5
|
emptyLedger,
|
|
6
|
-
evaluateSpendPolicy,
|
|
7
6
|
readLedger,
|
|
8
7
|
spentOf
|
|
9
|
-
} from "./chunk-
|
|
8
|
+
} from "./chunk-6JIYGYRB.js";
|
|
10
9
|
import {
|
|
11
10
|
withFileLock
|
|
12
11
|
} from "./chunk-MEFB5KHA.js";
|
|
12
|
+
import {
|
|
13
|
+
evaluateSpendPolicy
|
|
14
|
+
} from "./chunk-XMIVHQ35.js";
|
|
13
15
|
import {
|
|
14
16
|
writeFileAtomic
|
|
15
17
|
} from "./chunk-JLEF5WHM.js";
|
|
@@ -187,4 +189,4 @@ export {
|
|
|
187
189
|
createLocalSpendAuthorizer,
|
|
188
190
|
releaseUnchargedExposure
|
|
189
191
|
};
|
|
190
|
-
//# sourceMappingURL=chunk-
|
|
192
|
+
//# sourceMappingURL=chunk-5NUF4BHR.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/lib/wallet/spend.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { randomUUID } from 'node:crypto';\nimport { writeFileAtomic } from '../atomic-json';\nimport { withFileLock } from '../lock';\nimport { spendLedgerPath } from '../paths';\nimport {\n DEFAULT_WINDOW_MS,\n emptyLedger,\n readLedger,\n RESERVATION_TTL_MS,\n spentOf,\n type Ledger,\n type Reservation,\n} from '../spend-ledger';\nimport {\n evaluateSpendPolicy,\n type PolicyReason,\n type SpendDecision,\n type SpendPolicy,\n type PaymentMode,\n} from '../policy';\nimport type { PolicyEnforcement } from './provider';\n\n/**\n * The spend-policy enforcement seam, deliberately in the WALLET PROVIDER layer,\n * BEFORE any signing/payment path, so a future hosted provider (Privy, B5)\n * inherits it: policy moves provider-side by swapping this local authorizer for\n * one the hosted signer enforces. The local authorizer is `client-only` (any\n * process that runs the CLI can edit config or the ledger), and it says so.\n *\n * sessionBudget is enforced ATOMICALLY across the per-command CLI processes an\n * agent spawns: `authorize` takes the file lock and, when a spend may proceed,\n * writes a pending RESERVATION that counts against the budget immediately. Two\n * concurrent authorizations therefore each see the other's reservation and the\n * second is denied, closing the check-then-pay TOCTOU. `commit` finalizes a\n * reservation into committed spend after settlement; `release` drops an unused\n * one (a decline or a failed payment). A reservation left dangling (a crash\n * between authorize and commit) self-expires after RESERVATION_TTL_MS.\n */\n\nexport interface SpendRequest {\n mode?: PaymentMode;\n amountAtomic: bigint;\n creator: string;\n /** The caller's `--max-price` cap, if any. */\n maxPriceAtomic?: bigint;\n /**\n * THE SAME-TURN DUPLICATE GUARD. An opaque identity for the request being\n * paid for (its destination and its exact arguments), recorded on the\n * reservation. A second authorization carrying a key an unexpired reservation\n * already holds is DENIED rather than reserved, so one in-flight payment can\n * never become two because a caller retried, a harness re-fired, or a second\n * process asked for the same thing. Same lock and same file as the budget, so\n * the check is atomic across the per-command processes an agent spawns; the\n * reservation TTL is what bounds \"same turn\". Omit it and nothing changes.\n */\n requestKey?: string;\n}\n\nexport interface SpendAuthorization {\n decision: SpendDecision;\n reason: PolicyReason;\n message: string;\n amountAtomic: bigint;\n sessionSpentAtomic: bigint;\n sessionBudgetAtomic: bigint | null;\n policyEnforcement: PolicyEnforcement;\n /** The pending reservation to commit (on settlement) or release (on abort).\n * Present when the spend may proceed, including an unlimited budget. */\n reservationId?: string;\n}\n\nexport interface SpendAuthorizer {\n policyEnforcement: PolicyEnforcement;\n /** Evaluate a spend against policy + the rolling session ledger, atomically\n * reserving budget when the spend may proceed. */\n authorize(req: SpendRequest): Promise<SpendAuthorization>;\n /**\n * Finalize a reservation into committed spend after settlement. Runs only\n * post-settlement, so `amountAtomic` is authoritative: if the reservation\n * TTL-expired mid-confirm (a human can out-wait RESERVATION_TTL_MS at the\n * prompt), the settled amount is still recorded rather than silently lost\n * from the rolling budget.\n */\n commit(\n reservationId: string | undefined,\n amountAtomic: bigint,\n /** What the counterparty reported actually taking, when it said so at all.\n * Omitted means \"assume it took what was authorized\", the conservative\n * reading every caller had before the router began waiving fees. */\n opts?: { settledAtomic?: bigint; mode?: PaymentMode; nonce?: string },\n ): Promise<void>;\n /** Drop an unused reservation (a decline, a 409, or a failed payment). */\n release(reservationId: string | undefined): Promise<void>;\n}\n\nexport interface LocalSpendAuthorizerDeps {\n dir: string;\n policy: SpendPolicy;\n /** Rolling window length (ms); default 24h. Injectable for tests. */\n windowMs?: number;\n /** Clock seam for deterministic window tests. */\n now?: () => number;\n /**\n * Called at most ONCE per authorizer when the ledger file exists but cannot be\n * read back. The reset below is fail-open by design, and a silent one hands back\n * budget the operator believes is already spent — so the caller gets to say so.\n */\n onCorrupt?: (reason: string) => void;\n}\n\nexport function createLocalSpendAuthorizer(deps: LocalSpendAuthorizerDeps): SpendAuthorizer {\n const windowMs = deps.windowMs ?? DEFAULT_WINDOW_MS;\n const now = deps.now ?? Date.now;\n const path = spendLedgerPath(deps.dir);\n const lockPath = `${path}.lock`;\n // One notice per authorizer: authorize and commit each read the file, and the\n // reset is not persisted until something is written, so an unlatched warning\n // would fire twice for the same broken file within one command.\n let warnedCorrupt = false;\n\n // Roll the window and drop expired reservations; returns the live ledger.\n const freshen = (ledger: Ledger | null, nowMs: number): Ledger => {\n if (ledger === null || nowMs - ledger.windowStartMs >= windowMs) return emptyLedger(nowMs);\n return {\n ...ledger,\n reservations: ledger.reservations.filter((r) => nowMs - r.atMs < RESERVATION_TTL_MS),\n };\n };\n\n const persist = async (ledger: Ledger): Promise<void> => {\n await writeFileAtomic(path, `${JSON.stringify(ledger, null, 2)}\\n`, {\n mode: 0o600,\n dirMode: 0o700,\n });\n };\n\n async function withLedger<T>(fn: (ledger: Ledger, nowMs: number) => Promise<T> | T): Promise<T> {\n await mkdir(deps.dir, { recursive: true, mode: 0o700 });\n return withFileLock(lockPath, async () => {\n const nowMs = now();\n const read = await readLedger(path);\n if (read.corrupt !== undefined && !warnedCorrupt) {\n warnedCorrupt = true;\n deps.onCorrupt?.(read.corrupt);\n }\n const ledger = freshen(read.ledger, nowMs);\n return fn(ledger, nowMs);\n });\n }\n\n return {\n policyEnforcement: 'client-only',\n async authorize(req: SpendRequest): Promise<SpendAuthorization> {\n return withLedger(async (ledger) => {\n const sessionSpentAtomic = spentOf(ledger);\n if (\n req.requestKey !== undefined &&\n ledger.reservations.some((r) => r.requestKey === req.requestKey)\n ) {\n return {\n decision: 'deny',\n reason: 'duplicate_in_flight',\n message:\n 'An identical request already holds a reservation in this turn. No second payment was made.',\n amountAtomic: req.amountAtomic,\n sessionSpentAtomic,\n sessionBudgetAtomic: deps.policy.sessionBudgetAtomic,\n policyEnforcement: 'client-only',\n };\n }\n const evaluation = evaluateSpendPolicy(deps.policy, {\n mode: req.mode ?? 'automatic',\n amountAtomic: req.amountAtomic,\n creator: req.creator,\n ...(req.maxPriceAtomic !== undefined ? { maxPriceAtomic: req.maxPriceAtomic } : {}),\n sessionSpentAtomic,\n });\n const base: SpendAuthorization = {\n ...evaluation,\n amountAtomic: req.amountAtomic,\n sessionSpentAtomic,\n sessionBudgetAtomic: deps.policy.sessionBudgetAtomic,\n policyEnforcement: 'client-only',\n };\n // Unlimited budgets still reserve to prevent identical in-flight requests.\n if (evaluation.decision === 'deny') {\n return base;\n }\n const reservation: Reservation = {\n id: randomUUID(),\n mode: req.mode ?? 'automatic',\n amountAtomic: req.amountAtomic.toString(),\n atMs: now(),\n ...(req.requestKey !== undefined ? { requestKey: req.requestKey } : {}),\n };\n await persist({ ...ledger, reservations: [...ledger.reservations, reservation] });\n return { ...base, reservationId: reservation.id };\n });\n },\n async commit(\n reservationId: string | undefined,\n amountAtomic: bigint,\n opts: { settledAtomic?: bigint; mode?: PaymentMode; nonce?: string } = {},\n ): Promise<void> {\n // Record transmitted exposure even if its reservation has expired.\n await withLedger(async (ledger) => {\n const reservation =\n reservationId !== undefined\n ? ledger.reservations.find((r) => r.id === reservationId)\n : undefined;\n const exposure =\n reservation !== undefined ? BigInt(reservation.amountAtomic) : amountAtomic;\n // TWO NUMBERS, ON PURPOSE. The budget keeps counting what left; the\n // settled total records what was taken, and they differ whenever a\n // counterparty waives a fee against an authorization already sent.\n const settled = opts.settledAtomic ?? exposure;\n const settledSoFar = BigInt(ledger.settledAtomic ?? ledger.committedAtomic);\n const mode = reservation ? (reservation.mode ?? 'automatic') : (opts.mode ?? 'automatic');\n await persist({\n ...ledger,\n committedAtomic: (BigInt(ledger.committedAtomic) + exposure).toString(),\n automaticCommittedAtomic: (\n BigInt(ledger.automaticCommittedAtomic ?? ledger.committedAtomic) +\n (mode === 'manual' ? 0n : exposure)\n ).toString(),\n settledAtomic: (settledSoFar + settled).toString(),\n reservations:\n reservationId !== undefined\n ? ledger.reservations.filter((r) => r.id !== reservationId)\n : ledger.reservations,\n // Keyed by the authorization's nonce, so a reconcile that proves it\n // was never charged can release this amount and nothing else.\n ...(opts.nonce !== undefined\n ? {\n exposures: [\n ...(ledger.exposures ?? []),\n {\n nonce: opts.nonce.toLowerCase(),\n amountAtomic: exposure.toString(),\n atMs: now(),\n mode,\n },\n ],\n }\n : {}),\n });\n });\n },\n async release(reservationId: string | undefined): Promise<void> {\n if (reservationId === undefined) return;\n await withLedger(async (ledger) => {\n if (!ledger.reservations.some((r) => r.id === reservationId)) return;\n await persist({\n ...ledger,\n reservations: ledger.reservations.filter((r) => r.id !== reservationId),\n });\n });\n },\n };\n}\n\n/**\n * GIVE BACK A PAYMENT THE CHAIN PROVED WAS NEVER CHARGED: its authorization\n * expired unused. Exactly the exposure recorded under that nonce comes off the\n * committed totals, once; a nonce from an earlier window, from a ledger an\n * older build wrote, or one already released finds nothing and changes\n * nothing. Returns the amount released, or null when the ledger could not be\n * updated, so the caller keeps the payment open and asks again.\n */\nexport async function releaseUnchargedExposure(\n dir: string,\n nonce: string,\n opts: { now?: () => number; windowMs?: number } = {},\n): Promise<bigint | null> {\n const path = spendLedgerPath(dir);\n const nowMs = (opts.now ?? Date.now)();\n try {\n return await withFileLock(`${path}.lock`, async () => {\n const { ledger } = await readLedger(path);\n if (ledger === null || nowMs - ledger.windowStartMs >= (opts.windowMs ?? DEFAULT_WINDOW_MS)) {\n return 0n;\n }\n const key = nonce.toLowerCase();\n const entry = (ledger.exposures ?? []).find((e) => e.nonce === key);\n if (entry === undefined) return 0n;\n const amount = BigInt(entry.amountAtomic);\n const less = (value: string | undefined, fallback: string): string => {\n const current = BigInt(value ?? fallback);\n return (current > amount ? current - amount : 0n).toString();\n };\n await writeFileAtomic(\n path,\n `${JSON.stringify(\n {\n ...ledger,\n committedAtomic: less(ledger.committedAtomic, '0'),\n ...(entry.mode === 'manual'\n ? {}\n : {\n automaticCommittedAtomic: less(\n ledger.automaticCommittedAtomic,\n ledger.committedAtomic,\n ),\n }),\n settledAtomic: less(ledger.settledAtomic, ledger.committedAtomic),\n exposures: (ledger.exposures ?? []).filter((e) => e.nonce !== key),\n },\n null,\n 2,\n )}\\n`,\n { mode: 0o600, dirMode: 0o700 },\n );\n return amount;\n });\n } catch {\n return null;\n }\n}\n\nexport { readSpendSummary, type SpendSummary } from '../spend-ledger';\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/lib/wallet/spend.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { randomUUID } from 'node:crypto';\nimport { writeFileAtomic } from '../atomic-json';\nimport { withFileLock } from '../lock';\nimport { spendLedgerPath } from '../paths';\nimport {\n DEFAULT_WINDOW_MS,\n emptyLedger,\n readLedger,\n RESERVATION_TTL_MS,\n spentOf,\n type Ledger,\n type Reservation,\n} from '../spend-ledger';\nimport {\n evaluateSpendPolicy,\n type PolicyReason,\n type SpendDecision,\n type SpendPolicy,\n type PaymentMode,\n} from '../policy';\nimport type { PolicyEnforcement } from './provider';\n\n/**\n * The spend-policy enforcement seam, deliberately in the WALLET PROVIDER layer,\n * BEFORE any signing/payment path, so a future hosted provider (Privy, B5)\n * inherits it: policy moves provider-side by swapping this local authorizer for\n * one the hosted signer enforces. The local authorizer is `client-only` (any\n * process that runs the CLI can edit config or the ledger), and it says so.\n *\n * sessionBudget is enforced ATOMICALLY across the per-command CLI processes an\n * agent spawns: `authorize` takes the file lock and, when a spend may proceed,\n * writes a pending RESERVATION that counts against the budget immediately. Two\n * concurrent authorizations therefore each see the other's reservation and the\n * second is denied, closing the check-then-pay TOCTOU. `commit` finalizes a\n * reservation into committed spend after settlement; `release` drops an unused\n * one (a decline or a failed payment). A reservation left dangling (a crash\n * between authorize and commit) self-expires after RESERVATION_TTL_MS.\n */\n\nexport interface SpendRequest {\n mode?: PaymentMode;\n amountAtomic: bigint;\n creator: string;\n /** The caller's `--max-price` cap, if any. */\n maxPriceAtomic?: bigint;\n /**\n * THE SAME-TURN DUPLICATE GUARD. An opaque identity for the request being\n * paid for (its destination and its exact arguments), recorded on the\n * reservation. A second authorization carrying a key an unexpired reservation\n * already holds is DENIED rather than reserved, so one in-flight payment can\n * never become two because a caller retried, a harness re-fired, or a second\n * process asked for the same thing. Same lock and same file as the budget, so\n * the check is atomic across the per-command processes an agent spawns; the\n * reservation TTL is what bounds \"same turn\". Omit it and nothing changes.\n */\n requestKey?: string;\n}\n\nexport interface SpendAuthorization {\n decision: SpendDecision;\n reason: PolicyReason;\n message: string;\n amountAtomic: bigint;\n sessionSpentAtomic: bigint;\n sessionBudgetAtomic: bigint | null;\n policyEnforcement: PolicyEnforcement;\n /** The pending reservation to commit (on settlement) or release (on abort).\n * Present when the spend may proceed, including an unlimited budget. */\n reservationId?: string;\n}\n\nexport interface SpendAuthorizer {\n policyEnforcement: PolicyEnforcement;\n /** Evaluate a spend against policy + the rolling session ledger, atomically\n * reserving budget when the spend may proceed. */\n authorize(req: SpendRequest): Promise<SpendAuthorization>;\n /**\n * Finalize a reservation into committed spend after settlement. Runs only\n * post-settlement, so `amountAtomic` is authoritative: if the reservation\n * TTL-expired mid-confirm (a human can out-wait RESERVATION_TTL_MS at the\n * prompt), the settled amount is still recorded rather than silently lost\n * from the rolling budget.\n */\n commit(\n reservationId: string | undefined,\n amountAtomic: bigint,\n /** What the counterparty reported actually taking, when it said so at all.\n * Omitted means \"assume it took what was authorized\", the conservative\n * reading every caller had before the router began waiving fees. */\n opts?: { settledAtomic?: bigint; mode?: PaymentMode; nonce?: string },\n ): Promise<void>;\n /** Drop an unused reservation (a decline, a 409, or a failed payment). */\n release(reservationId: string | undefined): Promise<void>;\n}\n\nexport interface LocalSpendAuthorizerDeps {\n dir: string;\n policy: SpendPolicy;\n /** Rolling window length (ms); default 24h. Injectable for tests. */\n windowMs?: number;\n /** Clock seam for deterministic window tests. */\n now?: () => number;\n /**\n * Called at most ONCE per authorizer when the ledger file exists but cannot be\n * read back. The reset below is fail-open by design, and a silent one hands back\n * budget the operator believes is already spent — so the caller gets to say so.\n */\n onCorrupt?: (reason: string) => void;\n}\n\nexport function createLocalSpendAuthorizer(deps: LocalSpendAuthorizerDeps): SpendAuthorizer {\n const windowMs = deps.windowMs ?? DEFAULT_WINDOW_MS;\n const now = deps.now ?? Date.now;\n const path = spendLedgerPath(deps.dir);\n const lockPath = `${path}.lock`;\n // One notice per authorizer: authorize and commit each read the file, and the\n // reset is not persisted until something is written, so an unlatched warning\n // would fire twice for the same broken file within one command.\n let warnedCorrupt = false;\n\n // Roll the window and drop expired reservations; returns the live ledger.\n const freshen = (ledger: Ledger | null, nowMs: number): Ledger => {\n if (ledger === null || nowMs - ledger.windowStartMs >= windowMs) return emptyLedger(nowMs);\n return {\n ...ledger,\n reservations: ledger.reservations.filter((r) => nowMs - r.atMs < RESERVATION_TTL_MS),\n };\n };\n\n const persist = async (ledger: Ledger): Promise<void> => {\n await writeFileAtomic(path, `${JSON.stringify(ledger, null, 2)}\\n`, {\n mode: 0o600,\n dirMode: 0o700,\n });\n };\n\n async function withLedger<T>(fn: (ledger: Ledger, nowMs: number) => Promise<T> | T): Promise<T> {\n await mkdir(deps.dir, { recursive: true, mode: 0o700 });\n return withFileLock(lockPath, async () => {\n const nowMs = now();\n const read = await readLedger(path);\n if (read.corrupt !== undefined && !warnedCorrupt) {\n warnedCorrupt = true;\n deps.onCorrupt?.(read.corrupt);\n }\n const ledger = freshen(read.ledger, nowMs);\n return fn(ledger, nowMs);\n });\n }\n\n return {\n policyEnforcement: 'client-only',\n async authorize(req: SpendRequest): Promise<SpendAuthorization> {\n return withLedger(async (ledger) => {\n const sessionSpentAtomic = spentOf(ledger);\n if (\n req.requestKey !== undefined &&\n ledger.reservations.some((r) => r.requestKey === req.requestKey)\n ) {\n return {\n decision: 'deny',\n reason: 'duplicate_in_flight',\n message:\n 'An identical request already holds a reservation in this turn. No second payment was made.',\n amountAtomic: req.amountAtomic,\n sessionSpentAtomic,\n sessionBudgetAtomic: deps.policy.sessionBudgetAtomic,\n policyEnforcement: 'client-only',\n };\n }\n const evaluation = evaluateSpendPolicy(deps.policy, {\n mode: req.mode ?? 'automatic',\n amountAtomic: req.amountAtomic,\n creator: req.creator,\n ...(req.maxPriceAtomic !== undefined ? { maxPriceAtomic: req.maxPriceAtomic } : {}),\n sessionSpentAtomic,\n });\n const base: SpendAuthorization = {\n ...evaluation,\n amountAtomic: req.amountAtomic,\n sessionSpentAtomic,\n sessionBudgetAtomic: deps.policy.sessionBudgetAtomic,\n policyEnforcement: 'client-only',\n };\n // Unlimited budgets still reserve to prevent identical in-flight requests.\n if (evaluation.decision === 'deny') {\n return base;\n }\n const reservation: Reservation = {\n id: randomUUID(),\n mode: req.mode ?? 'automatic',\n amountAtomic: req.amountAtomic.toString(),\n atMs: now(),\n ...(req.requestKey !== undefined ? { requestKey: req.requestKey } : {}),\n };\n await persist({ ...ledger, reservations: [...ledger.reservations, reservation] });\n return { ...base, reservationId: reservation.id };\n });\n },\n async commit(\n reservationId: string | undefined,\n amountAtomic: bigint,\n opts: { settledAtomic?: bigint; mode?: PaymentMode; nonce?: string } = {},\n ): Promise<void> {\n // Record transmitted exposure even if its reservation has expired.\n await withLedger(async (ledger) => {\n const reservation =\n reservationId !== undefined\n ? ledger.reservations.find((r) => r.id === reservationId)\n : undefined;\n const exposure =\n reservation !== undefined ? BigInt(reservation.amountAtomic) : amountAtomic;\n // TWO NUMBERS, ON PURPOSE. The budget keeps counting what left; the\n // settled total records what was taken, and they differ whenever a\n // counterparty waives a fee against an authorization already sent.\n const settled = opts.settledAtomic ?? exposure;\n const settledSoFar = BigInt(ledger.settledAtomic ?? ledger.committedAtomic);\n const mode = reservation ? (reservation.mode ?? 'automatic') : (opts.mode ?? 'automatic');\n await persist({\n ...ledger,\n committedAtomic: (BigInt(ledger.committedAtomic) + exposure).toString(),\n automaticCommittedAtomic: (\n BigInt(ledger.automaticCommittedAtomic ?? ledger.committedAtomic) +\n (mode === 'manual' ? 0n : exposure)\n ).toString(),\n settledAtomic: (settledSoFar + settled).toString(),\n reservations:\n reservationId !== undefined\n ? ledger.reservations.filter((r) => r.id !== reservationId)\n : ledger.reservations,\n // Keyed by the authorization's nonce, so a reconcile that proves it\n // was never charged can release this amount and nothing else.\n ...(opts.nonce !== undefined\n ? {\n exposures: [\n ...(ledger.exposures ?? []),\n {\n nonce: opts.nonce.toLowerCase(),\n amountAtomic: exposure.toString(),\n atMs: now(),\n mode,\n },\n ],\n }\n : {}),\n });\n });\n },\n async release(reservationId: string | undefined): Promise<void> {\n if (reservationId === undefined) return;\n await withLedger(async (ledger) => {\n if (!ledger.reservations.some((r) => r.id === reservationId)) return;\n await persist({\n ...ledger,\n reservations: ledger.reservations.filter((r) => r.id !== reservationId),\n });\n });\n },\n };\n}\n\n/**\n * GIVE BACK A PAYMENT THE CHAIN PROVED WAS NEVER CHARGED: its authorization\n * expired unused. Exactly the exposure recorded under that nonce comes off the\n * committed totals, once; a nonce from an earlier window, from a ledger an\n * older build wrote, or one already released finds nothing and changes\n * nothing. Returns the amount released, or null when the ledger could not be\n * updated, so the caller keeps the payment open and asks again.\n */\nexport async function releaseUnchargedExposure(\n dir: string,\n nonce: string,\n opts: { now?: () => number; windowMs?: number } = {},\n): Promise<bigint | null> {\n const path = spendLedgerPath(dir);\n const nowMs = (opts.now ?? Date.now)();\n try {\n return await withFileLock(`${path}.lock`, async () => {\n const { ledger } = await readLedger(path);\n if (ledger === null || nowMs - ledger.windowStartMs >= (opts.windowMs ?? DEFAULT_WINDOW_MS)) {\n return 0n;\n }\n const key = nonce.toLowerCase();\n const entry = (ledger.exposures ?? []).find((e) => e.nonce === key);\n if (entry === undefined) return 0n;\n const amount = BigInt(entry.amountAtomic);\n const less = (value: string | undefined, fallback: string): string => {\n const current = BigInt(value ?? fallback);\n return (current > amount ? current - amount : 0n).toString();\n };\n await writeFileAtomic(\n path,\n `${JSON.stringify(\n {\n ...ledger,\n committedAtomic: less(ledger.committedAtomic, '0'),\n ...(entry.mode === 'manual'\n ? {}\n : {\n automaticCommittedAtomic: less(\n ledger.automaticCommittedAtomic,\n ledger.committedAtomic,\n ),\n }),\n settledAtomic: less(ledger.settledAtomic, ledger.committedAtomic),\n exposures: (ledger.exposures ?? []).filter((e) => e.nonce !== key),\n },\n null,\n 2,\n )}\\n`,\n { mode: 0o600, dirMode: 0o700 },\n );\n return amount;\n });\n } catch {\n return null;\n }\n}\n\nexport { readSpendSummary, type SpendSummary } from '../spend-ledger';\n"],"mappings":"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","names":[]}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
|
|
2
2
|
import {
|
|
3
3
|
inspectHooksFile
|
|
4
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-DI7WHXOZ.js";
|
|
5
5
|
import {
|
|
6
6
|
CliError,
|
|
7
7
|
writeFileAtomic
|
|
@@ -169,4 +169,4 @@ export {
|
|
|
169
169
|
removeStatusLine,
|
|
170
170
|
inspectStatusLine
|
|
171
171
|
};
|
|
172
|
-
//# sourceMappingURL=chunk-
|
|
172
|
+
//# sourceMappingURL=chunk-65EJJVT3.js.map
|
|
@@ -4,7 +4,7 @@ import {
|
|
|
4
4
|
} from "./chunk-2I4QTOLB.js";
|
|
5
5
|
import {
|
|
6
6
|
external_exports
|
|
7
|
-
} from "./chunk-
|
|
7
|
+
} from "./chunk-XICKN3CH.js";
|
|
8
8
|
import {
|
|
9
9
|
spendLedgerPath
|
|
10
10
|
} from "./chunk-K6AXXYCG.js";
|
|
@@ -103,62 +103,12 @@ async function readSpendSummary(dir, opts = {}) {
|
|
|
103
103
|
};
|
|
104
104
|
}
|
|
105
105
|
|
|
106
|
-
// src/lib/policy.ts
|
|
107
|
-
function normCreator(value) {
|
|
108
|
-
return value.trim().toLowerCase();
|
|
109
|
-
}
|
|
110
|
-
function evaluateSpendPolicy(policy, req) {
|
|
111
|
-
if (req.maxPriceAtomic !== void 0 && req.amountAtomic > req.maxPriceAtomic) {
|
|
112
|
-
return {
|
|
113
|
-
decision: "deny",
|
|
114
|
-
reason: "price_cap_exceeded",
|
|
115
|
-
message: `Price ${req.amountAtomic} exceeds the --max-price cap ${req.maxPriceAtomic}.`
|
|
116
|
-
};
|
|
117
|
-
}
|
|
118
|
-
if (policy.allowlistCreators.length > 0) {
|
|
119
|
-
const allowed = policy.allowlistCreators.map(normCreator);
|
|
120
|
-
if (!allowed.includes(normCreator(req.creator))) {
|
|
121
|
-
return {
|
|
122
|
-
decision: "deny",
|
|
123
|
-
reason: "not_allowlisted",
|
|
124
|
-
message: `Creator "${req.creator}" is not in allowlistCreators.`
|
|
125
|
-
};
|
|
126
|
-
}
|
|
127
|
-
}
|
|
128
|
-
if (req.mode === "manual") {
|
|
129
|
-
return req.amountAtomic > 0n ? {
|
|
130
|
-
decision: "confirm",
|
|
131
|
-
reason: "confirm_always",
|
|
132
|
-
message: "Manual payment requires explicit consent."
|
|
133
|
-
} : { decision: "allow", reason: "within_policy", message: "No payment required." };
|
|
134
|
-
}
|
|
135
|
-
if (policy.sessionBudgetAtomic !== null) {
|
|
136
|
-
const projected = req.sessionSpentAtomic + req.amountAtomic;
|
|
137
|
-
if (projected > policy.sessionBudgetAtomic) {
|
|
138
|
-
return {
|
|
139
|
-
decision: "deny",
|
|
140
|
-
reason: "session_budget_exceeded",
|
|
141
|
-
message: `This spend would bring the session total to ${projected}, over sessionBudget ${policy.sessionBudgetAtomic}.`
|
|
142
|
-
};
|
|
143
|
-
}
|
|
144
|
-
}
|
|
145
|
-
if (req.amountAtomic > policy.maxAutoSpendAtomic) {
|
|
146
|
-
return {
|
|
147
|
-
decision: "deny",
|
|
148
|
-
reason: "above_auto_spend",
|
|
149
|
-
message: `Price ${req.amountAtomic} is above maxAutoSpend ${policy.maxAutoSpendAtomic}; automatic payment refused.`
|
|
150
|
-
};
|
|
151
|
-
}
|
|
152
|
-
return { decision: "allow", reason: "within_policy", message: "within spend policy" };
|
|
153
|
-
}
|
|
154
|
-
|
|
155
106
|
export {
|
|
156
107
|
DEFAULT_WINDOW_MS,
|
|
157
108
|
RESERVATION_TTL_MS,
|
|
158
109
|
emptyLedger,
|
|
159
110
|
spentOf,
|
|
160
111
|
readLedger,
|
|
161
|
-
readSpendSummary
|
|
162
|
-
evaluateSpendPolicy
|
|
112
|
+
readSpendSummary
|
|
163
113
|
};
|
|
164
|
-
//# sourceMappingURL=chunk-
|
|
114
|
+
//# sourceMappingURL=chunk-6JIYGYRB.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/lib/spend-ledger.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { z } from 'zod';\nimport { hasCode } from './errno';\nimport { spendLedgerPath } from './paths';\n\n/**\n * The spend ledger's READ side: its shape, the two expiries, and a read-only\n * summary. It lives outside `lib/wallet` so the router hooks can measure an\n * offer against the same session total an authorization would, without the\n * wallet entering their chunk graph (`src/router/dist-chunks.test.ts`). The\n * write side, with its lock and reservations, stays in `lib/wallet/spend.ts`.\n */\n\nexport const DEFAULT_WINDOW_MS = 86_400_000; // 24h rolling day\nexport const RESERVATION_TTL_MS = 600_000; // 10 min: a dangling reservation self-expires\n\nconst ReservationSchema = z.object({\n id: z.string(),\n amountAtomic: z.string().regex(/^\\d+$/),\n atMs: z.number(),\n /** Optional so a ledger written by an older build still parses. */\n requestKey: z.string().optional(),\n mode: z.enum(['automatic', 'manual']).optional(),\n});\nexport type Reservation = z.infer<typeof ReservationSchema>;\n\n/**\n * ONE TRANSMITTED AUTHORIZATION, by its EIP-3009 nonce: what it exposed and\n * when, so a payment the chain later proves was never charged can give back\n * exactly its own amount inside the window it was counted in.\n */\nconst ExposureSchema = z.object({\n nonce: z.string(),\n amountAtomic: z.string().regex(/^\\d+$/),\n atMs: z.number(),\n mode: z.enum(['automatic', 'manual']).optional(),\n});\nexport type Exposure = z.infer<typeof ExposureSchema>;\n\nconst LedgerSchema = z.object({\n schemaVersion: z.literal(2),\n windowStartMs: z.number(),\n /**\n * EXPOSURE: every authorization this window transmitted. A signed EIP-3009\n * authorization is a bearer instrument, so total exposure stays recorded,\n * whatever any counterparty later says it took.\n */\n committedAtomic: z.string().regex(/^\\d+$/),\n automaticCommittedAtomic: z.string().regex(/^\\d+$/).optional(),\n /**\n * SETTLED: what counterparties reported actually taking, which the router's\n * waived outcomes made a different number from the line above (2026-09-23\n * lookup contract). Optional so a ledger an older build wrote still parses;\n * absent means \"everything committed was settled\", which is what that build\n * assumed. Reporting only, never a budget input: under-counting exposure\n * because a server said \"no charge\" is exactly the hole this avoids.\n */\n settledAtomic: z.string().regex(/^\\d+$/).optional(),\n reservations: z.array(ReservationSchema),\n /** Optional so a ledger an older build wrote still parses; such a ledger\n * simply has nothing a reconcile can release. */\n exposures: z.array(ExposureSchema).optional(),\n});\nexport type Ledger = z.infer<typeof LedgerSchema>;\n\nexport function emptyLedger(nowMs: number): Ledger {\n return {\n schemaVersion: 2,\n windowStartMs: nowMs,\n committedAtomic: '0',\n automaticCommittedAtomic: '0',\n settledAtomic: '0',\n reservations: [],\n };\n}\n\n/** Automatic exposure plus automatic pending reservations: the budget's input.\n * Legacy records with no mode/counter conservatively count as automatic. */\nexport function spentOf(ledger: {\n committedAtomic: string;\n automaticCommittedAtomic?: string;\n reservations: { amountAtomic: string; mode?: 'automatic' | 'manual' }[];\n}): bigint {\n return ledger.reservations.reduce(\n (sum, r) => sum + (r.mode === 'manual' ? 0n : BigInt(r.amountAtomic)),\n BigInt(ledger.automaticCommittedAtomic ?? ledger.committedAtomic),\n );\n}\n\n/**\n * ABSENT and CORRUPT both reset the window, but they are not the same fact: the\n * first is a first run, the second is spend that existed and is now gone. Only\n * the second is worth telling anyone about, so the two stay distinguishable here\n * rather than collapsing into one null.\n */\ninterface LedgerRead {\n ledger: Ledger | null;\n /** Set only when the file EXISTS and could not be turned back into a ledger. */\n corrupt?: string;\n}\n\nexport async function readLedger(path: string): Promise<LedgerRead> {\n let raw: string;\n try {\n raw = await readFile(path, 'utf8');\n } catch (err) {\n // A missing file is the ordinary first run. Any other read failure means a\n // file is there and unusable, which is the corrupt case by another name.\n if (hasCode(err, 'ENOENT')) return { ledger: null };\n return { ledger: null, corrupt: err instanceof Error ? err.message : String(err) };\n }\n let json: unknown;\n try {\n json = JSON.parse(raw);\n } catch {\n return { ledger: null, corrupt: 'not valid JSON' };\n }\n const parsed = LedgerSchema.safeParse(json);\n if (parsed.success) return { ledger: parsed.data };\n const issue = parsed.error.issues[0];\n const field = issue?.path.join('.');\n const message = issue?.message ?? 'schema mismatch';\n // Field-qualified: \"expected number, received undefined\" names nothing on its\n // own. zod never echoes the received VALUE, so no spend figure rides along.\n return {\n ledger: null,\n corrupt: field !== undefined && field.length > 0 ? `${field}: ${message}` : message,\n };\n}\n\nexport interface SpendSummary {\n windowStartMs: number;\n committedAtomic: string;\n automaticCommittedAtomic?: string;\n reservations: {\n amountAtomic: string;\n atMs: number;\n requestKey?: string;\n mode?: 'automatic' | 'manual';\n }[];\n}\n\n/**\n * The ledger AS AN AUTHORIZATION WOULD SEE IT, for `tenjin status`. Read-only,\n * and it applies the same two expiries the authorizer applies before it\n * evaluates a spend: a rolling window that has run out reads as a fresh one,\n * and reservations past their TTL are gone. Summing the raw file instead\n * reported spend as current, and crashed reservations as open, until the next\n * payment happened to rewrite it.\n *\n * `null` for absent or unreadable, which is the same thing to a report.\n */\nexport async function readSpendSummary(\n dir: string,\n opts: { now?: () => number; windowMs?: number } = {},\n): Promise<SpendSummary | null> {\n const { ledger } = await readLedger(spendLedgerPath(dir));\n if (ledger === null) return null;\n const nowMs = (opts.now ?? Date.now)();\n const windowMs = opts.windowMs ?? DEFAULT_WINDOW_MS;\n if (nowMs - ledger.windowStartMs >= windowMs) return emptyLedger(nowMs);\n return {\n ...ledger,\n reservations: ledger.reservations.filter((r) => nowMs - r.atMs < RESERVATION_TTL_MS),\n };\n}\n"],"mappings":"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","names":[]}
|