@love-moon/tui-driver 0.2.0

package/dist/term/HeadlessScreen.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeadlessScreen = void 0;
+const headless_1 = require("@xterm/headless");
+const addon_serialize_1 = require("@xterm/addon-serialize");
+const ScreenSnapshot_js_1 = require("./ScreenSnapshot.js");
+const DEFAULT_COLS = 120;
+const DEFAULT_ROWS = 40;
+const DEFAULT_SCROLLBACK = 5000;
+class HeadlessScreen {
+    terminal;
+    serializeAddon;
+    _cols;
+    _rows;
+    onTerminalReply;
+    constructor(options = {}) {
+        this._cols = options.cols ?? DEFAULT_COLS;
+        this._rows = options.rows ?? DEFAULT_ROWS;
+        this.onTerminalReply = options.onTerminalReply;
+        this.terminal = new headless_1.Terminal({
+            cols: this._cols,
+            rows: this._rows,
+            scrollback: options.scrollback ?? DEFAULT_SCROLLBACK,
+            allowProposedApi: true,
+        });
+        this.serializeAddon = new addon_serialize_1.SerializeAddon();
+        this.terminal.loadAddon(this.serializeAddon);
+    }
+    get cols() {
+        return this._cols;
+    }
+    get rows() {
+        return this._rows;
+    }
+    write(data) {
+        const replies = this.getDsrReplies(data);
+        this.terminal.write(data);
+        if (this.onTerminalReply && replies.length > 0) {
+            for (const reply of replies) {
+                this.onTerminalReply(reply);
+            }
+        }
+    }
+    resize(cols, rows) {
+        this._cols = cols;
+        this._rows = rows;
+        this.terminal.resize(cols, rows);
+    }
+    clear() {
+        this.terminal.clear();
+    }
+    reset() {
+        this.terminal.reset();
+    }
+    snapshot() {
+        const viewportText = this.getViewportText();
+        const scrollbackText = this.getScrollbackText();
+        const cursor = this.getCursor();
+        const hash = ScreenSnapshot_js_1.ScreenSnapshot.computeHash(viewportText);
+        return new ScreenSnapshot_js_1.ScreenSnapshot({
+            viewportText,
+            scrollbackText,
+            cursor,
+            hash,
+            timestamp: Date.now(),
+            cols: this._cols,
+            rows: this._rows,
+        });
+    }
+    getViewportText() {
+        const buffer = this.terminal.buffer.active;
+        const lines = [];
+        for (let i = 0; i < this._rows; i++) {
+            const line = buffer.getLine(buffer.baseY + i);
+            if (line) {
+                lines.push(line.translateToString(true));
+            }
+            else {
+                lines.push("");
+            }
+        }
+        return lines.join("\n");
+    }
+    getScrollbackText() {
+        const buffer = this.terminal.buffer.active;
+        const lines = [];
+        const totalLines = buffer.baseY + this._rows;
+        for (let i = 0; i < totalLines; i++) {
+            const line = buffer.getLine(i);
+            if (line) {
+                lines.push(line.translateToString(true));
+            }
+            else {
+                lines.push("");
+            }
+        }
+        return lines.join("\n");
+    }
+    getCursor() {
+        const buffer = this.terminal.buffer.active;
+        return {
+            x: buffer.cursorX,
+            y: buffer.cursorY,
+        };
+    }
+    getDsrReplies(data) {
+        const dsrRegex = /\x1b\[(\?)?6n/g;
+        const matches = data.match(dsrRegex);
+        if (!matches || matches.length === 0) {
+            return [];
+        }
+        const cursor = this.getCursor();
+        const row = cursor.y + 1;
+        const col = cursor.x + 1;
+        const reply = `\x1b[${row};${col}R`;
+        return Array.from({ length: matches.length }, () => reply);
+    }
+    serialize() {
+        return this.serializeAddon.serialize();
+    }
+    dispose() {
+        this.terminal.dispose();
+    }
+}
+exports.HeadlessScreen = HeadlessScreen;
+//# sourceMappingURL=HeadlessScreen.js.map

package/dist/term/HeadlessScreen.js.map

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

package/dist/term/ScreenSnapshot.d.ts

@@ -0,0 +1,37 @@
+export interface ScreenSnapshotData {
+    viewportText: string;
+    scrollbackText: string;
+    cursor: {
+        x: number;
+        y: number;
+    };
+    hash: string;
+    timestamp: number;
+    cols: number;
+    rows: number;
+}
+export declare class ScreenSnapshot implements ScreenSnapshotData {
+    readonly viewportText: string;
+    readonly scrollbackText: string;
+    readonly cursor: {
+        x: number;
+        y: number;
+    };
+    readonly hash: string;
+    readonly timestamp: number;
+    readonly cols: number;
+    readonly rows: number;
+    constructor(data: ScreenSnapshotData);
+    static computeHash(text: string): string;
+    getViewportLines(): string[];
+    getScrollbackLines(): string[];
+    getViewportWithoutBottom(bottomLines: number): string;
+    matchesPattern(pattern: RegExp, region?: "viewport" | "scrollback"): boolean;
+    findPattern(pattern: RegExp, region?: "viewport" | "scrollback"): RegExpMatchArray | null;
+    diff(other: ScreenSnapshot): {
+        added: string[];
+        removed: string[];
+    };
+    toJSON(): ScreenSnapshotData;
+}
+//# sourceMappingURL=ScreenSnapshot.d.ts.map

package/dist/term/ScreenSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenSnapshot.d.ts","sourceRoot":"","sources":["../../src/term/ScreenSnapshot.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,cAAe,YAAW,kBAAkB;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,kBAAkB;IAUpC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIxC,gBAAgB,IAAI,MAAM,EAAE;IAI5B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQrD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,UAAU,GAAG,YAAyB,GAAG,OAAO;IAKxF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,UAAU,GAAG,YAAyB,GAAG,gBAAgB,GAAG,IAAI;IAKrG,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG;QAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB;IAaD,MAAM,IAAI,kBAAkB;CAW7B"}

package/dist/term/ScreenSnapshot.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenSnapshot = void 0;
+const crypto_1 = require("crypto");
+class ScreenSnapshot {
+    viewportText;
+    scrollbackText;
+    cursor;
+    hash;
+    timestamp;
+    cols;
+    rows;
+    constructor(data) {
+        this.viewportText = data.viewportText;
+        this.scrollbackText = data.scrollbackText;
+        this.cursor = data.cursor;
+        this.hash = data.hash;
+        this.timestamp = data.timestamp;
+        this.cols = data.cols;
+        this.rows = data.rows;
+    }
+    static computeHash(text) {
+        return (0, crypto_1.createHash)("md5").update(text).digest("hex").slice(0, 16);
+    }
+    getViewportLines() {
+        return this.viewportText.split("\n");
+    }
+    getScrollbackLines() {
+        return this.scrollbackText.split("\n");
+    }
+    getViewportWithoutBottom(bottomLines) {
+        const lines = this.getViewportLines();
+        if (bottomLines >= lines.length) {
+            return "";
+        }
+        return lines.slice(0, lines.length - bottomLines).join("\n");
+    }
+    matchesPattern(pattern, region = "viewport") {
+        const text = region === "viewport" ? this.viewportText : this.scrollbackText;
+        return pattern.test(text);
+    }
+    findPattern(pattern, region = "viewport") {
+        const text = region === "viewport" ? this.viewportText : this.scrollbackText;
+        return text.match(pattern);
+    }
+    diff(other) {
+        const thisLines = this.scrollbackText.split("\n");
+        const otherLines = other.scrollbackText.split("\n");
+        const thisSet = new Set(thisLines);
+        const otherSet = new Set(otherLines);
+        const added = otherLines.filter(line => !thisSet.has(line));
+        const removed = thisLines.filter(line => !otherSet.has(line));
+        return { added, removed };
+    }
+    toJSON() {
+        return {
+            viewportText: this.viewportText,
+            scrollbackText: this.scrollbackText,
+            cursor: this.cursor,
+            hash: this.hash,
+            timestamp: this.timestamp,
+            cols: this.cols,
+            rows: this.rows,
+        };
+    }
+}
+exports.ScreenSnapshot = ScreenSnapshot;
+//# sourceMappingURL=ScreenSnapshot.js.map

package/dist/term/ScreenSnapshot.js.map

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

package/dist/term/index.d.ts

@@ -0,0 +1,3 @@
+export { HeadlessScreen, HeadlessScreenOptions } from "./HeadlessScreen.js";
+export { ScreenSnapshot, ScreenSnapshotData } from "./ScreenSnapshot.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/term/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/term/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/term/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenSnapshot = exports.HeadlessScreen = void 0;
+var HeadlessScreen_js_1 = require("./HeadlessScreen.js");
+Object.defineProperty(exports, "HeadlessScreen", { enumerable: true, get: function () { return HeadlessScreen_js_1.HeadlessScreen; } });
+var ScreenSnapshot_js_1 = require("./ScreenSnapshot.js");
+Object.defineProperty(exports, "ScreenSnapshot", { enumerable: true, get: function () { return ScreenSnapshot_js_1.ScreenSnapshot; } });
+//# sourceMappingURL=index.js.map

package/dist/term/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/term/index.ts"],"names":[],"mappings":";;;AAAA,yDAA4E;AAAnE,mHAAA,cAAc,OAAA;AACvB,yDAAyE;AAAhE,mHAAA,cAAc,OAAA"}

package/docs/tui-driver_implementation_plan.md

@@ -0,0 +1,307 @@
+# TUI Driver（状态机 + Screen Buffer + Expect）实现计划（Headless）
+> 目标：使用 **node-pty** 驱动 **Codex / Claude Code** 的交互式 TUI/REPL；利用 **@xterm/headless** 进行 ANSI/终端仿真和 screen buffer 维护；在 headless 模式下通过 “expect + 状态机” 与 TUI 稳定交互；抽取模型输出并返回给上层。
+
+---
+
+## 1. 总体思路（为什么 headless 可行）
+
+- `node-pty`：提供伪终端（PTY），可以让交互式 CLI 认为自己在真实 TTY 中运行，从而进入 TUI/REPL 模式。
+- `@xterm/headless`：在 Node 环境中模拟终端（解析 ANSI 控制序列、光标移动、清屏、局部重绘、scrollback 等），**不渲染界面**。
+- 关键：你不再把 PTY 输出当 “stdout 文本流”，而是当作 “终端屏幕刷新指令”。因此必须通过终端仿真器维护 screen buffer，再从 buffer 做匹配/抽取。
+
+推荐加：`@xterm/addon-serialize` 来序列化 framebuffer，用于日志、diff、回归测试。
+
+---
+
+## 2. 技术栈与依赖
+
+### Node 依赖
+- `node-pty`：spawn 交互式 CLI，输入/输出、resize、signal。
+- `@xterm/headless`：headless 终端仿真器。
+- `@xterm/addon-serialize`：将屏幕/scrollback 序列化为字符串（可选但强烈推荐）。
+- （可选）`fast-diff` / `diff-match-patch`：用于文本 diff。
+- （可选）`p-queue`：用于请求串行队列（避免输出交错）。
+
+---
+
+## 3. 架构拆分
+
+建议文件结构：
+
+```
+src/
+  pty/
+    PtySession.ts
+  term/
+    HeadlessScreen.ts
+    ScreenSnapshot.ts
+  expect/
+    ExpectEngine.ts
+    Matchers.ts
+  driver/
+    TuiProfile.ts
+    TuiDriver.ts
+    StateMachine.ts
+    profiles/
+      claudeCode.profile.ts
+      codex.profile.ts
+  extract/
+    OutputExtractor.ts
+    Diff.ts
+  index.ts
+```
+
+---
+
+## 4. 关键模块设计
+
+### 4.1 PtySession（node-pty wrapper）
+职责：
+- spawn/kill CLI
+- write 输入（按键、文本、粘贴）
+- resize（保持 cols/rows 固定）
+- onData 推送输出（raw chunk）
+
+关键点：
+- 固定 `TERM=xterm-256color`
+- 固定 `LANG/LC_ALL` 以减少文案变化（建议英文）
+- 同一 PTY **强制串行**：一次只跑一个 turn
+
+---
+
+### 4.2 HeadlessScreen（@xterm/headless）
+职责：
+- 创建 Terminal：`new Terminal({ cols, rows, scrollback })`
+- 接收 PTY chunk：`term.write(chunk)`
+- 提供快照 API：`snapshot()` → `ScreenSnapshot`
+
+`ScreenSnapshot` 内容建议：
+- `viewportText`：可见区域（rows 行）
+- `scrollbackText`：全量（scrollback + viewport）
+- `cursor`：光标坐标
+- `hash`：屏幕 hash（用于 idle 判断）
+- `timestamp`
+
+实现 viewportText：
+- 直接读 xterm buffer 每行 cell 拼接
+- 或 serialize addon：`serializeAddon.serialize({ ... })`
+
+---
+
+### 4.3 ExpectEngine（屏幕期望/等待引擎）
+你需要的不止 `waitFor(regex)`，还包括：
+
+- **稳定性等待**：某条件成立并持续 stableMs
+- **Idle 等待**：屏幕 hash N ms 无变化
+- **区域匹配**：仅在底栏/输入框区域搜索（减少误判）
+- **超时 recovery hook**：超时后执行 Esc/Ctrl+C 或重启
+
+接口示例：
+```ts
+await expect.until({
+  name: "READY",
+  match: snap => /Ready|New chat|>/i.test(snap.viewportText),
+  stableMs: 300,
+  timeoutMs: 15000,
+});
+
+await expect.untilIdle({
+  name: "STREAM_END",
+  idleMs: 800,
+  timeoutMs: 120000,
+});
+```
+
+---
+
+### 4.4 TuiProfile（工具差异配置层）
+不同工具 TUI 行为不同（锚点、快捷键、底栏文案）。必须配置化：
+
+```ts
+export type TuiProfile = {
+  name: "claude-code" | "codex";
+  command: string;
+  args: string[];
+  env?: Record<string,string>;
+
+  anchors: {
+    ready: RegExp[];     // 输入框可用/就绪
+    busy?: RegExp[];     // 生成中
+    error?: RegExp[];    // 断网/鉴权失败
+  };
+
+  keys: {
+    submit: string[];    // 如 ["ENTER"] 或 ["CTRL_J"]
+    newChat?: string[];
+    cancel?: string[];   // 如 ["ESC","ESC"] 或 ["CTRL_C"]
+  };
+
+  extraction: {
+    mode: "diff-viewport" | "diff-scrollback";
+    stripPatterns: RegExp[];
+    stripEcho?: boolean;
+    bottomUiLines?: number; // 底栏高度
+  };
+};
+```
+
+你最终只需要维护 2 份 Profile：
+- `claudeCode.profile.ts`
+- `codex.profile.ts`
+
+---
+
+## 5. 状态机（StateMachine）设计
+
+通用状态：
+
+1) **BOOT**
+- spawn PTY
+- 等待 UI 稳定（出现 ready/busy/error 任一）
+
+2) **WAIT_READY**
+- expect ready anchor（稳定 N ms）
+
+3) **PREPARE_TURN（可选）**
+- 新会话/清理上下文（newChat keys）
+- 清弹窗：Esc Esc
+
+4) **TYPE_PROMPT**
+- 输入 prompt（分块粘贴或逐字）
+- 可控速率（避免 TUI 丢字符）
+
+5) **SUBMIT**
+- 发送：ENTER / Ctrl+J / Ctrl+Enter 等
+
+6) **WAIT_STREAM_START**
+- 出现 busy anchor 或 hash 开始快速变化
+
+7) **WAIT_STREAM_END**
+- busy 消失 + idleMs 达标（组合更稳）
+
+8) **CAPTURE**
+- 快照 before/after
+- 输出抽取
+
+9) **DONE / ERROR**
+- 失败进入 recovery：cancel 或重启
+
+---
+
+## 6. 输出抽取策略（核心难点）
+
+### 推荐：diff + 过滤（最通用）
+流程：
+1. 发送前保存 `before = snapshot()`
+2. 结束后保存 `after = snapshot()`
+3. diff `viewportText` / `scrollbackText`
+4. 新增部分作为候选 output
+5. 过滤掉底栏/快捷键提示/状态栏（stripPatterns）
+
+### 进阶：区域抽取
+多数 TUI：
+- 输出区在上
+- 输入框在下
+- 底部有 help bar
+
+建议：只抽取 viewport 的 **上半/去掉底部 N 行**：
+- `bottomUiLines = 2~5`
+
+---
+
+## 7. 关键鲁棒性细节（必须做）
+
+### 7.1 固定尺寸
+- `pty.spawn(..., { cols: 120, rows: 40 })`
+- `new Terminal({ cols:120, rows:40 })`
+- 必要时同步 resize
+
+### 7.2 输入节流
+大 prompt 粘贴分块：
+- 每 200~500 chars 一块
+- 每块 sleep 10~30ms
+逐字输入作为 fallback
+
+### 7.3 Recovery 策略
+常见：
+- `ESC ESC`：清弹窗
+- `CTRL_C`：中断生成
+- 超时仍无解：kill + restart（回到 BOOT）
+
+### 7.4 串行队列
+一个 PTY driver 一次只处理一个 ask。
+否则输出混在同一 screen buffer 无法区分。
+
+### 7.5 录制回放（强烈建议）
+记录：
+- 每次 snapshot 的 viewportText + timestamp + hash
+- 或 raw PTY chunk（较大）
+用于 UI 改版后的回归测试、anchor 修正。
+
+---
+
+## 8. 最小可运行骨架（伪代码）
+
+```ts
+const pty = new PtySession(profile.command, profile.args, { cols, rows, env });
+const screen = new HeadlessScreen({ cols, rows, scrollback: 5000 });
+
+pty.onData(chunk => screen.write(chunk));
+
+const expect = new ExpectEngine(screen);
+const driver = new TuiDriver({ pty, screen, expect, profile });
+
+export async function ask(prompt: string) {
+  await driver.ensureReady();               // BOOT + WAIT_READY
+  const before = screen.snapshot();
+
+  await driver.prepareTurn();               // 可选 newChat/clear
+  await driver.typePrompt(prompt);          // 分块输入
+  await driver.submit();                    // ENTER
+
+  await driver.waitStreamStart();           // busy/hash变化
+  await driver.waitStreamEnd();             // busy消失 + idle
+
+  const after = screen.snapshot();
+  return extractAnswer(before, after, profile.extraction);
+}
+```
+
+---
+
+## 9. 落地步骤（建议按周推进）
+
+### Step 1：跑通 headless terminal pipeline
+- spawn claude/codex
+- 把 PTY 输出写入 xterm headless
+- 每 100ms 打印 viewportText 到日志
+
+### Step 2：录制真实交互屏幕快照
+- 手动输入一次 prompt
+- 记录 3 个关键阶段：ready / streaming / done
+- 从快照中提取 anchors
+
+### Step 3：写 Profile
+- ready anchor
+- busy anchor（如有）
+- submit/newChat/cancel key sequences
+- stripPatterns
+
+### Step 4：实现 ExpectEngine + 状态机
+- 先实现 ensureReady + ask 一轮
+- 再加入 timeout/recovery
+
+### Step 5：输出抽取与回归
+- diff-scrollback/viewport
+- strip UI
+- 做 30 条 prompt 回归，统计成功率、误判率
+
+---
+
+## 10. Notes：为什么 TUI driver 不一定比一次性命令更“鲁棒”
+- TUI 改版会破坏锚点
+- 不同 terminal 尺寸导致布局变化
+- 彩色/主题影响字符
+- 重绘节奏让 raw chunk 匹配失效
+
+因此建议：

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@love-moon/tui-driver",
+  "version": "0.2.0",
+  "description": "TUI Driver for interactive CLI tools like Claude Code and Codex",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build-pty": "npx node-gyp rebuild --directory=node_modules/.pnpm/node-pty@1.1.0/node_modules/node-pty",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "npx tsx test/integration.ts",
+    "test:claude": "npx tsx test/integration.ts --claude",
+    "lint": "eslint src --ext .ts"
+  },
+  "dependencies": {
+    "node-pty": "^1.0.0",
+    "@xterm/headless": "^5.5.0",
+    "@xterm/addon-serialize": "^0.13.0",
+    "fast-diff": "^1.3.0",
+    "p-queue": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/pnpm-workspace.yaml

@@ -0,0 +1 @@
+{"onlyBuiltDependencies": ["node-pty", "esbuild"]}