@thenewlabs/entangle-serve 2.6.2 → 2.7.0

package/dist/daemon.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The DAEMON half of the tmux-style detach/reattach split for `entangle serve`.
+ *
+ * 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.
+ *
+ * Config comes entirely from the environment (set by the index wiring that spawns
+ * the daemon):
+ *
+ *   ENTANGLE_DAEMON_SESSION   session name (registry key + log/socket basename)
+ *   ENTANGLE_DAEMON_SOCKET    absolute path of the unix socket to listen on
+ *   ENTANGLE_DAEMON_SERVER    relay server URL to register with
+ *   ENTANGLE_DAEMON_CAP       JSON-encoded CapabilityInfo ({capId,S,policy}) to pin
+ *   ENTANGLE_DAEMON_PASSWORD  optional connect password
+ */
+export declare function runDaemon(): Promise<void>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

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

package/dist/daemon.js

@@ -0,0 +1,245 @@
+import * as net from 'net';
+import * as fs from 'fs';
+import { OutputHandler, parseOutputMode } from '@thenewlabs/entangle-utils';
+import { startAgent } from './agent.js';
+import { SharedWorkspace } from './shared-workspace.js';
+import { LocalHostSession } from './host-session.js';
+import { addSession, logPath, removeSession } from './session-registry.js';
+import { createMessageReader, decodeChunk, encodeChunk, writeMessage, } from './ipc.js';
+/**
+ * The DAEMON half of the tmux-style detach/reattach split for `entangle serve`.
+ *
+ * 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.
+ *
+ * Config comes entirely from the environment (set by the index wiring that spawns
+ * the daemon):
+ *
+ *   ENTANGLE_DAEMON_SESSION   session name (registry key + log/socket basename)
+ *   ENTANGLE_DAEMON_SOCKET    absolute path of the unix socket to listen on
+ *   ENTANGLE_DAEMON_SERVER    relay server URL to register with
+ *   ENTANGLE_DAEMON_CAP       JSON-encoded CapabilityInfo ({capId,S,policy}) to pin
+ *   ENTANGLE_DAEMON_PASSWORD  optional connect password
+ */
+export async function runDaemon() {
+    const name = requireEnv('ENTANGLE_DAEMON_SESSION');
+    const socketPathValue = requireEnv('ENTANGLE_DAEMON_SOCKET');
+    const serverUrl = requireEnv('ENTANGLE_DAEMON_SERVER');
+    const cap = parseCap(requireEnv('ENTANGLE_DAEMON_CAP'));
+    const password = process.env.ENTANGLE_DAEMON_PASSWORD;
+    const output = new OutputHandler({ mode: parseOutputMode('text') });
+    // A sane default size; the first attaching client resizes the session to its
+    // real terminal via its `hello`.
+    const workspace = new SharedWorkspace(output, { cols: 80, rows: 24 });
+    // Installs the log sink (agent logs → ring buffer, fanned out to clients as
+    // `log` frames) and owns the session URL via setUrl().
+    const localSession = new LocalHostSession(workspace, output);
+    const createdAt = Date.now();
+    const register = (url) => {
+        const info = {
+            name,
+            socket: socketPathValue,
+            logFile: logPath(name),
+            pid: process.pid,
+            capId: cap.capId,
+            url,
+            createdAt,
+        };
+        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 */ }
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => shutdown(0));
+    process.on('SIGINT', () => shutdown(0));
+    // Subscribe ONCE to the session and fan each event out to every client.
+    localSession.onHostData((chunk) => broadcast({ t: 'data', chunk: encodeChunk(chunk) }));
+    localSession.onWindowState((state) => broadcast({ t: 'window-state', state }));
+    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 ---------------------------------------------
+    const handleClientMessage = (msg, socket) => {
+        switch (msg.t) {
+            case 'hello':
+                localSession.resize(msg.cols, msg.rows);
+                break;
+            case 'input':
+                localSession.write(decodeChunk(msg.data));
+                break;
+            case 'resize':
+                localSession.resize(msg.cols, msg.rows);
+                break;
+            case 'win':
+                switch (msg.op) {
+                    case 'new':
+                        localSession.newWindow();
+                        break;
+                    case 'next':
+                        localSession.nextWindow();
+                        break;
+                    case 'prev':
+                        localSession.prevWindow();
+                        break;
+                    case 'select':
+                        if (msg.index !== undefined)
+                            localSession.selectWindow(msg.index);
+                        break;
+                    case 'close':
+                        if (msg.index !== undefined)
+                            localSession.closeWindow(msg.index);
+                        break;
+                }
+                break;
+            case 'detach':
+                // Drop just this client; the daemon (and session) keep running.
+                clients.delete(socket);
+                try {
+                    socket.end();
+                }
+                catch { /* already ending */ }
+                break;
+        }
+    };
+    const onConnection = (socket) => {
+        clients.add(socket);
+        const remove = () => { clients.delete(socket); };
+        socket.on('close', remove);
+        socket.on('error', remove);
+        createMessageReader(socket, (msg) => {
+            // Only ClientToDaemon frames are expected inbound; a single bad message
+            // must not take down the daemon.
+            try {
+                handleClientMessage(msg, socket);
+            }
+            catch (err) {
+                output.warn('Client message failed', err instanceof Error ? err.message : String(err));
+            }
+        }, () => { remove(); try {
+            socket.destroy();
+        }
+        catch { /* already gone */ } });
+        // Push the current state immediately so the client's UI populates fast.
+        try {
+            const url = localSession.getUrl();
+            if (url)
+                writeMessage(socket, { t: 'url', url });
+            writeMessage(socket, { t: 'window-state', state: localSession.windowState() });
+            writeMessage(socket, { t: 'viewers', n: localSession.viewerCount() });
+            for (const line of localSession.getLogBuffer())
+                writeMessage(socket, { t: 'log', line });
+            writeMessage(socket, { t: 'replay', chunk: encodeChunk(localSession.getReplay()) });
+        }
+        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 once the relay assigns it).
+    register('');
+    // Connect to the relay and serve the pinned capability. onCapabilityReady sets
+    // the session URL (fanned out as a `url` frame) and records it in the registry.
+    await startAgent({
+        serverUrl,
+        sharedWorkspace: workspace,
+        onCapabilityReady: ({ link }) => {
+            localSession.setUrl(link);
+            register(link);
+        },
+        ...(password ? { password } : {}),
+        pinnedCapability: cap,
+    });
+}
+/** Read a required env var or throw a clear configuration error. */
+function requireEnv(key) {
+    const value = process.env[key];
+    if (!value)
+        throw new Error(`Daemon misconfigured: ${key} is not set`);
+    return value;
+}
+/** Parse the pinned capability JSON from the environment. */
+function parseCap(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('Daemon misconfigured: ENTANGLE_DAEMON_CAP is not valid JSON');
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        throw new Error('Daemon misconfigured: ENTANGLE_DAEMON_CAP is not a capability object');
+    }
+    const c = parsed;
+    if (typeof c.capId !== 'string' || typeof c.S !== 'string' || typeof c.policy !== 'object' || c.policy === null) {
+        throw new Error('Daemon misconfigured: ENTANGLE_DAEMON_CAP is missing capId/S/policy');
+    }
+    return parsed;
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/host-session.d.ts

