@thirdfy/agent-cli 0.2.16 → 0.2.18

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.18] - 2026-07-02
+
+### Changed
+
+- `credits balance`, `credits models list`, and `credits models estimate` human-readable summaries lead with USD when the API returns `availableUsd`, `estimatedUsdPerTurn`, or `chargedUsd` (Thirdfy API **v3.9.5+** USD credits Phase 1). JSON output unchanged. Pairs with `thirdfy-mcp` **v0.0.67+**.
+
+## [0.2.17] - 2026-07-02
+
+### Changed
+
+- Lighter onboarding writes (`complete_lighter_onboarding`, `setup_lighter_api_key`, `register_lighter_api_key`) use a 180s HTTP timeout by default (`THIRDFY_CLI_LONG_TIMEOUT_MS` or `THIRDFY_API_LONG_TIMEOUT_MS`) so managed `run` / `wallet execute` does not abort before the API finishes CCTP or Ethereum legs. Long-action timeout never falls below the configured base timeout. Pairs with Thirdfy API Ireland `sendTx` egress and `thirdfy-mcp` **v0.0.66+**.
+
 ## [0.2.16] - 2026-06-30
 
 ### Added

package/README.md

@@ -40,9 +40,9 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.16
+## What's new in v0.2.18
 
-- `credits` commands for balance, transactions (optional billing metadata), usage summary, model pricing, turn estimate, and action quote. Pairs with Thirdfy API **v3.8.2+** and `thirdfy-mcp` **v0.0.65+**.
+- Credits commands show USD-first summaries when the API returns Phase 1 display fields: balance (`availableUsd`), model list (`estimatedUsdPerTurn`), and estimates (`chargedUsd`). Use `--json` for the full API payload. Pairs with Thirdfy API **v3.9.5+** and `thirdfy-mcp` **v0.0.67+**.
 
 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.16",
+  "version": "0.2.18",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {
@@ -11,6 +11,7 @@
     "src/core/",
     "src/commands/",
     "src/cli/",
+    "src/lib/",
     "src/runtime/",
     "src/utils/cli/",
     "src/contracts/cli/schemas/",

package/src/commands/credits.mjs

@@ -1,5 +1,9 @@
 import { requireFlag } from '../core/args.mjs';
 import { apiGet, apiPost } from '../core/http.mjs';
+import {
+  formatCreditsEstimateSummary,
+  formatCreditsModelsSummary,
+} from '../lib/creditsUsdSummary.mjs';
 
 function resolveToolCallsEstimate(flags) {
   const raw = flags.toolCalls ?? flags.toolCallsList;
@@ -67,12 +71,13 @@ export function createCreditsCommands({ printEnvelope, getAuthToken }) {
     const response = await apiGet(ctx, '/api/v1/credits/pricing/models', {
       Authorization: `Bearer ${authToken}`,
     });
+    const summary = formatCreditsModelsSummary(response);
     printEnvelope({
       success: true,
       code: 'OK',
-      message: 'Model pricing loaded',
+      message: flags.json ? 'Model pricing loaded' : `Model pricing loaded: ${summary}`,
       data: response,
-      meta: { apiBase: ctx.apiBase },
+      meta: { apiBase: ctx.apiBase, ...(flags.json ? {} : { summary }) },
     });
   }
 
@@ -94,12 +99,14 @@ export function createCreditsCommands({ printEnvelope, getAuthToken }) {
       },
       { Authorization: `Bearer ${authToken}` },
     );
+    const estimate = response?.estimate;
+    const summary = formatCreditsEstimateSummary(estimate);
     printEnvelope({
       success: true,
       code: 'OK',
-      message: 'Model estimate generated',
+      message: flags.json ? 'Model estimate generated' : `Model estimate for ${modelKey}: ${summary}`,
       data: response,
-      meta: { apiBase: ctx.apiBase, modelKey },
+      meta: { apiBase: ctx.apiBase, modelKey, ...(flags.json ? {} : { summary }) },
     });
   }
 

package/src/commands/discovery.mjs

@@ -2,6 +2,7 @@ import { requireFlag, parseJsonFlag } from '../core/args.mjs';
 import { apiGet, apiPost } from '../core/http.mjs';
 import { extractActions, getCachedActionsCatalog } from '../core/context.mjs';
 import { getEffectiveRunMode } from '../core/runMode.mjs';
