@deepseek-harness-tui/dsh-tui 0.5.1 → 0.5.3

package/lib/types/components/PromptInput.js

@@ -8,6 +8,7 @@ import { formatClipboardInsert, readClipboard } from '../utils/clipboard.js';
 import { filterCommands, parseCommandName } from '../commands.js';
 import { appendHistory } from '../history.js';
 import { mentionAtCaret } from '../utils/mentions.js';
+import { isMod } from '../utils/modifiers.js';
 import { CommandSuggestions } from './CommandSuggestions.js';
 import { FileSuggestions } from './FileSuggestions.js';
 import { HelpMenu } from './HelpMenu.js';
@@ -347,10 +348,10 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             insertAtCaret(input.replace(/\r\n/g, '\n').replace(/\r/g, '\n'));
             return;
         }
-        // Ctrl+V: raw mode hands the key to the app, so the clipboard is read
-        // here — text, or file paths when Explorer copied files (pasted files
-        // insert their paths).
-        if (key.ctrl && input === 'v') {
+        // Ctrl+V / Cmd+V: raw mode hands the key to the app, so the clipboard is
+        // read here — text, or file paths when Explorer copied files (pasted
+        // files insert their paths).
+        if (isMod(key) && input === 'v') {
             if (clipboardBusyRef.current)
                 return;
             clipboardBusyRef.current = true;
@@ -425,9 +426,9 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 submitText(line);
             return;
         }
-        if (key.return && key.ctrl) {
-            // Ctrl+Enter: interrupt the running turn and process this message
-            // immediately (Windows Terminal sends CSI 13;5u / 13;1;5u).
+        if (key.return && isMod(key)) {
+            // Ctrl+Enter / Cmd+Enter: interrupt the running turn and process this
+            // message immediately (Windows Terminal sends CSI 13;5u / 13;1;5u).
             interruptSend();
             return;
         }
@@ -537,12 +538,12 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             setCursor(previous => Math.min(value.length, previous + 1));
             return;
         }
-        if (key.ctrl && key.leftArrow) {
+        if (isMod(key) && key.leftArrow) {
             // Jump to the previous word boundary (readline alt+b).
             setCursor(previous => wordBoundaryLeft(value, previous));
             return;
         }
-        if (key.ctrl && key.rightArrow) {
+        if (isMod(key) && key.rightArrow) {
             // Jump to the next word boundary (readline alt+f).
             setCursor(previous => wordBoundaryRight(value, previous));
             return;
@@ -572,31 +573,31 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             setCursor(nextLine === -1 ? value.length : nextLine);
             return;
         }
-        if (key.ctrl && input === 'a') {
+        if (isMod(key) && input === 'a') {
             const lineStart = value.lastIndexOf('\n', cursor - 1) + 1;
             setCursor(lineStart);
             return;
         }
-        if (key.ctrl && input === 'e') {
+        if (isMod(key) && input === 'e') {
             const nextLine = value.indexOf('\n', cursor);
             setCursor(nextLine === -1 ? value.length : nextLine);
             return;
         }
-        if (key.ctrl && input === 'u') {
+        if (isMod(key) && input === 'u') {
             // Delete to start of line.
             const lineStart = value.lastIndexOf('\n', cursor - 1) + 1;
             setValue(value.slice(0, lineStart) + value.slice(cursor));
             setCursor(lineStart);
             return;
         }
-        if (key.ctrl && input === 'k') {
+        if (isMod(key) && input === 'k') {
             // Delete to end of line.
             const nextLine = value.indexOf('\n', cursor);
             const end = nextLine === -1 ? value.length : nextLine;
             setValue(value.slice(0, cursor) + value.slice(end));
             return;
         }
-        if (key.ctrl && input === 'w') {
+        if (isMod(key) && input === 'w') {
             // Delete the word before the cursor (CC/readline behavior): skip
             // trailing whitespace, then the whitespace-delimited word.
             const before = value.slice(0, cursor);
@@ -678,7 +679,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             onToggleHelp();
             return;
         }
-        if (input && !key.ctrl && !key.meta && !key.tab && !key.escape) {
+        if (input && !key.ctrl && !key.meta && !key.super && !key.tab && !key.escape) {
             // Typing anything else dismisses the help menu (CC behavior).
             if (helpOpen)
                 onToggleHelp();

package/lib/types/components/approvals/ApprovalPanel.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The approval panel — Claude Code style permission prompt for the DSH
+ * approval seam (`ctx.approval`). One ask per panel: a permission-colored
+ * divider header naming the tool, the gated command recovered from the
+ * paired tool call (CC verbose full-command semantics), the asker's reason,
+ * "Do you want to proceed?", and a numbered Yes/No list.
+ *
+ * The protocol's outcome set is closed (allowed-once / rejected /
+ * cancelled / unavailable) with no allow-always or feedback channel, so
+ * the panel deliberately offers exactly two rows; Esc and Ctrl+C reject
+ * (fail closed, CC's "Esc to cancel" semantics).
+ */
+import React from 'react';
+import type { ApprovalSnapshot } from '../../approvals.js';
+export type ApprovalPanelProps = {
+    /** The approval to render (from the ApprovalStore snapshot). */
+    readonly approval: ApprovalSnapshot;
+    readonly onDecide: (outcome: 'allowed-once' | 'rejected') => void;
+};
+export declare function ApprovalPanel({ approval, onDecide }: ApprovalPanelProps): React.ReactNode;
+//# sourceMappingURL=ApprovalPanel.d.ts.map

package/lib/types/components/approvals/ApprovalPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApprovalPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/approvals/ApprovalPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,KAAK,IAAI,CAAA;CAClE,CAAA;AAID,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,SAAS,CAmEzF"}

package/lib/types/components/approvals/ApprovalPanel.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The approval panel — Claude Code style permission prompt for the DSH
+ * approval seam (`ctx.approval`). One ask per panel: a permission-colored
+ * divider header naming the tool, the gated command recovered from the
+ * paired tool call (CC verbose full-command semantics), the asker's reason,
+ * "Do you want to proceed?", and a numbered Yes/No list.
+ *
+ * The protocol's outcome set is closed (allowed-once / rejected /
+ * cancelled / unavailable) with no allow-always or feedback channel, so
+ * the panel deliberately offers exactly two rows; Esc and Ctrl+C reject
+ * (fail closed, CC's "Esc to cancel" semantics).
+ */
+import React from 'react';
+import { t } from '../../i18n.js';
+import { Box, Text, useInput } from '../../ui.js';
+import { Divider } from '../design-system/Divider.js';
+import { POINTER } from '../../cc/figures.js';
+const OUTCOMES = ['allowed-once', 'rejected'];
+export function ApprovalPanel({ approval, onDecide }) {
+    const [focusIndex, setFocusIndex] = React.useState(0);
+    useInput((input, key) => {
+        if (key.escape || (key.ctrl && input === 'c')) {
+            onDecide('rejected');
+            return;
+        }
+        if (key.upArrow) {
+            setFocusIndex(index => (index + OUTCOMES.length - 1) % OUTCOMES.length);
+            return;
+        }
+        if (key.downArrow) {
+            setFocusIndex(index => (index + 1) % OUTCOMES.length);
+            return;
+        }
+        if (input === '1' || input === '2') {
+            onDecide(OUTCOMES[Number(input) - 1]);
+            return;
+        }
+        if (key.return) {
+            onDecide(OUTCOMES[focusIndex]);
+        }
+    }, { isActive: true });
+    const optionLabels = [t('approval-yes'), t('approval-no')];
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 2, paddingRight: 2, width: "100%", children: [_jsx(Divider, { color: "permission", title: t('approval-waiting', { tool: approval.toolName }), padding: 4 }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [approval.command !== undefined && (_jsx(Box, { flexDirection: "column", paddingX: 2, children: _jsx(Text, { dimColor: true, wrap: "wrap", children: approval.command }) })), approval.reason !== undefined && (_jsx(Text, { dimColor: true, wrap: "wrap", children: approval.reason })), _jsx(Text, { dimColor: true, children: t('approval-proceed') })] }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: optionLabels.map((label, index) => {
+                    const focused = index === focusIndex;
+                    return (_jsxs(Box, { flexDirection: "row", marginTop: focused ? 1 : 0, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'claude' : undefined, bold: focused, children: focused ? POINTER : ' ' }) }), _jsxs(Text, { bold: focused, color: focused ? 'claude' : undefined, wrap: "wrap", children: [index + 1, ". ", label] })] }, label));
+                }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: t('approval-hint') }) })] }));
+}

