linkshell-cli 0.5.42 → 0.6.1

package/dist/host/src/ports.d.ts

@@ -0,0 +1,24 @@
+import { type PortInfo } from "@linkshell/wire";
+/**
+ * The host's web servers worth previewing: ones that answer HTTP and were
+ * started from a directory (system services run from `/`), minus this host's
+ * own ports. Databases, app helpers and build daemons listen too, but aren't
+ * pages.
+ */
+export declare function listPorts(options?: {
+    exclude?: number[];
+}): Promise<PortInfo[]>;
+/** One device connection's open streams; all end when the connection does. */
+export declare class ProxyStreams {
+    private readonly send;
+    private readonly streams;
+    constructor(send: {
+        data: (streamId: string, data: string) => void;
+        closed: (streamId: string, error?: string) => void;
+    });
+    open(port: number): Promise<string>;
+    write(streamId: string, data: string): void;
+    /** The device hung up: finish sending, then close. */
+    close(streamId: string): void;
+    closeAll(): void;
+}

package/dist/host/src/ports.js

@@ -0,0 +1,201 @@
+import { execFile } from "node:child_process";
+import { readlink } from "node:fs/promises";
+import { connect } from "node:net";
+import { randomUUID } from "node:crypto";
+import { promisify } from "node:util";
+import { RpcError } from "@linkshell/wire";
+// Previews of the host's local servers. `listPorts` finds what's listening
+// (and what looks like a dev server); `ProxyStreams` carries TCP streams to
+// those ports over a device's encrypted channel, like `ssh -L`.
+const run = promisify(execFile);
+/** `lsof -F` output: `p<pid>`, `c<command>`, then an `n<address>` per socket. */
+function parseLsof(output) {
+    const found = [];
+    let pid;
+    let command = "";
+    for (const line of output.split("\n")) {
+        const value = line.slice(1);
+        if (line.startsWith("p"))
+            pid = Number(value);
+        else if (line.startsWith("c"))
+            command = value;
+        else if (line.startsWith("n")) {
+            const port = Number(/:(\d+)$/.exec(value)?.[1]);
+            if (port)
+                found.push({ port, pid, process: command });
+        }
+    }
+    return found;
+}
+/** `ss -ltnpH`: `LISTEN 0 511 127.0.0.1:5173 0.0.0.0:* users:(("node",pid=1234,fd=20))`. */
+function parseSs(output) {
+    const found = [];
+    for (const line of output.split("\n")) {
+        const columns = line.trim().split(/\s+/);
+        const port = Number(/:(\d+)$/.exec(columns[3] ?? "")?.[1]);
+        if (!port)
+            continue;
+        const owner = /\("([^"]+)",pid=(\d+)/.exec(line);
+        found.push({ port, process: owner?.[1] ?? "", pid: owner ? Number(owner[2]) : undefined });
+    }
+    return found;
+}
+async function listeners() {
+    if (process.platform === "darwin") {
+        const { stdout } = await run("lsof", ["-nP", "-iTCP", "-sTCP:LISTEN", "-Fpcn"], { timeout: 5000, maxBuffer: 4_000_000 }).catch((error) => ({ stdout: error.stdout ?? "" }));
+        return parseLsof(stdout);
+    }
+    if (process.platform === "linux") {
+        const { stdout } = await run("ss", ["-ltnpH"], { timeout: 5000 }).catch(() => ({ stdout: "" }));
+        return parseSs(stdout);
+    }
+    return [];
+}
+async function workingDirectories(pids) {
+    const cwd = new Map();
+    if (!pids.length)
+        return cwd;
+    if (process.platform === "darwin") {
+        const { stdout } = await run("lsof", ["-a", "-d", "cwd", "-Fpn", "-p", pids.join(",")], { timeout: 5000 }).catch((error) => ({ stdout: error.stdout ?? "" }));
+        let pid;
+        for (const line of stdout.split("\n")) {
+            if (line.startsWith("p"))
+                pid = Number(line.slice(1));
+            else if (line.startsWith("n") && pid !== undefined)
+                cwd.set(pid, line.slice(1));
+        }
+    }
+    else if (process.platform === "linux") {
+        await Promise.all(pids.map(async (pid) => cwd.set(pid, await readlink(`/proc/${pid}/cwd`).catch(() => ""))));
+    }
+    return cwd;
+}
+/** Connects to a port on this machine's loopback, IPv4 first. */
+function connectLoopback(port) {
+    const attempt = (host) => new Promise((resolve, reject) => {
+        const socket = connect({ host, port });
+        socket.once("connect", () => {
+            socket.removeAllListeners("error");
+            resolve(socket);
+        });
+        socket.once("error", reject);
+    });
+    return attempt("127.0.0.1").catch(() => attempt("::1"));
+}
+/** Whether the port answers HTTP, and the page's <title> if it serves HTML. */
+async function probeHttp(port, timeoutMs = 1200) {
+    let socket;
+    try {
+        socket = await connectLoopback(port);
+        const open = socket;
+        return await new Promise((resolve) => {
+            let head = "";
+            const done = () => {
+                open.destroy();
+                const http = head.startsWith("HTTP/");
+                const html = /content-type:\s*text\/html/i.test(head);
+                const title = html ? /<title[^>]*>([^<]{1,200})<\/title>/i.exec(head)?.[1]?.trim() : undefined;
+                resolve({ http, title: title || undefined });
+            };
+            const timer = setTimeout(done, timeoutMs);
+            open.on("data", (chunk) => {
+                head += chunk.toString("utf8");
+                if (head.length > 64_000 || /<\/title>/i.test(head)) {
+                    clearTimeout(timer);
+                    done();
+                }
+            });
+            open.on("end", () => {
+                clearTimeout(timer);
+                done();
+            });
+            open.on("error", () => {
+                clearTimeout(timer);
+                done();
+            });
+            open.write(`GET / HTTP/1.1\r\nHost: localhost:${port}\r\nAccept: text/html\r\nConnection: close\r\n\r\n`);
+        });
+    }
+    catch {
+        socket?.destroy();
+        return { http: false };
+    }
+}
+/**
+ * The host's web servers worth previewing: ones that answer HTTP and were
+ * started from a directory (system services run from `/`), minus this host's
+ * own ports. Databases, app helpers and build daemons listen too, but aren't
+ * pages.
+ */
+export async function listPorts(options = {}) {
+    const exclude = new Set(options.exclude ?? []);
+    const seen = new Map();
+    for (const listener of await listeners()) {
+        if (exclude.has(listener.port) || listener.pid === process.pid || seen.has(listener.port))
+            continue;
+        seen.set(listener.port, listener);
+    }
+    const all = [...seen.values()];
+    const cwd = await workingDirectories([...new Set(all.flatMap((listener) => (listener.pid ? [listener.pid] : [])))]);
+    const candidates = all
+        .map((listener) => ({ ...listener, cwd: listener.pid ? cwd.get(listener.pid) : undefined }))
+        .filter((listener) => listener.cwd && listener.cwd !== "/")
+        .slice(0, 40);
+    const probed = await Promise.all(candidates.map(async (listener) => ({ ...listener, ...(await probeHttp(listener.port)) })));
+    return probed
+        .filter((entry) => entry.http)
+        .map(({ port, pid, process: name, cwd: dir, http, title }) => ({ port, pid, process: name, cwd: dir, http, title }))
+        .sort((a, b) => a.port - b.port);
+}
+const MAX_STREAMS = 96;
+/** One device connection's open streams; all end when the connection does. */
+export class ProxyStreams {
+    send;
+    streams = new Map();
+    constructor(send) {
+        this.send = send;
+    }
+    async open(port) {
+        if (this.streams.size >= MAX_STREAMS)
+            throw RpcError.app("busy", "too many open preview connections");
+        let socket;
+        try {
+            socket = await connectLoopback(port);
+        }
+        catch (error) {
+            throw RpcError.app("not_found", `nothing is listening on port ${port}`, { cause: String(error) });
+        }
+        const streamId = randomUUID();
+        this.streams.set(streamId, socket);
+        socket.setNoDelay(true);
+        socket.on("data", (chunk) => this.send.data(streamId, chunk.toString("base64")));
+        let failure;
+        socket.on("error", (error) => (failure = error.message));
+        socket.on("close", () => {
+            if (this.streams.delete(streamId))
+                this.send.closed(streamId, failure);
+        });
+        return streamId;
+    }
+    write(streamId, data) {
+        const socket = this.streams.get(streamId);
+        if (!socket)
+            throw RpcError.app("not_found", "this preview connection has closed");
+        socket.write(Buffer.from(data, "base64"));
+    }
+    /** The device hung up: finish sending, then close. */
+    close(streamId) {
+        const socket = this.streams.get(streamId);
+        if (!socket)
+            return;
+        this.streams.delete(streamId);
+        socket.end();
+        setTimeout(() => socket.destroy(), 5000).unref();
+    }
+    closeAll() {
+        for (const socket of this.streams.values())
+            socket.destroy();
+        this.streams.clear();
+    }
+}
+//# sourceMappingURL=ports.js.map

