@haven_ai/sdk 0.1.23-alpha.0 → 0.1.23-alpha.2

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 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, MPP demo authorization, resume-state
213
- rehydration, machine-payment receipts, and transactions. Its security scheme is
214
- deliberate: the Haven API key identifies the agent, but payment authority still
215
- requires an agent-held delegate signature and on-chain Safe allowance state.
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`: