@vincemakes/kiso-tui 0.36.0 → 0.37.0

package/dist/lines.d.ts

@@ -132,7 +132,7 @@ export interface RunUsage {
 }
 /**
  * B area/v2a: the one-line status bar after a terminal, e.g.
- *   [turn 3 · in 12.4k out 1.8k · cache 9.2k · ctx ~14%]
+ *   [turn 3 · fresh 12.4k out 1.8k · cache 9.2k · ctx ~14%]
  * Denoising: unknown fields are OMITTED ENTIRELY (show what there is); a fully unknown
  * usage → null (the caller prints nothing); faux mode → [turn N · faux].
  * All data comes from usage events; ctx is the approximate estimate
@@ -169,6 +169,16 @@ export interface RecapStats {
     readonly edits?: number;
     /** The turn's work BY TOOL, in first-call order (R3d). */
     readonly byTool?: readonly [string, number][];
+    /** W22 (owner, 2026-09-14) — the TURN's usage: the SUM over the turn's
+     *  model calls, never the last call's alone (the scope this field
+     *  carried until W22, which made a nine-call turn report its ninth
+     *  call and read as the turn's). `in` is the canonical FRESH count (E2)
+     *  and renders as `fresh`, so the number says what it is: the input the
+     *  turn bought at full price. The rest of its prompt was cache — which
+     *  is why the field beside it is a ratio, not a raw sum: a sum over
+     *  calls counts the same prefix once per call. An unmeasured call
+     *  (`known: false`) makes the whole figure unknown, and the row then
+     *  says nothing rather than a lower bound dressed as a total. */
     readonly usage: RunUsage;
     /** R-C item 4: the per-turn cache miss (min(prevIn, in) − cacheRead),
      *  passed only when above the noise floor — the re-sent-uncached

package/dist/lines.js

@@ -141,7 +141,7 @@ function approvalDetail(name, input, resolvePath) {
 }
 /**
  * B area/v2a: the one-line status bar after a terminal, e.g.
- *   [turn 3 · in 12.4k out 1.8k · cache 9.2k · ctx ~14%]
+ *   [turn 3 · fresh 12.4k out 1.8k · cache 9.2k · ctx ~14%]
  * Denoising: unknown fields are OMITTED ENTIRELY (show what there is); a fully unknown
  * usage → null (the caller prints nothing); faux mode → [turn N · faux].
  * All data comes from usage events; ctx is the approximate estimate
@@ -154,7 +154,7 @@ export function renderStatusLine(turn, usage, ctxRatio, faux = false) {
         return null; // everything unknown — nothing worth showing
     const parts = [];
     if (usage.in !== null || usage.out !== null) {
-        const seg = `${usage.in !== null ? `in ${kUnit(usage.in)}` : ""}${usage.in !== null && usage.out !== null ? " " : ""}${usage.out !== null ? `out ${kUnit(usage.out)}` : ""}`;
+        const seg = `${usage.in !== null ? `fresh ${kUnit(usage.in)}` : ""}${usage.in !== null && usage.out !== null ? " " : ""}${usage.out !== null ? `out ${kUnit(usage.out)}` : ""}`;
         parts.push(seg);
     }
     if (usage.cache !== null)
@@ -211,7 +211,7 @@ export function renderRecap(s) {
             : [];
     const parts = [`took ${s.seconds}s`, ...work];
     if (s.usage.known) {
-        const seg = `${s.usage.in !== null ? `in ${kUnit(s.usage.in)}` : ""}${s.usage.in !== null && s.usage.out !== null ? " " : ""}${s.usage.out !== null ? `out ${kUnit(s.usage.out)}` : ""}`;
+        const seg = `${s.usage.in !== null ? `fresh ${kUnit(s.usage.in)}` : ""}${s.usage.in !== null && s.usage.out !== null ? " " : ""}${s.usage.out !== null ? `out ${kUnit(s.usage.out)}` : ""}`;
         if (seg !== "")
             parts.push(seg);
         if (s.usage.cache !== null && s.usage.in !== null && (s.usage.in > 0 || s.usage.cache > 0)) {

package/dist/status.js

@@ -39,12 +39,24 @@ import { displayWidth } from "@vincemakes/kiso-tui-cells/width";
  * Glyphs only, no colour: intact under NO_COLOR and on any ground.
  */
 export const STATUS_GLYPHS = TWINKLE;
