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

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

@@ -11,6 +11,8 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
  * appends into that input row (single-select also attaches the option's
  * label, so the answer can carry both `selected` and `custom`); focusing
  * the input row itself and typing gives a pure custom answer.
+ * Local /provider model lists additionally offer a Tab capability editor;
+ * ordinary questionnaires retain the inline-answer behavior.
  *
  * Paste works on the input row like the composer: Ctrl+V/Alt+V (the keymap
  * `paste` binding, remappable in /settings) reads the system clipboard,
@@ -32,11 +34,13 @@ import { useDeclaredCursor } from '../../ink/hooks/use-declared-cursor.js';
 import { Divider } from '../design-system/Divider.js';
 import { POINTER } from '../../terminal-utils/figures.js';
 import { PlanReviewPanel } from './PlanReviewPanel.js';
+import { ProviderModelEditor } from './ProviderModelEditor.js';
 import { QuestionMinimizedBar } from './QuestionMinimizedBar.js';
 import { isPlainReturnInput } from '../../utils/modifiers.js';
 import { actionMatches, comboDisplay, effectiveComboDisplay, primaryComboString } from '../../utils/keymap.js';
 import { flattenPasteInline } from '../../dsh-adapter/sanitize.js';
 import { readClipboard } from '../../utils/clipboard.js';
