berry-agent-sdk 0.1.0-alpha.2

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

@@ -0,0 +1,90 @@
+/**
+ * 主屏 inline 形态编舞件（07 §4.1「屏幕模型双形态」主屏条——批 10e）。
+ *
+ * 物理形态（与副屏全屏网格分立、共用 cell/diff/width 基座——07 篇定形）：
+ * - **DECSTBM 滚动区**承载正文（顶行到固定区上方）：区底写满自动滚、
+ *   滚出视口整行交终端原生 scrollback（历史真相在 durable 事件日志，行集
+ *   是帽内最近段的内存上限语义）；
+ * - **固定区钉屏底**（区外行不被滚动卷入、绝对位可知）：输入框 + 状态行，
+ *   行级差分重画（变行整行重写、未变行零写出——擦除只走 EL 禁空格填充）；
+ * - **正文块直写**：块 → 行序列化 → 追加写（追加不回改——直播路「消息事件
+ *   唯一渲染源」的物理形）；流式槽原位换装是视口内唯一差分。序列化单源走
+ *   renderBlockLines（批 10f-4 提取——件 8 回看器全量档复用同一渲染管线，
+ *   零第二渲染器）。
+ *
+ * 编舞状态模型：**绝对行跟踪**。件内维护光标绝对行 cursorRow 与 durable
+ * 末行 durableEndRow（= 下一条追加的落笔行 = 流式槽首行），每次写行经
+ * writeLine 单点维护（区底 LF 触滚钉区底——滚动量不外显）；present 尾光标
+ * 归固定区末行行首（呈现不变式——编舞内相对定位全由此出发；固定区自身用
+ * 绝对 CUP，钉屏底位可知）。
+ *
+ * v1 已知边界：流式槽 partial 回缩（新行数少于旧）按余行 EL 清——inline
+ * 终端无删行机制；固定区高度变化时光标账按区底钳制（内容可能被固定区
+ * 覆盖——装配宜随高度变化触发 repaint 重建）。
+ */
+import { CellGrid, type TerminalIO } from '../../engine/index.js';
+import { type TranscriptBlock } from './transcript.js';
+/** 主屏选项 */
+export interface MainScreenOptions {
+    /** 固定区高（行——输入框 + 状态行；随内容折行动态变化经 setFixed 更新） */
+    readonly fixedHeight: number;
+}
+/**
+ * 主屏编舞：正文直写 + 槽换装 + 固定区差分。无自驱时钟（请求合并归装配），
+ * 所有公开方法同步产写出（测试经 MemoryTerminalIO 收帧断言）。
+ */
+export declare class MainScreen {
+    private readonly io;
+    private columns;
+    private rows;
+    private fixedHeight;
+    /** 已直写 durable 块数（增量追加起点——repaint 归零全量重写） */
+    private writtenBlocks;
+    /** 光标绝对行（0 基——写行/定位单点维护） */
+    private cursorRow;
+    /** durable 末行（追加落笔行 = 槽首行；滚动时钉区底） */
+    private durableEndRow;
+    /** 当前槽直写行数（余行清除上界依据） */
+    private slotLineCount;
+    /** 固定区网格（装配画好交入——null = 固定区未装配只归位光标） */
+    private fixedGrid;
+    /** 固定区上次呈现网格（行级差分基准；null = 全量重画） */
+    private prevFixed;
+    constructor(io: TerminalIO, options: MainScreenOptions);
+    /** 几何观测（装配层 resize 编舞消费） */
+    get geometry(): {
+        columns: number;
+        rows: number;
+    };
+    /** 启动编舞：清屏 + 滚动区确立 + 光标归位（呈现不变式自洽） */
+    start(): void;
+    /**
+     * 增量呈现（追加块直写 → 槽换装 → 余行清除 → 固定区差分）。
+     * 前置：光标在固定区末行行首（start / setFixed / 上次 present 归位）。
+     */
+    present(blocks: readonly TranscriptBlock[]): void;
+    /**
+     * 瞬时行直写（非聚焦摘要行 / notify 通知行——不进行集不记 writtenBlocks，
+     * repaint 不重建）。编舞同追加块：归 durable 末 → 写行 → 余行清除 → 归位。
+     * 行内容由调用方（TuiBackend）序列化——本件纯编舞不做着色决策。
+     */
+    appendTransient(lines: readonly string[]): void;
+    /** 固定区网格更新（装配直呼——行级差分；几何变化时滚动区重设 + 差分基准失效） */
+    setFixed(grid: CellGrid): void;
+    /** repaint（焦点切换）：清屏 + 行集全量重写（投影即真相——scrollback 旧内容不参与） */
+    repaint(blocks: readonly TranscriptBlock[]): void;
+    /** resize 编舞：几何重取 + 滚动区重设 + 全量重画（弃旧换新——宽字符 reflow 必失真） */
+    handleResize(blocks: readonly TranscriptBlock[]): void;
+    /** 滚动区确立/重设（DECSTBM 规范行为是光标归 home——随后显式归位呈现不变式位） */
+    private applyScrollRegion;
+    /** 写一行（CR 起笔 + LF 推进）并维护 cursorRow；区底 LF 触滚——内容整体上移一格、durableEndRow 同步减一（账不漂移） */
+    private writeLine;
+    /** 光标归行（present 入口光标在固定区末行——CUU 相对定位即可达全屏任意行） */
+    private gotoRow;
+    /** 固定区差分重画 + 光标落位（编辑光标外显的物理位） */
+    private redrawFixed;
+    /** 块 → 行序列化直写（序列化单源 renderBlockLines——件 8 回看器复用同一管线，批 10f-4） */
+    private writeBlockLines;
+    /** 流式槽行（纯文本直推——性能：不走网格不走样式；序列化同源 renderBlockLines） */
+    private renderSlotLines;
+}