@@ -0,0 +1,99 @@
+import { OutputHandler } from '@thenewlabs/entangle-utils';
+import type { WindowStateBody } from '@thenewlabs/entangle-protocol';
+import type { SharedWorkspace } from './shared-workspace.js';
+/**
+ * The data source the host terminal UI renders against, decoupled from the
+ * concrete {@link SharedWorkspace}/{@link OutputHandler} it runs on today.
+ *
+ * The blue-bar host UI (see host-terminal.ts) only ever touches this surface:
+ * the active window's byte stream, the window set + operations, the viewer
+ * count, the captured agent-log tail (debug tab), the session URL, and the
+ * lifecycle exit. Keeping the UI on this interface lets the SAME UI later run
+ * against a socket-backed session (a daemon/client split) instead of the
+ * in-process workspace, with no UI changes.
+ */
+export interface HostSession {
+    /** Register the callback fired with the active window's output chunks. */
+    onHostData(cb: (chunk: Buffer) => void): void;
+    /** Merge input (host keystrokes) into the active window. */
+    write(data: Uint8Array | string): void;
+    /** Resize the session (host is authoritative) to `cols` x `rows`. */
+    resize(cols: number, rows: number): void;
+    /** Recent-output snapshot of the active window (initial/repaint screen). */
+    getReplay(): Uint8Array;
+    /** Register the callback fired whenever the window set changes. */
+    onWindowState(cb: (s: WindowStateBody) => void): void;
+    /** Current window state (windows + active index) for the tab bar. */
+    windowState(): WindowStateBody;
+    /** Create a new window and switch to it. */
+    newWindow(): void;
+    /** Switch to the next window (wraps). */
+    nextWindow(): void;
+    /** Switch to the previous window (wraps). */
+    prevWindow(): void;
+    /** Switch the active window to `i` (no-op if out of range). */
+    selectWindow(i: number): void;
+    /** Close the window at `i`. */
+    closeWindow(i: number): void;
+    /** Register the callback fired whenever the attached-viewer count changes. */
+    onViewersChange(cb: (n: number) => void): void;
+    /** Number of attached client viewers. */
+    viewerCount(): number;
+    /** Register a callback fired with each newly captured `[level] message` line. */
+    onLog(cb: (line: string) => void): void;
+    /** The captured agent-log ring buffer (tail of which the debug tab shows). */
+    getLogBuffer(): readonly string[];
+    /** The session URL once the relay assigns it, else null. */
+    getUrl(): string | null;
+    /** Register a callback fired when the session URL is set (or refreshed). */
+    onUrl(cb: (url: string) => void): void;
+    /** Register the callback fired once when the session ends. */
+    onExit(cb: (code: number | null, signal: string | null) => void): void;
+    /** Tear down any owned resources (e.g. release the captured-log sink). */
+    dispose(): void;
+    /** Detach without ending the session (unused for now). */
+    detach?(): void;
+}
+/**
+ * The in-process {@link HostSession}: a thin adapter over a {@link SharedWorkspace}
+ * (for terminal/window/viewer/exit) that additionally OWNS the two sources the
+ * workspace doesn't provide:
+ *
+ * - the captured agent logs — it installs an {@link OutputHandler} log sink and
+ *   appends `[level] message` lines to a capped ring buffer for the debug tab
+ *   (this responsibility used to live in host-terminal); {@link dispose} clears
+ *   the sink so late logs print to stdout normally again;
+ * - the session URL — {@link setUrl} stores it and notifies {@link onUrl}
+ *   subscribers (the relay assigns it only after attach).
+ */
+export declare class LocalHostSession implements HostSession {
+    private readonly workspace;
+    private readonly logBuf;
+    private readonly logCbs;
+    private readonly urlCbs;
+    private url;
+    constructor(workspace: SharedWorkspace, _output: OutputHandler);
+    private pushLog;
+    onHostData(cb: (chunk: Buffer) => void): void;
+    write(data: Uint8Array | string): void;
+    resize(cols: number, rows: number): void;
+    getReplay(): Uint8Array;
+    onWindowState(cb: (s: WindowStateBody) => void): void;
+    windowState(): WindowStateBody;
+    newWindow(): void;
+    nextWindow(): void;
+    prevWindow(): void;
+    selectWindow(i: number): void;
+    closeWindow(i: number): void;
+    onViewersChange(cb: (n: number) => void): void;
+    viewerCount(): number;
+    onLog(cb: (line: string) => void): void;
+    getLogBuffer(): readonly string[];
+    getUrl(): string | null;
+    onUrl(cb: (url: string) => void): void;
+    /** Store the session URL (once the relay assigns it) and notify subscribers. */
+    setUrl(link: string): void;
+    onExit(cb: (code: number | null, signal: string | null) => void): void;
+    dispose(): void;
+}
+//# sourceMappingURL=host-session.d.ts.map

