@letterstory/cli 0.122.0 → 0.123.0

package/lib/cli.mjs

@@ -61,7 +61,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.122.0";
+export const VERSION = "0.123.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
@@ -851,7 +851,8 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | add --vendor V --amount N --from D [--to D] --area A --category C [--basis billed|estimated] …
           | import <file.csv> [--vendor Concentrate] [--area A] [--ledger-key K] [--dry-run]
           | import <file.csv> [--vendor Concentrate] [--area A] [--keep-ledger-key] [--dry-run]
-          | usage <events.json>                       per-call costs as kernels/lettertrace push them
+          | usage <events.json>                       per-call costs as kernels/lettertrace/models push them
+          | usage list --source models --from D --to D   one source's calls back, newest first
           | remove <entry-id> | services | service <slug> [--owner …] [--monthly N|none] [--renewal D] [--units N|none]
                                                        Where Letter's money goes (spending.letter.dev):
                                                        totals, run rate, area/vendor/provider/model/

package/lib/commands/admin.mjs

@@ -4043,7 +4043,34 @@ async function cmdAdminSpend(ctx) {
 			return 0;
 		}
 		case "usage": {
-			// Per-call model costs, as kernels / lettertrace push them (POST /api/superadmin/spend/usage):
+			if (positionals[1] === "list") {
+				// One source's calls back, newest first (GET /api/superadmin/spend/usage).
+				const source = flagStr(flags.source);
+				const from = flagStr(flags.from);
+				const to = flagStr(flags.to);
+				if (!source || !from || !to)
+					throw new CliError(
+						"Usage: admin spend usage list --source models --from YYYY-MM-DD --to YYYY-MM-DD [--limit N]"
+					);
+				const params = new URLSearchParams(
+					compact({ source, from, to, limit: flagNum(flags.limit)?.toString() })
+				);
+				const result = await staffRequest(ctx, "GET", `${SPEND}/usage?${params}`);
+				printResult(
+					io,
+					flags,
+					result,
+					(r) =>
+						(r.events ?? [])
+							.map(
+								(e) =>
+									`${e.occurred_at}  ${e.model.padEnd(16)} ${e.operation.padEnd(10)} ${(e.outcome ?? "").padEnd(8)} ${String(e.latency_ms ?? "").padStart(7)}ms  ${usd(e.cost_usd).padStart(9)}  ${e.key_label}`
+							)
+							.join("\n") + (r.next ? "\n… more (narrow --from/--to or raise --limit)" : "")
+				);
+				return 0;
+			}
+			// Per-call model costs, as kernels / lettertrace / models push them (POST /api/superadmin/spend/usage):
 			// a JSON file holding { events: [...] } or a bare array. Idempotent on each event_id.
 			const path = positionals[1];
 			if (!path) throw new CliError("Usage: admin spend usage <events.json>   ({ events: [...] } or an array)");
@@ -4193,7 +4220,7 @@ async function cmdAdminSpend(ctx) {
 		}
 		default:
 			throw new CliError(
-				"Usage: admin spend summary [--range day|week|month|year | --from D --to D] [--grain day|week|month] | reconcile [--from D --to D] | pnl [--range …] | reference add … | stripe-sync --from D --to D | entries [--from D] [--to D] [--vendor V] [--area A] [--source S] | add --vendor V --amount N --from D … | import <file.csv> … | usage <events.json> | remove <entry-id> | services | service <slug> --owner … --monthly …"
+				"Usage: admin spend summary [--range day|week|month|year | --from D --to D] [--grain day|week|month] | reconcile [--from D --to D] | pnl [--range …] | reference add … | stripe-sync --from D --to D | entries [--from D] [--to D] [--vendor V] [--area A] [--source S] | add --vendor V --amount N --from D … | import <file.csv> … | usage <events.json> | usage list --source S --from D --to D | remove <entry-id> | services | service <slug> --owner … --monthly …"
 			);
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.122.0",
+	"version": "0.123.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",