@livedesk/hub 0.1.49 → 0.1.51

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();
@@ -253,20 +253,40 @@ function readPositiveIntegerEnv(name, fallback) {
   return Number.isFinite(value) && value > 0 ? Math.round(value) : fallback;
 }
 
-function secureExactTestTokenMatches(actual, expected) {
+function secureExactTestTokenMatches(actual, expected) {
   const actualBytes = Buffer.from(String(actual || ''), 'utf8');
   const expectedBytes = Buffer.from(String(expected || ''), 'utf8');
   return actualBytes.length > 0
     && actualBytes.length === expectedBytes.length
-    && crypto.timingSafeEqual(actualBytes, expectedBytes);
-}
-
-function handleRemoteHubEvent(type, event) {
+    && crypto.timingSafeEqual(actualBytes, expectedBytes);
+}
+
+function sendRemoteInputRouteState(ws, deviceId, reason = '') {
+  const route = remoteHub.getInputRouteState(deviceId);
+  sendJson(ws, {
+    type: 'RemoteInputRouteState',
+    ...route,
+    reason: String(reason || route.reason || ''),
+    timestamp: new Date().toISOString()
+  });
+}
+
+function broadcastRemoteInputRouteState(deviceId, reason = '') {
+  const normalizedDeviceId = String(deviceId || '').trim();
+  if (!normalizedDeviceId) return;
+  for (const ws of inputClients) {
+    if (ws.readyState === 1 && ws.liveDeskInputDeviceIds?.has(normalizedDeviceId)) {
+      sendRemoteInputRouteState(ws, normalizedDeviceId, reason);
+    }
+  }
+}
+
+function handleRemoteHubEvent(type, event) {
   liveDeskUpdateManager?.handleRemoteEvent(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,
@@ -297,7 +317,7 @@ function handleRemoteHubEvent(type, event) {
     }
     return;
   }
-  if (type === 'RemoteInputError') {
+  if (type === 'RemoteInputError') {
     const targetConnectionId = String(event?.hubConnectionId || '').trim();
     for (const ws of inputClients) {
       if (targetConnectionId && ws.liveDeskInputClientId !== targetConnectionId) {
@@ -308,11 +328,18 @@ function handleRemoteHubEvent(type, event) {
         ...event
       });
     }
-    return;
-  }
-  if (type === 'RemoteDeviceConnected' || type === 'RemoteDeviceDisconnected') {
-    connectedDeviceCount = Number(remoteHub.getStatus({ includeSecrets: false }).connectedDeviceCount || 0);
-  }
+    return;
+  }
+  if (type === 'RemoteInputSocketConnected' || type === 'RemoteInputSocketDisconnected') {
+    const deviceId = String(event?.deviceId || event?.device?.deviceId || '').trim();
+    broadcastRemoteInputRouteState(deviceId, event?.reason || type);
+    return;
+  }
+  if (type === 'RemoteDeviceConnected' || type === 'RemoteDeviceDisconnected') {
+    connectedDeviceCount = Number(remoteHub.getStatus({ includeSecrets: false }).connectedDeviceCount || 0);
+    const deviceId = String(event?.deviceId || event?.device?.deviceId || '').trim();
+    broadcastRemoteInputRouteState(deviceId, event?.reason || type);
+  }
   if (type !== 'RemoteDeviceConnected') {
     return;
   }
@@ -572,7 +599,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 +685,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 +719,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 +740,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,
@@ -817,16 +844,18 @@ function getLiveDeskUpdateStatus() {
   };
 }
 
-if (process.env.LIVEDESK_DESKTOP_HOST !== '1') {
-  liveDeskUpdateManager = createLiveDeskUpdateManager({
-    remoteHub,
-    currentManagerVersion: process.env.LIVEDESK_MANAGER_VERSION || packageInfo.version,
-    currentClientVersion: process.env.LIVEDESK_CLIENT_PACKAGE_VERSION || '',
-    excludedDeviceIds: [runtimeDeviceId],
-    restartSupported: !!String(process.env.LIVEDESK_HUB_UPDATE_REQUEST_PATH || '').trim(),
-    requestHubRestart
-  });
-}
+const electronDesktopOwnsSelfUpdate = process.env.LIVEDESK_DESKTOP_HOST === '1';
+liveDeskUpdateManager = createLiveDeskUpdateManager({
+  remoteHub,
+  currentManagerVersion: process.env.LIVEDESK_MANAGER_VERSION || packageInfo.version,
+  currentClientVersion: process.env.LIVEDESK_CLIENT_PACKAGE_VERSION || '',
+  excludedDeviceIds: [runtimeDeviceId],
+  // electron-updater owns replacement of the installed desktop application.
+  // The same Hub still needs the fleet manager for connected outdated Clients.
+  restartSupported: !electronDesktopOwnsSelfUpdate
+    && !!String(process.env.LIVEDESK_HUB_UPDATE_REQUEST_PATH || '').trim(),
+  requestHubRestart: electronDesktopOwnsSelfUpdate ? undefined : requestHubRestart
+});
 
 if (process.env.LIVEDESK_UPDATE_CONTINUE === '1') {
   let continueUpdateInFlight = false;
@@ -870,7 +899,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;
@@ -1167,11 +1196,11 @@ async function dispatchAgentMcpTool(session, name, args = {}) {
     'livedesk.close_application': 'application.close',
     'livedesk.read_file': 'file.read',
     '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.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',
     'livedesk.get_network_status': 'network.status',
@@ -1255,8 +1284,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',
@@ -1330,7 +1359,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({
@@ -1761,40 +1790,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);
@@ -1931,12 +1960,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.'
           );
@@ -1944,12 +1973,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 });
@@ -3748,11 +3777,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'}`);
     }
   }
 }
