@thenewlabs/entangle-serve 2.2.1 → 2.4.0

package/dist/shared-workspace.d.ts

@@ -0,0 +1,128 @@
+import { OutputHandler } from '@thenewlabs/entangle-utils';
+import type { WindowStateBody } from '@thenewlabs/entangle-protocol';
+/**
+ * A client's viewport onto the shared workspace.
+ *
+ * Each client keeps ONE pty stream (the sid from STREAM_OPEN); the workspace
+ * multiplexes the ACTIVE window's output onto it via {@link onData}, repaints it
+ * on a window switch (also via {@link onData}: a clear + the new window's
+ * replay), and pushes the current {@link WindowStateBody} to it via
+ * {@link onWindowState} on every change. `onExit` fires only when the workspace
+ * as a whole ends (its last window exits) — closing a non-last window just
+ * repaints, it does not end the viewport.
+ */
+export interface Viewport {
+    sid: string;
+    onData: (chunk: Uint8Array) => void;
+    onExit: (code: number | null, signal: string | null) => void;
+    onWindowState: (state: WindowStateBody) => void;
+}
+/**
+ * A shared, tmux-style workspace of windows synced across every attached client.
+ *
+ * The workspace holds N windows, each its own {@link SharedSession} PTY; every
+ * window keeps running in the background but only the ONE global active window's
+ * output is streamed to clients' viewports and to the host terminal. Client
+ * keystrokes go to the active window; the host terminal size is authoritative
+ * and every window is sized to it.
+ *
+ * The host terminal binds to a workspace exactly as it used to bind to a single
+ * SharedSession — {@link onHostData}, {@link onViewersChange}, {@link onExit},
+ * {@link resize}, {@link write}, {@link getReplay}, {@link viewerCount} — so a
+ * single-window workspace behaves identically to the old shared terminal.
+ */
+export declare class SharedWorkspace {
+    private output;
+    private windows;
+    private activeIndex;
+    private viewports;
+    private exited;
+    private readonly cwd?;
+    private readonly maxReplayBytes?;
+    private readonly maxWindows;
+    private hostDataCb?;
+    private exitCb?;
+    private viewersChangedCb?;
+    private hostWindowStateCb?;
+    cols: number;
+    rows: number;
+    constructor(output: OutputHandler, opts: {
+        cols: number;
+        rows: number;
+        cwd?: string;
+        maxReplayBytes?: number;
+        maxWindows?: number;
+    });
+    /** Register the host's local rendering callback for the active window. */
+    onHostData(cb: (chunk: Buffer) => void): void;
+    /** Register a callback fired once when the workspace ends (last window exits). */
+    onExit(cb: (code: number | null, signal: string | null) => void): void;
+    /** Register a callback fired whenever the attached-viewport count changes. */
+    onViewersChange(cb: (count: number) => void): void;
+    /**
+     * Register a host callback fired whenever the window set changes — create,
+     * close, switch, or rename. Lets the host render its own tab bar in-process
+     * (the analogue of the {@link Viewport.onWindowState} push sent to clients).
+     * Fires with the current {@link windowState}.
+     */
+    onWindowState(cb: (state: WindowStateBody) => void): void;
+    get hasExited(): boolean;
+    /** Merge input (from the host) into the ACTIVE window. */
+    write(data: Uint8Array | string): void;
+    /** Resize the workspace (host is authoritative) — every window is sized to it. */
+    resize(cols: number, rows: number): void;
+    /** Recent-output snapshot of the ACTIVE window (host's initial paint). */
+    getReplay(): Uint8Array;
+    /** Number of attached client viewports. */
+    viewerCount(): number;
+    /** Kill every window (which drives the workspace to exit). */
+    kill(): void;
+    /**
+     * Attach a client viewport. Returns the current active-window replay so the
+     * caller can send it as the viewport's initial output. The caller should then
+     * send the current {@link windowState} so the client's tab bar populates.
+     */
+    attachViewport(v: Viewport): {
+        replay: Uint8Array;
+    };
+    /** Detach a client viewport (disconnect / stream close). */
+    detachViewport(sid: string): void;
+    /** Route a viewport's keystrokes to the ACTIVE window. */
+    writeFromViewport(sid: string, data: Uint8Array | string): void;
+    /** Create a new window and switch to it. */
+    newWindow(): void;
+    /** Switch the global active window to `index` (no-op if out of range/current). */
+    selectWindow(index: number): void;
+    /** Switch to the next window (wraps). */
+    nextWindow(): void;
+    /** Switch to the previous window (wraps). */
+    prevWindow(): void;
+    /**
+     * Close the window at `index`. Killing its PTY drives the shared exit path,
+     * which removes the window, re-homes the active index, and broadcasts. Closing
+     * the last window ends the whole workspace.
+     */
+    closeWindow(index: number): void;
+    /** Rename the window at `index` and broadcast the change. */
+    renameWindow(index: number, title: string): void;
+    /** Current window state (the `msg` body of a window-state frame). */
+    windowState(): WindowStateBody;
+    private spawnWindow;
+    /**
+     * Tap the active window's output and fan it out to the host + every viewport.
+     * Only the active window is tapped; background windows keep running silently.
+     */
+    private bindActiveOutput;
+    /**
+     * Switch the active window: detach the old window's output tap, tap the new
+     * one, and repaint the host + every viewport (clear + new window's replay).
+     * Does NOT broadcast window-state — callers pair this with broadcastWindowState.
+     */
+    private setActive;
+    /** Repaint the host + every viewport with a clear + the active window's replay. */
+    private repaintAll;
+    /** Notify the host + every attached client of the current window-state. */
+    broadcastWindowState(): void;
+    private handleWindowExit;
+}
+//# sourceMappingURL=shared-workspace.d.ts.map

