@tuned-tensor/cli 0.4.22 → 0.4.24

package/README.md

@@ -1,8 +1,11 @@
 # tt - Tuned Tensor CLI
 
-`tt` is the command-line tool for [Tuned Tensor](https://www.tunedtensor.com).
-Use it to define behaviour specs, validate them, launch fine-tuning runs,
-manage datasets, and download or serve trained models.
+`tt` is the command-line client for the optional managed
+[Tuned Tensor](https://www.tunedtensor.com) service. Use it to define behaviour
+specs, launch managed fine-tuning runs, inspect paired baseline-vs-tuned
+reports, and download or serve trained models. For local CUDA or DGX Spark
+training without a Tuned Tensor account, use `tt-local` from
+`@tuned-tensor/local`.
 
 The main CLI documentation lives at
 [tunedtensor.com/docs/cli](https://tunedtensor.com/docs/cli). This README is a
@@ -37,6 +40,7 @@ tt push
 tt runs estimate <spec-id>
 tt runs start <spec-id>
 tt runs watch <run-id>
+tt runs report <run-id>
 ```
 
 To continue training from a completed fine-tuned model artifact:
@@ -51,11 +55,16 @@ Useful discovery commands:
 tt specs list
 tt datasets list
 tt runs list
+tt runs list --summary --json
 tt models list
 tt models base
 tt balance
 ```
 
+Use `tt runs list --summary` for agents and scripts that only need run status,
+scores, and pagination. It asks the API to omit detailed evaluation and event
+payloads; combine it with `--json` for compact structured output.
+
 Label real, unlabeled data with a teacher model (JSONL with `{"input": ...}`
 rows, or CSV with `--input-column`; up to 50,000 rows / 50 MB). Labeling runs
 as a managed cloud workflow — upload and disconnect; the teacher drafts

package/dist/index.js

@@ -652,6 +652,7 @@ function formatEstimateRange(estimate) {
   return `${formatMinutes(duration.estimated_minutes)} (${formatMinutes(duration.range_minutes.low)}-${formatMinutes(duration.range_minutes.high)})`;
 }
 function printRunEstimate(estimate) {
+  const billing = estimate.billing;
   printDetail([
     ["Estimated Time", formatEstimateRange(estimate)],
     ["Confidence", estimate.duration.confidence],
@@ -659,7 +660,20 @@ function printRunEstimate(estimate) {
     ["Basis", estimate.duration.basis.replaceAll("_", " ")],
     ["Estimated Cost", formatCents(estimate.estimated_cost_cents)],
     ["Training Tokens", `${(estimate.estimated_training_tokens / 1e3).toFixed(1)}k`],
-    ["Epochs", String(estimate.estimated_epochs)]
+    ["Epochs", String(estimate.estimated_epochs)],
+    ["Plan", billing?.plan],
+    [
+      "Billing Source",
+      billing?.billing_source === "free_quota" ? "Free monthly quota" : billing?.billing_source === "credits" ? "Credits" : void 0
+    ],
+    [
+      "Free Runs",
+      billing ? `${billing.free_runs_remaining}/${billing.free_runs_monthly_limit} remaining` : void 0
+    ],
+    [
+      "Free Eligible",
+      billing ? billing.free_run_eligible ? "yes" : `no (${billing.free_run_ineligibility.join(", ") || "not eligible"})` : void 0
+    ]
   ]);
   console.log(
     "\nDuration is a rough historical range. Final cost uses provider-reported training tokens."
@@ -937,19 +951,23 @@ async function buildRunRequestBody(cmdOpts, opts) {
 }
 function registerRunsCommands(parent) {
   const runs = parent.command("runs").description("Manage runs");
-  runs.command("list").description("List runs").option("-s, --spec <id>", "Filter by spec ID (full UUID or 8+ char prefix)").option("-p, --page <n>", "Page number", "1").option("--per-page <n>", "Results per page", "20").action(async (cmdOpts) => {
+  runs.command("list").description("List runs").option("-s, --spec <id>", "Filter by spec ID (full UUID or 8+ char prefix)").option("-p, --page <n>", "Page number", "1").option("--per-page <n>", "Results per page", "20").option("--summary", "Request compact run summaries without detailed eval payloads or events").action(async (cmdOpts) => {
     const opts = parent.opts();
     let path = "/runs";
     const query = {
       page: cmdOpts.page,
       per_page: cmdOpts.perPage
     };
+    if (cmdOpts.summary) query.view = "summary";
     if (cmdOpts.spec) {
       const fullSpecId = await resolveSpecId(cmdOpts.spec, opts);
       path = `/behavior-specs/${fullSpecId}/runs`;
     }
-    const { data, meta } = await get(path, query, opts);
-    if (isJsonMode()) return printJson({ data, meta });
+    const response = await get(path, query, opts);
+    const { data, meta } = response;
+    if (isJsonMode()) {
+      return printJson(cmdOpts.summary ? response : { data, meta });
+    }
     printTable(
       ["ID", "Spec", "#", "Status", "Score", "Started", "Completed"],
       data.map((r) => [
@@ -4123,7 +4141,7 @@ function registerPushCommand(parent) {
 
 // src/index.ts
 var program = new Command();
-program.name("tt").description("Tuned Tensor CLI \u2014 fine-tune and evaluate LLMs").version("0.4.22").option("-k, --api-key <key>", "API key (overrides stored key)").option(
+program.name("tt").description("Tuned Tensor CLI \u2014 fine-tune and evaluate LLMs").version("0.4.24").option("-k, --api-key <key>", "API key (overrides stored key)").option(
   "-u, --base-url <url>",
   "API base URL (default: https://tunedtensor.com)"
 ).option("--json", "Output raw JSON").option("--no-color", "Disable colors").hook("preAction", (_thisCommand, actionCommand) => {