+import { createHyperlink } from '../../terminal-utils/hyperlink.js';
 import { listWindow } from '../listWindow.js';
 /** Unmodified arrows switch questions; Ctrl/Alt/Super/Shift stay caret motion. */
 function isPlainArrow(key) {
@@ -45,6 +49,8 @@ function isPlainArrow(key) {
 const CHECKED = '◉';
 const UNCHECKED = '○';
 const PENCIL = '✎';
+/** One masked code point of a secret answer (`question.secret`). */
+const SECRET_MASK = '•';
 /**
  * Paste cap for one answer field, in code points. Typing is naturally
  * bounded (humans cannot type unboundedly) and the protocol places no
@@ -65,6 +71,13 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
     const options = question.options ?? [];
     const multiSelect = question.multiSelect === true;
     const hideCustomInput = question.hideCustomInput === true && options.length > 0;
+    const modelEditor = typeof question.modelEditor?.read === 'function'
+        && typeof question.modelEditor.save === 'function' && typeof question.modelEditor.edited === 'function'
+        ? question.modelEditor : undefined;
+    const [editingModel, setEditingModel] = React.useState(null);
+    // Opening Tab and later keys may share one stdin batch. Stop the list
+    // synchronously, before the nested editor has had a chance to mount.
+    const editingRef = React.useRef(false);
     const { rows: terminalRows } = useTerminalSize();
     /** Rows: the real options plus the inline input row at the tail. */
     const rowCount = options.length + (hideCustomInput ? 0 : 1);
@@ -143,7 +156,9 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
     // Optional header/detail/input/error rows are charged explicitly. Long
     // lists then use fixed one/two-line rows so listWindow's budget is exact;
     // short questionnaires retain their existing wrapped presentation.
-    const detailRows = question.detail === undefined ? 0 : question.detail.split('\n').length + 1;
+    const linkText = question.link === undefined || question.link === '' ? '' : createHyperlink(question.link);
+    const detailRows = (question.detail === undefined ? 0 : question.detail.split('\n').length + 1)
+        + (linkText === '' ? 0 : question.detail === undefined ? 2 : 1);
     const reservedRows = 12
         + (question.header === undefined ? 0 : 1)
         + detailRows
@@ -166,7 +181,7 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
     // three visual variants): its nodeCache rect IS the caret cell, so (0, 0)
     // stays exact under CJK widths and line wrapping without any
     // layout-affecting wrapper Box.
-    const caretRef = useDeclaredCursor({ line: 0, column: 0, active: !hideCustomInput && !collapsed });
+    const caretRef = useDeclaredCursor({ line: 0, column: 0, active: !hideCustomInput && !collapsed && editingModel === null });
     const moveFocus = (delta) => {
         if (rowCount <= 1)
             return;
@@ -309,7 +324,34 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
             ...(textRef.current !== '' ? { custom: textRef.current } : {}),
         };
     };
+    const openModelEditor = (model, event) => {
+        editingRef.current = true;
+        setEditingModel(model);
+        event.stopImmediatePropagation();
+    };
+    const manualModelAtCaret = () => {
+        const points = [...textRef.current];
+        const isSeparator = (char) => char === undefined || /[,，\s]/u.test(char);
+        let at = Math.min(cursorRef.current, points.length);
+        if (at === points.length || isSeparator(points[at]))
+            at -= 1;
+        while (at >= 0 && isSeparator(points[at]))
+            at -= 1;
+        if (at < 0)
+            return '';
+        let start = at;
+        let end = at + 1;
+        while (start > 0 && !isSeparator(points[start - 1]))
+            start -= 1;
+        while (end < points.length && !isSeparator(points[end]))
+            end += 1;
+        return points.slice(start, end).join('');
+    };
     useInput((input, key, event) => {
+        if (editingRef.current) {
+            event.stopImmediatePropagation();
+            return;
+        }
         // The mounted panel owns folding, just like answering: hidden asks
         // cannot steal approval/dialog keys, and an interrupting questionnaire
         // still works when Chat yields to an underlying screen's open flag.
@@ -362,6 +404,16 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
             return;
         }
         if (onInputRow()) {
+            if (key.tab && modelEditor !== undefined) {
+                const manualModel = manualModelAtCaret();
+                if (manualModel !== '') {
+                    openModelEditor(manualModel, event);
+                    return;
+                }
+                placeFocus(0);
+                event.stopImmediatePropagation();
+                return;
+            }
             if (key.upArrow) {
                 moveFocus(-1);
                 return;
@@ -447,6 +499,13 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
                 onForward(currentDraft());
             return;
         }
+        if (key.tab && !key.shift && !key.ctrl && !key.meta && !key.super && modelEditor !== undefined) {
+            const model = options[focusRef.current]?.label;
+            if (model !== undefined) {
+                openModelEditor(model, event);
+            }
+            return;
+        }
         if (key.tab && !hideCustomInput) {
             placeFocus(options.length);
             setError(null);
@@ -483,8 +542,11 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
     const questionText = question.question.split('\n')[0]?.replace(/\s+/gu, ' ').trim() ?? '';
     // The caret counts code points (see the module header), so the caret
     // char and the visual split index into the point array — never raw
-    // UTF-16 offsets, which could land inside a surrogate pair.
-    const textPoints = [...customText];
+    // UTF-16 offsets, which could land inside a surrogate pair. A secret
+    // question paints one mask per code point instead: the same caret math,
+    // nothing of the typed text on screen.
+    const typedPoints = [...customText];
+    const textPoints = question.secret === true ? typedPoints.map(() => SECRET_MASK) : typedPoints;
     const cursorChar = customCursor < textPoints.length ? textPoints[customCursor] : ' ';
     /** Mouse: click the input row to focus it (same as Tab). */
     const focusInputRow = () => {
@@ -533,11 +595,12 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
                 const description = windowedOptions
                     ? option.description?.replace(/\s+/gu, ' ').trim()
                     : option.description;
-                return (_jsxs(Box, { flexDirection: "row", marginTop: !windowedOptions && focused ? 1 : 0, onClick: () => clickOption(absoluteIndex), onMouseEnter: () => setHoverIndex(absoluteIndex), onMouseLeave: () => setHoverIndex(current => (current === absoluteIndex ? -1 : current)), backgroundColor: hoverIndex === absoluteIndex && !focused ? 'userMessageBackgroundHover' : undefined, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'accent' : undefined, bold: focused, children: pointer }) }), _jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'accent' : undefined, bold: selected, children: selected ? (multiSelect ? CHECKED : '●') : UNCHECKED }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 1, children: [_jsx(Text, { bold: focused || selected, color: focused ? 'accent' : undefined, wrap: windowedOptions ? 'truncate' : 'wrap', children: label }), description !== undefined && (_jsx(Text, { dimColor: true, wrap: windowedOptions ? 'truncate' : 'wrap', children: description }))] })] }, `${absoluteIndex}:${option.label}`));
+                return (_jsxs(Box, { flexDirection: "row", marginTop: !windowedOptions && focused ? 1 : 0, onClick: () => clickOption(absoluteIndex), onMouseEnter: () => setHoverIndex(absoluteIndex), onMouseLeave: () => setHoverIndex(current => (current === absoluteIndex ? -1 : current)), backgroundColor: hoverIndex === absoluteIndex && !focused ? 'userMessageBackgroundHover' : undefined, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'accent' : undefined, bold: focused, children: pointer }) }), _jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'accent' : undefined, bold: selected, children: selected ? (multiSelect ? CHECKED : '●') : UNCHECKED }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 1, children: [_jsxs(Text, { bold: focused || selected, color: focused ? 'accent' : undefined, wrap: windowedOptions ? 'truncate' : 'wrap', children: [label, modelEditor?.edited(option.label) ? ` ${t('provider-model-edited')}` : ''] }), description !== undefined && (_jsx(Text, { dimColor: true, wrap: windowedOptions ? 'truncate' : 'wrap', children: description }))] })] }, `${absoluteIndex}:${option.label}`));
             }), hideCustomInput ? null : renderInputRow(), multiSelect && fullscreen && (checked.size > 0 || textRef.current !== '') && (_jsxs(Box, { flexDirection: "row", height: 1, marginTop: 1, onClick: submitOptions, onMouseEnter: () => setSubmitHovered(true), onMouseLeave: () => setSubmitHovered(false), backgroundColor: submitHovered ? 'userMessageBackgroundHover' : undefined, children: [_jsx(Text, { color: "accent", children: "\u2713 " }), _jsx(Text, { dimColor: true, children: t('question-submit-selection') })] }))] }));
     const hintParts = inputFocused
         ? [
             t('question-hint-type'),
+            ...(modelEditor === undefined ? [] : [t('provider-model-edit-hint')]),
             t('question-hint-paste', { key: comboDisplay(primaryComboString('paste')) }),
             t('question-hint-enter'),
             ...(options.length > 0 ? [t('question-hint-back')] : []),
@@ -550,6 +613,7 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
         : [
             t('question-hint-select'),
             ...(multiSelect ? [t('question-hint-multi')] : []),
+            ...(modelEditor === undefined ? [] : [t('provider-model-edit-hint')]),
             ...(hideCustomInput ? [] : [t('question-hint-paste', { key: comboDisplay(primaryComboString('paste')) }), t('question-hint-attach')]),
             t('question-hint-enter'),
             onBack === undefined ? t('question-hint-esc') : t('question-hint-previous'),
@@ -564,5 +628,11 @@ export function AskUserQuestionPanel({ question, position, total, answered, init
     if (collapsed) {
         return _jsx(QuestionMinimizedBar, { progress: headerTitle, questionText: questionText, onExpand: onExpand ?? (() => { }) });
     }
-    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 2, paddingRight: 2, width: "100%", children: [_jsx(Box, { flexDirection: "column", onClick: onToggleFold, onMouseEnter: () => setHeaderHovered(true), onMouseLeave: () => setHeaderHovered(false), backgroundColor: headerHovered ? 'userMessageBackgroundHover' : undefined, children: _jsx(Divider, { color: "permission", title: `▾${headerTitle}` }) }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [question.header !== undefined && (_jsxs(Text, { color: "suggestion", bold: true, children: ["\u25C8 ", question.header] })), _jsx(Text, { bold: true, wrap: "wrap", children: question.question }), question.detail !== undefined && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: question.detail.split('\n').map((line, index) => (_jsx(Text, { dimColor: true, italic: true, wrap: "wrap", children: line }, index))) }))] }), renderOptions(), error !== null && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "error", children: error }) })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: hintParts.join(' · ') }) })] }));
+    if (editingModel !== null && modelEditor !== undefined) {
+        return _jsx(ProviderModelEditor, { model: editingModel, editor: modelEditor, onClose: () => {
+                editingRef.current = false;
+                setEditingModel(null);
+            }, onAbort: onCancel, readClipboardOverride: readClipboardOverride });
+    }
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 2, paddingRight: 2, width: "100%", children: [_jsx(Box, { flexDirection: "column", onClick: onToggleFold, onMouseEnter: () => setHeaderHovered(true), onMouseLeave: () => setHeaderHovered(false), backgroundColor: headerHovered ? 'userMessageBackgroundHover' : undefined, children: _jsx(Divider, { color: "permission", title: `▾${headerTitle}` }) }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [question.header !== undefined && (_jsxs(Text, { color: "suggestion", bold: true, children: ["\u25C8 ", question.header] })), _jsx(Text, { bold: true, wrap: "wrap", children: question.question }), (question.detail !== undefined || linkText !== '') && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [question.detail?.split('\n').map((line, index) => (_jsx(Text, { dimColor: true, italic: true, wrap: "wrap", children: line }, index))), linkText !== '' && _jsx(Text, { wrap: "wrap", children: linkText })] }))] }), renderOptions(), error !== null && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "error", children: error }) })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: hintParts.join(' · ') }) })] }));
 }

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

