@caoruhua/open-claude-remote 0.1.0

package/dist/session/session-controller.js

@@ -0,0 +1,273 @@
+import { OutputBuffer } from '../pty/output-buffer.js';
+import { handleWsMessage } from '../ws/ws-handler.js';
+import { logger } from '../logger/logger.js';
+const WS_FLUSH_INTERVAL_MS = 16;
+const WS_MAX_CHUNK_BYTES = 32 * 1024;
+const WS_HIGH_WATERMARK_BYTES = 256 * 1024;
+/**
+ * Core coordinator: wires PTY ↔ WebSocket ↔ Terminal ↔ Hooks.
+ */
+export class SessionController {
+    ptyManager;
+    wsServer;
+    hookReceiver;
+    terminalRelay;
+    _status = 'idle';
+    buffer;
+    pushService = null;
+    dingtalkService = null;
+    wsPendingChunks = [];
+    wsPendingBytes = 0;
+    wsFlushTimer = null;
+    ptyInputBytesTotal = 0;
+    wsFlushCount = 0;
+    wsFlushBytesTotal = 0;
+    wsMaxPendingBytes = 0;
+    wsBackpressureEvents = 0;
+    constructor(ptyManager, wsServer, hookReceiver, maxBufferLines, terminalRelay) {
+        this.ptyManager = ptyManager;
+        this.wsServer = wsServer;
+        this.hookReceiver = hookReceiver;
+        this.terminalRelay = terminalRelay;
+        this.buffer = new OutputBuffer(maxBufferLines);
+        this.setupPtyHandlers();
+        this.setupWsHandlers();
+        this.setupHookHandlers();
+    }
+    get status() {
+        return this._status;
+    }
+    get connectedClients() {
+        return this.wsServer.clientCount;
+    }
+    /**
+     * Inject PushService for hook-triggered notifications.
+     */
+    setPushService(pushService) {
+        this.pushService = pushService;
+    }
+    /**
+     * Inject DingtalkService for hook-triggered notifications.
+     */
+    setDingtalkService(dingtalkService) {
+        this.dingtalkService = dingtalkService;
+    }
+    /**
+     * Wire PTY output → buffer + WS broadcast + process.stdout
+     */
+    setupPtyHandlers() {
+        this.ptyManager.on('data', (data) => {
+            // Write to PC terminal
+            process.stdout.write(data);
+            this.ptyInputBytesTotal += Buffer.byteLength(data, 'utf8');
+            // Buffer raw data for reconnection history
+            this.buffer.append(data);
+            // Broadcast raw PTY output to web clients (batched)
+            // xterm.js handles all ANSI sequences natively including alternate screen
+            this.enqueueWsOutput(data);
+        });
+        this.ptyManager.on('exit', (exitCode) => {
+            this.flushPendingWsOutput();
+            this._status = 'idle';
+            this.wsServer.broadcast({
+                type: 'session_ended',
+                exitCode,
+                reason: exitCode === 0 ? 'Process exited normally' : `Process exited with code ${exitCode}`,
+            });
+            logger.info({
+                exitCode,
+                ptyInputBytesTotal: this.ptyInputBytesTotal,
+                wsFlushCount: this.wsFlushCount,
+                wsFlushBytesTotal: this.wsFlushBytesTotal,
+                wsMaxPendingBytes: this.wsMaxPendingBytes,
+                wsBackpressureEvents: this.wsBackpressureEvents,
+            }, 'Claude Code session ended');
+        });
+        this.ptyManager.on('error', (err) => {
+            logger.error({ err }, 'PTY error');
+            this.wsServer.broadcast({
+                type: 'error',
+                code: 'pty_error',
+                message: err.message,
+            });
+        });
+        // Broadcast PTY resize to web clients
+        this.ptyManager.on('resize', (cols, rows) => {
+            logger.debug({ cols, rows }, 'PTY resize event, broadcasting to web clients');
+            this.wsServer.broadcast({
+                type: 'terminal_resize',
+                cols,
+                rows,
+            });
+        });
+    }
+    enqueueWsOutput(data) {
+        this.wsPendingChunks.push(data);
+        this.wsPendingBytes += Buffer.byteLength(data, 'utf8');
+        this.wsMaxPendingBytes = Math.max(this.wsMaxPendingBytes, this.wsPendingBytes);
+        if (this.wsPendingBytes >= WS_HIGH_WATERMARK_BYTES) {
+            this.wsBackpressureEvents += 1;
+            this.flushPendingWsOutput();
+            return;
+        }
+        if (this.wsPendingBytes >= WS_MAX_CHUNK_BYTES) {
+            this.flushPendingWsOutput();
+            return;
+        }
+        if (!this.wsFlushTimer) {
+            this.wsFlushTimer = setTimeout(() => {
+                this.wsFlushTimer = null;
+                this.flushPendingWsOutput();
+            }, WS_FLUSH_INTERVAL_MS);
+        }
+    }
+    flushPendingWsOutput() {
+        if (this.wsFlushTimer) {
+            clearTimeout(this.wsFlushTimer);
+            this.wsFlushTimer = null;
+        }
+        if (this.wsPendingChunks.length === 0) {
+            return;
+        }
+        const output = this.wsPendingChunks.join('');
+        const flushBytes = this.wsPendingBytes;
+        this.wsPendingChunks = [];
+        this.wsPendingBytes = 0;
+        this.wsFlushCount += 1;
+        this.wsFlushBytesTotal += flushBytes;
+        this.wsServer.broadcast({
+            type: 'terminal_output',
+            data: output,
+            seq: this.buffer.sequenceNumber,
+        });
+        logger.debug({
+            flushBytes,
+            wsFlushCount: this.wsFlushCount,
+            wsPendingBytes: this.wsPendingBytes,
+            wsMaxPendingBytes: this.wsMaxPendingBytes,
+            wsBackpressureEvents: this.wsBackpressureEvents,
+        }, 'Flushed batched terminal output');
+    }
+    /**
+     * Wire WS messages → PTY input
+     */
+    setupWsHandlers() {
+        this.wsServer.onMessage((ws, data, clientType) => {
+            handleWsMessage(ws, data, {
+                onUserInput: (input) => {
+                    logger.debug({ length: input.length }, 'User input from client');
+                    this.ptyManager.write(input);
+                },
+                onResize: (cols, rows) => {
+                    // webapp 在线时忽略 attach 的 resize（webapp 是主控端）
+                    if (clientType === 'attach') {
+                        const counts = this.wsServer.getClientCounts();
+                        if (counts.webapp > 0) {
+                            logger.debug({ cols, rows }, 'Ignoring attach resize, webapp is master');
+                            return;
+                        }
+                    }
+                    logger.info({ cols, rows, clientType, currentPtyCols: this.ptyManager.cols, currentPtyRows: this.ptyManager.rows }, 'Resize request from client, applying to PTY');
+                    this.ptyManager.resize(cols, rows);
+                    logger.info({ ptyCols: this.ptyManager.cols, ptyRows: this.ptyManager.rows }, 'PTY resize after client request');
+                },
+            });
+        });
+        // 处理客户端连接：区分主控端（webapp）和从控端（attach）
+        this.wsServer.onConnect((ws, clientType) => {
+            if (clientType === 'attach') {
+                // attach 客户端连接：作为从控端
+                // 暂停 PC 端 resize，attach 将跟随 webapp 的尺寸
+                if (this.terminalRelay) {
+                    this.terminalRelay.pauseResize();
+                }
+                logger.info('attach client connected (slave mode)');
+            }
+            else {
+                // WebApp 客户端连接：作为主控端
+                // 暂停 PC 端 resize，让 webapp 接管尺寸控制
+                const counts = this.wsServer.getClientCounts();
+                if (this.terminalRelay && counts.attach === 0 && counts.webapp === 1) {
+                    this.terminalRelay.pauseResize();
+                    logger.info('First WebApp client connected, PC resize paused');
+                }
+                logger.info('WebApp client connected (master mode)');
+            }
+            // 发送历史数据
+            this.wsServer.sendTo(ws, {
+                type: 'history_sync',
+                data: this.buffer.getFullContent(),
+                seq: this.buffer.sequenceNumber,
+                status: this._status,
+                cols: this.ptyManager.cols,
+                rows: this.ptyManager.rows,
+            });
+        });
+        // 处理客户端断开：根据剩余客户端类型决定是否恢复 PC 端 resize
+        this.wsServer.onDisconnect((clientCounts) => {
+            const { attach, webapp } = clientCounts;
+            if (attach === 0 && webapp === 0) {
+                // 所有客户端断开：恢复 PC 端 resize
+                if (this.terminalRelay) {
+                    this.terminalRelay.resumeResize();
+                    logger.info('All clients disconnected, PC resize resumed');
+                }
+            }
+            else if (attach === 0 && webapp > 0) {
+                // attach 断开，但 WebApp 还在：
+                // 不恢复 PC 端 resize（WebApp 继续控制尺寸）
+                logger.info({ webappCount: webapp }, 'attach disconnected, WebApp still connected');
+            }
+            else if (attach > 0 && webapp === 0) {
+                // WebApp 全部断开，attach 仍在：
+                // 广播当前 PTY 尺寸，触发 attach 客户端的 scheduleResizeSync 恢复自身尺寸
+                this.wsServer.broadcast({
+                    type: 'terminal_resize',
+                    cols: this.ptyManager.cols,
+                    rows: this.ptyManager.rows,
+                });
+                logger.info('All WebApps disconnected, broadcast PTY size to trigger attach re-sync');
+            }
+            // attach 还在且 webapp 也在：保持当前状态
+        });
+    }
+    /**
+     * Wire Hook notifications → status update + Push notification
+     */
+    setupHookHandlers() {
+        this.hookReceiver.on('notification', (notification) => {
+            this._status = 'waiting_input';
+            this.wsServer.broadcast({
+                type: 'status_update',
+                status: 'waiting_input',
+                detail: `Waiting for input: ${notification.tool}`,
+            });
+            // Send push notification if service is available
+            if (this.pushService) {
+                this.pushService.notifyAll({
+                    title: 'Claude Code 需要输入',
+                    body: notification.message,
+                    tag: 'claude-input',
+                    renotify: true,
+                }).catch((err) => {
+                    logger.error({ err }, 'Failed to send push notification');
+                });
+            }
+            // Send dingtalk notification if service is available
+            if (this.dingtalkService) {
+                this.dingtalkService.sendNotification('Claude Code 需要输入', notification.tool, notification.message).catch((err) => {
+                    logger.error({ err }, 'Failed to send dingtalk notification');
+                });
+            }
+            logger.info({ tool: notification.tool }, 'Hook notification processed, status set to waiting_input');
+        });
+    }
+    /**
+     * Update session status.
+     */
+    setStatus(status) {
+        this._status = status;
+        this.wsServer.broadcast({ type: 'status_update', status });
+    }
+}
+//# sourceMappingURL=session-controller.js.map

