@thirdfy/agent-cli 0.2.60 → 0.2.62

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.62] - 2026-09-09
+
+### Added
+
+- Ratehopper Managed USDC LP (`providerId: ratehopper`) on Base: `get_ratehopper_*` reads plus Safe deploy, operator enable, and `setup_ratehopper_cash_lp`. Close and owner sweep stay blocked until Ratehopper confirms a REST close path. See [`docs/providers/earn-ratehopper.md`](./docs/providers/earn-ratehopper.md). Pairs with `thirdfy-mcp` **0.0.111** and Thirdfy API **3.14.29**.
+
+## [0.2.61] - 2026-09-06
+
+### Fixed
+
+- `resolveTokenInForFunding` no longer uses `tokenAddress` for `withdraw_earn_position` and `claim_earn_rewards`. Those actions receive the asset; the wallet does not need to already hold it. Earn deposits still fund from `tokenAddress`. Pairs with `thirdfy-mcp` **0.0.109**.
+
 ## [0.2.60] - 2026-09-05
 
 ### Changed

package/README.md

@@ -40,10 +40,11 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.60
+## What's new in v0.2.62
 
-- basedbid buy and sell are live on Base, Ethereum, and Robinhood Chain.
-- Buy spends native ETH on the target chain. `tokenAddress` is the listing, not the funding token.
+- Ratehopper Managed USDC LP on Base is a named earn provider (`ratehopper`).
+- Discover agents and portfolio, then prepare Safe deploy and cash_lp setup when you confirm.
+- Close and owner sweep stay blocked until Ratehopper confirms the REST close path.
 - See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
 
 ## Quick start

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thirdfy/agent-cli",
-  "version": "0.2.60",
+  "version": "0.2.62",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {

package/src/core/fundingTokenIn.mjs

@@ -11,12 +11,22 @@ const NATIVE_ETH_SPEND_ACTIONS = new Set([
   'basedbid_create_board',
 ]);
 
+/**
+ * Position exits receive `tokenAddress` from the protocol instead of spending it from the wallet.
+ * A vault withdraw funded entirely by vault shares would otherwise block on a zero wallet balance.
+ */
+const POSITION_EXIT_ACTIONS = new Set([
+  'withdraw_earn_position',
+  'claim_earn_rewards',
+]);
+
 export function resolveTokenInForFunding(params, action) {
   if (!params || typeof params !== 'object') return '';
   const explicit = String(params.tokenIn || '').trim();
   if (explicit) return explicit;
   const actionId = normalizeActionKey(action);
   if (NATIVE_ETH_SPEND_ACTIONS.has(actionId)) return '';
+  if (POSITION_EXIT_ACTIONS.has(actionId)) return '';
   if (params.amountEth != null && String(params.amountEth).trim() !== '') return '';
   return String(params.tokenAddress || params.token || '').trim();
 }

package/src/runtime/actions/selection.mjs

@@ -144,6 +144,16 @@ function inferActionProvider(action) {
     'collect-uniswap-fees': 'uniswap',
     'close-uniswap-position': 'uniswap',
     'burn-uniswap-position': 'uniswap',
+    'get-ratehopper-agents': 'ratehopper',
+    'get-ratehopper-portfolio': 'ratehopper',
+    'get-ratehopper-logs': 'ratehopper',
+    'get-ratehopper-performance': 'ratehopper',
+    'get-ratehopper-setup-status': 'ratehopper',
+    'deploy-ratehopper-safe': 'ratehopper',
+    'enable-ratehopper-operator': 'ratehopper',
+    'setup-ratehopper-cash-lp': 'ratehopper',
+    'close-ratehopper-agent': 'ratehopper',
+    'transfer-ratehopper-to-owner': 'ratehopper',
     'get-aegis-pools': 'aegis',
     'get-aegis-pool-state': 'aegis',
     'get-aegis-vault-state': 'aegis',
@@ -195,6 +205,7 @@ function inferActionProvider(action) {
   if (key.includes('aegis')) return 'aegis';
   if (key.includes('curve')) return 'curve';
   if (key.includes('uniswap')) return 'uniswap';
+  if (key.includes('ratehopper')) return 'ratehopper';
   if (key.includes('earn') || key.includes('yield') || key.includes('vault')) return 'earn';
   if (key.includes('bridge')) return 'bridge';
   if (key.includes('dogeos-barkswap')) return 'dogeos-barkswap';
@@ -283,9 +294,9 @@ function actionMatchesProvider(action, requestedProvider, allActions) {
   }
   if (requestedProvider.startsWith('dogeos')) return isProviderActionKey(action, requestedProvider);
   if (requestedProvider === 'earn') {
-    return provider === 'earn' || provider === 'morpho' || provider === 'aave' || provider === 'aegis' || provider === 'curve' || provider === 'uniswap' || provider === 'capyfi' || provider === 'vaults-fyi' || provider === 'yield-xyz' || isEarnCatalogAction(action);
+    return provider === 'earn' || provider === 'morpho' || provider === 'aave' || provider === 'aegis' || provider === 'curve' || provider === 'uniswap' || provider === 'ratehopper' || provider === 'capyfi' || provider === 'vaults-fyi' || provider === 'yield-xyz' || isEarnCatalogAction(action);
   }
-  if (requestedProvider === 'morpho' || requestedProvider === 'aave' || requestedProvider === 'aegis' || requestedProvider === 'curve' || requestedProvider === 'uniswap' || requestedProvider === 'capyfi' || requestedProvider === 'vaults-fyi' || requestedProvider === 'yield-xyz') {
+  if (requestedProvider === 'morpho' || requestedProvider === 'aave' || requestedProvider === 'aegis' || requestedProvider === 'curve' || requestedProvider === 'uniswap' || requestedProvider === 'ratehopper' || requestedProvider === 'capyfi' || requestedProvider === 'vaults-fyi' || requestedProvider === 'yield-xyz') {
     const hasProtocolSpecificEarnRows = allActions.some((candidate) => getActionProviderWithInference(candidate) === requestedProvider);
     return (
       isProviderActionKey(action, requestedProvider) ||

package/src/runtime/providerHints.mjs

@@ -611,6 +611,33 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           '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,
@@ -820,6 +847,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       basedbid: 'basedbid_create_lbp',
       curve: 'deposit_earn_position',
       uniswap: 'mint_uniswap_position',
+      ratehopper: 'setup_ratehopper_cash_lp',
       'vaults-fyi': 'deposit_earn_position',
       'yield-xyz': 'deposit_earn_position',
     };
@@ -830,6 +858,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       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',