@@ -8,9 +8,12 @@
  *
  * 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.
+ *   plan-mode treats it as keep-planning-with-feedback. An asker may name
+ *   further approving options (`intent.approveAlso`, e.g. Claude's "approve,
+ *   but keep asking for edits"): they follow the same clean-answer rule.
  * - Keep planning / feedback: `{ selected: [declineLabel], custom? }` where
- *   declineLabel is the first option that is not the approve label.
+ *   declineLabel is `intent.decline` when the asker names it, else the first
+ *   option that does not approve (dsh-plan-mode names none).
  * - Esc / Ctrl+C: the store rejects with ASK_CANCELLED, which plan-mode
  *   reads as "the user dismissed the review to speak instead".
  *
@@ -25,7 +28,7 @@
  * never be split by ←/→/⌫/Del (same contract as the plugin InputDialog).
  */
 import React from 'react';
-import type { QuestionSelection } from '../../dsh-adapter/questions.js';
+import type { QuestionSelection } from '../../channel/questions.js';
 import { type ClipboardRead } from '../../utils/clipboard.js';
 export type PlanReviewPanelProps = {
     /** The plan-review question (intent.kind === 'plan-review'). */
@@ -40,6 +43,8 @@ export type PlanReviewPanelProps = {
         readonly intent?: {
             readonly kind: 'plan-review';
             readonly approve: string;
+            readonly approveAlso?: readonly string[];
+            readonly decline?: string;
         };
     };
     readonly onAnswer: (selection: QuestionSelection) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"PlanReviewPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/questions/PlanReviewPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAIvE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAa5E,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;IAC7B;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;CAC9D,CAAA;AAED,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,qBAAqB,GACtB,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CA4ZxC"}
+{"version":3,"file":"PlanReviewPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/questions/PlanReviewPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAInE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAa5E,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,CAAC;YAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;YAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAClJ,CAAA;IACD,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACzD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;CAC9D,CAAA;AAED,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,qBAAqB,GACtB,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CA8ZxC"}

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

@@ -9,9 +9,12 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  *
  * 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.
+ *   plan-mode treats it as keep-planning-with-feedback. An asker may name
+ *   further approving options (`intent.approveAlso`, e.g. Claude's "approve,
+ *   but keep asking for edits"): they follow the same clean-answer rule.
  * - Keep planning / feedback: `{ selected: [declineLabel], custom? }` where
- *   declineLabel is the first option that is not the approve label.
+ *   declineLabel is `intent.decline` when the asker names it, else the first
+ *   option that does not approve (dsh-plan-mode names none).
  * - Esc / Ctrl+C: the store rejects with ASK_CANCELLED, which plan-mode
  *   reads as "the user dismissed the review to speak instead".
  *
@@ -48,7 +51,9 @@ const ANSWER_PASTE_MAX_POINTS = 8000;
 export function PlanReviewPanel({ question, onAnswer, onCancel, readClipboardOverride, }) {
     const options = question.options ?? [];
     const approveLabel = question.intent?.approve ?? options[0]?.label;
-    const declineLabel = options.find(option => option.label !== approveLabel)?.label;
+    const approveAlso = question.intent?.approveAlso ?? [];
+    const approves = (label) => label !== undefined && (label === approveLabel || approveAlso.includes(label));
+    const declineLabel = question.intent?.decline ?? options.find(option => !approves(option.label))?.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);
@@ -193,11 +198,11 @@ export function PlanReviewPanel({ question, onAnswer, onCancel, readClipboardOve
         if (label === undefined)
             return;
         const text = textRef.current.trim();
-        if (label === approveLabel && text !== '') {
+        if (approves(label) && text !== '') {
             setError(t('plan-review-approve-needs-empty'));
             return;
         }
-        if (label === approveLabel) {
+        if (approves(label)) {
             onAnswer({ selected: [label] });
             return;
         }
@@ -343,7 +348,7 @@ export function PlanReviewPanel({ question, onAnswer, onCancel, readClipboardOve
     };
     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')} ` }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, wrap: "wrap", children: question.question }), question.detail !== undefined && detailMax > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, height: detailMax, flexShrink: 0, children: _jsx(ScrollBox, { ref: detailScrollRef, flexDirection: "column", flexGrow: 1, height: detailMax, 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;
+                        const isApprove = approves(option.label);
                         return (_jsxs(Box, { flexDirection: "row", marginTop: focused ? 1 : 0, onClick: () => clickOption(index), onMouseEnter: () => setHoverIndex(index), onMouseLeave: () => setHoverIndex(current => (current === index ? -1 : current)), backgroundColor: hoverIndex === index && !focused ? 'userMessageBackgroundHover' : undefined, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'accent' : undefined, bold: focused, children: focused ? POINTER : ' ' }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 1, children: [_jsxs(Text, { bold: focused, color: focused || isApprove ? 'accent' : 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, onClick: focusFeedbackRow, onMouseEnter: () => setHoverIndex(options.length), onMouseLeave: () => setHoverIndex(current => (current === options.length ? -1 : current)), backgroundColor: hoverIndex === options.length && !inputFocused ? 'userMessageBackgroundHover' : undefined, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: inputFocused ? 'accent' : undefined, bold: inputFocused, children: inputFocused ? POINTER : ' ' }) }), _jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: inputFocused ? 'accent' : 'suggestion', children: PENCIL }) }), _jsx(Box, { flexDirection: "row", marginLeft: 1, children: feedback === '' && !inputFocused ? (_jsxs(_Fragment, { children: [_jsx(Text, { ref: caretRef, children: ' ' }), _jsx(Text, { dimColor: true, children: t('plan-review-feedback-placeholder') })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { wrap: "wrap", children: feedbackPoints.slice(0, cursor).join('') }), inputFocused
                                             ? _jsx(Text, { ref: caretRef, inverse: true, children: cursorChar })

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

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { ProviderModelEditor as ModelEditor } from '../../adapter/ports/channel-settings.js';
+import { type ClipboardRead } from '../../utils/clipboard.js';
+/** Draft-only capability form nested in /provider's model-selection question. */
+export declare function ProviderModelEditor({ model, editor, onClose, onAbort, readClipboardOverride }: {
+    readonly model: string;
+    readonly editor: ModelEditor;
+    readonly onClose: () => void;
+    readonly onAbort: () => void;
+    readonly readClipboardOverride?: () => Promise<ClipboardRead>;
+}): React.ReactNode;
+//# sourceMappingURL=ProviderModelEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderModelEditor.d.ts","sourceRoot":"","sources":["../../../../src/components/questions/ProviderModelEditor.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,mBAAmB,IAAI,WAAW,EAAE,MAAM,yCAAyC,CAAA;AAOjG,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAc5E,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAE;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;IAC5B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;CAC9D,GAAG,KAAK,CAAC,SAAS,CAyQlB"}

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

@@ -0,0 +1,266 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { formatModelReasoning, parseModelCapacity, parseModelReasoning } from '../../channel/model-capabilities.js';
+import { capCells, cleanRenderText, flattenPasteInline } from '../../channel/sanitize.js';
+import { t } from '../../i18n.js';
+import { useDeclaredCursor } from '../../ink/hooks/use-declared-cursor.js';
+import { stringWidth } from '../../ink/stringWidth.js';
+import { Box, Text, useInput, useTerminalSize } from '../../ui.js';
+import { readClipboard } from '../../utils/clipboard.js';
+import { actionMatches } from '../../utils/keymap.js';
+import { isPlainReturnInput } from '../../utils/modifiers.js';
+import { Divider } from '../design-system/Divider.js';
+import { POINTER } from '../../terminal-utils/figures.js';
+import { listWindow } from '../listWindow.js';
+const FIELDS = ['contextWindow', 'maxTokens', 'reasoningEfforts', 'input', 'save'];
+const INPUT_MODES = ['inherit', 'text', 'image'];
+const FIELD_MAX_POINTS = 1024;
+/** Draft-only capability form nested in /provider's model-selection question. */
+export function ProviderModelEditor({ model, editor, onClose, onAbort, readClipboardOverride }) {
+    const initial = React.useMemo(() => editor.read(model), [editor, model]);
+    const initialText = {
+        contextWindow: String(initial.values.contextWindow ?? ''),
+        maxTokens: String(initial.values.maxTokens ?? ''),
+        reasoningEfforts: flattenPasteInline(formatModelReasoning(initial.values.reasoningEfforts)),
+    };
+    const initialMode = initial.values.input === undefined ? 'inherit'
+        : initial.values.input.includes('image') ? 'image' : 'text';
+    const [values, setValues] = React.useState(initialText);
+    const valuesRef = React.useRef(initialText);
+    const [cursors, setCursors] = React.useState({
+        contextWindow: [...initialText.contextWindow].length,
+        maxTokens: [...initialText.maxTokens].length,
+        reasoningEfforts: [...initialText.reasoningEfforts].length,
+    });
+    const cursorsRef = React.useRef(cursors);
+    const [focus, setFocus] = React.useState(0);
+    const focusRef = React.useRef(0);
+    const [inputMode, setInputMode] = React.useState(initialMode);
+    const inputModeRef = React.useRef(initialMode);
+    const [error, setError] = React.useState(null);
+    const closed = React.useRef(false);
+    const mounted = React.useRef(true);
+    const pasteBusy = React.useRef(false);
+    React.useEffect(() => () => { mounted.current = false; }, []);
+    const { columns, rows } = useTerminalSize();
+    const width = Math.max(1, columns - 6);
+    const compact = columns < 64;
+    const field = FIELDS[focus];
+    const textFocused = field !== 'input' && field !== 'save'
+        && (field !== 'reasoningEfforts' || editor.reasoningEditable);
+    const caretRef = useDeclaredCursor({ line: 0, column: 0, active: textFocused });
+    const { start, end } = listWindow([1, 1, 1, 1, 1], focus, Math.max(2, rows - 16));
+    const placeFocus = (next) => {
+        focusRef.current = next;
+        setFocus(next);
+        setError(null);
+    };
+    const moveFocus = (delta) => {
+        let next = (focusRef.current + delta + FIELDS.length) % FIELDS.length;
+        if (FIELDS[next] === 'reasoningEfforts' && !editor.reasoningEditable) {
+            next = (next + delta + FIELDS.length) % FIELDS.length;
+        }
+        placeFocus(next);
+    };
+    const edit = (name, value, cursor) => {
+        if ([...value].length > FIELD_MAX_POINTS) {
+            setError(t('provider-model-field-too-long', { n: FIELD_MAX_POINTS }));
+            return;
+        }
+        valuesRef.current = { ...valuesRef.current, [name]: value };
+        cursorsRef.current = { ...cursorsRef.current, [name]: cursor };
+        setValues(valuesRef.current);
+        setCursors(cursorsRef.current);
+        setError(null);
+    };
+    const insert = (name, raw) => {
+        const text = flattenPasteInline(raw);
+        const points = [...valuesRef.current[name]];
+        const at = cursorsRef.current[name];
+        points.splice(at, 0, ...text);
+        edit(name, points.join(''), at + [...text].length);
+    };
+    const cycleInput = (delta) => {
+        const next = INPUT_MODES[(INPUT_MODES.indexOf(inputModeRef.current) + delta + INPUT_MODES.length) % INPUT_MODES.length];
+        inputModeRef.current = next;
+        setInputMode(next);
+        setError(null);
+    };
+    const save = () => {
+        if (closed.current)
+            return;
+        try {
+            editor.save(model, {
+                contextWindow: parseModelCapacity(valuesRef.current.contextWindow),
+                maxTokens: parseModelCapacity(valuesRef.current.maxTokens),
+                reasoningEfforts: valuesRef.current.reasoningEfforts === initialText.reasoningEfforts
+                    ? initial.values.reasoningEfforts : parseModelReasoning(valuesRef.current.reasoningEfforts),
+                input: inputModeRef.current === initialMode ? initial.values.input
+                    : inputModeRef.current === 'inherit' ? undefined
+                        : inputModeRef.current === 'image' ? ['text', 'image'] : ['text'],
+            });
+            closed.current = true;
+            onClose();
+        }
+        catch (cause) {
+            setError(cause instanceof Error ? cause.message : String(cause));
+        }
+    };
+    useInput((input, key, event) => {
+        // Own the whole key, including the frame that closes the editor: Enter
+        // must not also submit the surrounding model-selection question.
+        event.stopImmediatePropagation();
+        if (closed.current)
+            return;
+        if (key.escape || (key.ctrl && input === 'c')) {
+            closed.current = true;
+            if (key.ctrl)
+                onAbort();
+            else
+                onClose();
+            return;
+        }
+        const current = FIELDS[focusRef.current];
+        const isText = current !== 'input' && current !== 'save'
+            && (current !== 'reasoningEfforts' || editor.reasoningEditable);
+        // Pasted newlines/tabs are data, never save or field navigation.
+        if (key.isPasted) {
+            if (isText)
+                insert(current, input);
+            return;
+        }
+        if (actionMatches('paste', input, key)) {
+            if (!isText || pasteBusy.current)
+                return;
+            const name = current;
+            pasteBusy.current = true;
+            void (readClipboardOverride ?? readClipboard)().then(content => {
+                if (!mounted.current || closed.current || FIELDS[focusRef.current] !== name)
+                    return;
+                if (content?.kind === 'text')
+                    insert(name, content.text);
+                else
+                    setError(t('provider-model-paste-text-only'));
+            }).catch(() => {
+                if (mounted.current && !closed.current)
+                    setError(t('provider-model-paste-text-only'));
+            }).finally(() => { pasteBusy.current = false; });
+            return;
+        }
+        if (isPlainReturnInput(input, key) || (key.ctrl && input === 's')) {
+            save();
+            return;
+        }
+        if (key.upArrow || (key.tab && key.shift)) {
+            moveFocus(-1);
+            return;
+        }
+        if (key.downArrow || key.tab) {
+            moveFocus(1);
+            return;
+        }
+        if (current === 'input') {
+            if (key.leftArrow)
+                cycleInput(-1);
+            else if (key.rightArrow || input === ' ')
+                cycleInput(1);
+            return;
+        }
+        if (!isText)
+            return;
+        const name = current;
+        const points = [...valuesRef.current[name]];
+        const at = cursorsRef.current[name];
+        if (key.home) {
+            edit(name, points.join(''), 0);
+            return;
+        }
+        if (key.end) {
+            edit(name, points.join(''), points.length);
+            return;
+        }
+        if (key.ctrl && input === 'u') {
+            edit(name, '', 0);
+            return;
+        }
+        if (key.leftArrow) {
+            edit(name, points.join(''), Math.max(0, at - 1));
+            return;
+        }
+        if (key.rightArrow) {
+            edit(name, points.join(''), Math.min(points.length, at + 1));
+            return;
+        }
+        if (key.backspace && at > 0) {
+            points.splice(at - 1, 1);
+            edit(name, points.join(''), at - 1);
+        }
+        else if (key.delete) {
+            points.splice(at, 1);
+            edit(name, points.join(''), at);
+        }
+        else if (input && !key.ctrl && !key.meta && !key.super && !key.backspace)
+            insert(name, input);
+    }, { prepend: true });
+    const labels = {
+        contextWindow: t('provider-model-context-window'),
+        maxTokens: t('provider-model-max-tokens'),
+        reasoningEfforts: t('provider-model-reasoning-efforts'),
+        input: t('provider-model-multimodal'),
+        save: t('provider-model-save'),
+    };
+    const compactLabels = {
+        contextWindow: 'ctx',
+        maxTokens: 'output',
+        reasoningEfforts: 'effort',
+        input: t('provider-model-multimodal-short'),
+        save: t('provider-model-save-short'),
+    };
+    const inheritedInputLabel = initial.defaults.input === undefined ? t('provider-model-inherit')
+        : initial.defaults.input.includes('image') ? t('provider-model-default-image') : t('provider-model-default-text');
+    const inputLabel = inputMode === 'inherit' ? inheritedInputLabel
+        : inputMode === 'image' ? t('provider-model-input-image') : t('provider-model-input-text');
+    const renderValue = (name, focused, availableWidth) => {
+        const points = [...values[name]];
+        const at = cursors[name];
+        // Keep the caret in the horizontal viewport without slicing UTF-16 or
+        // assuming one code point equals one terminal cell.
+        let first = 0;
+        while (first < at && stringWidth(points.slice(first, at).join('')) >= availableWidth)
+            first += 1;
+        const prefix = points.slice(first, at).join('');
+        const caret = points[at] ?? ' ';
+        const suffix = capCells(points.slice(at + 1).join(''), Math.max(0, availableWidth - stringWidth(prefix) - stringWidth(caret)));
+        const fallback = name === 'reasoningEfforts' ? t('provider-model-inherit')
+            : initial.defaults[name] === undefined ? t('provider-model-inherit')
+                : t('provider-model-default-capacity', { n: initial.defaults[name] });
+        if (!focused)
+            return _jsx(Text, { dimColor: points.length === 0, wrap: "truncate", children: points.length === 0 ? fallback : values[name] });
+        return _jsxs(Text, { children: [prefix, _jsx(Text, { ref: caretRef, inverse: true, children: caret }), suffix, points.length === 0 ? _jsx(Text, { dimColor: true, children: capCells(fallback, Math.max(0, availableWidth - 1)) }) : null] });
+    };
+    return _jsxs(Box, { flexDirection: "column", marginTop: 1, paddingX: 2, width: "100%", children: [_jsx(Divider, { color: "permission", title: t('provider-model-editor-title') }), _jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { bold: true, wrap: "truncate", children: cleanRenderText(model, Math.max(1, columns - 4)) }) }), FIELDS.slice(start, end).map((name, index) => {
+                const absolute = start + index;
+                const focused = absolute === focus;
+                const isText = name !== 'input' && name !== 'save';
+                const valueWidth = Math.max(1, width - (compact ? 10 : 27));
+                return _jsxs(Box, { flexDirection: "row", height: 1, flexShrink: 0, overflow: "hidden", width: "100%", onClick: () => {
+                        if (name === 'reasoningEfforts' && !editor.reasoningEditable)
+                            return;
+                        if (name === 'save')
+                            save();
+                        else {
+                            placeFocus(absolute);
+                            if (name === 'input')
+                                cycleInput(1);
+                        }
+                    }, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'accent' : undefined, dimColor: name === 'reasoningEfforts' && !editor.reasoningEditable, children: focused ? POINTER : absolute === start && start > 0 ? '↑' : absolute === end - 1 && end < FIELDS.length ? '↓' : ' ' }) }), _jsx(Box, { width: compact ? 9 : 26, flexShrink: 0, children: _jsx(Text, { bold: focused, color: focused ? 'accent' : undefined, dimColor: name === 'reasoningEfforts' && !editor.reasoningEditable, wrap: "truncate", children: compact ? compactLabels[name] : labels[name] }) }), _jsx(Box, { width: valueWidth, flexShrink: 0, overflow: "hidden", children: name === 'input'
+                                ? _jsx(Text, { wrap: "truncate", children: compact ? inputMode === 'inherit' ? initial.defaults.input?.includes('image') ? 'image default' : 'text default' : inputMode : inputLabel })
+                                : name === 'save'
+                                    ? _jsx(Text, { color: "success", wrap: "truncate", children: compact ? 'Enter' : t('provider-model-enter-to-save') })
+                                    : name === 'reasoningEfforts' && !editor.reasoningEditable
+                                        ? _jsx(Text, { dimColor: true, wrap: "truncate", children: t('provider-model-reasoning-unavailable-short') })
+                                        : renderValue(name, focused && textFocused, valueWidth) })] }, name);
+            }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, wrap: "truncate", children: field === 'reasoningEfforts'
+                        ? editor.reasoningEditable ? t('provider-model-reasoning-hint') : t('provider-model-reasoning-unavailable')
+                        : field === 'input' ? t('provider-model-input-hint') : t('provider-model-capacity-hint') }) }), error !== null ? _jsx(Text, { color: "error", wrap: "truncate", children: error }) : null, _jsx(Text, { dimColor: true, wrap: "truncate", children: t('hint-provider-model-editor') })] });
+}

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

