@thenewlabs/entangle-serve 2.12.2 → 2.14.0

package/dist/daemon-client.d.ts

@@ -0,0 +1,30 @@
+import * as net from 'net';
+import type { OutputHandler } from '@thenewlabs/entangle-utils';
+/** Connect to a unix socket, rejecting on connection error. */
+export declare function connectSocket(path: string): Promise<net.Socket>;
+/**
+ * Poll a socket path until it accepts a connection, resolving the connected
+ * socket. Rejects with a pointer to `logFile` if it never comes up in time. The
+ * socket is left flowing-paused (no 'data' listener) so no daemon frames are
+ * lost before the RemoteHostSession attaches its reader.
+ */
+export declare function pollSocket(path: string, logFile: string): Promise<net.Socket>;
+/**
+ * Spawn a detached daemon process whose stdout/stderr append to `logFile` and
+ * whose config rides entirely in `env`. Returns immediately (the child is
+ * unref'd); pair with {@link pollSocket} to wait for its socket.
+ */
+export declare function spawnDetached(opts: {
+    entry: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+    logFile: string;
+}): void;
+/**
+ * Attach this terminal to a daemon over its (already connected) socket: wrap it
+ * in a RemoteHostSession sized to the current terminal and hand it to the host
+ * UI. host-terminal keeps the process alive and calls process.exit on the
+ * session's exit/detach path.
+ */
+export declare function attachToSocket(socket: net.Socket, output: OutputHandler): void;
+//# sourceMappingURL=daemon-client.d.ts.map

package/dist/daemon-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-client.d.ts","sourceRoot":"","sources":["../src/daemon-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAG3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAoBhE,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAO/D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAcnF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CASP;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAM9E"}

package/dist/daemon-client.js

@@ -0,0 +1,76 @@
+import * as net from 'net';
+import * as fs from 'fs';
+import { spawn } from 'child_process';
+import { attachHostTerminal } from './host-terminal.js';
+import { RemoteHostSession } from './remote-host-session.js';
+/**
+ * The CLIENT half of the tmux-style detach/reattach split: helpers for spawning
+ * a detached session daemon and attaching the current terminal to its unix
+ * socket. Extracted from the serve CLI wiring so embedders (Locus's CLI) can
+ * compose the same spawn/poll/attach flow around their own daemon entry.
+ */
+/** How long to wait for a freshly spawned daemon's socket to become connectable. */
+const SOCKET_POLL_INTERVAL_MS = 100;
+const SOCKET_POLL_TIMEOUT_MS = 8000;
+/** Resolve after `ms`. */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Connect to a unix socket, rejecting on connection error. */
+export function connectSocket(path) {
+    return new Promise((resolve, reject) => {
+        const socket = net.connect(path);
+        const onError = (err) => reject(err);
+        socket.once('error', onError);
+        socket.once('connect', () => { socket.removeListener('error', onError); resolve(socket); });
+    });
+}
+/**
+ * Poll a socket path until it accepts a connection, resolving the connected
+ * socket. Rejects with a pointer to `logFile` if it never comes up in time. The
+ * socket is left flowing-paused (no 'data' listener) so no daemon frames are
+ * lost before the RemoteHostSession attaches its reader.
+ */
+export async function pollSocket(path, logFile) {
+    const deadline = Date.now() + SOCKET_POLL_TIMEOUT_MS;
+    for (;;) {
+        try {
+            return await connectSocket(path);
+        }
+        catch {
+            if (Date.now() >= deadline) {
+                throw new Error(`Session daemon did not come up within ${SOCKET_POLL_TIMEOUT_MS / 1000}s (socket ${path}); see log: ${logFile}`);
+            }
+            await delay(SOCKET_POLL_INTERVAL_MS);
+        }
+    }
+}
+/**
+ * Spawn a detached daemon process whose stdout/stderr append to `logFile` and
+ * whose config rides entirely in `env`. Returns immediately (the child is
+ * unref'd); pair with {@link pollSocket} to wait for its socket.
+ */
+export function spawnDetached(opts) {
+    const logFd = fs.openSync(opts.logFile, 'a');
+    const child = spawn(process.execPath, [opts.entry, ...opts.args], {
+        detached: true,
+        stdio: ['ignore', logFd, logFd],
+        env: opts.env,
+    });
+    child.unref();
+    fs.closeSync(logFd); // the child holds its own fd
+}
+/**
+ * Attach this terminal to a daemon over its (already connected) socket: wrap it
+ * in a RemoteHostSession sized to the current terminal and hand it to the host
+ * UI. host-terminal keeps the process alive and calls process.exit on the
+ * session's exit/detach path.
+ */
+export function attachToSocket(socket, output) {
+    const session = new RemoteHostSession(socket, {
+        cols: process.stdout.columns || 80,
+        rows: process.stdout.rows || 24,
+    });
+    attachHostTerminal(session, output);
+}
+//# sourceMappingURL=daemon-client.js.map

