@deepseek-harness-tui/dsh-tui 0.11.2 → 0.13.0

package/lib/types/ink/sixel-codec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sixel-codec.d.ts","sourceRoot":"","sources":["../../../src/ink/sixel-codec.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAW9D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,GAAG,YAAY,CAAA;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAAG;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAA;CACjG;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AASD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,8EAA8E;AAC9E,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAEnF;AA2FD,qFAAqF;AACrF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,KAAK,CAAI;IAEX,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoBtF"}
+{"version":3,"file":"sixel-codec.d.ts","sourceRoot":"","sources":["../../../src/ink/sixel-codec.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAmB9D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAKhF;AAED;2CAC2C;AAC3C,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,GAAG,YAAY,CAAA;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAAG;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAA;CACjG;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AASD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,8EAA8E;AAC9E,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAEnF;AAkGD,qFAAqF;AACrF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,KAAK,CAAI;IAEX,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoBtF"}

package/lib/types/ink/sixel-codec.js

@@ -3,12 +3,39 @@ import { loadSharp } from '../dsh-adapter/sharp.js';
 import { isTerminalImageSource, TERMINAL_IMAGE_MAX_EDGE, TERMINAL_IMAGE_MAX_BYTES, TERMINAL_IMAGE_PREVIEW_MAX_EDGE, TERMINAL_IMAGE_PREVIEW_MAX_BYTES, SIXEL_MAX_ENCODED_BYTES, SIXEL_CACHE_BYTES, SIXEL_CACHE_ENTRIES } from './terminal-image.js';
 /**
  * Coverage a transparent raster needs before a pixel is painted. Sixel alpha
- * is binary and this encoder keeps only fully opaque pixels, so anti-aliased
- * edges would otherwise be dropped outright and thin every glyph stroke to a
- * hairline; promoting coverage keeps the artwork's visual weight. Biased
- * below 0.5 because formula strokes are thin to begin with.
+ * is binary, so this encoder promotes coverage to a hard mask — with an
+ * ordered dither for the intermediate band: coverage below 25% never paints,
+ * 62.5%+ always paints, and the band between checkers over a 2×2 Bayer matrix
+ * so the eye averages it into apparent translucency (soft anti-aliased edges
+ * instead of a hard 25% cutoff). Pure 1-bit sources (alpha only 0/255) get
+ * exactly the old single-threshold mask: 255 always painted, 0 never did.
  */
 const TRANSPARENT_COVERAGE_THRESHOLD = 64;
+/** 2×2 Bayer matrix (values 0..3) for ordered dithering of the coverage band. */
+const BAYER_2X2 = [[0, 2], [3, 1]];
+/** Dither band: thresholds 25% / 37.5% / 50% / 62.5% at the four matrix cells. */
+const DITHER_BASE = 0.25;
+const DITHER_STEP = 0.125;
+/**
+ * Paint decision for one transparent-raster pixel: 0.25·255 = 63.75 keeps the
+ * historical "below 25% never paints" bias, 160 (= 62.5%·255 + 1) makes
+ * everything above the band solid (≥75% always paints by contract), and the
+ * band between resolves by position so constant mid coverage alternates in a
+ * checkerboard. Exported for the mask regression (gradient/const fills).
+ */
+export function sixelCoveragePaints(alpha, x, y) {
+    if (alpha >= 160)
+        return true;
+    if (alpha < TRANSPARENT_COVERAGE_THRESHOLD)
+        return false;
+    const bayer = BAYER_2X2[y & 1][x & 1];
+    return alpha > (DITHER_BASE + bayer * DITHER_STEP) * 255;
+}
+/** The pre-dither decision (single 25% threshold), kept for the mask
+ * regression's before/after comparison. */
+export function sixelCoveragePaintsThreshold(alpha) {
+    return alpha >= TRANSPARENT_COVERAGE_THRESHOLD;
+}
 /** CPU-heavy work: called in the image worker, never in the frame painter. */
 export async function encodeSixel(request) {
     return encodeRegion(await prepareSixel(request), request.crop);
@@ -63,10 +90,17 @@ async function prepareSixel(request) {
     if (data.byteLength !== width * height * 4)
         throw new Error('Invalid quantized raster size');
     if (transparent) {
-        // Binary ink: anything below the coverage threshold becomes fully
-        // transparent, everything above becomes solid.
-        for (let index = 3; index < data.length; index += 4) {
-            data[index] = data[index] >= TRANSPARENT_COVERAGE_THRESHOLD ? 255 : 0;
+        // Binary ink with an ordered-dithered coverage band (see
+        // sixelCoveragePaints): <25% transparent, ≥62.5% solid, in between by
+        // 2×2 Bayer position. Only sources that actually carry intermediate
+        // alpha change their mask; pure 0/255 rasters are byte-identical to the
+        // old single-threshold promotion.
+        let index = 3;
+        for (let y = 0; y < height; y += 1) {
+            for (let x = 0; x < width; x += 1) {
+                data[index] = sixelCoveragePaints(data[index], x, y) ? 255 : 0;
+                index += 4;
+            }
         }
     }
     const palette = new Set();

package/lib/types/ink/terminal-querier.d.ts

@@ -28,6 +28,11 @@ export type TerminalQuery<T extends TerminalResponse = TerminalResponse> = {
     request: string;
     /** Recognizes the expected response in the inbound stream */
     match: (r: TerminalResponse) => r is T;
+    /** The response type this query can be answered by, declared separately
+     *  from `match` (a predicate cannot be introspected). The input parser
+     *  reads it through {@link TerminalQuerier.pendingResponseTypes} to bind
+     *  an ambiguous reply tail to the queries actually awaiting an answer. */
+    responseType: TerminalResponse['type'];
 };
 type DecrpmResponse = Extract<TerminalResponse, {
     type: 'decrpm';
@@ -139,6 +144,26 @@ export declare class TerminalQuerier {
     constructor(stdout: NodeJS.WriteStream, setRawMode?: ((enabled: boolean) => void) | undefined);
     /** Whether terminal query I/O is paused for an external process handoff. */
     get isSuspended(): boolean;
+    /**
+     * In-flight evidence for the input parser (read-only observation): true
+     * while at least one query or flush sentinel is still waiting for its
+     * reply. Purely observational — queue semantics are untouched.
+     */
+    get hasPending(): boolean;
+    /**
+     * In-flight evidence for the input parser (read-only observation): the
+     * response types of the queries still awaiting a reply, plus `da1` when a
+     * flush() sentinel is still open (DA1 is the reply that resolves it).
+     *
+     * This is bound to the query lifecycle on purpose. A boolean "something
+     * was sent recently" lets any recent query authorize a claim for bytes
+     * that may belong to no query at all, so the parser receives the expected
+     * types instead: a reply tail is only claimed when its shape can complete
+     * into one of them, and a query resolved by a sentinel stops counting the
+     * moment its promise settles. Purely observational — queue semantics are
+     * untouched.
+     */
+    get pendingResponseTypes(): ReadonlySet<TerminalResponse['type']>;
     private holdRawMode;
     /**
      * Send a query and wait for its response.

package/lib/types/ink/terminal-querier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-querier.d.ts","sourceRoot":"","sources":["../../../src/ink/terminal-querier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"terminal-querier.d.ts","sourceRoot":"","sources":["../../../src/ink/terminal-querier.ts"],"names":[],"mappings":"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"}

package/lib/types/ink/terminal-querier.js

@@ -32,6 +32,7 @@ export function decrqm(mode) {
     return {
         request: csi(`?${mode}$p`),
         match: (r) => r.type === 'decrpm' && r.mode === mode,
+        responseType: 'decrpm',
     };
 }
 /**
@@ -44,6 +45,7 @@ export function da1() {
     return {
         request: csi('c'),
         match: (r) => r.type === 'da1',
+        responseType: 'da1',
     };
 }
 /**
@@ -54,6 +56,7 @@ export function da2() {
     return {
         request: csi('>c'),
         match: (r) => r.type === 'da2',
+        responseType: 'da2',
     };
 }
 /**
@@ -65,6 +68,7 @@ export function kittyKeyboard() {
     return {
         request: csi('?u'),
         match: (r) => r.type === 'kittyKeyboard',
+        responseType: 'kittyKeyboard',
     };
 }
 /**
@@ -78,6 +82,7 @@ export function kittyGraphics(imageId) {
         // same direct-data + compression path used by real renderer uploads.
         request: `\u001b_Gi=${id},s=1,v=1,a=q,t=d,f=32,o=z;eAFjYGBgAAAABAAB\u001b\\`,
         match: (r) => r.type === 'kittyGraphics' && r.imageId === id,
+        responseType: 'kittyGraphics',
     };
 }
 /** XTWINOPS: query the physical pixel dimensions of one terminal cell. */
@@ -85,6 +90,7 @@ export function terminalCellSizePixels() {
     return {
         request: csi('16t'),
         match: (r) => r.type === 'terminalPixelSize' && r.scope === 'cell',
+        responseType: 'terminalPixelSize',
     };
 }
 /** XTWINOPS: query the terminal text area's physical pixel dimensions. */
@@ -92,6 +98,7 @@ export function terminalWindowSizePixels() {
     return {
         request: csi('14t'),
         match: (r) => r.type === 'terminalPixelSize' && r.scope === 'window',
+        responseType: 'terminalPixelSize',
     };
 }
 /**
@@ -105,6 +112,7 @@ export function cursorPosition() {
     return {
         request: csi('?6n'),
         match: (r) => r.type === 'cursorPosition',
+        responseType: 'cursorPosition',
     };
 }
 /**
@@ -117,6 +125,7 @@ export function oscColor(code) {
     return {
         request: osc(code, '?'),
         match: (r) => r.type === 'osc' && r.code === code,
+        responseType: 'osc',
     };
 }
 /**
@@ -131,6 +140,7 @@ export function xtversion() {
     return {
         request: csi('>0q'),
         match: (r) => r.type === 'xtversion',
+        responseType: 'xtversion',
     };
 }
 // -- Querier --
@@ -166,6 +176,37 @@ export class TerminalQuerier {
     get isSuspended() {
         return this.suspended;
     }
+    /**
+     * In-flight evidence for the input parser (read-only observation): true
+     * while at least one query or flush sentinel is still waiting for its
+     * reply. Purely observational — queue semantics are untouched.
+     */
+    get hasPending() {
+        return this.queue.length > 0;
+    }
+    /**
+     * In-flight evidence for the input parser (read-only observation): the
+     * response types of the queries still awaiting a reply, plus `da1` when a
+     * flush() sentinel is still open (DA1 is the reply that resolves it).
+     *
+     * This is bound to the query lifecycle on purpose. A boolean "something
+     * was sent recently" lets any recent query authorize a claim for bytes
+     * that may belong to no query at all, so the parser receives the expected
+     * types instead: a reply tail is only claimed when its shape can complete
+     * into one of them, and a query resolved by a sentinel stops counting the
+     * moment its promise settles. Purely observational — queue semantics are
+     * untouched.
+     */
+    get pendingResponseTypes() {
+        const types = new Set();
+        for (const pending of this.queue) {
+            if (pending.kind === 'query')
+                types.add(pending.responseType);
+            else
+                types.add('da1');
+        }
+        return types;
+    }
     holdRawMode() {
         this.setRawMode?.(true);
         return () => this.setRawMode?.(false);
@@ -190,6 +231,7 @@ export class TerminalQuerier {
             this.queue.push({
                 kind: 'query',
                 match: query.match,
+                responseType: query.responseType,
                 resolve: r => resolve(r),
                 releaseRawMode: this.holdRawMode(),
             });

package/lib/types/ink/update-overflow-guard.d.ts

@@ -58,5 +58,29 @@ export declare function swallowNestedUpdateOverflow(error: unknown, source: stri
  * @param onChange - The subscriber callback about to run.
  */
 export declare function callWithUpdateOverflowGuard(source: string, onChange: () => void): void;
+/**
+ * Origin of a process-level fatal error, as reported to the sink.
+ */
+export type ProcessGuardOrigin = 'uncaughtException' | 'unhandledRejection';
+/**
+ * Fatal-error sink installed by the process owner (the dsh-tui runtime, which
+ * routes it into the TUI's single exit funnel). Returning true means the sink
+ * took ownership of the process — it runs the teardown (resume marker,
+ * terminal restore, `dsh-tui crashed: …`) and exits non-zero. Returning false
+ * leaves the error to Node's default crash, which keeps "fail loud, non-zero"
+ * true when no sink is registered or the tree is being torn down.
+ */
+export type ProcessGuardFatalSink = (error: unknown, origin: ProcessGuardOrigin) => boolean;
+/** Register (or clear, with undefined) the fatal-error sink. */
+export declare function registerProcessGuardFatalSink(sink: ProcessGuardFatalSink | undefined): void;
+/**
+ * Normalize the reason handed to a fatal sink so the exit funnel can never
+ * mistake a fatal error for a clean user exit. `Promise.reject()` and
+ * `throw undefined` deliver `undefined`, and the funnel selects its crash path
+ * with `error !== undefined` — passing the raw reason through would run the
+ * zero-exit path while the sink reported that it owned the process. Defined
+ * reasons (including non-Error values) are returned unchanged.
+ */
+export declare function fatalReasonForExit(error: unknown, origin: ProcessGuardOrigin): unknown;
 export declare function installNestedUpdateOverflowProcessGuard(): void;
 //# sourceMappingURL=update-overflow-guard.d.ts.map

package/lib/types/ink/update-overflow-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-overflow-guard.d.ts","sourceRoot":"","sources":["../../../src/ink/update-overflow-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAoBH,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;AAOjD,+CAA+C;AAC/C,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAEnF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAmDnF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAOtF;AAeD,wBAAgB,uCAAuC,IAAI,IAAI,CAc9D"}
+{"version":3,"file":"update-overflow-guard.d.ts","sourceRoot":"","sources":["../../../src/ink/update-overflow-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAoBH,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;AAOjD,+CAA+C;AAC/C,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAEnF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAmDnF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAOtF;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,oBAAoB,CAAA;AAE3E;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAA;AAG3F,gEAAgE;AAChE,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,qBAAqB,GAAG,SAAS,GAAG,IAAI,CAE3F;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAEtF;AAiBD,wBAAgB,uCAAuC,IAAI,IAAI,CAgB9D"}

package/lib/types/ink/update-overflow-guard.js

@@ -130,6 +130,22 @@ export function callWithUpdateOverflowGuard(source, onChange) {
         throw error;
     }
 }
+let fatalSink;
+/** Register (or clear, with undefined) the fatal-error sink. */
+export function registerProcessGuardFatalSink(sink) {
+    fatalSink = sink;
+}
+/**
+ * Normalize the reason handed to a fatal sink so the exit funnel can never
+ * mistake a fatal error for a clean user exit. `Promise.reject()` and
+ * `throw undefined` deliver `undefined`, and the funnel selects its crash path
+ * with `error !== undefined` — passing the raw reason through would run the
+ * zero-exit path while the sink reported that it owned the process. Defined
+ * reasons (including non-Error values) are returned unchanged.
+ */
+export function fatalReasonForExit(error, origin) {
+    return error === undefined ? new Error(`${origin} with undefined reason`) : error;
+}
 /**
  * Process-level backstop for the overflow error. The hotspot guards above
  * cover the known enqueue sites (clock tick, reveal tick, channel emit,
@@ -138,9 +154,11 @@ export function callWithUpdateOverflowGuard(source, onChange) {
  * feeder, a future timer, a plugin's store) would still kill the process.
  * This installs uncaughtException/unhandledRejection handlers that absorb
  * exactly the overflow error class (same self-healing contract: React
- * already reset the counter before throwing) and rethrow everything else
- * unchanged. Idempotent; opt out with DSH_TUI_NO_185_PROCESS_GUARD=1 when a
- * host owns process error policy.
+ * already reset the counter before throwing) and hand everything else to the
+ * registered fatal sink — or rethrow it unchanged when there is none, so the
+ * process still fails loud with a non-zero exit rather than continuing in an
+ * unknown state. Idempotent; opt out with DSH_TUI_NO_185_PROCESS_GUARD=1 when
+ * a host owns process error policy.
  */
 let processGuardInstalled = false;
 export function installNestedUpdateOverflowProcessGuard() {
@@ -152,6 +170,8 @@ export function installNestedUpdateOverflowProcessGuard() {
     process.on('uncaughtException', error => {
         if (swallowNestedUpdateOverflow(error, 'process.uncaught'))
             return;
+        if (fatalSink?.(error, 'uncaughtException') === true)
+            return;
         // Unknown errors keep Node's default semantics: rethrowing from a
         // listener crashes the process with the original error.
         throw error;
@@ -159,6 +179,8 @@ export function installNestedUpdateOverflowProcessGuard() {
     process.on('unhandledRejection', error => {
         if (swallowNestedUpdateOverflow(error, 'process.rejection'))
             return;
+        if (fatalSink?.(error, 'unhandledRejection') === true)
+            return;
         throw error;
     });
 }

package/lib/types/math/renderer.d.ts

@@ -47,6 +47,8 @@ export declare const mathRenderStats: {
     rasterHits: number;
     rasterMisses: number;
 };
+/** Formula renders still running (tests wait for 0 before reading the screen). */
+export declare function mathRendersInFlight(): number;
 /**
  * The settled result for this request if one is cached, without rendering.
  * Lets a remounted view (scrolled back into the viewport) paint its image on

package/lib/types/math/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/math/renderer.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAA;AAGjC,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,OAAO,CAAA;AASrC,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,gBAAgB,GAChB,WAAW,GACX,oBAAoB,GACpB,WAAW,GACX,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,qBAAqB,CAAA;AAEzB,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACrH;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAA;AAgE7D,kDAAkD;AAClD,eAAO,MAAM,eAAe;;;;;CAAqE,CAAA;AA+IjG;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,SAAS,CAIvF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyBtF;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/math/renderer.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAA;AAGjC,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,OAAO,CAAA;AASrC,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,gBAAgB,GAChB,WAAW,GACX,oBAAoB,GACpB,WAAW,GACX,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,qBAAqB,CAAA;AAEzB,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACrH;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAA;AAgE7D,kDAAkD;AAClD,eAAO,MAAM,eAAe;;;;;CAAqE,CAAA;AAEjG,kFAAkF;AAClF,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AA+ID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,SAAS,CAIvF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyBtF;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C"}

package/lib/types/math/renderer.js

@@ -59,6 +59,10 @@ const rasters = new WeightedLru(128, 64 * 1024 * 1024, value => value.ok ? value
 const inflight = new Map();
 /** Cache counters, for tests and debug output. */
 export const mathRenderStats = { vectorHits: 0, vectorMisses: 0, rasterHits: 0, rasterMisses: 0 };
+/** Formula renders still running (tests wait for 0 before reading the screen). */
+export function mathRendersInFlight() {
+    return inflight.size;
+}
 let converter;
 function loadConverter() {
     converter ??= import('@dsh-tui-vendor/mathjax-tex-svg')

package/lib/types/minimalUiMode.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Minimal UI: one process-wide flag gating decorative UI (header splash,
+ * emoji status glyphs, non-tool text colors, status-bar extras). The flag is
+ * owned by the channel (settings key `dsh-tui.minimal`, applied live through
+ * scope.watch); leaf components read it here instead of threading a prop
+ * through four render layers. Code highlighting and tool-name colors are
+ * deliberately NOT gated — the minimal UI keeps those.
+ *
+ * This is the INTERFACE switch only. It is unrelated to the kernel's agent
+ * preset `minimal` (极简模式 / "Minimal"), which changes the model-facing
+ * world (a single persistent-shell tool — bash on POSIX, pwsh on Windows —
+ * with no compaction, no plan mode and no runtime context). Renamed from
+ * `minimalMode` so the two concepts cannot be read as one.
+ */
+/** True when the minimal UI is active (settings key `dsh-tui.minimal`). */
+export declare function isMinimalUiMode(): boolean;
+/** @internal channel-owned setter; also called once at boot. */
+export declare function setMinimalUiMode(enabled: boolean): void;
+//# sourceMappingURL=minimalUiMode.d.ts.map

package/lib/types/minimalUiMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimalUiMode.d.ts","sourceRoot":"","sources":["../../src/minimalUiMode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEvD"}

package/lib/types/minimalUiMode.js

@@ -0,0 +1,23 @@
+/**
+ * Minimal UI: one process-wide flag gating decorative UI (header splash,
+ * emoji status glyphs, non-tool text colors, status-bar extras). The flag is
+ * owned by the channel (settings key `dsh-tui.minimal`, applied live through
+ * scope.watch); leaf components read it here instead of threading a prop
+ * through four render layers. Code highlighting and tool-name colors are
+ * deliberately NOT gated — the minimal UI keeps those.
+ *
+ * This is the INTERFACE switch only. It is unrelated to the kernel's agent
+ * preset `minimal` (极简模式 / "Minimal"), which changes the model-facing
+ * world (a single persistent-shell tool — bash on POSIX, pwsh on Windows —
+ * with no compaction, no plan mode and no runtime context). Renamed from
+ * `minimalMode` so the two concepts cannot be read as one.
+ */
+let minimalUi = false;
+/** True when the minimal UI is active (settings key `dsh-tui.minimal`). */
+export function isMinimalUiMode() {
+    return minimalUi;
+}
+/** @internal channel-owned setter; also called once at boot. */
+export function setMinimalUiMode(enabled) {
+    minimalUi = enabled;
+}

package/lib/types/oauth.d.ts

@@ -1,15 +1,10 @@
 /**
- * Re-export of the `@deepseek-harness-tui/dsh-auth` plugin under this
- * package's own name, so the bundle patch layer can mount the OAuth row as
- * `@deepseek-harness-tui/dsh-tui/oauth` instead of the bare package name —
- * the same anchor the working-activity row uses (#60): the dsh Loader
- * resolves row names from the *profile* directory, where only the profile's
- * direct dependencies are linked, and pnpm's isolated layout never hoists a
- * transitive dependency there. Mounting through this subpath keeps plugin
- * resolution anchored at @deepseek-harness-tui/dsh-tui itself, always a
- * direct profile dependency, under every package-manager layout.
+ * Public entry for the built-in OAuth Cordis module. The bundle patch keeps
+ * mounting this subpath so existing profile overrides and loader ordering
+ * remain compatible after the former dsh-auth package was folded into the
+ * TUI's adapter tree.
  *
  * @module @deepseek-harness-tui/dsh-tui/oauth
  */
-export * from '@deepseek-harness-tui/dsh-auth';
+export * from './dsh-adapter/oauth/index.js';
 //# sourceMappingURL=oauth.d.ts.map

package/lib/types/oauth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,gCAAgC,CAAA"}
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,8BAA8B,CAAA"}

package/lib/types/oauth.js

@@ -1,14 +1,9 @@
 /**
- * Re-export of the `@deepseek-harness-tui/dsh-auth` plugin under this
- * package's own name, so the bundle patch layer can mount the OAuth row as
- * `@deepseek-harness-tui/dsh-tui/oauth` instead of the bare package name —
- * the same anchor the working-activity row uses (#60): the dsh Loader
- * resolves row names from the *profile* directory, where only the profile's
- * direct dependencies are linked, and pnpm's isolated layout never hoists a
- * transitive dependency there. Mounting through this subpath keeps plugin
- * resolution anchored at @deepseek-harness-tui/dsh-tui itself, always a
- * direct profile dependency, under every package-manager layout.
+ * Public entry for the built-in OAuth Cordis module. The bundle patch keeps
+ * mounting this subpath so existing profile overrides and loader ordering
+ * remain compatible after the former dsh-auth package was folded into the
+ * TUI's adapter tree.
  *
  * @module @deepseek-harness-tui/dsh-tui/oauth
  */
-export * from '@deepseek-harness-tui/dsh-auth';
+export * from './dsh-adapter/oauth/index.js';

package/lib/types/onboardingPrefs.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The wizard revision this build writes. Bump it when a step is ADDED (not
+ * when copy changes): installs completed at an older revision become
+ * eligible again, which is the point — a new domain is worth one more pass.
+ */
+export declare const ONBOARDING_VERSION = 1;
+/** Persisted first-run state. */
+export interface OnboardingPrefs {
+    /** True once the wizard ran to completion on this installation. */
+    completed: boolean;
+    /** The wizard revision that was completed (0 when an older build did not stamp one). */
+    version: number;
+}
+/** Not-done-yet, the answer for every unreadable file. */
+export declare const ONBOARDING_UNSEEN: OnboardingPrefs;
+/**
+ * Parse a persisted onboarding record. Pure, so the shape rules are testable
+ * without a filesystem: anything that is not an object with a literal
+ * `completed: true` reads as unseen.
+ *
+ * @param text - Raw file contents.
+ * @returns The normalized record.
+ */
+export declare function parseOnboardingPrefs(text: string): OnboardingPrefs;
+/**
+ * Read the persisted onboarding state.
+ *
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns The normalized record; unseen when the file is absent or unreadable.
+ */
+export declare function readOnboardingPrefs(dir?: string): OnboardingPrefs;
+/**
+ * Record that the wizard completed (best effort).
+ *
+ * @param version - The wizard revision being stamped.
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns True when the record was durably written; false when the data
+ *   directory is not writable. The caller stays silent either way — the
+ *   preference is a convenience, not a promise.
+ */
+export declare function markOnboardingDone(version?: number, dir?: string): boolean;
+/**
+ * Whether this install should be offered the wizard on an ordinary launch.
+ *
+ * The single place the "should it fire" question is answered, so the host
+ * boot decision and any future `/setup` entry point cannot drift apart.
+ *
+ * @param prefs - The record read at boot (or a fixture in a test).
+ * @returns True when the wizard has never been completed at this revision.
+ */
+export declare function shouldOfferOnboarding(prefs?: OnboardingPrefs): boolean;
+//# sourceMappingURL=onboardingPrefs.d.ts.map

package/lib/types/onboardingPrefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboardingPrefs.d.ts","sourceRoot":"","sources":["../../src/onboardingPrefs.ts"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAA;IAClB,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,EAAE,eAAkD,CAAA;AAElF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAYlE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAiB,GAAG,eAAe,CAM3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAA2B,EAAE,GAAG,GAAE,MAAiB,GAAG,OAAO,CAYxG;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,eAAuC,GAAG,OAAO,CAE7F"}

package/lib/types/onboardingPrefs.js

@@ -0,0 +1,107 @@
+/**
+ * First-run onboarding state, at `~/.dsh-tui/onboarding.json`.
+ *
+ * Deliberately NOT a cordis config value: "has this installation already
+ * walked the user through setup" is per-machine UI state, like the lang and
+ * home preferences next to it — not a deployment choice a cordis.yml row
+ * should own. A repo-wide pinned config would make the wizard either always
+ * fire or never fire, and neither is what "first run" means.
+ *
+ * Two fields, and the split matters:
+ *
+ *   - `completed` — the user reached the end and pressed 完成. Written on the
+ *     way OUT, never at boot: a process that dies before the first frame
+ *     (a config error, a crash during render) must not burn the
+ *     installation's only first run. Same rule as homePrefs' `seen`.
+ *   - `version` — the wizard revision that was completed. A future wizard
+ *     that adds a step can re-fire on installs sitting on an older revision
+ *     without needing a second file. Absent/0 means "completed by a build
+ *     that did not stamp one", which the caller reads as "completing, but
+ *     worth re-offering if it ever grows a new step".
+ *
+ * Best effort, like every other pref here: a missing, unreadable or corrupt
+ * file simply means "not done yet". The worst outcome of a broken pref file
+ * is one extra wizard — recoverable with a single Esc.
+ *
+ * @module @deepseek-harness-tui/dsh-tui/onboardingPrefs
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { DATA_DIR } from './utils/paths.js';
+const FILE = 'onboarding.json';
+/**
+ * The wizard revision this build writes. Bump it when a step is ADDED (not
+ * when copy changes): installs completed at an older revision become
+ * eligible again, which is the point — a new domain is worth one more pass.
+ */
+export const ONBOARDING_VERSION = 1;
+/** Not-done-yet, the answer for every unreadable file. */
+export const ONBOARDING_UNSEEN = { completed: false, version: 0 };
+/**
+ * Parse a persisted onboarding record. Pure, so the shape rules are testable
+ * without a filesystem: anything that is not an object with a literal
+ * `completed: true` reads as unseen.
+ *
+ * @param text - Raw file contents.
+ * @returns The normalized record.
+ */
+export function parseOnboardingPrefs(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+            return ONBOARDING_UNSEEN;
+        const raw = parsed;
+        const version = typeof raw.version === 'number' && Number.isFinite(raw.version) && raw.version > 0
+            ? Math.floor(raw.version)
+            : 0;
+        return { completed: raw.completed === true, version };
+    }
+    catch {
+        return ONBOARDING_UNSEEN;
+    }
+}
+/**
+ * Read the persisted onboarding state.
+ *
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns The normalized record; unseen when the file is absent or unreadable.
+ */
+export function readOnboardingPrefs(dir = DATA_DIR) {
+    try {
+        return parseOnboardingPrefs(readFileSync(join(dir, FILE), 'utf8'));
+    }
+    catch {
+        return ONBOARDING_UNSEEN;
+    }
+}
+/**
+ * Record that the wizard completed (best effort).
+ *
+ * @param version - The wizard revision being stamped.
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns True when the record was durably written; false when the data
+ *   directory is not writable. The caller stays silent either way — the
+ *   preference is a convenience, not a promise.
+ */
+export function markOnboardingDone(version = ONBOARDING_VERSION, dir = DATA_DIR) {
+    try {
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, FILE), `${JSON.stringify({ completed: true, version }, null, 2)}\n`, 'utf8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Whether this install should be offered the wizard on an ordinary launch.
+ *
+ * The single place the "should it fire" question is answered, so the host
+ * boot decision and any future `/setup` entry point cannot drift apart.
+ *
+ * @param prefs - The record read at boot (or a fixture in a test).
+ * @returns True when the wizard has never been completed at this revision.
+ */
+export function shouldOfferOnboarding(prefs = readOnboardingPrefs()) {
+    return !prefs.completed || prefs.version < ONBOARDING_VERSION;
+}