@cotal-ai/manager 0.9.0 → 0.10.0

package/dist/attach-client.js

@@ -1,172 +0,0 @@
-import WebSocket from "ws";
-/** Detach key — Ctrl-] (0x1d), as in telnet/ssh escape conventions. */
-const DETACH = 0x1d;
-/**
- * Terminal modes a full-screen child (e.g. Claude's TUI) commonly turns on but that we must undo
- * locally on detach/exit: the agent keeps running after Ctrl-], so it never restores OUR terminal.
- * Without this, detaching from a mouse-tracking TUI leaves the terminal reporting every cursor move
- * as input (a stream of `ESC[<…M` escape codes), or its focus in/out as `ESC[I`/`ESC[O`. Disables
- * all mouse-report modes + focus reporting + bracketed paste, resets the keypad/cursor-key modes,
- * shows the cursor, and resets attributes. Deliberately does NOT toggle the alternate screen.
- */
-const MOUSE_OFF = "\x1b[?1000l\x1b[?1002l\x1b[?1003l\x1b[?1005l\x1b[?1006l\x1b[?1015l"; // all mouse tracking off
-const RESTORE = MOUSE_OFF +
-    "\x1b[?1004l" + // focus reporting off
-    "\x1b[?2004l" + // bracketed paste off
-    "\x1b[?1l" + // application cursor keys off (DECCKM): a full-screen TUI enables it; left on, arrows emit ESC O A not ESC [ A
-    "\x1b>" + // keypad → numeric (DECKPNM)
-    "\x1b[?25h" + // show cursor
-    "\x1b[0m"; // reset attributes
-// Wheel-scroll for full-screen children. A full-screen TUI (e.g. OpenCode) runs in the alternate
-// screen — where the terminal's native scrollback is dead — and scrolls its content itself off mouse
-// reports. But it enables that mouse capture on ITS pty, and the enable doesn't reliably survive the
-// attach hop (backlog eviction / nested pty), so our terminal never reports the wheel and scrolling
-// dies. So while the child is in the alternate screen we enable SGR mouse reporting on OUR terminal
-// and translate each wheel tick into PageUp/PageDown — the keystrokes every full-screen TUI treats
-// as "scroll the view" (OpenCode: `messages_page_up`/`_down`). Inline children (Claude) never enter
-// the alt-screen, so this stays off and their native terminal-scrollback wheel is untouched.
-const MOUSE_ON = "\x1b[?1002h\x1b[?1006h"; // button+drag tracking, SGR encoding
-const PAGE_UP = "\x1b[5~";
-const PAGE_DOWN = "\x1b[6~";
-// Enter/leave the alternate screen: xterm `?1049`, plus the older `?1047`/`?47`.
-const ALT_ENTER = /\x1b\[\?(?:1049|1047|47)h/g;
-const ALT_LEAVE = /\x1b\[\?(?:1049|1047|47)l/g;
-// A complete SGR mouse report: `ESC [ < btn ; col ; row (M|m)`.
-const SGR_MOUSE = /^\x1b\[<(\d+);\d+;\d+[Mm]/;
-const lastIndexOfRe = (re, s) => {
-    re.lastIndex = 0;
-    let last = -1;
-    for (let m = re.exec(s); m; m = re.exec(s))
-        last = m.index;
-    return last;
-};
-/**
- * Drive a manager's attach endpoint from the terminal: raw-mode stdin streams to
- * the PTY, PTY output streams to stdout, and SIGWINCH-style resizes are forwarded.
- * Ctrl-] detaches without killing the agent.
- */
-export function attachClient(url) {
-    return new Promise((resolve, reject) => {
-        const ws = new WebSocket(url);
-        const stdin = process.stdin;
-        const wasRaw = stdin.isRaw ?? false;
-        // A broken local pipe (terminal closed / SIGHUP) makes stdout writes async-error on a later
-        // tick; with no listener that EPIPE/EIO becomes an uncaughtException — crashing on the per-frame
-        // PTY write or the on-detach restore write. Register a no-op listener once here (not in cleanup,
-        // so it outlives the async error tick) to turn it into a handled no-op.
-        process.stdout.on("error", () => { });
-        // Wheel-scroll state (see MOUSE_ON above): whether the child is in the alternate screen, and a
-        // buffer for an SGR mouse report split across stdin reads.
-        let altScreen = false;
-        let mouseBuf = "";
-        // Carry the tail of the previous output frame so an alt-screen escape split across ws frames
-        // (e.g. `ESC[?10` then `49h`) is still detected; 16 bytes covers these private-mode sequences.
-        // Acting only on state *change* below makes re-scanning the carried bytes idempotent.
-        let scanTail = "";
-        // Track the child's alt-screen transitions in its output so we can arm/disarm wheel translation.
-        const trackAltScreen = (data) => {
-            const s = scanTail + data.toString("latin1");
-            scanTail = s.slice(-16);
-            const enter = lastIndexOfRe(ALT_ENTER, s);
-            const leave = lastIndexOfRe(ALT_LEAVE, s);
-            if (enter === -1 && leave === -1)
-                return;
-            const nowAlt = enter > leave;
-            if (nowAlt === altScreen)
-                return;
-            altScreen = nowAlt;
-            if (altScreen) {
-                if (process.stdout.isTTY)
-                    process.stdout.write(MOUSE_ON);
-            }
-            else {
-                // Leaving alt-screen mid-session: undo the mouse modes WE enabled so the terminal stops
-                // reporting the wheel/clicks and native scrollback works again — don't wait for detach.
-                mouseBuf = "";
-                if (process.stdout.isTTY)
-                    process.stdout.write(MOUSE_OFF);
-            }
-        };
-        const sendResize = () => ws.send(`r:${process.stdout.columns ?? 80},${process.stdout.rows ?? 24}`);
-        const onInput = (d) => {
-            if (d.length === 1 && d[0] === DETACH) {
-                ws.close();
-                return;
-            }
-            // Inline child: forward keystrokes raw (its wheel scrolls the local terminal, not the app).
-            if (!altScreen) {
-                ws.send(d);
-                return;
-            }
-            // Full-screen child: rewrite wheel reports to PageUp/PageDown, pass everything else through.
-            mouseBuf += d.toString("latin1");
-            let out = "";
-            for (;;) {
-                const i = mouseBuf.indexOf("\x1b[<");
-                if (i === -1) {
-                    // A report split right before `<` (`ESC[` now, `<…M` next) would slip through untranslated:
-                    // hold a trailing `ESC[` for the next read. Never hold a bare trailing `ESC` — that's the
-                    // Escape key and must forward at once (e.g. OpenCode's interrupt); the rarer `ESC`|`[<…`
-                    // split stays raw by design.
-                    const keep = mouseBuf.endsWith("\x1b[") ? 2 : 0;
-                    out += mouseBuf.slice(0, mouseBuf.length - keep);
-                    mouseBuf = mouseBuf.slice(mouseBuf.length - keep);
-                    break;
-                }
-                out += mouseBuf.slice(0, i);
-                const rest = mouseBuf.slice(i);
-                const m = SGR_MOUSE.exec(rest);
-                if (!m) {
-                    // Hold only a still-valid partial report (`ESC[<` + digits/semicolons) for the next read;
-                    // anything else can't become an SGR mouse report, so pass it straight through.
-                    if (/^\x1b\[<[\d;]*$/.test(rest))
-                        mouseBuf = rest;
-                    else {
-                        out += rest;
-                        mouseBuf = "";
-                    }
-                    break;
-                }
-                const btn = Number(m[1]);
-                if (btn & 0x40)
-                    out += btn & 1 ? PAGE_DOWN : PAGE_UP; // wheel: 64=up, 65=down
-                else
-                    out += m[0]; // other mouse (click/drag): forward raw so the TUI still gets it
-                mouseBuf = rest.slice(m[0].length);
-            }
-            if (out)
-                ws.send(Buffer.from(out, "latin1"));
-        };
-        const cleanup = () => {
-            stdin.off("data", onInput);
-            process.stdout.off("resize", sendResize);
-            // Undo terminal modes the (still-running) agent's TUI enabled — it won't restore us on detach.
-            if (process.stdout.isTTY)
-                process.stdout.write(RESTORE);
-            if (stdin.isTTY)
-                stdin.setRawMode(wasRaw);
-            stdin.pause();
-        };
-        ws.on("open", () => {
-            if (stdin.isTTY)
-                stdin.setRawMode(true);
-            stdin.resume();
-            sendResize();
-            process.stdout.on("resize", sendResize);
-            stdin.on("data", onInput);
-        });
-        ws.on("message", (data) => {
-            trackAltScreen(data);
-            process.stdout.write(data);
-        });
-        ws.on("close", () => {
-            cleanup();
-            resolve();
-        });
-        ws.on("error", (e) => {
-            cleanup();
-            reject(e);
-        });
-    });
-}
-//# sourceMappingURL=attach-client.js.map

package/dist/attach-client.js.map

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