@@ -18,6 +18,32 @@ export declare const ICE: Rgb;
 export declare const PALE: Rgb;
 /** Soft ice flash blue (`#C6D8F8`); stays visibly blue, never pure white. */
 export declare const FLASH: Rgb;
+/**
+ * Claude 陶土橙阶（claude 品牌开屏用，branding.ts / theme.ts 双主题共用）：
+ * 深底从正色 `#D77757` 起步、经亮橙、奔奶油橙收——三档对比拉满（用户反馈
+ * "渐变要明显、要亮"，起点不再用暗端）；浅底（claude-paper）反向：深化橙
+ * 起步、正色收（浅底上"亮"是加深）。
+ */
+export declare const EMBER: Rgb;
+export declare const EMBER_BRIGHT: Rgb;
+export declare const EMBER_PALE: Rgb;
+export declare const EMBER_LIGHT: Rgb;
+export declare const EMBER_FLASH: Rgb;
+export declare const EMBER_PAPER: Rgb;
+export declare const EMBER_PAPER_FLASH: Rgb;
+/**
+ * Codex 薰衣草紫阶（codex 品牌开屏用，branding.ts / theme.ts 双主题共用）：
+ * 与 claude 同构——深底从亮紫起步、经淡紫、奔近白的薰衣草收（三档对比拉
+ * 满）；浅底（codex-paper）反向：深化紫起步、正色收（浅底上"亮"是加深）。
+ */
+export declare const LAVENDER: Rgb;
+export declare const LAVENDER_BRIGHT: Rgb;
+export declare const LAVENDER_SOFT: Rgb;
+export declare const LAVENDER_PALE: Rgb;
+export declare const LAVENDER_LIGHT: Rgb;
+export declare const LAVENDER_FLASH: Rgb;
+export declare const LAVENDER_PAPER: Rgb;
+export declare const LAVENDER_PAPER_FLASH: Rgb;
 /**
  * Paint `word` with a 10-column highlight window sweeping across it. The
  * window advances one column per `stepMs` and the brightness pulse follows

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

@@ -1 +1 @@
-{"version":3,"file":"shimmer.d.ts","sourceRoot":"","sources":["../../../src/components/shimmer.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AAEH,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;iDAEiD;AACjD,eAAO,MAAM,KAAK,EAAE,GAA+B,CAAA;AACnD,0CAA0C;AAC1C,eAAO,MAAM,GAAG,EAAE,GAAgC,CAAA;AAClD,2CAA2C;AAC3C,eAAO,MAAM,IAAI,EAAE,GAAgC,CAAA;AACnD,6EAA6E;AAC7E,eAAO,MAAM,KAAK,EAAE,GAAgC,CAAA;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,SAAK,GAAG,MAAM,CAehG"}
+{"version":3,"file":"shimmer.d.ts","sourceRoot":"","sources":["../../../src/components/shimmer.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AAEH,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;iDAEiD;AACjD,eAAO,MAAM,KAAK,EAAE,GAA+B,CAAA;AACnD,0CAA0C;AAC1C,eAAO,MAAM,GAAG,EAAE,GAAgC,CAAA;AAClD,2CAA2C;AAC3C,eAAO,MAAM,IAAI,EAAE,GAAgC,CAAA;AACnD,6EAA6E;AAC7E,eAAO,MAAM,KAAK,EAAE,GAAgC,CAAA;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,GAA+B,CAAA;AACnD,eAAO,MAAM,YAAY,EAAE,GAAgC,CAAA;AAC3D,eAAO,MAAM,UAAU,EAAE,GAAgC,CAAA;AACzD,eAAO,MAAM,WAAW,EAAE,GAAgC,CAAA;AAC1D,eAAO,MAAM,WAAW,EAAE,GAAgC,CAAA;AAC1D,eAAO,MAAM,WAAW,EAAE,GAA+B,CAAA;AACzD,eAAO,MAAM,iBAAiB,EAAE,GAA8B,CAAA;AAE9D;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,GAAgC,CAAA;AACvD,eAAO,MAAM,eAAe,EAAE,GAAgC,CAAA;AAC9D,eAAO,MAAM,aAAa,EAAE,GAAgC,CAAA;AAC5D,eAAO,MAAM,aAAa,EAAE,GAAgC,CAAA;AAC5D,eAAO,MAAM,cAAc,EAAE,GAAgC,CAAA;AAC7D,eAAO,MAAM,cAAc,EAAE,GAAgC,CAAA;AAC7D,eAAO,MAAM,cAAc,EAAE,GAA+B,CAAA;AAC5D,eAAO,MAAM,oBAAoB,EAAE,GAAgC,CAAA;AAEnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,SAAK,GAAG,MAAM,CAehG"}

package/lib/types/components/shimmer.js

@@ -12,6 +12,32 @@ export const ICE = { r: 147, g: 190, b: 255 };
 export const PALE = { r: 215, g: 228, b: 255 };
 /** Soft ice flash blue (`#C6D8F8`); stays visibly blue, never pure white. */
 export const FLASH = { r: 198, g: 216, b: 248 };
