@vincemakes/kiso-tui 0.12.0 → 0.13.0

package/dist/editor.d.ts

@@ -23,7 +23,7 @@
  */
 import { charWidth, displayWidth, widthOf } from "./width.js";
 export { charWidth, displayWidth, widthOf };
-import { type PanelState, type PanelVerdict, type PanelView, type SaferOption } from "./approval-panel.js";
+import { type PanelState, type PanelVerdict, type PanelView, type SaferAnswer } from "./approval-panel.js";
 import { type AtItem, type AtMatch } from "./at-picker.js";
 import { type SessionCardView, type SessionPickState } from "./session-picker.js";
 /**
@@ -128,7 +128,7 @@ export declare class Editor {
      *  (restored at close — commit AND cancel), the panel takes the
      *  keys and the input row's lead, the menu closes. */
     beginPanel(view: PanelView, onCommit: (v: PanelVerdict) => void, opts?: {
-        safer?: () => Promise<readonly SaferOption[] | null>;
+        safer?: () => Promise<SaferAnswer>;
     }): void;
     /** W21: cancel the panel — the SIGINT path's pair to beginPanel. */
     cancelPanel(): void;

package/dist/editor.js

@@ -26,7 +26,7 @@ import { charWidth, displayWidth, leadWidth, widthOf } from "./width.js";
 // authority) — re-exported so the editor's public surface is unchanged.
 export { charWidth, displayWidth, widthOf };
 import { palette } from "./render.js";
-import { PICK_MAX, panelOptions, SAFER_DEGRADED, } from "./approval-panel.js";
+import { PICK_MAX, panelOptions, saferDegradedNote, } from "./approval-panel.js";
 // KC3.5: the panel-slot dispatchers — the ask branch folded into the
 // W21 lead/rows, so this file keeps ONE panel and one key owner.
 import { askCommitCustom, askKey, askStart, panelLead } from "./ask-panel.js";
@@ -1360,10 +1360,19 @@ export class Editor {
      * human is standing in front of a paused run.
      *
      * Every failure — a throw, a null, an empty list, no provider bound
-     * at all — lands on the SAME honest line and puts back every original
-     * choice. There is deliberately no retry and no partial state: the
-     * alternative to "I could not get them" is either a lie or a spinner
-     * that never ends, and both are worse than the sentence.
+     * at all — lands on the SAME honest branch and puts back every
+     * original choice. There is deliberately no retry and no partial
+     * state: the alternative to "I could not get them" is either a lie or
+     * a spinner that never ends, and both are worse than the sentence.
+     *
+     * R3v2-F1: one of those failures can now name its cause, and the
+     * sentence says it. That is a widening of the COPY, not of the
+     * branch — there is still exactly one failure path, it still restores
+     * every original choice, and a provider that has nothing to add still
+     * resolves `null` and still gets the line it always got. A cause is
+     * only ever spoken when the caller could prove it; a diagnosis the
+     * product cannot prove would be worse than the unqualified line it
+     * replaced.
      *
      * The generation token is the guard against a late answer: a panel
      * the human escaped (or that a SIGINT cancelled) must not be
@@ -1378,13 +1387,18 @@ export class Editor {
         panel.note = null;
         this.#onRender();
         const token = ++this.#saferToken;
-        const settle = (options) => {
+        const settle = (answer) => {
             // the panel that asked must still be the panel on screen
             if (this.#panel !== panel || token !== this.#saferToken)
                 return;
+            // R3v2-F1: a non-list answer is a failure, and it may name its
+            // cause. Which sentence that earns is decided where the
+            // sentences live; here we only route to the same one branch
+            // every failure has always taken.
+            const options = Array.isArray(answer) ? answer : null;
             if (options === null || options.length === 0) {
                 panel.phase = "options";
-                panel.note = SAFER_DEGRADED;
+                panel.note = saferDegradedNote(answer);
                 panel.cursor = 0;
                 this.#onRender();
                 return;

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  * 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, modelPickView, pickAffordance, pickBlockRows, pickLeadPlain, type PickOption, type PickResult, type PickRuntime, type PickSpec, type PanelArgs, type PanelFlavor, type PanelPhase, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, 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, 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 { 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, 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 "./render.js";

package/dist/index.js

@@ -12,7 +12,7 @@ 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, modelPickView, pickAffordance, pickBlockRows, pickLeadPlain, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, panelOptions, } from "./approval-panel.js";
+PICK_MAX, modelPickView, 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, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, toolTarget, truncateRow, } from "./render.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-tui",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "kiso tui — 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.12.0"
+    "@vincemakes/kiso-tui-cells": "0.13.0"
   }
 }