@haven_ai/sdk 0.0.0-dev.202609302232.fc07bd1 → 0.0.0-dev.202609302323.7ff7df0

package/dist/{base64-ChRk2kJ4.d.cts → base64-BXtuto0G.d.cts}

@@ -808,6 +808,22 @@ interface HavenTaskBudget {
     delegationHash: string;
     label: string | null;
     maxAtomic: string;
+    /**
+     * #3501: camelCase form of `spent_atomic` — the live enforcer figure.
+     * Present on GET reads of an open task budget; null when the read failed;
+     * absent when the response did not read the chain.
+     */
+    spentAtomic?: string | null;
+    /**
+     * #3501: what the chain will still allow through this child (cap minus
+     * spent, clamped at zero). A failed read is null — never the full cap.
+     */
+    remainingAtomic?: string | null;
+    /**
+     * #3501: provenance of `remainingAtomic`, the parent allowance's honesty
+     * flag (`onchain.remainingIsFromChain`, #1319) on the task-budget surface.
+     */
+    remainingIsFromChain?: boolean;
     status: HavenTaskBudgetStatus;
     expiresAt: number;
     isExpired: boolean;
@@ -820,6 +836,15 @@ interface HavenTaskBudget {
  * #3329: the condensed row `getAgentSummary()` carries per open, unexpired
  * task budget — enough to render a "reserved by open task budgets" line and
  * a task-budget list without a second read.
+ *
+ * #3501: each row also carries the budget-visibility figure the issue asks
+ * for — what the chain will still allow through this child — so an agent
+ * reading `haven_get_agent` can tell BEFORE its next payment whether the
+ * task budget will refuse it. `remainingAtomic` is null when the on-chain
+ * read failed (never the full cap as remaining), and
+ * `remainingIsFromChain` is the same honesty flag the parent allowance's
+ * `onchain.remainingIsFromChain` carries (#1319): true = live enforcer
+ * read, false = the read failed and the figures are null.
  */
 interface HavenTaskBudgetSummary {
     id: string;
@@ -827,6 +852,28 @@ interface HavenTaskBudgetSummary {
     tokenAddress: string;
     maxAtomic: string;
     maxDisplay: string;
+    /**
+     * #3501: spent so far through this child, from the enforcer's `spentMap`.
+     * Null when the on-chain read failed; also null for a budget whose
+     * delegation the read could not speak for.
+     */
+    spentAtomic: string | null;
+    /**
+     * #3501: `maxAtomic` minus spent, clamped at zero. Null — never the full
+     * cap — when the on-chain read failed.
+     */
+    remainingAtomic: string | null;
+    /**
+     * #3501: true when `remainingAtomic` came from the live enforcer read,
+     * false when that read failed (spent/remaining are then null).
+     */
+    remainingIsFromChain: boolean;
+    /**
+     * #3501: human form of `remainingAtomic` ("0.001 USDC"), derived by the
+     * same formatter as `maxDisplay`. Null exactly when `remainingAtomic` is
+     * null — a failed read never renders as an amount.
+     */
+    remainingDisplay: string | null;
     recipientAddress: string | null;
     expiresAt: number;
 }
@@ -2090,7 +2137,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.202609302232.fc07bd1";
+declare const SDK_VERSION = "0.0.0-dev.202609302323.7ff7df0";
 /** 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-ChRk2kJ4.d.ts → base64-BXtuto0G.d.ts}

@@ -808,6 +808,22 @@ interface HavenTaskBudget {
     delegationHash: string;
     label: string | null;
     maxAtomic: string;
+    /**
+     * #3501: camelCase form of `spent_atomic` — the live enforcer figure.
+     * Present on GET reads of an open task budget; null when the read failed;
+     * absent when the response did not read the chain.
+     */
+    spentAtomic?: string | null;
+    /**
+     * #3501: what the chain will still allow through this child (cap minus
+     * spent, clamped at zero). A failed read is null — never the full cap.
+     */
+    remainingAtomic?: string | null;
+    /**
+     * #3501: provenance of `remainingAtomic`, the parent allowance's honesty
+     * flag (`onchain.remainingIsFromChain`, #1319) on the task-budget surface.
+     */
+    remainingIsFromChain?: boolean;
     status: HavenTaskBudgetStatus;
     expiresAt: number;
     isExpired: boolean;
@@ -820,6 +836,15 @@ interface HavenTaskBudget {
  * #3329: the condensed row `getAgentSummary()` carries per open, unexpired
  * task budget — enough to render a "reserved by open task budgets" line and
  * a task-budget list without a second read.
+ *
+ * #3501: each row also carries the budget-visibility figure the issue asks
+ * for — what the chain will still allow through this child — so an agent
+ * reading `haven_get_agent` can tell BEFORE its next payment whether the
+ * task budget will refuse it. `remainingAtomic` is null when the on-chain
+ * read failed (never the full cap as remaining), and
+ * `remainingIsFromChain` is the same honesty flag the parent allowance's
+ * `onchain.remainingIsFromChain` carries (#1319): true = live enforcer
+ * read, false = the read failed and the figures are null.
  */
 interface HavenTaskBudgetSummary {
     id: string;
@@ -827,6 +852,28 @@ interface HavenTaskBudgetSummary {
     tokenAddress: string;
     maxAtomic: string;
     maxDisplay: string;
+    /**
+     * #3501: spent so far through this child, from the enforcer's `spentMap`.
+     * Null when the on-chain read failed; also null for a budget whose
+     * delegation the read could not speak for.
+     */
+    spentAtomic: string | null;
+    /**
+     * #3501: `maxAtomic` minus spent, clamped at zero. Null — never the full
+     * cap — when the on-chain read failed.
+     */
+    remainingAtomic: string | null;
+    /**
+     * #3501: true when `remainingAtomic` came from the live enforcer read,
+     * false when that read failed (spent/remaining are then null).
+     */
+    remainingIsFromChain: boolean;
+    /**
+     * #3501: human form of `remainingAtomic` ("0.001 USDC"), derived by the
+     * same formatter as `maxDisplay`. Null exactly when `remainingAtomic` is
+     * null — a failed read never renders as an amount.
+     */
+    remainingDisplay: string | null;
     recipientAddress: string | null;
     expiresAt: number;
 }
@@ -2090,7 +2137,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.202609302232.fc07bd1";
+declare const SDK_VERSION = "0.0.0-dev.202609302323.7ff7df0";
 /** 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-ANJUPDH2.js → chunk-AD26YHAN.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-ANJUPDH2.js.map
-//# sourceMappingURL=chunk-ANJUPDH2.js.map
+//# sourceMappingURL=chunk-AD26YHAN.js.map
+//# sourceMappingURL=chunk-AD26YHAN.js.map