package/dist/daemon-client.js.map

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

package/dist/daemon-server.d.ts

@@ -0,0 +1,57 @@
+import type { OutputHandler } from '@thenewlabs/entangle-utils';
+import type { SharedWorkspace } from './shared-workspace.js';
+import type { LocalHostSession } from './host-session.js';
+/**
+ * The reusable socket-server half of a detachable session daemon: everything a
+ * daemon does BETWEEN owning a workspace and connecting it to a relay.
+ *
+ * Extracted from daemon.ts so embedders (Locus's `locus __daemon`) can compose
+ * the same detach/reattach machinery around their own boot sequence: it listens
+ * on a unix socket where zero or more terminal CLIENTS (RemoteHostSession)
+ * attach, fans the session's events out to every attached client, applies each
+ * client's input/resize/window ops to the one shared workspace, and keeps the
+ * session registry entry current. Detaching a client leaves the daemon (and
+ * the session) running.
+ *
+ * The caller stays responsible for constructing the SharedWorkspace +
+ * LocalHostSession, starting the relay agent, and reporting the session URL
+ * via {@link DaemonServer.setUrl} once the relay announces it.
+ */
+export interface DaemonServerOptions {
+    /** Session name — the registry key and the log/socket basename. */
+    name: string;
+    /** Absolute path of the unix socket to listen on. */
+    socketPath: string;
+    workspace: SharedWorkspace;
+    session: LocalHostSession;
+    output: OutputHandler;
+    /** What the registry entry records about this session. */
+    registry: {
+        capId: string;
+        kind: 'entangle' | 'locus';
+        workspaceRoot?: string;
+    };
+    /**
+     * Extra async teardown run during shutdown, after the workspace and clients
+     * are torn down but before the process exits (Locus: close locusd + remove
+     * its pipe sockets). Best-effort: a throw here never blocks the exit.
+     */
+    beforeExit?: () => Promise<void> | void;
+    /** Install SIGTERM/SIGINT → shutdown handlers (default true; off for tests). */
+    installSignalHandlers?: boolean;
+    /** Process exit hook (default process.exit; replaced by tests). */
+    exit?: (code: number) => void;
+}
+export interface DaemonServer {
+    /** Record the session URL: pushes it to attached clients and the registry. */
+    setUrl(url: string): void;
+    /** Tear the daemon down (idempotent): broadcast exit, deregister, exit(0). */
+    shutdown(code: number | null): void;
+}
+/**
+ * Listen on `socketPath`, register the session, and serve attach/detach
+ * clients over the IPC protocol (ipc.ts). Resolves once the socket is
+ * listening and the registry entry is written (url filled in via setUrl).
+ */
+export declare function createDaemonServer(opts: DaemonServerOptions): Promise<DaemonServer>;
+//# sourceMappingURL=daemon-server.d.ts.map

package/dist/daemon-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-server.d.ts","sourceRoot":"","sources":["../src/daemon-server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAW1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,gFAAgF;IAChF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mEAAmE;IACnE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiNzF"}

package/dist/daemon-server.js