package/dist/src/channels/tui/backend/main-screen.js

@@ -0,0 +1,208 @@
+/**
+ * 主屏 inline 形态编舞件（07 §4.1「屏幕模型双形态」主屏条——批 10e）。
+ *
+ * 物理形态（与副屏全屏网格分立、共用 cell/diff/width 基座——07 篇定形）：
+ * - **DECSTBM 滚动区**承载正文（顶行到固定区上方）：区底写满自动滚、
+ *   滚出视口整行交终端原生 scrollback（历史真相在 durable 事件日志，行集
+ *   是帽内最近段的内存上限语义）；
+ * - **固定区钉屏底**（区外行不被滚动卷入、绝对位可知）：输入框 + 状态行，
+ *   行级差分重画（变行整行重写、未变行零写出——擦除只走 EL 禁空格填充）；
+ * - **正文块直写**：块 → 行序列化 → 追加写（追加不回改——直播路「消息事件
+ *   唯一渲染源」的物理形）；流式槽原位换装是视口内唯一差分。序列化单源走
+ *   renderBlockLines（批 10f-4 提取——件 8 回看器全量档复用同一渲染管线，
+ *   零第二渲染器）。
+ *
+ * 编舞状态模型：**绝对行跟踪**。件内维护光标绝对行 cursorRow 与 durable
+ * 末行 durableEndRow（= 下一条追加的落笔行 = 流式槽首行），每次写行经
+ * writeLine 单点维护（区底 LF 触滚钉区底——滚动量不外显）；present 尾光标
+ * 归固定区末行行首（呈现不变式——编舞内相对定位全由此出发；固定区自身用
+ * 绝对 CUP，钉屏底位可知）。
+ *
+ * v1 已知边界：流式槽 partial 回缩（新行数少于旧）按余行 EL 清——inline
+ * 终端无删行机制；固定区高度变化时光标账按区底钳制（内容可能被固定区
+ * 覆盖——装配宜随高度变化触发 repaint 重建）。
+ */
+import { CellGrid } from '../../engine/index.js';
+import { CLEAR_SCREEN, CR, cud, cuu, EL_TO_EOL, LF, renderFixedRegionDiff, setScrollRegion, cup } from './ansi-rows.js';
+import { renderBlockLines } from './transcript.js';
+/** 缺省几何（真值以 io.size() 为准——resize 路装配调 handleResize） */
+const DEFAULT_COLUMNS = 80;
+const DEFAULT_ROWS = 24;
+/**
+ * 主屏编舞：正文直写 + 槽换装 + 固定区差分。无自驱时钟（请求合并归装配），
+ * 所有公开方法同步产写出（测试经 MemoryTerminalIO 收帧断言）。
+ */
+export class MainScreen {
+    io;
+    columns = DEFAULT_COLUMNS;
+    rows = DEFAULT_ROWS;
+    fixedHeight;
+    /** 已直写 durable 块数（增量追加起点——repaint 归零全量重写） */
+    writtenBlocks = 0;
+    /** 光标绝对行（0 基——写行/定位单点维护） */
+    cursorRow = 0;
+    /** durable 末行（追加落笔行 = 槽首行；滚动时钉区底） */
+    durableEndRow = 0;
+    /** 当前槽直写行数（余行清除上界依据） */
+    slotLineCount = 0;
+    /** 固定区网格（装配画好交入——null = 固定区未装配只归位光标） */
+    fixedGrid = null;
+    /** 固定区上次呈现网格（行级差分基准；null = 全量重画） */
+    prevFixed = null;
+    constructor(io, options) {
+        this.io = io;
+        this.fixedHeight = options.fixedHeight;
+        const size = io.size();
+        this.columns = size.columns;
+        this.rows = size.rows;
+    }
+    /** 几何观测（装配层 resize 编舞消费） */
+    get geometry() {
+        return { columns: this.columns, rows: this.rows };
+    }
+    /** 启动编舞：清屏 + 滚动区确立 + 光标归位（呈现不变式自洽） */
+    start() {
+        this.io.write(CLEAR_SCREEN);
+        this.applyScrollRegion();
+    }
+    /**
+     * 增量呈现（追加块直写 → 槽换装 → 余行清除 → 固定区差分）。
+     * 前置：光标在固定区末行行首（start / setFixed / 上次 present 归位）。
+     */
+    present(blocks) {
+        // 末块为 streaming 时即流式槽（const 绑定经 kind 判别收窄）
+        const last = blocks.length > 0 ? blocks[blocks.length - 1] : null;
+        const slot = last !== null && last.kind === 'streaming' ? last : null;
+        const durableCount = slot === null ? blocks.length : blocks.length - 1;
+        // 余行清除上界：上次呈现的槽末行（= durable 末 + 槽行数 - 1——本帧前的账）
+        const prevBottomRow = Math.min(this.rows - this.fixedHeight - 1, this.durableEndRow + this.slotLineCount - 1);
+        // 光标归 durable 末（B/C 共同起点——无新增块时 C 段也从这里起笔）
+        this.gotoRow(this.durableEndRow);
+        // B. 追加块直写（每行 CR 起笔 + LF 推进，区底触滚交 scrollback）
+        if (durableCount > this.writtenBlocks) {
+            for (let i = this.writtenBlocks; i < durableCount; i++) {
+                this.writeBlockLines(blocks[i]);
+            }
+            this.writtenBlocks = durableCount;
+            this.durableEndRow = this.cursorRow;
+        }
+        // C. 槽换装（光标已在槽首 = durable 末；partial 是完整快照——逐行整写）
+        const slotLines = slot === null ? [] : this.renderSlotLines(slot);
+        for (const line of slotLines) {
+            this.writeLine(line);
+        }
+        // D. 余行清除（新槽末到上次槽末之间的 stale 行——EL 擦除禁空格填充）
+        const fixedTop = this.rows - this.fixedHeight;
+        const clearEnd = Math.min(fixedTop - 1, prevBottomRow);
+        for (let row = this.cursorRow; row <= clearEnd; row++) {
+            this.io.write((row > this.cursorRow ? cud(1) : '') + CR + EL_TO_EOL);
+        }
+        // E. 固定区差分重画 + 光标归位（呈现不变式）
+        this.redrawFixed();
+        this.slotLineCount = slotLines.length;
+    }
+    /**
+     * 瞬时行直写（非聚焦摘要行 / notify 通知行——不进行集不记 writtenBlocks，
+     * repaint 不重建）。编舞同追加块：归 durable 末 → 写行 → 余行清除 → 归位。
+     * 行内容由调用方（TuiBackend）序列化——本件纯编舞不做着色决策。
+     */
+    appendTransient(lines) {
+        if (lines.length === 0)
+            return;
+        this.gotoRow(this.durableEndRow);
+        for (const line of lines) {
+            this.writeLine(line);
+        }
+        this.durableEndRow = this.cursorRow;
+        const fixedTop = this.rows - this.fixedHeight;
+        const clearEnd = Math.min(fixedTop - 1, this.durableEndRow + this.slotLineCount - 1);
+        for (let row = this.cursorRow; row <= clearEnd; row++) {
+            this.io.write((row > this.cursorRow ? cud(1) : '') + CR + EL_TO_EOL);
+        }
+        this.redrawFixed();
+    }
+    /** 固定区网格更新（装配直呼——行级差分；几何变化时滚动区重设 + 差分基准失效） */
+    setFixed(grid) {
+        if (grid.rows !== this.fixedHeight) {
+            this.fixedHeight = grid.rows;
+            this.applyScrollRegion();
+            this.prevFixed = null; // 高度变化——差分基准失效全量重画；durable 末行按区底钳
+            this.durableEndRow = Math.min(this.durableEndRow, this.rows - this.fixedHeight - 1);
+            this.slotLineCount = 0;
+        }
+        this.fixedGrid = grid;
+        this.redrawFixed();
+    }
+    /** repaint（焦点切换）：清屏 + 行集全量重写（投影即真相——scrollback 旧内容不参与） */
+    repaint(blocks) {
+        this.writtenBlocks = 0;
+        this.slotLineCount = 0;
+        this.durableEndRow = 0;
+        this.io.write(CLEAR_SCREEN);
+        this.applyScrollRegion();
+        this.present(blocks);
+    }
+    /** resize 编舞：几何重取 + 滚动区重设 + 全量重画（弃旧换新——宽字符 reflow 必失真） */
+    handleResize(blocks) {
+        const size = this.io.size();
+        this.columns = size.columns;
+        this.rows = size.rows;
+        this.repaint(blocks);
+    }
+    /* ---------------- 内部编舞 ---------------- */
+    /** 滚动区确立/重设（DECSTBM 规范行为是光标归 home——随后显式归位呈现不变式位） */
+    applyScrollRegion() {
+        const bottom = Math.max(1, this.rows - this.fixedHeight);
+        this.io.write(setScrollRegion(bottom));
+        this.io.write(cup(this.rows - 1, 0));
+        this.cursorRow = this.rows - 1;
+    }
+    /** 写一行（CR 起笔 + LF 推进）并维护 cursorRow；区底 LF 触滚——内容整体上移一格、durableEndRow 同步减一（账不漂移） */
+    writeLine(text) {
+        this.io.write(CR + text + LF);
+        const regionBottom = this.rows - this.fixedHeight - 1;
+        if (this.cursorRow < regionBottom)
+            this.cursorRow++;
+        else if (this.durableEndRow > 0)
+            this.durableEndRow--; // 触滚：已写内容上移（B 段随后整账重赋、槽写路保持真值）
+    }
+    /** 光标归行（present 入口光标在固定区末行——CUU 相对定位即可达全屏任意行） */
+    gotoRow(row) {
+        const distance = this.cursorRow - row;
+        if (distance > 0)
+            this.io.write(cuu(distance));
+        else if (distance < 0)
+            this.io.write(cud(-distance));
+        this.cursorRow = row;
+    }
+    /** 固定区差分重画 + 光标落位（编辑光标外显的物理位） */
+    redrawFixed() {
+        if (this.fixedGrid !== null) {
+            const baseRow = this.rows - this.fixedGrid.rows;
+            this.io.write(renderFixedRegionDiff(this.prevFixed, this.fixedGrid, baseRow));
+            this.prevFixed = this.fixedGrid;
+            // 光标声明位落位（EditorView 编辑位经 setCursor 声明）——绝对 CUP 且
+            // 行账同步（gotoRow 相对定位数学依赖 cursorRow 真值）；无声明回退
+            // 屏底行首（呈现不变式原样）
+            const declared = this.fixedGrid.cursor;
+            if (declared !== null) {
+                const row = Math.min(baseRow + declared.row, this.rows - 1); // 越界声明防御钳屏底
+                this.io.write(cup(row, declared.col));
+                this.cursorRow = row;
+                return;
+            }
+        }
+        this.io.write(cup(this.rows - 1, 0));
+        this.cursorRow = this.rows - 1;
+    }
+    /** 块 → 行序列化直写（序列化单源 renderBlockLines——件 8 回看器复用同一管线，批 10f-4） */
+    writeBlockLines(block) {
+        for (const line of renderBlockLines(block, this.columns))
+            this.writeLine(line);
+    }
+    /** 流式槽行（纯文本直推——性能：不走网格不走样式；序列化同源 renderBlockLines） */
+    renderSlotLines(slot) {
+        return renderBlockLines(slot, this.columns);
+    }
+}
+//# sourceMappingURL=main-screen.js.map