-/** The ~ctx estimate as the whole-percent LEFT. A non-finite ratio (no
- *  window, no estimate) yields null and the row prints "~null%" — the
- *  long-standing shape, kept on purpose: an honest null beats an
- *  invented percentage. */
-function ctxLeft(ratio) {
-    return Number.isFinite(ratio) ? Math.round((1 - ratio) * 100) : null;
+/**
+ * The ~ctx estimate as the whole-percent LEFT, or `ctx ?` when there is no
+ * window to divide by.
+ *
+ * A percentage needs a denominator. When the model's context window is not
+ * KNOWN — the registry records null for it, nobody set one in the profile,
+ * no env — there is no denominator, and this row's rule is the same as
+ * every other number on it: a measurement, or nothing. It used to print
+ * `ctx left ~null%`, which at least did not invent a figure; `ctx ?` says
+ * the same thing to a reader.
+ *
+ * The failure this replaces is worse than either: the window fell back to
+ * a hardcoded 200,000 and the row printed a confident `ctx left ~82%`
+ * against a number nobody had measured. A reader had no way to tell that
+ * percentage from one computed against a real window.
+ */
+function ctxSegment(ratio) {
+    return Number.isFinite(ratio) ? `ctx left ~${Math.round((1 - ratio) * 100)}%` : "ctx ?";
 }
 /**
  * TPS-1 — the settled DECODE rate of one model call: its output tokens
@@ -90,7 +102,7 @@ export function runningStatus(glyph, since, outTokens, ctxRatio, tokPerSec = nul
     // state, so its row says nothing rather than guessing.
     const rate = tokPerSec !== null ? ` · ${tokPerSec} tok/s` : "";
     const seconds = Math.max(1, Math.round((Date.now() - since) / 1000));
-    return `${glyph} working ${seconds}s${out}${rate} · esc stop · alt+⏎ redirect · ctx left ~${ctxLeft(ctxRatio)}%`;
+    return `${glyph} working ${seconds}s${out}${rate} · esc stop · alt+⏎ redirect · ${ctxSegment(ctxRatio)}`;
 }
 /** DF-0330-F1 — how far the model id may be squeezed on the ROW. Twenty
  *  visible columns keeps a head and a tail: `deepseek-v…s-on-0910` still
@@ -165,7 +177,7 @@ export function idleStatus(tier, model, ctxRatio, meter, W) {
         if (meter?.cacheHitPct != null)
             parts.push(`CH ${Math.round(meter.cacheHitPct)}%`);
         // costUsd deliberately NOT rendered — see StatusMeter.costUsd.
-        parts.push(`ctx left ~${ctxLeft(ctxRatio)}%`);
+        parts.push(ctxSegment(ctxRatio));
         if (meter?.tokPerSec != null)
             parts.push(`${meter.tokPerSec} tok/s`); // TPS-1: last, after the ctx estimate
         return parts.join(" · ");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui",
-	"version": "0.36.0",
+	"version": "0.37.0",
 	"description": "kiso tui \u2014 the pure terminal layer (cell renderer, dock, raw editor, diff, palette). Zero runtime dependencies: input is data, output is bytes.",
 	"type": "module",
 	"license": "MIT",
@@ -35,6 +35,6 @@
 	},
 	"homepage": "https://github.com/vincemakes/kiso/tree/main/packages/tui#readme",
 	"dependencies": {
-		"@vincemakes/kiso-tui-cells": "0.36.0"
+		"@vincemakes/kiso-tui-cells": "0.37.0"
 	}
 }