@haven_ai/sdk 0.9.0-alpha.0 → 0.10.0-alpha.0

package/dist/{receipt-WkXHZGbu.d.ts → receipt-Cg9a5Seq.d.ts}

@@ -1,4 +1,4 @@
-import { aV as RawPaymentParties } from './types-CrszUJ7Z.js';
+import { aW as RawPaymentParties } from './types-BKgqzvnk.js';
 
 /**
  * Verifiable payment receipts.

package/dist/{receipt-D4Roey3D.d.cts → receipt-q7ez8Zb2.d.cts}

@@ -1,4 +1,4 @@
-import { aV as RawPaymentParties } from './types-CrszUJ7Z.cjs';
+import { aW as RawPaymentParties } from './types-BKgqzvnk.cjs';
 
 /**
  * Verifiable payment receipts.

package/dist/test-support.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunk7UTWSJC5_cjs = require('./chunk-7UTWSJC5.cjs');
-var chunk4Z6ATE44_cjs = require('./chunk-4Z6ATE44.cjs');
+var chunk6LEXYQ7J_cjs = require('./chunk-6LEXYQ7J.cjs');
+var chunkH37YVYZA_cjs = require('./chunk-H37YVYZA.cjs');
 var viem = require('viem');
 var ethers = require('ethers');
 
@@ -9,7 +9,7 @@ var ZERO_BYTES32 = `0x${"00".repeat(32)}`;
 var ROOT_AUTHORITY = `0x${"ff".repeat(32)}`;
 var DEFAULT_DELEGATOR = "0x98989898989898989898989898989898989898De";
 var DELEGATION_ARRAY_PARAM = [
-  { type: "tuple[]", components: chunk4Z6ATE44_cjs.DELEGATION_TUPLE_COMPONENTS }
+  { type: "tuple[]", components: chunkH37YVYZA_cjs.DELEGATION_TUPLE_COMPONENTS }
 ];
 var EXECUTE_ABI = [
   {
@@ -85,16 +85,16 @@ function buildBoundRedeemDelegationsCallData(options) {
     10000n
   );
   return viem.encodeFunctionData({
-    abi: chunk4Z6ATE44_cjs.REDEEM_DELEGATIONS_ABI,
+    abi: chunkH37YVYZA_cjs.REDEEM_DELEGATIONS_ABI,
     functionName: "redeemDelegations",
-    args: [[permissionContext], [chunk4Z6ATE44_cjs.SINGLE_DEFAULT_MODE], [executionCallData]]
+    args: [[permissionContext], [chunkH37YVYZA_cjs.SINGLE_DEFAULT_MODE], [executionCallData]]
   });
 }
 function buildEmptyPermissionContextRedemption(selfCallCallData) {
   return viem.encodeFunctionData({
-    abi: chunk4Z6ATE44_cjs.REDEEM_DELEGATIONS_ABI,
+    abi: chunkH37YVYZA_cjs.REDEEM_DELEGATIONS_ABI,
     functionName: "redeemDelegations",
-    args: [[buildEmptyPermissionContext()], [chunk4Z6ATE44_cjs.SINGLE_DEFAULT_MODE], [selfCallCallData]]
+    args: [[buildEmptyPermissionContext()], [chunkH37YVYZA_cjs.SINGLE_DEFAULT_MODE], [selfCallCallData]]
   });
 }
 function buildExecuteCallData(target, value, innerCallData) {
@@ -106,20 +106,20 @@ function buildExecuteCallData(target, value, innerCallData) {
 }
 function buildBoundDirectUserOp(options) {
   const chainId = options.chainId ?? 84532;
-  const sender = options.sender ?? chunk4Z6ATE44_cjs.deriveDelegateAccountAddress(options.delegate);
+  const sender = options.sender ?? chunkH37YVYZA_cjs.deriveDelegateAccountAddress(options.delegate);
   const callData = options.callData ?? buildExecuteCallData(
-    options.target ?? chunk4Z6ATE44_cjs.DELEGATION_MANAGER,
+    options.target ?? chunkH37YVYZA_cjs.DELEGATION_MANAGER,
     options.value ?? 0n,
     buildBoundRedeemDelegationsCallData({ delegate: sender, delegator: options.delegator })
   );
   const typedData = {
     domain: {
-      name: chunk4Z6ATE44_cjs.HYBRID_DELEGATOR_DOMAIN_NAME,
-      version: chunk4Z6ATE44_cjs.HYBRID_DELEGATOR_DOMAIN_VERSION,
+      name: chunkH37YVYZA_cjs.HYBRID_DELEGATOR_DOMAIN_NAME,
+      version: chunkH37YVYZA_cjs.HYBRID_DELEGATOR_DOMAIN_VERSION,
       chainId,
       verifyingContract: sender
     },
-    types: { PackedUserOperation: chunk4Z6ATE44_cjs.PACKED_USER_OPERATION_FIELDS.map((field) => ({ ...field })) },
+    types: { PackedUserOperation: chunkH37YVYZA_cjs.PACKED_USER_OPERATION_FIELDS.map((field) => ({ ...field })) },
     primaryType: "PackedUserOperation",
     message: {
       sender,
@@ -130,10 +130,10 @@ function buildBoundDirectUserOp(options) {
       preVerificationGas: "0",
       gasFees: ZERO_BYTES32,
       paymasterAndData: "0x",
-      entryPoint: chunk4Z6ATE44_cjs.ENTRY_POINT_V07
+      entryPoint: chunkH37YVYZA_cjs.ENTRY_POINT_V07
     }
   };
-  const payloadHash = chunk4Z6ATE44_cjs.packedUserOperationHash(typedData);
+  const payloadHash = chunkH37YVYZA_cjs.packedUserOperationHash(typedData);
   return { typedData, payloadHash, sender };
 }
 function buildSelfCallCallData(sender) {
@@ -151,7 +151,7 @@ function rebuildDirectUserOpForSender(fixtureTypedData, newSender) {
   const originalCallData = fixtureTypedData.message.callData;
   const { args: executeArgs } = viem.decodeFunctionData({ abi: EXECUTE_ABI, data: originalCallData });
   const execution = executeArgs[0];
-  const { args: redeemArgs } = viem.decodeFunctionData({ abi: chunk4Z6ATE44_cjs.REDEEM_DELEGATIONS_ABI, data: execution.callData });
+  const { args: redeemArgs } = viem.decodeFunctionData({ abi: chunkH37YVYZA_cjs.REDEEM_DELEGATIONS_ABI, data: execution.callData });
   const [permissionContexts, modes, executionCallDatas] = redeemArgs;
   const [delegations] = viem.decodeAbiParameters(DELEGATION_ARRAY_PARAM, permissionContexts[0]);
   const adjustedDelegations = delegations.map(
@@ -159,7 +159,7 @@ function rebuildDirectUserOpForSender(fixtureTypedData, newSender) {
   );
   const adjustedPermissionContext = viem.encodeAbiParameters(DELEGATION_ARRAY_PARAM, [adjustedDelegations]);
   const adjustedRedeemCallData = viem.encodeFunctionData({
-    abi: chunk4Z6ATE44_cjs.REDEEM_DELEGATIONS_ABI,
+    abi: chunkH37YVYZA_cjs.REDEEM_DELEGATIONS_ABI,
     functionName: "redeemDelegations",
     args: [[adjustedPermissionContext], modes, executionCallDatas]
   });
@@ -173,13 +173,13 @@ function rebuildDirectUserOpForSender(fixtureTypedData, newSender) {
     domain: { ...fixtureTypedData.domain, verifyingContract: newSender },
     message: { ...fixtureTypedData.message, sender: newSender, callData: adjustedCallData }
   };
-  const payloadHash = chunk4Z6ATE44_cjs.packedUserOperationHash(typedData);
+  const payloadHash = chunkH37YVYZA_cjs.packedUserOperationHash(typedData);
   return { typedData, payloadHash };
 }
 function buildFundingLegUserOp(options) {
-  const sender = chunk4Z6ATE44_cjs.deriveDelegateAccountAddress(options.delegate);
+  const sender = chunkH37YVYZA_cjs.deriveDelegateAccountAddress(options.delegate);
   const callData = buildExecuteCallData(
-    chunk4Z6ATE44_cjs.DELEGATION_MANAGER,
+    chunkH37YVYZA_cjs.DELEGATION_MANAGER,
     0n,
     buildBoundRedeemDelegationsCallData({
       delegate: sender,
@@ -212,7 +212,7 @@ function delegationDigest(signHash, chainId) {
         viem.keccak256(viem.toBytes("DelegationManager")),
         viem.keccak256(viem.toBytes("1")),
         BigInt(chainId),
-        chunk4Z6ATE44_cjs.DELEGATION_MANAGER
+        chunkH37YVYZA_cjs.DELEGATION_MANAGER
       ]
     )
   );
@@ -224,7 +224,7 @@ function signedErc7710Receipt(options = {}) {
   const delegate = new ethers.Wallet(options.delegateKey ?? RECEIPT_DELEGATE_KEY);
   const signature = delegate.signingKey.sign(delegationDigest(signHash, chainId)).serialized;
   return {
-    version: chunk7UTWSJC5_cjs.RECEIPT_VERSION,
+    version: chunk6LEXYQ7J_cjs.RECEIPT_VERSION,
     paymentId: options.paymentId ?? "pay_3723",
     payment: {
       token: "USDC",

package/dist/test-support.d.cts

@@ -1,6 +1,6 @@
 import { Address, Hex } from 'viem';
-import { P as PaymentReceipt } from './receipt-D4Roey3D.cjs';
-import './types-CrszUJ7Z.cjs';
+import { P as PaymentReceipt } from './receipt-q7ez8Zb2.cjs';
+import './types-BKgqzvnk.cjs';
 
 /**
  * #3272 — a real-shaped, BOUND direct-payment `PackedUserOperation` for

package/dist/test-support.d.ts

@@ -1,6 +1,6 @@
 import { Address, Hex } from 'viem';
-import { P as PaymentReceipt } from './receipt-WkXHZGbu.js';
-import './types-CrszUJ7Z.js';
+import { P as PaymentReceipt } from './receipt-Cg9a5Seq.js';
+import './types-BKgqzvnk.js';
 
 /**
  * #3272 — a real-shaped, BOUND direct-payment `PackedUserOperation` for

package/dist/test-support.js

@@ -1,5 +1,5 @@
-import { RECEIPT_VERSION } from './chunk-VRKWNJ7H.js';
-import { DELEGATION_TUPLE_COMPONENTS, SINGLE_DEFAULT_MODE, REDEEM_DELEGATIONS_ABI, deriveDelegateAccountAddress, DELEGATION_MANAGER, PACKED_USER_OPERATION_FIELDS, packedUserOperationHash, ENTRY_POINT_V07, HYBRID_DELEGATOR_DOMAIN_VERSION, HYBRID_DELEGATOR_DOMAIN_NAME } from './chunk-J7N4LUZZ.js';
+import { RECEIPT_VERSION } from './chunk-EWTHDEIW.js';
+import { DELEGATION_TUPLE_COMPONENTS, SINGLE_DEFAULT_MODE, REDEEM_DELEGATIONS_ABI, deriveDelegateAccountAddress, DELEGATION_MANAGER, PACKED_USER_OPERATION_FIELDS, packedUserOperationHash, ENTRY_POINT_V07, HYBRID_DELEGATOR_DOMAIN_VERSION, HYBRID_DELEGATOR_DOMAIN_NAME } from './chunk-TD2PHUYP.js';
 import { keccak256, toBytes, encodeAbiParameters, encodePacked, encodeFunctionData, decodeFunctionData, decodeAbiParameters, hashTypedData, concatHex } from 'viem';
 import { Wallet } from 'ethers';
 

package/dist/{types-CrszUJ7Z.d.cts → types-BKgqzvnk.d.cts}

@@ -715,6 +715,23 @@ interface HavenAgent {
      * mechanism a caller should read/derive from.
      */
     executionRail: 'legacy' | 'delegation';
