@thirdfy/agent-cli 0.1.34 → 0.1.36

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.1.36] - 2026-05-16
+
+### Added
+
+- Hyperliquid perps cancel and expanded Bitfinex/Hyperliquid discovery hints in `thirdfy-agent actions`, plus preflight routing tests aligned with the Thirdfy action catalog.
+
+## [0.1.35] - 2026-05-14
+
+### Added
+
+- Polymarket Gamma discovery hints in `thirdfy-agent actions` (`gamma_search_tags`, `gamma_search_events`, `gamma_search_markets`, and related prediction reads) aligned with the Thirdfy AgentKit catalog.
+
+### Changed
+
+- Public docs: provider index, action inventory, and command reference describe Gamma-backed Polymarket discovery and the production deposit-wallet (pUSD / POLY_1271) flow alongside existing trading and earn coverage.
+
 ## [0.1.34] - 2026-05-14
 
 ### Changed

package/README.md

@@ -40,7 +40,7 @@ npx @thirdfy/agent-cli --help
 
 ## Release notes
 
-Version history and highlights: [CHANGELOG.md](./CHANGELOG.md). Highlights through **v0.1.31** include 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.35** extends `thirdfy-agent actions` hints for Polymarket Gamma-style discovery (`gamma_search_*` where catalog-backed) and legacy `search_polymarket` / `get_polymarket_*` reads, with public docs aligned to the deposit-wallet (pUSD / POLY_1271) operator path. 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.
 
@@ -406,7 +406,7 @@ npm run e2e:managed:delegation:parity
 
 ## Release
 
-Version history and user-facing notes: [CHANGELOG.md](./CHANGELOG.md) (for example [v0.1.24](https://github.com/thirdfy/agent-cli/releases/tag/v0.1.24) — npm README and discovery docs aligned with MCP).
+Version history and user-facing notes: [CHANGELOG.md](./CHANGELOG.md) (for example [v0.1.35](https://github.com/thirdfy/agent-cli/releases/tag/v0.1.35) — Polymarket Gamma discovery hints and public docs; keep npm README, `CHANGELOG.md`, and MCP provider summaries in sync when discovery surfaces change).
 
 ```bash
 npm version patch

package/bin/thirdfy-agent.mjs

@@ -434,6 +434,7 @@ function getTradingProviderHint(providerId) {
       ],
       orderManagementActions: [
         'place_hyperliquid_perps_order',
+        'cancel_hyperliquid_perps_order',
         'get_hyperliquid_open_orders',
       ],
       setupActions: [
@@ -482,12 +483,48 @@ function getTradingProviderHint(providerId) {
         '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"}\'',
     };
   }
+  if (provider === 'bitfinex') {
+    return {
+      provider,
+      category: 'cex_funding',
+      canonicalReadAction: 'get_bitfinex_funding_ticker',
+      canonicalWriteAction: 'submit_bitfinex_funding_offer',
+      readActions: [
+        'get_bitfinex_funding_ticker',
+        'get_bitfinex_funding_stats_hist',
+        'get_bitfinex_funding_book',
+        'get_bitfinex_funding_info',
+        'get_bitfinex_wallets',
+        'list_bitfinex_funding_offers',
+        'list_bitfinex_funding_credits',
+      ],
+      orderManagementActions: [
+        'submit_bitfinex_funding_offer',
+        'cancel_bitfinex_funding_offer',
+        'submit_bitfinex_order',
+        'update_bitfinex_order',
+        'cancel_bitfinex_order',
+      ],
+      credentialType: 'bitfinex_api_key',
+      credentialRef: 'bitfinex:funding-primary',
+      credentialUx:
+        'Save and verify Bitfinex funding credentials in EarnClaw/Thirdfy first. MCP/CLI order intents reference credentialRef only; raw keys are never sent through agentRun.',
+      laneCompatibility:
+        'Bitfinex CEX writes require thirdfy, hybrid, or agent_wallet so Thirdfy can inject stored credentials and run policy/preflight. Reads and setup discovery can be listed without raw credentials.',
+      example:
+        'thirdfy-agent actions --provider bitfinex && thirdfy-agent run --run-mode thirdfy --action submit_bitfinex_funding_offer --params \'{"symbol":"fUSD","amount":"100","rate":"0.0002","period":2,"credentialRef":"bitfinex:funding-primary"}\'',
+    };
+  }
   if (provider === 'polymarket') {
     return {
       provider,
       category: 'prediction_market',
       canonicalWriteAction: 'place_polymarket_order',
       readActions: [
+        'get_polymarket_tags',
+        'search_polymarket',
+        'get_polymarket_events',
+        'get_polymarket_event',
         'get_polymarket_markets',
         'get_polymarket_market',
         'get_polymarket_order_book',
@@ -497,6 +534,14 @@ function getTradingProviderHint(providerId) {
         'get_polymarket_order',
         'get_polymarket_user_orders',
       ],
+      discoveryFlow: [
+        'get_polymarket_tags or search_polymarket',
+        'get_polymarket_events active=true closed=false',
+        'get_polymarket_market or get_polymarket_markets',
+        'get_polymarket_order_book',
+        'get_polymarket_prices or get_polymarket_price_history',
+        'get_polymarket_setup_status before place_polymarket_order',
+      ],
       orderManagementActions: [
         'place_polymarket_order',
         'get_polymarket_order',
@@ -505,27 +550,27 @@ function getTradingProviderHint(providerId) {
       ],
       setupActions: [
         'get_polymarket_setup_status',
-        'agent_wallet_setup:ensure_agent_wallet_safe',
-        'agent_wallet_setup:deploy_safe_and_set_approvals',
+        'agent_wallet_setup:ensure_agent_wallet_deposit_wallet',
+        'agent_wallet_setup:deploy_deposit_wallet_and_set_approvals',
         'agent_wallet_setup:create_or_derive_clob_credentials',
         'browser_setup:add_privy_signer',
         'browser_setup:create_or_derive_clob_credentials',
-        'browser_setup:deploy_safe_and_set_approvals',
+        'browser_setup:deploy_deposit_wallet_and_set_approvals',
       ],
       statusActions: ['get_polymarket_setup_status'],
       credentialType: 'polymarket_clob',
       credentialUx:
-        'Autonomous agents use an agent-owned Privy wallet/Safe first: Thirdfy creates the agent wallet, deploys/approves the Safe, and stores encrypted CLOB credentials once Polymarket key creation is available. User-owned browser setup remains optional for interactive capital.',
+        '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.',
       funding:
-        'Fund the agent-owned Polymarket Safe with Polygon USDC/pUSD collateral after Safe deployment and approvals.',
+        'Fund the agent-owned Polymarket deposit wallet with Polygon pUSD after deployment and approvals. If users start with Base USDC, route Base USDC -> Polygon pUSD to the deposit wallet recipient before CLOB order placement.',
       laneCompatibility:
         'Use agent_wallet as the preferred autonomous-agent path. Use self only for user-owned setup/funding signatures. CLOB orders should use thirdfy, hybrid, or agent_wallet after polymarket_clob credentials are stored.',
       setupBlockers: [
-        'POLYMARKET_AGENT_WALLET_SAFE_REQUIRED',
+        'POLYMARKET_DEPOSIT_WALLET_REQUIRED',
         'POLYMARKET_CLOB_CREDENTIALS_REQUIRED',
-        'POLYMARKET_SAFE_DEPLOYMENT_REQUIRED',
-        'POLYMARKET_SAFE_APPROVALS_REQUIRED',
-        'POLYMARKET_USDC_REQUIRED',
+        'POLYMARKET_DEPOSIT_WALLET_DEPLOY_REQUIRED',
+        'POLYMARKET_DEPOSIT_WALLET_APPROVALS_REQUIRED',
+        'POLYMARKET_DEPOSIT_WALLET_PUSD_REQUIRED',
         'POLYMARKET_CREDITS_REQUIRED',
         'POLYMARKET_RELAYER_UNAVAILABLE',
         'POLYMARKET_CLOB_KEY_CREATION_BLOCKED_UNTIL_POLYMARKET_FIX',
@@ -539,7 +584,14 @@ function getTradingProviderHint(providerId) {
       provider,
       category: 'prediction',
       canonicalWriteAction: 'place_prediction_order',
-      readActions: ['get_prediction_markets', 'get_prediction_market', 'get_prediction_order_book'],
+      readActions: [
+        'get_prediction_tags',
+        'search_prediction_markets',
+        'get_prediction_events',
+        'get_prediction_markets',
+        'get_prediction_market',
+        'get_prediction_order_book',
+      ],
       orderManagementActions: ['place_prediction_order', 'cancel_prediction_order'],
       compatibilityProvider: 'polymarket',
     };
@@ -682,6 +734,8 @@ function formatProviderUnknownActionHint(providerHint) {
 const OFFCHAIN_VENUE_ORDER_ACTIONS = new Set([
   'place_hyperliquid_perps_order',
   'place-hyperliquid-perps-order',
+  'cancel_hyperliquid_perps_order',
+  'cancel-hyperliquid-perps-order',
   'place_polymarket_order',
   'place-polymarket-order',
 ]);
@@ -3497,6 +3551,7 @@ function inferActionProvider(action) {
     'deposit-hyperliquid-staking': 'hyperliquid',
     'deposit-hyperliquid-bridge': 'hyperliquid',
     'place-hyperliquid-perps-order': 'hyperliquid',
+    'cancel-hyperliquid-perps-order': 'hyperliquid',
     'get-perps-markets': 'hyperliquid',
     'get-perps-account': 'hyperliquid',
     'get-perps-position': 'hyperliquid',
@@ -3519,18 +3574,31 @@ function inferActionProvider(action) {
     'get-yield-xyz-opportunities': 'yield-xyz',
     'get-prediction-markets': 'polymarket',
     'get-prediction-market': 'polymarket',
+    'get-prediction-events': 'polymarket',
+    'get-prediction-tags': 'polymarket',
+    'search-prediction-markets': 'polymarket',
     'get-prediction-order-book': 'polymarket',
     'get-prediction-position': 'polymarket',
     'place-prediction-order': 'polymarket',
     'cancel-prediction-order': 'polymarket',
     'get-polymarket-markets': 'polymarket',
     'get-polymarket-market': 'polymarket',
+    'get-polymarket-events': 'polymarket',
+    'get-polymarket-event': 'polymarket',
+    'get-polymarket-tags': 'polymarket',
+    'search-polymarket': 'polymarket',
+    'get-polymarket-order-book': 'polymarket',
+    'get-polymarket-prices': 'polymarket',
     'get-polymarket-setup-status': 'polymarket',
     'get-polymarket-order': 'polymarket',
+    'get-polymarket-user-orders': 'polymarket',
+    'cancel-polymarket-order': 'polymarket',
+    'get-polymarket-price-history': 'polymarket',
     'place-polymarket-order': 'polymarket',
   };
   if (knownMap[key]) return knownMap[key];
   if (key.includes('hyperliquid')) return 'hyperliquid';
+  if (key.includes('bitfinex')) return 'bitfinex';
   if (key.includes('polymarket') || key.includes('prediction')) return 'polymarket';
   if (key.includes('vaults-fyi')) return 'vaults-fyi';
   if (key.includes('yield-xyz')) return 'yield-xyz';

package/package.json

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