@thirdfy/agent-cli 0.2.20 → 0.2.22

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.22] - 2026-07-10
+
+### Added
+
+- Robinhood Chain (4663) provider hints for trading, bridge, yield-xyz, and market-data; `robinhood-mainnet` chat alias; live capabilities validation for 4663.
+
+### Fixed
+
+- Capabilities-derived hints no longer set a write action for read-only `market-data`.
+- Live API validation also asserts `yield-xyz` includes chain 4663.
+
+## [0.2.21] - 2026-07-05
+
+### Added
+
+- `console-mandate` command group: `status`, `draft`, `activate`, `revoke` for Console delegated execution (daily cap + expiry). Uses `/api/v1/console/delegation/*` and is separate from certified-agent `delegation *` commands. Pairs with Thirdfy API **v3.10.2+**.
+
 ## [0.2.20] - 2026-07-04
 
 ### Added

package/README.md

@@ -40,11 +40,12 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.20
+## What's new in v0.2.22
 
-- **Console Brain:** `thirdfy-agent brain sections|suggest|preflight|graduate` read ranked Trading, Yield, and Prediction lanes from Thirdfy API (no local ranking).
-- Brain commands support `--strategy`, `--section`, `--capital-usd`, `--risk`, and `--target earnclaw` for read/preflight-first strategy workflows.
-- Pairs with Thirdfy API **v3.10.0** Brain routes (`GET /api/v1/console/brain-*`). See [`docs/command-reference.md`](./docs/command-reference.md).
+- **Robinhood Chain (4663):** Provider hints for `trading`, `bridge`, `yield-xyz`, and `market-data`; `robinhood-mainnet` chat alias.
+- Live capabilities validation asserts chain 4663 when `THIRDFY_API_BASE` is set. Pairs with Thirdfy API **v3.10.7+**.
+
+Older versions: see [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
 
 Older versions: see [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
 

package/package.json

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

package/src/cli/manifest.mjs

@@ -377,6 +377,34 @@ export const CLI_MANIFEST = [
     options: ['auth', 'execution'],
     description: 'Redeem via delegation',
   },
+  {
+    path: ['console-mandate', 'status'],
+    handler: 'commandConsoleMandateStatus',
+    tier: 'online',
+    options: ['auth', 'delegation'],
+    description: 'Console delegated execution status',
+  },
+  {
+    path: ['console-mandate', 'draft'],
+    handler: 'commandConsoleMandateDraft',
+    tier: 'online',
+    options: ['auth', 'delegation'],
+    description: 'Create Console mandate draft',
+  },
+  {
+    path: ['console-mandate', 'activate'],
+    handler: 'commandConsoleMandateActivate',
+    tier: 'online',
+    options: ['auth', 'delegation'],
+    description: 'Activate signed Console mandate',
+  },
+  {
+    path: ['console-mandate', 'revoke'],
+    handler: 'commandConsoleMandateRevoke',
+    tier: 'online',
+    options: ['auth', 'delegation'],
+    description: 'Revoke Console mandate',
+  },
   {
     path: ['credentials', 'upsert'],
     handler: 'commandCredentialsUpsert',

package/src/commands/chat.mjs

@@ -5,6 +5,7 @@ import { apiGet, safeJsonParse } from '../core/http.mjs';
 const NETWORK_CHAIN_IDS = {
   'base-mainnet': 8453,
   'base-sepolia': 84532,
+  'robinhood-mainnet': 4663,
 };
 
 const DEFAULT_CHAT_CHAIN_ID = 8453;

package/src/commands/consoleMandate.mjs

@@ -0,0 +1,125 @@
+import { requireFlag } from '../core/args.mjs';
+import { apiGet, apiPost } from '../core/http.mjs';
+
+export function createConsoleMandateCommands(deps) {
+  const { buildOwnerAuthHeaders, printEnvelope } = deps;
+
+  async function commandConsoleMandateStatus(ctx, flags) {
+    const authHeaders = buildOwnerAuthHeaders(
+      flags,
+      'Missing --auth-token/--owner-session-token for console mandate status',
+    );
+    const chainId = Number(flags.chainId || 8453);
+    const walletAddress = String(flags.walletAddress || flags.ownerAddress || '').trim();
+    const query = new URLSearchParams({ chainId: String(chainId) });
+    if (walletAddress) query.set('walletAddress', walletAddress);
+    const response = await apiGet(ctx, `/api/v1/console/delegation/status?${query.toString()}`, {
+      ...authHeaders,
+      headers: {
+        ...(authHeaders.headers || {}),
+        'x-thirdfy-surface': 'cli',
+      },
+    });
+    printEnvelope({
+      success: Boolean(response?.success !== false),
+      code: 'CONSOLE_MANDATE_STATUS',
+      message: 'Console delegated execution status',
+      data: response?.data || response,
+      meta: { apiBase: ctx.apiBase },
+    });
+  }
+
+  async function commandConsoleMandateDraft(ctx, flags) {
+    const authHeaders = buildOwnerAuthHeaders(
+      flags,
+      'Missing --auth-token/--owner-session-token for console mandate draft',
+    );
+    const payload = {
+      ownerAddress: requireFlag(flags, 'ownerAddress', 'Missing --owner-address'),
+      chainId: Number(flags.chainId || 8453),
+      maxUsdPerDay: Number(requireFlag(flags, 'maxUsdPerDay', 'Missing --max-usd-per-day')),
+      expirySeconds: Number(flags.expirySeconds || 30 * 24 * 60 * 60),
+      tokenAddress: flags.tokenAddress,
+      periodDuration: Number(flags.periodDuration || 86_400),
+    };
+    const response = await apiPost(ctx, '/api/v1/console/delegation/draft', payload, {
+      ...authHeaders,
+      headers: {
+        ...(authHeaders.headers || {}),
+        'x-thirdfy-surface': 'cli',
+      },
+    });
+    printEnvelope({
+      success: Boolean(response?.success !== false),
+      code: 'CONSOLE_MANDATE_DRAFT',
+      message: 'Console mandate draft created',
+      data: response?.data || response,
+      meta: { apiBase: ctx.apiBase },
+    });
+  }
+
+  async function commandConsoleMandateActivate(ctx, flags) {
+    const authHeaders = buildOwnerAuthHeaders(
+      flags,
+      'Missing --auth-token/--owner-session-token for console mandate activate',
+    );
+    const payload = {
+      walletAddress: requireFlag(flags, 'walletAddress', 'Missing --wallet-address'),
+      chainId: Number(flags.chainId || 8453),
+      delegationManager: requireFlag(flags, 'delegationManager', 'Missing --delegation-manager'),
+      delegation: JSON.parse(requireFlag(flags, 'delegation', 'Missing --delegation JSON')),
+      signature: requireFlag(flags, 'signature', 'Missing --signature'),
+      permissionsExpiry: flags.permissionsExpiry,
+      maxUsdPerDay: Number(requireFlag(flags, 'maxUsdPerDay', 'Missing --max-usd-per-day')),
+      periodDuration: Number(flags.periodDuration || 86_400),
+      tokenAddress: flags.tokenAddress,
+    };
+    const response = await apiPost(ctx, '/api/v1/console/delegation/activate', payload, {
+      ...authHeaders,
+      headers: {
+        ...(authHeaders.headers || {}),
+        'x-thirdfy-surface': 'cli',
+      },
+    });
+    printEnvelope({
+      success: Boolean(response?.success !== false),
+      code: 'CONSOLE_MANDATE_ACTIVATED',
+      message: 'Console mandate activated',
+      data: response?.data || response,
+      meta: { apiBase: ctx.apiBase },
+    });
+  }
+
+  async function commandConsoleMandateRevoke(ctx, flags) {
+    const authHeaders = buildOwnerAuthHeaders(
+      flags,
+      'Missing --auth-token/--owner-session-token for console mandate revoke',
+    );
+    const payload = {
+      walletAddress: flags.walletAddress,
+      chainId: Number(flags.chainId || 8453),
+      reason: flags.reason || 'cli_revoked',
+    };
+    const response = await apiPost(ctx, '/api/v1/console/delegation/revoke', payload, {
+      ...authHeaders,
+      headers: {
+        ...(authHeaders.headers || {}),
+        'x-thirdfy-surface': 'cli',
+      },
+    });
+    printEnvelope({
+      success: Boolean(response?.success !== false),
+      code: 'CONSOLE_MANDATE_REVOKED',
+      message: 'Console mandate revoked',
+      data: response?.data || response,
+      meta: { apiBase: ctx.apiBase },
+    });
+  }
+
+  return {
+    commandConsoleMandateStatus,
+    commandConsoleMandateDraft,
+    commandConsoleMandateActivate,
+    commandConsoleMandateRevoke,
+  };
+}

package/src/runtime/handlers.mjs

@@ -6,6 +6,7 @@ import { createLighterHelpers } from '../commands/lighter.mjs';
 import { createExecuteCommands } from '../commands/execute.mjs';
 import { createWalletCommands } from '../commands/wallet.mjs';
 import { createDelegationCommands } from '../commands/delegation.mjs';
+import { createConsoleMandateCommands } from '../commands/consoleMandate.mjs';
 import { createBootstrapCommands } from '../commands/bootstrap.mjs';
 import { createDiscoveryCommands } from '../commands/discovery.mjs';
 import { createCreditsCommands } from '../commands/credits.mjs';
@@ -156,6 +157,11 @@ export function createRuntimeHandlers(deps) {
     commandRun: __execute.commandRun,
   });
 
+  const __consoleMandate = createConsoleMandateCommands({
+    buildOwnerAuthHeaders,
+    printEnvelope,
+  });
+
   const __polymarket = createPolymarketCommands({
     commandPreflight: __execute.commandPreflight,
     printEnvelope,
@@ -184,6 +190,7 @@ export function createRuntimeHandlers(deps) {
     ...__execute,
     ...__wallet,
     ...__delegation,
+    ...__consoleMandate,
     ...__polymarket,
     ...__hummingbot,
     ...__bootstrap,

package/src/runtime/providerHints.mjs

@@ -11,9 +11,9 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         provider,
         category: 'onchain_spot',
         canonicalWriteAction: 'swap',
-        supportedChains: [1, 10, 130, 137, 8453, 84532, 42161],
+        supportedChains: [1, 10, 130, 137, 8453, 84532, 42161, 4663],
         laneCompatibility:
-          'Kyber quote/build is live on Ethereum, Optimism, Unichain, Polygon, Base, and Arbitrum; sponsored Kyber execution is validated on Base only. Gnosis FX uses the fx provider via CoW.',
+          'Kyber quote/build is live on Ethereum, Optimism, Unichain, Polygon, Base, and Arbitrum; sponsored Kyber execution is validated on Base only. Robinhood Chain (4663) uses Li.Fi Intents for spot swaps with user-pays gas. Gnosis FX uses the fx provider via CoW.',
         credentialUx: 'Use normal Thirdfy login/delegation; do not use this provider for Hyperliquid, Lighter, or Polymarket.',
       };
     }
@@ -329,7 +329,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         canonicalWriteAction: 'execute_bridge',
         readActions: ['get_bridge_quote', 'get_supported_bridge_chains', 'check_bridge_status'],
         orderManagementActions: ['execute_bridge'],
-        supportedChains: [1, 8453, 42161, 10, 137, 56, 43114, 250, 100, 1284, 1285, 25, 288, 1088, 42220, 122, 324, 59144, 534352, 5000, 81457, 169],
+        supportedChains: [1, 8453, 42161, 10, 137, 56, 43114, 250, 100, 1284, 1285, 25, 288, 1088, 42220, 122, 324, 59144, 534352, 5000, 81457, 169, 4663],
         laneCompatibility: 'Li.Fi bridge supports mainnet value movement only; testnets are not auto-mapped to mainnet.',
       };
     }
@@ -455,6 +455,22 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           '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.',
         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}\'',
+        supportedChains: [1, 10, 100, 130, 137, 42220, 8453, 42161, 4663],
+      };
+    }
+    if (provider === 'market-data') {
+      return {
+        provider,
+        category: 'market_data',
+        canonicalReadAction: 'get_trending_tokens',
+        readActions: [
+          'get_trending_tokens',
+          'get_new_token_launches',
+          'get_token_market_data',
+          'get_chain_market_overview',
+        ],
+        supportedChains: [8453, 84532, 4663],
+        laneCompatibility: 'Read-only market data via API-owned actions. Robinhood Chain uses CoinGecko Onchain network id robinhood.',
       };
     }
     return null;
@@ -488,6 +504,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       curve: 'get_curve_pools',
       'vaults-fyi': 'get-vaults-fyi-vaults',
       'yield-xyz': 'get_yield_xyz_opportunities',
+      'market-data': 'get_trending_tokens',
       prediction: 'get_prediction_markets',
     };
     return {