+    /**
+     * #3772: non-null when a later `connect --replace` on this machine retired
+     * this agent's directory and installed a replacement — the session reading
+     * this is still running as the OLD agent. Warning only: nothing is paused or
+     * revoked, and the old agent keeps any budget it still holds until the user
+     * removes it. Null when not superseded, and on an older backend that sends nothing.
+     */
+    supersededBy: HavenAgentSupersession | null;
+}
+/** #3772: the "this agent was replaced" notice carried by agent reads. */
+interface HavenAgentSupersession {
+    replacementAgentId: string;
+    supersededAt: string;
+    warning: string;
+    nextAction: typeof AgentPaymentNextAction.StopAndTellUser;
+    /** Why no Haven tool follows: the next step is the user's. */
+    nextToolOmittedReason: string;
 }
 interface HavenAllowance {
     id: string;
@@ -789,6 +806,8 @@ interface HavenAllowanceSummary {
     delegateAddress: string;
     chainId: number;
     allowances: HavenAllowance[];
+    /** #3772: see {@link HavenAgent.supersededBy}. */
+    supersededBy: HavenAgentSupersession | null;
 }
 /**
  * Post-purchase allowance/budget summary attached to a settled x402 payment
@@ -1667,7 +1686,9 @@ declare const AgentPaymentFailureCode: {
      * challenge — e.g. its settlement wallet is out of gas. No 402 was ever
      * issued and no payment was created; this is honest and (per
      * `retry_after_s`, when present) usually transient, unlike a permanent
-     * endpoint miss.
+     * endpoint miss — except out of gas (`reason_code:
+     * settlement_wallet_out_of_gas`), which needs the merchant's operator to
+     * top up its settlement wallet first (#3834).
      */
     readonly MerchantNotReady: "MERCHANT_NOT_READY";
 };