package/dist/shared-workspace.d.ts.map

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

package/dist/shared-workspace.js

@@ -0,0 +1,295 @@
+import { SharedSession } from './shared-session.js';
+/** Screen clear + home used to repaint a viewport/host on a window switch. */
+const CLEAR = Buffer.from('\x1b[2J\x1b[3J\x1b[H', 'utf8');
+/** Hard cap on concurrent windows so a client can't spawn unbounded shells. */
+const DEFAULT_MAX_WINDOWS = 16;
+/**
+ * A shared, tmux-style workspace of windows synced across every attached client.
+ *
+ * The workspace holds N windows, each its own {@link SharedSession} PTY; every
+ * window keeps running in the background but only the ONE global active window's
+ * output is streamed to clients' viewports and to the host terminal. Client
+ * keystrokes go to the active window; the host terminal size is authoritative
+ * and every window is sized to it.
+ *
+ * The host terminal binds to a workspace exactly as it used to bind to a single
+ * SharedSession — {@link onHostData}, {@link onViewersChange}, {@link onExit},
+ * {@link resize}, {@link write}, {@link getReplay}, {@link viewerCount} — so a
+ * single-window workspace behaves identically to the old shared terminal.
+ */
+export class SharedWorkspace {
+    output;
+    windows = [];
+    activeIndex = 0;
+    viewports = new Map();
+    exited = false;
+    cwd;
+    maxReplayBytes;
+    maxWindows;
+    hostDataCb;
+    exitCb;
+    viewersChangedCb;
+    hostWindowStateCb;
+    cols;
+    rows;
+    constructor(output, opts) {
+        this.output = output;
+        this.cols = Math.max(1, opts.cols);
+        this.rows = Math.max(1, opts.rows);
+        if (opts.cwd !== undefined)
+            this.cwd = opts.cwd;
+        if (opts.maxReplayBytes !== undefined)
+            this.maxReplayBytes = opts.maxReplayBytes;
+        this.maxWindows = opts.maxWindows ?? DEFAULT_MAX_WINDOWS;
+        // Start with a single window so the existing single-shell behavior is
+        // preserved when nobody ever creates a second one.
+        const first = this.spawnWindow();
+        this.windows.push(first);
+        this.activeIndex = 0;
+        this.bindActiveOutput();
+        this.output.info(`Shared workspace started: 1 window, cols=${this.cols}, rows=${this.rows}`);
+    }
+    // --- host-facing API (mirrors the old SharedSession surface) -------------
+    /** Register the host's local rendering callback for the active window. */
+    onHostData(cb) { this.hostDataCb = cb; }
+    /** Register a callback fired once when the workspace ends (last window exits). */
+    onExit(cb) { this.exitCb = cb; }
+    /** Register a callback fired whenever the attached-viewport count changes. */
+    onViewersChange(cb) { this.viewersChangedCb = cb; }
+    /**
+     * Register a host callback fired whenever the window set changes — create,
+     * close, switch, or rename. Lets the host render its own tab bar in-process
+     * (the analogue of the {@link Viewport.onWindowState} push sent to clients).
+     * Fires with the current {@link windowState}.
+     */
+    onWindowState(cb) { this.hostWindowStateCb = cb; }
+    get hasExited() { return this.exited; }
+    /** Merge input (from the host) into the ACTIVE window. */
+    write(data) {
+        if (this.exited)
+            return;
+        this.windows[this.activeIndex]?.write(data);
+    }
+    /** Resize the workspace (host is authoritative) — every window is sized to it. */
+    resize(cols, rows) {
+        if (this.exited || cols < 1 || rows < 1)
+            return;
+        this.cols = cols;
+        this.rows = rows;
+        for (const w of this.windows)
+            w.resize(cols, rows);
+    }
+    /** Recent-output snapshot of the ACTIVE window (host's initial paint). */
+    getReplay() {
+        return this.windows[this.activeIndex]?.getReplay() ?? new Uint8Array(0);
+    }
+    /** Number of attached client viewports. */
+    viewerCount() { return this.viewports.size; }
+    /** Kill every window (which drives the workspace to exit). */
+    kill() {
+        for (const w of this.windows) {
+            try {
+                w.kill();
+            }
+            catch { }
+        }
+    }
+    // --- viewport-facing API (clients) ---------------------------------------
+    /**
+     * Attach a client viewport. Returns the current active-window replay so the
+     * caller can send it as the viewport's initial output. The caller should then
+     * send the current {@link windowState} so the client's tab bar populates.
+     */
+    attachViewport(v) {
+        this.viewports.set(v.sid, v);
+        this.output.info(`Viewport attached: ${v.sid} (${this.viewports.size} total)`);
+        this.viewersChangedCb?.(this.viewports.size);
+        return { replay: this.getReplay() };
+    }
+    /** Detach a client viewport (disconnect / stream close). */
+    detachViewport(sid) {
+        if (this.viewports.delete(sid)) {
+            this.output.info(`Viewport detached: ${sid} (${this.viewports.size} remaining)`);
+            this.viewersChangedCb?.(this.viewports.size);
+        }
+    }
+    /** Route a viewport's keystrokes to the ACTIVE window. */
+    writeFromViewport(sid, data) {
+        if (this.exited || !this.viewports.has(sid))
+            return;
+        this.windows[this.activeIndex]?.write(data);
+    }
+    // --- window operations (WINDOW_CTL client->server) -----------------------
+    /** Create a new window and switch to it. */
+    newWindow() {
+        if (this.exited)
+            return;
+        if (this.windows.length >= this.maxWindows) {
+            this.output.warn(`Window cap reached (${this.maxWindows}); ignoring new-window`);
+            return;
+        }
+        const win = this.spawnWindow();
+        this.windows.push(win);
+        this.setActive(this.windows.length - 1);
+        this.broadcastWindowState();
+    }
+    /** Switch the global active window to `index` (no-op if out of range/current). */
+    selectWindow(index) {
+        if (this.exited)
+            return;
+        if (index < 0 || index >= this.windows.length || index === this.activeIndex)
+            return;
+        this.setActive(index);
+        this.broadcastWindowState();
+    }
+    /** Switch to the next window (wraps). */
+    nextWindow() {
+        if (this.windows.length < 2)
+            return;
+        this.selectWindow((this.activeIndex + 1) % this.windows.length);
+    }
+    /** Switch to the previous window (wraps). */
+    prevWindow() {
+        if (this.windows.length < 2)
+            return;
+        this.selectWindow((this.activeIndex - 1 + this.windows.length) % this.windows.length);
+    }
+    /**
+     * Close the window at `index`. Killing its PTY drives the shared exit path,
+     * which removes the window, re-homes the active index, and broadcasts. Closing
+     * the last window ends the whole workspace.
+     */
+    closeWindow(index) {
+        if (this.exited)
+            return;
+        if (index < 0 || index >= this.windows.length)
+            return;
+        try {
+            this.windows[index].kill();
+        }
+        catch { }
+    }
+    /** Rename the window at `index` and broadcast the change. */
+    renameWindow(index, title) {
+        if (this.exited)
+            return;
+        const win = this.windows[index];
+        if (!win)
+            return;
+        win.title = title;
+        this.broadcastWindowState();
+    }
+    /** Current window state (the `msg` body of a window-state frame). */
+    windowState() {
+        const windows = this.windows.map((w) => ({ id: w.id, title: w.title }));
+        return { v: 1, kind: 'window-state', windows, activeIndex: this.activeIndex };
+    }
+    // --- internals -----------------------------------------------------------
+    spawnWindow() {
+        const win = new SharedSession(this.output, {
+            cols: this.cols,
+            rows: this.rows,
+            ...(this.cwd !== undefined ? { cwd: this.cwd } : {}),
+            ...(this.maxReplayBytes !== undefined ? { maxReplayBytes: this.maxReplayBytes } : {}),
+        });
+        win.onExit((code, signal) => this.handleWindowExit(win, code, signal));
+        return win;
+    }
+    /**
+     * Tap the active window's output and fan it out to the host + every viewport.
+     * Only the active window is tapped; background windows keep running silently.
+     */
+    bindActiveOutput() {
+        const active = this.windows[this.activeIndex];
+        if (!active)
+            return;
+        active.onHostData((chunk) => {
+            this.hostDataCb?.(chunk);
+            if (this.viewports.size === 0)
+                return;
+            const bytes = new Uint8Array(chunk);
+            for (const v of this.viewports.values()) {
+                try {
+                    v.onData(bytes);
+                }
+                catch { }
+            }
+        });
+    }
+    /**
+     * Switch the active window: detach the old window's output tap, tap the new
+     * one, and repaint the host + every viewport (clear + new window's replay).
+     * Does NOT broadcast window-state — callers pair this with broadcastWindowState.
+     */
+    setActive(index) {
+        const prev = this.windows[this.activeIndex];
+        if (prev)
+            prev.onHostData(() => { }); // stop tapping the now-background window
+        this.activeIndex = index;
+        this.bindActiveOutput();
+        this.repaintAll();
+    }
+    /** Repaint the host + every viewport with a clear + the active window's replay. */
+    repaintAll() {
+        const active = this.windows[this.activeIndex];
+        if (!active)
+            return;
+        const payload = Buffer.concat([CLEAR, Buffer.from(active.getReplay())]);
+        this.hostDataCb?.(payload);
+        if (this.viewports.size > 0) {
+            const bytes = new Uint8Array(payload);
+            for (const v of this.viewports.values()) {
+                try {
+                    v.onData(bytes);
+                }
+                catch { }
+            }
+        }
+    }
+    /** Notify the host + every attached client of the current window-state. */
+    broadcastWindowState() {
+        const state = this.windowState();
+        this.hostWindowStateCb?.(state);
+        if (this.viewports.size === 0)
+            return;
+        for (const v of this.viewports.values()) {
+            try {
+                v.onWindowState(state);
+            }
+            catch { }
+        }
+    }
+    handleWindowExit(win, code, signal) {
+        const idx = this.windows.indexOf(win);
+        if (idx === -1)
+            return;
+        const wasActive = idx === this.activeIndex;
+        this.windows.splice(idx, 1);
+        // Last window gone: the whole workspace ends. Tell every viewport and the
+        // host so the client streams and host process wind down.
+        if (this.windows.length === 0) {
+            this.exited = true;
+            for (const v of this.viewports.values()) {
+                try {
+                    v.onExit(code, signal);
+                }
+                catch { }
+            }
+            this.viewports.clear();
+            this.exitCb?.(code, signal);
+            return;
+        }
+        if (wasActive) {
+            // Re-home the active index onto a surviving neighbor and repaint everyone.
+            this.activeIndex = Math.min(idx, this.windows.length - 1);
+            this.bindActiveOutput();
+            this.repaintAll();
+        }
+        else if (idx < this.activeIndex) {
+            // A window before the active one vanished; keep pointing at the same window.
+            this.activeIndex -= 1;
+        }
+        this.broadcastWindowState();
+    }
+}
+//# sourceMappingURL=shared-workspace.js.map