@@ -4653,7 +4682,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);
@@ -4664,7 +4693,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 };
   }
 }
@@ -4714,7 +4743,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;
 }
 
@@ -4784,12 +4813,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;
@@ -4833,7 +4862,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 });
@@ -4848,7 +4877,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() };
 }
@@ -4869,7 +4898,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}`);
     });
   });
 }
@@ -4923,7 +4952,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() });
   }
 });
@@ -5010,31 +5039,30 @@ app.post('/api/runtime/role', async (req, res) => {
   }
 });
 
-app.get('/api/update/status', (_req, res) => {
-  noStore(res);
-  if (process.env.LIVEDESK_DESKTOP_HOST === '1') {
-    res.json({
-      updateAvailable: false,
-      state: 'electron-managed',
-      canApply: false,
-      disabled: true,
-      restartResult: readHubRestartResult()
-    });
-    return;
-  }
-  res.json(getLiveDeskUpdateStatus());
-});
-
-app.post('/api/update/apply', async (_req, res) => {
-  noStore(res);
-  if (process.env.LIVEDESK_DESKTOP_HOST === '1') {
-    res.status(409).json({ ok: false, error: 'electron-updater-managed', disabled: true });
-    return;
-  }
-  try {
-    liveDeskUpdateManager?.reconcileHubRestartResult(readHubRestartResult());
-    const result = await liveDeskUpdateManager?.startUpdate();
-    res.status(result?.ok === false ? 409 : 200).json(result || { ok: false, error: 'update-manager-unavailable' });
+app.get('/api/update/status', (_req, res) => {
+  noStore(res);
+  res.json({
+    ...getLiveDeskUpdateStatus(),
+    selfUpdateOwner: electronDesktopOwnsSelfUpdate ? 'electron-updater' : 'npm-launcher'
+  });
+});
+
+app.post('/api/update/apply', async (_req, res) => {
+  noStore(res);
+  try {
+    liveDeskUpdateManager?.reconcileHubRestartResult(readHubRestartResult());
+    const updateStatus = liveDeskUpdateManager?.getStatus();
+    if (electronDesktopOwnsSelfUpdate
+      && (updateStatus?.managerUpdateAvailable || updateStatus?.clientPackageUpdateAvailable)) {
+      res.status(409).json({
+        ok: false,
+        error: 'electron-updater-managed',
+        selfUpdateOwner: 'electron-updater'
+      });
+      return;
+    }
+    const result = await liveDeskUpdateManager?.startUpdate();
+    res.status(result?.ok === false ? 409 : 200).json(result || { ok: false, error: 'update-manager-unavailable' });
   } catch (error) {
     res.status(500).json({ ok: false, error: error instanceof Error ? error.message : String(error) });
   }
@@ -5184,64 +5212,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 || '')) }));
@@ -5793,7 +5821,7 @@ frameWss.on('connection', (ws, req) => {
   } catch {
     updateFrameSubscription(ws, {});
   }
-  ws.on('message', data => {
+  ws.on('message', data => {
     try {
       const payload = JSON.parse(Buffer.isBuffer(data) ? data.toString('utf8') : String(data || ''));
       if (payload?.type === 'subscribe') {
@@ -5899,11 +5927,29 @@ inputWss.on('connection', ws => {
     try {
       payload = JSON.parse(Buffer.isBuffer(data) ? data.toString('utf8') : String(data || ''));
     } catch {
-      sendJson(ws, { type: 'RemoteInputError', error: 'invalid-json' });
-      return;
-    }
-    const deviceId = String(payload?.deviceId || '').trim();
-    const inputEventId = String(
+      sendJson(ws, { type: 'RemoteInputError', error: 'invalid-json' });
+      return;
+    }
+    const deviceId = String(payload?.deviceId || '').trim();
+    if (payload?.type === 'watch') {
+      if (!deviceId) {
+        sendJson(ws, { type: 'RemoteInputError', error: 'device-id-required' });
+        return;
+      }
+      for (const previousDeviceId of ws.liveDeskInputDeviceIds) {
+        if (previousDeviceId !== deviceId) {
+          remoteHub.releaseInputOwner(
+            previousDeviceId,
+            ws.liveDeskInputClientId,
+            'browser-input-target-changed');
+        }
+      }
+      ws.liveDeskInputDeviceIds.clear();
+      ws.liveDeskInputDeviceIds.add(deviceId);
+      sendRemoteInputRouteState(ws, deviceId, 'browser-input-watch');
+      return;
+    }
+    const inputEventId = String(
       payload?.input?.inputEventId
       || payload?.inputEventId
       || payload?.requestId
@@ -5955,14 +6001,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();
 });
 
@@ -5988,9 +6034,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);
   }
@@ -6000,7 +6046,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)}`);
   }
 }
 
@@ -6010,13 +6056,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() {
@@ -6035,7 +6081,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;
@@ -6043,7 +6089,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());
@@ -6055,15 +6101,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();
       }
     });
@@ -6083,7 +6129,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;
 }
@@ -6093,7 +6139,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);
       });