@@ -0,0 +1,258 @@
+import * as net from 'net';
+import * as fs from 'fs';
+import { addSession, assertSocketPathUsable, logPath, removeSession } from './session-registry.js';
+import { createMessageReader, decodeChunk, encodeChunk, writeMessage, } from './ipc.js';
+/**
+ * Listen on `socketPath`, register the session, and serve attach/detach
+ * clients over the IPC protocol (ipc.ts). Resolves once the socket is
+ * listening and the registry entry is written (url filled in via setUrl).
+ */
+export async function createDaemonServer(opts) {
+    const { name, socketPath: socketPathValue, workspace, session: localSession, output } = opts;
+    // Refuse a path bind() would silently truncate — a truncated socket looks
+    // dead to every liveness check that stats the full path.
+    assertSocketPathUsable(socketPathValue);
+    const exit = opts.exit ?? ((code) => process.exit(code));
+    const createdAt = Date.now();
+    const register = (url) => {
+        const info = {
+            name,
+            socket: socketPathValue,
+            logFile: logPath(name),
+            pid: process.pid,
+            capId: opts.registry.capId,
+            url,
+            createdAt,
+            kind: opts.registry.kind,
+            ...(opts.registry.workspaceRoot ? { workspaceRoot: opts.registry.workspaceRoot } : {}),
+        };
+        addSession(info);
+    };
+    // --- client set + fan-out -------------------------------------------------
+    const clients = new Set();
+    const broadcast = (msg) => {
+        for (const socket of clients) {
+            try {
+                writeMessage(socket, msg);
+            }
+            catch { /* dropped client; its close handler cleans up */ }
+        }
+    };
+    // --- lifecycle / cleanup (idempotent) ------------------------------------
+    let server;
+    let shuttingDown = false;
+    const shutdown = (code) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        broadcast({ t: 'exit', code });
+        try {
+            localSession.dispose();
+        }
+        catch { /* best-effort */ }
+        try {
+            workspace.kill();
+        }
+        catch { /* best-effort */ }
+        for (const socket of clients) {
+            try {
+                socket.end();
+            }
+            catch { /* already gone */ }
+        }
+        clients.clear();
+        try {
+            server?.close();
+        }
+        catch { /* not listening */ }
+        removeSession(name);
+        try {
+            fs.unlinkSync(socketPathValue);
+        }
+        catch { /* already gone */ }
+        // The embedder's teardown may be async (Locus closes locusd); exit after it
+        // either way. With no beforeExit this is an immediate exit, as before.
+        void (async () => {
+            try {
+                await opts.beforeExit?.();
+            }
+            catch { /* best-effort */ }
+            exit(0);
+        })();
+    };
+    if (opts.installSignalHandlers !== false) {
+        process.on('SIGTERM', () => shutdown(0));
+        process.on('SIGINT', () => shutdown(0));
+    }
+    // Subscribe ONCE to the SESSION-GLOBAL streams and fan each out to every
+    // client. Terminal output and window-state are NOT global anymore: each client
+    // gets its own workspace viewport (see onConnection) so it can sit on its own
+    // active window, so we deliberately do NOT broadcast onHostData/onWindowState.
+    localSession.onViewersChange((n) => broadcast({ t: 'viewers', n }));
+    localSession.onLog((line) => broadcast({ t: 'log', line }));
+    localSession.onUrl((url) => broadcast({ t: 'url', url }));
+    // Workspace ended (last window's shell exited) → tear the daemon down.
+    localSession.onExit((code) => shutdown(code));
+    // --- inbound client handling ---------------------------------------------
+    // A client's messages drive ITS OWN workspace viewport (keyed by `vpId`), so
+    // input/window ops only move that client's active window. Sizing stays global
+    // (the host/workspace size is authoritative), so hello/resize resize the whole
+    // workspace as before.
+    const handleClientMessage = (msg, socket, vpId) => {
+        switch (msg.t) {
+            case 'hello':
+                workspace.resize(msg.cols, msg.rows);
+                break;
+            case 'input':
+                workspace.writeFromViewport(vpId, decodeChunk(msg.data));
+                break;
+            case 'resize':
+                workspace.resize(msg.cols, msg.rows);
+                break;
+            case 'win':
+                switch (msg.op) {
+                    case 'new':
+                        workspace.newWindowForViewport(vpId);
+                        break;
+                    case 'next':
+                        workspace.nextWindowForViewport(vpId);
+                        break;
+                    case 'prev':
+                        workspace.prevWindowForViewport(vpId);
+                        break;
+                    case 'select':
+                        if (msg.index !== undefined)
+                            workspace.selectWindowForViewport(vpId, msg.index);
+                        break;
+                    case 'close':
+                        if (msg.index !== undefined)
+                            workspace.closeWindowFromViewport(vpId, msg.index);
+                        break;
+                }
+                break;
+            case 'refresh':
+                // Serialize the viewport's active window NOW and send it back as a
+                // `replay` frame (getReplay()'s source client-side). Because this is a
+                // full IPC round-trip after the client's own bytes were fed to the
+                // emulator, the serialize reflects the window's live screen — this is
+                // what lets a host repaint (e.g. after a full-screen app quits) paint
+                // the CURRENT primary instead of the stale attach-time cache.
+                try {
+                    const frame = workspace.snapshotForViewport(vpId, msg.scrollback !== undefined ? { scrollback: msg.scrollback } : undefined);
+                    writeMessage(socket, { t: 'replay', chunk: encodeChunk(frame) });
+                }
+                catch { /* dropped client; its close handler cleans up */ }
+                break;
+            case 'scrollback':
+                // Serialize the viewport's active window buffer to plain-text lines NOW
+                // and send them back for the client's copy-mode pager.
+                try {
+                    writeMessage(socket, { t: 'scrollback', lines: workspace.scrollbackLinesForViewport(vpId) });
+                }
+                catch { /* dropped client; its close handler cleans up */ }
+                break;
+            case 'detach':
+                // Drop just this client's viewport; the daemon (and session) keep running.
+                clients.delete(socket);
+                workspace.detachViewport(vpId);
+                try {
+                    socket.end();
+                }
+                catch { /* already ending */ }
+                break;
+            case 'kill':
+                // End the whole session on a client's request (host UI Ctrl-B q): the
+                // exit broadcast inside shutdown() tells every attached client first.
+                shutdown(0);
+                break;
+        }
+    };
+    let nextVpId = 0;
+    const onConnection = (socket) => {
+        // Each connection is its own workspace viewport with an independent active
+        // window; reuse the connection counter as the viewport key.
+        const vpId = `client-${nextVpId++}`;
+        clients.add(socket);
+        const remove = () => {
+            clients.delete(socket);
+            workspace.detachViewport(vpId);
+        };
+        socket.on('close', remove);
+        socket.on('error', remove);
+        // Attach this client's viewport: the workspace multiplexes ITS active
+        // window's output onto this socket and pushes ITS own window-state.
+        const { replay } = workspace.attachViewport({
+            sid: vpId,
+            onData: (chunk) => { try {
+                writeMessage(socket, { t: 'data', chunk: encodeChunk(chunk) });
+            }
+            catch { /* dropped */ } },
+            onWindowState: (state) => { try {
+                writeMessage(socket, { t: 'window-state', state });
+            }
+            catch { /* dropped */ } },
+            onExit: (code) => { try {
+                writeMessage(socket, { t: 'exit', code });
+            }
+            catch { /* dropped */ } },
+        });
+        createMessageReader(socket, (msg) => {
+            // Only ClientToDaemon frames are expected inbound; a single bad message
+            // must not take down the daemon.
+            try {
+                handleClientMessage(msg, socket, vpId);
+            }
+            catch (err) {
+                output.warn('Client message failed', err instanceof Error ? err.message : String(err));
+            }
+        }, () => { remove(); try {
+            socket.destroy();
+        }
+        catch { /* already gone */ } });
+        // Push this viewport's current state immediately so the client's UI
+        // populates fast. Sent synchronously (no await) right after attach, so live
+        // onData frames can't slip in before the replay.
+        try {
+            const url = localSession.getUrl();
+            if (url)
+                writeMessage(socket, { t: 'url', url });
+            writeMessage(socket, { t: 'window-state', state: workspace.windowStateForViewport(vpId) });
+            writeMessage(socket, { t: 'viewers', n: workspace.viewerCount() });
+            for (const line of localSession.getLogBuffer())
+                writeMessage(socket, { t: 'log', line });
+            writeMessage(socket, { t: 'replay', chunk: encodeChunk(replay) });
+        }
+        catch {
+            remove();
+        }
+    };
+    // --- listen ---------------------------------------------------------------
+    try {
+        fs.unlinkSync(socketPathValue);
+    }
+    catch { /* no stale socket to remove */ }
+    server = net.createServer(onConnection);
+    server.on('error', (err) => output.error('Daemon socket server error', err.message));
+    await new Promise((resolve, reject) => {
+        const onError = (err) => reject(err);
+        server.once('error', onError);
+        server.listen(socketPathValue, () => {
+            server.off('error', onError);
+            resolve();
+        });
+    });
+    try {
+        fs.chmodSync(socketPathValue, 0o600);
+    }
+    catch { /* best-effort tightening */ }
+    // Register now (url filled in via setUrl once the relay assigns it).
+    register('');
+    return {
+        setUrl(url) {
+            localSession.setUrl(url);
+            register(url);
+        },
+        shutdown,
+    };
+}
+//# sourceMappingURL=daemon-server.js.map

package/dist/daemon-server.js.map

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

package/dist/daemon.d.ts

@@ -3,12 +3,12 @@
  *
  * Runs headless (no TTY): it owns a {@link SharedWorkspace} + {@link LocalHostSession}
  * and connects to the relay via {@link startAgent}, serving the pinned capability
- * handed to it. It listens on a local unix socket where zero or more terminal
- * CLIENTS ({@link RemoteHostSession}) attach; it fans the session's events out to
- * every attached client and applies each client's input/resize/window ops to the
- * one shared session. Detaching a client leaves the daemon (and the session)
- * running; the daemon exits only when the workspace's last shell exits or it is
- * signalled.
+ * handed to it. The socket server that terminal CLIENTS ({@link RemoteHostSession})
+ * attach to — fan-out, per-client viewports, registry bookkeeping, shutdown — lives
+ * in daemon-server.ts (shared with embedders like Locus); this file is just the
+ * entangle-specific composition around it. Detaching a client leaves the daemon
+ * (and the session) running; the daemon exits only when the workspace's last
+ * shell exits or it is signalled.
  *
  * Config comes entirely from the environment (set by the index wiring that spawns
  * the daemon):

package/dist/daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAiN/C"}
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAkC/C"}