@vincemakes/kiso-tui-cells 0.12.0 → 0.14.0

package/dist/approval-panel.d.ts

@@ -63,6 +63,44 @@ export interface SaferRuntime {
  *  all still there, which is the only thing they need to know to keep
  *  going. */
 export declare const SAFER_DEGRADED = "couldn't get safer options \u2014 the original choices stand";
+/**
+ * R3v2-F1 — the same sentence, for the one failure the reply's own text
+ * can PROVE.
+ *
+ * The unqualified line is true of every failure the ask has, which is
+ * exactly why it explains nothing when the cause was knowable. A reply
+ * the token budget cut in half is knowable: the JSON opens and never
+ * closes. So that case gets the cause in a parenthesis and keeps
+ * everything else — one line, dim, still leading with what is still
+ * true — because the human is mid-approval and the shape of the sentence
+ * is what they have already learned to read.
+ */
+export declare const SAFER_DEGRADED_TRUNCATED = "couldn't get safer options (the reply was cut short) \u2014 the original choices stand";
+/**
+ * R3v2-F1 — a failure that knows why it failed.
+ *
+ * `truncated` is the only cause the caller can demonstrate from the
+ * text, and it is deliberately the only member: a diagnosis the product
+ * cannot prove is worse than no diagnosis, so every other failure stays
+ * the unqualified line rather than growing a guess.
+ */
+export interface SaferFailure {
+    readonly reason: "truncated";
+}
+/**
+ * R3v2-F1 — what the safer-options provider hands back.
+ *
+ * A list is the answer. `null` is a failure with nothing to add, and is
+ * still the whole contract for any caller that has nothing to add — the
+ * widening is additive, so an existing provider's behaviour is
+ * byte-identical. A SaferFailure is a failure that can name its cause.
+ */
+export type SaferAnswer = readonly SaferOption[] | SaferFailure | null;
+/** R3v2-F1: the line a failed ask owes the human — the unqualified one,
+ *  unless the answer named a cause. The panel asks this instead of
+ *  reaching for a constant, so the choice of sentence lives with the
+ *  sentences. */
+export declare function saferDegradedNote(answer: SaferAnswer): string;
 /** The row that returns to state 1. Rendered last, always present — an
  *  alternatives list you cannot back out of would be a trap. */
 export declare const SAFER_BACK = "back to the original choices";

package/dist/approval-panel.js

@@ -35,6 +35,27 @@ import { escapeTerminal, palette } from "./render.js";
  *  all still there, which is the only thing they need to know to keep
  *  going. */
 export const SAFER_DEGRADED = "couldn't get safer options — the original choices stand";
+/**
+ * R3v2-F1 — the same sentence, for the one failure the reply's own text
+ * can PROVE.
+ *
+ * The unqualified line is true of every failure the ask has, which is
+ * exactly why it explains nothing when the cause was knowable. A reply
+ * the token budget cut in half is knowable: the JSON opens and never
+ * closes. So that case gets the cause in a parenthesis and keeps
+ * everything else — one line, dim, still leading with what is still
+ * true — because the human is mid-approval and the shape of the sentence
+ * is what they have already learned to read.
+ */
+export const SAFER_DEGRADED_TRUNCATED = "couldn't get safer options (the reply was cut short) — the original choices stand";
+/** R3v2-F1: the line a failed ask owes the human — the unqualified one,
+ *  unless the answer named a cause. The panel asks this instead of
+ *  reaching for a constant, so the choice of sentence lives with the
+ *  sentences. */
+export function saferDegradedNote(answer) {
+    const failure = answer === null || Array.isArray(answer) ? null : answer;
+    return failure?.reason === "truncated" ? SAFER_DEGRADED_TRUNCATED : SAFER_DEGRADED;
+}
 /** The row that returns to state 1. Rendered last, always present — an
  *  alternatives list you cannot back out of would be a trap. */
 export const SAFER_BACK = "back to the original choices";

package/dist/strings.d.ts

@@ -61,6 +61,14 @@ export declare function projectUntrustedNote(count: number, root: string): strin
  *  goes stale silently. The tool name is escaped for the dock-less
  *  fallback question because it reaches the terminal as raw text there;
  *  the panel's own rows are escaped by the panel renderer. */
+/**
+ * TV-1B — the verification offer (the thin task driver's one question):
+ * shown at a NORMAL settle when every item is claimed done and no
+ * passing check is fresh. The panel's simple flavor; bare-Enter
+ * approves, Esc dismisses. The fallback question serves a dock-less
+ * TTY; non-interactive paths never reach askPanel at all.
+ */
+export declare function verifyOfferView(): PanelView;
 export declare function uncertainView(name: string, executionId: string): PanelView;
 /**
  * KC3.5 — the SAME uncertainty gate, said honestly for an ask_user call.

package/dist/strings.js

@@ -72,6 +72,26 @@ export function projectUntrustedNote(count, root) {
  *  goes stale silently. The tool name is escaped for the dock-less
  *  fallback question because it reaches the terminal as raw text there;
  *  the panel's own rows are escaped by the panel renderer. */
+/**
+ * TV-1B — the verification offer (the thin task driver's one question):
+ * shown at a NORMAL settle when every item is claimed done and no
+ * passing check is fresh. The panel's simple flavor; bare-Enter
+ * approves, Esc dismisses. The fallback question serves a dock-less
+ * TTY; non-interactive paths never reach askPanel at all.
+ */
+export function verifyOfferView() {
+    return {
+        flavor: "simple",
+        name: "verification",
+        title: "finish the checklist?",
+        speaker: "kiso",
+        statusText: "\u25b8 run paused",
+        args: { kind: "text", lines: [] },
+        ruleOverride: "every item is marked done \u2014 run a check?",
+        simpleOptions: ["run a verification pass", "not now"],
+        fallbackQuestion: "run a verification pass? (y/n) ",
+    };
+}
 export function uncertainView(name, executionId) {
     return {
         flavor: "simple",

package/package.json

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