@thirdfy/agent-cli 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +4 -4
  3. package/package.json +1 -1
  4. package/src/runtime/actions/selection.mjs +1 -0
  5. package/src/runtime/execution/lanes.mjs +2 -0
  6. package/src/runtime/providerHints.mjs +10 -2
package/CHANGELOG.md CHANGED
@@ -4,6 +4,19 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.2.7] - 2026-06-08
8
+
9
+ ### Added
10
+
11
+ - Hyperliquid `update_hyperliquid_leverage` action parity: listed in provider hints `orderManagementActions`, classified under the `hyperliquid` provider, and treated as an offchain venue write (rejects `self`/BYOW with `OFFCHAIN_VENUE_ORDER_SELF_UNSUPPORTED`; use `thirdfy`/`hybrid`/`agent_wallet`). Sets per-coin leverage (cross by default), bounded by the venue per-coin maxLeverage. Matches Thirdfy API v3.4.52+ and thirdfy-mcp v0.0.56+.
12
+
13
+ ## [0.2.6] - 2026-06-05
14
+
15
+ ### Changed
16
+
17
+ - 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).
18
+ - Hyperliquid command reference documents active-builder gate and when `approve_hyperliquid_builder_fee` is required.
19
+
7
20
  ## [0.2.5] - 2026-05-31
8
21
 
9
22
  ### Fixed
package/README.md CHANGED
@@ -40,11 +40,11 @@ Run without global install:
40
40
  npx @thirdfy/agent-cli --help
41
41
  ```
42
42
 
43
- ## What's new in v0.2.5
43
+ ## What's new in v0.2.7
44
44
 
45
- - Vaults.fyi provider hints now report `get-vaults-fyi-vaults` as the canonical read action.
46
- - The legacy underscore request `get_vaults_fyi_vaults` resolves to the hyphenated catalog action before ambiguous alias matching.
47
- - Public action inventory docs use the same hyphenated Vaults.fyi discovery action as Thirdfy API and MCP.
45
+ - Hyperliquid `update_hyperliquid_leverage` sets per-coin leverage (cross by default) before placing an order; bounded by the venue per-coin maxLeverage.
46
+ - The leverage update is an offchain venue write: run it with `--run-mode thirdfy`, `--run-mode hybrid`, or `--run-mode agent_wallet` (not `self`/BYOW).
47
+ - Provider hints list `update_hyperliquid_leverage` in Hyperliquid order management actions.
48
48
 
49
49
  Older versions: [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
50
50
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@thirdfy/agent-cli",
3
- "version": "0.2.5",
3
+ "version": "0.2.7",
4
4
  "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
5
5
  "type": "module",
6
6
  "bin": {
package/src/runtime/actions/selection.mjs CHANGED
@@ -87,6 +87,7 @@ function inferActionProvider(action) {
87
87
  'deposit-hyperliquid-bridge': 'hyperliquid',
88
88
  'place-hyperliquid-perps-order': 'hyperliquid',
89
89
  'cancel-hyperliquid-perps-order': 'hyperliquid',
90
+ 'update-hyperliquid-leverage': 'hyperliquid',
90
91
  'get-perps-markets': 'hyperliquid',
91
92
  'get-perps-account': 'hyperliquid',
92
93
  'get-perps-position': 'hyperliquid',
package/src/runtime/execution/lanes.mjs CHANGED
@@ -5,6 +5,8 @@ const OFFCHAIN_VENUE_ORDER_ACTIONS = new Set([
5
5
  'place-hyperliquid-perps-order',
6
6
  'cancel_hyperliquid_perps_order',
7
7
  'cancel-hyperliquid-perps-order',
8
+ 'update_hyperliquid_leverage',
9
+ 'update-hyperliquid-leverage',
8
10
  'place_polymarket_order',
9
11
  'place-polymarket-order',
10
12
  ]);
package/src/runtime/providerHints.mjs CHANGED
@@ -38,6 +38,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
38
38
  orderManagementActions: [
39
39
  'place_hyperliquid_perps_order',
40
40
  'cancel_hyperliquid_perps_order',
41
+ 'update_hyperliquid_leverage',
41
42
  'get_hyperliquid_open_orders',
42
43
  ],
43
44
  setupActions: [
@@ -45,6 +46,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
45
46
  'get_hyperliquid_setup_status',
46
47
  'get_hyperliquid_onboarding_plan',
47
48
  'prepare_hyperliquid_onboarding',
49
+ 'complete_hyperliquid_onboarding',
48
50
  'get_bridge_quote',
49
51
  'execute_bridge',
50
52
  'approve_hyperliquid_agent',
@@ -87,13 +89,19 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
87
89
  'HYPERLIQUID_CREDITS_REQUIRED',
88
90
  'HYPERLIQUID_API_WALLET_SIGNER_REQUIRED',
89
91
  ],
92
+ setupWarnings: [
93
+ 'HYPERLIQUID_BUILDER_WALLET_UNFUNDED',
94
+ 'HYPERLIQUID_API_WALLET_NOT_PROVIDED',
95
+ ],
90
96
  sourceBridgeProvider: 'lifi',
91
97
  funding:
92
98
  '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.',
93
99
  laneCompatibility:
94
- 'Use self only for setup signatures or Arbitrum funding transactions. Perps orders should use thirdfy, hybrid, or agent_wallet.',
100
+ '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.',
95
101
  setupExample:
96
- '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',
102
+ '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',
103
+ monetization:
104
+ '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.',
97
105
  example:
98
106
  '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"}\'',
99
107
  };