@thirdfy/agent-cli 0.1.31 → 0.1.32

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.1.32] - 2026-05-08
+
+### Added
+
+- **Earn partners (Vaults.fyi and Yield.xyz):** `thirdfy-agent actions --provider vaults-fyi|yield-xyz` returns catalog-aligned hints (`get_vaults_fyi_vaults` / `get_yield_xyz_opportunities`, generic Earn reads, `deposit_earn_position` / `withdraw_earn_position`). Provider inference and `--provider earn` filtering include these providers alongside Morpho and Curve.
+
+### Changed
+
+- Public docs (`docs/command-reference.md`, `docs/action-inventory-and-compatibility.md`, `docs/providers/index.md`) describe partner earn discovery and transaction-prep-first writes.
+- **`--provider earn` hints:** Umbrella `readActions` lists Morpho and Curve discovery actions (`get_morpho_vaults`, `get_curve_pools`) together with partner reads so Earn hints stay symmetric across sub-providers.
+
 ## [0.1.31] - 2026-05-07
 
 ### Fixed

package/bin/thirdfy-agent.mjs

@@ -530,10 +530,18 @@ function getTradingProviderHint(providerId) {
       category: 'earn',
       canonicalReadAction: 'get_earn_opportunities',
       canonicalWriteAction: 'deposit_earn_position',
-      readActions: ['get_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
+      readActions: [
+        'get_earn_opportunities',
+        'get_earn_provider',
+        'get_earn_position',
+        'get_morpho_vaults',
+        'get_curve_pools',
+        'get_vaults_fyi_vaults',
+        'get_yield_xyz_opportunities',
+      ],
       orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
       laneCompatibility:
-        'Generic earn writes use deposit_earn_position / withdraw_earn_position on normal Thirdfy policy/delegation rails; routing selects Morpho vault calldata or the validated Curve Base 4pool adapter on Base (8453) per opportunity.',
+        'Generic earn writes use deposit_earn_position / withdraw_earn_position on normal Thirdfy policy/delegation rails; routing selects Morpho, Curve, Vaults.fyi, or Yield.xyz adapters per provider/opportunity.',
     };
   }
   if (provider === 'morpho') {
@@ -563,6 +571,34 @@ function getTradingProviderHint(providerId) {
         '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 === 'vaults-fyi') {
+    return {
+      provider,
+      category: 'earn',
+      canonicalReadAction: 'get_vaults_fyi_vaults',
+      canonicalWriteAction: 'deposit_earn_position',
+      readActions: ['get_vaults_fyi_vaults', '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_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
+      orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
+      laneCompatibility:
+        'Yield.xyz writes are transaction-prep first. Thirdfy calls Yield.xyz directly and validates returned unsigned transactions with @yieldxyz/shield before signing or returning prepared calls.',
+      example:
+        'thirdfy-agent actions --provider yield-xyz && thirdfy-agent preflight --action deposit_earn_position --params \'{"providerId":"yield-xyz","opportunityId":"ethereum-eth-lido-staking","tokenAddress":"0x...","amount":"0.01","chainId":1}\'',
+    };
+  }
   return null;
 }
 
@@ -582,11 +618,15 @@ function getCachedProviderHintFromCapabilities(provider) {
     earn: 'deposit_earn_position',
     morpho: 'deposit_earn_position',
     curve: 'deposit_earn_position',
+    'vaults-fyi': 'deposit_earn_position',
+    'yield-xyz': 'deposit_earn_position',
   };
   const canonicalReadActions = {
     earn: 'get_earn_opportunities',
     morpho: 'get_morpho_vaults',
     curve: 'get_curve_pools',
+    'vaults-fyi': 'get_vaults_fyi_vaults',
+    'yield-xyz': 'get_yield_xyz_opportunities',
     prediction: 'get_prediction_markets',
   };
   return {
@@ -3434,6 +3474,9 @@ function inferActionProvider(action) {
     'get-curve-pool-details': 'curve',
     'deposit-curve-pool': 'curve',
     'withdraw-curve-pool': 'curve',
+    'get-vaults-fyi-vaults': 'vaults-fyi',
+    'get-vaults-fyi-opportunities': 'vaults-fyi',
+    'get-yield-xyz-opportunities': 'yield-xyz',
     'get-prediction-markets': 'polymarket',
     'get-prediction-market': 'polymarket',
     'get-prediction-order-book': 'polymarket',
@@ -3449,9 +3492,11 @@ function inferActionProvider(action) {
   if (knownMap[key]) return knownMap[key];
   if (key.includes('hyperliquid')) return 'hyperliquid';
   if (key.includes('polymarket') || key.includes('prediction')) return 'polymarket';
+  if (key.includes('vaults-fyi')) return 'vaults-fyi';
+  if (key.includes('yield-xyz')) return 'yield-xyz';
   if (key.includes('morpho')) return 'morpho';
   if (key.includes('curve')) return 'curve';
-  if (key.includes('earn')) return 'earn';
+  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';
   if (key.includes('dogeos-laika')) return 'dogeos-laika';
@@ -3500,9 +3545,9 @@ function actionMatchesProvider(action, requestedProvider, allActions) {
   if (requestedProvider === 'bridge') return isProviderActionKey(action, 'bridge');
   if (requestedProvider.startsWith('dogeos')) return isProviderActionKey(action, requestedProvider);
   if (requestedProvider === 'earn') {
-    return provider === 'earn' || provider === 'morpho' || provider === 'curve' || isEarnCatalogAction(action);
+    return provider === 'earn' || provider === 'morpho' || provider === 'curve' || provider === 'vaults-fyi' || provider === 'yield-xyz' || isEarnCatalogAction(action);
   }
-  if (requestedProvider === 'morpho' || requestedProvider === 'curve') {
+  if (requestedProvider === 'morpho' || requestedProvider === 'curve' || requestedProvider === 'vaults-fyi' || requestedProvider === 'yield-xyz') {
     const hasProtocolSpecificEarnRows = allActions.some((candidate) => getActionProviderWithInference(candidate) === requestedProvider);
     return isProviderActionKey(action, requestedProvider) || (!hasProtocolSpecificEarnRows && isEarnCatalogAction(action));
   }

package/package.json

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