@livedesk/client 0.1.22 → 0.1.24

package/README.md

@@ -7,14 +7,14 @@ npx @livedesk/client
 npx @livedesk/client 3
 ```
 
-The default flow opens Google sign-in, waits for the active LiveDesk manager
-published by the same account, and connects locally. If the manager is not
+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. Omit the
 number for first-available placement, or pass `1` to `999` to pin this machine
 to a screen wall slot.
 
-On the manager computer, open the LiveDesk dashboard and sign in first. The
-dashboard keeps its local hub address and private pair token refreshed in the
+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:
@@ -27,11 +27,11 @@ If you use a custom port, run `npx @livedesk/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
-manager-requested thumbnails, can stream a focused view-only live screen, and
+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, file transfer, and Windows system-audio loopback
-playback. When file transfer is enabled by the manager, received files are saved
-to `Desktop/LiveDeskFiles` unless the manager sets another destination folder.
+playback. 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

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.22-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;
@@ -27,8 +27,8 @@ Usage:
   npx @livedesk/client connect --manager 127.0.0.1:5197 --pair <token>
 
 Options:
-  --manager <host:port>  RemoteHub address. Default: ${DEFAULT_MANAGER}
-  --pair <token>         RemoteHub pairing token. Can also use LIVEDESK_CLIENT_PAIR_TOKEN.
+  --manager <host:port>  LiveDesk Hub address. Default: ${DEFAULT_MANAGER}
+  --pair <token>         LiveDesk Hub pairing token. Can also use LIVEDESK_CLIENT_PAIR_TOKEN.
   --slot <number>        Screen wall slot number for this computer.
   --name <name>          Friendly device name. Default: OS hostname.
   --heartbeat <ms>       Status heartbeat interval. Default: ${DEFAULT_HEARTBEAT_MS}
@@ -45,8 +45,8 @@ Options:
   --ai-model <model>     OpenAI model for AI assist. Default: ${DEFAULT_AI_MODEL}
   --fake-ai              Use deterministic AI assist responses for smoke tests.
   --fake-thumbnail       Use generated thumbnail frames for smoke tests.
-  --exit-on-disconnect   Exit after manager disconnect. Useful for tests.
-  --exit-on-invalid-pair Exit when the manager rejects the pair token.
+  --exit-on-disconnect   Exit after Hub disconnect. Useful for tests.
+  --exit-on-invalid-pair Exit when the Hub rejects the pair token.
   --once                 Connect, send one status packet, and exit after welcome.
   --version              Show the agent version.
   --help                 Show this help.
@@ -587,14 +587,14 @@ function buildAiPrompt(options, payload, instruction) {
     const title = String(payload?.title || 'Remote AI task').trim();
     return [
         'You are the LiveDesk client AI assistant running on a controlled remote computer.',
-        'Complete the manager task as a text-only assistant.',
+        'Complete the LiveDesk Hub task as a text-only assistant.',
         'Do not claim you used shell commands, file writes, browser automation, keyboard input, or mouse input.',
         'If the task requires external side effects, explain what would be needed and stop.',
         '',
         `Device: ${options.name} (${os.hostname()}, ${os.platform()} ${os.release()}, ${os.arch()})`,
         `Task title: ${title}`,
         '',
-        'Manager instruction:',
+        'Hub instruction:',
         instruction
     ].join('\n');
 }