package/dist/src/channels/tui/backend/main-screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-screen.js","sourceRoot":"","sources":["../../../../../../../src/channels/tui/backend/main-screen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,QAAQ,EAAmB,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,qBAAqB,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACxH,OAAO,EAAE,gBAAgB,EAAwB,MAAM,iBAAiB,CAAC;AAQzE,uDAAuD;AACvD,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB;;;GAGG;AACH,MAAM,OAAO,UAAU;IACJ,EAAE,CAAa;IACxB,OAAO,GAAG,eAAe,CAAC;IAC1B,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,CAAS;IAC5B,6CAA6C;IACrC,aAAa,GAAG,CAAC,CAAC;IAC1B,4BAA4B;IACpB,SAAS,GAAG,CAAC,CAAC;IACtB,qCAAqC;IAC7B,aAAa,GAAG,CAAC,CAAC;IAC1B,wBAAwB;IAChB,aAAa,GAAG,CAAC,CAAC;IAC1B,wCAAwC;IAChC,SAAS,GAAoB,IAAI,CAAC;IAC1C,oCAAoC;IAC5B,SAAS,GAAoB,IAAI,CAAC;IAE1C,YAAY,EAAc,EAAE,OAA0B;QACpD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,4BAA4B;IAC5B,IAAI,QAAQ;QACV,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,sCAAsC;IACtC,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,MAAkC;QACxC,2CAA2C;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,MAAM,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACvE,gDAAgD;QAChD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;QAE9G,2CAA2C;QAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEjC,8CAA8C;QAC9C,IAAI,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACtC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;YAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;QACtC,CAAC;QAED,iDAAiD;QACjD,MAAM,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAClE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;QACvD,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QACvE,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,KAAwB;QACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;QACrF,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,8CAA8C;IAC9C,QAAQ,CAAC,IAAc;QACrB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;YAC7B,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,kCAAkC;YACzD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;YACpF,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,0DAA0D;IAC1D,OAAO,CAAC,MAAkC;QACxC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,0DAA0D;IAC1D,YAAY,CAAC,MAAkC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,4CAA4C;IAE5C,oDAAoD;IAC5C,iBAAiB;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACzD,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,kFAAkF;IAC1E,SAAS,CAAC,IAAY;QAC5B,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,SAAS,GAAG,YAAY;YAAE,IAAI,CAAC,SAAS,EAAE,CAAC;aAC/C,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC;YAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,+BAA+B;IACxF,CAAC;IAED,iDAAiD;IACzC,OAAO,CAAC,GAAW;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACtC,IAAI,QAAQ,GAAG,CAAC;YAAE,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;aAC1C,IAAI,QAAQ,GAAG,CAAC;YAAE,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;IACvB,CAAC;IAED,iCAAiC;IACzB,WAAW;QACjB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAChD,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;YAC9E,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAChC,kDAAkD;YAClD,4CAA4C;YAC5C,gBAAgB;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YACvC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY;gBACzE,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;gBACtC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;gBACrB,OAAO;YACT,CAAC;QACH,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,gEAAgE;IACxD,eAAe,CAAC,KAAsB;QAC5C,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC;IAED,sDAAsD;IAC9C,eAAe,CAAC,IAA2D;QACjF,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;CACF"}

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

