@thirdfy/agent-cli 0.1.46 → 0.1.48

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.1.48] - 2026-05-23
+
+### Fixed
+
+- `actions --provider <earn-adapter>` only includes generic `deposit_earn_position` / `withdraw_earn_position` when catalog provider is `earn` or matches the requested adapter (avoids morpho filter showing vaults-fyi-tagged rows).
+
+## [0.1.47] - 2026-05-23
+
+### Added
+
+- Provider discovery hints for `capyfi`, `fx`, and `bridge`; expanded Kyber `supportedChains` on `trading`.
+- `docs/providers/capyfi.md` operator guide.
+
 ## [0.1.46] - 2026-05-22
 
 ### Changed

package/README.md

@@ -42,7 +42,7 @@ npx @thirdfy/agent-cli --help
 
 ## Release notes
 
-Version history and highlights: [CHANGELOG.md](./CHANGELOG.md). **v0.1.46** routes `polymarket status` through `get_polymarket_funding_status` with config `agentKey` and defaults dry-run to `place-polymarket-order` (pairs with API **v3.4.37**). **v0.1.45** adds `polymarket status`, `polymarket setup`, and `polymarket dry-run` for agent-scoped setup/geoblock preflight (pairs with API **v3.4.35**). **v0.1.44** adds Aegis provider hints for Base and Unichain earn reads and fail-closed Engine writes (pairs with API **v3.4.28**). **v0.1.43** injects Hyperliquid `userAddress` from the managed execution wallet for solo `agent_wallet` reads when omitted (pairs with API **v3.4.27**). **v0.1.42** persists API `executionWallets` from email login, updates `doctor auth` / onboarding help for agent execution wallet funding vs owner embedded auth wallet, and documents Bridge2 `FUND_AGENT_EXECUTION_WALLET` remediation (pairs with API **v3.4.25**). **v0.1.41** documents Hyperliquid `get_hyperliquid_funding_status` as setup step 0, Bridge2 sender custody, and `deposit_hyperliquid_bridge --estimated-amount-usd` (pairs with API **v3.4.24**). **v0.1.40** fixes email/bootstrap credential persistence when the API returns nested registration payloads, so owner-session onboarding can save the hidden execution identity without exposing a raw agent API key. **v0.1.39** makes `agent_wallet` the fresh solo default, adds framework guidance for Hermes/OpenClaw/Claude Managed Agents, clarifies Gator/ERC-7710 delegation flows, and keeps BYOW/self plus hybrid/thirdfy mode switching explicit. **v0.1.38** is a **documentation and metadata patch**: it republishes to npm so the package homepage matches the updated `README.md` on `main`, and aligns root `package-lock.json` version fields with `package.json`. **v0.1.37** adds **email OTP** `thirdfy-agent login email` (send code, then complete with `--code --accept-terms`), **`help onboarding`**, **`doctor auth`**, **`wallet list`**, and **masked `whoami`** output so agents and operators get first-run guidance without dumping secrets. Earlier releases added provider discovery parity, portfolio analytics, managed-wallet swap normalization, and **self/build-tx** swap human-decimal `amountIn` parity when using `amountInHuman` + `tokenInDecimals`.
+Version history and highlights: [CHANGELOG.md](./CHANGELOG.md). **v0.1.48** fixes earn provider filtering so generic `deposit_earn_position` / `withdraw_earn_position` rows only appear for matching adapters (not unrelated morpho/vaults-fyi filters). **v0.1.47** adds CapyFi, FX, and bridge provider discovery hints. **v0.1.46** routes `polymarket status` through `get_polymarket_funding_status` with config `agentKey` and defaults dry-run to `place-polymarket-order` (pairs with API **v3.4.37**). **v0.1.45** adds `polymarket status`, `polymarket setup`, and `polymarket dry-run` for agent-scoped setup/geoblock preflight (pairs with API **v3.4.35**). **v0.1.44** adds Aegis provider hints for Base and Unichain earn reads and fail-closed Engine writes (pairs with API **v3.4.28**). **v0.1.43** injects Hyperliquid `userAddress` from the managed execution wallet for solo `agent_wallet` reads when omitted (pairs with API **v3.4.27**). **v0.1.42** persists API `executionWallets` from email login, updates `doctor auth` / onboarding help for agent execution wallet funding vs owner embedded auth wallet, and documents Bridge2 `FUND_AGENT_EXECUTION_WALLET` remediation (pairs with API **v3.4.25**). **v0.1.41** documents Hyperliquid `get_hyperliquid_funding_status` as setup step 0, Bridge2 sender custody, and `deposit_hyperliquid_bridge --estimated-amount-usd` (pairs with API **v3.4.24**). **v0.1.40** fixes email/bootstrap credential persistence when the API returns nested registration payloads, so owner-session onboarding can save the hidden execution identity without exposing a raw agent API key. **v0.1.39** makes `agent_wallet` the fresh solo default, adds framework guidance for Hermes/OpenClaw/Claude Managed Agents, clarifies Gator/ERC-7710 delegation flows, and keeps BYOW/self plus hybrid/thirdfy mode switching explicit. **v0.1.38** is a **documentation and metadata patch**: it republishes to npm so the package homepage matches the updated `README.md` on `main`, and aligns root `package-lock.json` version fields with `package.json`. **v0.1.37** adds **email OTP** `thirdfy-agent login email` (send code, then complete with `--code --accept-terms`), **`help onboarding`**, **`doctor auth`**, **`wallet list`**, and **masked `whoami`** output so agents and operators get first-run guidance without dumping secrets. Earlier releases added provider discovery parity, portfolio analytics, managed-wallet swap normalization, and **self/build-tx** swap human-decimal `amountIn` parity when using `amountInHuman` + `tokenInDecimals`.
 
 **Maintainers — npm:** follow [docs/releasing.md](./docs/releasing.md). From a clone with gitignored `.env`, use `npm run publish:npm:local -- --dry-run` then `npm run publish:npm:local`. Or run `npm run release:npm` after exporting tokens in the shell. Never commit npm tokens — use [.env.example](./.env.example) as a template only.
 

