otto-intel-mcp 0.1.2 → 0.1.4

package/dist/yield-withdraw-definition.js

@@ -0,0 +1,90 @@
+/**
+ * `otto_prepare_yield_withdraw` — the twin of `otto_prepare_yield_deposit` (Founder word `fence v2`,
+ * 2026-09-03): a delegated Yield Copilot WITHDRAW as a `otto_prepare_swap` pair whose INPUT token is the
+ * registry vault's share token and whose OUTPUT token is USDC, delivered to the signing account.
+ *
+ * WHY A SWAP. LI.FI routes `shares → USDC` through the diamond as a "composer" (zap-out) leg behind the same
+ * fenced GenericSwapV3 entry point, at redeem parity: on live quotes (2026-09-03) 0.5 gtUSDCp → 553,533 USDC
+ * units = the vault's own `previewRedeem` minus LI.FI's 0.25% fixed fee. The pair is submittable through
+ * the unchanged `otto_submit_under_delegation` path ONLY under fence v2 (the share-token approve rule) and
+ * ONLY for a permission minted under cap ruleset v2; the send gate values a withdraw at zero against the
+ * person's cap (it returns their own assets to them) and bounds it by the engine's share cap instead.
+ *
+ * WHAT THIS TOOL PINS: the input token is the registry row's `vaultAddress`, the output token is the row's
+ * asset (USDC), both never caller inputs; the row is the CURRENT registry record (commitment recomputed);
+ * REDEEM PARITY — the quoted USDC may not fall below the vault's own `previewRedeem(shares)` by more than
+ * `YIELD_WITHDRAW_PARITY_TOLERANCE_BPS`.
+ */
+import { z } from 'zod';
+import { YIELD_ROUTE_SEMANTICS_SCHEMA } from './yield-route-semantics.js';
+import { ACCOUNT_PROFILE_SCHEMA, EXECUTION_ENVELOPE_SCHEMA, PREPARE_SWAP_INPUT_SCHEMA, } from './execution-tool-definitions.js';
+export const YIELD_WITHDRAW_TOOL_NAME = 'otto_prepare_yield_withdraw';
+/**
+ * 🔴 PINNED REDEEM-PARITY TOLERANCE, in bps of the vault's own `previewRedeem(shares)`. Same derivation as the
+ * deposit's: LI.FI's fixed fee-collection leg takes 0.25% of the INPUT (here: shares) before the zap-out
+ * (25 bps) + rounding headroom (5 bps) = 30 bps. `slippage.maxBps` bounds the on-chain floor, not this.
+ * A test pins this value; widening it must redden that test.
+ */
+export const YIELD_WITHDRAW_PARITY_TOLERANCE_BPS = 30;
+const uintString = z
+    .string()
+    .regex(/^[1-9]\d*$/, 'must be a positive decimal integer')
+    .refine((value) => BigInt(value) <= (1n << 256n) - 1n, 'must fit uint256');
+export const PREPARE_YIELD_WITHDRAW_INPUT_SCHEMA = z
+    .object({
+    accountProfile: ACCOUNT_PROFILE_SCHEMA,
+    executableMarketId: z.string().min(1).max(120),
+    registryCommitment: z
+        .string()
+        .regex(/^sha256:[0-9a-f]{64}$/, 'must be the sha256:… registry commitment the READ half served'),
+    /** Exact vault shares to redeem, in atomic units (18 decimals) — at most the account's `maxRedeem`. */
+    shares: uintString,
+    slippage: z
+        .object({
+        maxBps: z.number().int().min(1).max(1_000),
+    })
+        .strict(),
+    client_ref: z.string().trim().min(1).max(128).optional(),
+})
+    .strict();
+const addressOut = z.string().regex(/^0x[0-9a-fA-F]{40}$/);
+const uintOut = z.string().regex(/^\d+$/);
+export const YIELD_WITHDRAW_PREVIEW_SCHEMA = z
+    .object({
+    market_id: z.string(),
+    venue: z.string(),
+    protocol: z.literal('MORPHO'),
+    chain_id: z.literal(8453),
+    vault: addressOut,
+    asset: addressOut,
+    /** The shares redeemed (atomic, 18 dp) — the approve amount; the engine bounds it by the share cap. */
+    shares: uintOut,
+    /** USDC (atomic) the route quotes for `shares`. */
+    expected_assets: uintOut,
+    /** The on-chain floor the router enforces; what `prepareInput.slippage.minAmountOut` carries. */
+    min_assets: uintOut,
+    /** The vault's own `previewRedeem(shares)` at prepare time. */
+    preview_redeem_assets: uintOut,
+    parity_shortfall_bps: z.number().int().min(0),
+    parity_tolerance_bps: z.literal(YIELD_WITHDRAW_PARITY_TOLERANCE_BPS),
+    quoted_fees: z.array(z.object({ name: z.string(), amount_usd: z.string() }).strict()),
+    quoted_gas_usd: z.string().optional(),
+    route_semantics: YIELD_ROUTE_SEMANTICS_SCHEMA,
+})
+    .strict();
+export const PREPARE_YIELD_WITHDRAW_OUTPUT_SCHEMA = z
+    .object({
+    envelope: EXECUTION_ENVELOPE_SCHEMA,
+    prepareInput: PREPARE_SWAP_INPUT_SCHEMA,
+    preview: YIELD_WITHDRAW_PREVIEW_SCHEMA,
+    registry_commitment: z.string().regex(/^sha256:[0-9a-f]{64}$/),
+})
+    .strict();
+export const YIELD_WITHDRAW_TOOL_DEFINITION = Object.freeze({
+    name: YIELD_WITHDRAW_TOOL_NAME,
+    title: 'Prepare a Yield Copilot vault withdraw (Morpho USDC on Base) as a delegable swap pair',
+    description: "Prepare the EXACT otto_prepare_swap pair (envelope + prepareInput) that redeems vault shares from one of the executable Morpho vaults in the Yield Copilot registry back to USDC in the signing account, as a LI.FI exit route (which may sell shares or compose a protocol redemption) whose input token is the vault's ERC-4626 share token. The vault and the asset come from the registry row named by executableMarketId and are never inputs; the caller's registryCommitment must equal the commitment recomputed over the current record. The quoted USDC is checked against the vault's own previewRedeem and refused when it falls short by more than the pinned tolerance. Returns the pair unchanged plus a preview; never signs or submits — submit the pair through otto_submit_under_delegation, which admits a withdraw only under fence v2 and a permission minted under cap ruleset v2, values it at zero against the per-swap cap (it returns the person's own assets), and bounds it by the engine's share cap.",
+    inputSchema: PREPARE_YIELD_WITHDRAW_INPUT_SCHEMA,
+    outputSchema: PREPARE_YIELD_WITHDRAW_OUTPUT_SCHEMA,
+});
+//# sourceMappingURL=yield-withdraw-definition.js.map