package/lib/types/components/questions/AskUserQuestionPanel.d.ts

@@ -24,6 +24,12 @@ export type AskUserQuestionPanelProps = {
             readonly description?: string;
         }>;
         readonly multiSelect?: boolean;
+        /** Presentation intent tag (rc.6): 'plan-review' switches to the
+         *  decision-card layout; an intent never changes the protocol. */
+        readonly intent?: {
+            readonly kind: 'plan-review';
+            readonly approve: string;
+        };
     };
     /** 1-based position within the batch (progress header). */
     readonly position: number;

package/lib/types/components/questions/AskUserQuestionPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AskUserQuestionPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/questions/AskUserQuestionPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAM3D,MAAM,MAAM,yBAAyB,GAAG;IACtC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;YAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC3F,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAC/B,CAAA;IACD,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACzD,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAC9B,CAAA;AAED,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE,yBAAyB,GAAG,KAAK,CAAC,SAAS,CA8S7C"}
+{"version":3,"file":"AskUserQuestionPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/questions/AskUserQuestionPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAO3D,MAAM,MAAM,yBAAyB,GAAG;IACtC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;YAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC3F,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;QAC9B;0EACkE;QAClE,QAAQ,CAAC,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;YAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAC7E,CAAA;IACD,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACzD,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAC9B,CAAA;AAED,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE,yBAAyB,GAAG,KAAK,CAAC,SAAS,CAoT7C"}

