@steerable/agent-cli 0.6.59 → 0.6.61

package/dist/tui/prompt-history.d.ts

@@ -0,0 +1,21 @@
+import type { DraftBuffer } from './editor.js';
+export interface PromptHistory {
+    items: string[];
+    index: number;
+    saved: {
+        text: string;
+        cursor: number;
+    } | null;
+}
+export declare function createPromptHistory(): PromptHistory;
+/** Remember a sent line. Newest is first. A repeat of the latest line is kept once. */
+export declare function rememberPrompt(history: PromptHistory, text: string): void;
+/** Typing leaves history browsing and keeps the text now in the composer. */
+export declare function leavePromptHistory(history: PromptHistory): void;
+/**
+ * Step through sent lines.
+ * `direction` -1 is older, 1 is newer. Past the newest line restores the draft that was there before browsing.
+ */
+export declare function recallPrompt(history: PromptHistory, draft: DraftBuffer, direction: -1 | 1): boolean;
+export declare function onFirstLine(text: string, cursor: number): boolean;
+export declare function onLastLine(text: string, cursor: number): boolean;

package/dist/tui/prompt-history.js

@@ -0,0 +1,57 @@
+const LIMIT = 100;
+export function createPromptHistory() {
+    return { items: [], index: -1, saved: null };
+}
+/** Remember a sent line. Newest is first. A repeat of the latest line is kept once. */
+export function rememberPrompt(history, text) {
+    const trimmed = text.trim();
+    history.index = -1;
+    history.saved = null;
+    if (!trimmed || history.items[0] === trimmed)
+        return;
+    history.items.unshift(trimmed);
+    if (history.items.length > LIMIT)
+        history.items.pop();
+}
+/** Typing leaves history browsing and keeps the text now in the composer. */
+export function leavePromptHistory(history) {
+    if (history.index < 0)
+        return;
+    history.index = -1;
+    history.saved = null;
+}
+/**
+ * Step through sent lines.
+ * `direction` -1 is older, 1 is newer. Past the newest line restores the draft that was there before browsing.
+ */
+export function recallPrompt(history, draft, direction) {
+    if (history.items.length === 0)
+        return false;
+    const next = history.index - direction;
+    if (next < -1 || next >= history.items.length)
+        return false;
+    if (history.index < 0)
+        history.saved = { text: draft.text, cursor: draft.cursor };
+    history.index = next;
+    if (next < 0) {
+        const saved = history.saved;
+        history.saved = null;
+        draft.text = saved?.text ?? '';
+        draft.cursor = saved?.cursor ?? 0;
+        return true;
+    }
+    draft.text = history.items[next] ?? '';
+    draft.cursor = draft.text.length;
+    return true;
+}
+export function onFirstLine(text, cursor) {
+    const at = clamp(cursor, text.length);
+    return !text.slice(0, at).includes('\n');
+}
+export function onLastLine(text, cursor) {
+    const at = clamp(cursor, text.length);
+    return !text.slice(at).includes('\n');
+}
+function clamp(cursor, length) {
+    return Math.max(0, Math.min(cursor, length));
+}

package/dist/tui/run.d.ts

@@ -6,3 +6,5 @@ export declare function runTui(options: {
     dataDir?: string;
     terminal?: Terminal;
 }): 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

@@ -1,5 +1,6 @@
 import { ProcessTerminal, TuiAltScreen } from '@earendil-works/pi-tui';
 import { installAgentKeybindings } from './keys.js';
+import { transcriptPage } from './scroll.js';
 import { AgentTui } from './session.js';
 export async function runTui(options) {
     installAgentKeybindings();
@@ -40,6 +41,13 @@ async function runOpenTui(options) {
         });
         const view = new OpenTuiView(renderer);
         renderer.prependInputHandler((sequence) => {
+            if (yieldsToRenderer(sequence))
+                return false;
+            const page = transcriptPage(sequence);
+            if (page !== 0) {
+                view.scrollPage(page);
+                return true;
+            }
             session.handleInput(sequence);
             return true;
         });
@@ -67,6 +75,16 @@ function runPlainTui(options) {
         tui.start();
     });
 }
