livedesk 0.1.592 → 0.1.593

package/electron/electron-builder.e2e.yml

@@ -1,5 +1,5 @@
 extends: file:packages/livedesk/electron/electron-builder.win.yml
-artifactName: LiveDesk-${version}-${arch}-e2e.${ext}
+artifactName: VuvoDesk-${version}-${arch}-e2e.${ext}
 directories:
   output: dist/desktop-e2e
 win:

package/electron/electron-builder.mac-arm64.yml

@@ -38,7 +38,7 @@ mac:
       arch:
         - arm64
   extendInfo:
-    NSMicrophoneUsageDescription: LiveDesk uses audio only when remote computer audio is enabled.
+    NSMicrophoneUsageDescription: VuvoDesk uses audio only when remote computer audio is enabled.
 publish:
   provider: generic
   url: https://livedesk-desktop-updates.lovecrdm.workers.dev/stable/macos/arm64

package/electron/electron-builder.mac-x64.yml

@@ -38,7 +38,7 @@ mac:
       arch:
         - x64
   extendInfo:
-    NSMicrophoneUsageDescription: LiveDesk uses audio only when remote computer audio is enabled.
+    NSMicrophoneUsageDescription: VuvoDesk uses audio only when remote computer audio is enabled.
 publish:
   provider: generic
   url: https://livedesk-desktop-updates.lovecrdm.workers.dev/stable/macos/x64

package/electron/electron-builder.win-dev.yml

@@ -1,5 +1,5 @@
 extends: file:packages/livedesk/electron/electron-builder.win.yml
-artifactName: LiveDesk-${version}-dev-${arch}.${ext}
+artifactName: VuvoDesk-${version}-dev-${arch}.${ext}
 directories:
   output: dist/desktop-dev
 extraMetadata:

package/electron/electron-builder.win.yml

@@ -29,14 +29,14 @@ win:
     - target: nsis
       arch:
         - x64
-  executableName: LiveDesk
+  executableName: VuvoDesk
 nsis:
   oneClick: false
   perMachine: false
   allowToChangeInstallationDirectory: true
   createDesktopShortcut: true
   createStartMenuShortcut: true
-  shortcutName: LiveDesk
+  shortcutName: VuvoDesk
   deleteAppDataOnUninstall: false
 publish:
   provider: generic

package/electron/electron-builder.yml

@@ -1,6 +1,6 @@
 appId: com.livedesk.desktop
-productName: LiveDesk
-artifactName: LiveDesk-${version}-${arch}.${ext}
+productName: VuvoDesk
+artifactName: VuvoDesk-${version}-${arch}.${ext}
 asar: true
 directories:
   app: packages/livedesk

package/electron/main.mjs

@@ -1,9 +1,9 @@
 import { app, BrowserWindow, clipboard, dialog, ipcMain, Menu, nativeImage, powerMonitor, safeStorage, shell, Tray } from 'electron';
 import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
-import { spawn } from 'node:child_process';
-import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
 import { createProductUpdateManager } from './update-manager.mjs';
 import { createRecurringProductUpdateOwner } from './recurring-update-owner.mjs';
 import { createPkceAuthorizationUrl, exchangePkceCode, fetchSupabaseUser, parsePkceCallbackUrl, refreshSupabaseSession } from './oauth-pkce.mjs';
@@ -27,8 +27,8 @@ import {
   registerOwnedWindowsChild,
   terminateExactRegisteredWindowsTreeUntilStopped
 } from '../runtime-core/src/windows-owned-process-tree.js';
