@haven_ai/sdk 0.0.0-dev.202609302247.f2e8289 → 0.0.0-dev.202610010927.3739fd3

package/dist/{base64-DKp_5E8w.d.cts → base64-CCJ8g3n3.d.cts}

@@ -794,6 +794,81 @@ interface HavenAgentSummary extends HavenAgent {
      * budgets", not a fetch failure).
      */
     taskBudgets: HavenTaskBudgetSummary[];
+    /**
+     * #3506: the sub-budget rows THIS agent must still sign as the DELEGATING
+     * agent — the owner issued a sub-budget (a parent-child row for this agent
+     * plus a grant to the sub-agent), and each row is `pending` until this
+     * agent's delegate key signs it (or `closing` until it signs the close).
+     * A derived VIEW, populated from `GET /sub-budgets?status=awaiting_signature`;
+     * empty (never throws) against a backend that predates the filter.
+     */
+    pendingSubBudgetSignatures: HavenPendingSubBudgetSignature[];
+}
+/**
+ * #3506: one sub-budget row awaiting THIS agent's signature — what
+ * `haven_get_agent` carries per row so the agent can call
+ * `haven_sign { sub_budget_id }` then `haven_submit { sub_budget_id, signature }`.
+ */
+interface HavenPendingSubBudgetSignature {
+    subBudgetId: string;
+    /** The parent-child row a grant hangs under; null on the parent-child row itself (they share a tree). */
+    parentSubBudgetId: string | null;
+    /** `open`: sign the child delegation (row is pending). `close`: sign the revocation (row is closing). */
+    purpose: 'open' | 'close';
+    /** `parent-child`: this agent's own narrowing of its budget. `grant`: the slice delegated to the sub-agent. */
+    what: 'parent-child' | 'grant';
+    /** The sub-agent that holds the grant; null on this agent's own parent-child row. */
+    subAgentId: string | null;
+    tokenAddress: string;
+    recipientAddress: string | null;
+    periodAmountAtomic: string;
+    expiresAt: number;
+    isExpired: boolean;
+}
+/** #3506: sub-budget lifecycle status, as the wire names it. */
+type HavenSubBudgetStatus = 'pending' | 'open' | 'closing' | 'closed';
+/** #3506: `RawSubBudget`, camelCased — what the SDK sub-budget methods return. */
+interface HavenSubBudget {
+    id: string;
+    agentId: string;
+    parentAgentId: string;
+    parentSubBudgetId: string | null;
+    chainId: number;
+    tokenAddress: string;
+    recipientAddress: string | null;
+    parentDelegationHash: string;
+    delegationHash: string;
+    label: string | null;
+    periodAmountAtomic: string;
+    status: HavenSubBudgetStatus;
+    expiresAt: number;
+    isExpired: boolean;
+    createdAt: string;
+    openedAt: string | null;
+    closedAt: string | null;
+    closeTxHash: string | null;
+}
+/** #3506: `POST /sub-budgets/:id/submit` — opened (from pending) or closed (from closing). */
+interface SubmitSubBudgetResult {
+    subBudget: HavenSubBudget;
+    status: 'open' | 'closed';
+    /** Present only once the close UserOp lands (`status === 'closed'` from `closing`). */
+    closeTxHash?: string;
+}
+/** #3506: the sign data a live-child close returns (the revocation UserOp's typed data). */
+interface HavenSubBudgetCloseSignData {
+    signature_scheme: 'eip712_userop';
+    typed_data: Record<string, unknown>;
+    user_op_hash: string;
+}
+/** #3506: `POST /sub-budgets/:id/close`. */
+interface CloseSubBudgetResult {
+    subBudget: HavenSubBudget;
+    /** `closed` on a trivial close (never signed, or already expired); absent when a close signature is pending. */
+    status?: 'closed';
+    /** Present only when the close needed a signature (a live child). */
+    signData?: HavenSubBudgetCloseSignData;
+    nextAction?: string;
 }
 /** #3329: task-budget lifecycle status, as the wire names it. */
 type HavenTaskBudgetStatus = 'pending' | 'open' | 'closing' | 'closed';
@@ -808,6 +883,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 +911,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 +927,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 +2212,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.202609302247.f2e8289";
+declare const SDK_VERSION = "0.0.0-dev.202610010927.3739fd3";
 /** 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}. */
@@ -3192,4 +3314,4 @@ declare function encodeBase64Json(value: unknown): string;
  */
 declare function decodeBase64Json<T>(value: string, label?: string): T;
 
