@thirdfy/agent-cli 0.2.17 → 0.2.18

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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

package/README.md

@@ -40,9 +40,9 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.17
+## What's new in v0.2.18
 
-- 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+**.
+- 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.17",
+  "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,10 +71,7 @@ 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`;
+    const summary = formatCreditsModelsSummary(response);
     printEnvelope({
       success: true,
       code: 'OK',
@@ -99,9 +100,7 @@ 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`;
+    const summary = formatCreditsEstimateSummary(estimate);
     printEnvelope({
       success: true,
       code: 'OK',

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,10 +58,7 @@ 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`;
+  const summary = formatCreditsBalanceSummary(response);
   printEnvelope({
     success: true,
     code: 'OK',

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`;
+}