@monotykamary/localterm-server 2.70.7 → 2.71.1

package/dist/terminal-browser-frame-relay.d.ts

@@ -0,0 +1,11 @@
+import type { SessionOutputTransport } from "./session-output-transport.js";
+import type { ManagedSession } from "./session-manager.js";
+import type { TerminalBrowserFrame } from "./terminal-browser-frame-scanner.js";
+export declare class TerminalBrowserFrameRelay {
+    private readonly transport;
+    private readonly state;
+    constructor(transport: SessionOutputTransport);
+    push(managed: ManagedSession, frame: TerminalBrowserFrame): void;
+    private pump;
+}
+//# sourceMappingURL=terminal-browser-frame-relay.d.ts.map

package/dist/terminal-browser-frame-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-browser-frame-relay.d.ts","sourceRoot":"","sources":["../src/terminal-browser-frame-relay.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAyBhF,qBAAa,yBAAyB;IAGxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IAEnE,YAA6B,SAAS,EAAE,sBAAsB,EAAI;IAElE,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAW/D;YAEa,IAAI;CAcnB"}

package/dist/terminal-browser-frame-relay.js

@@ -0,0 +1,58 @@
+import fs from "node:fs/promises";
+import { MAX_TERMINAL_BROWSER_FRAME_BYTES } from "./constants.js";
+async function readFrameFile(frame) {
+    const expected = frame.width * frame.height * 4;
+    if (expected <= 0 || expected > MAX_TERMINAL_BROWSER_FRAME_BYTES)
+        return null;
+    try {
+        const stat = await fs.stat(frame.path);
+        if (stat.size !== expected)
+            return null;
+        const data = await fs.readFile(frame.path);
+        if (data.length !== expected)
+            return null;
+        return new Uint8Array(data);
+    }
+    catch {
+        return null;
+    }
+}
+// latest-wins relay: terminal-browser renders at display cadence while a single
+// frame read + broadcast is async, so frames must not queue (that would pile up
+// megabytes of RGBA). The newest frame on the wire replaces any previous one
+// still pending, bounding memory and keeping the client as fresh as possible.
+export class TerminalBrowserFrameRelay {
+    transport;
+    state = new WeakMap();
+    constructor(transport) {
+        this.transport = transport;
+    }
+    push(managed, frame) {
+        let state = this.state.get(managed);
+        if (!state) {
+            state = { pending: null, active: false };
+            this.state.set(managed, state);
+        }
+        state.pending = frame;
+        if (!state.active) {
+            state.active = true;
+            void this.pump(managed, state);
+        }
+    }
+    async pump(managed, state) {
+        try {
+            while (state.pending) {
+                const frame = state.pending;
+                state.pending = null;
+                const pixels = await readFrameFile(frame);
+                if (pixels) {
+                    this.transport.broadcastTerminalBrowserFrame(managed, frame.width, frame.height, pixels);
+                }
+            }
+        }
+        finally {
+            state.active = false;
+        }
+    }
+}
+//# sourceMappingURL=terminal-browser-frame-relay.js.map

package/dist/terminal-browser-frame-relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-browser-frame-relay.js","sourceRoot":"","sources":["../src/terminal-browser-frame-relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AAUlE,KAAK,UAAU,aAAa,CAAC,KAA2B;IACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAChD,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,gCAAgC;QAAE,OAAO,IAAI,CAAC;IAC9E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1C,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAM,OAAO,yBAAyB;IAGP,SAAS;IAFrB,KAAK,GAAG,IAAI,OAAO,EAA8B,CAAC;IAEnE,YAA6B,SAAiC;yBAAjC,SAAS;IAA2B,CAAC;IAElE,IAAI,CAAC,OAAuB,EAAE,KAA2B;QACvD,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;YACpB,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,OAAuB,EAAE,KAAiB;QAC3D,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC;gBAC5B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;gBACrB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC1C,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC,SAAS,CAAC,6BAA6B,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC3F,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;CACF"}

package/dist/terminal-browser-frame-scanner.d.ts

@@ -0,0 +1,21 @@
+export interface TerminalBrowserFrame {
+    width: number;
+    height: number;
+    imageId: number;
+    path: string;
+}
+export declare const TERMINAL_BROWSER_FRAME_PATH_REGEX: RegExp;
+export declare function isTerminalBrowserFramePath(name: string, tmpdir: string): boolean;
+export declare function parseTerminalBrowserTransmit(body: string): {
+    width: number;
+    height: number;
+    imageId: number;
+    name: string;
+} | null;
+export declare class TerminalBrowserFrameScanner {
+    private readonly isAllowedPath;
+    private partial;
+    constructor(isAllowedPath: (name: string) => boolean);
+    push(chunk: string): TerminalBrowserFrame[];
+}
+//# sourceMappingURL=terminal-browser-frame-scanner.d.ts.map

package/dist/terminal-browser-frame-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-browser-frame-scanner.d.ts","sourceRoot":"","sources":["../src/terminal-browser-frame-scanner.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,eAAO,MAAM,iCAAiC,QAAyC,CAAC;AAExF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAKhF;AAID,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoBzE;AAMD,qBAAa,2BAA2B;IAG1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAF1C,OAAO,CAAC,OAAO,CAAM;IAErB,YAA6B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EAAI;IAEzE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,EAAE,CA+B1C;CACF"}

package/dist/terminal-browser-frame-scanner.js