+/** Terminal reports (capability replies, focus) must reach the renderer so Shift+Enter stays distinct from Enter. */
+export function yieldsToRenderer(sequence) {
+    if (sequence === '\x1b[I' || sequence === '\x1b[O')
+        return true;
+    if (sequence.startsWith('\x1b]') || sequence.startsWith('\x1bP') || sequence.startsWith('\x1b_'))
+        return true;
+    if (sequence.startsWith('\x1b[?'))
+        return true;
+    return /^\x1b\[\d+(;\d+)?R$/.test(sequence);
+}
 function openTuiUnavailable(error) {
     const cause = error instanceof Error && error.cause instanceof Error ? error.cause.message : '';
     const message = `${error instanceof Error ? error.message : String(error)} ${cause}`;

package/dist/tui/screen.d.ts

@@ -1,9 +1,15 @@
+import { type ChildRow } from './children.js';
 export interface TranscriptLine {
-    kind: 'user' | 'assistant' | 'tool';
+    kind: 'user' | 'assistant' | 'tool' | 'tree' | 'reasoning';
     text?: string;
     name?: string;
     args?: string;
     status?: string;
+    id?: string;
+    output?: string;
+    diff?: string;
+    open?: boolean;
+    streaming?: boolean;
 }
 export interface ChatRow {
     id: string;
@@ -11,6 +17,10 @@ export interface ChatRow {
     busy: boolean;
     selected: boolean;
 }
+export interface PickRow {
+    label: string;
+    selected: boolean;
+}
 export interface TuiScreen {
     product: string;
     title: string;
@@ -27,16 +37,39 @@ export interface TuiScreen {
     readOnly: boolean;
     help: boolean;
     draft: string;
+    cursor: number;
     status: string;
+    picks?: PickRow[] | null;
+    attachments?: string[];
+    children?: ChildRow[];
+    queued?: string[];
+    search?: string | null;
+    searchFocus?: number | null;
+    scroll?: 'top' | 'bottom' | null;
+    panel?: string[] | null;
+    mode?: 'agent' | 'plan';
+    permission?: 'ask' | 'auto' | 'read';
+    todos?: Array<{
+        content: string;
+        status: 'pending' | 'in_progress' | 'completed';
+    }>;
 }
+export declare function draftHint(): string;
 export declare function renderScreen(screen: TuiScreen, width: number): string[];
 export declare function toolText(line: TranscriptLine): string;
+export declare function toolBlock(line: TranscriptLine): string[];
+export declare function reasoningBlock(line: TranscriptLine): string[];
 export declare function chatText(chat: ChatRow): string;
 export declare function helpLines(): string[];
+export declare function pickText(pick: PickRow): string;
+export declare function attachmentText(names: readonly string[]): string;
 export declare function approvalLines(approval: {
     toolName: string;
     summary: string;
 }): string[];
 export declare function footerText(): string;
+export declare function draftLine(draft: string, cursor: number): string;
+export declare function composerRows(draft: string, columns: number): number;
 export declare const readOnlyText = "\u53EA\u8BFB \u00B7 \u53E6\u4E00\u4E2A\u8FDB\u7A0B\u6B63\u5728\u8FD0\u884C";
 export declare function visibleText(lines: string[]): string;
+export declare function bannerLines(screen: TuiScreen): string[];

package/dist/tui/screen.js

@@ -1,5 +1,12 @@
-import { Box, Text } from '@earendil-works/pi-tui';
+import { Box, CURSOR_MARKER, Text } from '@earendil-works/pi-tui';
+import { childLines } from './children.js';
+import { splitAtCursor } from './editor.js';
 import { keyLabel } from './keys.js';
+import { plainMarkdown } from './transcript.js';
+export function draftHint() {
+    return `输入消息，${keyLabel('tui.input.submit')} 发送，${keyLabel('tui.input.newLine')} 换行`;
+}
+const caret = '▍';
 export function renderScreen(screen, width) {
     const box = new Box(0, 0);
     for (const line of screenLines(screen))
@@ -9,13 +16,62 @@ export function renderScreen(screen, width) {
 export function toolText(line) {
     return `▸ ${line.name}  ${line.args}  ${line.status ?? ''}`.trimEnd();
 }
+export function toolBlock(line) {
+    const head = toolText(line);
+    if (!line.open)
+        return [head];
+    const rows = [];
+    if (line.diff)
+        rows.push(...line.diff.split('\n').slice(0, 12).map((row) => `  ${row}`));
+    if (line.output)
+        rows.push(...line.output.split('\n').slice(0, 8).map((row) => `  ${row}`));
+    return rows.length > 0 ? [head, ...rows] : [head];
+}
+export function reasoningBlock(line) {
+    const head = line.streaming ? '思考 …' : '思考';
+    if (!line.open || !line.text)
+        return [head];
+    return [head, ...line.text.split('\n').slice(0, 8).map((row) => `  ${row}`)];
+}
 export function chatText(chat) {
     const mark = chat.selected ? '*' : ' ';
     const busy = chat.busy ? '  只读' : '';
     return `${mark} ${chat.id}  ${chat.title}${busy}`;
 }
 export function helpLines() {
-    return ['/new 新会话', '/model 查看或切换模型', '/clear 清屏', '/help 帮助'];
+    return [
+        '/new 新会话',
+        '/model 查看或切换模型',
+        '/attach 附加文件',
+        '@ 补全文件',
+        '/clear 清屏',
+        '/help 帮助',
+        `${keyLabel('agent.tool.toggle')} 展开工具或思考`,
+        `${keyLabel('agent.clipboard.paste')} 粘贴图片`,
+        `${keyLabel('tui.altScreen.search')} 搜索记录`,
+        `${keyLabel('tui.altScreen.top')} 记录顶  ${keyLabel('tui.altScreen.bottom')} 记录底`,
+        `${keyLabel('agent.queue.pull')} 取回排队`,
+        `${keyLabel('agent.copy.reply')} 复制回答`,
+        `${keyLabel('agent.editor')} 外部编辑器`,
+        '/status 用量',
+        '/skills 技能',
+        '/mcp MCP',
+        '/export 导出会话',
+        '/compact 压缩上下文',
+        '/plan 计划模式',
+        '/tasks 后台任务',
+        '/fork 分叉',
+        '/rewind 回退',
+        '/permissions 会话权限',
+        '/copy 复制回答',
+        '/editor 外部编辑器',
+    ];
+}
+export function pickText(pick) {
+    return `${pick.selected ? '*' : ' '} ${pick.label}`;
+}
+export function attachmentText(names) {
+    return names.length > 0 ? `附件 ${names.join('  ')}` : '';
 }
 export function approvalLines(approval) {
     return [
@@ -25,7 +81,22 @@ export function approvalLines(approval) {
     ];
 }
 export function footerText() {
-    return `${keyLabel('agent.interrupt')} 中断 · ${keyLabel('agent.chats')} 会话 · /help`;
+    return `${keyLabel('agent.interrupt')} 中断 · ${keyLabel('agent.chats')} 会话 · ${keyLabel('tui.input.submit')} 发送 · /help`;
+}
+export function draftLine(draft, cursor) {
+    const { before, head, after } = splitAtCursor(draft, cursor);
+    if (draft.length === 0)
+        return `> ${CURSOR_MARKER}${caret} ${draftHint()}`;
+    return `> ${before}${CURSOR_MARKER}${caret}${head}${after}`;
+}
+export function composerRows(draft, columns) {
+    const width = Math.max(1, columns);
+    const shown = draft.length > 0 ? draft : `▍ ${draftHint()}`;
+    let rows = 0;
+    for (const line of shown.split('\n')) {
+        rows += Math.max(1, Math.ceil(displayWidth(`> ${line}`) / width));
+    }
+    return Math.min(8, rows);
 }
 export const readOnlyText = '只读 · 另一个进程正在运行';
 export function visibleText(lines) {
@@ -44,25 +115,70 @@ function screenLines(screen) {
     else {
         for (const line of screen.lines) {
             if (line.kind === 'tool')
-                lines.push(toolText(line));
+                lines.push(...toolBlock(line));
+            else if (line.kind === 'reasoning')
+                lines.push(...reasoningBlock(line));
             else if (line.kind === 'user')
                 lines.push(`user ${line.text ?? ''}`);
             else
-                lines.push(line.text ?? '');
+                lines.push(...plainMarkdown(line.text ?? '').split('\n'));
         }
     }
+    if (!screen.help && !screen.chats)
+        lines.push(...childLines(screen.children ?? []));
+    lines.push(...bannerLines(screen));
     if (screen.readOnly)
         lines.push(readOnlyText);
     if (screen.approval)
         lines.push(...approvalLines(screen.approval));
     if (screen.ask)
         lines.push(`追问 ${screen.ask.prompt}`);
-    lines.push(`> ${screen.draft}`);
+    for (const pick of screen.picks ?? [])
+        lines.push(pickText(pick));
+    const attached = attachmentText(screen.attachments ?? []);
+    if (attached)
+        lines.push(attached);
+    for (const item of screen.queued ?? [])
+        lines.push(`排队 ${item}`);
+    if (screen.search)
+        lines.push(screen.search);
+    lines.push(draftLine(screen.draft, screen.cursor));
     if (screen.status)
         lines.push(screen.status);
     lines.push(footerText());
     return lines;
 }
+export function bannerLines(screen) {
+    const lines = [];
+    if (!screen.help && !screen.chats) {
+        for (const todo of screen.todos ?? [])
+            lines.push(todoText(todo));
+    }
+    if (screen.mode === 'plan')
+        lines.push('模式 计划');
+    if (screen.permission === 'auto')
+        lines.push('权限 本会话自动');
+    if (screen.permission === 'read')
+        lines.push('权限 只读');
+    for (const row of screen.panel ?? [])
+        lines.push(row);
+    return lines;
+}
+function todoText(todo) {
+    if (todo.status === 'completed')
+        return `✓ ${todo.content}`;
+    if (todo.status === 'in_progress')
+        return `▸ ${todo.content}`;
+    return `○ ${todo.content}`;
+}
+function displayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        const code = char.codePointAt(0) ?? 0;
+        width += code > 0xff ? 2 : 1;
+    }
+    return width;
+}
 class PlainLine {
     text;
     constructor(text) {

package/dist/tui/scroll.d.ts

@@ -0,0 +1,6 @@
+/** Page Up / Page Down scroll the transcript. `0` means the key belongs to the composer. */
+export declare function transcriptPage(sequence: string): -1 | 1 | 0;
+/** Home / End jump the transcript. `null` means the key belongs to the composer. */
+export declare function transcriptEdge(sequence: string): 'top' | 'bottom' | null;
+/** One page, keeping a few lines of overlap so the reader can see where they were. */
+export declare function pageScrollLines(viewportHeight: number, direction: -1 | 1): number;

package/dist/tui/scroll.js

@@ -0,0 +1,28 @@
+import { getKeybindings } from '@earendil-works/pi-tui';
+import { ensureAgentKeybindings } from './keys.js';
+const PAGE_OVERLAP = 4;
+/** Page Up / Page Down scroll the transcript. `0` means the key belongs to the composer. */
+export function transcriptPage(sequence) {
+    ensureAgentKeybindings();
+    const keys = getKeybindings();
+    if (keys.matches(sequence, 'tui.altScreen.pageUp'))
+        return -1;
+    if (keys.matches(sequence, 'tui.altScreen.pageDown'))
+        return 1;
+    return 0;
+}
+/** Home / End jump the transcript. `null` means the key belongs to the composer. */
+export function transcriptEdge(sequence) {
+    ensureAgentKeybindings();
+    const keys = getKeybindings();
+    if (keys.matches(sequence, 'tui.altScreen.top'))
+        return 'top';
+    if (keys.matches(sequence, 'tui.altScreen.bottom'))
+        return 'bottom';
+    return null;
+}
+/** One page, keeping a few lines of overlap so the reader can see where they were. */
+export function pageScrollLines(viewportHeight, direction) {
+    const rows = Number.isFinite(viewportHeight) ? viewportHeight : 0;
+    return direction * Math.max(1, Math.floor(rows) - PAGE_OVERLAP);
+}

package/dist/tui/search.d.ts

@@ -0,0 +1,8 @@
+import type { TranscriptLine } from './screen.js';
+export interface SearchHit {
+    line: number;
+    snippet: string;
+}
+/** Case-insensitive hits over user, assistant, tool, reasoning, and tree text. */
+export declare function searchHits(lines: readonly TranscriptLine[], query: string): SearchHit[];
+export declare function searchLabel(query: string, hits: readonly SearchHit[], index: number): string;

package/dist/tui/search.js

@@ -0,0 +1,38 @@
+/** Case-insensitive hits over user, assistant, tool, reasoning, and tree text. */
+export function searchHits(lines, query) {
+    const needle = query.trim().toLowerCase();
+    if (!needle)
+        return [];
+    const hits = [];
+    lines.forEach((line, index) => {
+        const text = lineText(line);
+        const at = text.toLowerCase().indexOf(needle);
+        if (at < 0)
+            return;
+        hits.push({ line: index, snippet: snippetAt(text, at, needle.length) });
+    });
+    return hits;
+}
+export function searchLabel(query, hits, index) {
+    const shown = query.trim();
+    if (!shown)
+        return '搜索';
+    if (hits.length === 0)
+        return `搜索 ${shown}  无匹配`;
+    const hit = hits[Math.min(index, hits.length - 1)] ?? hits[0];
+    return `搜索 ${shown}  ${Math.min(index, hits.length - 1) + 1}/${hits.length}  ${hit?.snippet ?? ''}`;
+}
+function lineText(line) {
+    if (line.kind === 'tool') {
+        return [line.name, line.args, line.output, line.diff].filter((part) => part && part.length > 0).join(' ');
+    }
+    return line.text ?? '';
+}
+function snippetAt(text, at, length) {
+    const start = Math.max(0, at - 8);
+    const end = Math.min(text.length, at + length + 16);
+    const slice = text.slice(start, end).replace(/\s+/g, ' ').trim();
+    const prefix = start > 0 ? '…' : '';
+    const suffix = end < text.length ? '…' : '';
+    return `${prefix}${slice}${suffix}`;
+}

package/dist/tui/session.d.ts

@@ -1,10 +1,22 @@
 import { type Component } from '@earendil-works/pi-tui';
 import { type AgentClient } from '@steerable/agent-client';
+import { type ClipboardRead } from './clipboard.js';
+import { type SavedFile } from './files.js';
 import { type TuiScreen } from './screen.js';
 export interface AgentTuiOptions {
     product: string;
     dataDir?: string;
     busyChatIds?: string[];
+    cwd?: string;
+    saveAttachments?: (chatId: string, files: Array<{
+        name: string;
+        path: string;
+    }>) => Promise<SavedFile[]>;
+    readClipboard?: () => Promise<ClipboardRead>;
+    writeClipboard?: (text: string) => Promise<void>;
+    editInEditor?: (text: string) => Promise<string>;
+    exportDir?: string;
+    liveIntervalMs?: number;
     onExit: () => void;
     onChange?: () => void;
 }
@@ -22,7 +34,24 @@ export declare class AgentTui implements Component {
     private ask;
     private readOnly;
     private help;
-    private draft;
+    private buffer;
+    private prompts;
+    private paste;
+    private picks;
+    private pickIndex;
+    private pickGeneration;
+    private attachments;
+    private queue;
+    private sending;
+    private search;
+    private scroll;
+    private panel;
+    private mode;
+    private permission;
+    private todos;
+    private liveGeneration;
+    private children;
+    private readonly cwd;
     private status;
     private stopped;
     private turnAbort;
@@ -34,16 +63,45 @@ export declare class AgentTui implements Component {
     render(width: number): string[];
     snapshot(): TuiScreen;
     handleInput(data: string): void;
+    private applyInput;
+    private pasteClipboard;
+    private browseHistory;
+    private composing;
+    private consumePaste;
     private screen;
+    private searchBar;
+    private editSearch;
+    private pullQueue;
+    private pickRows;
+    private markPicks;
+    private refreshPicks;
+    private acceptPick;
     private showChats;
     private loadChats;
     private markSelection;
     private openChat;
     private submit;
+    private sendPrepared;
+    private prepareOwned;
     private slash;
+    private attach;
+    private prepareMessage;
+    private ensureChat;
     private runTurn;
     private observe;
     private watch;
+    private applyActions;
+    private toggleFold;
+    private armLive;
+    private pollLive;
+    private showList;
+    private showTasks;
+    private exportChat;
+    private compactChat;
+    private forkChat;
+    private rewindChat;
+    private copyReply;
+    private editDraftExternal;
     private decide;
     private touch;
     private exit;