@@ -1082,7 +1082,7 @@ function connectOnce(options, deviceId) {
 
                 const message = JSON.parse(line);
                 if (message.type === 'welcome') {
-                    console.log(`Connected to RemoteHub as ${options.name} (${deviceId})`);
+                    console.log(`Connected to LiveDesk Hub as ${options.name} (${deviceId})`);
                     writeJsonLine(socket, {
                         type: 'status',
                         status: getStatus(options)
@@ -1113,7 +1113,7 @@ function connectOnce(options, deviceId) {
                     finish();
                     return;
                 } else if (message.type === 'error') {
-                    const remoteError = new Error(message.error || 'RemoteHub rejected the connection.');
+                    const remoteError = new Error(message.error || 'LiveDesk Hub rejected the connection.');
                     if (message.error === 'invalid-pair-token' && options.exitOnInvalidPair) {
                         remoteError.exitCode = EXIT_INVALID_PAIR_TOKEN;
                     }
@@ -1130,7 +1130,7 @@ function connectOnce(options, deviceId) {
 
 async function connectWithRetry(options) {
     if (!options.pair) {
-        throw new Error('Missing --pair token. Get it from the manager RemoteHub status.');
+        throw new Error('Missing --pair token. Sign in with Google or get it from LiveDesk Hub status.');
     }
 
     const deviceId = await getDeviceId(options.deviceId);
@@ -1158,7 +1158,7 @@ async function connectWithRetry(options) {
                 throw err;
             }
             const delayMs = DEFAULT_RECONNECT_MS;
-            console.error(`RemoteHub connection failed: ${err?.message || err}. Retrying in ${delayMs}ms.`);
+            console.error(`LiveDesk Hub connection failed: ${err?.message || err}. Retrying in ${delayMs}ms.`);
             await wait(delayMs);
         }
     }

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');
@@ -32,9 +33,9 @@ Usage:
   npx @livedesk/client 3
 
 Default flow:
-  Opens Google sign-in, waits for the signed-in manager, and connects locally.
+  Opens Google sign-in, waits for the signed-in LiveDesk Hub, and connects locally.
   Omit the number for first-available placement, or pass 1-999 to pin a slot.
-  If no manager is active yet, the client keeps checking every 5 seconds.
+  If no LiveDesk Hub is active yet, the client keeps checking every 5 seconds.
 
 Options:
   --slot <number>                 Screen wall slot number for this computer.
@@ -53,7 +54,7 @@ Options:
   --files-dir <path>              Default folder for received files.
   --tasks                         Enable safe remote task inbox.
   --no-tasks                      Disable remote task dispatch capability.
-  --login                         Sign in with Google and auto-discover manager.
+  --login                         Sign in with Google and auto-discover the Hub.
   --logout                        Forget saved Google session before connecting.
   --auth-port <port>              Google sign-in callback port. Default: 5198.
   --version                       Show the agent version.
@@ -278,7 +279,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 +289,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 +590,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')
@@ -542,21 +600,21 @@ async function resolveManagerFromSupabase(supabase, options = {}) {
         throw error;
     }
     if (!data?.active) {
-        throw new Error('No active LiveDesk manager was found for this Google account. Start LiveDesk on the manager computer and sign in there first.');
+        throw new Error('No active LiveDesk Hub was found for this Google account. Start LiveDesk Hub on the screen wall computer and sign in there first.');
     }
     if (data.expires_at && Date.parse(data.expires_at) <= Date.now()) {
-        throw new Error('The LiveDesk manager record is expired. Open the manager screen again while signed in.');
+        throw new Error('The LiveDesk Hub record is expired. Open the Hub screen again while signed in.');
     }
     if (!data.pair_token) {
-        throw new Error('The LiveDesk manager record is missing its private connection token.');
+        throw new Error('The LiveDesk Hub record is missing its private connection token.');
     }
     const endpointCandidates = normalizeEndpointCandidates(data);
     if (endpointCandidates.length === 0) {
-        throw new Error('The LiveDesk manager record does not contain a reachable local address.');
+        throw new Error('The LiveDesk Hub record does not contain a reachable local address.');
     }
     const manager = await chooseReachableEndpoint(endpointCandidates, { requireReachable: options.requireReachable === true });
     if (!manager) {
-        throw new Error(`No reachable LiveDesk manager endpoint yet. Checked ${endpointCandidates.join(', ')}.`);
+        throw new Error(`No reachable LiveDesk Hub endpoint yet. Checked ${endpointCandidates.join(', ')}.`);
     }
     return {
         manager,
@@ -570,16 +628,16 @@ async function waitForManagerFromSupabase(supabase, options = {}) {
     const intervalSeconds = Math.max(1, Math.round(intervalMs / 1000));
     let attempts = 0;
     let lastMessage = '';
-    console.log(`Waiting for a LiveDesk manager. This client will keep trying every ${intervalSeconds}s.`);
+    console.log(`Waiting for a LiveDesk Hub. This client will keep trying every ${intervalSeconds}s.`);
     while (true) {
         attempts += 1;
         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 manager${suffix}: ${message}`);
+                console.log(`Still waiting for LiveDesk Hub${suffix}: ${message}`);
                 lastMessage = message;
             }
             await sleep(intervalMs);
@@ -607,7 +665,7 @@ async function prepareLoginConnection(parsed) {
         const resolved = await waitForManagerFromSupabase(supabase);
         manager = resolved.manager;
         pair = resolved.pair;
-        console.log(`Found LiveDesk manager at ${manager}.`);
+        console.log(`Found LiveDesk Hub at ${manager}.`);
     }
 
     const slot = normalizeSlotNumber(parsed.slot);
@@ -876,7 +934,7 @@ async function main() {
             return;
         }
         if (prepared.rediscoverOnInvalidPair && result?.code === EXIT_INVALID_PAIR_TOKEN) {
-            console.error(`LiveDesk manager pair token changed. Refreshing manager discovery in ${DISCOVERY_RETRY_MS}ms.`);
+            console.error(`LiveDesk Hub pair token changed. Refreshing Hub discovery in ${DISCOVERY_RETRY_MS}ms.`);
             await sleep(DISCOVERY_RETRY_MS);
             continue;
         }

package/package.json

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