@volter/supercode-terminal 0.2.43 → 0.2.45

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-terminal",
-  "version": "0.2.43",
+  "version": "0.2.45",
   "type": "module",
   "description": "Optional leak-safe terminal and tmux host adapter for Volter Harness frontends",
   "exports": {

package/substrate/tmux.js

@@ -344,12 +344,15 @@ function sessionServerOptionArgs() {
     return [
         "set-option", "-g", "history-limit", "50000", ";",
         "set-option", "-g", "mouse", "on", ";",
-        // The relay clients (tmux-stream attaches as screen-256color; a person's own
-        // terminal attaches as something else) draw into the viewer's normal screen,
-        // so lines that scroll off land in the viewer's own scrollback, and they
-        // pass clipboard, focus and extended keys through. Indexed, so re-applying
-        // on every create replaces one entry instead of appending.
-        "set-option", "-s", "terminal-overrides[90]", "screen-256color:smcup@:rmcup@", ";",
+        // Every client draws into the viewer's normal screen, so lines that scroll
+        // off land in the viewer's own scrollback and the wheel scrolls it; on the
+        // alternate screen a terminal turns the wheel into up/down arrows. That is
+        // every client, not only the relay's screen-256color: a person's own
+        // terminal, or a window a daemon opened, attaches as whatever TERM it sets.
+        // The relay clients also pass clipboard, focus and extended keys through.
+        // Indexed, so re-applying on every create replaces one entry instead of
+        // appending.
+        "set-option", "-s", "terminal-overrides[90]", "*:smcup@:rmcup@", ";",
         "set-option", "-s", "terminal-features[90]", "screen-256color:clipboard:focus:extkeys:title", ";",
         // Harness TUIs (Claude Code) track focus; tmux forwards focus in/out only with this on.
         "set-option", "-s", "focus-events", "on", ";",
@@ -849,29 +852,32 @@ function terminalInputRunOptions(deadlineMs) {
         throw new Error("Terminal input expired before delivery.");
     return { timeoutMs };
 }
+// The escape sequences a keystream carries for named keys, as tmux names them.
+const ESCAPE_SEQUENCE_KEYS = [
+    ["\u001b[A", "Up"],
+    ["\u001b[B", "Down"],
+    ["\u001b[C", "Right"],
+    ["\u001b[D", "Left"],
+    ["\u001b[H", "Home"],
+    ["\u001b[F", "End"],
+    ["\u001b[Z", "BTab"],
+    ["\u001b[3~", "DC"],
+    ["\u001b[5~", "PPage"],
+    ["\u001b[6~", "NPage"],
+];
 function tokenizeTerminalInput(data) {
     const tokens = [];
     for (let i = 0; i < data.length; i += 1) {
         const char = data[i];
-        const next3 = data.slice(i, i + 3);
-        if (next3 === "\u001b[A") {
-            tokens.push({ key: "Up" });
-            i += 2;
-            continue;
-        }
-        if (next3 === "\u001b[B") {
-            tokens.push({ key: "Down" });
-            i += 2;
-            continue;
-        }
-        if (next3 === "\u001b[C") {
-            tokens.push({ key: "Right" });
-            i += 2;
+        const sequence = ESCAPE_SEQUENCE_KEYS.find(([bytes]) => data.startsWith(bytes, i));
+        if (sequence) {
+            tokens.push({ key: sequence[1] });
+            i += sequence[0].length - 1;
             continue;
         }
-        if (next3 === "\u001b[D") {
-            tokens.push({ key: "Left" });
-            i += 2;
+        // A lone ESC (no sequence after it) is the Escape key.
+        if (char === "\u001b") {
+            tokens.push({ key: "Escape" });
             continue;
         }
         if (char === "\r" || char === "\n") {