@thirdfy/agent-cli 0.3.0 → 0.4.1

package/src/runtime/providerHints/dogeos.mjs

@@ -0,0 +1,38 @@
+export const DOGEOS_CHAIN_ID = 6281971;
+
+/** The DogeOS hint, shared by every DogeOS provider id and alias. */
+const DOGEOS_HINT = Object.freeze({
+  network: 'DogeOS Chikyu testnet only (chainId 6281971). Testnet tokens have no real value.',
+  gas: 'Not sponsored: the agent\'s wallet pays gas in native DOGE. Fund the agent\'s EVM execution wallet (`thirdfy-agent wallet list`, executionWallets; same address as on Base) with test DOGE, and test USDC if needed, from https://faucet.testnet.dogeos.com. A write without DOGE answers INSUFFICIENT_NATIVE_GAS with the faucet link.',
+  explorer: 'https://blockscout.testnet.dogeos.com',
+  startHere: 'dogeos_get_wallet_actionability (`thirdfy-agent run`, a read): the agent\'s DogeOS address, native DOGE for gas, token balances (WDOGE, USDC, USDT, BARK, WETH) and the next step. Use it for "my DogeOS address / balances" and before the first write.',
+  swapFlow: 'Barkswap swap: dogeos_barkswap_get_quote -> `thirdfy-agent preview` -> `thirdfy-agent run --action dogeos_barkswap_execute_swap --chain-id 6281971`; dogeos_prepare_trade (a read) plans it. Both take symbols (DOGE, WDOGE, USDC, USDT, BARK, WETH) or addresses; amountIn is in token units ("1"), not wei. tokenIn DOGE spends native DOGE in one swap (the router wraps it to WDOGE; no separate wrap, a little DOGE stays for gas); tokenOut DOGE swaps to WDOGE and unwraps it in a second transaction. Report every txHash the result lists.',
+  routing: 'With no direct pool, the quote and the swap take a two-hop route through the pool quote token in one swap: a migrated Laika token quoted in WETH buys as tokenIn DOGE, tokenOut the token address (DOGE -> WETH -> token) and sells back the same way with tokenOut DOGE. The quote\'s route shows the path; viaToken forces the middle token.',
+  wrapFlow: 'Plain wrap or unwrap: `thirdfy-agent run` dogeos_wrap_doge (native DOGE -> WDOGE) or dogeos_unwrap_wdoge (WDOGE -> DOGE), amount in DOGE units or "max". A write that would leave no DOGE for gas answers DOGEOS_GAS_RESERVE_INSUFFICIENT with maxSpendable and the faucet.',
+  amountUsd: 'Writes need --estimated-amount-usd. Testnet tokens have no market price: use the dogeos_barkswap_get_quote output in USDC (USDC counts as $1), or priceUsd from the Laika feeds.',
+  launchpadFlow: 'Laika tokens: dogeos_get_trending_tokens (or new/early-bird) -> dogeos_laika_token_state -> dogeos_laika_buy_token (dogeAmountWei: DOGE in wei) or dogeos_laika_sell_token (tokenAmountRaw: 18-decimal raw units; get it from dogeos_get_wallet_actionability or the token balance). A token with migrated: true no longer trades on Laika: buy and sell answer LAIKA_TOKEN_MIGRATED with nextAction dogeos_barkswap_execute_swap and the nextActionParams to send. Launch: name and symbol are all it needs; offer description, image URL and socials once as optional extras, and launch without them if the user skips (dogeos_prepare_token_launch, a read, returns the plan -> dogeos_laika_launch_token, which pays the on-chain creation fee in DOGE). ICO claims: dogeos_laika_claim. dogeos_laika_execute_raw takes prebuilt calldata: prefer the typed actions.',
+  discoveryActions: [
+    'dogeos_get_trending_tokens',
+    'dogeos_get_new_tokens',
+    'dogeos_get_early_bird_tokens',
+    'dogeos_get_only_moon_tokens',
+    'dogeos_get_big_wins_tokens',
+    'dogeos_get_related_tokens',
+    'dogeos_get_ecosystem_overview',
+    'dogeos_get_chain_insights',
+  ],
+  laneCompatibility: 'runMode agent_wallet on chainId 6281971, from the agent\'s EVM execution wallet.',
+});
+
+/**
+ * Static provider hints. DogeOS (Chikyu testnet 6281971): Barkswap swaps, the Laika launchpad and ecosystem reads. Same facts as thirdfy-mcp `src/tools/providers/dogeosProviderHints.ts`. The API has no provider manifest for DogeOS, so this hint is the only guidance: a testnet, gas paid in DOGE (not sponsored), the faucet, and which action starts each flow.
+ * Each entry builds the hint for one provider id; `dispatch.mjs` picks the entry.
+ */
+export const DOGEOS_PROVIDER_HINTS = Object.freeze({
+  dogeos: ({ provider }) => ({ provider, ...DOGEOS_HINT }),
+  'dogeos-ecosystem': ({ provider }) => ({ provider, ...DOGEOS_HINT }),
+  'dogeos-barkswap': ({ provider }) => ({ provider, ...DOGEOS_HINT }),
+  'dogeos-laika': ({ provider }) => ({ provider, ...DOGEOS_HINT }),
+  barkswap: ({ provider }) => ({ provider, ...DOGEOS_HINT }),
+  laika: ({ provider }) => ({ provider, ...DOGEOS_HINT }),
+});

