@thirdfy/agent-cli 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.5] - 2026-05-31
+
+### Fixed
+
+- Vaults.fyi provider hints now report `get-vaults-fyi-vaults` as the canonical read action.
+- Legacy `get_vaults_fyi_vaults` requests resolve to `get-vaults-fyi-vaults` before ambiguous alias matching.
+- Public action inventory docs now match the hyphenated Vaults.fyi discovery action used by Thirdfy API and MCP.
+
+## [0.2.4] - 2026-05-28
+
+### Changed
+
+- Hyperliquid docs: `complete_hyperliquid_onboarding` as the preferred runtime-owned setup action; clarify separated Hyperliquid main wallet vs managed API/execution wallet params (`mainWalletAddress`, `apiWalletAddress`, order `userAddress`).
+
 ## [0.2.3] - 2026-05-26
 
 ### Added
@@ -195,7 +209,7 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ### 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.
+- **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
 

package/README.md

@@ -40,12 +40,11 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.3
+## What's new in v0.2.5
 
-- **Hyperliquid** and **Polymarket** provider discovery now include `recoveryActions` and `decommissionExample` for fund recovery before runtime delete.
-- Hyperliquid recovery path: `get_hyperliquid_user_state` → `withdraw_hyperliquid_to_arbitrum` → withdraw execution wallet to owner.
-- Polymarket recovery path: `get_polymarket_recovery_status` → `withdraw_polymarket_collateral` → withdraw execution wallet to owner.
-- Pairs with Thirdfy API **v3.4.42+** managed recovery actions and EarnClaw runtime decommission flows.
+- Vaults.fyi provider hints now report `get-vaults-fyi-vaults` as the canonical read action.
+- The legacy underscore request `get_vaults_fyi_vaults` resolves to the hyphenated catalog action before ambiguous alias matching.
+- Public action inventory docs use the same hyphenated Vaults.fyi discovery action as Thirdfy API and MCP.
 
 Older versions: [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
 
@@ -182,7 +181,7 @@ Auth expectations by mode:
 - `hybrid`: requires execution identity and governed mirror semantics (`--hybrid-wallet-mode self|agent_wallet`, default `self`).
 - `thirdfy`: requires execution identity and delegated governance path.
 - `agent_wallet`: requires execution identity and owner `userDid`, but does not require subscriber delegation when the owner identity matches the agent wallet/creator. Thirdfy credits/free quota still gate execution; Privy gas sponsorship only covers network gas when enabled.
-- Hyperliquid Bridge2 setup is the Arbitrum exception to the Base-focused `agent_wallet` rule: Bridge2 credits the transaction sender. Pass **`--estimated-amount-usd`** as a top-level flag (not inside `--params`). When USDC sits on your linked email-login wallet (`primaryEvmWallet`) instead of the managed execution wallet, Thirdfy API returns **`FUND_AGENT_EXECUTION_WALLET`** / **`MANUAL_BRIDGE2_DEPOSIT_REQUIRED`** with `fundedWallet` and `executionWalletAddress`; move native Arbitrum USDC to `executionWalletAddress` and retry.
+- Hyperliquid setup uses `complete_hyperliquid_onboarding` for runtime-owned funding/setup. It can submit Li.Fi and Bridge2 steps automatically, then return `bridge2_submitted` while Hyperliquid credits the deposit. Bridge2 setup is the Arbitrum exception to the Base-focused `agent_wallet` rule: Bridge2 credits the transaction sender. Pass **`--estimated-amount-usd`** as a top-level flag (not inside `--params`). The normal solo `agent_wallet` path uses the managed execution wallet as the Hyperliquid main wallet. If margin already sits on a different Hyperliquid main wallet, pass that wallet as `mainWalletAddress` / order `userAddress`, and pass the approved execution/API wallet as `apiWalletAddress`. When USDC sits on your linked email-login wallet (`primaryEvmWallet`) instead of the managed execution wallet, Thirdfy API returns **`FUND_AGENT_EXECUTION_WALLET`** / **`MANUAL_BRIDGE2_DEPOSIT_REQUIRED`** with `fundedWallet` and `executionWalletAddress`; move native Arbitrum USDC to `executionWalletAddress` and retry.
 - custody mode defaults are profile-aware:
   - `managed` default for `thirdfy`
   - `external` default for `self` and `hybrid`

package/package.json

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

package/src/runtime/actions/selection.mjs

@@ -276,6 +276,22 @@ async function resolveActionSelection(ctx, flags) {
     return { requestedAction, resolvedAction: requestedAction, resolvedActionMeta: null };
   }
 
+  const canonicalAliasOverrides = {
+    get_vaults_fyi_vaults: 'get-vaults-fyi-vaults',
+    get_vaults_fyi_opportunities: 'get-vaults-fyi-vaults',
+  };
+  const canonicalOverride = canonicalAliasOverrides[requestedLower];
+  if (canonicalOverride) {
+    const overrideEntry = keyed.find((entry) => entry.key.toLowerCase() === canonicalOverride);
+    if (overrideEntry) {
+      return {
+        requestedAction,
+        resolvedAction: overrideEntry.key,
+        resolvedActionMeta: overrideEntry.action || null,
+      };
+    }
+  }
+
   // Prefer direct action id matches over alias matches.
   // This keeps UX simple for commands like `--action swap` when another action aliases to "swap".
   const exactKey = keyed.filter((entry) => entry.key.toLowerCase() === requestedLower);

package/src/runtime/providerHints.mjs

@@ -250,7 +250,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'get_aegis_pool_state',
           'get_aegis_vault_state',
           'get_curve_pools',
-          'get_vaults_fyi_vaults',
+          'get-vaults-fyi-vaults',
           'get_yield_xyz_opportunities',
         ],
         orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
@@ -335,9 +335,9 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       return {
         provider,
         category: 'earn',
-        canonicalReadAction: 'get_vaults_fyi_vaults',
+        canonicalReadAction: 'get-vaults-fyi-vaults',
         canonicalWriteAction: 'deposit_earn_position',
-        readActions: ['get_vaults_fyi_vaults', 'get_earn_opportunities', 'get_earn_provider', 'get_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.',
@@ -387,7 +387,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       morpho: 'get_morpho_vaults',
       aegis: 'get_aegis_pools',
       curve: 'get_curve_pools',
-      'vaults-fyi': 'get_vaults_fyi_vaults',
+      'vaults-fyi': 'get-vaults-fyi-vaults',
       'yield-xyz': 'get_yield_xyz_opportunities',
       prediction: 'get_prediction_markets',
     };