-export { AgentPaymentPhase as $, type AgentPaymentWarning as A, type ResumeAuthorizedX402Input as B, type CloseTaskBudgetResult as C, type ResumeX402PaymentInput as D, type X402ResumeState as E, type X402McpTransport as F, type X402MerchantCallContext as G, type HavenClientConfig as H, HavenError as I, AGENT_PAYMENT_FAILURE_CODE_VALUES as J, AGENT_PAYMENT_NEXT_ACTION_VALUES as K, AGENT_PAYMENT_PHASE_VALUES as L, AGENT_PAYMENT_RAIL_VALUES as M, type AgentNextStep as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentPaymentEnumSchema as Q, type RawPaymentParties as R, type SweepResult as S, type TaskBudgetSignContext as T, AgentPaymentFailureCode as U, AgentPaymentFailureCodeDescriptions as V, AgentPaymentFailureCodeSchema as W, type X402PaymentRequired as X, AgentPaymentNextAction as Y, AgentPaymentNextActionDescriptions as Z, AgentPaymentNextActionSchema as _, type HavenClientUpdate as a, type SweepExpectedAuth as a$, AgentPaymentPhaseDescriptions as a0, AgentPaymentPhaseSchema as a1, AgentPaymentRail as a2, AgentPaymentRailDescriptions as a3, AgentPaymentRailSchema as a4, type AgentPaymentSummary as a5, AgentPaymentWarningCode as a6, type AgentPurchaseSummary as a7, CONNECTOR_PACKAGE_NAME as a8, type CatalogSubmissionAccepted as a9, NEXT_TOOL_SERVER_NAMES as aA, NEXT_TOOL_SERVER_ROLES as aB, type NextStep as aC, type NextStepArguments as aD, type NextStepHandoff as aE, type NextStepInput as aF, type NextStepTarget as aG, type NextStepTargets as aH, type NextToolServerRole as aI, PACKED_USER_OPERATION_FIELDS as aJ, type PaymentFee as aK, type PaymentNextAction as aL, type PaymentPhase as aM, type PaymentStatus as aN, ROOT_AUTHORITY as aO, SDK_CLIENT_IDENTITY as aP, SDK_VERSION as aQ, SIGNER_UPDATE_FALLBACK as aR, SWEEP_BASE_CHAIN_ID as aS, SWEEP_BASE_SEPOLIA_CHAIN_ID as aT, SWEEP_BASE_SEPOLIA_USDC_ADDRESS as aU, SWEEP_BASE_USDC_ADDRESS as aV, type SettlementChildExpectation as aW, SignerRefusalCode as aX, type SweepConfirmation as aY, type SweepEip712Domain as aZ, type SweepEntry as a_, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, DEFAULT_NEXT_TOOL_BY_ACTION as ab, DIRECT_SIGN_CONTEXT_VERSION as ac, ENTRY_POINT_V07 as ad, ERC7710_ASSET_TRANSFER_METHOD as ae, HAVEN_CLIENT_HEADER as af, HAVEN_CONNECTOR_CHANNEL as ag, HAVEN_MINIMUM_NODE_VERSION as ah, HYBRID_DELEGATOR_DOMAIN_NAME as ai, HYBRID_DELEGATOR_DOMAIN_VERSION as aj, type HavenAgentAllowanceSummary as ak, type HavenAgentReadiness as al, type HavenAllowance as am, HavenApiError as an, type HavenCatalogMerchant as ao, type HavenListScope as ap, HavenPaymentStateError as aq, HavenSigningError as ar, HavenTimeoutError as as, HavenTypedDataRefusedError as at, HavenUnsupportedSignerVersionError as au, HavenUserOpBindingError as av, HavenZeroSettlementHashError as aw, MAX_TASK_BUDGET_TTL_SECONDS as ax, type MachinePaymentRail as ay, MerchantTimeoutError as az, type PaymentResult as b, resolveTokenBySymbol as b$, type SweepPreparation as b0, type SweepSubmitResult as b1, type SweepTypedData as b2, TASK_SIGN_CONTEXT_VERSION as b3, TRANSFER_WITH_AUTHORIZATION_TYPES as b4, TYPED_DATA_NOT_ALLOWED as b5, type TaskBudgetCloseExpectation as b6, type TaskChildExpectation as b7, type TaskChildTypedData as b8, type UnsupportedNodeVersionMessageOptions as b9, connectorRerunCommand as bA, connectorSpec as bB, connectorUpgradeCommand as bC, createNextStepBuilder as bD, decodeBase64Json as bE, decodeBase64Utf8 as bF, defaultNextToolFor as bG, deriveDelegateAccountAddress as bH, encodeBase64Json as bI, encodeBase64Utf8 as bJ, encodePaymentProof as bK, hashDelegation as bL, havenClientIdentity as bM, isConnectorChannel as bN, isErc7710Option as bO, isPackedUserOperationTypedData as bP, isSupportedNodeVersion as bQ, isSweepableChain as bR, isTaskChildTypedData as bS, normalizePaymentRequired as bT, packedUserOperationHash as bU, parseNextTool as bV, parsePaymentRequired as bW, parsePaymentRequiredResponse as bX, readClientUpdate as bY, renderNextTool as bZ, resolveConnectorChannel as b_, X402AlreadySettledError as ba, X402Erc7710AlreadySettledError as bb, type X402ExpectedAuth as bc, type X402ExpectedContext as bd, type X402PaymentHeaderContext as be, X402PaymentHeaderValidationError as bf, type X402PaymentOption as bg, type X402RequestSnapshot as bh, type X402SchemeSelection as bi, X402TaskBudgetMismatchError as bj, X402UnexpectedStatusError as bk, X402_LEGACY_PAYMENT_HEADER_NAME as bl, X402_MAX_AUTHORIZATION_WINDOW_SECONDS as bm, X402_PAYMENT_HEADER_NAME as bn, X402_PAYMENT_HEADER_NAMES_SENT as bo, X402_PAYMENT_REQUIRED_HEADER_NAME as bp, X402_PAYMENT_RESPONSE_HEADER_NAME as bq, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS as br, assertBoundDirectPaymentUserOp as bs, assertOwnTaskBudgetCloseUserOp as bt, assertOwnTaskChild as bu, assertUserOpTypedDataBinding as bv, buildSweepAuthorizationMessage as bw, buildSweepTypedData as bx, buildX402ExpectedMessage as by, compareNodeVersions as bz, type PaymentIntent as c, resolveTokenFromAddress as c0, selectErc7710PaymentOption as c1, selectPaymentOption as c2, selectStandardPaymentOption as c3, selectX402SettlementScheme as c4, signerUpdateFallback as c5, sweepUsdcAddress as c6, sweepUsdcDomain as c7, toStandardPaymentRequirements as c8, unsupportedNodeVersionMessage as c9, validateStandardX402PaymentHeader as ca, verifySettlementChild as cb, x402AssetTransferMethod as cc, x402AuthorizationAmount as cd, x402FacilitatorAddresses as ce, x402V2PaymentEnvelope as cf, type DelegationForHashing as cg, CAVEAT_ENFORCERS as ch, CAVEAT_TYPEHASH as ci, DELEGATION_MANAGER as cj, DELEGATION_TYPEHASH as ck, DIRECT_PAYMENT_CHAIN_IDS as cl, EXECUTE_ABI as cm, HYBRID_DELEGATOR_IMPLEMENTATION as cn, MAX_SETTLEMENT_WINDOW_SECONDS as co, SIMPLE_FACTORY_ADDRESS as cp, type SettlementChildTypedData as cq, assertFundingLegPaysDelegate as cr, assertOwnSettlementChild as cs, chainIdForNetwork as ct, isSettlementChildTypedData as cu, type X402AuthorizationOptions as d, type X402Intent as e, type PaymentStatusResult as f, type HavenAgent as g, type HavenAgentSummary as h, type SweepPrepareResponse as i, type SweepAuthorization as j, type SweepSubmitResponse as k, type HavenAllowanceSummary as l, type HavenBalanceCoverage as m, type PostPurchaseAllowanceSummary as n, type HavenCatalogEntry as o, type HavenCatalogSubmission as p, type HavenPaymentReceipt as q, type HavenPaymentReceiptsPage as r, type HavenTaskBudget as s, type SubmitTaskBudgetResult as t, type PaymentResumeState as u, type X402Receipt as v, type X402Quote as w, type X402Erc7710Settlement as x, type X402McpCallContext as y, type SignData as z };
+export { AgentPaymentNextAction as $, type AgentPaymentWarning as A, type X402Erc7710Settlement as B, type CloseTaskBudgetResult as C, type X402McpCallContext as D, type SignData as E, type ResumeAuthorizedX402Input as F, type ResumeX402PaymentInput as G, type HavenClientConfig as H, type X402ResumeState as I, type X402McpTransport as J, type X402MerchantCallContext as K, HavenError as L, AGENT_PAYMENT_FAILURE_CODE_VALUES as M, AGENT_PAYMENT_NEXT_ACTION_VALUES as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, AGENT_PAYMENT_PHASE_VALUES as Q, type RawPaymentParties as R, type SweepResult as S, type TaskBudgetSignContext as T, AGENT_PAYMENT_RAIL_VALUES as U, type AgentNextStep as V, type AgentPaymentEnumSchema as W, type X402PaymentRequired as X, AgentPaymentFailureCode as Y, AgentPaymentFailureCodeDescriptions as Z, AgentPaymentFailureCodeSchema as _, type HavenClientUpdate as a, type SweepConfirmation as a$, AgentPaymentNextActionDescriptions as a0, AgentPaymentNextActionSchema as a1, AgentPaymentPhase as a2, AgentPaymentPhaseDescriptions as a3, AgentPaymentPhaseSchema as a4, AgentPaymentRail as a5, AgentPaymentRailDescriptions as a6, AgentPaymentRailSchema as a7, type AgentPaymentSummary as a8, AgentPaymentWarningCode as a9, MAX_TASK_BUDGET_TTL_SECONDS as aA, type MachinePaymentRail as aB, MerchantTimeoutError as aC, NEXT_TOOL_SERVER_NAMES as aD, NEXT_TOOL_SERVER_ROLES as aE, type NextStep as aF, type NextStepArguments as aG, type NextStepHandoff as aH, type NextStepInput as aI, type NextStepTarget as aJ, type NextStepTargets as aK, type NextToolServerRole as aL, PACKED_USER_OPERATION_FIELDS as aM, type PaymentFee as aN, type PaymentNextAction as aO, type PaymentPhase as aP, type PaymentStatus as aQ, ROOT_AUTHORITY as aR, SDK_CLIENT_IDENTITY as aS, SDK_VERSION as aT, SIGNER_UPDATE_FALLBACK as aU, SWEEP_BASE_CHAIN_ID as aV, SWEEP_BASE_SEPOLIA_CHAIN_ID as aW, SWEEP_BASE_SEPOLIA_USDC_ADDRESS as aX, SWEEP_BASE_USDC_ADDRESS as aY, type SettlementChildExpectation as aZ, SignerRefusalCode as a_, type AgentPurchaseSummary as aa, CONNECTOR_PACKAGE_NAME as ab, type CatalogSubmissionAccepted as ac, DEFAULT_CONFIRMATION_TIMEOUT_MS as ad, DEFAULT_NEXT_TOOL_BY_ACTION as ae, DIRECT_SIGN_CONTEXT_VERSION as af, ENTRY_POINT_V07 as ag, ERC7710_ASSET_TRANSFER_METHOD as ah, HAVEN_CLIENT_HEADER as ai, HAVEN_CONNECTOR_CHANNEL as aj, HAVEN_MINIMUM_NODE_VERSION as ak, HYBRID_DELEGATOR_DOMAIN_NAME as al, HYBRID_DELEGATOR_DOMAIN_VERSION as am, type HavenAgentAllowanceSummary as an, type HavenAgentReadiness as ao, type HavenAllowance as ap, HavenApiError as aq, type HavenCatalogMerchant as ar, type HavenListScope as as, HavenPaymentStateError as at, HavenSigningError as au, HavenTimeoutError as av, HavenTypedDataRefusedError as aw, HavenUnsupportedSignerVersionError as ax, HavenUserOpBindingError as ay, HavenZeroSettlementHashError as az, type PaymentResult as b, readClientUpdate as b$, type SweepEip712Domain as b0, type SweepEntry as b1, type SweepExpectedAuth as b2, type SweepPreparation as b3, type SweepSubmitResult as b4, type SweepTypedData as b5, TASK_SIGN_CONTEXT_VERSION as b6, TRANSFER_WITH_AUTHORIZATION_TYPES as b7, TYPED_DATA_NOT_ALLOWED as b8, type TaskBudgetCloseExpectation as b9, buildSweepTypedData as bA, buildX402ExpectedMessage as bB, compareNodeVersions as bC, connectorRerunCommand as bD, connectorSpec as bE, connectorUpgradeCommand as bF, createNextStepBuilder as bG, decodeBase64Json as bH, decodeBase64Utf8 as bI, defaultNextToolFor as bJ, deriveDelegateAccountAddress as bK, encodeBase64Json as bL, encodeBase64Utf8 as bM, encodePaymentProof as bN, hashDelegation as bO, havenClientIdentity as bP, isConnectorChannel as bQ, isErc7710Option as bR, isPackedUserOperationTypedData as bS, isSupportedNodeVersion as bT, isSweepableChain as bU, isTaskChildTypedData as bV, normalizePaymentRequired as bW, packedUserOperationHash as bX, parseNextTool as bY, parsePaymentRequired as bZ, parsePaymentRequiredResponse as b_, type TaskChildExpectation as ba, type TaskChildTypedData as bb, type UnsupportedNodeVersionMessageOptions as bc, X402AlreadySettledError as bd, X402Erc7710AlreadySettledError as be, type X402ExpectedAuth as bf, type X402ExpectedContext as bg, type X402PaymentHeaderContext as bh, X402PaymentHeaderValidationError as bi, type X402PaymentOption as bj, type X402RequestSnapshot as bk, type X402SchemeSelection as bl, X402TaskBudgetMismatchError as bm, X402UnexpectedStatusError as bn, X402_LEGACY_PAYMENT_HEADER_NAME as bo, X402_MAX_AUTHORIZATION_WINDOW_SECONDS as bp, X402_PAYMENT_HEADER_NAME as bq, X402_PAYMENT_HEADER_NAMES_SENT as br, X402_PAYMENT_REQUIRED_HEADER_NAME as bs, X402_PAYMENT_RESPONSE_HEADER_NAME as bt, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS as bu, assertBoundDirectPaymentUserOp as bv, assertOwnTaskBudgetCloseUserOp as bw, assertOwnTaskChild as bx, assertUserOpTypedDataBinding as by, buildSweepAuthorizationMessage as bz, type PaymentIntent as c, renderNextTool as c0, resolveConnectorChannel as c1, resolveTokenBySymbol as c2, resolveTokenFromAddress as c3, selectErc7710PaymentOption as c4, selectPaymentOption as c5, selectStandardPaymentOption as c6, selectX402SettlementScheme as c7, signerUpdateFallback as c8, sweepUsdcAddress as c9, sweepUsdcDomain as ca, toStandardPaymentRequirements as cb, unsupportedNodeVersionMessage as cc, validateStandardX402PaymentHeader as cd, verifySettlementChild as ce, x402AssetTransferMethod as cf, x402AuthorizationAmount as cg, x402FacilitatorAddresses as ch, x402V2PaymentEnvelope as ci, type DelegationForHashing as cj, CAVEAT_ENFORCERS as ck, CAVEAT_TYPEHASH as cl, DELEGATION_MANAGER as cm, DELEGATION_TYPEHASH as cn, DIRECT_PAYMENT_CHAIN_IDS as co, EXECUTE_ABI as cp, HYBRID_DELEGATOR_IMPLEMENTATION as cq, MAX_SETTLEMENT_WINDOW_SECONDS as cr, SIMPLE_FACTORY_ADDRESS as cs, type SettlementChildTypedData as ct, assertFundingLegPaysDelegate as cu, assertOwnSettlementChild as cv, chainIdForNetwork as cw, isSettlementChildTypedData as cx, type X402AuthorizationOptions as d, type X402Intent as e, type PaymentStatusResult as f, type HavenAgent as g, type HavenAgentSummary as h, type SweepPrepareResponse as i, type SweepAuthorization as j, type SweepSubmitResponse as k, type HavenAllowanceSummary as l, type HavenBalanceCoverage as m, type PostPurchaseAllowanceSummary as n, type HavenCatalogEntry as o, type HavenCatalogSubmission as p, type HavenPaymentReceipt as q, type HavenPaymentReceiptsPage as r, type HavenTaskBudget as s, type SubmitTaskBudgetResult as t, type SubmitSubBudgetResult as u, type HavenPendingSubBudgetSignature as v, type CloseSubBudgetResult as w, type PaymentResumeState as x, type X402Receipt as y, type X402Quote as z };

