@steerable/agent-cli 0.6.62 → 0.6.64

package/README.md

@@ -1,3 +1,5 @@
 # @steerable/agent-cli
 
-Product-neutral command line for a Steerable host. Products wrap `createCli` and supply the bin name. Commands: `run`, `chat`, `skills`, `mcp`, `config`, and `doctor`.
+Product-neutral command line for a Steerable host. Products wrap `createCli` and supply the bin name. A bare invocation opens the TUI when stdin is a terminal; `tui` opens it explicitly. Other commands are `run`, `chat`, `skills`, `mcp`, `config`, and `doctor`.
+
+`pnpm test:tui` runs the deterministic renderer and interaction cases on every supported operating system. `pnpm test:tui:pty` runs the built TUI in a 100×32 tmux pane on Linux. Failed state waits write the visible frame, input trace, and environment metadata under `test-results/tui/`.

package/dist/cli.js

@@ -64,10 +64,8 @@ async function runCli(options) {
         stdout.write(`${rootHelp(packCommands)}\n`);
         return 0;
     }
-    if (!command) {
-        stderr.write(`${rootHelp(packCommands)}\n`);
-        return 2;
-    }
+    if (!command)
+        return tuiCommand(parsed, options, stdout, stderr);
     if (command === 'run')
         return runCommand(parsed, options, stdout, stderr);
     if (command === 'chat')

package/dist/tui/commands.js