@@ -0,0 +1,79 @@
+/**
+ * 终端外显件（07 §4.1 呈现面件 7——OSC 标题 + OSC 9;4 进度态）。
+ *
+ * 语义平移 pi-tui Terminal setTitle/setProgress（自研改裁——字节形锚定
+ * 参考源码/pi-monorepo/packages/tui/src/terminal.ts：title = OSC 0;… BEL、
+ * 忙态 = `\x1b]9;4;3\x07`、清零 = `\x1b]9;4;0\x07`、keepalive 1s）。
+ * - **OSC 写出分治**（07 §4.1 件 7 条款）：title 值缓存去重（同值不重写
+ *   字节）；progress 态**保活周期重发**——OSC 9;4 在部分终端超时衰减，去重
+ *   不适用于 progress 序列、须周期重写维持；
+ * - **OSC 52 选区复制序列构造**（2026-09-11 鼠标解码批——件 8 选区复制）：
+ *   buildOsc52Copy 纯函数（无状态无缓存——写出与否归装配层注入柄）；
+ * - 进度态判据（按 sessionId 归账的 agent_start/end 净计数、任一会话 > 0
+ *   即忙）在 TuiBackend 侧——本件只承「忙/闲」两态写出与保活自持；
+ * - 退出复原两写点：title 复原基线 + 进度清零（restore——TuiBackend 的
+ *   stop 与硬退复原钩子两消费点）。
+ *
+ * 可测性：写出走注入 TerminalIO 形参（勿直写 process）；保活 timer 走
+ * schedule 注入（TuiBackend armTick 同形），停针暴露名册语义（句柄非空才
+ * 取消、停后清位——cancelTimer 同律）。schedule 缺席 = 保活缺位（忙态首写
+ * 仍在——同步测试语义，与 TuiBackend「无注入调度 = 同步直出」同构）。
+ */
+import type { TerminalIO } from '../../engine/index.js';
+/** 保活重发周期（ms——pi-tui TERMINAL_PROGRESS_KEEPALIVE_MS 实证值） */
+export declare const OSC_PROGRESS_KEEPALIVE_MS = 1000;
+/**
+ * OSC 52 选区复制序列（07 §4.1 呈现面件 8 细则——BEL 终界）：
+ * `\x1b]52;c;<base64>\x07`，`c` = 系统剪贴板主位。终端支持不可探测（无标准
+ * 应答——kitty/Alacritty/wezterm/foot 支持、iTerm2 默认禁需用户开、tmux 需
+ * set-clipboard on、xterm 兼容族受 allowWindowOps 门控）——尽力写出无反馈，
+ * 不构成故障面。写出柄归装配层注入（onCopy），本函数只铸字节。
+ */
+export declare function buildOsc52Copy(text: string): string;
+/** 调度注入形（与 TuiBackend schedule 注入同形——(fn, ms) → 句柄） */
+export type OscSchedule = (fn: () => void, ms: number) => unknown;
+/** 终端外显件构造选项 */
+export interface OscDisplayOptions {
+    /** title 复原基线（退出复原落点——起屏基线形如 `berry-agent <版本>`） */
+    readonly baseline: string;
+    /** 调度注入（保活周期重发；缺席 = 保活缺位——忙态首写不受影响） */
+    readonly schedule?: OscSchedule;
+    /** 取消调度注入（与 schedule 配对——停针名册语义的取消出口） */
+    readonly cancel?: (handle: unknown) => void;
+}
+/**
+ * 终端外显件：OSC title + 进度态两写点的最小自持件。
+ * 忙态期间保活自重排（触发即清位再续针——armTick 同形）；restore/停针后
+ * 句柄位归 null，重复停针是 no-op。
+ */
+export declare class OscDisplay {
+    /** title 值缓存（null = 未写过——同值不重写判据位） */
+    private lastTitle;
+    /** 保活在飞句柄（null = 无在飞——名册语义判据位） */
+    private keepaliveHandle;
+    private readonly io;
+    private readonly baseline;
+    private readonly schedule;
+    private readonly cancel;
+    constructor(io: TerminalIO, options: OscDisplayOptions);
+    /** 在飞保活句柄现值（null = 无在飞——名册摘除/测试断言位） */
+    get activeKeepalive(): unknown;
+    /** 标题写出（OSC 0;… BEL——值缓存去重：同值不重写字节） */
+    setTitle(title: string): void;
+    /**
+     * 进度态写出（OSC 9;4）：
+     * - true = 写忙态序列 + 起 1s 保活周期重发（已在飞不重复起针——重发维持
+     *   单链不叠针）；同值重复调用仍重写忙态序列（去重不适用于 progress）；
+     * - false = 写清零序列 + 停保活 timer。
+     */
+    setProgress(active: boolean): void;
+    /**
+     * 退出复原两写点齐（07 §4.1 件 7 条款）：title 复原基线（经值缓存——
+     * 已在基线则零字节）+ 进度清零（无条件写——终态收口，含停保活）。
+     */
+    restore(): void;
+    /** 停保活定时器（名册语义：句柄非空才取消、停后清位——重复停针 no-op） */
+    stopKeepalive(): void;
+    /** 起保活（schedule 缺席 = 缺位；触发后清位自重排续针——周期重发维持） */
+    private armKeepalive;
+}

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

