berry-agent-sdk 0.1.0-alpha.2

package/dist/src/channels/tui/backend/transcript.js

@@ -0,0 +1,231 @@
+import { isStandardMessage } from '../../../contracts/index.js';
+import { CellGrid, truncateToWidth, wrapText } from '../../engine/index.js';
+import { gridRowToStyled, styledLineToAnsi } from './ansi-rows.js';
+import { MarkdownDoc } from '../markdown/markdown.js';
+/**
+ * 主屏滚动帽定值（07 §4.1「屏幕模型双形态」：帽值随主屏实装批实测定值回填、
+ * 规范不预写数字。批 10f-3 性能回归锁建锁：四指标 wall-time 面不覆盖块帽
+ * 〔内存上限语义〕——v1 维持保守值 500 块，实机校准注记留批 12 host 装配）。
+ * 批 10f-4 参数化：本值降级为缺省帽（主屏调用面零变化）；回看器全量档经
+ * LiveTranscriptOptions.blockCap 传 Number.POSITIVE_INFINITY（全量 durable
+ * 正文不被截——perf-lock 全量档回归锁）。
+ */
+export const TRANSCRIPT_BLOCK_CAP = 500;
+/** ⚙ 行 / ↳ 行的参数与结果简述显示宽帽（列） */
+const BRIEF_WIDTH = 40;
+/** 会话短 id（呈现层自截——散列映射色板键同源） */
+export function shortIdOf(sessionId) {
+    return sessionId.slice(0, 8);
+}
+/** dim 样式（简行块的整行样式——SGR 2；呈现侧带样式形同值） */
+const DIM_STYLE = Object.freeze({ dim: true });
+/**
+ * 块 → 带样式行集（管线单源本体——批 10f-4 件 8 提取）。
+ *
+ * 主屏 MainScreen 直写（经 renderBlockLines 的 ANSI 序列化形）与件 8 回看器
+ * cell 写出（StyledLine 直消费）共用本函数：同输入同行集、零第二渲染器
+ * （07 件 8 数据源条款）；markdown 块经 CellGrid 渲染（gridRowToStyled 提段）、
+ * user 块折行续挂对齐（宽算术单源走 wrapText）、简行块整行 dim、streaming
+ * 纯文本零样式、markdown 无内容行保空行（主屏空行直写形字节不变）。
+ */
+export function renderBlockStyledLines(block, columns) {
+    switch (block.kind) {
+        case 'markdown': {
+            const grid = new CellGrid(columns, block.doc.measure(columns));
+            block.doc.render(grid, { row: 0, col: 0, width: columns, height: grid.rows });
+            const lines = [];
+            for (let r = 0; r < grid.rows; r++) {
+                lines.push(gridRowToStyled(grid, r) ?? { plain: '', runs: [] }); // 无内容行保空行
+            }
+            return lines;
+        }
+        case 'user': {
+            // '> ' 前缀 + 折行续挂对齐（首行前缀、续行两空格缩进）
+            const lines = wrapText(block.text, columns - 2);
+            return lines.map((line, i) => ({ plain: (i === 0 ? '> ' : '  ') + line, runs: [] }));
+        }
+        case 'tool-call':
+            return [dimStyledLine(` ⚙ ${block.name}${block.brief}`)];
+        case 'tool-result':
+            return [dimStyledLine(` ↳ ${block.brief}`)];
+        case 'streaming':
+            // 流式槽纯文本直推（性能：不走网格不走样式）；空文本零行
+            return block.text === '' ? [] : wrapText(block.text, columns).map((text) => ({ plain: text, runs: [] }));
+    }
+}
+/** 简行块的带样式形（整行 dim——与 ANSI 形 dim() 字节同源） */
+function dimStyledLine(text) {
+    return { plain: text, runs: [{ start: 0, end: text.length, style: DIM_STYLE }] };
+}
+/**
+ * 块 → 行序列化（渲染管线单源——批 10f-4 提取为可复用函数；主屏直写消费形）。
+ * 带样式行本体经 styledLineToAnsi 导出 ANSI 串——与回看器 cell 写出形零第二
+ * 渲染器（renderBlockStyledLines 注）。
+ */
+export function renderBlockLines(block, columns) {
+    return renderBlockStyledLines(block, columns).map(styledLineToAnsi);
+}
+/** 消息文本块拼接（user/assistant/toolResult 通用；自定义角色与无文本块返 ''） */
+function textOf(message) {
+    // isStandardMessage 守卫先行——CustomMessage role: string 非字面判别位，
+    // 相等/开关收窄均排不掉，经守卫归一到标准三角色（自定义角色呈现侧宽容跳过）
+    if (!isStandardMessage(message))
+        return '';
+    if (typeof message.content === 'string')
+        return message.content; // user 纯文本形
+    return joinTextBlocks(message.content);
+}
+/** 文本块抽取拼接（图文/思考/工具块族里 text 块的串接——无文本块返 ''） */
+function joinTextBlocks(blocks) {
+    const parts = [];
+    for (const block of blocks) {
+        if (block.type === 'text' && typeof block.text === 'string')
+            parts.push(block.text);
+    }
+    return parts.join('');
+}
+/** 工具简述：参数键名序列（`path, content` 形——呈现面克制不倒参数值） */
+function argsBrief(args) {
+    const keys = Object.keys(args);
+    return keys.length > 0 ? `(${keys.join(', ')})` : '';
+}
+/**
+ * 直播路行集（单聚焦会话一账——非聚焦会话不建账，摘要行直返）。
+ * 纯状态件：无 IO、无时钟——applyEvent 同步归约，呈现编舞归 MainScreen。
+ */
+export class LiveTranscript {
+    /** 块帽（构造定着——主屏 500 / 回看器全量 Infinity） */
+    blockCap;
+    blocks = [];
+    /** 流式槽在场位（true = 末块是 streaming——message_start/message_end 配对守卫） */
+    slotOpen = false;
+    constructor(options = {}) {
+        this.blockCap = options.blockCap ?? TRANSCRIPT_BLOCK_CAP;
+    }
+    /** 行集快照（只读——呈现侧消费） */
+    get snapshot() {
+        return this.blocks;
+    }
+    /** 块计数（帽额度观测面） */
+    get blockCount() {
+        return this.blocks.length;
+    }
+    /**
+     * 直播路归约：活体信封 → 行集更新 + 瞬时行（非聚焦摘要行直返、聚焦返 null）。
+     * 非聚焦会话的 durable 事件全忽略（行集是聚焦会话的账——投影重建走 loadProjection）。
+     */
+    applyEvent(env, focused) {
+        const { event } = env;
+        if (!focused)
+            return this.summaryFor(event, env.sessionId);
+        this.applyFocused(event);
+        return null;
+    }
+    /** 投影重建（repaint 路——清账按投影重拉帽内段；直播/repaint 行集同构） */
+    loadProjection(messages) {
+        const rebuilt = [];
+        for (const message of messages) {
+            switch (message.role) {
+                case 'user':
+                    rebuilt.push({ kind: 'user', text: textOf(message) });
+                    break;
+                case 'assistant':
+                    this.appendAssistantFinal(rebuilt, message);
+                    break;
+                case 'toolResult':
+                    rebuilt.push({ kind: 'tool-result', brief: resultBrief(message) });
+                    break;
+                // 自定义角色：content unknown 宽容跳过（不猜形状——件 1 自定义渲染器优先级语义）
+            }
+        }
+        this.blocks = rebuilt;
+        this.slotOpen = false; // 投影是 durable 快照——无在飞槽
+        this.trimToCap();
+    }
+    /** 非聚焦摘要行分档（agent_start/end 之外的事件零产出） */
+    summaryFor(event, sessionId) {
+        const shortId = shortIdOf(sessionId);
+        switch (event.type) {
+            case 'agent_start':
+                return { symbol: '⧗', shortId, label: '后台工作中' };
+            case 'agent_end':
+                if (event.status === 'completed')
+                    return { symbol: '✓', shortId, label: '后台完成' };
+                if (event.status === 'failed')
+                    return { symbol: '✖', shortId, label: '后台失败' };
+                return { symbol: '⏹', shortId, label: '后台已中止' }; // aborted——失败与中止显式分档
+            default:
+                return null; // 消息族/turn 族：非聚焦零正文行（摘要行只由 run 生命周期驱动）
+        }
+    }
+    /** 聚焦归约：消息事件族分派（唯一渲染源律——tool_execution_* 正文零渲染） */
+    applyFocused(event) {
+        switch (event.type) {
+            case 'message_start':
+                if (event.role !== 'assistant')
+                    return;
+                // 流式单槽守卫：重开先摘旧槽（占位容器不孤儿滞留）
+                if (this.slotOpen)
+                    this.blocks.pop();
+                this.blocks.push({ kind: 'streaming', text: '' });
+                this.slotOpen = true;
+                break;
+            case 'message_update':
+                if (event.role !== 'assistant' || !this.slotOpen)
+                    return;
+                // partial 是完整快照——直换非追加（性能：纯文本直推）
+                this.blocks[this.blocks.length - 1] = { kind: 'streaming', text: textOf(event.partial) };
+                break;
+            case 'message_end': {
+                // 判别位在载荷 message.role（事件自身不带 role 字段——轻载荷事件形）
+                const { message } = event;
+                if (message.role === 'assistant') {
+                    if (this.slotOpen) {
+                        this.blocks.pop();
+                        this.slotOpen = false;
+                    }
+                    this.appendAssistantFinal(this.blocks, message);
+                }
+                else if (message.role === 'user') {
+                    this.blocks.push({ kind: 'user', text: textOf(message) });
+                }
+                else if (message.role === 'toolResult') {
+                    this.blocks.push({ kind: 'tool-result', brief: resultBrief(message) });
+                }
+                this.trimToCap();
+                break;
+            }
+            default:
+                break; // turn_*/tool_execution_*/agent_* 正文零渲染（状态面消费）
+        }
+    }
+    /** assistant 定稿展开：文本块非空 → markdown 块；每 toolCall 块 → ⚙ 行块 */
+    appendAssistantFinal(target, message) {
+        // 守卫 + 判别收窄到 AssistantMessage（CustomMessage 判别位是 string——见 textOf 注）
+        if (!isStandardMessage(message) || message.role !== 'assistant')
+            return;
+        const text = textOf(message);
+        if (text !== '')
+            target.push({ kind: 'markdown', doc: MarkdownDoc.of(text) });
+        for (const block of message.content) {
+            if (block.type === 'toolCall') {
+                target.push({ kind: 'tool-call', name: block.name, brief: argsBrief(block.arguments) });
+            }
+        }
+    }
+    /** 帽卸载：超帽从头卸（保留帽内最近段——滚出视口交 scrollback 后内存上限语义；全量档 Infinity 恒不触发） */
+    trimToCap() {
+        if (this.blocks.length > this.blockCap) {
+            this.blocks = this.blocks.slice(this.blocks.length - this.blockCap);
+        }
+    }
+}
+/** ↳ 工具结果简述：文本块首行按显示宽截断（无文本块返占位） */
+function resultBrief(message) {
+    const text = textOf(message);
+    if (text === '')
+        return '(无文本输出)';
+    const firstLine = text.split('\n').find((line) => line.trim() !== '') ?? '';
+    return truncateToWidth(firstLine.trim(), BRIEF_WIDTH);
+}
+//# sourceMappingURL=transcript.js.map

