@haven_ai/sdk 0.0.0-dev.202609250737.3bd5a51 → 0.0.0-dev.202609251409.98ed67a

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { R as RawPaymentParties, H as HavenClientConfig, P as PaymentRequest, a as PaymentResult, b as PaymentIntent, X as X402PaymentRequired, c as X402AuthorizationOptions, d as X402Intent, e as PaymentStatusResult, f as HavenAgent, g as HavenAgentSummary, S as SweepResult, h as SweepPrepareResponse, i as SweepAuthorization, j as SweepSubmitResponse, k as HavenAllowanceSummary, l as HavenBalanceCoverage, m as PostPurchaseAllowanceSummary, A as AgentPaymentWarning, n as HavenCatalogEntry, o as HavenCatalogSubmission, p as HavenPaymentReceipt, q as HavenPaymentReceiptsPage, r as PaymentResumeState, s as X402Receipt, t as X402Quote, u as X402Erc7710Settlement, v as X402McpCallContext, w as SignData, x as ResumeAuthorizedX402Input, y as ResumeX402PaymentInput, z as X402ResumeState, B as X402McpTransport, C as X402MerchantCallContext, D as HavenError } from './base64-Bw0qBf6v.cjs';
-export { E as AGENT_PAYMENT_FAILURE_CODE_VALUES, F as AGENT_PAYMENT_NEXT_ACTION_VALUES, G as AGENT_PAYMENT_PHASE_VALUES, I as AGENT_PAYMENT_RAIL_VALUES, J as AgentNextStep, K as AgentPaymentEnumSchema, L as AgentPaymentFailureCode, M as AgentPaymentFailureCodeDescriptions, N as AgentPaymentFailureCodeSchema, O as AgentPaymentNextAction, Q as AgentPaymentNextActionDescriptions, T as AgentPaymentNextActionSchema, U as AgentPaymentPhase, V as AgentPaymentPhaseDescriptions, W as AgentPaymentPhaseSchema, Y as AgentPaymentRail, Z as AgentPaymentRailDescriptions, _ as AgentPaymentRailSchema, $ as AgentPaymentSummary, a0 as AgentPaymentWarningCode, a1 as AgentPurchaseSummary, a2 as CONNECTOR_PACKAGE_NAME, a3 as CatalogSubmissionAccepted, a4 as DEFAULT_CONFIRMATION_TIMEOUT_MS, a5 as DEFAULT_NEXT_TOOL_BY_ACTION, a6 as DIRECT_SIGN_CONTEXT_VERSION, a7 as ENTRY_POINT_V07, a8 as ERC7710_ASSET_TRANSFER_METHOD, a9 as HAVEN_CONNECTOR_CHANNEL, aa as HAVEN_MINIMUM_NODE_VERSION, ab as HYBRID_DELEGATOR_DOMAIN_NAME, ac as HYBRID_DELEGATOR_DOMAIN_VERSION, ad as HavenAgentAllowanceSummary, ae as HavenAgentReadiness, af as HavenAllowance, ag as HavenApiError, ah as HavenCatalogMerchant, ai as HavenListScope, aj as HavenPaymentStateError, ak as HavenSigningError, al as HavenTimeoutError, am as HavenTypedDataRefusedError, an as HavenUnsupportedSignerVersionError, ao as HavenUserOpBindingError, ap as HavenZeroSettlementHashError, aq as MachinePaymentRail, ar as MerchantTimeoutError, as as NEXT_TOOL_SERVER_NAMES, at as NEXT_TOOL_SERVER_ROLES, au as NextStep, av as NextStepArguments, aw as NextStepHandoff, ax as NextStepInput, ay as NextStepTarget, az as NextStepTargets, aA as NextToolServerRole, aB as PACKED_USER_OPERATION_FIELDS, aC as PaymentFee, aD as PaymentNextAction, aE as PaymentPhase, aF as PaymentStatus, aG as ROOT_AUTHORITY, aH as SIGNER_UPDATE_FALLBACK, aI as SWEEP_BASE_CHAIN_ID, aJ as SWEEP_BASE_SEPOLIA_CHAIN_ID, aK as SWEEP_BASE_SEPOLIA_USDC_ADDRESS, aL as SWEEP_BASE_USDC_ADDRESS, aM as SettlementChildExpectation, aN as SignerRefusalCode, aO as SweepConfirmation, aP as SweepEip712Domain, aQ as SweepEntry, aR as SweepExpectedAuth, aS as SweepPreparation, aT as SweepSubmitResult, aU as SweepTypedData, aV as TRANSFER_WITH_AUTHORIZATION_TYPES, aW as TYPED_DATA_NOT_ALLOWED, aX as UnsupportedNodeVersionMessageOptions, aY as X402AlreadySettledError, aZ as X402ExpectedAuth, a_ as X402ExpectedContext, a$ as X402PaymentHeaderContext, b0 as X402PaymentHeaderValidationError, b1 as X402PaymentOption, b2 as X402RequestSnapshot, b3 as X402SchemeSelection, b4 as X402UnexpectedStatusError, b5 as X402_LEGACY_PAYMENT_HEADER_NAME, b6 as X402_MAX_AUTHORIZATION_WINDOW_SECONDS, b7 as X402_PAYMENT_HEADER_NAME, b8 as X402_PAYMENT_HEADER_NAMES_SENT, b9 as X402_PAYMENT_REQUIRED_HEADER_NAME, ba as X402_PAYMENT_RESPONSE_HEADER_NAME, bb as X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, bc as assertBoundDirectPaymentUserOp, bd as assertUserOpTypedDataBinding, be as buildSweepAuthorizationMessage, bf as buildSweepTypedData, bg as buildX402ExpectedMessage, bh as compareNodeVersions, bi as connectorRerunCommand, bj as connectorSpec, bk as createNextStepBuilder, bl as decodeBase64Json, bm as decodeBase64Utf8, bn as defaultNextToolFor, bo as deriveDelegateAccountAddress, bp as encodeBase64Json, bq as encodeBase64Utf8, br as encodePaymentProof, bs as isConnectorChannel, bt as isErc7710Option, bu as isPackedUserOperationTypedData, bv as isSupportedNodeVersion, bw as isSweepableChain, bx as normalizePaymentRequired, by as packedUserOperationHash, bz as parseNextTool, bA as parsePaymentRequired, bB as parsePaymentRequiredResponse, bC as renderNextTool, bD as resolveConnectorChannel, bE as resolveTokenFromAddress, bF as selectErc7710PaymentOption, bG as selectPaymentOption, bH as selectStandardPaymentOption, bI as selectX402SettlementScheme, bJ as signerUpdateFallback, bK as sweepUsdcAddress, bL as sweepUsdcDomain, bM as toStandardPaymentRequirements, bN as unsupportedNodeVersionMessage, bO as validateStandardX402PaymentHeader, bP as verifySettlementChild, bQ as x402AssetTransferMethod, bR as x402AuthorizationAmount, bS as x402FacilitatorAddresses, bT as x402V2PaymentEnvelope } from './base64-Bw0qBf6v.cjs';
+import { R as RawPaymentParties, H as HavenClientConfig, a as HavenClientUpdate, P as PaymentRequest, b as PaymentResult, c as PaymentIntent, X as X402PaymentRequired, d as X402AuthorizationOptions, e as X402Intent, f as PaymentStatusResult, g as HavenAgent, h as HavenAgentSummary, S as SweepResult, i as SweepPrepareResponse, j as SweepAuthorization, k as SweepSubmitResponse, l as HavenAllowanceSummary, m as HavenBalanceCoverage, n as PostPurchaseAllowanceSummary, A as AgentPaymentWarning, o as HavenCatalogEntry, p as HavenCatalogSubmission, q as HavenPaymentReceipt, r as HavenPaymentReceiptsPage, s as PaymentResumeState, t as X402Receipt, u as X402Quote, v as X402Erc7710Settlement, w as X402McpCallContext, x as SignData, y as ResumeAuthorizedX402Input, z as ResumeX402PaymentInput, B as X402ResumeState, C as X402McpTransport, D as X402MerchantCallContext, E as HavenError } from './base64-Dm78eUFX.cjs';
+export { F as AGENT_PAYMENT_FAILURE_CODE_VALUES, G as AGENT_PAYMENT_NEXT_ACTION_VALUES, I as AGENT_PAYMENT_PHASE_VALUES, J as AGENT_PAYMENT_RAIL_VALUES, K as AgentNextStep, L as AgentPaymentEnumSchema, M as AgentPaymentFailureCode, N as AgentPaymentFailureCodeDescriptions, O as AgentPaymentFailureCodeSchema, Q as AgentPaymentNextAction, T as AgentPaymentNextActionDescriptions, U as AgentPaymentNextActionSchema, V as AgentPaymentPhase, W as AgentPaymentPhaseDescriptions, Y as AgentPaymentPhaseSchema, Z as AgentPaymentRail, _ as AgentPaymentRailDescriptions, $ as AgentPaymentRailSchema, a0 as AgentPaymentSummary, a1 as AgentPaymentWarningCode, a2 as AgentPurchaseSummary, a3 as CONNECTOR_PACKAGE_NAME, a4 as CatalogSubmissionAccepted, a5 as DEFAULT_CONFIRMATION_TIMEOUT_MS, a6 as DEFAULT_NEXT_TOOL_BY_ACTION, a7 as DIRECT_SIGN_CONTEXT_VERSION, a8 as ENTRY_POINT_V07, a9 as ERC7710_ASSET_TRANSFER_METHOD, aa as HAVEN_CLIENT_HEADER, ab as HAVEN_CONNECTOR_CHANNEL, ac as HAVEN_MINIMUM_NODE_VERSION, ad as HYBRID_DELEGATOR_DOMAIN_NAME, ae as HYBRID_DELEGATOR_DOMAIN_VERSION, af as HavenAgentAllowanceSummary, ag as HavenAgentReadiness, ah as HavenAllowance, ai as HavenApiError, aj as HavenCatalogMerchant, ak as HavenListScope, al as HavenPaymentStateError, am as HavenSigningError, an as HavenTimeoutError, ao as HavenTypedDataRefusedError, ap as HavenUnsupportedSignerVersionError, aq as HavenUserOpBindingError, ar as HavenZeroSettlementHashError, as as MachinePaymentRail, at as MerchantTimeoutError, au as NEXT_TOOL_SERVER_NAMES, av as NEXT_TOOL_SERVER_ROLES, aw as NextStep, ax as NextStepArguments, ay as NextStepHandoff, az as NextStepInput, aA as NextStepTarget, aB as NextStepTargets, aC as NextToolServerRole, aD as PACKED_USER_OPERATION_FIELDS, aE as PaymentFee, aF as PaymentNextAction, aG as PaymentPhase, aH as PaymentStatus, aI as ROOT_AUTHORITY, aJ as SDK_CLIENT_IDENTITY, aK as SDK_VERSION, aL as SIGNER_UPDATE_FALLBACK, aM as SWEEP_BASE_CHAIN_ID, aN as SWEEP_BASE_SEPOLIA_CHAIN_ID, aO as SWEEP_BASE_SEPOLIA_USDC_ADDRESS, aP as SWEEP_BASE_USDC_ADDRESS, aQ as SettlementChildExpectation, aR as SignerRefusalCode, aS as SweepConfirmation, aT as SweepEip712Domain, aU as SweepEntry, aV as SweepExpectedAuth, aW as SweepPreparation, aX as SweepSubmitResult, aY as SweepTypedData, aZ as TRANSFER_WITH_AUTHORIZATION_TYPES, a_ as TYPED_DATA_NOT_ALLOWED, a$ as UnsupportedNodeVersionMessageOptions, b0 as X402AlreadySettledError, b1 as X402ExpectedAuth, b2 as X402ExpectedContext, b3 as X402PaymentHeaderContext, b4 as X402PaymentHeaderValidationError, b5 as X402PaymentOption, b6 as X402RequestSnapshot, b7 as X402SchemeSelection, b8 as X402UnexpectedStatusError, b9 as X402_LEGACY_PAYMENT_HEADER_NAME, ba as X402_MAX_AUTHORIZATION_WINDOW_SECONDS, bb as X402_PAYMENT_HEADER_NAME, bc as X402_PAYMENT_HEADER_NAMES_SENT, bd as X402_PAYMENT_REQUIRED_HEADER_NAME, be as X402_PAYMENT_RESPONSE_HEADER_NAME, bf as X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, bg as assertBoundDirectPaymentUserOp, bh as assertUserOpTypedDataBinding, bi as buildSweepAuthorizationMessage, bj as buildSweepTypedData, bk as buildX402ExpectedMessage, bl as compareNodeVersions, bm as connectorRerunCommand, bn as connectorSpec, bo as createNextStepBuilder, bp as decodeBase64Json, bq as decodeBase64Utf8, br as defaultNextToolFor, bs as deriveDelegateAccountAddress, bt as encodeBase64Json, bu as encodeBase64Utf8, bv as encodePaymentProof, bw as havenClientIdentity, bx as isConnectorChannel, by as isErc7710Option, bz as isPackedUserOperationTypedData, bA as isSupportedNodeVersion, bB as isSweepableChain, bC as normalizePaymentRequired, bD as packedUserOperationHash, bE as parseNextTool, bF as parsePaymentRequired, bG as parsePaymentRequiredResponse, bH as readClientUpdate, bI as renderNextTool, bJ as resolveConnectorChannel, bK as resolveTokenFromAddress, bL as selectErc7710PaymentOption, bM as selectPaymentOption, bN as selectStandardPaymentOption, bO as selectX402SettlementScheme, bP as signerUpdateFallback, bQ as sweepUsdcAddress, bR as sweepUsdcDomain, bS as toStandardPaymentRequirements, bT as unsupportedNodeVersionMessage, bU as validateStandardX402PaymentHeader, bV as verifySettlementChild, bW as x402AssetTransferMethod, bX as x402AuthorizationAmount, bY as x402FacilitatorAddresses, bZ as x402V2PaymentEnvelope } from './base64-Dm78eUFX.cjs';
 import 'x402/types';
 import 'viem';
 
