berry-agent-sdk 0.1.0-alpha.2

package/dist/src/channels/tui/markdown/inline.js

@@ -0,0 +1,76 @@
+/**
+ * Markdown 行内解析件（07 §4.1 引擎节件 6 Markdown 件——批 10d-4）。
+ *
+ * 手写扫描器四标记（v1 平面——嵌套标记不递归）：
+ * `**bold**` / `*italic*` / `` `code` `` / `[label](url)`（呈现取 label +
+ * underline——TUI 中性形，URL 不外显）。未闭合标记按普通文本回退（坏输入
+ * 不丢字）；空标记体（`****`）不产空 span。
+ */
+/**
+ * 行内解析：文本 → 样式段序列。
+ *
+ * 优先序：`**` 先于 `*`（前缀撞车时 bold 赢）；`[` 用 `](` 连续判据（label
+ * 内含 `]` 的罕见形不支撑——v1 已知边界）。
+ */
+export function parseInline(text) {
+    const spans = [];
+    let plain = ''; // 普通文本累积（相邻同形合并——flush 才成段）
+    let i = 0;
+    const flush = () => {
+        if (plain !== '') {
+            spans.push({ text: plain });
+            plain = '';
+        }
+    };
+    while (i < text.length) {
+        const ch = text[i];
+        // **bold**（** 先试——命中即吞两字符，* 不会误抢）
+        if (ch === '*' && text[i + 1] === '*') {
+            const end = text.indexOf('**', i + 2);
+            if (end > i + 2) {
+                flush();
+                spans.push({ text: text.slice(i + 2, end), bold: true });
+                i = end + 2;
+                continue;
+            }
+        }
+        // *italic*
+        if (ch === '*') {
+            const end = text.indexOf('*', i + 1);
+            if (end > i + 1) {
+                flush();
+                spans.push({ text: text.slice(i + 1, end), italic: true });
+                i = end + 1;
+                continue;
+            }
+        }
+        // `code`
+        if (ch === '`') {
+            const end = text.indexOf('`', i + 1);
+            if (end > i + 1) {
+                flush();
+                spans.push({ text: text.slice(i + 1, end), code: true });
+                i = end + 1;
+                continue;
+            }
+        }
+        // [label](url) → label + underline
+        if (ch === '[') {
+            const close = text.indexOf('](', i + 1);
+            if (close > i) {
+                const urlEnd = text.indexOf(')', close + 2);
+                if (urlEnd > close + 1) {
+                    flush();
+                    spans.push({ text: text.slice(i + 1, close), underline: true });
+                    i = urlEnd + 1;
+                    continue;
+                }
+            }
+        }
+        plain += ch;
+        i++;
+    }
+    flush();
+    return spans;
+}
+//# sourceMappingURL=inline.js.map

package/dist/src/channels/tui/markdown/inline.js.map

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

package/dist/src/channels/tui/markdown/markdown.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Markdown 渲染件（07 §4.1 引擎节件 6 + 呈现面件 1——批 10d-4）。
+ *
+ * - 两段语义的「定稿」腿：流式期纯文本直推（装配策略，批 10e 接）、
+ *   message_end 定稿换装本件（流式槽原位差分的换入对象）；
+ * - 内置中性 ANSI 配色、不接语法高亮库：行内代码 ANSI 2（绿）、引用
+ *   dim、标题 bold、链接 underline——**不触 accent**（引擎节件 3 着色纪律：
+ *   accent 只用于焦点指示面，正文不混用）；
+ * - 滚动帽语义 = 块数（呈现面件 1）——`blockCount` 即帽额度计数面；
+ * - 折行按显示宽字素硬折（复用 width 件三规则——宽字不产半字、不悬挂）；
+ *   折点后的行首空格游程跳过（软换行折叠的呈现收口）。
+ */
+import { type CellBuffer, type Region, type Renderable } from '../../engine/index.js';
+import { type MarkdownBlock } from './blocks.js';
+/** Markdown 渲染件：构造后静态不可变（文本件纪律——状态归持有方自管） */
+export declare class MarkdownDoc implements Renderable {
+    private readonly parsed;
+    /** 布局缓存（width 单槽——文本不可变，换宽整体重算） */
+    private cacheWidth;
+    private cacheRows;
+    constructor(text: string);
+    /** 便捷构造（换装装配点直呼） */
+    static of(text: string): MarkdownDoc;
+    /** 块序列（只读观测面） */
+    get blocks(): readonly MarkdownBlock[];
+    /** 块计数——主屏滚动帽的额度单位（呈现面件 1：一个 Markdown 块一子行） */
+    get blockCount(): number;
+    /** 量高：全块行数 + 块间空行（n-1 段间距——量高即分配承诺） */
+    measure(width: number): number;
+    /** 落位渲染：缓存行集逐行写（相邻同样式游程合并 writeText——省格级调用） */
+    render(buffer: CellBuffer, region: Region): void;
+    /** 布局（width 键缓存——块间空行并入行集，render 与 measure 同源） */
+    private layout;
+}