@@ -0,0 +1,90 @@
+import path from "node:path";
+import { MAX_TERMINAL_BROWSER_FRAME_STREAM_BYTES } from "./constants.js";
+// kitty "file" medium: the app transmits a base64 filesystem path by name and
+// the terminal reads the pixels itself. terminal-browser writes
+// <tmp>/terminal-browser-<pid>-<terminal-id>-<slot>.rgba for this.
+const ESC = "\x1b";
+const ESCAPE_START = ESC + "_";
+const ESCAPE_END = ESC + "\\";
+export const TERMINAL_BROWSER_FRAME_PATH_REGEX = /^terminal-browser-\d+-\d+-\d+\.rgba$/;
+export function isTerminalBrowserFramePath(name, tmpdir) {
+    const resolved = path.resolve(name);
+    const root = path.resolve(tmpdir) + path.sep;
+    if (!resolved.startsWith(root))
+        return false;
+    return TERMINAL_BROWSER_FRAME_PATH_REGEX.test(path.basename(resolved));
+}
+// Parses the body of a \x1b_G…\x1b\\ APC chunk into name-transmit metadata, or
+// null when it isn't a kitty file-medium transmit. Exported for direct testing.
+export function parseTerminalBrowserTransmit(body) {
+    const semi = body.indexOf(";");
+    if (semi === -1)
+        return null;
+    const control = body.slice(0, semi);
+    const payload = body.slice(semi + 1);
+    const fields = {};
+    for (const part of control.split(",")) {
+        const eq = part.indexOf("=");
+        if (eq === -1)
+            continue;
+        fields[part.slice(0, eq)] = part.slice(eq + 1);
+    }
+    if ((fields.a !== "T" && fields.a !== "t") || fields.t !== "f")
+        return null;
+    const width = Number(fields.s);
+    const height = Number(fields.v);
+    const imageId = Number(fields.i);
+    if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) {
+        return null;
+    }
+    if (!Number.isInteger(imageId) || imageId < 0)
+        return null;
+    return { width, height, imageId, name: Buffer.from(payload, "base64").toString("utf8") };
+}
+// Incremental scanner: PTY output arrives as many small data events, so a single
+// \x1b_G…\x1b\\ APC can span several. Holds the incomplete tail until the
+// terminator lands, then emits any complete frames. Non-frame APCs (inline
+// transmits, sixel, other kitty actions) pass through untouched and are ignored.
+export class TerminalBrowserFrameScanner {
+    isAllowedPath;
+    partial = "";
+    constructor(isAllowedPath) {
+        this.isAllowedPath = isAllowedPath;
+    }
+    push(chunk) {
+        const buffer = this.partial + chunk;
+        this.partial = "";
+        const frames = [];
+        let from = 0;
+        while (from < buffer.length) {
+            const start = buffer.indexOf(ESCAPE_START, from);
+            if (start === -1)
+                break;
+            const end = buffer.indexOf(ESCAPE_END, start + ESCAPE_START.length);
+            if (end === -1) {
+                const tail = buffer.slice(start);
+                if (tail.length <= MAX_TERMINAL_BROWSER_FRAME_STREAM_BYTES)
+                    this.partial = tail;
+                break;
+            }
+            // An APC carries a single final byte after ESC _ ; the kitty graphics
+            // protocol uses 'G', so the body here reads "Ga=…". Strip it so the
+            // control data parses cleanly.
+            let body = buffer.slice(start + ESCAPE_START.length, end);
+            if (body.charCodeAt(0) === 0x47)
+                body = body.slice(1);
+            const parsed = parseTerminalBrowserTransmit(body);
+            if (parsed && this.isAllowedPath(parsed.name)) {
+                frames.push({
+                    width: parsed.width,
+                    height: parsed.height,
+                    imageId: parsed.imageId,
+                    path: parsed.name,
+                });
+            }
+            from = end + ESCAPE_END.length;
+        }
+        return frames;
+    }
+}
+//# sourceMappingURL=terminal-browser-frame-scanner.js.map

package/dist/terminal-browser-frame-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-browser-frame-scanner.js","sourceRoot":"","sources":["../src/terminal-browser-frame-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,uCAAuC,EAAE,MAAM,gBAAgB,CAAC;AASzE,8EAA8E;AAC9E,gEAAgE;AAChE,mEAAmE;AACnE,MAAM,GAAG,GAAG,MAAM,CAAC;AACnB,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,CAAC;AAC/B,MAAM,UAAU,GAAG,GAAG,GAAG,IAAI,CAAC;AAC9B,MAAM,CAAC,MAAM,iCAAiC,GAAG,sCAAsC,CAAC;AAExF,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,MAAc;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IAC7C,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,+EAA+E;AAC/E,gFAAgF;AAChF,MAAM,UAAU,4BAA4B,CAC1C,IAAY;IAEZ,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,SAAS;QACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACvF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,iFAAiF;AACjF,0EAA0E;AAC1E,2EAA2E;AAC3E,iFAAiF;AACjF,MAAM,OAAO,2BAA2B;IAGT,aAAa;IAFlC,OAAO,GAAG,EAAE,CAAC;IAErB,YAA6B,aAAwC;6BAAxC,aAAa;IAA8B,CAAC;IAEzE,IAAI,CAAC,KAAa;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YACjD,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,MAAM;YACxB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YACpE,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACjC,IAAI,IAAI,CAAC,MAAM,IAAI,uCAAuC;oBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBAChF,MAAM;YACR,CAAC;YACD,sEAAsE;YACtE,oEAAoE;YACpE,+BAA+B;YAC/B,IAAI,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC1D,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI;gBAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,GAAG,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC;QACjC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monotykamary/localterm-server",
-  "version": "2.70.7",
+  "version": "2.71.1",
   "description": "PTY-backed HTTP/WebSocket server that powers localterm, built on Hono + node-pty.",
   "keywords": [
     "hono",