+/**
+ * Claude 陶土橙阶（claude 品牌开屏用，branding.ts / theme.ts 双主题共用）：
+ * 深底从正色 `#D77757` 起步、经亮橙、奔奶油橙收——三档对比拉满（用户反馈
+ * "渐变要明显、要亮"，起点不再用暗端）；浅底（claude-paper）反向：深化橙
+ * 起步、正色收（浅底上"亮"是加深）。
+ */
+export const EMBER = { r: 215, g: 119, b: 87 }; // #D77757 陶土橙（深底起点/正色）
+export const EMBER_BRIGHT = { r: 239, g: 169, b: 126 }; // #EFA97E 亮橙（深底中档/浅底终点）
+export const EMBER_PALE = { r: 251, g: 214, b: 176 }; // #FBD6B0 奶油橙（深底终点，够亮）
+export const EMBER_LIGHT = { r: 230, g: 138, b: 105 }; // #E68A69 亮橙（浅底终点档）
+export const EMBER_FLASH = { r: 245, g: 201, b: 180 }; // #F5C9B4 暖阳高光（深底）
+export const EMBER_PAPER = { r: 201, g: 100, b: 66 }; // #C96442 深化橙（浅底起点）
+export const EMBER_PAPER_FLASH = { r: 184, g: 87, b: 56 }; // #B85738 浅底高光
+/**
+ * Codex 薰衣草紫阶（codex 品牌开屏用，branding.ts / theme.ts 双主题共用）：
+ * 与 claude 同构——深底从亮紫起步、经淡紫、奔近白的薰衣草收（三档对比拉
+ * 满）；浅底（codex-paper）反向：深化紫起步、正色收（浅底上"亮"是加深）。
+ */
+export const LAVENDER = { r: 166, g: 155, b: 232 }; // #A69BE8 薰衣草紫（正色/浅底终点）
+export const LAVENDER_BRIGHT = { r: 197, g: 191, b: 238 }; // #C5BFEE 亮紫（深底起点）
+export const LAVENDER_SOFT = { r: 217, g: 213, b: 243 }; // #D9D5F3 淡紫（深底中档）
+export const LAVENDER_PALE = { r: 226, g: 222, b: 248 }; // #E2DEF8 近白薰衣草（深底终点，够亮）
+export const LAVENDER_LIGHT = { r: 138, g: 126, b: 217 }; // #8A7ED9 深亮紫（浅底中档）
+export const LAVENDER_FLASH = { r: 207, g: 199, b: 245 }; // #CFC7F5 高光（深底）
+export const LAVENDER_PAPER = { r: 107, g: 92, b: 200 }; // #6B5CC8 深化紫（浅底起点）
+export const LAVENDER_PAPER_FLASH = { r: 122, g: 106, b: 214 }; // #7A6AD6 浅底高光
 /**
  * Paint `word` with a 10-column highlight window sweeping across it. The
  * window advances one column per `stepMs` and the brightness pulse follows