@haven_ai/sdk 0.0.0-dev.202609291309.d369d9b → 0.0.0-dev.202609291912.efd0772

package/dist/{base64-ByIdX1Sk.d.cts → base64-DyOPH887.d.cts}

@@ -590,8 +590,12 @@ interface HavenAllowanceSummary {
  * (#1310). Read-only reporting — the on-chain policy remains the actual
  * spend gate either way, this only says what is left after the purchase.
  *
- * Deliberately the SAME rail-labeled field spelling as #1306's
- * catalog-purchase preflight `allowance` block (never a new spelling),
+ * #3464: the canonical key spelling is the ONE `haven_get_agent`'s
+ * `allowances[]` rows use — the read the server tells an agent to make
+ * first — with the figures named `remainingAtomic`, `remainingDisplay`,
+ * `resetPeriodMin`, `tokenSymbol`, `tokenAddress`. Deliberately the SAME
+ * spelling as #1306's catalog-purchase preflight `allowance` block (never a
+ * new spelling; the hosted result types carry the same names),
  * minus the preflight-only `sufficient` field: post-purchase reporting
  * answers "what is left", not "was this purchase covered". Read through the
  * exact same source as {@link HavenAllowanceSummary} / `haven_get_allowances`
@@ -599,19 +603,57 @@ interface HavenAllowanceSummary {
  * `deriveDelegationBudgets`-backed enforcer read, never `agent_allowances`),
  * so this can never disagree with `haven_get_allowances` for the same
  * fixture.
+ *
+ * The snake_case keys below are DEPRECATED since #3464 and kept for one
+ * deprecation window so existing readers keep working; every value is also
+ * emitted under the camelCase name above. Removal condition: once
+ * `packages/qa-agent` reads the camelCase keys on a released qa-agent build,
+ * the snake_case keys go — tracked as the additive-window close, not a
+ * separate decision. The new keys stay OPTIONAL on this exported type so
+ * existing constructors keep type-checking unchanged.
  */
 interface PostPurchaseAllowanceSummary {
-    /** Which on-chain policy primitive gates this agent's spend (#1306 labeling). */
-    rail: 'legacy' | 'delegation';
+    /**
+     * Which on-chain policy primitive gates this agent's spend (#1306
+     * labeling). #3464: `'legacy'` removed — unreachable since #1986/#2020
+     * (`GET /machine-payments/allowances` answers 410 before this summary is
+     * built), superseding #2265's keep-as-declared rationale; the public
+     * {@link HavenAgent.executionRail} keeps its declared union.
+     */
+    rail: 'delegation';
     /** Remaining atomic units, read through the same source as {@link HavenAllowance.onchain.remaining}. */
     remaining_atomic: string;
-    /** Human-readable remaining, e.g. "4.96 USDC". Omitted when the token's decimals are unknown. */
+    /**
+     * @deprecated #3464 — use `remainingAtomic` (same value). Kept for the
+     * deprecation window; removed once `packages/qa-agent` reads the camelCase
+     * keys.
+     */
     remaining_display?: string;
+    /** @deprecated #3464 — use `tokenSymbol` (same value). Same removal condition. */
     token_symbol?: string;
+    /** @deprecated #3464 — use `tokenAddress` (same value). Same removal condition. */
     token_address?: string;
-    /** Minutes — mirrors {@link HavenAllowance.resetPeriodMin} / the delegation's period. */
+    /** @deprecated #3464 — use `resetPeriodMin` (same value). Same removal condition. */
     reset_period?: number;
-    source: 'allowance_module' | 'active_delegations';
+    /**
+     * Which source produced the figures. #3464: `'allowance_module'` removed
+     * for the same unreachability as `rail: 'legacy'` above.
+     */
+    source: 'active_delegations';
+    /** Remaining atomic units — the same figure `remaining_atomic` carries. Optional on the type, always emitted at runtime. */
+    remainingAtomic?: string;
+    /**
+     * Human-readable remaining, formatted by the ONE shared formatter
+     * (`formatRemainingDisplay`) — always emitted at runtime, never omitted:
+     * an unknown-decimals token gets the same explicit atomic label
+     * `haven_get_agent`'s `allowances[]` rows carry. Optional on the type so
+     * existing constructors stay valid.
+     */
+    remainingDisplay?: string;
+    /** Minutes — mirrors {@link HavenAllowance.resetPeriodMin} / the delegation's period. */
+    resetPeriodMin?: number;
+    tokenSymbol?: string;
+    tokenAddress?: string;
 }
 /**
  * #3126 — the answer to "is there money actually HELD behind my budget?",
@@ -949,8 +991,10 @@ interface HavenPaymentReceipt {
     /**
      * The delegate → merchant settlement transaction (#2998). Trust level differs
      * by scheme: on erc7710 it is `txHash` itself and Haven VERIFIED it on-chain
-     * before the receipt existed; on eip3009 it is the merchant's claim as relayed
-     * (PAYMENT-RESPONSE), NOT verified on-chain by Haven — cite it as such.
+     * before the receipt existed. On eip3009 it is the settlement the agent
+     * reported through `reportSettlementEvidence()` when there is one, which Haven
+     * also VERIFIED on-chain (#3475); otherwise the merchant's claim as relayed
+     * (PAYMENT-RESPONSE), NOT verified on-chain by Haven — cite that as such.
      */
     settlementTxHash: string | null;
     chainId: number;
@@ -2033,7 +2077,7 @@ declare function buildSweepAuthorizationMessage(auth: SweepAuthorization): strin
  * This SDK's own version. Owned by `scripts/release-bump.mjs`, which rewrites
  * it with the package version on every release — never hand-edit it.
  */
-declare const SDK_VERSION = "0.0.0-dev.202609291309.d369d9b";
+declare const SDK_VERSION = "0.0.0-dev.202609291912.efd0772";
 /** The request header every published Haven client sends. */
 declare const HAVEN_CLIENT_HEADER = "X-Haven-Client";
 /** `<package>/<version>` — the value of {@link HAVEN_CLIENT_HEADER}. */

package/dist/{base64-ByIdX1Sk.d.ts → base64-DyOPH887.d.ts}

@@ -590,8 +590,12 @@ interface HavenAllowanceSummary {
  * (#1310). Read-only reporting — the on-chain policy remains the actual
  * spend gate either way, this only says what is left after the purchase.
  *
- * Deliberately the SAME rail-labeled field spelling as #1306's
- * catalog-purchase preflight `allowance` block (never a new spelling),
+ * #3464: the canonical key spelling is the ONE `haven_get_agent`'s
+ * `allowances[]` rows use — the read the server tells an agent to make
+ * first — with the figures named `remainingAtomic`, `remainingDisplay`,
+ * `resetPeriodMin`, `tokenSymbol`, `tokenAddress`. Deliberately the SAME
+ * spelling as #1306's catalog-purchase preflight `allowance` block (never a
+ * new spelling; the hosted result types carry the same names),
  * minus the preflight-only `sufficient` field: post-purchase reporting
  * answers "what is left", not "was this purchase covered". Read through the
  * exact same source as {@link HavenAllowanceSummary} / `haven_get_allowances`
@@ -599,19 +603,57 @@ interface HavenAllowanceSummary {
  * `deriveDelegationBudgets`-backed enforcer read, never `agent_allowances`),
  * so this can never disagree with `haven_get_allowances` for the same
  * fixture.
+ *
+ * The snake_case keys below are DEPRECATED since #3464 and kept for one
+ * deprecation window so existing readers keep working; every value is also
+ * emitted under the camelCase name above. Removal condition: once
+ * `packages/qa-agent` reads the camelCase keys on a released qa-agent build,
+ * the snake_case keys go — tracked as the additive-window close, not a
+ * separate decision. The new keys stay OPTIONAL on this exported type so
+ * existing constructors keep type-checking unchanged.
  */
 interface PostPurchaseAllowanceSummary {
-    /** Which on-chain policy primitive gates this agent's spend (#1306 labeling). */
-    rail: 'legacy' | 'delegation';
+    /**
+     * Which on-chain policy primitive gates this agent's spend (#1306
+     * labeling). #3464: `'legacy'` removed — unreachable since #1986/#2020
+     * (`GET /machine-payments/allowances` answers 410 before this summary is
+     * built), superseding #2265's keep-as-declared rationale; the public
+     * {@link HavenAgent.executionRail} keeps its declared union.
+     */
+    rail: 'delegation';
     /** Remaining atomic units, read through the same source as {@link HavenAllowance.onchain.remaining}. */
     remaining_atomic: string;
-    /** Human-readable remaining, e.g. "4.96 USDC". Omitted when the token's decimals are unknown. */
+    /**
+     * @deprecated #3464 — use `remainingAtomic` (same value). Kept for the
+     * deprecation window; removed once `packages/qa-agent` reads the camelCase
+     * keys.
+     */
     remaining_display?: string;
+    /** @deprecated #3464 — use `tokenSymbol` (same value). Same removal condition. */
     token_symbol?: string;
+    /** @deprecated #3464 — use `tokenAddress` (same value). Same removal condition. */
     token_address?: string;
-    /** Minutes — mirrors {@link HavenAllowance.resetPeriodMin} / the delegation's period. */
+    /** @deprecated #3464 — use `resetPeriodMin` (same value). Same removal condition. */
     reset_period?: number;
-    source: 'allowance_module' | 'active_delegations';
+    /**
+     * Which source produced the figures. #3464: `'allowance_module'` removed
+     * for the same unreachability as `rail: 'legacy'` above.
+     */
+    source: 'active_delegations';
+    /** Remaining atomic units — the same figure `remaining_atomic` carries. Optional on the type, always emitted at runtime. */
+    remainingAtomic?: string;
+    /**
+     * Human-readable remaining, formatted by the ONE shared formatter
+     * (`formatRemainingDisplay`) — always emitted at runtime, never omitted:
+     * an unknown-decimals token gets the same explicit atomic label
+     * `haven_get_agent`'s `allowances[]` rows carry. Optional on the type so
+     * existing constructors stay valid.
+     */
+    remainingDisplay?: string;
+    /** Minutes — mirrors {@link HavenAllowance.resetPeriodMin} / the delegation's period. */
+    resetPeriodMin?: number;
+    tokenSymbol?: string;
+    tokenAddress?: string;
 }
 /**
  * #3126 — the answer to "is there money actually HELD behind my budget?",
@@ -949,8 +991,10 @@ interface HavenPaymentReceipt {
     /**
      * The delegate → merchant settlement transaction (#2998). Trust level differs
      * by scheme: on erc7710 it is `txHash` itself and Haven VERIFIED it on-chain
-     * before the receipt existed; on eip3009 it is the merchant's claim as relayed
-     * (PAYMENT-RESPONSE), NOT verified on-chain by Haven — cite it as such.
+     * before the receipt existed. On eip3009 it is the settlement the agent
+     * reported through `reportSettlementEvidence()` when there is one, which Haven
+     * also VERIFIED on-chain (#3475); otherwise the merchant's claim as relayed
+     * (PAYMENT-RESPONSE), NOT verified on-chain by Haven — cite that as such.
      */
     settlementTxHash: string | null;
     chainId: number;
@@ -2033,7 +2077,7 @@ declare function buildSweepAuthorizationMessage(auth: SweepAuthorization): strin
  * This SDK's own version. Owned by `scripts/release-bump.mjs`, which rewrites
  * it with the package version on every release — never hand-edit it.
  */
-declare const SDK_VERSION = "0.0.0-dev.202609291309.d369d9b";
+declare const SDK_VERSION = "0.0.0-dev.202609291912.efd0772";
 /** The request header every published Haven client sends. */
 declare const HAVEN_CLIENT_HEADER = "X-Haven-Client";
 /** `<package>/<version>` — the value of {@link HAVEN_CLIENT_HEADER}. */

package/dist/{chunk-VMWFFNWS.js → chunk-5I6LGPWZ.js}

@@ -1016,5 +1016,5 @@ function assertRedeemsOwnBudgetDelegation(redeemCalldata, ownAccount) {
 }
 
 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, CAVEAT_ENFORCERS, CONNECTOR_PACKAGE_NAME, DEFAULT_CONFIRMATION_TIMEOUT_MS, DELEGATION_MANAGER, DELEGATION_TUPLE_COMPONENTS, DIRECT_SIGN_CONTEXT_VERSION, ENTRY_POINT_V07, HAVEN_CONNECTOR_CHANNEL, HYBRID_DELEGATOR_DOMAIN_NAME, HYBRID_DELEGATOR_DOMAIN_VERSION, HYBRID_DELEGATOR_IMPLEMENTATION, HavenApiError, HavenError, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, HavenUserOpBindingError, HavenZeroSettlementHashError, MAX_SETTLEMENT_WINDOW_SECONDS, MerchantTimeoutError, PACKED_USER_OPERATION_FIELDS, REDEEM_DELEGATIONS_ABI, ROOT_AUTHORITY, SIGNER_UPDATE_FALLBACK, SIMPLE_FACTORY_ADDRESS, SINGLE_DEFAULT_MODE, SignerRefusalCode, TASK_SIGN_CONTEXT_VERSION, X402AlreadySettledError, X402Erc7710AlreadySettledError, X402TaskBudgetMismatchError, X402UnexpectedStatusError, assertRedeemsOwnBudgetDelegation, assertUserOpTypedDataBinding, chainIdForNetwork, connectorRerunCommand, connectorSpec, connectorUpgradeCommand, deriveDelegateAccountAddress, isConnectorChannel, isPackedUserOperationTypedData, isSettlementChildTypedData, packedUserOperationHash, resolveConnectorChannel, signerUpdateFallback, verifySettlementChild };
-//# sourceMappingURL=chunk-VMWFFNWS.js.map
-//# sourceMappingURL=chunk-VMWFFNWS.js.map
+//# sourceMappingURL=chunk-5I6LGPWZ.js.map
+//# sourceMappingURL=chunk-5I6LGPWZ.js.map