package/dist/src/channels/tui/markdown/markdown.js

@@ -0,0 +1,183 @@
+/**
+ * Markdown 渲染件（07 §4.1 引擎节件 6 + 呈现面件 1——批 10d-4）。
+ *
+ * - 两段语义的「定稿」腿：流式期纯文本直推（装配策略，批 10e 接）、
+ *   message_end 定稿换装本件（流式槽原位差分的换入对象）；
+ * - 内置中性 ANSI 配色、不接语法高亮库：行内代码 ANSI 2（绿）、引用
+ *   dim、标题 bold、链接 underline——**不触 accent**（引擎节件 3 着色纪律：
+ *   accent 只用于焦点指示面，正文不混用）；
+ * - 滚动帽语义 = 块数（呈现面件 1）——`blockCount` 即帽额度计数面；
+ * - 折行按显示宽字素硬折（复用 width 件三规则——宽字不产半字、不悬挂）；
+ *   折点后的行首空格游程跳过（软换行折叠的呈现收口）。
+ */
+import { ansiColor, graphemeWidth, splitGraphemes, } from '../../engine/index.js';
+import { parseMarkdown } from './blocks.js';
+/** 行内代码配色（ANSI 2 绿——终端代码传统色；与 accent〔cyan 6〕分立，正文不触 accent 家族） */
+const CODE_COLOR = ansiColor(2);
+/** 引用块基础样式（dim——存在感弱于正文） */
+const DIM_STYLE = Object.freeze({ dim: true });
+/** span 样式解析（与块基础样式合并——行内位覆盖 base 的同名位） */
+function spanStyle(span, base) {
+    const style = base !== undefined ? { ...base } : {};
+    if (span.code === true)
+        style.fg = CODE_COLOR;
+    if (span.bold === true)
+        style.bold = true;
+    if (span.italic === true)
+        style.italic = true;
+    if (span.underline === true)
+        style.underline = true;
+    return Object.keys(style).length > 0 ? Object.freeze(style) : undefined;
+}
+/** spans 按显示宽折行（行满开新行；折点后行首空格游程跳过） */
+function layoutSpans(spans, width, base) {
+    const rows = [];
+    let current = [];
+    let used = 0;
+    const openRow = () => {
+        current = [];
+        used = 0;
+    };
+    for (const span of spans) {
+        const style = spanStyle(span, base);
+        for (const g of splitGraphemes(span.text)) {
+            if (g === ' ' && used === 0 && rows.length > 0)
+                continue; // 折点后行首空格跳过
+            const w = graphemeWidth(g);
+            if (w > width)
+                continue; // 防御位：比行宽还宽的字素丢弃（width 件三规则外的不可能格）
+            if (used + w > width) {
+                rows.push(current);
+                openRow();
+                if (g === ' ')
+                    continue; // 恰在折点上的空格不进新行
+            }
+            current.push({ grapheme: g, style });
+            used += w;
+        }
+    }
+    if (current.length > 0 || rows.length === 0)
+        rows.push(current); // 尾行收口（空段落落一行空行）
+    return rows;
+}
+/** 纯文本行折行（代码块体——无行内解析，样式恒定整体替换） */
+function layoutPlain(text, width, style) {
+    return layoutSpans([{ text }], width).map((row) => row.map((cell) => ({ grapheme: cell.grapheme, style })));
+}
+/** 前缀串 → 字素列（列表标记/引用竖线等固定前缀） */
+function prefixCells(prefix, style) {
+    return splitGraphemes(prefix).map((grapheme) => ({ grapheme, style }));
+}
+/** 单块布局 → 渲染行集（块型分派；行首前缀 + 折行 + 层级缩进） */
+function blockRows(block, width) {
+    switch (block.type) {
+        case 'heading': {
+            // 标题：整行强制 bold（行内样式位叠加保留——code 色不丢）；H1/H2 尾随分隔线
+            const rows = layoutSpans(block.spans, width, { bold: true });
+            if (block.level <= 2) {
+                rows.push(splitGraphemes('─'.repeat(width)).map((grapheme) => ({ grapheme, style: DIM_STYLE })));
+            }
+            return rows;
+        }
+        case 'paragraph':
+            return layoutSpans(block.spans, width);
+        case 'list-item': {
+            // 前缀 = 嵌套缩进 + 标记 + 空格；续行对齐前缀宽（视觉续挂）
+            const prefix = `${'  '.repeat(block.indent)}${block.marker} `;
+            const prefixWidth = splitGraphemes(prefix).reduce((sum, g) => sum + graphemeWidth(g), 0);
+            const body = layoutSpans(block.spans, Math.max(1, width - prefixWidth));
+            return body.map((row, index) => [
+                ...(index === 0 ? prefixCells(prefix) : prefixCells(' '.repeat(prefixWidth))),
+                ...row,
+            ]);
+        }
+        case 'code': {
+            // 代码块：竖线前缀贯通（含折行续行）+ 原样文本（无行内解析）
+            const bodyWidth = Math.max(1, width - 2);
+            const rows = [];
+            for (const line of block.lines)
+                rows.push(...layoutPlain(line, bodyWidth));
+            return rows.map((row) => [...prefixCells('│ '), ...row]);
+        }
+        case 'quote': {
+            // 引用：首列竖线 + dim 基础样式（行内样式位叠加）
+            const rows = [];
+            for (const line of block.lines)
+                rows.push(...layoutSpans(line, Math.max(1, width - 2), DIM_STYLE));
+            return rows.map((row) => [...prefixCells('┆ ', DIM_STYLE), ...row]);
+        }
+        case 'hr':
+            return [splitGraphemes('─'.repeat(width)).map((grapheme) => ({ grapheme, style: DIM_STYLE }))];
+    }
+}
+/** Markdown 渲染件：构造后静态不可变（文本件纪律——状态归持有方自管） */
+export class MarkdownDoc {
+    parsed;
+    /** 布局缓存（width 单槽——文本不可变，换宽整体重算） */
+    cacheWidth = -1;
+    cacheRows = [];
+    constructor(text) {
+        this.parsed = parseMarkdown(text);
+    }
+    /** 便捷构造（换装装配点直呼） */
+    static of(text) {
+        return new MarkdownDoc(text);
+    }
+    /** 块序列（只读观测面） */
+    get blocks() {
+        return this.parsed;
+    }
+    /** 块计数——主屏滚动帽的额度单位（呈现面件 1：一个 Markdown 块一子行） */
+    get blockCount() {
+        return this.parsed.length;
+    }
+    /** 量高：全块行数 + 块间空行（n-1 段间距——量高即分配承诺） */
+    measure(width) {
+        const rows = this.layout(width);
+        return rows.length;
+    }
+    /** 落位渲染：缓存行集逐行写（相邻同样式游程合并 writeText——省格级调用） */
+    render(buffer, region) {
+        const rows = this.layout(region.width);
+        const max = Math.min(rows.length, region.height);
+        for (let r = 0; r < max; r++) {
+            let col = region.col;
+            let run = '';
+            let runStyle;
+            // 游程起点显式跟踪（宽字素占两格——run 码位数算不出格位）
+            let runStart = region.col;
+            const flush = () => {
+                if (run !== '')
+                    buffer.writeText(region.row + r, runStart, run, runStyle);
+            };
+            for (const cell of rows[r]) {
+                if (cell.style !== runStyle) {
+                    flush();
+                    run = cell.grapheme;
+                    runStyle = cell.style;
+                    runStart = col;
+                }
+                else {
+                    run += cell.grapheme;
+                }
+                col += graphemeWidth(cell.grapheme); // 按显示宽推进（宽字素两格）
+            }
+            flush();
+        }
+    }
+    /** 布局（width 键缓存——块间空行并入行集，render 与 measure 同源） */
+    layout(width) {
+        if (this.cacheWidth === width)
+            return this.cacheRows;
+        const rows = [];
+        for (const block of this.parsed) {
+            if (rows.length > 0)
+                rows.push([]); // 块间空行
+            rows.push(...blockRows(block, Math.max(1, width)));
+        }
+        this.cacheWidth = width;
+        this.cacheRows = rows;
+        return rows;
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/src/channels/tui/markdown/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../../../../../src/channels/tui/markdown/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,SAAS,EACT,aAAa,EACb,cAAc,GAMf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAGhE,kEAAkE;AAClE,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAChC,4BAA4B;AAC5B,MAAM,SAAS,GAAwB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAQpE,2CAA2C;AAC3C,SAAS,SAAS,CAAC,IAAgB,EAAE,IAAqC;IACxE,MAAM,KAAK,GACT,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;QAAE,KAAK,CAAC,EAAE,GAAG,UAAU,CAAC;IAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;QAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAC9C,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;QAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IACpD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC;AAED,sCAAsC;AACtC,SAAS,WAAW,CAAC,KAA4B,EAAE,KAAa,EAAE,IAA0B;IAC1F,MAAM,IAAI,GAAuB,EAAE,CAAC;IACpC,IAAI,OAAO,GAAqB,EAAE,CAAC;IACnC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,CAAC,CAAC;IACX,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS,CAAC,YAAY;YACtE,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,GAAG,KAAK;gBAAE,SAAS,CAAC,mCAAmC;YAC5D,IAAI,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnB,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,KAAK,GAAG;oBAAE,SAAS,CAAC,eAAe;YAC1C,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB;IAClF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mCAAmC;AACnC,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa,EAAE,KAA2B;IAC3E,OAAO,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED,gCAAgC;AAChC,SAAS,WAAW,CAAC,MAAc,EAAE,KAA2B;IAC9D,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,yCAAyC;AACzC,SAAS,SAAS,CAAC,KAAoB,EAAE,KAAa;IACpD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,gDAAgD;YAChD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;YACnG,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,WAAW;YACd,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzC,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,oCAAoC;YACpC,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC;YAC9D,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACzF,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC9B,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;gBAC7E,GAAG,GAAG;aACP,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,iCAAiC;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACzC,MAAM,IAAI,GAAuB,EAAE,CAAC;YACpC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,8BAA8B;YAC9B,MAAM,IAAI,GAAuB,EAAE,CAAC;YACpC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;YACnG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,IAAI;YACP,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACnG,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,MAAM,OAAO,WAAW;IACL,MAAM,CAAkB;IACzC,mCAAmC;IAC3B,UAAU,GAAG,CAAC,CAAC,CAAC;IAChB,SAAS,GAAuB,EAAE,CAAC;IAE3C,YAAY,IAAY;QACtB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,oBAAoB;IACpB,MAAM,CAAC,EAAE,CAAC,IAAY;QACpB,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,iBAAiB;IACjB,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,+CAA+C;IAC/C,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,uCAAuC;IACvC,OAAO,CAAC,KAAa;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,+CAA+C;IAC/C,MAAM,CAAC,MAAkB,EAAE,MAAc;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;YACrB,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,IAAI,QAAyC,CAAC;YAC9C,iCAAiC;YACjC,IAAI,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC;YAC1B,MAAM,KAAK,GAAG,GAAS,EAAE;gBACvB,IAAI,GAAG,KAAK,EAAE;oBAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC5E,CAAC,CAAC;YACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,CAAC,CAAE,EAAE,CAAC;gBAC5B,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC5B,KAAK,EAAE,CAAC;oBACR,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;oBACpB,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;oBACtB,QAAQ,GAAG,GAAG,CAAC;gBACjB,CAAC;qBAAM,CAAC;oBACN,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC;gBACvB,CAAC;gBACD,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB;YACvD,CAAC;YACD,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IAED,kDAAkD;IAC1C,MAAM,CAAC,KAAa;QAC1B,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QACrD,MAAM,IAAI,GAAuB,EAAE,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO;YAC3C,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/src/channels/tui/memory/memory-viewer.d.ts

@@ -0,0 +1,235 @@
+/**
+ * /memory 轻管理面副屏件（06 §7 `/memory` TUI 形态定形注——mm 批落码腿）：
+ * 副屏内容件（OverlayContent——经 AltScreenHost 装载入 1049 备屏，与
+ * /history 回看器同基建同键面）。
+ *
+ * - **视图三段式**（定形注②）：头行（档名 + owner 并集短显——project 键
+ *   16 hex 截前 8 位）→ 健康投影两行（overview().health 五计数**恒全库口径**
+ *   ——全库不分 owner 假精度既有裁决，无参即正形勿对齐）→ 三分区列表
+ *   （活体区〔listVisibleForManagement 滤除 frozen 位——批 ev-1 管理形拆面，
+ *   未生效行可见并带「N天后生效」标注〕→ 冻结区〔同管理形滤出 frozen 位、
+ *   行首 ✱〕→ 终态区〔listForExport 客户端 ownerKey + status ∈
+ *   {dismissed, expired} 双过滤；TTL 未物化 active 行三区皆不进〕）；
+ *   条目行与工具读面同形（`[m:短id] [kind] summary  id=<完整id>
+ *   updated=<ISO>`——p-1 批时效尾缀同源），读出消毒经注入的 §8.2 统一函数
+ *   罩住（secret 命中遮蔽原文保留 id 操作面、指令样命中引述注记）；
+ * - **键面动词族**（定形注③）：行动词 f（冻结切换——呈现层判向调
+ *   freeze/unfreeze，终态行零义吞）/ d（忘掉——confirm 两段式；终态行零义
+ *   吞、冻结行零义吞 + 底行提示「先 f 解冻」）/ r（恢复——终态行免
+ *   confirm，active 行零义吞）；全局动词 e（副屏内嵌输入行走 /memory-export
+ *   真身同一函数——argv 引号感知切分与命令分发同源）/ Tab（筛选循环
+ *   全部→活体→冻结→终态）。光标只在条目行间移动（↑/↓ 循环——分区头/
+ *   投影行非可指行）；PgUp/PgDn/Home/End 与滚轮归 ScrollView 滚动路；
+ * - **confirm 副屏内嵌行**（定形注④）：主屏浮层在副屏在场时物理不可见 +
+ *   走通道 ask 原语会触发 ask 强制收起先收副屏——故收口为副屏内嵌行
+ *   （底行确认文案；键面语义同 ConfirmPanel：Enter/y 确认、Esc/n 取消、
+ *   单次保守值）；确认执行 forget(id) 缺省 supersededBy='user'，守卫错折
+ *   底行；
+ * - **刷新语义**（定形注⑤）：开屏快照 + 动词成功后整表重取重建、重取同 id
+ *   锚定、锚定目标不在筛选可见集驻留原位就近、零条目可见行动词消隐
+ *   （底行动态呈现按光标行分区给键面提示）；他路写入不实时进屏（挂账）；
+ * - **单源执法**（定形注⑥）：键面动词全走 DAO 既有族（零新 DAO 方法）、
+ *   导出走注入的 /memory-export 处理器闭包（真身同一函数）、用户直发零
+ *   审批对、零新审计词；
+ * - **鼠标消费面**（07 篇屏模型双形态节同批回写）：滚轮滚动（ScrollView
+ *   统一路）+ 左键点条目行 = 光标移至该行；头行/健康投影区/底铬/滚动条列
+ *   命中零动作；拖选复制不进 v1（操作面非回看面——挂账随真实需求再裁）；
+ * - **退出键面**：q/Esc 退出（确认态/输入态在场时让位——Esc 先收模态）、
+ *   Ctrl+C 打断（滤 kitty release）、Ctrl+D 退出进程（先收副屏再转退出柄；
+ *   输入行有文不退——主屏空框闸同律）。
+ *
+ * DAG 注记：本件不 import memory 域（02 §4.1 边表——channels 无 memory
+ * 边是刻意设计）：DAO/行形经手写结构相容窄面（TS 鸭子型装配零胶水——
+ * MemoryDaoFace 与 memory 域 MemoryDao 单实现律互证），消毒函数与导出
+ * 命令经依赖倒置注入（装配面传真身——「同一函数」由装配保证）。
+ */
+import type { CellBuffer, InputEvent, Region } from '../../engine/index.js';
+import { ScrollView } from '../scroll/scroll-view.js';
+import { type VisualSegment } from '../editor/visual-lines.js';
+import type { OverlayContent } from '../overlay/overlay.js';
+/** 记忆行呈现窄面（MemoryRow 子集 + content——消毒入检需要；结构相容真身） */
+export interface MemoryRowFace {
+    readonly id: string;
+    readonly ownerKey: string;
+    readonly kind: string;
+    readonly summary: string;
+    readonly content: string;
+    readonly status: 'active' | 'dismissed' | 'expired';
+    /** 终态来源记号：'auto_resolved' | 'user' | 'llm:<id>' | 'ttl' | 'skill:<名>'（active 行 null） */
+    readonly supersededBy: string | null;
+    /** Unix 毫秒 */
+    readonly updatedAt: number;
+    /** 冻结位（0/1） */
+    readonly frozen: boolean;
+    /** 生效起点 Unix 毫秒（批 ev-1——null = 即时；未生效行在本面可见并标注） */
+    readonly validFrom: number | null;
+}
+/** 健康五计数窄面（恒全库口径——overview 无参形） */
+export interface MemoryHealthFace {
+    readonly active: number;
+    readonly dismissed: number;
+    readonly expired: number;
+    readonly frozen: number;
+    readonly total: number;
+}
+/**
+ * DAO 窄面（结构相容 memory 域 MemoryDao——方法双变下窄参数/宽返回可并；
+ * 管理面只消费既有动词族，零新方法条款的码面形）。
+ */
+export interface MemoryDaoFace {
+    /**
+     * 可见行**管理形**（批 ev-1 M2 拆形——active AND (frozen OR 未过期) AND 起点
+     * 不滤，updated_at DESC；活体/冻结两分区单源。注入读面的起点过滤不适用于
+     * 本面——未生效行在 /memory 可见并带「N天后生效」标注）
+     */
+    listVisibleForManagement(ownerKeys?: readonly string[]): readonly MemoryRowFace[];
+    /** 全库全状态行（终态区客户端双过滤的数据源） */
+    listForExport(ownerKey?: string): readonly MemoryRowFace[];
+    /** 整面（health 五计数恒全库口径） */
+    overview(ownerKeys?: readonly string[]): {
+        readonly health: MemoryHealthFace;
+    };
+    /** 忘掉（缺省 supersededBy='user'；frozen 拒 MEMORY_FROZEN；终态短路幂等） */
+    forget(id: string, opts?: {
+        readonly supersededBy?: string;
+    }): MemoryRowFace;
+    /** 恢复（状态复活腿免 revision；幂等） */
+    restore(id: string, revision?: number): MemoryRowFace;
+    /** 冻结（幂等——纯持有面不动 updated_at） */
+    freeze(id: string): MemoryRowFace;
+    /** 解冻（幂等——解冻即按 ttl_days 重算钟） */
+    unfreeze(id: string): MemoryRowFace;
+}
+/** 读出消毒函数面（§8.2 统一函数注入位——装配传真身保持「同一函数」） */
+export type MemorySanitize = (entry: {
+    readonly summary: string;
+    readonly content?: string;
+}) => {
+    readonly blocked: boolean;
+    readonly patterns: readonly string[];
+    readonly quoted: boolean;
+};
+/** 数据材料位（TuiBackend 后置注入面 setMemoryScreen 的载荷——装配根 boot 后从服务面传真身） */
+export interface MemoryViewerDataDeps {
+    /** owner 并集（['global', 'project:<16hex>']——两分区过滤 + 头行短显） */
+    readonly ownerKeys: readonly string[];
+    readonly dao: MemoryDaoFace;
+    /** 读出消毒（§8.2 统一函数——真身由装配注入） */
+    readonly sanitize: MemorySanitize;
+    /** 导出命令（/memory-export 处理器装配闭包——真身同一函数；argv 引号感知切分同源） */
+    readonly exportCommand: (argv: readonly string[]) => Promise<string>;
+}
+/** 管理面装配选项（数据材料 + 退出三柄——三柄归 TuiBackend 装配闭包） */
+export interface MemoryViewerOptions extends MemoryViewerDataDeps {
+    /** 退出管理面（q/Esc/Ctrl+D——装配接线：收副屏〔AltScreenHost close〕） */
+    readonly onExit: () => void;
+    /** 打断在飞 run（Ctrl+C 副屏键面补丁——零参形：装配闭包已知目标会话） */
+    readonly onInterrupt?: () => void;
+    /** 退出进程（Ctrl+D——先收副屏〔onExit 已先调〕再转装配退出柄） */
+    readonly onQuit?: () => void;
+}
+/**
+ * 管理面内容件：ScrollView 子类（滚动/折叠/偏移算术继承）+ OverlayContent
+ * （副屏 root——render 直收全屏 region）。
+ */
+export declare class MemoryViewer extends ScrollView implements OverlayContent {
+    private readonly ownerKeys;
+    private readonly dao;
+    private readonly sanitize;
+    private readonly exportCommand;
+    private readonly onExit;
+    private readonly onInterrupt;
+    private readonly onQuit;
+    private styledLines;
+    private entries;
+    /** 光标（entries 下标；-1 = 零条目可见无处可指） */
+    private cursor;
+    /** 健康五计数（投影两行数据源） */
+    private health;
+    /** 筛选态（Tab 循环） */
+    private filter;
+    /** 确认态（d 两段式——目标条目非空即在态） */
+    private confirmTarget;
+    /** 输入态（e 导出参数行在场位） */
+    private exportOpen;
+    private readonly exportEditor;
+    /** 底行一次性提示（守卫错/导出回执/解冻指引——常态下次按键即清） */
+    private notice;
+    /** 退出闭锁（同批多事件只退一次——q 与 Esc 竞发的防御位） */
+    private exited;
+    constructor(options: MemoryViewerOptions);
+    /** 量高：头行 + 视口全量 + 底铬（输入态 = Editor；其余恒 1 行） */
+    measure(width: number): number;
+    /**
+     * 落位（副屏全屏 region 三段）：头行（档名 + owner 短显 + 筛选注记）→
+     * 滚动视口（super.render——投影两行/分区头/条目行全在内，折叠与偏移恒归
+     * ScrollView）→ 底铬（输入态 = 单行 Editor；确认态 = 确认文案；否则
+     * 一次性提示 ?? 动态键面提示）。
+     */
+    render(buffer: CellBuffer, region: Region): void;
+    /**
+     * 事件分发（副屏内容终局消费——未消费键不穿透，模态独占）。
+     * 序：Ctrl+C/Ctrl+D 副屏键面补丁 → Tab 全局动词（输入态仍可达——Editor
+     * 不消费 Tab）→ 输入态模态 → 确认态模态 → 常态（退出键/行动词/光标键
+     * → ScrollView 滚动路）。
+     */
+    handleEvent(event: InputEvent): boolean;
+    /**
+     * mouse 事件路（终局消费——模态独占）：滚轮归 ScrollView（统一滚动路）；
+     * 左键点条目行 = 光标移至该行（点击反查经视口段映射到逻辑行，再对
+     * entries 锚比对——非条目行零动作）；头行/底铬/滚动条列/非左键零动作吞。
+     */
+    private handleMouse;
+    /** f：冻结切换（呈现层判向——frozen 行 unfreeze、active 行 freeze；终态行零义吞） */
+    private applyFreezeToggle;
+    /** d：忘掉起手（active 行入确认态；终态行零义吞；冻结行零义吞 + 底行指引） */
+    private beginForget;
+    /** 确认态落子：forget(id) 缺省 supersededBy='user'（撤回后条目呈终态区——r 可复） */
+    private commitForget;
+    /** r：恢复（终态行免 confirm 直接 restore；active 行零义吞） */
+    private applyRestore;
+    /** e：开导出参数输入行（/memory-export 真身同一函数——参数面与命令面同形） */
+    private openExport;
+    /** 关输入行（查询文本保留——重开续打的增量延续，/history 搜索框同律） */
+    private closeExport;
+    /**
+     * 执行导出：输入行文本 → 引号感知切分（命令分发同源 tokenize）→ 注入的
+     * 处理器闭包；回执折底行（多行以 · 连呈——底行单行面）。fire-and-forget：
+     * 命令体同步落盘（writeFileSync），promise 首微task即resolve——引擎帧
+     * 合并的 setTimeout 渲染在其后，回执同帧可见。
+     */
+    private runExport;
+    /** Tab：筛选循环单步（全部→活体→冻结→终态→全部）+ 整表按新筛选重建 */
+    private cycleFilter;
+    /** 模态全收（Tab 切筛选前的清理位——两模态不跨筛选态存活） */
+    private closeModals;
+    /** 光标条目（无条目/零条目可见 = undefined——动词消隐判据面） */
+    private cursorEntry;
+    /** 光标移动（条目间循环——非条目行不驻留；移动后视口对齐光标行） */
+    private moveCursor;
+    /** 视口对齐光标行（顶对齐——近底行由 ScrollView 夹取自然呈现） */
+    private ensureCursorVisible;
+    /**
+     * 整表重取重建（开屏快照与动词成功后的统一路——06 §7 定形注⑤）：
+     * 三源取数（health 恒全库 / listVisible 双分流 / listForExport 终态双过滤）
+     * → 行集三段式构建 → 光标锚定（同 id 优先；锚定目标缺席驻留原位就近；
+     * 零条目可见 = -1 行动词消隐）。
+     */
+    private rebuild;
+    /**
+     * 条目行构建（工具读面同形——`[m:短id] [kind] summary  id=完整id
+     * updated=ISO`；p-1 时效尾缀同源）：消毒经注入的 §8.2 统一函数罩住
+     * （blocked → summary 遮蔽保 id 操作面；quoted → 引述注记）；冻结行行首
+     * ✱、终态行整行 dim + supersededBy 记号。
+     */
+    private entryLine;
+    /** 退出（闭锁——单次） */
+    private exit;
+    /**
+     * 视口切片带样式写出：样式段（dim 分区头/投影行/终态行）按切片边界分段
+     * 落格 + 光标行整行反色叠加。列位经 prefixDisplayWidth 换算（CJK 双宽
+     * 对齐与折叠算术同源——HistoryViewer writeSlice 同构的简化形：无搜索
+     * 高亮/选区面）。
+     */
+    protected writeSlice(buffer: CellBuffer, region: Region, displayRow: number, seg: VisualSegment): void;
+}