@vincemakes/kiso-tui-cells 0.39.0 → 0.39.2

package/dist/components.d.ts

@@ -318,6 +318,18 @@ export declare function formatDuration(totalSeconds: number): string;
  *  seconds, because a clock the user is watching tick should not stop
  *  ticking. */
 export declare function elapsedLabel(totalSeconds: number): string;
+/** The SETTLED call's duration — R13's grammar (`exit 0 · 90 lines ·
+ *  0.4s`). A finished call knows its length to a tenth, which is
+ *  information a running clock cannot have and a finished one should not
+ *  throw away: under a minute the tenth stays.
+ *
+ *  Past a minute the tenth stops being the interesting digit and the
+ *  live label takes over — a twelve-minute call settled as `734.2s`, the
+ *  same unreadable four-figure count the status row had. NOTHING under a
+ *  minute moves, which is every duration the suite pinned before this.
+ *  The suffix is part of the label (the live form's already is), so no
+ *  caller appends its own `s`. */
+export declare function settledLabel(totalSeconds: number): string;
 /** The status container's row: the status text (+ the tail) with the
  *  right-aligned "/ commands · ↑ history" hint in the idle state —
  *  the hint CUT FIRST when the width is short (the #16g rule); when

package/dist/components.js

@@ -644,7 +644,7 @@ class ToolExecution {
                 out.push(...toolBlockBody(c, W, ctx));
                 return out;
             }
-            const elapsed = c.startedAt !== null && c.doneAt !== null ? ((c.doneAt - c.startedAt) / 1000).toFixed(1) : "?";
+            const elapsed = c.startedAt !== null && c.doneAt !== null ? settledLabel((c.doneAt - c.startedAt) / 1000) : "?s";
             // TUI2-R1.5 ⑤ (VD-6): the line count is stated EXACTLY ONCE. Every
             // read card carried it twice — `(2 lines, 0.0s) · 2 lines · ctrl+o
             // expands` — because the parens and the suffix were written by
@@ -726,7 +726,7 @@ class ToolExecution {
                 // which let a narrow row cut the affordance off entirely.
                 // The tier ladder is what gives way; the key never is.
                 const keySuffix = c.expanded ? ` · ${COLLAPSE_ROW}` : "";
-                const words = pickTier([join(meta, counted, `${elapsed}s`, attr), join(meta, counted, `${elapsed}s`), join(meta, `${elapsed}s`), meta], W - visibleWidth(noteIndent()) - keySuffix.length);
+                const words = pickTier([join(meta, counted, elapsed, attr), join(meta, counted, elapsed), join(meta, elapsed), meta], W - visibleWidth(noteIndent()) - keySuffix.length);
                 // DC-50 / R14 — ONE CARD, ONE SKELETON, expanded or not.
                 //
                 // The expanded card used to take a DIFFERENT shape: its head
@@ -780,7 +780,7 @@ class ToolExecution {
             // ("compil 1s"). The head is cut against the room the duration
             // leaves; the duration then rides the row, always legible.
             const elapsed = c.startedAt !== null ? Math.max(1, Math.round((ctx.now - c.startedAt) / 1000)) : 1;
-            const dur = ` · ${elapsed}s`;
+            const dur = ` · ${elapsedLabel(elapsed)}`;
             // R3 (design §5.2): a running command BREATHES — one glyph, seven
             // greys, bottoming out on the ground's dim token (§2.2 applies
             // mid-animation, not just at rest). The quadrant spinner it
@@ -954,18 +954,18 @@ function settledHeadText(verbCol, target, meta, attr, elapsed, room, counted = "
     // first, then the count, and the core — what happened and how long it
     // took — is never cut open; below that the target itself truncates.
     const join = (...xs) => xs.filter((x) => x !== "").join(" · ");
-    const core = join(meta, counted, `${elapsed}s`);
-    const withAttr = join(meta, counted, `${elapsed}s`, attr.replace(" · ", ""));
+    const core = join(meta, counted, elapsed);
+    const withAttr = join(meta, counted, elapsed, attr.replace(" · ", ""));
     const lead = `${verbCol} `;
     const row = (tail) => `${lead}${target}${tail === "" ? "" : ` · ${tail}`}`;
     // 1. everything; 2. the attribution gives way; 2b. the COUNT gives
     //    way next (pin 4), where the suffix is not already carrying it —
     //    the target whole through all three
-    const whole = firstFit([row(withAttr), row(core), row(join(meta, `${elapsed}s`))], room);
+    const whole = firstFit([row(withAttr), row(core), row(join(meta, elapsed))], room);
     if (whole !== null)
         return whole;
     // 3. the target truncates, the core stays whole
-    const stem = join(meta, `${elapsed}s`);
+    const stem = join(meta, elapsed);
     const budget = room - visibleWidth(lead) - visibleWidth(stem) - 4; // the ellipsis + " · "
     if (budget >= 1)
         return `${lead}${widthCut(target, budget)}… · ${stem}`;
@@ -975,7 +975,7 @@ function settledHeadText(verbCol, target, meta, attr, elapsed, room, counted = "
     //    no bracket to leave open, so the reason retired with the
     //    parentheses and pin 4's own rule applies at every width: what
     //    happened and how long it took is never cut away.
-    const floor = `${elapsed}s`;
+    const floor = elapsed;
     const left = room - visibleWidth(lead) - visibleWidth(floor) - 4; // the ellipsis + " · "
     if (left >= 1)
         return `${lead}${widthCut(target, left)}… · ${floor}`;
@@ -1820,6 +1820,21 @@ export function formatDuration(totalSeconds) {
 export function elapsedLabel(totalSeconds) {
     return duration(totalSeconds, true);
 }
+/** The SETTLED call's duration — R13's grammar (`exit 0 · 90 lines ·
+ *  0.4s`). A finished call knows its length to a tenth, which is
+ *  information a running clock cannot have and a finished one should not
+ *  throw away: under a minute the tenth stays.
+ *
+ *  Past a minute the tenth stops being the interesting digit and the
+ *  live label takes over — a twelve-minute call settled as `734.2s`, the
+ *  same unreadable four-figure count the status row had. NOTHING under a
+ *  minute moves, which is every duration the suite pinned before this.
+ *  The suffix is part of the label (the live form's already is), so no
+ *  caller appends its own `s`. */
+export function settledLabel(totalSeconds) {
+    const tenths = Math.max(0, Math.round(totalSeconds * 10) / 10);
+    return tenths < 60 ? `${tenths.toFixed(1)}s` : elapsedLabel(tenths);
+}
 /**
  * W20 — the task checklist as STATE: ONE live block that redraws in
  * place (the current turn's in-place updates), settling at the turn's

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * package); the cli never imports it directly. Experimental — no
  * API-stability promise yet.
  */
