handmux 0.25.2 → 0.27.1

package/dist/src/tmux/paneOutputCapture.js

@@ -0,0 +1,180 @@
+import { spawn } from 'node:child_process';
+import { decodeControlData } from './controlProtocol.js';
+const START_TIMEOUT_MS = 5_000;
+const DEFAULT_MAX_BYTES = 256 * 1024;
+const defaultSpawnControl = (command, args, options) => (spawn(command, [...args], options));
+export class TmuxPaneOutputCapture {
+    #pane;
+    #maxBytes;
+    #child;
+    #attached;
+    #startTimer;
+    #resolveAttached;
+    #rejectAttached;
+    #buffer = Buffer.alloc(0);
+    #response;
+    #pending = null;
+    #chunks = [];
+    #bytes = 0;
+    #armed = false;
+    #overflow = false;
+    #failed = false;
+    #closed = false;
+    #lastError = '';
+    constructor({ pane, session, maxBytes = DEFAULT_MAX_BYTES, spawnControl = defaultSpawnControl, }) {
+        if (!/^%\d+$/.test(pane) || !/^\$\d+$/.test(session)) {
+            throw new TypeError('invalid tmux pane output capture target');
+        }
+        this.#pane = pane;
+        this.#maxBytes = Math.max(1, Math.trunc(maxBytes));
+        this.#attached = new Promise((resolve, reject) => {
+            this.#resolveAttached = resolve;
+            this.#rejectAttached = reject;
+        });
+        this.#startTimer = setTimeout(() => this.#fail(new Error('tmux control mode attach timed out')), START_TIMEOUT_MS);
+        this.#startTimer.unref?.();
+        this.#child = spawnControl('tmux', ['-C', 'attach-session', '-E', '-t', session], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.#child.stdout.on('data', (chunk) => this.#onChunk(chunk));
+        this.#child.stderr.on('data', (chunk) => { this.#lastError += chunk.toString('utf8'); });
+        this.#child.stdin.on('error', (error) => this.#fail(error));
+        this.#child.on('error', (error) => this.#fail(error));
+        this.#child.on('exit', (code) => {
+            if (!this.#closed)
+                this.#fail(new Error(this.#lastError || `tmux control mode exited (${code ?? 'unknown'})`));
+        });
+    }
+    async start() {
+        await this.#attached;
+    }
+    async sendKey(key) {
+        if (!/^[A-Za-z0-9-]+$/.test(key))
+            throw new TypeError('invalid tmux key');
+        await this.#attached;
+        await this.#request(`send-keys -t ${this.#pane} ${key}`);
+    }
+    output() {
+        if (!this.#armed || this.#failed || this.#overflow)
+            return null;
+        return Buffer.concat(this.#chunks, this.#bytes);
+    }
+    outputFrames() {
+        if (!this.#armed || this.#failed || this.#overflow)
+            return null;
+        return this.#chunks.map((chunk) => Buffer.from(chunk));
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        clearTimeout(this.#startTimer);
+        const error = new Error('tmux control output capture closed');
+        this.#rejectAttached(error);
+        this.#pending?.reject(error);
+        this.#response?.reject(error);
+        this.#pending = null;
+        this.#response = undefined;
+        try {
+            this.#child.kill();
+        }
+        catch { /* already gone */ }
+    }
+    #onChunk(chunk) {
+        this.#buffer = Buffer.concat([this.#buffer, chunk]);
+        for (;;) {
+            const newline = this.#buffer.indexOf(0x0a);
+            if (newline < 0)
+                return;
+            const line = this.#buffer.subarray(0, newline);
+            this.#buffer = this.#buffer.subarray(newline + 1);
+            this.#onLine(line.at(-1) === 0x0d ? line.subarray(0, -1) : line);
+        }
+    }
+    #onLine(line) {
+        if (line.subarray(0, 8).toString('ascii') === '%output ') {
+            const split = line.indexOf(0x20, 8);
+            if (!this.#armed || split < 0
+                || line.subarray(8, split).toString('ascii') !== this.#pane)
+                return;
+            const output = decodeControlData(line.subarray(split + 1));
+            if (this.#bytes + output.length > this.#maxBytes) {
+                this.#overflow = true;
+                this.#chunks = [];
+                this.#bytes = 0;
+                return;
+            }
+            if (!this.#overflow) {
+                this.#chunks.push(output);
+                this.#bytes += output.length;
+            }
+            return;
+        }
+        if (line.subarray(0, 7).toString('ascii') === '%begin ') {
+            this.#response = this.#pending;
+            this.#pending = null;
+            return;
+        }
+        const ended = line.subarray(0, 5).toString('ascii') === '%end ';
+        const errored = line.subarray(0, 7).toString('ascii') === '%error ';
+        if (ended || errored) {
+            const response = this.#response;
+            this.#response = undefined;
+            if (response) {
+                if (errored)
+                    response.reject(new Error('tmux control command failed'));
+                else {
+                    // tmux never inserts notifications inside a command output block. Arming synchronously at
+                    // this %end makes every subsequently parsed %output byte provably newer than this C-c.
+                    this.#chunks = [];
+                    this.#bytes = 0;
+                    this.#overflow = false;
+                    this.#armed = true;
+                    response.resolve();
+                }
+            }
+            return;
+        }
+        if (line.subarray(0, 17).toString('ascii') === '%session-changed ') {
+            clearTimeout(this.#startTimer);
+            this.#resolveAttached();
+            return;
+        }
+        if (line.subarray(0, 5).toString('ascii') === '%exit') {
+            this.#fail(new Error('tmux control mode detached'));
+        }
+    }
+    #fail(error) {
+        if (this.#failed || this.#closed)
+            return;
+        this.#failed = true;
+        this.#closed = true;
+        clearTimeout(this.#startTimer);
+        this.#rejectAttached(error);
+        this.#pending?.reject(error);
+        this.#response?.reject(error);
+        this.#pending = null;
+        this.#response = undefined;
+        this.#chunks = [];
+        this.#bytes = 0;
+        try {
+            this.#child.kill();
+        }
+        catch { /* already gone */ }
+    }
+    #request(command) {
+        if (this.#closed || this.#failed) {
+            return Promise.reject(new Error('tmux control output capture is unavailable'));
+        }
+        if (this.#pending || this.#response) {
+            return Promise.reject(new Error('tmux control command already pending'));
+        }
+        return new Promise((resolve, reject) => {
+            this.#pending = { resolve, reject };
+            this.#child.stdin.write(`${command}\n`, (error) => {
+                if (error)
+                    this.#fail(error);
+            });
+        });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handmux",
-  "version": "0.25.2",
+  "version": "0.27.1",
   "description": "A mobile vibe-coding cockpit — built on tmux: drive your live session, Claude Code / Codex — anything a terminal can run — from your phone.",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -75,13 +75,13 @@
     "vitest": "^2.0.0"
   },
   "whatsNew": [
+    {"version":"0.27.1","date":"2026-09-08","zh":"腾讯语音 · 终端光标修复 · Codex 对话恢复","en":"Tencent voice · terminal cursor fixes · Codex chat recovery"},
+    {"version":"0.27.0","date":"2026-09-05","zh":"腾讯语音输入 · 终端输入更准确","en":"Tencent voice input · more accurate terminal typing"},
+    {"version":"0.26.0","date":"2026-09-04","zh":"对话精细复制 · Pi 上下文状态","en":"Precise chat copy · Pi context status"},
     {"version":"0.25.2","date":"2026-09-02","zh":"修复 Agent 对话断流、排队与工具路径","en":"Fixed Agent chat streams, queues, and tool paths"},
     {"version":"0.25.1","date":"2026-09-02","zh":"修复 Codex 幽灵任务与对话空白","en":"Fixed Codex ghost tasks and blank chats"},
     {"version":"0.25.0","date":"2026-09-01","zh":"Pi 原生接入 · 多 Agent 对话更可靠","en":"Native Pi support · more reliable agent chat"},
     {"version":"0.24.0","date":"2026-08-11","zh":"Codex 任务进度与 Goal 原生上线","en":"Native Codex task progress and Goals"},
-    {"version":"0.23.0","date":"2026-08-09","zh":"Codex 托管对话正式上线","en":"Managed Codex chat is here"},
-    {"version":"0.22.1","date":"2026-08-04","zh":"网页宽度与网站版本分开控制","en":"Separate page width and site-version controls"},
-    {"version":"0.22.0","date":"2026-08-03","zh":"全屏设置 · 窗口与分屏管理更清晰","en":"Full-screen Settings · clearer window and pane management"},
-    {"version":"0.21.0","date":"2026-08-03","zh":"网页预览：手机直连、电脑代理与静态目录","en":"Web preview: direct, computer proxy, and static folders"}
+    {"version":"0.23.0","date":"2026-08-09","zh":"Codex 托管对话正式上线","en":"Managed Codex chat is here"}
   ]
 }