@livedesk/client 0.1.24 → 0.1.26

package/README.md

@@ -35,8 +35,10 @@ 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. Linux currently uses the Node engine with native
-`node-screenshots` capture for thumbnails and live frames.
+runtime is unavailable. macOS auto mode uses the Node engine by default because
+the current RemoteFast macOS path shells out to `screencapture`, which can show
+repeated Screen Recording privacy prompts. Use `--engine fast` on macOS only for
+experimental testing.
 
 Useful flags:
 
@@ -51,3 +53,12 @@ npx @livedesk/client --engine fast --trace-frames
 npx @livedesk/client --auth-port 5200
 npx @livedesk/client --logout
 ```
+
+Frame pipeline roadmap:
+
+- Mode 1: `mode1-jpeg` - current test path using screen capture, resize, and JPEG binary frames.
+- Mode 2: `mode2-lz4` - planned raw/tile delta frames compressed with LZ4.
+- Mode 3: `mode3-h264-hw` - planned GPU capture to hardware H.264 encoding.
+
+Legacy mode names such as `remote-fast` and `remote-quality` are treated as
+Mode 1 aliases.

package/bin/livedesk-client-node.js

@@ -747,7 +747,7 @@ function startLiveStream(socket, options, message, nextFrameSeq, activeStreams)
                 mimeType: frame.mimeType,
                 capturedAt: frame.capturedAt,
                 fps,
-                mode: 'remote-fast',
+                mode: 'mode1-jpeg',
                 droppedByAgent: stream.frameDrops,
                 data: frame.data
             });
@@ -919,7 +919,7 @@ async function handleRemoteCommand(socket, options, message, nextFrameSeq, activ
                     streamId: started.streamId,
                     fps: started.fps,
                     intervalMs: started.intervalMs,
-                    mode: 'remote-fast',
+                    mode: 'mode1-jpeg',
                     viewOnly: true,
                     inputControl: false,
                     startedAt: new Date().toISOString()

package/bin/livedesk-client.js

@@ -61,7 +61,8 @@ Options:
   --help                          Show this help.
 
 Auto uses C# RemoteFast when supported and falls back to Node for AI assist or
-when a packaged RemoteFast runtime is unavailable.
+when a packaged RemoteFast runtime is unavailable. On macOS, auto uses the Node
+agent by default to avoid repeated screencapture privacy prompts.
 `.trimStart());
 }
 
@@ -74,6 +75,14 @@ function readPackageVersion() {
     }
 }
 
+function isTruthy(value) {
+    return /^(1|true|yes|on)$/i.test(String(value || '').trim());
+}
+
+function isMacFastAutoEnabled() {
+    return isTruthy(process.env.LIVEDESK_CLIENT_MAC_FAST || process.env.MINDEXEC_REMOTE_MAC_FAST);
+}
+
 function normalizeEngine(value) {
     const engine = String(value || 'auto').trim().toLowerCase();
     if (engine === 'c#' || engine === 'csharp' || engine === 'fast') {
@@ -888,6 +897,9 @@ function shouldUseFast(parsed) {
     if (parsed.engine === 'fast') {
         return true;
     }
+    if (os.platform() === 'darwin' && !isMacFastAutoEnabled()) {
+        return false;
+    }
     return !parsed.nodeOnlyFeature;
 }
 
@@ -914,6 +926,9 @@ async function main() {
         const fastRuntime = getFastRuntime();
         const useFast = shouldTryFast(prepared, fastRuntime);
         let result;
+        if (!useFast && prepared.engine === 'auto' && os.platform() === 'darwin') {
+            console.warn('LiveDesk uses the Node engine on macOS to avoid repeated Screen Recording prompts. Use --engine fast only for experimental testing.');
+        }
         if (useFast) {
             const fastArgs = buildFastArgs(prepared.forwarded, prepared.fakeThumbnail);
             const fastLaunch = resolveFastLaunch(fastRuntime);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livedesk/client",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "LiveDesk local remote client",
   "type": "module",
   "bin": {