@@ -2017,6 +2038,14 @@ interface HavenCatalogEntry {
     priceAtomic: string | null;
     asset: string | null;
     network: string | null;
+    /**
+     * #3839: the x402 `assetTransferMethods` the merchant advertised on its last
+     * probe, comma-separated as the catalog stores them (`"eip3009"`,
+     * `"eip3009,erc7710"`); null until the first successful x402 probe and for
+     * ingestion/MPP rows. OPTIONAL on purpose: absent against a backend that does
+     * not send it. Feed it to `catalogFundingLegExpected` for the funding-leg hint.
+     */
+    assetTransferMethods?: string | null;
     status: 'active' | 'degraded' | 'delisted';
     verifiedAt: string | null;
     /**
@@ -2296,4 +2325,4 @@ declare class HavenTimeoutError extends HavenError {
     constructor(paymentId: string);
 }
 
-export { AgentPaymentNextActionSchema as $, type AgentPaymentWarning as A, type BudgetPrecheckResult as B, type CloseTaskBudgetResult as C, type X402ResumeState as D, type X402McpTransport as E, type X402MerchantCallContext as F, type X402IntentByKey as G, type HavenClientConfig as H, HavenError as I, AGENT_PAYMENT_FAILURE_CODE_VALUES as J, AGENT_PAYMENT_NEXT_ACTION_VALUES as K, AGENT_PAYMENT_PHASE_VALUES as L, type MerchantEgressPolicy as M, AGENT_PAYMENT_RAIL_VALUES as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentNextStep as Q, type ResumeAuthorizedX402Input as R, type SweepResult as S, type TaskBudgetSignContext as T, type AgentPaymentEnumSchema as U, AgentPaymentFailureCode as V, AgentPaymentFailureCodeDescriptions as W, type X402PaymentRequired as X, AgentPaymentFailureCodeSchema as Y, AgentPaymentNextAction as Z, AgentPaymentNextActionDescriptions as _, type PaymentResult as a, AgentPaymentPhase as a0, AgentPaymentPhaseDescriptions as a1, AgentPaymentPhaseSchema as a2, AgentPaymentRail as a3, AgentPaymentRailDescriptions as a4, AgentPaymentRailSchema as a5, type AgentPaymentSummary as a6, AgentPaymentWarningCode as a7, type AgentPurchaseSummary as a8, type CatalogSubmissionAccepted as a9, type PaymentNextAction as aA, type PaymentPhase as aB, type PaymentStatus as aC, SIGNER_UPDATE_FALLBACK as aD, SignerRefusalCode as aE, type SweepConfirmation as aF, type SweepEntry as aG, X402AlreadySettledError as aH, X402Erc7710AlreadySettledError as aI, type X402ExpectedAuth as aJ, type X402ExpectedContext as aK, type X402PaymentOption as aL, type X402RequestSnapshot as aM, X402TaskBudgetMismatchError as aN, X402UnexpectedStatusError as aO, assertPublicHttpsMerchantUrl as aP, isPublicHttpsMerchantUrl as aQ, publicHttpsMerchantUrlRefusal as aR, readBodyCapped as aS, signerUpdateFallback as aT, strictMerchantEgressPolicy as aU, type RawPaymentParties as aV, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, HOSTED_DISCOVERY_TIMEOUT_MS as ab, HOSTED_EGRESS_TIMEOUTS as ac, HOSTED_MAX_GET_REDIRECTS as ad, HOSTED_RESPONSE_BYTE_CAPS as ae, type HavenAgentAllowanceSummary as af, type HavenAgentReadiness as ag, type HavenAllowance as ah, HavenApiError as ai, type HavenCatalogMerchant as aj, type HavenListScope as ak, HavenPaymentStateError as al, HavenSigningError as am, HavenTimeoutError as an, HavenUnsupportedSignerVersionError as ao, HavenZeroSettlementHashError as ap, MERCHANT_EGRESS_REFUSED_CODE as aq, MERCHANT_EGRESS_RESPONSE_CAP_CODE as ar, type MachinePaymentRail as as, type MerchantEgressRefusalReason as at, MerchantEgressRefusedError as au, MerchantEgressResponseCapError as av, type MerchantEgressTimeouts as aw, type MerchantEgressUse as ax, MerchantTimeoutError as ay, type PaymentFee as az, type PaymentIntent as b, type X402AuthorizationOptions as c, type X402Intent as d, type PaymentStatusResult as e, type HavenAgent as f, type HavenAgentSummary as g, type HavenAllowanceSummary as h, type HavenBalanceCoverage as i, type PostPurchaseAllowanceSummary as j, type HavenCatalogEntry as k, type HavenCatalogSubmission as l, type HavenPaymentReceipt as m, type HavenPaymentReceiptsPage as n, type HavenTaskBudget as o, type SubmitTaskBudgetResult as p, type SubmitSubBudgetResult as q, type HavenPendingSubBudgetSignature as r, type CloseSubBudgetResult as s, type PaymentResumeState as t, type X402Receipt as u, type X402Quote as v, type X402Erc7710Settlement as w, type X402McpCallContext as x, type SignData as y, type ResumeX402PaymentInput as z };
+export { AgentPaymentNextActionSchema as $, type AgentPaymentWarning as A, type BudgetPrecheckResult as B, type CloseTaskBudgetResult as C, type X402ResumeState as D, type X402McpTransport as E, type X402MerchantCallContext as F, type X402IntentByKey as G, type HavenClientConfig as H, HavenError as I, AGENT_PAYMENT_FAILURE_CODE_VALUES as J, AGENT_PAYMENT_NEXT_ACTION_VALUES as K, AGENT_PAYMENT_PHASE_VALUES as L, type MerchantEgressPolicy as M, AGENT_PAYMENT_RAIL_VALUES as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentNextStep as Q, type ResumeAuthorizedX402Input as R, type SweepResult as S, type TaskBudgetSignContext as T, type AgentPaymentEnumSchema as U, AgentPaymentFailureCode as V, AgentPaymentFailureCodeDescriptions as W, type X402PaymentRequired as X, AgentPaymentFailureCodeSchema as Y, AgentPaymentNextAction as Z, AgentPaymentNextActionDescriptions as _, type PaymentResult as a, AgentPaymentPhase as a0, AgentPaymentPhaseDescriptions as a1, AgentPaymentPhaseSchema as a2, AgentPaymentRail as a3, AgentPaymentRailDescriptions as a4, AgentPaymentRailSchema as a5, type AgentPaymentSummary as a6, AgentPaymentWarningCode as a7, type AgentPurchaseSummary as a8, type CatalogSubmissionAccepted as a9, type PaymentFee as aA, type PaymentNextAction as aB, type PaymentPhase as aC, type PaymentStatus as aD, SIGNER_UPDATE_FALLBACK as aE, SignerRefusalCode as aF, type SweepConfirmation as aG, type SweepEntry as aH, X402AlreadySettledError as aI, X402Erc7710AlreadySettledError as aJ, type X402ExpectedAuth as aK, type X402ExpectedContext as aL, type X402PaymentOption as aM, type X402RequestSnapshot as aN, X402TaskBudgetMismatchError as aO, X402UnexpectedStatusError as aP, assertPublicHttpsMerchantUrl as aQ, isPublicHttpsMerchantUrl as aR, publicHttpsMerchantUrlRefusal as aS, readBodyCapped as aT, signerUpdateFallback as aU, strictMerchantEgressPolicy as aV, type RawPaymentParties as aW, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, HOSTED_DISCOVERY_TIMEOUT_MS as ab, HOSTED_EGRESS_TIMEOUTS as ac, HOSTED_MAX_GET_REDIRECTS as ad, HOSTED_RESPONSE_BYTE_CAPS as ae, type HavenAgentAllowanceSummary as af, type HavenAgentReadiness as ag, type HavenAgentSupersession as ah, type HavenAllowance as ai, HavenApiError as aj, type HavenCatalogMerchant as ak, type HavenListScope as al, HavenPaymentStateError as am, HavenSigningError as an, HavenTimeoutError as ao, HavenUnsupportedSignerVersionError as ap, HavenZeroSettlementHashError as aq, MERCHANT_EGRESS_REFUSED_CODE as ar, MERCHANT_EGRESS_RESPONSE_CAP_CODE as as, type MachinePaymentRail as at, type MerchantEgressRefusalReason as au, MerchantEgressRefusedError as av, MerchantEgressResponseCapError as aw, type MerchantEgressTimeouts as ax, type MerchantEgressUse as ay, MerchantTimeoutError as az, type PaymentIntent as b, type X402AuthorizationOptions as c, type X402Intent as d, type PaymentStatusResult as e, type HavenAgent as f, type HavenAgentSummary as g, type HavenAllowanceSummary as h, type HavenBalanceCoverage as i, type PostPurchaseAllowanceSummary as j, type HavenCatalogEntry as k, type HavenCatalogSubmission as l, type HavenPaymentReceipt as m, type HavenPaymentReceiptsPage as n, type HavenTaskBudget as o, type SubmitTaskBudgetResult as p, type SubmitSubBudgetResult as q, type HavenPendingSubBudgetSignature as r, type CloseSubBudgetResult as s, type PaymentResumeState as t, type X402Receipt as u, type X402Quote as v, type X402Erc7710Settlement as w, type X402McpCallContext as x, type SignData as y, type ResumeX402PaymentInput as z };

package/dist/{types-CrszUJ7Z.d.ts → types-BKgqzvnk.d.ts}

@@ -715,6 +715,23 @@ interface HavenAgent {
      * mechanism a caller should read/derive from.
      */
     executionRail: 'legacy' | 'delegation';
+    /**
+     * #3772: non-null when a later `connect --replace` on this machine retired
+     * this agent's directory and installed a replacement — the session reading
+     * this is still running as the OLD agent. Warning only: nothing is paused or
+     * revoked, and the old agent keeps any budget it still holds until the user
+     * removes it. Null when not superseded, and on an older backend that sends nothing.
+     */
+    supersededBy: HavenAgentSupersession | null;
+}
+/** #3772: the "this agent was replaced" notice carried by agent reads. */
+interface HavenAgentSupersession {
+    replacementAgentId: string;
+    supersededAt: string;
+    warning: string;
+    nextAction: typeof AgentPaymentNextAction.StopAndTellUser;
+    /** Why no Haven tool follows: the next step is the user's. */
+    nextToolOmittedReason: string;
 }
 interface HavenAllowance {
     id: string;
@@ -789,6 +806,8 @@ interface HavenAllowanceSummary {
     delegateAddress: string;
     chainId: number;
     allowances: HavenAllowance[];
+    /** #3772: see {@link HavenAgent.supersededBy}. */
+    supersededBy: HavenAgentSupersession | null;
 }
 /**
  * Post-purchase allowance/budget summary attached to a settled x402 payment
@@ -1667,7 +1686,9 @@ declare const AgentPaymentFailureCode: {
      * challenge — e.g. its settlement wallet is out of gas. No 402 was ever
      * issued and no payment was created; this is honest and (per
      * `retry_after_s`, when present) usually transient, unlike a permanent
-     * endpoint miss.
+     * endpoint miss — except out of gas (`reason_code:
+     * settlement_wallet_out_of_gas`), which needs the merchant's operator to
+     * top up its settlement wallet first (#3834).
      */
     readonly MerchantNotReady: "MERCHANT_NOT_READY";
 };
