@deepseek-harness-tui/dsh-tui 0.8.5 → 0.8.7

package/lib/types/commands.d.ts

@@ -53,6 +53,20 @@ export type CommandChildren = (canonicalPath: readonly string[]) => readonly Com
  * commands merge in at runtime; locals win on name collisions.
  */
 export declare const LOCAL_COMMANDS: LocalCommand[];
+/**
+ * Hidden slash commands: intentionally not exposed in the `/` suggestion
+ * menu or Help, but still recognized as local commands when typed. They are
+ * kept out of `LOCAL_COMMANDS` so `filterCommands`/`completeCommands` never
+ * surface them; dispatch recognizes them via {@link HIDDEN_COMMAND_NAMES}.
+ */
+export declare const HIDDEN_COMMANDS: readonly LocalCommand[];
+/** Names of hidden commands, for fast dispatch/lookup. */
+export declare const HIDDEN_COMMAND_NAMES: ReadonlySet<string>;
+/**
+ * Whether the input names a hidden command (same slash-optional trimming
+ * rules as {@link isLocalCommandName}).
+ */
+export declare function isHiddenCommandName(input: string): boolean;
 /**
  * Resolve a command's description in the active UI language. The en text in
  * `LOCAL_COMMANDS` (and the registry's own text for external commands) is

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

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,qBAAqB,EAAE,CAAA;AAEpG;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EA2DxC,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAIhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,YAAY,EAAE,CAKhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,SAAS,YAAY,EAAmB,EAC/C,QAAQ,GAAE,eAA0B,GACnC,iBAAiB,EAAE,CAoCrB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,qBAAqB,EAAE,CAAA;AAEpG;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EA2DxC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAElD,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAEpD,CAAA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAIhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,YAAY,EAAE,CAKhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,SAAS,YAAY,EAAmB,EAC/C,QAAQ,GAAE,eAA0B,GACnC,iBAAiB,EAAE,CAoCrB"}

package/lib/types/commands.js

@@ -71,6 +71,25 @@ export const LOCAL_COMMANDS = [
     { name: 'quit', description: 'Exit dsh-tui', tag: 'alias of /exit' },
     { name: 'q', description: 'Exit dsh-tui', tag: 'alias of /exit' },
 ];
+/**
+ * Hidden slash commands: intentionally not exposed in the `/` suggestion
+ * menu or Help, but still recognized as local commands when typed. They are
+ * kept out of `LOCAL_COMMANDS` so `filterCommands`/`completeCommands` never
+ * surface them; dispatch recognizes them via {@link HIDDEN_COMMAND_NAMES}.
+ */
+export const HIDDEN_COMMANDS = [
+    { name: 'deepseek', description: 'Hidden DeepSeek easter egg' },
+];
+/** Names of hidden commands, for fast dispatch/lookup. */
+export const HIDDEN_COMMAND_NAMES = new Set(HIDDEN_COMMANDS.map(command => command.name));
+/**
+ * Whether the input names a hidden command (same slash-optional trimming
+ * rules as {@link isLocalCommandName}).
+ */
+export function isHiddenCommandName(input) {
+    const name = input.replace(/^\//, '').trim();
+    return HIDDEN_COMMAND_NAMES.has(name);
+}
 /**
  * Resolve a command's description in the active UI language. The en text in
  * `LOCAL_COMMANDS` (and the registry's own text for external commands) is
@@ -111,7 +130,7 @@ export function isLocalCommandName(input, list = LOCAL_COMMANDS) {
     // Trailing whitespace is legal (Tab completion leaves a space after the
     // name so the user can type arguments).
     const name = input.replace(/^\//, '').trim();
-    return list.some(command => command.name === name);
+    return HIDDEN_COMMAND_NAMES.has(name) || list.some(command => command.name === name);
 }
 /**
  * Filter commands by a `/…` input prefix (matches the CC overlay behavior).

package/lib/types/components/Chat/SubagentMessage.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { SubagentRow } from '../../dsh-adapter/channel.js';
+/**
+ * Borderless, fixed-height activity card embedded directly in the transcript
+ * (Kimi Code visual language). Running: header + one-line current tool + a
+ * constant 3-row waterfall (each row hard-clipped to one terminal line so
+ * the card height never changes). Settled: folds to the header line alone
+ * (failure keeps one error line). The running glyph reuses the user's
+ * working-activity preset (`/activity`), so the indicator follows the same
+ * setting as the main spinner.
+ */
+export declare function SubagentMessage({ subagent, addMargin, activityFrames, onClick }: {
+    subagent: SubagentRow;
+    addMargin: boolean;
+    activityFrames?: string;
+    isExpanded: boolean;
+    onClick: () => void;
+}): React.ReactNode;
+//# sourceMappingURL=SubagentMessage.d.ts.map

package/lib/types/components/Chat/SubagentMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubagentMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/Chat/SubagentMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AA+C/D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE;IAChF,QAAQ,EAAE,WAAW,CAAA;IACrB,SAAS,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CAqElB"}

package/lib/types/components/Chat/SubagentMessage.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Box, Text, useAnimationFrame, useTerminalSize } from '../../ui.js';
+import { t } from '../../i18n.js';
+import { resolvePreset } from '../activityFrames.js';
+import { toolNameColor } from '../messages/AssistantToolUseMessage.js';
+import { stringWidth } from '../../ink/stringWidth.js';
+import { isMinimalMode } from '../../minimalMode.js';
+/** The waterfall window is a Kimi Code style constant-height region. */
+const WATERFALL_ROWS = 3;
+/** Card left padding + the `│ ` gutter prefix. */
+const WATERFALL_GUTTER = 4;
+function duration(ms = 0) {
+    const seconds = Math.floor(ms / 1000);
+    return seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m${seconds % 60}s`;
+}
+function tokens(row) {
+    const total = row.tokens?.total ?? ((row.tokens?.input ?? 0) + (row.tokens?.output ?? 0) || 0);
+    return total > 0 ? `${total} tok` : '- tok';
+}
+function status(row) {
+    const minimal = isMinimalMode();
+    if (row.status === 'completed')
+        return { glyph: minimal ? '✓' : '🟢', label: t('subagent-status-completed'), color: minimal ? undefined : 'success' };
+    if (row.status === 'failed')
+        return { glyph: minimal ? '×' : '🔴', label: t('subagent-status-failed'), color: minimal ? undefined : 'error' };
+    if (row.status === 'cancelled')
+        return { glyph: minimal ? '×' : '🔴', label: t('subagent-status-cancelled'), color: minimal ? undefined : 'error' };
+    return { glyph: minimal ? '·' : '🟡', label: t('subagent-status-running'), color: minimal ? undefined : 'warning' };
+}
+/** Hard single-line clip by display width — a wrapped waterfall row would
+ * break the constant-height window. */
+function clipLine(text, maxWidth) {
+    if (maxWidth <= 1)
+        return '';
+    let width = 0;
+    let index = 0;
+    while (index < text.length) {
+        // Advance by the next full code point so wide glyphs (CJK, emoji) are
+        // never split in half.
+        const next = text.codePointAt(index);
+        const char = String.fromCodePoint(next);
+        const charWidth = stringWidth(char);
+        if (width + charWidth > maxWidth - 1)
+            break;
+        width += charWidth;
+        index += char.length;
+    }
+    return index < text.length ? `${text.slice(0, index)}…` : text;
+}
+/**
+ * Borderless, fixed-height activity card embedded directly in the transcript
+ * (Kimi Code visual language). Running: header + one-line current tool + a
+ * constant 3-row waterfall (each row hard-clipped to one terminal line so
+ * the card height never changes). Settled: folds to the header line alone
+ * (failure keeps one error line). The running glyph reuses the user's
+ * working-activity preset (`/activity`), so the indicator follows the same
+ * setting as the main spinner.
+ */
+export function SubagentMessage({ subagent, addMargin, activityFrames, onClick }) {
+    const [, time] = useAnimationFrame(120);
+    const { columns } = useTerminalSize();
+    const info = status(subagent);
+    const settled = subagent.status === 'completed' || subagent.status === 'failed' || subagent.status === 'cancelled';
+    const elapsed = subagent.completedAt ? subagent.durationMs : Date.now() - subagent.startedAt;
+    const lastRunning = [...subagent.toolCalls].reverse().find(tool => tool.status === 'running');
+    const previousDone = lastRunning
+        ? subagent.toolCalls[subagent.toolCalls.indexOf(lastRunning) - 1]
+        : subagent.toolCalls[subagent.toolCalls.length - 1];
+    const preset = React.useMemo(() => resolvePreset(activityFrames), [activityFrames]);
+    const activity = settled ? [] : subagent.outputLines.slice(-WATERFALL_ROWS);
+    const runningGlyph = preset.frames[Math.floor(time / preset.intervalMs) % preset.frames.length] ?? '·';
+    const rowWidth = Math.max(20, (columns ?? 80) - WATERFALL_GUTTER);
+    return _jsxs(Box, { flexDirection: "column", marginTop: addMargin ? 1 : 0, paddingLeft: 2, onClick: onClick, children: [_jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsx(Text, { color: info.color, children: settled ? info.glyph : ` ${runningGlyph}` }), _jsx(Text, { bold: true, children: `${t('subagent-card-prefix')}${subagent.description}` }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { children: subagent.model ?? subagent.provider ?? 'default' }), subagent.effort && _jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: subagent.effort })] }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: duration(elapsed) }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: tokens(subagent) }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsxs(Text, { dimColor: true, children: [subagent.toolCalls.length, " tools"] }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { color: info.color, children: info.label })] }), !settled && (lastRunning ?? previousDone) !== undefined && (_jsx(Text, { wrap: "truncate", children: lastRunning !== undefined ? (_jsxs(_Fragment, { children: [previousDone !== undefined && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: '  · ' }), _jsx(Text, { color: "success", children: "\u2713" }), _jsx(Text, { color: toolNameColor(previousDone.name), children: previousDone.name }), _jsx(Text, { dimColor: true, children: ' · ' })] })), lastRunning.argsPreview === undefined && (_jsx(Text, { color: toolNameColor(lastRunning.name), children: lastRunning.name })), lastRunning.argsPreview !== undefined && (_jsxs(_Fragment, { children: [_jsx(Text, { color: toolNameColor(lastRunning.name), children: lastRunning.name }), _jsx(Text, { dimColor: true, children: ` (${clipLine(lastRunning.argsPreview.replace(/\s+/g, ' ').trim(), Math.max(10, rowWidth - lastRunning.name.length - 6))})` })] }))] })) : (previousDone !== undefined && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: '  · ' }), _jsx(Text, { color: "success", children: "\u2713" }), _jsx(Text, { color: toolNameColor(previousDone.name), children: previousDone.name }), previousDone.argsPreview !== undefined && (_jsx(Text, { dimColor: true, children: ` (${clipLine(previousDone.argsPreview.replace(/\s+/g, ' ').trim(), Math.max(10, rowWidth - previousDone.name.length - 6))})` }))] }))) })), !settled && Array.from({ length: WATERFALL_ROWS }, (_, index) => (_jsx(Text, { dimColor: true, wrap: "truncate", children: `  │ ${clipLine(activity[index] ?? '', rowWidth)}` }, `${subagent.agentId}-wf-${index}-${time}`))), settled && subagent.status === 'failed' && subagent.error && (_jsx(Text, { color: "error", wrap: "truncate", children: `  └ ${clipLine(subagent.error, rowWidth)}` }))] });
+}

package/lib/types/components/EffortChargeGlyph.d.ts

@@ -0,0 +1,26 @@
+/**
+ * EffortChargeGlyph — 输入提示前缀 `❯ ` 的最高档强调与充能。
+ *
+ * 思考强度处于当前路线最高档期间，前缀换为点火强调色（加粗，与点焰波
+ * 共用 hues[0]——同一瞬间前缀与波是同一种橙）；切到最高档的瞬间做一次
+ * 150ms「充能」渐变（accentRamp 的暗端 → 全值）。冷启动已在最高档时
+ * 不充能（充能只属于切换瞬间），离开最高档恢复原样的 dim 行为。
+ *
+ * 触发判定在渲染期做（React 官方的「props 变化即调整 state」模式，
+ * 与 EffortInputBorder 同一模式）——放 effect 会晚一帧，effort 变化
+ * 的首帧以全亮闪现、下一帧才跌回暗端重来。充能只动颜色，glyph 恒为
+ * `❯ `，SGR-only 规则天然成立。
+ *
+ * 时钟复用 Ink core 共享时钟，且只在充能未满的那 150ms 内订阅；稳态
+ * 零定时器、零重渲染，前缀色取记忆化常量。
+ */
+import React from 'react';
+export declare function EffortChargeGlyph({ effort, levels, working, }: {
+    /** 当前思考强度档 id；`undefined` 表示路线未声明。 */
+    effort: string | undefined;
+    /** 当前路线的档位表（低→高，末位为最高档）。 */
+    levels: readonly string[] | undefined;
+    /** 模型工作中时前缀照旧压暗（既有语义）。 */
+    working: boolean;
+}): React.ReactNode;
+//# sourceMappingURL=EffortChargeGlyph.d.ts.map

package/lib/types/components/EffortChargeGlyph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffortChargeGlyph.d.ts","sourceRoot":"","sources":["../../../src/components/EffortChargeGlyph.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAsD,MAAM,OAAO,CAAA;AAW1E,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,MAAM,EACN,OAAO,GACR,EAAE;IACD,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,4BAA4B;IAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACrC,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAA;CACjB,GAAG,KAAK,CAAC,SAAS,CAuDlB"}

package/lib/types/components/EffortChargeGlyph.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * EffortChargeGlyph — 输入提示前缀 `❯ ` 的最高档强调与充能。
+ *
+ * 思考强度处于当前路线最高档期间，前缀换为点火强调色（加粗，与点焰波
+ * 共用 hues[0]——同一瞬间前缀与波是同一种橙）；切到最高档的瞬间做一次
+ * 150ms「充能」渐变（accentRamp 的暗端 → 全值）。冷启动已在最高档时
+ * 不充能（充能只属于切换瞬间），离开最高档恢复原样的 dim 行为。
+ *
+ * 触发判定在渲染期做（React 官方的「props 变化即调整 state」模式，
+ * 与 EffortInputBorder 同一模式）——放 effect 会晚一帧，effort 变化
+ * 的首帧以全亮闪现、下一帧才跌回暗端重来。充能只动颜色，glyph 恒为
+ * `❯ `，SGR-only 规则天然成立。
+ *
+ * 时钟复用 Ink core 共享时钟，且只在充能未满的那 150ms 内订阅；稳态
+ * 零定时器、零重渲染，前缀色取记忆化常量。
+ */
+import { useContext, useEffect, useReducer, useState } from 'react';
+import { Text, useTheme } from '../ui.js';
+import { ClockContext } from '../ink/components/ClockContext.js';
+import { accentRamp } from '../trajectory/effortIgnition.js';
+import { rgbString } from '../trajectory/motion.js';
+import { interpolateColor } from './Spinner/spinnerUtils.js';
+import { isLightThemeActive } from '../theme.js';
+/** 充能时长（ms）。 */
+const CHARGE_MS = 150;
+export function EffortChargeGlyph({ effort, levels, working, }) {
+    const clock = useContext(ClockContext);
+    const [themeName] = useTheme();
+    const [chargeStartedAt, setChargeStartedAt] = useState(null);
+    const [prevEffort, setPrevEffort] = useState(effort);
+    const [, forceRender] = useReducer((tick) => tick + 1, 0);
+    const topActive = effort !== undefined && levels !== undefined && levels.length > 1 && effort === levels[levels.length - 1];
+    // Render-phase trigger (same pattern as EffortInputBorder): switching from
+    // an existing tier onto the top tier starts the charge NOW, not one effect
+    // later — the first frame of the new effort must not flash fully lit.
+    // Cold mounts enter the steady state directly; without a shared clock
+    // (headless embeds) there is no charge either — no frames would ever arrive.
+    if (effort !== prevEffort) {
+        setPrevEffort(effort);
+        if (topActive && clock !== null) {
+            setChargeStartedAt(clock.now());
+        }
+    }
+    // Only the 150ms charge window subscribes to the shared clock; steady
+    // state has zero timers and zero re-renders.
+    const chargeElapsed = chargeStartedAt === null
+        ? Infinity
+        : // Clamp at zero: the shared clock can hand back a stale tickTime for
+            // one frame after waking from pause.
+            Math.max(0, (clock?.now() ?? Date.now()) - chargeStartedAt);
+    const charging = chargeElapsed < CHARGE_MS;
+    useEffect(() => {
+        if (!charging || clock === null)
+            return;
+        return clock.subscribe(() => forceRender(), /* keepAlive */ true);
+    }, [charging, clock]);
+    if (!topActive)
+        return _jsx(Text, { dimColor: working, children: "\u276F " });
+    const ramp = accentRamp(isLightThemeActive(themeName));
+    if (!charging) {
+        // Steady state re-derives on every render (two allocations + one blend
+        // per keystroke — negligible) instead of caching: a cached colour would
+        // go stale across a light/dark theme flip while the tier stays active.
+        const color = rgbString(ramp.full);
+        return (_jsxs(Text, { bold: true, color: color, dimColor: working, children: ["\u276F", ' '] }));
+    }
+    const charge = Math.min(1, chargeElapsed / CHARGE_MS);
+    return (_jsxs(Text, { bold: true, color: rgbString(interpolateColor(ramp.dim, ramp.full, charge)), dimColor: working, children: ["\u276F", ' '] }));
+}

package/lib/types/components/EffortInputBorder.d.ts

@@ -0,0 +1,36 @@
+/**
+ * EffortInputBorder — 输入框层上的三幕点焰叠加（对齐 Codex 的完整
+ * 语义：光扫过、档位字样浮现、整体渐隐）。
+ *
+ * 输入框只有顶/底两条横边框（round、无左右）——本组件自绘这两行，
+ * **同步**承载动画；档位字样由输入行尾的 EffortTierBadge 短暂显示
+ * （见 PromptInput），动画全程行数恒定。切到最高思考强度档时：
+ *
+ *   1. 扫光 [0, 1s)——一段高亮彩色光带沿顶/底边框同步自左向右扫过
+ *      （wave 波形逐列变色），期间输入框完全正常可用；
+ *   2. 档位字样 [600ms, ~1.1s)——光带行至中段时，输入行居中浮现
+ *      档名大写（由暗渐亮加粗、间距聚拢，见 EffortTierBadge）；
+ *   3. 渐隐 [1.5s, 2s)——字样连同光色一起向主题色淡出，末帧归零：
+ *      静止时顶/底边框就是原主题色，内容区无任何附加物。
+ *
+ * glyph 变化仅限字样行的出现/让位（一次性）；其余帧间变化全部是既
+ * 有 `─` 的前景色。触发判定在渲染期做（props-变化-调整模式）；从
+ * 「已有档位」切到档位表末位最高档才触发，冷启动恢复偏好/单档表/
+ * 无档位表/无共享时钟均不触发。时钟复用 Ink core 共享时钟，仅动画
+ * 窗口订阅（keepAlive），播完回到零开销静止边框。
+ */
+import React from 'react';
+import type { Color } from '../ink/styles.js';
+import type { Theme } from '../theme.js';
+export declare function EffortInputBorder({ effort, levels, columns, onLight, idleColor, children, }: {
+    /** 当前思考强度档 id；`undefined` 表示路线未声明。 */
+    effort: string | undefined;
+    /** 当前路线的档位表（低→高，末位为最高档）；未知时传 `undefined`。 */
+    levels: readonly string[] | undefined;
+    columns: number;
+    onLight: boolean;
+    /** 静止边框色（主题 token 名，如 'promptBorder' / 'planMode'）。 */
+    idleColor: keyof Theme | Color;
+    children: React.ReactNode;
+}): React.ReactNode;
+//# sourceMappingURL=EffortInputBorder.d.ts.map

package/lib/types/components/EffortInputBorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffortInputBorder.d.ts","sourceRoot":"","sources":["../../../src/components/EffortInputBorder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAA8D,MAAM,OAAO,CAAA;AAGlF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAgCxC,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,EACT,QAAQ,GACT,EAAE;IACD,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,SAAS,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,GAAG,KAAK,CAAC,SAAS,CA0DlB"}

package/lib/types/components/EffortInputBorder.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * EffortInputBorder — 输入框层上的三幕点焰叠加（对齐 Codex 的完整
+ * 语义：光扫过、档位字样浮现、整体渐隐）。
+ *
+ * 输入框只有顶/底两条横边框（round、无左右）——本组件自绘这两行，
+ * **同步**承载动画；档位字样由输入行尾的 EffortTierBadge 短暂显示
+ * （见 PromptInput），动画全程行数恒定。切到最高思考强度档时：
+ *
+ *   1. 扫光 [0, 1s)——一段高亮彩色光带沿顶/底边框同步自左向右扫过
+ *      （wave 波形逐列变色），期间输入框完全正常可用；
+ *   2. 档位字样 [600ms, ~1.1s)——光带行至中段时，输入行居中浮现
+ *      档名大写（由暗渐亮加粗、间距聚拢，见 EffortTierBadge）；
+ *   3. 渐隐 [1.5s, 2s)——字样连同光色一起向主题色淡出，末帧归零：
+ *      静止时顶/底边框就是原主题色，内容区无任何附加物。
+ *
+ * glyph 变化仅限字样行的出现/让位（一次性）；其余帧间变化全部是既
+ * 有 `─` 的前景色。触发判定在渲染期做（props-变化-调整模式）；从
+ * 「已有档位」切到档位表末位最高档才触发，冷启动恢复偏好/单档表/
+ * 无档位表/无共享时钟均不触发。时钟复用 Ink core 共享时钟，仅动画
+ * 窗口订阅（keepAlive），播完回到零开销静止边框。
+ */
+import { useContext, useEffect, useReducer, useState } from 'react';
+import { Box, Text } from '../ui.js';
+import { ClockContext } from '../ink/components/ClockContext.js';
+import { IGNITION_TIMELINE, ignitionLineColors } from '../trajectory/effortIgnition.js';
+/** 边框行（顶/底共用同一色段序列——同步变色）。 */
+function BorderRow({ left, right, runs, idleColor, }) {
+    return (_jsx(Box, { width: "100%", height: 1, flexShrink: 0, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: idleColor, children: left }), runs.map((run, i) => (_jsx(Text, { color: run.color, children: run.glyph }, i))), _jsx(Text, { color: idleColor, children: right })] }) }));
+}
+export function EffortInputBorder({ effort, levels, columns, onLight, idleColor, children, }) {
+    const clock = useContext(ClockContext);
+    const [overlay, setOverlay] = useState(null);
+    const [prevEffort, setPrevEffort] = useState(effort);
+    const [, forceRender] = useReducer((tick) => tick + 1, 0);
+    // 渲染期触发：effort 变化的首帧就以新状态渲染（effect 会晚一帧）。
+    if (effort !== prevEffort) {
+        setPrevEffort(effort);
+        if (clock !== null &&
+            effort !== undefined &&
+            levels !== undefined &&
+            levels.length > 1 &&
+            effort === levels[levels.length - 1]) {
+            setOverlay({ label: effort.toUpperCase(), startedAtMs: clock.now() });
+        }
+    }
+    // 仅动画窗口订阅共享时钟；静止边框零定时器零重渲染。
+    const elapsedMs = overlay === null ? Infinity : Math.max(0, (clock?.now() ?? Date.now()) - overlay.startedAtMs);
+    useEffect(() => {
+        if (overlay === null || clock === null)
+            return;
+        return clock.subscribe(() => forceRender(), /* keepAlive */ true);
+    }, [overlay, clock]);
+    useEffect(() => {
+        if (overlay !== null && elapsedMs >= IGNITION_TIMELINE.fadeEndMs)
+            setOverlay(null);
+    }, [overlay, elapsedMs]);
+    const midWidth = Math.max(0, columns - 2);
+    const sweepColors = overlay !== null && elapsedMs < IGNITION_TIMELINE.sweepMs && midWidth > 0
+        ? ignitionLineColors({ elapsedMs, width: midWidth, onLight })
+        : [];
+    // 顶/底共用的色段序列（同步）：扫光列取波形色，其余列回主题色。
+    const runs = [];
+    for (let index = 0; index < midWidth; index++) {
+        const color = sweepColors[index] ?? idleColor;
+        const last = runs[runs.length - 1];
+        if (last !== undefined && last.color === color)
+            last.glyph += '─';
+        else
+            runs.push({ glyph: '─', color });
+    }
+    return (_jsxs(Box, { flexDirection: "column", alignItems: "flex-start", justifyContent: "flex-start", width: "100%", flexShrink: 0, children: [_jsx(BorderRow, { left: "\u256D", right: "\u256E", runs: runs, idleColor: idleColor }), _jsx(Box, { flexShrink: 0, children: children }), _jsx(BorderRow, { left: "\u2570", right: "\u256F", runs: runs, idleColor: idleColor })] }));
+}

package/lib/types/components/EffortTierBadge.d.ts

@@ -0,0 +1,26 @@
+/**
+ * EffortTierBadge — 输入行尾的档位字样徽标：三幕点焰的第二幕载体
+ * （与 EffortInputBorder 的双框扫光同一时间轴、同一触发），切到最高
+ * 思考强度档时光带行至中段，输入行居中浮现档名（当前档名大写，字母间距从
+ * 10 个空格减速聚拢到 1 个——连续位置逐字母取整保证帧帧有移动，
+ * 明亮蓝加粗，由暗渐亮），随后随图层整体渐隐让位——行数恒定，静
+ * 止时完全不渲染；输入行有文字时不显示（绝不遮挡内容）。
+ *
+ * 触发判定在渲染期做（props-变化-调整模式，与边框/充能组件同模
+ * 式）；冷启动恢复偏好/单档表/无档位表/无共享时钟均不触发。时钟
+ * 复用 Ink core 共享时钟，仅动画窗口订阅（keepAlive），播完归零。
+ */
+import React from 'react';
+export declare function EffortTierBadge({ effort, levels, onLight, columns, leadingColumns, }: {
+    /** 当前思考强度档 id；`undefined` 表示路线未声明。 */
+    effort: string | undefined;
+    /** 当前路线的档位表（低→高，末位为最高档）；未知时传 `undefined`。 */
+    levels: readonly string[] | undefined;
+    onLight: boolean;
+    /** 终端列数——居中锚点按终端几何中心计算（纯文本流，不引入嵌套 Box）。 */
+    columns: number;
+    /** badge 文本流之前该行已被占据的列数（❯ 与块光标等）——居中换算成
+     *  badge 流内列时要扣掉，否则整体偏右一个前缀宽。 */
+    leadingColumns: number;
+}): React.ReactNode;
+//# sourceMappingURL=EffortTierBadge.d.ts.map

package/lib/types/components/EffortTierBadge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffortTierBadge.d.ts","sourceRoot":"","sources":["../../../src/components/EffortTierBadge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAsD,MAAM,OAAO,CAAA;AAc1E,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,cAAc,GACf,EAAE;IACD,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf;qCACiC;IACjC,cAAc,EAAE,MAAM,CAAA;CACvB,GAAG,KAAK,CAAC,SAAS,CAkFlB"}

package/lib/types/components/EffortTierBadge.js

@@ -0,0 +1,97 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * EffortTierBadge — 输入行尾的档位字样徽标：三幕点焰的第二幕载体
+ * （与 EffortInputBorder 的双框扫光同一时间轴、同一触发），切到最高
+ * 思考强度档时光带行至中段，输入行居中浮现档名（当前档名大写，字母间距从
+ * 10 个空格减速聚拢到 1 个——连续位置逐字母取整保证帧帧有移动，
+ * 明亮蓝加粗，由暗渐亮），随后随图层整体渐隐让位——行数恒定，静
+ * 止时完全不渲染；输入行有文字时不显示（绝不遮挡内容）。
+ *
+ * 触发判定在渲染期做（props-变化-调整模式，与边框/充能组件同模
+ * 式）；冷启动恢复偏好/单档表/无档位表/无共享时钟均不触发。时钟
+ * 复用 Ink core 共享时钟，仅动画窗口订阅（keepAlive），播完归零。
+ */
+import { useContext, useEffect, useReducer, useState } from 'react';
+import { Text } from '../ui.js';
+import { ClockContext } from '../ink/components/ClockContext.js';
+import { rgbString } from '../trajectory/motion.js';
+import { IGNITION_TIMELINE, ignitionHues } from '../trajectory/effortIgnition.js';
+/** 字母间距聚拢：从 10 个空格减速收敛到 1 个（ease-out，快收慢停）。 */
+const GAP_START = 10;
+const GAP_END = 1;
+const CONVERGE_MS = 500;
+export function EffortTierBadge({ effort, levels, onLight, columns, leadingColumns, }) {
+    const clock = useContext(ClockContext);
+    const [overlay, setOverlay] = useState(null);
+    const [prevEffort, setPrevEffort] = useState(effort);
+    const [, forceRender] = useReducer((tick) => tick + 1, 0);
+    // 渲染期触发（与边框/充能同模式）：effort 变化的首帧就以新状态渲染。
+    if (effort !== prevEffort) {
+        setPrevEffort(effort);
+        if (clock !== null &&
+            effort !== undefined &&
+            levels !== undefined &&
+            levels.length > 1 &&
+            effort === levels[levels.length - 1]) {
+            setOverlay({ label: effort.toUpperCase(), startedAtMs: clock.now() });
+        }
+    }
+    const elapsedMs = overlay === null ? Infinity : Math.max(0, (clock?.now() ?? Date.now()) - overlay.startedAtMs);
+    useEffect(() => {
+        if (overlay === null || clock === null)
+            return;
+        return clock.subscribe(() => forceRender(), /* keepAlive */ true);
+    }, [overlay, clock]);
+    useEffect(() => {
+        if (overlay !== null && elapsedMs >= IGNITION_TIMELINE.fadeEndMs)
+            setOverlay(null);
+    }, [overlay, elapsedMs]);
+    if (overlay === null || elapsedMs < IGNITION_TIMELINE.labelStartMs)
+        return null;
+    const brighten = Math.min(1, (elapsedMs - IGNITION_TIMELINE.labelStartMs) / IGNITION_TIMELINE.labelBrightenMs);
+    const fade = elapsedMs < IGNITION_TIMELINE.fadeStartMs
+        ? 1
+        : Math.max(0, 1 - (elapsedMs - IGNITION_TIMELINE.fadeStartMs) / (IGNITION_TIMELINE.fadeEndMs - IGNITION_TIMELINE.fadeStartMs));
+    const alpha = brighten * fade;
+    if (alpha <= 0)
+        return null;
+    const band = onLight ? { r: 240, g: 240, b: 242 } : { r: 27, g: 30, b: 40 };
+    // 明亮蓝：accent 混白 35% 提亮（用户拍板的高亮观感）。
+    const hue = ignitionHues(onLight)[0];
+    const whiten = (x) => Math.round(x + (255 - x) * 0.35);
+    const bright = { r: whiten(hue.r), g: whiten(hue.g), b: whiten(hue.b) };
+    const mix = (x, y) => Math.round(x + (y - x) * alpha);
+    const color = rgbString({ r: mix(band.r, bright.r), g: mix(band.g, bright.g), b: mix(band.b, bright.b) });
+    // 字母间距聚拢（Codex 的 converge 语义）：间距是连续浮点，字母位置
+    // 以**行中心为锚**对称收缩——pos_i = center + (i-(n-1)/2)·(1+gap)，
+    // 左右字母各向中心移动一半（奇数档名的居中字母原位不动），两侧速
+    // 度天然均衡；每字母独立按连续位置取整落列，不同字母在不同帧跨
+    // 格，每帧至少一个在动（把间距整体取整会让 ease-out 慢末段上百毫
+    // 秒才跨一格，看起来就是卡顿）。曲线混入 15% 线性做末段保底速度。
+    const progress = Math.min(1, Math.max(0, (elapsedMs - IGNITION_TIMELINE.labelStartMs) / CONVERGE_MS));
+    // 跳变间隔均匀化：离散格子上「减速」若靠曲线导数趋零实现，末段会
+    // 出现几十帧不动一格的长停顿再突跳（卡感来源）。改为 90% 线性 +
+    // 10% easeOutQuad 的轻缓收尾——跳变间隔全程近似恒定（约 55ms/格），
+    // 仅末端轻微放慢，终端上的观感是均匀顺滑的聚拢。
+    const eased = 1 - progress;
+    const easedWithFloor = 0.9 * eased + 0.1 * (1 - progress * progress);
+    const gapF = GAP_END + (GAP_START - GAP_END) * easedWithFloor;
+    const letterCount = overlay.label.length;
+    // 锚点是**终端几何中心**（不是 ❯/光标之后可用区的中心——那会整体
+    // 偏右约 1.5 格；可用区起点在左，其"中点"不含左部占位）。左右字母
+    // 严格镜像——Math.round 对 .5 恒向上，正负方向舍入不对称会让跨格
+    // 时刻错开；左字母的落列由右字母的舍入结果镜像得出（2C − col），
+    // M/X 每次同帧反向同跳，全程对称于终端中心。
+    const C = Math.round((columns - 1) / 2) - leadingColumns;
+    let spaced = '';
+    let column = 0;
+    for (let i = 0; i < letterCount; i++) {
+        const off = (i - (letterCount - 1) / 2) * (1 + gapF);
+        const at = off >= 0
+            ? Math.round(C + off)
+            : 2 * C - Math.round(C - off);
+        spaced += ' '.repeat(Math.max(0, at - column)) + overlay.label[i];
+        column = at + 1;
+    }
+    return (_jsx(Text, { bold: true, color: color, wrap: "truncate-end", children: spaced }));
+}

package/lib/types/components/HelpMenu.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { type ScrollBoxHandle } from '../ui.js';
 import type { LocalCommand } from '../commands.js';
 /**
  * The `?` help menu, mirroring Claude Code's `PromptInputHelpMenu.tsx`
@@ -10,7 +11,13 @@ import type { LocalCommand } from '../commands.js';
  * menu is for chrome commands. Modifier labels follow the platform
  * convention: ⌘ on macOS, ctrl elsewhere.
  */
-export declare function HelpMenu({ commands, }: {
+export declare function HelpMenu({ commands, viewportHeight, viewportWidth, scrollRef, }: {
     commands: readonly LocalCommand[];
+    /** Fixed viewport supplied by the prompt overlay; unset for standalone renders. */
+    viewportHeight?: number;
+    /** Terminal width used to collapse the three-column layout when necessary. */
+    viewportWidth?: number;
+    /** PromptInput owns keyboard routing and drives this scroll viewport. */
+    scrollRef?: React.Ref<ScrollBoxHandle>;
 }): React.ReactNode;
 //# sourceMappingURL=HelpMenu.d.ts.map

package/lib/types/components/HelpMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HelpMenu.d.ts","sourceRoot":"","sources":["../../../src/components/HelpMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAKlD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;CAClC,GAAG,KAAK,CAAC,SAAS,CAiElB"}
+{"version":3,"file":"HelpMenu.d.ts","sourceRoot":"","sources":["../../../src/components/HelpMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAKlD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IACjC,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;CACvC,GAAG,KAAK,CAAC,SAAS,CAyHlB"}

package/lib/types/components/HelpMenu.js

@@ -1,6 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import Box from '../ink/components/Box.js';
-import Text from '../ink/components/Text.js';
+import { Box, ScrollBox, Text } from '../ui.js';
 import { localizedDescription } from '../commands.js';
 import { t } from '../i18n.js';
 import { modLabel } from '../utils/modifiers.js';
@@ -14,7 +13,19 @@ import { modLabel } from '../utils/modifiers.js';
  * menu is for chrome commands. Modifier labels follow the platform
  * convention: ⌘ on macOS, ctrl elsewhere.
  */
-export function HelpMenu({ commands, }) {
+export function HelpMenu({ commands, viewportHeight, viewportWidth, scrollRef, }) {
     const chrome = commands.filter(command => !command.skill);
-    return (_jsxs(Box, { paddingX: 2, flexDirection: "row", gap: 4, children: [_jsxs(Box, { flexDirection: "column", width: 26, flexShrink: 0, children: [_jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-for-commands') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-this-help') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-verbose-output', { mod: modLabel }) }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-open-trajectory', { mod: modLabel }) }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-search-history', { mod: modLabel }) }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-interrupt') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-exit') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-redraw', { mod: modLabel }) }) })] }), _jsxs(Box, { flexDirection: "column", width: 24, flexShrink: 0, children: [_jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-clear-input') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-history-nav') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-move-cursor') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-word-jumps', { mod: modLabel }) }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-complete-command') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-cycle-mode') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-open-editor') }) })] }), _jsxs(Box, { flexDirection: "column", flexShrink: 1, children: [_jsx(Text, { dimColor: true, children: t('help-commands-title') }), chrome.map(command => (_jsx(Box, { children: _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["/", command.name, " \u2014 ", localizedDescription(command)] }) }, command.name)))] })] }));
+    const primaryShortcuts = (_jsxs(Box, { flexDirection: "column", width: 26, flexShrink: 0, children: [_jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-for-commands') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-this-help') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-verbose-output', { mod: modLabel }) }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-open-trajectory', { mod: modLabel }) }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-search-history', { mod: modLabel }) }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-interrupt') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-exit') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-redraw', { mod: modLabel }) }) })] }));
+    const secondaryShortcuts = (_jsxs(Box, { flexDirection: "column", width: 24, flexShrink: 0, children: [_jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-clear-input') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-history-nav') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-move-cursor') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-word-jumps', { mod: modLabel }) }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-complete-command') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-cycle-mode') }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: t('help-open-editor') }) })] }));
+    const commandRows = chrome.map(command => (_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["/", command.name, " \u2014 ", localizedDescription(command)] }) }, command.name)));
+    const compactCommandRows = chrome.map(command => (_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["/", command.name, " \u2014 ", localizedDescription(command)] }) }, command.name)));
+    const commandList = (_jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [_jsx(Text, { dimColor: true, children: t('help-commands-title') }), commandRows] }));
+    const content = (_jsxs(Box, { paddingX: 2, flexDirection: "row", gap: 4, children: [primaryShortcuts, secondaryShortcuts, _jsx(Box, { flexDirection: "column", flexShrink: 1, children: commandList })] }));
+    // Standalone renders (notably the i18n verifier) keep the historical
+    // intrinsic-height layout. The real prompt overlay supplies an explicit
+    // height so a growing command registry cannot escape the terminal.
+    if (viewportHeight === undefined)
+        return content;
+    const compact = viewportWidth !== undefined && viewportWidth < 72;
+    return (_jsxs(Box, { height: viewportHeight, flexDirection: "column", children: [compact ? (_jsxs(ScrollBox, { ref: scrollRef, flexDirection: "column", flexGrow: 1, flexShrink: 1, paddingX: 2, children: [primaryShortcuts, secondaryShortcuts, _jsx(Text, { dimColor: true, children: t('help-commands-title') }), compactCommandRows] })) : (_jsxs(Box, { paddingX: 2, flexDirection: "row", gap: 4, flexGrow: 1, children: [primaryShortcuts, secondaryShortcuts, _jsx(ScrollBox, { ref: scrollRef, flexDirection: "column", flexGrow: 1, flexShrink: 1, children: commandList })] })), _jsx(Box, { paddingX: 2, flexShrink: 0, children: _jsx(Text, { dimColor: true, wrap: "truncate-end", children: t('help-scroll-hint') }) })] }));
 }

package/lib/types/components/LoadedContextPanel.js

@@ -26,5 +26,5 @@ export function LoadedContextPanel({ context, open, onToggle, }) {
     const summary = summarizeLoadedContext(context);
     if (summary === '')
         return null;
-    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginBottom: 1, children: [_jsx(Box, { paddingX: 1, backgroundColor: open ? 'userMessageBackground' : undefined, children: _jsxs(Text, { bold: open, wrap: "truncate", children: [open ? '▼' : '▶', " ", _jsxs(Text, { dimColor: true, children: ["\uFF08Ctrl+P", open ? t('context-panel-collapse') : t('context-panel-expand'), "\uFF09"] }), " ", t('context-loaded'), " \u00B7 ", summary] }) }), open && (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingTop: 1, children: [context.sections.length > 0 && (_jsx(Group, { title: t('context-panel-sections', { n: context.sections.length }), children: context.sections.map(section => (_jsx(Entry, { entry: section }, section.name))) })), context.files.length > 0 && (_jsx(Group, { title: t('context-panel-files', { n: context.files.length }), children: context.files.map(file => (_jsx(Text, { dimColor: true, children: file.displayPath }, file.displayPath))) })), context.contexts.length > 0 && (_jsx(Group, { title: t('context-panel-runtime', { n: context.contexts.length }), children: context.contexts.map(entry => (_jsx(Entry, { entry: entry }, entry.name))) })), context.skills.length > 0 && (_jsx(Group, { title: t('context-panel-skills', { n: context.skills.length }), children: context.skills.map(skill => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: skill.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: skill.description })] }, skill.name))) })), context.tools.length > 0 && (_jsx(Group, { title: t('context-panel-tools', { n: context.tools.length }), children: context.tools.map(tool => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: tool.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: truncateContextText(tool.description, 160) })] }, tool.name))) })), _jsx(Text, { dimColor: true, children: "\u00B7 /context" })] }))] }));
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginBottom: 1, children: [_jsx(Box, { paddingX: 1, backgroundColor: open ? 'userMessageBackgroundHover' : undefined, children: _jsxs(Text, { bold: open, wrap: "truncate", children: [open ? '▼' : '▶', " ", _jsxs(Text, { dimColor: true, children: ["\uFF08Ctrl+P", open ? t('context-panel-collapse') : t('context-panel-expand'), "\uFF09"] }), " ", t('context-loaded'), " \u00B7 ", summary] }) }), open && (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingTop: 1, children: [context.sections.length > 0 && (_jsx(Group, { title: t('context-panel-sections', { n: context.sections.length }), children: context.sections.map(section => (_jsx(Entry, { entry: section }, section.name))) })), context.files.length > 0 && (_jsx(Group, { title: t('context-panel-files', { n: context.files.length }), children: context.files.map(file => (_jsx(Text, { dimColor: true, children: file.displayPath }, file.displayPath))) })), context.contexts.length > 0 && (_jsx(Group, { title: t('context-panel-runtime', { n: context.contexts.length }), children: context.contexts.map(entry => (_jsx(Entry, { entry: entry }, entry.name))) })), context.skills.length > 0 && (_jsx(Group, { title: t('context-panel-skills', { n: context.skills.length }), children: context.skills.map(skill => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: skill.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: skill.description })] }, skill.name))) })), context.tools.length > 0 && (_jsx(Group, { title: t('context-panel-tools', { n: context.tools.length }), children: context.tools.map(tool => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: tool.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: truncateContextText(tool.description, 160) })] }, tool.name))) })), _jsx(Text, { dimColor: true, children: "\u00B7 /context" })] }))] }));
 }

package/lib/types/components/LogoV2.d.ts

@@ -14,7 +14,7 @@ import { type Tip } from '../tips.js';
  * the whale the welcome tagline, centered under the art, in ice
  * blue. Narrow terminals drop the whale and keep the text column.
  */
-export declare function LogoV2({ model, effort, cwd, skipIntro, tip, }: {
+export declare function LogoV2({ model, effort, cwd, skipIntro, tip, whale, }: {
     model: string;
     effort?: string | undefined;
     cwd: string;
@@ -22,5 +22,7 @@ export declare function LogoV2({ model, effort, cwd, skipIntro, tip, }: {
     skipIntro?: boolean;
     /** Test seam: pin the startup tip line (probes need a deterministic tip). */
     tip?: Tip;
+    /** Show the pixel whale art (settings `dsh-tui.whale`); off → text-only header. */
+    whale?: boolean;
 }): React.ReactNode;
 //# sourceMappingURL=LogoV2.d.ts.map