package/dist/yield-withdraw.d.ts

@@ -0,0 +1,11 @@
+import { type PublicClient } from 'viem';
+import { type ExecutionToolRuntime } from './execution-tools.js';
+import { type PrepareYieldWithdrawOutput, type YieldVaultReader } from './yield-withdraw-definition.js';
+/** The production reader for BOTH yield constructors: previews over the delegation rig's Base public client. */
+export declare function viemYieldVaultReader(pub: PublicClient): YieldVaultReader;
+/**
+ * The shortfall of the quoted USDC against the vault's own `previewRedeem`, in bps of the preview (0 when
+ * the route quotes at or above it). Refuses past the pinned tolerance.
+ */
+export declare function assertRedeemParity(previewAssets: bigint, quotedAssets: bigint): number;
+export declare function prepareYieldWithdraw(runtime: ExecutionToolRuntime, rawInput: unknown, signal?: AbortSignal): Promise<PrepareYieldWithdrawOutput>;

package/dist/yield-withdraw.js

@@ -0,0 +1,122 @@
+/**
+ * `otto_prepare_yield_withdraw` — the constructor. See `yield-withdraw-definition.ts` for WHY it is a swap.
+ *
+ * Steps, mirroring the deposit: strict input → the registry row (unknown / stale commitment / not Base-USDC-
+ * MORPHO → refused by name) → ONE LI.FI quote through `quoteSwap` for `row.vaultAddress → row.asset` from
+ * the signing account (both tokens the row's, never the caller's) → redeem parity against the vault's own
+ * `previewRedeem(shares)` (reader absent or failing → refused, nothing prepared) → the swap prepareInput
+ * with `slippage.minAmountOut` = the quote's floor, then the envelope from THAT quote via
+ * `prepareSwapFromQuote`. Nothing here signs, submits, or touches the delegation.
+ */
+import { describeYieldRoute } from './yield-route-semantics.js';
+import { getAddress, parseAbi } from 'viem';
+import { refuse } from './execution-errors.js';
+import { PREPARE_SWAP_INPUT_SCHEMA } from './execution-tool-definitions.js';
+import { prepareSwapFromQuote, quoteSwap, } from './execution-tools.js';
+import { resolveYieldDepositMarket } from './yield-deposit.js';
+import { PREPARE_YIELD_WITHDRAW_INPUT_SCHEMA, PREPARE_YIELD_WITHDRAW_OUTPUT_SCHEMA, YIELD_WITHDRAW_PARITY_TOLERANCE_BPS, } from './yield-withdraw-definition.js';
+const ERC4626_PREVIEW_ABI = parseAbi([
+    'function previewDeposit(uint256 assets) view returns (uint256)',
+    'function previewRedeem(uint256 shares) view returns (uint256)',
+]);
+/** The production reader for BOTH yield constructors: previews over the delegation rig's Base public client. */
+export function viemYieldVaultReader(pub) {
+    return Object.freeze({
+        async previewDeposit(vault, assets) {
+            return pub.readContract({ address: vault, abi: ERC4626_PREVIEW_ABI, functionName: 'previewDeposit', args: [assets] });
+        },
+        async previewRedeem(vault, shares) {
+            return pub.readContract({ address: vault, abi: ERC4626_PREVIEW_ABI, functionName: 'previewRedeem', args: [shares] });
+        },
+    });
+}
+/**
+ * The shortfall of the quoted USDC against the vault's own `previewRedeem`, in bps of the preview (0 when
+ * the route quotes at or above it). Refuses past the pinned tolerance.
+ */
+export function assertRedeemParity(previewAssets, quotedAssets) {
+    if (previewAssets <= 0n) {
+        return refuse('YIELD_PREVIEW_UNAVAILABLE', 'the vault previews zero assets for this redeem');
+    }
+    if (quotedAssets >= previewAssets)
+        return 0;
+    const shortfallBps = Number(((previewAssets - quotedAssets) * 10000n) / previewAssets);
+    // EXACT, by cross-multiplication (codex gate r1 LOW) — see assertDepositParity.
+    if ((previewAssets - quotedAssets) * 10000n > previewAssets * BigInt(YIELD_WITHDRAW_PARITY_TOLERANCE_BPS)) {
+        return refuse('YIELD_WITHDRAW_PARITY', `the route quotes ${shortfallBps} bps less USDC than the vault's own previewRedeem (tolerance ${YIELD_WITHDRAW_PARITY_TOLERANCE_BPS} bps); the withdraw is not prepared`);
+    }
+    return shortfallBps;
+}
+function quotedFeeLines(quote) {
+    const estimate = quote.estimate;
+    const lines = Array.isArray(estimate.feeCosts) ? estimate.feeCosts : [];
+    return lines.flatMap((line) => {
+        const l = line;
+        return typeof l.name === 'string' && typeof l.amountUSD === 'string' ? [{ name: l.name, amount_usd: l.amountUSD }] : [];
+    });
+}
+function quotedGasUsd(quote) {
+    const estimate = quote.estimate;
+    const first = Array.isArray(estimate.gasCosts) ? estimate.gasCosts[0] : undefined;
+    return typeof first?.amountUSD === 'string' ? first.amountUSD : undefined;
+}
+export async function prepareYieldWithdraw(runtime, rawInput, signal) {
+    const input = PREPARE_YIELD_WITHDRAW_INPUT_SCHEMA.parse(rawInput);
+    const market = resolveYieldDepositMarket(input);
+    const reader = runtime.yieldVaultReader;
+    if (!reader) {
+        return refuse('YIELD_PREVIEW_UNAVAILABLE', 'this server has no vault reader, so redeem parity cannot be checked; nothing is prepared');
+    }
+    const vault = getAddress(market.vaultAddress);
+    const asset = getAddress(market.asset.address);
+    const shares = BigInt(input.shares);
+    // The swap request: fromToken PINNED to the registry vault, toToken PINNED to its asset. Quoted once.
+    const quoteInput = PREPARE_SWAP_INPUT_SCHEMA.parse({
+        accountProfile: input.accountProfile,
+        chainId: market.chainId,
+        fromToken: vault,
+        toToken: asset,
+        fromAmount: input.shares,
+        slippage: { maxBps: input.slippage.maxBps },
+        ...(input.client_ref ? { client_ref: input.client_ref } : {}),
+    });
+    const quote = await quoteSwap(runtime, quoteInput, signal);
+    const expectedAssets = BigInt(quote.estimate.toAmount);
+    const minAssets = BigInt(quote.estimate.toAmountMin);
+    let previewAssets;
+    try {
+        previewAssets = await reader.previewRedeem(vault, shares);
+    }
+    catch {
+        return refuse('YIELD_PREVIEW_UNAVAILABLE', "the vault's previewRedeem could not be read, so redeem parity cannot be checked; nothing is prepared");
+    }
+    const shortfallBps = assertRedeemParity(previewAssets, expectedAssets);
+    const prepareInput = PREPARE_SWAP_INPUT_SCHEMA.parse({
+        ...quoteInput,
+        slippage: { maxBps: input.slippage.maxBps, minAmountOut: minAssets.toString() },
+    });
+    const envelope = prepareSwapFromQuote(runtime, prepareInput, quote);
+    return PREPARE_YIELD_WITHDRAW_OUTPUT_SCHEMA.parse({
+        envelope,
+        prepareInput,
+        preview: {
+            route_semantics: describeYieldRoute(quote, 'withdraw', vault, market.chainId),
+            market_id: market.id,
+            venue: market.venue,
+            protocol: 'MORPHO',
+            chain_id: 8453,
+            vault,
+            asset,
+            shares: shares.toString(),
+            expected_assets: expectedAssets.toString(),
+            min_assets: minAssets.toString(),
+            preview_redeem_assets: previewAssets.toString(),
+            parity_shortfall_bps: shortfallBps,
+            parity_tolerance_bps: YIELD_WITHDRAW_PARITY_TOLERANCE_BPS,
+            quoted_fees: quotedFeeLines(quote),
+            ...(quotedGasUsd(quote) !== undefined ? { quoted_gas_usd: quotedGasUsd(quote) } : {}),
+        },
+        registry_commitment: input.registryCommitment,
+    });
+}
+//# sourceMappingURL=yield-withdraw.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "otto-intel-mcp",
-  "version": "0.1.2",
-  "description": "Otto AI market intelligence + execution constructors over MCP — hosted at mcp.ottoai.services (first call free, then pay per call in USDC via x402) or local via `npx otto-intel-mcp`. Library entries: otto-intel-mcp/execution, /adapter, /adapter-cdp.",
+  "version": "0.1.4",
+  "description": "Otto AI market intelligence + execution constructors over MCP \u2014 hosted at mcp.ottoai.services (first eligible cached call free; crypto news paid-only; pay per call in USDC via x402) or local via `npx otto-intel-mcp`. Library entries: otto-intel-mcp/execution, /adapter, /adapter-cdp.",
   "type": "module",
   "homepage": "https://docs.useotto.xyz/acp-swarm/otto-intel-mcp",
   "bugs": {
@@ -71,6 +71,10 @@
     "dist/adapter/chain.d.ts",
     "dist/adapter/erc20.js",
     "dist/adapter/erc20.d.ts",
+    "dist/adapter/evm-call-failure.js",
+    "dist/adapter/evm-call-failure.d.ts",
+    "dist/adapter/route-simulator.js",
+    "dist/adapter/route-simulator.d.ts",
     "dist/adapter/lifi-decode.js",
     "dist/adapter/lifi-decode.d.ts",
     "dist/adapter/refusal.js",
@@ -87,6 +91,24 @@
     "dist/execution-delegation.d.ts",
     "dist/execution-delegation-policy.js",
     "dist/execution-delegation-policy.d.ts",
+    "dist/execution-delegation-cap-store.js",
+    "dist/execution-delegation-cap-store.d.ts",
+    "dist/execution-delegation-operation-store.js",
+    "dist/execution-delegation-operation-store.d.ts",
+    "dist/execution-delegation-finality.js",
+    "dist/execution-delegation-finality.d.ts",
+    "dist/execution-delegation-operations.js",
+    "dist/execution-delegation-operations.d.ts",
+    "dist/execution-delegation-operations-definition.js",
+    "dist/execution-delegation-operations-definition.d.ts",
+    "dist/execution-delegation-exit.js",
+    "dist/execution-delegation-exit.d.ts",
+    "dist/execution-delegation-exit-definition.js",
+    "dist/execution-delegation-exit-definition.d.ts",
+    "dist/execution-delegation-exit-store.js",
+    "dist/execution-delegation-exit-store.d.ts",
+    "dist/execution-worker-guard.js",
+    "dist/execution-worker-guard.d.ts",
     "dist/execution-delegated-definition.js",
     "dist/execution-delegated-definition.d.ts",
     "dist/prepared-artifacts.js",
@@ -98,7 +120,189 @@
     "dist/boot-redaction.js",
     "dist/boot-redaction.d.ts",
     "dist/package-version.js",
-    "dist/package-version.d.ts"
+    "dist/package-version.d.ts",
+    "dist/executable-equities.js",
+    "dist/executable-equities.d.ts",
+    "dist/stock-buy.js",
+    "dist/stock-buy.d.ts",
+    "dist/stock-buy-definition.js",
+    "dist/stock-buy-definition.d.ts",
+    "dist/stock-buy-oracle.js",
+    "dist/stock-buy-oracle.d.ts",
+    "dist/yield-deposit.js",
+    "dist/yield-deposit.d.ts",
+    "dist/yield-deposit-definition.js",
+    "dist/yield-deposit-definition.d.ts",
+    "dist/executable-yield-markets.js",
+    "dist/executable-yield-markets.d.ts",
+    "dist/yield-withdraw.js",
+    "dist/yield-withdraw.d.ts",
+    "dist/yield-withdraw-definition.js",
+    "dist/yield-withdraw-definition.d.ts",
+    "dist/yield-route-semantics.js",
+    "dist/yield-route-semantics.d.ts",
+    "dist/hybrid-yield-markets.js",
+    "dist/hybrid-yield-markets.d.ts",
+    "dist/hybrid-yield.js",
+    "dist/hybrid-yield.d.ts",
+    "dist/hybrid-yield-index.js",
+    "dist/hybrid-yield-index.d.ts",
+    "dist/native-yield-definition.js",
+    "dist/native-yield-definition.d.ts",
+    "dist/native-yield-reader.js",
+    "dist/native-yield-reader.d.ts",
+    "dist/native-yield.js",
+    "dist/native-yield.d.ts",
+    "dist/native-yield-verify.js",
+    "dist/native-yield-verify.d.ts",
+    "dist/native-yield-settlement.js",
+    "dist/native-yield-settlement.d.ts",
+    "dist/native-yield-simulation.js",
+    "dist/native-yield-simulation.d.ts",
+    "dist/execution-journal-schema.js",
+    "dist/execution-journal-schema.d.ts",
+    "dist/execution-policy-compatibility.js",
+    "dist/execution-policy-compatibility.d.ts",
+    "dist/native-yield-consent-store.js",
+    "dist/native-yield-consent-store.d.ts",
+    "dist/native-yield-account-definition.js",
+    "dist/native-yield-account-definition.d.ts",
+    "dist/native-yield-account-policy.js",
+    "dist/native-yield-account-policy.d.ts",
+    "dist/native-yield-account-gas.js",
+    "dist/native-yield-account-gas.d.ts",
+    "dist/native-yield-account-rpc.js",
+    "dist/native-yield-account-rpc.d.ts",
+    "dist/native-yield-account-runtime.js",
+    "dist/native-yield-account-runtime.d.ts",
+    "dist/native-yield-account-store.js",
+    "dist/native-yield-account-store.d.ts",
+    "dist/native-yield-account.js",
+    "dist/native-yield-account.d.ts",
+    "dist/native-yield-account-index.js",
+    "dist/native-yield-account-index.d.ts",
+    "dist/execution-sponsored-account.js",
+    "dist/execution-sponsored-account.d.ts",
+    "dist/execution-sponsored-definition.js",
+    "dist/execution-sponsored-definition.d.ts",
+    "dist/execution-sponsored-index.js",
+    "dist/execution-sponsored-index.d.ts",
+    "dist/execution-sponsored-receipt.js",
+    "dist/execution-sponsored-receipt.d.ts",
+    "dist/execution-sponsored-runtime.js",
+    "dist/execution-sponsored-runtime.d.ts",
+    "dist/execution-sponsored-settlement.js",
+    "dist/execution-sponsored-settlement.d.ts",
+    "dist/execution-sponsored-store.js",
+    "dist/execution-sponsored-store.d.ts",
+    "dist/execution-sponsored-transport.js",
+    "dist/execution-sponsored-transport.d.ts",
+    "dist/execution-journal-tables.js",
+    "dist/execution-journal-tables.d.ts",
+    "dist/execution-sponsored-mcp-definition.js",
+    "dist/execution-sponsored-mcp-definition.d.ts",
+    "dist/execution-sponsored-registration.js",
+    "dist/execution-sponsored-registration.d.ts",
+    "dist/execution-sponsored-hosted.js",
+    "dist/execution-sponsored-hosted.d.ts",
+    "dist/native-yield-userop.js",
+    "dist/native-yield-userop.d.ts",
+    "dist/native-yield-userop-account.js",
+    "dist/native-yield-userop-account.d.ts",
+    "dist/native-yield-userop-authority.js",
+    "dist/native-yield-userop-authority.d.ts",
+    "dist/native-yield-userop-definition.js",
+    "dist/native-yield-userop-definition.d.ts",
+    "dist/native-yield-userop-hosted.js",
+    "dist/native-yield-userop-hosted.d.ts",
+    "dist/native-yield-userop-index.js",
+    "dist/native-yield-userop-index.d.ts",
+    "dist/native-yield-userop-mcp-definition.js",
+    "dist/native-yield-userop-mcp-definition.d.ts",
+    "dist/native-yield-userop-operation.js",
+    "dist/native-yield-userop-operation.d.ts",
+    "dist/native-yield-userop-registration.js",
+    "dist/native-yield-userop-registration.d.ts",
+    "dist/native-yield-userop-settlement.js",
+    "dist/native-yield-userop-settlement.d.ts",
+    "dist/native-yield-userop-simulation.js",
+    "dist/native-yield-userop-simulation.d.ts",
+    "dist/account-userop-policy-definition.js",
+    "dist/account-userop-policy-definition.d.ts",
+    "dist/account-userop-policy-relation.js",
+    "dist/account-userop-policy-relation.d.ts",
+    "dist/execution-sponsored-account-profile.js",
+    "dist/execution-sponsored-account-profile.d.ts",
+    "dist/native-yield-userop-policy.js",
+    "dist/native-yield-userop-policy.d.ts",
+    "dist/lp-userop.js",
+    "dist/lp-userop.d.ts",
+    "dist/lp-userop-account.js",
+    "dist/lp-userop-account.d.ts",
+    "dist/lp-userop-authority.js",
+    "dist/lp-userop-authority.d.ts",
+    "dist/lp-userop-definition.js",
+    "dist/lp-userop-definition.d.ts",
+    "dist/lp-userop-hosted.js",
+    "dist/lp-userop-hosted.d.ts",
+    "dist/lp-userop-index.js",
+    "dist/lp-userop-index.d.ts",
+    "dist/lp-userop-mcp-definition.js",
+    "dist/lp-userop-mcp-definition.d.ts",
+    "dist/lp-userop-operation.js",
+    "dist/lp-userop-operation.d.ts",
+    "dist/lp-userop-registration.js",
+    "dist/lp-userop-registration.d.ts",
+    "dist/lp-userop-settlement.js",
+    "dist/lp-userop-settlement.d.ts",
+    "dist/vendor/lp-v3/lp-v3-atomic-contract.js",
+    "dist/vendor/lp-v3/lp-v3-atomic-contract.d.ts",
+    "dist/vendor/lp-v3/lp-v3-atomic-evidence.js",
+    "dist/vendor/lp-v3/lp-v3-atomic-evidence.d.ts",
+    "dist/vendor/lp-v3/lp-v3-atomic-index.js",
+    "dist/vendor/lp-v3/lp-v3-atomic-index.d.ts",
+    "dist/vendor/lp-v3/lp-v3-atomic-plan.js",
+    "dist/vendor/lp-v3/lp-v3-atomic-plan.d.ts",
+    "dist/vendor/lp-v3/lp-v3-atomic-read-contract.js",
+    "dist/vendor/lp-v3/lp-v3-atomic-read-contract.d.ts",
+    "dist/vendor/lp-v3/lp-v3-atomic-read-index.js",
+    "dist/vendor/lp-v3/lp-v3-atomic-read-index.d.ts",
+    "dist/vendor/lp-v3/lp-v3-atomic-read-rpc.js",
+    "dist/vendor/lp-v3/lp-v3-atomic-read-rpc.d.ts",
+    "dist/vendor/lp-v3/lp-v3-atomic-read.js",
+    "dist/vendor/lp-v3/lp-v3-atomic-read.d.ts",
+    "dist/vendor/lp-v3/lp-v3-atomic-settlement.js",
+    "dist/vendor/lp-v3/lp-v3-atomic-settlement.d.ts",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-contract.js",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-contract.d.ts",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-index.js",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-index.d.ts",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-observation.js",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-observation.d.ts",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-plan.js",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-plan.d.ts",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-reconcile.js",
+    "dist/vendor/lp-v3/lp-v3-collect-protocol-reconcile.d.ts",
+    "dist/vendor/lp-v3/lp-v3-contract.js",
+    "dist/vendor/lp-v3/lp-v3-contract.d.ts",
+    "dist/vendor/lp-v3/lp-v3-evidence.js",
+    "dist/vendor/lp-v3/lp-v3-evidence.d.ts",
+    "dist/vendor/lp-v3/lp-v3-plan.js",
+    "dist/vendor/lp-v3/lp-v3-plan.d.ts",
+    "dist/vendor/lp-v3/types.js",
+    "dist/vendor/lp-v3/types.d.ts",
+    "dist/vendor/lp-v3/v4-math.js",
+    "dist/vendor/lp-v3/v4-math.d.ts",
+    "dist/execution-account-gas-quote.js",
+    "dist/execution-account-gas-quote.d.ts",
+    "dist/execution-account-gas-review.js",
+    "dist/execution-account-gas-review.d.ts",
+    "dist/execution-account-gas-runtime.js",
+    "dist/execution-account-gas-runtime.d.ts",
+    "dist/execution-account-gas-view.js",
+    "dist/execution-account-gas-view.d.ts",
+    "dist/execution-sponsored-gas-policy.js",
+    "dist/execution-sponsored-gas-policy.d.ts"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -111,9 +315,17 @@
     "test": "node --import tsx --test \"test/**/*.test.ts\"",
     "test:liveness": "node --import tsx --test --test-name-pattern=liveness test/execution-tools.test.ts test/execution-bridge.test.ts test/execution-polymarket.test.ts test/execution-hyperliquid.test.ts",
     "test:mutation": "node --import tsx test/lifi-fee-mutation-proof.ts && node --import tsx test/lifi-bridge-mutation-proof.ts && node --import tsx test/polymarket-order-mutation-proof.ts && node --import tsx test/hyperliquid-order-mutation-proof.ts",
-    "verify": "npm run typecheck && npm run build && npm test",
+    "delegation:journal": "tsx scripts/delegation-operation-journal.ts",
+    "verify": "npm run lp:check && npm run typecheck && npm run build && npm test",
     "prepublishOnly": "npm run verify && npm run pack:audit",
-    "pack:audit": "node scripts/pack-audit.mjs"
+    "pack:audit": "node scripts/pack-audit.mjs",
+    "test:native-local": "node --import tsx scripts/test-native-yield-local.ts",
+    "test:native-account-local": "node --import tsx scripts/test-native-yield-account-local.ts",
+    "native:journal": "tsx scripts/native-yield-account-journal.ts",
+    "sponsored:journal": "tsx scripts/sponsored-account-journal.ts",
+    "native-userop:journal": "tsx scripts/native-yield-userop-journal.ts",
+    "lp-userop:journal": "tsx scripts/lp-userop-journal.ts",
+    "lp:check": "node scripts/check-lp-v3-library.mjs --check"
   },
   "engines": {
     "node": ">=22",
@@ -122,7 +334,7 @@
   "devEngines": {
     "runtime": {
       "name": "node",
-      "version": "22.16.0",
+      "version": "22.23.2",
       "onFail": "warn"
     }
   },
@@ -190,10 +402,30 @@
     "./adapter-cdp": {
       "types": "./dist/adapter-cdp-index.d.ts",
       "import": "./dist/adapter-cdp-index.js"
+    },
+    "./yield": {
+      "import": "./dist/hybrid-yield-index.js",
+      "types": "./dist/hybrid-yield-index.d.ts"
+    },
+    "./yield-account": {
+      "types": "./dist/native-yield-account-index.d.ts",
+      "import": "./dist/native-yield-account-index.js"
+    },
+    "./sponsored-account": {
+      "types": "./dist/execution-sponsored-index.d.ts",
+      "import": "./dist/execution-sponsored-index.js"
+    },
+    "./yield-userop-account": {
+      "types": "./dist/native-yield-userop-index.d.ts",
+      "import": "./dist/native-yield-userop-index.js"
+    },
+    "./lp-userop-account": {
+      "types": "./dist/lp-userop-index.d.ts",
+      "import": "./dist/lp-userop-index.js"
     }
   },
   "optionalDependencies": {
     "@coinbase/cdp-sdk": "1.54.0"
   },