package/dist/host/src/ports.js.map

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

package/dist/host/src/rpc/client.d.ts

@@ -0,0 +1,9 @@
+import { type MethodName, type MethodParams, type MethodResult, type NotificationName, type NotificationParams } from "@linkshell/wire";
+export interface HostClient {
+    call<M extends MethodName>(method: M, params: MethodParams<M>, timeoutMs?: number): Promise<MethodResult<M>>;
+    on<N extends NotificationName>(name: N, listener: (params: NotificationParams<N>) => void): () => void;
+    close(): void;
+    readonly closed: Promise<void>;
+}
+/** Connects to a host over its unix socket (`path`) or a `ws://` URL. */
+export declare function connectHost(target: string): Promise<HostClient>;

package/dist/host/src/rpc/client.js

@@ -0,0 +1,42 @@
+import WebSocket from "ws";
+import { RpcPeer, } from "@linkshell/wire";
+/** Connects to a host over its unix socket (`path`) or a `ws://` URL. */
+export async function connectHost(target) {
+    const url = target.startsWith("ws://") || target.startsWith("wss://") ? target : `ws+unix://${target}:/`;
+    const socket = new WebSocket(url, { perMessageDeflate: false });
+    await new Promise((resolve, reject) => {
+        socket.once("open", () => resolve());
+        socket.once("error", reject);
+    });
+    const listeners = new Map();
+    const peer = new RpcPeer({
+        send: (text) => socket.send(text),
+        onNotification: (method, params) => {
+            for (const listener of listeners.get(method) ?? [])
+                listener(params);
+        },
+        requestTimeoutMs: 120_000,
+    });
+    socket.on("message", (data) => peer.receive(data.toString()));
+    const closed = new Promise((resolve) => {
+        socket.once("close", () => {
+            peer.close();
+            resolve();
+        });
+    });
+    return {
+        call: (method, params, timeoutMs) => peer.request(method, params, timeoutMs),
+        on(name, listener) {
+            let set = listeners.get(name);
+            if (!set) {
+                set = new Set();
+                listeners.set(name, set);
+            }
+            set.add(listener);
+            return () => set.delete(listener);
+        },
+        close: () => socket.close(),
+        closed,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/host/src/rpc/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../host/src/rpc/client.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EACL,OAAO,GAMR,MAAM,iBAAiB,CAAC;AASzB,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,IAAI,CAAC;IACzG,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0C,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC;QACvB,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACjC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;YACjC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;gBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;QACD,gBAAgB,EAAE,OAAO;KAC1B,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC3C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;QAC5E,EAAE,CAAC,IAAI,EAAE,QAAQ;YACf,IAAI,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;gBAChB,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC3B,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,QAAqC,CAAC,CAAC;YAC/C,OAAO,GAAG,EAAE,CAAC,GAAI,CAAC,MAAM,CAAC,QAAqC,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QAC3B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/host/src/rpc/server.d.ts

@@ -0,0 +1,52 @@
+import { type MachineInfo, type NotificationName, type NotificationParams } from "@linkshell/wire";
+import type { GatewayLink } from "../gateway.js";
+import type { SessionHub } from "../hub.js";
+import type { TerminalManager } from "../terminals.js";
+export interface HostRpcServerOptions {
+    hub: SessionHub;
+    terminals: TerminalManager;
+    machineInfo: () => MachineInfo;
+    /** Unix socket for local clients (terminal shims, CLI). */
+    socketPath: string;
+    /** Optional loopback TCP port, for local development clients. */
+    tcpPort?: number;
+    log: (message: string) => void;
+}
+/** Anything that carries JSON-RPC text both ways: a local WebSocket, or an encrypted tunnel through the gateway. */
+export interface RpcTransport {
+    send(text: string): void;
+    close(): void;
+    onMessage(listener: (text: string) => void): void;
+    onClose(listener: () => void): void;
+    /** Local transports (this machine's own sockets) may use desktop.* methods. */
+    local: boolean;
+}
+/**
+ * JSON-RPC over WebSocket for host clients. Each connection gets live
+ * `session.summary` notifications, plus `session.event` for the sessions it
+ * subscribed to.
+ */
+export declare class HostRpcServer {
+    private readonly options;
+    private readonly servers;
+    private readonly sockets;
+    private readonly connections;
+    private gateway?;
+    private readonly screen;
+    private readonly handlers;
+    constructor(options: HostRpcServerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** The TCP port actually bound (useful when started with port 0). */
+    tcpAddress(): number | undefined;
+    private listen;
+    /** Makes this connection the terminal driving a handoff session. */
+    private adoptDesktop;
+    private accept;
+    setGateway(gateway: GatewayLink): void;
+    /** A notification to every connected client. */
+    broadcast<N extends NotificationName>(name: N, params: NotificationParams<N>): void;
+    /** Serves one client connection over `transport` until it closes. */
+    connect(transport: RpcTransport): void;
+    private dispatch;
+}

package/dist/host/src/rpc/server.js

@@ -0,0 +1,293 @@
+import { createServer } from "node:http";
+import { existsSync, rmSync } from "node:fs";
+import WebSocket, { WebSocketServer } from "ws";
+import { RPC_INVALID_PARAMS, RPC_METHOD_NOT_FOUND, RpcError, RpcPeer, isMethodName, methods, } from "@linkshell/wire";
+import { listDirectory, makeDirectory, readFile, searchDirectories, uploadFile } from "../fs.js";
+import { listPorts, ProxyStreams } from "../ports.js";
+import { ScreenShare } from "../screen.js";
+/**
+ * JSON-RPC over WebSocket for host clients. Each connection gets live
+ * `session.summary` notifications, plus `session.event` for the sessions it
+ * subscribed to.
+ */
+export class HostRpcServer {
+    options;
+    servers = [];
+    sockets = new Set();
+    connections = new Set();
+    gateway;
+    screen;
+    handlers;
+    constructor(options) {
+        this.options = options;
+        this.screen = new ScreenShare(options.log);
+        const hub = options.hub;
+        const terminals = options.terminals;
+        this.handlers = {
+            "machine.info": () => {
+                void hub.refreshAuthIfStale();
+                return options.machineInfo();
+            },
+            "projects.list": (params) => ({ projects: hub.listProjects(params.limit) }),
+            "sessions.list": (params) => hub.listSessions(params),
+            "sessions.create": async (params) => ({ session: await hub.createSession(params) }),
+            "sessions.subscribe": async (params, context) => {
+                const previous = context.subscriptions.get(params.sessionId);
+                if (previous)
+                    hub.unsubscribe(params.sessionId, previous);
+                const subscriber = { event: (event) => context.peer.notify("session.event", event) };
+                context.subscriptions.set(params.sessionId, subscriber);
+                return { session: await hub.subscribe(params.sessionId, params.fromSeq, subscriber) };
+            },
+            "sessions.unsubscribe": (params, context) => {
+                const subscriber = context.subscriptions.get(params.sessionId);
+                if (subscriber)
+                    hub.unsubscribe(params.sessionId, subscriber);
+                context.subscriptions.delete(params.sessionId);
+                return {};
+            },
+            "sessions.prompt": async (params) => ({
+                delivery: await hub.prompt(params.sessionId, params.clientMessageId, params.content),
+            }),
+            "sessions.cancel": async (params) => {
+                await hub.cancel(params.sessionId);
+                return {};
+            },
+            "sessions.permission": async (params) => {
+                await hub.respondPermission(params.sessionId, params.requestId, params.optionId);
+                return {};
+            },
+            "sessions.setConfig": async (params) => {
+                await hub.setConfig(params.sessionId, params.optionId, params.value);
+                return {};
+            },
+            "sessions.takeover": async (params) => ({ driver: (await hub.takeover(params.sessionId)).driver }),
+            "sessions.release": (params) => ({ driver: hub.getSession(params.sessionId).driver }),
+            "desktop.launch": async (params, context) => {
+                const launch = await hub.desktopLaunch(params.agent, params.args, params.sessionId, { cwd: params.cwd, env: params.env });
+                if (launch.sessionId)
+                    this.adoptDesktop(launch.sessionId, context);
+                return launch;
+            },
+            "desktop.yielded": (params, context) => {
+                const entry = context.desktops.get(params.sessionId);
+                entry?.pendingYield?.();
+                if (entry)
+                    entry.pendingYield = undefined;
+                return {};
+            },
+            "gateway.status": () => this.gateway?.status() ?? { status: "off", devices: [] },
+            "pairing.start": (_params, context) => {
+                if (!context.local)
+                    throw RpcError.app("forbidden", "pairing starts on the computer itself");
+                if (!this.gateway)
+                    throw RpcError.app("not_supported", "no gateway configured: start the host with --gateway <url>");
+                return this.gateway.startPairing();
+            },
+            "devices.revoke": async (params) => {
+                await this.gateway?.revoke(params.deviceId);
+                return {};
+            },
+            "fs.list": (params) => listDirectory(params),
+            "fs.search": (params) => searchDirectories(params),
+            "fs.read": (params) => readFile(params),
+            "fs.upload": (params) => uploadFile(params),
+            "fs.mkdir": (params) => makeDirectory(params),
+            "terminals.list": () => ({ terminals: terminals.list() }),
+            "terminals.create": (params) => ({ terminal: terminals.create(params) }),
+            "terminals.attach": (params, context) => {
+                const previous = context.terminals.get(params.terminalId);
+                if (previous)
+                    terminals.detach(params.terminalId, previous);
+                const listener = (seq, data) => context.peer.notify("terminal.output", { terminalId: params.terminalId, seq, data });
+                const attached = terminals.attach(params.terminalId, listener, params.fromSeq);
+                context.terminals.set(params.terminalId, listener);
+                return attached;
+            },
+            "terminals.detach": (params, context) => {
+                const listener = context.terminals.get(params.terminalId);
+                if (listener)
+                    terminals.detach(params.terminalId, listener);
+                context.terminals.delete(params.terminalId);
+                return {};
+            },
+            "terminals.input": (params) => {
+                terminals.input(params.terminalId, params.data);
+                return {};
+            },
+            "terminals.resize": (params) => {
+                terminals.resize(params.terminalId, params.cols, params.rows);
+                return {};
+            },
+            "ports.list": async () => ({ ports: await listPorts() }),
+            "screen.start": () => this.screen.start(),
+            "proxy.open": async (params, context) => ({ streamId: await context.proxy.open(params.port) }),
+            "proxy.write": (params, context) => {
+                context.proxy.write(params.streamId, params.data);
+                return {};
+            },
+            "proxy.close": (params, context) => {
+                context.proxy.close(params.streamId);
+                return {};
+            },
+            "terminals.close": (params) => {
+                terminals.close(params.terminalId);
+                return {};
+            },
+            "desktop.reclaim": async (params, context) => {
+                const launch = await hub.reclaim(params.sessionId, {});
+                this.adoptDesktop(params.sessionId, context);
+                return launch;
+            },
+        };
+    }
+    async start() {
+        if (existsSync(this.options.socketPath))
+            rmSync(this.options.socketPath, { force: true });
+        await this.listen((server) => server.listen(this.options.socketPath));
+        if (this.options.tcpPort !== undefined) {
+            await this.listen((server) => server.listen(this.options.tcpPort, "127.0.0.1"));
+        }
+    }
+    async stop() {
+        this.screen.stop();
+        for (const socket of this.sockets)
+            socket.terminate();
+        await Promise.all(this.servers.map((server) => new Promise((resolve) => server.close(() => resolve()))));
+        rmSync(this.options.socketPath, { force: true });
+    }
+    /** The TCP port actually bound (useful when started with port 0). */
+    tcpAddress() {
+        const address = this.servers[1]?.address();
+        return address && typeof address === "object" ? address.port : undefined;
+    }
+    listen(bind) {
+        const server = createServer((_, response) => {
+            response.writeHead(426, { "content-type": "text/plain" });
+            response.end("LinkShell host: WebSocket required\n");
+        });
+        const wss = new WebSocketServer({ server, perMessageDeflate: false, maxPayload: 32 * 1024 * 1024 });
+        wss.on("connection", (socket) => this.accept(socket));
+        this.servers.push(server);
+        return new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.once("listening", () => {
+                server.off("error", reject);
+                resolve();
+            });
+            bind(server);
+        });
+    }
+    /** Makes this connection the terminal driving a handoff session. */
+    adoptDesktop(sessionId, context) {
+        // Already this terminal's session (e.g. after reclaim): keep the registration.
+        if (context.desktops.has(sessionId))
+            return;
+        const entry = { unregister: () => { } };
+        entry.unregister = this.options.hub.registerDesktop(sessionId, {
+            yield: () => new Promise((resolve) => {
+                const timer = setTimeout(done, 15_000);
+                function done() {
+                    clearTimeout(timer);
+                    resolve();
+                }
+                entry.pendingYield = done;
+                context.peer.notify("desktop.yield", { sessionId });
+            }),
+            activity: (line) => context.peer.notify("desktop.remoteActivity", { sessionId, line }),
+        });
+        context.desktops.set(sessionId, entry);
+    }
+    accept(socket) {
+        this.sockets.add(socket);
+        const listeners = {};
+        socket.on("message", (data) => listeners.message?.(data.toString()));
+        socket.on("close", () => {
+            this.sockets.delete(socket);
+            listeners.close?.();
+        });
+        this.connect({
+            local: true,
+            send: (text) => {
+                if (socket.readyState === WebSocket.OPEN)
+                    socket.send(text);
+            },
+            close: () => socket.close(),
+            onMessage: (listener) => (listeners.message = listener),
+            onClose: (listener) => (listeners.close = listener),
+        });
+    }
+    setGateway(gateway) {
+        this.gateway = gateway;
+    }
+    /** A notification to every connected client. */
+    broadcast(name, params) {
+        for (const peer of this.connections)
+            peer.notify(name, params);
+    }
+    /** Serves one client connection over `transport` until it closes. */
+    connect(transport) {
+        const peer = new RpcPeer({
+            send: (text) => transport.send(text),
+            onRequest: (method, params) => this.dispatch(method, params, context),
+        });
+        const context = {
+            local: transport.local,
+            desktops: new Map(),
+            subscriptions: new Map(),
+            terminals: new Map(),
+            proxy: new ProxyStreams({
+                data: (streamId, data) => peer.notify("proxy.data", { streamId, data }),
+                closed: (streamId, error) => peer.notify("proxy.closed", error ? { streamId, error } : { streamId }),
+            }),
+            peer,
+        };
+        this.connections.add(context.peer);
+        const stopSummaries = this.options.hub.onSummary((session) => context.peer.notify("session.summary", { session }));
+        const stopTerminals = this.options.terminals.onChange((terminal, closed) => context.peer.notify("terminal.changed", closed ? { terminal, closed } : { terminal }));
+        transport.onMessage((text) => context.peer.receive(text));
+        transport.onClose(() => {
+            this.connections.delete(context.peer);
+            stopSummaries();
+            stopTerminals();
+            for (const [terminalId, listener] of context.terminals)
+                this.options.terminals.detach(terminalId, listener);
+            context.terminals.clear();
+            for (const [sessionId, subscriber] of context.subscriptions)
+                this.options.hub.unsubscribe(sessionId, subscriber);
+            context.subscriptions.clear();
+            // A terminal that went away can't be driving anything; release waiters.
+            for (const entry of context.desktops.values()) {
+                entry.pendingYield?.();
+                entry.unregister();
+            }
+            context.desktops.clear();
+            context.proxy.closeAll();
+            context.peer.close();
+        });
+    }
+    async dispatch(method, params, context) {
+        if (!isMethodName(method))
+            throw new RpcError(RPC_METHOD_NOT_FOUND, `unknown method ${method}`);
+        // The terminal shim's methods launch local processes with a given environment: never over the network.
+        if (method.startsWith("desktop.") && !context.local)
+            throw RpcError.app("forbidden", `${method} is only available locally`);
+        const parsed = methods[method].params.safeParse(params ?? {});
+        if (!parsed.success) {
+            throw new RpcError(RPC_INVALID_PARAMS, `invalid params for ${method}`, {
+                code: "invalid_params",
+                issues: parsed.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`),
+            });
+        }
+        const handler = this.handlers[method];
+        try {
+            return await handler(parsed.data, context);
+        }
+        catch (error) {
+            if (!(error instanceof RpcError))
+                this.options.log(`[rpc] ${method} failed: ${error instanceof Error ? error.stack : String(error)}`);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=server.js.map