-export { SPINNER, foldLine, foldWords, visibleWidth, bodySpacing, Container, cellComponent, foldTerms, CAP_TASK_LIVE, elapsedLabel, formatDuration, statusLine, boxTop, boxBottom, terminalPipe, type FrameCtx, type RenderLine, type Component, type BodyCell, } from "./components.js";
+export { SPINNER, foldLine, foldWords, visibleWidth, bodySpacing, Container, cellComponent, foldTerms, CAP_TASK_LIVE, elapsedLabel, settledLabel, formatDuration, statusLine, boxTop, boxBottom, terminalPipe, type FrameCtx, type RenderLine, type Component, type BodyCell, } from "./components.js";
 export { editFileDiff, truncateDiff, writeFileDiff, type DiffLine, type DiffResult } from "./diff.js";
 export { pendingQueueRows } from "./components.js";
 export { charWidth, displayWidth, leadWidth, widthOf } from "./width.js";

package/dist/index.js

@@ -6,7 +6,7 @@
  * package); the cli never imports it directly. Experimental — no
  * API-stability promise yet.
  */
-export { SPINNER, foldLine, foldWords, visibleWidth, bodySpacing, Container, cellComponent, foldTerms, CAP_TASK_LIVE, elapsedLabel, formatDuration, statusLine, boxTop, boxBottom, terminalPipe, } from "./components.js";
+export { SPINNER, foldLine, foldWords, visibleWidth, bodySpacing, Container, cellComponent, foldTerms, CAP_TASK_LIVE, elapsedLabel, settledLabel, formatDuration, statusLine, boxTop, boxBottom, terminalPipe, } from "./components.js";
 export { editFileDiff, truncateDiff, writeFileDiff } from "./diff.js";
 // W22 (the v8 input round): the pending-queue chips — the SAME
 // UserMessage chip with the □ gutter, pre-rendered above the input