@@ -0,0 +1,92 @@
+/** 保活重发周期（ms——pi-tui TERMINAL_PROGRESS_KEEPALIVE_MS 实证值） */
+export const OSC_PROGRESS_KEEPALIVE_MS = 1000;
+/** OSC 9;4 忙态序列（indeterminate progress——state 3） */
+const PROGRESS_ACTIVE_SEQUENCE = '\x1b]9;4;3\x07';
+/** OSC 9;4 清零序列（state 0） */
+const PROGRESS_CLEAR_SEQUENCE = '\x1b]9;4;0\x07';
+/**
+ * OSC 52 选区复制序列（07 §4.1 呈现面件 8 细则——BEL 终界）：
+ * `\x1b]52;c;<base64>\x07`，`c` = 系统剪贴板主位。终端支持不可探测（无标准
+ * 应答——kitty/Alacritty/wezterm/foot 支持、iTerm2 默认禁需用户开、tmux 需
+ * set-clipboard on、xterm 兼容族受 allowWindowOps 门控）——尽力写出无反馈，
+ * 不构成故障面。写出柄归装配层注入（onCopy），本函数只铸字节。
+ */
+export function buildOsc52Copy(text) {
+    return `\x1b]52;c;${Buffer.from(text, 'utf8').toString('base64')}\x07`;
+}
+/**
+ * 终端外显件：OSC title + 进度态两写点的最小自持件。
+ * 忙态期间保活自重排（触发即清位再续针——armTick 同形）；restore/停针后
+ * 句柄位归 null，重复停针是 no-op。
+ */
+export class OscDisplay {
+    /** title 值缓存（null = 未写过——同值不重写判据位） */
+    lastTitle = null;
+    /** 保活在飞句柄（null = 无在飞——名册语义判据位） */
+    keepaliveHandle = null;
+    io;
+    baseline;
+    schedule;
+    cancel;
+    constructor(io, options) {
+        this.io = io;
+        this.baseline = options.baseline;
+        this.schedule = options.schedule ?? null;
+        // 取消缺省兜底 setTimeout 句柄族（与 TuiBackend cancelFn 缺省同形）
+        this.cancel = options.cancel ?? ((handle) => clearTimeout(handle));
+    }
+    /** 在飞保活句柄现值（null = 无在飞——名册摘除/测试断言位） */
+    get activeKeepalive() {
+        return this.keepaliveHandle;
+    }
+    /** 标题写出（OSC 0;… BEL——值缓存去重：同值不重写字节） */
+    setTitle(title) {
+        if (title === this.lastTitle)
+            return; // 去重律——同值零字节
+        this.lastTitle = title;
+        this.io.write(`\x1b]0;${title}\x07`);
+    }
+    /**
+     * 进度态写出（OSC 9;4）：
+     * - true = 写忙态序列 + 起 1s 保活周期重发（已在飞不重复起针——重发维持
+     *   单链不叠针）；同值重复调用仍重写忙态序列（去重不适用于 progress）；
+     * - false = 写清零序列 + 停保活 timer。
+     */
+    setProgress(active) {
+        if (active) {
+            this.io.write(PROGRESS_ACTIVE_SEQUENCE);
+            this.armKeepalive();
+        }
+        else {
+            this.stopKeepalive();
+            this.io.write(PROGRESS_CLEAR_SEQUENCE);
+        }
+    }
+    /**
+     * 退出复原两写点齐（07 §4.1 件 7 条款）：title 复原基线（经值缓存——
+     * 已在基线则零字节）+ 进度清零（无条件写——终态收口，含停保活）。
+     */
+    restore() {
+        this.stopKeepalive();
+        this.setTitle(this.baseline);
+        this.io.write(PROGRESS_CLEAR_SEQUENCE);
+    }
+    /** 停保活定时器（名册语义：句柄非空才取消、停后清位——重复停针 no-op） */
+    stopKeepalive() {
+        if (this.keepaliveHandle === null)
+            return;
+        this.cancel(this.keepaliveHandle);
+        this.keepaliveHandle = null;
+    }
+    /** 起保活（schedule 缺席 = 缺位；触发后清位自重排续针——周期重发维持） */
+    armKeepalive() {
+        if (this.schedule === null || this.keepaliveHandle !== null)
+            return;
+        this.keepaliveHandle = this.schedule(() => {
+            this.keepaliveHandle = null;
+            this.io.write(PROGRESS_ACTIVE_SEQUENCE); // 周期重发（超时衰减型终端维持）
+            this.armKeepalive();
+        }, OSC_PROGRESS_KEEPALIVE_MS);
+    }
+}
+//# sourceMappingURL=osc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"osc.js","sourceRoot":"","sources":["../../../../../../../src/channels/tui/backend/osc.ts"],"names":[],"mappings":"AAuBA,4DAA4D;AAC5D,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,oDAAoD;AACpD,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAClD,4BAA4B;AAC5B,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;AACzE,CAAC;AAeD;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACrB,sCAAsC;IAC9B,SAAS,GAAkB,IAAI,CAAC;IACxC,kCAAkC;IAC1B,eAAe,GAAY,IAAI,CAAC;IAEvB,EAAE,CAAa;IACf,QAAQ,CAAS;IACjB,QAAQ,CAAqB;IAC7B,MAAM,CAA4B;IAEnD,YAAY,EAAc,EAAE,OAA0B;QACpD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QACzC,oDAAoD;QACpD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAwB,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,uCAAuC;IACvC,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,uCAAuC;IACvC,QAAQ,CAAC,KAAa;QACpB,IAAI,KAAK,KAAK,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,aAAa;QACnD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,MAAe;QACzB,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACxC,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACzC,CAAC;IAED,4CAA4C;IAC5C,aAAa;QACX,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI;YAAE,OAAO;QAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED,+CAA+C;IACvC,YAAY;QAClB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI;YAAE,OAAO;QACpE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YACxC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC5B,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC,kBAAkB;YAC3D,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAChC,CAAC;CACF"}

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