@@ -178,6 +178,13 @@ declare class HavenClient {
      * context.
      */
     withRequestContext<T>(headers: Record<string, string>, fn: () => Promise<T>): Promise<T>;
+    /**
+     * The backend's newest `client_update` hint for this client (#3303): inside
+     * a `withRequestContext` dispatch, the one that dispatch's own requests
+     * received; outside one, the latest seen. Undefined when the client is
+     * current or the backend predates #3303.
+     */
+    clientUpdate(): HavenClientUpdate | undefined;
     /**
      * Send a payment in one call.
      *
@@ -1340,4 +1347,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_APPROVAL_RELAY_JSON_SENTENCE, AGENT_APPROVAL_RELAY_PROSE_SENTENCE, AGENT_COMMAND_MODIFICATION_SENTENCE, AGENT_JSON_MODE_SENTENCE, AGENT_LOCAL_KEY_SENTENCE, AGENT_NETWORK_ACCESS_SENTENCE, AGENT_ONBOARDING_PROMPT, AGENT_README_SECTION_MD, AGENT_SECRET_HYGIENE_SENTENCE, AGENT_WIRING_COLLISION_RELAY_SENTENCE, AgentPaymentWarning, type ClaudeTool, DISCOVERY_MAX_BYTES, type EvidenceReportOutcome, HAVEN_AGENT_RUNBOOK_MD, HAVEN_SKILL_BODY_MD, HAVEN_SKILL_MD, HavenAgent, HavenAgentSummary, HavenAllowanceSummary, HavenBalanceCoverage, HavenCatalogEntry, HavenCatalogSubmission, HavenClient, HavenClientConfig, HavenError, HavenInsecureRetryTargetError, HavenPaymentReceipt, HavenPaymentReceiptsPage, INSECURE_RETRY_TARGET_CODE, MERCHANT_DISCOVERY_PATHS, type OpenAITool, PaymentIntent, type PaymentReceipt, PaymentRequest, PaymentResult, PaymentResumeState, PaymentStatusResult, PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, ResumeAuthorizedX402Input, ResumeX402PaymentInput, SKILL_FOLDER_NAME, type SharedToolKey, SignData, SweepAuthorization, SweepPrepareResponse, SweepResult, SweepSubmitResponse, type ToolDescription, X402AuthorizationOptions, X402Erc7710Settlement, X402Intent, X402McpCallContext, X402McpTransport, X402MerchantCallContext, type X402MerchantOutcome, type X402MerchantOutcomeReport, X402PaymentRequired, X402Quote, X402Receipt, X402ResumeState, type X402RetryTarget, addressFromKey, assertSecureX402RetryTarget, composeDescription, discoverMerchantMcpUrl, havenTools, isSecureX402RetryTarget, isZeroSettlementTxHash, readX402ReceiptPayer, resolveX402RetryTarget, sameUrl, signHash, signUserOpTypedDataForDelegation, toolDescriptions, verifyPaymentReceipt, verifySignature };
+export { AGENT_APPROVAL_RELAY_JSON_SENTENCE, AGENT_APPROVAL_RELAY_PROSE_SENTENCE, AGENT_COMMAND_MODIFICATION_SENTENCE, AGENT_JSON_MODE_SENTENCE, AGENT_LOCAL_KEY_SENTENCE, AGENT_NETWORK_ACCESS_SENTENCE, AGENT_ONBOARDING_PROMPT, AGENT_README_SECTION_MD, AGENT_SECRET_HYGIENE_SENTENCE, AGENT_WIRING_COLLISION_RELAY_SENTENCE, AgentPaymentWarning, type ClaudeTool, DISCOVERY_MAX_BYTES, type EvidenceReportOutcome, HAVEN_AGENT_RUNBOOK_MD, HAVEN_SKILL_BODY_MD, HAVEN_SKILL_MD, HavenAgent, HavenAgentSummary, HavenAllowanceSummary, HavenBalanceCoverage, HavenCatalogEntry, HavenCatalogSubmission, HavenClient, HavenClientConfig, HavenClientUpdate, HavenError, HavenInsecureRetryTargetError, HavenPaymentReceipt, HavenPaymentReceiptsPage, INSECURE_RETRY_TARGET_CODE, MERCHANT_DISCOVERY_PATHS, type OpenAITool, PaymentIntent, type PaymentReceipt, PaymentRequest, PaymentResult, PaymentResumeState, PaymentStatusResult, PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, ResumeAuthorizedX402Input, ResumeX402PaymentInput, SKILL_FOLDER_NAME, type SharedToolKey, SignData, SweepAuthorization, SweepPrepareResponse, SweepResult, SweepSubmitResponse, type ToolDescription, X402AuthorizationOptions, X402Erc7710Settlement, X402Intent, X402McpCallContext, X402McpTransport, X402MerchantCallContext, type X402MerchantOutcome, type X402MerchantOutcomeReport, X402PaymentRequired, X402Quote, X402Receipt, X402ResumeState, type X402RetryTarget, addressFromKey, assertSecureX402RetryTarget, composeDescription, discoverMerchantMcpUrl, havenTools, isSecureX402RetryTarget, isZeroSettlementTxHash, readX402ReceiptPayer, resolveX402RetryTarget, sameUrl, signHash, signUserOpTypedDataForDelegation, toolDescriptions, verifyPaymentReceipt, verifySignature };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as RawPaymentParties, H as HavenClientConfig, P as PaymentRequest, a as PaymentResult, b as PaymentIntent, X as X402PaymentRequired, c as X402AuthorizationOptions, d as X402Intent, e as PaymentStatusResult, f as HavenAgent, g as HavenAgentSummary, S as SweepResult, h as SweepPrepareResponse, i as SweepAuthorization, j as SweepSubmitResponse, k as HavenAllowanceSummary, l as HavenBalanceCoverage, m as PostPurchaseAllowanceSummary, A as AgentPaymentWarning, n as HavenCatalogEntry, o as HavenCatalogSubmission, p as HavenPaymentReceipt, q as HavenPaymentReceiptsPage, r as PaymentResumeState, s as X402Receipt, t as X402Quote, u as X402Erc7710Settlement, v as X402McpCallContext, w as SignData, x as ResumeAuthorizedX402Input, y as ResumeX402PaymentInput, z as X402ResumeState, B as X402McpTransport, C as X402MerchantCallContext, D as HavenError } from './base64-Bw0qBf6v.js';
-export { E as AGENT_PAYMENT_FAILURE_CODE_VALUES, F as AGENT_PAYMENT_NEXT_ACTION_VALUES, G as AGENT_PAYMENT_PHASE_VALUES, I as AGENT_PAYMENT_RAIL_VALUES, J as AgentNextStep, K as AgentPaymentEnumSchema, L as AgentPaymentFailureCode, M as AgentPaymentFailureCodeDescriptions, N as AgentPaymentFailureCodeSchema, O as AgentPaymentNextAction, Q as AgentPaymentNextActionDescriptions, T as AgentPaymentNextActionSchema, U as AgentPaymentPhase, V as AgentPaymentPhaseDescriptions, W as AgentPaymentPhaseSchema, Y as AgentPaymentRail, Z as AgentPaymentRailDescriptions, _ as AgentPaymentRailSchema, $ as AgentPaymentSummary, a0 as AgentPaymentWarningCode, a1 as AgentPurchaseSummary, a2 as CONNECTOR_PACKAGE_NAME, a3 as CatalogSubmissionAccepted, a4 as DEFAULT_CONFIRMATION_TIMEOUT_MS, a5 as DEFAULT_NEXT_TOOL_BY_ACTION, a6 as DIRECT_SIGN_CONTEXT_VERSION, a7 as ENTRY_POINT_V07, a8 as ERC7710_ASSET_TRANSFER_METHOD, a9 as HAVEN_CONNECTOR_CHANNEL, aa as HAVEN_MINIMUM_NODE_VERSION, ab as HYBRID_DELEGATOR_DOMAIN_NAME, ac as HYBRID_DELEGATOR_DOMAIN_VERSION, ad as HavenAgentAllowanceSummary, ae as HavenAgentReadiness, af as HavenAllowance, ag as HavenApiError, ah as HavenCatalogMerchant, ai as HavenListScope, aj as HavenPaymentStateError, ak as HavenSigningError, al as HavenTimeoutError, am as HavenTypedDataRefusedError, an as HavenUnsupportedSignerVersionError, ao as HavenUserOpBindingError, ap as HavenZeroSettlementHashError, aq as MachinePaymentRail, ar as MerchantTimeoutError, as as NEXT_TOOL_SERVER_NAMES, at as NEXT_TOOL_SERVER_ROLES, au as NextStep, av as NextStepArguments, aw as NextStepHandoff, ax as NextStepInput, ay as NextStepTarget, az as NextStepTargets, aA as NextToolServerRole, aB as PACKED_USER_OPERATION_FIELDS, aC as PaymentFee, aD as PaymentNextAction, aE as PaymentPhase, aF as PaymentStatus, aG as ROOT_AUTHORITY, aH as SIGNER_UPDATE_FALLBACK, aI as SWEEP_BASE_CHAIN_ID, aJ as SWEEP_BASE_SEPOLIA_CHAIN_ID, aK as SWEEP_BASE_SEPOLIA_USDC_ADDRESS, aL as SWEEP_BASE_USDC_ADDRESS, aM as SettlementChildExpectation, aN as SignerRefusalCode, aO as SweepConfirmation, aP as SweepEip712Domain, aQ as SweepEntry, aR as SweepExpectedAuth, aS as SweepPreparation, aT as SweepSubmitResult, aU as SweepTypedData, aV as TRANSFER_WITH_AUTHORIZATION_TYPES, aW as TYPED_DATA_NOT_ALLOWED, aX as UnsupportedNodeVersionMessageOptions, aY as X402AlreadySettledError, aZ as X402ExpectedAuth, a_ as X402ExpectedContext, a$ as X402PaymentHeaderContext, b0 as X402PaymentHeaderValidationError, b1 as X402PaymentOption, b2 as X402RequestSnapshot, b3 as X402SchemeSelection, b4 as X402UnexpectedStatusError, b5 as X402_LEGACY_PAYMENT_HEADER_NAME, b6 as X402_MAX_AUTHORIZATION_WINDOW_SECONDS, b7 as X402_PAYMENT_HEADER_NAME, b8 as X402_PAYMENT_HEADER_NAMES_SENT, b9 as X402_PAYMENT_REQUIRED_HEADER_NAME, ba as X402_PAYMENT_RESPONSE_HEADER_NAME, bb as X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, bc as assertBoundDirectPaymentUserOp, bd as assertUserOpTypedDataBinding, be as buildSweepAuthorizationMessage, bf as buildSweepTypedData, bg as buildX402ExpectedMessage, bh as compareNodeVersions, bi as connectorRerunCommand, bj as connectorSpec, bk as createNextStepBuilder, bl as decodeBase64Json, bm as decodeBase64Utf8, bn as defaultNextToolFor, bo as deriveDelegateAccountAddress, bp as encodeBase64Json, bq as encodeBase64Utf8, br as encodePaymentProof, bs as isConnectorChannel, bt as isErc7710Option, bu as isPackedUserOperationTypedData, bv as isSupportedNodeVersion, bw as isSweepableChain, bx as normalizePaymentRequired, by as packedUserOperationHash, bz as parseNextTool, bA as parsePaymentRequired, bB as parsePaymentRequiredResponse, bC as renderNextTool, bD as resolveConnectorChannel, bE as resolveTokenFromAddress, bF as selectErc7710PaymentOption, bG as selectPaymentOption, bH as selectStandardPaymentOption, bI as selectX402SettlementScheme, bJ as signerUpdateFallback, bK as sweepUsdcAddress, bL as sweepUsdcDomain, bM as toStandardPaymentRequirements, bN as unsupportedNodeVersionMessage, bO as validateStandardX402PaymentHeader, bP as verifySettlementChild, bQ as x402AssetTransferMethod, bR as x402AuthorizationAmount, bS as x402FacilitatorAddresses, bT as x402V2PaymentEnvelope } from './base64-Bw0qBf6v.js';
+import { R as RawPaymentParties, H as HavenClientConfig, a as HavenClientUpdate, P as PaymentRequest, b as PaymentResult, c as PaymentIntent, X as X402PaymentRequired, d as X402AuthorizationOptions, e as X402Intent, f as PaymentStatusResult, g as HavenAgent, h as HavenAgentSummary, S as SweepResult, i as SweepPrepareResponse, j as SweepAuthorization, k as SweepSubmitResponse, l as HavenAllowanceSummary, m as HavenBalanceCoverage, n as PostPurchaseAllowanceSummary, A as AgentPaymentWarning, o as HavenCatalogEntry, p as HavenCatalogSubmission, q as HavenPaymentReceipt, r as HavenPaymentReceiptsPage, s as PaymentResumeState, t as X402Receipt, u as X402Quote, v as X402Erc7710Settlement, w as X402McpCallContext, x as SignData, y as ResumeAuthorizedX402Input, z as ResumeX402PaymentInput, B as X402ResumeState, C as X402McpTransport, D as X402MerchantCallContext, E as HavenError } from './base64-Dm78eUFX.js';
+export { F as AGENT_PAYMENT_FAILURE_CODE_VALUES, G as AGENT_PAYMENT_NEXT_ACTION_VALUES, I as AGENT_PAYMENT_PHASE_VALUES, J as AGENT_PAYMENT_RAIL_VALUES, K as AgentNextStep, L as AgentPaymentEnumSchema, M as AgentPaymentFailureCode, N as AgentPaymentFailureCodeDescriptions, O as AgentPaymentFailureCodeSchema, Q as AgentPaymentNextAction, T as AgentPaymentNextActionDescriptions, U as AgentPaymentNextActionSchema, V as AgentPaymentPhase, W as AgentPaymentPhaseDescriptions, Y as AgentPaymentPhaseSchema, Z as AgentPaymentRail, _ as AgentPaymentRailDescriptions, $ as AgentPaymentRailSchema, a0 as AgentPaymentSummary, a1 as AgentPaymentWarningCode, a2 as AgentPurchaseSummary, a3 as CONNECTOR_PACKAGE_NAME, a4 as CatalogSubmissionAccepted, a5 as DEFAULT_CONFIRMATION_TIMEOUT_MS, a6 as DEFAULT_NEXT_TOOL_BY_ACTION, a7 as DIRECT_SIGN_CONTEXT_VERSION, a8 as ENTRY_POINT_V07, a9 as ERC7710_ASSET_TRANSFER_METHOD, aa as HAVEN_CLIENT_HEADER, ab as HAVEN_CONNECTOR_CHANNEL, ac as HAVEN_MINIMUM_NODE_VERSION, ad as HYBRID_DELEGATOR_DOMAIN_NAME, ae as HYBRID_DELEGATOR_DOMAIN_VERSION, af as HavenAgentAllowanceSummary, ag as HavenAgentReadiness, ah as HavenAllowance, ai as HavenApiError, aj as HavenCatalogMerchant, ak as HavenListScope, al as HavenPaymentStateError, am as HavenSigningError, an as HavenTimeoutError, ao as HavenTypedDataRefusedError, ap as HavenUnsupportedSignerVersionError, aq as HavenUserOpBindingError, ar as HavenZeroSettlementHashError, as as MachinePaymentRail, at as MerchantTimeoutError, au as NEXT_TOOL_SERVER_NAMES, av as NEXT_TOOL_SERVER_ROLES, aw as NextStep, ax as NextStepArguments, ay as NextStepHandoff, az as NextStepInput, aA as NextStepTarget, aB as NextStepTargets, aC as NextToolServerRole, aD as PACKED_USER_OPERATION_FIELDS, aE as PaymentFee, aF as PaymentNextAction, aG as PaymentPhase, aH as PaymentStatus, aI as ROOT_AUTHORITY, aJ as SDK_CLIENT_IDENTITY, aK as SDK_VERSION, aL as SIGNER_UPDATE_FALLBACK, aM as SWEEP_BASE_CHAIN_ID, aN as SWEEP_BASE_SEPOLIA_CHAIN_ID, aO as SWEEP_BASE_SEPOLIA_USDC_ADDRESS, aP as SWEEP_BASE_USDC_ADDRESS, aQ as SettlementChildExpectation, aR as SignerRefusalCode, aS as SweepConfirmation, aT as SweepEip712Domain, aU as SweepEntry, aV as SweepExpectedAuth, aW as SweepPreparation, aX as SweepSubmitResult, aY as SweepTypedData, aZ as TRANSFER_WITH_AUTHORIZATION_TYPES, a_ as TYPED_DATA_NOT_ALLOWED, a$ as UnsupportedNodeVersionMessageOptions, b0 as X402AlreadySettledError, b1 as X402ExpectedAuth, b2 as X402ExpectedContext, b3 as X402PaymentHeaderContext, b4 as X402PaymentHeaderValidationError, b5 as X402PaymentOption, b6 as X402RequestSnapshot, b7 as X402SchemeSelection, b8 as X402UnexpectedStatusError, b9 as X402_LEGACY_PAYMENT_HEADER_NAME, ba as X402_MAX_AUTHORIZATION_WINDOW_SECONDS, bb as X402_PAYMENT_HEADER_NAME, bc as X402_PAYMENT_HEADER_NAMES_SENT, bd as X402_PAYMENT_REQUIRED_HEADER_NAME, be as X402_PAYMENT_RESPONSE_HEADER_NAME, bf as X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, bg as assertBoundDirectPaymentUserOp, bh as assertUserOpTypedDataBinding, bi as buildSweepAuthorizationMessage, bj as buildSweepTypedData, bk as buildX402ExpectedMessage, bl as compareNodeVersions, bm as connectorRerunCommand, bn as connectorSpec, bo as createNextStepBuilder, bp as decodeBase64Json, bq as decodeBase64Utf8, br as defaultNextToolFor, bs as deriveDelegateAccountAddress, bt as encodeBase64Json, bu as encodeBase64Utf8, bv as encodePaymentProof, bw as havenClientIdentity, bx as isConnectorChannel, by as isErc7710Option, bz as isPackedUserOperationTypedData, bA as isSupportedNodeVersion, bB as isSweepableChain, bC as normalizePaymentRequired, bD as packedUserOperationHash, bE as parseNextTool, bF as parsePaymentRequired, bG as parsePaymentRequiredResponse, bH as readClientUpdate, bI as renderNextTool, bJ as resolveConnectorChannel, bK as resolveTokenFromAddress, bL as selectErc7710PaymentOption, bM as selectPaymentOption, bN as selectStandardPaymentOption, bO as selectX402SettlementScheme, bP as signerUpdateFallback, bQ as sweepUsdcAddress, bR as sweepUsdcDomain, bS as toStandardPaymentRequirements, bT as unsupportedNodeVersionMessage, bU as validateStandardX402PaymentHeader, bV as verifySettlementChild, bW as x402AssetTransferMethod, bX as x402AuthorizationAmount, bY as x402FacilitatorAddresses, bZ as x402V2PaymentEnvelope } from './base64-Dm78eUFX.js';
 import 'x402/types';
 import 'viem';
 
@@ -178,6 +178,13 @@ declare class HavenClient {
      * context.
      */
     withRequestContext<T>(headers: Record<string, string>, fn: () => Promise<T>): Promise<T>;
+    /**
+     * The backend's newest `client_update` hint for this client (#3303): inside
+     * a `withRequestContext` dispatch, the one that dispatch's own requests
+     * received; outside one, the latest seen. Undefined when the client is
+     * current or the backend predates #3303.
+     */
+    clientUpdate(): HavenClientUpdate | undefined;
     /**
      * Send a payment in one call.
      *
@@ -1340,4 +1347,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_APPROVAL_RELAY_JSON_SENTENCE, AGENT_APPROVAL_RELAY_PROSE_SENTENCE, AGENT_COMMAND_MODIFICATION_SENTENCE, AGENT_JSON_MODE_SENTENCE, AGENT_LOCAL_KEY_SENTENCE, AGENT_NETWORK_ACCESS_SENTENCE, AGENT_ONBOARDING_PROMPT, AGENT_README_SECTION_MD, AGENT_SECRET_HYGIENE_SENTENCE, AGENT_WIRING_COLLISION_RELAY_SENTENCE, AgentPaymentWarning, type ClaudeTool, DISCOVERY_MAX_BYTES, type EvidenceReportOutcome, HAVEN_AGENT_RUNBOOK_MD, HAVEN_SKILL_BODY_MD, HAVEN_SKILL_MD, HavenAgent, HavenAgentSummary, HavenAllowanceSummary, HavenBalanceCoverage, HavenCatalogEntry, HavenCatalogSubmission, HavenClient, HavenClientConfig, HavenError, HavenInsecureRetryTargetError, HavenPaymentReceipt, HavenPaymentReceiptsPage, INSECURE_RETRY_TARGET_CODE, MERCHANT_DISCOVERY_PATHS, type OpenAITool, PaymentIntent, type PaymentReceipt, PaymentRequest, PaymentResult, PaymentResumeState, PaymentStatusResult, PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, ResumeAuthorizedX402Input, ResumeX402PaymentInput, SKILL_FOLDER_NAME, type SharedToolKey, SignData, SweepAuthorization, SweepPrepareResponse, SweepResult, SweepSubmitResponse, type ToolDescription, X402AuthorizationOptions, X402Erc7710Settlement, X402Intent, X402McpCallContext, X402McpTransport, X402MerchantCallContext, type X402MerchantOutcome, type X402MerchantOutcomeReport, X402PaymentRequired, X402Quote, X402Receipt, X402ResumeState, type X402RetryTarget, addressFromKey, assertSecureX402RetryTarget, composeDescription, discoverMerchantMcpUrl, havenTools, isSecureX402RetryTarget, isZeroSettlementTxHash, readX402ReceiptPayer, resolveX402RetryTarget, sameUrl, signHash, signUserOpTypedDataForDelegation, toolDescriptions, verifyPaymentReceipt, verifySignature };
+export { AGENT_APPROVAL_RELAY_JSON_SENTENCE, AGENT_APPROVAL_RELAY_PROSE_SENTENCE, AGENT_COMMAND_MODIFICATION_SENTENCE, AGENT_JSON_MODE_SENTENCE, AGENT_LOCAL_KEY_SENTENCE, AGENT_NETWORK_ACCESS_SENTENCE, AGENT_ONBOARDING_PROMPT, AGENT_README_SECTION_MD, AGENT_SECRET_HYGIENE_SENTENCE, AGENT_WIRING_COLLISION_RELAY_SENTENCE, AgentPaymentWarning, type ClaudeTool, DISCOVERY_MAX_BYTES, type EvidenceReportOutcome, HAVEN_AGENT_RUNBOOK_MD, HAVEN_SKILL_BODY_MD, HAVEN_SKILL_MD, HavenAgent, HavenAgentSummary, HavenAllowanceSummary, HavenBalanceCoverage, HavenCatalogEntry, HavenCatalogSubmission, HavenClient, HavenClientConfig, HavenClientUpdate, HavenError, HavenInsecureRetryTargetError, HavenPaymentReceipt, HavenPaymentReceiptsPage, INSECURE_RETRY_TARGET_CODE, MERCHANT_DISCOVERY_PATHS, type OpenAITool, PaymentIntent, type PaymentReceipt, PaymentRequest, PaymentResult, PaymentResumeState, PaymentStatusResult, PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, ResumeAuthorizedX402Input, ResumeX402PaymentInput, SKILL_FOLDER_NAME, type SharedToolKey, SignData, SweepAuthorization, SweepPrepareResponse, SweepResult, SweepSubmitResponse, type ToolDescription, X402AuthorizationOptions, X402Erc7710Settlement, X402Intent, X402McpCallContext, X402McpTransport, X402MerchantCallContext, type X402MerchantOutcome, type X402MerchantOutcomeReport, X402PaymentRequired, X402Quote, X402Receipt, X402ResumeState, type X402RetryTarget, addressFromKey, assertSecureX402RetryTarget, composeDescription, discoverMerchantMcpUrl, havenTools, isSecureX402RetryTarget, isZeroSettlementTxHash, readX402ReceiptPayer, resolveX402RetryTarget, sameUrl, signHash, signUserOpTypedDataForDelegation, toolDescriptions, verifyPaymentReceipt, verifySignature };

package/dist/index.js

@@ -1,7 +1,7 @@
-import { selectStandardPaymentOption, buildX402IdempotencyKey, x402AuthorizationAmount, assertBoundDirectPaymentUserOp, HavenTypedDataRefusedError, assertOwnSettlementChild, parsePaymentRequiredResponse, x402PaymentHeaderNamesSent, resolveTokenFromAddress, isSweepableChain, sweepUsdcAddress, x402PaymentHeaderNamesFor, X402_PAYMENT_HEADER_NAMES, toStandardPaymentRequirements, decodeBase64Json, encodeBase64Json, x402V2PaymentEnvelope, selectX402SettlementScheme, selectErc7710PaymentOption, isErc7710Option, x402AssetTransferMethod, normalizePaymentRequired } from './chunk-5C4GDDG2.js';
-export { DEFAULT_NEXT_TOOL_BY_ACTION, ERC7710_ASSET_TRANSFER_METHOD, HAVEN_MINIMUM_NODE_VERSION, HavenTypedDataRefusedError, NEXT_TOOL_SERVER_NAMES, NEXT_TOOL_SERVER_ROLES, 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_SENT, X402_PAYMENT_REQUIRED_HEADER_NAME, X402_PAYMENT_RESPONSE_HEADER_NAME, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, assertBoundDirectPaymentUserOp, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, createNextStepBuilder, decodeBase64Json, decodeBase64Utf8, defaultNextToolFor, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, isErc7710Option, isSupportedNodeVersion, isSweepableChain, normalizePaymentRequired, parseNextTool, parsePaymentRequired, parsePaymentRequiredResponse, renderNextTool, resolveTokenFromAddress, selectErc7710PaymentOption, selectPaymentOption, selectStandardPaymentOption, selectX402SettlementScheme, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, unsupportedNodeVersionMessage, validateStandardX402PaymentHeader, x402AssetTransferMethod, x402AuthorizationAmount, x402FacilitatorAddresses, x402V2PaymentEnvelope } from './chunk-5C4GDDG2.js';
-import { HavenSigningError, HavenError, DEFAULT_CONFIRMATION_TIMEOUT_MS, HavenApiError, assertUserOpTypedDataBinding, AgentPaymentRail, AgentPaymentPhase, HavenTimeoutError, X402UnexpectedStatusError, X402AlreadySettledError, AgentPaymentWarningCode, MerchantTimeoutError, AgentPaymentNextAction, HavenPaymentStateError, HavenZeroSettlementHashError, chainIdForNetwork } from './chunk-KQ757ZWS.js';
-export { AGENT_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, AgentPaymentWarningCode, CONNECTOR_PACKAGE_NAME, DEFAULT_CONFIRMATION_TIMEOUT_MS, DIRECT_SIGN_CONTEXT_VERSION, ENTRY_POINT_V07, HAVEN_CONNECTOR_CHANNEL, HYBRID_DELEGATOR_DOMAIN_NAME, HYBRID_DELEGATOR_DOMAIN_VERSION, HavenApiError, HavenError, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, HavenUserOpBindingError, HavenZeroSettlementHashError, MerchantTimeoutError, PACKED_USER_OPERATION_FIELDS, ROOT_AUTHORITY, SIGNER_UPDATE_FALLBACK, SignerRefusalCode, X402AlreadySettledError, X402UnexpectedStatusError, assertUserOpTypedDataBinding, connectorRerunCommand, connectorSpec, deriveDelegateAccountAddress, isConnectorChannel, isPackedUserOperationTypedData, packedUserOperationHash, resolveConnectorChannel, signerUpdateFallback, verifySettlementChild } from './chunk-KQ757ZWS.js';
+import { selectStandardPaymentOption, buildX402IdempotencyKey, x402AuthorizationAmount, assertBoundDirectPaymentUserOp, HavenTypedDataRefusedError, assertOwnSettlementChild, parsePaymentRequiredResponse, x402PaymentHeaderNamesSent, SDK_CLIENT_IDENTITY, readClientUpdate, HAVEN_CLIENT_HEADER, resolveTokenFromAddress, isSweepableChain, sweepUsdcAddress, x402PaymentHeaderNamesFor, X402_PAYMENT_HEADER_NAMES, toStandardPaymentRequirements, decodeBase64Json, encodeBase64Json, x402V2PaymentEnvelope, selectX402SettlementScheme, selectErc7710PaymentOption, isErc7710Option, x402AssetTransferMethod, normalizePaymentRequired } from './chunk-UVC2VUU7.js';
+export { DEFAULT_NEXT_TOOL_BY_ACTION, ERC7710_ASSET_TRANSFER_METHOD, HAVEN_CLIENT_HEADER, HAVEN_MINIMUM_NODE_VERSION, HavenTypedDataRefusedError, 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_SENT, X402_PAYMENT_REQUIRED_HEADER_NAME, X402_PAYMENT_RESPONSE_HEADER_NAME, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, assertBoundDirectPaymentUserOp, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, createNextStepBuilder, decodeBase64Json, decodeBase64Utf8, defaultNextToolFor, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, havenClientIdentity, isErc7710Option, isSupportedNodeVersion, isSweepableChain, normalizePaymentRequired, parseNextTool, parsePaymentRequired, parsePaymentRequiredResponse, readClientUpdate, renderNextTool, resolveTokenFromAddress, selectErc7710PaymentOption, selectPaymentOption, selectStandardPaymentOption, selectX402SettlementScheme, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, unsupportedNodeVersionMessage, validateStandardX402PaymentHeader, x402AssetTransferMethod, x402AuthorizationAmount, x402FacilitatorAddresses, x402V2PaymentEnvelope } from './chunk-UVC2VUU7.js';
+import { HavenSigningError, HavenError, DEFAULT_CONFIRMATION_TIMEOUT_MS, HavenApiError, assertUserOpTypedDataBinding, AgentPaymentRail, AgentPaymentPhase, HavenTimeoutError, X402UnexpectedStatusError, X402AlreadySettledError, AgentPaymentWarningCode, MerchantTimeoutError, AgentPaymentNextAction, HavenPaymentStateError, HavenZeroSettlementHashError, chainIdForNetwork } from './chunk-AVKWY6JC.js';
+export { AGENT_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, AgentPaymentWarningCode, CONNECTOR_PACKAGE_NAME, DEFAULT_CONFIRMATION_TIMEOUT_MS, DIRECT_SIGN_CONTEXT_VERSION, ENTRY_POINT_V07, HAVEN_CONNECTOR_CHANNEL, HYBRID_DELEGATOR_DOMAIN_NAME, HYBRID_DELEGATOR_DOMAIN_VERSION, HavenApiError, HavenError, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, HavenUserOpBindingError, HavenZeroSettlementHashError, MerchantTimeoutError, PACKED_USER_OPERATION_FIELDS, ROOT_AUTHORITY, SIGNER_UPDATE_FALLBACK, SignerRefusalCode, X402AlreadySettledError, X402UnexpectedStatusError, assertUserOpTypedDataBinding, connectorRerunCommand, connectorSpec, deriveDelegateAccountAddress, isConnectorChannel, isPackedUserOperationTypedData, packedUserOperationHash, resolveConnectorChannel, signerUpdateFallback, verifySettlementChild } from './chunk-AVKWY6JC.js';
 import { hashTypedData } from 'viem';
 import { ethers } from 'ethers';
 import { AsyncLocalStorage } from 'async_hooks';
@@ -60,17 +60,41 @@ function verifySignature(hash, signature, expectedAddress) {
 }
 var DEFAULT_BASE_URL = "http://localhost:3001";
 var DEFAULT_REQUEST_TIMEOUT = 3e4;
+function withoutClientHeader(headers) {
+  const target = HAVEN_CLIENT_HEADER.toLowerCase();
+  return Object.fromEntries(Object.entries(headers).filter(([name]) => name.toLowerCase() !== target));
+}
 var HavenApiTransport = class {
   apiKey;
   baseUrl;
   requestTimeout;
   defaultHeaders;
+  clientIdentity;
   requestContext = new AsyncLocalStorage();
+  lastClientUpdate;
   constructor(config) {
     this.apiKey = config.apiKey;
     this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.requestTimeout = config.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT;
     this.defaultHeaders = { ...config.defaultHeaders ?? {} };
+    this.clientIdentity = config.clientIdentity ?? SDK_CLIENT_IDENTITY;
+  }
+  /**
+   * The newest `client_update` the backend sent (#3303): inside a
+   * `withRequestContext` dispatch, the one that dispatch's own requests
+   * received; outside one, the latest this transport has seen.
+   */
+  clientUpdate() {
+    const store = this.requestContext.getStore();
+    return store ? store.clientUpdate : this.lastClientUpdate;
+  }
+  recordClientUpdate(data) {
+    if (data === null || typeof data !== "object" || Array.isArray(data)) return;
+    const hint = readClientUpdate(data.client_update);
+    if (!hint) return;
+    this.lastClientUpdate = hint;
+    const store = this.requestContext.getStore();
+    if (store) store.clientUpdate = hint;
   }
   /** Run `fn` with extra headers scoped to its asynchronous Haven API work. */
   withRequestContext(headers, fn) {
@@ -93,13 +117,19 @@ var HavenApiTransport = class {
         headers: {
           "Content-Type": "application/json",
           "Authorization": `Bearer ${this.apiKey}`,
-          ...this.defaultHeaders,
-          ...contextHeaders
+          ...withoutClientHeader(this.defaultHeaders),
+          ...withoutClientHeader(contextHeaders),
+          // Last, and any other spelling of it dropped above (fetch would
+          // JOIN `x-haven-client` and `X-Haven-Client` into one unparseable
+          // value), so neither `defaultHeaders` nor a dispatch context can
+          // misname the client; `clientIdentity` is the one way to set it.
+          [HAVEN_CLIENT_HEADER]: this.clientIdentity
         },
         body: body ? JSON.stringify(body) : void 0,
         signal: controller.signal
       });
       const data = await res.json();
+      this.recordClientUpdate(data);
       if (!res.ok) {
         const record = data;
         const errorText = typeof record.error === "string" ? record.error : void 0;
@@ -2422,6 +2452,15 @@ var HavenClient = class {
   withRequestContext(headers, fn) {
     return this.havenApi.withRequestContext(headers, fn);
   }
+  /**
+   * The backend's newest `client_update` hint for this client (#3303): inside
+   * a `withRequestContext` dispatch, the one that dispatch's own requests
+   * received; outside one, the latest seen. Undefined when the client is
+   * current or the backend predates #3303.
+   */
+  clientUpdate() {
+    return this.havenApi.clientUpdate();
+  }
   // ── High-Level API ───────────────────────────────────────────────
   /**
    * Send a payment in one call.