@desklink/host 0.5.14 → 0.5.15

package/README.md

@@ -84,8 +84,12 @@ See the [changelog](https://github.com/umeranjum17/desklink/blob/main/CHANGELOG.
 npm install @desklink/host
 npx desklink-host path            # the engine this install will run
 npx desklink-host capabilities    # what this machine can do right now
+npx desklink-host doctor          # check every Linux requirement before a session
 ```
 
+`doctor` prints one PASS/FAIL line per requirement with the exact free package
+command for each failure, and exits nonzero when one is missing. It starts no session.
+
 On **Linux x64 with glibc 2.36 or newer** — Debian 12, Ubuntu 24.04, Fedora 37
 or later, Arch — that is the whole install. npm also installs the optional
 platform package `@desklink/host-linux-x64-gnu`, which carries the prebuilt
@@ -114,7 +118,8 @@ that asks), Quartz pointer/keyboard events, and
 plain-text NSPasteboard operations. `capabilities` is non-prompting; `session.open`
 requests Screen Recording and, for input, Accessibility consent when needed.
 For persistent grants, install the signed `DesklinkHost.app` at one fixed path.
-Build the engine on the Mac, then run
+Build the engine on the Mac with `cargo build --release` (the packed release CLI, built with
+`DESKLINK_MACOS_CLI`, has no bundle identity and the installer refuses it), then run
 `release/install-mac-app.sh <engine> <absolute path to DesklinkHost.app> [existing signing PEM]`
 from this package. It prefers a usable Developer ID Application or Apple
 Development identity in the login keychain; otherwise it imports the supplied

package/bin/desklink-host.mjs

@@ -2,14 +2,16 @@
 /**
  * CLI for the desktop host engine package.
  *
- * `path` and `capabilities` work without starting a session, so a consumer can
- * tell the user what is wrong before a desktop is opened rather than after.
+ * `path`, `doctor` and `capabilities` work without starting a session, so a
+ * consumer can tell the user what is wrong before a desktop is opened rather
+ * than after.
  * Everything else is forwarded to the engine binary, so the CLI cannot drift
  * from the process protocol it documents.
  */
 import { spawn } from 'node:child_process';
 import { randomBytes } from 'node:crypto';
 import { Bridge } from '../dist/bridge.js';
+import { runDoctor } from '../dist/doctor.js';
 import { EngineClient, windowsEngineStartupError } from '../dist/engineProcess.js';
 import { explainMissingEngine, resolveEngine } from '../dist/resolveEngine.js';
 
@@ -21,12 +23,13 @@ async function main() {
 
 USAGE:
   desklink-host path                  print the engine binary this package would run
+  desklink-host doctor                check every Linux requirement and print the fix for each failure
   desklink-host capabilities          print what this machine can do right now
   desklink-host bridge [--listen H:P] [--token T] [--source portal|x11|display] [--display :0] [--display-id ID] [--reattach-ms MS]
                                       re-serve the engine's protocol over a WebSocket and
                                       print the URL to open; no signaling of your own needed
                                       retain detached sessions for 30000 ms; --reattach-ms 0 closes immediately
-  desklink-host <engine command> ...  run the engine directly (serve, keep, capture-probe, setup-input, version)
+  desklink-host <engine command> ...  run the engine directly (serve, keep, capture-probe, setup-input, diagnose, version)
 
 Set DESKLINK_ENGINE to use an engine built somewhere else (MUXR_DESKLINK_ENGINE still works as a deprecated fallback).`);
         return 0;
@@ -40,6 +43,9 @@ Set DESKLINK_ENGINE to use an engine built somewhere else (MUXR_DESKLINK_ENGINE
         console.log(resolved.command);
         return 0;
     }
