@livedesk/hub 0.1.48 → 0.1.50

package/src/server.js

@@ -8,12 +8,12 @@ import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import os from 'node:os';
 import { WebSocketServer } from 'ws';
-import { createRemoteHub } from './remote-hub.js';
-import {
-  REMOTE_CLIPBOARD_INPUT_ACTIONS,
-  RemoteClipboardContractError,
-  normalizeRemoteClipboardRequest
-} from './remote-clipboard-contract.mjs';
+import { createRemoteHub } from './remote-hub.js';
+import {
+  REMOTE_CLIPBOARD_INPUT_ACTIONS,
+  RemoteClipboardContractError,
+  normalizeRemoteClipboardRequest
+} from './remote-clipboard-contract.mjs';
 import { createHubConsoleRelay } from './console-relay.js';
 import {
   buildImmutableRemoteFramePacket,
@@ -151,7 +151,7 @@ const atlasPool = new Mode4AtlasPool({
   onStatus: status => {
     if (status?.type !== 'log') return;
     const logger = status.level === 'warn' ? console.warn : console.log;
-    logger(`[LiveDesk Hub] ${status.message}`);
+    logger(`[VuvoDesk Hub] ${status.message}`);
   }
 });
 const inputClients = new Set();
@@ -266,7 +266,7 @@ function handleRemoteHubEvent(type, event) {
   hubTransferJobs?.handleRemoteEvent(type, event);
   if (traceRemoteTestEventsEnabled
     && (type === 'RemoteFrameDropped' || type === 'RemoteFrameTransportProofAccepted')) {
-    console.warn(`[LiveDesk Hub Test Event] ${type} ${JSON.stringify({
+    console.warn(`[VuvoDesk Hub Test Event] ${type} ${JSON.stringify({
       reason: event?.reason || '',
       deviceId: event?.deviceId || event?.device?.deviceId || '',
       proofOnly: event?.proofOnly === true,
@@ -572,7 +572,7 @@ async function getRuntimeAccessToken() {
       expires_at: Math.floor(runtimeAccessTokenExpiresAt / 1000)
     });
   } catch (error) {
-    console.warn(`[LiveDesk Hub] Refreshed session persistence failed: ${error?.message || error}`);
+    console.warn(`[VuvoDesk Hub] Refreshed session persistence failed: ${error?.message || error}`);
   }
   return runtimeAccessToken;
 }
@@ -658,7 +658,7 @@ async function watchAuthoritativeRuntimeRole() {
   try {
     const role = await queryAuthoritativeRuntimeRole();
     if (role === 'client') {
-      console.warn('[LiveDesk Hub] Supabase selected another Sync Server. Transitioning this runtime to Client.');
+      console.warn('[VuvoDesk Hub] Supabase selected another Sync Server. Transitioning this runtime to Client.');
       void clearHubHostTarget('role-demoted').finally(() => {
         setTimeout(() => process.exit(ROLE_TRANSITION_EXIT_CODE), 150);
       });
@@ -692,16 +692,16 @@ const agentDataDir = process.env.LIVEDESK_DATA_DIR || undefined;
 const liveDeskSettingsStore = new LiveDeskSettingsStore({ dataDir: agentDataDir });
 const captureStore = new CaptureStore({ dataDir: agentDataDir });
 void captureStore.initialize().catch(error => {
-  console.warn(`[LiveDesk Hub] capture store initialization failed: ${error instanceof Error ? error.message : String(error)}`);
+  console.warn(`[VuvoDesk Hub] capture store initialization failed: ${error instanceof Error ? error.message : String(error)}`);
 });
 void liveDeskSettingsStore.getRecord().catch(error => {
-  console.warn(`[LiveDesk Hub] settings load failed: ${error instanceof Error ? error.message : String(error)}`);
+  console.warn(`[VuvoDesk Hub] settings load failed: ${error instanceof Error ? error.message : String(error)}`);
 });
 
 const udpTransport = createHubUdpTransport({
   env: process.env,
-  logEvent: (_scope, message) => console.log(`[LiveDesk Hub] ${message}`),
-  logWarn: (_scope, message) => console.warn(`[LiveDesk Hub] ${message}`)
+  logEvent: (_scope, message) => console.log(`[VuvoDesk Hub] ${message}`),
+  logWarn: (_scope, message) => console.warn(`[VuvoDesk Hub] ${message}`)
 });
 
 const remoteHub = createRemoteHub({
@@ -713,8 +713,8 @@ const remoteHub = createRemoteHub({
     MINDEXEC_MANAGER_VERSION: packageInfo.version
   },
   udpTransport,
-  logEvent: (_scope, message) => console.log(`[LiveDesk Hub] ${message}`),
-  logWarn: (_scope, message) => console.warn(`[LiveDesk Hub] ${message}`),
+  logEvent: (_scope, message) => console.log(`[VuvoDesk Hub] ${message}`),
+  logWarn: (_scope, message) => console.warn(`[VuvoDesk Hub] ${message}`),
   emitEvent: handleRemoteHubEvent,
   emitFrame: broadcastRemoteBinaryFrame,
   emitAudio: broadcastRemoteBinaryAudio,
@@ -870,7 +870,7 @@ if (process.env.LIVEDESK_UPDATE_CONTINUE === '1') {
         clearInterval(continueUpdateTimer);
       }
     } catch (error) {
-      console.warn(`[LiveDesk Hub] automatic client update continuation failed: ${error instanceof Error ? error.message : String(error)}`);
+      console.warn(`[VuvoDesk Hub] automatic client update continuation failed: ${error instanceof Error ? error.message : String(error)}`);
       clearInterval(continueUpdateTimer);
     } finally {
       continueUpdateInFlight = false;
@@ -1169,6 +1169,8 @@ async function dispatchAgentMcpTool(session, name, args = {}) {
     'livedesk.write_file': 'file.write',
     'livedesk.delete_file': 'file.delete',
     'livedesk.list_directory': 'file.list',
+    'livedesk.search_files': 'file.search',
+    'livedesk.create_directory': 'directory.create',
     'livedesk.run_command': 'command.run',
     'livedesk.run_script': 'script.run',
     'livedesk.install_software': 'software.install',
@@ -1253,8 +1255,8 @@ async function dispatchAgentMcpTool(session, name, args = {}) {
       ? String(args.serviceName || '').replace(/[\0\r\n]/g, ' ').trim().slice(0, 120)
       : '';
   const result = remoteHub.requestAgentTaskBatch(targetIds, {
-    instruction: `${tool.readOnly ? `LiveDesk read-only ${operation}` : `LiveDesk ${name}`}${targetQuery ? ` for ${targetQuery}` : ''}. Return only the collected result.`,
-    title: `LiveDesk ${operation}`,
+    instruction: `${tool.readOnly ? `VuvoDesk read-only ${operation}` : `VuvoDesk ${name}`}${targetQuery ? ` for ${targetQuery}` : ''}. Return only the collected result.`,
+    title: `VuvoDesk ${operation}`,
     operation,
     targetQuery,
     approvalLevel: tool.readOnly ? 'read-only' : 'task-only',
@@ -1328,7 +1330,7 @@ const codexRuntime = createCodexAgentRuntime({
     const detail = ['failed', 'recovering'].includes(progress.stage) && progress.message
       ? ` detail=${JSON.stringify(String(progress.message).slice(0, 800))}`
       : '';
-    console.log(`[LiveDesk Hub] Agent ${progress.stage} run=${progress.runId}${tool} clients=${delivery.sent}/${delivery.total}${detail}`);
+    console.log(`[VuvoDesk Hub] Agent ${progress.stage} run=${progress.runId}${tool} clients=${delivery.sent}/${delivery.total}${detail}`);
   }
 });
 const agentManager = createAgentManager({
@@ -1759,40 +1761,40 @@ function normalizeLiveOptions(payload = {}) {
   };
 }
 
-function sendJson(ws, payload) {
+function sendJson(ws, payload) {
   if (!ws || ws.readyState !== 1) {
     return false;
   }
   return safeWebSocketSend(ws, JSON.stringify(payload));
-}
-
-function findLiveRemoteInputClient(hubConnectionId) {
-  const requestedId = String(hubConnectionId || '').trim();
-  if (!requestedId) {
-    return null;
-  }
-  for (const ws of inputClients) {
-    if (ws.readyState === 1 && ws.liveDeskInputClientId === requestedId) {
-      return ws;
-    }
-  }
-  return null;
-}
-
-function clipboardHttpStatus(error) {
-  const code = String(error || '');
-  if (code.includes('blocked-by-settings') || code === 'remote-access-blocked-by-settings') return 403;
-  if (code.includes('too-large')) return 413;
-  if (code.includes('unavailable') || code === 'device-not-connected') return 503;
-  if (code.startsWith('STALE_')
-    || code.includes('owner')
-    || code.includes('not-ready')
-    || code.includes('not-found')
-    || code.includes('already-exists')
-    || code.includes('busy')
-    || code.includes('capacity')) return 409;
-  return 400;
-}
+}
+
+function findLiveRemoteInputClient(hubConnectionId) {
+  const requestedId = String(hubConnectionId || '').trim();
+  if (!requestedId) {
+    return null;
+  }
+  for (const ws of inputClients) {
+    if (ws.readyState === 1 && ws.liveDeskInputClientId === requestedId) {
+      return ws;
+    }
+  }
+  return null;
+}
+
+function clipboardHttpStatus(error) {
+  const code = String(error || '');
+  if (code.includes('blocked-by-settings') || code === 'remote-access-blocked-by-settings') return 403;
+  if (code.includes('too-large')) return 413;
+  if (code.includes('unavailable') || code === 'device-not-connected') return 503;
+  if (code.startsWith('STALE_')
+    || code.includes('owner')
+    || code.includes('not-ready')
+    || code.includes('not-found')
+    || code.includes('already-exists')
+    || code.includes('busy')
+    || code.includes('capacity')) return 409;
+  return 400;
+}
 
 function forgetWebSocketClient(ws) {
   unregisterFrameClient(ws);
@@ -1929,12 +1931,12 @@ function scheduleFrameStreamStop(deviceId, streamId, streamPurpose) {
     if (result?.stopPromise) {
       void result.stopPromise.then(confirmation => {
         if (confirmation?.captureStopConfirmed === true) {
-          console.log(`[LiveDesk Hub] confirmed ${streamPurpose} capture stopped after frame client closed device=${deviceId} stream=${streamId}`);
+          console.log(`[VuvoDesk Hub] confirmed ${streamPurpose} capture stopped after frame client closed device=${deviceId} stream=${streamId}`);
           return;
         }
         if (!hasOtherFrameStreamOwner(null, deviceId, streamId, streamPurpose)) {
           console.warn(
-            `[LiveDesk Hub] ${streamPurpose} capture stop was not confirmed device=${deviceId} `
+            `[VuvoDesk Hub] ${streamPurpose} capture stop was not confirmed device=${deviceId} `
             + `stream=${streamId}: ${confirmation?.error || 'capture-stop-unconfirmed'}. `
             + 'Disconnecting the Agent so its final capture drain runs before reconnect.'
           );
@@ -1942,12 +1944,12 @@ function scheduleFrameStreamStop(deviceId, streamId, streamPurpose) {
         }
       }).catch(error => {
         if (!hasOtherFrameStreamOwner(null, deviceId, streamId, streamPurpose)) {
-          console.warn(`[LiveDesk Hub] ${streamPurpose} capture stop confirmation failed device=${deviceId}: ${error instanceof Error ? error.message : String(error)}`);
+          console.warn(`[VuvoDesk Hub] ${streamPurpose} capture stop confirmation failed device=${deviceId}: ${error instanceof Error ? error.message : String(error)}`);
           remoteHub.disconnectDevice(deviceId, 'frame-capture-stop-confirmation-failed');
         }
       });
     } else if (result?.ok && !result.alreadyStopped) {
-      console.log(`[LiveDesk Hub] queued ${streamPurpose} capture stop after frame client closed device=${deviceId} stream=${streamId}`);
+      console.log(`[VuvoDesk Hub] queued ${streamPurpose} capture stop after frame client closed device=${deviceId} stream=${streamId}`);
     }
   }, frameStreamStopGraceMs);
   pendingFrameStreamStops.set(key, { timer });
@@ -3746,11 +3748,11 @@ function stopUnsubscribedAudioOwners(owners, reason) {
       disconnect: (targetDeviceId, disconnectReason) => (
         remoteHub.disconnectDevice(targetDeviceId, disconnectReason)
       ),
-      warn: message => console.warn(`[LiveDesk Hub] ${message}. Disconnecting the Agent for a final drain.`)
+      warn: message => console.warn(`[VuvoDesk Hub] ${message}. Disconnecting the Agent for a final drain.`)
     });
     if (result?.ok === false
       && !['device-not-found', 'device-not-connected', 'device-audio-unavailable'].includes(String(result.error || ''))) {
-      console.warn(`[LiveDesk Hub] Could not stop unused remote audio capture device=${deviceId} reason=${reason}: ${result.error || 'unknown-error'}`);
+      console.warn(`[VuvoDesk Hub] Could not stop unused remote audio capture device=${deviceId} reason=${reason}: ${result.error || 'unknown-error'}`);
     }
   }
 }
@@ -3858,7 +3860,7 @@ function buildHubHealthPayload({
   };
   return {
     ok: true,
-    product: 'LiveDesk',
+    product: 'LiveDesk',
     timestamp: new Date().toISOString(),
     persistentSessionGc,
     memoryBeforeGc,
@@ -4321,7 +4323,7 @@ app.get('/api/remote/status', (_req, res) => {
   res.json({
     ...remoteHub.getStatus({ includeSecrets: false }),
     pairingPin: secretStatus.pairingPin,
-    product: 'LiveDesk',
+    product: 'LiveDesk',
     runtimeRole,
     deviceId: runtimeDeviceId,
     deviceName: runtimeDeviceName,
@@ -4651,7 +4653,7 @@ async function notifyHubOnline({ accessToken, target, remoteStatus, endpointCand
       lastEventId: eventId,
       nextAttemptAt: ''
     };
-    console.log(`[LiveDesk Hub] Hub-online wake signal sent event=${eventId.slice(0, 8)} delivered=${Number(data?.delivered || 0)}.`);
+    console.log(`[VuvoDesk Hub] Hub-online wake signal sent event=${eventId.slice(0, 8)} delivered=${Number(data?.delivered || 0)}.`);
     return { ok: true, eventId, delivered: Number(data?.delivered || 0) };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -4662,7 +4664,7 @@ async function notifyHubOnline({ accessToken, target, remoteStatus, endpointCand
       lastError: message,
       nextAttemptAt: new Date(hubWakeNextAttemptAtMs).toISOString()
     };
-    console.warn(`[LiveDesk Hub] Hub-online wake signal failed; Supabase target remains authoritative: ${message}`);
+    console.warn(`[VuvoDesk Hub] Hub-online wake signal failed; Supabase target remains authoritative: ${message}`);
     return { ok: false, error: message, eventId };
   }
 }
@@ -4712,7 +4714,7 @@ async function promoteCurrentRuntimeToHub() {
     p_assigned_hub_id: null,
     p_expected_role_version: null
   }, accessToken);
-  console.log(`[LiveDesk Hub] Sync Server role confirmed for ${runtimeDeviceId}.`);
+  console.log(`[VuvoDesk Hub] Sync Server role confirmed for ${runtimeDeviceId}.`);
   return result;
 }
 
@@ -4782,12 +4784,12 @@ async function publishHubHostTarget({ takeover = false, reason = 'renewal' } = {
       lastPublishedEndpoint: target.endpoint || remoteStatus.agentEndpoint || '',
       lastExpiresAt: target.expiresAt || ''
     });
-    console.log(`[LiveDesk Hub] Host target ${reason} published endpoint=${target.endpoint || remoteStatus.agentEndpoint} expires=${target.expiresAt || ''}.`);
+    console.log(`[VuvoDesk Hub] Host target ${reason} published endpoint=${target.endpoint || remoteStatus.agentEndpoint} expires=${target.expiresAt || ''}.`);
     return { ok: true, active: true, hostTarget: target, lease: getHubHostTargetLeaseStatus() };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     updateHubHostTargetLeaseState({ state: 'error', lastError: message });
-    console.error(`[LiveDesk Hub] Host target ${reason} publish failed: ${message}`);
+    console.error(`[VuvoDesk Hub] Host target ${reason} publish failed: ${message}`);
     return { ok: false, active: false, error: message, lease: getHubHostTargetLeaseStatus() };
   } finally {
     hubHostTargetRenewInFlight = false;
@@ -4831,7 +4833,7 @@ async function clearHubHostTarget(reason = 'shutdown') {
     }
   } catch (cause) {
     error = cause instanceof Error ? cause.message : String(cause);
-    console.error(`[LiveDesk Hub] Host target ${reason} clear failed: ${error}`);
+    console.error(`[VuvoDesk Hub] Host target ${reason} clear failed: ${error}`);
   }
   try {
     await remoteHub.setHostTarget({ enabled: false, nodeId: targetNodeId });
@@ -4846,7 +4848,7 @@ async function clearHubHostTarget(reason = 'shutdown') {
     lastExpiresAt: ''
   });
   if (!error) {
-    console.log(`[LiveDesk Hub] Host target cleared (${reason}).`);
+    console.log(`[VuvoDesk Hub] Host target cleared (${reason}).`);
   }
   return { ok: !error, error, lease: getHubHostTargetLeaseStatus() };
 }
@@ -4867,7 +4869,7 @@ function scheduleAuthenticatedHubHostTargetPublication(reason = 'session-receive
     void publishHubHostTargetWithPendingRoleTakeover(reason).catch(error => {
       const message = error instanceof Error ? error.message : String(error);
       updateHubHostTargetLeaseState({ state: 'error', lastError: message });
-      console.error(`[LiveDesk Hub] Host target ${reason} background publish failed: ${message}`);
+      console.error(`[VuvoDesk Hub] Host target ${reason} background publish failed: ${message}`);
     });
   });
 }
@@ -4921,7 +4923,7 @@ app.post('/api/hub/sync', async (req, res) => {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     updateHubHostTargetLeaseState({ state: 'error', lastError: message, lastReason: 'sync-server' });
-    console.error(`[LiveDesk Hub] Sync Server failed: ${message}`);
+    console.error(`[VuvoDesk Hub] Sync Server failed: ${message}`);
     res.status(409).json({ ok: false, error: message, lease: getHubHostTargetLeaseStatus() });
   }
 });
@@ -5182,64 +5184,64 @@ app.post('/api/remote/devices/:deviceId/status-diagnostic', (req, res) => {
   }));
 });
 
-app.post('/api/remote/devices/:deviceId/input', requireHubFeatureAccess, (req, res) => {
-  noStore(res);
-  res.json(remoteHub.sendInputControl(req.params.deviceId, req.body || {}));
-});
-
-app.post('/api/remote/devices/:deviceId/clipboard', requireHubFeatureAccess, async (req, res) => {
-  noStore(res);
-  try {
-    const request = normalizeRemoteClipboardRequest(req.body || {});
-    const inputClient = findLiveRemoteInputClient(request.hubConnectionId);
-    if (!inputClient) {
-      res.status(409).json({ ok: false, error: 'clipboard-input-owner-not-live' });
-      return;
-    }
-    const deviceId = String(req.params.deviceId || '').trim();
-    inputClient.liveDeskInputDeviceIds?.add?.(deviceId);
-
-    if (REMOTE_CLIPBOARD_INPUT_ACTIONS.has(request.action)) {
-      const result = remoteHub.sendInputControl(deviceId, {
-        type: request.action,
-        clipboardOperationId: request.operationId,
-        operationId: request.operationId,
-        clipboardDirection: request.clipboardDirection,
-        manifest: request.payload.manifest || null,
-        contentKind: request.payload.contentKind || request.payload.manifest?.contentKind || '',
-        controlSessionId: request.binding.controlSessionId,
-        controlCommandId: request.binding.controlCommandId,
-        captureGeneration: request.binding.captureGeneration,
-        monitorIndex: request.binding.monitorIndex,
-        hubConnectionId: request.hubConnectionId,
-        requestAck: true
-      });
-      res.status(result.ok ? 200 : clipboardHttpStatus(result.error)).json({
-        ok: result.ok === true,
-        action: request.action,
-        operationId: request.operationId,
-        input: result,
-        ...(result.ok ? {} : { error: result.error || 'clipboard-input-failed' })
-      });
-      return;
-    }
-
-    const result = await remoteHub.sendClipboardCommand(deviceId, request);
-    res.status(result.ok ? 200 : clipboardHttpStatus(result.error)).json(result);
-  } catch (error) {
-    const status = error instanceof RemoteClipboardContractError
-      ? error.status
-      : 500;
-    res.status(status).json({
-      ok: false,
-      error: error instanceof RemoteClipboardContractError
-        ? error.code
-        : 'clipboard-request-failed'
-    });
-  }
-});
-
-app.get('/api/remote/filesystem/roots', requireHubFeatureAccess, async (req, res) => {
+app.post('/api/remote/devices/:deviceId/input', requireHubFeatureAccess, (req, res) => {
+  noStore(res);
+  res.json(remoteHub.sendInputControl(req.params.deviceId, req.body || {}));
+});
+
+app.post('/api/remote/devices/:deviceId/clipboard', requireHubFeatureAccess, async (req, res) => {
+  noStore(res);
+  try {
+    const request = normalizeRemoteClipboardRequest(req.body || {});
+    const inputClient = findLiveRemoteInputClient(request.hubConnectionId);
+    if (!inputClient) {
+      res.status(409).json({ ok: false, error: 'clipboard-input-owner-not-live' });
+      return;
+    }
+    const deviceId = String(req.params.deviceId || '').trim();
+    inputClient.liveDeskInputDeviceIds?.add?.(deviceId);
+
+    if (REMOTE_CLIPBOARD_INPUT_ACTIONS.has(request.action)) {
+      const result = remoteHub.sendInputControl(deviceId, {
+        type: request.action,
+        clipboardOperationId: request.operationId,
+        operationId: request.operationId,
+        clipboardDirection: request.clipboardDirection,
+        manifest: request.payload.manifest || null,
+        contentKind: request.payload.contentKind || request.payload.manifest?.contentKind || '',
+        controlSessionId: request.binding.controlSessionId,
+        controlCommandId: request.binding.controlCommandId,
+        captureGeneration: request.binding.captureGeneration,
+        monitorIndex: request.binding.monitorIndex,
+        hubConnectionId: request.hubConnectionId,
+        requestAck: true
+      });
+      res.status(result.ok ? 200 : clipboardHttpStatus(result.error)).json({
+        ok: result.ok === true,
+        action: request.action,
+        operationId: request.operationId,
+        input: result,
+        ...(result.ok ? {} : { error: result.error || 'clipboard-input-failed' })
+      });
+      return;
+    }
+
+    const result = await remoteHub.sendClipboardCommand(deviceId, request);
+    res.status(result.ok ? 200 : clipboardHttpStatus(result.error)).json(result);
+  } catch (error) {
+    const status = error instanceof RemoteClipboardContractError
+      ? error.status
+      : 500;
+    res.status(status).json({
+      ok: false,
+      error: error instanceof RemoteClipboardContractError
+        ? error.code
+        : 'clipboard-request-failed'
+    });
+  }
+});
+
+app.get('/api/remote/filesystem/roots', requireHubFeatureAccess, async (req, res) => {
   noStore(res);
   try {
     res.json(await hubFilesystem.getRoots({ refresh: /^(1|true|yes|on)$/i.test(String(req.query?.refresh || '')) }));
@@ -5953,14 +5955,14 @@ await remoteHub.start();
 connectedDeviceCount = Number(remoteHub.getStatus({ includeSecrets: false }).connectedDeviceCount || 0);
 hubSharedFolders.startAutoSync(
   () => remoteHub.listDevices({ includeDataUrl: false }).filter(device => device.connected).map(device => device.deviceId),
-  () => process.env.LIVEDESK_REMOTE_DIRECTORY || 'Desktop/LiveDeskFiles'
+  () => process.env.LIVEDESK_REMOTE_DIRECTORY || 'Desktop/VuvoDeskFiles'
 );
 httpServer.listen(httpPort, httpHost, () => {
   const status = remoteHub.getStatus({ includeSecrets: true });
   const managerVersion = String(process.env.LIVEDESK_MANAGER_VERSION || packageInfo.version || 'dev');
-  console.log(`[LiveDesk Hub] Version ${managerVersion}`);
-  console.log(`[LiveDesk Hub] HTTP API http://${httpHost}:${httpPort}`);
-  console.log(`[LiveDesk Hub] Client endpoint ${status.agentEndpoint} pair=${status.pairTokenPreview}`);
+  console.log(`[VuvoDesk Hub] Version ${managerVersion}`);
+  console.log(`[VuvoDesk Hub] HTTP API http://${httpHost}:${httpPort}`);
+  console.log(`[VuvoDesk Hub] Client endpoint ${status.agentEndpoint} pair=${status.pairTokenPreview}`);
   hubConsoleRelay?.start();
 });
 
@@ -5986,9 +5988,9 @@ async function boundedShutdownStep(label, action, timeoutMs) {
         timer.unref?.();
       })
     ]);
-    console.log(`[LiveDesk Hub] Shutdown stage completed: ${label}.`);
+    console.log(`[VuvoDesk Hub] Shutdown stage completed: ${label}.`);
   } catch (error) {
-    console.warn(`[LiveDesk Hub] Shutdown stage warning: ${error instanceof Error ? error.message : String(error)}`);
+    console.warn(`[VuvoDesk Hub] Shutdown stage warning: ${error instanceof Error ? error.message : String(error)}`);
   } finally {
     if (timer) clearTimeout(timer);
   }
@@ -5998,7 +6000,7 @@ function runSynchronousShutdownStep(label, action) {
   try {
     action();
   } catch (error) {
-    console.warn(`[LiveDesk Hub] Shutdown stage warning: ${label} failed: ${error instanceof Error ? error.message : String(error)}`);
+    console.warn(`[VuvoDesk Hub] Shutdown stage warning: ${label} failed: ${error instanceof Error ? error.message : String(error)}`);
   }
 }
 
@@ -6008,13 +6010,13 @@ function closeBrowserWebSockets() {
     for (const ws of wss.clients) {
       closeRequested += 1;
       try {
-        ws.close(1012, 'LiveDesk Hub restarting');
+        ws.close(1012, 'VuvoDesk Hub restarting');
       } catch {
         try { ws.terminate(); } catch { /* socket already closed */ }
       }
     }
   }
-  console.log(`[LiveDesk Hub] Shutdown stage: requested ${closeRequested} browser WebSocket connection(s) to close.`);
+  console.log(`[VuvoDesk Hub] Shutdown stage: requested ${closeRequested} browser WebSocket connection(s) to close.`);
 }
 
 function terminateOpenConnections() {
@@ -6033,7 +6035,7 @@ function terminateOpenConnections() {
     try { socket.destroy(); } catch { /* socket already closed */ }
   }
   try { httpServer.closeAllConnections?.(); } catch { /* older Node runtime */ }
-  console.log(`[LiveDesk Hub] Shutdown stage: force-closed ${terminatedWebSockets} WebSocket and ${destroyedHttpConnections} HTTP connection(s).`);
+  console.log(`[VuvoDesk Hub] Shutdown stage: force-closed ${terminatedWebSockets} WebSocket and ${destroyedHttpConnections} HTTP connection(s).`);
 }
 
 let hubShutdownPromise = null;
@@ -6041,7 +6043,7 @@ function shutdownHub(signal) {
   if (hubShutdownPromise) return hubShutdownPromise;
   hubShutdownPromise = (async () => {
     const startedAt = Date.now();
-    console.log(`[LiveDesk Hub] Shutdown started signal=${signal} grace=${hubShutdownGraceMs}ms timeout=${hubShutdownTimeoutMs}ms.`);
+    console.log(`[VuvoDesk Hub] Shutdown started signal=${signal} grace=${hubShutdownGraceMs}ms timeout=${hubShutdownTimeoutMs}ms.`);
     if (roleWatchTimer) clearInterval(roleWatchTimer);
     clearInterval(browserWebSocketHeartbeatTimer);
     runSynchronousShutdownStep('update manager close', () => liveDeskUpdateManager?.close());
@@ -6053,15 +6055,15 @@ function shutdownHub(signal) {
       try {
         httpServer.close(error => {
           if (error) {
-            console.warn(`[LiveDesk Hub] HTTP listener close warning: ${error.message}`);
+            console.warn(`[VuvoDesk Hub] HTTP listener close warning: ${error.message}`);
           } else {
-            console.log('[LiveDesk Hub] Shutdown stage completed: HTTP listener closed.');
+            console.log('[VuvoDesk Hub] Shutdown stage completed: HTTP listener closed.');
           }
           resolveClose();
         });
         httpServer.closeIdleConnections?.();
       } catch (error) {
-        console.warn(`[LiveDesk Hub] HTTP listener close warning: ${error instanceof Error ? error.message : String(error)}`);
+        console.warn(`[VuvoDesk Hub] HTTP listener close warning: ${error instanceof Error ? error.message : String(error)}`);
         resolveClose();
       }
     });
@@ -6081,7 +6083,7 @@ function shutdownHub(signal) {
     await Promise.race([httpClosed, waitForShutdownDelay(remainingMs)]);
     clearTimeout(forceCloseTimer);
     terminateOpenConnections();
-    console.log(`[LiveDesk Hub] Shutdown complete in ${Date.now() - startedAt}ms.`);
+    console.log(`[VuvoDesk Hub] Shutdown complete in ${Date.now() - startedAt}ms.`);
   })();
   return hubShutdownPromise;
 }
@@ -6091,7 +6093,7 @@ for (const signal of ['SIGINT', 'SIGTERM']) {
     void shutdownHub(signal)
       .then(() => process.exit(0))
       .catch(error => {
-        console.error(`[LiveDesk Hub] Shutdown failed: ${error instanceof Error ? error.message : String(error)}`);
+        console.error(`[VuvoDesk Hub] Shutdown failed: ${error instanceof Error ? error.message : String(error)}`);
         terminateOpenConnections();
         process.exit(1);
       });

package/src/settings/effective-device-policy.js

@@ -1,36 +1,36 @@
-import { effectiveDevicePolicy } from './settings-schema.js';
-import { REMOTE_CLIPBOARD_LIMITS } from '../remote-clipboard-contract.mjs';
+import { effectiveDevicePolicy } from './settings-schema.js';
+import { REMOTE_CLIPBOARD_LIMITS } from '../remote-clipboard-contract.mjs';
 
-export function buildEffectiveDevicePolicy(settings, { deviceId = '', capabilities = {} } = {}) {
-  const policy = effectiveDevicePolicy(settings);
-  const clipboardV1 = capabilities.clipboardProtocol === 'livedesk.clipboard.v1';
-  const clipboardCommonLimits = clipboardV1
-    && capabilities.sessionBoundSideChannels === true
-    && Number.isSafeInteger(Number(capabilities.clipboardMaxTextBytes))
-    && Number(capabilities.clipboardMaxTextBytes) > 0
-    && Number.isSafeInteger(Number(capabilities.clipboardMaxTotalBytes))
-    && Number(capabilities.clipboardMaxTotalBytes) > 0
-    && Number.isSafeInteger(Number(capabilities.clipboardMaxChunkBytes))
-    && Number(capabilities.clipboardMaxChunkBytes) >= REMOTE_CLIPBOARD_LIMITS.maxChunkBytes;
-  const clipboardMaxImageBytes = Number(
-    capabilities.clipboardMaxImageBytes ?? capabilities.clipboardMaxPngBytes);
-  return {
+export function buildEffectiveDevicePolicy(settings, { deviceId = '', capabilities = {} } = {}) {
+  const policy = effectiveDevicePolicy(settings);
+  const clipboardV1 = capabilities.clipboardProtocol === 'livedesk.clipboard.v1';
+  const clipboardCommonLimits = clipboardV1
+    && capabilities.sessionBoundSideChannels === true
+    && Number.isSafeInteger(Number(capabilities.clipboardMaxTextBytes))
+    && Number(capabilities.clipboardMaxTextBytes) > 0
+    && Number.isSafeInteger(Number(capabilities.clipboardMaxTotalBytes))
+    && Number(capabilities.clipboardMaxTotalBytes) > 0
+    && Number.isSafeInteger(Number(capabilities.clipboardMaxChunkBytes))
+    && Number(capabilities.clipboardMaxChunkBytes) >= REMOTE_CLIPBOARD_LIMITS.maxChunkBytes;
+  const clipboardMaxImageBytes = Number(
+    capabilities.clipboardMaxImageBytes ?? capabilities.clipboardMaxPngBytes);
+  return {
     ...policy,
-    deviceId: String(deviceId || ''),
-    supported: {
-      control: capabilities.control !== false,
-      clipboardText: clipboardCommonLimits && capabilities.clipboardText === true,
-      clipboardImage: clipboardCommonLimits
-        && capabilities.clipboardImage === true
-        && Number.isSafeInteger(clipboardMaxImageBytes)
-        && clipboardMaxImageBytes > 0,
-      clipboardFiles: clipboardCommonLimits
-        && capabilities.clipboardFiles === true
-        && Number.isSafeInteger(Number(capabilities.clipboardMaxFiles))
-        && Number(capabilities.clipboardMaxFiles) > 0,
-      clipboardCopy: clipboardCommonLimits && capabilities.clipboardCopy === true,
-      clipboardPaste: clipboardCommonLimits && capabilities.clipboardPaste === true,
-      fileTransfer: capabilities.fileTransfer !== false,
+    deviceId: String(deviceId || ''),
+    supported: {
+      control: capabilities.control !== false,
+      clipboardText: clipboardCommonLimits && capabilities.clipboardText === true,
+      clipboardImage: clipboardCommonLimits
+        && capabilities.clipboardImage === true
+        && Number.isSafeInteger(clipboardMaxImageBytes)
+        && clipboardMaxImageBytes > 0,
+      clipboardFiles: clipboardCommonLimits
+        && capabilities.clipboardFiles === true
+        && Number.isSafeInteger(Number(capabilities.clipboardMaxFiles))
+        && Number(capabilities.clipboardMaxFiles) > 0,
+      clipboardCopy: clipboardCommonLimits && capabilities.clipboardCopy === true,
+      clipboardPaste: clipboardCommonLimits && capabilities.clipboardPaste === true,
+      fileTransfer: capabilities.fileTransfer !== false,
       remoteAudio: capabilities.audio === true || capabilities.remoteAudio === true,
       agent: Array.isArray(capabilities.agentTools) && capabilities.agentTools.length > 0
     }

package/src/settings/settings-schema.js

@@ -65,7 +65,7 @@ export const DEFAULT_LIVEDESK_SETTINGS = Object.freeze({
     openReceivedFolder: false,
     notifyTransferComplete: true,
     allowOverwrite: false,
-    defaultReceiveFolder: 'Desktop/LiveDeskFiles',
+    defaultReceiveFolder: 'Desktop/VuvoDeskFiles',
     maxFileSizeBytes: 1024 * 1024 * 1024,
     allowRemoteAudio: true,
     startAudioMuted: false,
@@ -76,7 +76,7 @@ export const DEFAULT_LIVEDESK_SETTINGS = Object.freeze({
     recordingQuality: 'standard',
     timelapseIntervalSeconds: 10,
     includeRemoteCursor: true,
-    captureSaveLocation: 'LiveDesk Captures',
+    captureSaveLocation: 'VuvoDesk Captures',
     captureAutoDelete: 'never'
   },
   agent: {