@livedesk/client 0.1.134 → 0.1.136

package/README.md

@@ -1,81 +1,81 @@
-# LiveDesk Client
-
-Run a direct LiveDesk remote client from a controlled computer.
-
-```powershell
-npx -y --prefer-online livedesk@latest client
-npx -y --prefer-online livedesk@latest client 3
-```
-
-`@livedesk/client` is the internal direct package and remains available for
-advanced diagnostics. The public command above keeps Hub and client versions
-aligned.
-
-The default flow opens Google sign-in, waits for the active LiveDesk Hub
-published by the same account, and connects locally. If the Hub is not
-ready yet, the client keeps checking every 5 seconds instead of exiting. If a
-connected Hub is replaced, the launcher also leaves the stale endpoint and
-discovers the newly published Hub without another Google login. Omit the number
-for first-available placement, or pass `1` to `999` to pin this machine to a
-screen wall slot.
-
-On Windows, check **Start with Windows** on the connection page to reconnect this
-client automatically after reboot. The startup entry reuses the saved Google
-session and only opens the connection page again if sign-in is needed.
-
-On the Hub computer, open the LiveDesk dashboard and sign in first. The
-dashboard keeps its local Hub address and private pair token refreshed in the
-LiveDesk Supabase registry for the signed-in account.
-
-Supabase Auth must allow the CLI callback URL:
-
-```text
-http://127.0.0.1:5198/callback
-```
-
-If you use a custom port, run `npx -y --prefer-online livedesk@latest client --auth-port 5200` and add
-the matching callback URL to Supabase Auth redirect URLs.
-
-The client registers the device, sends status heartbeats, can return
-Hub-requested thumbnails, can stream a focused view-only live screen, and
-can receive safe task-only instructions. The C# RemoteFast engine also supports
-keyboard/mouse control on Windows, macOS, and Linux/X11, file transfer, and
-Windows system-audio loopback playback. macOS control requires Accessibility
-permission for the terminal app that started LiveDesk; screen streaming and
-system-audio capture require Screen Recording permission. LiveDesk checks these
-permissions without opening repeated system dialogs and prints the matching
-System Settings path when access is missing; after granting access, restart the
-client. When file transfer is enabled by the Hub, received files are saved
-to `Desktop/LiveDeskFiles` unless the Hub sets another destination folder.
-
-By default, the launcher uses the packaged C# RemoteFast engine when supported.
-It falls back to the Node engine for AI assist or when a compatible RemoteFast
-runtime is unavailable. Windows, macOS, and Linux all try RemoteFast first so
-the Hub can request the Mode 3 hardware video path when it is available.
-The launcher also includes a prebuilt ffmpeg executable through
-`@ffmpeg-installer/ffmpeg` and passes it to RemoteFast automatically. Set
-`LIVEDESK_FFMPEG` to override that path. If you need LGPL-only distribution,
-point `LIVEDESK_FFMPEG` at a verified LGPL ffmpeg build before shipping.
-
-Useful flags:
-
-```powershell
-npx -y --prefer-online livedesk@latest client 3
-npx -y --prefer-online livedesk@latest client --no-thumbnail
-npx -y --prefer-online livedesk@latest client --no-live
-npx -y --prefer-online livedesk@latest client --no-audio
-npx -y --prefer-online livedesk@latest client --files-dir "D:\LiveDeskFiles"
-npx -y --prefer-online livedesk@latest client --engine node
-npx -y --prefer-online livedesk@latest client --engine fast --trace-frames
-npx -y --prefer-online livedesk@latest client --auth-port 5200
-npx -y --prefer-online livedesk@latest client --logout
-```
-
-Frame pipeline roadmap:
-
-- Mode 1: `mode1-jpeg` - current test path using screen capture, resize, and JPEG binary frames.
-- Mode 2: `mode2-lzo` - cross-platform wall path using independent RGB565LE frames capped at 320x180 and compressed as LZO1X blocks. The wall defaults to 8 fps. macOS and Linux keep one persistent local capture helper per client process. Legacy `mode2-lz4` settings migrate to this mode.
-- Mode 3: `mode3-h264-hw` - OS-specific hardware H.264 path. Windows tries Media Foundation/NVENC/QSV/AMF, macOS prefers ScreenCaptureKit plus VideoToolbox, and Linux tries NVENC/VAAPI/QSV. macOS emits one startup key frame and then an approximately one-second GOP. The launcher uses bundled ffmpeg for fallback paths unless `LIVEDESK_FFMPEG` points to a custom binary. On macOS, set `LIVEDESK_FFMPEG_AVFOUNDATION_INPUT` only when the ScreenCaptureKit helper is unavailable and the AVFoundation fallback input is not `1:none`.
-
-Legacy mode names such as `remote-fast` and `remote-quality` are treated as
-Mode 1 aliases.
+# LiveDesk Client
+
+Run a direct LiveDesk remote client from a controlled computer.
+
+```powershell
+npx -y --prefer-online livedesk@latest client
+npx -y --prefer-online livedesk@latest client 3
+```
+
+`@livedesk/client` is the internal direct package and remains available for
+advanced diagnostics. The public command above keeps Hub and client versions
+aligned.
+
+The default flow opens Google sign-in, waits for the active LiveDesk Hub
+published by the same account, and connects locally. If the Hub is not
+ready yet, the client keeps checking every 5 seconds instead of exiting. If a
+connected Hub is replaced, the launcher also leaves the stale endpoint and
+discovers the newly published Hub without another Google login. Omit the number
+for first-available placement, or pass `1` to `999` to pin this machine to a
+screen wall slot.
+
+On Windows, check **Start with Windows** on the connection page to reconnect this
+client automatically after reboot. The startup entry reuses the saved Google
+session and only opens the connection page again if sign-in is needed.
+
+On the Hub computer, open the LiveDesk dashboard and sign in first. The
+dashboard keeps its local Hub address and private pair token refreshed in the
+LiveDesk Supabase registry for the signed-in account.
+
+Supabase Auth must allow the CLI callback URL:
+
+```text
+http://127.0.0.1:5198/callback
+```
+
+If you use a custom port, run `npx -y --prefer-online livedesk@latest client --auth-port 5200` and add
+the matching callback URL to Supabase Auth redirect URLs.
+
+The client registers the device, sends status heartbeats, can return
+Hub-requested thumbnails, can stream a focused view-only live screen, and
+can receive safe task-only instructions. The C# RemoteFast engine also supports
+keyboard/mouse control on Windows, macOS, and Linux/X11, file transfer, and
+Windows system-audio loopback playback. macOS control requires Accessibility
+permission for the terminal app that started LiveDesk; screen streaming and
+system-audio capture require Screen Recording permission. LiveDesk checks these
+permissions without opening repeated system dialogs and prints the matching
+System Settings path when access is missing; after granting access, restart the
+client. When file transfer is enabled by the Hub, received files are saved
+to `Desktop/LiveDeskFiles` unless the Hub sets another destination folder.
+
+By default, the launcher uses the packaged C# RemoteFast engine when supported.
+It falls back to the Node engine for AI assist or when a compatible RemoteFast
+runtime is unavailable. Windows, macOS, and Linux all try RemoteFast first so
+the Hub can request the Mode 3 hardware video path when it is available.
+The launcher also includes a prebuilt ffmpeg executable through
+`@ffmpeg-installer/ffmpeg` and passes it to RemoteFast automatically. Set
+`LIVEDESK_FFMPEG` to override that path. If you need LGPL-only distribution,
+point `LIVEDESK_FFMPEG` at a verified LGPL ffmpeg build before shipping.
+
+Useful flags:
+
+```powershell
+npx -y --prefer-online livedesk@latest client 3
+npx -y --prefer-online livedesk@latest client --no-thumbnail
+npx -y --prefer-online livedesk@latest client --no-live
+npx -y --prefer-online livedesk@latest client --no-audio
+npx -y --prefer-online livedesk@latest client --files-dir "D:\LiveDeskFiles"
+npx -y --prefer-online livedesk@latest client --engine node
+npx -y --prefer-online livedesk@latest client --engine fast --trace-frames
+npx -y --prefer-online livedesk@latest client --auth-port 5200
+npx -y --prefer-online livedesk@latest client --logout
+```
+
+Frame pipeline roadmap:
+
+- Mode 1: `mode1-jpeg` - current test path using screen capture, resize, and JPEG binary frames.
+- Mode 2: `mode2-lzo` - cross-platform wall path using independent RGB565LE frames capped at 320x180 and compressed as LZO1X blocks. The wall defaults to 8 fps. macOS and Linux keep one persistent local capture helper per client process. Legacy `mode2-lz4` settings migrate to this mode.
+- Mode 3: `mode3-h264-hw` - OS-specific hardware H.264 path. Windows tries Media Foundation/NVENC/QSV/AMF, macOS prefers ScreenCaptureKit plus VideoToolbox, and Linux tries NVENC/VAAPI/QSV. macOS emits one startup key frame and then an approximately one-second GOP. The launcher uses bundled ffmpeg for fallback paths unless `LIVEDESK_FFMPEG` points to a custom binary. On macOS, set `LIVEDESK_FFMPEG_AVFOUNDATION_INPUT` only when the ScreenCaptureKit helper is unavailable and the AVFoundation fallback input is not `1:none`.
+
+Legacy mode names such as `remote-fast` and `remote-quality` are treated as
+Mode 1 aliases.

