@livedesk/client 0.1.23 → 0.1.25

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:
 

package/bin/livedesk-client-node.js

@@ -6,7 +6,7 @@ import path from 'path';
 import crypto from 'crypto';
 import { promises as fs, statfsSync } from 'fs';
 
-const AGENT_VERSION = '0.1.23-livedesk.1';
+const AGENT_VERSION = '0.1.24-livedesk.1';
 const DEFAULT_MANAGER = '127.0.0.1:5197';
 const DEFAULT_HEARTBEAT_MS = 5000;
 const DEFAULT_RECONNECT_MS = 5000;

package/bin/livedesk-client.js

@@ -17,6 +17,7 @@ const DEFAULT_AUTH_CALLBACK_HOST = '127.0.0.1';
 const DEFAULT_AUTH_CALLBACK_PORT = 5198;
 const DISCOVERY_RETRY_MS = 5000;
 const EXIT_INVALID_PAIR_TOKEN = 23;
+const SESSION_REFRESH_SKEW_SECONDS = 60;
 const SUPABASE_URL = process.env.LIVEDESK_SUPABASE_URL || 'https://otbyfkjxrkngvjziawki.supabase.co';
 const SUPABASE_PUBLISHABLE_KEY = process.env.LIVEDESK_SUPABASE_PUBLISHABLE_KEY || 'sb_publishable_NpUs0RDJH2YnllsqTKO6TQ_1jTdSsNQ';
 const CLIENT_STATE_DIR = join(os.homedir(), '.livedesk-client');
@@ -60,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());
 }
 
@@ -73,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') {
@@ -278,7 +288,7 @@ async function createSupabaseClient() {
     const { createClient } = await import('@supabase/supabase-js');
     return createClient(SUPABASE_URL, SUPABASE_PUBLISHABLE_KEY, {
         auth: {
-            autoRefreshToken: true,
+            autoRefreshToken: false,
             persistSession: true,
             detectSessionInUrl: false,
             flowType: 'pkce',
@@ -288,6 +298,62 @@ async function createSupabaseClient() {
     });
 }
 
+function getNestedErrorCode(error) {
+    let cursor = error;
+    for (let i = 0; i < 5 && cursor; i++) {
+        if (typeof cursor.code === 'string' && cursor.code.trim()) {
+            return cursor.code.trim();
+        }
+        cursor = cursor.cause;
+    }
+    return '';
+}
+
+function getNestedErrorMessage(error) {
+    const messages = [];
+    let cursor = error;
+    for (let i = 0; i < 5 && cursor; i++) {
+        if (typeof cursor.message === 'string' && cursor.message.trim()) {
+            messages.push(cursor.message.trim());
+        }
+        cursor = cursor.cause;
+    }
+    return messages.join(' ');
+}
+
+function isTransientNetworkError(error) {
+    const code = getNestedErrorCode(error).toUpperCase();
+    if (['ENOTFOUND', 'EAI_AGAIN', 'ECONNRESET', 'ECONNREFUSED', 'ETIMEDOUT', 'ENETUNREACH', 'EHOSTUNREACH'].includes(code)) {
+        return true;
+    }
+    return /fetch failed|network|dns|socket|connection|timeout|getaddrinfo/i.test(getNestedErrorMessage(error));
+}
+
+function formatDiscoveryError(error) {
+    if (isTransientNetworkError(error)) {
+        const code = getNestedErrorCode(error);
+        return `Network is not ready yet${code ? ` (${code})` : ''}. Waiting for DNS/Wi-Fi after sleep.`;
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+
+async function refreshSessionIfNeeded(supabase) {
+    const { data: existing } = await supabase.auth.getSession();
+    const session = existing?.session;
+    if (!session?.access_token) {
+        return null;
+    }
+    const expiresAt = Number(session.expires_at || 0);
+    if (expiresAt <= 0 || expiresAt - Math.floor(Date.now() / 1000) > SESSION_REFRESH_SKEW_SECONDS) {
+        return session;
+    }
+    const { data, error } = await supabase.auth.refreshSession(session);
+    if (error) {
+        throw error;
+    }
+    return data?.session || session;
+}
+
 function openBrowser(url) {
     if (os.platform() === 'win32') {
         spawn('rundll32.exe', ['url.dll,FileProtocolHandler', url], { detached: true, stdio: 'ignore', windowsHide: true }).unref();
@@ -533,6 +599,7 @@ function normalizeEndpointCandidates(target) {
 }
 
 async function resolveManagerFromSupabase(supabase, options = {}) {
+    await refreshSessionIfNeeded(supabase);
     const { data, error } = await supabase
         .from('livedesk_remote_host_targets')
         .select('endpoint, endpoint_candidates, pair_token, active, expires_at, updated_at, manager_version')
@@ -576,7 +643,7 @@ async function waitForManagerFromSupabase(supabase, options = {}) {
         try {
             return await resolveManagerFromSupabase(supabase, { requireReachable: true });
         } catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
+            const message = formatDiscoveryError(err);
             if (message !== lastMessage || attempts === 1 || attempts % 6 === 0) {
                 const suffix = attempts === 1 ? '' : ` attempt ${attempts}`;
                 console.log(`Still waiting for LiveDesk Hub${suffix}: ${message}`);
@@ -830,6 +897,9 @@ function shouldUseFast(parsed) {
     if (parsed.engine === 'fast') {
         return true;
     }
+    if (os.platform() === 'darwin' && !isMacFastAutoEnabled()) {
+        return false;
+    }
     return !parsed.nodeOnlyFeature;
 }
 
@@ -856,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.23",
+  "version": "0.1.25",
   "description": "LiveDesk local remote client",
   "type": "module",
   "bin": {