@thirdfy/agent-cli 0.3.0 → 0.4.0

package/src/runtime/providerHints.mjs

@@ -1,1017 +0,0 @@
-import { normalizeVenueProviderId } from '../core/venueBrand.mjs';
-
-/**
- * Veranta (formerly Avantis) naming for the `avantis` / `avantis-vault` hints, static or from the
- * capabilities manifest. Empty for every other provider.
- */
-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.`,
-  };
-}
-
-/**
- * Static and capabilities-backed provider discovery hints for CLI actions filtering.
- */
-export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
-  function getTradingProviderHint(providerId) {
-    // `veranta` / `veranta-vault` resolve to the internal `avantis` / `avantis-vault` hints.
-    const provider = normalizeVenueProviderId(providerId || '');
-    const manifestHint = getCachedProviderHintFromCapabilities(provider);
-    const setupHints =
-      manifestHint?.setupHints && typeof manifestHint.setupHints === 'object' ? manifestHint.setupHints : {};
-    if (provider === 'hyperliquid') {
-      return {
-        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',
-          '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_to_arbitrum',
-        ],
-        decommissionExample:
-          'get_hyperliquid_user_state -> withdraw_hyperliquid_to_arbitrum -> withdraw-to-user on execution wallet',
-        credentialType: 'hyperliquid_api_wallet',
-        credentialUx:
-          'Thirdfy manages Hyperliquid API-wallet setup for normal users. Delegated writes require encrypted privateKey-backed hyperliquid_api_wallet credentials; walletAddress-only records are rejected until Privy walletId-backed Hyperliquid signing ships.',
-        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:
-          '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.',
-        setupExample:
-          'actions --provider hyperliquid -> get_hyperliquid_funding_status -> complete_hyperliquid_onboarding for runtime-owned setup, or get_hyperliquid_onboarding_plan/prepare_hyperliquid_onboarding for operator previews -> follow nextAction with nextActionParams -> 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"}\'',
-        ...(manifestHint || {}),
-        ...setupHints,
-        provider,
-        source: manifestHint ? 'cli_capabilities_manifest' : 'static_provider_hint',
-      };
-    }
-    if (manifestHint) return manifestHint;
-    if (provider === 'trading') {
-      return {
-        provider,
-        category: 'onchain_spot',
-        canonicalWriteAction: 'swap',
-        supportedChains: [1, 10, 130, 137, 8453, 84532, 42161, 4663],
-        laneCompatibility:
-          'Kyber quote/build is live on Ethereum, Optimism, Unichain, Polygon, Base, and Arbitrum; sponsored Kyber execution is validated on Base only. Robinhood Chain (4663) uses Li.Fi Intents for spot swaps with user-pays gas. Gnosis FX uses the fx provider via CoW. Pass private: true to swap from the shielded (Bermuda) balance on a fresh burner where a Bermuda pool exists (Base Sepolia 84532 today); it fails instead of falling back to a public swap.',
-        credentialUx: 'Use normal Thirdfy login/delegation; do not use this provider for Hyperliquid, Lighter, or Polymarket.',
-      };
-    }
-    if (provider === 'lighter') {
-      return {
-        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: privateKey, apiKeyIndex (4-254), and accountIndex. Upsert via delegation credentials before place_lighter_perps_order.',
-        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 (chainId 8453) 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 get_lighter_setup_status.ready is true. Perps writes use thirdfy, hybrid, or agent_wallet with a stored lighter_api_key credential. Gator covers EVM funding and setup only, not L2 orders.',
-        setupExample:
-          'actions --provider lighter -> complete_lighter_onboarding (chainId 8453, agent_wallet) -> repeat until get_lighter_setup_status.ready -> 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"}\'',
-      };
-    }
-    if (provider === 'avantis') {
-      return {
-        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',
-          '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. Thirdfy builds EIP-712 intents; the delegate credential signs batched-market submissions. Relayer is default. Builder-fee collection stays unwired until Veranta supplies a fee-enabled template.',
-        setupExample:
-          'actions --provider veranta -> get_veranta_funding_status -> complete_veranta_onboarding (agent_wallet on Base 8453) -> 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"}\'',
-      };
-    }
-    if (provider === 'avantis-vault') {
-      return {
-        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 (formerly Avantis) 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',
-      };
-    }
-    if (provider === 'bitfinex') {
-      return {
-        provider,
-        category: 'cex_funding',
-        canonicalReadAction: 'get_bitfinex_funding_ticker',
-        canonicalWriteAction: 'submit_bitfinex_funding_offer',
-        readActions: [
-          'get_bitfinex_funding_ticker',
-          'get_bitfinex_funding_stats_hist',
-          'get_bitfinex_funding_book',
-          'get_bitfinex_funding_info',
-          'get_bitfinex_wallets',
-          'list_bitfinex_funding_offers',
-          'list_bitfinex_funding_credits',
-        ],
-        orderManagementActions: [
-          'submit_bitfinex_funding_offer',
-          'cancel_bitfinex_funding_offer',
-          'submit_bitfinex_order',
-          'update_bitfinex_order',
-          'cancel_bitfinex_order',
-        ],
-        credentialType: 'bitfinex_api_key',
-        credentialRef: 'bitfinex:funding-primary',
-        credentialUx:
-          'Save and verify Bitfinex funding credentials in EarnClaw/Thirdfy first. MCP/CLI order intents reference credentialRef only; raw keys are never sent through agentRun.',
-        laneCompatibility:
-          'Bitfinex CEX writes require thirdfy, hybrid, or agent_wallet so Thirdfy can inject stored credentials and run policy/preflight. Reads and setup discovery can be listed without raw credentials.',
-        example:
-          'thirdfy-agent actions --provider bitfinex && thirdfy-agent run --run-mode thirdfy --action submit_bitfinex_funding_offer --params \'{"symbol":"fUSD","amount":"100","rate":"0.0002","period":2,"credentialRef":"bitfinex:funding-primary"}\'',
-      };
-    }
-    if (provider === 'polymarket') {
-      return {
-        provider,
-        category: 'prediction_market',
-        canonicalWriteAction: 'place_polymarket_order',
-        readActions: [
-          'get_polymarket_tags',
-          'search_polymarket',
-          'get_polymarket_events',
-          'get_polymarket_event',
-          'get_polymarket_markets',
-          'get_polymarket_market',
-          'get_polymarket_order_book',
-          'get_polymarket_prices',
-          'get_polymarket_price_history',
-          'get_polymarket_setup_status',
-          'get_polymarket_onboarding_plan',
-          'get_polymarket_order',
-          'get_polymarket_user_orders',
-          'get_polymarket_user_positions',
-          'get_polymarket_balance_allowance',
-          'get_polymarket_bridge_supported_assets',
-          'get_polymarket_bridge_status',
-        ],
-        discoveryFlow: [
-          'get_polymarket_tags or search_polymarket',
-          'get_polymarket_events active=true closed=false',
-          'get_polymarket_market or get_polymarket_markets',
-          'get_polymarket_order_book',
-          'get_polymarket_prices or get_polymarket_price_history',
-          'get_polymarket_funding_status with agentKey (check deposit pUSD + nested setup status)',
-          'when Base USDC is on execution wallet: create_polymarket_bridge_deposit then execute_polymarket_bridge_deposit with confirm=true',
-          'get_polymarket_bridge_status until pUSD lands',
-          'get_polymarket_setup_status with agentKey (check liveOrderReady + apiExecutionGeoblockReady) before place_polymarket_order',
-        ],
-        orderManagementActions: [
-          'place_polymarket_order',
-          'get_polymarket_order',
-          'get_polymarket_user_orders',
-          'get_polymarket_user_positions',
-          'get_polymarket_balance_allowance',
-          'cancel_polymarket_order',
-        ],
-        setupActions: [
-          'get_polymarket_setup_status',
-          'get_polymarket_onboarding_plan',
-          'create_polymarket_bridge_deposit',
-          'execute_polymarket_bridge_deposit',
-          'agent_wallet_setup:ensure_agent_wallet_deposit_wallet',
-          'agent_wallet_setup:deploy_deposit_wallet_and_set_approvals',
-          'agent_wallet_setup:create_or_derive_clob_credentials',
-          'browser_setup:add_privy_signer',
-          'browser_setup:create_or_derive_clob_credentials',
-          'browser_setup:deploy_deposit_wallet_and_set_approvals',
-        ],
-        statusActions: [
-          'get_polymarket_funding_status',
-          'get_polymarket_setup_status',
-          'get_polymarket_recovery_status',
-        ],
-        recoveryActions: [
-          'get_polymarket_recovery_status',
-          'create_polymarket_bridge_withdraw',
-          'execute_polymarket_bridge_withdraw',
-          'get_polymarket_bridge_status',
-          'withdraw_polymarket_collateral',
-        ],
-        decommissionExample:
-          'get_polymarket_recovery_status -> create_polymarket_bridge_withdraw -> execute_polymarket_bridge_withdraw -> withdraw-to-user',
-        credentialType: 'polymarket_clob',
-        credentialUx:
-          'Autonomous agents use an agent-owned Privy wallet and Polymarket deposit wallet first: Thirdfy creates the agent wallet, deploys/approves the deposit wallet, and stores encrypted CLOB credentials once Polymarket key creation is available. User-owned browser setup remains optional for interactive capital.',
-        funding:
-          'Fund the agent-owned Polymarket deposit wallet with Polygon pUSD after deployment and approvals. If users start with Base USDC, use Polymarket official Bridge (create/execute_polymarket_bridge_deposit). Li.Fi is legacy fallback only.',
-        laneCompatibility:
-          'Use agent_wallet as the preferred autonomous-agent path. Use self only for user-owned setup/funding signatures. CLOB orders should use thirdfy, hybrid, or agent_wallet after polymarket_clob credentials are stored.',
-        setupBlockers: [
-          'POLYMARKET_DEPOSIT_WALLET_REQUIRED',
-          'POLYMARKET_CLOB_CREDENTIALS_REQUIRED',
-          'POLYMARKET_DEPOSIT_WALLET_DEPLOY_REQUIRED',
-          'POLYMARKET_DEPOSIT_WALLET_APPROVALS_REQUIRED',
-          'POLYMARKET_DEPOSIT_WALLET_PUSD_REQUIRED',
-          'POLYMARKET_CREDITS_REQUIRED',
-          'POLYMARKET_RELAYER_UNAVAILABLE',
-          'POLYMARKET_CLOB_KEY_CREATION_BLOCKED_UNTIL_POLYMARKET_FIX',
-        ],
-        example:
-          'thirdfy-agent actions --provider polymarket && thirdfy-agent preflight --action place_polymarket_order --params \'{"tokenID":"...","price":0.42,"size":10,"side":"BUY"}\'',
-      };
-    }
-    if (provider === 'prediction') {
-      return {
-        provider,
-        category: 'prediction',
-        canonicalWriteAction: 'place_prediction_order',
-        readActions: [
-          'get_prediction_tags',
-          'get_prediction_markets',
-          'get_prediction_events',
-          'get_prediction_market',
-          'get_prediction_order_book',
-          'search_prediction_markets',
-        ],
-        discoveryFlow: [
-          'get_prediction_tags (resolve numeric tag_id once)',
-          'get_prediction_markets with tag_id + end_date_min/end_date_max + liquidity_num_min',
-          'get_prediction_order_book when book prices are missing',
-          'place_prediction_order after setup/funding/preflight',
-          'search_prediction_markets last for human text/slug lookup only',
-        ],
-        orderManagementActions: ['place_prediction_order', 'cancel_prediction_order'],
-        compatibilityProvider: 'polymarket',
-      };
-    }
-    if (provider === 'bridge') {
-      return {
-        provider,
-        category: 'bridge',
-        canonicalReadAction: 'get_bridge_quote',
-        canonicalWriteAction: 'execute_bridge',
-        readActions: ['get_bridge_quote', 'get_supported_bridge_chains', 'check_bridge_status'],
-        orderManagementActions: ['execute_bridge'],
-        supportedChains: [1, 8453, 42161, 10, 137, 56, 43114, 250, 100, 1284, 1285, 25, 288, 1088, 42220, 122, 324, 59144, 534352, 5000, 81457, 169, 4663],
-        laneCompatibility: 'Li.Fi bridge supports mainnet value movement only; testnets are not auto-mapped to mainnet.',
-      };
-    }
-    if (provider === 'earn') {
-      return {
-        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, Aave, Curve, Vaults.fyi, or Yield.xyz adapters per provider/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.',
-      };
-    }
-    if (provider === 'capyfi') {
-      return {
-        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 Compound-v2 supply on Ethereum and World Chain; Gnosis pending deployment addresses.',
-        example:
-          'thirdfy-agent run --action deposit_earn_position --params \'{"providerId":"capyfi","opportunityId":"capyfi-1-usdc","amount":"100","chainId":1,"tokenAddress":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}\'',
-      };
-    }
-    if (provider === 'fx') {
-      return {
-        provider,
-        category: 'fx',
-        canonicalReadAction: 'get_fx_supported_assets',
-        readActions: ['get_fx_supported_assets', 'quote_fx_swap', 'get_monerium_profile_status'],
-        supportedChains: [100],
-        laneCompatibility:
-          'Gnosis FX: quote_fx_swap is read-only; on-chain execution uses the trading/cow path on chain 100. Monerium IBAN flows need credentials.',
-      };
-    }
-    if (provider === 'morpho') {
-      return {
-        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 (use 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}\'',
-      };
-    }
-    if (provider === 'aave') {
-      return {
-        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 route through deposit_earn_position / withdraw_earn_position with providerId aave. Lending beta actions use aave_borrow, aave_repay, and aave_set_collateral with health-factor guards.',
-        example:
-          'thirdfy-agent actions --provider aave --json && thirdfy-agent run --action get_aave_markets --params \'{"chainId":8453}\'',
-      };
-    }
-    if (provider === 'aegis') {
-      return {
-        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 with router-only approvals and eth_call simulation; writes stay fail-closed until partner addresses, PoolKeys, Engine ABI/opcodes, and audit sign-off. Use agent_wallet / walletExecute for solo Hermes — 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}\'',
-      };
-    }
-    if (provider === 'curve') {
-      return {
-        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.',
-      };
-    }
-    if (provider === 'uniswap') {
-      return {
-        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}\'',
-      };
-    }
-    if (provider === 'ratehopper') {
-      return {
-        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 need 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}\'',
-      };
-    }
-    if (provider === 'vaults-fyi') {
-      return {
-        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 allowed targets before returning or submitting 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}\'',
-      };
-    }
-    if (provider === 'yield-xyz') {
-      return {
-        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. Always discover with get_yield_xyz_opportunities (or get_earning_opportunities) and pass the canonical opportunityId/yieldId. 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; pass optional passthrough from get_earn_position.claimableRewards). Balances omit metadata.name; use yields_get / get_earn_position enrich for display names.',
-        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],
-      };
-    }
-    if (provider === 'hummingbot') {
-      return {
-        provider,
-        category: 'hummingbot',
-        canonicalWriteAction: 'hummingbot_executor_create',
-        readActions: [
-          'get_hummingbot_connectors',
-          'get_hummingbot_executor_schema',
-          'get_hummingbot_gateway_networks',
-          'get_hummingbot_gateway_connectors',
-        ],
-        orderManagementActions: ['hummingbot_executor_create', 'hummingbot_executor_stop'],
-        setupActions: ['get_hummingbot_connectors', 'get_hummingbot_gateway_networks', 'get_hummingbot_gateway_connectors'],
-        laneCompatibility:
-          'Hummingbot executor create/stop and Gateway reads are offchain API actions. Use thirdfy, hybrid, or agent_wallet for writes; self is setup-only.',
-        example:
-          'thirdfy-agent hummingbot gateway-networks && thirdfy-agent hummingbot executor-stop --executor-id <id>',
-      };
-    }
-    if (provider === 'condor') {
-      return {
-        provider,
-        category: 'condor',
-        canonicalWriteAction: 'condor_executor_create',
-        readActions: ['get_condor_policy_status'],
-        orderManagementActions: ['condor_executor_create', 'condor_executor_stop'],
-        setupActions: ['get_condor_policy_status'],
-        laneCompatibility:
-          'Condor Pattern A reserves day notional before executor create. Use thirdfy or agent_wallet for writes; run condor preflight for governance reservation.',
-        example:
-          'thirdfy-agent condor policy-status && thirdfy-agent condor preflight --estimated-amount-usd 25 --idempotency-key <key>',
-      };
-    }
-    if (provider === 'fomo') {
-      return {
-        provider,
-        category: 'smart_money_intel',
-        canonicalReadAction: 'get_fomo_alerts',
-        readActions: [
-          'get_fomo_search',
-          'get_fomo_user',
-          'get_fomo_balances',
-          'get_fomo_leaderboard',
-          'get_fomo_alerts',
-        ],
-        supportedChains: [],
-        laneCompatibility:
-          'Fomo API (fomoapi.io) uses string chain slugs (robinhood, solana, base, bsc, eth), not numeric chainId. Unofficial integration; not the Fomo consumer app. Read-only handle intel and app alerts via Thirdfy API. Resolve handles before storing watchlists. Pace calls (~1 req/s).',
-        example:
-          'thirdfy-agent run --action get_fomo_alerts --params \'{"chain":"robinhood","type":"buy","limit":5}\' --provider fomo --json',
-      };
-    }
-    if (provider === 'gmgn') {
-      return {
-        provider,
-        category: 'smart_money_intel',
-        canonicalReadAction: 'get_gmgn_kol_trades',
-        readActions: [
-          'get_gmgn_token_info',
-          'get_gmgn_token_security',
-          'get_gmgn_token_pool',
-          'get_gmgn_token_holders',
-          'get_gmgn_token_traders',
-          'get_gmgn_token_kline',
-          'get_gmgn_trending',
-          'get_gmgn_trenches',
-          'get_gmgn_hot_searches',
-          'get_gmgn_wallet_activity',
-          'get_gmgn_wallet_stats',
-          'get_gmgn_wallet_token_balance',
-          'get_gmgn_created_tokens',
-          'get_gmgn_kol_trades',
-          'get_gmgn_smartmoney_trades',
-        ],
-        supportedChains: [],
-        laneCompatibility:
-          'GMGN uses string chain slugs (sol, base, bsc, eth, robinhood), not numeric chainId. Read-only KOL, smart-money, wallet, and token security evidence via Thirdfy API. Pace calls (~1 req/s).',
-        example:
-          'thirdfy-agent run --action get_gmgn_kol_trades --params \'{"chain":"sol","limit":5}\' --provider gmgn --json',
-      };
-    }
-    if (provider === 'basedbid') {
-      return {
-        provider,
-        category: 'spot',
-        canonicalReadAction: 'basedbid_get_tokens',
-        canonicalWriteAction: 'basedbid_create_lbp',
-        readActions: ['basedbid_get_tokens'],
-        orderManagementActions: [
-          'basedbid_create_lbp',
-          'basedbid_create_flash',
-          'basedbid_create_board',
-          'basedbid_buy',
-          'basedbid_sell',
-          'basedbid_claim_fees',
-          'basedbid_update_hook',
-        ],
-        supportedChains: [8453, 1, 4663],
-        laneCompatibility:
-          'basedbid launchpad. Discovery is read-only. LBP and flash create, buy, and sell are write-enabled on 8453, 1, and 4663. Buy spends native ETH on the target chain. Board, fee claim, and hook writes stay fail-closed. Console uses the existing preview-then-confirm path. No extra venue credential.',
-        example:
-          'thirdfy-agent run --action basedbid_get_tokens --params \'{"chainId":8453,"limit":10}\' --provider basedbid --json',
-      };
-    }
-    if (provider === 'bermuda') {
-      return {
-        provider,
-        category: 'internal',
-        canonicalReadAction: 'get_bermuda_setup_status',
-        canonicalWriteAction: 'bermuda_deposit',
-        readActions: ['get_bermuda_setup_status', 'get_bermuda_balance'],
-        orderManagementActions: [
-          'bermuda_deposit',
-          'bermuda_transfer',
-          'bermuda_withdraw',
-          'bermuda_stealth_earn',
-          'bermuda_stealth_exit',
-          'bermuda_stealth_swap',
-          'bermuda_sweep_burners',
-        ],
-        supportedChains: [84532],
-        laneCompatibility:
-          'Base Sepolia shielded accounts (USDC, WETH, MetaMorpho vault shares). Catalog is flag-gated on the API host. Deposit is sent from the execution wallet; every other write is proven and relayed, so the execution wallet never appears: transfer, withdraw, private vault entry/exit (stealth earn/exit), private swap (stealth swap, best of Thirdfy routes and Uniswap v3, fresh burner per trade) and burner sweep. The regular swap takes private: true for the same private swap. Writes are capped at 5 USD; the sweep has no cap. Private writes bill the write_private credit tier; any privacy fee is reported as privacyFee (0 at launch). Responses include privacyNotes.',
-        example:
-          'thirdfy-agent run --action get_bermuda_setup_status --params \'{"chainId":84532}\' --provider bermuda --json',
-      };
-    }
-    if (provider === 'arc') {
-      return {
-        provider,
-        category: 'internal',
-        canonicalReadAction: 'get_arc_job',
-        canonicalWriteAction: 'create_arc_job',
-        readActions: ['get_arc_job'],
-        orderManagementActions: [
-          'create_arc_job',
-          'set_arc_job_budget',
-          'fund_arc_job',
-          'submit_arc_job',
-          'complete_arc_job',
-        ],
-        supportedChains: [5042002, 5042],
-        laneCompatibility:
-          'Arc ERC-8183 job escrow. Testnet 5042002 is live. Mainnet 5042 cash is ready. Jobs writes on 5042 need the API jobs contract. Use Privy agent_wallet. USDC pays gas. No Uniswap, Li.Fi, or Yield.xyz on Arc yet.',
-        example:
-          'thirdfy-agent run --action get_arc_job --params \'{"chainId":5042002,"jobId":1}\' --provider arc --json',
-      };
-    }
-    if (provider === 'nansen') {
-      return {
-        provider,
-        category: 'research_intel',
-        canonicalReadAction: 'get_nansen_perp_screener',
-        readActions: [
-          'get_nansen_perp_screener',
-          'get_nansen_position_intelligence',
-          'get_nansen_address_perp_positions',
-          'get_nansen_address_perp_trades',
-          'get_nansen_address_balances',
-          'get_nansen_address_pnl_summary',
-          'get_nansen_flow_intelligence',
-          'get_nansen_agent_fast',
-          'get_nansen_agent_expert',
-        ],
-        supportedChains: [],
-        laneCompatibility:
-          'Nansen HL/TGM reads and premium research agent via Thirdfy API. JSON body params for screener/profiler calls. Fast and expert research cost more than screener reads. Pace outbound starts (~1 req/s).',
-        example:
-          'thirdfy-agent run --action get_nansen_perp_screener --params \'{"date":{"from":"2026-08-27T00:00:00.000Z","to":"2026-08-28T00:00:00.000Z"},"pagination":{"page":1,"per_page":5}}\' --provider nansen --json',
-      };
-    }
-    if (provider === 'cmc') {
-      return {
-        provider,
-        category: 'research_intel',
-        canonicalReadAction: 'get_cmc_quotes',
-        readActions: [
-          'get_cmc_search',
-          'get_cmc_quotes',
-          'get_cmc_info',
-          'get_cmc_global_metrics',
-          'get_cmc_fear_greed',
-          'get_cmc_metrics',
-          'get_cmc_technicals',
-          'get_cmc_marketcap_technicals',
-          'get_cmc_derivatives_metrics',
-          'get_cmc_news',
-          'get_cmc_search_info',
-          'get_cmc_narratives',
-          'get_cmc_upcoming_events',
-          'get_cmc_skill',
-          'get_cmc_daily_market_overview',
-          'get_cmc_btc_etf_demand',
-          'get_cmc_perp_contract_analysis',
-          'get_cmc_market_regime',
-          'get_cmc_derivatives_crowding',
-        ],
-        supportedChains: [],
-        laneCompatibility:
-          'CoinMarketCap quotes, global metrics, and composed Skill Hub briefs via Thirdfy API. Skill actions may take up to 180s. Composed briefs cost more than cheap reads.',
-        example:
-          'thirdfy-agent run --action get_cmc_quotes --params \'{"symbol":"BTC","convert":"USD"}\' --provider cmc --json',
-      };
-    }
-    if (provider === 'market-data') {
-      return {
-        provider,
-        category: 'market_data',
-        canonicalReadAction: 'get_trending_tokens',
-        readActions: [
-          'get_trending_tokens',
-          'get_new_token_launches',
-          'get_token_market_data',
-          'get_chain_market_overview',
-        ],
-        supportedChains: [8453, 84532, 4663],
-        laneCompatibility: 'Read-only market data via API-owned actions. Robinhood Chain uses CoinGecko Onchain network id robinhood.',
-      };
-    }
-    return null;
-  }
-
-  function getCachedProviderHintFromCapabilities(provider) {
-    const normalizedProvider = normalizeVenueProviderId(provider || '');
-    if (!normalizedProvider) return null;
-    const manifests = Array.isArray(getNegotiatedCapabilitiesCache()?.providers?.manifests)
-      ? getNegotiatedCapabilitiesCache().providers.manifests
-      : [];
-    const match = manifests.find((entry) => normalizeVenueProviderId(entry?.providerId || '') === normalizedProvider);
-    if (!match) return null;
-    const canonicalWriteActions = {
-      trading: 'swap',
-      hyperliquid: 'place_hyperliquid_perps_order',
-      lighter: 'place_lighter_perps_order',
-      polymarket: 'place_polymarket_order',
-      prediction: 'place_prediction_order',
-      earn: 'deposit_earn_position',
-      morpho: 'deposit_earn_position',
-      aave: 'deposit_earn_position',
-      aegis: 'deposit_aegis_lender',
-      basedbid: 'basedbid_create_lbp',
-      bermuda: 'bermuda_deposit',
-      arc: 'create_arc_job',
-      curve: 'deposit_earn_position',
-      uniswap: 'mint_uniswap_position',
-      ratehopper: 'setup_ratehopper_cash_lp',
-      'vaults-fyi': 'deposit_earn_position',
-      'yield-xyz': 'deposit_earn_position',
-    };
-    const canonicalReadActions = {
-      earn: 'get_earning_opportunities',
-      morpho: 'get_morpho_vaults',
-      aave: 'get_aave_markets',
-      aegis: 'get_aegis_pools',
-      curve: 'get_curve_pools',
-      uniswap: 'get_uniswap_pools',
-      ratehopper: 'get_ratehopper_agents',
-      'vaults-fyi': 'get-vaults-fyi-vaults',
-      'yield-xyz': 'get_yield_xyz_opportunities',
-      'market-data': 'get_trending_tokens',
-      fomo: 'get_fomo_alerts',
-      gmgn: 'get_gmgn_kol_trades',
-      nansen: 'get_nansen_perp_screener',
-      basedbid: 'basedbid_get_tokens',
-      bermuda: 'get_bermuda_setup_status',
-      arc: 'get_arc_job',
-      cmc: 'get_cmc_quotes',
-      prediction: 'get_prediction_markets',
-    };
-    return {
-      provider: normalizedProvider,
-      category: match.category || match.domain || match.providerKind || null,
-      ...(canonicalReadActions[normalizedProvider] ? { canonicalReadAction: canonicalReadActions[normalizedProvider] } : {}),
-      ...(canonicalWriteActions[normalizedProvider] ? { canonicalWriteAction: canonicalWriteActions[normalizedProvider] } : {}),
-      providerKind: match.providerKind || null,
-      capabilities: Array.isArray(match.capabilities) ? match.capabilities : [],
-      supportedChains: Array.isArray(match.supportedChains) ? match.supportedChains : [],
-      custodyMode: match.custodyMode || null,
-      description: match.description || null,
-      source: 'cli_capabilities_manifest',
-      ...verantaNamingFields(normalizedProvider),
-      ...(match.setupHints && typeof match.setupHints === 'object' ? { setupHints: match.setupHints } : {}),
-    };
-  }
-
-  // Veranta hints carry `providerAliases`; show the public name in messages (`--provider veranta`).
-  function providerLabelForHint(providerHint) {
-    const alias = Array.isArray(providerHint?.providerAliases) ? providerHint.providerAliases[0] : null;
-    return alias || providerHint.provider;
-  }
-
-  function formatProviderAmbiguousActionHint(providerHint) {
-    if (!providerHint) return '';
-    const p = providerLabelForHint(providerHint);
-    const w = providerHint.canonicalWriteAction;
-    if (w) return ` Provider ${p} expects ${w}.`;
-    return ` Provider ${p} did not declare a canonical write action in capabilities; run actions --provider ${p} first.`;
-  }
-
-  function formatProviderUnknownActionHint(providerHint) {
-    if (!providerHint) return '';
-    const p = providerLabelForHint(providerHint);
-    const w = providerHint.canonicalWriteAction;
-    if (w) return ` Provider ${p} expects ${w}; run actions --provider ${p} first.`;
-    return ` Provider ${p} did not declare a canonical write action in capabilities; run actions --provider ${p} first.`;
-  }
-
-  return {
-    getTradingProviderHint,
-    getCachedProviderHintFromCapabilities,
-    formatProviderAmbiguousActionHint,
-    formatProviderUnknownActionHint,
-  };
-}