@thirdfy/agent-cli 0.2.4 → 0.2.6

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.6] - 2026-06-05
+
+### Changed
+
+- Hyperliquid provider hints: `complete_hyperliquid_onboarding` in setup actions; `setupWarnings` for `HYPERLIQUID_BUILDER_WALLET_UNFUNDED`; builder monetization copy matches Thirdfy API setup/execute parity (approval only when builder treasury is funded).
+- Hyperliquid command reference documents active-builder gate and when `approve_hyperliquid_builder_fee` is required.
+
+## [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
@@ -201,7 +216,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,13 +40,11 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.4
+## What's new in v0.2.6
 
-- Hyperliquid setup docs now lead with `complete_hyperliquid_onboarding` for runtime-owned Li.Fi, Bridge2, and approval steps.
-- Clarified the separated Hyperliquid wallet model: pass `mainWalletAddress` / order `userAddress` for the funded HL account and `apiWalletAddress` for the managed execution/API wallet when they differ.
-- Operator previews still use `get_hyperliquid_onboarding_plan` and `prepare_hyperliquid_onboarding`.
-
-Older versions: [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
+- Hyperliquid provider hints include `complete_hyperliquid_onboarding` and `setupWarnings` for unfunded builder treasury (`HYPERLIQUID_BUILDER_WALLET_UNFUNDED`).
+- Builder fee approval is documented only when builder monetization is active (builder treasury funded on Hyperliquid).
+- Command reference matches Thirdfy API setup/execute parity for Hyperliquid perps.
 
 Older versions: [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thirdfy/agent-cli",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "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

@@ -45,6 +45,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'get_hyperliquid_setup_status',
           'get_hyperliquid_onboarding_plan',
           'prepare_hyperliquid_onboarding',
+          'complete_hyperliquid_onboarding',
           'get_bridge_quote',
           'execute_bridge',
           'approve_hyperliquid_agent',
@@ -87,13 +88,19 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'HYPERLIQUID_CREDITS_REQUIRED',
           'HYPERLIQUID_API_WALLET_SIGNER_REQUIRED',
         ],
+        setupWarnings: [
+          'HYPERLIQUID_BUILDER_WALLET_UNFUNDED',
+          'HYPERLIQUID_API_WALLET_NOT_PROVIDED',
+        ],
         sourceBridgeProvider: 'lifi',
         funding:
           'Best path: Base/Ethereum/Polygon USDC -> Li.Fi bridge to native Arbitrum USDC -> Hyperliquid Bridge2. If the user already has native Circle USDC on Arbitrum One (42161), skip Li.Fi and call deposit_hyperliquid_bridge. Minimum 5 USDC; Bridge2 credits the sender/source wallet.',
         laneCompatibility:
-          'Use self only for setup signatures or Arbitrum funding transactions. Perps orders should use thirdfy, hybrid, or agent_wallet.',
+          'Use self/BYOW only for setup signatures or Arbitrum funding transactions. Perps order placement is an offchain venue write and should use thirdfy, hybrid, or agent_wallet. The default solo agent_wallet path uses the managed execution wallet as the Hyperliquid master address. If margin already sits on a distinct Hyperliquid main wallet, pass that as userAddress/mainWalletAddress and pass the approved execution/API wallet as apiWalletAddress.',
         setupExample:
-          'actions --provider hyperliquid -> search_hyperliquid_markets (or get_hyperliquid_perps_meta + get_hyperliquid_all_mids) -> get_hyperliquid_funding_status -> get_hyperliquid_onboarding_plan -> prepare_hyperliquid_onboarding -> get_bridge_quote/execute_bridge if source is Base -> deposit_hyperliquid_bridge on 42161 -> approve_hyperliquid_agent -> approve_hyperliquid_builder_fee if required -> get_hyperliquid_setup_status',
+          'actions --provider hyperliquid -> get_hyperliquid_funding_status -> complete_hyperliquid_onboarding for runtime-owned setup, or get_hyperliquid_onboarding_plan/prepare_hyperliquid_onboarding for operator previews -> get_bridge_quote/execute_bridge if source is Base/Ethereum/Polygon -> deposit_hyperliquid_bridge on 42161 -> approve_hyperliquid_agent -> approve_hyperliquid_builder_fee only when get_hyperliquid_setup_status shows builder.enabled=true -> get_hyperliquid_setup_status before place_hyperliquid_perps_order',
+        monetization:
+          'Builder monetization is active only when the API operator configured a builder address and the builder treasury has Hyperliquid margin. When active, the main wallet signs approve_hyperliquid_builder_fee once and orders attach builder fees. When the treasury is unfunded, get_hyperliquid_setup_status can return ready=true with warning HYPERLIQUID_BUILDER_WALLET_UNFUNDED, get_hyperliquid_builder_fee_status returns monetizationEnabled=false with reason BUILDER_WALLET_UNFUNDED, and place_hyperliquid_perps_order does not require builder approval.',
         example:
           'thirdfy-agent actions --provider hyperliquid && thirdfy-agent preflight --action place_hyperliquid_perps_order --params \'{"coin":"ETH","isBuy":true,"size":0.01,"limitPx":3500,"orderType":"market"}\'',
       };
@@ -250,7 +257,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 +342,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 +394,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',
     };