@letterstory/cli 0.74.0 → 0.75.0

package/lib/cli.mjs

@@ -56,7 +56,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.74.0";
+export const VERSION = "0.75.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.
@@ -585,6 +585,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | entries [--from D] [--to D] [--vendor V] [--area A] [--source invoice|csv_import|api|manual]
           | add --vendor V --amount N --from D [--to D] --area A --category C [--basis billed|estimated] …
           | import <file.csv> [--vendor Concentrate] [--area A] [--keep-ledger-key] [--dry-run]
+          | usage <events.json>                       per-call costs as kernels/lettertrace push them
           | remove <entry-id> | services | service <slug> [--owner …] [--monthly N|none] [--renewal D]
                                                        Where Letter's money goes (spending.letter.dev):
                                                        totals, run rate, area/vendor/provider/model/

package/lib/commands/admin.mjs

@@ -13,7 +13,7 @@
 //      The old names — evals, eval-add, eval-set, proposals, propose-eval, capture-eval, reject-eval — still work.)
 //   admin evals scoreboard|cases|runs|run|triage|guard|retire …                      (fleet:read / tuning:experiment)
 //   admin crm import|capture|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
-//   admin spend summary|entries|add|import|remove|services|service …                (spend:read / spend:write)
+//   admin spend summary|entries|add|import|usage|remove|services|service …                (spend:read / spend:write)
 //   admin replays [--org <id>] [--target <id>] [--status …] [--limit n]                (fleet:read)
 //   admin replay --org <id> [<response-id> | --target <id>] [--surface …]           (fleet:replay)
 //   admin create-org --domain acme.com [--name "Acme"] [--test] [--no-key] [--key-name N]
@@ -3171,6 +3171,38 @@ async function cmdAdminSpend(ctx) {
 			printResult(io, flags, result, () => "");
 			return 0;
 		}
+		case "usage": {
+			// Per-call model costs, as kernels / lettertrace 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)");
+			const parsed = JSON.parse(readFileSync(path, "utf8"));
+			const events = Array.isArray(parsed) ? parsed : parsed?.events;
+			if (!Array.isArray(events) || events.length === 0) throw new CliError(`${path} holds no events.`);
+			let inserted = 0;
+			let duplicates = 0;
+			let cost = 0;
+			const rejected = [];
+			for (let i = 0; i < events.length; i += 1000) {
+				const r = await staffPost(ctx, `${SPEND}/usage`, { events: events.slice(i, i + 1000) });
+				inserted += r.inserted;
+				duplicates += r.duplicates;
+				cost += r.cost_usd;
+				rejected.push(...(r.rejected ?? []));
+			}
+			ok(
+				ctx,
+				`${events.length} events: ${inserted} new (${usd(cost)}), ${duplicates} already on file` +
+					(rejected.length ? `, ${rejected.length} refused` : "")
+			);
+			printResult(
+				io,
+				flags,
+				{ received: events.length, inserted, duplicates, cost_usd: cost, rejected },
+				() => ""
+			);
+			return 0;
+		}
 		case "remove": {
 			const id = positionals[1];
 			if (!id) throw new CliError("Usage: admin spend remove <entry-id>");
@@ -3208,7 +3240,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] | entries [--from D] [--to D] [--vendor V] [--area A] [--source S] | add --vendor V --amount N --from D … | import <file.csv> … | 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] | 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 …"
 			);
 	}
 }

package/package.json

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