berry-agent-sdk 0.1.0-alpha.2

package/dist/src/channels/tui/memory/memory-viewer.js

@@ -0,0 +1,541 @@
+import { ScrollView } from '../scroll/scroll-view.js';
+import { Editor } from '../editor/editor.js';
+import { prefixDisplayWidth } from '../editor/visual-lines.js';
+import { shortIdOf } from '../backend/transcript.js';
+import { tokenize } from '../../commands.js';
+/** 筛选四态循环序（全部→活体→冻结→终态→全部——Tab 单步右移） */
+const FILTER_CYCLE = ['all', 'active', 'frozen', 'terminal'];
+/** 分区呈现名（分区头 + 筛选注记共用单源） */
+const SECTION_LABEL = Object.freeze({
+    active: '活体',
+    frozen: '冻结',
+    terminal: '终态',
+});
+/** 提示行样式（dim——存在感弱于正文；分区头/投影行同载体） */
+const DIM_STYLE = Object.freeze({ dim: true });
+/** 光标行反色样式（整行最强存在感——SelectPanel 高亮行同载体） */
+const CURSOR_STYLE = Object.freeze({ inverse: true });
+/** 常态底行键面提示（按光标行分区动态铸造——零条目可见时行动词消隐） */
+function hintText(section) {
+    const verbs = section === null
+        ? ''
+        : section === 'active'
+            ? 'f 冻结 · d 忘掉 · '
+            : section === 'frozen'
+                ? 'f 解冻 · '
+                : 'r 恢复 · ';
+    return `${verbs}e 导出 · tab 筛选 · q/esc 返回`;
+}
+/** owner 键短显（头行——project 键 16 hex 截前 8 位，引用短 id 同款 8 位惯例） */
+function ownerLabel(key) {
+    if (key.startsWith('project:'))
+        return `project:${key.slice('project:'.length, 'project:'.length + 8)}`;
+    return key; // global（及未来他形）原样——project 之外的键无哈希面
+}
+/** epoch 毫秒 → ISO UTC（tools.ts fmt 同式——呈现换算面同源注记） */
+function fmtTs(ts) {
+    return new Date(ts).toISOString().replace('.000Z', 'Z');
+}
+/** key 事件窄化（text/ime/paste 归各分路） */
+function asKey(event) {
+    return event.kind === 'key' ? event : null;
+}
+/** 无修饰命名键判 */
+function isPlainKey(e, key) {
+    return !e.ctrl && !e.alt && !e.shift && !e.meta && e.key === key;
+}
+/** 错误折底行文案（守卫错人读面——码与人读原因直呈，同命令面 idiom） */
+function errorText(err) {
+    if (err instanceof Error && 'code' in err && typeof err.code === 'string') {
+        return `${err.code}：${err.message}`;
+    }
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * 管理面内容件：ScrollView 子类（滚动/折叠/偏移算术继承）+ OverlayContent
+ * （副屏 root——render 直收全屏 region）。
+ */
+export class MemoryViewer extends ScrollView {
+    ownerKeys;
+    dao;
+    sanitize;
+    exportCommand;
+    onExit;
+    onInterrupt;
+    onQuit;
+    /* ---- 视图态（rebuild 全量重建——动词后整表重取） ---- */
+    styledLines = [];
+    entries = [];
+    /** 光标（entries 下标；-1 = 零条目可见无处可指） */
+    cursor = -1;
+    /** 健康五计数（投影两行数据源） */
+    health = { active: 0, dismissed: 0, expired: 0, frozen: 0, total: 0 };
+    /** 筛选态（Tab 循环） */
+    filter = 'all';
+    /* ---- 模态两态（互斥：确认态与输入态不并在场——开其一先收另一） ---- */
+    /** 确认态（d 两段式——目标条目非空即在态） */
+    confirmTarget = null;
+    /** 输入态（e 导出参数行在场位） */
+    exportOpen = false;
+    exportEditor;
+    /** 底行一次性提示（守卫错/导出回执/解冻指引——常态下次按键即清） */
+    notice = null;
+    /** 退出闭锁（同批多事件只退一次——q 与 Esc 竞发的防御位） */
+    exited = false;
+    constructor(options) {
+        super(); // 无 maxHeight——副屏 root 直收 region 全高
+        this.ownerKeys = options.ownerKeys;
+        this.dao = options.dao;
+        this.sanitize = options.sanitize;
+        this.exportCommand = options.exportCommand;
+        this.onExit = options.onExit;
+        this.onInterrupt = options.onInterrupt;
+        this.onQuit = options.onQuit;
+        this.exportEditor = new Editor({ maxVisibleLines: 1 }); // 单行档——导出参数行
+        this.exportEditor.setFocused(false);
+        this.rebuild(); // 开屏快照（光标落首条——顶部对齐）
+    }
+    /** 量高：头行 + 视口全量 + 底铬（输入态 = Editor；其余恒 1 行） */
+    measure(width) {
+        return 1 + super.measure(width) + (this.exportOpen ? this.exportEditor.measure(width) : 1);
+    }
+    /**
+     * 落位（副屏全屏 region 三段）：头行（档名 + owner 短显 + 筛选注记）→
+     * 滚动视口（super.render——投影两行/分区头/条目行全在内，折叠与偏移恒归
+     * ScrollView）→ 底铬（输入态 = 单行 Editor；确认态 = 确认文案；否则
+     * 一次性提示 ?? 动态键面提示）。
+     */
+    render(buffer, region) {
+        if (region.height < 2)
+            return; // 防御位（极小终端——头行 + 视口都不够）
+        // 头行（筛选态在场时附注记——Tab 动作的可视反馈位）
+        const filterTag = this.filter === 'all' ? '' : ` ·〔筛选：${SECTION_LABEL[this.filter]}〕`;
+        buffer.writeText(region.row, region.col, `❄ 记忆管理 · ${this.ownerKeys.map(ownerLabel).join(' · ')}${filterTag}`);
+        // 滚动视口
+        const chromeBottom = this.exportOpen ? this.exportEditor.measure(region.width) : 1;
+        const viewHeight = region.height - 1 - chromeBottom;
+        if (viewHeight > 0) {
+            super.render(buffer, { row: region.row + 1, col: region.col, width: region.width, height: viewHeight });
+        }
+        // 底铬
+        if (this.exportOpen) {
+            this.exportEditor.setFocused(true);
+            this.exportEditor.render(buffer, {
+                row: region.row + region.height - chromeBottom,
+                col: region.col,
+                width: region.width,
+                height: chromeBottom,
+            });
+            return;
+        }
+        const bottom = this.confirmTarget !== null
+            ? `忘掉 [m:${shortIdOf(this.confirmTarget.id)}]？enter/y 确认 · esc/n 取消`
+            : (this.notice ?? hintText(this.cursorEntry()?.section ?? null));
+        buffer.writeText(region.row + region.height - 1, region.col, bottom, DIM_STYLE);
+    }
+    /**
+     * 事件分发（副屏内容终局消费——未消费键不穿透，模态独占）。
+     * 序：Ctrl+C/Ctrl+D 副屏键面补丁 → Tab 全局动词（输入态仍可达——Editor
+     * 不消费 Tab）→ 输入态模态 → 确认态模态 → 常态（退出键/行动词/光标键
+     * → ScrollView 滚动路）。
+     */
+    handleEvent(event) {
+        if (event.kind === 'mouse')
+            return this.handleMouse(event); // mouse 路（终局消费）
+        const k = asKey(event);
+        if (k !== null && k.phase !== 'release') {
+            // Ctrl+C = 打断在飞 run（press/repeat 相动作滤 kitty release——主屏同键面）
+            if (k.ctrl && !k.alt && !k.shift && !k.meta && k.key === 'c') {
+                this.onInterrupt?.();
+                return true;
+            }
+            // Ctrl+D = 退出进程（先收副屏再转退出柄；输入行有文不退——主屏空框闸同律）
+            if (k.ctrl && !k.alt && !k.shift && !k.meta && k.key === 'd' && this.exportEditor.model.isEmpty()) {
+                this.exit();
+                this.onQuit?.();
+                return true;
+            }
+            // Tab 全局动词：筛选循环单步（输入态在场仍可达——Editor 不消费 Tab，
+            // 与 /history 搜索框键面无冲突的判据面）
+            if (isPlainKey(k, 'tab')) {
+                this.closeModals();
+                this.cycleFilter();
+                return true;
+            }
+        }
+        // 输入态（e 导出参数行）——模态：Esc 关 / Enter 执行 / 其余入 Editor
+        if (this.exportOpen) {
+            if (k !== null && k.phase !== 'release' && !k.ctrl && !k.alt && !k.meta) {
+                if (isPlainKey(k, 'escape')) {
+                    this.closeExport();
+                    return true;
+                }
+                if (isPlainKey(k, 'enter')) {
+                    void this.runExport();
+                    return true;
+                }
+            }
+            this.exportEditor.handleEvent(event);
+            return true;
+        }
+        // 确认态（d 两段式）——模态：Enter/y 确认 / Esc/n 取消（保守值）/ 其余吞
+        //（y/n 双轨同判——kitty 轨纯键打字走 text 事件，与常态行动词同律）
+        if (this.confirmTarget !== null) {
+            const typed = event.kind === 'text' ? event.text : null;
+            if (k !== null && k.phase !== 'release') {
+                if (isPlainKey(k, 'enter') || isPlainKey(k, 'y')) {
+                    this.commitForget();
+                    return true;
+                }
+                if (isPlainKey(k, 'escape') || isPlainKey(k, 'n')) {
+                    this.confirmTarget = null; // 取消——保守值收场
+                    return true;
+                }
+            }
+            if (typed === 'y') {
+                this.commitForget();
+                return true;
+            }
+            if (typed === 'n') {
+                this.confirmTarget = null; // 取消——保守值收场
+                return true;
+            }
+            return true; // 未消费键层内终局（模态）
+        }
+        // 常态：退出键与行动词双轨（kitty disambiguate 轨纯键打字走 text 事件、
+        // legacy 轨走 key 事件——同一动作两轨同判，HistoryViewer q 键同律）
+        this.notice = null; // 一次性提示读毕即清（动词自身的新提示随后覆写）
+        if (k !== null && k.phase !== 'release') {
+            if (isPlainKey(k, 'escape')) {
+                this.exit();
+                return true;
+            }
+            if (isPlainKey(k, 'up')) {
+                this.moveCursor(-1);
+                return true;
+            }
+            if (isPlainKey(k, 'down')) {
+                this.moveCursor(1);
+                return true;
+            }
+            if (isPlainKey(k, 'f')) {
+                this.applyFreezeToggle();
+                return true;
+            }
+            if (isPlainKey(k, 'd')) {
+                this.beginForget();
+                return true;
+            }
+            if (isPlainKey(k, 'r')) {
+                this.applyRestore();
+                return true;
+            }
+            if (isPlainKey(k, 'e')) {
+                this.openExport();
+                return true;
+            }
+        }
+        if (event.kind === 'text') {
+            const ch = event.text;
+            if (ch === 'q') {
+                this.exit();
+                return true;
+            }
+            if (ch === 'f') {
+                this.applyFreezeToggle();
+                return true;
+            }
+            if (ch === 'd') {
+                this.beginForget();
+                return true;
+            }
+            if (ch === 'r') {
+                this.applyRestore();
+                return true;
+            }
+            if (ch === 'e') {
+                this.openExport();
+                return true;
+            }
+        }
+        // 滚动键（PgUp/PgDn/Home/End——↑/↓ 已被光标消费；未消费键终局吞）
+        super.handleEvent(event);
+        return true;
+    }
+    /* ---------------- 鼠标消费面（07 屏模型双形态节同批回写） ---------------- */
+    /**
+     * mouse 事件路（终局消费——模态独占）：滚轮归 ScrollView（统一滚动路）；
+     * 左键点条目行 = 光标移至该行（点击反查经视口段映射到逻辑行，再对
+     * entries 锚比对——非条目行零动作）；头行/底铬/滚动条列/非左键零动作吞。
+     */
+    handleMouse(event) {
+        if (event.button === 'wheel-up' || event.button === 'wheel-down') {
+            super.handleEvent(event); // 滚轮消费路（±3 视觉行——显式滚动路）
+            return true;
+        }
+        if (event.phase !== 'press')
+            return true; // motion/release 零动作（无拖选面 v1）
+        if (this.exportOpen || this.confirmTarget !== null)
+            return true; // 模态在场零动作吞
+        if (event.button !== 'left')
+            return true; // v1 只有左键消费——中/右零动作
+        const geo = this.viewportGeometry;
+        if (event.row < 1 || event.row >= 1 + geo.height)
+            return true; // 头行/底铬命中零动作
+        if (this.hitScrollbar(event.col))
+            return true; // 滚动条列零动作
+        const seg = this.segmentAt(event.row - 1); // 视口首行 = region.row + 1
+        if (seg === null)
+            return true;
+        const idx = this.entries.findIndex((e) => e.lineIndex === seg.line);
+        if (idx >= 0)
+            this.cursor = idx; // 条目行命中——光标移至该行；分区头/投影行不指
+        return true;
+    }
+    /* ---------------- 行动词（f/d/r——单源走 DAO 既有族） ---------------- */
+    /** f：冻结切换（呈现层判向——frozen 行 unfreeze、active 行 freeze；终态行零义吞） */
+    applyFreezeToggle() {
+        const entry = this.cursorEntry();
+        if (entry === undefined || entry.section === 'terminal')
+            return; // 终态行 f 零义吞
+        try {
+            if (entry.section === 'frozen')
+                this.dao.unfreeze(entry.row.id);
+            else
+                this.dao.freeze(entry.row.id);
+            this.rebuild(entry.row.id); // 同 id 锚定（frozen 位变即换分区呈现）
+        }
+        catch (err) {
+            this.notice = errorText(err); // 守卫错折底行
+        }
+    }
+    /** d：忘掉起手（active 行入确认态；终态行零义吞；冻结行零义吞 + 底行指引） */
+    beginForget() {
+        const entry = this.cursorEntry();
+        if (entry === undefined || entry.section === 'terminal')
+            return; // 终态行 d 零义吞
+        if (entry.section === 'frozen') {
+            this.notice = '已冻结——先 f 解冻再忘掉';
+            return;
+        }
+        this.confirmTarget = entry.row; // 确认态（两段式第二段）
+    }
+    /** 确认态落子：forget(id) 缺省 supersededBy='user'（撤回后条目呈终态区——r 可复） */
+    commitForget() {
+        const target = this.confirmTarget;
+        this.confirmTarget = null; // 单次语义（先出态——守卫错也不再回确认态）
+        if (target === null)
+            return;
+        try {
+            this.dao.forget(target.id, { supersededBy: 'user' });
+            this.rebuild(target.id); // 同 id 锚定（filter=all 时条目现于终态区）
+        }
+        catch (err) {
+            this.notice = errorText(err); // 守卫错折底行（MEMORY_FROZEN 等）
+        }
+    }
+    /** r：恢复（终态行免 confirm 直接 restore；active 行零义吞） */
+    applyRestore() {
+        const entry = this.cursorEntry();
+        if (entry === undefined || entry.section !== 'terminal')
+            return; // active 行 r 零义吞
+        try {
+            this.dao.restore(entry.row.id);
+            this.rebuild(entry.row.id); // 同 id 锚定（复活后现于活体区）
+        }
+        catch (err) {
+            this.notice = errorText(err);
+        }
+    }
+    /* ---------------- 全局动词（e/Tab） ---------------- */
+    /** e：开导出参数输入行（/memory-export 真身同一函数——参数面与命令面同形） */
+    openExport() {
+        this.confirmTarget = null; // 模态互斥（先收另一态）
+        this.exportOpen = true;
+        this.exportEditor.setFocused(true);
+    }
+    /** 关输入行（查询文本保留——重开续打的增量延续，/history 搜索框同律） */
+    closeExport() {
+        this.exportOpen = false;
+        this.exportEditor.setFocused(false);
+    }
+    /**
+     * 执行导出：输入行文本 → 引号感知切分（命令分发同源 tokenize）→ 注入的
+     * 处理器闭包；回执折底行（多行以 · 连呈——底行单行面）。fire-and-forget：
+     * 命令体同步落盘（writeFileSync），promise 首微task即resolve——引擎帧
+     * 合并的 setTimeout 渲染在其后，回执同帧可见。
+     */
+    async runExport() {
+        const raw = this.exportEditor.getText();
+        this.closeExport();
+        try {
+            const text = await this.exportCommand(tokenize(raw));
+            this.notice = text.replace(/\n+/g, ' · ');
+        }
+        catch (err) {
+            this.notice = errorText(err); // 非 BaseError 异常面（BaseError 命令内已折文本）
+        }
+    }
+    /** Tab：筛选循环单步（全部→活体→冻结→终态→全部）+ 整表按新筛选重建 */
+    cycleFilter() {
+        const idx = FILTER_CYCLE.indexOf(this.filter);
+        this.filter = FILTER_CYCLE[(idx + 1) % FILTER_CYCLE.length];
+        this.rebuild(); // 无锚定 id——光标驻留原位就近
+    }
+    /** 模态全收（Tab 切筛选前的清理位——两模态不跨筛选态存活） */
+    closeModals() {
+        this.confirmTarget = null;
+        if (this.exportOpen)
+            this.closeExport();
+    }
+    /* ---------------- 光标与视图重建 ---------------- */
+    /** 光标条目（无条目/零条目可见 = undefined——动词消隐判据面） */
+    cursorEntry() {
+        return this.cursor >= 0 ? this.entries[this.cursor] : undefined;
+    }
+    /** 光标移动（条目间循环——非条目行不驻留；移动后视口对齐光标行） */
+    moveCursor(delta) {
+        if (this.entries.length === 0)
+            return; // 零条目可见——光标无处可指
+        this.cursor =
+            this.cursor < 0
+                ? delta > 0
+                    ? 0
+                    : this.entries.length - 1
+                : (this.cursor + delta + this.entries.length) % this.entries.length;
+        this.ensureCursorVisible();
+    }
+    /** 视口对齐光标行（顶对齐——近底行由 ScrollView 夹取自然呈现） */
+    ensureCursorVisible() {
+        const entry = this.cursorEntry();
+        if (entry !== undefined)
+            this.scrollToLine(entry.lineIndex, 0);
+    }
+    /**
+     * 整表重取重建（开屏快照与动词成功后的统一路——06 §7 定形注⑤）：
+     * 三源取数（health 恒全库 / listVisible 双分流 / listForExport 终态双过滤）
+     * → 行集三段式构建 → 光标锚定（同 id 优先；锚定目标缺席驻留原位就近；
+     * 零条目可见 = -1 行动词消隐）。
+     */
+    rebuild(anchorId) {
+        // —— 取数三源（零新 DAO 方法——既有动词族单源）——
+        this.health = this.dao.overview().health; // 恒全库口径（无参即正形）
+        // 管理形取数（批 ev-1 M2 拆形——未生效行在本面可见，行尾「N天后生效」标注）
+        const visible = this.dao.listVisibleForManagement(this.ownerKeys);
+        const frozenRows = visible.filter((r) => r.frozen); // 冻结区（滤出 frozen 位）
+        const activeRows = visible.filter((r) => !r.frozen); // 活体区（滤除 frozen 位）
+        const terminalRows = this.dao.listForExport().filter((r) => this.ownerKeys.includes(r.ownerKey) && // ownerKey 过滤
+            (r.status === 'dismissed' || r.status === 'expired'));
+        // —— 行集三段式构建（投影两行 + 分区列表；头行不在行集——render 直写，
+        // 行集进屏不会与屏上头行重复）——
+        const lines = [];
+        const entries = [];
+        const dim = (plain) => ({ plain, runs: [{ start: 0, end: plain.length, style: DIM_STYLE }] });
+        lines.push(dim(`记忆库 · 在册 ${this.health.active} · 冻结 ${this.health.frozen} · 共 ${this.health.total}`));
+        lines.push(dim(`终态 · 否决 ${this.health.dismissed} · 过期 ${this.health.expired}`));
+        const sections = this.filter === 'all'
+            ? [
+                { key: 'active', rows: activeRows },
+                { key: 'frozen', rows: frozenRows },
+                { key: 'terminal', rows: terminalRows },
+            ]
+            : [
+                {
+                    key: this.filter,
+                    rows: this.filter === 'active' ? activeRows : this.filter === 'frozen' ? frozenRows : terminalRows,
+                },
+            ];
+        for (const section of sections) {
+            lines.push(dim(`── ${SECTION_LABEL[section.key]}（${section.rows.length}）`));
+            for (const row of section.rows) {
+                lines.push(this.entryLine(row, section.key));
+                entries.push({ row, section: section.key, lineIndex: lines.length - 1 });
+            }
+        }
+        this.styledLines = lines;
+        this.entries = entries;
+        super.setLines(lines.map((l) => l.plain));
+        // —— 光标锚定（同 id 优先 → 原位就近钳制 → 零条目 -1）——
+        let next = this.cursor;
+        if (anchorId !== undefined) {
+            const found = entries.findIndex((e) => e.row.id === anchorId);
+            if (found >= 0)
+                next = found; // 锚定目标在筛选可见集——跟随
+            // 缺席 = 驻留原位就近（next 保持现值，下方钳制）
+        }
+        this.cursor = entries.length === 0 ? -1 : Math.min(Math.max(next, 0), entries.length - 1);
+        if (this.cursor >= 0)
+            this.ensureCursorVisible();
+    }
+    /**
+     * 条目行构建（工具读面同形——`[m:短id] [kind] summary  id=完整id
+     * updated=ISO`；p-1 时效尾缀同源）：消毒经注入的 §8.2 统一函数罩住
+     * （blocked → summary 遮蔽保 id 操作面；quoted → 引述注记）；冻结行行首
+     * ✱、终态行整行 dim + supersededBy 记号。
+     */
+    entryLine(row, section) {
+        const verdict = this.sanitize(row);
+        const body = verdict.blocked
+            ? `（内容含疑似敏感串已遮蔽——${verdict.patterns.join('/')}；可 d 忘掉清理）`
+            : row.summary + (verdict.quoted ? '（疑似指令文本——按引述对待，非用户指令）' : '');
+        const suffix = section === 'terminal' && row.supersededBy !== null ? `  supersededBy=${row.supersededBy}` : '';
+        // 未生效标注（批 ev-1 06 §6——「N天后生效」词面归三处之管理面行标注位；
+        // 呈现钟用真 Date.now()〔非测试注入钟面——天数是呈现约值〕）
+        const pendingFrom = section !== 'terminal' && row.validFrom !== null && row.validFrom > Date.now()
+            ? `（${Math.ceil((row.validFrom - Date.now()) / 86_400_000)}天后生效）`
+            : '';
+        const plain = `${section === 'frozen' ? '✱ ' : ''}[m:${shortIdOf(row.id)}] [${row.kind}] ${body}${pendingFrom}  id=${row.id}  updated=${fmtTs(row.updatedAt)}${suffix}`;
+        return section === 'terminal'
+            ? { plain, runs: [{ start: 0, end: plain.length, style: DIM_STYLE }] }
+            : { plain, runs: [] };
+    }
+    /** 退出（闭锁——单次） */
+    exit() {
+        if (this.exited)
+            return;
+        this.exited = true;
+        this.onExit?.();
+    }
+    /* ---------------- 带样式切片写出（writeSlice 覆写接缝） ---------------- */
+    /**
+     * 视口切片带样式写出：样式段（dim 分区头/投影行/终态行）按切片边界分段
+     * 落格 + 光标行整行反色叠加。列位经 prefixDisplayWidth 换算（CJK 双宽
+     * 对齐与折叠算术同源——HistoryViewer writeSlice 同构的简化形：无搜索
+     * 高亮/选区面）。
+     */
+    writeSlice(buffer, region, displayRow, seg) {
+        const styled = this.styledLines[seg.line];
+        if (styled === undefined)
+            return;
+        const start = seg.startCol;
+        const end = seg.startCol + seg.length;
+        const cursorLine = this.cursorEntry()?.lineIndex;
+        const isCursor = cursorLine === seg.line; // 光标行——整切片反色（叠加在样式段上）
+        // 分段边界：切片端点 ∪ 样式段端点（升序去重）
+        const cuts = new Set([start, end]);
+        for (const run of styled.runs) {
+            if (run.start > start && run.start < end)
+                cuts.add(run.start);
+            if (run.end > start && run.end < end)
+                cuts.add(run.end);
+        }
+        const bounds = [...cuts].sort((a, b) => a - b);
+        const baseCols = prefixDisplayWidth(styled.plain, start);
+        for (let i = 0; i + 1 < bounds.length; i++) {
+            const from = bounds[i];
+            const to = bounds[i + 1];
+            let style;
+            for (const run of styled.runs) {
+                if (run.start <= from && from < run.end) {
+                    style = run.style;
+                    break;
+                }
+            }
+            if (isCursor) {
+                style = style === undefined ? CURSOR_STYLE : { ...style, inverse: true };
+            }
+            buffer.writeText(region.row + displayRow, region.col + prefixDisplayWidth(styled.plain, from) - baseCols, styled.plain.slice(from, to), style);
+        }
+    }
+}
+//# sourceMappingURL=memory-viewer.js.map

package/dist/src/channels/tui/memory/memory-viewer.js.map

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

package/dist/src/channels/tui/overlay/alt-screen.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 副屏编舞件（07 §4.1 引擎节件 6（组件与呈现装配件） + §4.3 屏幕模型双形态）：AltScreenHost——
+ * 备屏 1049 整屏切换的进出编排。
+ *
+ * 「overlay」专指主屏浮层（OverlayStack）；本件是副屏路——件 8 /history
+ * 回看器与 06 /memory 的呈现形态（整屏内容值得 1049 备屏切换）。
+ *
+ * 编舞序（进出对称）：
+ * - 进：主屏 suspendMain（出屏串 + 卸监听 + pause 流 + raw 复先验）→ 副屏
+ *   Engine（共享同一 io 实例、screen:'alt-screen'）start（1049 备屏进 + raw +
+ *   放流——start 的显式放流正是为共享 io 场景补的结构性接缝）；
+ * - 出：退订转发 → 副屏 dispose（备屏出 + raw 复原 + pause）→ 主屏 resumeMain
+ *   （进屏串 + raw + 放流 + 全帧重画不走 repaint：停屏期瞬时行靠全帧 + 缓冲
+ *   补吐，07 屏模型 / 件 8 条款）→ onReturn 装配钩（树重建等附加动作）。
+ *
+ * 输入路由切换：共享 io 同一时刻只有一个在听（主屏 suspendMain 已卸监听、
+ * 副屏 start 重装）——副屏 input 事件转发 content.handleEvent（回看器键盘滚动）。
+ *
+ * 鼠标降级接线（2026-09-11 鼠标解码批）：open 组合 onMouseLegacy——X10 形首
+ * 达（开了 1006 的会话里到达 ⟺ 终端无 SGR 能力，判据可靠）即写 DECRST
+ * 1006/1002 关鼠标签听把选区还给终端原生（写序与出屏关序同取先 1006 后
+ * 1002）。降级闩 = per-entry：每次 open 新 Engine 新 decoder——重开重新武装、
+ * 再吃一次首达（非 SGR 终端上重开 /history 的首个鼠标事件死一次为已知代价）。
+ *
+ * 构造双注 (primary, io)：Engine.io 私有无 getter——装配根同根传两参（io 须与
+ * primary 共享同一实例，否则编舞失联）。
+ *
+ * 批 10f-4 主屏绑收窄：primary 原系 Engine 型——10e 前旧设想残留（主屏
+ * TuiBackend 自持输入管线不经 Engine，07 篇屏模型双形态实装对账注）。收窄为
+ * AltScreenPrimary 最小宿主介面（本件实际消费面：挂起 / 复起 + 生命周期判定
+ * 位）；Engine 语义保留给副屏自身的帧管线（生命周期四态仅副屏 Engine 消费）。
+ */
+import { type EngineOptions } from '../../engine/index.js';
+import type { TerminalIO } from '../../engine/types.js';
+import type { OverlayContent, OverlayHandle } from './overlay.js';
+/**
+ * 主屏宿主窄介面（AltScreenHost 消费面的最小集——批 10f-4 收窄）。
+ *
+ * 实装 = TuiBackend（主屏挂起 / 复起交出面 UiBackend 实装件自持——07 §4.1
+ * 件 8 条款 2026-09-07 勘正：主屏编舞自持不经 Engine）。挂起 = 停屏期主屏
+ * 零写出 + 瞬时行入缓冲；复起 = 全帧重画不走（通道）repaint + 瞬时行缓冲
+ * 补吐——语义细节归实装件（tui-backend.ts 直测覆盖）。
+ */
+export interface AltScreenPrimary {
+    /** 生命周期判定位（'running' 才是可挂起对象——open 前置闸；四态词表对齐 Engine） */
+    readonly lifecycle: 'idle' | 'running' | 'suspended' | 'disposed';
+    /** 挂起主屏（进副屏半场：出屏串 + 卸监听 + 停流 + raw 复先验 + 渲染 no-op 闸） */
+    suspendMain(): void;
+    /** 复起主屏（出副屏半场：进屏串 + 重装 + 放流 + 全帧重画 + 瞬时行补吐） */
+    resumeMain(): void;
+}
+/** 副屏编舞选项 */
+export interface AltScreenOptions {
+    /** 引擎构造透传（测试假钟 / 帧帽注入口——io 与 screen 由本件独占） */
+    readonly engineOptions?: Omit<EngineOptions, 'io' | 'screen'>;
+    /** 出副屏钩（主屏 resume 已全帧重画后调——装配层做树重建等附加动作） */
+    readonly onReturn?: () => void;
+}
+/**
+ * 副屏宿主：单副屏在场（再 open 拒绝返 null——1049 无嵌套备屏）。
+ */
+export declare class AltScreenHost {
+    private readonly primary;
+    private readonly io;
+    private readonly engineOptions;
+    private readonly onReturn;
+    private alt;
+    private unsubAltInput;
+    constructor(primary: AltScreenPrimary, io: TerminalIO, options?: AltScreenOptions);
+    /** 副屏在场态 */
+    get isOpen(): boolean;
+    /**
+     * 进副屏：挂起主屏 → 副屏 Engine 进屏 → 输入转发接线。
+     * 拒绝位：已在副屏 / 主屏不在 running 态（无挂起对象）返 null。
+     */
+    open(content: OverlayContent): OverlayHandle | null;
+    /** 出副屏（幂等）：退订 → 副屏 dispose → 主屏 resume（全帧重画）→ onReturn 钩 */
+    private close;
+}