@@ -0,0 +1,98 @@
+import { type AgentMessage } from '../../../contracts/index.js';
+import { type StyledLine } from './ansi-rows.js';
+import { MarkdownDoc } from '../markdown/markdown.js';
+import type { SessionEnvelope } from '../../types.js';
+export type { StyleRun, StyledLine } from './ansi-rows.js';
+/**
+ * 主屏滚动帽定值（07 §4.1「屏幕模型双形态」：帽值随主屏实装批实测定值回填、
+ * 规范不预写数字。批 10f-3 性能回归锁建锁：四指标 wall-time 面不覆盖块帽
+ * 〔内存上限语义〕——v1 维持保守值 500 块，实机校准注记留批 12 host 装配）。
+ * 批 10f-4 参数化：本值降级为缺省帽（主屏调用面零变化）；回看器全量档经
+ * LiveTranscriptOptions.blockCap 传 Number.POSITIVE_INFINITY（全量 durable
+ * 正文不被截——perf-lock 全量档回归锁）。
+ */
+export declare const TRANSCRIPT_BLOCK_CAP = 500;
+/**
+ * 行块（帽单位——blockCount 即帽额度）。streaming 槽是行集末块的瞬时态
+ * （定稿摘槽换装）；其余为 durable 块（repaint 投影重建的同构物）。
+ */
+export type TranscriptBlock = {
+    readonly kind: 'user';
+    readonly text: string;
+} | {
+    readonly kind: 'markdown';
+    readonly doc: MarkdownDoc;
+} | {
+    readonly kind: 'tool-call';
+    readonly name: string;
+    readonly brief: string;
+} | {
+    readonly kind: 'tool-result';
+    readonly brief: string;
+} | {
+    readonly kind: 'streaming';
+    readonly text: string;
+};
+/** 非聚焦摘要行（瞬时——呈现侧直写后即交 scrollback，不存账） */
+export interface SummaryLine {
+    readonly symbol: '⧗' | '✓' | '✖' | '⏹';
+    readonly shortId: string;
+    readonly label: string;
+}
+/** 会话短 id（呈现层自截——散列映射色板键同源） */
+export declare function shortIdOf(sessionId: string): string;
+/**
+ * 块 → 带样式行集（管线单源本体——批 10f-4 件 8 提取）。
+ *
+ * 主屏 MainScreen 直写（经 renderBlockLines 的 ANSI 序列化形）与件 8 回看器
+ * cell 写出（StyledLine 直消费）共用本函数：同输入同行集、零第二渲染器
+ * （07 件 8 数据源条款）；markdown 块经 CellGrid 渲染（gridRowToStyled 提段）、
+ * user 块折行续挂对齐（宽算术单源走 wrapText）、简行块整行 dim、streaming
+ * 纯文本零样式、markdown 无内容行保空行（主屏空行直写形字节不变）。
+ */
+export declare function renderBlockStyledLines(block: TranscriptBlock, columns: number): StyledLine[];
+/**
+ * 块 → 行序列化（渲染管线单源——批 10f-4 提取为可复用函数；主屏直写消费形）。
+ * 带样式行本体经 styledLineToAnsi 导出 ANSI 串——与回看器 cell 写出形零第二
+ * 渲染器（renderBlockStyledLines 注）。
+ */
+export declare function renderBlockLines(block: TranscriptBlock, columns: number): string[];
+/** 行集选项（批 10f-4 帽参数化——主屏缺省帽之外的自定义档） */
+export interface LiveTranscriptOptions {
+    /**
+     * 块帽（缺省 TRANSCRIPT_BLOCK_CAP = 500 主屏帽——主屏调用面零变化）。
+     * 件 8 回看器全量档传 Number.POSITIVE_INFINITY（全量 durable 正文不截）。
+     */
+    readonly blockCap?: number;
+}
+/**
+ * 直播路行集（单聚焦会话一账——非聚焦会话不建账，摘要行直返）。
+ * 纯状态件：无 IO、无时钟——applyEvent 同步归约，呈现编舞归 MainScreen。
+ */
+export declare class LiveTranscript {
+    /** 块帽（构造定着——主屏 500 / 回看器全量 Infinity） */
+    private readonly blockCap;
+    private blocks;
+    /** 流式槽在场位（true = 末块是 streaming——message_start/message_end 配对守卫） */
+    private slotOpen;
+    constructor(options?: LiveTranscriptOptions);
+    /** 行集快照（只读——呈现侧消费） */
+    get snapshot(): readonly TranscriptBlock[];
+    /** 块计数（帽额度观测面） */
+    get blockCount(): number;
+    /**
+     * 直播路归约：活体信封 → 行集更新 + 瞬时行（非聚焦摘要行直返、聚焦返 null）。
+     * 非聚焦会话的 durable 事件全忽略（行集是聚焦会话的账——投影重建走 loadProjection）。
+     */
+    applyEvent(env: SessionEnvelope, focused: boolean): SummaryLine | null;
+    /** 投影重建（repaint 路——清账按投影重拉帽内段；直播/repaint 行集同构） */
+    loadProjection(messages: readonly AgentMessage[]): void;
+    /** 非聚焦摘要行分档（agent_start/end 之外的事件零产出） */
+    private summaryFor;
+    /** 聚焦归约：消息事件族分派（唯一渲染源律——tool_execution_* 正文零渲染） */
+    private applyFocused;
+    /** assistant 定稿展开：文本块非空 → markdown 块；每 toolCall 块 → ⚙ 行块 */
+    private appendAssistantFinal;
+    /** 帽卸载：超帽从头卸（保留帽内最近段——滚出视口交 scrollback 后内存上限语义；全量档 Infinity 恒不触发） */
+    private trimToCap;
+}