package/dist/{base64-DKp_5E8w.d.ts → base64-CCJ8g3n3.d.ts}

@@ -794,6 +794,81 @@ interface HavenAgentSummary extends HavenAgent {
      * budgets", not a fetch failure).
      */
     taskBudgets: HavenTaskBudgetSummary[];
+    /**
+     * #3506: the sub-budget rows THIS agent must still sign as the DELEGATING
+     * agent — the owner issued a sub-budget (a parent-child row for this agent
+     * plus a grant to the sub-agent), and each row is `pending` until this
+     * agent's delegate key signs it (or `closing` until it signs the close).
+     * A derived VIEW, populated from `GET /sub-budgets?status=awaiting_signature`;
+     * empty (never throws) against a backend that predates the filter.
+     */
+    pendingSubBudgetSignatures: HavenPendingSubBudgetSignature[];
+}
+/**
+ * #3506: one sub-budget row awaiting THIS agent's signature — what
+ * `haven_get_agent` carries per row so the agent can call
+ * `haven_sign { sub_budget_id }` then `haven_submit { sub_budget_id, signature }`.
+ */
+interface HavenPendingSubBudgetSignature {
+    subBudgetId: string;
+    /** The parent-child row a grant hangs under; null on the parent-child row itself (they share a tree). */
+    parentSubBudgetId: string | null;
+    /** `open`: sign the child delegation (row is pending). `close`: sign the revocation (row is closing). */
+    purpose: 'open' | 'close';
+    /** `parent-child`: this agent's own narrowing of its budget. `grant`: the slice delegated to the sub-agent. */
+    what: 'parent-child' | 'grant';
+    /** The sub-agent that holds the grant; null on this agent's own parent-child row. */
+    subAgentId: string | null;
+    tokenAddress: string;
+    recipientAddress: string | null;
+    periodAmountAtomic: string;
+    expiresAt: number;
+    isExpired: boolean;
+}
+/** #3506: sub-budget lifecycle status, as the wire names it. */
+type HavenSubBudgetStatus = 'pending' | 'open' | 'closing' | 'closed';
+/** #3506: `RawSubBudget`, camelCased — what the SDK sub-budget methods return. */
+interface HavenSubBudget {
+    id: string;
+    agentId: string;
+    parentAgentId: string;
+    parentSubBudgetId: string | null;
+    chainId: number;
+    tokenAddress: string;
+    recipientAddress: string | null;
+    parentDelegationHash: string;
+    delegationHash: string;
+    label: string | null;
+    periodAmountAtomic: string;
+    status: HavenSubBudgetStatus;
+    expiresAt: number;
+    isExpired: boolean;
+    createdAt: string;
+    openedAt: string | null;
+    closedAt: string | null;
+    closeTxHash: string | null;
+}
+/** #3506: `POST /sub-budgets/:id/submit` — opened (from pending) or closed (from closing). */
+interface SubmitSubBudgetResult {
+    subBudget: HavenSubBudget;
+    status: 'open' | 'closed';
+    /** Present only once the close UserOp lands (`status === 'closed'` from `closing`). */
+    closeTxHash?: string;
+}
+/** #3506: the sign data a live-child close returns (the revocation UserOp's typed data). */
+interface HavenSubBudgetCloseSignData {
+    signature_scheme: 'eip712_userop';
+    typed_data: Record<string, unknown>;
+    user_op_hash: string;
+}
+/** #3506: `POST /sub-budgets/:id/close`. */
+interface CloseSubBudgetResult {
+    subBudget: HavenSubBudget;
+    /** `closed` on a trivial close (never signed, or already expired); absent when a close signature is pending. */
+    status?: 'closed';
+    /** Present only when the close needed a signature (a live child). */
+    signData?: HavenSubBudgetCloseSignData;
+    nextAction?: string;
 }
 /** #3329: task-budget lifecycle status, as the wire names it. */
 type HavenTaskBudgetStatus = 'pending' | 'open' | 'closing' | 'closed';
@@ -808,6 +883,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 +911,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 +927,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 +2212,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.202609302247.f2e8289";
+declare const SDK_VERSION = "0.0.0-dev.202610010927.3739fd3";
 /** 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}. */
@@ -3192,4 +3314,4 @@ declare function encodeBase64Json(value: unknown): string;
  */
 declare function decodeBase64Json<T>(value: string, label?: string): T;
 
-export { AgentPaymentPhase as $, type AgentPaymentWarning as A, type ResumeAuthorizedX402Input as B, type CloseTaskBudgetResult as C, type ResumeX402PaymentInput as D, type X402ResumeState as E, type X402McpTransport as F, type X402MerchantCallContext as G, type HavenClientConfig as H, HavenError as I, AGENT_PAYMENT_FAILURE_CODE_VALUES as J, AGENT_PAYMENT_NEXT_ACTION_VALUES as K, AGENT_PAYMENT_PHASE_VALUES as L, AGENT_PAYMENT_RAIL_VALUES as M, type AgentNextStep as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, type AgentPaymentEnumSchema as Q, type RawPaymentParties as R, type SweepResult as S, type TaskBudgetSignContext as T, AgentPaymentFailureCode as U, AgentPaymentFailureCodeDescriptions as V, AgentPaymentFailureCodeSchema as W, type X402PaymentRequired as X, AgentPaymentNextAction as Y, AgentPaymentNextActionDescriptions as Z, AgentPaymentNextActionSchema as _, type HavenClientUpdate as a, type SweepExpectedAuth as a$, AgentPaymentPhaseDescriptions as a0, AgentPaymentPhaseSchema as a1, AgentPaymentRail as a2, AgentPaymentRailDescriptions as a3, AgentPaymentRailSchema as a4, type AgentPaymentSummary as a5, AgentPaymentWarningCode as a6, type AgentPurchaseSummary as a7, CONNECTOR_PACKAGE_NAME as a8, type CatalogSubmissionAccepted as a9, NEXT_TOOL_SERVER_NAMES as aA, NEXT_TOOL_SERVER_ROLES as aB, type NextStep as aC, type NextStepArguments as aD, type NextStepHandoff as aE, type NextStepInput as aF, type NextStepTarget as aG, type NextStepTargets as aH, type NextToolServerRole as aI, PACKED_USER_OPERATION_FIELDS as aJ, type PaymentFee as aK, type PaymentNextAction as aL, type PaymentPhase as aM, type PaymentStatus as aN, ROOT_AUTHORITY as aO, SDK_CLIENT_IDENTITY as aP, SDK_VERSION as aQ, SIGNER_UPDATE_FALLBACK as aR, SWEEP_BASE_CHAIN_ID as aS, SWEEP_BASE_SEPOLIA_CHAIN_ID as aT, SWEEP_BASE_SEPOLIA_USDC_ADDRESS as aU, SWEEP_BASE_USDC_ADDRESS as aV, type SettlementChildExpectation as aW, SignerRefusalCode as aX, type SweepConfirmation as aY, type SweepEip712Domain as aZ, type SweepEntry as a_, DEFAULT_CONFIRMATION_TIMEOUT_MS as aa, DEFAULT_NEXT_TOOL_BY_ACTION as ab, DIRECT_SIGN_CONTEXT_VERSION as ac, ENTRY_POINT_V07 as ad, ERC7710_ASSET_TRANSFER_METHOD as ae, HAVEN_CLIENT_HEADER as af, HAVEN_CONNECTOR_CHANNEL as ag, HAVEN_MINIMUM_NODE_VERSION as ah, HYBRID_DELEGATOR_DOMAIN_NAME as ai, HYBRID_DELEGATOR_DOMAIN_VERSION as aj, type HavenAgentAllowanceSummary as ak, type HavenAgentReadiness as al, type HavenAllowance as am, HavenApiError as an, type HavenCatalogMerchant as ao, type HavenListScope as ap, HavenPaymentStateError as aq, HavenSigningError as ar, HavenTimeoutError as as, HavenTypedDataRefusedError as at, HavenUnsupportedSignerVersionError as au, HavenUserOpBindingError as av, HavenZeroSettlementHashError as aw, MAX_TASK_BUDGET_TTL_SECONDS as ax, type MachinePaymentRail as ay, MerchantTimeoutError as az, type PaymentResult as b, resolveTokenBySymbol as b$, type SweepPreparation as b0, type SweepSubmitResult as b1, type SweepTypedData as b2, TASK_SIGN_CONTEXT_VERSION as b3, TRANSFER_WITH_AUTHORIZATION_TYPES as b4, TYPED_DATA_NOT_ALLOWED as b5, type TaskBudgetCloseExpectation as b6, type TaskChildExpectation as b7, type TaskChildTypedData as b8, type UnsupportedNodeVersionMessageOptions as b9, connectorRerunCommand as bA, connectorSpec as bB, connectorUpgradeCommand as bC, createNextStepBuilder as bD, decodeBase64Json as bE, decodeBase64Utf8 as bF, defaultNextToolFor as bG, deriveDelegateAccountAddress as bH, encodeBase64Json as bI, encodeBase64Utf8 as bJ, encodePaymentProof as bK, hashDelegation as bL, havenClientIdentity as bM, isConnectorChannel as bN, isErc7710Option as bO, isPackedUserOperationTypedData as bP, isSupportedNodeVersion as bQ, isSweepableChain as bR, isTaskChildTypedData as bS, normalizePaymentRequired as bT, packedUserOperationHash as bU, parseNextTool as bV, parsePaymentRequired as bW, parsePaymentRequiredResponse as bX, readClientUpdate as bY, renderNextTool as bZ, resolveConnectorChannel as b_, X402AlreadySettledError as ba, X402Erc7710AlreadySettledError as bb, type X402ExpectedAuth as bc, type X402ExpectedContext as bd, type X402PaymentHeaderContext as be, X402PaymentHeaderValidationError as bf, type X402PaymentOption as bg, type X402RequestSnapshot as bh, type X402SchemeSelection as bi, X402TaskBudgetMismatchError as bj, X402UnexpectedStatusError as bk, X402_LEGACY_PAYMENT_HEADER_NAME as bl, X402_MAX_AUTHORIZATION_WINDOW_SECONDS as bm, X402_PAYMENT_HEADER_NAME as bn, X402_PAYMENT_HEADER_NAMES_SENT as bo, X402_PAYMENT_REQUIRED_HEADER_NAME as bp, X402_PAYMENT_RESPONSE_HEADER_NAME as bq, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS as br, assertBoundDirectPaymentUserOp as bs, assertOwnTaskBudgetCloseUserOp as bt, assertOwnTaskChild as bu, assertUserOpTypedDataBinding as bv, buildSweepAuthorizationMessage as bw, buildSweepTypedData as bx, buildX402ExpectedMessage as by, compareNodeVersions as bz, type PaymentIntent as c, resolveTokenFromAddress as c0, selectErc7710PaymentOption as c1, selectPaymentOption as c2, selectStandardPaymentOption as c3, selectX402SettlementScheme as c4, signerUpdateFallback as c5, sweepUsdcAddress as c6, sweepUsdcDomain as c7, toStandardPaymentRequirements as c8, unsupportedNodeVersionMessage as c9, validateStandardX402PaymentHeader as ca, verifySettlementChild as cb, x402AssetTransferMethod as cc, x402AuthorizationAmount as cd, x402FacilitatorAddresses as ce, x402V2PaymentEnvelope as cf, type DelegationForHashing as cg, CAVEAT_ENFORCERS as ch, CAVEAT_TYPEHASH as ci, DELEGATION_MANAGER as cj, DELEGATION_TYPEHASH as ck, DIRECT_PAYMENT_CHAIN_IDS as cl, EXECUTE_ABI as cm, HYBRID_DELEGATOR_IMPLEMENTATION as cn, MAX_SETTLEMENT_WINDOW_SECONDS as co, SIMPLE_FACTORY_ADDRESS as cp, type SettlementChildTypedData as cq, assertFundingLegPaysDelegate as cr, assertOwnSettlementChild as cs, chainIdForNetwork as ct, isSettlementChildTypedData as cu, type X402AuthorizationOptions as d, type X402Intent as e, type PaymentStatusResult as f, type HavenAgent as g, type HavenAgentSummary as h, type SweepPrepareResponse as i, type SweepAuthorization as j, type SweepSubmitResponse as k, type HavenAllowanceSummary as l, type HavenBalanceCoverage as m, type PostPurchaseAllowanceSummary as n, type HavenCatalogEntry as o, type HavenCatalogSubmission as p, type HavenPaymentReceipt as q, type HavenPaymentReceiptsPage as r, type HavenTaskBudget as s, type SubmitTaskBudgetResult as t, type PaymentResumeState as u, type X402Receipt as v, type X402Quote as w, type X402Erc7710Settlement as x, type X402McpCallContext as y, type SignData as z };
+export { AgentPaymentNextAction as $, type AgentPaymentWarning as A, type X402Erc7710Settlement as B, type CloseTaskBudgetResult as C, type X402McpCallContext as D, type SignData as E, type ResumeAuthorizedX402Input as F, type ResumeX402PaymentInput as G, type HavenClientConfig as H, type X402ResumeState as I, type X402McpTransport as J, type X402MerchantCallContext as K, HavenError as L, AGENT_PAYMENT_FAILURE_CODE_VALUES as M, AGENT_PAYMENT_NEXT_ACTION_VALUES as N, type OpenTaskBudgetResult as O, type PaymentRequest as P, AGENT_PAYMENT_PHASE_VALUES as Q, type RawPaymentParties as R, type SweepResult as S, type TaskBudgetSignContext as T, AGENT_PAYMENT_RAIL_VALUES as U, type AgentNextStep as V, type AgentPaymentEnumSchema as W, type X402PaymentRequired as X, AgentPaymentFailureCode as Y, AgentPaymentFailureCodeDescriptions as Z, AgentPaymentFailureCodeSchema as _, type HavenClientUpdate as a, type SweepConfirmation as a$, AgentPaymentNextActionDescriptions as a0, AgentPaymentNextActionSchema as a1, AgentPaymentPhase as a2, AgentPaymentPhaseDescriptions as a3, AgentPaymentPhaseSchema as a4, AgentPaymentRail as a5, AgentPaymentRailDescriptions as a6, AgentPaymentRailSchema as a7, type AgentPaymentSummary as a8, AgentPaymentWarningCode as a9, MAX_TASK_BUDGET_TTL_SECONDS as aA, type MachinePaymentRail as aB, MerchantTimeoutError as aC, NEXT_TOOL_SERVER_NAMES as aD, NEXT_TOOL_SERVER_ROLES as aE, type NextStep as aF, type NextStepArguments as aG, type NextStepHandoff as aH, type NextStepInput as aI, type NextStepTarget as aJ, type NextStepTargets as aK, type NextToolServerRole as aL, PACKED_USER_OPERATION_FIELDS as aM, type PaymentFee as aN, type PaymentNextAction as aO, type PaymentPhase as aP, type PaymentStatus as aQ, ROOT_AUTHORITY as aR, SDK_CLIENT_IDENTITY as aS, SDK_VERSION as aT, SIGNER_UPDATE_FALLBACK as aU, SWEEP_BASE_CHAIN_ID as aV, SWEEP_BASE_SEPOLIA_CHAIN_ID as aW, SWEEP_BASE_SEPOLIA_USDC_ADDRESS as aX, SWEEP_BASE_USDC_ADDRESS as aY, type SettlementChildExpectation as aZ, SignerRefusalCode as a_, type AgentPurchaseSummary as aa, CONNECTOR_PACKAGE_NAME as ab, type CatalogSubmissionAccepted as ac, DEFAULT_CONFIRMATION_TIMEOUT_MS as ad, DEFAULT_NEXT_TOOL_BY_ACTION as ae, DIRECT_SIGN_CONTEXT_VERSION as af, ENTRY_POINT_V07 as ag, ERC7710_ASSET_TRANSFER_METHOD as ah, HAVEN_CLIENT_HEADER as ai, HAVEN_CONNECTOR_CHANNEL as aj, HAVEN_MINIMUM_NODE_VERSION as ak, HYBRID_DELEGATOR_DOMAIN_NAME as al, HYBRID_DELEGATOR_DOMAIN_VERSION as am, type HavenAgentAllowanceSummary as an, type HavenAgentReadiness as ao, type HavenAllowance as ap, HavenApiError as aq, type HavenCatalogMerchant as ar, type HavenListScope as as, HavenPaymentStateError as at, HavenSigningError as au, HavenTimeoutError as av, HavenTypedDataRefusedError as aw, HavenUnsupportedSignerVersionError as ax, HavenUserOpBindingError as ay, HavenZeroSettlementHashError as az, type PaymentResult as b, readClientUpdate as b$, type SweepEip712Domain as b0, type SweepEntry as b1, type SweepExpectedAuth as b2, type SweepPreparation as b3, type SweepSubmitResult as b4, type SweepTypedData as b5, TASK_SIGN_CONTEXT_VERSION as b6, TRANSFER_WITH_AUTHORIZATION_TYPES as b7, TYPED_DATA_NOT_ALLOWED as b8, type TaskBudgetCloseExpectation as b9, buildSweepTypedData as bA, buildX402ExpectedMessage as bB, compareNodeVersions as bC, connectorRerunCommand as bD, connectorSpec as bE, connectorUpgradeCommand as bF, createNextStepBuilder as bG, decodeBase64Json as bH, decodeBase64Utf8 as bI, defaultNextToolFor as bJ, deriveDelegateAccountAddress as bK, encodeBase64Json as bL, encodeBase64Utf8 as bM, encodePaymentProof as bN, hashDelegation as bO, havenClientIdentity as bP, isConnectorChannel as bQ, isErc7710Option as bR, isPackedUserOperationTypedData as bS, isSupportedNodeVersion as bT, isSweepableChain as bU, isTaskChildTypedData as bV, normalizePaymentRequired as bW, packedUserOperationHash as bX, parseNextTool as bY, parsePaymentRequired as bZ, parsePaymentRequiredResponse as b_, type TaskChildExpectation as ba, type TaskChildTypedData as bb, type UnsupportedNodeVersionMessageOptions as bc, X402AlreadySettledError as bd, X402Erc7710AlreadySettledError as be, type X402ExpectedAuth as bf, type X402ExpectedContext as bg, type X402PaymentHeaderContext as bh, X402PaymentHeaderValidationError as bi, type X402PaymentOption as bj, type X402RequestSnapshot as bk, type X402SchemeSelection as bl, X402TaskBudgetMismatchError as bm, X402UnexpectedStatusError as bn, X402_LEGACY_PAYMENT_HEADER_NAME as bo, X402_MAX_AUTHORIZATION_WINDOW_SECONDS as bp, X402_PAYMENT_HEADER_NAME as bq, X402_PAYMENT_HEADER_NAMES_SENT as br, X402_PAYMENT_REQUIRED_HEADER_NAME as bs, X402_PAYMENT_RESPONSE_HEADER_NAME as bt, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS as bu, assertBoundDirectPaymentUserOp as bv, assertOwnTaskBudgetCloseUserOp as bw, assertOwnTaskChild as bx, assertUserOpTypedDataBinding as by, buildSweepAuthorizationMessage as bz, type PaymentIntent as c, renderNextTool as c0, resolveConnectorChannel as c1, resolveTokenBySymbol as c2, resolveTokenFromAddress as c3, selectErc7710PaymentOption as c4, selectPaymentOption as c5, selectStandardPaymentOption as c6, selectX402SettlementScheme as c7, signerUpdateFallback as c8, sweepUsdcAddress as c9, sweepUsdcDomain as ca, toStandardPaymentRequirements as cb, unsupportedNodeVersionMessage as cc, validateStandardX402PaymentHeader as cd, verifySettlementChild as ce, x402AssetTransferMethod as cf, x402AuthorizationAmount as cg, x402FacilitatorAddresses as ch, x402V2PaymentEnvelope as ci, type DelegationForHashing as cj, CAVEAT_ENFORCERS as ck, CAVEAT_TYPEHASH as cl, DELEGATION_MANAGER as cm, DELEGATION_TYPEHASH as cn, DIRECT_PAYMENT_CHAIN_IDS as co, EXECUTE_ABI as cp, HYBRID_DELEGATOR_IMPLEMENTATION as cq, MAX_SETTLEMENT_WINDOW_SECONDS as cr, SIMPLE_FACTORY_ADDRESS as cs, type SettlementChildTypedData as ct, assertFundingLegPaysDelegate as cu, assertOwnSettlementChild as cv, chainIdForNetwork as cw, isSettlementChildTypedData as cx, type X402AuthorizationOptions as d, type X402Intent as e, type PaymentStatusResult as f, type HavenAgent as g, type HavenAgentSummary as h, type SweepPrepareResponse as i, type SweepAuthorization as j, type SweepSubmitResponse as k, type HavenAllowanceSummary as l, type HavenBalanceCoverage as m, type PostPurchaseAllowanceSummary as n, type HavenCatalogEntry as o, type HavenCatalogSubmission as p, type HavenPaymentReceipt as q, type HavenPaymentReceiptsPage as r, type HavenTaskBudget as s, type SubmitTaskBudgetResult as t, type SubmitSubBudgetResult as u, type HavenPendingSubBudgetSignature as v, type CloseSubBudgetResult as w, type PaymentResumeState as x, type X402Receipt as y, type X402Quote as z };