package/dist/session/session-controller.js.map

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

package/dist/terminal/terminal-relay.d.ts

@@ -0,0 +1,29 @@
+import type { IPtyManager } from '../pty/types.js';
+export declare class TerminalRelay {
+    private ptyManager;
+    private stdinHandler;
+    private resizeHandler;
+    private wasRaw;
+    private lastCtrlCTime;
+    private resizePaused;
+    constructor(ptyManager: IPtyManager);
+    /**
+     * Start relaying stdin → PTY and listen for terminal resize.
+     */
+    start(): void;
+    /**
+     * Pause forwarding PC terminal resize events to PTY.
+     * Used when a mobile client connects and becomes the resize source.
+     */
+    pauseResize(): void;
+    /**
+     * Resume forwarding PC terminal resize events to PTY.
+     * Immediately syncs current PC terminal size to PTY.
+     */
+    resumeResize(): void;
+    /**
+     * Stop relaying and restore terminal state.
+     */
+    stop(): void;
+}
+//# sourceMappingURL=terminal-relay.d.ts.map

package/dist/terminal/terminal-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-relay.d.ts","sourceRoot":"","sources":["../../src/terminal/terminal-relay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAcnD,qBAAa,aAAa;IAOZ,OAAO,CAAC,UAAU;IAN9B,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,YAAY,CAAkB;gBAElB,UAAU,EAAE,WAAW;IAE3C;;OAEG;IACH,KAAK,IAAI,IAAI;IA8Cb;;;OAGG;IACH,WAAW,IAAI,IAAI;IAKnB;;;OAGG;IACH,YAAY,IAAI,IAAI;IAUpB;;OAEG;IACH,IAAI,IAAI,IAAI;CAiBb"}