package/bin/livedesk-client-node.js

@@ -3,15 +3,24 @@
 import net from 'net';
 import os from 'os';
 import path from 'path';
-import crypto from 'crypto';
-import { promises as fs, statfsSync } from 'fs';
-import { spawn } from 'child_process';
-
-const AGENT_VERSION = '0.1.24-livedesk.1';
+import crypto from 'crypto';
+import { promises as fs, statfsSync } from 'fs';
+import { spawn } from 'child_process';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const AGENT_VERSION = (() => {
+    try {
+        return String(require('../package.json').version || '0.0.0');
+    } catch {
+        return '0.0.0';
+    }
+})();
 const DEFAULT_MANAGER = '127.0.0.1:5197';
 const DEFAULT_HEARTBEAT_MS = 5000;
 const DEFAULT_RECONNECT_MS = 5000;
-const EXIT_INVALID_PAIR_TOKEN = 23;
+const EXIT_INVALID_PAIR_TOKEN = 23;
+const EXIT_CLIENT_UPDATE = 42;
 const DEFAULT_AI_MODEL = 'gpt-5.4-mini';
 const DEFAULT_LIVE_FPS = 30;
 const MAX_LIVE_FPS = 30;
@@ -1292,6 +1301,8 @@ function remotePolicyAllows(options, command) {
             ? ['allowFileTransfer']
             : command === 'audio.start'
                 ? ['allowRemoteAudio']
+                : command === 'livedesk.client-update'
+                    ? []
                 : command === 'agent.task' || NODE_AGENT_OPERATIONS.has(command)
                     ? ['allowAgent']
                     : [];
@@ -1299,6 +1310,42 @@ function remotePolicyAllows(options, command) {
     return denied ? { ok: false, error: `${denied}-blocked-by-settings` } : { ok: true };
 }
 
+function scheduleClientUpdate(options, payload = {}) {
+    const parentPid = Number(process.env.LIVEDESK_CLIENT_PARENT_PID || process.ppid);
+    if (!Number.isInteger(parentPid) || parentPid <= 1) {
+        throw new Error('LiveDesk client launcher process id is unavailable.');
+    }
+    const command = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+    const child = spawn(command, [
+        '-y',
+        '--prefer-online',
+        'livedesk@latest',
+        'client',
+        '--no-login',
+        '--update-wait-pid',
+        String(parentPid)
+    ], {
+        env: {
+            ...process.env,
+            LIVEDESK_CLIENT_UPDATE_TARGET_VERSION: String(payload.targetVersion || process.env.LIVEDESK_CLIENT_UPDATE_TARGET_VERSION || '')
+        },
+        detached: true,
+        stdio: 'ignore',
+        windowsHide: true
+    });
+    child.once('error', error => {
+        console.error(`LiveDesk client updater failed to start: ${error.message}`);
+    });
+    child.unref();
+    return {
+        ok: true,
+        status: 'update-scheduled',
+        targetVersion: String(payload.targetVersion || ''),
+        parentPid,
+        restartAfterMs: 500
+    };
+}
+
 async function handleRemoteCommand(socket, options, message, nextFrameSeq, activeStreams) {
     const command = String(message.command || '');
     if (command === 'ping') {
@@ -1323,6 +1370,26 @@ async function handleRemoteCommand(socket, options, message, nextFrameSeq, activ
         });
         return;
     }
+
+    if (command === 'livedesk.client-update') {
+        try {
+            const result = scheduleClientUpdate(options, message.payload || {});
+            writeJsonLine(socket, {
+                type: 'command.result',
+                commandId: message.commandId,
+                result
+            });
+            setTimeout(() => process.exit(EXIT_CLIENT_UPDATE), 500);
+        } catch (error) {
+            writeJsonLine(socket, {
+                type: 'command.result',
+                commandId: message.commandId,
+                error: error?.message || String(error),
+                result: { ok: false, status: 'failed', error: error?.message || String(error) }
+            });
+        }
+        return;
+    }
 
     if (NODE_AGENT_OPERATIONS.has(command)) {
         if (!options.taskEnabled) {
@@ -1657,7 +1724,8 @@ function connectOnce(options, deviceId) {
                     remoteFiles: true,
                     fileTransferMaxBytes: MAX_FILE_TRANSFER_BYTES,
                     computerAgent: options.taskEnabled,
-                    taskDispatch: options.taskEnabled,
+                    taskDispatch: options.taskEnabled,
+                    clientUpdate: true,
                     agentApproval: options.taskEnabled,
                     agentAudit: options.taskEnabled,
                     agentTools: [...NODE_AGENT_OPERATIONS],