@thirdfy/agent-cli 0.2.61 → 0.2.63

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.63] - 2026-09-09
+
+### Changed
+
+- Prediction provider hints prefer `get_prediction_markets` with Gamma `tag_id` and `end_date_min` / `end_date_max` over `search_prediction_markets` for discovery. Pairs with `thirdfy-mcp` **0.0.113** and Thirdfy API **3.14.30**.
+
+## [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

package/README.md

@@ -40,10 +40,11 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.61
+## What's new in v0.2.63
 
-- Vault withdraw and claim no longer treat the received asset as the funding token.
-- A fully deployed earn position can exit even when the wallet holds none of that asset.
+- Polymarket discovery uses `get_prediction_markets` with a Gamma `tag_id` and an `end_date_min` / `end_date_max` window.
+- `search_prediction_markets` is for human text or slug lookup, not agent discovery.
+- `get_polymarket_user_orders` returns `orders` and `openOrderCount` at the top level.
 - 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.61",
+  "version": "0.2.63",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {

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

@@ -433,11 +433,18 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         canonicalWriteAction: 'place_prediction_order',
         readActions: [
           'get_prediction_tags',
-          'search_prediction_markets',
-          'get_prediction_events',
           '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',
@@ -611,6 +618,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 +854,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 +865,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',