package/lib/types/components/questions/AskUserQuestionPanel.js

@@ -17,10 +17,17 @@ import { t } from '../../i18n.js';
 import { Box, Text, useInput } from '../../ui.js';
 import { Divider } from '../design-system/Divider.js';
 import { POINTER } from '../../cc/figures.js';
+import { PlanReviewPanel } from './PlanReviewPanel.js';
 const CHECKED = '◉';
 const UNCHECKED = '○';
 const PENCIL = '✎';
 export function AskUserQuestionPanel({ question, position, total, answered, onAnswer, onCancel, }) {
+    // Plan-mode's exit_plan_mode ask carries a presentation intent: render
+    // the CC-style decision card instead of the generic questionnaire. The
+    // branch precedes every hook so hook order stays stable per remount key.
+    if (question.intent?.kind === 'plan-review') {
+        return _jsx(PlanReviewPanel, { question: question, onAnswer: onAnswer, onCancel: onCancel });
+    }
     const options = question.options ?? [];
     const multiSelect = question.multiSelect === true;
     /** Rows: the real options plus the inline input row at the tail. */
@@ -147,7 +154,7 @@ export function AskUserQuestionPanel({ question, position, total, answered, onAn
                 setCustomCursor(customText.length);
                 return;
             }
-            if (!key.ctrl && !key.meta && input) {
+            if (!key.ctrl && !key.meta && !key.super && input) {
                 setCustomText(text => text.slice(0, customCursor) + input + text.slice(customCursor));
                 setCustomCursor(cursor => cursor + input.length);
                 setError(null);
@@ -191,7 +198,7 @@ export function AskUserQuestionPanel({ question, position, total, answered, onAn
         }
         // Typing on an option appends into the input row; single-select also
         // attaches this option's label so Enter carries label + text (#9).
-        if (!key.ctrl && !key.meta && input) {
+        if (!key.ctrl && !key.meta && !key.super && input) {
             appendText(input);
             if (!multiSelect)
                 setAttached(options[focusIndex]?.label ?? null);

package/lib/types/components/questions/PlanReviewPanel.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The plan-review panel — Claude Code style exit-plan-mode decision card
+ * for the DSH user-interaction seam. plan-mode's `exit_plan_mode` tool asks
+ * through `ctx.userQuestions` with `intent: { kind: 'plan-review',
+ * approve }`: the plan markdown arrives in `detail`, the approve/decline
+ * choices in `options` (labels verbatim — the protocol answers with the
+ * asker's own labels).
+ *
+ * Protocol-exact answer mapping (dsh-plan-mode):
+ * - Approve: `{ selected: [intent.approve] }` — custom MUST be absent, or
+ *   plan-mode treats it as keep-planning-with-feedback.
+ * - Keep planning / feedback: `{ selected: [declineLabel], custom? }` where
+ *   declineLabel is the first option that is not the approve label.
+ * - Esc / Ctrl+C: the store rejects with ASK_CANCELLED, which plan-mode
+ *   reads as "the user dismissed the review to speak instead".
+ */
+import React from 'react';
+import type { QuestionSelection } from '../../questions.js';
+export type PlanReviewPanelProps = {
+    /** The plan-review question (intent.kind === 'plan-review'). */
+    readonly question: {
+        readonly question: string;
+        readonly header?: string;
+        readonly detail?: string;
+        readonly options?: ReadonlyArray<{
+            readonly label: string;
+            readonly description?: string;
+        }>;
+        readonly intent?: {
+            readonly kind: 'plan-review';
+            readonly approve: string;
+        };
+    };
+    readonly onAnswer: (selection: QuestionSelection) => void;
+    /** Esc / Ctrl+C — dismissed to speak instead (ASK_CANCELLED). */
+    readonly onCancel: () => void;
+};
+export declare function PlanReviewPanel({ question, onAnswer, onCancel, }: PlanReviewPanelProps): React.ReactNode;
+//# sourceMappingURL=PlanReviewPanel.d.ts.map

package/lib/types/components/questions/PlanReviewPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanReviewPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/questions/PlanReviewPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAI3D,MAAM,MAAM,oBAAoB,GAAG;IACjC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;YAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC3F,QAAQ,CAAC,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;YAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAC7E,CAAA;IACD,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACzD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAC9B,CAAA;AAED,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CAgOxC"}

package/lib/types/components/questions/PlanReviewPanel.js

@@ -0,0 +1,168 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The plan-review panel — Claude Code style exit-plan-mode decision card
+ * for the DSH user-interaction seam. plan-mode's `exit_plan_mode` tool asks
+ * through `ctx.userQuestions` with `intent: { kind: 'plan-review',
+ * approve }`: the plan markdown arrives in `detail`, the approve/decline
+ * choices in `options` (labels verbatim — the protocol answers with the
+ * asker's own labels).
+ *
+ * Protocol-exact answer mapping (dsh-plan-mode):
+ * - Approve: `{ selected: [intent.approve] }` — custom MUST be absent, or
+ *   plan-mode treats it as keep-planning-with-feedback.
+ * - Keep planning / feedback: `{ selected: [declineLabel], custom? }` where
+ *   declineLabel is the first option that is not the approve label.
+ * - Esc / Ctrl+C: the store rejects with ASK_CANCELLED, which plan-mode
+ *   reads as "the user dismissed the review to speak instead".
+ */
+import React from 'react';
+import { t } from '../../i18n.js';
+import { Box, Text, useInput } from '../../ui.js';
+import { Divider } from '../design-system/Divider.js';
+import { Markdown } from '../Markdown.js';
+import { POINTER } from '../../cc/figures.js';
+const PENCIL = '✎';
+export function PlanReviewPanel({ question, onAnswer, onCancel, }) {
+    const options = question.options ?? [];
+    const approveLabel = question.intent?.approve ?? options[0]?.label;
+    const declineLabel = options.find(option => option.label !== approveLabel)?.label;
+    /** Rows: the asker's options plus the feedback input row at the tail. */
+    const rowCount = options.length + 1;
+    const [focusIndex, setFocusIndex] = React.useState(0);
+    const [feedback, setFeedback] = React.useState('');
+    const [cursor, setCursor] = React.useState(0);
+    const [error, setError] = React.useState(null);
+    const inputFocused = focusIndex === options.length;
+    const moveFocus = (delta) => {
+        setFocusIndex(index => (index + delta + rowCount) % rowCount);
+        setError(null);
+    };
+    /** Typing anywhere appends to the feedback buffer and focuses the input
+     *  row — plan review has no "attach" semantics: approve must be clean. */
+    const appendFeedback = (text) => {
+        setFeedback(previous => previous + text);
+        setCursor(previous => previous + text.length);
+        setFocusIndex(options.length);
+        setError(null);
+    };
+    const backspaceFeedback = () => {
+        if (cursor <= 0)
+            return;
+        setFeedback(previous => previous.slice(0, cursor - 1) + previous.slice(cursor));
+        setCursor(previous => previous - 1);
+    };
+    /** The decline answer: the other option's label when the asker named one,
+     *  else an empty selection (plan-mode reads any non-approve as decline). */
+    const declineSelected = () => declineLabel !== undefined ? [declineLabel] : [];
+    /** Enter on an option row. Approve with feedback in the buffer is an
+     *  error — the protocol would silently read it as keep-planning. */
+    const submitOption = (index) => {
+        const label = options[index]?.label;
+        if (label === undefined)
+            return;
+        const text = feedback.trim();
+        if (label === approveLabel && text !== '') {
+            setError(t('plan-review-approve-needs-empty'));
+            return;
+        }
+        if (label === approveLabel) {
+            onAnswer({ selected: [label] });
+            return;
+        }
+        onAnswer({ selected: [label], ...(text !== '' ? { custom: text } : {}) });
+    };
+    /** Enter on the feedback row: text routes to keep-planning-with-feedback;
+     *  empty is a plain keep-planning. */
+    const submitFeedback = () => {
+        const text = feedback.trim();
+        onAnswer({ selected: declineSelected(), ...(text !== '' ? { custom: text } : {}) });
+    };
+    useInput((input, key) => {
+        if (key.escape || (key.ctrl && input === 'c')) {
+            onCancel();
+            return;
+        }
+        if (inputFocused) {
+            if (key.upArrow) {
+                moveFocus(-1);
+                return;
+            }
+            if (key.downArrow) {
+                moveFocus(1);
+                return;
+            }
+            if (key.return) {
+                submitFeedback();
+                return;
+            }
+            if (key.backspace) {
+                backspaceFeedback();
+                return;
+            }
+            if (key.delete) {
+                if (cursor < feedback.length) {
+                    setFeedback(text => text.slice(0, cursor) + text.slice(cursor + 1));
+                }
+                return;
+            }
+            if (key.leftArrow) {
+                setCursor(value => Math.max(0, value - 1));
+                return;
+            }
+            if (key.rightArrow) {
+                setCursor(value => Math.min(feedback.length, value + 1));
+                return;
+            }
+            if (key.home) {
+                setCursor(0);
+                return;
+            }
+            if (key.end) {
+                setCursor(feedback.length);
+                return;
+            }
+            if (!key.ctrl && !key.meta && input) {
+                setFeedback(text => text.slice(0, cursor) + input + text.slice(cursor));
+                setCursor(value => value + input.length);
+                setError(null);
+            }
+            return;
+        }
+        // An option row.
+        if (key.upArrow) {
+            moveFocus(-1);
+            return;
+        }
+        if (key.downArrow) {
+            moveFocus(1);
+            return;
+        }
+        if (key.return) {
+            submitOption(focusIndex);
+            return;
+        }
+        if (key.backspace) {
+            if (feedback !== '')
+                backspaceFeedback();
+            return;
+        }
+        if (!key.ctrl && !key.meta && input) {
+            // Number quick-pick submits the option outright — but only with an
+            // empty buffer; with feedback pending, digits are feedback chars.
+            const digit = /^[1-9]$/.test(input) ? Number(input) : 0;
+            if (feedback === '' && digit >= 1 && digit <= options.length) {
+                submitOption(digit - 1);
+                return;
+            }
+            appendFeedback(input);
+        }
+    }, { isActive: true });
+    const cursorChar = cursor < feedback.length ? feedback[cursor] : ' ';
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 2, paddingRight: 2, width: "100%", children: [_jsx(Divider, { color: "permission", title: ` ${question.header ?? t('plan-review-fallback-header')} `, padding: 4 }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, wrap: "wrap", children: question.question }), question.detail !== undefined && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(Markdown, { children: question.detail }) }))] }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [options.map((option, index) => {
+                        const focused = index === focusIndex;
+                        const isApprove = option.label === approveLabel;
+                        return (_jsxs(Box, { flexDirection: "row", marginTop: focused ? 1 : 0, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'claude' : undefined, bold: focused, children: focused ? POINTER : ' ' }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 1, children: [_jsxs(Text, { bold: focused, color: focused || isApprove ? 'claude' : undefined, wrap: "wrap", children: [index + 1, ". ", option.label] }), option.description !== undefined && (_jsx(Text, { dimColor: true, wrap: "wrap", children: option.description }))] })] }, option.label));
+                    }), _jsxs(Box, { flexDirection: "row", marginTop: inputFocused ? 1 : 0, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: inputFocused ? 'claude' : undefined, bold: inputFocused, children: inputFocused ? POINTER : ' ' }) }), _jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: inputFocused ? 'claude' : 'suggestion', children: PENCIL }) }), _jsx(Box, { flexDirection: "row", marginLeft: 1, children: feedback === '' && !inputFocused ? (_jsx(Text, { dimColor: true, children: t('plan-review-feedback-placeholder') })) : (_jsxs(_Fragment, { children: [_jsx(Text, { wrap: "wrap", children: feedback.slice(0, cursor) }), inputFocused
+                                            ? _jsx(Text, { inverse: true, children: cursorChar })
+                                            : _jsx(Text, { color: "suggestion", children: "\u258F" }), _jsx(Text, { wrap: "wrap", children: feedback.slice(inputFocused ? cursor + 1 : cursor) })] })) })] })] }), error !== null && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "error", children: error }) })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: t('plan-review-hint') }) })] }));
+}

