@thirdfy/agent-cli 0.2.16 → 0.2.17

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [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.17
 
-- `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+**.
+- Lighter onboarding writes (`complete_lighter_onboarding`, `setup_lighter_api_key`, `register_lighter_api_key`) use a 180s HTTP timeout by default so `run` and `wallet execute` do not abort before CCTP credit or Ethereum `changePubKey` completes. Override with `THIRDFY_CLI_LONG_TIMEOUT_MS`. Pairs with Thirdfy API **v3.9.4+** and `thirdfy-mcp` **v0.0.66+**.
 
 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.17",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {

package/src/commands/credits.mjs

@@ -67,12 +67,16 @@ export function createCreditsCommands({ printEnvelope, getAuthToken }) {
     const response = await apiGet(ctx, '/api/v1/credits/pricing/models', {
       Authorization: `Bearer ${authToken}`,
     });
+    const firstModel = response?.models?.[0];
+    const summary = firstModel?.estimatedUsdPerTurn != null
+      ? `${response?.models?.length ?? 0} models · e.g. ${firstModel.modelKey} ~$${Number(firstModel.estimatedUsdPerTurn).toFixed(2)}/turn`
+      : `${response?.models?.length ?? 0} models loaded`;
     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 +98,16 @@ export function createCreditsCommands({ printEnvelope, getAuthToken }) {
       },
       { Authorization: `Bearer ${authToken}` },
     );
+    const estimate = response?.estimate;
+    const summary = estimate?.chargedUsd != null
+      ? `~$${Number(estimate.chargedUsd).toFixed(2)} charged (${estimate.chargedCredits ?? estimate.totalCredits} credits)`
+      : `${estimate?.chargedCredits ?? estimate?.totalCredits ?? '?'} credits`;
     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

@@ -57,14 +57,19 @@ async function commandCreditsBalance(ctx, flags, capabilities) {
   const response = await apiGet(ctx, '/api/v1/credits/balance', {
     Authorization: `Bearer ${authToken}`,
   });
+  const summary =
+    typeof response?.availableUsd === 'number'
+      ? `$${response.availableUsd.toFixed(2)} available (${response.balance ?? 0} credits)`
+      : `${response?.balance ?? 0} credits`;
   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/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);