package/dist/host-session.d.ts.map

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

package/dist/host-session.js

@@ -0,0 +1,83 @@
+import { OutputHandler } from '@thenewlabs/entangle-utils';
+/** Cap on the host's captured-log ring buffer backing the debug tab. */
+const DEBUG_MAX_LINES = 1000;
+/**
+ * The in-process {@link HostSession}: a thin adapter over a {@link SharedWorkspace}
+ * (for terminal/window/viewer/exit) that additionally OWNS the two sources the
+ * workspace doesn't provide:
+ *
+ * - the captured agent logs — it installs an {@link OutputHandler} log sink and
+ *   appends `[level] message` lines to a capped ring buffer for the debug tab
+ *   (this responsibility used to live in host-terminal); {@link dispose} clears
+ *   the sink so late logs print to stdout normally again;
+ * - the session URL — {@link setUrl} stores it and notifies {@link onUrl}
+ *   subscribers (the relay assigns it only after attach).
+ */
+export class LocalHostSession {
+    workspace;
+    logBuf = [];
+    logCbs = [];
+    urlCbs = [];
+    url = null;
+    // `output` is accepted for symmetry with the workspace's construction (and so
+    // a future session variant can log through it); the log sink it installs is a
+    // process-global static, so the instance itself isn't retained.
+    constructor(workspace, _output) {
+        this.workspace = workspace;
+        // Redirect all agent text-mode logs into the ring buffer instead of stdout
+        // (which the host UI owns) so they don't trample the terminal, and feed the
+        // debug tab. Cleared again in dispose().
+        OutputHandler.setLogSink((level, message, data) => this.pushLog(level, message, data));
+    }
+    pushLog(level, message, data) {
+        let line = `[${level}] ${message}`;
+        if (data !== undefined && data !== null) {
+            let extra;
+            try {
+                extra = typeof data === 'string' ? data : JSON.stringify(data);
+            }
+            catch {
+                extra = String(data);
+            }
+            if (extra)
+                line += ` ${extra}`;
+        }
+        this.logBuf.push(line);
+        if (this.logBuf.length > DEBUG_MAX_LINES)
+            this.logBuf.splice(0, this.logBuf.length - DEBUG_MAX_LINES);
+        for (const cb of this.logCbs)
+            cb(line);
+    }
+    // --- terminal ------------------------------------------------------------
+    onHostData(cb) { this.workspace.onHostData(cb); }
+    write(data) { this.workspace.write(data); }
+    resize(cols, rows) { this.workspace.resize(cols, rows); }
+    getReplay() { return this.workspace.getReplay(); }
+    // --- windows -------------------------------------------------------------
+    onWindowState(cb) { this.workspace.onWindowState(cb); }
+    windowState() { return this.workspace.windowState(); }
+    newWindow() { this.workspace.newWindow(); }
+    nextWindow() { this.workspace.nextWindow(); }
+    prevWindow() { this.workspace.prevWindow(); }
+    selectWindow(i) { this.workspace.selectWindow(i); }
+    closeWindow(i) { this.workspace.closeWindow(i); }
+    // --- viewers -------------------------------------------------------------
+    onViewersChange(cb) { this.workspace.onViewersChange(cb); }
+    viewerCount() { return this.workspace.viewerCount(); }
+    // --- logs ----------------------------------------------------------------
+    onLog(cb) { this.logCbs.push(cb); }
+    getLogBuffer() { return this.logBuf; }
+    // --- url -----------------------------------------------------------------
+    getUrl() { return this.url; }
+    onUrl(cb) { this.urlCbs.push(cb); }
+    /** Store the session URL (once the relay assigns it) and notify subscribers. */
+    setUrl(link) {
+        this.url = link;
+        for (const cb of this.urlCbs)
+            cb(link);
+    }
+    // --- lifecycle -----------------------------------------------------------
+    onExit(cb) { this.workspace.onExit(cb); }
+    dispose() { OutputHandler.setLogSink(null); }
+}
+//# sourceMappingURL=host-session.js.map