package/lib/types/i18n.d.ts

@@ -584,8 +584,8 @@ declare const dict: {
         readonly en: "Recommended: Windows Terminal (≥110 columns, monospace, TrueColor).";
     };
     readonly 'terminal-paste-hint': {
-        readonly zh: "Ctrl+V 粘贴文本/文件路径；Ctrl+Shift+V 终端原生粘贴；右键粘贴同样可用。";
-        readonly en: "Ctrl+V pastes text/file paths; Ctrl+Shift+V is native terminal paste; right-click paste also works.";
+        readonly zh: "{{mod}}V 粘贴文本/文件路径；Ctrl+Shift+V 终端原生粘贴；右键粘贴同样可用。";
+        readonly en: "{{mod}}V pastes text/file paths; Ctrl+Shift+V is native terminal paste; right-click paste also works.";
     };
     readonly 'connect-none': {
         readonly zh: "DSH 暂无远程连接机制（CC 的 /connect 对应能力未适配）。";
@@ -855,6 +855,168 @@ declare const dict: {
         readonly zh: "直接输入…";
         readonly en: "Type directly…";
     };
+    readonly 'approval-waiting': {
+        readonly zh: " ⏳ 等待审批 · {{tool}} ";
+        readonly en: " Awaiting approval · {{tool}} ";
+    };
+    readonly 'approval-proceed': {
+        readonly zh: "要允许这次操作吗？";
+        readonly en: "Do you want to proceed?";
+    };
+    readonly 'approval-yes': {
+        readonly zh: "允许（仅本次）";
+        readonly en: "Yes, allow once";
+    };
+    readonly 'approval-no': {
+        readonly zh: "拒绝";
+        readonly en: "No";
+    };
+    readonly 'approval-hint': {
+        readonly zh: "↑/↓ 选择 · Enter 确认 · Esc 拒绝";
+        readonly en: "↑/↓ select · Enter confirm · Esc reject";
+    };
+    readonly 'plan-review-fallback-header': {
+        readonly zh: "计划评审";
+        readonly en: "Plan review";
+    };
+    readonly 'plan-review-feedback-placeholder': {
+        readonly zh: "输入反馈，告诉模型要改什么…";
+        readonly en: "Tell the model what to change…";
+    };
+    readonly 'plan-review-approve-needs-empty': {
+        readonly zh: "请先清空反馈再批准（或在输入行回车提交反馈）";
+        readonly en: "Clear the feedback to approve (or press Enter on the input row to send it)";
+    };
+    readonly 'plan-review-hint': {
+        readonly zh: "↑/↓ 选择 · 1/2 快选 · 打字输入反馈 · Enter 提交 · Esc 打断评审";
+        readonly en: "↑/↓ select · 1/2 quick-pick · type feedback · Enter submit · Esc dismiss";
+    };
+    readonly 'cmd-desc-new': {
+        readonly zh: "新开会话";
+    };
+    readonly 'cmd-desc-clear': {
+        readonly zh: "清空当前会话";
+    };
+    readonly 'cmd-desc-compact': {
+        readonly zh: "压缩会话历史";
+    };
+    readonly 'cmd-desc-resume': {
+        readonly zh: "恢复历史会话";
+    };
+    readonly 'cmd-desc-rewind': {
+        readonly zh: "回退会话到历史消息";
+    };
+    readonly 'cmd-desc-export': {
+        readonly zh: "导出会话为 Markdown 文件";
+    };
+    readonly 'cmd-desc-status': {
+        readonly zh: "查看会话状态";
+    };
+    readonly 'cmd-desc-cost': {
+        readonly zh: "查看会话 token 用量";
+    };
+    readonly 'cmd-desc-config': {
+        readonly zh: "查看 dsh-cc 配置来源";
+    };
+    readonly 'cmd-desc-doctor': {
+        readonly zh: "运行环境检查";
+    };
+    readonly 'cmd-desc-init': {
+        readonly zh: "在工作目录创建 AGENTS.md";
+    };
+    readonly 'cmd-desc-agents': {
+        readonly zh: "查看本会话的子代理";
+    };
+    readonly 'cmd-desc-activity': {
+        readonly zh: "切换工作状态指示器预设";
+    };
+    readonly 'cmd-desc-preset': {
+        readonly zh: "切换 Agent 预设（standard/code/minimal/cordis）";
+    };
+    readonly 'cmd-desc-theme': {
+        readonly zh: "切换配色主题（内置或自定义）";
+    };
+    readonly 'cmd-desc-lang': {
+        readonly zh: "切换界面语言（en / zh）";
+    };
+    readonly 'cmd-desc-model': {
+        readonly zh: "查看当前模型";
+    };
+    readonly 'cmd-desc-thinking': {
+        readonly zh: "切换扩展思考显示";
+    };
+    readonly 'cmd-desc-tokens': {
+        readonly zh: "查看会话 token 用量";
+    };
+    readonly 'cmd-desc-login': {
+        readonly zh: "查看 API 凭证状态";
+    };
+    readonly 'cmd-desc-logout': {
+        readonly zh: "清除 API 凭证";
+    };
+    readonly 'cmd-desc-permissions': {
+        readonly zh: "查看权限策略状态";
+    };
+    readonly 'cmd-desc-add-dir': {
+        readonly zh: "查看文件系统策略范围";
+    };
+    readonly 'cmd-desc-hooks': {
+        readonly zh: "查看 hooks 状态";
+    };
+    readonly 'cmd-desc-mcp': {
+        readonly zh: "查看 MCP 状态";
+    };
+    readonly 'cmd-desc-memory': {
+        readonly zh: "查看记忆状态";
+    };
+    readonly 'cmd-desc-update': {
+        readonly zh: "更新 dsh-cc-tui 并重启";
+    };
+    readonly 'cmd-desc-audit': {
+        readonly zh: "对当前项目做全面代码审计";
+    };
+    readonly 'cmd-desc-bug': {
+        readonly zh: "记录一份 bug 报告";
+    };
+    readonly 'cmd-desc-practice': {
+        readonly zh: "与 dsh-cc 进行编程练习";
+    };
+    readonly 'cmd-desc-review': {
+        readonly zh: "对当前项目做全面代码评审";
+    };
+    readonly 'cmd-desc-pr_comments': {
+        readonly zh: "审查拉取请求评论";
+    };
+    readonly 'cmd-desc-release-notes': {
+        readonly zh: "生成发布说明";
+    };
+    readonly 'cmd-desc-vuln-check': {
+        readonly zh: "运行安全漏洞检查";
+    };
+    readonly 'cmd-desc-vim': {
+        readonly zh: "切换 vim 模式";
+    };
+    readonly 'cmd-desc-terminal-setup': {
+        readonly zh: "查看终端配置建议";
+    };
+    readonly 'cmd-desc-connect': {
+        readonly zh: "连接远程机器";
+    };
+    readonly 'cmd-desc-help': {
+        readonly zh: "查看快捷键与命令";
+    };
+    readonly 'cmd-desc-exit': {
+        readonly zh: "退出 dsh-tui";
+    };
+    readonly 'cmd-desc-plan': {
+        readonly zh: "切换计划模式（/plan off 退出）";
+    };
+    readonly 'cmd-desc-goal': {
+        readonly zh: "设置或查看会话目标";
+    };
+    readonly 'cmd-desc-feedback': {
+        readonly zh: "提交使用反馈";
+    };
     readonly 'lang-current': {
         readonly zh: "当前语言  {{lang}}";
         readonly en: "Current language  {{lang}}";
@@ -900,6 +1062,16 @@ export declare function isLang(value: unknown): value is Lang;
  * @param params - Placeholder values.
  */
 export declare function t(key: I18nKey, params?: I18nParams): string;
+/**
+ * Translate a runtime-computed key (e.g. `cmd-desc-${name}`), falling back
+ * to the given text when the key is missing or has no entry in the active
+ * language — unlike {@link t}, which renders the key itself. Used where the
+ * fallback holds the authoritative text (command descriptions: the en copy
+ * lives in `LOCAL_COMMANDS` / the DSH registry, the dict carries zh only).
+ * @param key - Dictionary key, computed at runtime so it is not type-checked.
+ * @param fallback - Text used when no translation exists.
+ */
+export declare function tOr(key: string, fallback: string): string;
 /**
  * Parse a persisted `{ lang }` value; anything else yields undefined.
  * @param text - Raw file contents.

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

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAI9B,+DAA+D;AAC/D,eAAO,MAAM,KAAK,uBAAwB,CAAA;AAE1C,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyPA,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,IAAI,CAAA;AACvC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;AAOxD,uEAAuE;AACvE,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAA;AAG1B,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAG5D;AAED,qCAAqC;AACrC,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED,yDAAyD;AACzD,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAGxC;AAED,iDAAiD;AACjD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,UAAe,GAAG,MAAM,CAM/D;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAS5D;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAkB,GAAG,IAAI,GAAG,SAAS,CAMtE;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAE,MAAkB,GAAG,OAAO,CAQ1E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAUvC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/i18n.ts"],"names":[],"mappings":"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"}