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

package/dist/index.d.cts

@@ -453,49 +453,7 @@ interface X402ResumeState {
     chainId: number | null;
     merchantAddress: string;
 }
-interface MppAuthorizationOptions {
-    /** Stable caller-supplied key for this user intent. Prevents duplicate approvals across retries. */
-    idempotencyKey?: string;
-}
-/** Quote parsed from an MPP challenge without creating a Haven payment. */
-interface MppQuote {
-    rail: 'mpp';
-    paymentRail: MachinePaymentRail;
-    idempotencyKey: string;
-    challenge: MachinePaymentChallenge;
-    request: X402RequestSnapshot;
-    resourceUrl: string;
-    description: string | null;
-    amountAtomic: string;
-    amount: string;
-    token: string;
-    asset: string;
-    network: string;
-    chainId: number;
-    merchantAddress: string;
-    expiresAt: string;
-}
-/** State bundle an agent can persist while waiting for manual MPP approval. */
-interface MppResumeState {
-    rail: 'mpp';
-    paymentRail: MachinePaymentRail;
-    paymentId: string;
-    idempotencyKey: string;
-    challenge: MachinePaymentChallenge;
-    url: string;
-    request?: X402RequestSnapshot;
-    resourceUrl: string;
-    description: string | null;
-    amountAtomic: string;
-    amount: string;
-    token: string;
-    asset: string;
-    network: string;
-    chainId: number;
-    merchantAddress: string;
-    expiresAt: string;
-}
-type PaymentResumeState = X402ResumeState | MppResumeState;
+type PaymentResumeState = X402ResumeState;
 interface ResumeAuthorizedX402Input extends X402AuthorizationOptions {
     /** Payment or approval request ID returned by authorizeX402 / haven.fetch. */
     paymentId: string;
@@ -514,63 +472,7 @@ interface ResumeX402PaymentInput extends X402AuthorizationOptions {
     /** Original or freshly parsed x402 requirements. Supplying this avoids an extra merchant 402 probe. */
     paymentRequired?: X402PaymentRequired;
 }
-interface ResumeAuthorizedMppInput extends MppAuthorizationOptions {
-    /** Payment or approval request ID returned by authorizeMachinePayment / haven.fetch. */
-    paymentId: string;
-    /** Original MPP challenge returned by the paid resource. */
-    challenge: MachinePaymentChallenge;
-}
-interface ResumeMppPaymentInput extends MppAuthorizationOptions {
-    /** Payment or approval request ID returned by authorizeMachinePayment / haven.fetch. */
-    paymentId: string;
-    /** Original paid URL. If challenge is omitted, Haven will call it once to re-read the MPP challenge. */
-    url: string;
-    /** Original fetch options. Reused for the 402 probe and final merchant retry. */
-    init?: RequestInit;
-    /** Serializable original request captured by quoteMpp() / pending approval errors. */
-    request?: X402RequestSnapshot;
-    /** Original MPP challenge. Supplying this avoids an extra paid-resource 402 probe. */
-    challenge?: MachinePaymentChallenge;
-}
 type MachinePaymentRail = 'x402' | 'mpp_demo' | 'mpp_crypto' | 'stripe_deposit' | 'spt';
-interface MachinePaymentChallenge {
-    rail: MachinePaymentRail;
-    version: string;
-    challengeId: string;
-    resource: string;
-    description: string;
-    network: {
-        chainId: number;
-        name: 'base';
-    };
-    asset: {
-        symbol: 'USDC';
-        address: string;
-        decimals: 6;
-    };
-    amount: {
-        display: string;
-        atomic: string;
-    };
-    recipient: string;
-    expiresAt: string;
-    metadata?: Record<string, unknown>;
-}
-interface MachinePaymentReceipt {
-    success: boolean;
-    rail: MachinePaymentRail;
-    paymentId: string;
-    challengeId: string;
-    txHash: string;
-    token: string;
-    amount: string;
-    to: string;
-    resourceUrl: string;
-    explorerUrl: string;
-    payer?: string;
-    chainId?: number;
-    proofHeader: string;
-}
 interface HavenAgent {
     id: string;
     name: string;
@@ -874,17 +776,19 @@ type AgentPaymentFailureCode = (typeof AgentPaymentFailureCode)[keyof typeof Age
  *
  * Two layers of vocabulary share this enum because both reach the wire:
  *
- *   - **Categorical rails** identify the rail family and are used as
- *     discriminators on `PaymentResumeState`: `direct`, `x402`, `mpp`.
+ *   - **Categorical rails** identify the rail family and are used as the
+ *     `PaymentResumeState` discriminator: `direct`, `x402` (`mpp` remains a
+ *     valid categorical VALUE on historical status reads, but #1328 retired
+ *     the `MppResumeState` variant that used to carry it — the mpp_demo
+ *     client resume flow no longer exists).
  *   - **Granular rails** identify the specific protocol the backend persists
  *     and returns on response bodies: `mpp_demo`, `mpp_crypto`,
  *     `stripe_deposit`, `spt`. `x402` doubles as both categorical and
  *     granular.
  *
  * Consumers reading the top-level `rail` field on a payment status response
- * should treat any `mpp*` value as the MPP family; consumers reading the
- * `rail` field on a `MppResumeState` will always see the categorical `mpp`,
- * with the granular value on `paymentRail`.
+ * should treat any `mpp*` value as the MPP family — this still applies to
+ * historical `mpp_demo` rows, which remain readable.
  */
 declare const AgentPaymentRail: {
     /** Standard Haven payment from the user's Safe through an approved delegate allowance. */
@@ -908,7 +812,7 @@ type PaymentNextAction = AgentPaymentNextAction;
 declare const AGENT_PAYMENT_PHASE_VALUES: ("rejected" | "expired" | "failed" | "agent_signature_required" | "payment_submitted" | "payment_confirmed" | "user_approval_required" | "user_execution_required" | "waiting_for_additional_approvals" | "funding_sent" | "insufficient_funds" | "funded_but_unsettled")[];
 declare const AGENT_PAYMENT_NEXT_ACTION_VALUES: ("sign_and_submit_payment" | "check_status_later" | "none" | "wait_for_user_approval" | "wait_for_user_to_complete_payment" | "retry_original_x402_request" | "stop_and_tell_user" | "request_again_if_user_still_wants_it" | "retry_with_explicit_context" | "payment_window_expired" | "fund_safe_or_raise_allowance" | "sweep_stranded_funds")[];
 declare const AGENT_PAYMENT_FAILURE_CODE_VALUES: ("PRICE_EXCEEDS_MAX" | "PAYMENT_WINDOW_EXPIRED" | "MERCHANT_REJECTED_AFTER_FUNDING" | "MERCHANT_UNRESPONSIVE_AFTER_FUNDING" | "MERCHANT_CALL_CONTEXT_UNAVAILABLE" | "AMBIGUOUS_MAX_AMOUNT" | "MAX_AMOUNT_UNCONVERTIBLE")[];
-declare const AGENT_PAYMENT_RAIL_VALUES: ("x402" | "mpp" | "mpp_demo" | "mpp_crypto" | "stripe_deposit" | "spt" | "direct")[];
+declare const AGENT_PAYMENT_RAIL_VALUES: ("x402" | "mpp_demo" | "mpp_crypto" | "stripe_deposit" | "spt" | "direct" | "mpp")[];
 declare const AgentPaymentPhaseDescriptions: Record<AgentPaymentPhase, string>;
 declare const AgentPaymentNextActionDescriptions: Record<AgentPaymentNextAction, string>;
 declare const AgentPaymentFailureCodeDescriptions: Record<AgentPaymentFailureCode, string>;
@@ -1123,7 +1027,7 @@ declare class X402UnexpectedStatusError extends HavenApiError {
 }
 declare class HavenPaymentStateError extends HavenApiError {
     readonly state: PaymentStatusResult;
-    resumeState?: X402ResumeState | MppResumeState;
+    resumeState?: X402ResumeState;
     constructor(message: string, statusCode: number, state: PaymentStatusResult, body?: unknown);
     get status(): string;
     get phase(): PaymentPhase;
@@ -1375,7 +1279,6 @@ declare class HavenClient {
     private readonly chainRpcs;
     private readonly inFlightX402;
     private readonly x402ReceiptCache;
-    private readonly inFlightMachinePayments;
     /**
      * Setup-time headers configured via `HavenClientConfig.defaultHeaders`.
      * Read-only after construction — use `withRequestContext` for per-call
@@ -1615,10 +1518,11 @@ declare class HavenClient {
         verification: ReceiptVerification;
     }>;
     /**
-     * Rehydrate the x402/MPP resume-state bundle for a payment id.
+     * Rehydrate the x402 resume-state bundle for a payment id (#1328: the MPP
+     * resume-state variant retired along with the rest of the mpp_demo surface).
      *
      * The server returns stored protocol context only. The client still signs the
-     * merchant proof locally when resumeX402Payment() or resumeMppPayment() runs.
+     * merchant proof locally when resumeX402Payment() runs.
      */
     getResumeState(paymentId: string): Promise<PaymentResumeState>;
     /**
@@ -1707,15 +1611,6 @@ declare class HavenClient {
      * Non-SSE responses pass through untouched.
      */
     private surfaceMcpResult;
-    /**
-     * Probe a paid MPP endpoint or inspect an existing challenge without creating
-     * a Haven payment or approval request.
-     */
-    quoteMpp(challengeOrUrl: MachinePaymentChallenge | string, init?: RequestInit, options?: MppAuthorizationOptions): Promise<MppQuote>;
-    /**
-     * Pay a previously inspected MPP quote and retry the exact captured request.
-     */
-    payMppChallenge(quote: MppQuote, options?: MppAuthorizationOptions): Promise<Response>;
     private retryX402Request;
     /**
      * #956: capture the merchant's OWN receipt when the paid response carries
@@ -1784,21 +1679,12 @@ declare class HavenClient {
     getX402MerchantCallContext(paymentId: string): Promise<X402MerchantCallContext>;
     private resolveX402MerchantCompletionContext;
     private resolveX402WalletForMerchantCall;
-    authorizeMachinePayment(challenge: MachinePaymentChallenge, options?: MppAuthorizationOptions): Promise<MachinePaymentReceipt>;
-    private authorizeMppDemoPayment;
-    resumeAuthorizedMpp(input: ResumeAuthorizedMppInput): Promise<MachinePaymentReceipt>;
-    resumeMppPayment(input: ResumeMppPaymentInput | MppResumeState): Promise<Response>;
-    private fetchWithMachinePayment;
-    private retryMppRequest;
     private assertCanResumeX402;
-    private assertCanResumeMpp;
     private mapX402ReceiptFromAuthorization;
     private mapX402ReceiptFromStatus;
     private buildX402Receipt;
     private createStandardX402Header;
     private cacheX402Receipt;
-    private mapMachinePaymentReceipt;
-    private mapMachinePaymentReceiptFromStatus;
     private recordMerchantRetryRejected;
     private reportMachinePaymentEvidence;
     /**
@@ -1822,11 +1708,8 @@ declare class HavenClient {
     private buildX402Quote;
     private detectX402McpTransport;
     private buildX402ResumeState;
-    private buildMppQuote;
-    private buildMppResumeState;
     private attachResumeState;
     private attachX402ResumeState;
-    private attachMppResumeState;
     /**
      * Execute a tool call by name and input.
      *
@@ -1999,7 +1882,7 @@ declare const toolDescriptions: {
     readonly payX402OneShot: {
         readonly summary: "Fetch an x402 paid HTTP resource in a single call. Handles the full probe -> pay -> retry round trip and returns the merchant response.";
         readonly selectionGuidance: "Prefer this over the quote+pay split when the agent just wants the paid resource and does not need to inspect the price first. If you already have a quote from haven_quote_x402, use haven_pay_x402_quote instead. Do not use for read-only allowance, budget, spend-limit, remaining-amount, reset-period, or what-can-I-spend questions; use the allowance lookup tool instead.";
-        readonly behavior: "Calls the URL, parses any HTTP 402 x402 challenge, signs the EIP-3009 payment from the delegate wallet, asks Haven for a Safe AllowanceModule top-up if needed, then retries the original request with the X-PAYMENT header and returns the merchant response. If the resource returns an MPP machine-payment challenge instead of standard x402, the MPP payment path is used automatically. If the resource returns a non-402 status, returns it unchanged without contacting Haven.";
+        readonly behavior: "Calls the URL, parses any HTTP 402 x402 challenge, signs the EIP-3009 payment from the delegate wallet, asks Haven for a Safe AllowanceModule top-up if needed, then retries the original request with the X-PAYMENT header and returns the merchant response. If the resource returns a non-402 status, returns it unchanged without contacting Haven.";
         readonly nextActionGuidance: string;
     };
     readonly resumeX402: {
@@ -2007,29 +1890,13 @@ declare const toolDescriptions: {
         readonly behavior: "Accepts either resume_state or payment_id, validates the original x402 details against the approved Haven funding, and retries the merchant request with the X-PAYMENT header. No new Haven approval is created.";
         readonly nextActionGuidance: "Only use when get_payment_status returns nextAction=retry_original_x402_request; do not start a new merchant session.";
     };
-    readonly quoteMpp: {
-        readonly summary: "Inspect a Haven MPP challenge or paid MPP URL without creating a Haven payment, signature, approval, or on-chain transaction.";
-        readonly behavior: "Parses an MPP challenge envelope and returns a typed quote with rail tag, amount, asset, and merchant context. Pure read-only — Haven is not contacted.";
-        readonly nextActionGuidance: "On success the returned quote is the input to haven_pay_mpp_challenge. Do not call the merchant again — Haven re-uses the captured request when paying.";
-    };
-    readonly payMpp: {
-        readonly summary: "Pay an inspected MPP challenge. The delegate key signs locally; Haven only validates and relays signed, on-chain-constrained payment transactions.";
-        readonly selectionGuidance: "Do not use this for read-only allowance, budget, spend-limit, remaining-amount, reset-period, or what-can-I-spend questions; use the allowance lookup tool instead.";
-        readonly behavior: "Authorizes the payment through Haven within the on-chain allowance, signs the challenge proof, and returns the proof header for retrying the original paid resource.";
-        readonly nextActionGuidance: "If approval is needed, preserve resume_state or payment_id and wait for nextAction=retry_original_x402_request before resuming.";
-    };
-    readonly resumeMpp: {
-        readonly summary: "Resume an MPP payment after the Haven wallet owner approved the funding step.";
-        readonly behavior: "Accepts either resume_state or payment_id and retries the original paid resource with the MPP proof header. No new Haven approval is created.";
-        readonly nextActionGuidance: "";
-    };
     readonly getPaymentStatus: {
         readonly summary: "Fetch structured Haven payment status, including phase and nextAction taxonomy for agent recovery.";
         readonly behavior: "Accepts a payment intent or approval request id and returns the full state taxonomy (phase, nextAction, rail, amount, merchant, resource url, idempotency key, message).";
         readonly nextActionGuidance: "";
     };
     readonly getResumeState: {
-        readonly summary: "Rehydrate stored x402 or MPP resume_state by payment_id.";
+        readonly summary: "Rehydrate stored x402 resume_state by payment_id.";
         readonly behavior: "Returns the context that the agent originally received in a pending-approval response, reconstructed from Haven's database. This is context only; signing still happens locally when a resume tool is called.";
         readonly nextActionGuidance: "";
     };
@@ -2297,11 +2164,6 @@ declare function resolveTokenFromAddress(address: string, network?: string): {
     decimals: number;
 } | null;
 
-declare function parseMachinePaymentChallenge(response: Response): MachinePaymentChallenge;
-declare function parseMachinePaymentChallengeResponse(response: Response): Promise<MachinePaymentChallenge>;
-declare function buildMachinePaymentIdempotencyKey(challenge: MachinePaymentChallenge): string;
-declare function encodeMachinePaymentProof(receipt: Omit<MachinePaymentReceipt, 'proofHeader'>): string;
-
 /**
  * Runtime-agnostic base64 helpers — the single source of truth for the wire
  * encoding shared by the SDK and the edge signer (#325).
@@ -2368,4 +2230,4 @@ declare function discoverMerchantMcpUrl(inputUrl: string): Promise<string | null
 /** Trailing-slash/percent-case echoes compare equal; unparseable never does. */
 declare function sameUrl(a: string, b: string): boolean;
 
-export { AGENT_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type AgentPurchaseSummary, type ClaudeTool, DISCOVERY_MAX_BYTES, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentChallenge, type MachinePaymentRail, type MachinePaymentReceipt, MerchantTimeoutError, type MppAuthorizationOptions, type MppQuote, type MppResumeState, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedMppInput, type ResumeAuthorizedX402Input, type ResumeMppPaymentInput, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, type X402AuthorizationOptions, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, X402UnexpectedStatusError, X402_MAX_AUTHORIZATION_WINDOW_SECONDS, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, addressFromKey, buildMachinePaymentIdempotencyKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, composeDescription, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodeMachinePaymentProof, encodePaymentProof, havenTools, isSupportedNodeVersion, isSweepableChain, parseMachinePaymentChallenge, parseMachinePaymentChallengeResponse, parsePaymentRequired, parsePaymentRequiredResponse, resolveTokenFromAddress, sameUrl, selectPaymentOption, selectStandardPaymentOption, signHash, signUserOpTypedDataForDelegation, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, verifyPaymentReceipt, verifySignature, x402AuthorizationAmount };
+export { AGENT_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type AgentPurchaseSummary, type ClaudeTool, DISCOVERY_MAX_BYTES, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentRail, MerchantTimeoutError, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedX402Input, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, type X402AuthorizationOptions, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, X402UnexpectedStatusError, X402_MAX_AUTHORIZATION_WINDOW_SECONDS, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, addressFromKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, composeDescription, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, havenTools, isSupportedNodeVersion, isSweepableChain, parsePaymentRequired, parsePaymentRequiredResponse, resolveTokenFromAddress, sameUrl, selectPaymentOption, selectStandardPaymentOption, signHash, signUserOpTypedDataForDelegation, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, verifyPaymentReceipt, verifySignature, x402AuthorizationAmount };

package/dist/index.d.ts

@@ -453,49 +453,7 @@ interface X402ResumeState {
     chainId: number | null;
     merchantAddress: string;
 }
-interface MppAuthorizationOptions {
-    /** Stable caller-supplied key for this user intent. Prevents duplicate approvals across retries. */
-    idempotencyKey?: string;
-}
-/** Quote parsed from an MPP challenge without creating a Haven payment. */
-interface MppQuote {
-    rail: 'mpp';
-    paymentRail: MachinePaymentRail;
-    idempotencyKey: string;
-    challenge: MachinePaymentChallenge;
-    request: X402RequestSnapshot;
-    resourceUrl: string;
-    description: string | null;
-    amountAtomic: string;
-    amount: string;
-    token: string;
-    asset: string;
-    network: string;
-    chainId: number;
-    merchantAddress: string;
-    expiresAt: string;
-}
-/** State bundle an agent can persist while waiting for manual MPP approval. */
-interface MppResumeState {
-    rail: 'mpp';
-    paymentRail: MachinePaymentRail;
-    paymentId: string;
-    idempotencyKey: string;
-    challenge: MachinePaymentChallenge;
-    url: string;
-    request?: X402RequestSnapshot;
-    resourceUrl: string;
-    description: string | null;
-    amountAtomic: string;
-    amount: string;
-    token: string;
-    asset: string;
-    network: string;
-    chainId: number;
-    merchantAddress: string;
-    expiresAt: string;
-}
-type PaymentResumeState = X402ResumeState | MppResumeState;
+type PaymentResumeState = X402ResumeState;
 interface ResumeAuthorizedX402Input extends X402AuthorizationOptions {
     /** Payment or approval request ID returned by authorizeX402 / haven.fetch. */
     paymentId: string;
@@ -514,63 +472,7 @@ interface ResumeX402PaymentInput extends X402AuthorizationOptions {
     /** Original or freshly parsed x402 requirements. Supplying this avoids an extra merchant 402 probe. */
     paymentRequired?: X402PaymentRequired;
 }
-interface ResumeAuthorizedMppInput extends MppAuthorizationOptions {
-    /** Payment or approval request ID returned by authorizeMachinePayment / haven.fetch. */
-    paymentId: string;
-    /** Original MPP challenge returned by the paid resource. */
-    challenge: MachinePaymentChallenge;
-}
-interface ResumeMppPaymentInput extends MppAuthorizationOptions {
-    /** Payment or approval request ID returned by authorizeMachinePayment / haven.fetch. */
-    paymentId: string;
-    /** Original paid URL. If challenge is omitted, Haven will call it once to re-read the MPP challenge. */
-    url: string;
-    /** Original fetch options. Reused for the 402 probe and final merchant retry. */
-    init?: RequestInit;
-    /** Serializable original request captured by quoteMpp() / pending approval errors. */
-    request?: X402RequestSnapshot;
-    /** Original MPP challenge. Supplying this avoids an extra paid-resource 402 probe. */
-    challenge?: MachinePaymentChallenge;
-}
 type MachinePaymentRail = 'x402' | 'mpp_demo' | 'mpp_crypto' | 'stripe_deposit' | 'spt';
-interface MachinePaymentChallenge {
-    rail: MachinePaymentRail;
-    version: string;
-    challengeId: string;
-    resource: string;
-    description: string;
-    network: {
-        chainId: number;
-        name: 'base';
-    };
-    asset: {
-        symbol: 'USDC';
-        address: string;
-        decimals: 6;
-    };
-    amount: {
-        display: string;
-        atomic: string;
-    };
-    recipient: string;
-    expiresAt: string;
-    metadata?: Record<string, unknown>;
-}
-interface MachinePaymentReceipt {
-    success: boolean;
-    rail: MachinePaymentRail;
-    paymentId: string;
-    challengeId: string;
-    txHash: string;
-    token: string;
-    amount: string;
-    to: string;
-    resourceUrl: string;
-    explorerUrl: string;
-    payer?: string;
-    chainId?: number;
-    proofHeader: string;
-}
 interface HavenAgent {
     id: string;
     name: string;
@@ -874,17 +776,19 @@ type AgentPaymentFailureCode = (typeof AgentPaymentFailureCode)[keyof typeof Age
  *
  * Two layers of vocabulary share this enum because both reach the wire:
  *
- *   - **Categorical rails** identify the rail family and are used as
- *     discriminators on `PaymentResumeState`: `direct`, `x402`, `mpp`.
+ *   - **Categorical rails** identify the rail family and are used as the
+ *     `PaymentResumeState` discriminator: `direct`, `x402` (`mpp` remains a
+ *     valid categorical VALUE on historical status reads, but #1328 retired
+ *     the `MppResumeState` variant that used to carry it — the mpp_demo
+ *     client resume flow no longer exists).
  *   - **Granular rails** identify the specific protocol the backend persists
  *     and returns on response bodies: `mpp_demo`, `mpp_crypto`,
  *     `stripe_deposit`, `spt`. `x402` doubles as both categorical and
  *     granular.
  *
  * Consumers reading the top-level `rail` field on a payment status response
- * should treat any `mpp*` value as the MPP family; consumers reading the
- * `rail` field on a `MppResumeState` will always see the categorical `mpp`,
- * with the granular value on `paymentRail`.
+ * should treat any `mpp*` value as the MPP family — this still applies to
+ * historical `mpp_demo` rows, which remain readable.
  */
 declare const AgentPaymentRail: {
     /** Standard Haven payment from the user's Safe through an approved delegate allowance. */
@@ -908,7 +812,7 @@ type PaymentNextAction = AgentPaymentNextAction;
 declare const AGENT_PAYMENT_PHASE_VALUES: ("rejected" | "expired" | "failed" | "agent_signature_required" | "payment_submitted" | "payment_confirmed" | "user_approval_required" | "user_execution_required" | "waiting_for_additional_approvals" | "funding_sent" | "insufficient_funds" | "funded_but_unsettled")[];
 declare const AGENT_PAYMENT_NEXT_ACTION_VALUES: ("sign_and_submit_payment" | "check_status_later" | "none" | "wait_for_user_approval" | "wait_for_user_to_complete_payment" | "retry_original_x402_request" | "stop_and_tell_user" | "request_again_if_user_still_wants_it" | "retry_with_explicit_context" | "payment_window_expired" | "fund_safe_or_raise_allowance" | "sweep_stranded_funds")[];
 declare const AGENT_PAYMENT_FAILURE_CODE_VALUES: ("PRICE_EXCEEDS_MAX" | "PAYMENT_WINDOW_EXPIRED" | "MERCHANT_REJECTED_AFTER_FUNDING" | "MERCHANT_UNRESPONSIVE_AFTER_FUNDING" | "MERCHANT_CALL_CONTEXT_UNAVAILABLE" | "AMBIGUOUS_MAX_AMOUNT" | "MAX_AMOUNT_UNCONVERTIBLE")[];
-declare const AGENT_PAYMENT_RAIL_VALUES: ("x402" | "mpp" | "mpp_demo" | "mpp_crypto" | "stripe_deposit" | "spt" | "direct")[];
+declare const AGENT_PAYMENT_RAIL_VALUES: ("x402" | "mpp_demo" | "mpp_crypto" | "stripe_deposit" | "spt" | "direct" | "mpp")[];
 declare const AgentPaymentPhaseDescriptions: Record<AgentPaymentPhase, string>;
 declare const AgentPaymentNextActionDescriptions: Record<AgentPaymentNextAction, string>;
 declare const AgentPaymentFailureCodeDescriptions: Record<AgentPaymentFailureCode, string>;
@@ -1123,7 +1027,7 @@ declare class X402UnexpectedStatusError extends HavenApiError {
 }
 declare class HavenPaymentStateError extends HavenApiError {
     readonly state: PaymentStatusResult;
-    resumeState?: X402ResumeState | MppResumeState;
+    resumeState?: X402ResumeState;
     constructor(message: string, statusCode: number, state: PaymentStatusResult, body?: unknown);
     get status(): string;
     get phase(): PaymentPhase;
@@ -1375,7 +1279,6 @@ declare class HavenClient {
     private readonly chainRpcs;
     private readonly inFlightX402;
     private readonly x402ReceiptCache;
-    private readonly inFlightMachinePayments;
     /**
      * Setup-time headers configured via `HavenClientConfig.defaultHeaders`.
      * Read-only after construction — use `withRequestContext` for per-call
@@ -1615,10 +1518,11 @@ declare class HavenClient {
         verification: ReceiptVerification;
     }>;
     /**
-     * Rehydrate the x402/MPP resume-state bundle for a payment id.
+     * Rehydrate the x402 resume-state bundle for a payment id (#1328: the MPP
+     * resume-state variant retired along with the rest of the mpp_demo surface).
      *
      * The server returns stored protocol context only. The client still signs the
-     * merchant proof locally when resumeX402Payment() or resumeMppPayment() runs.
+     * merchant proof locally when resumeX402Payment() runs.
      */
     getResumeState(paymentId: string): Promise<PaymentResumeState>;
     /**
@@ -1707,15 +1611,6 @@ declare class HavenClient {
      * Non-SSE responses pass through untouched.
      */
     private surfaceMcpResult;
-    /**
-     * Probe a paid MPP endpoint or inspect an existing challenge without creating
-     * a Haven payment or approval request.
-     */
-    quoteMpp(challengeOrUrl: MachinePaymentChallenge | string, init?: RequestInit, options?: MppAuthorizationOptions): Promise<MppQuote>;
-    /**
-     * Pay a previously inspected MPP quote and retry the exact captured request.
-     */
-    payMppChallenge(quote: MppQuote, options?: MppAuthorizationOptions): Promise<Response>;
     private retryX402Request;
     /**
      * #956: capture the merchant's OWN receipt when the paid response carries
@@ -1784,21 +1679,12 @@ declare class HavenClient {
     getX402MerchantCallContext(paymentId: string): Promise<X402MerchantCallContext>;
     private resolveX402MerchantCompletionContext;
     private resolveX402WalletForMerchantCall;
-    authorizeMachinePayment(challenge: MachinePaymentChallenge, options?: MppAuthorizationOptions): Promise<MachinePaymentReceipt>;
-    private authorizeMppDemoPayment;
-    resumeAuthorizedMpp(input: ResumeAuthorizedMppInput): Promise<MachinePaymentReceipt>;
-    resumeMppPayment(input: ResumeMppPaymentInput | MppResumeState): Promise<Response>;
-    private fetchWithMachinePayment;
-    private retryMppRequest;
     private assertCanResumeX402;
-    private assertCanResumeMpp;
     private mapX402ReceiptFromAuthorization;
     private mapX402ReceiptFromStatus;
     private buildX402Receipt;
     private createStandardX402Header;
     private cacheX402Receipt;
-    private mapMachinePaymentReceipt;
-    private mapMachinePaymentReceiptFromStatus;
     private recordMerchantRetryRejected;
     private reportMachinePaymentEvidence;
     /**
@@ -1822,11 +1708,8 @@ declare class HavenClient {
     private buildX402Quote;
     private detectX402McpTransport;
     private buildX402ResumeState;
-    private buildMppQuote;
-    private buildMppResumeState;
     private attachResumeState;
     private attachX402ResumeState;
-    private attachMppResumeState;
     /**
      * Execute a tool call by name and input.
      *
@@ -1999,7 +1882,7 @@ declare const toolDescriptions: {
     readonly payX402OneShot: {
         readonly summary: "Fetch an x402 paid HTTP resource in a single call. Handles the full probe -> pay -> retry round trip and returns the merchant response.";
         readonly selectionGuidance: "Prefer this over the quote+pay split when the agent just wants the paid resource and does not need to inspect the price first. If you already have a quote from haven_quote_x402, use haven_pay_x402_quote instead. Do not use for read-only allowance, budget, spend-limit, remaining-amount, reset-period, or what-can-I-spend questions; use the allowance lookup tool instead.";
-        readonly behavior: "Calls the URL, parses any HTTP 402 x402 challenge, signs the EIP-3009 payment from the delegate wallet, asks Haven for a Safe AllowanceModule top-up if needed, then retries the original request with the X-PAYMENT header and returns the merchant response. If the resource returns an MPP machine-payment challenge instead of standard x402, the MPP payment path is used automatically. If the resource returns a non-402 status, returns it unchanged without contacting Haven.";
+        readonly behavior: "Calls the URL, parses any HTTP 402 x402 challenge, signs the EIP-3009 payment from the delegate wallet, asks Haven for a Safe AllowanceModule top-up if needed, then retries the original request with the X-PAYMENT header and returns the merchant response. If the resource returns a non-402 status, returns it unchanged without contacting Haven.";
         readonly nextActionGuidance: string;
     };
     readonly resumeX402: {
@@ -2007,29 +1890,13 @@ declare const toolDescriptions: {
         readonly behavior: "Accepts either resume_state or payment_id, validates the original x402 details against the approved Haven funding, and retries the merchant request with the X-PAYMENT header. No new Haven approval is created.";
         readonly nextActionGuidance: "Only use when get_payment_status returns nextAction=retry_original_x402_request; do not start a new merchant session.";
     };
-    readonly quoteMpp: {
-        readonly summary: "Inspect a Haven MPP challenge or paid MPP URL without creating a Haven payment, signature, approval, or on-chain transaction.";
-        readonly behavior: "Parses an MPP challenge envelope and returns a typed quote with rail tag, amount, asset, and merchant context. Pure read-only — Haven is not contacted.";
-        readonly nextActionGuidance: "On success the returned quote is the input to haven_pay_mpp_challenge. Do not call the merchant again — Haven re-uses the captured request when paying.";
-    };
-    readonly payMpp: {
-        readonly summary: "Pay an inspected MPP challenge. The delegate key signs locally; Haven only validates and relays signed, on-chain-constrained payment transactions.";
-        readonly selectionGuidance: "Do not use this for read-only allowance, budget, spend-limit, remaining-amount, reset-period, or what-can-I-spend questions; use the allowance lookup tool instead.";
-        readonly behavior: "Authorizes the payment through Haven within the on-chain allowance, signs the challenge proof, and returns the proof header for retrying the original paid resource.";
-        readonly nextActionGuidance: "If approval is needed, preserve resume_state or payment_id and wait for nextAction=retry_original_x402_request before resuming.";
-    };
-    readonly resumeMpp: {
-        readonly summary: "Resume an MPP payment after the Haven wallet owner approved the funding step.";
-        readonly behavior: "Accepts either resume_state or payment_id and retries the original paid resource with the MPP proof header. No new Haven approval is created.";
-        readonly nextActionGuidance: "";
-    };
     readonly getPaymentStatus: {
         readonly summary: "Fetch structured Haven payment status, including phase and nextAction taxonomy for agent recovery.";
         readonly behavior: "Accepts a payment intent or approval request id and returns the full state taxonomy (phase, nextAction, rail, amount, merchant, resource url, idempotency key, message).";
         readonly nextActionGuidance: "";
     };
     readonly getResumeState: {
-        readonly summary: "Rehydrate stored x402 or MPP resume_state by payment_id.";
+        readonly summary: "Rehydrate stored x402 resume_state by payment_id.";
         readonly behavior: "Returns the context that the agent originally received in a pending-approval response, reconstructed from Haven's database. This is context only; signing still happens locally when a resume tool is called.";
         readonly nextActionGuidance: "";
     };
@@ -2297,11 +2164,6 @@ declare function resolveTokenFromAddress(address: string, network?: string): {
     decimals: number;
 } | null;
 
-declare function parseMachinePaymentChallenge(response: Response): MachinePaymentChallenge;
-declare function parseMachinePaymentChallengeResponse(response: Response): Promise<MachinePaymentChallenge>;
-declare function buildMachinePaymentIdempotencyKey(challenge: MachinePaymentChallenge): string;
-declare function encodeMachinePaymentProof(receipt: Omit<MachinePaymentReceipt, 'proofHeader'>): string;
-
 /**
  * Runtime-agnostic base64 helpers — the single source of truth for the wire
  * encoding shared by the SDK and the edge signer (#325).
@@ -2368,4 +2230,4 @@ declare function discoverMerchantMcpUrl(inputUrl: string): Promise<string | null
 /** Trailing-slash/percent-case echoes compare equal; unparseable never does. */
 declare function sameUrl(a: string, b: string): boolean;
 
-export { AGENT_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type AgentPurchaseSummary, type ClaudeTool, DISCOVERY_MAX_BYTES, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentChallenge, type MachinePaymentRail, type MachinePaymentReceipt, MerchantTimeoutError, type MppAuthorizationOptions, type MppQuote, type MppResumeState, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedMppInput, type ResumeAuthorizedX402Input, type ResumeMppPaymentInput, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, type X402AuthorizationOptions, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, X402UnexpectedStatusError, X402_MAX_AUTHORIZATION_WINDOW_SECONDS, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, addressFromKey, buildMachinePaymentIdempotencyKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, composeDescription, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodeMachinePaymentProof, encodePaymentProof, havenTools, isSupportedNodeVersion, isSweepableChain, parseMachinePaymentChallenge, parseMachinePaymentChallengeResponse, parsePaymentRequired, parsePaymentRequiredResponse, resolveTokenFromAddress, sameUrl, selectPaymentOption, selectStandardPaymentOption, signHash, signUserOpTypedDataForDelegation, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, verifyPaymentReceipt, verifySignature, x402AuthorizationAmount };
+export { AGENT_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type AgentPurchaseSummary, type ClaudeTool, DISCOVERY_MAX_BYTES, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentRail, MerchantTimeoutError, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedX402Input, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, type X402AuthorizationOptions, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, X402UnexpectedStatusError, X402_MAX_AUTHORIZATION_WINDOW_SECONDS, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, addressFromKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, composeDescription, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, havenTools, isSupportedNodeVersion, isSweepableChain, parsePaymentRequired, parsePaymentRequiredResponse, resolveTokenFromAddress, sameUrl, selectPaymentOption, selectStandardPaymentOption, signHash, signUserOpTypedDataForDelegation, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, verifyPaymentReceipt, verifySignature, x402AuthorizationAmount };