package/dist/shared-workspace.js.map

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

package/dist/vt-grid.d.ts

@@ -0,0 +1,41 @@
+export declare class VtGrid {
+    cols: number;
+    rows: number;
+    cursorX: number;
+    cursorY: number;
+    private grid;
+    private sgr;
+    private savedX;
+    private savedY;
+    private pending;
+    constructor(cols: number, rows: number);
+    private blankGrid;
+    /** Resize, preserving as much top-left content as fits. */
+    resize(cols: number, rows: number): void;
+    write(data: string): void;
+    private handleEscape;
+    private handleCsi;
+    private applySgr;
+    private handleControlOrPrintable;
+    private lineFeed;
+    private reverseLineFeed;
+    private scrollUp;
+    private scrollDown;
+    private insertLines;
+    private deleteLines;
+    private deleteChars;
+    private insertBlanks;
+    private eraseDisplay;
+    private eraseLine;
+    private clampX;
+    private clampY;
+    /**
+     * Render each row as a styled string exactly `cols` wide, with SGR runs
+     * reconstructed and a reset at both ends so a row never bleeds style into the
+     * box frame.
+     */
+    renderRows(): string[];
+    /** Plain-text rows (no SGR) — handy for assertions/tests. */
+    renderPlainRows(): string[];
+}
+//# sourceMappingURL=vt-grid.d.ts.map

package/dist/vt-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vt-grid.d.ts","sourceRoot":"","sources":["../src/vt-grid.ts"],"names":[],"mappings":"AAmBA,qBAAa,MAAM;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,SAAK;IACZ,OAAO,SAAK;IACZ,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAM;gBAET,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAMtC,OAAO,CAAC,SAAS;IAMjB,2DAA2D;IAC3D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAgBxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAqBzB,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,SAAS;IAiCjB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IAEd;;;;OAIG;IACH,UAAU,IAAI,MAAM,EAAE;IAgBtB,6DAA6D;IAC7D,eAAe,IAAI,MAAM,EAAE;CAG5B"}