@thirdfy/agent-cli 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [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
+
+- Hyperliquid and Polymarket `recoveryActions` and `decommissionExample` in `providerHints` for fund recovery before runtime delete (pairs with Thirdfy API v3.4.42+).
+
 ## [0.2.2] - 2026-05-23
 
 ### Changed

package/README.md

@@ -40,12 +40,15 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.2
+## What's new in v0.2.4
 
-- **npm README cleanup** — the registry homepage is user-facing again: one **What's new** section for the current version, full history in [CHANGELOG.md](./CHANGELOG.md) (no multi-version release wall or maintainer publish steps on npm).
-- **Public docs validation** — `npm run validate:public-docs` enforces README/npm surface rules before publish.
+- 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 highlights (Commander routing, stricter flags): see [CHANGELOG.md](./CHANGELOG.md) · [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
+Older versions: [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
+
+Older versions: [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
 
 ## Quick start
 
@@ -180,7 +183,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.2",
+  "version": "0.2.4",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {

package/src/runtime/providerHints.mjs

@@ -61,6 +61,12 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'get_hyperliquid_builder_fee_status',
           'get_hyperliquid_referral_status',
         ],
+        recoveryActions: [
+          'get_hyperliquid_user_state',
+          'withdraw_hyperliquid_to_arbitrum',
+        ],
+        decommissionExample:
+          'get_hyperliquid_user_state -> withdraw_hyperliquid_to_arbitrum -> withdraw-to-user on execution wallet',
         credentialType: 'hyperliquid_api_wallet',
         credentialUx:
           'Thirdfy manages Hyperliquid API-wallet setup for normal users. Delegated writes require encrypted privateKey-backed hyperliquid_api_wallet credentials; walletAddress-only records are rejected until Privy walletId-backed Hyperliquid signing ships.',
@@ -168,7 +174,17 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'browser_setup:create_or_derive_clob_credentials',
           'browser_setup:deploy_deposit_wallet_and_set_approvals',
         ],
-        statusActions: ['get_polymarket_setup_status'],
+        statusActions: [
+          'get_polymarket_funding_status',
+          'get_polymarket_setup_status',
+          'get_polymarket_recovery_status',
+        ],
+        recoveryActions: [
+          'get_polymarket_recovery_status',
+          'withdraw_polymarket_collateral',
+        ],
+        decommissionExample:
+          'get_polymarket_recovery_status -> withdraw_polymarket_collateral -> withdraw-to-user',
         credentialType: 'polymarket_clob',
         credentialUx:
           'Autonomous agents use an agent-owned Privy wallet and Polymarket deposit wallet first: Thirdfy creates the agent wallet, deploys/approves the deposit wallet, and stores encrypted CLOB credentials once Polymarket key creation is available. User-owned browser setup remains optional for interactive capital.',