@aegis-engine/core 0.6.0 → 0.7.0

package/README.md

@@ -582,3 +582,20 @@ concurrent package publishes from rebuilding shared workspace artifacts.
 pnpm build
 pnpm pack:check
 ```
+
+## Borrow collateral sizing
+
+`quoteEngineBorrowCapacity` reports `collateralFloor` as a settled result:
+`not-requested`, `ready-positive`, `ready-zero`, `infeasible`, or `unavailable`.
+Unavailable results include a reason and whether a fresh read may help. A null
+closed-form result is terminal for that request; it does not mean the request is
+still running. Zero means no additional collateral is needed at the sizing
+inputs; it is not permission to submit a new borrow. Its `outputSource`
+distinguishes existing idle tokens from new debt or an unknown legacy result.
+Only confirmed idle output supports a withdrawal review through the normal
+protected quote and authorization flow.
+`minimumNoSwapCollateralIn` remains available for compatibility, and
+`resolveEngineBorrowCollateralFloor` adapts older capacity snapshots.
+
+The result's `frame` identifies the market read used for sizing. Caller-supplied
+vault inputs and any executable transaction still require fresh validation.

package/dist/actions/directPoolSwap.d.ts

@@ -46,6 +46,8 @@ export declare function executeDirectPoolSwap(args: {
     slippageBps: number;
     displayedQuote?: DirectSwapQuote | null;
     approvalMode?: AegisSwapApprovalMode;
+    /** Finite cap for the next token and Permit2 approvals. Must cover the reviewed spend. */
+    approvalAmount?: bigint;
     signal?: AbortSignal;
     onWalletChainId?: (chainId: number | null) => void;
 } & AegisSwapActionCallbacks): Promise<AegisSwapActionResult<DirectSwapQuote>>;

package/dist/actions/kyberSwap.d.ts

@@ -23,6 +23,7 @@ export declare function approveKyberSwapInput(args: {
     amount: bigint;
     approvalMode?: AegisSwapApprovalMode;
     onStatus?: AegisSwapActionCallbacks['onStatus'];
+    onApprovalProgress?: AegisSwapActionCallbacks['onApprovalProgress'];
 }): Promise<KyberSwapApprovalResult>;
 export declare function executeKyberSwap(args: {
     wallet: WalletSession;

package/dist/actions/types.d.ts

@@ -26,6 +26,8 @@ export type AegisSwapApprovalRequest = {
  * adds a second prompt, and only it sees that reset's receipt.
  */
 export type AegisSwapApprovalProgress = {
+    /** Broadcast approval awaiting its receipt; absent before signing and after settlement. */
+    pendingHash?: Hex;
     /** Prompts the approval step opens: 0, 1, or 2 when a zero-reset precedes it. */
     planned: number;
     /** How many of `planned` have landed on-chain. */
@@ -40,6 +42,8 @@ export type AegisSwapApprovalProgress = {
  * signatures fail closed, so this is a count rather than a boolean.
  */
 export type AegisSwapAuthorizationProgress = {
+    /** On-chain Permit2 fallback awaiting its receipt; signatures have no hash. */
+    pendingHash?: Hex;
     /** Prompts this authorization step will open from the executor's live state. */
     planned: number;
     /** Prompts already completed by the wallet/user. */
@@ -50,15 +54,16 @@ export type AegisSwapActionCallbacks<TSwapDetails = AegisSwapSubmitDetails> = {
     onTxHash?: (hash: Hex | null) => void;
     onSubmitted?: (hash: Hex, swap?: TSwapDetails) => void;
     /**
-     * Fires with the plan before the first approval prompt opens, then again
-     * after each approval transaction mines. Once allowance resolution is
+     * Fires with the plan before the first approval prompt opens, when each
+     * approval is broadcast, and after it mines. Once allowance resolution is
      * reached, no required approval reports `{ planned: 0, completed: 0 }`.
      * Earlier chain-validation or quote failures can stop before this callback.
      */
     onApprovalProgress?: (progress: AegisSwapApprovalProgress) => void;
     /**
      * Fires before the first Permit2 authorization prompt, whenever the plan
-     * changes, and after each completed prompt. A reusable standing cap reports
+     * changes, when an on-chain fallback is broadcast, and after each completed
+     * prompt. A reusable standing cap reports
      * `{ planned: 0, completed: 0 }`.
      */
     onAuthorizationProgress?: (progress: AegisSwapAuthorizationProgress) => void;

package/dist/aegis-core.js

@@ -1,10 +1,10 @@
-import { A as s, b as i, c as r, d as t, e as n, f as o, g as c, h as E, i as S, j as A, k as g, l as d, m as _, n as l, o as p, p as b, q as P, r as T, t as u, u as h, v as m, w as k, x as I, y as R, z as C, B as w, C as G, D as B, E as D, F as N, G as M, H as y, K as v, I as W, J as U, M as O, L as F, N as L, O as f, P as K, S as H, Q as V, T as x, U as Q, R as q, V as z, W as X, X as Y, Y as j, Z, _ as J, $, a0 as aa, a1 as ea, a2 as sa, a3 as ia, a4 as ra, a5 as ta, a6 as na, a7 as oa, a8 as ca, a9 as Ea, aa as Sa, ab as Aa, ac as ga, ad as da, ae as _a, af as la, ag as pa, ah as ba, ai as Pa, aj as Ta, ak as ua, al as ha, am as ma, an as ka, ao as Ia, ap as Ra, aq as Ca, ar as wa, as as Ga, at as Ba, au as Da, av as Na, aw as Ma, ax as ya, ay as va, az as Wa, aA as Ua, aB as Oa, aC as Fa, aD as La, aE as fa, aF as Ka, aG as Ha, aH as Va, aI as xa, aJ as Qa, aK as qa, aL as za, aM as Xa, aN as Ya, aO as ja, aP as Za, aQ as Ja, aR as $a, aS as ae, aT as ee, aU as se, aV as ie, aW as re, aX as te, aY as ne, aZ as oe, a_ as ce, a$ as Ee, b0 as Se, b1 as Ae, b2 as ge, b3 as de, b4 as _e, b5 as le, b6 as pe, b7 as be, b8 as Pe, b9 as Te, ba as ue, bb as he, bc as me, bd as ke, be as Ie, bf as Re, bg as Ce, bh as we, bi as Ge, bj as Be, bk as De, bl as Ne, bm as Me, bn as ye, bo as ve, bp as We, bq as Ue, br as Oe, bs as Fe, bt as Le, bu as fe, bv as Ke, bw as He, bx as Ve, by as xe, bz as Qe, bA as qe, bB as ze, bC as Xe, bD as Ye, bE as je, bF as Ze, bG as Je, bH as $e, bI as as, bJ as es, bK as ss, bL as is, bM as rs, bN as ts, bO as ns, bP as os, bQ as cs, bR as Es, bS as Ss, bT as As, bU as gs, bV as ds, bW as _s, bX as ls, bY as ps, bZ as bs, b_ as Ps, b$ as Ts, c0 as us, c1 as hs, c2 as ms, c3 as ks, c4 as Is, c5 as Rs, c6 as Cs, c7 as ws, c8 as Gs, c9 as Bs, ca as Ds, cb as Ns, cc as Ms, cd as ys, ce as vs, cf as Ws, cg as Us, ch as Os, ci as Fs, cj as Ls } from "./index-D9EfUokZ.js";
+import { A as s, b as i, c as r, d as n, e as t, f as o, g as c, h as E, i as S, j as A, k as g, l as d, m as l, n as _, o as p, p as b, q as P, r as T, t as u, u as h, v as m, w as k, x as R, y as I, z as C, B as w, C as G, D as B, E as D, F as N, G as M, H as v, K as y, I as W, J as U, M as O, L as F, N as L, O as f, P as K, S as H, Q as V, T as q, U as x, R as Q, V as z, W as X, X as Y, Y as j, Z, _ as J, $, a0 as aa, a1 as ea, a2 as sa, a3 as ia, a4 as ra, a5 as na, a6 as ta, a7 as oa, a8 as ca, a9 as Ea, aa as Sa, ab as Aa, ac as ga, ad as da, ae as la, af as _a, ag as pa, ah as ba, ai as Pa, aj as Ta, ak as ua, al as ha, am as ma, an as ka, ao as Ra, ap as Ia, aq as Ca, ar as wa, as as Ga, at as Ba, au as Da, av as Na, aw as Ma, ax as va, ay as ya, az as Wa, aA as Ua, aB as Oa, aC as Fa, aD as La, aE as fa, aF as Ka, aG as Ha, aH as Va, aI as qa, aJ as xa, aK as Qa, aL as za, aM as Xa, aN as Ya, aO as ja, aP as Za, aQ as Ja, aR as $a, aS as ae, aT as ee, aU as se, aV as ie, aW as re, aX as ne, aY as te, aZ as oe, a_ as ce, a$ as Ee, b0 as Se, b1 as Ae, b2 as ge, b3 as de, b4 as le, b5 as _e, b6 as pe, b7 as be, b8 as Pe, b9 as Te, ba as ue, bb as he, bc as me, bd as ke, be as Re, bf as Ie, bg as Ce, bh as we, bi as Ge, bj as Be, bk as De, bl as Ne, bm as Me, bn as ve, bo as ye, bp as We, bq as Ue, br as Oe, bs as Fe, bt as Le, bu as fe, bv as Ke, bw as He, bx as Ve, by as qe, bz as xe, bA as Qe, bB as ze, bC as Xe, bD as Ye, bE as je, bF as Ze, bG as Je, bH as $e, bI as as, bJ as es, bK as ss, bL as is, bM as rs, bN as ns, bO as ts, bP as os, bQ as cs, bR as Es, bS as Ss, bT as As, bU as gs, bV as ds, bW as ls, bX as _s, bY as ps, bZ as bs, b_ as Ps, b$ as Ts, c0 as us, c1 as hs, c2 as ms, c3 as ks, c4 as Rs, c5 as Is, c6 as Cs, c7 as ws, c8 as Gs, c9 as Bs, ca as Ds, cb as Ns, cc as Ms, cd as vs, ce as ys, cf as Ws, cg as Us, ch as Os, ci as Fs, cj as Ls, ck as fs, cl as Ks, cm as Hs, cn as Vs } from "./index-DofKgro2.js";
 export {
   s as AEGIS_BACKEND_PROD_BASE_URL,
   i as AEGIS_DYNAMIC_FEE_FLAG,
   r as AEGIS_SWAP_CHAINS,
-  t as AEGIS_SWAP_CHAIN_ID,
-  n as AEGIS_SWAP_DEFAULT_FEE_BPS,
+  n as AEGIS_SWAP_CHAIN_ID,
+  t as AEGIS_SWAP_DEFAULT_FEE_BPS,
   o as AEGIS_SWAP_DEFAULT_FEE_RECIPIENT,
   c as AEGIS_SWAP_DEFAULT_METADATA_ENDPOINT,
   E as AEGIS_SWAP_DEFAULT_RPC_URLS,
@@ -12,8 +12,8 @@ export {
   A as AEGIS_SWAP_MAINNET_CHAIN,
   g as AEGIS_SWAP_MAINNET_UNISWAP_V4_CONTRACTS,
   d as AEGIS_SWAP_PERMIT2,
-  _ as AEGIS_SWAP_ROUTER,
-  l as AEGIS_SWAP_TOKENS,
+  l as AEGIS_SWAP_ROUTER,
+  _ as AEGIS_SWAP_TOKENS,
   p as AEGIS_SWAP_TRUSTED_ROUTERS_BY_CHAIN,
   b as AEGIS_SWAP_V4_QUOTER,
   P as AGGREGATED_SWAP_CURATED_TOKENS,
@@ -22,8 +22,8 @@ export {
   h as AGGREGATED_SWAP_SUPPORTED_CHAIN_IDS,
   m as AGGREGATED_SWAP_TOKEN_PRESETS,
   k as AGGREGATED_SWAP_WOLFGAME_TOKENS,
-  I as AGGREGATED_SWAP_WOLFGAME_TOKEN_LIST,
-  R as AegisBackendApiError,
+  R as AGGREGATED_SWAP_WOLFGAME_TOKEN_LIST,
+  I as AegisBackendApiError,
   C as AegisBackendContractError,
   w as AegisContractGuardError,
   G as AegisEngineMarketNotReadyError,
@@ -31,8 +31,8 @@ export {
   D as AggregatedSwapCalldataError,
   N as DEFAULT_PERMIT_EXPIRATION_SECONDS,
   M as DirectPoolSwapPriceMovedError,
-  y as ENGINE_UTILIZATION_CAP_PCT,
-  v as KyberSwapApiError,
+  v as ENGINE_UTILIZATION_CAP_PCT,
+  y as KyberSwapApiError,
   W as KyberSwapContractError,
   U as KyberSwapPriceMovedError,
   O as MAX_UINT128,
@@ -42,9 +42,9 @@ export {
   K as PERMIT2_FAR_FUTURE_EXPIRATION,
   H as SWAP_TX_DEADLINE_SECONDS,
   V as SubmittedTransactionReceiptError,
-  x as TransactionReceiptTimeoutError,
-  Q as UNISWAP_V4_CONTRACTS_BY_CHAIN,
-  q as USER_REJECTED_MESSAGE,
+  q as TransactionReceiptTimeoutError,
+  x as UNISWAP_V4_CONTRACTS_BY_CHAIN,
+  Q as USER_REJECTED_MESSAGE,
   z as UserFacingError,
   X as aegisBackendAddressAllowlistSchema,
   Y as aegisBackendAddressSchema,
@@ -57,8 +57,8 @@ export {
   sa as aegisBackendDecimalStringSchema,
   ia as aegisBackendFeeConfigSchema,
   ra as aegisBackendHealthResponseSchema,
-  ta as aegisBackendHexSchema,
-  na as aegisBackendIsoDateTimeSchema,
+  na as aegisBackendHexSchema,
+  ta as aegisBackendIsoDateTimeSchema,
   oa as aegisBackendMarketMetricsSchema,
   ca as aegisBackendMarketSchema,
   Ea as aegisBackendMarketStatusSchema,
@@ -66,8 +66,8 @@ export {
   Aa as aegisBackendQuoteDefaultsSchema,
   ga as aegisBackendQuoteModeSchema,
   da as aegisBackendSwapProviderSchema,
-  _a as aegisBackendSwapQuoteRequestSchema,
-  la as aegisBackendSwapQuoteResponseSchema,
+  la as aegisBackendSwapQuoteRequestSchema,
+  _a as aegisBackendSwapQuoteResponseSchema,
   pa as aegisBackendTokenSchema,
   ba as aegisBackendTokensResponseSchema,
   Pa as aegisPoolKeySchema,
@@ -76,8 +76,8 @@ export {
   ha as approveEnginePermit2ToRouter,
   ma as approveEngineTokenToPermit2,
   ka as approveErc20Spender,
-  Ia as approveErc20ToPermit2,
-  Ra as approveKyberSwapInput,
+  Ra as approveErc20ToPermit2,
+  Ia as approveKyberSwapInput,
   Ca as approvePermit2ToRouter,
   wa as assertCalldataHash,
   Ga as assertChainMatches,
@@ -85,8 +85,8 @@ export {
   Da as assertRouterAllowlisted,
   Na as assertSpenderAllowlisted,
   Ma as assertUint128,
-  ya as attachEngineActivityLotDisplays,
-  va as authorizeEnginePositionRouter,
+  va as attachEngineActivityLotDisplays,
+  ya as authorizeEnginePositionRouter,
   Wa as authorizeEngineVaultOperator,
   Ua as backendTokenToAegisSwapToken,
   Oa as backendTokensToAegisSwapTokens,
@@ -96,9 +96,9 @@ export {
   Ka as buildSignedPermitBatch,
   Ha as classifyEngineVaultActivity,
   Va as classifyError,
-  xa as clearEngineMarketHistoryCache,
-  Qa as clearEngineMarketsCache,
-  qa as clearEnginePositionActivityCache,
+  qa as clearEngineMarketHistoryCache,
+  xa as clearEngineMarketsCache,
+  Qa as clearEnginePositionActivityCache,
   za as clearEnginePositionsCache,
   Xa as clearEnginePositionsV2ProbeCache,
   Ya as clearEngineReadCaches,
@@ -111,93 +111,97 @@ export {
   se as createAegisSwapChains,
   ie as createAegisSwapChainsFromBackendConfig,
   re as createAegisSwapMarketsFromPools,
-  te as createAegisSwapPoolMarket,
-  ne as createAegisSwapPoolsFromBackendMarkets,
+  ne as createAegisSwapPoolMarket,
+  te as createAegisSwapPoolsFromBackendMarkets,
   oe as createAegisSwapUniswapV4Contracts,
   ce as createSwapPublicClient,
   Ee as deriveEngineActivityLotDisplay,
   Se as deriveEngineTradePositionStrategy,
   Ae as engineIdleWithdrawPassesResidualLtv,
-  ge as enginePermit2GrantSatisfies,
-  de as enginePreviewMaxLtvPips,
+  ge as engineMarketsRestResponseSchema,
+  de as enginePermit2GrantSatisfies,
+  le as enginePreviewMaxLtvPips,
   _e as engineRouterForChain,
-  le as engineTokenGrantSatisfies,
-  pe as ensureWalletChain,
-  be as errorMessage,
-  Pe as estimateSwapGasWithBuffer,
-  Te as executeDirectPoolSwap,
-  ue as executeKyberSwap,
-  he as executionLtvGuardPips,
-  me as fetchAggregatedSwapQuote,
-  ke as fetchDirectPoolSwapQuote,
+  pe as engineTokenGrantSatisfies,
+  be as ensureWalletChain,
+  Pe as errorMessage,
+  Te as estimateSwapGasWithBuffer,
+  ue as executeDirectPoolSwap,
+  he as executeKyberSwap,
+  me as executionLtvGuardPips,
+  ke as fetchAggregatedSwapQuote,
+  Re as fetchDirectPoolSwapQuote,
   Ie as fetchEngineLendActivity,
-  Re as fetchEngineMarketHistory,
-  Ce as fetchEngineMarkets,
-  we as fetchEnginePositionActivitySnapshot,
-  Ge as fetchEnginePositionsSnapshot,
-  Be as fetchEngineVaultActivity,
-  De as fetchGlobalTokenMetadata,
-  Ne as fetchKyberSwapRoute,
-  Me as fetchTokenPriceHistory,
+  Ce as fetchEngineMarketHistory,
+  we as fetchEngineMarkets,
+  Ge as fetchEnginePositionActivitySnapshot,
+  Be as fetchEnginePositionsSnapshot,
+  De as fetchEngineVaultActivity,
+  Ne as fetchGlobalTokenMetadata,
+  Me as fetchKyberSwapRoute,
+  ve as fetchTokenPriceHistory,
   ye as getExplorerUrl,
-  ve as getInjectedProvider,
-  We as getProviderAccount,
-  Ue as getProviderChainId,
-  Oe as getZeroForOne,
-  Fe as isAegisEngineTradePositionIntent,
-  Le as isBusy,
-  fe as isDocumentVisible,
-  Ke as isEip1193Provider,
-  He as isNativeAssetAddress,
-  Ve as isNativeToken,
+  We as getInjectedProvider,
+  Ue as getProviderAccount,
+  Oe as getProviderChainId,
+  Fe as getZeroForOne,
+  Le as isAegisEngineTradePositionIntent,
+  fe as isBusy,
+  Ke as isDocumentVisible,
+  He as isEip1193Provider,
+  Ve as isNativeAssetAddress,
+  qe as isNativeToken,
   xe as isRetryableAegisBackendApiError,
   Qe as isRetryableKyberSwapError,
-  qe as isSubmittedTransactionReceiptError,
-  ze as isUserRejectedError,
-  Xe as missingEngineExecutionReason,
-  Ye as normalizeAccount,
-  je as normalizeAegisBackendBaseUrl,
-  Ze as normalizeEngineMarkets,
-  Je as normalizeWalletConnection,
-  $e as outputFeeForQuote,
-  as as peekTokenPriceHistory,
-  es as pollUntil,
-  ss as prepareEnginePermit,
-  is as quoteEngineAddCollateral,
-  rs as quoteEngineBorrow,
-  ts as quoteEngineBorrowCapacity,
-  ns as quoteEngineCloseVault,
-  os as quoteEngineDeposit,
-  cs as quoteEngineIdleWithdraw,
-  Es as quoteEngineRedeem,
-  Ss as quoteEngineRepay,
-  As as quoteEngineTradeOpen,
-  gs as quoteSpendAmount,
-  ds as readEngineAuthorizationPlan,
-  _s as readEngineBorrowQuoteContext,
-  ls as readEngineLendQuoteContext,
-  ps as readEngineMarketMark,
-  bs as readEngineMarketSnapshot,
-  Ps as readEnginePositionsHydration,
-  Ts as readEngineVaultActivity,
-  us as readEngineVaultRouterApproved,
-  hs as readErc20Allowance,
-  ms as readPermit2RouterAllowance,
-  ks as reconcileSubmitQuote,
-  Is as reconcileSubmittedReceipt,
-  Rs as requestProviderAccount,
-  Cs as resolveTokenIconUrl,
-  ws as resolveWalletSession,
-  Gs as retryOnError,
-  Bs as sameQuote,
-  Ds as sendEngineTransaction,
-  Ns as subscribeProvider,
-  Ms as summarizeEngineLendShareGrowth,
-  ys as summarizeEngineSimpleYieldPosition,
-  vs as summarizeTransactionReceipt,
-  Ws as switchProviderChain,
-  Us as transactionProgressView,
-  Os as trustedEngineRegistryForChain,
-  Fs as trustedEngineVersionForChain,
-  Ls as waitForProviderChain
+  ze as isSubmittedTransactionReceiptError,
+  Xe as isUserRejectedError,
+  Ye as missingEngineExecutionReason,
+  je as normalizeAccount,
+  Ze as normalizeAegisBackendBaseUrl,
+  Je as normalizeEngineMarkets,
+  $e as normalizeWalletConnection,
+  as as outputFeeForQuote,
+  es as peekTokenPriceHistory,
+  ss as pollUntil,
+  is as prepareEnginePermit,
+  rs as progressRailSteps,
+  ns as quoteEngineAddCollateral,
+  ts as quoteEngineBorrow,
+  os as quoteEngineBorrowCapacity,
+  cs as quoteEngineCloseVault,
+  Es as quoteEngineDeposit,
+  Ss as quoteEngineIdleWithdraw,
+  As as quoteEngineRedeem,
+  gs as quoteEngineRepay,
+  ds as quoteEngineTradeOpen,
+  ls as quoteSpendAmount,
+  _s as readEngineAuthorizationPlan,
+  ps as readEngineBorrowQuoteContext,
+  bs as readEngineLendQuoteContext,
+  Ps as readEngineMarketMark,
+  Ts as readEngineMarketSnapshot,
+  us as readEnginePositionsHydration,
+  hs as readEngineVaultActivity,
+  ms as readEngineVaultRouterApproved,
+  ks as readErc20Allowance,
+  Rs as readPermit2RouterAllowance,
+  Is as reconcileSubmitQuote,
+  Cs as reconcileSubmittedReceipt,
+  ws as requestProviderAccount,
+  Gs as resolveEngineBorrowCollateralFloor,
+  Bs as resolveTokenIconUrl,
+  Ds as resolveWalletSession,
+  Ns as retryOnError,
+  Ms as sameQuote,
+  vs as sendEngineTransaction,
+  ys as subscribeProvider,
+  Ws as summarizeEngineLendShareGrowth,
+  Us as summarizeEngineSimpleYieldPosition,
+  Os as summarizeTransactionReceipt,
+  Fs as switchProviderChain,
+  Ls as transactionProgressView,
+  fs as transactionSequenceProgress,
+  Ks as trustedEngineRegistryForChain,
+  Hs as trustedEngineVersionForChain,
+  Vs as waitForProviderChain
 };

package/dist/engine/actions.d.ts

@@ -50,12 +50,16 @@ export type AegisEnginePositionRouterAuthorizationInput = {
  * executable quote after prerequisite receipts are mined.
  */
 export declare function readEngineAuthorizationPlan(args: AegisEngineAuthorizationPlanInput): Promise<AegisEngineAuthorizationPlan>;
+/** Explicit allowance edits; transaction preparation keeps sufficient grants. */
+type EngineAllowanceUpdateInput = AegisEngineApprovalInput & {
+    replaceAllowance?: boolean;
+};
 /** Grants only the ERC-20 allowance from the token to Permit2. */
-export declare function approveEngineTokenToPermit2(args: AegisEngineApprovalInput): Promise<{
+export declare function approveEngineTokenToPermit2(args: EngineAllowanceUpdateInput): Promise<{
     approvalHash: Hex | null;
 }>;
 /** Grants only the Permit2 spending cap from Permit2 to the Engine router. */
-export declare function approveEnginePermit2ToRouter(args: AegisEngineApprovalInput): Promise<void>;
+export declare function approveEnginePermit2ToRouter(args: EngineAllowanceUpdateInput): Promise<void>;
 export declare function prepareEnginePermit(args: AegisEngineApprovalInput): Promise<{
     approvalHash: Hex | null;
     permit: AegisEngineSignedPermitBatch | null;
@@ -99,3 +103,4 @@ export declare function missingEngineExecutionReason(market: {
     v4StateView?: Address;
     v4Quoter?: Address;
 }): string | null;
+export {};

package/dist/engine/borrowCollateralFloor.d.ts

@@ -0,0 +1,3 @@
+import type { AegisEngineBorrowCapacity, AegisEngineBorrowCollateralFloor } from './types.js';
+/** Compatibility boundary for hosts holding capacity snapshots from older Core versions. */
+export declare function resolveEngineBorrowCollateralFloor(capacity: AegisEngineBorrowCapacity): AegisEngineBorrowCollateralFloor;

package/dist/engine/borrowLimits.d.ts

@@ -0,0 +1,18 @@
+import type { engineSdkRuntime } from './sdkRuntime.js';
+type Sdk = typeof engineSdkRuntime;
+type Market = Parameters<Sdk['computeBorrowCapacity']>[0]['market'];
+type Vault = Parameters<Sdk['forwardFunctionNoSwap']>[0]['vault'];
+/** No-swap borrowing creates LP-shaped debt. A USD collateral × LTV ratio
+ * overstates the delivered asset, so size against the SDK's actual forward
+ * path and integer utilization headroom, in the same frame as the quote. */
+export declare function noSwapWalletBorrowLimit({ sdk, market, canonicalMarket, vault, deposit, upperBound, tauPips, slippageBps }: {
+    sdk: Pick<Sdk, 'forwardFunctionNoSwap' | 'utilizationHeadroomGammaNewLWad' | 'minDebtFloorRl'>;
+    market: Market;
+    canonicalMarket: Parameters<Sdk['forwardFunctionNoSwap']>[0]['market'];
+    vault: Vault;
+    deposit: bigint;
+    upperBound: bigint;
+    tauPips: number;
+    slippageBps: number;
+}): bigint;
+export {};

package/dist/engine/index.d.ts

@@ -7,6 +7,7 @@ export * from './marketAdapter.js';
 export * from './registry.js';
 export * from './reads.js';
 export * from './quotes.js';
+export * from './borrowCollateralFloor.js';
 export * from './actions.js';
 export * from './positionAmounts.js';
 export * from './positionStrategy.js';

package/dist/engine/types.d.ts

@@ -456,6 +456,9 @@ export type AegisEngineRestSource = {
  */
 export type AegisEngineStaticSource = {
     kind: 'static';
+    /** Read current balances and vault state for supplied positions through the
+     * host's public client. Opt in for interactive simulation or host indexes. */
+    hydratePositions?: boolean;
     markets: AegisEngineMarket[];
     positions?: AegisEnginePosition[];
     lendPositions?: AegisEngineLendSharesPosition[];
@@ -632,6 +635,10 @@ export type AegisEngineBorrowCapacityInput = Omit<AegisEngineQuoteBase, 'owner'
     /** Optional output-first target. When supplied, the result includes the
      *  collateral floor for the deterministic no-swap path. */
     borrowOut?: bigint;
+    /** Include wallet and market quick-fill limits in this same live frame. */
+    includeBorrowLimits?: boolean;
+    /** Spendable collateral after the native gas reserve; omitted when unknown. */
+    walletCollateralIn?: bigint;
     tauPips?: number;
     /** See `AegisEngineBorrowQuoteInput.tauPercentOfMaxLtv`. */
     tauPercentOfMaxLtv?: number;
@@ -1120,6 +1127,24 @@ export type AegisEngineVaultActivityEntry = {
     receivedRaw: bigint | null;
     receivedIsToken0: boolean | null;
 };
+/** Settled sizing result. A floor is planning data, never execution permission. */
+export type AegisEngineBorrowCollateralFloor = {
+    status: 'not-requested';
+} | {
+    status: 'ready-positive';
+    amountIn: bigint;
+} | {
+    status: 'ready-zero';
+    amountIn: 0n;
+    outputSource: 'existing-idle' | 'new-debt' | 'unknown';
+} | {
+    status: 'infeasible';
+    reason: 'utilization-capped';
+} | {
+    status: 'unavailable';
+    reason: 'closed-form-not-applicable' | 'forward-validation-unavailable' | 'legacy-no-floor';
+    retryable: boolean;
+};
 export type AegisEngineBorrowCapacity = {
     kind: 'borrow-capacity';
     market: AegisEngineMarket;
@@ -1135,16 +1160,25 @@ export type AegisEngineBorrowCapacity = {
     tauPercentOfMaxLtv: number | null;
     /** Echoed output target used to derive `minimumNoSwapCollateralIn`. */
     borrowOut: bigint | null;
-    /** Minimum fresh-vault deposit that crosses the SDK's integer no-swap
+    /** Minimum deposit for the supplied vault that crosses the SDK's integer no-swap
      *  boundary. Null when no output target was supplied, no closed-form
      *  no-swap solution exists, or the market is utilization-capped. */
     minimumNoSwapCollateralIn: bigint | null;
+    /** Always emitted by quoteEngineBorrowCapacity; optional for older host snapshots. */
+    collateralFloor?: AegisEngineBorrowCollateralFloor;
+    /** Market frame used for sizing; vault inputs still need executable revalidation. */
+    frame?: AegisEngineReadFrame;
     /** Equals `capacity.utilizationPre >= capacity.utilizationCap` at quote
      *  time. Named (rather than derived by consumers) because the SDK's stage
      *  classifier can mask a cap block behind preserve-vs-allow reachability
      *  (`preserve-collateral-blocked`), so `bindingConstraint`/quote reasons
      *  can't be trusted for it. When true no borrow executes for any deposit
      *  and no collateral floor is published. */
+    borrowLimits?: {
+        walletCollateralIn: bigint | null;
+        walletBorrowOut: bigint | null;
+        marketBorrowOut: bigint;
+    };
     utilizationCapped: boolean;
     capacity: {
         yMaxLtv: bigint;
@@ -1229,6 +1263,12 @@ export type AegisEngineAuthorizationPlan = {
     token: AegisEngineToken;
     amount: bigint;
     approvalMode: 'exact' | 'max';
+    /** Read observations drive permission presentation only, never submission authority. */
+    observations?: {
+        erc20Allowance: bigint | null;
+        permit2Allowance: readonly [bigint, number, number] | null;
+        permit2AuthorizationMode: 'signature' | 'spending-cap';
+    };
     router: Address;
     permit2: Address;
     vaultRegistry: Address;