package/dist/host-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-session.js","sourceRoot":"","sources":["../src/host-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAI3D,wEAAwE;AACxE,MAAM,eAAe,GAAG,IAAI,CAAC;AAmE7B;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAgB;IAUR;IATF,MAAM,GAAa,EAAE,CAAC;IACtB,MAAM,GAAkC,EAAE,CAAC;IAC3C,MAAM,GAAiC,EAAE,CAAC;IACnD,GAAG,GAAkB,IAAI,CAAC;IAElC,8EAA8E;IAC9E,8EAA8E;IAC9E,gEAAgE;IAChE,YACmB,SAA0B,EAC3C,OAAsB;QADL,cAAS,GAAT,SAAS,CAAiB;QAG3C,2EAA2E;QAC3E,4EAA4E;QAC5E,yCAAyC;QACzC,aAAa,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACzF,CAAC;IAEO,OAAO,CAAC,KAAa,EAAE,OAAe,EAAE,IAAc;QAC5D,IAAI,IAAI,GAAG,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACnC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACxC,IAAI,KAAa,CAAC;YAClB,IAAI,CAAC;gBAAC,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YACvE,MAAM,CAAC;gBAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAC/B,IAAI,KAAK;gBAAE,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;QACtG,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM;YAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,4EAA4E;IAC5E,UAAU,CAAC,EAA2B,IAAU,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChF,KAAK,CAAC,IAAyB,IAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,CAAC,IAAY,EAAE,IAAY,IAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/E,SAAS,KAAiB,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAE9D,4EAA4E;IAC5E,aAAa,CAAC,EAAgC,IAAU,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3F,WAAW,KAAsB,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACvE,SAAS,KAAW,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACjD,UAAU,KAAW,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACnD,UAAU,KAAW,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACnD,YAAY,CAAC,CAAS,IAAU,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,WAAW,CAAC,CAAS,IAAU,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/D,4EAA4E;IAC5E,eAAe,CAAC,EAAuB,IAAU,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtF,WAAW,KAAa,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAE9D,4EAA4E;IAC5E,KAAK,CAAC,EAA0B,IAAU,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,YAAY,KAAwB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzD,4EAA4E;IAC5E,MAAM,KAAoB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAyB,IAAU,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,gFAAgF;IAChF,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAChB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM;YAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,EAAwD,IAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrG,OAAO,KAAW,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CACpD"}