package/src/runtime/providerHints/earn.mjs

@@ -0,0 +1,201 @@
+/**
+ * Static provider hints. Earn and lending: the `earn` aggregator and the protocols behind it.
+ * Each entry builds the hint for one provider id; `dispatch.mjs` picks the entry.
+ */
+export const EARN_PROVIDER_HINTS = Object.freeze({
+  earn: ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get_earning_opportunities',
+    canonicalWriteAction: 'deposit_earn_position',
+    readActions: [
+      'get_earning_opportunities',
+      'get_earn_opportunities',
+      'get_earn_provider',
+      'get_earn_position',
+      'get_morpho_vaults',
+      'get_aave_markets',
+      'get_aave_portfolio',
+      'get_aegis_pools',
+      'get_aegis_pool_state',
+      'get_aegis_vault_state',
+      'get_curve_pools',
+      'get-vaults-fyi-vaults',
+      'get_yield_xyz_opportunities',
+    ],
+    orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position', 'claim_earn_rewards'],
+    laneCompatibility: 'Generic earn writes use deposit_earn_position / withdraw_earn_position on normal Thirdfy policy/delegation rails; Yield.xyz incentive claims use claim_earn_rewards (no amount; optional passthrough from get_earn_position.claimableRewards). Routing selects Morpho vault calldata or the validated Curve Base 4pool adapter on Base (8453) per opportunity. With private: true (deposit_earn_position / withdraw_earn_position) the position is entered or exited from the shielded (Bermuda) USDC balance on allowlisted vaults where a Bermuda pool exists (Base Sepolia MetaMorpho today); a private withdraw without amount exits everything; otherwise it is refused, never run publicly.',
+  }),
+  capyfi: ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get_capyfi_markets',
+    canonicalWriteAction: 'deposit_earn_position',
+    readActions: [
+      'get_capyfi_markets',
+      'get_earning_opportunities',
+      'get_earn_opportunities',
+      'get_earn_position',
+    ],
+    orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
+    supportedChains: [1, 480],
+    laneCompatibility: 'CapyFi uses Compound-v2 mint/redeem; native ETH markets use payable mint().',
+    example: 'thirdfy-agent run --action deposit_earn_position --params \'{"providerId":"capyfi","opportunityId":"capyfi-1-usdc","amount":"100","chainId":1,"tokenAddress":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}\'',
+  }),
+  morpho: ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get_morpho_vaults',
+    canonicalWriteAction: 'deposit_earn_position',
+    readActions: ['get_morpho_vaults', 'get_earn_provider', 'get_earn_position'],
+    orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
+    supportedChains: [8453, 4663],
+    laneCompatibility: 'Base MetaMorpho V1 vaults are writable (prefer depositPlan from discovery). Robinhood Vault V2 on 4663 is discoverable read-only until maxDeposit > 0. Deposits require ERC-20 approval before deposit_earn_position.',
+    example: 'thirdfy-agent run --action get_earn_opportunities --params \'{"providerId":"morpho","chainId":8453,"asset":"USDC"}\' && thirdfy-agent run --action deposit_earn_position --params \'{"providerId":"morpho","chainId":8453,"vaultAddress":"0x...","tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"0.1","tokenDecimals":6}\'',
+  }),
+  aave: ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get_aave_markets',
+    canonicalWriteAction: 'deposit_earn_position',
+    readActions: [
+      'get_aave_markets',
+      'get_aave_portfolio',
+      'get_earning_opportunities',
+      'get_earn_opportunities',
+      'get_earn_position',
+    ],
+    orderManagementActions: [
+      'deposit_earn_position',
+      'withdraw_earn_position',
+      'aave_borrow',
+      'aave_repay',
+      'aave_set_collateral',
+    ],
+    laneCompatibility: 'Aave V3 supply and withdraw use deposit_earn_position / withdraw_earn_position with providerId aave. Borrow, repay, and collateral toggles use aave_* lending actions with health-factor guards.',
+    example: 'thirdfy-agent actions --provider aave --json && thirdfy-agent run --action get_aave_markets --params \'{"chainId":8453}\'',
+  }),
+  aegis: ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get_aegis_pools',
+    canonicalWriteAction: 'deposit_aegis_lender',
+    readActions: [
+      'get_earning_opportunities',
+      'get_earn_opportunities',
+      'get_aegis_pools',
+      'get_aegis_pool_state',
+      'get_aegis_vault_state',
+      'get_earn_provider',
+    ],
+    orderManagementActions: [
+      'deposit_aegis_lender',
+      'redeem_aegis_lender',
+      'open_aegis_vault_and_borrow',
+      'repay_aegis_vault',
+      'stabilize_aegis_vault',
+    ],
+    supportedChains: [8453, 130],
+    laneCompatibility: 'Aegis reads are live on Base allowlisted pools and Unichain DFM defaults. Engine writes use AegisRouterV1 batches with router-only approvals and eth_call simulation; writes stay fail-closed until partner addresses, PoolKeys, Engine ABI/opcodes, and audit sign-off. Solo Hermes should use agent_wallet (`thirdfy-agent run --run-mode agent_wallet`), not execute-intent.',
+    example: 'thirdfy-agent actions --provider aegis --chain-id 8453 --json && thirdfy-agent run --action get_aegis_pool_state --run-mode agent_wallet --params \'{"pool":"tfy-usdc","chainId":8453}\'',
+  }),
+  curve: ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get_curve_pools',
+    canonicalWriteAction: 'deposit_earn_position',
+    readActions: [
+      'get_curve_pools',
+      'get_earning_opportunities',
+      'get_earn_opportunities',
+      'get_earn_provider',
+      'get_earn_position',
+    ],
+    orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
+    supportedChains: [8453],
+    laneCompatibility: 'Curve EVM writes are limited to the validated Base mainnet 4pool adapter; other pools remain discovery-only until per-pool calldata is validated.',
+  }),
+  uniswap: ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get_uniswap_pools',
+    canonicalWriteAction: 'mint_uniswap_position',
+    readActions: [
+      'get_uniswap_pools',
+      'get_uniswap_pool_state',
+      'get_uniswap_positions',
+      'get_uniswap_position',
+      'get_uniswap_fees',
+      'get_earning_opportunities',
+      'get_earn_opportunities',
+    ],
+    orderManagementActions: [
+      'mint_uniswap_position',
+      'increase_uniswap_liquidity',
+      'decrease_uniswap_liquidity',
+      'collect_uniswap_fees',
+      'close_uniswap_position',
+      'burn_uniswap_position',
+    ],
+    supportedChains: [8453, 42161, 1, 4663],
+    laneCompatibility: 'Uniswap LP discovery is read-first on Base v3 and vanilla v4 pools. Named mint/increase/decrease/collect/close actions replace deposit_earn_position; writes ship after Gate A discover passes.',
+    example: 'thirdfy-agent actions --provider uniswap --json && thirdfy-agent run --action get_uniswap_pools --params \'{"chainId":8453}\'',
+  }),
+  ratehopper: ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get_ratehopper_agents',
+    canonicalWriteAction: 'setup_ratehopper_cash_lp',
+    readActions: [
+      'get_ratehopper_agents',
+      'get_ratehopper_portfolio',
+      'get_ratehopper_logs',
+      'get_ratehopper_performance',
+      'get_ratehopper_setup_status',
+    ],
+    orderManagementActions: [
+      'deploy_ratehopper_safe',
+      'enable_ratehopper_operator',
+      'setup_ratehopper_cash_lp',
+      'close_ratehopper_agent',
+      'transfer_ratehopper_to_owner',
+    ],
+    supportedChains: [8453],
+    laneCompatibility: 'Ratehopper Managed USDC LP uses a user-owned Safe on Base. Reads use Thirdfy-hosted Partner REST access. Close and owner sweep stay blocked until the REST close-path spike is confirmed.',
+    example: 'thirdfy-agent actions --provider ratehopper --json && thirdfy-agent run --action get_ratehopper_agents --params \'{"chainId":8453}\'',
+  }),
+  'vaults-fyi': ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get-vaults-fyi-vaults',
+    canonicalWriteAction: 'deposit_earn_position',
+    readActions: [
+      'get-vaults-fyi-vaults',
+      'get_earning_opportunities',
+      'get_earn_opportunities',
+      'get_earn_provider',
+      'get_earn_position',
+    ],
+    orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
+    laneCompatibility: 'Vaults.fyi writes are transaction-prep first; Thirdfy validates partner payloads, chain/user context, and target allowlists before signing or returning prepared calls.',
+    example: 'thirdfy-agent actions --provider vaults-fyi && thirdfy-agent preflight --action deposit_earn_position --params \'{"providerId":"vaults-fyi","opportunityId":"...","vaultAddress":"0x...","tokenAddress":"0x...","amount":"10","chainId":8453}\'',
+    supportedChains: [1, 10, 137, 8453, 42161],
+  }),
+  'yield-xyz': ({ provider }) => ({
+    provider,
+    category: 'earn',
+    canonicalReadAction: 'get_yield_xyz_opportunities',
+    canonicalWriteAction: 'deposit_earn_position',
+    readActions: [
+      'get_yield_xyz_opportunities',
+      'get_earning_opportunities',
+      'get_earn_opportunities',
+      'get_earn_provider',
+      'get_earn_position',
+    ],
+    orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position', 'claim_earn_rewards'],
+    laneCompatibility: 'Yield.xyz writes are transaction-prep first. Discover with get_yield_xyz_opportunities and pass the canonical opportunityId. Thirdfy prepareDeposit calls GET /v1/yields/{yieldId} before enter/exit, then validates unsigned transactions with @yieldxyz/shield. claim_earn_rewards claims pending CLAIM_REWARDS incentives (no amount; optional passthrough from get_earn_position.claimableRewards).',
+    example: 'thirdfy-agent run --action get_yield_xyz_opportunities --params \'{"chainId":8453,"asset":"USDC"}\' && thirdfy-agent preflight --action deposit_earn_position --params \'{"providerId":"yield-xyz","opportunityId":"<canonical-yieldId>","tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10","chainId":8453}\'',
+    supportedChains: [1, 10, 100, 130, 137, 42220, 8453, 42161, 4663],
+  }),
+});

