@haven_ai/sdk 0.2.1-alpha.0 → 0.3.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -84,12 +84,10 @@ interface SignData {
84
84
  };
85
85
  /** Breakdown of values that were hashed — useful for debugging */
86
86
  components: {
87
- /** @deprecated #2908 — same value as `payer_account`; the server drops it at #2914. */
88
- safe: string;
89
87
  /**
90
- * #2907 — the account-vocabulary twin of `safe`: the PAYER account
91
- * (the user's smart account). Not to be confused with `account`, which on
92
- * the funding shapes holds the DELEGATE account address.
88
+ * The PAYER account (the user's smart account). Not to be confused with
89
+ * `account`, which on the funding shapes holds the DELEGATE account
90
+ * address.
93
91
  */
94
92
  payer_account?: string;
95
93
  token: string;
@@ -475,16 +473,8 @@ interface HavenAgent {
475
473
  id: string;
476
474
  name: string;
477
475
  status: string;
478
- /**
479
- * The agent's Haven account (smart account) address — #2908, the
480
- * account-vocabulary name. Same value as {@link HavenAgent.safeAddress}.
481
- */
476
+ /** The agent's Haven account (smart account) address. */
482
477
  accountAddress: string;
483
- /**
484
- * @deprecated #2908 — same value as {@link HavenAgent.accountAddress}.
485
- * Removed in the release after the one carrying #2908 (#2914).
486
- */
487
- safeAddress: string;
488
478
  delegateAddress: string;
489
479
  chainId: number;
490
480
  /**
@@ -525,13 +515,7 @@ interface HavenAllowance {
525
515
  }
526
516
  interface HavenAllowanceSummary {
527
517
  agentId: string;
528
- /** #2908 — the account-vocabulary name; same value as `safeAddress`. */
529
518
  accountAddress: string;
530
- /**
531
- * @deprecated #2908 — same value as {@link HavenAllowanceSummary.accountAddress}.
532
- * Removed in the release after the one carrying #2908 (#2914).
533
- */
534
- safeAddress: string;
535
519
  delegateAddress: string;
536
520
  chainId: number;
537
521
  allowances: HavenAllowance[];
@@ -851,12 +835,12 @@ declare const AgentPaymentNextAction: {
851
835
  * the agent's per-token allowance needs to be raised before the payment
852
836
  * can succeed. A user approval will not fix this state on its own.
853
837
  *
854
- * #2908: the wire twin `fund_account_or_raise_allowance`
855
- * ({@link AgentPaymentNextActionAccountAlias}) means the same thing; the
856
- * server keeps emitting THIS value until #2914. Compare via
857
- * {@link canonicalAgentPaymentNextAction}.
838
+ * #2914: the account-vocabulary spelling, and the only one — the
839
+ * pre-#2907 `fund_safe_or_raise_allowance` wire value (and the
840
+ * `AgentPaymentNextActionAccountAlias` seam #2908 added to bridge it) are
841
+ * retired along with the rest of the #2908 compatibility window.
858
842
  */
859
- readonly FundSafeOrRaiseAllowance: "fund_safe_or_raise_allowance";
843
+ readonly FundAccountOrRaiseAllowance: "fund_account_or_raise_allowance";
860
844
  /**
861
845
  * The delegate wallet may hold funds that were sent from the Safe but never
862
846
  * settled to the merchant. The wallet owner should initiate a sweep to
@@ -884,39 +868,6 @@ declare const AgentPaymentNextAction: {
884
868
  readonly AwaitingSettlementEvidence: "awaiting_settlement_evidence";
885
869
  };
886
870
  type AgentPaymentNextAction = (typeof AgentPaymentNextAction)[keyof typeof AgentPaymentNextAction];
887
- /**
888
- * #2908 (naming epic #2906): the account-vocabulary twin of
889
- * {@link AgentPaymentNextAction.FundSafeOrRaiseAllowance}. The server ACCEPTS
890
- * and DOCUMENTS this value from #2907 but keeps EMITTING the old one through
891
- * the compatibility window; the emitted value flips at #2914.
892
- *
893
- * Deliberately declared beside `AgentPaymentNextAction` rather than inside
894
- * it: the backend keeps a hand-mirror of that const, parity-pinned key-for-key
895
- * and value-for-value (`agent-payment-taxonomy.parity.test.ts`), and the
896
- * served `x-enumDescriptions` are the SDK's strings verbatim. Both consts
897
- * move together at #2914; until then this alias is how a client handles both
898
- * wire values without forking the taxonomy.
899
- */
900
- declare const AgentPaymentNextActionAccountAlias: {
901
- /** Account-vocabulary twin of `fund_safe_or_raise_allowance`; same meaning. */
902
- readonly FundAccountOrRaiseAllowance: "fund_account_or_raise_allowance";
903
- };
904
- type AgentPaymentNextActionAccountAlias = (typeof AgentPaymentNextActionAccountAlias)[keyof typeof AgentPaymentNextActionAccountAlias];
905
- /** Every `next_action` value a server may put on the wire during the #2908 window. */
906
- type AgentPaymentNextActionWire = AgentPaymentNextAction | AgentPaymentNextActionAccountAlias;
907
- /**
908
- * Collapse the #2908 account-vocabulary alias onto its canonical taxonomy
909
- * value, and pass every other value through untouched.
910
- *
911
- * This is the one seam a `switch` over `AgentPaymentNextAction` needs: a
912
- * case on `FundSafeOrRaiseAllowance` matches a server that emits either
913
- * spelling, and no case falls through because the alias arrived. Unknown
914
- * strings are returned as-is (the SDK never invents a value), so the return
915
- * type is exactly the input type widened by the canonical value.
916
- */
917
- declare function canonicalAgentPaymentNextAction<T extends string | null | undefined>(value: T): Exclude<T, AgentPaymentNextActionAccountAlias> | typeof AgentPaymentNextAction.FundSafeOrRaiseAllowance;
918
- /** True for EITHER spelling of the fund-or-raise-allowance next action (#2908). */
919
- declare function isFundAccountOrRaiseAllowance(value: string | null | undefined): boolean;
920
871
  declare const AgentPaymentFailureCode: {
921
872
  /** A merchant-authoritative x402 price exceeds the caller's pre-funding max_amount cap. */
922
873
  readonly PriceExceedsMax: "PRICE_EXCEEDS_MAX";
@@ -1008,7 +959,7 @@ type AgentPaymentRail = (typeof AgentPaymentRail)[keyof typeof AgentPaymentRail]
1008
959
  type PaymentPhase = AgentPaymentPhase;
1009
960
  type PaymentNextAction = AgentPaymentNextAction;
1010
961
  declare const AGENT_PAYMENT_PHASE_VALUES: ("rejected" | "expired" | "failed" | "agent_signature_required" | "payment_submitted" | "payment_confirmed" | "user_approval_required" | "user_execution_required" | "waiting_for_additional_approvals" | "funding_sent" | "insufficient_funds" | "funded_but_unsettled")[];
1011
- declare const AGENT_PAYMENT_NEXT_ACTION_VALUES: ("sign_and_submit_payment" | "check_status_later" | "none" | "wait_for_user_approval" | "wait_for_user_to_complete_payment" | "retry_original_x402_request" | "stop_and_tell_user" | "request_again_if_user_still_wants_it" | "retry_with_explicit_context" | "payment_window_expired" | "fund_safe_or_raise_allowance" | "sweep_stranded_funds" | "awaiting_settlement_evidence")[];
962
+ declare const AGENT_PAYMENT_NEXT_ACTION_VALUES: ("sign_and_submit_payment" | "check_status_later" | "none" | "wait_for_user_approval" | "wait_for_user_to_complete_payment" | "retry_original_x402_request" | "stop_and_tell_user" | "request_again_if_user_still_wants_it" | "retry_with_explicit_context" | "payment_window_expired" | "fund_account_or_raise_allowance" | "sweep_stranded_funds" | "awaiting_settlement_evidence")[];
1012
963
  declare const AGENT_PAYMENT_FAILURE_CODE_VALUES: ("PRICE_EXCEEDS_MAX" | "PAYMENT_WINDOW_EXPIRED" | "MERCHANT_REJECTED_AFTER_FUNDING" | "MERCHANT_UNRESPONSIVE_AFTER_FUNDING" | "MERCHANT_CALL_CONTEXT_UNAVAILABLE" | "AMBIGUOUS_MAX_AMOUNT" | "MAX_AMOUNT_UNCONVERTIBLE" | "MERCHANT_NOT_READY")[];
1013
964
  declare const AGENT_PAYMENT_RAIL_VALUES: ("x402" | "mpp_demo" | "mpp_crypto" | "stripe_deposit" | "spt" | "direct" | "mpp")[];
1014
965
  declare const AgentPaymentPhaseDescriptions: Record<AgentPaymentPhase, string>;
@@ -1082,15 +1033,8 @@ interface AgentPaymentWarning {
1082
1033
  * (payment_required) are named in `reason` and taken from the SAME response.
1083
1034
  */
1084
1035
  interface AgentNextStep {
1085
- /**
1086
- * From `AgentPaymentNextAction`, widened by the #2908 account-vocabulary
1087
- * alias for the compatibility window: the hosted server keeps emitting
1088
- * `fund_safe_or_raise_allowance` until #2914, but a client compiled against
1089
- * this type must not reject `fund_account_or_raise_allowance` when the flip
1090
- * lands. Compare through {@link canonicalAgentPaymentNextAction} or
1091
- * {@link isFundAccountOrRaiseAllowance}, never by one literal.
1092
- */
1093
- next_action: AgentPaymentNextActionWire;
1036
+ /** From `AgentPaymentNextAction`. */
1037
+ next_action: AgentPaymentNextAction;
1094
1038
  /**
1095
1039
  * Claude-family namespaced tool name for the next call
1096
1040
  * (`mcp__<server>__<tool>`), when one exists.
@@ -1481,18 +1425,13 @@ interface PaymentReceipt {
1481
1425
  amount: string;
1482
1426
  amountSek: string | null;
1483
1427
  recipient: string;
1484
- /** @deprecated since #2907 — read `account`; removed in #2914 (the release after the naming window). Same value as `account`. */
1485
- safe: string;
1428
+ /** The payer's smart-account address. */
1429
+ account: string;
1486
1430
  /**
1487
- * The payer's smart-account address (#2907 twin of `safe`). Optional for
1488
- * the window: a server from before the twin emits `safe` only.
1489
- */
1490
- account?: string;
1491
- /**
1492
- * #2960: one party vocabulary for "who paid", additive alongside `safe`/
1493
- * `account` above (which are `parties.treasury_account` only). Optional
1494
- * for the window: a server from before #2960 emits neither. Ignored by
1495
- * `verifyPaymentReceipt`, which reads only `authorization`.
1431
+ * #2960: one party vocabulary for "who paid", additive alongside `account`
1432
+ * above (which is `parties.treasury_account` only). Optional: a server
1433
+ * from before #2960 emits neither. Ignored by `verifyPaymentReceipt`,
1434
+ * which reads only `authorization`.
1496
1435
  */
1497
1436
  parties?: RawPaymentParties;
1498
1437
  chainId: number;
@@ -2487,7 +2426,7 @@ declare const toolDescriptions: {
2487
2426
  readonly getAgent: {
2488
2427
  readonly summary: "Return the authenticated agent identity AND its live spend authority in one call: Haven wallet, delegate, chain, raw status, spend_authority_readiness, and per-token remaining allowance (atomic + human-readable). The recommended first call in a new session to confirm who you are and whether Haven will let you spend right now.";
2489
2428
  readonly selectionGuidance: "Use this as the one-shot orientation/bootstrap at the start of a session, or whenever you need to confirm identity together with whether the agent can spend right now. For a detailed per-token breakdown (configured vs spent vs reset window) use haven_get_allowances.";
2490
- readonly behavior: "Reads identity plus the live spend-authority snapshot in one shot — the agent's active on-chain budget delegation. spend_authority_readiness (readiness is a deprecated alias, same value) is \"ready\" when at least one token has remaining spend authority, \"needs_approval\" when the agent is active but has none, and \"revoked\" when the credential is not active. It covers hosted identity + on-chain spend authority ONLY — the hosted server cannot see the LOCAL signer, so \"ready\" does not mean the signer can start; verify the signer with a signer tool call or connect --doctor. An over-budget payment is declined before any money moves: there is no approval queue, so ask the owner to grant or raise the budget in Haven rather than waiting for an approval. allowances[] carries remainingAtomic and remainingDisplay per token. Identity fields: id, name, status, accountAddress (safeAddress: deprecated alias, same value), delegateAddress, chainId.";
2429
+ readonly behavior: "Reads identity plus the live spend-authority snapshot in one shot — the agent's active on-chain budget delegation. spend_authority_readiness (readiness is a deprecated alias, same value) is \"ready\" when at least one token has remaining spend authority, \"needs_approval\" when the agent is active but has none, and \"revoked\" when the credential is not active. It covers hosted identity + on-chain spend authority ONLY — the hosted server cannot see the LOCAL signer, so \"ready\" does not mean the signer can start; verify the signer with a signer tool call or connect --doctor. An over-budget payment is declined before any money moves: there is no approval queue, so ask the owner to grant or raise the budget in Haven rather than waiting for an approval. allowances[] carries remainingAtomic and remainingDisplay per token. Identity fields: id, name, status, accountAddress, delegateAddress, chainId.";
2491
2430
  readonly nextActionGuidance: "";
2492
2431
  };
2493
2432
  readonly getAllowances: {
@@ -2969,55 +2908,27 @@ interface UnsupportedNodeVersionMessageOptions {
2969
2908
  declare function unsupportedNodeVersionMessage(options: UnsupportedNodeVersionMessageOptions): string;
2970
2909
 
2971
2910
  /**
2972
- * #2908 (naming epic #2906, phase 1): the account-vocabulary reads and the
2973
- * dual-name emissions every published package shares during the one-release
2974
- * compatibility window.
2911
+ * #2914 (naming epic #2906, phase 5 — the CONTRACTION): the compatibility
2912
+ * window #2908 opened (read both server-response names, prefer the new;
2913
+ * emit both camelCase names; write only the new) closed with the
2914
+ * `0.2.0-alpha.0` release reaching `main` on 2026-09-14 and a further
2915
+ * promotion on 2026-09-16. The account-vocabulary name is now the ONLY name
2916
+ * on every wire shape this module touches; `safe_address` / `safe_id` /
2917
+ * `sign_data.components.safe` are no longer read from a server response.
2975
2918
  *
2976
- * The rule, stated once: READ both names and prefer the new; EMIT both names
2977
- * with the same value; WRITE only the new. The old names on server responses
2978
- * are removed by #2914, one release after the one that carries this module.
2979
- * The credential-FILE fallbacks (`safe_address` / `safeAddress` in a file on
2980
- * disk) are NOT part of that window — they are permanent, because a file that
2981
- * was written before this release never rewrites itself.
2919
+ * `readAccountAddress` and `readAccountId` collapsed to a single field read
2920
+ * once the fallback was removed, so they are gone — read `raw.account_address`
2921
+ * / `raw.account_id` directly. `accountAddressTwins` is gone too: the SDK's
2922
+ * public shapes carry `accountAddress` only, never a `safeAddress` twin.
2982
2923
  *
2983
- * Kept as tiny pure functions so a reader has exactly one fallback chain per
2984
- * shape and a test can mutate it: dropping the new name fails the new-shape
2985
- * test, dropping the old name fails the old-shape test.
2924
+ * `readX402ReceiptPayer` survives because it still has a real multi-step
2925
+ * chain (`payer`, then the top-level account address, then the nested
2926
+ * `sign_data.components` twin) once the old names are dropped from it.
2986
2927
  */
2987
2928
  /**
2988
- * The account address off a snake_case server shape, new name first.
2989
- *
2990
- * `account_address` is the P0 (#2907) twin the server emits beside
2991
- * `safe_address`; an older server emits only `safe_address`. A missing pair
2992
- * resolves to `undefined` rather than an empty string so callers can tell
2993
- * "absent" from "blank".
2994
- */
2995
- declare function readAccountAddress(raw: {
2996
- account_address?: string | null;
2997
- safe_address?: string | null;
2998
- }): string | undefined;
2999
- /**
3000
- * The account id off a snake_case server shape, new name first
3001
- * (`account_id`, the #2907 twin of `safe_id`).
3002
- */
3003
- declare function readAccountId(raw: {
3004
- account_id?: string | null;
3005
- safe_id?: string | null;
3006
- }): string | undefined;
3007
- /**
3008
- * Both camelCase names for one address, for the SDK's public shapes (and the
3009
- * hosted MCP outputs that spread them). Same value under both keys; the
3010
- * `safeAddress` key is the deprecated one and goes at #2914.
3011
- */
3012
- declare function accountAddressTwins(address: string | undefined): {
3013
- accountAddress: string;
3014
- safeAddress: string;
3015
- };
3016
- /**
3017
- * The x402 receipt's `payer` off a funding-authorization response, in the
3018
- * order the issue pins (#2908): the explicit `payer`, then the top-level
3019
- * account address (new name, then old), then the `sign_data.components`
3020
- * twins — `payer_account` (the #2907 twin) before `safe`.
2929
+ * The x402 receipt's `payer` off a funding-authorization response: the
2930
+ * explicit `payer`, then the top-level `account_address`, then
2931
+ * `sign_data.components.payer_account`.
3021
2932
  *
3022
2933
  * `components.account` is deliberately NOT in this chain: on the funding
3023
2934
  * shapes it holds the DELEGATE account address, a different address, and
@@ -3026,11 +2937,9 @@ declare function accountAddressTwins(address: string | undefined): {
3026
2937
  declare function readX402ReceiptPayer(raw: {
3027
2938
  payer?: string;
3028
2939
  account_address?: string;
3029
- safe_address?: string;
3030
2940
  sign_data?: {
3031
2941
  components?: {
3032
2942
  payer_account?: string;
3033
- safe?: string;
3034
2943
  account?: string;
3035
2944
  };
3036
2945
  };
@@ -3384,4 +3293,4 @@ declare function discoverMerchantMcpUrl(inputUrl: string): Promise<string | null
3384
3293
  /** Trailing-slash/percent-case echoes compare equal; unparseable never does. */
3385
3294
  declare function sameUrl(a: string, b: string): boolean;
3386
3295
 
3387
- 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_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, AGENT_README_SECTION_MD, AGENT_SECRET_HYGIENE_SENTENCE, AGENT_WIRING_COLLISION_RELAY_SENTENCE, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionAccountAlias, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, type AgentPaymentNextActionWire, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type AgentPurchaseSummary, CONNECTOR_PACKAGE_NAME, type CatalogSubmissionAccepted, type ClaudeTool, DEFAULT_CONFIRMATION_TIMEOUT_MS, DISCOVERY_MAX_BYTES, ERC7710_ASSET_TRANSFER_METHOD, type EvidenceReportOutcome, HAVEN_AGENT_RUNBOOK_MD, HAVEN_CONNECTOR_CHANNEL, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_BODY_MD, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, type HavenCatalogSubmission, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, HavenZeroSettlementHashError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentRail, MerchantTimeoutError, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedX402Input, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepConfirmation, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, X402AlreadySettledError, type X402AuthorizationOptions, type X402Erc7710Settlement, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402MerchantOutcome, type X402MerchantOutcomeReport, type X402PaymentHeaderContext, X402PaymentHeaderValidationError, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, type X402SchemeSelection, X402UnexpectedStatusError, 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, accountAddressTwins, addressFromKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, canonicalAgentPaymentNextAction, compareNodeVersions, composeDescription, connectorRerunCommand, connectorSpec, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, havenTools, isConnectorChannel, isErc7710Option, isFundAccountOrRaiseAllowance, isSupportedNodeVersion, isSweepableChain, isZeroSettlementTxHash, normalizePaymentRequired, parsePaymentRequired, parsePaymentRequiredResponse, readAccountAddress, readAccountId, readX402ReceiptPayer, resolveConnectorChannel, resolveTokenFromAddress, sameUrl, selectErc7710PaymentOption, selectPaymentOption, selectStandardPaymentOption, selectX402SettlementScheme, signHash, signUserOpTypedDataForDelegation, signerUpdateFallback, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, validateStandardX402PaymentHeader, verifyPaymentReceipt, verifySignature, x402AssetTransferMethod, x402AuthorizationAmount, x402FacilitatorAddresses, x402V2PaymentEnvelope };
3296
+ 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_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, AGENT_README_SECTION_MD, AGENT_SECRET_HYGIENE_SENTENCE, AGENT_WIRING_COLLISION_RELAY_SENTENCE, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type AgentPurchaseSummary, CONNECTOR_PACKAGE_NAME, type CatalogSubmissionAccepted, type ClaudeTool, DEFAULT_CONFIRMATION_TIMEOUT_MS, DISCOVERY_MAX_BYTES, ERC7710_ASSET_TRANSFER_METHOD, type EvidenceReportOutcome, HAVEN_AGENT_RUNBOOK_MD, HAVEN_CONNECTOR_CHANNEL, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_BODY_MD, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, type HavenCatalogSubmission, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, HavenZeroSettlementHashError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentRail, MerchantTimeoutError, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedX402Input, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepConfirmation, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, X402AlreadySettledError, type X402AuthorizationOptions, type X402Erc7710Settlement, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402MerchantOutcome, type X402MerchantOutcomeReport, type X402PaymentHeaderContext, X402PaymentHeaderValidationError, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, type X402SchemeSelection, X402UnexpectedStatusError, 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, addressFromKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, composeDescription, connectorRerunCommand, connectorSpec, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, havenTools, isConnectorChannel, isErc7710Option, isSupportedNodeVersion, isSweepableChain, isZeroSettlementTxHash, normalizePaymentRequired, parsePaymentRequired, parsePaymentRequiredResponse, readX402ReceiptPayer, resolveConnectorChannel, resolveTokenFromAddress, sameUrl, selectErc7710PaymentOption, selectPaymentOption, selectStandardPaymentOption, selectX402SettlementScheme, signHash, signUserOpTypedDataForDelegation, signerUpdateFallback, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, validateStandardX402PaymentHeader, verifyPaymentReceipt, verifySignature, x402AssetTransferMethod, x402AuthorizationAmount, x402FacilitatorAddresses, x402V2PaymentEnvelope };
package/dist/index.d.ts CHANGED
@@ -84,12 +84,10 @@ interface SignData {
84
84
  };
85
85
  /** Breakdown of values that were hashed — useful for debugging */
86
86
  components: {
87
- /** @deprecated #2908 — same value as `payer_account`; the server drops it at #2914. */
88
- safe: string;
89
87
  /**
90
- * #2907 — the account-vocabulary twin of `safe`: the PAYER account
91
- * (the user's smart account). Not to be confused with `account`, which on
92
- * the funding shapes holds the DELEGATE account address.
88
+ * The PAYER account (the user's smart account). Not to be confused with
89
+ * `account`, which on the funding shapes holds the DELEGATE account
90
+ * address.
93
91
  */
94
92
  payer_account?: string;
95
93
  token: string;
@@ -475,16 +473,8 @@ interface HavenAgent {
475
473
  id: string;
476
474
  name: string;
477
475
  status: string;
478
- /**
479
- * The agent's Haven account (smart account) address — #2908, the
480
- * account-vocabulary name. Same value as {@link HavenAgent.safeAddress}.
481
- */
476
+ /** The agent's Haven account (smart account) address. */
482
477
  accountAddress: string;
483
- /**
484
- * @deprecated #2908 — same value as {@link HavenAgent.accountAddress}.
485
- * Removed in the release after the one carrying #2908 (#2914).
486
- */
487
- safeAddress: string;
488
478
  delegateAddress: string;
489
479
  chainId: number;
490
480
  /**
@@ -525,13 +515,7 @@ interface HavenAllowance {
525
515
  }
526
516
  interface HavenAllowanceSummary {
527
517
  agentId: string;
528
- /** #2908 — the account-vocabulary name; same value as `safeAddress`. */
529
518
  accountAddress: string;
530
- /**
531
- * @deprecated #2908 — same value as {@link HavenAllowanceSummary.accountAddress}.
532
- * Removed in the release after the one carrying #2908 (#2914).
533
- */
534
- safeAddress: string;
535
519
  delegateAddress: string;
536
520
  chainId: number;
537
521
  allowances: HavenAllowance[];
@@ -851,12 +835,12 @@ declare const AgentPaymentNextAction: {
851
835
  * the agent's per-token allowance needs to be raised before the payment
852
836
  * can succeed. A user approval will not fix this state on its own.
853
837
  *
854
- * #2908: the wire twin `fund_account_or_raise_allowance`
855
- * ({@link AgentPaymentNextActionAccountAlias}) means the same thing; the
856
- * server keeps emitting THIS value until #2914. Compare via
857
- * {@link canonicalAgentPaymentNextAction}.
838
+ * #2914: the account-vocabulary spelling, and the only one — the
839
+ * pre-#2907 `fund_safe_or_raise_allowance` wire value (and the
840
+ * `AgentPaymentNextActionAccountAlias` seam #2908 added to bridge it) are
841
+ * retired along with the rest of the #2908 compatibility window.
858
842
  */
859
- readonly FundSafeOrRaiseAllowance: "fund_safe_or_raise_allowance";
843
+ readonly FundAccountOrRaiseAllowance: "fund_account_or_raise_allowance";
860
844
  /**
861
845
  * The delegate wallet may hold funds that were sent from the Safe but never
862
846
  * settled to the merchant. The wallet owner should initiate a sweep to
@@ -884,39 +868,6 @@ declare const AgentPaymentNextAction: {
884
868
  readonly AwaitingSettlementEvidence: "awaiting_settlement_evidence";
885
869
  };
886
870
  type AgentPaymentNextAction = (typeof AgentPaymentNextAction)[keyof typeof AgentPaymentNextAction];
887
- /**
888
- * #2908 (naming epic #2906): the account-vocabulary twin of
889
- * {@link AgentPaymentNextAction.FundSafeOrRaiseAllowance}. The server ACCEPTS
890
- * and DOCUMENTS this value from #2907 but keeps EMITTING the old one through
891
- * the compatibility window; the emitted value flips at #2914.
892
- *
893
- * Deliberately declared beside `AgentPaymentNextAction` rather than inside
894
- * it: the backend keeps a hand-mirror of that const, parity-pinned key-for-key
895
- * and value-for-value (`agent-payment-taxonomy.parity.test.ts`), and the
896
- * served `x-enumDescriptions` are the SDK's strings verbatim. Both consts
897
- * move together at #2914; until then this alias is how a client handles both
898
- * wire values without forking the taxonomy.
899
- */
900
- declare const AgentPaymentNextActionAccountAlias: {
901
- /** Account-vocabulary twin of `fund_safe_or_raise_allowance`; same meaning. */
902
- readonly FundAccountOrRaiseAllowance: "fund_account_or_raise_allowance";
903
- };
904
- type AgentPaymentNextActionAccountAlias = (typeof AgentPaymentNextActionAccountAlias)[keyof typeof AgentPaymentNextActionAccountAlias];
905
- /** Every `next_action` value a server may put on the wire during the #2908 window. */
906
- type AgentPaymentNextActionWire = AgentPaymentNextAction | AgentPaymentNextActionAccountAlias;
907
- /**
908
- * Collapse the #2908 account-vocabulary alias onto its canonical taxonomy
909
- * value, and pass every other value through untouched.
910
- *
911
- * This is the one seam a `switch` over `AgentPaymentNextAction` needs: a
912
- * case on `FundSafeOrRaiseAllowance` matches a server that emits either
913
- * spelling, and no case falls through because the alias arrived. Unknown
914
- * strings are returned as-is (the SDK never invents a value), so the return
915
- * type is exactly the input type widened by the canonical value.
916
- */
917
- declare function canonicalAgentPaymentNextAction<T extends string | null | undefined>(value: T): Exclude<T, AgentPaymentNextActionAccountAlias> | typeof AgentPaymentNextAction.FundSafeOrRaiseAllowance;
918
- /** True for EITHER spelling of the fund-or-raise-allowance next action (#2908). */
919
- declare function isFundAccountOrRaiseAllowance(value: string | null | undefined): boolean;
920
871
  declare const AgentPaymentFailureCode: {
921
872
  /** A merchant-authoritative x402 price exceeds the caller's pre-funding max_amount cap. */
922
873
  readonly PriceExceedsMax: "PRICE_EXCEEDS_MAX";
@@ -1008,7 +959,7 @@ type AgentPaymentRail = (typeof AgentPaymentRail)[keyof typeof AgentPaymentRail]
1008
959
  type PaymentPhase = AgentPaymentPhase;
1009
960
  type PaymentNextAction = AgentPaymentNextAction;
1010
961
  declare const AGENT_PAYMENT_PHASE_VALUES: ("rejected" | "expired" | "failed" | "agent_signature_required" | "payment_submitted" | "payment_confirmed" | "user_approval_required" | "user_execution_required" | "waiting_for_additional_approvals" | "funding_sent" | "insufficient_funds" | "funded_but_unsettled")[];
1011
- declare const AGENT_PAYMENT_NEXT_ACTION_VALUES: ("sign_and_submit_payment" | "check_status_later" | "none" | "wait_for_user_approval" | "wait_for_user_to_complete_payment" | "retry_original_x402_request" | "stop_and_tell_user" | "request_again_if_user_still_wants_it" | "retry_with_explicit_context" | "payment_window_expired" | "fund_safe_or_raise_allowance" | "sweep_stranded_funds" | "awaiting_settlement_evidence")[];
962
+ declare const AGENT_PAYMENT_NEXT_ACTION_VALUES: ("sign_and_submit_payment" | "check_status_later" | "none" | "wait_for_user_approval" | "wait_for_user_to_complete_payment" | "retry_original_x402_request" | "stop_and_tell_user" | "request_again_if_user_still_wants_it" | "retry_with_explicit_context" | "payment_window_expired" | "fund_account_or_raise_allowance" | "sweep_stranded_funds" | "awaiting_settlement_evidence")[];
1012
963
  declare const AGENT_PAYMENT_FAILURE_CODE_VALUES: ("PRICE_EXCEEDS_MAX" | "PAYMENT_WINDOW_EXPIRED" | "MERCHANT_REJECTED_AFTER_FUNDING" | "MERCHANT_UNRESPONSIVE_AFTER_FUNDING" | "MERCHANT_CALL_CONTEXT_UNAVAILABLE" | "AMBIGUOUS_MAX_AMOUNT" | "MAX_AMOUNT_UNCONVERTIBLE" | "MERCHANT_NOT_READY")[];
1013
964
  declare const AGENT_PAYMENT_RAIL_VALUES: ("x402" | "mpp_demo" | "mpp_crypto" | "stripe_deposit" | "spt" | "direct" | "mpp")[];
1014
965
  declare const AgentPaymentPhaseDescriptions: Record<AgentPaymentPhase, string>;
@@ -1082,15 +1033,8 @@ interface AgentPaymentWarning {
1082
1033
  * (payment_required) are named in `reason` and taken from the SAME response.
1083
1034
  */
1084
1035
  interface AgentNextStep {
1085
- /**
1086
- * From `AgentPaymentNextAction`, widened by the #2908 account-vocabulary
1087
- * alias for the compatibility window: the hosted server keeps emitting
1088
- * `fund_safe_or_raise_allowance` until #2914, but a client compiled against
1089
- * this type must not reject `fund_account_or_raise_allowance` when the flip
1090
- * lands. Compare through {@link canonicalAgentPaymentNextAction} or
1091
- * {@link isFundAccountOrRaiseAllowance}, never by one literal.
1092
- */
1093
- next_action: AgentPaymentNextActionWire;
1036
+ /** From `AgentPaymentNextAction`. */
1037
+ next_action: AgentPaymentNextAction;
1094
1038
  /**
1095
1039
  * Claude-family namespaced tool name for the next call
1096
1040
  * (`mcp__<server>__<tool>`), when one exists.
@@ -1481,18 +1425,13 @@ interface PaymentReceipt {
1481
1425
  amount: string;
1482
1426
  amountSek: string | null;
1483
1427
  recipient: string;
1484
- /** @deprecated since #2907 — read `account`; removed in #2914 (the release after the naming window). Same value as `account`. */
1485
- safe: string;
1428
+ /** The payer's smart-account address. */
1429
+ account: string;
1486
1430
  /**
1487
- * The payer's smart-account address (#2907 twin of `safe`). Optional for
1488
- * the window: a server from before the twin emits `safe` only.
1489
- */
1490
- account?: string;
1491
- /**
1492
- * #2960: one party vocabulary for "who paid", additive alongside `safe`/
1493
- * `account` above (which are `parties.treasury_account` only). Optional
1494
- * for the window: a server from before #2960 emits neither. Ignored by
1495
- * `verifyPaymentReceipt`, which reads only `authorization`.
1431
+ * #2960: one party vocabulary for "who paid", additive alongside `account`
1432
+ * above (which is `parties.treasury_account` only). Optional: a server
1433
+ * from before #2960 emits neither. Ignored by `verifyPaymentReceipt`,
1434
+ * which reads only `authorization`.
1496
1435
  */
1497
1436
  parties?: RawPaymentParties;
1498
1437
  chainId: number;
@@ -2487,7 +2426,7 @@ declare const toolDescriptions: {
2487
2426
  readonly getAgent: {
2488
2427
  readonly summary: "Return the authenticated agent identity AND its live spend authority in one call: Haven wallet, delegate, chain, raw status, spend_authority_readiness, and per-token remaining allowance (atomic + human-readable). The recommended first call in a new session to confirm who you are and whether Haven will let you spend right now.";
2489
2428
  readonly selectionGuidance: "Use this as the one-shot orientation/bootstrap at the start of a session, or whenever you need to confirm identity together with whether the agent can spend right now. For a detailed per-token breakdown (configured vs spent vs reset window) use haven_get_allowances.";
2490
- readonly behavior: "Reads identity plus the live spend-authority snapshot in one shot — the agent's active on-chain budget delegation. spend_authority_readiness (readiness is a deprecated alias, same value) is \"ready\" when at least one token has remaining spend authority, \"needs_approval\" when the agent is active but has none, and \"revoked\" when the credential is not active. It covers hosted identity + on-chain spend authority ONLY — the hosted server cannot see the LOCAL signer, so \"ready\" does not mean the signer can start; verify the signer with a signer tool call or connect --doctor. An over-budget payment is declined before any money moves: there is no approval queue, so ask the owner to grant or raise the budget in Haven rather than waiting for an approval. allowances[] carries remainingAtomic and remainingDisplay per token. Identity fields: id, name, status, accountAddress (safeAddress: deprecated alias, same value), delegateAddress, chainId.";
2429
+ readonly behavior: "Reads identity plus the live spend-authority snapshot in one shot — the agent's active on-chain budget delegation. spend_authority_readiness (readiness is a deprecated alias, same value) is \"ready\" when at least one token has remaining spend authority, \"needs_approval\" when the agent is active but has none, and \"revoked\" when the credential is not active. It covers hosted identity + on-chain spend authority ONLY — the hosted server cannot see the LOCAL signer, so \"ready\" does not mean the signer can start; verify the signer with a signer tool call or connect --doctor. An over-budget payment is declined before any money moves: there is no approval queue, so ask the owner to grant or raise the budget in Haven rather than waiting for an approval. allowances[] carries remainingAtomic and remainingDisplay per token. Identity fields: id, name, status, accountAddress, delegateAddress, chainId.";
2491
2430
  readonly nextActionGuidance: "";
2492
2431
  };
2493
2432
  readonly getAllowances: {
@@ -2969,55 +2908,27 @@ interface UnsupportedNodeVersionMessageOptions {
2969
2908
  declare function unsupportedNodeVersionMessage(options: UnsupportedNodeVersionMessageOptions): string;
2970
2909
 
2971
2910
  /**
2972
- * #2908 (naming epic #2906, phase 1): the account-vocabulary reads and the
2973
- * dual-name emissions every published package shares during the one-release
2974
- * compatibility window.
2911
+ * #2914 (naming epic #2906, phase 5 — the CONTRACTION): the compatibility
2912
+ * window #2908 opened (read both server-response names, prefer the new;
2913
+ * emit both camelCase names; write only the new) closed with the
2914
+ * `0.2.0-alpha.0` release reaching `main` on 2026-09-14 and a further
2915
+ * promotion on 2026-09-16. The account-vocabulary name is now the ONLY name
2916
+ * on every wire shape this module touches; `safe_address` / `safe_id` /
2917
+ * `sign_data.components.safe` are no longer read from a server response.
2975
2918
  *
2976
- * The rule, stated once: READ both names and prefer the new; EMIT both names
2977
- * with the same value; WRITE only the new. The old names on server responses
2978
- * are removed by #2914, one release after the one that carries this module.
2979
- * The credential-FILE fallbacks (`safe_address` / `safeAddress` in a file on
2980
- * disk) are NOT part of that window — they are permanent, because a file that
2981
- * was written before this release never rewrites itself.
2919
+ * `readAccountAddress` and `readAccountId` collapsed to a single field read
2920
+ * once the fallback was removed, so they are gone — read `raw.account_address`
2921
+ * / `raw.account_id` directly. `accountAddressTwins` is gone too: the SDK's
2922
+ * public shapes carry `accountAddress` only, never a `safeAddress` twin.
2982
2923
  *
2983
- * Kept as tiny pure functions so a reader has exactly one fallback chain per
2984
- * shape and a test can mutate it: dropping the new name fails the new-shape
2985
- * test, dropping the old name fails the old-shape test.
2924
+ * `readX402ReceiptPayer` survives because it still has a real multi-step
2925
+ * chain (`payer`, then the top-level account address, then the nested
2926
+ * `sign_data.components` twin) once the old names are dropped from it.
2986
2927
  */
2987
2928
  /**
2988
- * The account address off a snake_case server shape, new name first.
2989
- *
2990
- * `account_address` is the P0 (#2907) twin the server emits beside
2991
- * `safe_address`; an older server emits only `safe_address`. A missing pair
2992
- * resolves to `undefined` rather than an empty string so callers can tell
2993
- * "absent" from "blank".
2994
- */
2995
- declare function readAccountAddress(raw: {
2996
- account_address?: string | null;
2997
- safe_address?: string | null;
2998
- }): string | undefined;
2999
- /**
3000
- * The account id off a snake_case server shape, new name first
3001
- * (`account_id`, the #2907 twin of `safe_id`).
3002
- */
3003
- declare function readAccountId(raw: {
3004
- account_id?: string | null;
3005
- safe_id?: string | null;
3006
- }): string | undefined;
3007
- /**
3008
- * Both camelCase names for one address, for the SDK's public shapes (and the
3009
- * hosted MCP outputs that spread them). Same value under both keys; the
3010
- * `safeAddress` key is the deprecated one and goes at #2914.
3011
- */
3012
- declare function accountAddressTwins(address: string | undefined): {
3013
- accountAddress: string;
3014
- safeAddress: string;
3015
- };
3016
- /**
3017
- * The x402 receipt's `payer` off a funding-authorization response, in the
3018
- * order the issue pins (#2908): the explicit `payer`, then the top-level
3019
- * account address (new name, then old), then the `sign_data.components`
3020
- * twins — `payer_account` (the #2907 twin) before `safe`.
2929
+ * The x402 receipt's `payer` off a funding-authorization response: the
2930
+ * explicit `payer`, then the top-level `account_address`, then
2931
+ * `sign_data.components.payer_account`.
3021
2932
  *
3022
2933
  * `components.account` is deliberately NOT in this chain: on the funding
3023
2934
  * shapes it holds the DELEGATE account address, a different address, and
@@ -3026,11 +2937,9 @@ declare function accountAddressTwins(address: string | undefined): {
3026
2937
  declare function readX402ReceiptPayer(raw: {
3027
2938
  payer?: string;
3028
2939
  account_address?: string;
3029
- safe_address?: string;
3030
2940
  sign_data?: {
3031
2941
  components?: {
3032
2942
  payer_account?: string;
3033
- safe?: string;
3034
2943
  account?: string;
3035
2944
  };
3036
2945
  };
@@ -3384,4 +3293,4 @@ declare function discoverMerchantMcpUrl(inputUrl: string): Promise<string | null
3384
3293
  /** Trailing-slash/percent-case echoes compare equal; unparseable never does. */
3385
3294
  declare function sameUrl(a: string, b: string): boolean;
3386
3295
 
3387
- 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_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, AGENT_README_SECTION_MD, AGENT_SECRET_HYGIENE_SENTENCE, AGENT_WIRING_COLLISION_RELAY_SENTENCE, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionAccountAlias, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, type AgentPaymentNextActionWire, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type AgentPurchaseSummary, CONNECTOR_PACKAGE_NAME, type CatalogSubmissionAccepted, type ClaudeTool, DEFAULT_CONFIRMATION_TIMEOUT_MS, DISCOVERY_MAX_BYTES, ERC7710_ASSET_TRANSFER_METHOD, type EvidenceReportOutcome, HAVEN_AGENT_RUNBOOK_MD, HAVEN_CONNECTOR_CHANNEL, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_BODY_MD, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, type HavenCatalogSubmission, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, HavenZeroSettlementHashError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentRail, MerchantTimeoutError, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedX402Input, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepConfirmation, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, X402AlreadySettledError, type X402AuthorizationOptions, type X402Erc7710Settlement, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402MerchantOutcome, type X402MerchantOutcomeReport, type X402PaymentHeaderContext, X402PaymentHeaderValidationError, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, type X402SchemeSelection, X402UnexpectedStatusError, 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, accountAddressTwins, addressFromKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, canonicalAgentPaymentNextAction, compareNodeVersions, composeDescription, connectorRerunCommand, connectorSpec, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, havenTools, isConnectorChannel, isErc7710Option, isFundAccountOrRaiseAllowance, isSupportedNodeVersion, isSweepableChain, isZeroSettlementTxHash, normalizePaymentRequired, parsePaymentRequired, parsePaymentRequiredResponse, readAccountAddress, readAccountId, readX402ReceiptPayer, resolveConnectorChannel, resolveTokenFromAddress, sameUrl, selectErc7710PaymentOption, selectPaymentOption, selectStandardPaymentOption, selectX402SettlementScheme, signHash, signUserOpTypedDataForDelegation, signerUpdateFallback, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, validateStandardX402PaymentHeader, verifyPaymentReceipt, verifySignature, x402AssetTransferMethod, x402AuthorizationAmount, x402FacilitatorAddresses, x402V2PaymentEnvelope };
3296
+ 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_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, AGENT_README_SECTION_MD, AGENT_SECRET_HYGIENE_SENTENCE, AGENT_WIRING_COLLISION_RELAY_SENTENCE, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type AgentPurchaseSummary, CONNECTOR_PACKAGE_NAME, type CatalogSubmissionAccepted, type ClaudeTool, DEFAULT_CONFIRMATION_TIMEOUT_MS, DISCOVERY_MAX_BYTES, ERC7710_ASSET_TRANSFER_METHOD, type EvidenceReportOutcome, HAVEN_AGENT_RUNBOOK_MD, HAVEN_CONNECTOR_CHANNEL, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_BODY_MD, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, type HavenCatalogSubmission, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, HavenZeroSettlementHashError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentRail, MerchantTimeoutError, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedX402Input, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepConfirmation, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, X402AlreadySettledError, type X402AuthorizationOptions, type X402Erc7710Settlement, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402MerchantOutcome, type X402MerchantOutcomeReport, type X402PaymentHeaderContext, X402PaymentHeaderValidationError, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, type X402SchemeSelection, X402UnexpectedStatusError, 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, addressFromKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, composeDescription, connectorRerunCommand, connectorSpec, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, havenTools, isConnectorChannel, isErc7710Option, isSupportedNodeVersion, isSweepableChain, isZeroSettlementTxHash, normalizePaymentRequired, parsePaymentRequired, parsePaymentRequiredResponse, readX402ReceiptPayer, resolveConnectorChannel, resolveTokenFromAddress, sameUrl, selectErc7710PaymentOption, selectPaymentOption, selectStandardPaymentOption, selectX402SettlementScheme, signHash, signUserOpTypedDataForDelegation, signerUpdateFallback, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, validateStandardX402PaymentHeader, verifyPaymentReceipt, verifySignature, x402AssetTransferMethod, x402AuthorizationAmount, x402FacilitatorAddresses, x402V2PaymentEnvelope };