+    if (command === 'doctor') {
+        return await runDoctor();
+    }
     if (command === 'bridge') {
         const resolved = resolveEngine();
         if (resolved === null) {

package/dist/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function runDoctor(): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AA0LA,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAyEjD"}

package/dist/doctor.js

@@ -0,0 +1,220 @@
+/**
+ * `desklink-host doctor`: one PASS/FAIL line per requirement a Linux session
+ * needs, and the free package command that fixes a failure.
+ *
+ * The engine answers the machine questions (`diagnose`); this file adds the
+ * package facts and the words a person can act on. It starts no session and
+ * opens no portal, so it is safe to run before choosing a capture source.
+ */
+import { execFile } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { missingSystemLibrary } from './engineProcess.js';
+import { enginePackageRoot, explainMissingEngine, resolveEngine } from './resolveEngine.js';
+const ENGINE_FIX = 'Debian/Ubuntu: `npm install @desklink/host-linux-x64-gnu` (keep optional dependencies); Fedora: the same command.';
+const NODE_FIX = 'Debian/Ubuntu: `curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs`; Fedora: `sudo dnf install nodejs`.';
+const X11_FIX = 'Debian/Ubuntu: `sudo apt install xserver-xorg-core`; Fedora: `sudo dnf install xorg-x11-server-Xorg` (run inside the logged-in desktop session).';
+const WAYLAND_FIX = 'Debian/Ubuntu: `sudo apt install pipewire xdg-desktop-portal xdg-desktop-portal-gnome` (KDE: xdg-desktop-portal-kde); Fedora: `sudo dnf install pipewire xdg-desktop-portal xdg-desktop-portal-gnome`.';
+const INPUT_FIX = 'Wayland Debian/Ubuntu: `sudo apt install xdg-desktop-portal xdg-desktop-portal-gnome`; Fedora: `sudo dnf install xdg-desktop-portal xdg-desktop-portal-gnome`; then run `desklink-host setup-input` once for /dev/uinput.';
+const ENCODER_FIX = 'Debian/Ubuntu: `sudo apt install mesa-va-drivers intel-media-va-driver`; Fedora: `sudo dnf install mesa-va-drivers intel-media-driver` (the engine also fetches Cisco openh264 once on first use when online).';
+const LIBRARY_FIX = 'Debian/Ubuntu: `sudo apt install libpipewire-0.3-0 libxkbcommon0 libevdev2 libstdc++6 libxcursor1 libx11-6 libxext6 libwayland-client0 libfontconfig1 libfreetype6`; Fedora: `sudo dnf install pipewire-libs libxkbcommon libevdev libstdc++ libXcursor libX11 libXext libwayland-client fontconfig freetype`. A complete desktop install usually has these already.';
+const UPDATE_FIX = 'Debian/Ubuntu: `npm install @desklink/host@latest`; Fedora: the same command.';
+const PROBE_FIX = `install the engine first — ${ENGINE_FIX}`;
+function pass(name, detail) {
+    return { status: 'PASS', name, detail };
+}
+function na(name, detail) {
+    return { status: 'N/A', name, detail };
+}
+function fail(name, detail, fix) {
+    return { status: 'FAIL', name, detail, fix };
+}
+function firstLine(text) {
+    return text.split('\n').find((line) => line.trim() !== '')?.trim() ?? '';
+}
+function runEngine(command, args) {
+    return new Promise((done) => {
+        execFile(command, args, { timeout: 40_000, maxBuffer: 8 << 20, windowsHide: true }, (error, stdout, stderr) => {
+            const code = error === null ? 0 : typeof error.code === 'number' ? error.code : null;
+            done({ code, stdout: String(stdout), stderr: String(stderr) });
+        });
+    });
+}
+function readPackage() {
+    try {
+        return JSON.parse(readFileSync(join(enginePackageRoot(), 'package.json'), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** The package asks for a minimum Node version; only `>=` needs to be read. */
+function nodeMeets(current, requirement) {
+    const have = current.split('.').map(Number);
+    for (const clause of requirement.trim().split(/\s+/)) {
+        const match = /^>=\s*v?(\d+)(?:\.(\d+))?(?:\.(\d+))?$/.exec(clause);
+        if (match === null)
+            return false;
+        const want = [Number(match[1]), Number(match[2] ?? 0), Number(match[3] ?? 0)];
+        for (let index = 0; index < 3; index++) {
+            const left = have[index] ?? 0;
+            const right = want[index] ?? 0;
+            if (left !== right) {
+                if (left < right)
+                    return false;
+                break;
+            }
+        }
+    }
+    return true;
+}
+function librariesCheck(resolved, version) {
+    if (resolved === null)
+        return na('libraries', 'needs an engine binary; see the engine line');
+    const missing = missingSystemLibrary(version.stderr);
+    if (missing !== null)
+        return fail('libraries', `cannot load ${missing}`, LIBRARY_FIX);
+    if (version.code === 0)
+        return pass('libraries', "the engine starts with this machine's system libraries");
+    return fail('libraries', `the engine did not run: ${firstLine(version.stderr) || `exit ${version.code ?? 'unexpectedly'}`}`, UPDATE_FIX);
+}
+function x11Check(x11, session, probeError, probeFix) {
+    if (session === 'wayland')
+        return na('x11', 'Wayland session; the portal is the capture path');
+    if (session === 'none')
+        return fail('x11', 'no X11 or Wayland session (DISPLAY and WAYLAND_DISPLAY are unset)', X11_FIX);
+    if (x11 === undefined)
+        return fail('x11', `not checked: ${probeError ?? 'the engine reported no X11 result'}`, probeFix);
+    if (!x11.connected)
+        return fail('x11', `cannot open ${x11.display ?? process.env.DISPLAY ?? 'the display'}: ${x11.error ?? 'unknown error'}`, X11_FIX);
+    const missing = [!x11.shm && 'XShm', !x11.damage && 'XDamage'].filter((value) => value !== false);
+    const size = `${x11.width ?? '?'}x${x11.height ?? '?'}`;
+    if (missing.length > 0) {
+        return fail('x11', `${x11.display ?? 'the display'} ${size} cannot use ${missing.join(' or ')}`, X11_FIX);
+    }
+    return pass('x11', `${x11.display ?? 'the display'} ${size}, XShm + XDamage`);
+}
+function waylandCheck(wayland, session, probeError, probeFix) {
+    if (session !== 'wayland')
+        return na('wayland', session === 'x11' ? 'X11 session; no portal is needed' : 'no Wayland session');
+    if (wayland === undefined)
+        return fail('wayland', `not checked: ${probeError ?? 'the engine reported no Wayland result'}`, probeFix);
+    const missing = [];
+    if (!wayland.screencast)
+        missing.push(`xdg-desktop-portal ScreenCast (${wayland.screencast_error ?? 'not reachable'})`);
+    if (!wayland.pipewire)
+        missing.push('PipeWire socket');
+    if (missing.length > 0)
+        return fail('wayland', `missing ${missing.join(', ')}`, WAYLAND_FIX);
+    return pass('wayland', 'xdg-desktop-portal ScreenCast + PipeWire');
+}
+function inputCheck(report, session, probeError, probeFix) {
+    if (report === null)
+        return fail('input', `not checked: ${probeError ?? 'the engine did not answer'}`, probeFix);
+    if (session === 'x11') {
+        const x11 = report.x11;
+        if (x11?.connected !== true)
+            return fail('input', 'XTest cannot be checked without an X display', X11_FIX);
+        if (x11.xtest !== true)
+            return fail('input', `XTest is missing from ${x11.display ?? 'the display'}`, X11_FIX);
+        return pass('input', `XTest on ${x11.display ?? 'the display'}`);
+    }
+    if (session === 'wayland') {
+        const wayland = report.wayland;
+        const missing = [];
+        if (wayland?.remote_desktop !== true)
+            missing.push(`portal RemoteDesktop (${wayland?.remote_desktop_error ?? 'not reachable'})`);
+        if (report.uinput !== true)
+            missing.push('/dev/uinput is not writable');
+        if (missing.length > 0)
+            return fail('input', `missing ${missing.join(', ')}`, INPUT_FIX);
+        return pass('input', 'portal RemoteDesktop + /dev/uinput');
+    }
+    return fail('input', 'no X11 or Wayland session to inject into', X11_FIX);
+}
+function encoderCheck(report, probeError, probeFix) {
+    if (report === null)
+        return fail('encoder', `not checked: ${probeError ?? 'the engine did not answer'}`, probeFix);
+    if (report.encoder === null || report.encoder === undefined)
+        return fail('encoder', 'no working H.264 encoder', ENCODER_FIX);
+    return pass('encoder', `${report.encoder.name}${report.encoder.hardware ? ' (hardware)' : ''}; VP9 software is always available`);
+}
+function versionCheck(packageVersion, engineVersion, reason, fix) {
+    if (packageVersion === null)
+        return fail('versions', 'cannot read @desklink/host package.json', UPDATE_FIX);
+    if (engineVersion === null)
+        return fail('versions', `@desklink/host ${packageVersion}; engine version unavailable (${reason ?? 'no answer'})`, fix);
+    return pass('versions', `@desklink/host ${packageVersion} · engine ${engineVersion}`);
+}
+export async function runDoctor() {
+    // Linux first: the engine has no `diagnose` on other platforms yet, and a
+    // report built from failed probes there would describe the wrong machine.
+    if (process.platform !== 'linux') {
+        console.log(`FAIL  platform  desklink-host doctor checks Linux only; ${process.platform} was not checked`);
+        return 1;
+    }
+    const checks = [];
+    const packageFacts = readPackage();
+    const packageVersion = typeof packageFacts?.version === 'string' ? packageFacts.version : null;
+    const resolved = resolveEngine();
+    checks.push(resolved === null
+        ? fail('engine', explainMissingEngine() ?? 'the engine binary is not resolvable', ENGINE_FIX)
+        : pass('engine', `${resolved.command} (${resolved.origin})`));
+    const nodeVersion = process.versions.node;
+    const requirement = typeof packageFacts?.engines?.node === 'string' ? packageFacts.engines.node : null;
+    checks.push(requirement !== null && !nodeMeets(nodeVersion, requirement)
+        ? fail('node', `v${nodeVersion} does not meet the package requirement ${requirement}`, NODE_FIX)
+        : pass('node', `v${nodeVersion}${requirement === null ? '' : ` (package needs ${requirement})`}`));
+    let diagnose = null;
+    let engineVersion = null;
+    let probeError = null;
+    let versionResult = { code: null, stdout: '', stderr: '' };
+    if (resolved !== null) {
+        const [version, diagnoseResult] = await Promise.all([
+            runEngine(resolved.command, ['version']),
+            runEngine(resolved.command, ['diagnose']),
+        ]);
+        versionResult = version;
+        if (versionResult.code === 0)
+            engineVersion = versionResult.stdout.trim() || null;
+        if (diagnoseResult.code === 0) {
+            try {
+                diagnose = JSON.parse(diagnoseResult.stdout);
+            }
+            catch {
+                probeError = 'the engine returned unreadable diagnose output';
+            }
+        }
+        else {
+            probeError = firstLine(diagnoseResult.stderr) || `engine diagnose exited ${diagnoseResult.code ?? 'unexpectedly'}`;
+        }
+        if (engineVersion === null && typeof diagnose?.version === 'string')
+            engineVersion = diagnose.version;
+    }
+    checks.push(librariesCheck(resolved, versionResult));
+    const session = diagnose?.session
+        ?? (process.env.WAYLAND_DISPLAY !== undefined && process.env.WAYLAND_DISPLAY !== ''
+            ? 'wayland'
+            : process.env.DISPLAY !== undefined && process.env.DISPLAY !== ''
+                ? 'x11'
+                : 'none');
+    const missingLibrary = missingSystemLibrary(versionResult.stderr);
+    const probeFix = resolved === null ? PROBE_FIX : missingLibrary !== null ? LIBRARY_FIX : UPDATE_FIX;
+    checks.push(x11Check(diagnose?.x11 ?? undefined, session, probeError, probeFix));
+    checks.push(waylandCheck(diagnose?.wayland ?? undefined, session, probeError, probeFix));
+    checks.push(inputCheck(diagnose, session, probeError, probeFix));
+    checks.push(encoderCheck(diagnose, probeError, probeFix));
+    checks.push(versionCheck(packageVersion, engineVersion, resolved === null ? 'no engine binary' : probeError, probeFix));
+    for (const check of checks) {
+        console.log(`${check.status.padEnd(4)}  ${check.name.padEnd(8)}  ${check.detail}`);
+        if (check.fix !== undefined)
+            console.log(`      fix       ${check.fix}`);
+    }
+    const failed = checks.filter((check) => check.status === 'FAIL').length;
+    const passed = checks.filter((check) => check.status === 'PASS').length;
+    const skipped = checks.length - failed - passed;
+    console.log('');
+    console.log(`${checks.length} checks: ${passed} passed, ${failed} failed, ${skipped} not applicable`);
+    return failed === 0 ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/engineProcess.d.ts

@@ -1,4 +1,9 @@
 import { EngineRefused, type EngineCapabilities, type EngineEvent, type OpenedSession, type PointRequest, type OpenSessionRequest, type SessionMetrics } from './protocol.js';
+/**
+ * The library a Linux engine could not load, from the linker's own message, or
+ * null when the engine started or stopped for another reason.
+ */
+export declare function missingSystemLibrary(stderr: string): string | null;
 export declare function windowsEngineStartupError(code: number | null, error?: Error): EngineRefused | null;
 export interface EngineClientOptions {
     /**

package/dist/engineProcess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engineProcess.d.ts","sourceRoot":"","sources":["../src/engineProcess.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,aAAa,EAEb,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACtB,MAAM,eAAe,CAAC;AAEvB,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,aAAa,GAAG,IAAI,CASlG;AAQD,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,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;IAiCP,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;IA4BxB,OAAO,CAAC,UAAU;IAkClB;;;;;;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;IAgBpG,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI3C;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmBpF,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,6EAA6E;IAC7E,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAW5E,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,OAAO,CAAC,mBAAmB;IAM3B;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO;IAUT,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB9B"}
+{"version":3,"file":"engineProcess.d.ts","sourceRoot":"","sources":["../src/engineProcess.ts"],"names":[],"mappings":"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"}

package/dist/engineProcess.js

@@ -2,6 +2,19 @@ import { spawn, spawnSync } from 'node:child_process';
 import { appendFileSync } from 'node:fs';
 import { createInterface } from 'node:readline';
 import { EngineRefused, PROTOCOL_VERSION, } from './protocol.js';
+/** The system libraries the prebuilt Linux engine loads at start. */
+const LINUX_SYSTEM_LIBRARIES = [
+    'libpipewire-0.3.so.0', 'libxkbcommon.so.0', 'libevdev.so.2', 'libstdc++.so.6',
+    'libXcursor.so.1', 'libX11.so.6', 'libXext.so.6', 'libwayland-client.so.0', 'libfontconfig.so.1', 'libfreetype.so.6',
+];
+/**
+ * The library a Linux engine could not load, from the linker's own message, or
+ * null when the engine started or stopped for another reason.
+ */
+export function missingSystemLibrary(stderr) {
+    const missing = /error while loading shared libraries: ([^:\s]+): cannot open shared object file/.exec(stderr)?.[1];
+    return missing !== undefined && LINUX_SYSTEM_LIBRARIES.includes(missing) ? missing : null;
+}
 export function windowsEngineStartupError(code, error) {
     if (process.platform !== 'win32')
         return null;
@@ -64,11 +77,8 @@ export class EngineClient {
     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',
-                'libXcursor.so.1', 'libX11.so.6', 'libXext.so.6', 'libwayland-client.so.0', 'libfontconfig.so.1', 'libfreetype.so.6',
-            ].includes(missing)) {
+            const missing = missingSystemLibrary(probe.stderr ?? '');
+            if (missing !== null) {
                 throw new EngineRefused('missing-system-library', `missing system library: ${missing}`);
             }
         }

package/dist/engineProcess.js.map

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

package/docs/PROTOCOL.md

@@ -480,7 +480,7 @@ The session ended on the engine's side; there is nothing further to drain.
 | `code` | Meaning | A client should |
 |---|---|---|
 | `transport` | The path to the client's peer was lost (ICE `failed`, or the track refused a frame) | open a new session with fresh authority; the desktop is still available |
-| `lease` | The session's `ttl_seconds` ran out | end; the grant is spent |
+| `lease` | The session's `ttl_seconds` ran out | open a new session with fresh authority at once; this grant is spent but the desktop is still available (`@desklink/react-native`'s hook does; a client that ignores the event just goes dead) |
 | `error` | The engine could not keep serving it, such as an encoder refusing a frame | end and report |
 
 A session the consumer closes or replaces (`session.close`, a new

package/engine/Cargo.lock

@@ -536,7 +536,7 @@ checksum = "7cd812cc2bc1d69d4764bd80df88b4317eaef9e773c75226407d9bc0876b211c"
 
 [[package]]
 name = "desklink-host"
-version = "0.5.14"
+version = "0.5.15"
 dependencies = [
  "anyhow",
  "ashpd",

package/engine/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "desklink-host"
-version = "0.5.14"
+version = "0.5.15"
 edition = "2021"
 rust-version = "1.97.1"
 license = "Apache-2.0"

package/engine/native/mac_stream.mm

@@ -118,7 +118,10 @@ extern "C" void *dl_mac_stream_start(uint32_t display_id, size_t width, size_t h
         config.width = width;
         config.height = height;
         config.pixelFormat = kCVPixelFormatType_32BGRA;
-        config.minimumFrameInterval = CMTimeMake(1, fps ? fps : 30);
+        // Asking for exactly 1/fps makes ScreenCaptureKit drop any refresh that lands a hair early and hold the rest to its
+        // own timer, a few ms late (a 60 Hz display delivered 52-58 fps). 90% of the interval lets every refresh through;
+        // the encoder cadence still caps the stream at `fps`.
+        config.minimumFrameInterval = CMTimeMake(9, (fps ? fps : 30) * 10);
         config.queueDepth = 3;
         config.showsCursor = YES;
         config.capturesAudio = NO;

package/engine/src/diagnose.rs

@@ -0,0 +1,99 @@
+//! `desklink-host diagnose`: the machine facts behind `desklink-host doctor`.
+//!
+//! Every check here is a question, not an action: the X server is connected to
+//! and read, the portal's version properties are fetched, and an encoder codes
+//! one blank 320x240 frame. Nothing opens a portal session, asks for consent,
+//! captures a desktop or creates an input device. `doctor` in the Node CLI adds
+//! the package facts and decides which answer a person needs to act on.
+
+use anyhow::Result;
+use serde_json::{json, Value};
+
+pub async fn run() -> Result<()> {
+    let session = if std::env::var_os("WAYLAND_DISPLAY").is_some() {
+        "wayland"
+    } else if std::env::var_os("DISPLAY").is_some() {
+        "x11"
+    } else {
+        "none"
+    };
+    let x11 = if session == "x11" { probe_x11() } else { Value::Null };
+    let wayland = if session == "wayland" {
+        probe_wayland().await
+    } else {
+        Value::Null
+    };
+    // `prepare` rather than `probe`: on a machine with no hardware encoder the
+    // engine fetches Cisco's openh264 once at first need, so that is the answer
+    // a session would get. It is a bounded download, not a session or a prompt.
+    let encoder = crate::h264::prepare().map(|info| {
+        json!({ "name": info.encoder, "hardware": info.hardware })
+    });
+    println!(
+        "{}",
+        serde_json::to_string(&json!({
+            "version": env!("CARGO_PKG_VERSION"),
+            "session": session,
+            "x11": x11,
+            "wayland": wayland,
+            "encoder": encoder,
+            "uinput": crate::input::probe().is_ok(),
+        }))?
+    );
+    Ok(())
+}
+
+/// Connect exactly as the capture backend would, then report the two
+/// extensions it wants and XTest for input.
+fn probe_x11() -> Value {
+    match crate::x11::X11Desktop::connect(None) {
+        Ok(desktop) => json!({
+            "connected": true,
+            "display": std::env::var("DISPLAY").ok(),
+            "width": desktop.width,
+            "height": desktop.height,
+            "shm": desktop.capture_path() == "shm",
+            "damage": desktop.damage_armed(),
+            "xtest": desktop.input_available(),
+        }),
+        Err(error) => json!({ "connected": false, "error": format!("{error:#}") }),
+    }
+}
+
+/// Ask the session portal whether its ScreenCast and RemoteDesktop interfaces
+/// are there. Building these proxies reads the interface's `version` property;
+/// it creates no session and cannot prompt. The PipeWire socket is the capture
+/// backend's own half of a screen share.
+async fn probe_wayland() -> Value {
+    let screencast = ashpd::desktop::screencast::Screencast::new().await;
+    let remote_desktop = ashpd::desktop::remote_desktop::RemoteDesktop::new().await;
+    json!({
+        "screencast": screencast.is_ok(),
+        "screencast_error": screencast.err().map(|error| error.to_string()),
+        "remote_desktop": remote_desktop.is_ok(),
+        "remote_desktop_error": remote_desktop.err().map(|error| error.to_string()),
+        "pipewire": pipewire_socket(),
+    })
+}
+
+/// Whether the session PipeWire socket is present. A portal screencast hands
+/// back a remote on this socket, so a portal without one cannot deliver frames.
+fn pipewire_socket() -> bool {
+    let runtime = std::env::var_os("PIPEWIRE_RUNTIME_DIR")
+        .filter(|path| !path.is_empty())
+        .or_else(|| std::env::var_os("XDG_RUNTIME_DIR"))
+        .map(std::path::PathBuf::from);
+    let Some(directory) = runtime else {
+        return false;
+    };
+    let remote = std::env::var("PIPEWIRE_REMOTE")
+        .ok()
+        .filter(|remote| !remote.is_empty())
+        .unwrap_or_else(|| String::from("pipewire-0"));
+    let remote = std::path::Path::new(&remote);
+    if remote.is_absolute() {
+        remote.exists()
+    } else {
+        directory.join(remote).exists()
+    }
+}

package/engine/src/mac.rs

@@ -592,6 +592,152 @@ fn capture_probe(seconds: u64) -> Result<Value, String> {
     )
 }
 
+/// One real ScreenCaptureKit screenshot of a screen-point rectangle, converted
+/// to packed BGRA with its row stride. `capture-probe --frame/--record` uses it
+/// to keep a real desktop view for proof; it is not a render.
+fn capture_rect_bgra(area: CGRect) -> Result<(Vec<u8>, usize, usize, usize), String> {
+    use block2::RcBlock;
+    use objc2_core_foundation::{
+        CGPoint as NativePoint, CGRect as NativeRect, CGSize as NativeSize,
+    };
+    use objc2_screen_capture_kit::SCScreenshotManager;
+
+    let rect = NativeRect {
+        origin: NativePoint {
+            x: area.origin.x,
+            y: area.origin.y,
+        },
+        size: NativeSize {
+            width: area.size.width,
+            height: area.size.height,
+        },
+    };
+    let ready = Arc::new((
+        Mutex::new(None::<Result<(Vec<u8>, usize, usize, usize), String>>),
+        Condvar::new(),
+    ));
+    let callback_state = ready.clone();
+    let callback = RcBlock::new(
+        move |image: *mut objc2_core_graphics::CGImage, error: *mut objc2_foundation::NSError| {
+            let frame = if !error.is_null() || image.is_null() {
+                Err(String::from(
+                    "ScreenCaptureKit returned an error or no image",
+                ))
+            } else {
+                let image = unsafe { &*image };
+                let width = objc2_core_graphics::CGImage::width(Some(image));
+                let height = objc2_core_graphics::CGImage::height(Some(image));
+                let mut length = 0usize;
+                let mut stride = 0usize;
+                let pointer = unsafe {
+                    desklink_image_bgra(
+                        image as *const _ as *const c_void,
+                        &mut length,
+                        &mut stride,
+                    )
+                };
+                if pointer.is_null() || width == 0 || height == 0 {
+                    Err(String::from(
+                        "ScreenCaptureKit image could not be converted to BGRA",
+                    ))
+                } else {
+                    let pixels = unsafe { std::slice::from_raw_parts(pointer, length) }.to_vec();
+                    unsafe { libc::free(pointer.cast()) };
+                    Ok((pixels, width, height, stride))
+                }
+            };
+            let (lock, wake) = &*callback_state;
+            if let Ok(mut result) = lock.lock() {
+                *result = Some(frame);
+                wake.notify_one();
+            }
+        },
+    );
+    unsafe {
+        SCScreenshotManager::captureImageInRect_completionHandler(rect, Some(&callback));
+    }
+    let deadline = Instant::now() + Duration::from_secs(5);
+    let (lock, wake) = &*ready;
+    let mut result = lock
+        .lock()
+        .map_err(|_| String::from("capture lock poisoned"))?;
+    while result.is_none() && Instant::now() < deadline {
+        let (next, _) = wake
+            .wait_timeout(result, deadline.saturating_duration_since(Instant::now()))
+            .map_err(|_| String::from("capture wait failed"))?;
+        result = next;
+    }
+    result
+        .take()
+        .unwrap_or_else(|| Err(String::from("ScreenCaptureKit timed out")))
+}
+
+/// Write one real desktop frame, or a short real desktop sequence, to raw BGRA
+/// files. The proof harness turns these into stills and recordings; no pixels
+/// are ever rendered by the engine itself.
+fn capture_rects(
+    seconds: u64,
+    frame_path: Option<String>,
+    record_dir: Option<String>,
+    fps: u64,
+    area: Option<CGRect>,
+) -> Result<Value, String> {
+    let area = area.unwrap_or_else(|| unsafe { CGDisplayBounds(CGMainDisplayID()) });
+    let rect = serde_json::json!({
+        "x": area.origin.x, "y": area.origin.y,
+        "width": area.size.width, "height": area.size.height
+    });
+    let mut written = Vec::new();
+    let mut dimensions = None;
+    if let Some(path) = frame_path {
+        let (pixels, width, height, stride) = capture_rect_bgra(area)?;
+        std::fs::write(&path, &pixels)
+            .map_err(|error| format!("could not write {path}: {error}"))?;
+        dimensions = Some((width, height));
+        written.push(serde_json::json!({
+            "kind": "frame", "path": path, "width": width, "height": height,
+            "stride": stride, "format": "bgra"
+        }));
+    }
+    if let Some(dir) = record_dir {
+        std::fs::create_dir_all(&dir)
+            .map_err(|error| format!("could not create {dir}: {error}"))?;
+        let fps = fps.clamp(1, 30);
+        let count = seconds.saturating_mul(fps).max(1);
+        for index in 0..count {
+            let (pixels, width, height, stride) = capture_rect_bgra(area)?;
+            dimensions = Some((width, height));
+            let path = std::path::Path::new(&dir).join(format!("frame-{index:04}.bgra"));
+            std::fs::write(&path, &pixels)
+                .map_err(|error| format!("could not write {}: {error}", path.display()))?;
+            if index == 0 {
+                written.push(serde_json::json!({
+                    "kind": "record", "dir": dir, "width": width, "height": height,
+                    "stride": stride, "format": "bgra", "fps": fps, "frames": count
+                }));
+            }
+            std::thread::sleep(Duration::from_millis(1000 / fps));
+        }
+        let manifest = serde_json::json!({
+            "format": "bgra", "fps": fps, "frames": count,
+            "width": dimensions.map(|d| d.0), "height": dimensions.map(|d| d.1),
+            "rect": rect
+        });
+        std::fs::write(
+            std::path::Path::new(&dir).join("manifest.json"),
+            serde_json::to_vec_pretty(&manifest).unwrap(),
+        )
+        .map_err(|error| format!("could not write manifest: {error}"))?;
+    }
+    Ok(serde_json::json!({
+        "source": {
+            "kind": "screencapturekit", "rect": rect.clone(),
+            "width": dimensions.map(|d| d.0), "height": dimensions.map(|d| d.1)
+        },
+        "written": written
+    }))
+}
+
 pub fn run() -> i32 {
     let mut args = std::env::args().skip(1);
     let command = args.next().unwrap_or_else(|| "help".into());
@@ -600,6 +746,7 @@ pub fn run() -> i32 {
         "serve"
             | "capabilities"
             | "capture-probe"
+            | "warp-pointer"
             | "indicator-demo"
             | "axi-record"
             | "setup-input"
@@ -668,6 +815,46 @@ pub fn run() -> i32 {
             let Some(path) = args.next() else { eprintln!("axi-record requires an output path"); return 2; };
             if let Err(error) = record_agent_overlay(&path) { eprintln!("axi-record: {error}"); return 1; }
         }
+        "warp-pointer" => {
+            let x = args.next().and_then(|value| value.parse::<i64>().ok());
+            let y = args.next().and_then(|value| value.parse::<i64>().ok());
+            let display = args
+                .next()
+                .and_then(|value| value.parse::<u32>().ok())
+                .unwrap_or_else(|| unsafe { CGMainDisplayID() });
+            let (Some(x), Some(y)) = (x, y) else {
+                eprintln!("usage: desklink-host warp-pointer <source x> <source y> [display]");
+                return 2;
+            };
+            let mode = unsafe { CGDisplayCopyDisplayMode(display) };
+            let (width, height) = if mode.is_null() {
+                (
+                    unsafe { CGDisplayPixelsWide(display) },
+                    unsafe { CGDisplayPixelsHigh(display) },
+                )
+            } else {
+                let pixels = unsafe {
+                    (
+                        CGDisplayModeGetPixelWidth(mode),
+                        CGDisplayModeGetPixelHeight(mode),
+                    )
+                };
+                unsafe { CGDisplayModeRelease(mode) };
+                pixels
+            };
+            let (width, height) = (width as i32, height as i32);
+            match crate::input::InputDevices::create_for_display(width, height, display) {
+                Ok(mut devices) => {
+                    devices.move_absolute(x, y);
+                    std::thread::sleep(Duration::from_millis(200));
+                    println!("{}", json!({"warped": true, "x": x, "y": y, "display": display}));
+                }
+                Err(error) => {
+                    eprintln!("warp-pointer: {error}");
+                    return 1;
+                }
+            }
+        }
         #[cfg(all(desklink_vpx, not(desklink_macos_cli)))]
         "indicator-demo" => {
             let display = args.next().and_then(|value| value.parse().ok()).unwrap_or(0);
@@ -679,15 +866,51 @@ pub fn run() -> i32 {
         "capture-probe" => {
             let mut seconds = 3;
             let mut output_path = None;
+            let mut frame_path = None;
+            let mut record_dir = None;
+            let mut fps = 10;
+            let mut area = None;
             while let Some(argument) = args.next() {
-                if argument == "--out" {
-                    output_path = args.next();
-                } else if let Ok(value) = argument.parse() {
-                    seconds = value;
+                match argument.as_str() {
+                    "--out" => output_path = args.next(),
+                    "--frame" => frame_path = args.next(),
+                    "--record" => record_dir = args.next(),
+                    "--fps" => {
+                        fps = args.next().and_then(|value| value.parse().ok()).unwrap_or(10);
+                    }
+                    "--rect" => {
+                        let parts: Vec<f64> = args
+                            .next()
+                            .unwrap_or_default()
+                            .split(',')
+                            .filter_map(|value| value.trim().parse().ok())
+                            .collect();
+                        if parts.len() == 4 {
+                            area = Some(CGRect {
+                                origin: CGPoint {
+                                    x: parts[0],
+                                    y: parts[1],
+                                },
+                                size: CGSize {
+                                    width: parts[2],
+                                    height: parts[3],
+                                },
+                            });
+                        }
+                    }
+                    other => {
+                        if let Ok(value) = other.parse() {
+                            seconds = value;
+                        }
+                    }
                 }
             }
             let result = if unsafe { CGPreflightScreenCaptureAccess() } {
-                capture_probe(seconds)
+                if frame_path.is_some() || record_dir.is_some() {
+                    capture_rects(seconds, frame_path, record_dir, fps, area)
+                } else {
+                    capture_probe(seconds)
+                }
             } else {
                 request_screen_capture_content().and_then(|_| Err(format!("capture-permission: allow {} in System Settings › Privacy & Security › Screen & System Audio Recording, then reconnect", tcc_responsible_app_name())))
             };
@@ -722,7 +945,7 @@ pub fn run() -> i32 {
                 println!("If the Input Monitoring alert did not open, allow {} in System Settings › Privacy & Security › Input Monitoring.", tcc_responsible_app_name());
             }
         }
-        _ => println!("desklink-host {}\nUSAGE: desklink-host [serve|capabilities|capture-probe|encode-probe|setup-input|version]", env!("CARGO_PKG_VERSION")),
+        _ => println!("desklink-host {}\nUSAGE: desklink-host [serve|capabilities|capture-probe|warp-pointer|encode-probe|setup-input|version]", env!("CARGO_PKG_VERSION")),
     }
     0
 }

package/engine/src/main.rs

@@ -26,6 +26,8 @@ mod clipboard;
 mod clipboard;
 #[cfg(any(target_os = "linux", target_os = "macos", target_os = "windows"))]
 mod convert;
+#[cfg(target_os = "linux")]
+mod diagnose;
 #[cfg(any(target_os = "linux", all(target_os = "macos", desklink_vpx)))]
 mod cursor;
 #[cfg(target_os = "linux")]
@@ -245,6 +247,8 @@ fn main() {
             );
             0
         }
+        #[cfg(target_os = "linux")]
+        "diagnose" => report(runtime.block_on(diagnose::run())),
         "serve" => report(runtime.block_on(serve())),
         "keep" => keeper::command(&args[1..]),
         "capture-probe" => report(runtime.block_on(probe(
@@ -293,6 +297,7 @@ USAGE:
                                  keep one private X screen: kiosk geometry, focus,
                                  and a JSON-lines window report on stdout
   desklink-host capabilities     print what this machine can do right now
+  desklink-host diagnose         print the non-prompting checks behind `desklink-host doctor`
   desklink-host capture-probe [seconds] [display]
                                  capture frames and report the stream; with a
                                  display argument it reads that X display's root

package/engine/src/session.rs

@@ -208,9 +208,9 @@ unsafe extern "C" {
 }
 
 /// The X11 agent cue is a real window, so root grabs contain it. Restore
-/// exactly the pixels the announced cues cover (one pixel wider for edge
-/// rounding) from the last clean frame; everything else, including what lies
-/// inside the halo, stays live.
+/// the pixels the announced cues cover (with a small margin for edge rounding)
+/// from the last clean frame; everything else, including what lies inside the
+/// halo, stays live.
 #[cfg(target_os = "linux")]
 struct CueMask {
     cues: crate::indicator::Cues,
@@ -230,18 +230,18 @@ impl CueMask {
             .unwrap_or_default()
     }
 
-    /// `before` is the snapshot taken when the grab started: with the states
-    /// announced by the time it returned, it covers whatever the grab saw.
+    /// `announced` is the snapshot taken after the grab: the helper announces
+    /// every state before drawing it, so this covers whatever the grab saw.
     fn apply(
         &mut self,
         raw: &mut [u8],
         width: usize,
         height: usize,
-        mut cues: Vec<crate::indicator::Cue>,
+        mut announced: Vec<crate::indicator::Cue>,
     ) {
-        cues.extend(self.snapshot());
+        announced.extend(self.snapshot());
         if let Some(clean) = self.clean.as_ref().filter(|clean| clean.len() == raw.len()) {
-            for cue in cues {
+            for cue in &announced {
                 let side = cue.size as usize + 2;
                 let mut covered = vec![false; side * side];
                 for row in 0..cue.size as usize {
@@ -260,16 +260,26 @@ impl CueMask {
                         } != 0;
                     }
                 }
-                for row in 0..side {
-                    for col in 0..side {
-                        let near =
-                            |r: usize, c: usize| r < side && c < side && covered[r * side + c];
-                        if !(near(row, col)
-                            || near(row.wrapping_sub(1), col)
-                            || near(row + 1, col)
-                            || near(row, col.wrapping_sub(1))
-                            || near(row, col + 1))
-                        {
+                // Restore the cue's pixels and one pixel around them. The
+                // shaped window's edge rounds differently from the coverage
+                // test; the margin keeps its anti-aliased edge out of the
+                // picture without covering live pixels inside the halo.
+                let margin = 1isize;
+                for row in -margin..side as isize + margin {
+                    for col in -margin..side as isize + margin {
+                        let near = |r: isize, c: isize| {
+                            (-margin..=margin).any(|dr| {
+                                (-margin..=margin).any(|dc| {
+                                    let (rr, cc) = (r + dr, c + dc);
+                                    rr >= 0
+                                        && cc >= 0
+                                        && rr < side as isize
+                                        && cc < side as isize
+                                        && covered[rr as usize * side + cc as usize]
+                                })
+                            })
+                        };
+                        if !near(row, col) {
                             continue;
                         }
                         let (x, y) = (cue.x - 1 + col as i64, cue.y - 1 + row as i64);
@@ -282,7 +292,29 @@ impl CueMask {
                 }
             }
         }
-        self.clean = Some(raw.to_vec());
+        // Keep the pre-cue baseline inside each cue's bounding box. Restoring
+        // only the announced shape can leave an anti-aliased edge pixel in the
+        // frame; if that pixel became the baseline, every later cue over it
+        // would restore the old cue instead of the desktop. Outside the boxes
+        // the grab is live and becomes the next baseline.
+        self.clean = Some(match self.clean.take() {
+            Some(old) if old.len() == raw.len() && !announced.is_empty() => {
+                let mut next = raw.to_vec();
+                for cue in &announced {
+                    let x0 = (cue.x - 4).max(0) as usize;
+                    let y0 = (cue.y - 4).max(0) as usize;
+                    let x1 = ((cue.x + cue.size + 4).max(0) as usize).min(width);
+                    let y1 = ((cue.y + cue.size + 4).max(0) as usize).min(height);
+                    for y in y0..y1 {
+                        let start = (y * width + x0) * 4;
+                        let end = (y * width + x1) * 4;
+                        next[start..end].copy_from_slice(&old[start..end]);
+                    }
+                }
+                next
+            }
+            _ => raw.to_vec(),
+        });
     }
 }
 
@@ -371,11 +403,17 @@ fn select_x11(
                     let grabbed = Instant::now();
                     #[cfg(target_os = "linux")]
                     let frame = {
-                        let before = mask.as_ref().map(CueMask::snapshot);
                         let mut desktop = lock(&desktop);
                         desktop.capture_raw().and_then(|mut raw| {
-                            if let (Some(mask), Some(before)) = (mask.as_mut(), before) {
-                                mask.apply(&mut raw, width as usize, height as usize, before);
+                            if let Some(mask) = mask.as_mut() {
+                                // The helper announces each cue before it draws
+                                // it, so reading the feed after the grab covers
+                                // every state the grab could have seen. Reading
+                                // it before the grab would miss a cue drawn
+                                // during the grab and bake it into the clean
+                                // baseline.
+                                let after = mask.snapshot();
+                                mask.apply(&mut raw, width as usize, height as usize, after);
                             }
                             Ok((desktop.convert(&raw, max_width, max_height)?, raw))
                         })

package/examples/reference-client.html

@@ -223,13 +223,26 @@ const named = {
   Delete: 'Delete', Home: 'Home', End: 'End', PageUp: 'PageUp', PageDown: 'PageDown',
   Control: 'Control', Shift: 'Shift', Alt: 'Alt', Meta: 'Meta',
 };
+// A shortcut (Control or Meta plus one character) is a key with its modifiers,
+// not text: typed text is applied without them, so select-all, copy and paste
+// would otherwise arrive as plain letters.
+function chord(event, down) {
+  if (composing || !(event.ctrlKey || event.metaKey) || event.key.length !== 1) return false;
+  event.preventDefault();
+  const modifiers = [['ctrlKey', 'Control'], ['altKey', 'Alt'], ['shiftKey', 'Shift'], ['metaKey', 'Meta']]
+    .filter(([flag]) => event[flag]).map(([, name]) => name);
+  control({ kind: 'key', character: event.key, down, modifiers });
+  return true;
+}
 keyboard.addEventListener('keydown', (event) => {
+  if (chord(event, true)) return;
   const name = named[event.key];
   if (composing || name === undefined) return;
   event.preventDefault();
   control({ kind: 'key', name, down: true });
 });
 keyboard.addEventListener('keyup', (event) => {
+  if (chord(event, false)) return;
   const name = named[event.key];
   if (composing || name === undefined) return;
   event.preventDefault();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@desklink/host",
-    "version": "0.5.14",
+    "version": "0.5.15",
     "license": "Apache-2.0",
     "repository": {
         "type": "git",
@@ -53,7 +53,7 @@
         "desklink"
     ],
     "optionalDependencies": {
-        "@desklink/host-linux-x64-gnu": "0.5.14",
-        "@desklink/host-darwin-arm64": "0.5.14"
+        "@desklink/host-linux-x64-gnu": "0.5.15",
+        "@desklink/host-darwin-arm64": "0.5.15"
     }
 }