@thirdfy/agent-cli 0.2.45 → 0.2.47

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.47] - 2026-08-08
+
+### Added
+
+- `gmgn` provider hints and `docs/providers/gmgn.md` for `get_gmgn_*` read-only smart-money actions (pairs with Thirdfy API `gmgn` provider / API 3.13.56).
+
+## [0.2.46] - 2026-08-08
+
+### Changed
+
+- Yield.xyz provider hints: require discovery (`get_yield_xyz_opportunities`) before deposit; document that Thirdfy prepareDeposit calls `GET /v1/yields/{yieldId}` before enter/exit. Example uses Base USDC + canonical yieldId. Pairs with Thirdfy API 3.13.55 + thirdfy-mcp 0.0.94.
+
 ## [0.2.45] - 2026-08-06
 
 ### Added

package/README.md

@@ -40,14 +40,10 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.45
+## What's new in v0.2.47
 
-- Polymarket official Bridge funding hints (`create_polymarket_bridge_deposit` / withdraw + status).
-- Classifier treats Bridge create actions as setup reads (parity with API and MCP).
-- `console-mandate` accepts `--chain-id` / `--network` for multi-chain Automations (Gnosis, Robinhood, Base).
-- Docs: Li.Fi remains legacy fallback for Polymarket collateral only.
-
-See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
+- GMGN smart-money reads: provider hints and `docs/providers/gmgn.md` for `get_gmgn_*` actions.
+- See [CHANGELOG.md](./CHANGELOG.md) for older versions.
 
 
 ## Quick start

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thirdfy/agent-cli",
-  "version": "0.2.45",
+  "version": "0.2.47",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {
@@ -22,7 +22,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --test \"test/**/*.test.cjs\"",
+    "test": "node --test test/*.test.cjs",
     "lint": "node --check ./bin/thirdfy-agent.mjs && node --check ./src/core/*.mjs && node --check ./src/commands/*.mjs && node --check ./src/cli/*.mjs && node --check ./src/cli/options/*.mjs && node --check ./src/runtime/*.mjs && node --check ./src/runtime/execution/*.mjs && node --check ./src/runtime/actions/*.mjs && node --check ./src/runtime/validation/*.mjs && node --check ./src/runtime/certification/*.mjs",
     "validate:cli-manifest-handlers": "node ./scripts/validate-cli-manifest-handlers.mjs",
     "validate:runtime-boundaries": "node ./scripts/validate-runtime-boundaries.mjs",

package/src/runtime/providerHints.mjs

@@ -494,9 +494,9 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         readActions: ['get_yield_xyz_opportunities', 'get_earning_opportunities', 'get_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
         orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
         laneCompatibility:
-          'Yield.xyz writes are transaction-prep first. Thirdfy calls Yield.xyz directly and validates returned unsigned transactions with @yieldxyz/shield before signing or returning prepared calls.',
+          'Yield.xyz writes are transaction-prep first. Always discover with get_yield_xyz_opportunities (or get_earning_opportunities) and pass the canonical opportunityId/yieldId. Thirdfy prepareDeposit calls GET /v1/yields/{yieldId} before enter/exit, then validates unsigned transactions with @yieldxyz/shield. Balances omit metadata.name; use yields_get / get_earn_position enrich for display names.',
         example:
-          'thirdfy-agent actions --provider yield-xyz && thirdfy-agent preflight --action deposit_earn_position --params \'{"providerId":"yield-xyz","opportunityId":"ethereum-eth-lido-staking","tokenAddress":"0x...","amount":"0.01","chainId":1}\'',
+          'thirdfy-agent run --action get_yield_xyz_opportunities --params \'{"chainId":8453,"asset":"USDC"}\' && thirdfy-agent preflight --action deposit_earn_position --params \'{"providerId":"yield-xyz","opportunityId":"<canonical-yieldId>","tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10","chainId":8453}\'',
         supportedChains: [1, 10, 100, 130, 137, 42220, 8453, 42161, 4663],
       };
     }
@@ -533,6 +533,35 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'thirdfy-agent condor policy-status && thirdfy-agent condor preflight --estimated-amount-usd 25 --idempotency-key <key>',
       };
     }
+    if (provider === 'gmgn') {
+      return {
+        provider,
+        category: 'smart_money_intel',
+        canonicalReadAction: 'get_gmgn_kol_trades',
+        readActions: [
+          'get_gmgn_token_info',
+          'get_gmgn_token_security',
+          'get_gmgn_token_pool',
+          'get_gmgn_token_holders',
+          'get_gmgn_token_traders',
+          'get_gmgn_token_kline',
+          'get_gmgn_trending',
+          'get_gmgn_trenches',
+          'get_gmgn_hot_searches',
+          'get_gmgn_wallet_activity',
+          'get_gmgn_wallet_stats',
+          'get_gmgn_wallet_token_balance',
+          'get_gmgn_created_tokens',
+          'get_gmgn_kol_trades',
+          'get_gmgn_smartmoney_trades',
+        ],
+        supportedChains: [],
+        laneCompatibility:
+          'GMGN uses string chain slugs (sol, base, bsc, eth, robinhood), not numeric chainId. Read-only KOL, smart-money, wallet, and token security evidence via Thirdfy API. Pace calls (~1 req/s).',
+        example:
+          'thirdfy-agent run --action get_gmgn_kol_trades --params \'{"chain":"sol","limit":5}\' --provider gmgn --json',
+      };
+    }
     if (provider === 'market-data') {
       return {
         provider,
@@ -582,6 +611,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       'vaults-fyi': 'get-vaults-fyi-vaults',
       'yield-xyz': 'get_yield_xyz_opportunities',
       'market-data': 'get_trending_tokens',
+      gmgn: 'get_gmgn_kol_trades',
       prediction: 'get_prediction_markets',
     };
     return {