@haven_ai/sdk 0.1.23-alpha.0 → 0.1.23-alpha.1
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 +8 -6
- package/dist/index.cjs +30 -519
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +16 -154
- package/dist/index.d.ts +16 -154
- package/dist/index.js +31 -516
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -183,7 +183,6 @@ for (const block of response.content) {
|
|
|
183
183
|
| `get_allowances` | Read configured and on-chain allowance state, including spent and remaining allowance |
|
|
184
184
|
| `authorize_x402_payment` | Authorize a policy-limited x402 payment and return a payment header for an HTTP 402 resource |
|
|
185
185
|
| `resume_x402_payment` | Resume an approved x402 payment and return a merchant payment header without creating a duplicate approval |
|
|
186
|
-
| `authorize_machine_payment` | Authorize an internal Haven MPP demo challenge and return proof details |
|
|
187
186
|
|
|
188
187
|
Use `get_allowances` for allowance, budget, spend-limit, remaining amount, reset-period, or "what can I spend?" questions. Payment tools still require the agent-held delegate key and on-chain Safe allowance state; the Haven API key identifies the agent but does not authorize spending by itself.
|
|
189
188
|
|
|
@@ -209,10 +208,13 @@ The backend serves an OpenAPI 3.1 contract at:
|
|
|
209
208
|
- Local development: `http://localhost:3001/openapi.json`
|
|
210
209
|
|
|
211
210
|
The spec covers the agent-facing payment surface: agents, direct payments,
|
|
212
|
-
payment status, x402 authorization,
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
211
|
+
payment status, x402 authorization, resume-state rehydration, machine-payment
|
|
212
|
+
receipts, and transactions. `POST /machine-payments/authorize` (the legacy
|
|
213
|
+
internal MPP demo challenge flow) is retired — it now refuses unconditionally
|
|
214
|
+
with HTTP 410; use the x402 flow for agent-to-merchant payments. Its security
|
|
215
|
+
scheme is deliberate: the Haven API key identifies the agent, but payment
|
|
216
|
+
authority still requires an agent-held delegate signature and on-chain Safe
|
|
217
|
+
allowance state.
|
|
216
218
|
|
|
217
219
|
## Agent payment state machine
|
|
218
220
|
|
|
@@ -220,7 +222,7 @@ Every payment or approval state returned by Haven includes:
|
|
|
220
222
|
|
|
221
223
|
- `phase`: where the Haven-side payment currently is.
|
|
222
224
|
- `nextAction`: the stable action an agent should take next.
|
|
223
|
-
- `rail`: which payment rail produced the state. Categorical values (`direct`, `x402`, `mpp`) appear on resume-state discriminators; granular values (`mpp_demo`, `mpp_crypto`, `stripe_deposit`, `spt`) appear on response bodies.
|
|
225
|
+
- `rail`: which payment rail produced the state. Categorical values (`direct`, `x402`, `mpp`) appear on resume-state discriminators; granular values (`mpp_demo`, `mpp_crypto`, `stripe_deposit`, `spt`) appear on response bodies. The `mpp` resume-state shape is a historical read only — the SDK no longer exposes a client method that acts on it (`mpp_demo` is retired, #1328).
|
|
224
226
|
- `message`: human-readable guidance for the same state.
|
|
225
227
|
|
|
226
228
|
The enum values and JSON Schema fragments are exported from `@haven_ai/sdk`:
|