-  "publishGate": "0.1.0 published 2026-09-01; 0.1.1 = the privacy + readability pass. `prepublishOnly` = verify + scripts/pack-audit.mjs (packs the tarball and fails on any personal or secret content; never publish with --ignore-scripts). No source maps ship. Dependency note: @x402/axios + @x402/evm pinned 2.23.0 so the optional @coinbase/cdp-sdk peers resolve to one @x402/core without the root-only `overrides` (kept in lockstep for the Railway install). @x402/core >= 2.23.0 enables client spendControls by default ($1 per payment) — raise it before any tool price exceeds $1."
+  "publishGate": "0.1.4 is a staged release candidate: reviewed Optimism swap construction/verification, hybrid/native yield library entries, fenced sponsored-account entry and shared journal schema v4. Publication requires explicit Founder authority; the recommended initial npm tag is next. otto-execute 0.1.4 deliberately retains the aged registry otto-intel-mcp 0.1.3 seam and refuses Optimism. A later consumer repin may use this version only after seven full days from its registry publication, followed by rebuild, SRI/vendor checks and verification. Publishing this package does not deploy or activate a service. The frozen 0.1.4 publication archives retain that reviewed schema-v4 candidate and do not contain the native and guarded LP UserOperation follow-ups now in source. These follow-ups add the fenced native and guarded LP UserOperation entries and explicit schema-v5/v6 operator rollouts; native version-2 records require explicit migration to schema 5 and separate native readiness, while LP version-3 records require explicit migration to schema 6 and separate LP readiness. Current-source startup preserves coherent existing schema 2, 3, 4, 5 and 6 journals without DDL, marker changes or claim repair; a truly empty database initializes schema 4 with all rails unready. Only an explicit existing-journal migration requires the separately approved old-worker drain and exact prior version/coverage. `prepublishOnly` = verify + scripts/pack-audit.mjs (packs the tarball and fails on any personal or secret content; never publish with --ignore-scripts). No source maps ship. Dependency note: @x402/axios + @x402/evm pinned 2.23.0 so the optional @coinbase/cdp-sdk peers resolve to one @x402/core without the root-only `overrides` (kept in lockstep for the Railway install). @x402/core >= 2.23.0 enables client spendControls by default ($1 per payment) \u2014 raise it before any tool price exceeds $1."
 }