@vincemakes/kiso-tui 0.45.3 → 0.46.1

package/dist/editor.d.ts

@@ -96,6 +96,9 @@ export declare class Editor {
      *  exactly like ctrl+o because it is the same kind of thing: a switch
      *  the compositor throws, never an interpretation the editor makes. */
     onThink(cb: () => void): void;
+    /** ADR-0058 (3e): the background key (ctrl+b) — move the running
+     *  foreground command to the background. Forwarded, like ctrl+t. */
+    onBackground(cb: () => void): void;
     /** §2.4: the external-editor key (ctrl+g). */
     onEditor(cb: () => void): void;
     /** §2.4 — hand the terminal to an external program, and take it back.

package/dist/editor.js

@@ -116,7 +116,8 @@ export const MOUSE_OFF = "\x1b[?1000l\x1b[?1006l";
 export const PROMPT = "▌ ";
 export const PROMPT_WIDTH = displayWidth(PROMPT);
 export const MENU_ITEMS = [
-    { name: "/mode", desc: "switch the approval tier (default/accept-edits/plan/dontAsk/bypass)" },
+    { name: "/mode", desc: "switch the approval tier (default/accept-edits/plan/full-access)" },
+    { name: "/dont-ask", desc: "never stop for you: what would ask is refused (on/off)" },
     { name: "/model", desc: "list model profiles; switch with /model <name|provider/model>" },
     { name: "/compact", desc: "summarize the older conversation to free context" },
     // the /resume+/clear mini-spec: the session-navigation pair
@@ -130,6 +131,8 @@ export const MENU_ITEMS = [
     { name: "/think", desc: "show the last full thinking block" },
     { name: "/last", desc: "show the most recent tool call's input and output" },
     { name: "/copy", desc: "copy the last answer (raw markdown) — ctrl+x does the same" },
+    // ADR-0058 (3e): the session's tasks — stop one, or look at its output
+    { name: "/tasks", desc: "list this session's background tasks; stop one or show its output" },
     // R4 (C4d): the committed transcript belongs to the terminal and can
     // never be re-wrapped in place (ADR-0046); this appends it re-folded.
     { name: "/rewrap", desc: "re-print the recent prose at the current width" },
@@ -351,6 +354,7 @@ export class Editor {
     // coexist; the editor never interprets the key itself.
     #expandCbs = [];
     #thinkCbs = [];
+    #backgroundCbs = [];
     #editorCbs = [];
     /** E1 §3 — ctrl+x. Same shape as the expand key: the editor owns the
      *  KEY, the CLI owns what it means. */
@@ -502,6 +506,11 @@ export class Editor {
     onThink(cb) {
         this.#thinkCbs.push(cb);
     }
+    /** ADR-0058 (3e): the background key (ctrl+b) — move the running
+     *  foreground command to the background. Forwarded, like ctrl+t. */
+    onBackground(cb) {
+        this.#backgroundCbs.push(cb);
+    }
     /** §2.4: the external-editor key (ctrl+g). */
     onEditor(cb) {
         this.#editorCbs.push(cb);
@@ -1656,6 +1665,17 @@ export class Editor {
                     cb();
                 i += 1;
             }
+            else if (c === "\x02") {
+                // ADR-0058 (3e) — ctrl+b moves the running foreground command
+                // to the background. `\x02` was unbound in this dispatch. It
+                // works with text in the composer (a steer being typed is
+                // exactly when the person wants the command out of the way);
+                // a panel owns its keys before this point. Inside tmux the
+                // first ctrl+b is tmux's prefix: pressing it twice sends it.
+                for (const cb of [...this.#backgroundCbs])
+                    cb();
+                i += 1;
+            }
             else if (c === "\x07") {
                 // §2.4 — ctrl+g opens $VISUAL / $EDITOR on the composer.
                 //

package/dist/index.d.ts

@@ -7,12 +7,12 @@
  * editor, the diff renderer, and the palette.
  */
 export { Body, Dock, CURSOR_MARKER, type BodyOptions } from "./compositor.js";
-export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, PICK_MAX, modePickView, modelPickView, pickAffordance, pickBlockRows, pickLeadPlain, type PickOption, type PickResult, type PickRuntime, type PickSpec, type PanelArgs, type PanelFlavor, type PanelPhase, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, type SaferAnswer, type SaferFailure, type SaferOption, type SaferRuntime, panelOptions, type PanelOption, type PanelOptionKind, type PanelState, type PanelVerdict, type PanelView, } from "./approval-panel.js";
+export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, PICK_MAX, modePickView, modelPickView, namedPickView, pickAffordance, pickBlockRows, pickLeadPlain, type PickOption, type PickResult, type PickRuntime, type PickSpec, type PanelArgs, type PanelFlavor, type PanelPhase, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, type SaferAnswer, type SaferFailure, type SaferOption, type SaferRuntime, panelOptions, type PanelOption, type PanelOptionKind, type PanelState, type PanelVerdict, type PanelView, } from "./approval-panel.js";
 export { Container, foldLine, foldWords, visibleWidth, SPINNER, type Component, type FrameCtx } from "./components.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, type MenuItem, } from "./editor.js";
 export { bannerLines, COLOR_OFF, COLOR_ON, currentGround, setGround, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, toolTarget, truncateRow, type Palette, type PathResolver, type RecapStats, type ResumeMeta, type RenderInput, type RenderResult, type RunUsage, } from "./lines.js";
 export { editFileDiff, truncateDiff, writeFileDiff, type DiffLine, type DiffResult } from "./diff.js";
-export { STATUS_GLYPHS, cacheHitPct, compactingStatus, composeRow, decodeRate, idleStatus, retrySegment, runningStatus, type CompactingProgress, type RetryOnRow, type RowSegment, type StatusMeter } from "./status.js";
+export { STATUS_GLYPHS, cacheHitPct, compactingStatus, composeRow, decodeRate, idleStatus, retrySegment, runningStatus, tasksSegment, type CompactingProgress, type RetryOnRow, type RowSegment, type StatusMeter, type TaskCountsOnRow } from "./status.js";
 export { contextRows, contextUnavailableRows, type ContextLedger } from "./context-ledger.js";
 export { interactivePrompt, projectTrustRows, projectTrustView, projectUntrustedNote, uncertainView, type TrustArtifact } from "./strings.js";
 export { AT_CAP, AT_SKIP, AT_VISIBLE, atEmbed, atFilter, atPanelRows, atWindow, bandHeader, longestRun, type AtItem, type AtMatch } from "./at-picker.js";

package/dist/index.js

@@ -12,14 +12,14 @@ export { Body, Dock, CURSOR_MARKER } from "./compositor.js";
 // approval is pending (the shape authority is the committed preview).
 export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, 
 // TUI2-R2 ④: the pick payload — the panel slot's third occupant.
-PICK_MAX, modePickView, modelPickView, pickAffordance, pickBlockRows, pickLeadPlain, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, panelOptions, } from "./approval-panel.js";
+PICK_MAX, modePickView, modelPickView, namedPickView, pickAffordance, pickBlockRows, pickLeadPlain, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, panelOptions, } from "./approval-panel.js";
 export { Container, foldLine, foldWords, visibleWidth, SPINNER } from "./components.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, } from "./editor.js";
 export { bannerLines, COLOR_OFF, COLOR_ON, currentGround, setGround, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, toolTarget, truncateRow, } from "./lines.js";
 export { editFileDiff, truncateDiff, writeFileDiff } from "./diff.js";
 // KC2 §5: the status rows' formatters — the CLI keeps the state and the
 // repaint, the terminal layer owns what the row says.
-export { STATUS_GLYPHS, cacheHitPct, compactingStatus, composeRow, decodeRate, idleStatus, retrySegment, runningStatus } from "./status.js";
+export { STATUS_GLYPHS, cacheHitPct, compactingStatus, composeRow, decodeRate, idleStatus, retrySegment, runningStatus, tasksSegment } from "./status.js";
 // TUI2-R1 (E): /context's attribution rows — a pure function of the
 // counts the trace sidecar already records (the CLI reads, this renders).
 export { contextRows, contextUnavailableRows } from "./context-ledger.js";

package/dist/status.d.ts

@@ -117,7 +117,18 @@ export interface RetryOnRow {
  *  counts against, what failed, and how long until it is tried. Whole
  *  seconds, rounded UP, so the row never says 0s while still waiting. */
 export declare function retrySegment(r: RetryOnRow): string;
-export declare function runningStatus(glyph: string, since: number, outTokens: number | null, ctxRatio: number, tokPerSec?: number | null, W?: number, retry?: RetryOnRow | null): string;
+/** ADR-0058 (3e): the session's tasks, as the status rows count them. */
+export interface TaskCountsOnRow {
+    /** running or starting */
+    readonly running: number;
+    /** an outcome that cannot be known, not yet looked at in `/tasks` */
+    readonly unknown: number;
+}
+/** `● 2 tasks running · ◌ 1 unknown`, `◌ 1 task unknown` — or nothing.
+ *  An unknown task is never hidden behind the panel: it is the one that
+ *  needs the person most. */
+export declare function tasksSegment(c: TaskCountsOnRow | undefined): string;
+export declare function runningStatus(glyph: string, since: number, outTokens: number | null, ctxRatio: number, tokPerSec?: number | null, W?: number, retry?: RetryOnRow | null, tasks?: TaskCountsOnRow, detachable?: boolean): string;
 /**
  * The COMPACTING row (W18): the covered rounds, the pre-call token
  * estimate, and the elapsed seconds — all knowable before the one summary
@@ -185,7 +196,7 @@ export interface StatusMeter {
  * No `W` means no dropping, which is what the callers that do not know
  * their width should get: today's row, unchanged.
  */
-export declare function idleStatus(tier: string, model: string, ctxRatio: number, meter?: StatusMeter, W?: number, floorOff?: boolean): string;
+export declare function idleStatus(tier: string, model: string, ctxRatio: number, meter?: StatusMeter, W?: number, floorOff?: boolean, tasks?: TaskCountsOnRow): string;
 /** TUI2-R1 (E) — the cache hit rate the status row shows, from the usage
  *  the CLI already tracks. The denominator is the TOTAL the model was
  *  given (fresh + cacheRead), which is the E2 ruling's own: cacheRead

package/dist/status.js

@@ -118,7 +118,25 @@ export function retrySegment(r) {
     const head = `retrying ${r.attempt}/${r.maxRetries} · ${r.code}`;
     return r.remainingMs > 0 ? `${head} · ${Math.ceil(r.remainingMs / 1000)}s` : head;
 }
-export function runningStatus(glyph, since, outTokens, ctxRatio, tokPerSec = null, W, retry) {
+/** `● 2 tasks running · ◌ 1 unknown`, `◌ 1 task unknown` — or nothing.
+ *  An unknown task is never hidden behind the panel: it is the one that
+ *  needs the person most. */
+export function tasksSegment(c) {
+    if (c === undefined)
+        return "";
+    const n = (k, word) => `${k} ${word}${k === 1 ? "" : "s"}`;
+    if (c.running > 0 && c.unknown > 0)
+        return `● ${n(c.running, "task")} running · ◌ ${c.unknown} unknown`;
+    if (c.running > 0)
+        return `● ${n(c.running, "task")} running`;
+    if (c.unknown > 0)
+        return `◌ ${n(c.unknown, "task")} unknown`;
+    return "";
+}
+export function runningStatus(glyph, since, outTokens, ctxRatio, tokPerSec = null, W, retry, 
+// 3e: the session's tasks, and whether a running command can be moved
+// to the background now (the row teaches ctrl+b exactly then)
+tasks, detachable = false) {
     const out = outTokens !== null ? ` ↓ ${kUnit(outTokens)} tokens` : "";
     const seconds = Math.max(1, Math.round((Date.now() - since) / 1000));
     return composeRow(`${glyph} working ${elapsedLabel(seconds)}${out}`, [
@@ -132,7 +150,9 @@ export function runningStatus(glyph, since, outTokens, ctxRatio, tokPerSec = nul
         // honest rule spelled as a default — the recovery flow has no
         // per-call timing state, so its row says nothing rather than guessing.
         tokPerSec !== null ? { kind: "fact", text: `${tokPerSec} tok/s` } : null,
+        { kind: "fact", text: tasksSegment(tasks) },
         { kind: "hint", text: "esc stop" },
+        detachable ? { kind: "hint", text: "ctrl+b background" } : null,
         { kind: "hint", text: "alt+⏎ redirect" },
         { kind: "fact", text: ctxSegment(ctxRatio) },
     ], W);
@@ -229,12 +249,14 @@ function elideMiddle(text, max) {
  * No `W` means no dropping, which is what the callers that do not know
  * their width should get: today's row, unchanged.
  */
-export function idleStatus(tier, model, ctxRatio, meter, W, floorOff = false) {
+export function idleStatus(tier, model, ctxRatio, meter, W, floorOff = false, tasks) {
     return composeRow(`▸ ${tier}`, [
         // 0.40.0: the catastrophe floor is on by default and says nothing;
         // OFF is the state worth seeing, and a fact beside the tier it
         // changes the meaning of.
         floorOff ? { kind: "fact", text: "floor off" } : null,
+        // 3e: work still going on (or gone unknown) after the turn ended
+        { kind: "fact", text: tasksSegment(tasks) },
         { kind: "hint", text: "/mode to switch" },
         { kind: "label", text: model },
         meter?.cacheHitPct != null ? { kind: "fact", text: `CH ${Math.round(meter.cacheHitPct)}%` } : null,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui",
-	"version": "0.45.3",
+	"version": "0.46.1",
 	"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.45.3"
+		"@vincemakes/kiso-tui-cells": "0.46.1"
 	}
 }