@desklink/host 0.1.0

package/dist/bridge.d.ts

@@ -0,0 +1,57 @@
+/**
+ * A consumer-facing transport for the engine's local protocol.
+ *
+ * The engine speaks newline-delimited JSON on stdio, which is the right shape
+ * for a consumer that already holds the process. A consumer whose client is on
+ * another machine needs something to carry that protocol further, and inventing
+ * one is exactly the work this package is supposed to remove. `Bridge` re-serves
+ * the same protocol over a WebSocket, so a browser, a phone or a script connects
+ * with nothing but a WebSocket.
+ *
+ * This is a *consumer-side* convenience, not engine surface: the engine still
+ * has no listener, and the bridge is started by whoever owns the machine.
+ */
+import { type EngineClientOptions } from './engineProcess.js';
+import type { SourceRequest } from './protocol.js';
+export interface BridgeOptions {
+    /** Address to listen on, e.g. `127.0.0.1:19400` or `0.0.0.0:19400`. */
+    listen: string;
+    /**
+     * Shared secret required on the socket path. Required, not optional: this
+     * channel grants control of a desktop, and `ws://` is plaintext, so an
+     * unauthenticated one on a reachable address is a remote-control port for
+     * anyone who finds it.
+     */
+    token: string;
+    engineCommand: string;
+    engineArgs: string[];
+    /** Serve the reference client page at `/?token=…` so the bridge is usable at once. */
+    serveExample?: boolean;
+    /**
+     * Which desktop this bridge offers. A bridge is bound to one machine and one
+     * desktop, and the client on the other end has no way to know whether that
+     * machine has a working screen-cast portal, so the choice belongs here.
+     */
+    source?: SourceRequest;
+    engineOptions?: EngineClientOptions;
+}
+/** The path a client connects to: `/desktop?token=…`. */
+export declare const BRIDGE_PATH = "/desktop";
+export declare class Bridge {
+    private readonly server;
+    private readonly sockets;
+    private readonly engine;
+    private readonly defaultSource;
+    private closing;
+    /** The session the engine holds, so a consumer that vanishes can release it. */
+    private session;
+    private constructor();
+    static start(options: BridgeOptions): Promise<Bridge>;
+    /** The port actually bound, which matters when the caller asked for `:0`. */
+    get port(): number;
+    private attach;
+    private rememberSession;
+    private releaseSessionIfDetached;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC1B,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sFAAsF;IACtF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,yDAAyD;AACzD,eAAO,MAAM,WAAW,aAAa,CAAC;AAYtC,qBAAa,MAAM;IAMX,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IARlC,OAAO,CAAC,OAAO,CAAS;IACxB,gFAAgF;IAChF,OAAO,CAAC,OAAO,CAAyD;IAExE,OAAO;WAOM,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAqD3D,6EAA6E;IAC7E,IAAI,IAAI,IAAI,MAAM,CAGjB;IAED,OAAO,CAAC,MAAM;IA4Dd,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,wBAAwB;IAa1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B"}

package/dist/bridge.js

@@ -0,0 +1,208 @@
+/**
+ * A consumer-facing transport for the engine's local protocol.
+ *
+ * The engine speaks newline-delimited JSON on stdio, which is the right shape
+ * for a consumer that already holds the process. A consumer whose client is on
+ * another machine needs something to carry that protocol further, and inventing
+ * one is exactly the work this package is supposed to remove. `Bridge` re-serves
+ * the same protocol over a WebSocket, so a browser, a phone or a script connects
+ * with nothing but a WebSocket.
+ *
+ * This is a *consumer-side* convenience, not engine surface: the engine still
+ * has no listener, and the bridge is started by whoever owns the machine.
+ */
+import { readFileSync } from 'node:fs';
+import { createServer } from 'node:http';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { WebSocketServer } from 'ws';
+import { EngineClient } from './engineProcess.js';
+/** The path a client connects to: `/desktop?token=…`. */
+export const BRIDGE_PATH = '/desktop';
+/**
+ * The reference client, served as one file with no build step. It is the
+ * smallest thing that shows a desktop in a browser, and it doubles as the worked
+ * example an application can read instead of reverse-engineering the protocol.
+ */
+function examplePage() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return readFileSync(join(here, '..', 'examples', 'reference-client.html'), 'utf8');
+}
+export class Bridge {
+    server;
+    sockets;
+    engine;
+    defaultSource;
+    closing = false;
+    /** The session the engine holds, so a consumer that vanishes can release it. */
+    session;
+    constructor(server, sockets, engine, defaultSource) {
+        this.server = server;
+        this.sockets = sockets;
+        this.engine = engine;
+        this.defaultSource = defaultSource;
+    }
+    static async start(options) {
+        if (options.token.trim() === '')
+            throw new Error('the bridge token must not be blank');
+        const server = createServer((request, response) => {
+            const url = new URL(request.url ?? '/', 'http://localhost');
+            // The page is served only to a caller that already has the token: an
+            // unauthenticated page that connects to a desktop would be a worse
+            // secret than the socket itself.
+            if (options.serveExample !== false && url.pathname === '/' && url.searchParams.get('token') === options.token) {
+                response.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-store' });
+                response.end(examplePage());
+                return;
+            }
+            response.writeHead(404);
+            response.end('not found');
+        });
+        const sockets = new WebSocketServer({
+            server,
+            path: BRIDGE_PATH,
+            // The token in the URL is the whole authorisation for this socket.
+            // It is deliberately checked here rather than in the first message:
+            // an unauthenticated socket must not be able to reach the engine at
+            // all, not merely be refused an answer.
+            verifyClient: ((info) => {
+                const url = new URL(info.req.url ?? '/', 'http://localhost');
+                return url.searchParams.get('token') === options.token;
+            }),
+        });
+        const engine = await EngineClient.start(options.engineCommand, options.engineArgs, {
+            ...(options.engineOptions ?? {}),
+            // Grant credentials stay with the host; session notifications go
+            // to the attached controllers watching this session.
+            onEvent: (event) => {
+                options.engineOptions?.onEvent?.(event);
+                if (event.event === 'session.restoreToken')
+                    return;
+                const line = JSON.stringify(event);
+                for (const socket of sockets.clients) {
+                    if (socket.readyState === socket.OPEN)
+                        socket.send(line);
+                }
+            },
+        });
+        const bridge = new Bridge(server, sockets, engine, options.source);
+        sockets.on('connection', (socket) => bridge.attach(socket));
+        const address = splitAddress(options.listen);
+        await new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(address.port, address.host, () => resolve());
+        });
+        return bridge;
+    }
+    /** The port actually bound, which matters when the caller asked for `:0`. */
+    get port() {
+        const address = this.server.address();
+        return typeof address === 'object' && address !== null ? address.port : 0;
+    }
+    attach(socket) {
+        socket.on('message', (raw) => {
+            let request;
+            try {
+                request = JSON.parse(String(raw));
+            }
+            catch {
+                socket.send(JSON.stringify({ error: { code: 'malformed', message: 'not JSON' } }));
+                return;
+            }
+            if (request === null || typeof request !== 'object' || Array.isArray(request)) {
+                socket.send(JSON.stringify({ error: { code: 'malformed', message: 'expected a request object' } }));
+                return;
+            }
+            const method = request.method;
+            if (typeof method !== 'string')
+                return;
+            if (method === 'session.open' && request.params != null && Object.prototype.hasOwnProperty.call(request.params, 'source')) {
+                socket.send(JSON.stringify({ id: request.id, error: { code: 'source', message: 'the client cannot choose the desktop source' } }));
+                return;
+            }
+            const params = method === 'session.open' && this.defaultSource !== undefined
+                ? { ...(request.params ?? {}), source: this.defaultSource }
+                : request.params;
+            void this.engine
+                .request(method, params)
+                .then((result) => {
+                this.rememberSession(method, result);
+                const forwarded = this.defaultSource?.kind === 'x11'
+                    && (method === 'hello' || method === 'capabilities')
+                    && result !== null && result.clipboard !== null && typeof result.clipboard === 'object'
+                    ? { ...result, clipboard: { ...result.clipboard, read: false, write: false } }
+                    : result;
+                if (method === 'session.open' && socket.readyState !== socket.OPEN) {
+                    this.releaseSessionIfDetached(true);
+                    return;
+                }
+                if (request.id !== undefined && socket.readyState === socket.OPEN) {
+                    socket.send(JSON.stringify({ id: request.id, result: forwarded }));
+                }
+            })
+                .catch((error) => {
+                if (request.id === undefined || socket.readyState !== socket.OPEN)
+                    return;
+                socket.send(JSON.stringify({
+                    id: request.id,
+                    error: {
+                        code: error.code ?? 'engine',
+                        message: error instanceof Error ? error.message : String(error),
+                    },
+                }));
+            });
+        });
+        // A consumer that disappears mid-gesture — a closed tab, a lost phone,
+        // a killed process — must not leave the desktop holding synthetic input
+        // until the engine's lease expires. Nothing keeps the session for a
+        // consumer that might reconnect: a reconnect opens a fresh one.
+        const release = () => this.releaseSessionIfDetached();
+        socket.on('close', release);
+        socket.on('error', release);
+    }
+    rememberSession(method, result) {
+        if (method === 'session.close') {
+            this.session = undefined;
+            return;
+        }
+        if (method !== 'session.open')
+            return;
+        const opened = result;
+        if (typeof opened?.sessionId !== 'string')
+            return;
+        this.session = typeof opened.generation === 'number'
+            ? { sessionId: opened.sessionId, generation: opened.generation }
+            : { sessionId: opened.sessionId };
+    }
+    releaseSessionIfDetached(force = false) {
+        if (this.closing || (!force && this.sockets.clients.size > 0))
+            return;
+        const session = this.session;
+        this.session = undefined;
+        if (session === undefined)
+            return;
+        void this.engine
+            .request('session.close', {
+            session_id: session.sessionId,
+            ...(session.generation !== undefined ? { generation: session.generation } : {}),
+        })
+            .catch(() => undefined);
+    }
+    async close() {
+        if (this.closing)
+            return;
+        this.closing = true;
+        for (const socket of this.sockets.clients)
+            socket.close();
+        await new Promise((resolve) => this.sockets.close(() => resolve()));
+        await new Promise((resolve) => this.server.close(() => resolve()));
+        await this.engine.stop().catch(() => undefined);
+    }
+}
+function splitAddress(listen) {
+    const index = listen.lastIndexOf(':');
+    if (index <= 0)
+        return { host: '127.0.0.1', port: Number(listen) || 0 };
+    return { host: listen.slice(0, index), port: Number(listen.slice(index + 1)) || 0 };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/engineProcess.d.ts

@@ -0,0 +1,82 @@
+import { type EngineCapabilities, type EngineEvent, type OpenedSession, type OpenSessionRequest, type SessionMetrics } from './protocol.js';
+export interface EngineClientOptions {
+    /**
+     * Request timeout: an engine that does not answer in time is killed, not
+     * waited on. A portal open that may wait on a consent prompt passes its
+     * own, longer one to `openSession`.
+     */
+    requestTimeoutMs?: number;
+    onEvent?: (event: EngineEvent) => void;
+    /** Called when the engine process goes away, with whatever it said first. */
+    onExit?: (detail: {
+        code: number | null;
+        signal: NodeJS.Signals | null;
+    }) => void;
+    onDiagnostic?: (line: string) => void;
+}
+/**
+ * A consumer of the engine's local control protocol.
+ *
+ * The engine is this process's child and speaks newline-delimited JSON on
+ * stdin/stdout, so the channel inherits this process's own access control: same
+ * user, same session, no socket to protect and no second authorization scheme.
+ */
+export declare class EngineClient {
+    private readonly child;
+    private readonly pending;
+    private readonly queue;
+    private nextId;
+    private closed;
+    private stopping;
+    private readonly timeoutMs;
+    private constructor();
+    /** Start an engine process and complete the protocol handshake. */
+    static start(command: string, args: string[], options?: EngineClientOptions, env?: NodeJS.ProcessEnv): Promise<EngineClient>;
+    private handleLine;
+    /**
+     * One request on the engine's protocol.
+     *
+     * Public because the protocol *is* the contract: a consumer that wants to
+     * add a capability the typed helpers do not cover should send it rather than
+     * patch this package.
+     */
+    request<T>(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    capabilities(): Promise<EngineCapabilities>;
+    /**
+     * `timeoutMs` overrides the client's request timeout for this open alone:
+     * a portal open may be waiting on a person at the computer, which takes
+     * longer than any other request should.
+     */
+    openSession(request: OpenSessionRequest, timeoutMs?: number): Promise<OpenedSession>;
+    acceptAnswer(sessionId: string, generation: number, sdp: string): Promise<{
+        accepted: boolean;
+    }>;
+    addCandidate(sessionId: string, generation: number, candidate: string, sdpMid: string | null, sdpMLineIndex: number | null): Promise<{
+        accepted: boolean;
+    }>;
+    metrics(): Promise<SessionMetrics>;
+    readClipboard(sessionId: string): Promise<{
+        text: string;
+        truncated: boolean;
+    }>;
+    writeClipboard(sessionId: string, text: string): Promise<{
+        written: boolean;
+    }>;
+    closeSession(sessionId: string): Promise<{
+        closed: boolean;
+    }>;
+    /** Drain notifications received so far, in order. */
+    drainEvents(sessionId?: string): EngineEvent[];
+    /**
+     * The engine answers one request at a time, so one it did not answer is
+     * still running inside it — typically a `session.open` waiting on a consent
+     * prompt nobody at the desktop is answering. Everything sent after it would
+     * queue behind it, and a late answer would open a session nobody owns, so
+     * the engine is killed and every waiting request fails with the reason.
+     * Its exit is also what withdraws a pending portal prompt: the portal
+     * closes every request whose sender left the session bus.
+     */
+    private abandon;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=engineProcess.d.ts.map

package/dist/engineProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineProcess.d.ts","sourceRoot":"","sources":["../src/engineProcess.ts"],"names":[],"mappings":"AAGA,OAAO,EAGH,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACtB,MAAM,eAAe,CAAC;AAQvB,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;IAClF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO;IAuBP,mEAAmE;WACtD,KAAK,CACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,mBAAwB,EACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,OAAO,CAAC,YAAY,CAAC;IAuBxB,OAAO,CAAC,UAAU;IAgClB;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,SAAiB,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBpG,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI3C;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAepF,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAQhG,YAAY,CACR,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAUjC,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IAIlC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAI/E,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAI9E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAI7D,qDAAqD;IACrD,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAU9C;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO;IAUT,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB9B"}

package/dist/engineProcess.js

@@ -0,0 +1,243 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { EngineRefused, PROTOCOL_VERSION, } from './protocol.js';
+/**
+ * A consumer of the engine's local control protocol.
+ *
+ * The engine is this process's child and speaks newline-delimited JSON on
+ * stdin/stdout, so the channel inherits this process's own access control: same
+ * user, same session, no socket to protect and no second authorization scheme.
+ */
+export class EngineClient {
+    child;
+    pending = new Map();
+    queue = [];
+    nextId = 1;
+    closed = false;
+    stopping = false;
+    timeoutMs;
+    constructor(child, options) {
+        this.child = child;
+        this.timeoutMs = options.requestTimeoutMs ?? 30_000;
+        const stdout = createInterface({ input: child.stdout });
+        stdout.on('line', (line) => this.handleLine(line, options));
+        const stderr = createInterface({ input: child.stderr });
+        stderr.on('line', (line) => options.onDiagnostic?.(line));
+        child.on('exit', (code, signal) => {
+            this.closed = true;
+            for (const [id, pending] of this.pending) {
+                this.pending.delete(id);
+                clearTimeout(pending.timer);
+                pending.reject(new Error('the desktop engine exited'));
+            }
+            if (!this.stopping)
+                options.onExit?.({ code, signal });
+        });
+        child.on('error', (error) => {
+            this.closed = true;
+            options.onDiagnostic?.(`engine process error: ${error.message}`);
+        });
+    }
+    /** Start an engine process and complete the protocol handshake. */
+    static async start(command, args, options = {}, env = process.env) {
+        if (process.platform === 'linux' && args[0] === 'serve') {
+            const probe = spawnSync(command, ['version'], { env, encoding: 'utf8', timeout: 3000 });
+            const missing = /error while loading shared libraries: ([^:\s]+): cannot open shared object file/.exec(probe.stderr ?? '')?.[1];
+            if (missing !== undefined && [
+                'libpipewire-0.3.so.0', 'libxkbcommon.so.0', 'libevdev.so.2', 'libstdc++.so.6',
+            ].includes(missing)) {
+                throw new EngineRefused('missing-system-library', `missing system library: ${missing}`);
+            }
+        }
+        const child = spawn(command, args, { env, stdio: ['pipe', 'pipe', 'pipe'] });
+        const client = new EngineClient(child, options);
+        try {
+            await client.request('hello', { protocol: PROTOCOL_VERSION });
+        }
+        catch (error) {
+            // A refused or timed-out handshake must not leave a child running
+            // with its exit still wired to the caller's state.
+            await client.stop().catch(() => undefined);
+            throw error;
+        }
+        return client;
+    }
+    handleLine(line, options) {
+        const trimmed = line.trim();
+        if (trimmed === '')
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            options.onDiagnostic?.(`engine sent a line that is not JSON: ${trimmed.slice(0, 200)}`);
+            return;
+        }
+        if (typeof parsed.event === 'string') {
+            const event = parsed;
+            // Setup notifications are drained by the consumer; queue them so a
+            // slow reader cannot lose an offer or a candidate.
+            this.queue.push(event);
+            options.onEvent?.(event);
+            return;
+        }
+        const id = typeof parsed.id === 'number' ? parsed.id : undefined;
+        if (id === undefined)
+            return;
+        const pending = this.pending.get(id);
+        if (pending === undefined)
+            return;
+        this.pending.delete(id);
+        clearTimeout(pending.timer);
+        const error = parsed.error;
+        if (error !== undefined) {
+            pending.reject(new EngineRefused(error.code ?? 'engine', error.message ?? 'the engine refused the request'));
+            return;
+        }
+        pending.resolve(parsed.result);
+    }
+    /**
+     * One request on the engine's protocol.
+     *
+     * Public because the protocol *is* the contract: a consumer that wants to
+     * add a capability the typed helpers do not cover should send it rather than
+     * patch this package.
+     */
+    request(method, params, timeoutMs = this.timeoutMs) {
+        if (this.closed) {
+            return Promise.reject(new Error('the desktop engine is not running'));
+        }
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => this.abandon(timedOut(method, params, timeoutMs)), timeoutMs);
+            this.pending.set(id, { resolve: resolve, reject, timer });
+            this.child.stdin.write(`${JSON.stringify({ id, method, params: params ?? {} })}\n`, (error) => {
+                if (error !== null && error !== undefined) {
+                    this.pending.delete(id);
+                    clearTimeout(timer);
+                    reject(error);
+                }
+            });
+        });
+    }
+    capabilities() {
+        return this.request('capabilities');
+    }
+    /**
+     * `timeoutMs` overrides the client's request timeout for this open alone:
+     * a portal open may be waiting on a person at the computer, which takes
+     * longer than any other request should.
+     */
+    openSession(request, timeoutMs) {
+        return this.request('session.open', {
+            ...(request.source === undefined ? {} : { source: request.source }),
+            permissions: request.permissions,
+            ...(request.maxWidth === undefined ? {} : { max_width: request.maxWidth }),
+            ...(request.maxHeight === undefined ? {} : { max_height: request.maxHeight }),
+            ...(request.bitrateKbps === undefined ? {} : { bitrate_kbps: request.bitrateKbps }),
+            ...(request.maxFps === undefined ? {} : { max_fps: request.maxFps }),
+            ...(request.iceServers === undefined ? {} : { ice_servers: request.iceServers }),
+            ...(request.restoreToken === undefined ? {} : { restore_token: request.restoreToken }),
+            ...(request.ttlSeconds === undefined ? {} : { ttl_seconds: request.ttlSeconds }),
+            ...(request.loopbackTcp === true ? { loopback_tcp: true } : {}),
+        }, timeoutMs);
+    }
+    acceptAnswer(sessionId, generation, sdp) {
+        return this.request('session.description', {
+            session_id: sessionId,
+            generation,
+            description: { type: 'answer', sdp },
+        });
+    }
+    addCandidate(sessionId, generation, candidate, sdpMid, sdpMLineIndex) {
+        return this.request('session.candidate', {
+            session_id: sessionId,
+            generation,
+            candidate,
+            sdp_mid: sdpMid,
+            sdp_m_line_index: sdpMLineIndex,
+        });
+    }
+    metrics() {
+        return this.request('session.metrics');
+    }
+    readClipboard(sessionId) {
+        return this.request('session.clipboard.read', { session_id: sessionId });
+    }
+    writeClipboard(sessionId, text) {
+        return this.request('session.clipboard.write', { session_id: sessionId, text });
+    }
+    closeSession(sessionId) {
+        return this.request('session.close', { session_id: sessionId });
+    }
+    /** Drain notifications received so far, in order. */
+    drainEvents(sessionId) {
+        if (sessionId === undefined)
+            return this.queue.splice(0);
+        const selected = [];
+        for (const event of this.queue.splice(0)) {
+            if (event.params.sessionId === sessionId)
+                selected.push(event);
+            else
+                this.queue.push(event);
+        }
+        return selected;
+    }
+    /**
+     * The engine answers one request at a time, so one it did not answer is
+     * still running inside it — typically a `session.open` waiting on a consent
+     * prompt nobody at the desktop is answering. Everything sent after it would
+     * queue behind it, and a late answer would open a session nobody owns, so
+     * the engine is killed and every waiting request fails with the reason.
+     * Its exit is also what withdraws a pending portal prompt: the portal
+     * closes every request whose sender left the session bus.
+     */
+    abandon(reason) {
+        this.closed = true;
+        for (const [id, pending] of this.pending) {
+            this.pending.delete(id);
+            clearTimeout(pending.timer);
+            pending.reject(reason);
+        }
+        this.child.kill('SIGKILL');
+    }
+    async stop() {
+        // Set even for an engine already abandoned: a caller that stops a client
+        // is done with it, so its exit is no longer news.
+        this.stopping = true;
+        if (this.closed)
+            return;
+        // The documented graceful stop: the engine exits without answering, so
+        // this is sent and the EOF/timeout below still brings a stuck engine
+        // down.
+        void this.request('shutdown').catch(() => undefined);
+        this.closed = true;
+        this.child.stdin.end();
+        const child = this.child;
+        await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                child.kill('SIGTERM');
+                resolve();
+            }, 3000);
+            child.once('exit', () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    }
+}
+/**
+ * A portal `session.open` that runs out of time is waiting on the desktop's
+ * consent prompt, so it is refused as `consent-timeout`: a client can tell the
+ * user to approve screen sharing on the computer rather than show a raw timeout.
+ */
+function timedOut(method, params, timeoutMs) {
+    const message = `the desktop engine did not answer ${method} in ${timeoutMs}ms`;
+    const source = params?.source;
+    if (method === 'session.open' && (source === undefined || source.kind === 'portal')) {
+        return new EngineRefused('consent-timeout', `${message}; screen sharing was not approved on the computer`);
+    }
+    return new Error(message);
+}
+//# sourceMappingURL=engineProcess.js.map

package/dist/engineProcess.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public API of the desktop host engine package.
+ *
+ * The engine itself is a native per-user process; this package is how a
+ * consumer starts it and speaks its local control protocol. Nothing in this
+ * surface refers to any particular application.
+ */
+export * from './protocol.js';
+export { EngineClient, type EngineClientOptions } from './engineProcess.js';
+export { resolveEngine, explainMissingEngine, enginePackageRoot, type ResolvedEngine } from './resolveEngine.js';
+export { Bridge, BRIDGE_PATH, type BridgeOptions } from './bridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC"}