@@ -2017,6 +2038,14 @@ interface HavenCatalogEntry {
     priceAtomic: string | null;
     asset: string | null;
     network: string | null;
+    /**
+     * #3839: the x402 `assetTransferMethods` the merchant advertised on its last
+     * probe, comma-separated as the catalog stores them (`"eip3009"`,
+     * `"eip3009,erc7710"`); null until the first successful x402 probe and for
+     * ingestion/MPP rows. OPTIONAL on purpose: absent against a backend that does
+     * not send it. Feed it to `catalogFundingLegExpected` for the funding-leg hint.
+     */
+    assetTransferMethods?: string | null;
     status: 'active' | 'degraded' | 'delisted';
     verifiedAt: string | null;
     /**
@@ -2296,4 +2325,4 @@ declare class HavenTimeoutError extends HavenError {
     constructor(paymentId: string);
 }
 
-export { AgentPaymentNextActionSchema as $, type AgentPaymentWarning as A, type BudgetPrecheckResult as B, type CloseTaskBudgetResult as C, type X402ResumeState as D, type X402McpTransport as E, type X402MerchantCallContext as F, type X402IntentByKey as G, type HavenClientConfig as H, HavenError as I, AGENT_PAYMENT_FAILURE_CODE_VALUES as J, AGENT_PAYMENT_NEXT_ACTION_VALUES as K, AGENT_PAYMENT_PHASE_VALUES as L, type MerchantEgressPolicy as M, AGENT_PAYMENT_RAIL_VALUES as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentNextStep as Q, type ResumeAuthorizedX402Input as R, type SweepResult as S, type TaskBudgetSignContext as T, type AgentPaymentEnumSchema as U, AgentPaymentFailureCode as V, AgentPaymentFailureCodeDescriptions as W, type X402PaymentRequired as X, AgentPaymentFailureCodeSchema as Y, AgentPaymentNextAction as Z, AgentPaymentNextActionDescriptions as _, type PaymentResult as a, AgentPaymentPhase as a0, AgentPaymentPhaseDescriptions as a1, AgentPaymentPhaseSchema as a2, AgentPaymentRail as a3, AgentPaymentRailDescriptions as a4, AgentPaymentRailSchema as a5, type AgentPaymentSummary as a6, AgentPaymentWarningCode as a7, type AgentPurchaseSummary as a8, type CatalogSubmissionAccepted as a9, type PaymentNextAction as aA, type PaymentPhase as aB, type PaymentStatus as aC, SIGNER_UPDATE_FALLBACK as aD, SignerRefusalCode as aE, type SweepConfirmation as aF, type SweepEntry as aG, X402AlreadySettledError as aH, X402Erc7710AlreadySettledError as aI, type X402ExpectedAuth as aJ, type X402ExpectedContext as aK, type X402PaymentOption as aL, type X402RequestSnapshot as aM, X402TaskBudgetMismatchError as aN, X402UnexpectedStatusError as aO, assertPublicHttpsMerchantUrl as aP, isPublicHttpsMerchantUrl as aQ, publicHttpsMerchantUrlRefusal as aR, readBodyCapped as aS, signerUpdateFallback as aT, strictMerchantEgressPolicy as aU, type RawPaymentParties as aV, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, HOSTED_DISCOVERY_TIMEOUT_MS as ab, HOSTED_EGRESS_TIMEOUTS as ac, HOSTED_MAX_GET_REDIRECTS as ad, HOSTED_RESPONSE_BYTE_CAPS as ae, type HavenAgentAllowanceSummary as af, type HavenAgentReadiness as ag, type HavenAllowance as ah, HavenApiError as ai, type HavenCatalogMerchant as aj, type HavenListScope as ak, HavenPaymentStateError as al, HavenSigningError as am, HavenTimeoutError as an, HavenUnsupportedSignerVersionError as ao, HavenZeroSettlementHashError as ap, MERCHANT_EGRESS_REFUSED_CODE as aq, MERCHANT_EGRESS_RESPONSE_CAP_CODE as ar, type MachinePaymentRail as as, type MerchantEgressRefusalReason as at, MerchantEgressRefusedError as au, MerchantEgressResponseCapError as av, type MerchantEgressTimeouts as aw, type MerchantEgressUse as ax, MerchantTimeoutError as ay, type PaymentFee as az, type PaymentIntent as b, type X402AuthorizationOptions as c, type X402Intent as d, type PaymentStatusResult as e, type HavenAgent as f, type HavenAgentSummary as g, type HavenAllowanceSummary as h, type HavenBalanceCoverage as i, type PostPurchaseAllowanceSummary as j, type HavenCatalogEntry as k, type HavenCatalogSubmission as l, type HavenPaymentReceipt as m, type HavenPaymentReceiptsPage as n, type HavenTaskBudget as o, type SubmitTaskBudgetResult as p, type SubmitSubBudgetResult as q, type HavenPendingSubBudgetSignature as r, type CloseSubBudgetResult as s, type PaymentResumeState as t, type X402Receipt as u, type X402Quote as v, type X402Erc7710Settlement as w, type X402McpCallContext as x, type SignData as y, type ResumeX402PaymentInput as z };
+export { AgentPaymentNextActionSchema as $, type AgentPaymentWarning as A, type BudgetPrecheckResult as B, type CloseTaskBudgetResult as C, type X402ResumeState as D, type X402McpTransport as E, type X402MerchantCallContext as F, type X402IntentByKey as G, type HavenClientConfig as H, HavenError as I, AGENT_PAYMENT_FAILURE_CODE_VALUES as J, AGENT_PAYMENT_NEXT_ACTION_VALUES as K, AGENT_PAYMENT_PHASE_VALUES as L, type MerchantEgressPolicy as M, AGENT_PAYMENT_RAIL_VALUES as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentNextStep as Q, type ResumeAuthorizedX402Input as R, type SweepResult as S, type TaskBudgetSignContext as T, type AgentPaymentEnumSchema as U, AgentPaymentFailureCode as V, AgentPaymentFailureCodeDescriptions as W, type X402PaymentRequired as X, AgentPaymentFailureCodeSchema as Y, AgentPaymentNextAction as Z, AgentPaymentNextActionDescriptions as _, type PaymentResult as a, AgentPaymentPhase as a0, AgentPaymentPhaseDescriptions as a1, AgentPaymentPhaseSchema as a2, AgentPaymentRail as a3, AgentPaymentRailDescriptions as a4, AgentPaymentRailSchema as a5, type AgentPaymentSummary as a6, AgentPaymentWarningCode as a7, type AgentPurchaseSummary as a8, type CatalogSubmissionAccepted as a9, type PaymentFee as aA, type PaymentNextAction as aB, type PaymentPhase as aC, type PaymentStatus as aD, SIGNER_UPDATE_FALLBACK as aE, SignerRefusalCode as aF, type SweepConfirmation as aG, type SweepEntry as aH, X402AlreadySettledError as aI, X402Erc7710AlreadySettledError as aJ, type X402ExpectedAuth as aK, type X402ExpectedContext as aL, type X402PaymentOption as aM, type X402RequestSnapshot as aN, X402TaskBudgetMismatchError as aO, X402UnexpectedStatusError as aP, assertPublicHttpsMerchantUrl as aQ, isPublicHttpsMerchantUrl as aR, publicHttpsMerchantUrlRefusal as aS, readBodyCapped as aT, signerUpdateFallback as aU, strictMerchantEgressPolicy as aV, type RawPaymentParties as aW, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, HOSTED_DISCOVERY_TIMEOUT_MS as ab, HOSTED_EGRESS_TIMEOUTS as ac, HOSTED_MAX_GET_REDIRECTS as ad, HOSTED_RESPONSE_BYTE_CAPS as ae, type HavenAgentAllowanceSummary as af, type HavenAgentReadiness as ag, type HavenAgentSupersession as ah, type HavenAllowance as ai, HavenApiError as aj, type HavenCatalogMerchant as ak, type HavenListScope as al, HavenPaymentStateError as am, HavenSigningError as an, HavenTimeoutError as ao, HavenUnsupportedSignerVersionError as ap, HavenZeroSettlementHashError as aq, MERCHANT_EGRESS_REFUSED_CODE as ar, MERCHANT_EGRESS_RESPONSE_CAP_CODE as as, type MachinePaymentRail as at, type MerchantEgressRefusalReason as au, MerchantEgressRefusedError as av, MerchantEgressResponseCapError as aw, type MerchantEgressTimeouts as ax, type MerchantEgressUse as ay, MerchantTimeoutError as az, type PaymentIntent as b, type X402AuthorizationOptions as c, type X402Intent as d, type PaymentStatusResult as e, type HavenAgent as f, type HavenAgentSummary as g, type HavenAllowanceSummary as h, type HavenBalanceCoverage as i, type PostPurchaseAllowanceSummary as j, type HavenCatalogEntry as k, type HavenCatalogSubmission as l, type HavenPaymentReceipt as m, type HavenPaymentReceiptsPage as n, type HavenTaskBudget as o, type SubmitTaskBudgetResult as p, type SubmitSubBudgetResult as q, type HavenPendingSubBudgetSignature as r, type CloseSubBudgetResult as s, type PaymentResumeState as t, type X402Receipt as u, type X402Quote as v, type X402Erc7710Settlement as w, type X402McpCallContext as x, type SignData as y, type ResumeX402PaymentInput as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haven_ai/sdk",
-  "version": "0.9.0-alpha.0",
+  "version": "0.10.0-alpha.0",
   "description": "TypeScript SDK for Haven — give AI agents budgeted, non-custodial payment ability. Pay x402 (HTTP 402) APIs in USDC within on-chain-enforced spending limits; the agent never holds funds or keys.",
   "engines": {
     "node": ">=22"