@thirdfy/agent-cli 0.1.42 → 0.1.44

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.1.44] - 2026-05-20
+
+### Added
+
+- Aegis AgentKit provider hints for `get_aegis_pools`, pool/vault reads, and gated Engine writes on Base `8453` and Unichain `130` (fail-closed until partner Engine addresses/ABIs). Pairs with thirdfy-api-v2 **v3.4.28**.
+- Hyperliquid provider hints list `search_hyperliquid_markets` for joined perps meta + mids discovery (pairs with API **v3.4.28**).
+
+## [0.1.43] - 2026-05-19
+
+### Changed
+
+- Solo `agent_wallet` Hyperliquid account reads inject `userAddress` from the managed execution wallet via preflight when omitted (open orders, user state, funding status). Pairs with thirdfy-api-v2 **v3.4.27**.
+
 ## [0.1.42] - 2026-05-19
 
 ### 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.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.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

@@ -479,6 +479,7 @@ function getTradingProviderHint(providerId) {
       readActions: [
         'get_hyperliquid_perps_meta',
         'get_hyperliquid_all_mids',
+        'search_hyperliquid_markets',
         'get_hyperliquid_l2_book',
         'get_hyperliquid_candles',
         'get_hyperliquid_user_state',
@@ -540,7 +541,7 @@ function getTradingProviderHint(providerId) {
       laneCompatibility:
         'Use self only for setup signatures or Arbitrum funding transactions. Perps orders should use thirdfy, hybrid, or agent_wallet.',
       setupExample:
-        'actions --provider hyperliquid -> 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 -> 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',
       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"}\'',
     };
@@ -669,6 +670,9 @@ function getTradingProviderHint(providerId) {
         'get_earn_provider',
         'get_earn_position',
         'get_morpho_vaults',
+        'get_aegis_pools',
+        'get_aegis_pool_state',
+        'get_aegis_vault_state',
         'get_curve_pools',
         'get_vaults_fyi_vaults',
         'get_yield_xyz_opportunities',
@@ -692,6 +696,27 @@ function getTradingProviderHint(providerId) {
         'thirdfy-agent actions --provider morpho && thirdfy-agent run --action deposit_earn_position --params \'{"providerId":"morpho","vaultAddress":"0x...","tokenAddress":"0x...","amount":"10","chainId":8453}\'',
     };
   }
+  if (provider === 'aegis') {
+    return {
+      provider,
+      category: 'earn',
+      canonicalReadAction: 'get_aegis_pools',
+      canonicalWriteAction: 'deposit_aegis_lender',
+      readActions: ['get_earn_opportunities', 'get_aegis_pools', 'get_aegis_pool_state', 'get_aegis_vault_state', 'get_earn_provider'],
+      orderManagementActions: [
+        'deposit_aegis_lender',
+        'redeem_aegis_lender',
+        'open_aegis_vault_and_borrow',
+        'repay_aegis_vault',
+        'stabilize_aegis_vault',
+      ],
+      supportedChains: [8453, 130],
+      laneCompatibility:
+        'Aegis reads are live on Base allowlisted pools and Unichain DFM defaults. Engine writes use AegisRouterV1 with router-only approvals and eth_call simulation; writes stay fail-closed until partner addresses, PoolKeys, Engine ABI/opcodes, and audit sign-off. Use agent_wallet / walletExecute for solo Hermes — not execute-intent.',
+      example:
+        'thirdfy-agent actions --provider aegis --chain-id 8453 --json && thirdfy-agent run --action get_aegis_pool_state --run-mode agent_wallet --params \'{"pool":"tfy-usdc","chainId":8453}\'',
+    };
+  }
   if (provider === 'curve') {
     return {
       provider,
@@ -751,6 +776,7 @@ function getCachedProviderHintFromCapabilities(provider) {
     prediction: 'place_prediction_order',
     earn: 'deposit_earn_position',
     morpho: 'deposit_earn_position',
+    aegis: 'deposit_aegis_lender',
     curve: 'deposit_earn_position',
     'vaults-fyi': 'deposit_earn_position',
     'yield-xyz': 'deposit_earn_position',
@@ -758,6 +784,7 @@ function getCachedProviderHintFromCapabilities(provider) {
   const canonicalReadActions = {
     earn: 'get_earn_opportunities',
     morpho: 'get_morpho_vaults',
+    aegis: 'get_aegis_pools',
     curve: 'get_curve_pools',
     'vaults-fyi': 'get_vaults_fyi_vaults',
     'yield-xyz': 'get_yield_xyz_opportunities',
@@ -1001,6 +1028,45 @@ function getPreparedParams(flags) {
   return parseJsonFlag(flags, 'params');
 }
 
+function hyperliquidDefaultAddressParamForAction(action) {
+  const canonical = String(action || '').trim().toLowerCase().replace(/_/g, '-');
+  if (
+    canonical === 'get-hyperliquid-open-orders'
+    || canonical === 'get-hyperliquid-user-state'
+    || canonical === 'get-hyperliquid-builder-fee-status'
+    || canonical === 'get-hyperliquid-referral-status'
+  ) {
+    return 'userAddress';
+  }
+  if (
+    canonical === 'get-hyperliquid-setup-status'
+    || canonical === 'get-hyperliquid-funding-status'
+    || canonical === 'get-hyperliquid-onboarding-plan'
+    || canonical === 'prepare-hyperliquid-onboarding'
+  ) {
+    return 'mainWalletAddress';
+  }
+  return null;
+}
+
+async function applyHyperliquidAgentWalletAddressDefault(ctx, flags, resolved, runMode) {
+  if (runMode !== 'agent_wallet') return null;
+  const paramName = hyperliquidDefaultAddressParamForAction(resolved?.resolvedAction);
+  if (!paramName) return null;
+  const params = getPreparedParams(flags);
+  if (String(params?.[paramName] || '').trim()) return null;
+  const preflight = await resolveManagedExecutionPreflight(ctx, flags, resolved, {
+    runMode: 'agent_wallet',
+    requireFundingCheck: false,
+  });
+  if (!preflight.success || !preflight.executionWalletAddress) return preflight;
+  flags.__preparedParams = {
+    ...(params || {}),
+    [paramName]: preflight.executionWalletAddress,
+  };
+  return preflight;
+}
+
 async function commandCatalogsList(ctx, flags, capabilities) {
   const response = await apiGet(ctx, '/api/v1/agent/actions/catalog');
   const actions = extractActions(response);
@@ -1194,7 +1260,8 @@ async function commandPreflight(ctx, flags, capabilities) {
   enforceOffchainVenueLaneCompatibility(resolved.resolvedAction, runMode);
   const hybridWalletMode = runMode === 'hybrid' ? normalizeHybridWalletMode(flags.hybridWalletMode) : null;
   enforceChainCompatibility(capabilities, flags, runMode);
-  const backendResult = await runPreflightByMode(runMode, ctx, flags, resolved, { hybridWalletMode });
+  const managedPreflight = await applyHyperliquidAgentWalletAddressDefault(ctx, flags, resolved, runMode);
+  const backendResult = await runPreflightByMode(runMode, ctx, flags, resolved, { hybridWalletMode, managedPreflight });
   const normalized = applyExecutionFallbackHints(backendResult.normalized, {
     flags,
     runMode,
@@ -1229,10 +1296,12 @@ async function commandRun(ctx, flags, capabilities) {
   enforceOffchainVenueLaneCompatibility(resolved.resolvedAction, runMode);
   const hybridWalletMode = runMode === 'hybrid' ? normalizeHybridWalletMode(flags.hybridWalletMode) : null;
   enforceChainCompatibility(capabilities, flags, runMode);
+  const managedPreflight = await applyHyperliquidAgentWalletAddressDefault(ctx, flags, resolved, runMode);
   const skipPreflight = Boolean(flags.skipPreflight);
   const backendResult = await runExecutionByMode(runMode, ctx, flags, resolved, {
     skipPreflight,
     hybridWalletMode,
+    managedPreflight,
   });
   const normalized = applyExecutionFallbackHints(backendResult.normalized, {
     flags,
@@ -1327,8 +1396,9 @@ async function commandWalletExecute(ctx, flags, capabilities) {
   const resolved = await resolveActionSelection(ctx, normalizedFlags);
   prepareActionParamsForFlags(normalizedFlags, resolved.resolvedAction);
   enforceChainCompatibility(capabilities, normalizedFlags, 'agent_wallet');
+  const managedPreflight = await applyHyperliquidAgentWalletAddressDefault(ctx, normalizedFlags, resolved, 'agent_wallet');
   const skipPreflight = Boolean(normalizedFlags.skipPreflight);
-  const result = await executeManagedWalletRun(ctx, normalizedFlags, resolved, { skipPreflight });
+  const result = await executeManagedWalletRun(ctx, normalizedFlags, resolved, { skipPreflight, managedPreflight });
   printEnvelope({
     success: result.success,
     code: result.success ? 'WALLET_EXECUTED' : result.preflightBlocked ? 'PREFLIGHT_BLOCKED' : 'RUN_FAILED',
@@ -3358,6 +3428,7 @@ async function runPreflightByMode(runMode, ctx, flags, resolved, options = {}) {
     const preflight = await resolveManagedExecutionPreflight(ctx, flags, resolved, {
       runMode,
       requireFundingCheck: true,
+      preflightSeed: options.managedPreflight,
     });
     const normalized = normalizeIntentResponse({
       success: preflight.success,
@@ -3569,6 +3640,7 @@ async function executeManagedWalletRun(ctx, flags, resolved, options) {
     preflight = await resolveManagedExecutionPreflight(ctx, flags, resolved, {
       runMode: 'agent_wallet',
       requireFundingCheck: true,
+      preflightSeed: options?.managedPreflight,
     });
     if (!preflight.success) {
       const normalized = normalizeIntentResponse({
@@ -3821,9 +3893,21 @@ async function resolveManagedExecutionPreflight(ctx, flags, resolved, options =
     runMode,
   });
   if (tokenIn) query.set('tokenIn', tokenIn);
-  const response = await apiGet(ctx, `/api/v1/agent/execution-wallet?${query.toString()}`, {
-    'x-agent-api-key': agentApiKey,
-  });
+  const preflightSeed = options.preflightSeed && typeof options.preflightSeed === 'object'
+    ? options.preflightSeed
+    : null;
+  if (preflightSeed && preflightSeed.success === false) {
+    return preflightSeed;
+  }
+  const response = preflightSeed
+    ? {
+      executionWalletAddress: preflightSeed.executionWalletAddress || null,
+      signerMethod: preflightSeed.signerMethod || null,
+      fundingTokenBalance: preflightSeed.fundingTokenBalance || null,
+    }
+    : await apiGet(ctx, `/api/v1/agent/execution-wallet?${query.toString()}`, {
+      'x-agent-api-key': agentApiKey,
+    });
   const executionWalletAddress = String(response?.executionWalletAddress || '').trim().toLowerCase();
   const signerMethod = String(response?.signerMethod || 'managed_wallet_server').trim();
   const rawBalance = String(response?.fundingTokenBalance?.raw || '').trim();
@@ -4028,6 +4112,7 @@ function inferActionProvider(action) {
     'get-governance-v2-breakdowns': 'governance-v2',
     'get-hyperliquid-perps-meta': 'hyperliquid',
     'get-hyperliquid-all-mids': 'hyperliquid',
+    'search-hyperliquid-markets': 'hyperliquid',
     'get-hyperliquid-l2-book': 'hyperliquid',
     'get-hyperliquid-candles': 'hyperliquid',
     'get-hyperliquid-user-state': 'hyperliquid',
@@ -4064,6 +4149,14 @@ function inferActionProvider(action) {
     'get-curve-pool-details': 'curve',
     'deposit-curve-pool': 'curve',
     'withdraw-curve-pool': 'curve',
+    'get-aegis-pools': 'aegis',
+    'get-aegis-pool-state': 'aegis',
+    'get-aegis-vault-state': 'aegis',
+    'deposit-aegis-lender': 'aegis',
+    'redeem-aegis-lender': 'aegis',
+    'open-aegis-vault-and-borrow': 'aegis',
+    'repay-aegis-vault': 'aegis',
+    'stabilize-aegis-vault': 'aegis',
     'get-vaults-fyi-vaults': 'vaults-fyi',
     'get-vaults-fyi-opportunities': 'vaults-fyi',
     'get-yield-xyz-opportunities': 'yield-xyz',
@@ -4098,6 +4191,7 @@ function inferActionProvider(action) {
   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('aegis')) return 'aegis';
   if (key.includes('curve')) return 'curve';
   if (key.includes('earn') || key.includes('yield') || key.includes('vault')) return 'earn';
   if (key.includes('bridge')) return 'bridge';
@@ -4148,9 +4242,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' || provider === 'vaults-fyi' || provider === 'yield-xyz' || isEarnCatalogAction(action);
+    return provider === 'earn' || provider === 'morpho' || provider === 'aegis' || provider === 'curve' || provider === 'vaults-fyi' || provider === 'yield-xyz' || isEarnCatalogAction(action);
   }
-  if (requestedProvider === 'morpho' || requestedProvider === 'curve' || requestedProvider === 'vaults-fyi' || requestedProvider === 'yield-xyz') {
+  if (requestedProvider === 'morpho' || requestedProvider === 'aegis' || 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.42",
+  "version": "0.1.44",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {