@thirdfy/agent-cli 0.2.52 → 0.2.54

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.54] - 2026-08-28
+
+### Added
+
+- `nansen` provider hints and `docs/providers/nansen.md` for nine read-only `get_nansen_*` actions (HL/TGM reads + premium research agent). Pairs with Thirdfy API **3.14.14** and `thirdfy-mcp` **0.0.101**.
+
+## [0.2.53] - 2026-08-25
+
+### Added
+
+- Polymarket provider hints include `get_polymarket_balance_allowance` on CLOB reads and order management so agents can check collateral balance and allowance before placing orders. Pairs with Thirdfy API **3.14.7** and `thirdfy-mcp` **0.0.101**.
+
 ## [0.2.52] - 2026-08-18
 
 ### Added

package/README.md

@@ -40,10 +40,10 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.52
+## What's new in v0.2.54
 
-- Yield.xyz incentive claims use `claim_earn_rewards` (no amount; optional `passthrough` from `get_earn_position.claimableRewards`).
-- Claim writes wait up to 180s, same as earn deposit and withdraw.
+- Nansen provider hints for nine read-only `get_nansen_*` actions (Hyperliquid screener, TGM intel, address profiler, and premium research agent).
+- See [`docs/providers/nansen.md`](./docs/providers/nansen.md) for discovery examples and credit tiers.
 - See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
 
 

package/package.json

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

package/src/runtime/providerHints.mjs

@@ -248,6 +248,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'get_polymarket_order',
           'get_polymarket_user_orders',
           'get_polymarket_user_positions',
+          'get_polymarket_balance_allowance',
           'get_polymarket_bridge_supported_assets',
           'get_polymarket_bridge_status',
         ],
@@ -267,6 +268,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'get_polymarket_order',
           'get_polymarket_user_orders',
           'get_polymarket_user_positions',
+          'get_polymarket_balance_allowance',
           'cancel_polymarket_order',
         ],
         setupActions: [
@@ -592,6 +594,29 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'thirdfy-agent run --action get_gmgn_kol_trades --params \'{"chain":"sol","limit":5}\' --provider gmgn --json',
       };
     }
+    if (provider === 'nansen') {
+      return {
+        provider,
+        category: 'research_intel',
+        canonicalReadAction: 'get_nansen_perp_screener',
+        readActions: [
+          'get_nansen_perp_screener',
+          'get_nansen_position_intelligence',
+          'get_nansen_address_perp_positions',
+          'get_nansen_address_perp_trades',
+          'get_nansen_address_balances',
+          'get_nansen_address_pnl_summary',
+          'get_nansen_flow_intelligence',
+          'get_nansen_agent_fast',
+          'get_nansen_agent_expert',
+        ],
+        supportedChains: [],
+        laneCompatibility:
+          'Nansen HL/TGM reads and premium research agent via Thirdfy API. JSON body params for screener/profiler calls. Fast agent ~100 Thirdfy credits; expert ~375. Pace outbound starts (~1 req/s).',
+        example:
+          'thirdfy-agent run --action get_nansen_perp_screener --params \'{"date":{"from":"2026-08-27T00:00:00.000Z","to":"2026-08-28T00:00:00.000Z"},"pagination":{"page":1,"per_page":5}}\' --provider nansen --json',
+      };
+    }
     if (provider === 'market-data') {
       return {
         provider,
@@ -644,6 +669,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       'yield-xyz': 'get_yield_xyz_opportunities',
       'market-data': 'get_trending_tokens',
       gmgn: 'get_gmgn_kol_trades',
+      nansen: 'get_nansen_perp_screener',
       prediction: 'get_prediction_markets',
     };
     return {