-import {
-  DEFAULT_RUNTIME_COOPERATIVE_REQUEST_MS,
+import {
+  DEFAULT_RUNTIME_COOPERATIVE_REQUEST_MS,
   DEFAULT_RUNTIME_FORCED_CLEANUP_RESERVE_MS,
   DEFAULT_RUNTIME_STOP_TIMEOUT_MS,
   claimRuntimeIntentionalStop,
@@ -37,14 +37,14 @@ import {
   remainingRuntimeDeadlineMs,
   shouldRestartOwnedRuntimeAfterExit,
   terminateOwnedUnixRuntimeTree,
-  waitForOwnedRuntimeTreeExit,
-  waitForPromiseBeforeDeadline
-} from './runtime-process-owner.mjs';
-import {
-  desktopHubTakeoverPublicationConfirmed,
-  resolveDesktopHubTakeoverPending
-} from './runtime-role-transition.mjs';
-import { createDesktopClipboardOwner } from './desktop-clipboard-owner.mjs';
+  waitForOwnedRuntimeTreeExit,
+  waitForPromiseBeforeDeadline
+} from './runtime-process-owner.mjs';
+import {
+  desktopHubTakeoverPublicationConfirmed,
+  resolveDesktopHubTakeoverPending
+} from './runtime-role-transition.mjs';
+import { createDesktopClipboardOwner } from './desktop-clipboard-owner.mjs';
 
 // Chromium otherwise leaves an out-of-process Audio Service (~80-90 MiB on
 // Windows) alive after the exact Remote Audio owner, AudioContext, worklet,
@@ -53,7 +53,8 @@ import { createDesktopClipboardOwner } from './desktop-clipboard-owner.mjs';
 // warm-idle process baseline instead of retaining a hidden utility process.
 app.commandLine.appendSwitch('disable-features', 'AudioServiceOutOfProcess');
 
-const APP_NAME = 'LiveDesk Desktop';
+const APP_NAME = 'VuvoDesk Desktop';
+const DESKTOP_STARTUP_ENTRY_NAME = 'LiveDesk Desktop';
 const appWindowTitle = () => `${APP_NAME} · ${app.getVersion()}`;
 const LOCAL_RUNTIME_PORT = Number(process.env.LIVEDESK_LOCAL_RUNTIME_PORT || 5179);
 const LOCAL_RUNTIME_URL = `http://127.0.0.1:${Number.isInteger(LOCAL_RUNTIME_PORT) && LOCAL_RUNTIME_PORT > 0 ? LOCAL_RUNTIME_PORT : 5179}/`;
@@ -77,11 +78,11 @@ const SUPABASE_URL = DESKTOP_AUTH_CONFIG.supabaseUrl;
 const SUPABASE_PUBLISHABLE_KEY = DESKTOP_AUTH_CONFIG.publishableKey;
 const OAUTH_REDIRECT_URI = DESKTOP_AUTH_CONFIG.oauthRedirectUri;
 const OAUTH_PENDING_TTL_MS = 10 * 60 * 1000;
-const LEGACY_STARTUP_ENTRY_NAMES = ['LiveDesk Client.vbs', 'LiveDesk Client.cmd', 'LiveDesk Desktop.vbs'];
+const LEGACY_STARTUP_ENTRY_NAMES = ['LiveDesk Client.vbs', 'LiveDesk Client.cmd', 'LiveDesk Desktop.vbs'];
 const configuredStateRoot = process.env.LIVEDESK_DESKTOP_STATE_DIR || process.env.LIVEDESK_STATE_DIR || '';
 const stateRoot = configuredStateRoot
   ? resolve(configuredStateRoot)
-  : join(process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local'), 'LiveDesk');
+  : join(process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local'), 'LiveDesk');
 const logDir = join(stateRoot, 'logs');
 const logPath = join(logDir, 'desktop.log');
 const authSessionPath = join(stateRoot, 'auth-session.json');
@@ -93,50 +94,50 @@ const unpackedAppPath = appPath.replace(/app\.asar([\\/]|$)/, 'app.asar.unpacked
 const appRoot = [appPath, unpackedAppPath, resolve(appPath, '..'), resolve(unpackedAppPath, '..')]
   .find(candidate => existsSync(join(candidate, 'bin', 'livedesk.js')) || existsSync(join(candidate, 'package.json')))
   || appPath;
-const runtimeCwd = existsSync(join(unpackedAppPath, 'bin', 'livedesk.js')) ? unpackedAppPath : appRoot;
-const require = createRequire(import.meta.url);
+const runtimeCwd = existsSync(join(unpackedAppPath, 'bin', 'livedesk.js')) ? unpackedAppPath : appRoot;
+const require = createRequire(import.meta.url);
+
+function appResource(...parts) {
+  const unpacked = resolve(unpackedAppPath, ...parts);
+  return existsSync(unpacked) ? unpacked : resolve(appRoot, ...parts);
+}
 
-function appResource(...parts) {
-  const unpacked = resolve(unpackedAppPath, ...parts);
-  return existsSync(unpacked) ? unpacked : resolve(appRoot, ...parts);
-}
-
-function resolveClipboardHelperPath() {
-  const override = String(process.env.LIVEDESK_CLIPBOARD_HELPER_PATH || '').trim();
-  if (override && existsSync(override)) return resolve(override);
-  const platform = process.platform;
-  const arch = process.arch;
-  const rid = platform === 'win32' && arch === 'x64'
-    ? 'win-x64'
-    : platform === 'darwin' && arch === 'arm64'
-      ? 'osx-arm64'
-      : platform === 'darwin' && arch === 'x64'
-        ? 'osx-x64'
-        : platform === 'linux' && arch === 'x64'
-          ? 'linux-x64'
-          : '';
-  if (!rid) return '';
-  const executableName = platform === 'win32' ? 'livedesk-client-fast.exe' : 'livedesk-client-fast';
-  const packageName = `@livedesk/fast-${rid}`;
-  const candidates = [];
-  const sourceCandidates = [
-    resolve(appRoot, '..', `fast-${rid}`, 'fast', executableName),
-    resolve(appRoot, '..', 'client', 'fast', rid, executableName),
-    resolve(appRoot, '..', '..', 'packages', `fast-${rid}`, 'fast', executableName)
-  ];
-  if (!app.isPackaged) candidates.push(...sourceCandidates);
-  try {
-    const packagePath = require.resolve(`${packageName}/package.json`);
-    const packagedPath = join(dirname(packagePath), 'fast', executableName);
-    candidates.push(packagedPath.replace(/app\.asar([\\/]|$)/, 'app.asar.unpacked$1'), packagedPath);
-  } catch {
-    // Development checkouts use the source/package staging candidates below.
-  }
-  candidates.push(
-    appResource('client', 'fast', rid, executableName),
-    ...sourceCandidates);
-  return candidates.find(candidate => existsSync(candidate)) || '';
-}
+function resolveClipboardHelperPath() {
+  const override = String(process.env.LIVEDESK_CLIPBOARD_HELPER_PATH || '').trim();
+  if (override && existsSync(override)) return resolve(override);
+  const platform = process.platform;
+  const arch = process.arch;
+  const rid = platform === 'win32' && arch === 'x64'
+    ? 'win-x64'
+    : platform === 'darwin' && arch === 'arm64'
+      ? 'osx-arm64'
+      : platform === 'darwin' && arch === 'x64'
+        ? 'osx-x64'
+        : platform === 'linux' && arch === 'x64'
+          ? 'linux-x64'
+          : '';
+  if (!rid) return '';
+  const executableName = platform === 'win32' ? 'livedesk-client-fast.exe' : 'livedesk-client-fast';
+  const packageName = `@livedesk/fast-${rid}`;
+  const candidates = [];
+  const sourceCandidates = [
+    resolve(appRoot, '..', `fast-${rid}`, 'fast', executableName),
+    resolve(appRoot, '..', 'client', 'fast', rid, executableName),
+    resolve(appRoot, '..', '..', 'packages', `fast-${rid}`, 'fast', executableName)
+  ];
+  if (!app.isPackaged) candidates.push(...sourceCandidates);
+  try {
+    const packagePath = require.resolve(`${packageName}/package.json`);
+    const packagedPath = join(dirname(packagePath), 'fast', executableName);
+    candidates.push(packagedPath.replace(/app\.asar([\\/]|$)/, 'app.asar.unpacked$1'), packagedPath);
+  } catch {
+    // Development checkouts use the source/package staging candidates below.
+  }
+  candidates.push(
+    appResource('client', 'fast', rid, executableName),
+    ...sourceCandidates);
+  return candidates.find(candidate => existsSync(candidate)) || '';
+}
 
 // Electron's ASAR loader keeps unpacked files addressable through the virtual
 // app.asar path while resolving their package dependencies from the same tree.
@@ -151,11 +152,11 @@ let runtimeChild = null;
 let isQuitting = false;
 let runtimeRestartCount = 0;
 let runtimeRestartWindowStartedAt = 0;
-let runtimeRestartTimer = null;
-let runtimeRestartPromise = null;
-let runtimeLaunchStartedAt = 0;
-let runtimeRoleTakeoverPending = process.env.LIVEDESK_ROLE_TAKEOVER === '1';
-let quitSequenceStarted = false;
+let runtimeRestartTimer = null;
+let runtimeRestartPromise = null;
+let runtimeLaunchStartedAt = 0;
+let runtimeRoleTakeoverPending = process.env.LIVEDESK_ROLE_TAKEOVER === '1';
+let quitSequenceStarted = false;
 let updateInstallSequenceStarted = false;
 let productUpdates = null;
 let recurringProductUpdates = null;
@@ -165,10 +166,10 @@ let runtimeLogoutPromise = null;
 let desktopAuthRefreshTimer = null;
 let desktopSessionRestorePromise = null;
 let lastDesktopResumeRecoveryAt = 0;
-let desktopSessionEpoch = 0;
-let lastKnownDesktopSession = null;
-let desktopClipboardOwner = null;
-const desktopAuthInvalidationGuard = createDesktopAuthInvalidationGuard();
+let desktopSessionEpoch = 0;
+let lastKnownDesktopSession = null;
+let desktopClipboardOwner = null;
+const desktopAuthInvalidationGuard = createDesktopAuthInvalidationGuard();
 const FALLBACK_ICON_DATA_URL = `data:image/svg+xml;charset=utf-8,${encodeURIComponent('<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32" fill="none"><rect x="1" y="1" width="30" height="30" rx="7" fill="#111827"/><g transform="translate(5 5) scale(.785714)"><rect x="2.5" y="4" width="14" height="9" rx="1.5" stroke="#F8FAFC" stroke-width="1.7" opacity=".42"/><path d="M7 16v1.5h5" stroke="#F8FAFC" stroke-width="1.7" stroke-linecap="round" opacity=".42"/><rect x="10.5" y="2.5" width="14" height="9" rx="1.5" stroke="#F8FAFC" stroke-width="1.7" opacity=".62"/><path d="M15 14.5V16h5" stroke="#F8FAFC" stroke-width="1.7" stroke-linecap="round" opacity=".62"/><rect x="6.5" y="8.5" width="15" height="10" rx="1.7" fill="#F8FAFC" fill-opacity=".12" stroke="#F8FAFC" stroke-width="1.9"/><path d="M12 21v1.5H9.5M16 21v1.5h2.5M9.5 22.5h9" stroke="#F8FAFC" stroke-width="1.9" stroke-linecap="round"/></g></svg>')}`;
 const desktopLogger = createBoundedDesktopLogger({ logPath });
 
@@ -402,23 +403,23 @@ async function drainRuntimeTreeUntilStopped(child, deadline) {
   );
 }
 
-function startRuntime(options = {}) {
-  if (runtimeChild) return runtimeChild;
-  runtimeLaunchStartedAt = Date.now();
-  const preResolvedRole = options?.role === 'hub' || options?.role === 'client' ? options.role : '';
-  const roleTakeover = options?.roleTakeover === true || runtimeRoleTakeoverPending;
-  if (roleTakeover) runtimeRoleTakeoverPending = true;
-  const ownsUnixProcessGroup = process.platform !== 'win32';
+function startRuntime(options = {}) {
+  if (runtimeChild) return runtimeChild;
+  runtimeLaunchStartedAt = Date.now();
+  const preResolvedRole = options?.role === 'hub' || options?.role === 'client' ? options.role : '';
+  const roleTakeover = options?.roleTakeover === true || runtimeRoleTakeoverPending;
+  if (roleTakeover) runtimeRoleTakeoverPending = true;
+  const ownsUnixProcessGroup = process.platform !== 'win32';
   const child = spawn(runtimeNode(), [launcherEntry, '--no-open'], {
     cwd: runtimeCwd,
     env: {
       ...process.env,
       LIVEDESK_DESKTOP_HOST: '1',
       LIVEDESK_MANAGER_VERSION: app.getVersion(),
-      LIVEDESK_NPM_LAUNCHER_NAME: 'livedesk',
-      LIVEDESK_NPM_LAUNCHER_VERSION: app.getVersion(),
-      LIVEDESK_STATE_DIR: runtimeStateDir,
-      LIVEDESK_ROLE_TAKEOVER: roleTakeover ? '1' : '',
+      LIVEDESK_NPM_LAUNCHER_NAME: 'livedesk',
+      LIVEDESK_NPM_LAUNCHER_VERSION: app.getVersion(),
+      LIVEDESK_STATE_DIR: runtimeStateDir,
+      LIVEDESK_ROLE_TAKEOVER: roleTakeover ? '1' : '',
       ...(preResolvedRole ? {
         LIVEDESK_PRE_RESOLVED_ROLE: preResolvedRole,
         LIVEDESK_ROLE_SOURCE: String(options.source || 'supabase'),
@@ -450,23 +451,23 @@ function startRuntime(options = {}) {
   // `exit` starts descendant cleanup without waiting for inherited stdio to
   // close. `close` is the failed-spawn fallback because Node does not promise
   // a corresponding `exit` event after every ChildProcess `error`.
-  const handleRuntimeTerminal = (code, signal, source) => {
+  const handleRuntimeTerminal = (code, signal, source) => {
     if (runtimeTerminalHandled) return;
-    runtimeTerminalHandled = true;
-    log(`runtime terminal source=${source} code=${code ?? 'null'} signal=${signal || 'none'}`);
-    const expectedRoleAfterExit = expectedRuntimeRole();
-    const takeoverWasPending = runtimeRoleTakeoverPending;
-    runtimeRoleTakeoverPending = resolveDesktopHubTakeoverPending({
-      pending: runtimeRoleTakeoverPending,
-      exitCode: code,
-      signal,
-      expectedRole: expectedRoleAfterExit
-    });
-    if (runtimeRoleTakeoverPending !== takeoverWasPending) {
-      log(runtimeRoleTakeoverPending
-        ? 'desktop role transition retained one-shot Hub target takeover authority'
-        : 'desktop role transition cleared Hub target takeover authority for Client startup');
-    }
+    runtimeTerminalHandled = true;
+    log(`runtime terminal source=${source} code=${code ?? 'null'} signal=${signal || 'none'}`);
+    const expectedRoleAfterExit = expectedRuntimeRole();
+    const takeoverWasPending = runtimeRoleTakeoverPending;
+    runtimeRoleTakeoverPending = resolveDesktopHubTakeoverPending({
+      pending: runtimeRoleTakeoverPending,
+      exitCode: code,
+      signal,
+      expectedRole: expectedRoleAfterExit
+    });
+    if (runtimeRoleTakeoverPending !== takeoverWasPending) {
+      log(runtimeRoleTakeoverPending
+        ? 'desktop role transition retained one-shot Hub target takeover authority'
+        : 'desktop role transition cleared Hub target takeover authority for Client startup');
+    }
     const continueAfterExactDrain = async () => {
       try {
         const drainDeadline = Number(child.livedeskRuntimeStopDeadline || 0)
@@ -506,42 +507,42 @@ function startRuntime(options = {}) {
     };
     void continueAfterExactDrain();
   };
-  child.once('exit', (code, signal) => handleRuntimeTerminal(code, signal, 'exit'));
-  child.once('close', (code, signal) => handleRuntimeTerminal(code, signal, 'close'));
-  if (roleTakeover) void monitorDesktopHubTakeoverPublication(child);
-  log(`runtime started pid=${child.pid}`);
-  return child;
-}
-
-async function monitorDesktopHubTakeoverPublication(child) {
-  while (!isQuitting && runtimeChild === child && runtimeRoleTakeoverPending) {
-    try {
-      const deadline = Date.now() + 1_000;
-      const status = await fetchBeforeRuntimeDeadline(
-        fetch,
-        `${LOCAL_RUNTIME_URL}api/hub/status`,
-        { cache: 'no-store' },
-        {
-          deadline,
-          maxDurationMs: remainingRuntimeDeadlineMs(deadline),
-          label: 'hub-role-takeover-publication-deadline',
-          consumeResponse: response => response.json()
-        }
-      );
-      if (desktopHubTakeoverPublicationConfirmed(status)) {
-        if (runtimeChild === child) {
-          runtimeRoleTakeoverPending = false;
-          log('desktop Hub target takeover completed and one-shot authority was released');
-        }
-        return true;
-      }
-    } catch {
-      // The replacement Hub may still be starting or retrying its saved session.
-    }
-    await new Promise(resolveDelay => setTimeout(resolveDelay, 1_000));
-  }
-  return false;
-}
+  child.once('exit', (code, signal) => handleRuntimeTerminal(code, signal, 'exit'));
+  child.once('close', (code, signal) => handleRuntimeTerminal(code, signal, 'close'));
+  if (roleTakeover) void monitorDesktopHubTakeoverPublication(child);
+  log(`runtime started pid=${child.pid}`);
+  return child;
+}
+
+async function monitorDesktopHubTakeoverPublication(child) {
+  while (!isQuitting && runtimeChild === child && runtimeRoleTakeoverPending) {
+    try {
+      const deadline = Date.now() + 1_000;
+      const status = await fetchBeforeRuntimeDeadline(
+        fetch,
+        `${LOCAL_RUNTIME_URL}api/hub/status`,
+        { cache: 'no-store' },
+        {
+          deadline,
+          maxDurationMs: remainingRuntimeDeadlineMs(deadline),
+          label: 'hub-role-takeover-publication-deadline',
+          consumeResponse: response => response.json()
+        }
+      );
+      if (desktopHubTakeoverPublicationConfirmed(status)) {
+        if (runtimeChild === child) {
+          runtimeRoleTakeoverPending = false;
+          log('desktop Hub target takeover completed and one-shot authority was released');
+        }
+        return true;
+      }
+    } catch {
+      // The replacement Hub may still be starting or retrying its saved session.
+    }
+    await new Promise(resolveDelay => setTimeout(resolveDelay, 1_000));
+  }
+  return false;
+}
 
 function expectedRuntimeRole() {
   const forcedRole = String(process.env.LIVEDESK_FORCE_ROLE || '').trim().toLowerCase();
@@ -1071,11 +1072,11 @@ function registerIpc() {
       return { ok: false, error: 'application-exit-already-started' };
     }
     quitSequenceStarted = true;
-    isQuitting = true;
-    try {
-      await stopRuntime();
-      await desktopClipboardOwner?.close();
-      await closeDesktopLog();
+    isQuitting = true;
+    try {
+      await stopRuntime();
+      await desktopClipboardOwner?.close();
+      await closeDesktopLog();
       app.relaunch();
       app.exit(0);
       return { ok: true };
@@ -1142,32 +1143,32 @@ function registerIpc() {
     } catch (error) { return { ok: false, error: mask(error?.message || error) }; }
   });
   handle('logs:open-folder', () => shell.openPath(logDir));
-  handle('logs:copy-diagnostics', async () => {
+  handle('logs:copy-diagnostics', async () => {
     const status = await fetch(`${LOCAL_RUNTIME_URL}api/runtime/status`).then(response => response.json()).catch(error => ({ ok: false, error: mask(error?.message || error) }));
     const diagnostics = JSON.stringify({ appVersion: app.getVersion(), runtime: status, logDir }, null, 2);
-    clipboard.writeText(mask(diagnostics));
-    return { ok: true };
-  });
-  handle('clipboard:read-snapshot', operationId => desktopClipboardOwner?.readSnapshot(operationId)
-    || Promise.reject(new Error('clipboard-helper-unavailable')));
-  handle('clipboard:read-chunk', request => desktopClipboardOwner?.readChunk(request)
-    || Promise.reject(new Error('clipboard-helper-unavailable')));
-  handle('clipboard:release-read', operationId => desktopClipboardOwner?.releaseRead(operationId)
-    || Promise.resolve({ ok: true }));
-  handle('clipboard:begin-write', manifest => desktopClipboardOwner?.beginWrite(manifest)
-    || Promise.reject(new Error('clipboard-helper-unavailable')));
-  handle('clipboard:write-chunk', request => desktopClipboardOwner?.writeChunk(request)
-    || Promise.reject(new Error('clipboard-helper-unavailable')));
-  handle('clipboard:commit-write', operationId => desktopClipboardOwner?.commitWrite(operationId)
-    || Promise.reject(new Error('clipboard-helper-unavailable')));
-  handle('clipboard:cancel-write', operationId => desktopClipboardOwner?.cancelWrite(operationId)
-    || Promise.resolve({ ok: true }));
+    clipboard.writeText(mask(diagnostics));
+    return { ok: true };
+  });
+  handle('clipboard:read-snapshot', operationId => desktopClipboardOwner?.readSnapshot(operationId)
+    || Promise.reject(new Error('clipboard-helper-unavailable')));
+  handle('clipboard:read-chunk', request => desktopClipboardOwner?.readChunk(request)
+    || Promise.reject(new Error('clipboard-helper-unavailable')));
+  handle('clipboard:release-read', operationId => desktopClipboardOwner?.releaseRead(operationId)
+    || Promise.resolve({ ok: true }));
+  handle('clipboard:begin-write', manifest => desktopClipboardOwner?.beginWrite(manifest)
+    || Promise.reject(new Error('clipboard-helper-unavailable')));
+  handle('clipboard:write-chunk', request => desktopClipboardOwner?.writeChunk(request)
+    || Promise.reject(new Error('clipboard-helper-unavailable')));
+  handle('clipboard:commit-write', operationId => desktopClipboardOwner?.commitWrite(operationId)
+    || Promise.reject(new Error('clipboard-helper-unavailable')));
+  handle('clipboard:cancel-write', operationId => desktopClipboardOwner?.cancelWrite(operationId)
+    || Promise.resolve({ ok: true }));
   handle('app:about', async () => {
     await dialog.showMessageBox(mainWindow, {
       type: 'info',
       title: APP_NAME,
       message: APP_NAME,
-      detail: `Version ${app.getVersion()}\nOne LiveDesk runtime with Hub and Client roles.`
+      detail: `Version ${app.getVersion()}\nOne VuvoDesk runtime with Hub and Client roles.`
     });
     return { ok: true };
   });
@@ -1180,14 +1181,14 @@ function createTray() {
   const iconPath = appResource('electron', process.platform === 'win32' ? 'tray.ico' : 'tray.png');
   tray = new Tray(existsSync(iconPath) ? iconPath : nativeImage.createFromDataURL(FALLBACK_ICON_DATA_URL));
   const menu = Menu.buildFromTemplate([
-    { label: 'Show LiveDesk', click: showWindow },
+    { label: 'Show VuvoDesk', click: showWindow },
     { label: 'Restart runtime', click: () => requestRuntimeRestart('tray') },
     { label: 'Check for updates', click: () => { void productUpdates?.check(); } },
-    { label: 'About LiveDesk', click: () => { void dialog.showMessageBox(mainWindow, { type: 'info', title: APP_NAME, message: APP_NAME, detail: `Version ${app.getVersion()}\nOne LiveDesk runtime with Hub and Client roles.` }); } },
+    { label: 'About VuvoDesk', click: () => { void dialog.showMessageBox(mainWindow, { type: 'info', title: APP_NAME, message: APP_NAME, detail: `Version ${app.getVersion()}\nOne VuvoDesk runtime with Hub and Client roles.` }); } },
     { label: 'Open logs', click: () => { void shell.openPath(logDir); } },
     { type: 'separator' },
-    { label: 'Start with Windows', type: 'checkbox', checked: app.getLoginItemSettings().openAtLogin, click: item => app.setLoginItemSettings({ openAtLogin: item.checked, name: APP_NAME }) },
-    { label: 'Quit LiveDesk', click: () => { app.quit(); } }
+    { label: 'Start with Windows', type: 'checkbox', checked: app.getLoginItemSettings().openAtLogin, click: item => app.setLoginItemSettings({ openAtLogin: item.checked, name: DESKTOP_STARTUP_ENTRY_NAME }) },
+    { label: 'Quit VuvoDesk', click: () => { app.quit(); } }
   ]);
   tray.setContextMenu(menu);
   tray.on('click', showWindow);
@@ -1226,20 +1227,20 @@ if (!app.requestSingleInstanceLock()) {
       beforeInstall: prepareRuntimeForUpdateInstall,
       onInstallError: recoverRuntimeAfterUpdateInstallError
     });
-    recurringProductUpdates = createRecurringProductUpdateOwner({
+    recurringProductUpdates = createRecurringProductUpdateOwner({
       manager: productUpdates,
       canRun: () => !isQuitting && !quitSequenceStarted && !updateInstallSequenceStarted,
       initialDelayMs: 15_000,
       intervalMs: 30_000,
-      onError: error => log(`recurring desktop update failed: ${error?.message || error}`)
-    });
-    const clipboardHelperPath = resolveClipboardHelperPath();
-    desktopClipboardOwner = createDesktopClipboardOwner({
-      rootDir: join(stateRoot, 'clipboard-staging'),
-      helperPath: clipboardHelperPath
-    });
-    if (!clipboardHelperPath) log('desktop clipboard helper unavailable for this platform');
-    registerIpc();
+      onError: error => log(`recurring desktop update failed: ${error?.message || error}`)
+    });
+    const clipboardHelperPath = resolveClipboardHelperPath();
+    desktopClipboardOwner = createDesktopClipboardOwner({
+      rootDir: join(stateRoot, 'clipboard-staging'),
+      helperPath: clipboardHelperPath
+    });
+    if (!clipboardHelperPath) log('desktop clipboard helper unavailable for this platform');
+    registerIpc();
     powerMonitor.on('resume', () => requestDesktopResumeAuthRecovery('system-resume'));
     powerMonitor.on('unlock-screen', () => requestDesktopResumeAuthRecovery('screen-unlock'));
     if (DESKTOP_BUILD_FLAVOR !== 'e2e') {
@@ -1277,11 +1278,11 @@ if (!app.requestSingleInstanceLock()) {
     event.preventDefault();
     recurringProductUpdates?.stop();
     quitSequenceStarted = true;
-    isQuitting = true;
-    void stopRuntime().then(() => {
-      return desktopClipboardOwner?.close();
-    }).then(() => {
-      return closeDesktopLog();
+    isQuitting = true;
+    void stopRuntime().then(() => {
+      return desktopClipboardOwner?.close();
+    }).then(() => {
+      return closeDesktopLog();
     }).then(() => {
       app.quit();
     }).catch(error => {

package/electron/preload.cjs

@@ -24,20 +24,20 @@ contextBridge.exposeInMainWorld('liveDesk', {
     restart: () => ipcRenderer.invoke('runtime:restart'),
     switchRole: role => ipcRenderer.invoke('runtime:switch-role', role)
   },
-  logs: {
+  logs: {
     openFolder: () => ipcRenderer.invoke('logs:open-folder'),
-    copyDiagnostics: () => ipcRenderer.invoke('logs:copy-diagnostics')
-  },
-  clipboard: {
-    readSnapshot: operationId => ipcRenderer.invoke('clipboard:read-snapshot', operationId),
-    readChunk: request => ipcRenderer.invoke('clipboard:read-chunk', request),
-    releaseRead: operationId => ipcRenderer.invoke('clipboard:release-read', operationId),
-    beginWrite: manifest => ipcRenderer.invoke('clipboard:begin-write', manifest),
-    writeChunk: request => ipcRenderer.invoke('clipboard:write-chunk', request),
-    commitWrite: operationId => ipcRenderer.invoke('clipboard:commit-write', operationId),
-    cancelWrite: operationId => ipcRenderer.invoke('clipboard:cancel-write', operationId)
-  },
-  updates: {
+    copyDiagnostics: () => ipcRenderer.invoke('logs:copy-diagnostics')
+  },
+  clipboard: {
+    readSnapshot: operationId => ipcRenderer.invoke('clipboard:read-snapshot', operationId),
+    readChunk: request => ipcRenderer.invoke('clipboard:read-chunk', request),
+    releaseRead: operationId => ipcRenderer.invoke('clipboard:release-read', operationId),
+    beginWrite: manifest => ipcRenderer.invoke('clipboard:begin-write', manifest),
+    writeChunk: request => ipcRenderer.invoke('clipboard:write-chunk', request),
+    commitWrite: operationId => ipcRenderer.invoke('clipboard:commit-write', operationId),
+    cancelWrite: operationId => ipcRenderer.invoke('clipboard:cancel-write', operationId)
+  },
+  updates: {
     getStatus: () => ipcRenderer.invoke('updates:get-status'),
     check: () => ipcRenderer.invoke('updates:check'),
     install: () => ipcRenderer.invoke('updates:install'),

package/electron/runtime-role-transition.mjs

@@ -1,17 +1,17 @@
-export const DESKTOP_ROLE_TRANSITION_EXIT_CODE = 43;
-
-export function resolveDesktopHubTakeoverPending(options = {}) {
-  const pending = options.pending === true;
-  const signal = String(options.signal || '').trim();
-  const exitCode = Number(options.exitCode);
-  if (signal || exitCode !== DESKTOP_ROLE_TRANSITION_EXIT_CODE) {
-    return pending;
-  }
-  return String(options.expectedRole || '').trim().toLowerCase() === 'hub';
-}
-
-export function desktopHubTakeoverPublicationConfirmed(status = {}) {
-  return String(status.role || '').trim().toLowerCase() === 'hub'
-    && status.hostTargetActive === true
-    && String(status.hostTargetLease?.state || '').trim().toLowerCase() === 'active';
-}
+export const DESKTOP_ROLE_TRANSITION_EXIT_CODE = 43;
+
+export function resolveDesktopHubTakeoverPending(options = {}) {
+  const pending = options.pending === true;
+  const signal = String(options.signal || '').trim();
+  const exitCode = Number(options.exitCode);
+  if (signal || exitCode !== DESKTOP_ROLE_TRANSITION_EXIT_CODE) {
+    return pending;
+  }
+  return String(options.expectedRole || '').trim().toLowerCase() === 'hub';
+}
+
+export function desktopHubTakeoverPublicationConfirmed(status = {}) {
+  return String(status.role || '').trim().toLowerCase() === 'hub'
+    && status.hostTargetActive === true
+    && String(status.hostTargetLease?.state || '').trim().toLowerCase() === 'active';
+}