package/bin/thirdfy-agent.mjs

@@ -477,6 +477,9 @@ function getTradingProviderHint(providerId) {
       provider,
       category: 'onchain_spot',
       canonicalWriteAction: 'swap',
+      supportedChains: [1, 10, 130, 137, 8453, 84532, 42161],
+      laneCompatibility:
+        'Kyber quote/build is live on Ethereum, Optimism, Unichain, Polygon, Base, and Arbitrum; sponsored Kyber execution is validated on Base only. Gnosis FX uses the fx provider via CoW.',
       credentialUx: 'Use normal Thirdfy login/delegation; do not use this provider for Hyperliquid or Polymarket.',
     };
   }
@@ -670,6 +673,18 @@ function getTradingProviderHint(providerId) {
       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],
+      laneCompatibility: 'Li.Fi bridge supports mainnet value movement only; testnets are not auto-mapped to mainnet.',
+    };
+  }
   if (provider === 'earn') {
     return {
       provider,
@@ -693,6 +708,31 @@ function getTradingProviderHint(providerId) {
         '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 === 'capyfi') {
+    return {
+      provider,
+      category: 'earn',
+      canonicalReadAction: 'get_capyfi_markets',
+      canonicalWriteAction: 'deposit_earn_position',
+      readActions: ['get_capyfi_markets', '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,
@@ -4166,6 +4206,10 @@ function inferActionProvider(action) {
     'get-earn-position': 'earn',
     'deposit-earn-position': 'earn',
     'withdraw-earn-position': 'earn',
+    'get-capyfi-markets': 'capyfi',
+    'get-fx-supported-assets': 'fx',
+    'quote-fx-swap': 'fx',
+    'get-monerium-profile-status': 'fx',
     'get-morpho-vaults': 'morpho',
     'deposit-morpho-vault': 'morpho',
     'withdraw-morpho-vault': 'morpho',
@@ -4214,6 +4258,8 @@ function inferActionProvider(action) {
   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('capyfi')) return 'capyfi';
+  if (key.includes('fx') || key.includes('monerium')) return 'fx';
   if (key.includes('morpho')) return 'morpho';
   if (key.includes('aegis')) return 'aegis';
   if (key.includes('curve')) return 'curve';
@@ -4238,6 +4284,21 @@ function isEarnCatalogAction(action) {
   );
 }
 
+function isGenericEarnWriteAction(action) {
+  const actionKey = rowActionKey(action);
+  return actionKey === 'deposit_earn_position' || actionKey === 'withdraw_earn_position';
+}
+
+/** Generic earn writes are shared catalog rows; only attach to the matching adapter or unlabeled rows. */
+function isGenericEarnWriteForProvider(action, requestedProvider) {
+  if (!isGenericEarnWriteAction(action)) return false;
+  const provider = getActionProviderWithInference(action);
+  if (!provider) return true;
+  if (provider === requestedProvider) return true;
+  if (provider === 'earn' && requestedProvider === 'earn') return true;
+  return false;
+}
+
 function isSpotTradingCatalogAction(action) {
   const actionKey = rowActionKey(action);
   return actionKey === 'swap' || actionKey === 'execute_optimal_swap' || actionKey === 'get_best_trading_quote';
@@ -4263,14 +4324,22 @@ function actionMatchesProvider(action, requestedProvider, allActions) {
   // Here resolved metadata already disagrees with the filter; fall back to action-key shape only.
   if (requestedProvider === 'hyperliquid') return isProviderActionKey(action, 'hyperliquid');
   if (requestedProvider === 'polymarket') return isProviderActionKey(action, 'polymarket');
-  if (requestedProvider === 'bridge') return isProviderActionKey(action, 'bridge');
+  if (requestedProvider === 'bridge') {
+    // Hyperliquid Bridge2 setup actions are owned by Hyperliquid, not the cross-chain bridge provider.
+    if (provider === 'hyperliquid') return false;
+    return isProviderActionKey(action, 'bridge');
+  }
   if (requestedProvider.startsWith('dogeos')) return isProviderActionKey(action, requestedProvider);
   if (requestedProvider === 'earn') {
-    return provider === 'earn' || provider === 'morpho' || provider === 'aegis' || provider === 'curve' || provider === 'vaults-fyi' || provider === 'yield-xyz' || isEarnCatalogAction(action);
+    return provider === 'earn' || provider === 'morpho' || provider === 'aegis' || provider === 'curve' || provider === 'capyfi' || provider === 'vaults-fyi' || provider === 'yield-xyz' || isEarnCatalogAction(action);
   }
-  if (requestedProvider === 'morpho' || requestedProvider === 'aegis' || requestedProvider === 'curve' || requestedProvider === 'vaults-fyi' || requestedProvider === 'yield-xyz') {
+  if (requestedProvider === 'morpho' || requestedProvider === 'aegis' || requestedProvider === 'curve' || requestedProvider === 'capyfi' || requestedProvider === 'vaults-fyi' || requestedProvider === 'yield-xyz') {
     const hasProtocolSpecificEarnRows = allActions.some((candidate) => getActionProviderWithInference(candidate) === requestedProvider);
-    return isProviderActionKey(action, requestedProvider) || (!hasProtocolSpecificEarnRows && isEarnCatalogAction(action));
+    return (
+      isProviderActionKey(action, requestedProvider) ||
+      isGenericEarnWriteForProvider(action, requestedProvider) ||
+      (!hasProtocolSpecificEarnRows && isEarnCatalogAction(action))
+    );
   }
   if (requestedProvider === 'prediction') {
     return (

package/package.json

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