package/dist/terminal/terminal-relay.js

@@ -0,0 +1,106 @@
+import { logger } from '../logger/logger.js';
+/**
+ * Relays PC terminal stdin/stdout to/from the PTY process.
+ * Sets stdin to raw mode so all keystrokes pass through directly.
+ */
+const CTRL_C = '\x03';
+// Kitty keyboard protocol CSI u variants for Ctrl+C:
+//   basic: \x1b[99;5u  |  with event type: \x1b[99;5:1u  |  with text: \x1b[99;5;99u
+// Match press/repeat (event type 1 or 2) but not release (3)
+const KITTY_CTRL_C_RE = /\x1b\[99;5(?::(?:[12]))?(?:;\d+)*u/;
+const DOUBLE_CTRL_C_WINDOW_MS = 500;
+export class TerminalRelay {
+    ptyManager;
+    stdinHandler = null;
+    resizeHandler = null;
+    wasRaw = false;
+    lastCtrlCTime = 0;
+    resizePaused = false;
+    constructor(ptyManager) {
+        this.ptyManager = ptyManager;
+    }
+    /**
+     * Start relaying stdin → PTY and listen for terminal resize.
+     */
+    start() {
+        if (!process.stdin.isTTY) {
+            logger.warn('stdin is not a TTY, terminal relay will not set raw mode');
+            return;
+        }
+        // Save and set raw mode
+        this.wasRaw = process.stdin.isRaw ?? false;
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        // stdin → PTY
+        this.stdinHandler = (data) => {
+            const str = data.toString();
+            this.ptyManager.write(str);
+            // Double Ctrl+C within window → send SIGINT to proxy process itself
+            // Support both classic ETX (\x03) and kitty keyboard protocol CSI u encoding
+            if (str.startsWith('\x1b')) {
+                logger.debug({ hex: data.toString('hex'), len: data.length }, 'stdin escape sequence received');
+            }
+            if (str === CTRL_C || KITTY_CTRL_C_RE.test(str)) {
+                const now = Date.now();
+                if (now - this.lastCtrlCTime <= DOUBLE_CTRL_C_WINDOW_MS) {
+                    logger.info('Double Ctrl+C detected, sending SIGINT to proxy process');
+                    process.kill(process.pid, 'SIGINT');
+                }
+                this.lastCtrlCTime = now;
+            }
+        };
+        process.stdin.on('data', this.stdinHandler);
+        // Terminal resize → PTY resize
+        this.resizeHandler = () => {
+            if (this.resizePaused)
+                return;
+            const cols = process.stdout.columns;
+            const rows = process.stdout.rows;
+            if (cols && rows) {
+                this.ptyManager.resize(cols, rows);
+            }
+        };
+        process.stdout.on('resize', this.resizeHandler);
+        logger.info('Terminal relay started (raw mode)');
+    }
+    /**
+     * Pause forwarding PC terminal resize events to PTY.
+     * Used when a mobile client connects and becomes the resize source.
+     */
+    pauseResize() {
+        this.resizePaused = true;
+        logger.info('Terminal relay: PC resize paused (mobile client connected)');
+    }
+    /**
+     * Resume forwarding PC terminal resize events to PTY.
+     * Immediately syncs current PC terminal size to PTY.
+     */
+    resumeResize() {
+        this.resizePaused = false;
+        const cols = process.stdout.columns;
+        const rows = process.stdout.rows;
+        if (cols && rows) {
+            this.ptyManager.resize(cols, rows);
+        }
+        logger.info({ cols, rows }, 'Terminal relay: PC resize resumed, synced PTY size');
+    }
+    /**
+     * Stop relaying and restore terminal state.
+     */
+    stop() {
+        if (this.stdinHandler) {
+            process.stdin.removeListener('data', this.stdinHandler);
+            this.stdinHandler = null;
+        }
+        if (this.resizeHandler) {
+            process.stdout.removeListener('resize', this.resizeHandler);
+            this.resizeHandler = null;
+        }
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(this.wasRaw);
+            process.stdin.pause();
+        }
+        logger.info('Terminal relay stopped');
+    }
+}
+//# sourceMappingURL=terminal-relay.js.map