package/dist/strings.d.ts

@@ -188,15 +188,7 @@ export declare function keysSheetRows(W: number): string[];
  *  sheet renders, joined — so the two can disagree only by deleting a
  *  test. The sheet is the readable form; this is the greppable one. */
 export declare function keysHelpRow(): string;
-/**
- * KC3.5 slice ⓪ (the extraction) — the /help command table.
- *
- * The rows were eight bodyLog calls in the CLI's dispatcher; they are
- * presentation, and presentation belongs here (the KC3 §1 pattern —
- * the FLOW, which is "print these on the chain, then re-prompt", stays
- * in dispatch.ts). The last row carries its own newline exactly as it
- * did inline: bodyLog splits on \n, so `exit` and `keys` land as two
- * rows from one call — the shape the KC1/KC2/KC3 gestures were added
- * to, unchanged.
- */
+/** The slash commands `/help` lists. The keys and the `!` gestures in the
+ *  table are not commands and are not here. */
+export declare function slashCommandNames(): readonly string[];
 export declare function helpRows(): string[];

package/dist/strings.js

@@ -430,51 +430,65 @@ export function keysHelpRow() {
  * rows from one call — the shape the KC1/KC2/KC3 gestures were added
  * to, unchanged.
  */
+/** The rows `/help` prints, as DATA — the one place that says which
+ *  commands exist. `helpRows` renders it; `slashCommandNames` asks it
+ *  whether a word is a command at all, so the dispatcher's error line
+ *  cannot drift from the list the same screen prints. */
+const HELP_TABLE = [
+    ["/help", "print this list of commands"],
+    ["/think", "show the last full thinking block"],
+    ["/last", "show the most recent tool call's input and output"],
+    // R4 (C4d): a committed row is the terminal's, and cannot be
+    // re-wrapped in place (ADR-0046) — this appends it re-folded.
+    ["/rewrap", "re-print the recent prose at the current width"],
+    ["/copy", "copy the last answer (raw markdown) — ctrl+x does the same"],
+    ["/status", "show session id, event count, and context estimate"],
+    // A command with no row is a command nobody can find. `/context` has
+    // been dispatchable since TUI2-R1 slice 6 and was never listed here,
+    // so the only way to learn it existed was to read the source.
+    ["/context", "show where the context went — the per-request rent ledger"],
+    ["/mode", "show the approval tier; /mode <name> switches (manual/default/accept-edits/plan/bypass)"],
+    ["/model", "list model profiles; /model <name|provider/model> switches"],
+    ["/compact", "summarize the older conversation to free context"],
+    ["/clear", "start a fresh conversation (the old session stays resumable)"],
+    ["/resume", "switch to another session; /resume <id> goes directly"],
+    // §2.5: the conversation is untouched — this rereads what kiso was
+    // built with, not what it has said.
+    ["/reload", "reread extensions, skills and config into this session"],
+    // §2.2: the two shell gestures and their one escape. They sit
+    // beside the slash commands because that is what a reader is
+    // looking for when they look here, even though `!` is not one.
+    // §2.3: the switch belongs beside ctrl+o's job, and a gesture the
+    // sheet does not name is a gesture nobody uses (DC-30, DC-36).
+    ["ctrl+t", "fold the thinking blocks, and fold them back"],
+    // §2.4: the composer, in your own editor. It names the variables
+    // because that is what a reader has to set for it to work.
+    ["ctrl+g", "edit the composer in $VISUAL or $EDITOR — the text comes back unsent"],
+    ["!<cmd>", "run a shell command and send it with its output as your turn"],
+    ["!!<cmd>", "run one and show it here only — the model never sees it"],
+    ["\\!", "send a line that really starts with ! (the only escape)"],
+    ["exit", "leave the session"],
+    // TUI2-R1 (D): the SENTENCE is deliberately unchanged. Deriving it
+    // from KEY_BINDINGS would be an improvement and it would also move
+    // an assertion outside the round's declared supersession classes,
+    // so the sheet stays the derived surface and this row keeps its
+    // words. `keysHelpRow()` exists for the round allowed to swap it;
+    // until then the drift guard is the test that every binding in the
+    // table is mentioned here. DC-1 changes the PADDING, not the words.
+    ["keys", "enter sends \u00b7 ctrl+J newline (shift+enter where encoded) \u00b7 esc stops the run \u00b7 alt+\u23ce stops it and sends this instead \u00b7 @ files \u00b7 1-4 answers an ask"],
+];
+/** The slash commands `/help` lists. The keys and the `!` gestures in the
+ *  table are not commands and are not here. */
+export function slashCommandNames() {
+    return HELP_TABLE.map(([name]) => name).filter((n) => n.startsWith("/"));
+}
 export function helpRows() {
     const p = palette();
     // DC-1: ONE description column. The gap used to be four spaces after
     // the name whatever the name's length, so `/help`'s description began
     // three columns left of `/compact`'s and the second column wandered
     // down the list. displayWidth is the authority, as everywhere else.
-    const table = [
-        ["/help", "print this list of commands"],
-        ["/think", "show the last full thinking block"],
-        ["/last", "show the most recent tool call's input and output"],
-        // R4 (C4d): a committed row is the terminal's, and cannot be
-        // re-wrapped in place (ADR-0046) — this appends it re-folded.
-        ["/rewrap", "re-print the recent prose at the current width"],
-        ["/copy", "copy the last answer (raw markdown) — ctrl+x does the same"],
-        ["/status", "show session id, event count, and context estimate"],
-        ["/mode", "show the approval tier; /mode <name> switches (manual/default/accept-edits/plan/bypass)"],
-        ["/model", "list model profiles; /model <name|provider/model> switches"],
-        ["/compact", "summarize the older conversation to free context"],
-        ["/clear", "start a fresh conversation (the old session stays resumable)"],
-        ["/resume", "switch to another session; /resume <id> goes directly"],
-        // §2.5: the conversation is untouched — this rereads what kiso was
-        // built with, not what it has said.
-        ["/reload", "reread extensions, skills and config into this session"],
-        // §2.2: the two shell gestures and their one escape. They sit
-        // beside the slash commands because that is what a reader is
-        // looking for when they look here, even though `!` is not one.
-        // §2.3: the switch belongs beside ctrl+o's job, and a gesture the
-        // sheet does not name is a gesture nobody uses (DC-30, DC-36).
-        ["ctrl+t", "fold the thinking blocks, and fold them back"],
-        // §2.4: the composer, in your own editor. It names the variables
-        // because that is what a reader has to set for it to work.
-        ["ctrl+g", "edit the composer in $VISUAL or $EDITOR — the text comes back unsent"],
-        ["!<cmd>", "run a shell command and send it with its output as your turn"],
-        ["!!<cmd>", "run one and show it here only — the model never sees it"],
-        ["\\!", "send a line that really starts with ! (the only escape)"],
-        ["exit", "leave the session"],
-        // TUI2-R1 (D): the SENTENCE is deliberately unchanged. Deriving it
-        // from KEY_BINDINGS would be an improvement and it would also move
-        // an assertion outside the round's declared supersession classes,
-        // so the sheet stays the derived surface and this row keeps its
-        // words. `keysHelpRow()` exists for the round allowed to swap it;
-        // until then the drift guard is the test that every binding in the
-        // table is mentioned here. DC-1 changes the PADDING, not the words.
-        ["keys", "enter sends \u00b7 ctrl+J newline (shift+enter where encoded) \u00b7 esc stops the run \u00b7 alt+\u23ce stops it and sends this instead \u00b7 @ files \u00b7 1-4 answers an ask"],
-    ];
+    const table = HELP_TABLE;
     const stop = Math.max(...table.map(([name]) => displayWidth(name))) + 4;
     const cmd = (name, desc) => `${p.bold}${name}${p.reset}${" ".repeat(stop - displayWidth(name))}${desc}`;
     const rows = table.slice(0, -2).map(([name, desc]) => cmd(name, desc));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui-cells",
-	"version": "0.39.0",
+	"version": "0.39.2",
 	"description": "kiso tui-cells \u2014 the components cell renderer (components, diff, width, the render slice). Zero runtime dependencies: input is data, output is bytes.",
 	"type": "module",
 	"license": "MIT",