dsh-ssh-tui 0.1.0

package/lib/tui.js

@@ -0,0 +1,3685 @@
+/**
+ * A small, dependency-light interactive terminal channel for DeepSeek
+ * Harness. It renders the durable session transcript, streams assistant
+ * output, shows tool-call cards, answers approval requests and
+ * `ask_user_question` prompts from the keyboard, and drives one configured
+ * agent with followup/steer.
+ *
+ * The renderer uses plain ANSI and a throttled full repaint, which keeps it
+ * predictable over slow SSH links and avoids terminal-library dependency
+ * drift inside the plugin.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { StringDecoder } from 'node:string_decoder';
+import { credentialRef } from '@deepseek-ai/dsh-credentials';
+import { createUserMessage, errorChain, ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+import { SessionId } from '@deepseek-ai/dsh-session';
+import { settingsNamespace } from '@deepseek-ai/dsh-settings';
+import { formatSessionTime, listResumableSessions } from './session-list.js';
+import { defaultReasoningEffort } from './reasoning.js';
+import { UserQuestionError, } from '@deepseek-ai/dsh-user-questions';
+const PROVIDER_TEMPLATES = {
+    official: {
+        label: 'DeepSeek 官方',
+        defaultId: 'deepseek-official',
+        defaultBaseUrl: 'https://api.deepseek.com',
+        defaultModels: ['deepseek-v4-pro', 'deepseek-v4-flash'],
+    },
+    'opencode-go': {
+        label: 'OpenCode Go（opencode.ai/zen/go）',
+        defaultId: 'opencode-go',
+        defaultBaseUrl: 'https://opencode.ai/zen/go/v1',
+        api: 'openai-responses',
+        defaultModels: ['deepseek-v4-flash', 'deepseek-v4-pro'],
+    },
+    'openai-completions': {
+        label: '自定义 OpenAI 兼容网关（Completions）',
+        defaultId: 'my-gateway',
+        defaultBaseUrl: '',
+        api: 'openai-completions',
+        defaultModels: ['deepseek-v4-flash'],
+    },
+    'openai-responses': {
+        label: '自定义 OpenAI Responses 网关',
+        defaultId: 'my-responses',
+        defaultBaseUrl: '',
+        api: 'openai-responses',
+        defaultModels: ['deepseek-v4-flash'],
+    },
+    'anthropic-messages': {
+        label: 'Anthropic Messages 兼容网关',
+        defaultId: 'my-anthropic',
+        defaultBaseUrl: '',
+        api: 'anthropic-messages',
+        defaultModels: ['deepseek-v4-flash'],
+    },
+};
+const RENDER_INTERVAL_MS = 120;
+const WAIT_INDICATOR_MS = 8000;
+const STALL_WARNING_MS = 60000;
+const SPINNER = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const RESERVED_BOTTOM_LINES = 3; // input line + stats line + status line
+const MAX_TRANSCRIPT_ROWS = 5000;
+const IS_WINDOWS = process.platform === 'win32';
+function dshHomeDir() {
+    return process.env.DSH_HOME ?? join(homedir(), '.dsh');
+}
+function displayDshPath(file) {
+    const home = dshHomeDir();
+    if (IS_WINDOWS) {
+        const profile = process.env.USERPROFILE;
+        if (profile !== undefined && home.toLowerCase().startsWith(profile.toLowerCase())) {
+            const rest = home.slice(profile.length);
+            return `%USERPROFILE%${rest}\\${file}`.replaceAll('/', '\\');
+        }
+        return `${home}\\${file}`.replaceAll('/', '\\');
+    }
+    return `~/.dsh/${file}`;
+}
+const DSH_ENV_FILE = join(dshHomeDir(), IS_WINDOWS ? 'env.cmd' : 'env.sh');
+const DEEPSEEK_LOGO_VARIANTS = [
+    {
+        width: 52,
+        lines: [
+            '',
+            '',
+            '                                   .:',
+            '             ...... .-=*###-      .%%.',
+            '        -+*%%%@@@@%%@@@@@@.       =@%%*-.        -*-.',
+            '     :*%@@@@@@%%%%@@%%%%%%*:      -@%@@@%= -+***%@@.',
+            '    +@@@%%%%%%%%%%%%%%%@@%@@#=     #@%%%@@%@@@@@@@=',
+            '  .#@%%%%%%%%%%%%@@@@@@%%@%%@@%=    *@@%%%@%%@@@%=',
+            '  #@@@@@@@@@@@%%%%%%@@@@%@%%%%%@%=   .*%%%%%%#*-',
+            ' =@%*=---=+*#%@@@%%%%%@@@%@@%@@@@@%+: *@%%%-',
+            ' #%@-        .-+%@@@%%%%%%%+: .=#@%@@@%@%%%%.',
+            ' #%@*            :*%@%%@%%%+++  -%@%%@%@%%*',
+            ' #%%%.             .+@@%%%@%%%   .#%%%%%%@:',
+            ' =@%@*               :#@%%@@@%#=--#%%%%%@+',
+            '  %@%@+                +@@%%%%@@@@@%@%%@*',
+            '  :%@%@*                -%@%%%%%%%%@%@@+',
+            '   :%@%@%-       -+-.    .*@@%%%%%@%@#-',
+            '    .*@@@@#-.    :%@%*-    -%@@%%%%%*',
+            '      :#@@@@%*=:::#%%@@%+:   -*@@@@@%#*=:',
+            '        :+%@@@@@@@@%%%%%@@%#*+**+*##%%%#=',
+            '           :+*%%@@@@@@@@@@@%#+:',
+            '               .:-=====--:.',
+        ],
+    },
+    {
+        width: 44,
+        lines: [
+            '',
+            '',
+            '                  .:-==.     :#.',
+            '       :=*#######%%@@@-      *@%=:       .=:',
+            '    .+%@@@@@@@@@@@@%%%+:     *@%@@#::=+**%@:',
+            '   +%@@%%%%%%%%%%%%%@%@@#-   .%@%%@%@@@@@@+',
+            '  *@@@@@@@%%%%%%%@@%%@%%@@#-  .+%%%@@@@%#-',
+            ' =@%####%%@@@@%%%%%@@@@@@@@@#-  =%%%#=-.',
+            ' %%*     .:-*%@@@%%%%%%+-+#@@@%#%@%%=',
+            '.%%#          :*%@%%%%%=+  =%%@@@%%@:',
+            ' %%@-           .+@@%%@#@-  :%%%%%@*',
+            ' +@%%.            :#@%%@%%*++%%%%@%.',
+            ' .%@%#.             *@@%%@@@@@%%@%.',
+            '  .%@@%-      .:.    =%@%%%%%%@@*.',
+            '   .*@@@#-    .%%*=.  .*@@@%%%%-',
+            '     -#@@@%+-::*@@@%*-  :+%@@@@#*=.',
+            '       :+#@@@@@@@@%@@@@%*++-++****:',
+            '          :=+*#%%%%%##*+-.',
+        ],
+    },
+    {
+        width: 36,
+        lines: [
+            '',
+            '',
+            '                 .:     ::',
+            '      :-++++++*#%%-     %%-.      :.',
+            '   .+%@@@@@@@@@@@%=.    %@@%+:=++#@=',
+            '  =%@@%%%%%%%%%%%%@%*:  -%@@@@@@@@+',
+            ' =@@@@@@@@@%%%%%@@%@@@*:  +%%%%#+:',
+            '.%%-..:-=*%@@@%%%%%**%@@#=+%%%',
+            ':@%.       :+%@%%%%=: +%@@@%%*',
+            '.%%+         .+@@%%%#  =%%%%@.',
+            ' *@%-          :%@%@@%##@%%@=',
+            ' .#@%=           *@@%@@@%@%-',
+            '  .*@@#-    **=.  -%@@%%%*',
+            '    -#@@%+-:+@@%*- .=%@@@#*=',
+            '      :+#@@@@@@@@@@#+=:-====',
+            '         .:-=+++=-:.',
+        ],
+    },
+    {
+        width: 28,
+        lines: [
+            '',
+            '',
+            '     .:----=+*:   :#:      .',
+            '  .+#%@@@@@@@@=.  -@@#--++%+',
+            ' :%@@@@%%%%%%%@@+. =%@@@@@+',
+            '.%#++*#%@@@%%@%%@@+:=%%+:.',
+            '=%-     :+%@%%#=.+@@%%%',
+            ':@#       .+@@%%- *%%@+',
+            ' *@*        :%@%@@%@@*',
+            '  *@#:   :=:  +%@@%%-',
+            '   -#@%+-+@@#=.=#%@%+-',
+            '     :+#%@%%@@#+:.::-:',
+            '          ...',
+        ],
+    },
+    {
+        width: 20,
+        lines: [
+            '',
+            '     ...:-.  -.',
+            '  +#%%%%@@=  +@*-+*+',
+            '.#@%@@@@%%@%+.+@@#+',
+            '*#  .-+%@%#-*%*@=',
+            '=@.     +@%*-%@%.',
+            ' *%-   . :#@@@*.',
+            '  -##++@%=-*#%+.',
+            '    :=++*+=.  .',
+        ],
+    },
+];
+const LOCAL_COMMANDS = [
+    { name: 'help', description: 'show all available commands' },
+    { name: 'model', description: 'select model and reasoning effort (same provider)' },
+    { name: 'mode', description: 'switch agent mode / preset (standard, PTC, minimal, ...)' },
+    { name: 'quit', description: 'exit the TUI' },
+    { name: 'exit', description: 'exit the TUI' },
+    { name: 'clear', description: 'clear the transcript view' },
+    { name: 'status', description: 'show session, provider and model status' },
+    { name: 'usage', description: 'show OpenCode Zen billing / Go quota usage' },
+    { name: 'quota', description: 'alias of /usage for OpenCode Go quota' },
+    { name: 'subagents', description: 'list active subagents' },
+    { name: 'resume', description: 'resume a past session (empty = session picker)' },
+    { name: 'setup', description: 're-open provider / API key setup' },
+    { name: 'dialog-test', description: 'verify the question dialog' },
+];
+function displayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        const cp = char.codePointAt(0) ?? 0;
+        const wide = (cp >= 0x1100 && cp <= 0x115f) ||
+            (cp >= 0x2e80 && cp <= 0xa4cf) ||
+            (cp >= 0xac00 && cp <= 0xd7a3) ||
+            (cp >= 0xf900 && cp <= 0xfaff) ||
+            (cp >= 0xfe30 && cp <= 0xfe4f) ||
+            (cp >= 0xff00 && cp <= 0xff60) ||
+            (cp >= 0xffe0 && cp <= 0xffe6) ||
+            (cp >= 0x1f300 && cp <= 0x1faff) ||
+            (cp >= 0x20000 && cp <= 0x3fffd);
+        width += wide ? 2 : 1;
+    }
+    return width;
+}
+function wrap(text, width) {
+    const lines = [];
+    for (const rawLine of text.split('\n')) {
+        if (rawLine === '') {
+            lines.push('');
+            continue;
+        }
+        let rest = rawLine;
+        while (displayWidth(rest) > width) {
+            let cut = 0;
+            let used = 0;
+            for (const char of rest) {
+                const charWidth = displayWidth(char);
+                if (used + charWidth > width)
+                    break;
+                used += charWidth;
+                cut += char.length;
+            }
+            if (cut === 0)
+                cut = 1;
+            lines.push(rest.slice(0, cut));
+            rest = rest.slice(cut);
+        }
+        lines.push(rest);
+    }
+    return lines;
+}
+function truncate(text, maxLines) {
+    const lines = text.split('\n');
+    if (lines.length <= maxLines)
+        return text;
+    const head = lines.slice(0, Math.max(1, maxLines - 1));
+    const tail = lines.slice(-1);
+    return [...head, `… ${lines.length - head.length - 1} more line(s) …`, ...tail].join('\n');
+}
+const INLINE_MARKDOWN_PATTERN = /(\*\*[^*\n]+\*\*)|(`[^`\n]+`)|(\[[^\]\n]+\]\([^)\n]+\))|(\*[^*\n]+\*)|(_[^_\n]+_)/gu;
+/** Parse one line's bold / italic / inline-code / link spans. */
+function parseInlineMarkdown(line) {
+    const segments = [];
+    let last = 0;
+    for (const match of line.matchAll(INLINE_MARKDOWN_PATTERN)) {
+        const index = match.index;
+        if (index > last)
+            segments.push({ kind: 'text', text: line.slice(last, index) });
+        const token = match[0];
+        if (match[1] !== undefined) {
+            segments.push({ kind: 'bold', text: token.slice(2, -2) });
+        }
+        else if (match[2] !== undefined) {
+            segments.push({ kind: 'code', text: token.slice(1, -1) });
+        }
+        else if (match[3] !== undefined) {
+            const labelEnd = token.indexOf('](');
+            const label = token.slice(1, labelEnd);
+            const url = token.slice(labelEnd + 2, -1);
+            segments.push({ kind: 'link', text: label });
+            if (url !== '')
+                segments.push({ kind: 'muted', text: ` (${url})` });
+        }
+        else if (match[4] !== undefined) {
+            segments.push({ kind: 'italic', text: token.slice(1, -1) });
+        }
+        else if (match[5] !== undefined) {
+            segments.push({ kind: 'italic', text: token.slice(1, -1) });
+        }
+        last = index + token.length;
+    }
+    if (last < line.length)
+        segments.push({ kind: 'text', text: line.slice(last) });
+    if (segments.length === 0)
+        segments.push({ kind: 'text', text: line });
+    return segments;
+}
+function markdownSegmentWidth(segments) {
+    return segments.reduce((total, segment) => total + displayWidth(segment.text), 0);
+}
+/** Wrap styled inline segments into visual rows, carrying a prefix only on row one. */
+function wrapMarkdownSegments(segments, width, prefixSegments = []) {
+    const limit = Math.max(1, width);
+    const lines = [];
+    let current = [...prefixSegments];
+    let used = markdownSegmentWidth(current);
+    for (const segment of segments) {
+        let rest = segment.text;
+        while (rest !== '') {
+            const available = limit - used;
+            if (available <= 0) {
+                lines.push(current);
+                current = [];
+                used = 0;
+                continue;
+            }
+            const slice = forwardSliceByWidth(rest, available);
+            let chunk = slice.text;
+            if (chunk === '') {
+                // A wide character does not fit the remaining cell; take one code
+                // point so the loop always makes progress. The terminal wraps it.
+                chunk = Array.from(rest)[0] ?? rest.slice(0, 1);
+            }
+            current.push({ kind: segment.kind, text: chunk });
+            used += displayWidth(chunk);
+            rest = rest.slice(chunk.length);
+            if (rest !== '') {
+                lines.push(current);
+                current = [];
+                used = 0;
+            }
+        }
+    }
+    if (current.length > 0 || lines.length === 0)
+        lines.push(current);
+    return lines.map(line => line.length === 0 ? [{ kind: 'text', text: '' }] : line);
+}
+function markdownSegmentCode(kind) {
+    switch (kind) {
+        case 'bold': return '1;97';
+        case 'italic': return '3;37';
+        case 'code': return '36';
+        case 'link': return '4;36';
+        case 'muted': return '2;37';
+        default: return '';
+    }
+}
+function markdownBaseCode(kind) {
+    switch (kind) {
+        case 'heading1': return '1;4;97';
+        case 'heading2': return '1;4;36';
+        case 'heading3': return '1;36';
+        case 'code': return '36';
+        case 'quote': return '3;37';
+        case 'rule': return '90';
+        default: return '1;37';
+    }
+}
+/** Render one pre-wrapped markdown line as ANSI (or plain text without color). */
+function renderMarkdownBlockLine(block, color) {
+    if (!color)
+        return block.segments.map(segment => segment.text).join('');
+    const base = markdownBaseCode(block.base);
+    let out = `\x1b[${base}m`;
+    for (const segment of block.segments) {
+        const code = markdownSegmentCode(segment.kind);
+        if (code === '') {
+            out += segment.text;
+        }
+        else {
+            out += `\x1b[${code}m${segment.text}\x1b[${base}m`;
+        }
+    }
+    return `${out}\x1b[0m`;
+}
+/** Enlarge H1 text visually: fullwidth ASCII and spaced CJK glyphs. */
+function expandHeadingText(text) {
+    let out = '';
+    for (const char of text) {
+        const cp = char.codePointAt(0) ?? 0;
+        if (cp >= 0x21 && cp <= 0x7e) {
+            out += String.fromCodePoint(0xff01 + cp - 0x21);
+        }
+        else if (char.trim() === '') {
+            out += ' ';
+        }
+        else {
+            out += `${char} `;
+        }
+    }
+    return out;
+}
+function headingSegments(text, level) {
+    const segments = parseInlineMarkdown(text);
+    if (level !== 1)
+        return segments;
+    return segments.map(segment => segment.kind === 'code' || segment.kind === 'link' || segment.kind === 'muted'
+        ? segment
+        : { kind: segment.kind, text: expandHeadingText(segment.text) });
+}
+/**
+ * Render workspace markdown into width-bounded terminal rows. Assistant
+ * replies get a bold-white base; code blocks, headings, quotes, lists, rules,
+ * links and inline spans keep their own ANSI treatment.
+ */
+export function renderMarkdownLines(text, width, color) {
+    const lines = [];
+    let inFence = false;
+    for (const raw of text.split('\n')) {
+        const fence = /^```([^\n]*)$/u.exec(raw.trim());
+        if (fence !== null) {
+            inFence = !inFence;
+            lines.push(renderMarkdownBlockLine({
+                base: 'code',
+                segments: [{ kind: 'text', text: `\`\`\`${fence[1] ?? ''}` }],
+            }, color));
+            continue;
+        }
+        if (inFence) {
+            if (raw === '') {
+                lines.push('');
+                continue;
+            }
+            for (const line of wrap(raw, width)) {
+                lines.push(renderMarkdownBlockLine({
+                    base: 'code',
+                    segments: [{ kind: 'text', text: line }],
+                }, color));
+            }
+            continue;
+        }
+        const heading = /^(#{1,6})\s+(.*)$/u.exec(raw);
+        if (heading !== null) {
+            // The hashes are markdown syntax, not content: replace them with
+            // heading style. Levels differ visually: H1 is enlarged and
+            // underlined, H2 underlined, H3 colored, H4+ bold white.
+            const level = Math.min(6, (heading[1] ?? '#').length);
+            const base = level === 1
+                ? 'heading1'
+                : level === 2
+                    ? 'heading2'
+                    : level === 3
+                        ? 'heading3'
+                        : 'assistant';
+            if (level === 1 && lines.at(-1) !== '')
+                lines.push('');
+            for (const segments of wrapMarkdownSegments(headingSegments(heading[2] ?? '', level), width)) {
+                lines.push(renderMarkdownBlockLine({ base, segments }, color));
+            }
+            if (level === 1)
+                lines.push('');
+            continue;
+        }
+        if (/^\s*(?:-{3,}|\*{3,}|_{3,})\s*$/u.test(raw) && raw.trim() !== '') {
+            lines.push(renderMarkdownBlockLine({
+                base: 'rule',
+                segments: [{ kind: 'text', text: '─'.repeat(Math.max(1, width)) }],
+            }, color));
+            continue;
+        }
+        const quote = /^(\s*)>\s?(.*)$/u.exec(raw);
+        if (quote !== null) {
+            const indent = quote[1] ?? '';
+            const prefix = `${indent}│ `;
+            for (const segments of wrapMarkdownSegments(parseInlineMarkdown(quote[2] ?? ''), width, [{ kind: 'text', text: prefix }])) {
+                lines.push(renderMarkdownBlockLine({ base: 'quote', segments }, color));
+            }
+            continue;
+        }
+        const list = /^(\s*)([-*+]|\d+[.)])\s+(.*)$/u.exec(raw);
+        if (list !== null) {
+            const indent = list[1] ?? '';
+            const marker = list[2] ?? '-';
+            const prefix = `${indent}${marker} `;
+            for (const segments of wrapMarkdownSegments(parseInlineMarkdown(list[3] ?? ''), width, [{ kind: 'text', text: prefix }])) {
+                lines.push(renderMarkdownBlockLine({ base: 'assistant', segments }, color));
+            }
+            continue;
+        }
+        if (raw === '') {
+            lines.push('');
+            continue;
+        }
+        for (const segments of wrapMarkdownSegments(parseInlineMarkdown(raw), width)) {
+            lines.push(renderMarkdownBlockLine({ base: 'assistant', segments }, color));
+        }
+    }
+    return lines;
+}
+/** Cut one line to fit a width, appending an ellipsis when truncated. */
+function truncateToWidth(text, width) {
+    if (displayWidth(text) <= width)
+        return text;
+    let cut = 0;
+    let used = 0;
+    for (const char of text) {
+        const charWidth = displayWidth(char);
+        if (used + charWidth > width - 1)
+            break;
+        used += charWidth;
+        cut += char.length;
+    }
+    if (cut === 0)
+        cut = 1;
+    return `${text.slice(0, cut)}…`;
+}
+/** Slice up to `maxWidth` display columns from the beginning of `text`. */
+function forwardSliceByWidth(text, maxWidth) {
+    let cut = 0;
+    let used = 0;
+    for (const char of text) {
+        const charWidth = displayWidth(char);
+        if (used + charWidth > maxWidth)
+            break;
+        used += charWidth;
+        cut += char.length;
+    }
+    return { text: text.slice(0, cut), width: used };
+}
+/** Slice up to `maxWidth` display columns ending at `end` in `text`. */
+function backwardSliceByWidth(text, end, maxWidth) {
+    if (end <= 0 || maxWidth <= 0)
+        return { start: end, width: 0 };
+    const chars = Array.from(text.slice(0, end));
+    let used = 0;
+    let firstIncluded = chars.length;
+    for (let index = chars.length - 1; index >= 0; index--) {
+        const charWidth = displayWidth(chars[index] ?? '');
+        if (used + charWidth > maxWidth)
+            break;
+        used += charWidth;
+        firstIncluded = index;
+    }
+    return {
+        start: chars.slice(0, firstIncluded).join('').length,
+        width: used,
+    };
+}
+/**
+ * Fold a long single-line input into one terminal row around the cursor.
+ * Only the *display* is clipped; the caller keeps the original `input` intact
+ * for editing and submission.
+ */
+export function foldInputView(input, cursor, maxWidth) {
+    const width = Math.max(1, maxWidth);
+    const totalWidth = displayWidth(input);
+    const cursorOffset = displayWidth(input.slice(0, cursor));
+    if (totalWidth <= width) {
+        return { text: input, cursorOffset, folded: false };
+    }
+    const before = cursorOffset;
+    const after = totalWidth - cursorOffset;
+    const leftFolded = before > 0;
+    const rightFolded = after > 0;
+    const markers = (leftFolded ? 1 : 0) + (rightFolded ? 1 : 0);
+    const available = Math.max(1, width - markers);
+    let beforeBudget = Math.min(before, Math.ceil(available / 2));
+    let afterBudget = Math.min(after, available - beforeBudget);
+    // If the tail is shorter than its budget, spend the spare columns on the
+    // side before the cursor so the cursor stays visible near its true offset.
+    beforeBudget = Math.min(before, beforeBudget + (available - beforeBudget - afterBudget));
+    const beforeSlice = backwardSliceByWidth(input, cursor, beforeBudget);
+    const afterSlice = forwardSliceByWidth(input.slice(cursor), afterBudget);
+    const beforeText = input.slice(beforeSlice.start, cursor);
+    return {
+        text: `${leftFolded ? '…' : ''}${beforeText}${afterSlice.text}${rightFolded ? '…' : ''}`,
+        cursorOffset: (leftFolded ? 1 : 0) + displayWidth(beforeText),
+        folded: true,
+    };
+}
+const OPENCODE_GO_USAGE_URL = 'https://opencode.ai/zen/go/v1/usage';
+const OPENCODE_ZEN_BASE_URL = 'https://opencode.ai/zen/v1';
+/**
+ * Classify the currently selected provider as an OpenCode route. Built-in
+ * `opencode`/`opencode-go` ids are recognized directly, and custom llm-pi-ai
+ * routes are recognized by their `opencode.ai` base URL.
+ */
+export function openCodeSourceFor(provider, llmPiAiSection) {
+    const section = llmPiAiSection;
+    const profile = section?.providers?.[provider];
+    const baseURL = typeof profile?.baseURL === 'string' ? profile.baseURL : undefined;
+    const lowerBase = baseURL?.toLowerCase() ?? '';
+    const isGo = provider === 'opencode-go' || lowerBase.includes('opencode.ai/zen/go');
+    const isZen = provider === 'opencode' || (lowerBase.includes('opencode.ai/zen') && !isGo);
+    if (!isGo && !isZen)
+        return null;
+    const apiKeyEnv = typeof profile?.apiKeyEnv === 'string' && profile.apiKeyEnv.trim() !== ''
+        ? profile.apiKeyEnv
+        : provider === 'opencode' || provider === 'opencode-go'
+            ? 'OPENCODE_API_KEY'
+            : `${provider.replaceAll('-', '_').toUpperCase()}_API_KEY`;
+    const label = typeof profile?.displayName === 'string' && profile.displayName.trim() !== ''
+        ? profile.displayName
+        : isGo ? 'OpenCode Go' : 'OpenCode Zen';
+    return {
+        provider,
+        flavor: isGo ? 'go' : 'zen',
+        label,
+        apiKeyEnv,
+        ...(baseURL === undefined ? {} : { baseURL }),
+    };
+}
+function openCodeGoUsageWindow(value) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const raw = value;
+    return {
+        ...(typeof raw.status === 'string' ? { status: raw.status } : {}),
+        ...(typeof raw.percent === 'number' && Number.isFinite(raw.percent) ? { percent: raw.percent } : {}),
+        ...(typeof raw.resetsAt === 'string' ? { resetsAt: raw.resetsAt } : {}),
+    };
+}
+/** A days/hours/minutes/seconds relative duration for quota reset times. */
+function formatRelativeDuration(ms) {
+    const seconds = Math.max(0, Math.floor(ms / 1000));
+    if (seconds < 60)
+        return `${seconds}s`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m${seconds % 60}s`;
+    if (seconds < 86400) {
+        return `${Math.floor(seconds / 3600)}h${Math.floor(seconds % 3600 / 60)}m`;
+    }
+    return `${Math.floor(seconds / 86400)}d${Math.floor(seconds % 86400 / 3600)}h`;
+}
+/** One compact `████░░ 40.0% · 正常 · 约 2m 后重置` line for a Go limit. */
+function formatOpenCodeGoWindow(label, value) {
+    const window = openCodeGoUsageWindow(value);
+    const percent = window?.percent === undefined
+        ? null
+        : Math.max(0, Math.min(100, window.percent));
+    const state = window?.status === 'rate-limited'
+        ? '已限流'
+        : window?.status === 'ok'
+            ? '正常'
+            : window?.status ?? '未知状态';
+    const parts = [label];
+    if (percent !== null) {
+        const barWidth = 16;
+        const filled = Math.round(percent / 100 * barWidth);
+        parts.push(`${'█'.repeat(filled)}${'░'.repeat(barWidth - filled)} ${percent.toFixed(1)}%`);
+    }
+    parts.push(state);
+    if (window?.resetsAt !== undefined) {
+        const reset = new Date(window.resetsAt);
+        if (!Number.isNaN(reset.getTime())) {
+            const until = reset.getTime() - Date.now();
+            parts.push(until > 0
+                ? `约 ${formatRelativeDuration(until)} 后重置（${reset.toLocaleString()}）`
+                : `已于 ${reset.toLocaleString()} 重置`);
+        }
+    }
+    return `  ${parts.join(' · ')}`;
+}
+/** Render the OpenCode Go quota payload as a transcript block. */
+export function formatOpenCodeGoUsage(payload, source) {
+    const raw = payload;
+    const usage = raw?.usage;
+    if (usage === null || usage === undefined) {
+        throw new Error('额度接口返回格式无法识别');
+    }
+    return [
+        `OpenCode Go 额度（${source.provider}）`,
+        formatOpenCodeGoWindow('滚动 5 小时', usage.rolling),
+        formatOpenCodeGoWindow('本周', usage.weekly),
+        formatOpenCodeGoWindow('本月', usage.monthly),
+    ].join('\n');
+}
+/** Extract a safe human-readable message from an OpenCode error payload. */
+function openCodeApiErrorMessage(payload) {
+    if (typeof payload !== 'object' || payload === null)
+        return '';
+    const raw = payload;
+    const error = raw.error;
+    if (typeof error === 'string' && error.trim() !== '')
+        return error.trim();
+    if (typeof error === 'object' && error !== null) {
+        const message = error.message;
+        if (typeof message === 'string' && message.trim() !== '')
+            return message.trim();
+    }
+    if (typeof raw.message === 'string' && raw.message.trim() !== '')
+        return raw.message.trim();
+    return '';
+}
+/** Whether `text` could still grow into a recognized escape sequence. */
+function isEscapePrefix(text) {
+    if (text === '\x1b')
+        return true;
+    if (!text.startsWith('\x1b'))
+        return false;
+    if (text === '\x1b[')
+        return true;
+    if (/^\x1b\[[A-D]$/u.test(text))
+        return true;
+    if (/^\x1b\[[HF]$/u.test(text))
+        return true;
+    if (/^\x1b\[\d~?$/u.test(text))
+        return true;
+    if (/^\x1b\[<(?:\d*;?)*[Mm]?$/u.test(text))
+        return true;
+    return false;
+}
+/** Parse a tool call's raw arguments JSON into an object; null when unparsable. */
+function parseJsonArgs(args) {
+    try {
+        const parsed = JSON.parse(args);
+        return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** A short scalar rendering of one argument value, or null for objects/arrays. */
+function scalarText(value) {
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return null;
+}
+/** Prefer the fields a human scans for; fall back to the first scalar pairs. */
+function friendlyArgsSummary(name, args) {
+    const parsed = parseJsonArgs(args);
+    if (parsed === null)
+        return args.slice(0, 120);
+    const preferred = [
+        'path', 'file_path', 'file', 'query', 'pattern', 'url', 'command',
+        'description', 'content', 'file_text', 'old_string', 'new_string',
+        'old_str', 'new_str', 'insert_line', 'line', 'offset', 'limit',
+    ];
+    const parts = [];
+    for (const key of preferred) {
+        const value = parsed[key];
+        if (value === undefined || value === null || typeof value === 'object')
+            continue;
+        parts.push(`${key}: ${String(value)}`);
+        if (parts.length >= 3)
+            break;
+    }
+    if (parts.length === 0) {
+        for (const [key, value] of Object.entries(parsed)) {
+            const text = scalarText(value);
+            if (text !== null) {
+                parts.push(`${key}: ${text}`);
+                if (parts.length >= 3)
+                    break;
+            }
+        }
+    }
+    const summary = parts.join('  ');
+    return summary === '' ? name : summary.slice(0, 160);
+}
+const SHELL_TOOL_NAMES = new Set(['bash', 'pwsh']);
+const DIFF_TOOL_NAMES = new Set(['edit', 'write', 'str_replace_editor']);
+/** Derive the intended file change from a mutation tool's arguments. */
+function diffHunksFromArgs(name, argsRaw) {
+    const args = parseJsonArgs(argsRaw);
+    if (args === null)
+        return null;
+    if (name === 'edit' || name === 'write') {
+        const path = typeof args.file_path === 'string' ? args.file_path : '';
+        if (path === '')
+            return null;
+        if (name === 'edit') {
+            return [{
+                    path,
+                    oldText: typeof args.old_string === 'string' ? args.old_string : null,
+                    newText: typeof args.new_string === 'string' ? args.new_string : '',
+                }];
+        }
+        return [{
+                path,
+                oldText: null,
+                newText: typeof args.content === 'string' ? args.content : '',
+            }];
+    }
+    if (name === 'str_replace_editor') {
+        const path = typeof args.path === 'string' ? args.path : '';
+        const command = typeof args.command === 'string' ? args.command : '';
+        if (path === '')
+            return null;
+        if (command === 'create') {
+            return [{ path, oldText: null, newText: typeof args.file_text === 'string' ? args.file_text : '' }];
+        }
+        if (command === 'str_replace') {
+            return [{
+                    path,
+                    oldText: typeof args.old_str === 'string' ? args.old_str : null,
+                    newText: typeof args.new_str === 'string' ? args.new_str : '',
+                }];
+        }
+    }
+    return null;
+}
+/** One-line friendly tool-call presentation (command / path / arg summary). */
+export function presentToolCall(name, args) {
+    const parsed = parseJsonArgs(args);
+    if (SHELL_TOOL_NAMES.has(name)) {
+        const command = typeof parsed?.command === 'string' ? parsed.command : args.slice(0, 80);
+        return {
+            title: name,
+            summary: `$ ${command}`,
+            command,
+            cwd: typeof parsed?.workdir === 'string' ? parsed.workdir : undefined,
+        };
+    }
+    if (DIFF_TOOL_NAMES.has(name)) {
+        const diff = diffHunksFromArgs(name, args);
+        const path = diff?.[0]?.path;
+        return {
+            title: name,
+            summary: path ?? friendlyArgsSummary(name, args),
+            ...diff === null || diff === undefined ? {} : { diff },
+        };
+    }
+    return { title: name, summary: friendlyArgsSummary(name, args) };
+}
+/** Validate a tool/result meta payload's structured diff, mirroring the web card. */
+export function diffMetaDiffs(meta) {
+    if (typeof meta !== 'object' || meta === null)
+        return null;
+    const diffs = meta.diffs;
+    if (!Array.isArray(diffs) || diffs.length === 0)
+        return null;
+    const out = [];
+    for (const hunk of diffs) {
+        if (typeof hunk !== 'object' || hunk === null)
+            return null;
+        const { path, oldText, newText } = hunk;
+        if (typeof path !== 'string' || typeof newText !== 'string')
+            return null;
+        if (oldText !== null && typeof oldText !== 'string')
+            return null;
+        out.push({ path, oldText: oldText, newText });
+    }
+    return out;
+}
+/** Split one diff side into content lines (trailing newline is a terminator). */
+function diffContentLines(text) {
+    if (text === '')
+        return [];
+    const body = text.endsWith('\n') ? text.slice(0, -1) : text;
+    return body.split('\n');
+}
+/** Flatten hunks into git-style `-`/`+` lines plus the web-compatible footer. */
+export function renderToolDiff(diffs, maxLines) {
+    const rows = [];
+    const paths = new Set();
+    let added = 0;
+    let removed = 0;
+    let prevPath;
+    for (const hunk of diffs) {
+        paths.add(hunk.path);
+        rows.push(hunk.path === prevPath
+            ? { kind: 'diff-path', text: '⋯' }
+            : { kind: 'diff-path', text: hunk.path });
+        prevPath = hunk.path;
+        if (hunk.oldText !== null) {
+            for (const line of diffContentLines(hunk.oldText)) {
+                rows.push({ kind: 'diff-del', text: `- ${line}` });
+                removed += 1;
+            }
+        }
+        for (const line of diffContentLines(hunk.newText)) {
+            rows.push({ kind: 'diff-add', text: `+ ${line}` });
+            added += 1;
+        }
+    }
+    rows.push({
+        kind: 'tool-result',
+        text: `└ +${added} -${removed} · ${paths.size} file${paths.size === 1 ? '' : 's'}`,
+    });
+    if (rows.length <= maxLines)
+        return rows;
+    const head = rows.slice(0, Math.max(1, maxLines - 1));
+    const tail = rows.slice(-1);
+    return [
+        ...head,
+        { kind: 'tool-result', text: `… ${rows.length - head.length - 1} more line(s) …` },
+        ...tail,
+    ];
+}
+/** Keys whose multiline strings render as indented content blocks. */
+const LONG_TEXT_KEYS = new Set([
+    'program', 'content', 'file_text', 'new_string', 'old_string',
+    'plan', 'markdown', 'details', 'description', 'text',
+]);
+const JSON_STRING_CAP = 400;
+/** Convert any parsed JSON value into readable indented display lines. */
+export function friendlyJsonLines(value, depth = 0) {
+    const pad = '  '.repeat(depth);
+    if (value === null)
+        return [`${pad}null`];
+    if (typeof value === 'string') {
+        const capped = value.length > JSON_STRING_CAP ? `${value.slice(0, JSON_STRING_CAP)}…` : value;
+        return [`${pad}${capped}`];
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return [`${pad}${String(value)}`];
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return [`${pad}[]`];
+        const lines = [];
+        for (const item of value) {
+            if (item !== null && typeof item === 'object') {
+                lines.push(`${pad}-`);
+                lines.push(...friendlyJsonLines(item, depth + 1));
+            }
+            else {
+                lines.push(`${pad}- ${friendlyJsonLines(item, 0)[0] ?? ''}`);
+            }
+        }
+        return lines;
+    }
+    if (typeof value === 'object') {
+        const entries = Object.entries(value);
+        if (entries.length === 0)
+            return [`${pad}{}`];
+        const lines = [];
+        for (const [key, item] of entries) {
+            if (typeof item === 'string' && item.includes('\n') && LONG_TEXT_KEYS.has(key)) {
+                const contentLines = item.split('\n');
+                lines.push(`${pad}${key}:`);
+                for (const contentLine of contentLines.slice(0, 80)) {
+                    lines.push(`${pad}  │ ${contentLine}`);
+                }
+                if (contentLines.length > 80) {
+                    lines.push(`${pad}  … ${contentLines.length - 80} more line(s)`);
+                }
+            }
+            else if (item !== null && typeof item === 'object') {
+                lines.push(`${pad}${key}:`);
+                lines.push(...friendlyJsonLines(item, depth + 1));
+            }
+            else {
+                const scalar = friendlyJsonLines(item, 0)[0] ?? '';
+                lines.push(`${pad}${key}: ${scalar}`);
+            }
+        }
+        return lines;
+    }
+    return [`${pad}${String(value)}`];
+}
+/** Try to parse a result body as one JSON document, when it looks like one. */
+function parseJsonBody(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('{') && !trimmed.startsWith('['))
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The expanded body of one tool card: diffs and shell output keep their
+ * dedicated views; every other tool's JSON arguments and JSON result are
+ * converted into readable indented content instead of raw JSON text.
+ */
+export function toolBodyLines(row, maxLines) {
+    if (row.diff !== undefined && row.diff.length > 0) {
+        // File-edit diffs are never truncated: omitting hunks would hide the
+        // exact code change the model applied. `maxLines` only governs shell and
+        // generic JSON output bodies.
+        return renderToolDiff(row.diff, Number.MAX_SAFE_INTEGER);
+    }
+    if (row.command !== undefined) {
+        const out = [];
+        if (row.output !== '') {
+            for (const line of truncate(row.output, maxLines).split('\n')) {
+                out.push({ kind: row.status === 'error' ? 'error' : 'tool-result', text: line });
+            }
+        }
+        else if (row.status !== 'running' && row.status !== undefined) {
+            out.push({ kind: 'tool-result', text: '(无输出)' });
+        }
+        return out;
+    }
+    const out = [];
+    const args = parseJsonArgs(row.args);
+    if (args !== null && Object.keys(args).length > 0) {
+        out.push({ kind: 'diff-path', text: '参数' });
+        for (const line of friendlyJsonLines(args)) {
+            out.push({ kind: 'tool-result', text: line });
+        }
+    }
+    if (row.output !== '') {
+        out.push({ kind: 'diff-path', text: '结果' });
+        const parsed = parseJsonBody(row.output);
+        if (parsed !== null) {
+            for (const line of friendlyJsonLines(parsed)) {
+                out.push({ kind: 'tool-result', text: line });
+            }
+        }
+        else {
+            for (const line of truncate(row.output, maxLines).split('\n')) {
+                out.push({ kind: 'tool-result', text: line });
+            }
+        }
+    }
+    return out;
+}
+/** Recover the shell tools' exit marker, mirroring @deepseek-ai/dsh-shell/render. */
+export function parseExitStatus(text) {
+    const signal = /\n\[killed by signal: ([^\]\n]+)\]$/.exec(text);
+    if (signal?.[1] !== undefined) {
+        return { body: text.slice(0, signal.index), signal: signal[1] };
+    }
+    const exit = /\n\[exit code: (\d+)\]$/.exec(text);
+    if (exit?.[1] !== undefined) {
+        return { body: text.slice(0, exit.index), exitCode: Number(exit[1]) };
+    }
+    return { body: text, exitCode: 0 };
+}
+/** Compact token count, matching the web stats line (517 / 12.2K / 1.2M). */
+export function formatTokens(n) {
+    const scaled = (value) => value >= 100 ? String(Math.round(value)) : String(Math.round(value * 10) / 10);
+    if (n < 1_000)
+        return String(n);
+    if (n < 1_000_000)
+        return `${scaled(n / 1_000)}K`;
+    return `${scaled(n / 1_000_000)}M`;
+}
+/** Compact duration, matching the web stats line (45.2s / 2m42s). */
+export function formatDuration(ms) {
+    const seconds = ms / 1_000;
+    if (seconds < 60)
+        return `${Math.round(seconds * 10) / 10}s`;
+    const whole = Math.round(seconds);
+    return `${Math.floor(whole / 60)}m${whole % 60}s`;
+}
+export function formatTokensPerSecond(tokensPerSecond) {
+    return `${Math.round(tokensPerSecond)} tok/s`;
+}
+/** Owns one interactive terminal channel and its agent event wiring. */
+export class SshTui {
+    ctx;
+    agent;
+    rows = [];
+    streaming;
+    input = '';
+    cursor = 0;
+    inputFolded = false;
+    history = [];
+    historyIndex = -1;
+    status = 'idle';
+    dialog;
+    dirty = true;
+    disposed = false;
+    exiting = false;
+    renderTimer;
+    decoder = new StringDecoder('utf8');
+    color;
+    maxToolOutputLines;
+    showReasoning;
+    goodbye;
+    resume;
+    providerName;
+    selectionRef;
+    onSwitchSession;
+    onSelectionChanged;
+    resumePicker;
+    disposers = [];
+    userQuestionDisposer;
+    presetId = 'standard';
+    presetName = '标准模式';
+    useAlternateScreen;
+    agentGone = false;
+    onboarding;
+    commandSuggestions = [];
+    suggestionIndex = 0;
+    focusedRow = null;
+    pendingMessages = new Map();
+    lastActivity = Date.now();
+    stalledWarningShown = false;
+    lastPaintAt = 0;
+    activeSubagents = new Map();
+    subagentSessions = new Set();
+    openToolCalls = new Map();
+    stats = {
+        turns: 0,
+        steps: 0,
+        llmMs: 0,
+        toolMs: 0,
+        ttftMs: 0,
+        ttftSteps: 0,
+        decodeMs: 0,
+        decodeTokens: 0,
+        usage: { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 },
+    };
+    openStepStats;
+    pendingToolTimes = new Map();
+    usageByStep = new Map();
+    lastStatsTurn = null;
+    scrollOffset = 0;
+    clickableRows = new Map();
+    streamingReasoning;
+    escapeBuffer = '';
+    escapeTimer;
+    thinkingStartedAt;
+    completionSignaled = false;
+    completedAt = 0;
+    lastTitleUpdateAt = 0;
+    lastPaintRows = [];
+    lastChromeKey = '';
+    constructor(ctx, agent, config) {
+        this.ctx = ctx;
+        this.agent = agent;
+        const noColorEnv = process.env.NO_COLOR !== undefined && process.env.NO_COLOR !== '';
+        this.color = config.color !== false && !noColorEnv && process.env.TERM !== 'dumb';
+        this.maxToolOutputLines = Math.max(1, config.maxToolOutputLines ?? 6);
+        this.showReasoning = config.showReasoning !== false;
+        this.goodbye = this.ctx.get('tuiGoodbyeMessage')
+            ?? `To resume this session: dsh --profile tui --resume=${this.agent.id}`;
+        this.resume = config.resume === true;
+        this.providerName = config.provider ?? 'deepseek-official';
+        this.selectionRef = config.selectionRef;
+        this.onSwitchSession = config.onSwitchSession;
+        this.onSelectionChanged = config.onSelectionChanged;
+        this.resumePicker = config.resumePicker === true;
+        this.presetId = config.presetId ?? 'standard';
+        this.presetName = config.presetName ?? this.presetId;
+        this.useAlternateScreen = process.env.DSH_TUI_NO_ALT_SCREEN !== '1' && process.env.DSH_TUI_NO_ALT_SCREEN !== 'true';
+        this.pushRow({ kind: 'brand-logo' });
+        this.pushRow({ kind: 'system', text: 'DeepSeek Harness — SSH TUI' });
+        this.pushRow({ kind: 'system', text: 'Type /help for commands · /setup provider & key · ↑/↓ select · Enter expand/collapse · Ctrl+T fold input · Esc cancels' });
+    }
+    /** Enter raw mode, switch to the alternate screen, and start listening. */
+    start() {
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on('data', this.handleData);
+        process.stdout.on('resize', this.markDirty);
+        process.on('SIGWINCH', this.markDirty);
+        this.disposers.push(this.ctx.on('session/event', this.handleSessionEvent), this.ctx.on('agent/status', this.handleStatus), this.ctx.on('agent/error', this.handleError), this.ctx.on('agent/disposed', this.handleDisposed), this.ctx.on('agent/inbox/claimed', this.handleInboxClaimed), this.ctx.on('agent/inbox/discarded', this.handleInboxDiscarded), this.ctx.on('subagent/start', this.handleSubagentStart), this.ctx.on('subagent/end', this.handleSubagentEnd), this.ctx.on('approval/request', this.handleApproval));
+        const questions = this.ctx.get('userQuestions');
+        if (questions !== undefined) {
+            this.userQuestionDisposer = questions.registerProvider({ ask: this.handleUserQuestions });
+        }
+        this.write(`${this.useAlternateScreen ? '\x1b[?1049h' : ''}\x1b[?1000h\x1b[?1006h\x1b[?25l`);
+        this.render();
+        this.updateTerminalTitle();
+        if (this.resumePicker) {
+            void this.runResumeCommand('', true);
+        }
+        this.renderTimer = setInterval(() => {
+            const now = Date.now();
+            if (this.agent.status === 'running')
+                this.updateTerminalTitle();
+            if (this.streaming !== undefined
+                && this.streaming.reasoning !== ''
+                && now - this.lastPaintAt >= 200) {
+                this.dirty = true;
+            }
+            // While a turn is waiting on the provider with no new events, repaint at
+            // most once per second so slow SSH links do not drown in redraws.
+            const idleWaiting = this.agent.status === 'running' && !this.dirty;
+            if (idleWaiting && now - this.lastPaintAt < 1000)
+                return;
+            // Running with no fresh events only needs the seconds-bearing status
+            // line refreshed; force one repaint per second instead of every tick.
+            if (this.agent.status === 'running' && !this.dirty && now - this.lastPaintAt >= 1000) {
+                this.dirty = true;
+            }
+            if (this.dirty) {
+                this.lastPaintAt = now;
+                this.render();
+            }
+        }, RENDER_INTERVAL_MS);
+        this.renderTimer.unref?.();
+        void this.maybeRunOnboarding();
+    }
+    /** Replay the durable session log so a resumed session renders its history. */
+    replayHistory() {
+        for (const event of this.agent.session.events) {
+            this.handleSessionEvent(this.agent.session, event);
+        }
+        this.streaming = undefined;
+        this.status = this.agent.status === 'running' ? 'running' : 'idle';
+        this.dirty = true;
+    }
+    /** Show the first-launch provider/API-key onboarding when nothing is configured. */
+    async maybeRunOnboarding() {
+        const credentials = this.ctx.get('credentials');
+        const provider = this.providerName;
+        const envRef = provider === 'deepseek-official' ? 'DEEPSEEK_API_KEY' : envRefForId(provider);
+        const envKey = process.env[envRef];
+        let stored = false;
+        if (credentials !== undefined) {
+            stored = (await credentials.describe(credentialRef(envRef))).configured;
+        }
+        if (!stored) {
+            // Belt-and-braces: the file provider may not have its in-memory snapshot
+            // visible to this plugin copy yet; the managed document is authoritative.
+            try {
+                const credentialFile = join(dshHomeDir(), '.credentials.yaml');
+                if (existsSync(credentialFile)) {
+                    const content = await readFile(credentialFile, 'utf8');
+                    stored = new RegExp(`^${envRef}\\s*:\\s*\\S`, 'm').test(content);
+                }
+            }
+            catch {
+                // Ignore unreadable/missing documents; the wizard will ask again.
+            }
+        }
+        if (envKey !== undefined && envKey !== '') {
+            if (stored || existsSync(DSH_ENV_FILE) || this.resume) {
+                this.pushRow({
+                    kind: 'system',
+                    text: `当前使用 ${envRef}（环境变量/启动环境文件）。如需更换，随时输入 /setup 重新配置。`,
+                });
+                this.markDirty();
+                return;
+            }
+            this.pushRow({
+                kind: 'system',
+                text: `检测到系统已注入 ${envRef}（可能已失效）。首次启动向导将覆盖为你的 Key，保存后重启 TUI 生效。`,
+            });
+            await this.runOnboarding();
+            return;
+        }
+        if (stored || this.resume)
+            return;
+        this.pushRow({ kind: 'system', text: '首次启动：请先配置提供商和 API Key（随时可输入 /setup 重新配置）。' });
+        await this.runOnboarding();
+    }
+    /** Run the provider/API-key onboarding wizard. Resolves true when saved. */
+    runOnboarding() {
+        return new Promise((resolve) => {
+            this.onboarding = {
+                step: 'provider',
+                providerType: 'official',
+                providerId: '',
+                baseUrl: '',
+                key: '',
+                models: [],
+                resolve,
+            };
+            this.input = '';
+            this.cursor = 0;
+            this.dialog = { kind: 'onboarding' };
+            this.markDirty();
+        });
+    }
+    cancelOnboarding() {
+        const state = this.onboarding;
+        if (state === undefined)
+            return;
+        this.onboarding = undefined;
+        this.dialog = undefined;
+        this.input = '';
+        this.cursor = 0;
+        state.resolve(false);
+        this.markDirty();
+    }
+    /** Restore the terminal, flush the session, and request process exit. */
+    async dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.exiting = true;
+        const dialog = this.dialog;
+        if (dialog !== undefined) {
+            if (dialog.kind === 'confirm') {
+                dialog.resolve('cancel');
+            }
+            else if (dialog.kind === 'questions') {
+                dialog.reject(new UserQuestionError('TUI closed before the question was answered', 'ASK_ABORTED'));
+            }
+            else {
+                this.cancelOnboarding();
+            }
+            this.dialog = undefined;
+        }
+        if (this.renderTimer !== undefined)
+            clearInterval(this.renderTimer);
+        for (const dispose of this.disposers.splice(0)) {
+            dispose();
+        }
+        this.userQuestionDisposer?.();
+        this.userQuestionDisposer = undefined;
+        process.stdin.removeListener('data', this.handleData);
+        process.stdout.removeListener('resize', this.markDirty);
+        process.removeListener('SIGWINCH', this.markDirty);
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        this.write('\x1b]0;\x07');
+        // Clear every screen (regular + scrollback) before restoring the terminal.
+        // In no-alternate-screen mode this removes the last painted frame that
+        // would otherwise stay behind the shell prompt after exit.
+        this.write('\x1b[0m\x1b[2J\x1b[3J\x1b[H');
+        this.write(`\x1b[?1000l\x1b[?1006l\x1b[?25h${this.useAlternateScreen ? '\x1b[?1049l' : ''}`);
+    }
+    /** Human-facing exit with goodbye and flush; called from key handling. */
+    async requestExit(code) {
+        if (this.exiting)
+            return;
+        this.exiting = true;
+        await this.dispose();
+        process.stdout.write(`\n${this.goodbye}\n`);
+        try {
+            await this.ctx.get('sessions')?.flush(this.agent.session);
+        }
+        catch (error) {
+            process.stdout.write(`dsh-ssh-tui: failed to flush session: ${errorChain(error)}\n`);
+        }
+        const exit = this.ctx.get('appExit');
+        if (exit !== undefined)
+            exit(code);
+        else
+            process.exit(code);
+    }
+    // ── terminal output ─────────────────────────────────────────────────────
+    write(chunk) {
+        process.stdout.write(chunk);
+    }
+    markDirty = () => {
+        this.dirty = true;
+    };
+    /** Append one transcript row, bounding memory on long sessions. */
+    pushRow(row) {
+        this.rows.push(row);
+        if (this.rows.length > MAX_TRANSCRIPT_ROWS) {
+            const removed = this.rows.length - MAX_TRANSCRIPT_ROWS;
+            if (this.focusedRow !== null
+                && this.focusedRow.kind !== 'streaming-reasoning'
+                && this.rows.indexOf(this.focusedRow) < removed) {
+                this.focusedRow = null;
+            }
+            this.rows.splice(0, removed);
+        }
+    }
+    /** The transcript rows that support per-row expand/collapse. */
+    collapsibleRows() {
+        const rows = this.rows.filter((row) => row.kind === 'reasoning' || row.kind === 'tool');
+        if (this.streaming !== undefined && this.streaming.reasoning !== '') {
+            this.streamingReasoning ??= { kind: 'streaming-reasoning', expanded: false };
+            rows.push(this.streamingReasoning);
+        }
+        return rows;
+    }
+    /** Move the expand/collapse focus among reasoning and tool rows. */
+    moveCollapsibleFocus(delta) {
+        const rows = this.collapsibleRows();
+        if (rows.length === 0)
+            return;
+        if (this.focusedRow === null) {
+            const target = delta >= 0 ? rows[0] : rows[rows.length - 1];
+            if (target !== undefined)
+                this.focusedRow = target;
+        }
+        else {
+            const current = rows.indexOf(this.focusedRow);
+            const next = rows[current === -1 ? (delta >= 0 ? 0 : rows.length - 1) : Math.min(rows.length - 1, Math.max(0, current + delta))];
+            if (next !== undefined)
+                this.focusedRow = next;
+        }
+        this.markDirty();
+    }
+    /** Toggle the focused block; without focus, toggle the most recent one. */
+    toggleCollapsible() {
+        const rows = this.collapsibleRows();
+        if (rows.length === 0)
+            return;
+        const focused = this.focusedRow !== null && rows.includes(this.focusedRow)
+            ? this.focusedRow
+            : undefined;
+        const target = focused ?? rows[rows.length - 1];
+        if (target === undefined)
+            return;
+        target.expanded = !target.expanded;
+        this.focusedRow = target;
+        this.markDirty();
+    }
+    /** Expand all collapsible blocks, or collapse them again when all are open. */
+    toggleAllCollapsible() {
+        const rows = this.collapsibleRows();
+        if (rows.length === 0)
+            return;
+        const allExpanded = rows.every(row => row.expanded);
+        for (const row of rows)
+            row.expanded = !allExpanded;
+        this.focusedRow = allExpanded ? null : rows[rows.length - 1] ?? null;
+        this.markDirty();
+    }
+    paint = () => {
+        if (this.exiting)
+            return;
+        const width = Math.max(10, process.stdout.columns || 80);
+        const height = Math.max(6, process.stdout.rows || 24);
+        const display = [];
+        const displayRefs = [];
+        const addDisplay = (line, ref) => {
+            display.push(line);
+            displayRefs.push(ref);
+        };
+        const pushRow = (kind, text) => {
+            if (kind === 'assistant') {
+                for (const line of renderMarkdownLines(text, width, this.color)) {
+                    addDisplay(line);
+                }
+                return;
+            }
+            for (const line of wrap(text, width)) {
+                addDisplay(this.styleLine(kind, line));
+            }
+        };
+        for (const row of this.rows) {
+            if (row.kind === 'brand-logo') {
+                const variant = DEEPSEEK_LOGO_VARIANTS.find(candidate => candidate.width <= width - 2)
+                    ?? DEEPSEEK_LOGO_VARIANTS[DEEPSEEK_LOGO_VARIANTS.length - 1];
+                for (const line of variant.lines) {
+                    const pad = Math.max(0, Math.floor((width - displayWidth(line)) / 2));
+                    addDisplay(this.styleLine('brand', ' '.repeat(pad) + line));
+                }
+                const wordmark = 'DeepSeek';
+                const wordmarkPad = Math.max(0, Math.floor((width - displayWidth(wordmark)) / 2));
+                addDisplay(this.styleLine('brand', ' '.repeat(wordmarkPad) + wordmark));
+                continue;
+            }
+            if (row.kind === 'reasoning') {
+                const focused = this.focusedRow === row;
+                const marker = row.expanded ? '▾' : '▸';
+                const lines = row.text.split('\n').length;
+                const header = `${marker} 已思考 · ${lines} 行${row.expanded ? '' : ' · Ctrl+R 展开'}`;
+                const line = `${focused ? '▶ ' : '  '}${header}`;
+                const styled = this.styleLine('reasoning', line);
+                addDisplay(focused && this.color ? `\x1b[7m${styled}\x1b[27m` : styled, row);
+                if (row.expanded) {
+                    for (const wrapped of wrap(row.text, width)) {
+                        addDisplay(this.styleLine('reasoning', wrapped));
+                    }
+                }
+                continue;
+            }
+            if (row.kind === 'tool') {
+                const running = row.status === undefined || row.status === 'running';
+                const ok = row.status === 'ok';
+                const dot = this.color
+                    ? running ? '\x1b[33m●\x1b[0m' : ok ? '\x1b[32m●\x1b[0m' : '\x1b[31m●\x1b[0m'
+                    : '●';
+                const state = running ? 'running…' : ok ? 'ok' : 'error';
+                const summary = row.summary === '' ? '' : `  ${row.summary}`;
+                const exit = !running && row.command !== undefined
+                    ? row.signal !== undefined
+                        ? `  [信号 ${row.signal}]`
+                        : (row.exitCode ?? 0) !== 0
+                            ? `  [退出码 ${row.exitCode}]`
+                            : ''
+                    : '';
+                const focused = this.focusedRow === row;
+                const marker = row.expanded ? '▾' : '▸';
+                const plainHeader = `${marker} ● ${row.title}${summary}  [${state}]${exit}`;
+                if (!row.expanded) {
+                    const collapsed = truncateToWidth(`${focused ? '▶ ' : '  '}${plainHeader}`, Math.max(1, width - 2));
+                    const dotIndex = collapsed.indexOf('●');
+                    const withDot = dotIndex === -1
+                        ? collapsed
+                        : `${collapsed.slice(0, dotIndex)}${dot}${collapsed.slice(dotIndex + 1)}`;
+                    const styled = this.styleLine('tool', withDot);
+                    addDisplay(focused && this.color ? `\x1b[7m${styled}\x1b[27m` : styled, row);
+                    continue;
+                }
+                for (const [index, wrapped] of wrap(plainHeader, width).entries()) {
+                    const dotIndex = index === 0 ? wrapped.indexOf('●') : -1;
+                    const withDot = dotIndex === -1
+                        ? wrapped
+                        : `${wrapped.slice(0, dotIndex)}${dot}${wrapped.slice(dotIndex + 1)}`;
+                    addDisplay(this.styleLine('tool', withDot), row);
+                }
+                for (const line of toolBodyLines(row, this.maxToolOutputLines)) {
+                    for (const wrapped of wrap(line.text, Math.max(1, width - 2))) {
+                        addDisplay(this.styleLine(line.kind, `  ${wrapped}`));
+                    }
+                }
+                continue;
+            }
+            pushRow(row.kind, row.text);
+        }
+        if (this.streaming !== undefined) {
+            if (this.showReasoning && this.streaming.reasoning !== '') {
+                const block = this.streamingReasoning ??= { kind: 'streaming-reasoning', expanded: false };
+                const focused = this.focusedRow === block;
+                const marker = block.expanded ? '▾' : '▸';
+                const spinner = SPINNER[Math.floor(Date.now() / 120) % SPINNER.length];
+                const chars = this.streaming.reasoning.length;
+                const elapsed = this.thinkingStartedAt === undefined
+                    ? 0
+                    : Math.floor((Date.now() - this.thinkingStartedAt) / 1000);
+                const header = `${marker} 思考中 ${spinner} · ${chars} 字${elapsed > 0 ? ` · ${elapsed}s` : ''}`;
+                const line = `${focused ? '▶ ' : '  '}${header}`;
+                const styled = this.styleLine('reasoning', line);
+                addDisplay(focused && this.color ? `\x1b[7m${styled}\x1b[27m` : styled, block);
+                if (block.expanded) {
+                    for (const wrapped of wrap(this.streaming.reasoning, width)) {
+                        addDisplay(this.styleLine('reasoning', wrapped));
+                    }
+                }
+            }
+            if (this.streaming.text !== '') {
+                // Streaming text is the model's live token stream: while reasoning is
+                // being produced (before a final assistant message has assembled) it
+                // can contain the raw thinking/chain-of-thought. Rendering it as
+                // markdown here would style that thinking instead of keeping it in the
+                // collapsible reasoning block, so keep the in-progress stream plain.
+                // The completed assistant message is what gets markdown-rendered.
+                for (const line of wrap(this.streaming.text, width)) {
+                    addDisplay(this.styleLine('assistant', line));
+                }
+            }
+        }
+        const dialogLines = [];
+        const addDialog = (text) => {
+            for (const wrapped of wrap(text, Math.max(1, width))) {
+                dialogLines.push(this.styleLine('system', wrapped));
+            }
+        };
+        if (this.dialog !== undefined) {
+            if (this.dialog.kind === 'confirm') {
+                addDialog(this.dialog.prompt);
+                addDialog(`  ${this.dialog.hint}`);
+            }
+            else if (this.dialog.kind === 'onboarding') {
+                const ob = this.onboarding;
+                if (ob !== undefined) {
+                    const template = PROVIDER_TEMPLATES[ob.providerType];
+                    const providerLabel = `${template.label}${template.defaultBaseUrl === '' ? '' : `（${template.defaultBaseUrl}）`}`;
+                    switch (ob.step) {
+                        case 'provider':
+                            addDialog('首次配置向导 — 选择提供商（与官方 Models 页一致）');
+                            addDialog('  1  DeepSeek 官方（api.deepseek.com）');
+                            addDialog('  2  OpenCode Go（opencode.ai/zen/go，Responses 协议）');
+                            addDialog('  3  自定义 OpenAI 兼容网关（Completions）');
+                            addDialog('  4  自定义 OpenAI Responses 网关');
+                            addDialog('  5  Anthropic Messages 兼容网关');
+                            addDialog('  按 1-5 选择，Esc 取消');
+                            break;
+                        case 'id':
+                            addDialog(`提供商：${providerLabel}`);
+                            addDialog('Provider ID（小写字母/数字/连字符，永久标识）：');
+                            addDialog(`  默认：${template.defaultId}`);
+                            addDialog('  Enter 确认，Esc 取消');
+                            break;
+                        case 'key':
+                            addDialog(`提供商：${providerLabel}`);
+                            addDialog('请输入 API Key（输入时以 • 显示）：');
+                            addDialog('  Enter 确认，Esc 取消');
+                            break;
+                        case 'base-url':
+                            addDialog(`提供商：${providerLabel}`);
+                            addDialog(`请输入 Base URL（留空使用 ${template.defaultBaseUrl || '官方/模板默认'}）：`);
+                            addDialog('  Enter 确认，Esc 取消');
+                            break;
+                        case 'models':
+                            addDialog(`提供商：${providerLabel}`);
+                            addDialog('模型 ID（多个用逗号或空格分隔）：');
+                            addDialog(`  默认：${template.defaultModels.join(', ')}`);
+                            if (template.api !== undefined)
+                                addDialog('  Ctrl+F = 从端点获取模型列表');
+                            addDialog('  Enter 确认，Esc 取消');
+                            break;
+                        case 'confirm':
+                            addDialog('确认保存以下配置？');
+                            addDialog(`  提供商:  ${providerLabel}`);
+                            addDialog(`  Provider ID: ${ob.providerId}`);
+                            addDialog(`  Base URL: ${ob.baseUrl === '' ? (template.defaultBaseUrl || '(默认)') : ob.baseUrl}`);
+                            addDialog(`  API 协议: ${template.api ?? 'deepseek-official'}`);
+                            addDialog(`  模型: ${ob.models.join(', ')}`);
+                            addDialog(`  API Key:  ${ob.key.slice(0, 6)}…${ob.key.slice(-4)}（长度 ${ob.key.length}）`);
+                            addDialog('  y = 保存, n = 重填, Esc = 取消');
+                            break;
+                    }
+                }
+            }
+            else {
+                const d = this.dialog;
+                addDialog(`Question ${d.index + 1}/${d.total}: ${d.question.question}`);
+                if (d.question.detail !== undefined && d.question.detail !== '') {
+                    addDialog(truncate(d.question.detail, 6));
+                }
+                const options = d.question.options ?? [];
+                for (const [index, option] of options.entries()) {
+                    const marker = d.selected.has(index) ? '●' : '○';
+                    const extra = option.description === undefined ? '' : ` — ${option.description}`;
+                    addDialog(`  ${index + 1} ${marker} ${option.label}${extra}`);
+                }
+                if (options.length === 0) {
+                    addDialog('  (free text: type below and press Enter)');
+                }
+                addDialog(`  ${d.question.multiSelect === true ? 'digits toggle, Enter submit' : 'digit to select, Enter submit'}, Esc to cancel`);
+            }
+        }
+        const fitLine = (text) => truncateToWidth(text, Math.max(1, width));
+        const headerLines = [
+            this.styleLine('system', fitLine(`DeepSeek Harness — SSH TUI  [${this.presetName}]  ${this.currentSelectionLabel()}`)),
+            this.styleLine('system', '─'.repeat(width)),
+        ];
+        if (this.scrollOffset > 0) {
+            headerLines.push(this.styleLine('system', fitLine(`↑ 已回看 ${this.scrollOffset} 行 · PgUp/PgDn/滚轮滚动 · Esc 回到底部`)));
+        }
+        const inputDivider = this.styleLine('system', '─'.repeat(width));
+        this.commandSuggestions = this.dialog === undefined ? this.buildSuggestions() : [];
+        if (this.suggestionIndex >= this.commandSuggestions.length) {
+            this.suggestionIndex = Math.max(0, this.commandSuggestions.length - 1);
+        }
+        const suggestionLines = [];
+        for (const [index, command] of this.commandSuggestions.entries()) {
+            const marker = index === this.suggestionIndex ? '›' : ' ';
+            const line = `  ${marker} /${command.name.padEnd(14)} ${command.description}${command.local ? '' : '  (dsh)'}`;
+            suggestionLines.push(index === this.suggestionIndex
+                ? `\x1b[7m${fitLine(line)}\x1b[27m`
+                : this.styleLine('system', fitLine(line)));
+        }
+        const promptPlain = this.color ? '❯ ' : '> ';
+        const prompt = this.color ? `\x1b[36m${promptPlain.trimEnd()}\x1b[0m ` : promptPlain;
+        const promptWidth = displayWidth(promptPlain);
+        const masked = this.dialog?.kind === 'onboarding' && this.onboarding?.step === 'key';
+        const inputView = masked
+            ? { text: '•'.repeat(this.input.length), cursorOffset: this.cursor, folded: false }
+            : this.inputFolded
+                ? foldInputView(this.input, this.cursor, Math.max(1, width - promptWidth))
+                : { text: this.input, cursorOffset: displayWidth(this.input.slice(0, this.cursor)), folded: false };
+        const grid = Math.max(1, width);
+        const cursorPlainOffset = promptWidth + inputView.cursorOffset;
+        const inputTextWidth = Math.max(1, width - promptWidth);
+        const inputTextLines = wrap(inputView.text, inputTextWidth);
+        const inputDisplayLines = inputTextLines.map((line, index) => index === 0 ? `${prompt}${line}` : line);
+        // When the cursor sits exactly at the end of a full visual row, the
+        // terminal has already advanced to the next row. Reserve that empty row so
+        // the cursor never lands on top of the last character typed.
+        if (!inputView.folded
+            && cursorPlainOffset > 0
+            && cursorPlainOffset % grid === 0
+            && Math.floor(cursorPlainOffset / grid) >= inputDisplayLines.length) {
+            inputDisplayLines.push('');
+        }
+        const inputRows = Math.max(1, inputDisplayLines.length);
+        const reserved = RESERVED_BOTTOM_LINES + (inputRows - 1) + headerLines.length + suggestionLines.length + 1; // +1 input divider
+        const available = Math.max(1, height - reserved - dialogLines.length);
+        const maxOffset = Math.max(0, display.length - available);
+        if (this.scrollOffset > maxOffset)
+            this.scrollOffset = maxOffset;
+        const start = Math.max(0, display.length - available - this.scrollOffset);
+        const visible = display.slice(start, start + available);
+        const visibleRefs = displayRefs.slice(start, start + available);
+        const padding = Math.max(0, available - visible.length);
+        for (let index = 0; index < padding; index++) {
+            visible.unshift('');
+            visibleRefs.unshift(undefined);
+        }
+        this.clickableRows.clear();
+        for (let index = 0; index < visibleRefs.length; index++) {
+            const ref = visibleRefs[index];
+            if (ref !== undefined)
+                this.clickableRows.set(headerLines.length + index + 1, ref);
+        }
+        const statsText = this.statsText();
+        const statsLine = this.styleLine('system', fitLine(statsText === '' ? '— 尚无会话统计' : statsText));
+        let statusText = `${this.status}  [${this.presetName}]  ${this.currentSelectionLabel()}`;
+        if (inputView.folded)
+            statusText += ' · 输入已折叠 · Ctrl+T 展开';
+        else if (inputRows > 1)
+            statusText += ' · Ctrl+T 折叠输入';
+        if (this.pendingMessages.size > 0)
+            statusText += ` · 排队 ${this.pendingMessages.size}`;
+        const idleMs = Date.now() - this.lastActivity;
+        if (this.agent.status === 'running' && this.activeSubagents.size > 0) {
+            statusText += ` · 子代理执行中 ${this.activeSubagents.size}`;
+        }
+        else if (this.agent.status === 'running' && this.openToolCalls.size > 0) {
+            statusText += ` · 工具执行中 ${this.openToolCalls.size}`;
+        }
+        else if (this.agent.status === 'running' && idleMs > WAIT_INDICATOR_MS) {
+            statusText += ` · 等待响应 ${Math.floor(idleMs / 1000)}s`;
+        }
+        const statusLine = this.styleLine('system', fitLine(statusText));
+        const paintRows = [
+            ...headerLines,
+            ...visible,
+            ...dialogLines,
+            inputDivider,
+            ...suggestionLines,
+            ...inputDisplayLines,
+            `${statsLine}\x1b[0m`,
+            `${statusLine}\x1b[0m`,
+        ];
+        // Bottom chrome is force-repainted whenever its state changes while the
+        // agent is working; this clears any stale cell left behind by a previous
+        // frame even when the row strings happen to be identical.
+        const chromeStart = Math.max(0, paintRows.length - inputRows - 3);
+        const chromeKey = [
+            this.status,
+            this.agent.status,
+            this.scrollOffset,
+            statsText,
+            statusText,
+            inputView.text,
+            inputView.folded,
+            inputRows,
+            paintRows.length,
+            this.pendingMessages.size,
+            this.commandSuggestions.length,
+            this.suggestionIndex,
+        ].join('\x1f');
+        const chromeChanged = chromeKey !== this.lastChromeKey;
+        // Incremental repaint: rewrite only rows whose content changed, so slow
+        // SSH links don't rebuild (and flicker) the whole screen on every tick.
+        this.write('\x1b[?25l');
+        const maxRows = Math.max(paintRows.length, this.lastPaintRows.length);
+        for (let i = 0; i < maxRows; i++) {
+            const current = paintRows[i];
+            if (current === this.lastPaintRows[i] && !(chromeChanged && i >= chromeStart))
+                continue;
+            this.write(`\x1b[${i + 1};1H\x1b[0m${current ?? ''}\x1b[K`);
+        }
+        if (paintRows.length < this.lastPaintRows.length) {
+            this.write(`\x1b[${paintRows.length + 1};1H\x1b[J`);
+        }
+        this.write('\x1b[0m');
+        this.lastPaintRows = paintRows;
+        this.lastChromeKey = chromeKey;
+        const cursorRowOffset = Math.min(Math.floor(cursorPlainOffset / grid), Math.max(0, inputRows - 1));
+        let column = cursorPlainOffset % grid + 1;
+        // A folded view is capped to one visual row; if the cursor still lands on
+        // an exact boundary, keep it on the final occupied cell rather than
+        // pointing at the row below.
+        if (cursorPlainOffset > 0
+            && cursorPlainOffset % grid === 0
+            && Math.floor(cursorPlainOffset / grid) >= inputRows) {
+            column = grid;
+        }
+        const inputTopRow = visible.length + dialogLines.length + suggestionLines.length + headerLines.length + 2;
+        const row = Math.min(height, inputTopRow + cursorRowOffset);
+        this.write(`\x1b[${row};${Math.max(1, column)}H\x1b[?25h`);
+    };
+    buildSuggestions() {
+        const input = this.input;
+        if (!input.startsWith('/'))
+            return [];
+        const prefix = input.slice(1).toLowerCase();
+        const dsh = (this.ctx.get('commands')?.list(this.agent) ?? []).map(command => ({
+            name: command.name,
+            description: command.description,
+            local: false,
+        }));
+        const all = [
+            ...LOCAL_COMMANDS.map(command => ({ name: command.name, description: command.description, local: true })),
+            ...dsh,
+        ];
+        const filtered = prefix === ''
+            ? all
+            : all.filter(command => command.name.startsWith(prefix) || command.name.includes(prefix));
+        return filtered.slice(0, 12);
+    }
+    suggestionsVisible() {
+        return this.commandSuggestions.length > 0 && this.dialog === undefined;
+    }
+    currentSelectionLabel() {
+        const current = this.selectionRef?.current;
+        const provider = current?.provider ?? this.agent.options.provider ?? this.providerName;
+        const model = current?.model ?? this.agent.options.model ?? 'unknown';
+        const effort = current?.reasoningEffort;
+        return `${provider}/${model}${effort === undefined ? '' : ` (${effort})`}`;
+    }
+    /** Replace one step's usage sample so a repeated report never double counts. */
+    recordUsage(turn, step, usage) {
+        const key = `${turn}:${step}`;
+        const next = {
+            inputTokens: usage.inputTokens,
+            outputTokens: usage.outputTokens,
+            cacheReadTokens: usage.cacheReadTokens ?? 0,
+            cacheWriteTokens: usage.cacheWriteTokens ?? 0,
+        };
+        const previous = this.usageByStep.get(key);
+        const totals = this.stats.usage;
+        this.stats.usage = {
+            inputTokens: totals.inputTokens - (previous?.inputTokens ?? 0) + next.inputTokens,
+            outputTokens: totals.outputTokens - (previous?.outputTokens ?? 0) + next.outputTokens,
+            cacheReadTokens: totals.cacheReadTokens - (previous?.cacheReadTokens ?? 0) + next.cacheReadTokens,
+            cacheWriteTokens: totals.cacheWriteTokens - (previous?.cacheWriteTokens ?? 0) + next.cacheWriteTokens,
+        };
+        this.usageByStep.set(key, next);
+    }
+    /** The web-aligned session stats strip: counts, timings, cache, tokens. */
+    statsText() {
+        const stats = this.stats;
+        const groups = [];
+        if (stats.steps > 0)
+            groups.push(`${stats.turns} 轮 · ${stats.steps} 步`);
+        const durations = [];
+        if (stats.llmMs > 0)
+            durations.push(`模型 ${formatDuration(stats.llmMs)}`);
+        if (stats.toolMs > 0)
+            durations.push(`工具 ${formatDuration(stats.toolMs)}`);
+        if (durations.length > 0)
+            groups.push(durations.join(' · '));
+        const speeds = [];
+        if (stats.ttftSteps > 0)
+            speeds.push(`首字 ${formatDuration(stats.ttftMs / stats.ttftSteps)}`);
+        if (stats.decodeMs > 0 && stats.decodeTokens > 0) {
+            speeds.push(formatTokensPerSecond(stats.decodeTokens / (stats.decodeMs / 1_000)));
+        }
+        if (speeds.length > 0)
+            groups.push(speeds.join(' · '));
+        const usage = stats.usage;
+        const billedInput = usage.inputTokens + usage.cacheReadTokens + usage.cacheWriteTokens;
+        if (billedInput > 0 || usage.outputTokens > 0) {
+            if (billedInput > 0) {
+                groups.push(`缓存命中 ${Math.round(usage.cacheReadTokens / billedInput * 100)}%`);
+            }
+            groups.push(`输入 ${formatTokens(billedInput)} · 输出 ${formatTokens(usage.outputTokens)}`);
+        }
+        return groups.join(' | ');
+    }
+    /** Refresh the terminal window title (throttled while running). */
+    updateTerminalTitle() {
+        if (this.exiting)
+            return;
+        const now = Date.now();
+        // Completion wins over a still-running agent status: the turn/end event
+        // lands before agent/status flips to idle, and the title must not stay
+        // on the running spinner until the next repaint trigger.
+        if (this.completedAt !== 0 && now - this.completedAt < 5000) {
+            this.write('\x1b]0;dsh ✓ 已完成\x07');
+            return;
+        }
+        if (this.agent.status === 'running') {
+            if (now - this.lastTitleUpdateAt < 800)
+                return;
+            this.lastTitleUpdateAt = now;
+            const spinner = SPINNER[Math.floor(now / 800) % SPINNER.length];
+            let detail = '运行中';
+            if (this.openToolCalls.size > 0)
+                detail = `运行中 · 工具 ${this.openToolCalls.size}`;
+            else if (this.activeSubagents.size > 0)
+                detail = `运行中 · 子代理 ${this.activeSubagents.size}`;
+            this.write(`\x1b]0;dsh ${spinner} ${detail}\x07`);
+            return;
+        }
+        this.write('\x1b]0;dsh 待命\x07');
+    }
+    /** Terminal bell on completion (opt out with DSH_TUI_NO_BELL=1). */
+    playCompletionSignal() {
+        const disabled = process.env.DSH_TUI_NO_BELL === '1' || process.env.DSH_TUI_NO_BELL === 'true';
+        if (disabled)
+            return;
+        process.stdout.write('\x07');
+    }
+    render = () => {
+        if (!this.dirty || this.exiting)
+            return;
+        if (this.agent.status === 'running'
+            && Date.now() - this.lastActivity > STALL_WARNING_MS
+            && !this.stalledWarningShown
+            && this.openToolCalls.size === 0
+            && this.activeSubagents.size === 0) {
+            this.stalledWarningShown = true;
+            this.pushRow({ kind: 'error', text: '模型/工具长时间无响应，可按 Esc 或 Ctrl+C 中断当前轮次。' });
+            this.markDirty();
+            return;
+        }
+        this.dirty = false;
+        this.paint();
+    };
+    styleLine(kind, text) {
+        if (!this.color)
+            return text;
+        const code = kind === 'user' ? '36' :
+            kind === 'assistant' ? '1;37' :
+                kind === 'reasoning' ? '2;3' :
+                    kind === 'brand' ? '1;38;2;77;107;253' :
+                        kind === 'tool' || kind === 'tool-result' ? '33' :
+                            kind === 'diff-add' ? '38;5;22;48;5;194' :
+                                kind === 'diff-del' ? '38;5;124;48;5;224' :
+                                    kind === 'diff-path' ? '1;36' :
+                                        kind === 'error' ? '31' :
+                                            '90';
+        return `\x1b[${code}m${text}`;
+    }
+    // ── event handling ──────────────────────────────────────────────────────
+    handleSessionEvent = (session, event) => {
+        if (session.id !== this.agent.id) {
+            if (this.subagentSessions.has(session.id))
+                this.handleSubagentSessionEvent(session.id, event);
+            return;
+        }
+        this.lastActivity = Date.now();
+        switch (event.type) {
+            case 'user/message': {
+                const text = event.data.content
+                    .filter(block => block.type === 'text')
+                    .map(block => block.text)
+                    .join('');
+                if (text !== '') {
+                    const sourceKind = event.data.source.kind;
+                    if (sourceKind === 'user') {
+                        this.pushRow({ kind: 'user', text: `❯ ${text}` });
+                    }
+                    else if (sourceKind === 'plugin' && event.data.source.form === 'snapshot') {
+                        this.pushRow({ kind: 'system', text: text });
+                    }
+                    else {
+                        this.pushRow({ kind: 'system', text: `(context) ${text}` });
+                    }
+                    this.streaming = undefined;
+                    this.streamingReasoning = undefined;
+                    this.markDirty();
+                }
+                break;
+            }
+            case 'assistant/chunk': {
+                const chunk = event.data.chunk;
+                const open = this.openStepStats;
+                if (open !== null && open !== undefined
+                    && open.turn === event.data.turn && open.step === event.data.step) {
+                    if (open.firstTokenTime === null
+                        && chunk.type === 'text-delta'
+                        && chunk.text !== '') {
+                        this.openStepStats = { ...open, firstTokenTime: event.time };
+                    }
+                }
+                if (chunk.type === 'usage' && chunk.usage !== undefined) {
+                    this.recordUsage(event.data.turn, event.data.step, chunk.usage);
+                }
+                if (chunk.type === 'text-delta') {
+                    this.streaming ??= { text: '', reasoning: '' };
+                    this.streaming.text += chunk.text;
+                    this.markDirty();
+                }
+                else if (chunk.type === 'reasoning-delta') {
+                    this.streaming ??= { text: '', reasoning: '' };
+                    if (this.streaming.reasoning === '' && chunk.text !== '') {
+                        this.thinkingStartedAt = Date.now();
+                        this.streamingReasoning = { kind: 'streaming-reasoning', expanded: false };
+                    }
+                    this.streaming.reasoning += chunk.text;
+                    this.markDirty();
+                }
+                break;
+            }
+            case 'assistant/message': {
+                const text = event.data.message.content
+                    .filter(block => block.type === 'text')
+                    .map(block => block.text)
+                    .join('');
+                const reasoning = event.data.message.content
+                    .filter(block => block.type === 'reasoning')
+                    .map(block => block.text)
+                    .join('');
+                const open = this.openStepStats;
+                if (open !== undefined && open.turn === event.data.turn && open.step === event.data.step) {
+                    this.stats.llmMs += Math.max(0, event.time - open.startTime);
+                    if (open.firstTokenTime !== null) {
+                        this.stats.ttftMs += Math.max(0, open.firstTokenTime - open.startTime);
+                        this.stats.ttftSteps += 1;
+                        const outputTokens = event.data.usage?.outputTokens;
+                        if (typeof outputTokens === 'number' && Number.isFinite(outputTokens) && outputTokens >= 0) {
+                            this.stats.decodeMs += Math.max(0, event.time - open.firstTokenTime);
+                            this.stats.decodeTokens += outputTokens;
+                        }
+                    }
+                    this.openStepStats = undefined;
+                }
+                if (event.data.usage !== undefined) {
+                    this.recordUsage(event.data.turn, event.data.step, event.data.usage);
+                }
+                const reasoningExpanded = this.streamingReasoning?.expanded ?? false;
+                this.streaming = undefined;
+                this.streamingReasoning = undefined;
+                this.thinkingStartedAt = undefined;
+                if (reasoning !== '') {
+                    this.pushRow({ kind: 'reasoning', text: reasoning, expanded: reasoningExpanded });
+                }
+                if (text !== '')
+                    this.pushRow({ kind: 'assistant', text });
+                this.markDirty();
+                break;
+            }
+            case 'tool/call': {
+                this.openToolCalls.set(String(event.data.callId), event.data.name);
+                this.pendingToolTimes.set(String(event.data.callId), event.time);
+                const present = presentToolCall(event.data.name, event.data.arguments);
+                const row = {
+                    kind: 'tool',
+                    callId: event.data.callId,
+                    name: event.data.name,
+                    args: event.data.arguments,
+                    status: 'running',
+                    output: '',
+                    title: present.title,
+                    summary: present.summary,
+                    ...present.command === undefined ? {} : { command: present.command },
+                    ...present.cwd === undefined ? {} : { cwd: present.cwd },
+                    ...present.diff === undefined ? {} : { diff: present.diff },
+                    expanded: DIFF_TOOL_NAMES.has(event.data.name),
+                };
+                this.pushRow(row);
+                this.streaming = undefined;
+                this.markDirty();
+                break;
+            }
+            case 'tool/result': {
+                this.openToolCalls.delete(String(event.data.message.source.callId));
+                const dispatchedAt = this.pendingToolTimes.get(String(event.data.message.source.callId));
+                if (dispatchedAt !== undefined) {
+                    this.stats.toolMs += Math.max(0, event.time - dispatchedAt);
+                    this.pendingToolTimes.delete(String(event.data.message.source.callId));
+                }
+                const row = this.rows.findLast((candidate) => candidate.kind === 'tool' && candidate.callId === event.data.message.source.callId);
+                const output = collectText(event.data.message.content);
+                if (row !== undefined) {
+                    const metaDiffs = diffMetaDiffs(event.data.meta);
+                    if (metaDiffs !== null) {
+                        row.diff = metaDiffs;
+                        if (DIFF_TOOL_NAMES.has(row.name))
+                            row.expanded = true;
+                    }
+                    const isShell = SHELL_TOOL_NAMES.has(row.name);
+                    if (isShell) {
+                        const parsed = parseExitStatus(output);
+                        row.output = parsed.body;
+                        if (parsed.signal !== undefined)
+                            row.signal = parsed.signal;
+                        else
+                            row.exitCode = parsed.exitCode;
+                    }
+                    else {
+                        row.output = output;
+                    }
+                    const failed = event.data.error !== undefined
+                        || event.data.message.content[0]?.isError === true
+                        || (isShell && ((row.exitCode !== undefined && row.exitCode !== 0) || row.signal !== undefined));
+                    row.status = failed ? 'error' : 'ok';
+                }
+                else {
+                    const present = presentToolCall(event.data.message.source.callId, '');
+                    this.pushRow({
+                        kind: 'tool',
+                        callId: event.data.message.source.callId,
+                        name: event.data.message.source.callId,
+                        args: '',
+                        status: event.data.error === undefined ? 'ok' : 'error',
+                        output,
+                        title: present.title,
+                        summary: present.summary,
+                        expanded: false,
+                    });
+                }
+                this.markDirty();
+                break;
+            }
+            case 'step/start': {
+                this.openStepStats = {
+                    turn: event.data.turn,
+                    step: event.data.step,
+                    startTime: event.time,
+                    firstTokenTime: null,
+                };
+                this.markDirty();
+                break;
+            }
+            case 'step/end': {
+                if (this.lastStatsTurn !== event.data.turn) {
+                    this.stats.turns += 1;
+                    this.lastStatsTurn = event.data.turn;
+                }
+                this.stats.steps += 1;
+                this.openStepStats = undefined;
+                this.markDirty();
+                break;
+            }
+            case 'turn/start':
+                this.stalledWarningShown = false;
+                this.status = `turn ${event.data.turn} running`;
+                this.markDirty();
+                break;
+            case 'turn/end': {
+                const reason = event.data.reason;
+                this.openToolCalls.clear();
+                this.pendingToolTimes.clear();
+                this.stalledWarningShown = false;
+                this.pendingMessages.clear();
+                if (reason.kind === 'completed' && !this.completionSignaled) {
+                    this.completionSignaled = true;
+                    this.completedAt = Date.now();
+                    this.updateTerminalTitle();
+                    this.playCompletionSignal();
+                }
+                this.status = reason.kind === 'completed'
+                    ? 'idle'
+                    : reason.kind === 'error'
+                        ? `error: ${reason.error.message}`
+                        : `idle (${reason.kind})`;
+                if (reason.kind === 'error') {
+                    this.pushRow({ kind: 'error', text: `Turn ${event.data.turn} failed: ${reason.error.message}` });
+                }
+                this.markDirty();
+                break;
+            }
+            default:
+                break;
+        }
+    };
+    handleStatus = ({ agent, status }) => {
+        if (agent !== this.agent)
+            return;
+        this.lastActivity = Date.now();
+        if (status === 'running') {
+            this.completionSignaled = false;
+        }
+        else if (!this.completionSignaled && this.status === 'running') {
+            this.completionSignaled = true;
+            this.completedAt = Date.now();
+            this.updateTerminalTitle();
+            this.playCompletionSignal();
+        }
+        this.status = status === 'running' ? 'running' : 'idle';
+        this.markDirty();
+    };
+    handleError = ({ agent, error }) => {
+        if (agent !== this.agent)
+            return;
+        this.lastActivity = Date.now();
+        this.pushRow({ kind: 'error', text: errorChain(error) });
+        this.markDirty();
+    };
+    handleInboxClaimed = ({ agent, message }) => {
+        if (agent !== this.agent)
+            return;
+        if (this.pendingMessages.delete(message.id))
+            this.markDirty();
+    };
+    handleInboxDiscarded = ({ agent, message }) => {
+        if (agent !== this.agent)
+            return;
+        if (this.pendingMessages.delete(message.id))
+            this.markDirty();
+    };
+    handleDisposed = ({ agent }) => {
+        if (agent !== this.agent)
+            return;
+        this.agentGone = true;
+        this.pushRow({ kind: 'error', text: 'Agent was disposed; press Ctrl+C to exit.' });
+        this.status = 'disposed';
+        this.markDirty();
+    };
+    /** Render a live subagent's own session events so its progress is visible. */
+    handleSubagentSessionEvent = (sessionId, event) => {
+        const label = `[子代理 ${String(sessionId).slice(0, 8)}]`;
+        switch (event.type) {
+            case 'user/message': {
+                const text = collectText(event.data.content);
+                if (text !== '')
+                    this.pushRow({ kind: 'system', text: `${label} ❯ ${truncate(text, 6)}` });
+                break;
+            }
+            case 'assistant/chunk': {
+                // Child chunks are coalesced into assistant/message to avoid flooding.
+                break;
+            }
+            case 'assistant/message': {
+                const text = collectText(event.data.message.content);
+                if (text !== '')
+                    this.pushRow({ kind: 'assistant', text: `${label} ${truncate(text, 12)}` });
+                break;
+            }
+            case 'tool/call':
+                this.pushRow({ kind: 'system', text: `${label} ▶ ${event.data.name} ${event.data.arguments.slice(0, 160)}` });
+                break;
+            case 'tool/result': {
+                const output = truncate(collectText(event.data.message.content), 4);
+                const ok = event.data.error === undefined && !event.data.message.content[0]?.isError;
+                this.pushRow({ kind: 'system', text: `${label} ${ok ? '✓' : '✗'} ${event.data.message.source.callId}${output === '' ? '' : `\n  ${output}`}` });
+                break;
+            }
+            case 'turn/end':
+                this.pushRow({ kind: 'system', text: `${label} 轮次结束（${event.data.reason.kind}）` });
+                break;
+            case 'approval/asked':
+                this.pushRow({ kind: 'system', text: `${label} 等待审批：${event.data.toolName}` });
+                break;
+            default:
+                break;
+        }
+        this.lastActivity = Date.now();
+        this.markDirty();
+    };
+    handleSubagentStart = (info) => {
+        this.activeSubagents.set(String(info.runId), {
+            id: String(info.id),
+            provider: info.provider,
+            startedAt: Date.now(),
+        });
+        this.subagentSessions.add(String(info.id));
+        this.lastActivity = Date.now();
+        this.pushRow({ kind: 'system', text: `▶ 子代理 ${info.id} 已启动（${info.provider}${info.local ? '' : '，外部进程'}）` });
+        this.markDirty();
+    };
+    handleSubagentEnd = (info) => {
+        this.activeSubagents.delete(String(info.runId));
+        this.subagentSessions.delete(String(info.id));
+        this.lastActivity = Date.now();
+        const output = info.lastAssistantMessage === undefined
+            ? ''
+            : truncate(collectText(info.lastAssistantMessage), 6);
+        this.pushRow({
+            kind: 'system',
+            text: `✓ 子代理 ${info.id} 结束（${info.stopReason}）${output === '' ? '' : `\n  ${output}`}`,
+        });
+        this.markDirty();
+    };
+    // ── approval and questions ──────────────────────────────────────────────
+    handleApproval = async (request, next) => {
+        const agentLabel = request.agent.id === this.agent.id
+            ? '当前会话'
+            : `子代理 ${request.agent.id}`;
+        return new Promise((resolve) => {
+            const onAbort = () => {
+                this.closeConfirm('cancel');
+            };
+            request.signal?.addEventListener('abort', onAbort, { once: true });
+            this.openConfirm(`允许工具 "${request.toolName}"？（${agentLabel}）${request.reason === undefined ? '' : `\n${request.reason}`}`, 'y = 允许一次, n = 拒绝, Esc = 取消', (answer) => {
+                request.signal?.removeEventListener('abort', onAbort);
+                resolve(answer === 'y' ? 'allowed-once' : answer === 'n' ? 'rejected' : 'cancelled');
+            });
+        });
+    };
+    handleUserQuestions = async (request) => {
+        const answers = [];
+        const agentLabel = request.agent === undefined || request.agent.id === this.agent.id
+            ? undefined
+            : `子代理 ${request.agent.id}`;
+        for (const [index, question] of request.questions.entries()) {
+            const answer = await new Promise((resolve, reject) => {
+                const onAbort = () => {
+                    this.dialog = undefined;
+                    reject(new UserQuestionError('ask_user_question was interrupted before the user answered', 'ASK_ABORTED'));
+                };
+                request.signal?.addEventListener('abort', onAbort, { once: true });
+                const labeled = agentLabel === undefined
+                    ? question
+                    : { ...question, question: `[${agentLabel}] ${question.question}` };
+                this.openQuestion(labeled, index, request.questions.length, (selection) => {
+                    request.signal?.removeEventListener('abort', onAbort);
+                    resolve(selection);
+                }, reject);
+            });
+            answers.push({ id: question.id, selected: answer.selected, custom: answer.custom });
+        }
+        return { answers };
+    };
+    openConfirm(prompt, hint, resolve) {
+        this.dialog = { kind: 'confirm', prompt, hint, resolve };
+        this.markDirty();
+    }
+    closeConfirm(value) {
+        const dialog = this.dialog;
+        if (dialog === undefined || dialog.kind !== 'confirm')
+            return;
+        this.dialog = undefined;
+        dialog.resolve(value);
+        this.markDirty();
+    }
+    openQuestion(question, index, total, resolve, reject) {
+        this.dialog = {
+            kind: 'questions',
+            question,
+            index,
+            total,
+            selected: new Set(),
+            resolve: (selection) => {
+                this.dialog = undefined;
+                resolve(selection);
+                this.markDirty();
+            },
+            reject: (error) => {
+                this.dialog = undefined;
+                reject(error);
+                this.markDirty();
+            },
+        };
+        this.markDirty();
+    }
+    /** Open one question dialog and await its answer (cancellation rejects). */
+    askQuestion(question, index = 0, total = 1) {
+        return new Promise((resolve, reject) => {
+            this.openQuestion(question, index, total, resolve, reject);
+        });
+    }
+    /** The stored llm-pi-ai profile for one provider route, when settings provide one. */
+    piAiProviderProfile(provider) {
+        if (provider === 'deepseek-official')
+            return undefined;
+        const section = this.ctx.get('settings')?.get(settingsNamespace('llm-pi-ai'));
+        return section?.providers?.[provider];
+    }
+    /** Default listing endpoint for a built-in OpenCode route with no stored base URL. */
+    openCodeListingBaseURL(provider) {
+        if (provider === 'opencode-go')
+            return PROVIDER_TEMPLATES['opencode-go'].defaultBaseUrl;
+        if (provider === 'opencode')
+            return OPENCODE_ZEN_BASE_URL;
+        return undefined;
+    }
+    /**
+     * Fetch the live model list for an OpenCode or third-party provider from its
+     * OpenAI-compatible listing endpoint. The provider route is deliberately not
+     * passed to discovery: pi-ai would answer a catalog route from its installed
+     * registry, while the TUI wants the endpoint's current list.
+     */
+    async discoverEndpointModels(provider) {
+        const profile = this.piAiProviderProfile(provider);
+        const baseURL = typeof profile?.baseURL === 'string' && profile.baseURL.trim() !== ''
+            ? profile.baseURL.trim()
+            : this.openCodeListingBaseURL(provider);
+        if (baseURL === undefined)
+            return [];
+        const api = typeof profile?.api === 'string' && profile.api.trim() !== '' ? profile.api.trim() : undefined;
+        const apiKeyEnv = typeof profile?.apiKeyEnv === 'string' && profile.apiKeyEnv.trim() !== ''
+            ? profile.apiKeyEnv.trim()
+            : undefined;
+        const apiKey = apiKeyEnv === undefined ? undefined : await this.resolveCredential(apiKeyEnv);
+        const llm = this.ctx.get('llm');
+        if (llm === undefined)
+            return [];
+        const discovered = await llm.discoverModels(settingsNamespace('llm-pi-ai'), {
+            baseURL,
+            ...(api === undefined ? {} : { api }),
+            ...(apiKey === undefined ? {} : { apiKey }),
+            signal: AbortSignal.timeout(15_000),
+        });
+        return discovered.map(model => ({ id: model.id, label: model.name || model.id }));
+    }
+    /** Add one endpoint-listed model to the stored provider profile when needed. */
+    async ensureProviderModelConfigured(provider, modelId) {
+        const settings = this.ctx.get('settings');
+        const profile = this.piAiProviderProfile(provider);
+        if (settings === undefined || profile === undefined)
+            return true;
+        // A profile may legitimately have no models yet (e.g. onboarding saved an
+        // empty list); the picked endpoint model must still be persisted so the
+        // harness can serve it.
+        const models = Array.isArray(profile.models) ? profile.models : [];
+        const ids = new Set();
+        for (const raw of models) {
+            const id = typeof raw === 'string'
+                ? raw
+                : typeof raw === 'object' && raw !== null && typeof raw.id === 'string'
+                    ? raw.id
+                    : undefined;
+            if (typeof id === 'string' && id.length > 0)
+                ids.add(id);
+        }
+        if (ids.has(modelId))
+            return true;
+        try {
+            await settings.mutate(settingsNamespace('llm-pi-ai'), [
+                { op: 'set', path: ['providers', provider, 'models'], value: [...models, { id: modelId }] },
+            ]);
+            this.pushRow({ kind: 'system', text: `模型 ${modelId} 已加入提供商 ${provider} 的配置。` });
+            this.markDirty();
+            return true;
+        }
+        catch (error) {
+            this.pushRow({ kind: 'error', text: `无法把模型 ${modelId} 写入提供商配置：${errorChain(error)}` });
+            this.markDirty();
+            return false;
+        }
+    }
+    /** How many endpoint-listed models fit on one picker page alongside navigation. */
+    MODEL_PAGE_SIZE = 7;
+    MODEL_PAGE_PREV = '« 上一页';
+    MODEL_PAGE_NEXT = '» 下一页';
+    /**
+     * One pick across a possibly long model list, paging through the digit
+     * dialog so an endpoint with dozens of models stays selectable.
+     */
+    async pickModelOption(modelOptions, provider, sourceLabel, currentModel) {
+        const seen = new Set();
+        const unique = modelOptions.filter(option => {
+            if (seen.has(option.id))
+                return false;
+            seen.add(option.id);
+            return true;
+        });
+        if (unique.length === 0)
+            return undefined;
+        let offset = 0;
+        for (;;) {
+            const page = unique.slice(offset, offset + this.MODEL_PAGE_SIZE);
+            const hasPrev = offset > 0;
+            const hasNext = offset + this.MODEL_PAGE_SIZE < unique.length;
+            const pageCount = Math.max(1, Math.ceil(unique.length / this.MODEL_PAGE_SIZE));
+            const currentPage = Math.floor(offset / this.MODEL_PAGE_SIZE) + 1;
+            const options = page.map(option => ({
+                label: option.label,
+                description: option.id === currentModel ? '当前' : undefined,
+            }));
+            if (hasPrev)
+                options.push({ label: this.MODEL_PAGE_PREV, description: undefined });
+            if (hasNext)
+                options.push({ label: this.MODEL_PAGE_NEXT, description: undefined });
+            const answer = await this.askQuestion({
+                id: 'model-pick',
+                question: `选择模型（提供商 ${provider} · ${sourceLabel}${hasPrev || hasNext ? `，第 ${currentPage}/${pageCount} 页` : ''}）`,
+                options,
+            });
+            const picked = options.find(option => option.label === answer.selected[0]);
+            if (picked === undefined)
+                return undefined;
+            if (picked.label === this.MODEL_PAGE_NEXT) {
+                offset += this.MODEL_PAGE_SIZE;
+                continue;
+            }
+            if (picked.label === this.MODEL_PAGE_PREV) {
+                offset = Math.max(0, offset - this.MODEL_PAGE_SIZE);
+                continue;
+            }
+            return page.find(option => option.label === picked.label);
+        }
+    }
+    /** /model: pick a model and reasoning effort for the current provider. */
+    async runModelCommand() {
+        const llm = this.ctx.get('llm');
+        const current = this.selectionRef?.current;
+        const provider = current?.provider ?? this.agent.options.provider ?? this.providerName;
+        let modelOptions = [];
+        let modelSource = '已配置列表';
+        // OpenCode and other third-party routes are interrogated live so the picker
+        // shows what the endpoint actually serves, not just the stored catalog.
+        if (this.piAiProviderProfile(provider) !== undefined || provider === 'opencode' || provider === 'opencode-go') {
+            const previousStatus = this.status;
+            try {
+                this.status = `正在从端点获取 ${provider} 的模型列表…`;
+                this.markDirty();
+                modelOptions = await this.discoverEndpointModels(provider);
+                if (modelOptions.length > 0) {
+                    modelSource = '端点实时列表';
+                    // Keep models the endpoint does not list (e.g. ones already stored
+                    // for the route) selectable, so the live list never hides the
+                    // current model.
+                    try {
+                        const listed = (await llm?.listModels(provider)) ?? [];
+                        const endpointIds = new Set(modelOptions.map(model => model.id));
+                        for (const model of listed) {
+                            if (!endpointIds.has(model.id)) {
+                                modelOptions.push({ id: model.id, label: model.name || model.id });
+                            }
+                        }
+                    }
+                    catch {
+                        // The endpoint list stands alone when the catalog cannot be read.
+                    }
+                }
+            }
+            catch {
+                modelOptions = [];
+            }
+            finally {
+                this.status = previousStatus;
+                this.markDirty();
+            }
+        }
+        if (modelOptions.length === 0) {
+            try {
+                const listed = (await llm?.listModels(provider)) ?? [];
+                modelOptions = listed.map(model => ({ id: model.id, label: model.name || model.id }));
+            }
+            catch {
+                modelOptions = [];
+            }
+        }
+        if (modelOptions.length === 0) {
+            const fallback = current?.model ?? this.agent.options.model ?? 'deepseek-v4-flash';
+            modelOptions = [{ id: fallback, label: fallback }];
+        }
+        const selected = await this.pickModelOption(modelOptions, provider, modelSource, current?.model);
+        if (selected === undefined)
+            return;
+        if (!(await this.ensureProviderModelConfigured(provider, selected.id)))
+            return;
+        let effortOptions = [];
+        try {
+            const info = await llm?.resolveModelInfo(provider, selected.id);
+            effortOptions = (info?.reasoning?.efforts ?? []).map(effort => ({ id: String(effort.id), label: effort.name }));
+        }
+        catch {
+            effortOptions = [];
+        }
+        if (effortOptions.length === 0) {
+            effortOptions = ['off', 'high', 'max'].map(id => ({ id, label: id }));
+        }
+        const effortAnswer = await this.askQuestion({
+            id: 'effort-pick',
+            question: `选择思考强度（${selected.id}）`,
+            options: effortOptions.map(option => ({
+                label: option.label,
+                description: option.id === String(current?.reasoningEffort) ? '当前' : undefined,
+            })),
+        });
+        const effort = effortOptions.find(option => option.label === effortAnswer.selected[0])?.id;
+        const next = {
+            provider,
+            model: selected.id,
+            ...(effort === undefined ? {} : { reasoningEffort: ReasoningEffortId(effort) }),
+        };
+        if (this.selectionRef !== undefined)
+            this.selectionRef.current = next;
+        this.onSelectionChanged?.(next);
+        await this.ctx.get('agentDefaultModel')?.saveSelection(next);
+        this.pushRow({ kind: 'system', text: `模型已切换：${selected.id}（思考强度 ${effort ?? '默认'}）；下一步请求生效。` });
+        this.markDirty();
+    }
+    /** /mode: pick an agent preset (standard / PTC / minimal / ...). */
+    async runModeCommand() {
+        const agentPresets = this.ctx.get('agentPresets');
+        if (agentPresets === undefined) {
+            this.pushRow({ kind: 'error', text: 'agentPresets 服务不可用。' });
+            this.markDirty();
+            return;
+        }
+        const presets = await agentPresets.list();
+        if (presets.length === 0) {
+            this.pushRow({ kind: 'error', text: '没有可用的模式（preset）。' });
+            this.markDirty();
+            return;
+        }
+        const answer = await this.askQuestion({
+            id: 'mode-pick',
+            question: '选择模式',
+            options: presets.map(preset => ({
+                label: preset.name ?? preset.id,
+                description: `${preset.id === this.presetId ? '当前 · ' : ''}${preset.description ?? ''}`.trim(),
+            })),
+        });
+        const selected = presets.find(preset => (preset.name ?? preset.id) === answer.selected[0]);
+        if (selected === undefined)
+            return;
+        const selectedName = selected.name ?? selected.id;
+        const hasWork = this.agent.session.events.some(event => event.type === 'turn/start');
+        if (!hasWork) {
+            await agentPresets.recompose(this.agent.ctx, selected.id);
+            this.presetId = selected.id;
+            this.presetName = selectedName;
+            this.pushRow({ kind: 'system', text: `已切换到模式：${selectedName}（当前会话生效）。` });
+        }
+        else {
+            this.pushRow({
+                kind: 'system',
+                text: `当前会话已有内容，无法中途切换模式；已记住 ${selectedName}，下次启动生效。`,
+            });
+        }
+        await this.ctx.get('settings')?.update(settingsNamespace('agent-presets'), { default: selected.id });
+        this.markDirty();
+    }
+    /** /resume: switch to a past session, or open a picker when no id is given. */
+    async runResumeCommand(arg, fromLaunch = false) {
+        const target = arg.trim();
+        if (!fromLaunch && this.agent.status === 'running') {
+            this.pushRow({ kind: 'error', text: '当前轮次运行中，请等待结束或按 Esc 取消后再切换会话。' });
+            this.markDirty();
+            return;
+        }
+        if (target !== '') {
+            if (target === String(this.agent.id)) {
+                this.pushRow({ kind: 'system', text: '已在当前会话。' });
+                this.markDirty();
+                return;
+            }
+            this.pushRow({ kind: 'system', text: `正在切换到会话 ${target}…` });
+            this.markDirty();
+            await this.onSwitchSession?.(target);
+            return;
+        }
+        const persistence = this.ctx.get('sessionPersistence');
+        if (persistence === undefined) {
+            this.pushRow({ kind: 'error', text: 'sessionPersistence 服务不可用。' });
+            this.markDirty();
+            return;
+        }
+        const inspected = await listResumableSessions(persistence, String(this.agent.id));
+        if (inspected.length === 0) {
+            this.pushRow({ kind: 'system', text: '没有可恢复的历史会话（也可以直接 /resume <session-id>）。' });
+            this.markDirty();
+            return;
+        }
+        const answer = await this.askQuestion({
+            id: 'resume-pick',
+            question: '选择要恢复的历史会话',
+            options: inspected.map(item => ({
+                label: item.label,
+                description: `${formatSessionTime(item.updatedAt)} · ${item.cwd}`,
+            })),
+        });
+        const picked = inspected.find(item => item.label === answer.selected[0]);
+        if (picked === undefined)
+            return;
+        this.pushRow({ kind: 'system', text: `正在切换到会话 ${picked.id}…` });
+        this.markDirty();
+        await this.onSwitchSession?.(picked.id);
+    }
+    /** Current provider route selected for the running agent. */
+    currentProvider() {
+        // `agent.options` is authoritative for the launched agent; the selection
+        // ref can still hold the persisted default when a CLI override is active.
+        return this.agent.options.provider ?? this.selectionRef?.current?.provider ?? this.providerName;
+    }
+    /** Resolve one credential reference without exposing its value. */
+    async resolveCredential(envRef) {
+        const env = process.env[envRef];
+        if (env !== undefined && env.trim() !== '')
+            return env.trim();
+        const credentials = this.ctx.get('credentials');
+        if (credentials === undefined)
+            return undefined;
+        const resolved = await credentials.resolve(credentialRef(envRef));
+        return resolved?.value.trim() === '' ? undefined : resolved?.value.trim();
+    }
+    /** Query the OpenCode Go quota endpoint. */
+    async fetchOpenCodeGoUsage(apiKey) {
+        let response;
+        try {
+            response = await fetch(OPENCODE_GO_USAGE_URL, {
+                headers: {
+                    authorization: `Bearer ${apiKey}`,
+                    accept: 'application/json',
+                },
+                signal: AbortSignal.timeout(15_000),
+            });
+        }
+        catch (error) {
+            throw new Error(`无法访问 OpenCode 额度接口：${errorChain(error)}`);
+        }
+        let payload;
+        try {
+            payload = await response.json();
+        }
+        catch {
+            payload = undefined;
+        }
+        if (!response.ok) {
+            const message = openCodeApiErrorMessage(payload);
+            if (response.status === 401) {
+                throw new Error(`OpenCode Go API Key 无效或未授权（401）${message === '' ? '' : `：${message}`}`);
+            }
+            if (response.status === 403) {
+                throw new Error(`当前 Key 未订阅 OpenCode Go，或额度服务不可用（403）${message === '' ? '' : `：${message}`}`);
+            }
+            throw new Error(`OpenCode Go 额度接口返回 HTTP ${response.status}${message === '' ? '' : `：${message}`}`);
+        }
+        return payload;
+    }
+    /** Explain Zen metered billing instead of pretending it has a quota. */
+    zenUsageText(source) {
+        const usage = this.stats.usage;
+        const billedInput = usage.inputTokens + usage.cacheReadTokens + usage.cacheWriteTokens;
+        const tokenLine = billedInput > 0 || usage.outputTokens > 0
+            ? `本会话已记录 token：输入 ${formatTokens(billedInput)} · 输出 ${formatTokens(usage.outputTokens)}（会话统计，非账单金额）`
+            : '本会话尚无 token 用量记录。';
+        return [
+            `OpenCode Zen 按量计费（${source.provider}）`,
+            'Zen 没有固定额度：请求按 API 账单计费，余额与账单请前往 https://opencode.ai/zen 查看。',
+            tokenLine,
+        ].join('\n');
+    }
+    /** /usage and /quota: show Zen billing info or live Go quota usage. */
+    async runUsageCommand() {
+        const provider = this.currentProvider();
+        const llmPiAi = this.ctx.get('settings')?.get(settingsNamespace('llm-pi-ai'));
+        const source = openCodeSourceFor(provider, llmPiAi);
+        if (source === null) {
+            this.pushRow({
+                kind: 'error',
+                text: `当前提供商 ${provider} 不是 OpenCode 源；/usage 仅对 OpenCode Zen/Go 可用。`,
+            });
+            this.markDirty();
+            return;
+        }
+        if (source.flavor === 'zen') {
+            this.pushRow({ kind: 'system', text: this.zenUsageText(source) });
+            this.markDirty();
+            return;
+        }
+        const apiKey = await this.resolveCredential(source.apiKeyEnv);
+        if (apiKey === undefined) {
+            this.pushRow({
+                kind: 'error',
+                text: `未找到 OpenCode Go 凭据 ${source.apiKeyEnv}；请先运行 /setup 配置，或导出该环境变量。`,
+            });
+            this.markDirty();
+            return;
+        }
+        const previousStatus = this.status;
+        this.status = `querying ${source.provider} usage…`;
+        this.markDirty();
+        try {
+            const payload = await this.fetchOpenCodeGoUsage(apiKey);
+            this.pushRow({ kind: 'system', text: formatOpenCodeGoUsage(payload, source) });
+        }
+        finally {
+            this.status = previousStatus;
+            this.markDirty();
+        }
+    }
+    // ── keyboard ────────────────────────────────────────────────────────────
+    handleData = (chunk) => {
+        const text = this.decoder.write(chunk);
+        const combined = this.escapeBuffer + text;
+        this.escapeBuffer = '';
+        if (this.escapeTimer !== undefined) {
+            clearTimeout(this.escapeTimer);
+            this.escapeTimer = undefined;
+        }
+        const escape = /^\x1b\[([A-D])$/u;
+        const match = combined.match(escape);
+        if (match !== null) {
+            switch (match[1]) {
+                case 'A':
+                    if (this.suggestionsVisible()) {
+                        this.suggestionIndex = Math.max(0, this.suggestionIndex - 1);
+                        this.markDirty();
+                    }
+                    else if (this.input === '' && this.collapsibleRows().length > 0) {
+                        this.moveCollapsibleFocus(-1);
+                    }
+                    else {
+                        this.historyBack();
+                    }
+                    return;
+                case 'B':
+                    if (this.suggestionsVisible()) {
+                        this.suggestionIndex = Math.min(this.commandSuggestions.length - 1, this.suggestionIndex + 1);
+                        this.markDirty();
+                    }
+                    else if (this.input === '' && this.collapsibleRows().length > 0) {
+                        this.moveCollapsibleFocus(1);
+                    }
+                    else {
+                        this.historyForward();
+                    }
+                    return;
+                case 'C':
+                    this.moveCursor(1);
+                    return;
+                case 'D':
+                    this.moveCursor(-1);
+                    return;
+            }
+        }
+        const sgrMouse = /^\x1b\[<(\d+);(\d+);(\d+)([Mm])$/u.exec(combined);
+        if (sgrMouse !== null) {
+            const button = Number(sgrMouse[1]);
+            const y = Number(sgrMouse[3]);
+            if (sgrMouse[4] === 'M') {
+                if (button === 64) {
+                    this.scrollOffset += 3;
+                    this.markDirty();
+                    return;
+                }
+                if (button === 65) {
+                    this.scrollOffset = Math.max(0, this.scrollOffset - 3);
+                    this.markDirty();
+                    return;
+                }
+                if (button === 0) {
+                    this.handleMouseClick(y);
+                    return;
+                }
+            }
+            return;
+        }
+        if (combined === '\x1b[5~') {
+            this.scrollOffset += Math.max(3, Math.floor((process.stdout.rows || 24) / 2));
+            this.markDirty();
+            return;
+        }
+        if (combined === '\x1b[6~') {
+            this.scrollOffset = Math.max(0, this.scrollOffset - Math.max(3, Math.floor((process.stdout.rows || 24) / 2)));
+            this.markDirty();
+            return;
+        }
+        if (combined === '\x1b[H' || combined === '\x1b[1~') {
+            this.cursor = 0;
+            this.markDirty();
+            return;
+        }
+        if (combined === '\x1b[F' || combined === '\x1b[4~') {
+            this.cursor = this.input.length;
+            this.markDirty();
+            return;
+        }
+        if (combined === '\x1b[3~') {
+            this.deleteAtCursor();
+            return;
+        }
+        if (isEscapePrefix(combined)) {
+            this.escapeBuffer = combined;
+            this.escapeTimer = setTimeout(() => {
+                this.escapeTimer = undefined;
+                const pending = this.escapeBuffer;
+                this.escapeBuffer = '';
+                if (pending === '\x1b') {
+                    this.handleChar('\x1b');
+                }
+                else if (pending.startsWith('\x1b[')) {
+                    // An escape sequence that never completed: consume it silently
+                    // instead of treating its ESC byte as a cancel.
+                }
+                else if (pending !== '') {
+                    this.handlePlainText(pending);
+                }
+            }, 60);
+            return;
+        }
+        if (combined.startsWith('\x1b[')) {
+            // Unknown escape sequence — consume without side effects.
+            return;
+        }
+        if (combined.startsWith('\x1b')) {
+            this.handleChar('\x1b');
+            const rest = combined.slice(1);
+            if (rest !== '')
+                this.handlePlainText(rest);
+            return;
+        }
+        this.handlePlainText(combined);
+    };
+    handlePlainText(text) {
+        let previous = '';
+        for (const char of text) {
+            // Windows terminals may deliver Enter as CRLF; consume only the first half.
+            if (char === '\n' && previous === '\r') {
+                previous = char;
+                continue;
+            }
+            if (char === '\r' && previous === '\n') {
+                previous = char;
+                continue;
+            }
+            this.handleChar(char);
+            previous = char;
+        }
+    }
+    handleChar(char) {
+        switch (char) {
+            case '\x1b':
+                this.handleEscape();
+                return;
+            case '\r':
+            case '\n':
+                this.submit();
+                return;
+            case '\x7f':
+                this.backspace();
+                return;
+            case '\x08':
+                this.backspace();
+                return;
+            case '\x03':
+                this.handleCtrlC();
+                return;
+            case '\x04':
+                void this.requestExit(0);
+                return;
+            case '\x0c':
+                this.dirty = true;
+                this.render();
+                return;
+            case '\x01':
+                this.cursor = 0;
+                this.markDirty();
+                return;
+            case '\x05':
+                this.cursor = this.input.length;
+                this.markDirty();
+                return;
+            case '\x15':
+                this.input = '';
+                this.cursor = 0;
+                this.inputFolded = false;
+                this.markDirty();
+                return;
+            case '\x0b':
+                this.input = this.input.slice(0, this.cursor);
+                this.markDirty();
+                return;
+            case '\x0e':
+                this.moveCollapsibleFocus(1);
+                return;
+            case '\x10':
+                this.moveCollapsibleFocus(-1);
+                return;
+            case '\x12':
+                this.toggleAllCollapsible();
+                return;
+            case '\x14':
+                this.inputFolded = !this.inputFolded;
+                this.markDirty();
+                return;
+        }
+        if (this.dialog !== undefined) {
+            this.handleDialogChar(char);
+            return;
+        }
+        if (char === '\t') {
+            if (this.suggestionsVisible()) {
+                const selected = this.commandSuggestions[this.suggestionIndex];
+                if (selected !== undefined) {
+                    this.input = `/${selected.name} `;
+                    this.cursor = this.input.length;
+                    this.commandSuggestions = [];
+                    this.suggestionIndex = 0;
+                    this.markDirty();
+                    return;
+                }
+            }
+            this.input = `${this.input.slice(0, this.cursor)}  ${this.input.slice(this.cursor)}`;
+            this.cursor += 2;
+            this.markDirty();
+            return;
+        }
+        if (char >= ' ' && char !== '\x7f') {
+            this.input = `${this.input.slice(0, this.cursor)}${char}${this.input.slice(this.cursor)}`;
+            this.cursor += char.length;
+            this.markDirty();
+        }
+    }
+    handleDialogChar(text) {
+        const dialog = this.dialog;
+        if (dialog === undefined)
+            return;
+        if (dialog.kind === 'onboarding') {
+            this.handleOnboardingChar(text);
+            return;
+        }
+        if (dialog.kind === 'confirm') {
+            if (text === 'y' || text === 'Y')
+                this.closeConfirm('y');
+            else if (text === 'n' || text === 'N')
+                this.closeConfirm('n');
+            else if (text === '\x03' || text === '\x1b')
+                this.closeConfirm('cancel');
+            return;
+        }
+        const digit = /^[0-9]$/u.exec(text)?.[0];
+        if (digit !== undefined) {
+            const index = Number(digit) - 1;
+            if (index >= 0 && index < (dialog.question.options?.length ?? 0)) {
+                if (dialog.question.multiSelect === true) {
+                    if (dialog.selected.has(index))
+                        dialog.selected.delete(index);
+                    else
+                        dialog.selected.add(index);
+                }
+                else {
+                    dialog.selected.clear();
+                    dialog.selected.add(index);
+                }
+                this.markDirty();
+            }
+            return;
+        }
+        if (text === '\r' || text === '\n') {
+            const options = dialog.question.options ?? [];
+            const selected = [...dialog.selected].map(index => options[index]?.label).filter((label) => label !== undefined);
+            if (selected.length === 0 && options.length > 0 && dialog.question.multiSelect !== true) {
+                // no selection: treat as cancel unless there are no options
+                dialog.reject(new UserQuestionError('ask_user_question was cancelled', 'ASK_ABORTED'));
+                return;
+            }
+            if (options.length === 0) {
+                dialog.resolve({ selected: [], custom: this.input });
+                this.input = '';
+                this.cursor = 0;
+                return;
+            }
+            dialog.resolve({ selected });
+            return;
+        }
+        if (text === '\x1b' || text === '\x03') {
+            dialog.reject(new UserQuestionError('ask_user_question was cancelled', 'ASK_ABORTED'));
+            return;
+        }
+        if (optionsLength(dialog) === 0) {
+            for (const char of text) {
+                if (char >= ' ' && char !== '\x7f') {
+                    this.input = `${this.input.slice(0, this.cursor)}${char}${this.input.slice(this.cursor)}`;
+                    this.cursor += char.length;
+                }
+            }
+            this.markDirty();
+        }
+    }
+    handleOnboardingChar(text) {
+        const state = this.onboarding;
+        if (state === undefined)
+            return;
+        switch (state.step) {
+            case 'provider':
+                {
+                    const selected = text === '1' ? 'official'
+                        : text === '2' ? 'opencode-go'
+                            : text === '3' ? 'openai-completions'
+                                : text === '4' ? 'openai-responses'
+                                    : text === '5' ? 'anthropic-messages'
+                                        : undefined;
+                    if (selected !== undefined) {
+                        state.providerType = selected;
+                        state.providerId = '';
+                        state.baseUrl = '';
+                        state.key = '';
+                        state.models = [];
+                        this.input = '';
+                        this.cursor = 0;
+                        this.advanceOnboarding();
+                    }
+                }
+                return;
+            case 'id':
+            case 'base-url':
+            case 'key':
+            case 'models': {
+                if (state.step === 'models' && text === '\x06') {
+                    void this.fetchOnboardingModels();
+                    return;
+                }
+                if (text === '\r' || text === '\n') {
+                    const value = this.input.trim();
+                    if (state.step === 'id') {
+                        const template = PROVIDER_TEMPLATES[state.providerType];
+                        const id = value === '' ? template.defaultId : value;
+                        if (!/^[a-z0-9][a-z0-9-]*$/u.test(id)) {
+                            this.pushRow({ kind: 'error', text: 'Provider ID 只能包含小写字母、数字和连字符，且不能以连字符开头。' });
+                            this.markDirty();
+                            return;
+                        }
+                        state.providerId = id;
+                    }
+                    else if (state.step === 'key') {
+                        if (value === '') {
+                            this.pushRow({ kind: 'error', text: 'API Key 不能为空，请重新输入。' });
+                            this.markDirty();
+                            return;
+                        }
+                        state.key = value;
+                    }
+                    else if (state.step === 'models') {
+                        const template = PROVIDER_TEMPLATES[state.providerType];
+                        const parsed = value === ''
+                            ? template.defaultModels
+                            : value.split(/[\s,，]+/u).filter(Boolean);
+                        if (parsed.length === 0) {
+                            this.pushRow({ kind: 'error', text: '至少需要一个模型 ID。' });
+                            this.markDirty();
+                            return;
+                        }
+                        state.models = parsed;
+                    }
+                    else {
+                        state.baseUrl = value;
+                    }
+                    this.input = '';
+                    this.cursor = 0;
+                    this.advanceOnboarding();
+                    return;
+                }
+                for (const char of text) {
+                    if (char >= ' ' && char !== '\x7f') {
+                        this.input = `${this.input.slice(0, this.cursor)}${char}${this.input.slice(this.cursor)}`;
+                        this.cursor += char.length;
+                    }
+                }
+                this.markDirty();
+                return;
+            }
+            case 'confirm':
+                if (text === 'y' || text === 'Y') {
+                    this.dialog = undefined;
+                    this.input = '';
+                    this.cursor = 0;
+                    void this.saveOnboarding();
+                }
+                else if (text === 'n' || text === 'N') {
+                    state.step = 'provider';
+                    state.providerType = 'official';
+                    state.providerId = '';
+                    state.baseUrl = '';
+                    state.key = '';
+                    state.models = [];
+                    this.input = '';
+                    this.cursor = 0;
+                    this.markDirty();
+                }
+                return;
+        }
+    }
+    advanceOnboarding() {
+        const state = this.onboarding;
+        if (state === undefined)
+            return;
+        if (state.step === 'provider') {
+            state.step = state.providerType === 'official' ? 'key' : 'id';
+        }
+        else if (state.step === 'id') {
+            state.step = 'base-url';
+        }
+        else if (state.step === 'base-url') {
+            state.step = 'key';
+        }
+        else if (state.step === 'key') {
+            state.step = 'models';
+        }
+        else if (state.step === 'models') {
+            state.step = 'confirm';
+        }
+        this.input = '';
+        this.cursor = 0;
+        this.markDirty();
+    }
+    /** Fetch the endpoint's model list into the onboarding wizard's models step. */
+    async fetchOnboardingModels() {
+        const state = this.onboarding;
+        if (state === undefined || state.step !== 'models')
+            return;
+        const template = PROVIDER_TEMPLATES[state.providerType];
+        const providerType = state.providerType;
+        const baseUrl = state.baseUrl;
+        const key = state.key;
+        const baseURL = baseUrl === '' ? template.defaultBaseUrl : baseUrl;
+        if (baseURL === '') {
+            this.pushRow({ kind: 'error', text: '请先填写 Base URL 再获取模型列表。' });
+            this.markDirty();
+            return;
+        }
+        const previousStatus = this.status;
+        this.status = '正在从端点获取模型列表…';
+        this.markDirty();
+        try {
+            const llm = this.ctx.get('llm');
+            if (llm === undefined)
+                throw new Error('llm 服务不可用');
+            const discovered = await llm.discoverModels(settingsNamespace('llm-pi-ai'), {
+                baseURL,
+                ...(template.api === undefined ? {} : { api: template.api }),
+                ...(key === '' ? {} : { apiKey: key }),
+                signal: AbortSignal.timeout(15_000),
+            });
+            // Apply only if the wizard is still on the same draft the fetch started
+            // from, so a stale reply cannot overwrite a newer edit or a reset.
+            const stillCurrent = this.onboarding === state
+                && state.step === 'models'
+                && state.providerType === providerType
+                && state.baseUrl === baseUrl
+                && state.key === key;
+            if (!stillCurrent)
+                return;
+            const ids = [...new Set(discovered.map(model => model.id).filter(id => id.length > 0))];
+            if (ids.length === 0) {
+                this.pushRow({ kind: 'error', text: '端点没有返回可用模型，请手动输入模型 ID。' });
+            }
+            else {
+                state.models = ids;
+                this.input = '';
+                this.cursor = 0;
+                this.pushRow({ kind: 'system', text: `已从端点获取 ${ids.length} 个模型（Enter 确认，也可继续修改）。` });
+            }
+        }
+        catch (error) {
+            this.pushRow({ kind: 'error', text: `获取模型列表失败：${errorChain(error)}` });
+        }
+        finally {
+            this.status = previousStatus;
+            this.markDirty();
+        }
+    }
+    async saveOnboarding() {
+        const state = this.onboarding;
+        if (state === undefined)
+            return;
+        let saved = true;
+        try {
+            const credentials = this.ctx.get('credentials');
+            const settings = this.ctx.get('settings');
+            const template = PROVIDER_TEMPLATES[state.providerType];
+            if (state.providerType === 'official') {
+                const envRef = 'DEEPSEEK_API_KEY';
+                await this.saveCredential(credentials, envRef, state.key);
+                const model = state.models[0] ?? 'deepseek-v4-pro';
+                await this.ctx.get('agentDefaultModel')?.saveSelection({ provider: 'deepseek-official', model });
+                if (this.selectionRef !== undefined) {
+                    this.selectionRef.current = { provider: 'deepseek-official', model };
+                }
+                this.onSelectionChanged?.({ provider: 'deepseek-official', model });
+                if (state.baseUrl !== '' && settings !== undefined) {
+                    await settings.update(settingsNamespace('llm-deepseek'), { baseURL: state.baseUrl });
+                    this.pushRow({ kind: 'system', text: `Base URL 已保存 → ${displayDshPath('settings.yaml')}` });
+                }
+                if (saved) {
+                    this.pushRow({
+                        kind: 'system',
+                        text: `配置完成，已记住默认提供商/模型：deepseek-official / ${model}。以后直接运行 dsh --profile tui 即可。`,
+                    });
+                }
+            }
+            else {
+                const envRef = envRefForId(state.providerId);
+                const model = state.models[0];
+                // OpenCode / third-party (llm-pi-ai) routes have no adapter-level
+                // reasoning default. Re-running setup must not silently drop the
+                // effort that makes thinking arrive as `reasoning` blocks; default it
+                // to a supported level (if any) and persist it in both the profile
+                // and the default-model selection.
+                const llm = this.ctx.get('llm');
+                const defaultEffort = model !== undefined && llm !== undefined
+                    ? await defaultReasoningEffort(llm, state.providerId, model)
+                    : undefined;
+                const profile = {
+                    displayName: template.label,
+                    apiKeyEnv: envRef,
+                    api: template.api,
+                    baseURL: state.baseUrl === '' ? template.defaultBaseUrl : state.baseUrl,
+                    models: state.models.map(id => ({ id })),
+                    ...(defaultEffort === undefined ? {} : { reasoning: defaultEffort }),
+                };
+                if (settings === undefined) {
+                    this.pushRow({ kind: 'error', text: '设置服务不可用，自定义提供商未保存。' });
+                    saved = false;
+                }
+                else {
+                    await settings.mutate(settingsNamespace('llm-pi-ai'), [
+                        { op: 'set', path: ['providers', state.providerId], value: profile },
+                    ]);
+                    this.pushRow({ kind: 'system', text: `提供商 ${state.providerId} 已保存 → ${displayDshPath('settings.yaml')}` });
+                }
+                await this.saveCredential(credentials, envRef, state.key);
+                if (saved) {
+                    const selection = {
+                        provider: state.providerId,
+                        model,
+                        ...(defaultEffort === undefined ? {} : { reasoningEffort: defaultEffort }),
+                    };
+                    await this.ctx.get('agentDefaultModel')?.saveSelection(selection);
+                    if (this.selectionRef !== undefined) {
+                        this.selectionRef.current = selection;
+                    }
+                    this.onSelectionChanged?.(selection);
+                    this.pushRow({
+                        kind: 'system',
+                        text: `配置完成，已记住默认提供商/模型：${state.providerId} / ${model}。以后直接运行 dsh --profile tui 即可（--provider/--model 可临时覆盖）。`,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            saved = false;
+            this.pushRow({ kind: 'error', text: `保存配置失败: ${errorChain(error)}` });
+        }
+        finally {
+            this.onboarding = undefined;
+            state.resolve(saved);
+            this.markDirty();
+        }
+    }
+    /** Store one credential, falling back to a launch-environment override on shadow/absence. */
+    async saveCredential(credentials, envRef, key) {
+        const shadowing = process.env[envRef];
+        const shadowed = shadowing !== undefined && shadowing !== '';
+        if (credentials !== undefined && !shadowed) {
+            await credentials.set(credentialRef(envRef), key);
+            this.pushRow({ kind: 'system', text: `${envRef} 已保存 → ${displayDshPath('.credentials.yaml')}` });
+            return;
+        }
+        await this.writeLaunchEnv({ [envRef]: key });
+        this.pushRow({
+            kind: 'system',
+            text: shadowed
+                ? IS_WINDOWS
+                    ? `环境变量 ${envRef} 已存在且优先，已用 setx + env.cmd 覆盖；新开的终端生效。`
+                    : `环境变量 ${envRef} 已存在且优先，已写入启动环境覆盖；新开的终端生效。`
+                : `凭据服务不可用，已写入启动环境覆盖 → ${displayDshPath(IS_WINDOWS ? 'env.cmd' : 'env.sh')}`,
+        });
+    }
+    /** Write launch-environment overrides so they beat system-injected variables. */
+    async writeLaunchEnv(entries) {
+        const home = dshHomeDir();
+        const file = join(home, IS_WINDOWS ? 'env.cmd' : 'env.sh');
+        await mkdir(home, { recursive: true, mode: 0o700 });
+        if (IS_WINDOWS) {
+            const lines = ['@echo off', 'rem Generated by dsh-ssh-tui onboarding.'];
+            for (const [name, value] of Object.entries(entries)) {
+                lines.push(`set "${name}=${value.replaceAll('"', '')}"`);
+            }
+            await writeFile(file, `${lines.join('\r\n')}\r\n`, { mode: 0o600 });
+            // Persist for future processes; best-effort, env.cmd remains as a manual fallback.
+            await Promise.all(Object.entries(entries).map(([name, value]) => this.setWindowsEnv(name, value))).catch(() => { });
+            return;
+        }
+        const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+        const lines = ['# Generated by dsh-ssh-tui onboarding.'];
+        for (const [name, value] of Object.entries(entries)) {
+            lines.push(`export ${name}=${quote(value)}`);
+        }
+        await writeFile(file, `${lines.join('\n')}\n`, { mode: 0o600 });
+        await this.ensurePosixEnvHook();
+    }
+    /** Persist one variable into the Windows user environment (best-effort). */
+    setWindowsEnv(name, value) {
+        return new Promise((resolve) => {
+            const child = spawn('setx', [name, value], { stdio: 'ignore', windowsHide: true });
+            child.on('error', () => resolve());
+            child.on('exit', () => resolve());
+        });
+    }
+    /** Idempotently source $DSH_HOME/env.sh from the user's POSIX shell rc files. */
+    async ensurePosixEnvHook() {
+        const sourceLine = `[ -f "$HOME/.dsh/env.sh" ] && . "$HOME/.dsh/env.sh"`;
+        const marker = '# dsh-ssh-tui launch environment';
+        const shell = process.env.SHELL ?? '';
+        const targets = [];
+        if (shell.endsWith('zsh'))
+            targets.push('.zshenv', '.zshrc');
+        else if (shell.endsWith('fish'))
+            targets.push('.config/fish/config.fish');
+        else
+            targets.push('.bashrc');
+        targets.push('.profile');
+        for (const relative of targets) {
+            const file = join(homedir(), relative);
+            let content = '';
+            try {
+                content = await readFile(file, 'utf8');
+            }
+            catch {
+                // File absent: create it below when it is a primary target.
+            }
+            if (content.includes(marker))
+                continue;
+            const line = relative.endsWith('config.fish')
+                ? 'test -f "$HOME/.dsh/env.sh"; and source "$HOME/.dsh/env.sh"'
+                : sourceLine;
+            const addition = `${content === '' ? '' : '\n'}${marker}\n${line}\n`;
+            await mkdir(dirname(file), { recursive: true, mode: 0o700 });
+            await writeFile(file, content + addition, { mode: 0o600 });
+        }
+    }
+    handleEscape() {
+        if (this.dialog !== undefined) {
+            if (this.dialog.kind === 'confirm')
+                this.closeConfirm('cancel');
+            else if (this.dialog.kind === 'onboarding')
+                this.cancelOnboarding();
+            else
+                this.dialog.reject(new UserQuestionError('ask_user_question was cancelled', 'ASK_ABORTED'));
+            return;
+        }
+        if (this.scrollOffset > 0) {
+            this.scrollOffset = 0;
+            this.markDirty();
+            return;
+        }
+        if (this.focusedRow !== null) {
+            this.focusedRow = null;
+            this.markDirty();
+            return;
+        }
+        if (this.suggestionsVisible()) {
+            this.commandSuggestions = [];
+            this.suggestionIndex = 0;
+            this.markDirty();
+            return;
+        }
+        if (this.agent.status === 'running') {
+            this.pushRow({ kind: 'system', text: '已请求取消当前轮次…' });
+            this.agent.cancel({ kind: 'user' });
+            this.status = 'cancelling…';
+            this.markDirty();
+        }
+    }
+    /** Toggle the collapsible row under a click on the transcript area. */
+    handleMouseClick(y) {
+        if (this.dialog !== undefined)
+            return;
+        const row = this.clickableRows.get(y);
+        if (row === undefined)
+            return;
+        this.focusedRow = row;
+        row.expanded = !row.expanded;
+        this.markDirty();
+    }
+    handleCtrlC() {
+        if (this.dialog !== undefined) {
+            this.handleEscape();
+            return;
+        }
+        if (this.agent.status === 'running') {
+            this.pushRow({ kind: 'system', text: '已请求取消当前轮次…（Ctrl+C）' });
+            this.agent.cancel({ kind: 'user' });
+            this.status = 'cancelling…';
+            this.markDirty();
+            return;
+        }
+        void this.requestExit(130);
+    }
+    submit() {
+        if (this.dialog !== undefined) {
+            this.handleDialogChar('\r');
+            return;
+        }
+        this.scrollOffset = 0;
+        if (this.input.trim() === '' && this.collapsibleRows().length > 0) {
+            this.toggleCollapsible();
+            return;
+        }
+        if (this.suggestionsVisible()) {
+            const selected = this.commandSuggestions[this.suggestionIndex];
+            if (selected !== undefined && selected.name.startsWith(this.input.slice(1))) {
+                this.input = `/${selected.name}`;
+                this.cursor = this.input.length;
+            }
+        }
+        const text = this.input.trim();
+        if (text === '')
+            return;
+        if (text.startsWith('/')) {
+            this.runCommand(text);
+            return;
+        }
+        if (this.agentGone)
+            return;
+        this.history.push(text);
+        this.historyIndex = this.history.length;
+        this.input = '';
+        this.cursor = 0;
+        this.inputFolded = false;
+        const message = createUserMessage({
+            content: [{ type: 'text', text }],
+            source: { kind: 'user' },
+        });
+        if (this.agent.status === 'running') {
+            this.pendingMessages.set(message.id, text);
+            this.pushRow({ kind: 'system', text: `⚡ ${text}（运行中已提交，将在下个步骤生效；Esc/Ctrl+C 可中断）` });
+            this.agent.steer(message);
+        }
+        else {
+            this.agent.followup(message);
+        }
+        this.markDirty();
+    }
+    runCommand(text) {
+        const [command, ...rest] = text.slice(1).split(/\s+/u);
+        const arg = rest.join(' ');
+        switch (command) {
+            case 'help': {
+                const local = LOCAL_COMMANDS
+                    .filter(item => item.name !== 'help' && item.name !== 'exit')
+                    .map(item => `/${item.name.padEnd(12)} ${item.description}`);
+                const dsh = (this.ctx.get('commands')?.list(this.agent) ?? [])
+                    .map(item => `/${item.name.padEnd(12)} ${item.description}  (dsh)`);
+                this.pushRow({
+                    kind: 'system',
+                    text: [
+                        ...local,
+                        ...dsh,
+                        '',
+                        'Enter while running steers the agent; Esc or Ctrl+C cancels the turn.',
+                    ].join('\n'),
+                });
+                break;
+            }
+            case 'quit':
+            case 'exit':
+                void this.requestExit(0);
+                break;
+            case 'model':
+                void this.runModelCommand().catch((error) => {
+                    if (error instanceof UserQuestionError) {
+                        this.pushRow({ kind: 'system', text: '模型选择已取消。' });
+                    }
+                    else {
+                        this.pushRow({ kind: 'error', text: `/model failed: ${errorChain(error)}` });
+                    }
+                    this.markDirty();
+                });
+                break;
+            case 'mode':
+                void this.runModeCommand().catch((error) => {
+                    if (error instanceof UserQuestionError) {
+                        this.pushRow({ kind: 'system', text: '模式选择已取消。' });
+                    }
+                    else {
+                        this.pushRow({ kind: 'error', text: `/mode failed: ${errorChain(error)}` });
+                    }
+                    this.markDirty();
+                });
+                break;
+            case 'clear':
+                this.rows.length = 0;
+                this.streaming = undefined;
+                break;
+            case 'status':
+                this.pushRow({
+                    kind: 'system',
+                    text: `session: ${this.agent.id}\nmodel: ${this.agent.options.model ?? 'default'}\nprovider: ${this.agent.options.provider ?? 'default'}\nstatus: ${this.agent.status}`,
+                });
+                break;
+            case 'usage':
+            case 'quota':
+                void this.runUsageCommand().catch((error) => {
+                    this.pushRow({ kind: 'error', text: `/${command} failed: ${errorChain(error)}` });
+                    this.markDirty();
+                });
+                break;
+            case 'subagents': {
+                if (this.activeSubagents.size === 0) {
+                    this.pushRow({ kind: 'system', text: '当前没有活动的子代理。' });
+                }
+                else {
+                    const lines = [...this.activeSubagents.entries()].map(([runId, sub]) => `▶ ${sub.id}（${sub.provider}）运行 ${Math.floor((Date.now() - sub.startedAt) / 1000)}s  [${runId.slice(0, 8)}]`);
+                    this.pushRow({ kind: 'system', text: lines.join('\n') });
+                }
+                break;
+            }
+            case 'resume':
+                void this.runResumeCommand(arg).catch((error) => {
+                    if (error instanceof UserQuestionError) {
+                        this.pushRow({ kind: 'system', text: '会话选择已取消。' });
+                    }
+                    else {
+                        this.pushRow({ kind: 'error', text: `/resume failed: ${errorChain(error)}` });
+                    }
+                    this.markDirty();
+                });
+                break;
+            case 'setup':
+                void this.runOnboarding();
+                break;
+            case 'dialog-test': {
+                const questions = this.ctx.get('userQuestions');
+                if (questions === undefined) {
+                    this.pushRow({ kind: 'error', text: 'userQuestions service is unavailable' });
+                    break;
+                }
+                void questions.ask({
+                    questions: [{
+                            id: 'tui-test',
+                            question: 'Choose an option to verify the dialog',
+                            options: [{ label: 'Option A' }, { label: 'Option B' }],
+                        }],
+                    agent: this.agent,
+                }).then((answer) => this.pushRow({ kind: 'system', text: `dialog answer: ${JSON.stringify(answer)}` }), (error) => this.pushRow({ kind: 'error', text: `dialog error: ${errorChain(error)}` }));
+                break;
+            }
+            default:
+                {
+                    const commands = this.ctx.get('commands');
+                    if (commands === undefined) {
+                        this.pushRow({ kind: 'error', text: `Unknown command: /${command} (try /help)` });
+                        break;
+                    }
+                    const controller = new AbortController();
+                    void commands.execute(this.agent, text, controller.signal).then((execution) => {
+                        if (execution === undefined) {
+                            this.pushRow({ kind: 'error', text: `Unknown command: /${command} (try /help)` });
+                            return;
+                        }
+                        const result = execution.result;
+                        if (result.kind === 'success') {
+                            if (result.text !== undefined && result.text !== '') {
+                                this.pushRow({ kind: 'system', text: result.text });
+                            }
+                        }
+                        else {
+                            this.pushRow({ kind: 'error', text: result.text });
+                        }
+                    }).catch((error) => {
+                        this.pushRow({ kind: 'error', text: `/${command} failed: ${errorChain(error)}` });
+                    });
+                }
+                break;
+        }
+        this.input = '';
+        this.cursor = 0;
+        this.inputFolded = false;
+        this.markDirty();
+    }
+    backspace() {
+        if (this.cursor === 0)
+            return;
+        this.input = `${this.input.slice(0, this.cursor - 1)}${this.input.slice(this.cursor)}`;
+        this.cursor -= 1;
+        this.markDirty();
+    }
+    deleteAtCursor() {
+        if (this.cursor >= this.input.length)
+            return;
+        this.input = `${this.input.slice(0, this.cursor)}${this.input.slice(this.cursor + 1)}`;
+        this.markDirty();
+    }
+    moveCursor(delta) {
+        this.cursor = Math.max(0, Math.min(this.input.length, this.cursor + delta));
+        this.markDirty();
+    }
+    historyBack() {
+        if (this.history.length === 0)
+            return;
+        if (this.historyIndex <= 0)
+            return;
+        this.historyIndex -= 1;
+        this.input = this.history[this.historyIndex] ?? '';
+        this.cursor = this.input.length;
+        this.markDirty();
+    }
+    historyForward() {
+        if (this.historyIndex >= this.history.length)
+            return;
+        this.historyIndex += 1;
+        this.input = this.history[this.historyIndex] ?? '';
+        this.cursor = this.input.length;
+        this.markDirty();
+    }
+}
+function optionsLength(dialog) {
+    return dialog.kind === 'questions' ? dialog.question.options?.length ?? 0 : 0;
+}
+function envRefForId(providerId) {
+    return `${providerId.replaceAll('-', '_').toUpperCase()}_API_KEY`;
+}
+function collectText(blocks) {
+    const parts = [];
+    for (const block of blocks) {
+        if (block.type === 'text' && block.text !== undefined)
+            parts.push(block.text);
+        else if (block.type === 'tool-result' && block.content !== undefined)
+            parts.push(collectText(block.content));
+    }
+    return parts.join('\n');
+}
+/**
+ * Mount the terminal channel once the configured agent exists.
+ *
+ * @param ctx - context supplying the agent registry, sessions, and event stream.
+ * @param config - target agent and presentation config.
+ * @returns lifecycle controller used by the Cordis effect disposer.
+ */
+export function mountTui(ctx, config) {
+    const sessionId = SessionId(config.sessionId);
+    let settled = false;
+    let controller;
+    const start = (agent) => {
+        if (settled || agent.id !== sessionId || !ctx.agents.roots().includes(agent))
+            return;
+        settled = true;
+        stopWaiting();
+        controller = new SshTui(ctx, agent, config);
+        controller.start();
+        controller.replayHistory();
+    };
+    const fail = (failedSessionId, error) => {
+        if (settled || failedSessionId !== sessionId)
+            return;
+        settled = true;
+        stopWaiting();
+        process.stdout.write(`dsh-ssh-tui: session "${sessionId}" failed to start: ${errorChain(error)}\n`);
+        const exit = ctx.get('appExit');
+        if (exit !== undefined)
+            exit(1);
+        else
+            process.exit(1);
+    };
+    const disposeCreated = ctx.on('agent/created', ({ agent }) => start(agent));
+    const disposeFailure = ctx.on('agent-loop/config-start-failed', ({ sessionId: failedSessionId, error }) => fail(failedSessionId, error));
+    const stopWaiting = () => {
+        disposeCreated();
+        disposeFailure();
+    };
+    const existing = ctx.agents.roots().find(agent => agent.id === sessionId);
+    if (existing !== undefined)
+        start(existing);
+    return {
+        async dispose() {
+            stopWaiting();
+            await controller?.dispose();
+        },
+    };
+}
+//# sourceMappingURL=tui.js.map