@thirdfy/agent-cli 0.2.51 → 0.2.53

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [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
+
+- Yield.xyz `claim_earn_rewards` / `claim-earn-rewards` earn-family routing, 180s write timeout, and provider hints (`providerId=yield-xyz`; no amount; optional `passthrough` from `get_earn_position.claimableRewards`). Pairs with Thirdfy API **3.14.2** and `thirdfy-mcp` **0.0.100**.
+
 ## [0.2.51] - 2026-08-16
 
 ### Fixed

package/README.md

@@ -40,10 +40,9 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.51
+## What's new in v0.2.53
 
-- Morpho and Aave earn writes (`deposit_earn_position` / `withdraw_earn_position`) wait up to 180s instead of aborting at the 30s default.
-- Hyphen and snake action ids both use the long timeout.
+- Polymarket CLOB discovery includes `get_polymarket_balance_allowance` so agents can read collateral balance and allowance before placing orders.
 - 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.51",
+  "version": "0.2.53",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {

package/src/core/actionTimeouts.mjs

@@ -6,6 +6,7 @@ const LONG_RUNNING_ACTIONS = new Set([
   'register_lighter_api_key',
   'deposit_earn_position',
   'withdraw_earn_position',
+  'claim_earn_rewards',
 ]);
 
 function normalizeActionId(action) {

package/src/runtime/actions/selection.mjs

@@ -116,6 +116,7 @@ function inferActionProvider(action) {
     'get-earn-position': 'earn',
     'deposit-earn-position': 'earn',
     'withdraw-earn-position': 'earn',
+    'claim-earn-rewards': 'earn',
     'get-capyfi-markets': 'capyfi',
     'get-fx-supported-assets': 'fx',
     'quote-fx-swap': 'fx',
@@ -215,7 +216,11 @@ function isEarnCatalogAction(action) {
 
 function isGenericEarnWriteAction(action) {
   const actionKey = rowActionKey(action);
-  return actionKey === 'deposit_earn_position' || actionKey === 'withdraw_earn_position';
+  return (
+    actionKey === 'deposit_earn_position' ||
+    actionKey === 'withdraw_earn_position' ||
+    actionKey === 'claim_earn_rewards'
+  );
 }
 
 function isGenericEarnWriteForProvider(action, requestedProvider) {

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: [
@@ -366,9 +368,9 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'get-vaults-fyi-vaults',
           'get_yield_xyz_opportunities',
         ],
-        orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
+        orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position', 'claim_earn_rewards'],
         laneCompatibility:
-          'Generic earn writes use deposit_earn_position / withdraw_earn_position on normal Thirdfy policy/delegation rails; routing selects Morpho, Aave, Curve, Vaults.fyi, or Yield.xyz adapters per provider/opportunity.',
+          'Generic earn writes use deposit_earn_position / withdraw_earn_position on normal Thirdfy policy/delegation rails; Yield.xyz incentive claims use claim_earn_rewards (no amount; optional passthrough from get_earn_position.claimableRewards). Routing selects Morpho, Aave, Curve, Vaults.fyi, or Yield.xyz adapters per provider/opportunity.',
       };
     }
     if (provider === 'capyfi') {
@@ -522,9 +524,9 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         canonicalReadAction: 'get_yield_xyz_opportunities',
         canonicalWriteAction: 'deposit_earn_position',
         readActions: ['get_yield_xyz_opportunities', 'get_earning_opportunities', 'get_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
-        orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
+        orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position', 'claim_earn_rewards'],
         laneCompatibility:
-          '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.',
+          '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. claim_earn_rewards claims pending CLAIM_REWARDS incentives (no amount; pass optional passthrough from get_earn_position.claimableRewards). Balances omit metadata.name; use yields_get / get_earn_position enrich for display names.',
         example:
           '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],