@bytetrue/byspace 0.2.0-beta.4 → 0.2.0

package/node_modules/@bytetrue/byspace-server/dist/server/terminal/terminal.js

@@ -576,7 +576,15 @@ export async function createTerminal(options) {
     let titleDebounceTimer = null;
     let pendingInput = "";
     let inputFlushImmediate = null;
-    let stateRevision = 0;
+    // emitRevision tracks output emission (incremented immediately on PTY data).
+    // snapshotRevision tracks the headless xterm state (incremented when the
+    // headless xterm write callback fires). Output is emitted to listeners
+    // immediately without waiting for the headless xterm, so keystroke echo
+    // isn't serialized behind a backlog of TUI writes. Snapshots use
+    // snapshotRevision to stay consistent with the headless xterm buffer;
+    // drainHeadlessXterm() bridges the gap before on-demand snapshots.
+    let emitRevision = 0;
+    let snapshotRevision = 0;
     const inputModeTracker = new TerminalInputModeTracker();
     const activityTracker = new TerminalActivityTracker();
     const activityChangeListeners = new Set();
@@ -797,15 +805,21 @@ export async function createTerminal(options) {
         activityChangeListeners.clear();
     }
     function writeOutputToHeadless(data) {
+        emitRevision += 1;
+        const currentRevision = emitRevision;
+        // Write to headless xterm for snapshot fidelity. The callback updates
+        // snapshotRevision so getStateSnapshot() stays consistent with the buffer.
         terminal.write(data, () => {
-            if (disposed || killed) {
-                return;
-            }
-            stateRevision += 1;
-            for (const listener of listeners) {
-                listener({ type: "output", data, revision: stateRevision });
+            if (!disposed && !killed) {
+                snapshotRevision = currentRevision;
             }
         });
+        // Emit to listeners immediately — do not wait for the headless xterm to
+        // parse the write. This removes the serialization that delayed keystroke
+        // echo behind TUI output backlogs (notably ConPTY + Pi on Windows).
+        for (const listener of listeners) {
+            listener({ type: "output", data, revision: currentRevision });
+        }
     }
     // Pipe PTY output to terminal emulator
     ptyProcess.onData((data) => {
@@ -887,9 +901,14 @@ export async function createTerminal(options) {
     function getStateSnapshot(snapshotOptions) {
         return {
             state: getState(snapshotOptions),
-            revision: stateRevision,
+            revision: snapshotRevision,
         };
     }
+    function drainHeadlessXterm() {
+        return new Promise((resolve) => {
+            terminal.write("", () => resolve());
+        });
+    }
     function getSize() {
         return {
             rows: terminal.rows,
@@ -936,7 +955,10 @@ export async function createTerminal(options) {
                 flushPendingInput();
                 terminal.resize(msg.cols, msg.rows);
                 ptyProcess.resize(msg.cols, msg.rows);
-                stateRevision += 1;
+                // Resize affects both headless xterm state and emitted output, so increment
+                // both revision counters to keep snapshots consistent.
+                emitRevision += 1;
+                snapshotRevision += 1;
                 break;
             case "mouse":
                 // Mouse events can be sent as escape sequences if terminal supports it
@@ -968,7 +990,7 @@ export async function createTerminal(options) {
                     // (live restore) can replay it without a separate state fetch.
                     listener({
                         type: "snapshotReady",
-                        revision: stateRevision,
+                        revision: snapshotRevision,
                         replayPreamble: getReplayPreamble(),
                     });
                 }
@@ -1137,6 +1159,7 @@ export async function createTerminal(options) {
         getSize,
         getState,
         getStateSnapshot,
+        drainHeadlessXterm,
         getReplayPreamble,
         getTitle,
         getActivity,

package/node_modules/@bytetrue/byspace-server/dist/server/terminal/worker-terminal-manager.js

@@ -249,6 +249,9 @@ export function createWorkerTerminalManager(managerOptions = {}) {
                     revision: 0,
                 };
             },
+            drainHeadlessXterm() {
+                return Promise.resolve();
+            },
             getReplayPreamble() {
                 // Refreshed from every getTerminalState response, which the controller fetches
                 // before every snapshot replay (legacy + visible-snapshot restore). The one