@haven_ai/sdk 0.0.0-dev.202609261556.90c27a2 → 0.0.0-dev.202609272032.679e797

package/dist/{base64-64gEwlyv.d.cts → base64-uq8A2tP_.d.cts}

@@ -277,6 +277,10 @@ interface X402AuthorizationOptions {
      * a task budget's recipient pin is compared with the agent's own delegate
      * wallet, so a merchant-pinned task budget is refused there
      * (`task_budget_recipient_mismatch`); it pays through erc7710 only (#3378).
+     * #3392: the receipt cache and in-flight map record this id per entry —
+     * reusing an idempotency key under a DIFFERENT budget throws
+     * `X402TaskBudgetMismatchError` before any network call; pay again under a
+     * new key instead.
      */
     taskBudgetId?: string;
 }
@@ -831,6 +835,33 @@ interface PaymentParties {
     delegate: string | null;
     delegateAccount: string | null;
     merchant: string | null;
+    /**
+     * #3332: the paying agent's owner's company details — additive, present
+     * only when the backend has `HAVEN_OWNER_COMPANY_DETAILS` on AND the owner
+     * saved details; absent (not `undefined`-valued, the KEY is absent)
+     * otherwise. `viesStatus: 'valid'` means VIES accepted the VAT number —
+     * never render that as "verified" (see Haven's agent-passport docs on the
+     * same naming discipline).
+     *
+     * Present only on the receipt surfaces — `GET /payments/:id/receipt` and
+     * `GET /machine-payments/receipts` (`HavenClient.getReceipt()`,
+     * `listReceipts()`/`listReceiptsPage()`) — never on `GET
+     * /machine-payments/:id/status` (`getPaymentStatus`) or the evidence-attach echo,
+     * even with the feature on: those report payment/settlement state, not the
+     * buyer's company details (out of scope for #3332, see
+     * docs/product/owner-company-details.md).
+     */
+    buyer?: PaymentPartiesBuyer;
+}
+interface PaymentPartiesBuyer {
+    legalName: string;
+    /** ISO 3166-1 alpha-2. */
+    country: string;
+    /** For a sole trader this IS the personal identity number. */
+    orgNumber: string;
+    vatNumber: string | null;
+    viesStatus: 'pending' | 'valid' | 'invalid' | 'not_verifiable' | null;
+    viesCheckedAt: string | null;
 }
 /** @internal wire shape of {@link PaymentParties}. */
 interface RawPaymentParties {
@@ -838,6 +869,16 @@ interface RawPaymentParties {
     delegate: string | null;
     delegate_account: string | null;
     merchant: string | null;
+    buyer?: RawPaymentPartiesBuyer;
+}
+/** @internal wire shape of {@link PaymentPartiesBuyer}. */
+interface RawPaymentPartiesBuyer {
+    legal_name: string;
+    country: string;
+    org_number: string;
+    vat_number: string | null;
+    vies_status: 'pending' | 'valid' | 'invalid' | 'not_verifiable' | null;
+    vies_checked_at: string | null;
 }
 /**
  * #3132 (owner decision 3 on #3130): what population a list row came from and
@@ -1626,6 +1667,33 @@ declare class HavenPaymentStateError extends HavenApiError {
     get phase(): PaymentPhase;
     get nextAction(): PaymentNextAction;
 }
+/**
+ * #3392: the SDK's x402 receipt cache and in-flight map record the
+ * `taskBudgetId` each entry was created under. A call reusing an idempotency
+ * key whose cached/in-flight entry was created under a DIFFERENT task budget
+ * is refused with this typed error BEFORE any network call — the alternative
+ * was silently returning (or joining) a payment charged to another budget.
+ * Typed rather than `HavenApiError`-shaped: no request was attempted, so
+ * there is no HTTP status or response body to carry (the
+ * `HavenZeroSettlementHashError` precedent). A caller that genuinely wants to
+ * pay again under a different budget passes a new `idempotencyKey`.
+ */
+declare class X402TaskBudgetMismatchError extends HavenError {
+    /** The idempotency key whose cached entry was created under another budget. */
+    readonly idempotencyKey: string;
+    /** The budget the cached/in-flight entry was created under (undefined = none). */
+    readonly entryTaskBudgetId: string | undefined;
+    /** The budget this call named (undefined = none). */
+    readonly requestedTaskBudgetId: string | undefined;
+    readonly x402ErrorCode: "task_budget_mismatch";
+    constructor(message: string, 
+    /** The idempotency key whose cached entry was created under another budget. */
+    idempotencyKey: string, 
+    /** The budget the cached/in-flight entry was created under (undefined = none). */
+    entryTaskBudgetId: string | undefined, 
+    /** The budget this call named (undefined = none). */
+    requestedTaskBudgetId: string | undefined);
+}
 declare class HavenSigningError extends HavenError {
     constructor(message: string);
 }
@@ -1901,7 +1969,7 @@ declare function buildSweepAuthorizationMessage(auth: SweepAuthorization): strin
  * This SDK's own version. Owned by `scripts/release-bump.mjs`, which rewrites
  * it with the package version on every release — never hand-edit it.
  */
-declare const SDK_VERSION = "0.0.0-dev.202609261556.90c27a2";
+declare const SDK_VERSION = "0.0.0-dev.202609272032.679e797";
 /** The request header every published Haven client sends. */
 declare const HAVEN_CLIENT_HEADER = "X-Haven-Client";
 /** `<package>/<version>` — the value of {@link HAVEN_CLIENT_HEADER}. */
@@ -2955,4 +3023,4 @@ declare function encodeBase64Json(value: unknown): string;
  */
 declare function decodeBase64Json<T>(value: string, label?: string): T;
 
-export { AgentPaymentPhase as $, type AgentPaymentWarning as A, type ResumeAuthorizedX402Input as B, type CloseTaskBudgetResult as C, type ResumeX402PaymentInput as D, type X402ResumeState as E, type X402McpTransport as F, type X402MerchantCallContext 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, AGENT_PAYMENT_RAIL_VALUES as M, type AgentNextStep as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentPaymentEnumSchema as Q, type RawPaymentParties as R, type SweepResult as S, type TaskBudgetSignContext as T, AgentPaymentFailureCode as U, AgentPaymentFailureCodeDescriptions as V, AgentPaymentFailureCodeSchema as W, type X402PaymentRequired as X, AgentPaymentNextAction as Y, AgentPaymentNextActionDescriptions as Z, AgentPaymentNextActionSchema as _, type HavenClientUpdate as a, type SweepExpectedAuth as a$, AgentPaymentPhaseDescriptions as a0, AgentPaymentPhaseSchema as a1, AgentPaymentRail as a2, AgentPaymentRailDescriptions as a3, AgentPaymentRailSchema as a4, type AgentPaymentSummary as a5, AgentPaymentWarningCode as a6, type AgentPurchaseSummary as a7, CONNECTOR_PACKAGE_NAME as a8, type CatalogSubmissionAccepted as a9, NEXT_TOOL_SERVER_NAMES as aA, NEXT_TOOL_SERVER_ROLES as aB, type NextStep as aC, type NextStepArguments as aD, type NextStepHandoff as aE, type NextStepInput as aF, type NextStepTarget as aG, type NextStepTargets as aH, type NextToolServerRole as aI, PACKED_USER_OPERATION_FIELDS as aJ, type PaymentFee as aK, type PaymentNextAction as aL, type PaymentPhase as aM, type PaymentStatus as aN, ROOT_AUTHORITY as aO, SDK_CLIENT_IDENTITY as aP, SDK_VERSION as aQ, SIGNER_UPDATE_FALLBACK as aR, SWEEP_BASE_CHAIN_ID as aS, SWEEP_BASE_SEPOLIA_CHAIN_ID as aT, SWEEP_BASE_SEPOLIA_USDC_ADDRESS as aU, SWEEP_BASE_USDC_ADDRESS as aV, type SettlementChildExpectation as aW, SignerRefusalCode as aX, type SweepConfirmation as aY, type SweepEip712Domain as aZ, type SweepEntry as a_, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, DEFAULT_NEXT_TOOL_BY_ACTION as ab, DIRECT_SIGN_CONTEXT_VERSION as ac, ENTRY_POINT_V07 as ad, ERC7710_ASSET_TRANSFER_METHOD as ae, HAVEN_CLIENT_HEADER as af, HAVEN_CONNECTOR_CHANNEL as ag, HAVEN_MINIMUM_NODE_VERSION as ah, HYBRID_DELEGATOR_DOMAIN_NAME as ai, HYBRID_DELEGATOR_DOMAIN_VERSION as aj, type HavenAgentAllowanceSummary as ak, type HavenAgentReadiness as al, type HavenAllowance as am, HavenApiError as an, type HavenCatalogMerchant as ao, type HavenListScope as ap, HavenPaymentStateError as aq, HavenSigningError as ar, HavenTimeoutError as as, HavenTypedDataRefusedError as at, HavenUnsupportedSignerVersionError as au, HavenUserOpBindingError as av, HavenZeroSettlementHashError as aw, MAX_TASK_BUDGET_TTL_SECONDS as ax, type MachinePaymentRail as ay, MerchantTimeoutError as az, type PaymentResult as b, selectX402SettlementScheme as b$, type SweepPreparation as b0, type SweepSubmitResult as b1, type SweepTypedData as b2, TRANSFER_WITH_AUTHORIZATION_TYPES as b3, TYPED_DATA_NOT_ALLOWED as b4, type TaskBudgetCloseExpectation as b5, type TaskChildExpectation as b6, type TaskChildTypedData as b7, type UnsupportedNodeVersionMessageOptions as b8, X402AlreadySettledError as b9, decodeBase64Json as bA, decodeBase64Utf8 as bB, defaultNextToolFor as bC, deriveDelegateAccountAddress as bD, encodeBase64Json as bE, encodeBase64Utf8 as bF, encodePaymentProof as bG, hashDelegation as bH, havenClientIdentity as bI, isConnectorChannel as bJ, isErc7710Option as bK, isPackedUserOperationTypedData as bL, isSupportedNodeVersion as bM, isSweepableChain as bN, isTaskChildTypedData as bO, normalizePaymentRequired as bP, packedUserOperationHash as bQ, parseNextTool as bR, parsePaymentRequired as bS, parsePaymentRequiredResponse as bT, readClientUpdate as bU, renderNextTool as bV, resolveConnectorChannel as bW, resolveTokenFromAddress as bX, selectErc7710PaymentOption as bY, selectPaymentOption as bZ, selectStandardPaymentOption as b_, type X402ExpectedAuth as ba, type X402ExpectedContext as bb, type X402PaymentHeaderContext as bc, X402PaymentHeaderValidationError as bd, type X402PaymentOption as be, type X402RequestSnapshot as bf, type X402SchemeSelection as bg, X402UnexpectedStatusError as bh, X402_LEGACY_PAYMENT_HEADER_NAME as bi, X402_MAX_AUTHORIZATION_WINDOW_SECONDS as bj, X402_PAYMENT_HEADER_NAME as bk, X402_PAYMENT_HEADER_NAMES_SENT as bl, X402_PAYMENT_REQUIRED_HEADER_NAME as bm, X402_PAYMENT_RESPONSE_HEADER_NAME as bn, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS as bo, assertBoundDirectPaymentUserOp as bp, assertOwnTaskBudgetCloseUserOp as bq, assertOwnTaskChild as br, assertUserOpTypedDataBinding as bs, buildSweepAuthorizationMessage as bt, buildSweepTypedData as bu, buildX402ExpectedMessage as bv, compareNodeVersions as bw, connectorRerunCommand as bx, connectorSpec as by, createNextStepBuilder as bz, type PaymentIntent as c, signerUpdateFallback as c0, sweepUsdcAddress as c1, sweepUsdcDomain as c2, toStandardPaymentRequirements as c3, unsupportedNodeVersionMessage as c4, validateStandardX402PaymentHeader as c5, verifySettlementChild as c6, x402AssetTransferMethod as c7, x402AuthorizationAmount as c8, x402FacilitatorAddresses as c9, x402V2PaymentEnvelope as ca, CAVEAT_ENFORCERS as cb, CAVEAT_TYPEHASH as cc, DELEGATION_MANAGER as cd, DELEGATION_TYPEHASH as ce, DIRECT_PAYMENT_CHAIN_IDS as cf, type DelegationForHashing as cg, EXECUTE_ABI as ch, HYBRID_DELEGATOR_IMPLEMENTATION as ci, MAX_SETTLEMENT_WINDOW_SECONDS as cj, SIMPLE_FACTORY_ADDRESS as ck, type SettlementChildTypedData as cl, assertFundingLegPaysDelegate as cm, assertOwnSettlementChild as cn, chainIdForNetwork as co, isSettlementChildTypedData as cp, type X402AuthorizationOptions as d, type X402Intent as e, type PaymentStatusResult as f, type HavenAgent as g, type HavenAgentSummary as h, type SweepPrepareResponse as i, type SweepAuthorization as j, type SweepSubmitResponse as k, type HavenAllowanceSummary as l, type HavenBalanceCoverage as m, type PostPurchaseAllowanceSummary as n, type HavenCatalogEntry as o, type HavenCatalogSubmission as p, type HavenPaymentReceipt as q, type HavenPaymentReceiptsPage as r, type HavenTaskBudget as s, type SubmitTaskBudgetResult as t, type PaymentResumeState as u, type X402Receipt as v, type X402Quote as w, type X402Erc7710Settlement as x, type X402McpCallContext as y, type SignData as z };
+export { AgentPaymentPhase as $, type AgentPaymentWarning as A, type ResumeAuthorizedX402Input as B, type CloseTaskBudgetResult as C, type ResumeX402PaymentInput as D, type X402ResumeState as E, type X402McpTransport as F, type X402MerchantCallContext 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, AGENT_PAYMENT_RAIL_VALUES as M, type AgentNextStep as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentPaymentEnumSchema as Q, type RawPaymentParties as R, type SweepResult as S, type TaskBudgetSignContext as T, AgentPaymentFailureCode as U, AgentPaymentFailureCodeDescriptions as V, AgentPaymentFailureCodeSchema as W, type X402PaymentRequired as X, AgentPaymentNextAction as Y, AgentPaymentNextActionDescriptions as Z, AgentPaymentNextActionSchema as _, type HavenClientUpdate as a, type SweepExpectedAuth as a$, AgentPaymentPhaseDescriptions as a0, AgentPaymentPhaseSchema as a1, AgentPaymentRail as a2, AgentPaymentRailDescriptions as a3, AgentPaymentRailSchema as a4, type AgentPaymentSummary as a5, AgentPaymentWarningCode as a6, type AgentPurchaseSummary as a7, CONNECTOR_PACKAGE_NAME as a8, type CatalogSubmissionAccepted as a9, NEXT_TOOL_SERVER_NAMES as aA, NEXT_TOOL_SERVER_ROLES as aB, type NextStep as aC, type NextStepArguments as aD, type NextStepHandoff as aE, type NextStepInput as aF, type NextStepTarget as aG, type NextStepTargets as aH, type NextToolServerRole as aI, PACKED_USER_OPERATION_FIELDS as aJ, type PaymentFee as aK, type PaymentNextAction as aL, type PaymentPhase as aM, type PaymentStatus as aN, ROOT_AUTHORITY as aO, SDK_CLIENT_IDENTITY as aP, SDK_VERSION as aQ, SIGNER_UPDATE_FALLBACK as aR, SWEEP_BASE_CHAIN_ID as aS, SWEEP_BASE_SEPOLIA_CHAIN_ID as aT, SWEEP_BASE_SEPOLIA_USDC_ADDRESS as aU, SWEEP_BASE_USDC_ADDRESS as aV, type SettlementChildExpectation as aW, SignerRefusalCode as aX, type SweepConfirmation as aY, type SweepEip712Domain as aZ, type SweepEntry as a_, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, DEFAULT_NEXT_TOOL_BY_ACTION as ab, DIRECT_SIGN_CONTEXT_VERSION as ac, ENTRY_POINT_V07 as ad, ERC7710_ASSET_TRANSFER_METHOD as ae, HAVEN_CLIENT_HEADER as af, HAVEN_CONNECTOR_CHANNEL as ag, HAVEN_MINIMUM_NODE_VERSION as ah, HYBRID_DELEGATOR_DOMAIN_NAME as ai, HYBRID_DELEGATOR_DOMAIN_VERSION as aj, type HavenAgentAllowanceSummary as ak, type HavenAgentReadiness as al, type HavenAllowance as am, HavenApiError as an, type HavenCatalogMerchant as ao, type HavenListScope as ap, HavenPaymentStateError as aq, HavenSigningError as ar, HavenTimeoutError as as, HavenTypedDataRefusedError as at, HavenUnsupportedSignerVersionError as au, HavenUserOpBindingError as av, HavenZeroSettlementHashError as aw, MAX_TASK_BUDGET_TTL_SECONDS as ax, type MachinePaymentRail as ay, MerchantTimeoutError as az, type PaymentResult as b, selectStandardPaymentOption as b$, type SweepPreparation as b0, type SweepSubmitResult as b1, type SweepTypedData as b2, TRANSFER_WITH_AUTHORIZATION_TYPES as b3, TYPED_DATA_NOT_ALLOWED as b4, type TaskBudgetCloseExpectation as b5, type TaskChildExpectation as b6, type TaskChildTypedData as b7, type UnsupportedNodeVersionMessageOptions as b8, X402AlreadySettledError as b9, createNextStepBuilder as bA, decodeBase64Json as bB, decodeBase64Utf8 as bC, defaultNextToolFor as bD, deriveDelegateAccountAddress as bE, encodeBase64Json as bF, encodeBase64Utf8 as bG, encodePaymentProof as bH, hashDelegation as bI, havenClientIdentity as bJ, isConnectorChannel as bK, isErc7710Option as bL, isPackedUserOperationTypedData as bM, isSupportedNodeVersion as bN, isSweepableChain as bO, isTaskChildTypedData as bP, normalizePaymentRequired as bQ, packedUserOperationHash as bR, parseNextTool as bS, parsePaymentRequired as bT, parsePaymentRequiredResponse as bU, readClientUpdate as bV, renderNextTool as bW, resolveConnectorChannel as bX, resolveTokenFromAddress as bY, selectErc7710PaymentOption as bZ, selectPaymentOption as b_, type X402ExpectedAuth as ba, type X402ExpectedContext as bb, type X402PaymentHeaderContext as bc, X402PaymentHeaderValidationError as bd, type X402PaymentOption as be, type X402RequestSnapshot as bf, type X402SchemeSelection as bg, X402TaskBudgetMismatchError as bh, X402UnexpectedStatusError as bi, X402_LEGACY_PAYMENT_HEADER_NAME as bj, X402_MAX_AUTHORIZATION_WINDOW_SECONDS as bk, X402_PAYMENT_HEADER_NAME as bl, X402_PAYMENT_HEADER_NAMES_SENT as bm, X402_PAYMENT_REQUIRED_HEADER_NAME as bn, X402_PAYMENT_RESPONSE_HEADER_NAME as bo, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS as bp, assertBoundDirectPaymentUserOp as bq, assertOwnTaskBudgetCloseUserOp as br, assertOwnTaskChild as bs, assertUserOpTypedDataBinding as bt, buildSweepAuthorizationMessage as bu, buildSweepTypedData as bv, buildX402ExpectedMessage as bw, compareNodeVersions as bx, connectorRerunCommand as by, connectorSpec as bz, type PaymentIntent as c, selectX402SettlementScheme as c0, signerUpdateFallback as c1, sweepUsdcAddress as c2, sweepUsdcDomain as c3, toStandardPaymentRequirements as c4, unsupportedNodeVersionMessage as c5, validateStandardX402PaymentHeader as c6, verifySettlementChild as c7, x402AssetTransferMethod as c8, x402AuthorizationAmount as c9, x402FacilitatorAddresses as ca, x402V2PaymentEnvelope as cb, CAVEAT_ENFORCERS as cc, CAVEAT_TYPEHASH as cd, DELEGATION_MANAGER as ce, DELEGATION_TYPEHASH as cf, DIRECT_PAYMENT_CHAIN_IDS as cg, type DelegationForHashing as ch, EXECUTE_ABI as ci, HYBRID_DELEGATOR_IMPLEMENTATION as cj, MAX_SETTLEMENT_WINDOW_SECONDS as ck, SIMPLE_FACTORY_ADDRESS as cl, type SettlementChildTypedData as cm, assertFundingLegPaysDelegate as cn, assertOwnSettlementChild as co, chainIdForNetwork as cp, isSettlementChildTypedData as cq, type X402AuthorizationOptions as d, type X402Intent as e, type PaymentStatusResult as f, type HavenAgent as g, type HavenAgentSummary as h, type SweepPrepareResponse as i, type SweepAuthorization as j, type SweepSubmitResponse as k, type HavenAllowanceSummary as l, type HavenBalanceCoverage as m, type PostPurchaseAllowanceSummary as n, type HavenCatalogEntry as o, type HavenCatalogSubmission as p, type HavenPaymentReceipt as q, type HavenPaymentReceiptsPage as r, type HavenTaskBudget as s, type SubmitTaskBudgetResult as t, type PaymentResumeState as u, type X402Receipt as v, type X402Quote as w, type X402Erc7710Settlement as x, type X402McpCallContext as y, type SignData as z };

package/dist/{base64-64gEwlyv.d.ts → base64-uq8A2tP_.d.ts}

@@ -277,6 +277,10 @@ interface X402AuthorizationOptions {
      * a task budget's recipient pin is compared with the agent's own delegate
      * wallet, so a merchant-pinned task budget is refused there
      * (`task_budget_recipient_mismatch`); it pays through erc7710 only (#3378).
+     * #3392: the receipt cache and in-flight map record this id per entry —
+     * reusing an idempotency key under a DIFFERENT budget throws
+     * `X402TaskBudgetMismatchError` before any network call; pay again under a
+     * new key instead.
      */
     taskBudgetId?: string;
 }
@@ -831,6 +835,33 @@ interface PaymentParties {
     delegate: string | null;
     delegateAccount: string | null;
     merchant: string | null;
+    /**
+     * #3332: the paying agent's owner's company details — additive, present
+     * only when the backend has `HAVEN_OWNER_COMPANY_DETAILS` on AND the owner
+     * saved details; absent (not `undefined`-valued, the KEY is absent)
+     * otherwise. `viesStatus: 'valid'` means VIES accepted the VAT number —
+     * never render that as "verified" (see Haven's agent-passport docs on the
+     * same naming discipline).
+     *
+     * Present only on the receipt surfaces — `GET /payments/:id/receipt` and
+     * `GET /machine-payments/receipts` (`HavenClient.getReceipt()`,
+     * `listReceipts()`/`listReceiptsPage()`) — never on `GET
+     * /machine-payments/:id/status` (`getPaymentStatus`) or the evidence-attach echo,
+     * even with the feature on: those report payment/settlement state, not the
+     * buyer's company details (out of scope for #3332, see
+     * docs/product/owner-company-details.md).
+     */
+    buyer?: PaymentPartiesBuyer;
+}
+interface PaymentPartiesBuyer {
+    legalName: string;
+    /** ISO 3166-1 alpha-2. */
+    country: string;
+    /** For a sole trader this IS the personal identity number. */
+    orgNumber: string;
+    vatNumber: string | null;
+    viesStatus: 'pending' | 'valid' | 'invalid' | 'not_verifiable' | null;
+    viesCheckedAt: string | null;
 }
 /** @internal wire shape of {@link PaymentParties}. */
 interface RawPaymentParties {
@@ -838,6 +869,16 @@ interface RawPaymentParties {
     delegate: string | null;
     delegate_account: string | null;
     merchant: string | null;
+    buyer?: RawPaymentPartiesBuyer;
+}
+/** @internal wire shape of {@link PaymentPartiesBuyer}. */
+interface RawPaymentPartiesBuyer {
+    legal_name: string;
+    country: string;
+    org_number: string;
+    vat_number: string | null;
+    vies_status: 'pending' | 'valid' | 'invalid' | 'not_verifiable' | null;
+    vies_checked_at: string | null;
 }
 /**
  * #3132 (owner decision 3 on #3130): what population a list row came from and
@@ -1626,6 +1667,33 @@ declare class HavenPaymentStateError extends HavenApiError {
     get phase(): PaymentPhase;
     get nextAction(): PaymentNextAction;
 }
+/**
+ * #3392: the SDK's x402 receipt cache and in-flight map record the
+ * `taskBudgetId` each entry was created under. A call reusing an idempotency
+ * key whose cached/in-flight entry was created under a DIFFERENT task budget
+ * is refused with this typed error BEFORE any network call — the alternative
+ * was silently returning (or joining) a payment charged to another budget.
+ * Typed rather than `HavenApiError`-shaped: no request was attempted, so
+ * there is no HTTP status or response body to carry (the
+ * `HavenZeroSettlementHashError` precedent). A caller that genuinely wants to
+ * pay again under a different budget passes a new `idempotencyKey`.
+ */
+declare class X402TaskBudgetMismatchError extends HavenError {
+    /** The idempotency key whose cached entry was created under another budget. */
+    readonly idempotencyKey: string;
+    /** The budget the cached/in-flight entry was created under (undefined = none). */
+    readonly entryTaskBudgetId: string | undefined;
+    /** The budget this call named (undefined = none). */
+    readonly requestedTaskBudgetId: string | undefined;
+    readonly x402ErrorCode: "task_budget_mismatch";
+    constructor(message: string, 
+    /** The idempotency key whose cached entry was created under another budget. */
+    idempotencyKey: string, 
+    /** The budget the cached/in-flight entry was created under (undefined = none). */
+    entryTaskBudgetId: string | undefined, 
+    /** The budget this call named (undefined = none). */
+    requestedTaskBudgetId: string | undefined);
+}
 declare class HavenSigningError extends HavenError {
     constructor(message: string);
 }
@@ -1901,7 +1969,7 @@ declare function buildSweepAuthorizationMessage(auth: SweepAuthorization): strin
  * This SDK's own version. Owned by `scripts/release-bump.mjs`, which rewrites
  * it with the package version on every release — never hand-edit it.
  */
-declare const SDK_VERSION = "0.0.0-dev.202609261556.90c27a2";
+declare const SDK_VERSION = "0.0.0-dev.202609272032.679e797";
 /** The request header every published Haven client sends. */
 declare const HAVEN_CLIENT_HEADER = "X-Haven-Client";
 /** `<package>/<version>` — the value of {@link HAVEN_CLIENT_HEADER}. */
@@ -2955,4 +3023,4 @@ declare function encodeBase64Json(value: unknown): string;
  */
 declare function decodeBase64Json<T>(value: string, label?: string): T;
 
-export { AgentPaymentPhase as $, type AgentPaymentWarning as A, type ResumeAuthorizedX402Input as B, type CloseTaskBudgetResult as C, type ResumeX402PaymentInput as D, type X402ResumeState as E, type X402McpTransport as F, type X402MerchantCallContext 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, AGENT_PAYMENT_RAIL_VALUES as M, type AgentNextStep as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentPaymentEnumSchema as Q, type RawPaymentParties as R, type SweepResult as S, type TaskBudgetSignContext as T, AgentPaymentFailureCode as U, AgentPaymentFailureCodeDescriptions as V, AgentPaymentFailureCodeSchema as W, type X402PaymentRequired as X, AgentPaymentNextAction as Y, AgentPaymentNextActionDescriptions as Z, AgentPaymentNextActionSchema as _, type HavenClientUpdate as a, type SweepExpectedAuth as a$, AgentPaymentPhaseDescriptions as a0, AgentPaymentPhaseSchema as a1, AgentPaymentRail as a2, AgentPaymentRailDescriptions as a3, AgentPaymentRailSchema as a4, type AgentPaymentSummary as a5, AgentPaymentWarningCode as a6, type AgentPurchaseSummary as a7, CONNECTOR_PACKAGE_NAME as a8, type CatalogSubmissionAccepted as a9, NEXT_TOOL_SERVER_NAMES as aA, NEXT_TOOL_SERVER_ROLES as aB, type NextStep as aC, type NextStepArguments as aD, type NextStepHandoff as aE, type NextStepInput as aF, type NextStepTarget as aG, type NextStepTargets as aH, type NextToolServerRole as aI, PACKED_USER_OPERATION_FIELDS as aJ, type PaymentFee as aK, type PaymentNextAction as aL, type PaymentPhase as aM, type PaymentStatus as aN, ROOT_AUTHORITY as aO, SDK_CLIENT_IDENTITY as aP, SDK_VERSION as aQ, SIGNER_UPDATE_FALLBACK as aR, SWEEP_BASE_CHAIN_ID as aS, SWEEP_BASE_SEPOLIA_CHAIN_ID as aT, SWEEP_BASE_SEPOLIA_USDC_ADDRESS as aU, SWEEP_BASE_USDC_ADDRESS as aV, type SettlementChildExpectation as aW, SignerRefusalCode as aX, type SweepConfirmation as aY, type SweepEip712Domain as aZ, type SweepEntry as a_, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, DEFAULT_NEXT_TOOL_BY_ACTION as ab, DIRECT_SIGN_CONTEXT_VERSION as ac, ENTRY_POINT_V07 as ad, ERC7710_ASSET_TRANSFER_METHOD as ae, HAVEN_CLIENT_HEADER as af, HAVEN_CONNECTOR_CHANNEL as ag, HAVEN_MINIMUM_NODE_VERSION as ah, HYBRID_DELEGATOR_DOMAIN_NAME as ai, HYBRID_DELEGATOR_DOMAIN_VERSION as aj, type HavenAgentAllowanceSummary as ak, type HavenAgentReadiness as al, type HavenAllowance as am, HavenApiError as an, type HavenCatalogMerchant as ao, type HavenListScope as ap, HavenPaymentStateError as aq, HavenSigningError as ar, HavenTimeoutError as as, HavenTypedDataRefusedError as at, HavenUnsupportedSignerVersionError as au, HavenUserOpBindingError as av, HavenZeroSettlementHashError as aw, MAX_TASK_BUDGET_TTL_SECONDS as ax, type MachinePaymentRail as ay, MerchantTimeoutError as az, type PaymentResult as b, selectX402SettlementScheme as b$, type SweepPreparation as b0, type SweepSubmitResult as b1, type SweepTypedData as b2, TRANSFER_WITH_AUTHORIZATION_TYPES as b3, TYPED_DATA_NOT_ALLOWED as b4, type TaskBudgetCloseExpectation as b5, type TaskChildExpectation as b6, type TaskChildTypedData as b7, type UnsupportedNodeVersionMessageOptions as b8, X402AlreadySettledError as b9, decodeBase64Json as bA, decodeBase64Utf8 as bB, defaultNextToolFor as bC, deriveDelegateAccountAddress as bD, encodeBase64Json as bE, encodeBase64Utf8 as bF, encodePaymentProof as bG, hashDelegation as bH, havenClientIdentity as bI, isConnectorChannel as bJ, isErc7710Option as bK, isPackedUserOperationTypedData as bL, isSupportedNodeVersion as bM, isSweepableChain as bN, isTaskChildTypedData as bO, normalizePaymentRequired as bP, packedUserOperationHash as bQ, parseNextTool as bR, parsePaymentRequired as bS, parsePaymentRequiredResponse as bT, readClientUpdate as bU, renderNextTool as bV, resolveConnectorChannel as bW, resolveTokenFromAddress as bX, selectErc7710PaymentOption as bY, selectPaymentOption as bZ, selectStandardPaymentOption as b_, type X402ExpectedAuth as ba, type X402ExpectedContext as bb, type X402PaymentHeaderContext as bc, X402PaymentHeaderValidationError as bd, type X402PaymentOption as be, type X402RequestSnapshot as bf, type X402SchemeSelection as bg, X402UnexpectedStatusError as bh, X402_LEGACY_PAYMENT_HEADER_NAME as bi, X402_MAX_AUTHORIZATION_WINDOW_SECONDS as bj, X402_PAYMENT_HEADER_NAME as bk, X402_PAYMENT_HEADER_NAMES_SENT as bl, X402_PAYMENT_REQUIRED_HEADER_NAME as bm, X402_PAYMENT_RESPONSE_HEADER_NAME as bn, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS as bo, assertBoundDirectPaymentUserOp as bp, assertOwnTaskBudgetCloseUserOp as bq, assertOwnTaskChild as br, assertUserOpTypedDataBinding as bs, buildSweepAuthorizationMessage as bt, buildSweepTypedData as bu, buildX402ExpectedMessage as bv, compareNodeVersions as bw, connectorRerunCommand as bx, connectorSpec as by, createNextStepBuilder as bz, type PaymentIntent as c, signerUpdateFallback as c0, sweepUsdcAddress as c1, sweepUsdcDomain as c2, toStandardPaymentRequirements as c3, unsupportedNodeVersionMessage as c4, validateStandardX402PaymentHeader as c5, verifySettlementChild as c6, x402AssetTransferMethod as c7, x402AuthorizationAmount as c8, x402FacilitatorAddresses as c9, x402V2PaymentEnvelope as ca, CAVEAT_ENFORCERS as cb, CAVEAT_TYPEHASH as cc, DELEGATION_MANAGER as cd, DELEGATION_TYPEHASH as ce, DIRECT_PAYMENT_CHAIN_IDS as cf, type DelegationForHashing as cg, EXECUTE_ABI as ch, HYBRID_DELEGATOR_IMPLEMENTATION as ci, MAX_SETTLEMENT_WINDOW_SECONDS as cj, SIMPLE_FACTORY_ADDRESS as ck, type SettlementChildTypedData as cl, assertFundingLegPaysDelegate as cm, assertOwnSettlementChild as cn, chainIdForNetwork as co, isSettlementChildTypedData as cp, type X402AuthorizationOptions as d, type X402Intent as e, type PaymentStatusResult as f, type HavenAgent as g, type HavenAgentSummary as h, type SweepPrepareResponse as i, type SweepAuthorization as j, type SweepSubmitResponse as k, type HavenAllowanceSummary as l, type HavenBalanceCoverage as m, type PostPurchaseAllowanceSummary as n, type HavenCatalogEntry as o, type HavenCatalogSubmission as p, type HavenPaymentReceipt as q, type HavenPaymentReceiptsPage as r, type HavenTaskBudget as s, type SubmitTaskBudgetResult as t, type PaymentResumeState as u, type X402Receipt as v, type X402Quote as w, type X402Erc7710Settlement as x, type X402McpCallContext as y, type SignData as z };
+export { AgentPaymentPhase as $, type AgentPaymentWarning as A, type ResumeAuthorizedX402Input as B, type CloseTaskBudgetResult as C, type ResumeX402PaymentInput as D, type X402ResumeState as E, type X402McpTransport as F, type X402MerchantCallContext 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, AGENT_PAYMENT_RAIL_VALUES as M, type AgentNextStep as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentPaymentEnumSchema as Q, type RawPaymentParties as R, type SweepResult as S, type TaskBudgetSignContext as T, AgentPaymentFailureCode as U, AgentPaymentFailureCodeDescriptions as V, AgentPaymentFailureCodeSchema as W, type X402PaymentRequired as X, AgentPaymentNextAction as Y, AgentPaymentNextActionDescriptions as Z, AgentPaymentNextActionSchema as _, type HavenClientUpdate as a, type SweepExpectedAuth as a$, AgentPaymentPhaseDescriptions as a0, AgentPaymentPhaseSchema as a1, AgentPaymentRail as a2, AgentPaymentRailDescriptions as a3, AgentPaymentRailSchema as a4, type AgentPaymentSummary as a5, AgentPaymentWarningCode as a6, type AgentPurchaseSummary as a7, CONNECTOR_PACKAGE_NAME as a8, type CatalogSubmissionAccepted as a9, NEXT_TOOL_SERVER_NAMES as aA, NEXT_TOOL_SERVER_ROLES as aB, type NextStep as aC, type NextStepArguments as aD, type NextStepHandoff as aE, type NextStepInput as aF, type NextStepTarget as aG, type NextStepTargets as aH, type NextToolServerRole as aI, PACKED_USER_OPERATION_FIELDS as aJ, type PaymentFee as aK, type PaymentNextAction as aL, type PaymentPhase as aM, type PaymentStatus as aN, ROOT_AUTHORITY as aO, SDK_CLIENT_IDENTITY as aP, SDK_VERSION as aQ, SIGNER_UPDATE_FALLBACK as aR, SWEEP_BASE_CHAIN_ID as aS, SWEEP_BASE_SEPOLIA_CHAIN_ID as aT, SWEEP_BASE_SEPOLIA_USDC_ADDRESS as aU, SWEEP_BASE_USDC_ADDRESS as aV, type SettlementChildExpectation as aW, SignerRefusalCode as aX, type SweepConfirmation as aY, type SweepEip712Domain as aZ, type SweepEntry as a_, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, DEFAULT_NEXT_TOOL_BY_ACTION as ab, DIRECT_SIGN_CONTEXT_VERSION as ac, ENTRY_POINT_V07 as ad, ERC7710_ASSET_TRANSFER_METHOD as ae, HAVEN_CLIENT_HEADER as af, HAVEN_CONNECTOR_CHANNEL as ag, HAVEN_MINIMUM_NODE_VERSION as ah, HYBRID_DELEGATOR_DOMAIN_NAME as ai, HYBRID_DELEGATOR_DOMAIN_VERSION as aj, type HavenAgentAllowanceSummary as ak, type HavenAgentReadiness as al, type HavenAllowance as am, HavenApiError as an, type HavenCatalogMerchant as ao, type HavenListScope as ap, HavenPaymentStateError as aq, HavenSigningError as ar, HavenTimeoutError as as, HavenTypedDataRefusedError as at, HavenUnsupportedSignerVersionError as au, HavenUserOpBindingError as av, HavenZeroSettlementHashError as aw, MAX_TASK_BUDGET_TTL_SECONDS as ax, type MachinePaymentRail as ay, MerchantTimeoutError as az, type PaymentResult as b, selectStandardPaymentOption as b$, type SweepPreparation as b0, type SweepSubmitResult as b1, type SweepTypedData as b2, TRANSFER_WITH_AUTHORIZATION_TYPES as b3, TYPED_DATA_NOT_ALLOWED as b4, type TaskBudgetCloseExpectation as b5, type TaskChildExpectation as b6, type TaskChildTypedData as b7, type UnsupportedNodeVersionMessageOptions as b8, X402AlreadySettledError as b9, createNextStepBuilder as bA, decodeBase64Json as bB, decodeBase64Utf8 as bC, defaultNextToolFor as bD, deriveDelegateAccountAddress as bE, encodeBase64Json as bF, encodeBase64Utf8 as bG, encodePaymentProof as bH, hashDelegation as bI, havenClientIdentity as bJ, isConnectorChannel as bK, isErc7710Option as bL, isPackedUserOperationTypedData as bM, isSupportedNodeVersion as bN, isSweepableChain as bO, isTaskChildTypedData as bP, normalizePaymentRequired as bQ, packedUserOperationHash as bR, parseNextTool as bS, parsePaymentRequired as bT, parsePaymentRequiredResponse as bU, readClientUpdate as bV, renderNextTool as bW, resolveConnectorChannel as bX, resolveTokenFromAddress as bY, selectErc7710PaymentOption as bZ, selectPaymentOption as b_, type X402ExpectedAuth as ba, type X402ExpectedContext as bb, type X402PaymentHeaderContext as bc, X402PaymentHeaderValidationError as bd, type X402PaymentOption as be, type X402RequestSnapshot as bf, type X402SchemeSelection as bg, X402TaskBudgetMismatchError as bh, X402UnexpectedStatusError as bi, X402_LEGACY_PAYMENT_HEADER_NAME as bj, X402_MAX_AUTHORIZATION_WINDOW_SECONDS as bk, X402_PAYMENT_HEADER_NAME as bl, X402_PAYMENT_HEADER_NAMES_SENT as bm, X402_PAYMENT_REQUIRED_HEADER_NAME as bn, X402_PAYMENT_RESPONSE_HEADER_NAME as bo, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS as bp, assertBoundDirectPaymentUserOp as bq, assertOwnTaskBudgetCloseUserOp as br, assertOwnTaskChild as bs, assertUserOpTypedDataBinding as bt, buildSweepAuthorizationMessage as bu, buildSweepTypedData as bv, buildX402ExpectedMessage as bw, compareNodeVersions as bx, connectorRerunCommand as by, connectorSpec as bz, type PaymentIntent as c, selectX402SettlementScheme as c0, signerUpdateFallback as c1, sweepUsdcAddress as c2, sweepUsdcDomain as c3, toStandardPaymentRequirements as c4, unsupportedNodeVersionMessage as c5, validateStandardX402PaymentHeader as c6, verifySettlementChild as c7, x402AssetTransferMethod as c8, x402AuthorizationAmount as c9, x402FacilitatorAddresses as ca, x402V2PaymentEnvelope as cb, CAVEAT_ENFORCERS as cc, CAVEAT_TYPEHASH as cd, DELEGATION_MANAGER as ce, DELEGATION_TYPEHASH as cf, DIRECT_PAYMENT_CHAIN_IDS as cg, type DelegationForHashing as ch, EXECUTE_ABI as ci, HYBRID_DELEGATOR_IMPLEMENTATION as cj, MAX_SETTLEMENT_WINDOW_SECONDS as ck, SIMPLE_FACTORY_ADDRESS as cl, type SettlementChildTypedData as cm, assertFundingLegPaysDelegate as cn, assertOwnSettlementChild as co, chainIdForNetwork as cp, isSettlementChildTypedData as cq, type X402AuthorizationOptions as d, type X402Intent as e, type PaymentStatusResult as f, type HavenAgent as g, type HavenAgentSummary as h, type SweepPrepareResponse as i, type SweepAuthorization as j, type SweepSubmitResponse as k, type HavenAllowanceSummary as l, type HavenBalanceCoverage as m, type PostPurchaseAllowanceSummary as n, type HavenCatalogEntry as o, type HavenCatalogSubmission as p, type HavenPaymentReceipt as q, type HavenPaymentReceiptsPage as r, type HavenTaskBudget as s, type SubmitTaskBudgetResult as t, type PaymentResumeState as u, type X402Receipt as v, type X402Quote as w, type X402Erc7710Settlement as x, type X402McpCallContext as y, type SignData as z };

package/dist/{chunk-XCC2QYHC.js → chunk-BVNBYB7Q.js}

@@ -1,4 +1,4 @@
-import { HavenSigningError, deriveDelegateAccountAddress, DELEGATION_MANAGER, assertRedeemsOwnBudgetDelegation, verifySettlementChild, REDEEM_DELEGATIONS_ABI, ROOT_AUTHORITY, CAVEAT_ENFORCERS, DELEGATION_TUPLE_COMPONENTS } from './chunk-KNUEZ5LH.js';
+import { HavenSigningError, deriveDelegateAccountAddress, DELEGATION_MANAGER, assertRedeemsOwnBudgetDelegation, verifySettlementChild, REDEEM_DELEGATIONS_ABI, ROOT_AUTHORITY, CAVEAT_ENFORCERS, DELEGATION_TUPLE_COMPONENTS } from './chunk-USEZLMWK.js';
 import { decodeFunctionData, encodeFunctionData, encodePacked, recoverTypedDataAddress, encodeAbiParameters, keccak256 } from 'viem';
 import { createHash } from 'crypto';
 
@@ -777,7 +777,7 @@ function stableStringify2(value) {
 }
 
 // src/client-identity.ts
-var SDK_VERSION = "0.0.0-dev.202609261556.90c27a2";
+var SDK_VERSION = "0.0.0-dev.202609272032.679e797";
 var HAVEN_CLIENT_HEADER = "X-Haven-Client";
 function havenClientIdentity(pkg, version) {
   return `${pkg}/${version}`;
@@ -1207,5 +1207,5 @@ function hashDelegation(delegation) {
 }
 
 export { CAVEAT_TYPEHASH, DEFAULT_NEXT_TOOL_BY_ACTION, DELEGATION_TYPEHASH, DIRECT_PAYMENT_CHAIN_IDS, ERC7710_ASSET_TRANSFER_METHOD, EXECUTE_ABI, HAVEN_CLIENT_HEADER, HAVEN_MINIMUM_NODE_VERSION, HavenTypedDataRefusedError, MAX_TASK_BUDGET_TTL_SECONDS, NEXT_TOOL_SERVER_NAMES, NEXT_TOOL_SERVER_ROLES, SDK_CLIENT_IDENTITY, SDK_VERSION, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, TRANSFER_WITH_AUTHORIZATION_TYPES, TYPED_DATA_NOT_ALLOWED, X402PaymentHeaderValidationError, X402_LEGACY_PAYMENT_HEADER_NAME, X402_MAX_AUTHORIZATION_WINDOW_SECONDS, X402_PAYMENT_HEADER_NAME, X402_PAYMENT_HEADER_NAMES, X402_PAYMENT_HEADER_NAMES_SENT, X402_PAYMENT_REQUIRED_HEADER_NAME, X402_PAYMENT_RESPONSE_HEADER_NAME, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, assertBoundDirectPaymentUserOp, assertFundingLegPaysDelegate, assertOwnSettlementChild, assertOwnTaskBudgetCloseUserOp, assertOwnTaskChild, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, buildX402IdempotencyKey, compareNodeVersions, createNextStepBuilder, decodeBase64Json, decodeBase64Utf8, defaultNextToolFor, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, hashDelegation, havenClientIdentity, isErc7710Option, isSupportedNodeVersion, isSweepableChain, isTaskChildTypedData, normalizePaymentRequired, parseNextTool, parsePaymentRequired, parsePaymentRequiredResponse, readClientUpdate, renderNextTool, resolveTokenFromAddress, selectErc7710PaymentOption, selectPaymentOption, selectStandardPaymentOption, selectX402SettlementScheme, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, unsupportedNodeVersionMessage, validateStandardX402PaymentHeader, x402AssetTransferMethod, x402AuthorizationAmount, x402FacilitatorAddresses, x402PaymentHeaderNamesFor, x402PaymentHeaderNamesSent, x402V2PaymentEnvelope };
-//# sourceMappingURL=chunk-XCC2QYHC.js.map
-//# sourceMappingURL=chunk-XCC2QYHC.js.map
+//# sourceMappingURL=chunk-BVNBYB7Q.js.map
+//# sourceMappingURL=chunk-BVNBYB7Q.js.map