package/dist/src/channels/tui/backend/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../../../../../../src/channels/tui/backend/transcript.ts"],"names":[],"mappings":"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"}

package/dist/src/channels/tui/backend/tui-backend.d.ts

@@ -0,0 +1,324 @@
+import { type AgentMessage } from '../../../contracts/index.js';
+import type { ApprovalAskAnswer, ApprovalAskRequest, NotifyLevel, SessionEnvelope, TodoItem, UiAskOptions, UiBackend, UiInputOptions, UiSelectChoice } from '../../types.js';
+import { type TerminalIO } from '../../engine/index.js';
+import { type AltScreenPrimary } from '../overlay/alt-screen.js';
+import { type MemoryViewerDataDeps } from '../memory/memory-viewer.js';
+import { type AutocompleteSources } from '../autocomplete/autocomplete.js';
+/** 后端构造选项 */
+export interface TuiBackendOptions {
+    /** 当前交互会话位（提交/打断柄的 sessionId 机器位——装配焦点联动可改） */
+    readonly sessionId?: string;
+    /** 装配向接线柄（07 §4.3 两柄）：提交（非命令形文本——驱动 conversation） */
+    readonly onSubmit?: (sessionId: string, text: string) => void;
+    /** 装配向接线柄：打断当前 run（ctrl+c——run 打断经装配侧折入 ask 链收口） */
+    readonly onInterrupt?: (sessionId: string) => void;
+    /** 装配向接线柄：退出（ctrl+d 空框） */
+    readonly onQuit?: () => void;
+    /** 命令柄（'/' 起手文本——03 §2.2 dispatch；false = 未命中落 onSubmit 兜底） */
+    readonly dispatchCommand?: (input: string) => Promise<boolean>;
+    /** 补全三源注入（命令名源注入查询函数接 CommandRegistry.list()；@ 文件段源归装配批） */
+    readonly autocomplete?: AutocompleteSources;
+    /** todo 面板数据源（件 4——装配接 deps 同名面；注入缺席 = 面板缺席零变化） */
+    readonly todoFor?: (sessionId: string) => readonly TodoItem[] | null | undefined;
+    /** 调度注入（启用渲染合并 + fps 帽 + tick 自驱——缺省同步直出测试语义） */
+    readonly schedule?: (fn: () => void, ms: number) => unknown;
+    /** 取消调度注入（与 schedule 配对——stop 时收在飞帧/tick/ESC 窗） */
+    readonly cancelSchedule?: (handle: unknown) => void;
+    /** 时钟注入（缺省 Date.now——fps 帽锚） */
+    readonly now?: () => number;
+    /** lone-ESC 判定窗（ms；缺省 30） */
+    readonly escapeWindowMs?: number;
+    /** 帧率帽 fps（缺省 60——与 Engine DEFAULT_FPS_CAP 对齐） */
+    readonly fpsCap?: number;
+    /** 编辑器最大可视行（装配按终端高 30% 注入；缺省 8） */
+    readonly maxVisibleLines?: number;
+    /** 宿主版本（件 7——title 基线 `berry-agent <版本>`；缺席或空串 = 无版本缀裸名。真值归批 12 host 装配传 HostFace.version） */
+    readonly version?: string;
+}
+/**
+ * run 级用量累计（件 6——agent_start/repaint 归零、turn_end 累加、agent_end
+ * 落行；观测面供装配/宿主侧二次消费，`/usage` 全量面板分职不互替）。
+ */
+export interface UsageAccumulation {
+    readonly input: number;
+    readonly output: number;
+    readonly cacheRead: number;
+    readonly cacheWrite: number;
+    readonly totalTokens: number;
+    /** 累计货币额（cost 在场才累——spec 条款） */
+    readonly cost: number;
+    /** 币种（首见 cost.currency 定着） */
+    readonly currency: string | null;
+}
+/**
+ * TUI 后端：单终端 inline 主屏 + 自持输入管线。构造后须 start()（模式串 +
+ * 清屏 + 滚动区确立）再接核事件；stop() 对称出屏（模式串反序 + raw 复原）。
+ */
+export declare class TuiBackend implements UiBackend<AgentMessage>, AltScreenPrimary {
+    readonly id = "tui";
+    readonly capabilities: Readonly<{
+        notify: true;
+        confirm: true;
+        select: true;
+        input: true;
+        approval: true;
+        setStatus: true;
+        setWidget: false;
+    }>;
+    /** 当前交互会话位（装配焦点联动可改——提交/打断柄的机器位） */
+    sessionId: string;
+    private readonly io;
+    private readonly screen;
+    private readonly transcript;
+    private readonly statusLine;
+    private readonly editor;
+    private readonly popup;
+    private readonly stack;
+    /** overlay 锚定注册表（content 身份键 → 本帧 region——renderFixed 行账重建） */
+    private readonly overlayLayout;
+    /** 装配柄（07 §4.3 两柄 + 命令柄） */
+    private readonly onSubmit;
+    private readonly onInterrupt;
+    private readonly onQuit;
+    private readonly dispatchCommand;
+    private readonly decoder;
+    private readonly escapeWindowMs;
+    private escapeHandle;
+    private unsubInput;
+    private unsubResize;
+    private running;
+    /** 起动过位（lifecycle 的 idle / disposed 分权——一次性事实，start 幂等位之外） */
+    private startedOnce;
+    private priorRaw;
+    private disarmExitRestore;
+    /** 挂起位（suspendMain 置位：渲染请求安全 no-op 闸 + 输入已卸订） */
+    private suspendedMain;
+    /** 停屏期到达的瞬时行缓冲（notify / 件 9 摘要行 / 撤销说明行——复起补显射界，2026-09-07 勘正笔） */
+    private suspendedTransients;
+    /** 副屏宿主（构造晚于 io 赋值——类字段初始化序：宿主构造须见 io 实值） */
+    private readonly altHost;
+    /** 在场副屏句柄（单值承载 /history 与 /memory 两件——无嵌套备屏律；开、q/Esc/Ctrl+D/ask 收四路共闭） */
+    private altHandle;
+    /**
+     * 记忆管理面材料位（mm 批——后置注入）：构造期不可达（memory 件的 dao
+     * 生命周期在插件 apply 内、且 channels 不可 import memory——边表），装配
+     * 根 boot 完成后经 setMemoryScreen 注入真身；null = 材料缺席（openMemory
+     * 返 false——/memory 命令核侧 notify 降级提示）。
+     */
+    private memoryScreen;
+    private readonly scheduleFn;
+    private readonly cancelFn;
+    private readonly now;
+    private readonly minFrameMs;
+    private pendingOps;
+    private needFixed;
+    private frameHandle;
+    private tickHandle;
+    private lastFlushAt;
+    /** input-ask 在飞体（null = 常态——提交落 onSubmit） */
+    private inputAsk;
+    private readonly todoFor;
+    private readonly todoPanel;
+    private readonly toolPanel;
+    /** 当前 turn 的 assistant 消息用量暂存（turn_end 累加——件 6 等价性条款） */
+    private pendingUsage;
+    private usageTotal;
+    /** title 基线（`berry-agent` 或 `berry-agent <版本>`——起屏与复原落点） */
+    private readonly titleBaseline;
+    private readonly osc;
+    /**
+     * 各会话在飞净计数（agent_start +1 / agent_end -1——按信封 sessionId 归
+     * 账，clamp ≥ 0；归零删条目防会话退出残键）。聚焦位不参账：run 跨切焦时
+     * start/end 恒落同一会话账——按事件时刻聚焦位分两路会跨路不对称（末路
+     * end 被 clamp 吞致忙态永残留，07 件 7 判据勘正）。
+     */
+    private readonly inFlightBySession;
+    /** 进度态上次写出（忙闲迁移门——同态静默，周期重发归保活自持） */
+    private progressBusy;
+    constructor(io: TerminalIO, options?: TuiBackendOptions);
+    /** TUI 恒有观众（07 §4.3 观众探针定值） */
+    hasAudience(): boolean;
+    /** 生命周期判定位（AltScreenPrimary 窄介面面：idle 未启 / running 持屏 / suspended 挂起 / disposed 终退） */
+    get lifecycle(): 'idle' | 'running' | 'suspended' | 'disposed';
+    /** 启动：主屏形模式串 + raw + 输入订阅 + 清屏滚动区 + 固定区首画 */
+    start(): void;
+    /** 对称出屏：模式串反序 + 输入卸订 + 定时器全收 + 外显复原 + raw 复原（终退不可复用） */
+    stop(): void;
+    /**
+     * 主屏挂起（AltScreenPrimary 交出半场——批 10f-4；07 §4.1 件 8「主屏挂起 /
+     * 复起交出面（UiBackend 实装件自持）」条款）：
+     * 出屏模式串 + 卸输入监听 + 在途转义一窗全丢 + 停流 + raw 复先验（Engine
+     * suspend 三件套同形——共享 io 换防，副屏随后 start 重装重放流）；渲染请求
+     * 安全 no-op（requestRender / flush 挂起闸——停屏期零写出）；帧合并 / tick /
+     * lone-ESC 窗定时器全收（防后台空转）；硬退复原钩解除（挂起期副屏自担其屏
+     * 的退出复原）。
+     *
+     * 件 7 osc 保活不停（批内裁）：外显态（title / 忙态 OSC 9;4）属终端级非
+     * 主屏 cell 内容——停屏期终端标签页注意力语义照常（onEnvelope 照常归账），
+     * OSC 序列不落 cell 网格不扰动副屏画面。
+     *
+     * 停屏期账不丢：durable 事件照常归约行集模型（复起全帧重画携带——树已含
+     * 停屏期全部事件）；瞬时行（notify / 件 9 摘要行 / 撤销说明行）入
+     * suspendedTransients 缓冲——复起补显射界含瞬时行（树按字面不含不入树的
+     * 瞬时行，2026-09-07 遗漏审计批补笔）。
+     */
+    suspendMain(): void;
+    /**
+     * 主屏复起（AltScreenPrimary 交出半场的对称复位）：进屏模式串 + 硬退钩
+     * 重武装 + raw 重设 + 输入重装 + 显式放流（已被 pause 的流再挂监听不自动回
+     * flowing——Engine resume 同形）+ **全帧重画不走（通道）repaint**：主屏既有
+     * 权威全量重建路（几何真值重取 + 清屏 + 行集全量重写）+ 瞬时行缓冲补吐。
+     *
+     * 不走（通道）repaint 的行为锁：通道 repaint 按投影重建行集，投影不含停屏
+     * 期直写主屏的瞬时行——全帧重画以行集 + 瞬时缓冲为真相，瞬时行在场即补显
+     * （07 件 8「repaint 清树会抹掉停屏期入树的瞬时行」+ 2026-09-07 勘正笔）。
+     * 停屏期 resize 由几何真值重取吸收（挂起期 handleResize 安全 no-op——此刻
+     * 写出会污染在场副屏）。
+     */
+    resumeMain(): void;
+    /**
+     * 开副屏回看器（UiBackend 可选能力面实装——通道核 /history 命令到达扇出）：
+     * 挂起主屏 → 1049 副屏 HistoryViewer（同一渲染管线全量档——件 8 数据源
+     * 条款）。已在副屏 no-op（无嵌套备屏）；主屏不在 running 态 open 被拒
+     * （句柄 null——保持无副屏态）。Ctrl+C / Ctrl+D 副屏键面经 viewer 装配柄
+     * 透传本件两柄（与主屏同键面）。
+     */
+    openHistory(sessionId: string, messages: readonly AgentMessage[]): void;
+    /**
+     * 记忆管理面材料注入（mm 批——后置 init 位）：装配根 boot 完成后从
+     * core:memory 服务面取材料注入（ownerKeys/DAO 窄面/消毒函数/导出闭包——
+     * 真身经装配传真）。null = 撤材料（件卸载形——后续 openMemory 返 false）。
+     */
+    setMemoryScreen(deps: MemoryViewerDataDeps | null): void;
+    /**
+     * 开副屏记忆管理面（UiBackend 可选能力面实装——通道核 /memory 命令到达
+     * 扇出；06 §7 形态定形注）：材料缺席或已在副屏返 false（核侧 notify 降级
+     * 提示）；退出三柄本件自持（打断 = 当前交互会话位——与提交柄同锚）。
+     */
+    openMemory(): boolean;
+    /**
+     * 收副屏（UiBackend 可选能力面实装——UiCore ask 入口扇出「先收副屏再入
+     * 提问队列」，07 §4.1 件 8 注意力优先级 ask > 回看条款；viewer 退出键
+     * 同路收口；/history 与 /memory 两件共口——在场者谁收谁）。幂等：无副屏 no-op。
+     */
+    collapseAltScreen(): void;
+    /** 副屏统一收口：句柄 close（AltScreenHost 编舞：出副屏 + 主屏复起全帧重画） */
+    private closeAlt;
+    /** 一次性通知：正文瞬时行直写（级别符号前缀——不进行集） */
+    notify(message: string, opts?: {
+        level?: NotifyLevel;
+    }): void;
+    /**
+     * 瞬时说明行入正文流（notify 与 ask 撤销说明行共用路——07 §4.3「曾在屏
+     * 者由通道上撤销说明行」）：op 入合并队列 + 渲染请求（同步直出模式立即
+     * 落地；注入调度随帧合并——transient 到达序保持）。挂起期入缓冲账不丢
+     * （复起补显射界含瞬时行——批 10f-4）。
+     */
+    private appendTransientLine;
+    /** 状态行文案（last-writer-wins——StatusLine 件语义） */
+    setStatus(_sessionId: string, status: string): void;
+    /** 活体信封呈现：渲染归约 + 摘要行分叉 + 聚焦态状态面消费 */
+    onEnvelope(env: SessionEnvelope, focused: boolean): void;
+    /** 重画呈现：投影重建行集 + 清屏全量重写（widget 槽值不支撑——忽略） */
+    onRepaint(sessionId: string, projection: readonly AgentMessage[], _widget: {
+        node: unknown;
+    } | null): void;
+    /** 状态行动画推帧（自驱定时器内调；公开面留装配侧手动驱动——忙态外零开销） */
+    tick(): void;
+    /** run 级用量累计观测面（件 6——装配/宿主侧二次消费） */
+    get usageView(): UsageAccumulation;
+    /** resize 编舞：几何重取 + 主屏全量重画 + 固定区按新几何重建（权威重建不走队列） */
+    handleResize(): void;
+    /** 是/否确认：ConfirmPanel 浮层（Enter → true / Esc → false；signal abort 保守值 + 关层 + 撤销说明行） */
+    confirm(message: string, opts?: UiAskOptions): Promise<boolean>;
+    /** 单选：SelectPanel 浮层（Enter → value / Esc → ''；ui-core 校验不在集保守值同收 ''） */
+    select(message: string, choices: readonly UiSelectChoice[], opts?: UiAskOptions): Promise<string>;
+    /**
+     * 自由文本：input-ask 形——提示行入固定区 + 编辑器转应答车（提交即应答，
+     * 弹层抑制）；signal abort → '' 保守值 + 残稿清框 + 撤销说明行（07 §4.3
+     * 撤销面——提示行曾在固定区在屏，abort 收口正文流落 ⏹ 行）。
+     */
+    input(message: string, opts?: UiInputOptions): Promise<string>;
+    /**
+     * 审批：SelectPanel 浮层四值（批准/拒绝/总是批准/取消——Esc 面板保守值 ''
+     * 映射 cancel，与 07 §4.3 收口律对齐）；always 草案经 hint 段呈现（回写
+     * 归通道核 settleApprovalAlways——本件只呈现与回值）。signal abort 收口
+     * 'cancel' 保守值 + 撤销说明行（文案「审批」区分于 input/confirm/select
+     * 三件——07 §4.3 撤销面）。
+     */
+    askApproval(_sessionId: string, request: ApprovalAskRequest, opts?: UiAskOptions): Promise<ApprovalAskAnswer>;
+    /** 输入处理器：decoder 喂入 + lone-ESC 窗定时器（同步直出模式无窗即决） + 事件路由 */
+    private readonly handleInput;
+    /** 排空 decoder 事件队列并逐件路由 */
+    private flushDecoderEvents;
+    /**
+     * 事件路由四层（07 §4.3 拦截链序）。
+     * 层① 全局键先于 overlay（ctrl+c 打断 run——ask 链收口经装配侧信号折入；
+     * ctrl+d 仅 overlay 空 + 编辑器空框才全局退出，否则让路面板/编辑器）；
+     * 层② overlay 模态独占（未消费键不穿透）；层③ 补全弹层非模态穿透；
+     * 层④ 编辑器（未消费键终局丢弃——escape 等无全局绑定）。
+     */
+    private routeEvent;
+    /** 编辑器提交路由：input-ask 应答优先 → '/' 命令柄（false 兜底）→ onSubmit */
+    private handleSubmit;
+    /** 编辑器内容变更：补全层重取（应答期抑制）+ 固定区脏位 */
+    private handleEditorChange;
+    /**
+     * 开 ask 浮层：锚定注册表锚 + signal abort 保守值收口 + 撤销说明行 + 重绘
+     * 请求。
+     *
+     * 「曾在屏者」判据（07 §4.3 语义纪律撤销面——confirm / select / askApproval
+     * 三路共用本层，统一处理）：abort 传播到后端呈现时层仍未关（在 overlay 栈
+     * 中）= 曾在屏 → 撤销说明行入正文流；面板已 done（onFinish 先关层）后迟
+     * 到的 abort 是 no-op，不误写。说明行只标撤销收场本身——保守值收口（与提
+     * 问队列收口三则「保守值同撤销面」同源条款：审批项收 'cancel'、阻塞件各
+     * 收保守值）由 promise 回值承载，行文不重复。
+     */
+    private openAskLayer;
+    /** 锚定闭包：读 renderFixed 行账（首帧前回退固定区顶整宽） */
+    private anchorFor;
+    /** present op 入队（连续 present 合并留末次——到达序相对 transient 保持） */
+    private enqueuePresent;
+    /** 固定区脏位 + 渲染请求（touch 固定区的统一入口） */
+    private touchFixed;
+    /** 渲染请求（合并位）：同步直出立即 flush；注入调度则 fps 帽下排帧 */
+    private requestRender;
+    /** 帧落地：op 队列按到达序执行 + 固定区脏位一帧一次重建 */
+    private flush;
+    /** 状态行转轮自驱定时器（注入调度后自重排；忙态外 tick 零开销） */
+    private armTick;
+    /** 定时器收口（frame/tick/escape 三名） */
+    private cancelTimer;
+    /**
+     * 聚焦事件的固定区消费面：run 启停驱动忙态与 usage 累计（件 6）、工具
+     * 执行驱动状态行工具名与进度面板（件 3/5）、tool_execution_end/agent_end
+     * 驱动 todo 刷新（件 4）。（执行层事件正文零渲染——07 §4.1 直播路渲染
+     * 单源的刻意分立。）
+     */
+    private applyFocusedEvent;
+    /** usage 归零清行（agent_start / repaint——件 6 清账重计条款） */
+    private resetUsage;
+    /** turn_end 累加（暂存的 assistant 用量并入 run 级账本；cost 在场累货币额） */
+    private accumulateUsage;
+    /** todo 面板刷新（todoFor 注入缺席 = 面板缺席零变化——件 4 条款） */
+    private refreshTodo;
+    /**
+     * 件 7 进度态按会话净计数（任一会话在飞即忙——终端标签页注意力模型）：
+     * agent_start +1 / agent_end -1，均按信封 sessionId 归账、clamp ≥ 0（进程
+     * 内事件无错过窗——clamp 只防重复 end 不穿底；归零删条目）。聚焦位不参
+     * 账（07 件 7 判据勘正——事件时刻聚焦位分两路在切焦场景与主句背离）。
+     * 忙闲迁移才写 progress 序列（同态静默——周期重发归 osc 保活自持）。
+     * stop 后静默短路（终退不再写字节）。
+     */
+    private trackProgress;
+    /**
+     * 固定区 v2 重建（自上而下段序）：overlay 段（各层量高叠放 + 锚定注册表
+     * 行账）→ todo 面板（件 4——todoFor 缺席/空表即零行）→ input-ask 提示行
+     * → 补全弹层 → 编辑器（动态量高；聚焦态 = 无 overlay 占焦）→ 工具进度
+     * 面板（件 5——与状态行分职互补相邻）→ 状态行。编辑光标经 EditorView
+     * setCursor 声明 → MainScreen.setFixed 声明位落 cup。
+     */
+    private renderFixed;
+    /** 硬退复原钩子（仅真 ProcessTerminalIO——注入 io 零污染；Engine 同形） */
+    private armExitRestore;
+}