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

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/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/screens/Chat.d.ts

@@ -8,9 +8,10 @@ import type { TuiShortcutHost } from '../dsh-adapter/shortcuts.js';
 import type { TuiThemeHost } from '../dsh-adapter/themes.js';
 import { ApprovalStore } from '../dsh-adapter/approvals.js';
 import { type StarAttempt } from '../components/StarPrompt.js';
+import type { WhaleCouponStore } from '../dsh-adapter/oauth/bonus.js';
 import { type PromptController } from '../components/PromptInput.js';
 import type { InjectController } from '../dsh-adapter/inject-channel.js';
-export declare function Chat({ channel, questionStore, approvalStore, extensionDialogs, extensionStatus, activityStore, extensionShortcuts, themeHost, onExit, onUpdate, onRestart, fullscreen, trajectorySeen: trajectorySeenProp, injectControllerRef, promptControllerRef: promptControllerRefProp, renderScene, openHomeOnBoot, starPrompt, }: {
+export declare function Chat({ channel, questionStore, approvalStore, extensionDialogs, bonusNotices, extensionStatus, activityStore, extensionShortcuts, themeHost, onExit, onUpdate, onRestart, fullscreen, trajectorySeen: trajectorySeenProp, injectControllerRef, promptControllerRef: promptControllerRefProp, renderScene, openHomeOnBoot, starPrompt, }: {
     channel: Channel;
     renderScene?: (id: string, channel: Channel) => React.ReactNode;
     questionStore: QuestionStore;
@@ -26,6 +27,8 @@ export declare function Chat({ channel, questionStore, approvalStore, extensionD
      * park unanswered (their `timeoutMs` is the plugin's guard).
      */
     extensionDialogs?: TuiDialogStore;
+    /** Server-confirmed login bonuses awaiting presentation in the TUI. */
+    bonusNotices?: WhaleCouponStore;
     /** Plugin text and bounded rich status contributions. */
     extensionStatus?: TuiStatusStore;
     /** Session-scoped activity values published by the working-activity plugin. */

package/lib/types/screens/Chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/screens/Chat.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AA2BzB,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAwB,MAAM,0BAA0B,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAe,MAAM,kCAAkC,CAAA;AAW7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAa3D,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAQ1E,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AA4NxE,wBAAgB,IAAI,CAAC,EACnB,OAAO,EACP,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,MAAM,EACN,QAAQ,EACR,SAAS,EACT,UAAkB,EAClB,cAAc,EAAE,kBAAkB,EAClC,mBAAmB,EACnB,mBAAmB,EAAE,uBAAuB,EAC5C,WAAW,EACX,cAAc,EACd,UAAU,GACX,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAA;IAC/D,aAAa,EAAE,aAAa,CAAA;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,cAAc,CAAA;IACjC,yDAAyD;IACzD,eAAe,CAAC,EAAE,cAAc,CAAA;IAChC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,eAAe,CAAA;IACpC,uEAAuE;IACvE,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAC9D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IAC5G;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CAC/D,4BAkvJA"}
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/screens/Chat.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AA2BzB,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAwB,MAAM,0BAA0B,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAe,MAAM,kCAAkC,CAAA;AAW7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAa3D,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAQrE,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AA8NxE,wBAAgB,IAAI,CAAC,EACnB,OAAO,EACP,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,MAAM,EACN,QAAQ,EACR,SAAS,EACT,UAAkB,EAClB,cAAc,EAAE,kBAAkB,EAClC,mBAAmB,EACnB,mBAAmB,EAAE,uBAAuB,EAC5C,WAAW,EACX,cAAc,EACd,UAAU,GACX,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAA;IAC/D,aAAa,EAAE,aAAa,CAAA;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,cAAc,CAAA;IACjC,uEAAuE;IACvE,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,yDAAyD;IACzD,eAAe,CAAC,EAAE,cAAc,CAAA;IAChC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,eAAe,CAAA;IACpC,uEAAuE;IACvE,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAC9D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IAC5G;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CAC/D,4BAywJA"}

package/lib/types/screens/Chat.js

@@ -43,7 +43,7 @@ import { useSelection } from '../ink/hooks/use-selection.js';
 import { NoSelect } from '../ink/components/NoSelect.js';
 import { LogoHeader, MessageList } from '../components/MessageList.js';
 import { splashFontIdOf } from '../components/splashFonts.js';
-import { StarPrompt } from '../components/StarPrompt.js';
+import { StarPrompt, WhaleCouponPrompt } from '../components/StarPrompt.js';
 import { dueStarModal, markStarAsked, STAR_MILESTONES } from '../usageStats.js';
 import { TimelineRail } from '../components/TimelineRail.js';
 import { ScrollbarGutter } from '../components/ScrollbarGutter.js';
@@ -223,12 +223,14 @@ let fallbackDialogStore;
 let fallbackStatusStore;
 /** Standalone mounts (tests, bare embeds) without the composition root's store. */
 let fallbackActivityStore;
+const noCouponSubscription = () => () => undefined;
+const noCouponSnapshot = () => null;
 /** Identity of one caret-preview dismissal: the token (its title) on the
  *  image, so the same image staged twice is dismissed per token. */
 function peekKey(image, title) {
     return `${title ?? ''} ${image.id}`;
 }
-export function Chat({ channel, questionStore, approvalStore, extensionDialogs, extensionStatus, activityStore, extensionShortcuts, themeHost, onExit, onUpdate, onRestart, fullscreen = false, trajectorySeen: trajectorySeenProp, injectControllerRef, promptControllerRef: promptControllerRefProp, renderScene, openHomeOnBoot, starPrompt, }) {
+export function Chat({ channel, questionStore, approvalStore, extensionDialogs, bonusNotices, extensionStatus, activityStore, extensionShortcuts, themeHost, onExit, onUpdate, onRestart, fullscreen = false, trajectorySeen: trajectorySeenProp, injectControllerRef, promptControllerRef: promptControllerRefProp, renderScene, openHomeOnBoot, starPrompt, }) {
     const writeRaw = React.useContext(TerminalWriteContext);
     // Re-render whenever the channel mutates; rows/status are read fresh below.
     // DEFAULT lane on purpose (useExternalVersion): the channel version bumps
@@ -258,6 +260,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // extensions row share one inert store that never holds a dialog.
     const dialogs = extensionDialogs ?? (fallbackDialogStore ??= new TuiDialogStore());
     const dialogSnapshot = React.useSyncExternalStore(listener => dialogs.subscribe(listener), () => dialogs.getSnapshot());
+    const coupon = React.useSyncExternalStore(bonusNotices?.subscribe ?? noCouponSubscription, bonusNotices?.getSnapshot ?? noCouponSnapshot);
     // Plugin status contributions: text keys join into one line; bounded rich
     // views keep their own rows immediately above the prompt.
     const statusContributions = extensionStatus ?? (fallbackStatusStore ??= new TuiStatusStore());
@@ -2415,7 +2418,9 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                                 ...oauth.map(row => t('login-oauth-row', {
                                     provider: row.provider,
                                     state: row.signedIn
-                                        ? t('login-oauth-in', { time: new Date(row.expiresAt ?? 0).toISOString() })
+                                        ? row.expiresAt === undefined
+                                            ? t('login-oauth-in-no-expiry')
+                                            : t('login-oauth-in', { time: new Date(row.expiresAt).toISOString() })
                                         : row.expired
                                             ? t('login-oauth-expired')
                                             : t('login-oauth-signed-out'),
@@ -3014,11 +3019,23 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     }, []);
     /** Deduplicate terminals that report one Enter as parsed Return then raw CR/LF. */
     const lastModalEnterAtRef = React.useRef(0);
+    const couponVisible = coupon !== null && starModal === null
+        && approvalSnapshot === null && dialogSnapshot === null && questionSnapshot === null
+        && overlay.kind === 'none' && btw === null && recap === null
+        && !supervisorOpen && !treeOpen && !settingsOpen && !jobsPanelOpen
+        && !sceneOpen && !subagentDashboardOpen && subagentDetailId === null;
+    const markCouponShown = React.useCallback((orderId) => {
+        bonusNotices?.shown(orderId);
+    }, [bonusNotices]);
+    const closeCoupon = React.useCallback(() => {
+        if (coupon !== null)
+            bonusNotices?.dismiss(coupon.orderId);
+    }, [bonusNotices, coupon]);
     useInput((input, key, event) => {
         // 开屏"求 star"弹窗开着时键盘全归它（↑/↓/Enter/Esc 由它自己的
         // useInput 处理），滚轮也不许滚动它身后的转录——和下面的整屏界面
         // 同一套让位规则。
-        if (starModal !== null)
+        if (starModal !== null || couponVisible)
             return;
         // Prompt-slot panels own the keyboard while visible. Their own useInput
         // handles the relevant keys; Chat registered first, so yielding here
@@ -4030,7 +4047,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // Who owns the spinner slot: with the working-activity line on, that slot
     // draws the user's `/activity` preset, so the compaction row borrows the same
     // indicator instead of answering with the classic dot.
-    const activitySlot = channel.activityEnabled && !channel.minimal;
+    const activitySlot = channel.activityEnabled && !channel.minimalUi;
     // An automatic compaction runs INSIDE the turn, so it rides whichever spinner
     // the slot shows as a badge instead of a second row (the spinner's timer is
     // the turn's, not the compaction's).
@@ -4235,7 +4252,8 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         || (recap !== null && (!recap.auto || recap.expanded))
         || btw !== null
         || questionPanelNode !== null
-        || starModal !== null;
+        || starModal !== null
+        || couponVisible;
     // The trajectory scene replaces the conversation for as long as it is open.
     // Rendering it INSTEAD of (not above) the transcript is what makes it a
     // screen rather than an overlay: it owns the full viewport, and the
@@ -4392,6 +4410,8 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                                         band: wakeBand,
                                         hint: trajectorySeen ? undefined : primaryComboString('trajectory'),
                                         tick: Math.floor(wakeTime / 120),
+                                        onOpen: openScene,
+                                        hoverHint: primaryComboString('trajectory'),
                                     } }), dialogOverlayOpen && (_jsxs(OverlayAbove, { maxHeight: Math.max(terminalRows - 8, 1), children: [overlay.kind === 'thinking' && (_jsx(ThinkingToggle, { currentValue: thinkingVisible, focusIndex: overlay.focus, onPick: (index) => {
                                             // 点击行 = 设焦点 + 应用（与 Enter 同一条路径）
                                             const visible = index === 0;
@@ -4534,7 +4554,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                                                 const path = overlay.path;
                                                 dispatchOverlay({ type: 'close' });
                                                 runFileAction(index, path);
-                                            } }) })), overlay.kind === 'search' && _jsx(TranscriptSearch, { query: searchQuery, cursorOffset: searchCursor, count: searchCount, current: searchCurrent })] }))] })] }), _jsx(TooltipLayer, { invalidationKey: `${overlay.kind}:${dialogOverlayOpen}:${btw !== null}`, subscribeInvalidation: subscribeTooltipInvalidation }), _jsx(PromptEditorLayer, {}), promptEditorOpen && imagePreviewNode, starModal !== null && STAR_MILESTONES[starModal.index] !== undefined && (_jsx(StarPrompt, { milestone: STAR_MILESTONES[starModal.index], actions: starModalActions, onClose: closeStarModal, initialPhase: starModal.phase }))] }));
+                                            } }) })), overlay.kind === 'search' && _jsx(TranscriptSearch, { query: searchQuery, cursorOffset: searchCursor, count: searchCount, current: searchCurrent })] }))] })] }), _jsx(TooltipLayer, { invalidationKey: `${overlay.kind}:${dialogOverlayOpen}:${btw !== null}`, subscribeInvalidation: subscribeTooltipInvalidation }), _jsx(PromptEditorLayer, {}), promptEditorOpen && imagePreviewNode, starModal !== null && STAR_MILESTONES[starModal.index] !== undefined && (_jsx(StarPrompt, { milestone: STAR_MILESTONES[starModal.index], actions: starModalActions, onClose: closeStarModal, initialPhase: starModal.phase })), couponVisible && coupon !== null && (_jsx(WhaleCouponPrompt, { notice: coupon, onShown: markCouponShown, onClose: closeCoupon }))] }));
 }
 /**
  * The pinned prompt header shown above the ScrollBox while the user has

package/lib/types/screens/StatusLine.d.ts

@@ -22,6 +22,10 @@ export declare function StatusLine({ channel, selectionActive, helpOpen, wake, a
         band: WaveBand;
         hint?: string;
         tick: number;
+        /** Click target for the strip: opens the trajectory scene. */
+        onOpen?: () => void;
+        /** Chord revealed while the pointer rests on the strip. */
+        hoverHint?: string;
     };
 }): React.JSX.Element;
 type UsageSnapshot = {

package/lib/types/screens/StatusLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StatusLine.d.ts","sourceRoot":"","sources":["../../../src/screens/StatusLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,EAAoC,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAOxG,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAqB3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAqHvD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,eAAuB,EACvB,QAAgB,EAChB,IAAI,EACJ,QAAQ,EAAE,iBAAiB,GAC5B,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;kFAC8E;IAC9E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACvD,qBA+aA;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AA0LD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKvF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EACL;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD,SAAS,GACZ,MAAM,GAAG,SAAS,CAIpB"}
+{"version":3,"file":"StatusLine.d.ts","sourceRoot":"","sources":["../../../src/screens/StatusLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,EAAoC,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAOxG,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAqB3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAqHvD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,eAAuB,EACvB,QAAgB,EAChB,IAAI,EACJ,QAAQ,EAAE,iBAAiB,GAC5B,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;kFAC8E;IAC9E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,QAAQ,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,8DAA8D;QAC9D,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;QACnB,2DAA2D;QAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF,qBA+aA;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AA0LD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKvF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EACL;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD,SAAS,GACZ,MAAM,GAAG,SAAS,CAIpB"}

package/lib/types/screens/StatusLine.js

@@ -38,20 +38,20 @@ import { FREE_SEGMENT_FILL, USED_SEGMENTS, contextBarBreakdown, renderMiniContex
  * own, so hovering it is how its colors get their names and numbers.
  */
 /**
- * Minimal mode's footer config. It ignores every SAVED preference (built from
+ * The minimal UI's footer config. It ignores every SAVED preference (built from
  * scratch rather than `normalizeStatusBar(channel.statusBar)`) and pins the
  * DECORATION switches OFF — the shared defaults are free to change
- * (`contextBar` became default-on in 2026-09) and minimal mode must not follow
+ * (`contextBar` became default-on in 2026-09) and the minimal UI must not follow
  * them into the footer.
  *
- * The metric fields keep their `DEFAULT_STATUS_BAR` values on purpose: minimal
- * mode has ALWAYS shown the default-on metrics (thinking / contextUsage /
+ * The metric fields keep their `DEFAULT_STATUS_BAR` values on purpose: the
+ * minimal UI has ALWAYS shown the default-on metrics (thinking / contextUsage /
  * cache / cost / goal) next to model + cwd — that predates the long-line fold
  * and the context-bar flip, and trimming them further is a product decision,
  * not a regression fix. Module scope: one frozen object, no per-render
  * allocation.
  */
-const MINIMAL_STATUS_BAR = Object.freeze({
+const MINIMAL_UI_STATUS_BAR = Object.freeze({
     ...DEFAULT_STATUS_BAR,
     compact: true,
     model: true,
@@ -82,10 +82,10 @@ export function StatusLine({ channel, selectionActive = false, helpOpen = false,
         // not clobber the field it entered.
         onMouseLeave: () => setHover(current => (current === id ? null : current)),
     }), []);
-    const statusBar = channel.minimal
-        // Minimal mode overrides every field switch: model + cwd only, so the
+    const statusBar = channel.minimalUi
+        // The minimal UI overrides every field switch: model + cwd only, so the
         // footer can never grow decorations regardless of saved preferences.
-        ? MINIMAL_STATUS_BAR
+        ? MINIMAL_UI_STATUS_BAR
         : normalizeStatusBar(channel.statusBar);
     // Provider workspaces expose a remote display path alongside a host alias;
     // only the local target has identical cwd/displayCwd values to fold.
@@ -259,7 +259,7 @@ export function StatusLine({ channel, selectionActive = false, helpOpen = false,
             ? [{
                     key: 'goal',
                     id: 'goal',
-                    node: _jsx(GoalStatusChip, { goal: channel.goal, minimal: channel.minimal }),
+                    node: _jsx(GoalStatusChip, { goal: channel.goal, minimal: channel.minimalUi }),
                 }]
             : []),
         ...(statusBar.gitBranch && channel.gitBranch
@@ -345,13 +345,13 @@ export function StatusLine({ channel, selectionActive = false, helpOpen = false,
     // on hover is what made the footer grow mid-gesture and shoved the
     // transcript up (user feedback). Idle it may sit blank: a stable footer
     // outranks a reclaimable row, and hovering only ever swaps this line's
-    // content. Minimal mode keeps the old contract — no hover details, the
+    // content. The minimal UI keeps the old contract — no hover details, the
     // row appears only for real content (which its defaults never produce).
-    const showSupplementalRow = (!channel.minimal && (hasStatusFields || barVisible)) ||
+    const showSupplementalRow = (!channel.minimalUi && (hasStatusFields || barVisible)) ||
         showActivity ||
         showTrajectory ||
         hint !== '';
-    return (_jsx(Box, { paddingX: 1, width: columns, flexShrink: 0, children: _jsxs(Box, { flexDirection: "column", width: "100%", children: [barVisible ? (_jsx(ContextBarView, { segments: channel.contextSegments, usedTokens: contextUsed ?? 0, contextWindow: channel.contextWindow ?? 0, width: barWidth, colors: barColors, onHover: hovered => setHover(current => hovered ? 'bar' : current === 'bar' ? null : current) })) : null, hasStatusFields ? statusBar.compact ? (_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsx(Box, { flexGrow: 1, flexShrink: 1, flexDirection: "row", overflow: "hidden", children: _jsx(FieldLine, { parts: compactFields, hoverProps: hoverProps }) }), ctxNode !== undefined ? (_jsx(Box, { flexShrink: 0, ...hoverProps('ctx'), children: _jsx(Text, { wrap: "truncate", children: ctxNode }) })) : null] })) : (_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsx(Box, { flexGrow: 1, flexShrink: 1, flexDirection: "row", overflow: "hidden", children: _jsx(FieldLine, { parts: fullLeftFields, hoverProps: hoverProps }) }), _jsx(Box, { justifyContent: "flex-end", flexShrink: 2, flexDirection: "row", overflow: "hidden", children: _jsx(FieldLine, { parts: rightFields, hoverProps: hoverProps }) })] })) : null, showSupplementalRow ? _jsxs(Box, { height: 1, overflow: "hidden", flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsxs(Box, { flexDirection: "row", flexGrow: 1, justifyContent: showActivity && trailer !== null ? 'space-between' : 'flex-start', gap: 2, children: [showActivity && activity !== undefined ? (_jsx(ActivityLine, { activity: activity, activityFrames: channel.activityFrames, warnPct: contextPressurePct(usage, channel.contextWindow), warnDanger: (contextPressurePct(usage, channel.contextWindow) ?? 0) >= 95 })) : trailer, showActivity ? trailer : null] }), showTrajectory && wake !== undefined ? (_jsx(MiniWake, { band: wake.band, hint: wake.hint, tick: wake.tick })) : null] }) : null] }) }));
+    return (_jsx(Box, { paddingX: 1, width: columns, flexShrink: 0, children: _jsxs(Box, { flexDirection: "column", width: "100%", children: [barVisible ? (_jsx(ContextBarView, { segments: channel.contextSegments, usedTokens: contextUsed ?? 0, contextWindow: channel.contextWindow ?? 0, width: barWidth, colors: barColors, onHover: hovered => setHover(current => hovered ? 'bar' : current === 'bar' ? null : current) })) : null, hasStatusFields ? statusBar.compact ? (_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsx(Box, { flexGrow: 1, flexShrink: 1, flexDirection: "row", overflow: "hidden", children: _jsx(FieldLine, { parts: compactFields, hoverProps: hoverProps }) }), ctxNode !== undefined ? (_jsx(Box, { flexShrink: 0, ...hoverProps('ctx'), children: _jsx(Text, { wrap: "truncate", children: ctxNode }) })) : null] })) : (_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsx(Box, { flexGrow: 1, flexShrink: 1, flexDirection: "row", overflow: "hidden", children: _jsx(FieldLine, { parts: fullLeftFields, hoverProps: hoverProps }) }), _jsx(Box, { justifyContent: "flex-end", flexShrink: 2, flexDirection: "row", overflow: "hidden", children: _jsx(FieldLine, { parts: rightFields, hoverProps: hoverProps }) })] })) : null, showSupplementalRow ? _jsxs(Box, { height: 1, overflow: "hidden", flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsxs(Box, { flexDirection: "row", flexGrow: 1, justifyContent: showActivity && trailer !== null ? 'space-between' : 'flex-start', gap: 2, children: [showActivity && activity !== undefined ? (_jsx(ActivityLine, { activity: activity, activityFrames: channel.activityFrames, warnPct: contextPressurePct(usage, channel.contextWindow), warnDanger: (contextPressurePct(usage, channel.contextWindow) ?? 0) >= 95 })) : trailer, showActivity ? trailer : null] }), showTrajectory && wake !== undefined ? (_jsx(MiniWake, { band: wake.band, hint: wake.hint, tick: wake.tick, onOpen: wake.onOpen, hoverHint: wake.hoverHint })) : null] }) : null] }) }));
 }
 /**
  * The supplemental-row readout for a hovered footer field. Technical label

package/lib/types/settings/definitions.js

@@ -124,11 +124,11 @@ export const SETTING_DEFINITIONS = {
         kind: 'boolean',
     },
     'minimal': {
-        label: 'Minimal mode',
-        descriptions: { zh: '极简模式' },
+        label: 'Minimal UI',
+        descriptions: { zh: '极简界面' },
         group: 'appearance',
-        hint: 'Hide the header splash, emoji glyphs, and decorative colors; code highlight and tool colors stay. Trims the status bar to model + cwd.',
-        hintDescriptions: { zh: '隐藏开屏头部、emoji 状态符与装饰性配色；代码高亮与工具配色保留，底栏只留模型与目录。' },
+        hint: 'Interface only: hide the header splash, emoji glyphs and decorative colors, and trim the status bar to model + cwd; code highlight and tool colors stay. NOT the agent preset — the kernel\'s own `minimal` preset is a separate, model-facing choice that decides which tools the model can use (see /preset).',
+        hintDescriptions: { zh: '只精简界面：隐藏开屏头部、emoji 状态符与装饰性配色，底栏只留模型与目录；代码高亮与工具配色保留。这是界面开关，不是 Agent 预设——模型能用哪些工具由内核预设决定（见 /preset）。' },
         kind: 'boolean',
     },
     'pageMargin': {