@aegis-engine/core 0.1.3 → 0.3.0

package/dist/contract/index.d.ts

@@ -1,2 +1,3 @@
-export * from './guards';
-export * from './schemas';
+export * from './backendClient.js';
+export * from './guards.js';
+export * from './schemas.js';

package/dist/contract/schemas.d.ts

@@ -2,6 +2,7 @@ import { z } from 'zod';
 export declare const aegisBackendAddressSchema: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
 export declare const aegisBackendHexSchema: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
 export declare const aegisBackendDecimalStringSchema: z.ZodString;
+export declare const aegisBackendPositiveDecimalStringSchema: z.ZodString;
 export declare const aegisBackendIsoDateTimeSchema: z.ZodISODateTime;
 export declare const aegisBackendSwapProviderSchema: z.ZodEnum<{
     "aegis-direct-v4": "aegis-direct-v4";
@@ -15,12 +16,7 @@ export declare const aegisBackendMarketStatusSchema: z.ZodEnum<{
     enabled: "enabled";
     disabled: "disabled";
 }>;
-export declare const aegisBackendTxStatusSchema: z.ZodEnum<{
-    pending: "pending";
-    success: "success";
-    reverted: "reverted";
-    not_found: "not_found";
-}>;
+export declare const aegisBackendChainIdSchema: z.ZodLiteral<1 | 130 | 8453>;
 export declare const aegisBackendChainSchema: z.ZodObject<{
     chainId: z.ZodNumber;
     slug: z.ZodString;
@@ -36,12 +32,31 @@ export declare const aegisBackendAddressAllowlistSchema: z.ZodObject<{
     routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
     spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
 }, z.core.$strip>;
+export declare const aegisBackendContractsByChainSchema: z.ZodObject<{
+    '1': z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+    '130': z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+    '8453': z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+}, z.core.$strip>;
+export declare const aegisBackendAllowlistsByChainSchema: z.ZodObject<{
+    '1': z.ZodObject<{
+        routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+        spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+    }, z.core.$strip>;
+    '130': z.ZodObject<{
+        routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+        spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+    }, z.core.$strip>;
+    '8453': z.ZodObject<{
+        routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+        spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const aegisBackendFeeConfigSchema: z.ZodObject<{
     outputFeeBps: z.ZodNumber;
     recipient: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
 }, z.core.$strip>;
 export declare const aegisBackendConfigSchema: z.ZodObject<{
-    schemaVersion: z.ZodString;
+    schemaVersion: z.ZodLiteral<"1">;
     chains: z.ZodArray<z.ZodObject<{
         chainId: z.ZodNumber;
         slug: z.ZodString;
@@ -56,11 +71,25 @@ export declare const aegisBackendConfigSchema: z.ZodObject<{
         defaultSlippageBps: z.ZodNumber;
         maxSlippageBps: z.ZodNumber;
     }, z.core.$strip>;
-    contracts: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>>;
-    allowlists: z.ZodRecord<z.ZodString, z.ZodObject<{
-        routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
-        spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
-    }, z.core.$strip>>;
+    contracts: z.ZodObject<{
+        '1': z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+        '130': z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+        '8453': z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+    }, z.core.$strip>;
+    allowlists: z.ZodObject<{
+        '1': z.ZodObject<{
+            routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+            spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+        }, z.core.$strip>;
+        '130': z.ZodObject<{
+            routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+            spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+        }, z.core.$strip>;
+        '8453': z.ZodObject<{
+            routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+            spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
     fee: z.ZodObject<{
         outputFeeBps: z.ZodNumber;
         recipient: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
@@ -74,14 +103,14 @@ export declare const aegisBackendTokenSchema: z.ZodObject<{
     displayName: z.ZodString;
     fullName: z.ZodString;
     decimals: z.ZodNumber;
-    priceUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    iconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    stable: z.ZodOptional<z.ZodBoolean>;
+    priceUsd: z.ZodNumber;
+    iconUrl: z.ZodString;
+    stable: z.ZodBoolean;
 }, z.core.$strip>;
 export declare const aegisBackendMarketMetricsSchema: z.ZodObject<{
-    tvlUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    volumeUsd7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    feeApr7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    tvlUsd: z.ZodNumber;
+    volumeUsd7d: z.ZodNumber;
+    feeApr7d: z.ZodNumber;
 }, z.core.$strip>;
 export declare const aegisPoolKeySchema: z.ZodObject<{
     currency0: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
@@ -91,16 +120,13 @@ export declare const aegisPoolKeySchema: z.ZodObject<{
     hooks: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
 }, z.core.$strip>;
 export declare const aegisBackendMarketSchema: z.ZodObject<{
-    id: z.ZodString;
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     chainId: z.ZodNumber;
     status: z.ZodEnum<{
         enabled: "enabled";
         disabled: "disabled";
     }>;
-    kind: z.ZodEnum<{
-        "aegis-direct-v4": "aegis-direct-v4";
-        kyber: "kyber";
-    }>;
+    kind: z.ZodLiteral<"aegis-direct-v4">;
     label: z.ZodString;
     baseToken: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     quoteToken: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
@@ -112,18 +138,21 @@ export declare const aegisBackendMarketSchema: z.ZodObject<{
         tickSpacing: z.ZodNumber;
         hooks: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     }, z.core.$strip>;
-    metrics: z.ZodOptional<z.ZodObject<{
-        tvlUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        volumeUsd7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        feeApr7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    }, z.core.$strip>>;
-    warnings: z.ZodArray<z.ZodString>;
+    metrics: z.ZodObject<{
+        tvlUsd: z.ZodNumber;
+        volumeUsd7d: z.ZodNumber;
+        feeApr7d: z.ZodNumber;
+    }, z.core.$strip>;
+    warnings: z.ZodArray<z.ZodEnum<{
+        paused: "paused";
+        "surge-active": "surge-active";
+        "cap-event": "cap-event";
+    }>>;
 }, z.core.$strip>;
 export declare const aegisBackendSwapQuoteRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     mode: z.ZodLiteral<"exactIn">;
     amountIn: z.ZodString;
-    amountOut: z.ZodOptional<z.ZodNever>;
-    chainId: z.ZodNumber;
+    chainId: z.ZodLiteral<1 | 130 | 8453>;
     provider: z.ZodEnum<{
         "aegis-direct-v4": "aegis-direct-v4";
         kyber: "kyber";
@@ -133,11 +162,10 @@ export declare const aegisBackendSwapQuoteRequestSchema: z.ZodDiscriminatedUnion
     tokenOut: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     slippageBps: z.ZodNumber;
     account: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
-}, z.core.$strip>, z.ZodObject<{
+}, z.core.$loose>, z.ZodObject<{
     mode: z.ZodLiteral<"exactOut">;
     amountOut: z.ZodString;
-    amountIn: z.ZodOptional<z.ZodNever>;
-    chainId: z.ZodNumber;
+    chainId: z.ZodLiteral<1 | 130 | 8453>;
     provider: z.ZodEnum<{
         "aegis-direct-v4": "aegis-direct-v4";
         kyber: "kyber";
@@ -147,95 +175,27 @@ export declare const aegisBackendSwapQuoteRequestSchema: z.ZodDiscriminatedUnion
     tokenOut: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     slippageBps: z.ZodNumber;
     account: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
-}, z.core.$strip>], "mode">;
-export declare const aegisBackendSwapApprovalSchema: z.ZodObject<{
-    required: z.ZodBoolean;
-    model: z.ZodEnum<{
-        permit2: "permit2";
-        erc20: "erc20";
-        native: "native";
-        none: "none";
-    }>;
-    spender: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
-}, z.core.$strip>;
+}, z.core.$loose>], "mode">;
 export declare const aegisBackendSwapQuoteResponseSchema: z.ZodObject<{
-    quoteId: z.ZodString;
-    quoteHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    routeHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    expiresAt: z.ZodISODateTime;
-    quoteBlockNumber: z.ZodString;
-    provider: z.ZodEnum<{
-        "aegis-direct-v4": "aegis-direct-v4";
-        kyber: "kyber";
-    }>;
-    marketId: z.ZodOptional<z.ZodString>;
+    indicative: z.ZodLiteral<true>;
+    executable: z.ZodLiteral<false>;
+    provider: z.ZodLiteral<"aegis-direct-v4">;
+    marketId: z.ZodString;
+    mode: z.ZodLiteral<"exactIn">;
+    tokenIn: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    tokenOut: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     amountIn: z.ZodString;
     amountOut: z.ZodString;
     minAmountOut: z.ZodString;
-    gasEstimate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    approval: z.ZodObject<{
-        required: z.ZodBoolean;
-        model: z.ZodEnum<{
-            permit2: "permit2";
-            erc20: "erc20";
-            native: "native";
-            none: "none";
-        }>;
-        spender: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
-    }, z.core.$strip>;
+    price: z.ZodNumber;
+    slippageBps: z.ZodNumber;
     fee: z.ZodObject<{
         outputFeeBps: z.ZodNumber;
         recipient: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     }, z.core.$strip>;
+    asOf: z.ZodISODateTime;
     warnings: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
-export declare const aegisBackendSwapBuildRequestSchema: z.ZodObject<{
-    quoteId: z.ZodString;
-    account: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    recipient: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    permitSignature: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
-}, z.core.$strip>;
-export declare const aegisBackendUnsignedSwapTxSchema: z.ZodObject<{
-    chainId: z.ZodNumber;
-    to: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    value: z.ZodString;
-}, z.core.$strip>;
-export declare const aegisBackendSwapBuildResponseSchema: z.ZodObject<{
-    buildId: z.ZodString;
-    quoteId: z.ZodString;
-    routeHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    expectedCalldataHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-    expiresAt: z.ZodISODateTime;
-    tx: z.ZodObject<{
-        chainId: z.ZodNumber;
-        to: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-        data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-        value: z.ZodString;
-    }, z.core.$strip>;
-    allowance: z.ZodObject<{
-        spender: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
-        permit2Required: z.ZodBoolean;
-    }, z.core.$strip>;
-    simulation: z.ZodObject<{
-        ok: z.ZodBoolean;
-        blockNumber: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    warnings: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-export declare const aegisBackendTxStatusResponseSchema: z.ZodObject<{
-    status: z.ZodEnum<{
-        pending: "pending";
-        success: "success";
-        reverted: "reverted";
-        not_found: "not_found";
-    }>;
-    blockNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    gasUsed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    effectiveGasPrice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    feeWei: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    explorerUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
 export declare const aegisBackendHealthResponseSchema: z.ZodObject<{
     ok: z.ZodBoolean;
 }, z.core.$strip>;
@@ -247,21 +207,18 @@ export declare const aegisBackendTokensResponseSchema: z.ZodArray<z.ZodObject<{
     displayName: z.ZodString;
     fullName: z.ZodString;
     decimals: z.ZodNumber;
-    priceUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    iconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    stable: z.ZodOptional<z.ZodBoolean>;
+    priceUsd: z.ZodNumber;
+    iconUrl: z.ZodString;
+    stable: z.ZodBoolean;
 }, z.core.$strip>>;
 export declare const aegisBackendMarketsResponseSchema: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     chainId: z.ZodNumber;
     status: z.ZodEnum<{
         enabled: "enabled";
         disabled: "disabled";
     }>;
-    kind: z.ZodEnum<{
-        "aegis-direct-v4": "aegis-direct-v4";
-        kyber: "kyber";
-    }>;
+    kind: z.ZodLiteral<"aegis-direct-v4">;
     label: z.ZodString;
     baseToken: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     quoteToken: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
@@ -273,10 +230,21 @@ export declare const aegisBackendMarketsResponseSchema: z.ZodArray<z.ZodObject<{
         tickSpacing: z.ZodNumber;
         hooks: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     }, z.core.$strip>;
-    metrics: z.ZodOptional<z.ZodObject<{
-        tvlUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        volumeUsd7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        feeApr7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    }, z.core.$strip>>;
-    warnings: z.ZodArray<z.ZodString>;
+    metrics: z.ZodObject<{
+        tvlUsd: z.ZodNumber;
+        volumeUsd7d: z.ZodNumber;
+        feeApr7d: z.ZodNumber;
+    }, z.core.$strip>;
+    warnings: z.ZodArray<z.ZodEnum<{
+        paused: "paused";
+        "surge-active": "surge-active";
+        "cap-event": "cap-event";
+    }>>;
 }, z.core.$strip>>;
+export declare function refineHistorySeries(value: {
+    status: 'ready' | 'warming_up' | 'no_data';
+    pointCount: number;
+    points: ReadonlyArray<{
+        t: number;
+    }>;
+}, context: z.RefinementCtx): void;

package/dist/encoding.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type Hex } from 'viem';
-import type { AegisPoolKey } from './config';
+import type { AegisPoolKey } from './config/index.js';
 export type ExecutionBatch = {
     requiresV4Unlock: boolean;
     actions: Hex;

package/dist/engine/actions.d.ts

@@ -0,0 +1,56 @@
+import { type Address, type Hex } from 'viem';
+import type { AegisEngineActionCallbacks, AegisEngineApprovalInput, AegisEngineMarket, AegisEnginePositionTarget, AegisEngineSendInput, AegisEngineSignedPermitBatch, AegisEngineTransactionResult } from './types.js';
+export type AegisEnginePositionRouterAuthorizationInput = {
+    wallet: AegisEngineSendInput['wallet'];
+    publicClient: AegisEngineSendInput['publicClient'];
+    activeChain: AegisEngineSendInput['activeChain'];
+    market: AegisEngineMarket;
+    target: AegisEnginePositionTarget;
+    /** Exact ERC-6909 share allowance required for a lender-position action. */
+    amount?: bigint;
+    onStatus?: AegisEngineActionCallbacks['onStatus'];
+    onTxHash?: AegisEngineActionCallbacks['onTxHash'];
+};
+export declare function prepareEnginePermit(args: AegisEngineApprovalInput): Promise<{
+    approvalHash: Hex | null;
+    permit: AegisEngineSignedPermitBatch | null;
+}>;
+/**
+ * Authorize the trusted Engine router to manage an already-open position.
+ *
+ * Borrow vaults use a per-vault ERC-721 approval; lender positions use a
+ * per-pool, amount-bounded ERC-6909 allowance. The helper deliberately
+ * does not accept `onSubmitted`: authorization is a prerequisite transaction,
+ * not the host's requested position action.
+ */
+export declare function authorizeEnginePositionRouter(args: AegisEnginePositionRouterAuthorizationInput): Promise<AegisEngineTransactionResult>;
+/**
+ * Whether the trusted router may already move this borrow vault — either a
+ * per-vault approval or a blanket operator approval. Lets a borrow into an
+ * existing vault skip a redundant ERC-721 approval on repeat borrows. Without
+ * a `vaultId` (createVault path) only the blanket operator approval can
+ * exist, so only that is read.
+ */
+export declare function readEngineVaultRouterApproved(args: {
+    publicClient: AegisEngineSendInput['publicClient'];
+    market: AegisEngineMarket;
+    owner: Address;
+    vaultId?: bigint;
+}): Promise<boolean>;
+/**
+ * Blanket operator approval for the trusted router on the vault registry.
+ * A first borrow (createVault) has no vault to approve per-token, and the
+ * SDK's execution evidence for a fresh vault checks `isApprovedForAll` only —
+ * this is the only authorization that can satisfy its router gate. Existing
+ * vaults should keep the narrower per-vault approval via
+ * `authorizeEnginePositionRouter`.
+ */
+export declare function authorizeEngineVaultOperator(args: Omit<AegisEnginePositionRouterAuthorizationInput, 'target' | 'amount'>): Promise<AegisEngineTransactionResult>;
+export declare function sendEngineTransaction(args: AegisEngineSendInput): Promise<AegisEngineTransactionResult>;
+export declare function missingEngineExecutionReason(market: {
+    router?: Address;
+    permit2?: Address;
+    stateView?: Address;
+    v4StateView?: Address;
+    v4Quoter?: Address;
+}): string | null;

package/dist/engine/borrowCostProjection.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/engine/dataSource.d.ts

@@ -0,0 +1,63 @@
+import type { Address } from 'viem';
+import type { AegisEngineDataSource, AegisEngineHistoryWindow, AegisEngineMarket, AegisEngineMetricHistory, AegisEnginePositionActivitySnapshot, AegisEngineVaultActivityEntry, AegisEnginePositionsSnapshot } from './types.js';
+export declare function clearEngineMarketsCache(): void;
+export declare function clearEngineMarketHistoryCache(): void;
+export declare function clearEnginePositionsCache(): void;
+export declare function clearEnginePositionActivityCache(): void;
+export declare function clearEnginePositionsV2ProbeCache(): void;
+export declare function fetchEngineMarkets(args: {
+    source: AegisEngineDataSource;
+    chainId: number;
+    signal?: AbortSignal;
+    defaultV4Quoter?: Address;
+}): Promise<AegisEngineMarket[]>;
+export declare function fetchEngineMarketHistory(args: {
+    source: AegisEngineDataSource;
+    marketId: string;
+    window?: AegisEngineHistoryWindow;
+    signal?: AbortSignal;
+}): Promise<AegisEngineMetricHistory | null>;
+export declare function fetchEnginePositionsSnapshot(args: {
+    source: AegisEngineDataSource;
+    chainId: number;
+    account: Address;
+    signal?: AbortSignal;
+    /** Explicit user refresh and post-transaction reconciliation bypass the
+     * short display cache; normal tab re-entry does not. */
+    force?: boolean;
+}): Promise<AegisEnginePositionsSnapshot>;
+/** Loads the complete account-scoped Engine action ledger. Static sources have
+ * no activity plane and return null rather than presenting fixture data as
+ * indexed history. */
+export declare function fetchEnginePositionActivitySnapshot(args: {
+    source: AegisEngineDataSource;
+    chainId: number;
+    account: Address;
+    signal?: AbortSignal;
+    /** Explicit refresh and post-transaction reconciliation bypass the cache. */
+    force?: boolean;
+}): Promise<AegisEnginePositionActivitySnapshot | null>;
+/** Convenience view for the latest debt/idle transaction of one vault. The
+ * full REST ledger remains available through fetchEnginePositionActivitySnapshot. */
+export declare function fetchEngineVaultActivity(args: {
+    source: AegisEngineDataSource;
+    chainId: number;
+    account: Address;
+    vaultId: bigint | string;
+    signal?: AbortSignal;
+    force?: boolean;
+}): Promise<AegisEngineVaultActivityEntry | null>;
+/** Convenience view for the wallet's latest lend transaction in one market.
+ * Deposit/withdraw only: share transfers move pool shares between wallets
+ * without a token leg, so presenting one as the market's latest transaction
+ * would misstate what the wallet last did with tokens. Rides the shared
+ * wallet activity snapshot cache — no extra request beyond
+ * fetchEnginePositionActivitySnapshot. */
+export declare function fetchEngineLendActivity(args: {
+    source: AegisEngineDataSource;
+    chainId: number;
+    account: Address;
+    poolId: string;
+    signal?: AbortSignal;
+    force?: boolean;
+}): Promise<AegisEngineVaultActivityEntry | null>;

package/dist/engine/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './dataSource.js';
+export * from './marketAdapter.js';
+export * from './registry.js';
+export * from './reads.js';
+export * from './quotes.js';
+export * from './actions.js';

package/dist/engine/marketAdapter.d.ts

@@ -0,0 +1,8 @@
+import type { Address } from 'viem';
+import type { AegisEngineMarket, AegisEngineMarketSource } from './types.js';
+export declare function normalizeEngineMarkets(args: {
+    chainId: number;
+    markets: readonly unknown[];
+    source?: AegisEngineMarketSource;
+    defaultV4Quoter?: Address;
+}): AegisEngineMarket[];

package/dist/engine/quotes.d.ts

@@ -0,0 +1,8 @@
+import type { AegisEngineBorrowCapacity, AegisEngineBorrowCapacityInput, AegisEngineBorrowQuote, AegisEngineBorrowQuoteInput, AegisEngineCloseQuoteInput, AegisEngineDepositQuote, AegisEngineDepositQuoteInput, AegisEngineIdleWithdrawQuoteInput, AegisEnginePositionActionQuote, AegisEngineRedeemQuoteInput, AegisEngineRepayQuoteInput } from './types.js';
+export declare function quoteEngineDeposit(input: AegisEngineDepositQuoteInput): Promise<AegisEngineDepositQuote>;
+export declare function quoteEngineBorrow(input: AegisEngineBorrowQuoteInput): Promise<AegisEngineBorrowQuote>;
+export declare function quoteEngineBorrowCapacity(input: AegisEngineBorrowCapacityInput): Promise<AegisEngineBorrowCapacity>;
+export declare function quoteEngineRepay(input: AegisEngineRepayQuoteInput): Promise<AegisEnginePositionActionQuote>;
+export declare function quoteEngineCloseVault(input: AegisEngineCloseQuoteInput): Promise<AegisEnginePositionActionQuote>;
+export declare function quoteEngineIdleWithdraw(input: AegisEngineIdleWithdrawQuoteInput): Promise<AegisEnginePositionActionQuote>;
+export declare function quoteEngineRedeem(input: AegisEngineRedeemQuoteInput): Promise<AegisEnginePositionActionQuote>;

package/dist/engine/reads.d.ts

@@ -0,0 +1,41 @@
+import type { Address } from 'viem';
+import type { AegisEngineBorrowQuoteContext, AegisEngineMarket, AegisEngineMarketReadInput, AegisEngineMarketSnapshot, AegisEnginePositionsHydration, AegisEnginePositionsHydrationInput, AegisEngineVaultActivityEntry } from './types.js';
+export declare class AegisEngineMarketNotReadyError extends Error {
+    constructor(message: string);
+}
+/** Test-only reset for the module-owned, weakly client-scoped read caches. */
+export declare function clearEngineReadCaches(): void;
+export declare function readEngineMarketSnapshot(input: AegisEngineMarketReadInput): Promise<AegisEngineMarketSnapshot>;
+export declare function readEngineBorrowQuoteContext(input: AegisEngineMarketReadInput, execution?: {
+    owner: Address;
+    vaultId?: bigint;
+}): Promise<AegisEngineBorrowQuoteContext>;
+/**
+ * Hydrates REST/subgraph-discovered borrow and lender positions in one
+ * block-pinned SDK frame. Results remain one-to-one with the discovery arrays
+ * and carry their stable position ids so consumers can merge without relying
+ * on list order after the read completes.
+ */
+export declare function readEnginePositionsHydration(input: AegisEnginePositionsHydrationInput): Promise<AegisEnginePositionsHydration>;
+/** Classifies one transaction's vault actions into a ledger entry: the shared
+ *  grammar for turning a group of debt/idle action rows into a
+ *  {@link AegisEngineVaultActivityEntry}. Public so hosts rendering their own
+ *  activity list classify transactions the same way core does. */
+export declare function classifyEngineVaultActivity(group: {
+    txHash: `0x${string}`;
+    timestamp: number;
+    debt: readonly {
+        principalDeltaActual: bigint;
+    }[];
+    idle: readonly {
+        deltaAmount0: bigint;
+        deltaAmount1: bigint;
+    }[];
+}): AegisEngineVaultActivityEntry;
+/** Latest transaction that touched a vault, from the public Engine subgraph.
+ *  Read-only and wallet-free; returns null for an untraceable vault (no
+ *  trusted deployment, empty ledger, or subgraph outage — callers degrade). */
+export declare function readEngineVaultActivity(input: {
+    market: AegisEngineMarket;
+    vaultId: bigint;
+}): Promise<AegisEngineVaultActivityEntry | null>;

package/dist/engine/registry.d.ts

@@ -0,0 +1,27 @@
+import type { Address } from 'viem';
+import type { AegisEngineVersion } from './types.js';
+/** Engine hard utilization cap as a percentage of supplied liquidity.
+ *  Mirrors the SDK's UTILIZATION_CAP_PIPS (950_000/1_000_000), inlined so
+ *  sync widget code can read cap state off REST `utilizationPct` without
+ *  loading the SDK. Drift-guarded by engineRegistry.test.ts. */
+export declare const ENGINE_UTILIZATION_CAP_PCT = 95;
+export type AegisEngineChainAddresses = {
+    aegisEngine: Address;
+    aegisHook: Address;
+    aegisRouterV1: Address;
+    aegisStateView: Address;
+    vaultRegistry: Address;
+    variableInterestRate: Address;
+    oracleManager: Address;
+    limitOrderManager: Address;
+    dynamicFeeManager: Address;
+    poolManager: Address;
+    positionManager: Address;
+    stateView: Address;
+    uniswapV4Quoter: Address;
+    permit2: Address;
+    weth9: Address;
+};
+export declare function trustedEngineVersionForChain(chainId: number): AegisEngineVersion | null;
+export declare function trustedEngineRegistryForChain(chainId: number): AegisEngineChainAddresses | null;
+export declare function engineRouterForChain(chainId: number): Address;