package/dist/terminal/terminal-relay.js.map

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

package/dist/utils/ansi-filter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Alternate Screen Buffer 过滤器
+ *
+ * 检测 PTY 输出中的 alternate screen buffer 切换序列（\x1b[?1049h/l），
+ * 在交互式 UI 模式时过滤输出，避免 web 端显示错位。
+ *
+ * 典型场景：Claude Code 斜杠命令选择时，下拉菜单使用 alternate screen，
+ * 其 ANSI 定位序列基于 PC 终端尺寸，在 web 端会导致内容错位重叠。
+ */
+/**
+ * Alternate Screen Buffer 状态过滤
+ *
+ * 维护 alternate screen 状态，处理流式数据中可能被切分的 ANSI 序列。
+ */
+export declare class AlternateScreenFilter {
+    private _inAlternateScreen;
+    private pending;
+    /** 当前是否处于 alternate screen 模式 */
+    get inAlternateScreen(): boolean;
+    /**
+     * 处理 PTY 输出数据
+     *
+     * @param data - PTY 输出的原始 ANSI 字符串
+     * @returns 过滤后的数据（alternate screen 期间返回空字符串）
+     */
+    process(data: string): string;
+    /**
+     * 处理数据并返回过滤后的内容
+     */
+    private processData;
+    /**
+     * 保存可能不完整的序列
+     * @returns 是否保存了未完成的序列
+     */
+    private savePendingIncomplete;
+    /**
+     * 重置状态
+     */
+    reset(): void;
+}
+//# sourceMappingURL=ansi-filter.d.ts.map

package/dist/utils/ansi-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi-filter.d.ts","sourceRoot":"","sources":["../../src/utils/ansi-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,OAAO,CAAc;IAE7B,iCAAiC;IACjC,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAS7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAqFnB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/utils/ansi-filter.js

@@ -0,0 +1,147 @@
+/**
+ * Alternate Screen Buffer 过滤器
+ *
+ * 检测 PTY 输出中的 alternate screen buffer 切换序列（\x1b[?1049h/l），
+ * 在交互式 UI 模式时过滤输出，避免 web 端显示错位。
+ *
+ * 典型场景：Claude Code 斜杠命令选择时，下拉菜单使用 alternate screen，
+ * 其 ANSI 定位序列基于 PC 终端尺寸，在 web 端会导致内容错位重叠。
+ */
+/** 进入 alternate screen 的 ANSI 序列 */
+const ALT_SCREEN_ENTER_REGEX = /\x1b\[\?(1049|47)h/;
+/** 退出 alternate screen 的 ANSI 序列 */
+const ALT_SCREEN_EXIT_REGEX = /\x1b\[\?(1049|47)l/;
+/** ANSII ESC 字符 */
+const ESC = '\x1b';
+/**
+ * Alternate Screen Buffer 状态过滤
+ *
+ * 维护 alternate screen 状态，处理流式数据中可能被切分的 ANSI 序列。
+ */
+export class AlternateScreenFilter {
+    _inAlternateScreen = false;
+    pending = '';
+    /** 当前是否处于 alternate screen 模式 */
+    get inAlternateScreen() {
+        return this._inAlternateScreen;
+    }
+    /**
+     * 处理 PTY 输出数据
+     *
+     * @param data - PTY 输出的原始 ANSI 字符串
+     * @returns 过滤后的数据（alternate screen 期间返回空字符串）
+     */
+    process(data) {
+        // 合并上次可能未完成的序列
+        const combined = this.pending + data;
+        this.pending = '';
+        // 处理完整数据
+        return this.processData(combined);
+    }
+    /**
+     * 处理数据并返回过滤后的内容
+     */
+    processData(data) {
+        // 查找所有进入和退出序列的位置
+        const segments = [];
+        // 找出所有进入序列
+        let match;
+        const enterRegex = new RegExp(ALT_SCREEN_ENTER_REGEX.source, 'g');
+        while ((match = enterRegex.exec(data)) !== null) {
+            segments.push({ type: 'enter', index: match.index, length: match[0].length });
+        }
+        // 找出所有退出序列
+        const exitRegex = new RegExp(ALT_SCREEN_EXIT_REGEX.source, 'g');
+        while ((match = exitRegex.exec(data)) !== null) {
+            segments.push({ type: 'exit', index: match.index, length: match[0].length });
+        }
+        // 按位置排序
+        segments.sort((a, b) => a.index - b.index);
+        // 如果没有找到任何序列
+        if (segments.length === 0) {
+            // 检查是否有未完成的序列需要保存
+            this.savePendingIncomplete(data);
+            if (this._inAlternateScreen) {
+                return '';
+            }
+            return data;
+        }
+        // 构建结果
+        let result = '';
+        let currentPos = 0;
+        let inAltScreen = this._inAlternateScreen;
+        for (const seg of segments) {
+            // 处理序列之前的内容（如果有）
+            if (seg.index > currentPos) {
+                const content = data.slice(currentPos, seg.index);
+                if (!inAltScreen) {
+                    result += content;
+                }
+            }
+            // 更新状态
+            if (seg.type === 'enter') {
+                inAltScreen = true;
+            }
+            else {
+                inAltScreen = false;
+            }
+            currentPos = seg.index + seg.length;
+        }
+        // 处理最后一个序列之后的内容
+        if (currentPos < data.length) {
+            const remaining = data.slice(currentPos);
+            // 检查是否有未完成的序列
+            const hasIncomplete = this.savePendingIncomplete(remaining);
+            if (inAltScreen && !hasIncomplete) {
+                // 在 alternate screen 中，且剩余部分是完整内容
+                // 不返回任何内容
+            }
+            else if (!inAltScreen) {
+                // 不在 alternate screen 中
+                if (hasIncomplete) {
+                    // 有未完成的序列，只返回不完整的序列之前的内容
+                    const escIndex = remaining.lastIndexOf(ESC);
+                    if (escIndex > 0) {
+                        result += remaining.slice(0, escIndex);
+                    }
+                }
+                else {
+                    result += remaining;
+                }
+            }
+        }
+        // 更新最终状态
+        this._inAlternateScreen = inAltScreen;
+        return result;
+    }
+    /**
+     * 保存可能不完整的序列
+     * @returns 是否保存了未完成的序列
+     */
+    savePendingIncomplete(data) {
+        // 查找最后一个 ESC 字符的位置
+        const lastEscIndex = data.lastIndexOf(ESC);
+        if (lastEscIndex !== -1) {
+            const afterEsc = data.slice(lastEscIndex);
+            // 如果 ESC 后面内容太短（完整的序列至少 7 字符），可能是不完整的序列
+            if (afterEsc.length < 7) {
+                // 检查是否已经是完整序列
+                const isCompleteEnter = ALT_SCREEN_ENTER_REGEX.test(afterEsc);
+                const isCompleteExit = ALT_SCREEN_EXIT_REGEX.test(afterEsc);
+                if (!isCompleteEnter && !isCompleteExit) {
+                    this.pending = afterEsc;
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * 重置状态
+     */
+    reset() {
+        this._inAlternateScreen = false;
+        this.pending = '';
+    }
+}
+//# sourceMappingURL=ansi-filter.js.map

package/dist/utils/ansi-filter.js.map

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

package/dist/utils/file-lock.d.ts

@@ -0,0 +1,23 @@
+export interface FileLockOptions {
+    /** 最大重试次数 (默认 50) */
+    retries?: number;
+    /** 重试间隔 ms (默认 50) */
+    retryIntervalMs?: number;
+    /** 超过此 ms 视为僵尸锁，强制删除 (默认 10000) */
+    staleMs?: number;
+}
+/**
+ * 同步文件锁。在 fn 执行期间持有 lockPath 目录锁。
+ * fn 无论正常返回还是抛异常，锁都会被释放。
+ *
+ * 注意：锁竞争时使用 Atomics.wait 阻塞事件循环。
+ * 仅适合启动/关闭阶段使用，请求路径上应使用 withFileLockAsync。
+ */
+export declare function withFileLock<T>(lockPath: string, fn: () => T, options?: FileLockOptions): T;
+/**
+ * 异步文件锁。在 fn 执行期间持有 lockPath 目录锁。
+ * fn 无论 resolve 还是 reject，锁都会被释放。
+ * 使用非阻塞 setTimeout 重试，不阻塞事件循环。
+ */
+export declare function withFileLockAsync<T>(lockPath: string, fn: () => Promise<T>, options?: FileLockOptions): Promise<T>;
+//# sourceMappingURL=file-lock.d.ts.map

package/dist/utils/file-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.d.ts","sourceRoot":"","sources":["../../src/utils/file-lock.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8DD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,CAAC,CAqB3F;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,CAAC,CAqBZ"}