package/src/runtime/providerHints/perps.mjs

@@ -0,0 +1,346 @@
+/**
+ * Veranta (formerly Avantis) naming for the `avantis` / `avantis-vault` hints, static or from the
+ * capabilities manifest. Empty for every other provider.
+ */
+export function verantaNamingFields(provider) {
+  if (provider !== 'avantis' && provider !== 'avantis-vault') return {};
+  const alias = provider === 'avantis' ? 'veranta' : 'veranta-vault';
+  return {
+    displayName: 'Veranta',
+    formerName: 'Avantis',
+    providerAliases: [alias],
+    actionNaming: `Veranta (formerly Avantis). Veranta action names (*_veranta_*) are canonical; Avantis names (*_avantis_*) still resolve. Provider id stays ${provider}; --provider ${alias} is an alias.`,
+  };
+}
+
+/**
+ * Perps trade recipes: which action and params answer the requests people make ("short BTC 50x $20 with
+ * 3% TP and SL", "close my position", "what is my PnL", "move my TP", "add margin", "withdraw to Base").
+ * Limits are never written here: each recipe names the read that returns them. Same rules as
+ * thirdfy-mcp `src/tools/providers/perpsTradeRecipes.ts`.
+ */
+export const HYPERLIQUID_TRADE_RECIPES = Object.freeze({
+  limits: 'search_hyperliquid_markets {query: coin} returns mid, szDecimals and maxLeverage per coin. A leverage above maxLeverage is refused: say so and offer maxLeverage. An order under the venue\'s minimum value is refused HL_ORDER_BELOW_MIN_VALUE, which names the minimum. `thirdfy-agent preview` checks both (blockedStage venue_rules) before the order is sent.',
+  open: 'One write, leverage, TP and SL included: place_hyperliquid_perps_order {coin, isBuy (false = short), size, limitPx, orderType: market|limit, leverage, takeProfitPx, stopLossPx}. leverage is an integer, at most maxLeverage (cross by default; isCross: false for isolated margin); omit it to keep the account\'s leverage. size is in coins: margin USD x leverage / mid, rounded down to szDecimals. For market, limitPx is the mid (Thirdfy bounds the fill to mid +-1%). --estimated-amount-usd = size x mid. Preview it with `thirdfy-agent preview` and place it once with `run`: never send update_hyperliquid_leverage or place_hyperliquid_tp_sl for the same order.',
+  takeProfitStopLoss: 'takeProfitPx and stopLossPx ride on the order: reduce-only triggers sized like the entry that wait for it to fill. A short\'s TP is below entry and its SL above (a crossed leg is refused HL_TP_SL_CROSSED). `thirdfy-agent preview` returns the estimated liquidationPrice and warns HL_STOP_PAST_LIQUIDATION when the stop is past it: tell the user, and offer a closer stop or a lower leverage. HL_TP_SL_LEG_REJECTED means the entry is live without that leg: do not resend the order; read get_hyperliquid_open_orders and attach the missing leg with place_hyperliquid_tp_sl {coin, tpsl: tp|sl, triggerPx, size: the position size, isBuy: the opposite of the position}. place_hyperliquid_tp_sl also adds a TP or SL to a position opened without one.',
+  positions: 'get_hyperliquid_user_state: assetPositions[].position (coin, szi: negative = short, entryPx, unrealizedPnl, liquidationPx, leverage {type: cross|isolated}, marginUsed) and marginSummary (accountValue, withdrawable). Open orders and TP/SL triggers: get_hyperliquid_open_orders.',
+  close: 'There is no close action: place_hyperliquid_perps_order {coin, isBuy: opposite of the position, size: abs(szi), limitPx: mid, orderType: market, reduceOnly: true} with no leverage, TP or SL. A partial close sends a smaller size.',
+  modifyTakeProfitStopLoss: 'cancel_hyperliquid_perps_order {coin, orderId: oid from get_hyperliquid_open_orders}, then place_hyperliquid_tp_sl with the new triggerPx.',
+  margin: 'Cross margin (the default) is the account balance: depositing more USDC adds margin to every cross position (deposit_hyperliquid_cctp {sourceChainId: 8453, amountUsdc}, quote_hyperliquid_cctp_deposit first for the fee). An isolated position (opened with isCross: false) takes update_hyperliquid_isolated_margin {coin, direction: add|remove, amountUsdc}: it changes no size; adding moves the liquidation price away. A cross position is refused HL_POSITION_NOT_ISOLATED.',
+  withdraw: 'withdraw_hyperliquid_cctp_to_base {amountUsdc} (omit for all withdrawable margin) lands native USDC in the agent\'s Base wallet; get_hyperliquid_cctp_withdraw_status confirms it. Open positions block it: close them first, or pass confirmFullExit: true only when the user asked to close everything.',
+  setup: 'Thirdfy runs the one-time Hyperliquid setup (API wallet, approvals) by itself with the first order: do not list keys or approvals to the user. Only funding is the user\'s step.',
+});
+
+export const VERANTA_TRADE_RECIPES = Object.freeze({
+  limits: 'get_veranta_pair {pair: "BTC/USD"} returns leverages.maxLeverage and pairMinLevPosUSDC (minimum position: collateral x leverage). `thirdfy-agent preview` refuses an open outside them (blockedStage venue_rules) with the reason.',
+  open: 'One write, TP and SL included: place_veranta_perps_order {pair: "BTC/USD", side: long|short, collateralUsdc, leverage, orderType: market, takeProfitPrice, stopLossPrice, confirmWrites: true} on chainId 8453. collateralUsdc is the margin ("$20 at 50x" is collateralUsdc 20, leverage 50). --estimated-amount-usd = collateralUsdc x leverage. Limit: orderType limit plus limitPrice.',
+  takeProfitStopLoss: 'Prices in USD from the mark (get_veranta_price): a short\'s TP below entry, SL above. Veranta caps a stop at an 80% loss of collateral, so at L x the stop can be at most 80/L % from entry (1.6% at 50x): a wider stop is refused. Tell the user and offer the widest allowed stop or a lower leverage.',
+  positions: 'get_veranta_positions: each position\'s pairIndex, tradeIndex, isLong, collateralUsdc and leverage (entry price, TP and SL in raw). Mark for PnL: get_veranta_price. Open limit orders: get_veranta_open_orders.',
+  close: 'close_veranta_position {pairIndex, tradeIndex, confirmWrites: true} from get_veranta_positions; collateralToCloseUsdc for a partial close. The collateral returns to the agent\'s Base wallet.',
+  modifyTakeProfitStopLoss: 'update_veranta_tp_sl {pairIndex, tradeIndex, takeProfitPrice, stopLossPrice, confirmWrites: true}; cancel_veranta_tp_sl removes them.',
+  margin: 'Collateral is per position. update_veranta_margin {pairIndex, tradeIndex, direction: add|remove, amountUsdc, confirmWrites: true} from get_veranta_positions adds Base USDC from the agent wallet to the position, or withdraws it back, with no change of size: adding lowers the leverage and moves the liquidation price away. Withdrawing from an Upside (PnL) position is refused. increase_veranta_coin_position adds collateral and size together. Funding is native USDC in the agent\'s Base wallet.',
+  withdraw: 'Nothing to withdraw from the venue: closing a position returns its USDC to the agent\'s Base wallet.',
+  setup: 'Thirdfy runs the one-time Veranta setup (delegate, USDC approval) by itself with the first order: do not list delegates or approvals to the user.',
+});
+
+/**
+ * Static provider hints. Leveraged perps venues: Hyperliquid, Lighter and Veranta (provider id `avantis`), and the Veranta vault.
+ * Each entry builds the hint for one provider id; `dispatch.mjs` picks the entry.
+ */
+export const PERPS_PROVIDER_HINTS = Object.freeze({
+  hyperliquid: ({ provider, manifestHint, setupHints }) => ({
+    provider,
+    category: 'leveraged_perps',
+    canonicalWriteAction: 'place_hyperliquid_perps_order',
+    readActions: [
+      'get_hyperliquid_perps_meta',
+      'get_hyperliquid_all_mids',
+      'search_hyperliquid_markets',
+      'get_hyperliquid_l2_book',
+      'get_hyperliquid_candles',
+      'get_hyperliquid_user_state',
+      'get_hyperliquid_open_orders',
+      'get_hyperliquid_funding_status',
+      'get_hyperliquid_onboarding_plan',
+      'get_hyperliquid_referral_status',
+      'get_hyperliquid_builder_fee_status',
+      'quote_hyperliquid_cctp_deposit',
+    ],
+    orderManagementActions: [
+      'place_hyperliquid_perps_order',
+      'place_hyperliquid_tp_sl',
+      'cancel_hyperliquid_perps_order',
+      'update_hyperliquid_leverage',
+      'update_hyperliquid_isolated_margin',
+      'get_hyperliquid_open_orders',
+    ],
+    setupActions: [
+      'get_hyperliquid_funding_status',
+      'get_hyperliquid_setup_status',
+      'get_hyperliquid_onboarding_plan',
+      'prepare_hyperliquid_onboarding',
+      'complete_hyperliquid_onboarding',
+      'quote_hyperliquid_cctp_deposit',
+      'deposit_hyperliquid_cctp',
+      'deposit_hyperliquid_bridge',
+      'transfer_hyperliquid_spot_to_perps',
+      'get_bridge_quote',
+      'execute_bridge',
+      'approve_hyperliquid_agent',
+      'get_hyperliquid_builder_fee_status',
+      'approve_hyperliquid_builder_fee',
+      'set_hyperliquid_referrer',
+      'deposit_hyperliquid_staking',
+      'claim_hyperliquid_testnet_faucet',
+    ],
+    statusActions: [
+      'get_hyperliquid_funding_status',
+      'get_hyperliquid_setup_status',
+      'get_hyperliquid_builder_fee_status',
+      'get_hyperliquid_referral_status',
+    ],
+    recoveryActions: [
+      'get_hyperliquid_user_state',
+      'withdraw_hyperliquid_cctp_to_base',
+      'withdraw_hyperliquid_to_arbitrum',
+    ],
+    decommissionExample: 'get_hyperliquid_user_state -> close each position (reduceOnly order) -> withdraw_hyperliquid_cctp_to_base (USDC lands in the agent\'s Base wallet) -> withdraw-to-user on execution wallet',
+    credentialType: 'hyperliquid_api_wallet',
+    credentialUx: 'agent_wallet lane (signed-in apps and the agent\'s managed wallet): Thirdfy creates and stores the Hyperliquid API wallet with the first order; never ask the user for a private key or an approval. Delegated lanes (thirdfy, hybrid) need a signer-backed hyperliquid_api_wallet credential stored first.',
+    supportedFundingSourceChains: [
+      {
+        chainId: 8453,
+        name: 'Base',
+      },
+      {
+        chainId: 42161,
+        name: 'Arbitrum One',
+      },
+      {
+        chainId: 137,
+        name: 'Polygon',
+      },
+      {
+        chainId: 1,
+        name: 'Ethereum',
+      },
+    ],
+    setupBlockers: [
+      'HYPERLIQUID_SOURCE_FUNDS_REQUIRED',
+      'HYPERLIQUID_API_WALLET_APPROVAL_REQUIRED',
+      'HYPERLIQUID_BUILDER_APPROVAL_REQUIRED',
+      'HYPERLIQUID_POLICY_REQUIRED',
+      'HYPERLIQUID_CREDITS_REQUIRED',
+      'HYPERLIQUID_API_WALLET_SIGNER_REQUIRED',
+    ],
+    setupWarnings: ['HYPERLIQUID_BUILDER_WALLET_UNFUNDED', 'HYPERLIQUID_API_WALLET_NOT_PROVIDED'],
+    funding: 'Fund the agent\'s execution wallet with native USDC on Base, Arbitrum, Ethereum or Polygon; Thirdfy bridges and deposits it and sponsors the gas (no ETH needed). Then follow nextAction and nextActionParams from get_hyperliquid_funding_status. Do not invent a funding chain.',
+    laneCompatibility: 'Use self/BYOW only for setup signatures or source-chain funding transactions. Perps order placement is an offchain venue write and should use thirdfy, hybrid, or agent_wallet. The default solo agent_wallet path uses the managed execution wallet as the Hyperliquid master address. If margin already sits on a distinct Hyperliquid main wallet, pass that as userAddress/mainWalletAddress and pass the approved execution/API wallet as apiWalletAddress; place_hyperliquid_perps_order uses userAddress for main-wallet readiness checks while the API wallet signs.',
+    setupExample: '0) get_hyperliquid_funding_status 1) complete_hyperliquid_onboarding for runtime-owned setup, or get_hyperliquid_onboarding_plan/prepare_hyperliquid_onboarding for operator previews 2) follow nextAction with nextActionParams 3) get_hyperliquid_setup_status before place_hyperliquid_perps_order',
+    monetization: 'Builder monetization is active only when the API operator configured a builder address and the builder treasury has Hyperliquid margin. When active, the main wallet signs approve_hyperliquid_builder_fee once and orders attach builder fees. When the treasury is unfunded, get_hyperliquid_setup_status can return ready=true with warning HYPERLIQUID_BUILDER_WALLET_UNFUNDED, get_hyperliquid_builder_fee_status returns monetizationEnabled=false with reason BUILDER_WALLET_UNFUNDED, and place_hyperliquid_perps_order does not require builder approval.',
+    example: 'thirdfy-agent actions --provider hyperliquid && thirdfy-agent preflight --action place_hyperliquid_perps_order --params \'{"coin":"ETH","isBuy":true,"size":0.01,"limitPx":3500,"orderType":"market"}\'',
+    tradeRecipes: HYPERLIQUID_TRADE_RECIPES,
+    ...(manifestHint || {}),
+    ...setupHints,
+    provider,
+    source: manifestHint ? 'cli_capabilities_manifest' : 'static_provider_hint',
+  }),
+  lighter: ({ provider }) => ({
+    provider,
+    category: 'leveraged_perps',
+    canonicalWriteAction: 'place_lighter_perps_order',
+    readActions: [
+      'get_lighter_markets',
+      'search_lighter_markets',
+      'get_lighter_order_book',
+      'get_lighter_candles',
+      'get_lighter_funding_rates',
+      'get_lighter_account',
+      'get_lighter_positions',
+      'get_lighter_open_orders',
+      'get_lighter_pnl',
+      'get_lighter_funding_status',
+      'get_lighter_setup_status',
+      'get_lighter_onboarding_plan',
+      'get_lighter_integrator_status',
+      'get_lighter_partner_stats',
+    ],
+    orderManagementActions: [
+      'place_lighter_perps_order',
+      'cancel_lighter_perps_order',
+      'modify_lighter_perps_order',
+      'update_lighter_leverage',
+      'update_lighter_margin',
+      'get_lighter_open_orders',
+    ],
+    setupActions: [
+      'get_lighter_funding_status',
+      'get_lighter_setup_status',
+      'get_lighter_onboarding_plan',
+      'prepare_lighter_onboarding',
+      'complete_lighter_onboarding',
+      'create_lighter_deposit_intent',
+      'setup_lighter_api_key',
+      'create_lighter_api_key',
+      'register_lighter_api_key',
+      'approve_lighter_integrator',
+      'get_bridge_quote',
+      'execute_bridge',
+    ],
+    statusActions: ['get_lighter_funding_status', 'get_lighter_setup_status', 'get_lighter_integrator_status'],
+    recoveryActions: ['get_lighter_account', 'get_lighter_withdrawal_status', 'prepare_lighter_secure_withdrawal'],
+    decommissionExample: 'get_lighter_account -> prepare_lighter_secure_withdrawal -> withdraw-to-user on execution wallet',
+    credentialType: 'lighter_api_key',
+    credentialUx: 'Delegated Lighter writes require encrypted lighter_api_key credentials with privateKey, apiKeyIndex (4-254), and accountIndex.',
+    recommendedFundingChainId: 8453,
+    supportedFundingSourceChains: [
+      {
+        chainId: 8453,
+        name: 'Base',
+        path: 'native USDC -> CCTP intent -> Lighter margin (recommended)',
+      },
+      {
+        chainId: 42161,
+        name: 'Arbitrum One',
+        path: 'Li.Fi -> Base USDC -> CCTP intent -> Lighter margin',
+      },
+      {
+        chainId: 43114,
+        name: 'Avalanche',
+        path: 'Li.Fi -> Base USDC -> CCTP intent -> Lighter margin',
+      },
+      {
+        chainId: 1,
+        name: 'Ethereum',
+        path: 'Priority changePubKey registration only (chainId 1)',
+      },
+    ],
+    setupBlockers: [
+      'LIGHTER_SOURCE_FUNDS_REQUIRED',
+      'LIGHTER_DEPOSIT_REQUIRED',
+      'LIGHTER_ACCOUNT_NOT_FOUND',
+      'LIGHTER_API_KEY_REGISTRATION_REQUIRED',
+      'LIGHTER_INTEGRATOR_APPROVAL_REQUIRED',
+      'LIGHTER_POLICY_REQUIRED',
+      'LIGHTER_CREDITS_REQUIRED',
+      'LIGHTER_SIGNER_NOT_CONFIGURED',
+    ],
+    setupWarnings: ['LIGHTER_API_KEY_NOT_PROVIDED', 'LIGHTER_INTEGRATOR_ACCOUNT_UNFUNDED'],
+    sourceBridgeProvider: 'lifi',
+    funding: 'Run complete_lighter_onboarding on Base for Li.Fi, CCTP intent, and USDC transfer. When margin is credited, the API auto-switches to Ethereum API key registration on the next complete_lighter_onboarding call. Minimum CCTP deposit is 5 USDC.',
+    laneCompatibility: 'Use agent_wallet and repeat complete_lighter_onboarding on chainId 8453 until setup status is ready. Perps writes use thirdfy, hybrid, or agent_wallet with lighter_api_key credentials.',
+    setupExample: '0) complete_lighter_onboarding (chainId 8453, agent_wallet) 1) repeat until get_lighter_setup_status.ready 2) place_lighter_perps_order',
+    example: 'thirdfy-agent actions --provider lighter && thirdfy-agent preflight --action place_lighter_perps_order --params \'{"accountIndex":1,"apiKeyIndex":4,"marketId":0,"baseAmount":100,"price":310000,"isAsk":false,"orderType":"limit"}\'',
+  }),
+  avantis: ({ provider }) => ({
+    provider,
+    ...verantaNamingFields(provider),
+    category: 'leveraged_perps',
+    canonicalWriteAction: 'place_veranta_perps_order',
+    readActions: [
+      'get_veranta_markets',
+      'get_veranta_pair',
+      'get_veranta_price',
+      'get_veranta_spread',
+      'get_veranta_positions',
+      'get_veranta_open_orders',
+      'get_veranta_allowance',
+      'get_veranta_delegation_status',
+      'get_veranta_funding_status',
+      'get_veranta_setup_status',
+      'get_veranta_onboarding_plan',
+      'get_veranta_builder_fee_status',
+      'get_veranta_referral_status',
+      'get_veranta_referral_stats',
+    ],
+    orderManagementActions: [
+      'place_veranta_perps_order',
+      'cancel_veranta_perps_order',
+      'close_veranta_position',
+      'update_veranta_tp_sl',
+      'cancel_veranta_tp_sl',
+      'update_veranta_margin',
+      'place_veranta_twap_order',
+      'close_veranta_twap_order',
+      'cancel_veranta_twap_order',
+      'place_veranta_coin_perps_order',
+      'increase_veranta_coin_position',
+      'close_veranta_coin_position',
+      'place_veranta_mm_order',
+      'cancel_veranta_mm_order',
+      'get_veranta_open_orders',
+      'get_veranta_positions',
+    ],
+    setupActions: [
+      'get_veranta_funding_status',
+      'get_veranta_setup_status',
+      'get_veranta_onboarding_plan',
+      'prepare_veranta_onboarding',
+      'complete_veranta_onboarding',
+      'approve_veranta_builder_fee',
+      'revoke_veranta_builder_fee',
+      'set_veranta_referral_code',
+      'register_veranta_referral_code',
+      'claim_veranta_referral_rebate',
+    ],
+    statusActions: [
+      'get_veranta_funding_status',
+      'get_veranta_setup_status',
+      'get_veranta_builder_fee_status',
+      'get_veranta_delegation_status',
+    ],
+    recoveryActions: ['get_veranta_positions', 'close_veranta_position'],
+    decommissionExample: 'get_veranta_positions -> close_veranta_position -> withdraw-to-user on execution wallet (Base USDC)',
+    credentialType: 'avantis_delegate',
+    credentialUx: 'Thirdfy mints and stores the encrypted Veranta delegate. CLI callers use Thirdfy auth only. Do not paste a private key.',
+    recommendedFundingChainId: 8453,
+    supportedFundingSourceChains: [
+      {
+        chainId: 8453,
+        name: 'Base',
+        path: 'native USDC in managed execution wallet (recommended)',
+      },
+    ],
+    setupBlockers: [
+      'AVANTIS_USDC_BALANCE_REQUIRED',
+      'AVANTIS_USDC_ALLOWANCE_REQUIRED',
+      'AVANTIS_DELEGATION_REQUIRED',
+      'AVANTIS_DELEGATE_CREDENTIAL_REQUIRED',
+    ],
+    setupWarnings: ['AVANTIS_BUILDER_TEMPLATE_UNWIRED'],
+    supportedChains: [8453],
+    funding: 'Fund the managed execution wallet on Base (8453) with native USDC. Minimum collateral follows the live catalog notional floor.',
+    laneCompatibility: 'Use agent_wallet for solo managed-wallet onboarding and perps writes after avantis_delegate credential is stored. Use thirdfy or hybrid for delegated capital. Relayer is default. Builder-fee collection stays unwired until Veranta supplies a fee-enabled template.',
+    setupExample: '0) get_veranta_funding_status 1) complete_veranta_onboarding (agent_wallet on Base 8453) 2) get_veranta_setup_status before place_veranta_perps_order. Do not call approve_veranta_builder_fee until setup status shows a wired template.',
+    example: 'thirdfy-agent actions --provider veranta && thirdfy-agent preflight --action place_veranta_perps_order --params \'{"pairIndex":0,"side":"long","collateralUsdc":10,"leverage":10,"orderType":"market"}\'',
+    formerlyKnownAs: 'Avantis',
+    tradeRecipes: VERANTA_TRADE_RECIPES,
+  }),
+  'avantis-vault': ({ provider }) => ({
+    provider,
+    ...verantaNamingFields(provider),
+    category: 'earn',
+    canonicalReadAction: 'get_veranta_vault_info',
+    canonicalWriteAction: 'deposit_veranta_vault',
+    readActions: ['get_veranta_vault_info', 'get_veranta_vault_position'],
+    orderManagementActions: [
+      'deposit_veranta_vault',
+      'request_veranta_vault_withdrawal',
+      'redeem_veranta_vault',
+      'claim_veranta_vault',
+    ],
+    recommendedFundingChainId: 8453,
+    supportedChains: [8453],
+    funding: 'Fund the managed execution wallet on Base with native USDC before vault deposit.',
+    laneCompatibility: 'Veranta LP vault on Base. Use agent_wallet, thirdfy, or hybrid. Relayer is default.',
+    example: 'thirdfy-agent actions --provider veranta-vault && thirdfy-agent run --action get_veranta_vault_info --provider veranta-vault --json',
+    formerlyKnownAs: 'Avantis LP vault',
+    supportedFundingSourceChains: [
+      {
+        chainId: 8453,
+        name: 'Base',
+        path: 'native USDC in managed execution wallet',
+      },
+    ],
+  }),
+});