@zergai/ztc 0.4.1-dev.36919234045 → 0.5.0-beta.1

package/dist/ui/views/status_bar.js

@@ -1,3 +1,4 @@
+import { normalizeInputMode } from '../../types.js';
 import { MODE_CONFIGS } from '../../app/modes.js';
 import { getProviderDisplayName } from '../../agent/backends/provider_ids.js';
 import { formatTokenCount, cacheHitRate } from '../../utils/context.js';
@@ -86,9 +87,11 @@ const CONNECTION_COLORS = {
  */
 function statusItemForms(item, props) {
     const modeConfig = MODE_CONFIGS[props.mode];
-    const modeLabel = modeConfig.label
-        ? modeConfig.label[0].toUpperCase() + modeConfig.label.slice(1)
-        : props.mode;
+    const modeLabel = props.mode === 'auto-accept'
+        ? 'Auto-accept'
+        : modeConfig.label
+            ? modeConfig.label[0].toUpperCase() + modeConfig.label.slice(1)
+            : props.mode;
     const providerName = props.provider ? getProviderDisplayName(props.provider) : '';
     const displayModel = props.model ? ellipsize(props.model, 20) : '';
     // Router IDs may already carry the provider. Strip it only in the combined label.
@@ -113,8 +116,9 @@ function statusItemForms(item, props) {
     const percentage = props.contextStatus && props.contextStatus.total > 0 ? `${Math.round(props.contextStatus.percentage)}%` : undefined;
     const remaining = props.contextStatus && props.contextStatus.total > 0 ? `${Math.max(0, Math.round(props.contextStatus.remaining))}%` : undefined;
     const reasoning = reasoningEnabled(props.effort);
-    const inputMode = props.inputMode && props.inputMode !== 'queue'
-        ? props.inputMode[0].toUpperCase() + props.inputMode.slice(1)
+    const canonicalInputMode = normalizeInputMode(props.inputMode ?? 'steer');
+    const inputMode = canonicalInputMode !== 'steer'
+        ? canonicalInputMode[0].toUpperCase() + canonicalInputMode.slice(1)
         : undefined;
     const model = providerName && pairedModel
         ? `${providerName}/${pairedModel}`
@@ -179,7 +183,11 @@ function statusItemForms(item, props) {
         case 'effort': {
             const unsupported = props.unsupportedEffort;
             if (!unsupported) {
-                return { raw: props.effort, short: props.effort && `eff ${props.effort}`, long: props.effort && `Effort ${props.effort}` };
+                return {
+                    raw: props.effort ?? 'default',
+                    short: `eff ${props.effort ?? 'default'}`,
+                    long: `Effort ${props.effort ?? 'provider default'}`,
+                };
             }
             return {
                 raw: unsupported,
@@ -193,14 +201,14 @@ function statusItemForms(item, props) {
             // The field is the thinking switch, so the short form says the thing the
             // user is actually turning on rather than restating the flag.
             return reasoning === undefined
-                ? {}
+                ? { raw: 'default', short: 'thinking default', long: 'Reasoning provider default' }
                 : {
                     raw: reasoning ? 'on' : 'off',
                     short: reasoning ? 'thinking' : 'no thinking',
                     long: `Reasoning ${reasoning ? 'on' : 'off'}`,
                 };
         case 'input-mode':
-            return { raw: props.inputMode === 'queue' ? undefined : props.inputMode, short: inputMode, long: inputMode && `Input: ${inputMode}` };
+            return { raw: canonicalInputMode === 'steer' ? undefined : canonicalInputMode, short: inputMode, long: inputMode && `Input: ${inputMode}` };
         case 'version':
             return { raw: props.version, short: `v${props.version}`, long: `ZTC v${props.version}` };
         case 'connection':
@@ -320,6 +328,9 @@ export function buildStatusBarView(rawProps) {
     let right = settings.right
         .map(item => statusItemSegment(item, props, settings.variants[item]))
         .filter((segment) => segment !== null);
+    if (props.escapeHint) {
+        right.push({ value: props.escapeHint, color: TERMINAL_THEME.muted, priority: 900, protected: true });
+    }
     const alerts = [];
     if (props.state.authError) {
         alerts.push({ value: 'auth!', color: TERMINAL_THEME.error, priority: 1000, protected: true });

package/dist/ui/views/theme.d.ts

@@ -12,4 +12,6 @@ export declare const TERMINAL_THEME: {
     readonly error: "#f85149";
     readonly success: "#3fb950";
 };
+/** Rules and glyphs remain distinct on both dark and light terminal backgrounds. */
+export declare const PLAN_ACCENT = "#b7791f";
 export declare function modeColor(mode: string): string;

package/dist/ui/views/theme.js

@@ -12,6 +12,8 @@ export const TERMINAL_THEME = {
     error: '#f85149',
     success: '#3fb950',
 };
+/** Rules and glyphs remain distinct on both dark and light terminal backgrounds. */
+export const PLAN_ACCENT = '#b7791f';
 export function modeColor(mode) {
     if (mode === 'plan')
         return TERMINAL_THEME.attention;

package/dist/ui/widgets/color_panel.js

@@ -200,6 +200,24 @@ export class ColorPanelWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            if (!input)
+                return;
+            if (this.hexEditing) {
+                this.hexValue += input;
+                this.notice = null;
+            }
+            else if (this.filterMode) {
+                this.filterText += input;
+                this.presetIndex = 0;
+                this.presetScroll = 0;
+            }
+            else {
+                return;
+            }
+            this.host.render();
+            return;
+        }
         if (this.hexEditing) {
             this.handleHexInput(input, key);
             return;

package/dist/ui/widgets/form.js

@@ -28,6 +28,14 @@ export class FormWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            const field = this.active.fields[this.focusedField];
+            if (!input || !field)
+                return;
+            this.values[field.name] = (this.values[field.name] || '') + input;
+            this.host.render();
+            return;
+        }
         const fields = this.active.fields;
         // Ctrl+C / Escape to cancel. Invoke the callback with an empty map (like a
         // submit with no values) BEFORE clearing state — mirror the submit branch.

package/dist/ui/widgets/log_view.js

@@ -90,6 +90,13 @@ export class LogViewWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            if (input && this.filterMode) {
+                this.filterInput += input;
+                this.host.render();
+            }
+            return;
+        }
         // Filter mode
         if (this.filterMode) {
             if (key.escape) {

package/dist/ui/widgets/navigator_panel.js

@@ -372,6 +372,14 @@ export class NavigatorPanelWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            if (!input)
+                return;
+            this.filterMode = true;
+            this.filterText += input;
+            this.applyFilter();
+            return;
+        }
         if (key.ctrl && input.toLowerCase() === 'c') {
             this.cancel();
             return;

package/dist/ui/widgets/prompt_viewer.js

@@ -108,6 +108,8 @@ export class PromptViewerWidget {
         this.detailScrollOffset = 0;
     }
     handleInput(input, key) {
+        if (key.paste)
+            return;
         // Normalize: detect arrow keys from both structured key flags and ANSI escape sequences
         const up = key.upArrow || input === '\x1b[A';
         const down = key.downArrow || input === '\x1b[B';

package/dist/ui/widgets/questionnaire.d.ts

@@ -10,6 +10,8 @@ export interface QuestionnaireOption {
     label: string;
     /** Shown only while this option is highlighted, so lists stay one row per option. */
     description?: string;
+    /** A short next-step preview, shown only for the highlighted option. */
+    preview?: string;
     /** Marks the option the agent suggests; gets a badge and starts highlighted. */
     recommended?: boolean;
 }

package/dist/ui/widgets/questionnaire.js

@@ -111,10 +111,27 @@ export class QuestionnaireWidget {
         return question.options.findIndex(option => option.recommended === true);
     }
     show(data) {
-        this.active = data;
+        this.active = {
+            ...data,
+            questions: data.questions.map(question => {
+                if (!question.options)
+                    return { ...question };
+                const recommendation = question.options.findIndex(option => option.recommended === true);
+                const options = question.options.map((option, index) => ({
+                    ...option,
+                    ...(option.recommended === true && index !== recommendation ? { recommended: false } : {}),
+                }));
+                return {
+                    ...question,
+                    options: recommendation > 0
+                        ? [options[recommendation], ...options.filter((_option, index) => index !== recommendation)]
+                        : options,
+                };
+            }),
+        };
         this.tabIndex = 0;
         // Start on the recommended option so Enter accepts the agent's suggestion.
-        this.optionIndex = Math.max(0, QuestionnaireWidget.recommendedOptionIndex(data.questions[0]));
+        this.optionIndex = Math.max(0, QuestionnaireWidget.recommendedOptionIndex(this.active.questions[0]));
         this.answers = {};
         this.checked.clear();
         this.otherMode = false;
@@ -123,8 +140,8 @@ export class QuestionnaireWidget {
         this.optionNotes.clear();
         this.editingOptionNote = false;
         // Pre-fill defaults
-        for (let i = 0; i < data.questions.length; i++) {
-            const q = data.questions[i];
+        for (let i = 0; i < this.active.questions.length; i++) {
+            const q = this.active.questions[i];
             if (q.default !== undefined) {
                 this.answers[q.name] = q.default;
                 if (q.type === 'multiselect' && Array.isArray(q.default) && q.options) {
@@ -370,6 +387,31 @@ export class QuestionnaireWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            const question = this.active.questions[this.tabIndex];
+            if (!input || !question)
+                return;
+            if (this.otherMode) {
+                this.otherValue += input;
+                this.host.render();
+            }
+            else if (question.type === 'text' || question.type === 'textarea') {
+                this.textValues[this.tabIndex] = (this.textValues[this.tabIndex] || '') + input;
+                this.host.render();
+            }
+            else if (this.active.allowOptionNotes && question.type === 'select') {
+                this.selectHighlightedOption(question);
+                this.editingOptionNote = true;
+                this.setOptionNote(insertText(this.getOptionNote(), input));
+            }
+            else if (this.active.allowOther && question.type === 'select') {
+                this.otherMode = true;
+                this.otherValue = input;
+                this.optionIndex = (question.options || []).length;
+                this.host.render();
+            }
+            return;
+        }
         const questions = this.active.questions;
         const totalTabs = questions.length;
         const currentQ = questions[this.tabIndex];
@@ -385,7 +427,7 @@ export class QuestionnaireWidget {
             }
             if (key.return) {
                 if (this.otherValue.trim()) {
-                    this.answers[currentQ.name] = this.otherValue.trim();
+                    this.answers[currentQ.name] = this.otherValue;
                     this.otherMode = false;
                     this.otherValue = '';
                     this.advanceOrSubmit();
@@ -635,6 +677,11 @@ export class QuestionnaireWidget {
         const question = questions[this.tabIndex];
         if (!question)
             return { content: '', view: box([], {}), lineCount: 0 };
+        const cap = typeof maxRows === 'number' && Number.isFinite(maxRows)
+            ? Math.max(0, Math.floor(maxRows))
+            : Number.POSITIVE_INFINITY;
+        if (cap === 0)
+            return { content: '', view: box([], {}), lineCount: 0 };
         // The form shares the pane width with the composer: it must reflow on
         // every build so a terminal or zmux-pane resize mid-question is picked up.
         // A cap here froze the frame at 88 columns on wide panes.
@@ -650,7 +697,6 @@ export class QuestionnaireWidget {
         const separator = () => ({
             segments: [{ text: `├${'─'.repeat(width - 2)}┤`, style: { color: TERMINAL_THEME.borderSubtle } }],
         });
-        lines.push(topBorder(width, title || 'Questions', ''));
         const unanswered = questions.filter((candidate, index) => {
             const answer = this.answers[candidate.name];
             const draft = this.textValues[index];
@@ -669,7 +715,6 @@ export class QuestionnaireWidget {
         if (question.header) {
             progress.push({ text: ` · ${question.header}`, style: { color: TERMINAL_THEME.subtle } });
         }
-        lines.push(framed(progress));
         // One content column for the whole card. The question, every option label,
         // and every description start at this same column; the selection caret,
         // number, and state marker are outdented into the gutter to its left. Lining
@@ -688,7 +733,17 @@ export class QuestionnaireWidget {
         // caret + space + (padded number) + space + marker + space
         const gutter = ' '.repeat(displayWidth('› ') + numberWidth + 1 + 1 + markerWidth + 1);
         const questionLines = wrapText(question.question, innerWidth - gutter.length, 2);
-        for (const questionLine of questionLines) {
+        // Keep at least one answer row. In short panes, collapse metadata and
+        // separators before sacrificing the actual question or highlighted choice.
+        const compactChrome = cap < questionLines.length + 6;
+        const showFrame = !compactChrome || cap >= questionLines.length + 4;
+        const footerRows = compactChrome ? (showFrame ? 2 : cap > 1 ? 1 : 0) : 3;
+        if (showFrame)
+            lines.push(topBorder(width, title || 'Questions', compactChrome ? `${this.tabIndex + 1}/${questions.length}` : ''));
+        if (!compactChrome)
+            lines.push(framed(progress));
+        const questionRowCount = Math.max(0, Math.min(questionLines.length, cap - lines.length - footerRows - 1));
+        for (const questionLine of questionLines.slice(0, questionRowCount)) {
             lines.push(framed([
                 { text: gutter },
                 { text: questionLine, style: { color: TERMINAL_THEME.text, bold: true } },
@@ -697,12 +752,8 @@ export class QuestionnaireWidget {
         // The box is sized to the question it renders (capped by the caller's
         // budget). Filling the whole budget left the transcript hidden behind a
         // wall of empty rows.
-        const footerRows = 3;
-        const cap = typeof maxRows === 'number' && Number.isFinite(maxRows)
-            ? Math.max(0, Math.floor(maxRows))
-            : Number.POSITIVE_INFINITY;
         const roomForBody = Math.max(0, cap - lines.length - footerRows);
-        const spacerRows = roomForBody > 1 ? 1 : 0;
+        const spacerRows = !compactChrome && roomForBody > 1 ? 1 : 0;
         const bodyRows = Math.max(0, roomForBody - spacerRows);
         const body = [];
         let optionPosition = '';
@@ -805,6 +856,15 @@ export class QuestionnaireWidget {
                         ], TERMINAL_THEME.bgElevated));
                     }
                 }
+                if (highlighted && option.preview) {
+                    const previewWidth = Math.max(1, innerWidth - displayWidth(prefix));
+                    for (const line of wrapText(`Next: ${option.preview}`, previewWidth, Number.MAX_SAFE_INTEGER)) {
+                        rows.push(framed([
+                            { text: ' '.repeat(displayWidth(prefix)) },
+                            { text: line, style: { color: TERMINAL_THEME.info } },
+                        ], TERMINAL_THEME.bgElevated));
+                    }
+                }
                 return { rows };
             });
             if (allowOther && !(allowOptionNotes && question.type === 'select')) {
@@ -880,7 +940,8 @@ export class QuestionnaireWidget {
         if (spacerRows > 0)
             lines.push(blank());
         lines.push(...body);
-        lines.push(separator());
+        if (!compactChrome)
+            lines.push(separator());
         const isLast = this.tabIndex === questions.length - 1;
         let hint;
         if (this.otherMode) {
@@ -907,8 +968,10 @@ export class QuestionnaireWidget {
             ? [{ text: `${optionPosition} · `, style: { color: TERMINAL_THEME.subtle } }]
             : [];
         hintSegments.push({ text: hint, style: { color: TERMINAL_THEME.muted } });
-        lines.push(framed(hintSegments));
-        lines.push(bottomBorder(width));
+        if (cap > 1)
+            lines.push(framed(hintSegments));
+        if (showFrame)
+            lines.push(bottomBorder(width));
         return {
             content: lines.map(lineText).join('\n'),
             view: box(lines.map(line => box(line.segments.map(segment => text(segment.text, segment.style)), { flexDirection: 'row', height: 1, flexShrink: 0, backgroundColor: line.backgroundColor })), { flexDirection: 'column', height: lines.length, flexShrink: 0 }),

package/dist/ui/widgets/resume_panel.js

@@ -326,6 +326,15 @@ export class ResumePanelWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            if (!input)
+                return;
+            this.filterMode = true;
+            this.filterText += input;
+            this.applyFilter();
+            this.host.render();
+            return;
+        }
         if (key.ctrl && input.toLowerCase() === 'c') {
             this.cancel();
             return;

package/dist/ui/widgets/rewind_panel.d.ts

@@ -1,6 +1,6 @@
 /**
- * Rewind panel — full-page prompt picker opened with Esc while the agent is
- * idle.
+ * Rewind panel — full-page prompt picker opened with /rewind while the agent
+ * is idle.
  *
  * The list is anchored to the bottom of its pane: the prompt just sent sits on
  * the last row and older prompts climb upward, so the newest entry is where the

package/dist/ui/widgets/rewind_panel.js

@@ -1,6 +1,6 @@
 /**
- * Rewind panel — full-page prompt picker opened with Esc while the agent is
- * idle.
+ * Rewind panel — full-page prompt picker opened with /rewind while the agent
+ * is idle.
  *
  * The list is anchored to the bottom of its pane: the prompt just sent sits on
  * the last row and older prompts climb upward, so the newest entry is where the
@@ -124,6 +124,8 @@ export class RewindPanelWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste)
+            return;
         const entries = this.active.entries;
         if (key.escape || isCtrlKey(input, key, 'c')) {
             this.cancel();

package/dist/ui/widgets/select.js

@@ -4,6 +4,7 @@
  * Extracted from cli_ratatui.ts to reduce file size.
  */
 import { displayWidth } from '../core/text_width.js';
+import { wrapText } from '../core/wrap_text.js';
 export class SelectWidget {
     host;
     active = null;
@@ -85,6 +86,17 @@ export class SelectWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            if (!input)
+                return;
+            if (this.otherMode || (this.active.allowOther && this.active.type === 'select')) {
+                this.otherMode = true;
+                this.selectedIndex = this.active.options.length;
+                this.otherValue += input;
+                this.host.render();
+            }
+            return;
+        }
         const options = this.active.options;
         const totalOptions = options.length + (this.active.allowOther ? 1 : 0);
         // If in "Other" text input mode
@@ -285,35 +297,12 @@ export class SelectWidget {
         const titleFill = Math.max(0, width - 3 - displayWidth(titlePart));
         const topLine = '╭─' + titlePart + '─'.repeat(titleFill) + '╮';
         lines.push(topLine);
-        // Question (word-wrap if longer than available width)
+        // Keep explicit metadata rows and wrap long path tokens at visible cells.
         const maxQWidth = width - 4;
-        // Both branches indent to the option label column. Fixing only the wrapped
-        // branch left short questions flush at column 1 while their labels started
-        // at the gutter, so the two disagreed for the commonest case.
         const questionGutter = SelectWidget.labelColumn(type);
-        if (displayWidth(questionGutter + question) <= maxQWidth) {
-            lines.push('│ ' + pad(questionGutter + question, maxQWidth) + ' │');
-        }
-        else {
-            // Indent the question to the option label column so the card has one left
-            // edge. Deriving it from the real gutter keeps the two in step for both
-            // the select radio and the wider multiselect checkbox.
-            const gutter = questionGutter;
-            const innerQ = Math.max(1, maxQWidth - displayWidth(gutter));
-            const words = question.split(' ');
-            let line = '';
-            for (const word of words) {
-                if (displayWidth(line + word) > innerQ && line.length > 0) {
-                    lines.push('│ ' + pad(gutter + line.trimEnd(), maxQWidth) + ' │');
-                    line = word + ' ';
-                }
-                else {
-                    line += word + ' ';
-                }
-            }
-            if (line.trimEnd().length > 0) {
-                lines.push('│ ' + pad(gutter + line.trimEnd(), maxQWidth) + ' │');
-            }
+        const innerQ = Math.max(1, maxQWidth - displayWidth(questionGutter));
+        for (const line of wrapText(question, innerQ)) {
+            lines.push('│ ' + pad(questionGutter + line, maxQWidth) + ' │');
         }
         lines.push('│' + ' '.repeat(width - 2) + '│');
         // If in "Other" text input mode

package/dist/ui/widgets/settings_panel.js

@@ -575,6 +575,22 @@ export class SettingsPanelWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            // Key capture and expanded choices have no literal text destination.
+            if (!input || this.captureSetting || this.expandedSetting)
+                return;
+            if (this.editMode) {
+                this.editValue += input;
+                this.editDirty = true;
+            }
+            else {
+                this.filterMode = true;
+                this.filterText += input;
+                this.applyFilter();
+            }
+            this.host.render();
+            return;
+        }
         // Capture mode is modal: the next keystroke becomes the binding.
         if (this.captureSetting) {
             this.handleCaptureInput(input, key);

package/dist/ui/widgets/status_line_panel.d.ts

@@ -104,6 +104,7 @@ export declare class StatusLinePanelWidget {
     /** Fields currently listed, in row order; `fieldIndex` indexes into this. */
     private catalogueFields;
     private currentOption;
+    private selectedDescription;
     /**
      * Typing a query puts the cursor on the first match, so the field you then
      * toggle is the best one the search found rather than wherever the cursor

package/dist/ui/widgets/status_line_panel.js

@@ -17,7 +17,7 @@
 import { displayWidth, padEndDisplay } from '../core/text_width.js';
 import { TERMINAL_THEME } from '../views/theme.js';
 import { fuzzyMatch } from '../../utils/fuzzy_match.js';
-import { cycleStatusLineVariant, resolveStatusLineVariants, statusLineItemGroups, statusLineItemOptions, STATUS_LINE_VARIANT_LABELS, } from '../status_line_config.js';
+import { cycleStatusLineVariant, resolveStatusLineVariants, statusLineItemGroups, statusLineItemOptions, STATUS_LINE_ITEM_DESCRIPTIONS, STATUS_LINE_VARIANT_LABELS, } from '../status_line_config.js';
 import { bodyBand, bottomBorder, clipText, dropLastGrapheme, fitSegments, framedLine, isInsideBand, joinColumns, lineText, planPanelSplit, sideBySideBands, stackedBands, topBorder, buildWidgetFrameView, widgetFrameGeometry, } from './panel_frame.js';
 /** The order pane is the point of this page, so it keeps a workable width. */
 const ORDER_PANE_MIN_WIDTH = 34;
@@ -89,6 +89,7 @@ export class StatusLinePanelWidget {
         this.lineScroll = 0;
         this.held = null;
         this.notice = null;
+        this.resetFieldCursor();
         this.host.render();
     }
     isActive() {
@@ -171,13 +172,20 @@ export class StatusLinePanelWidget {
     currentOption() {
         return this.catalogueFields()[this.fieldIndex];
     }
+    selectedDescription() {
+        if (this.focus === 'fields')
+            return this.currentOption()?.description;
+        const item = this.sideItems(this.side)[this.lineIndex];
+        return item ? STATUS_LINE_ITEM_DESCRIPTIONS[item] : undefined;
+    }
     /**
      * Typing a query puts the cursor on the first match, so the field you then
      * toggle is the best one the search found rather than wherever the cursor
      * happened to be sitting.
      */
     resetFieldCursor() {
-        this.fieldIndex = 0;
+        const exact = this.catalogueFields().findIndex(option => option.value === this.filterText.trim().toLowerCase());
+        this.fieldIndex = Math.max(0, exact);
         this.fieldScroll = 0;
     }
     // ── Mutations ─────────────────────────────────────────────────────────────
@@ -295,6 +303,15 @@ export class StatusLinePanelWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            if (!input)
+                return;
+            this.filterMode = true;
+            this.filterText += input;
+            this.resetFieldCursor();
+            this.host.render();
+            return;
+        }
         if (this.filterMode) {
             if (key.ctrl && input.toLowerCase() === 'c') {
                 this.cancel();
@@ -596,7 +613,7 @@ export class StatusLinePanelWidget {
         if (this.focus === 'line') {
             return [{ text: '↑↓ move · Space pick up · v variant · x remove · Tab fields · Esc close', style: { color: TERMINAL_THEME.muted, dimColor: true } }];
         }
-        return [{ text: '↑↓ move · Space add or remove · Tab the line · ←→ side · / search · Esc close', style: { color: TERMINAL_THEME.muted, dimColor: true } }];
+        return [{ text: '↑↓ move · Space toggle · Tab pane · ←→ side · / search · Esc close', style: { color: TERMINAL_THEME.muted, dimColor: true } }];
     }
     /**
      * Move the cursor of whichever pane the wheel is over.
@@ -656,11 +673,14 @@ export class StatusLinePanelWidget {
         const showHeadings = height >= 6;
         const showChrome = height >= 8;
         const showPreview = height >= 11 && this.active.enabled !== false;
+        const description = this.selectedDescription();
+        const showDescription = height >= 8 && description !== undefined;
         // The body owns its heading rows, so they are not counted as chrome here.
         const fixed = 2
             + (showFooter ? 1 : 0)
             + (showChrome ? 2 : 0)
-            + (showPreview ? 1 : 0);
+            + (showPreview ? 1 : 0)
+            + (showDescription ? 1 : 0);
         const bodyRows = Math.max(1, height - fixed);
         this.lastBodyRows = Math.max(1, bodyRows - 1);
         if (showChrome) {
@@ -738,6 +758,12 @@ export class StatusLinePanelWidget {
             this.fieldBand = kind === 'fields' ? band : null;
             this.lineBand = kind === 'line' ? band : null;
         }
+        if (showDescription) {
+            lines.push(framedLine([{
+                    text: clipText(description, innerWidth),
+                    style: { color: TERMINAL_THEME.muted },
+                }], width, TERMINAL_THEME.bgPanel));
+        }
         if (showPreview) {
             lines.push(framedLine(this.previewSegments(innerWidth), width, TERMINAL_THEME.bgPanel));
         }

package/dist/ui/widgets/text_input.d.ts

@@ -9,6 +9,8 @@ export interface TextInputData {
     question: string;
     placeholder?: string;
     defaultValue?: string;
+    isPassword?: boolean;
+    allowEmptySubmit?: boolean;
     callback: (value: string | null) => void | Promise<void>;
 }
 export declare class TextInputWidget {

package/dist/ui/widgets/text_input.js

@@ -37,6 +37,16 @@ export class TextInputWidget {
     handleInput(input, key) {
         if (!this.active)
             return;
+        if (key.paste) {
+            if (!input)
+                return;
+            this.completions = [];
+            this.completionIndex = 0;
+            this.value = this.value.slice(0, this.cursor) + input + this.value.slice(this.cursor);
+            this.cursor += input.length;
+            this.host.render();
+            return;
+        }
         // Ctrl+C or Escape to cancel
         if ((key.ctrl && input === 'c') || key.escape) {
             this.host.addSystemMessage('Cancelled.');
@@ -48,6 +58,8 @@ export class TextInputWidget {
         }
         // Enter to submit
         if (key.return) {
+            if (this.active.allowEmptySubmit === false && !this.value.trim())
+                return;
             const callback = this.active.callback;
             const value = this.value;
             this.cancel();
@@ -105,6 +117,8 @@ export class TextInputWidget {
         }
         // Tab - path completion
         if (key.tab) {
+            if (this.active.isPassword)
+                return;
             // If we have alternatives and Tab again, cycle through them
             if (this.completions.length > 1) {
                 this.completionIndex = (this.completionIndex + 1) % this.completions.length;
@@ -163,7 +177,7 @@ export class TextInputWidget {
         lines.push('│ ' + pad(question) + ' │');
         // Input field with block cursor (█)
         const inputWidth = width - 6;
-        let displayValue = this.value;
+        let displayValue = this.active.isPassword ? '•'.repeat(this.value.length) : this.value;
         let cursorPos = this.cursor;
         // Truncate if too long, keeping cursor visible
         if (displayValue.length >= inputWidth) {