@steerable/agent-cli 0.6.60 → 0.6.61

package/dist/tui/session.js

@@ -1,7 +1,25 @@
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
 import { getKeybindings } from '@earendil-works/pi-tui';
 import { listBusyChatIds } from '@steerable/agent-client';
+import { saveAttachmentFiles } from '@steerable/agent-shell/attachments';
+import { applyChildEvent, childLines } from './children.js';
+import { readSystemClipboard, saveClipboardImage, writeSystemClipboard } from './clipboard.js';
+import { completeSlash, slashAt } from './commands.js';
+import { clearDraft, createDraft, editDraft, insertText } from './editor.js';
+import { attachmentMessage, completeFiles, isImagePath, mentionAt, } from './files.js';
+import { markdownChat } from './export-chat.js';
 import { ensureAgentKeybindings } from './keys.js';
+import { createPromptHistory, leavePromptHistory, onFirstLine, onLastLine, recallPrompt, rememberPrompt, } from './prompt-history.js';
 import { renderScreen } from './screen.js';
+import { searchHits, searchLabel } from './search.js';
+import { transcriptEdge } from './scroll.js';
+import { todosFromAction } from './todos.js';
+import { historyRows, toolOutput, toolStatus } from './transcript.js';
+import { formatUsage } from './usage.js';
 export class AgentTui {
     client;
     options;
@@ -16,7 +34,24 @@ export class AgentTui {
     ask = null;
     readOnly = false;
     help = false;
-    draft = '';
+    buffer = createDraft();
+    prompts = createPromptHistory();
+    paste = null;
+    picks = null;
+    pickIndex = 0;
+    pickGeneration = 0;
+    attachments = [];
+    queue = [];
+    sending = false;
+    search = null;
+    scroll = null;
+    panel = null;
+    mode = 'agent';
+    permission = 'ask';
+    todos = [];
+    liveGeneration = 0;
+    children = [];
+    cwd;
     status = '';
     stopped = false;
     turnAbort = null;
@@ -24,6 +59,7 @@ export class AgentTui {
     constructor(client, options) {
         this.client = client;
         this.options = options;
+        this.cwd = options.cwd ?? process.cwd();
         ensureAgentKeybindings();
     }
     async open() {
@@ -51,15 +87,36 @@ export class AgentTui {
         return this.screen();
     }
     handleInput(data) {
-        if (data.length > 1 && !data.includes('\x1b')) {
-            for (const char of data)
-                this.handleInput(char);
+        this.applyInput(data);
+        this.touch();
+        this.scroll = null;
+    }
+    applyInput(data) {
+        if (this.paste !== null || data.includes('\x1b[200~')) {
+            if (!this.composing())
+                this.paste = null;
+            else
+                this.consumePaste(data);
+            return;
+        }
+        const chars = [...data];
+        if (chars.length > 1 && !data.includes('\x1b')) {
+            for (let index = 0; index < chars.length; index += 1) {
+                const char = chars[index] ?? '';
+                if (char === '\r' && chars[index + 1] === '\n') {
+                    this.applyInput('\r');
+                    index += 1;
+                    continue;
+                }
+                this.applyInput(char);
+            }
             return;
         }
         const keys = getKeybindings();
         if (keys.matches(data, 'agent.interrupt')) {
             if (this.turnAbort && !this.turnAbort.signal.aborted) {
                 this.turnAbort.abort();
+                this.queue = [];
                 this.status = '已中断';
                 return;
             }
@@ -108,28 +165,164 @@ export class AgentTui {
             this.showChats();
             return;
         }
+        if (keys.matches(data, 'agent.tool.toggle')) {
+            this.toggleFold();
+            return;
+        }
+        const edge = this.composing() ? transcriptEdge(data) : null;
+        if (edge) {
+            this.scroll = edge;
+            return;
+        }
+        if (this.search && this.composing() && this.editSearch(data))
+            return;
+        if (this.composing() && keys.matches(data, 'tui.altScreen.search')) {
+            this.search = { query: '', index: 0 };
+            this.panel = null;
+            this.picks = null;
+            return;
+        }
+        if (this.panel && keys.matches(data, 'tui.select.cancel')) {
+            this.panel = null;
+            return;
+        }
+        if (this.composing() && keys.matches(data, 'agent.queue.pull')) {
+            this.pullQueue();
+            return;
+        }
+        if (this.composing() && keys.matches(data, 'agent.copy.reply')) {
+            void this.copyReply();
+            return;
+        }
+        if (this.composing() && keys.matches(data, 'agent.editor')) {
+            void this.editDraftExternal();
+            return;
+        }
         if (this.ask && keys.matches(data, 'tui.input.submit')) {
             const requestId = this.ask.requestId;
-            const answer = this.draft;
-            this.draft = '';
+            const answer = this.buffer.text;
+            clearDraft(this.buffer);
             this.ask = null;
             void this.client.answerAsk(requestId, { text: answer });
             return;
         }
-        if (keys.matches(data, 'tui.input.newLine')) {
-            this.draft += '\n';
+        if (this.picks && keys.matches(data, 'tui.select.cancel')) {
+            this.picks = null;
+            return;
+        }
+        if (this.picks && keys.matches(data, 'tui.input.tab')) {
+            this.acceptPick();
+            return;
+        }
+        if (this.picks && keys.matches(data, 'tui.select.confirm')) {
+            const pick = this.picks[this.pickIndex];
+            if (!pick || this.buffer.text.trim() !== pick.insert.trim()) {
+                this.acceptPick();
+                return;
+            }
+        }
+        if (this.picks && keys.matches(data, 'tui.select.up')) {
+            this.pickIndex = Math.max(0, this.pickIndex - 1);
+            this.markPicks();
+            return;
+        }
+        if (this.picks && keys.matches(data, 'tui.select.down')) {
+            this.pickIndex = Math.min(this.picks.length - 1, this.pickIndex + 1);
+            this.markPicks();
+            return;
+        }
+        if (keys.matches(data, 'tui.editor.deleteCharBackward')
+            && this.buffer.text.length === 0
+            && this.buffer.cursor === 0
+            && this.attachments.length > 0) {
+            this.attachments.pop();
+            return;
+        }
+        if (this.composing() && keys.matches(data, 'agent.clipboard.paste')) {
+            void this.pasteClipboard();
             return;
         }
-        if (keys.matches(data, 'tui.input.submit')) {
+        if (this.browseHistory(data))
+            return;
+        const edited = editDraft(this.buffer, data);
+        if (edited === 'submit') {
             void this.submit();
             return;
         }
-        if (keys.matches(data, 'tui.editor.deleteCharBackward')) {
-            this.draft = [...this.draft].slice(0, -1).join('');
+        if (edited === 'edited')
+            leavePromptHistory(this.prompts);
+        this.refreshPicks();
+    }
+    async pasteClipboard() {
+        const read = this.options.readClipboard ?? readSystemClipboard;
+        let payload;
+        try {
+            payload = await read();
+        }
+        catch (error) {
+            void error;
+            this.status = '剪贴板不可用';
+            this.touch();
             return;
         }
-        if (data.length > 0 && [...data].every((char) => char >= ' ' && char !== '\x7f'))
-            this.draft += data;
+        const bytes = payload.image;
+        if (bytes && bytes.length > 0) {
+            const saved = await saveClipboardImage(bytes);
+            if (!saved) {
+                this.status = '剪贴板里的图片格式不支持';
+                this.touch();
+                return;
+            }
+            this.attachments.push(saved);
+            this.status = `已附加 ${saved.name}`;
+            this.touch();
+            return;
+        }
+        if (payload.text) {
+            insertText(this.buffer, payload.text);
+            this.refreshPicks();
+            this.touch();
+        }
+    }
+    browseHistory(data) {
+        if (!this.composing())
+            return false;
+        const keys = getKeybindings();
+        const previous = keys.matches(data, 'tui.editor.historyPrevious');
+        const next = keys.matches(data, 'tui.editor.historyNext');
+        const up = keys.matches(data, 'tui.editor.cursorUp') && onFirstLine(this.buffer.text, this.buffer.cursor);
+        const down = keys.matches(data, 'tui.editor.cursorDown')
+            && this.prompts.index >= 0
+            && onLastLine(this.buffer.text, this.buffer.cursor);
+        if (!previous && !next && !up && !down)
+            return false;
+        const direction = previous || up ? -1 : 1;
+        const moved = recallPrompt(this.prompts, this.buffer, direction);
+        if (!moved && !previous && !next)
+            return false;
+        this.picks = null;
+        return true;
+    }
+    composing() {
+        return !this.approval && !this.help && !this.chats;
+    }
+    consumePaste(data) {
+        let chunk = data;
+        if (this.paste === null) {
+            this.paste = '';
+            chunk = chunk.replaceAll('\x1b[200~', '');
+        }
+        this.paste += chunk;
+        const end = this.paste.indexOf('\x1b[201~');
+        if (end < 0)
+            return;
+        const text = this.paste.slice(0, end).replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+        const rest = this.paste.slice(end + '\x1b[201~'.length);
+        this.paste = null;
+        if (text.length > 0)
+            insertText(this.buffer, text);
+        if (rest.length > 0)
+            this.applyInput(rest);
     }
     screen() {
         return {
@@ -142,18 +335,145 @@ export class AgentTui {
             chats: this.chats,
             readOnly: this.readOnly,
             help: this.help,
-            draft: this.draft,
+            draft: this.buffer.text,
+            cursor: this.buffer.cursor,
             status: this.status,
+            picks: this.pickRows(),
+            attachments: this.attachments.map((file) => file.name),
+            children: this.children,
+            queued: this.queue.map((item) => item.text || item.files.map((file) => file.name).join(' ')),
+            search: this.searchBar().label,
+            searchFocus: this.searchBar().focus,
+            scroll: this.scroll,
+            panel: this.panel,
+            mode: this.mode,
+            permission: this.permission,
+            todos: this.todos,
+        };
+    }
+    searchBar() {
+        if (!this.search)
+            return { label: null, focus: null };
+        const hits = searchHits(this.lines, this.search.query);
+        const index = hits.length === 0 ? 0 : this.search.index % hits.length;
+        return {
+            label: searchLabel(this.search.query, hits, index),
+            focus: hits[index]?.line ?? null,
         };
     }
+    editSearch(data) {
+        if (!this.search)
+            return false;
+        const keys = getKeybindings();
+        if (keys.matches(data, 'tui.altScreen.search') || keys.matches(data, 'tui.altScreen.searchClose')) {
+            this.search = null;
+            return true;
+        }
+        const hits = searchHits(this.lines, this.search.query);
+        if (keys.matches(data, 'tui.altScreen.searchNext')) {
+            if (hits.length > 0)
+                this.search.index = (this.search.index + 1) % hits.length;
+            return true;
+        }
+        if (keys.matches(data, 'tui.altScreen.searchPrevious')) {
+            if (hits.length > 0)
+                this.search.index = (this.search.index - 1 + hits.length) % hits.length;
+            return true;
+        }
+        if (keys.matches(data, 'tui.editor.deleteCharBackward')) {
+            this.search.query = [...this.search.query].slice(0, -1).join('');
+            this.search.index = 0;
+            return true;
+        }
+        if ([...data].length === 1 && data >= ' ' && !data.includes('\x1b')) {
+            this.search.query += data;
+            this.search.index = 0;
+            return true;
+        }
+        return false;
+    }
+    pullQueue() {
+        const item = this.queue.pop();
+        if (!item)
+            return;
+        if (this.buffer.text.length > 0) {
+            this.queue.push(item);
+            this.status = '输入框里还有字';
+            return;
+        }
+        this.buffer.text = item.text;
+        this.buffer.cursor = [...item.text].length;
+        this.attachments.push(...item.files);
+        this.status = '已取回';
+    }
+    pickRows() {
+        if (!this.picks || this.picks.length === 0)
+            return null;
+        return this.picks.map((pick, index) => ({ label: pick.label, selected: index === this.pickIndex }));
+    }
+    markPicks() {
+        if (!this.picks)
+            return;
+        if (this.pickIndex >= this.picks.length)
+            this.pickIndex = Math.max(0, this.picks.length - 1);
+    }
+    refreshPicks() {
+        if (!this.composing()) {
+            this.picks = null;
+            return;
+        }
+        const slash = slashAt(this.buffer.text, this.buffer.cursor);
+        if (slash) {
+            this.pickGeneration += 1;
+            const commands = completeSlash(slash.query);
+            this.picks = commands.length > 0 ? commands : null;
+            this.markPicks();
+            return;
+        }
+        const token = mentionAt(this.buffer.text, this.buffer.cursor);
+        if (!token) {
+            this.picks = null;
+            return;
+        }
+        const generation = ++this.pickGeneration;
+        const query = token.query;
+        void completeFiles(this.cwd, query).then((files) => {
+            if (generation !== this.pickGeneration)
+                return;
+            if (!mentionAt(this.buffer.text, this.buffer.cursor))
+                return;
+            this.picks = files.length > 0 ? files : [{ label: '无匹配', insert: '', directory: false }];
+            this.markPicks();
+            this.touch();
+        });
+    }
+    acceptPick() {
+        const pick = this.picks?.[this.pickIndex];
+        const token = slashAt(this.buffer.text, this.buffer.cursor) ?? mentionAt(this.buffer.text, this.buffer.cursor);
+        if (!pick?.insert || !token) {
+            this.picks = null;
+            return;
+        }
+        const next = `${this.buffer.text.slice(0, token.start)}${pick.insert}${this.buffer.text.slice(this.buffer.cursor)}`;
+        this.buffer.text = next;
+        this.buffer.cursor = token.start + pick.insert.length;
+        if (pick.directory)
+            this.refreshPicks();
+        else
+            this.picks = null;
+    }
     showChats() {
         const index = this.rows.findIndex((chat) => chat.id === this.chatId);
         this.selected = index >= 0 ? index : 0;
         this.chats = this.rows.map((chat, row) => ({ ...chat, selected: row === this.selected }));
         void this.loadChats().then((rows) => {
             this.rows = rows;
-            if (this.chats)
-                this.markSelection();
+            if (!this.chats)
+                return;
+            if (this.selected >= rows.length)
+                this.selected = Math.max(0, rows.length - 1);
+            this.chats = rows.map((chat, row) => ({ ...chat, selected: row === this.selected }));
+            this.touch();
         });
     }
     async loadChats() {
@@ -184,17 +504,31 @@ export class AgentTui {
         const records = messages.status === 200
             ? (messages.data.messages ?? [])
             : [];
-        this.lines = records.map((message) => ({
-            kind: message.role === 'user' ? 'user' : 'assistant',
-            text: message.content ?? '',
-        }));
+        this.todos = [];
+        this.lines = historyRows(records).map((row) => {
+            if (row.kind !== 'tool')
+                return { kind: row.kind, text: row.text };
+            const next = todosFromAction(row.action.tool, row.action.arguments, row.action.result);
+            if (next)
+                this.todos = next;
+            return toolLine(row.action);
+        });
         this.help = false;
+        this.search = null;
+        this.panel = null;
+        this.children = [];
+        this.picks = null;
+        this.attachments = [];
         this.touch();
+        this.armLive(id);
     }
     async submit() {
-        const text = this.draft.trim();
-        this.draft = '';
-        if (!text)
+        const text = this.buffer.text.trim();
+        clearDraft(this.buffer);
+        this.picks = null;
+        if (text)
+            rememberPrompt(this.prompts, text);
+        if (!text && this.attachments.length === 0)
             return;
         if (text.startsWith('/')) {
             await this.slash(text);
@@ -204,10 +538,50 @@ export class AgentTui {
             this.status = '只读 · 另一个进程正在运行';
             return;
         }
-        this.lines.push({ kind: 'user', text });
-        this.pending = this.runTurn(text);
+        if (this.permission === 'read') {
+            this.status = '权限 只读';
+            this.touch();
+            return;
+        }
+        const files = this.attachments.splice(0);
+        if (this.sending) {
+            this.queue.push({ text, files });
+            this.touch();
+            return;
+        }
+        this.sending = true;
+        try {
+            await this.sendPrepared(text, files);
+            while (!this.stopped && this.queue.length > 0) {
+                const next = this.queue.shift();
+                if (!next)
+                    break;
+                await this.sendPrepared(next.text, next.files);
+            }
+        }
+        finally {
+            this.sending = false;
+            this.touch();
+        }
+    }
+    async sendPrepared(text, files) {
+        const prepared = await this.prepareOwned(text, files);
+        this.lines.push({ kind: 'user', text: prepared.message });
+        this.touch();
+        this.pending = this.runTurn(prepared.message, prepared.images);
         await this.pending;
     }
+    async prepareOwned(text, files) {
+        const added = this.attachments.splice(0);
+        this.attachments = files;
+        try {
+            return await this.prepareMessage(text);
+        }
+        finally {
+            const failed = this.attachments;
+            this.attachments = [...added, ...failed];
+        }
+    }
     async slash(text) {
         const [command, ...rest] = text.slice(1).split(/\s+/);
         if (command === 'help') {
@@ -215,6 +589,10 @@ export class AgentTui {
             this.touch();
             return;
         }
+        if (command === 'attach') {
+            await this.attach(rest.join(' '));
+            return;
+        }
         if (command === 'clear') {
             this.lines = [];
             this.status = '';
@@ -249,31 +627,179 @@ export class AgentTui {
             this.touch();
             return;
         }
+        if (command === 'status') {
+            const summary = await this.client.request('GET', '/api/v2/usage/summary', undefined);
+            this.status = summary.status === 200 ? formatUsage(summary.data) : '用量不可用';
+            this.touch();
+            return;
+        }
+        if (command === 'skills') {
+            await this.showList('GET', '/api/v2/chat-agents/skills', 'skills', (row) => `技能 ${textField(row, 'name')}${textField(row, 'description') ? `  ${textField(row, 'description')}` : ''}`, '没有技能');
+            return;
+        }
+        if (command === 'mcp') {
+            await this.showList('GET', '/api/v2/mcp/servers', 'servers', (row) => `MCP ${textField(row, 'name') || textField(row, 'id')}  ${numberField(row, 'toolCount')} 个工具`, '没有 MCP');
+            return;
+        }
+        if (command === 'export') {
+            await this.exportChat();
+            return;
+        }
+        if (command === 'compact') {
+            await this.compactChat();
+            return;
+        }
+        if (command === 'plan') {
+            this.mode = this.mode === 'plan' ? 'agent' : 'plan';
+            this.status = this.mode === 'plan' ? '计划模式' : '对话模式';
+            this.touch();
+            return;
+        }
+        if (command === 'tasks') {
+            await this.showTasks();
+            return;
+        }
+        if (command === 'fork') {
+            await this.forkChat();
+            return;
+        }
+        if (command === 'rewind') {
+            await this.rewindChat();
+            return;
+        }
+        if (command === 'permissions') {
+            this.permission = this.permission === 'ask' ? 'auto' : this.permission === 'auto' ? 'read' : 'ask';
+            this.status = this.permission === 'ask' ? '权限 询问' : this.permission === 'auto' ? '权限 本会话自动' : '权限 只读';
+            this.touch();
+            return;
+        }
+        if (command === 'copy') {
+            await this.copyReply();
+            return;
+        }
+        if (command === 'editor') {
+            await this.editDraftExternal();
+            return;
+        }
         this.status = `unknown command /${command}`;
         this.touch();
     }
-    async runTurn(text) {
-        if (!this.chatId) {
-            const created = await this.client.request('POST', '/api/v2/chats/new', {});
-            this.chatId = created.data.chatId ?? 'draft';
-            this.title = this.chatId;
+    async attach(target) {
+        if (this.readOnly) {
+            this.status = '只读 · 另一个进程正在运行';
+            this.touch();
+            return;
+        }
+        if (!target) {
+            this.status = this.attachments.length > 0
+                ? this.attachments.map((file) => file.name).join('  ')
+                : '用法 /attach <路径>';
             this.touch();
+            return;
         }
+        const full = path.resolve(this.cwd, target);
+        let fileStat;
+        try {
+            fileStat = await fs.stat(full);
+        }
+        catch {
+            this.status = '找不到文件';
+            this.touch();
+            return;
+        }
+        if (!fileStat.isFile()) {
+            this.status = '不是文件';
+            this.touch();
+            return;
+        }
+        const name = path.basename(full);
+        this.attachments.push({ name, path: full });
+        this.status = `已附加 ${name}`;
+        this.touch();
+    }
+    async prepareMessage(text) {
+        if (this.attachments.length === 0)
+            return { message: text, images: [] };
+        await this.ensureChat();
+        const chatId = this.chatId ?? '';
+        const save = this.options.saveAttachments ?? defaultSaveAttachments;
+        const saved = await save(chatId, this.attachments);
+        const stored = [];
+        const kept = [];
+        saved.forEach((file, index) => {
+            if (file.path && !file.error)
+                stored.push(file);
+            else {
+                const original = this.attachments[index];
+                if (original)
+                    kept.push(original);
+            }
+        });
+        this.attachments = kept;
+        if (kept.length > 0) {
+            this.status = saved.filter((file) => file.error).map((file) => file.error).join(' ');
+        }
+        return {
+            message: attachmentMessage(text, stored),
+            images: stored.filter((file) => isImagePath(file.path)).map((file) => ({ path: file.path, name: file.name })),
+        };
+    }
+    async ensureChat() {
+        if (this.chatId)
+            return;
+        const created = await this.client.request('POST', '/api/v2/chats/new', {});
+        this.chatId = created.data.chatId ?? 'draft';
+        this.title = this.chatId;
+    }
+    async runTurn(text, images = []) {
+        await this.ensureChat();
+        if (!this.chatId)
+            return;
         const controller = new AbortController();
         this.turnAbort = controller;
+        this.children = [];
         this.status = '';
         try {
-            for await (const event of this.client.stream(`/api/v2/chats/${encodeURIComponent(this.chatId)}/send`, { message: text }, controller.signal)) {
+            const payload = { message: text };
+            if (images.length > 0)
+                payload.images = images;
+            if (this.mode === 'plan')
+                payload.mode = 'plan';
+            for await (const event of this.client.stream(`/api/v2/chats/${encodeURIComponent(this.chatId)}/send`, payload, controller.signal)) {
                 this.observe(event, controller.signal);
                 this.touch();
             }
         }
         finally {
+            for (const line of this.lines)
+                line.streaming = false;
+            if (this.children.length > 0) {
+                for (const line of childLines(this.children))
+                    this.lines.push({ kind: 'tree', text: line });
+                this.children = [];
+                this.touch();
+            }
+            if (controller.signal.aborted)
+                this.queue = [];
             if (this.turnAbort === controller)
                 this.turnAbort = null;
         }
     }
     observe(event, signal) {
+        if (String(event.type) === 'executed_actions' && Array.isArray(event.actions)) {
+            this.applyActions(event.actions);
+            return;
+        }
+        if (String(event.type) === 'orchestration_child') {
+            this.children = applyChildEvent(this.children, {
+                kind: event.kind,
+                childId: event.childId,
+                task: event.task,
+                profile: event.profile,
+                depth: event.depth,
+            });
+            return;
+        }
         if (event.type === 'tool_call') {
             const payload = event.payload ?? {};
             const name = typeof payload.name === 'string' ? payload.name : 'tool';
@@ -287,12 +813,26 @@ export class AgentTui {
                 tool.status = '✓';
             return;
         }
+        if (String(event.type) === 'reasoning' && typeof event.content === 'string') {
+            const last = this.lines[this.lines.length - 1];
+            if (last?.kind === 'reasoning') {
+                last.text = `${last.text ?? ''}${event.content}`;
+                last.streaming = true;
+            }
+            else {
+                this.lines.push({ kind: 'reasoning', text: event.content, streaming: true });
+            }
+            return;
+        }
         if (event.type === 'content' && typeof event.content === 'string') {
             const last = this.lines[this.lines.length - 1];
-            if (last?.kind === 'assistant')
+            if (last?.kind === 'assistant') {
                 last.text = `${last.text ?? ''}${event.content}`;
-            else
-                this.lines.push({ kind: 'assistant', text: event.content });
+                last.streaming = true;
+            }
+            else {
+                this.lines.push({ kind: 'assistant', text: event.content, streaming: true });
+            }
             return;
         }
         if (event.type === 'error' && !signal.aborted) {
@@ -307,6 +847,11 @@ export class AgentTui {
                 const payload = event.payload;
                 if (!payload.requestId)
                     continue;
+                if (this.permission === 'auto') {
+                    void this.client.decideApproval(payload.requestId, 'allow_for_session');
+                    this.touch();
+                    continue;
+                }
                 this.approval = {
                     requestId: payload.requestId,
                     toolName: payload.toolName || 'tool',
@@ -321,6 +866,196 @@ export class AgentTui {
             this.touch();
         }
     }
+    applyActions(actions) {
+        for (const action of actions) {
+            if (!action || typeof action !== 'object')
+                continue;
+            const nextTodos = todosFromAction(action.tool, action.arguments, action.result);
+            if (nextTodos)
+                this.todos = nextTodos;
+            const next = toolLine(action);
+            const index = next.id
+                ? this.lines.findIndex((line) => line.kind === 'tool' && line.id === next.id)
+                : -1;
+            if (index >= 0) {
+                next.open = this.lines[index]?.open;
+                this.lines[index] = next;
+            }
+            else {
+                this.lines.push(next);
+            }
+        }
+    }
+    toggleFold() {
+        const open = this.lines.find((line) => (line.kind === 'tool' || line.kind === 'reasoning') && line.open);
+        if (open) {
+            open.open = false;
+            return;
+        }
+        for (let index = this.lines.length - 1; index >= 0; index -= 1) {
+            const line = this.lines[index];
+            if (line?.kind === 'tool' && line.status !== '…') {
+                line.open = true;
+                return;
+            }
+            if (line?.kind === 'reasoning' && (line.text ?? '').length > 0) {
+                line.open = true;
+                return;
+            }
+        }
+    }
+    armLive(chatId) {
+        const generation = ++this.liveGeneration;
+        void this.pollLive(chatId, generation);
+    }
+    async pollLive(chatId, generation) {
+        if (this.stopped || this.chatId !== chatId || generation !== this.liveGeneration)
+            return;
+        const live = await this.client.request('GET', `/api/v2/chats/${encodeURIComponent(chatId)}/live-stream`, undefined);
+        if (this.stopped || this.chatId !== chatId || generation !== this.liveGeneration)
+            return;
+        if (live.status !== 200 || !live.data || typeof live.data !== 'object')
+            return;
+        const data = live.data;
+        if (data.active !== true) {
+            if (this.status === '运行中')
+                this.status = '';
+            this.touch();
+            return;
+        }
+        this.status = '运行中';
+        if (typeof data.content === 'string' && data.content.length > 0) {
+            const streaming = [...this.lines].reverse().find((line) => line.kind === 'assistant' && line.streaming);
+            if (streaming)
+                streaming.text = data.content;
+            else if (!this.lines.some((line) => line.kind === 'assistant' && line.text === data.content)) {
+                this.lines.push({ kind: 'assistant', text: data.content, streaming: true });
+            }
+        }
+        if (Array.isArray(data.executedActions))
+            this.applyActions(data.executedActions);
+        this.touch();
+        const wait = this.options.liveIntervalMs ?? 1000;
+        await new Promise((resolve) => {
+            setTimeout(resolve, wait);
+        });
+        await this.pollLive(chatId, generation);
+    }
+    async showList(method, requestPath, key, format, empty) {
+        const listed = await this.client.request(method, requestPath, undefined);
+        const rows = listed.status === 200 && listed.data && typeof listed.data === 'object'
+            ? listed.data[key]
+            : [];
+        const lines = Array.isArray(rows)
+            ? rows.filter((row) => !!row && typeof row === 'object').map(format)
+            : [];
+        this.panel = lines.length > 0 ? lines : [empty];
+        this.touch();
+    }
+    async showTasks() {
+        if (!this.chatId) {
+            this.status = '还没有会话';
+            this.touch();
+            return;
+        }
+        const listed = await this.client.request('GET', `/api/v2/chats/${encodeURIComponent(this.chatId)}/tasks`, undefined);
+        const rows = listed.status === 200 && listed.data && typeof listed.data === 'object'
+            ? listed.data.tasks ?? []
+            : [];
+        this.panel = rows.length > 0
+            ? rows.map((task) => `后台 ${task.task ?? ''}  ${taskStatus(task.status)}`)
+            : ['没有后台任务'];
+        this.touch();
+    }
+    async exportChat() {
+        const messages = this.lines
+            .filter((line) => line.kind === 'user' || line.kind === 'assistant')
+            .map((line) => ({ role: line.kind, content: line.text ?? '' }));
+        const file = path.join(this.options.exportDir ?? os.tmpdir(), `${this.chatId ?? 'chat'}.md`);
+        await fs.writeFile(file, markdownChat(this.title, messages));
+        this.status = `已导出 ${file}`;
+        this.touch();
+    }
+    async compactChat() {
+        if (!this.chatId)
+            return;
+        const result = await this.client.request('POST', `/api/v2/chats/${encodeURIComponent(this.chatId)}/compact`, {});
+        const compacted = result.status === 200 ? numberField(result.data, 'compacted') : 0;
+        if (result.status !== 200) {
+            this.status = '压缩失败';
+            this.touch();
+            return;
+        }
+        if (compacted === 0) {
+            this.status = '没有可压缩的记录';
+            this.touch();
+            return;
+        }
+        await this.openChat(this.chatId);
+        this.status = `已压缩 ${compacted} 条`;
+        this.touch();
+    }
+    async forkChat() {
+        if (!this.chatId)
+            return;
+        const created = await this.client.request('POST', `/api/v2/chats/${encodeURIComponent(this.chatId)}/fork`, {});
+        const chatId = created.status === 200 ? textField(created.data, 'chatId') : '';
+        if (!chatId) {
+            this.status = '分叉失败';
+            this.touch();
+            return;
+        }
+        await this.openChat(chatId);
+        this.status = '已分叉';
+        this.touch();
+    }
+    async rewindChat() {
+        if (!this.chatId)
+            return;
+        const result = await this.client.request('POST', `/api/v2/chats/${encodeURIComponent(this.chatId)}/rewind`, {});
+        const removed = result.status === 200 ? numberField(result.data, 'removed') : 0;
+        if (result.status !== 200 || removed === 0) {
+            this.status = '没有可回退的回合';
+            this.touch();
+            return;
+        }
+        await this.openChat(this.chatId);
+        this.status = '已回退';
+        this.touch();
+    }
+    async copyReply() {
+        const text = [...this.lines].reverse().find((line) => line.kind === 'assistant' && (line.text ?? '').length > 0)?.text ?? '';
+        if (!text) {
+            this.status = '没有可复制的回答';
+            this.touch();
+            return;
+        }
+        const write = this.options.writeClipboard ?? writeSystemClipboard;
+        try {
+            await write(text);
+            this.status = '已复制';
+        }
+        catch (error) {
+            void error;
+            this.status = '剪贴板不可用';
+        }
+        this.touch();
+    }
+    async editDraftExternal() {
+        const edit = this.options.editInEditor ?? editWithEditor;
+        try {
+            const next = await edit(this.buffer.text);
+            this.buffer.text = next.replace(/\r\n/g, '\n');
+            this.buffer.cursor = [...this.buffer.text].length;
+            leavePromptHistory(this.prompts);
+            this.refreshPicks();
+        }
+        catch (error) {
+            void error;
+            this.status = '编辑器不可用';
+        }
+        this.touch();
+    }
     async decide(kind) {
         const request = this.approval;
         if (!request)
@@ -330,6 +1065,8 @@ export class AgentTui {
         await this.client.decideApproval(request.requestId, kind);
     }
     touch() {
+        if (this.stopped)
+            return;
         this.options.onChange?.();
     }
     exit() {
@@ -356,6 +1093,76 @@ function approvalKind(data) {
         return 'abort';
     return null;
 }
+async function defaultSaveAttachments(chatId, files) {
+    const saved = await saveAttachmentFiles(chatId, files);
+    return saved.files.map((file) => ({
+        name: file.name,
+        path: file.path,
+        ...(file.error ? { error: file.error } : {}),
+    }));
+}
+function toolLine(action) {
+    const name = typeof action.tool === 'string' && action.tool ? action.tool : 'tool';
+    const title = typeof action.view?.title === 'string' ? action.view.title : '';
+    return {
+        kind: 'tool',
+        id: typeof action.id === 'string' ? action.id : undefined,
+        name,
+        args: title && title !== name ? title : toolArgs(action.arguments),
+        status: toolStatus(action),
+        output: toolOutput(action),
+        ...(diffOf(action) ? { diff: diffOf(action) } : {}),
+    };
+}
+function diffOf(action) {
+    const result = action.result;
+    if (!result || typeof result !== 'object')
+        return undefined;
+    const diff = result.diff;
+    return typeof diff === 'string' && diff.length > 0 ? diff : undefined;
+}
+function textField(value, key) {
+    if (!value || typeof value !== 'object')
+        return '';
+    const field = value[key];
+    return typeof field === 'string' ? field : '';
+}
+function numberField(value, key) {
+    if (!value || typeof value !== 'object')
+        return 0;
+    const field = value[key];
+    return typeof field === 'number' && Number.isFinite(field) ? field : 0;
+}
+function taskStatus(status) {
+    if (status === 'running')
+        return '进行中';
+    if (status === 'completed')
+        return '完成';
+    if (status === 'failed')
+        return '失败';
+    if (status === 'blocked')
+        return '等待';
+    return status ?? '';
+}
+async function editWithEditor(text) {
+    const editor = process.env.VISUAL || process.env.EDITOR;
+    if (!editor)
+        throw new Error('editor unavailable');
+    const file = path.join(os.tmpdir(), `steerable-draft-${randomUUID().slice(0, 8)}.md`);
+    await fs.writeFile(file, text);
+    const code = await new Promise((resolve, reject) => {
+        const child = spawn(editor, [file], { stdio: 'inherit' });
+        child.on('error', reject);
+        child.on('exit', (status) => resolve(status ?? 1));
+    });
+    const next = await fs.readFile(file, 'utf8');
+    await fs.unlink(file).catch((error) => {
+        void error;
+    });
+    if (code !== 0)
+        throw new Error(`editor exited ${code}`);
+    return next;
+}
 function toolArgs(value) {
     if (typeof value === 'string')
         return value;