package/dist/host-terminal.d.ts

@@ -1,16 +1,7 @@
 import { OutputHandler } from '@thenewlabs/entangle-utils';
-import type { SharedWorkspace } from './shared-workspace.js';
+import type { HostSession } from './host-session.js';
 /**
- * Handle returned by {@link attachHostTerminal}. The session URL is only known
- * once the relay assigns the capability, so index.ts feeds it in later via
- * {@link HostTerminalHandle.setUrl}; until then the host shows a brief
- * "connecting…" screen and only goes live once the URL arrives.
- */
-export interface HostTerminalHandle {
-    setUrl(link: string): void;
-}
-/**
- * Wire the host's own terminal to the shared workspace.
+ * Wire the host's own terminal to the {@link HostSession}.
  *
  * On a real, big-enough terminal the host sees their shell rendered RAW at full
  * width, using rows 1..(rows-1), with a blue tmux-style status bar pinned to the
@@ -18,6 +9,10 @@ export interface HostTerminalHandle {
  * region keeps its scrolling clear of the bar; because output is passed through
  * byte-for-byte (no VtGrid), resizes stay clean. Elsewhere (too small, or not a
  * TTY) it falls back to raw pass-through.
+ *
+ * The session URL is only known once the relay assigns the capability, so the
+ * host subscribes to {@link HostSession.onUrl} and shows a brief "connecting…"
+ * screen until it arrives (index.ts sets it on the session).
  */
-export declare function attachHostTerminal(shared: SharedWorkspace, output: OutputHandler): HostTerminalHandle;
+export declare function attachHostTerminal(session: HostSession, output: OutputHandler): void;
 //# sourceMappingURL=host-terminal.d.ts.map

package/dist/host-terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-terminal.d.ts","sourceRoot":"","sources":["../src/host-terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAS3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAqB7D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAYrG"}
+{"version":3,"file":"host-terminal.d.ts","sourceRoot":"","sources":["../src/host-terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAU3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAkBrD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAWpF"}