+import { formatCreditsBalanceSummary } from '../lib/creditsUsdSummary.mjs';
 export function createDiscoveryCommands({ printEnvelope, applyActionFilters, getTradingProviderHint, resolveChainSupport, getAuthToken, resolveAgentApiKey }) {
 async function commandCatalogsList(ctx, flags, capabilities) {
   const response = await apiGet(ctx, '/api/v1/agent/actions/catalog');
@@ -57,14 +58,16 @@ async function commandCreditsBalance(ctx, flags, capabilities) {
   const response = await apiGet(ctx, '/api/v1/credits/balance', {
     Authorization: `Bearer ${authToken}`,
   });
+  const summary = formatCreditsBalanceSummary(response);
   printEnvelope({
     success: true,
     code: 'OK',
-    message: 'Credits balance loaded',
+    message: flags.json ? 'Credits balance loaded' : `Credits balance loaded: ${summary}`,
     data: response,
     meta: {
       apiBase: ctx.apiBase,
       capabilitiesVersion: capabilities?.contractVersion || null,
+      ...(flags.json ? {} : { summary }),
     },
   });
 }

package/src/core/actionTimeouts.mjs

@@ -0,0 +1,29 @@
+import { DEFAULT_TIMEOUT_MS } from './constants.mjs';
+
+const LONG_RUNNING_ACTIONS = new Set([
+  'complete_lighter_onboarding',
+  'setup_lighter_api_key',
+  'register_lighter_api_key',
+]);
+
+function normalizeActionId(action) {
+  return String(action || '')
+    .trim()
+    .replace(/-/g, '_')
+    .toLowerCase();
+}
+
+/** Longer HTTP timeout for Lighter onboarding writes that poll CCTP credit or Ethereum changePubKey. */
+export function resolveActionTimeoutMs(action, baseTimeoutMs = DEFAULT_TIMEOUT_MS) {
+  const base = Number.isFinite(baseTimeoutMs) && baseTimeoutMs > 0 ? baseTimeoutMs : DEFAULT_TIMEOUT_MS;
+  if (!LONG_RUNNING_ACTIONS.has(normalizeActionId(action))) return base;
+  const longMs = Number(
+    process.env.THIRDFY_CLI_LONG_TIMEOUT_MS || process.env.THIRDFY_API_LONG_TIMEOUT_MS || 180_000,
+  );
+  const resolvedLong = Number.isFinite(longMs) && longMs > 0 ? longMs : 180_000;
+  return Math.max(base, resolvedLong);
+}
+
+export function withActionTimeout(ctx, action) {
+  return { ...ctx, timeoutMs: resolveActionTimeoutMs(action, ctx.timeoutMs) };
+}

package/src/lib/creditsUsdSummary.mjs

@@ -0,0 +1,21 @@
+export function formatCreditsBalanceSummary(response) {
+  if (typeof response?.availableUsd === 'number') {
+    return `$${response.availableUsd.toFixed(2)} available (${response.balance ?? 0} credits)`;
+  }
+  return `${response?.balance ?? 0} credits`;
+}
+
+export function formatCreditsModelsSummary(response) {
+  const firstModel = response?.models?.[0];
+  if (firstModel?.estimatedUsdPerTurn != null) {
+    return `${response?.models?.length ?? 0} models · e.g. ${firstModel.modelKey} ~$${Number(firstModel.estimatedUsdPerTurn).toFixed(2)}/turn`;
+  }
+  return `${response?.models?.length ?? 0} models loaded`;
+}
+
+export function formatCreditsEstimateSummary(estimate) {
+  if (estimate?.chargedUsd != null) {
+    return `~$${Number(estimate.chargedUsd).toFixed(2)} charged (${estimate.chargedCredits ?? estimate.totalCredits} credits)`;
+  }
+  return `${estimate?.chargedCredits ?? estimate?.totalCredits ?? '?'} credits`;
+}

package/src/runtime/execution/runners.mjs

@@ -10,6 +10,7 @@ import {
   parseBooleanFlag,
 } from '../../core/runMode.mjs';
 import { apiGet, apiPost } from '../../core/http.mjs';
+import { withActionTimeout } from '../../core/actionTimeouts.mjs';
 import { createRequire } from 'module';
 
 const require = createRequire(import.meta.url);
@@ -269,6 +270,7 @@ async function runExecutionByMode(runMode, ctx, flags, resolved, options) {
 
 async function executeThirdfyRun(ctx, flags, resolved, options, runMode = 'thirdfy') {
   const skipPreflight = Boolean(options?.skipPreflight);
+  const actionCtx = withActionTimeout(ctx, resolved.resolvedAction);
   if (!skipPreflight) {
     const preflightPayload = buildIntentPayload(flags, {
       validationOnly: true,
@@ -278,7 +280,7 @@ async function executeThirdfyRun(ctx, flags, resolved, options, runMode = 'third
       mirrorOnly: false,
       hybridWalletMode: options?.hybridWalletMode,
     });
-    const preflight = await apiPost(ctx, '/api/v1/agent/execute-intent', preflightPayload);
+    const preflight = await apiPost(actionCtx, '/api/v1/agent/execute-intent', preflightPayload);
     const preflightNormalized = normalizeIntentResponse(preflight);
     const blockedCount = preflightNormalized.blocked || 0;
     if (!preflightNormalized.success || blockedCount > 0) {
@@ -296,7 +298,7 @@ async function executeThirdfyRun(ctx, flags, resolved, options, runMode = 'third
     mirrorOnly: false,
     hybridWalletMode: options?.hybridWalletMode,
   });
-  const response = await apiPost(ctx, '/api/v1/agent/execute-intent', payload);
+  const response = await apiPost(actionCtx, '/api/v1/agent/execute-intent', payload);
   const normalized = normalizeIntentResponse(response);
   normalized.idempotencyKey = payload.idempotencyKey;
   return normalized;
@@ -333,7 +335,8 @@ async function executeManagedWalletRun(ctx, flags, resolved, options) {
     runMode: 'agent_wallet',
     forceIdempotency: true,
   });
-  const response = await apiPost(ctx, '/api/v1/agent/execute', payload);
+  const actionCtx = withActionTimeout(ctx, resolved.resolvedAction);
+  const response = await apiPost(actionCtx, '/api/v1/agent/execute', payload);
   if (shouldFallbackAgentWalletToExecuteIntent(resolved, response)) {
     const userDid = resolveEffectiveUserDid(flags);
     const chainId = Number(flags.chainId || 8453);