@thirdfy/agent-cli 0.2.20 → 0.2.21

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [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,11 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.20
+## What's new in v0.2.21
 
-- **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).
+- **Console mandate:** `thirdfy-agent console-mandate status|draft|activate|revoke` for Console delegated execution with daily cap and expiry.
+- Uses the same `/api/v1/console/delegation/*` routes as Console and Account. Separate from certified-agent `delegation *` commands.
+- Pairs with Thirdfy API **v3.10.2+**. See [`docs/command-reference.md`](./docs/command-reference.md).
 
 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.21",
   "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/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,