@@ -10,6 +10,8 @@ const COMMANDS = [
     { name: 'export', hint: '导出会话' },
     { name: 'compact', hint: '压缩上下文' },
     { name: 'plan', hint: '计划模式' },
+    { name: 'goal', hint: '持续目标' },
+    { name: 'loop', hint: '循环执行' },
     { name: 'tasks', hint: '后台任务' },
     { name: 'fork', hint: '分叉' },
     { name: 'rewind', hint: '回退' },

package/dist/tui/run.d.ts

@@ -1,10 +1,14 @@
 import { type Terminal } from '@earendil-works/pi-tui';
+import type { CliRenderer } from '@opentui/core';
 import type { AgentClient } from '@steerable/agent-client';
-export declare function runTui(options: {
+export interface RunTuiOptions {
     client: AgentClient;
     product: string;
     dataDir?: string;
     terminal?: Terminal;
-}): Promise<number>;
+    fallbackTerminal?: Terminal;
+    openRenderer?: CliRenderer;
+}
+export declare function runTui(options: RunTuiOptions): Promise<number>;
 /** Terminal reports (capability replies, focus) must reach the renderer so Shift+Enter stays distinct from Enter. */
 export declare function yieldsToRenderer(sequence: string): boolean;

package/dist/tui/run.js

@@ -12,13 +12,18 @@ export async function runTui(options) {
     catch (error) {
         if (!openTuiUnavailable(error))
             throw error;
-        return runPlainTui(options);
+        return runPlainTui({
+            ...options,
+            ...(options.fallbackTerminal ? { terminal: options.fallbackTerminal } : {}),
+        });
     }
 }
 async function runOpenTui(options) {
-    const { createCliRenderer } = await import('@opentui/core');
+    const createCliRenderer = options.openRenderer
+        ? null
+        : (await import('@opentui/core')).createCliRenderer;
     const { OpenTuiView } = await import('./view.js');
-    const renderer = await createCliRenderer({
+    const renderer = options.openRenderer ?? await createCliRenderer({
         exitOnCtrlC: false,
         useMouse: false,
         consoleMode: 'disabled',
@@ -27,7 +32,7 @@ async function runOpenTui(options) {
         backgroundColor: '#16161e',
         targetFps: 30,
     });
-    return new Promise((resolve) => {
+    return new Promise((resolve, reject) => {
         const session = new AgentTui(options.client, {
             product: options.product,
             ...(options.dataDir ? { dataDir: options.dataDir } : {}),
@@ -51,13 +56,16 @@ async function runOpenTui(options) {
             session.handleInput(sequence);
             return true;
         });
-        void session.open().then(() => view.apply(session.snapshot()));
+        void session.open().then(() => view.apply(session.snapshot()), (error) => {
+            renderer.destroy();
+            reject(error);
+        });
     });
 }
 function runPlainTui(options) {
     const terminal = options.terminal ?? new ProcessTerminal();
     const tui = new TuiAltScreen(terminal);
-    return new Promise((resolve) => {
+    return new Promise((resolve, reject) => {
         const session = new AgentTui(options.client, {
             product: options.product,
             ...(options.dataDir ? { dataDir: options.dataDir } : {}),
@@ -71,7 +79,10 @@ function runPlainTui(options) {
         });
         tui.addChild(session);
         tui.setFocus(session);
-        void session.open().then(() => tui.requestRender());
+        void session.open().then(() => tui.requestRender(), (error) => {
+            tui.stop();
+            reject(error);
+        });
         tui.start();
     });
 }

package/dist/tui/screen.d.ts

@@ -53,6 +53,17 @@ export interface TuiScreen {
         content: string;
         status: 'pending' | 'in_progress' | 'completed';
     }>;
+    goal?: {
+        objective: string;
+        phase: 'active' | 'paused' | 'blocked' | 'complete';
+        turns: number;
+        blockedReason?: string;
+    } | null;
+    loops?: Array<{
+        id: string;
+        prompt: string;
+        intervalSeconds: number;
+    }>;
 }
 export declare function draftHint(): string;
 export declare function renderScreen(screen: TuiScreen, width: number): string[];

package/dist/tui/screen.js

@@ -59,6 +59,8 @@ export function helpLines() {
         '/export 导出会话',
         '/compact 压缩上下文',
         '/plan 计划模式',
+        '/goal <目标> 持续执行',
+        '/loop <间隔> <任务> 循环执行',
         '/tasks 后台任务',
         '/fork 分叉',
         '/rewind 回退',
@@ -151,6 +153,11 @@ function screenLines(screen) {
 export function bannerLines(screen) {
     const lines = [];
     if (!screen.help && !screen.chats) {
+        if (screen.goal)
+            lines.push(goalText(screen.goal));
+        if ((screen.loops?.length ?? 0) > 0) {
+            lines.push(`Loop · ${screen.loops.length} 个运行中`);
+        }
         for (const todo of screen.todos ?? [])
             lines.push(todoText(todo));
     }
@@ -164,6 +171,19 @@ export function bannerLines(screen) {
         lines.push(row);
     return lines;
 }
+function goalText(goal) {
+    const objective = goal.objective.length > 48
+        ? `${goal.objective.slice(0, 47)}…`
+        : goal.objective;
+    if (goal.phase === 'blocked') {
+        return `目标 · 阻塞 · ${objective}${goal.blockedReason ? ` · ${goal.blockedReason}` : ''}`;
+    }
+    if (goal.phase === 'paused')
+        return `目标 · 暂停 · ${objective}`;
+    if (goal.phase === 'complete')
+        return `目标 · 完成 · ${objective}`;
+    return `目标 · ${objective} · 第 ${goal.turns} 轮`;
+}
 function todoText(todo) {
     if (todo.status === 'completed')
         return `✓ ${todo.content}`;

package/dist/tui/session.d.ts

@@ -31,6 +31,7 @@ export declare class AgentTui implements Component {
     private chats;
     private selected;
     private approval;
+    private approvalSubmitting;
     private ask;
     private readOnly;
     private help;
@@ -49,6 +50,10 @@ export declare class AgentTui implements Component {
     private mode;
     private permission;
     private todos;
+    private goal;
+    private loops;
+    private backendTurnActive;
+    private loopExitArmed;
     private liveGeneration;
     private children;
     private readonly cwd;
@@ -81,9 +86,12 @@ export declare class AgentTui implements Component {
     private markSelection;
     private openChat;
     private submit;
+    private drainQueue;
     private sendPrepared;
     private prepareOwned;
     private slash;
+    private manageGoal;
+    private manageLoop;
     private attach;
     private prepareMessage;
     private ensureChat;
@@ -94,6 +102,9 @@ export declare class AgentTui implements Component {
     private toggleFold;
     private armLive;
     private pollLive;
+    private refreshGoal;
+    private refreshLoops;
+    private reloadMessages;
     private showList;
     private showTasks;
     private exportChat;

package/dist/tui/session.js

@@ -31,6 +31,7 @@ export class AgentTui {
     chats = null;
     selected = 0;
     approval = null;
+    approvalSubmitting = false;
     ask = null;
     readOnly = false;
     help = false;
@@ -49,6 +50,10 @@ export class AgentTui {
     mode = 'agent';
     permission = 'ask';
     todos = [];
+    goal = null;
+    loops = [];
+    backendTurnActive = false;
+    loopExitArmed = false;
     liveGeneration = 0;
     children = [];
     cwd;
@@ -128,6 +133,8 @@ export class AgentTui {
             return;
         }
         if (this.approval) {
+            if (this.approvalSubmitting)
+                return;
             const kind = approvalKind(data);
             if (kind)
                 void this.decide(kind);
@@ -349,6 +356,8 @@ export class AgentTui {
             mode: this.mode,
             permission: this.permission,
             todos: this.todos,
+            goal: this.goal,
+            loops: this.loops,
         };
     }
     searchBar() {
@@ -519,6 +528,8 @@ export class AgentTui {
         this.children = [];
         this.picks = null;
         this.attachments = [];
+        await this.refreshGoal(id);
+        await this.refreshLoops(id);
         this.touch();
         this.armLive(id);
     }
@@ -530,8 +541,14 @@ export class AgentTui {
             rememberPrompt(this.prompts, text);
         if (!text && this.attachments.length === 0)
             return;
-        if (text.startsWith('/')) {
-            await this.slash(text);
+        if (text.startsWith('/') && !isSkillFacadeCommand(text)) {
+            try {
+                await this.slash(text);
+            }
+            catch (error) {
+                this.status = `命令失败：${error instanceof Error ? error.message : String(error)}`;
+                this.touch();
+            }
             return;
         }
         if (this.readOnly) {
@@ -544,14 +561,18 @@ export class AgentTui {
             return;
         }
         const files = this.attachments.splice(0);
-        if (this.sending) {
-            this.queue.push({ text, files });
+        this.queue.push({ text, files });
+        if (this.sending || this.backendTurnActive) {
             this.touch();
             return;
         }
+        await this.drainQueue();
+    }
+    async drainQueue() {
+        if (this.sending || this.backendTurnActive)
+            return;
         this.sending = true;
         try {
-            await this.sendPrepared(text, files);
             while (!this.stopped && this.queue.length > 0) {
                 const next = this.queue.shift();
                 if (!next)
@@ -565,6 +586,7 @@ export class AgentTui {
         }
     }
     async sendPrepared(text, files) {
+        this.status = '';
         const prepared = await this.prepareOwned(text, files);
         this.lines.push({ kind: 'user', text: prepared.message });
         this.touch();
@@ -634,11 +656,11 @@ export class AgentTui {
             return;
         }
         if (command === 'skills') {
-            await this.showList('GET', '/api/v2/chat-agents/skills', 'skills', (row) => `技能 ${textField(row, 'name')}${textField(row, 'description') ? `  ${textField(row, 'description')}` : ''}`, '没有技能');
+            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');
+            await this.showList('GET', '/api/v2/mcp/servers', 'servers', (row) => `MCP ${textField(row, 'name') || textField(row, 'id')}  ${numberField(row, 'toolCount')} 个工具`, '没有 MCP', 'MCP 不可用');
             return;
         }
         if (command === 'export') {
@@ -655,6 +677,14 @@ export class AgentTui {
             this.touch();
             return;
         }
+        if (command === 'goal') {
+            await this.manageGoal(rest);
+            return;
+        }
+        if (command === 'loop') {
+            await this.manageLoop(rest);
+            return;
+        }
         if (command === 'tasks') {
             await this.showTasks();
             return;
@@ -684,6 +714,54 @@ export class AgentTui {
         this.status = `unknown command /${command}`;
         this.touch();
     }
+    async manageGoal(parts) {
+        if (!this.chatId) {
+            this.status = '还没有会话';
+            return;
+        }
+        if (parts.length === 0) {
+            await this.refreshGoal(this.chatId);
+            this.status = this.goal ? '' : '没有持续目标';
+            return;
+        }
+        const action = parts[0];
+        if (!['edit', 'pause', 'resume', 'complete', 'clear'].includes(action)) {
+            this.status = '用法 /goal [edit <目标>|pause|resume|complete|clear]';
+            return;
+        }
+        const objective = parts.slice(1).join(' ').trim();
+        if (action === 'edit' && !objective) {
+            this.status = '用法 /goal edit <目标>';
+            return;
+        }
+        const response = await this.client.request('POST', `/api/v2/chats/${encodeURIComponent(this.chatId)}/goal`, { action, ...(objective ? { objective } : {}) });
+        if (response.status !== 200) {
+            this.status = `目标操作失败 (${response.status})`;
+            return;
+        }
+        this.goal = response.data.goal ?? null;
+        this.status = '';
+    }
+    async manageLoop(parts) {
+        if (!this.chatId) {
+            this.status = '还没有会话';
+            return;
+        }
+        if (parts[0] === 'list') {
+            await this.refreshLoops(this.chatId);
+            this.panel = this.loops.length > 0
+                ? this.loops.map((loop) => `Loop ${loop.id}  每 ${loop.intervalSeconds} 秒  ${loop.prompt}`)
+                : ['没有运行中的 Loop'];
+            return;
+        }
+        if (parts[0] === 'stop' && parts[1]) {
+            const response = await this.client.request('DELETE', `/api/v2/chats/${encodeURIComponent(this.chatId)}/loops/${encodeURIComponent(parts[1])}`, undefined);
+            this.status = response.status === 200 ? 'Loop 已停止' : `停止 Loop 失败 (${response.status})`;
+            await this.refreshLoops(this.chatId);
+            return;
+        }
+        this.status = '用法 /loop list | /loop stop <id>';
+    }
     async attach(target) {
         if (this.readOnly) {
             this.status = '只读 · 另一个进程正在运行';
@@ -758,7 +836,6 @@ export class AgentTui {
         const controller = new AbortController();
         this.turnAbort = controller;
         this.children = [];
-        this.status = '';
         try {
             const payload = { message: text };
             if (images.length > 0)
@@ -770,6 +847,12 @@ export class AgentTui {
                 this.touch();
             }
         }
+        catch (error) {
+            if (!controller.signal.aborted) {
+                this.status = error instanceof Error ? error.message : String(error);
+                this.touch();
+            }
+        }
         finally {
             for (const line of this.lines)
                 line.streaming = false;
@@ -863,6 +946,32 @@ export class AgentTui {
                 if (payload.requestId)
                     this.ask = { requestId: payload.requestId, prompt: payload.prompt ?? '' };
             }
+            else if (event.channel === 'goal-changed') {
+                const payload = event.payload;
+                if (payload.chatId === this.chatId)
+                    this.goal = payload.goal ?? null;
+            }
+            else if (event.channel === 'loop-changed') {
+                const payload = event.payload;
+                if (payload.chatId === this.chatId)
+                    this.loops = payload.loops ?? [];
+            }
+            else if (event.channel === 'chat-turn-started') {
+                const payload = event.payload;
+                if (payload.chatId === this.chatId) {
+                    this.backendTurnActive = true;
+                    this.armLive(payload.chatId, true);
+                }
+            }
+            else if (event.channel === 'chat-turn-finished') {
+                const payload = event.payload;
+                if (payload.chatId === this.chatId) {
+                    this.backendTurnActive = false;
+                    await this.reloadMessages(payload.chatId);
+                    await this.refreshGoal(payload.chatId);
+                    void this.drainQueue();
+                }
+            }
             this.touch();
         }
     }
@@ -904,11 +1013,11 @@ export class AgentTui {
             }
         }
     }
-    armLive(chatId) {
+    armLive(chatId, waitForStart = false) {
         const generation = ++this.liveGeneration;
-        void this.pollLive(chatId, generation);
+        void this.pollLive(chatId, generation, waitForStart ? 10 : 0);
     }
-    async pollLive(chatId, generation) {
+    async pollLive(chatId, generation, startRetries) {
         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);
@@ -918,6 +1027,13 @@ export class AgentTui {
             return;
         const data = live.data;
         if (data.active !== true) {
+            if (startRetries > 0) {
+                await new Promise((resolve) => {
+                    setTimeout(resolve, this.options.liveIntervalMs ?? 1000);
+                });
+                await this.pollLive(chatId, generation, startRetries - 1);
+                return;
+            }
             if (this.status === '运行中')
                 this.status = '';
             this.touch();
@@ -939,10 +1055,43 @@ export class AgentTui {
         await new Promise((resolve) => {
             setTimeout(resolve, wait);
         });
-        await this.pollLive(chatId, generation);
+        await this.pollLive(chatId, generation, 0);
+    }
+    async refreshGoal(chatId) {
+        const response = await this.client.request('GET', `/api/v2/chats/${encodeURIComponent(chatId)}/goal`, undefined);
+        this.goal = response.status === 200 && response.data && typeof response.data === 'object'
+            ? (response.data.goal ?? null)
+            : null;
+    }
+    async refreshLoops(chatId) {
+        const response = await this.client.request('GET', `/api/v2/chats/${encodeURIComponent(chatId)}/loops`, undefined);
+        this.loops = response.status === 200 && response.data && typeof response.data === 'object'
+            ? (response.data.loops ?? [])
+            : [];
+    }
+    async reloadMessages(chatId) {
+        const response = await this.client.request('GET', `/api/v2/chats/${encodeURIComponent(chatId)}/messages`, undefined);
+        if (response.status !== 200)
+            return;
+        const records = response.data.messages ?? [];
+        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.touch();
     }
-    async showList(method, requestPath, key, format, empty) {
+    async showList(method, requestPath, key, format, empty, unavailable) {
         const listed = await this.client.request(method, requestPath, undefined);
+        if (listed.status !== 200) {
+            this.panel = [`${unavailable} (${listed.status})`];
+            this.touch();
+            return;
+        }
         const rows = listed.status === 200 && listed.data && typeof listed.data === 'object'
             ? listed.data[key]
             : [];
@@ -959,6 +1108,11 @@ export class AgentTui {
             return;
         }
         const listed = await this.client.request('GET', `/api/v2/chats/${encodeURIComponent(this.chatId)}/tasks`, undefined);
+        if (listed.status !== 200) {
+            this.panel = [`后台任务不可用 (${listed.status})`];
+            this.touch();
+            return;
+        }
         const rows = listed.status === 200 && listed.data && typeof listed.data === 'object'
             ? listed.data.tasks ?? []
             : [];
@@ -1058,11 +1212,24 @@ export class AgentTui {
     }
     async decide(kind) {
         const request = this.approval;
-        if (!request)
+        if (!request || this.approvalSubmitting)
             return;
-        this.approval = null;
+        this.approvalSubmitting = true;
         this.touch();
-        await this.client.decideApproval(request.requestId, kind);
+        try {
+            const accepted = await this.client.decideApproval(request.requestId, kind);
+            if (!accepted)
+                throw new Error('approval unavailable');
+            if (this.approval?.requestId === request.requestId)
+                this.approval = null;
+        }
+        catch (error) {
+            this.status = `审批失败：${error instanceof Error ? error.message : String(error)}`;
+        }
+        finally {
+            this.approvalSubmitting = false;
+            this.touch();
+        }
     }
     touch() {
         if (this.stopped)
@@ -1070,6 +1237,12 @@ export class AgentTui {
         this.options.onChange?.();
     }
     exit() {
+        if (this.loops.length > 0 && !this.loopExitArmed) {
+            this.loopExitArmed = true;
+            this.status = '活动 Loop 会随本进程停止；再按一次退出';
+            this.touch();
+            return;
+        }
         this.stopped = true;
         this.turnAbort?.abort();
         this.options.onExit();
@@ -1144,6 +1317,15 @@ function taskStatus(status) {
         return '等待';
     return status ?? '';
 }
+function isSkillFacadeCommand(text) {
+    if (/^\/goal(?:\s|$)/.test(text)) {
+        return !/^\/goal(?:\s+(?:edit|pause|resume|complete|clear)(?:\s|$)|\s*$)/.test(text);
+    }
+    if (/^\/loop(?:\s|$)/.test(text)) {
+        return !/^\/loop\s+(?:list|stop)(?:\s|$)/.test(text);
+    }
+    return false;
+}
 async function editWithEditor(text) {
     const editor = process.env.VISUAL || process.env.EDITOR;
     if (!editor)

package/dist/tui/smoke-entry.js

@@ -1,8 +1,13 @@
+import { createCli } from '../cli.js';
 import { runTui } from './run.js';
 const queue = [];
 const waiters = [];
 let closed = false;
 let decided = () => { };
+let goal = null;
+let loops = [];
+const proactiveMessages = [];
+let liveActive = false;
 function push(item) {
     const waiter = waiters.shift();
     if (waiter)
@@ -19,10 +24,78 @@ const client = {
             return { status: 200, data: { model: 'demo-model' } };
         if (method === 'POST' && requestPath === '/api/v2/chats/new')
             return { status: 200, data: { chatId: 'chat-1' } };
+        if (method === 'GET' && requestPath.endsWith('/goal'))
+            return { status: 200, data: { goal } };
+        if (method === 'GET' && requestPath.endsWith('/loops'))
+            return { status: 200, data: { loops } };
+        if (method === 'DELETE' && requestPath.includes('/loops/')) {
+            const id = requestPath.split('/').pop();
+            loops = loops.filter((loop) => loop.id !== id);
+            push({ channel: 'loop-changed', payload: { chatId: 'chat-1', loops } });
+            return { status: 200, data: { success: true } };
+        }
+        if (method === 'GET' && requestPath.endsWith('/live-stream')) {
+            return {
+                status: 200,
+                data: liveActive ? { active: true, content: 'goal wake running' } : { active: false },
+            };
+        }
+        if (method === 'GET' && requestPath.endsWith('/messages')) {
+            return {
+                status: 200,
+                data: {
+                    messages: proactiveMessages,
+                },
+            };
+        }
         return { status: 200, data: {} };
     },
     async *stream(_requestPath, body, signal) {
         const message = String(body.message ?? '');
+        if (message.startsWith('/goal ')) {
+            goal = { objective: message.slice('/goal '.length), phase: 'active', turns: 1 };
+            push({ channel: 'goal-changed', payload: { chatId: 'chat-1', goal } });
+            yield { type: 'content', content: 'goal accepted' };
+            setTimeout(() => {
+                liveActive = true;
+                push({
+                    channel: 'chat-turn-started',
+                    payload: { chatId: 'chat-1', trigger: 'goal', sourceId: 'goal-1' },
+                });
+                setTimeout(() => {
+                    liveActive = false;
+                    proactiveMessages.push({
+                        role: 'user',
+                        content: '<objective>hidden</objective>',
+                        messageMetadata: JSON.stringify({
+                            internal: true,
+                            trigger: 'goal',
+                            sourceId: 'goal-1',
+                        }),
+                    }, { role: 'assistant', content: 'goal wake completed' });
+                    goal = { ...goal, turns: 2 };
+                    push({
+                        channel: 'chat-turn-finished',
+                        payload: { chatId: 'chat-1', trigger: 'goal', status: 'completed' },
+                    });
+                }, 250);
+            }, 100);
+            return;
+        }
+        if (message.startsWith('/loop ')) {
+            const finite = message.includes('until complete');
+            const id = finite ? 'loop-finite' : 'loop-recurring';
+            loops = [{
+                    id,
+                    prompt: finite ? 'monitor demo until complete' : 'recurring demo',
+                    intervalSeconds: 1,
+                }];
+            push({ channel: 'loop-changed', payload: { chatId: 'chat-1', loops } });
+            yield { type: 'content', content: `loop armed ${id}` };
+            if (finite)
+                scheduleFiniteLoopWake(id, 1);
+            return;
+        }
         if (message.includes('hang')) {
             yield { type: 'content', content: 'running' };
             await new Promise((resolve) => signal.addEventListener('abort', () => resolve()));
@@ -65,6 +138,48 @@ const client = {
             waiter(null);
     },
 };
-await runTui({ client, product: 'Demo' });
-await client.close();
-process.exit(0);
+function scheduleFiniteLoopWake(id, attempt) {
+    setTimeout(() => {
+        liveActive = true;
+        push({
+            channel: 'chat-turn-started',
+            payload: { chatId: 'chat-1', trigger: 'loop', sourceId: id },
+        });
+        setTimeout(() => {
+            liveActive = false;
+            proactiveMessages.push({
+                role: 'user',
+                content: 'hidden loop wake',
+                messageMetadata: JSON.stringify({
+                    internal: true,
+                    trigger: 'loop',
+                    sourceId: id,
+                }),
+            }, {
+                role: 'assistant',
+                content: attempt === 1 ? 'loop monitoring pending' : 'loop reached terminal state',
+            });
+            if (attempt === 2) {
+                loops = [];
+                push({ channel: 'loop-changed', payload: { chatId: 'chat-1', loops } });
+            }
+            push({
+                channel: 'chat-turn-finished',
+                payload: { chatId: 'chat-1', trigger: 'loop', sourceId: id, status: 'completed' },
+            });
+            if (attempt === 1)
+                scheduleFiniteLoopWake(id, 2);
+        }, 200);
+    }, 150);
+}
+const defaultCli = process.argv.includes('--default-cli');
+const code = defaultCli
+    ? await createCli({
+        argv: [],
+        createClient: async () => client,
+        installSignals: false,
+    })
+    : await runTui({ client, product: 'Demo' });
+if (!defaultCli)
+    await client.close();
+process.exit(code);

package/dist/tui/transcript.js

@@ -66,11 +66,16 @@ function clip(text) {
 export function historyRows(messages) {
     const rows = [];
     for (const message of inTimeOrder(messages)) {
+        const meta = parseMeta(message.messageMetadata);
         if (message.role === 'user') {
+            if (meta.internal === true) {
+                const trigger = meta.trigger === 'loop' ? 'Loop 触发' : '目标续跑';
+                rows.push({ kind: 'tree', text: trigger });
+                continue;
+            }
             rows.push({ kind: 'user', text: message.content ?? '' });
             continue;
         }
-        const meta = parseMeta(message.messageMetadata);
         const timeline = Array.isArray(meta.timeline) ? meta.timeline : null;
         if (timeline) {
             let sawText = false;

package/dist/tui/view.d.ts

@@ -20,11 +20,21 @@ export declare class OpenTuiView {
     private bodyKey;
     private overlayKey;
     private picksKey;
-    private readonly syntax;
+    private chatListOpen;
+    private transcriptPinned;
+    private transcriptScroll;
+    private revealId;
+    private restoreTranscript;
+    private readonly onFrame;
     constructor(renderer: CliRenderer);
     scrollPage(direction: -1 | 1): void;
     scrollEdge(edge: 'top' | 'bottom'): void;
     apply(screen: TuiScreen): void;
+    /** Transcript stays pinned to the bottom. The chat list follows the selected row instead. */
+    private followChats;
+    private atBottom;
+    private maxScrollTop;
+    private viewportRows;
     private paintOverlay;
     private paintPicks;
     private replaceBody;

package/dist/tui/view.js

@@ -1,4 +1,4 @@
-import { BoxRenderable, MarkdownRenderable, ScrollBoxRenderable, SyntaxStyle, TextRenderable, dim as dimText, reverse, t, } from '@opentui/core';
+import { BoxRenderable, ScrollBoxRenderable, TextRenderable, bold, dim as dimText, italic, reverse, strikethrough, t, underline, } from '@opentui/core';
 import { splitAtCursor } from './editor.js';
 import { childLines } from './children.js';
 import { approvalLines, attachmentText, bannerLines, chatText, composerRows, draftHint, footerText, helpLines, pickText, readOnlyText, reasoningBlock, toolBlock, } from './screen.js';
@@ -34,16 +34,31 @@ export class OpenTuiView {
     bodyKey = '';
     overlayKey = '';
     picksKey = '';
-    syntax;
+    chatListOpen = false;
+    transcriptPinned = true;
+    transcriptScroll = 0;
+    revealId = null;
+    restoreTranscript = false;
+    onFrame = () => {
+        if (this.restoreTranscript) {
+            this.restoreTranscript = false;
+            this.body.stickyScroll = true;
+            const max = this.maxScrollTop();
+            this.body.scrollTop = this.transcriptPinned ? max : Math.min(this.transcriptScroll, max);
+            return;
+        }
+        if (!this.revealId)
+            return;
+        const id = this.revealId;
+        this.revealId = null;
+        this.body.scrollChildIntoView(id);
+    };
     constructor(renderer) {
         this.renderer = renderer;
-        try {
-            this.syntax = SyntaxStyle.create();
-        }
-        catch (error) {
-            void error;
-            this.syntax = null;
-        }
+        renderer.on('frame', this.onFrame);
+        renderer.once('destroy', () => {
+            renderer.off('frame', this.onFrame);
+        });
         const shell = new BoxRenderable(renderer, {
             width: '100%',
             height: '100%',
@@ -181,12 +196,44 @@ export class OpenTuiView {
             this.body.scrollChildIntoView(`line-${screen.searchFocus}`);
         this.paintOverlay(screen);
         this.paintPicks(screen);
+        this.followChats(screen);
         const key = bodyKey(screen);
         if (key === this.bodyKey)
             return;
         this.bodyKey = key;
         this.replaceBody(screen);
     }
+    /** Transcript stays pinned to the bottom. The chat list follows the selected row instead. */
+    followChats(screen) {
+        const chats = screen.chats;
+        if (chats && !this.chatListOpen) {
+            this.transcriptPinned = this.atBottom();
+            this.transcriptScroll = this.body.scrollTop;
+            this.body.stickyScroll = false;
+            this.body.scrollTop = 0;
+            this.chatListOpen = true;
+        }
+        else if (!chats && this.chatListOpen) {
+            this.chatListOpen = false;
+            this.revealId = null;
+            this.restoreTranscript = true;
+            this.body.stickyScroll = false;
+        }
+        if (!chats)
+            return;
+        const index = chats.findIndex((chat) => chat.selected);
+        this.revealId = index < 0 ? null : index === 0 ? 'chat-heading' : `chat-${index}`;
+    }
+    atBottom() {
+        return this.body.scrollTop >= this.maxScrollTop() - 1;
+    }
+    maxScrollTop() {
+        return Math.max(0, this.body.scrollHeight - this.viewportRows());
+    }
+    viewportRows() {
+        const height = this.body.viewport.height;
+        return typeof height === 'number' ? height : 0;
+    }
     paintOverlay(screen) {
         const lines = screen.approval
             ? approvalLines(screen.approval)
@@ -247,9 +294,10 @@ export class OpenTuiView {
             return;
         }
         if (screen.chats) {
-            this.body.add(text(renderer, dim, '会话'));
-            for (const chat of screen.chats) {
+            this.body.add(text(renderer, dim, '会话', 'chat-heading'));
+            screen.chats.forEach((chat, index) => {
                 const row = new BoxRenderable(renderer, {
+                    id: `chat-${index}`,
                     width: '100%',
                     height: 1,
                     backgroundColor: chat.selected ? selected : canvas,
@@ -257,11 +305,11 @@ export class OpenTuiView {
                 });
                 row.add(text(renderer, chat.selected ? ink : dim, chatText(chat)));
                 this.body.add(row);
-            }
+            });
             return;
         }
         screen.lines.forEach((line, index) => {
-            this.body.add(transcriptRow(renderer, line, this.syntax, `line-${index}`));
+            this.body.add(transcriptRow(renderer, line, `line-${index}`));
         });
         for (const line of childLines(screen.children ?? []))
             this.body.add(text(renderer, tool, line));
@@ -284,7 +332,7 @@ function bodyKey(screen) {
         children: screen.children ?? [],
     });
 }
-function transcriptRow(renderer, line, syntax, id) {
+function transcriptRow(renderer, line, id) {
     if (line.kind === 'reasoning') {
         const card = new BoxRenderable(renderer, {
             id,
@@ -316,20 +364,46 @@ function transcriptRow(renderer, line, syntax, id) {
     if (line.kind === 'user') {
         return text(renderer, user, `user ${line.text ?? ''}`, id);
     }
-    if (line.kind === 'assistant' && syntax) {
-        return new MarkdownRenderable(renderer, {
-            id,
-            content: line.text && line.text.length > 0 ? line.text : ' ',
-            syntaxStyle: syntax,
-            fg: ink,
-            conceal: true,
-            streaming: line.streaming === true,
-            width: '100%',
-        });
+    if (line.kind === 'assistant') {
+        return markdown(renderer, line.text ?? '', id);
     }
     const plain = plainMarkdown(line.text ?? '');
     return text(renderer, ink, plain.length > 0 ? plain : ' ', id);
 }
+function markdown(renderer, source, id) {
+    const box = new BoxRenderable(renderer, {
+        id,
+        width: '100%',
+        flexDirection: 'column',
+    });
+    let fenced = false;
+    for (const raw of source.replace(/\r\n/g, '\n').split('\n')) {
+        if (raw.trim().startsWith('```')) {
+            fenced = !fenced;
+            continue;
+        }
+        if (fenced) {
+            box.add(text(renderer, tool, raw.length > 0 ? raw : ' '));
+            continue;
+        }
+        const content = plainMarkdown(raw);
+        if (/^#{1,6}\s+/.test(raw))
+            box.add(text(renderer, user, t `${bold(content)}`));
+        else if (/^\s*>/.test(raw))
+            box.add(text(renderer, dim, t `${italic(content.replace(/^\s*>\s?/, ''))}`));
+        else if (/\*\*[^*\n]+\*\*/.test(raw))
+            box.add(text(renderer, ink, t `${bold(content)}`));
+        else if (/~~[^~\n]+~~/.test(raw))
+            box.add(text(renderer, ink, t `${strikethrough(content)}`));
+        else if (/\[[^\]\n]+\]\([^)]+\)/.test(raw))
+            box.add(text(renderer, user, t `${underline(content)}`));
+        else if (/`[^`\n]+`/.test(raw))
+            box.add(text(renderer, tool, content));
+        else
+            box.add(text(renderer, ink, content.length > 0 ? content : ' '));
+    }
+    return box;
+}
 function text(renderer, fg, content = '', id) {
     return new TextRenderable(renderer, { ...(id ? { id } : {}), content, fg, wrapMode: 'word' });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-cli",
-  "version": "0.6.62",
+  "version": "0.6.64",
   "description": "Product-neutral command line for a Steerable host. Products supply the bin name and brand.",
   "license": "Apache-2.0",
   "homepage": "https://steerableframework.com/",
@@ -38,9 +38,9 @@
   "dependencies": {
     "@earendil-works/pi-tui": "0.87.1",
     "@opentui/core": "0.5.12",
-    "@steerable/agent-client": "0.6.62",
-    "@steerable/agent-protocol": "0.6.62",
-    "@steerable/agent-shell": "0.6.62"
+    "@steerable/agent-client": "0.6.64",
+    "@steerable/agent-protocol": "0.6.64",
+    "@steerable/agent-shell": "0.6.64"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
@@ -51,7 +51,9 @@
     "gen": "echo agent-cli",
     "build": "tsc -p tsconfig.json",
     "test": "vitest run",
-    "lint": "tsc -p tsconfig.json --noEmit",
+    "test:tui": "vitest run tests/tui.test.ts tests/tui-framework.test.ts tests/tui-edge-cases.test.ts tests/tui-open-renderer.test.ts tests/tui-platform.test.ts tests/tui-case-coverage.test.ts",
+    "test:tui:pty": "vitest run tests/tui-tmux.test.ts",
+    "lint": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json",
     "check:drift": "echo ok"
   }
 }