@livedesk/hub 0.1.41 → 0.1.43

package/src/server.js

@@ -7,8 +7,9 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, wri
 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 { WebSocketServer } from 'ws';
+import { createRemoteHub } from './remote-hub.js';
+import { createHubConsoleRelay } from './console-relay.js';
 import {
   buildImmutableRemoteFramePacket,
   createRemoteFramePacketMetrics,
@@ -51,13 +52,13 @@ import { normalizeRuntimeAuthSession, runtimeRoleError } from '../../runtime-cor
 import { fetchAuthResponse, AUTH_REQUEST_TIMEOUT_MS } from '../../runtime-core/src/auth-http.js';
 import { PRODUCTION_SUPABASE_PUBLISHABLE_KEY, PRODUCTION_SUPABASE_URL } from '../../runtime-core/src/auth-config.js';
 import { createHubRuntime } from './runtime/hub-runtime.js';
-import { hubRuntimeStatus } from './runtime/hub-runtime-status.js';
-import { roleGuardResponse } from './http/hub-role-guard.js';
-import {
-  clearHubUiSessionCookie,
-  createHubUiSessionAuthority,
-  serializeHubUiSessionCookie
-} from './http/hub-ui-session.js';
+import { hubRuntimeStatus } from './runtime/hub-runtime-status.js';
+import { roleGuardResponse } from './http/hub-role-guard.js';
+import {
+  clearHubUiSessionCookie,
+  createHubUiSessionAuthority,
+  serializeHubUiSessionCookie
+} from './http/hub-ui-session.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const webDistCandidates = [
@@ -187,10 +188,10 @@ const persistentSessionGcToken = persistentSessionGcEnabled
   ? String(process.env.LIVEDESK_PERSISTENT_SESSION_TEST_TOKEN || '').trim()
   : '';
 let connectedDeviceCount = 0;
-let runtimeAccessToken = '';
-let runtimeRefreshToken = '';
-let runtimeAccessTokenExpiresAt = 0;
-const hubUiSessionAuthority = createHubUiSessionAuthority();
+let runtimeAccessToken = '';
+let runtimeRefreshToken = '';
+let runtimeAccessTokenExpiresAt = 0;
+const hubUiSessionAuthority = createHubUiSessionAuthority();
 let roleWatchInFlight = false;
 let verifiedLicense = {
   userId: '',
@@ -202,15 +203,22 @@ let verifiedLicense = {
 let frameClientSeq = 0;
 let inputClientSeq = 0;
 let audioClientSeq = 0;
-let liveDeskUpdateManager = null;
-let hubTransferJobs = null;
+let liveDeskUpdateManager = null;
+let hubTransferJobs = null;
+let hubConsoleRelay = null;
 const HUB_HOST_TARGET_LEASE_MS = Math.max(5000, readPositiveIntegerEnv('LIVEDESK_HOST_TARGET_LEASE_MS', 60_000));
 const HUB_HOST_TARGET_RENEW_MS = Math.max(1000, Math.min(
   readPositiveIntegerEnv('LIVEDESK_HOST_TARGET_RENEW_MS', 20_000),
   Math.max(1000, HUB_HOST_TARGET_LEASE_MS - 1000)
 ));
-const HUB_ACCESS_TOKEN_REFRESH_SKEW_MS = 90_000;
-const hubWakeBaseUrl = String(process.env.LIVEDESK_WAKE_URL || 'https://livedesk-wake.lovecrdm.workers.dev').trim();
+const HUB_ACCESS_TOKEN_REFRESH_SKEW_MS = 90_000;
+const hubWakeBaseUrl = String(process.env.LIVEDESK_WAKE_URL || 'https://livedesk-wake.lovecrdm.workers.dev').trim();
+const hubConsoleRelayBaseUrl = String(
+  process.env.LIVEDESK_CONSOLE_RELAY_URL
+  || (process.env.LIVEDESK_TEST_MODE === '1' || process.env.LIVEDESK_AUTH_TEST_MODE === '1'
+    ? 'off'
+    : 'https://livedesk-wake.lovecrdm.workers.dev')
+).trim();
 const HUB_WAKE_NOTIFY_RETRY_MS = 60_000;
 let hubHostTargetRenewTimer = null;
 let hubHostTargetRenewInFlight = false;
@@ -491,12 +499,12 @@ function clearPersistedRuntimeSession() {
   return writePrivateRuntimeAuthState(state);
 }
 
-function clearRuntimeSession() {
-  runtimeAccessToken = '';
-  runtimeRefreshToken = '';
-  runtimeAccessTokenExpiresAt = 0;
-  hubUiSessionAuthority.revokeAll();
-  runtimeManager.setAuthenticated(false);
+function clearRuntimeSession() {
+  runtimeAccessToken = '';
+  runtimeRefreshToken = '';
+  runtimeAccessTokenExpiresAt = 0;
+  hubUiSessionAuthority.revokeAll();
+  runtimeManager.setAuthenticated(false);
   try { clearPersistedRuntimeSession(); } catch { /* runtime auth is already invalid */ }
 }
 
@@ -796,11 +804,12 @@ 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 || '',
-    restartSupported: !!String(process.env.LIVEDESK_HUB_UPDATE_REQUEST_PATH || '').trim(),
+  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
   });
 }
@@ -1332,9 +1341,16 @@ const hubSharedFolders = createHubSharedFolders({
   dataDir: agentDataDir
 });
 
-const app = express();
-const httpServer = createServer(app);
-const httpConnections = new Set();
+const app = express();
+const httpServer = createServer(app);
+hubConsoleRelay = createHubConsoleRelay({
+  url: runtimeRole === 'hub' ? hubConsoleRelayBaseUrl : 'off',
+  deviceId: runtimeDeviceId,
+  httpBaseUrl: `http://127.0.0.1:${httpPort}`,
+  getAccessToken: () => getRuntimeAccessToken(),
+  logger: console
+});
+const httpConnections = new Set();
 const frameWss = new WebSocketServer({ noServer: true, perMessageDeflate: false });
 const atlasWss = new WebSocketServer({ noServer: true, perMessageDeflate: false });
 const inputWss = new WebSocketServer({ noServer: true, perMessageDeflate: false });
@@ -1412,7 +1428,7 @@ function requestHostname(req) {
   }
 }
 
-function isTrustedBrowserRequest(req) {
+function isTrustedBrowserRequest(req) {
   const origin = String(req.headers.origin || '').trim();
   if (!origin) {
     const fetchSite = String(req.headers['sec-fetch-site'] || '').toLowerCase();
@@ -1429,59 +1445,59 @@ function isTrustedBrowserRequest(req) {
     const targetHost = requestHostname(req);
     return (originHost === targetHost && isPrivateHubHostname(targetHost))
       || (isLoopbackHostname(originHost) && isLoopbackHostname(targetHost));
-  } catch {
-    return false;
-  }
-}
-
-function isSecureHubHttpRequest(req) {
-  return req.socket?.encrypted === true
-    || String(req.headers['x-forwarded-proto'] || '').trim().toLowerCase() === 'https';
-}
-
-function currentBoundHubUserId() {
-  return String(
-    runtimeManager.getSnapshot().userId
-    || readPersistedRuntimeSession()?.user?.id
-    || ''
-  ).trim();
-}
-
-function isPublicHubApiRequest(req) {
-  const method = String(req.method || 'GET').toUpperCase();
-  const path = String(req.path || '');
-  return (method === 'GET' && (path === '/api/health' || path === '/api/runtime/status' || path === '/api/auth/status'))
-    || (method === 'POST' && path === '/api/auth/session');
-}
-
-function isTrustedNativeLoopbackRequest(req) {
-  return isLoopbackAddress(req.socket?.remoteAddress)
-    && !String(req.headers.origin || '').trim()
-    && !String(req.headers['sec-fetch-site'] || '').trim();
-}
-
-function authorizeHubUiRequest(req) {
-  if (process.env.LIVEDESK_TEST_MODE === '1') {
-    return { ok: true, explicitTestMode: true };
-  }
-  if (isTrustedNativeLoopbackRequest(req)) {
-    return { ok: true, nativeLoopback: true };
-  }
-  return hubUiSessionAuthority.authorize(req, currentBoundHubUserId());
-}
-
-app.use((req, res, next) => {
+  } catch {
+    return false;
+  }
+}
+
+function isSecureHubHttpRequest(req) {
+  return req.socket?.encrypted === true
+    || String(req.headers['x-forwarded-proto'] || '').trim().toLowerCase() === 'https';
+}
+
+function currentBoundHubUserId() {
+  return String(
+    runtimeManager.getSnapshot().userId
+    || readPersistedRuntimeSession()?.user?.id
+    || ''
+  ).trim();
+}
+
+function isPublicHubApiRequest(req) {
+  const method = String(req.method || 'GET').toUpperCase();
+  const path = String(req.path || '');
+  return (method === 'GET' && (path === '/api/health' || path === '/api/runtime/status' || path === '/api/auth/status'))
+    || (method === 'POST' && path === '/api/auth/session');
+}
+
+function isTrustedNativeLoopbackRequest(req) {
+  return isLoopbackAddress(req.socket?.remoteAddress)
+    && !String(req.headers.origin || '').trim()
+    && !String(req.headers['sec-fetch-site'] || '').trim();
+}
+
+function authorizeHubUiRequest(req) {
+  if (process.env.LIVEDESK_TEST_MODE === '1') {
+    return { ok: true, explicitTestMode: true };
+  }
+  if (isTrustedNativeLoopbackRequest(req)) {
+    return { ok: true, nativeLoopback: true };
+  }
+  return hubUiSessionAuthority.authorize(req, currentBoundHubUserId());
+}
+
+app.use((req, res, next) => {
   if (!isTrustedBrowserRequest(req)) {
     res.status(403).json({ ok: false, error: 'untrusted-hub-origin' });
     return;
   }
   const origin = String(req.headers.origin || '').trim();
   if (origin) {
-    res.setHeader('Access-Control-Allow-Origin', origin);
-    res.setHeader('Access-Control-Allow-Credentials', 'true');
-    res.setHeader('Access-Control-Allow-Private-Network', 'true');
+    res.setHeader('Access-Control-Allow-Origin', origin);
+    res.setHeader('Access-Control-Allow-Credentials', 'true');
+    res.setHeader('Access-Control-Allow-Private-Network', 'true');
     res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, PATCH, DELETE, OPTIONS');
-    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-LiveDesk-CSRF');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-LiveDesk-CSRF');
     res.setHeader('Vary', 'Origin, Access-Control-Request-Headers, Access-Control-Request-Private-Network');
   }
   if (req.method === 'OPTIONS') {
@@ -1490,21 +1506,21 @@ app.use((req, res, next) => {
   }
   next();
 });
-app.use(express.json({ limit: '32mb' }));
-app.use((req, res, next) => {
-  if (!req.path.startsWith('/api/') || isPublicHubApiRequest(req)) {
-    next();
-    return;
-  }
-  const authorization = authorizeHubUiRequest(req);
-  if (!authorization.ok) {
-    noStore(res);
-    res.status(authorization.status).json({ ok: false, error: authorization.error });
-    return;
-  }
-  next();
-});
-app.use((req, res, next) => {
+app.use(express.json({ limit: '32mb' }));
+app.use((req, res, next) => {
+  if (!req.path.startsWith('/api/') || isPublicHubApiRequest(req)) {
+    next();
+    return;
+  }
+  const authorization = authorizeHubUiRequest(req);
+  if (!authorization.ok) {
+    noStore(res);
+    res.status(authorization.status).json({ ok: false, error: authorization.error });
+    return;
+  }
+  next();
+});
+app.use((req, res, next) => {
   if (runtimeRole === 'client' && req.path.startsWith('/api/remote')) {
     res.status(403).json(roleGuardResponse(runtimeRole, 'hub'));
     return;
@@ -2767,7 +2783,7 @@ function enqueueFramePacketForClient(ws, packetOwner, meta) {
 }
 // FRAME_LANE_GENERATION_CONTRACT_END
 
-function updateFrameSubscription(ws, payload = {}) {
+function updateFrameSubscription(ws, payload = {}) {
   const previousDeviceIds = ws.liveDeskDeviceIds instanceof Set
     ? new Set(ws.liveDeskDeviceIds)
     : new Set();
@@ -2800,43 +2816,43 @@ function updateFrameSubscription(ws, payload = {}) {
   const targetIds = newlySubscribedIds.length > 0 ? newlySubscribedIds : deviceIds;
   for (const deviceId of targetIds.slice(0, 80)) {
     startFrameSubscriptionLive(ws, 'subscribe', deviceId, { reuseExisting: true });
-  }
-}
-
-function refreshFrameSubscriptionLive(ws, payload = {}) {
-  if (!ws || ws.readyState !== 1) {
-    return;
-  }
-  const requestedIds = normalizeDeviceIds(payload.deviceIds ?? payload.devices ?? payload.deviceId);
-  const subscribedIds = [...(ws.liveDeskDeviceIds || [])];
-  const targetIds = requestedIds.length > 0
-    ? requestedIds.filter(deviceId => ws.liveDeskDeviceIds?.has?.(deviceId))
-    : subscribedIds;
-  if (targetIds.length === 0) {
-    return;
-  }
-  ws.liveDeskAutoStart = /^(1|true|yes|on|live)$/i.test(String(
-    payload.autoStartLive ?? payload.startLive ?? ws.liveDeskAutoStart ?? ''
-  ));
-  ws.liveDeskLiveOptions = normalizeLiveOptions({
-    ...(ws.liveDeskLiveOptions || {}),
-    ...payload,
-    forceRestart: false,
-    reuseExisting: true,
-    monitorSelections: {
-      ...(ws.liveDeskLiveOptions?.monitorSelections || {}),
-      ...(payload.monitorSelections || {})
-    }
-  });
-  for (const deviceId of targetIds.slice(0, 80)) {
-    startFrameSubscriptionLive(ws, 'watchdog', deviceId, {
-      ...ws.liveDeskLiveOptions,
-      reuseExisting: true
-    });
-  }
-}
-
-function startFrameSubscriptionLive(
+  }
+}
+
+function refreshFrameSubscriptionLive(ws, payload = {}) {
+  if (!ws || ws.readyState !== 1) {
+    return;
+  }
+  const requestedIds = normalizeDeviceIds(payload.deviceIds ?? payload.devices ?? payload.deviceId);
+  const subscribedIds = [...(ws.liveDeskDeviceIds || [])];
+  const targetIds = requestedIds.length > 0
+    ? requestedIds.filter(deviceId => ws.liveDeskDeviceIds?.has?.(deviceId))
+    : subscribedIds;
+  if (targetIds.length === 0) {
+    return;
+  }
+  ws.liveDeskAutoStart = /^(1|true|yes|on|live)$/i.test(String(
+    payload.autoStartLive ?? payload.startLive ?? ws.liveDeskAutoStart ?? ''
+  ));
+  ws.liveDeskLiveOptions = normalizeLiveOptions({
+    ...(ws.liveDeskLiveOptions || {}),
+    ...payload,
+    forceRestart: false,
+    reuseExisting: true,
+    monitorSelections: {
+      ...(ws.liveDeskLiveOptions?.monitorSelections || {}),
+      ...(payload.monitorSelections || {})
+    }
+  });
+  for (const deviceId of targetIds.slice(0, 80)) {
+    startFrameSubscriptionLive(ws, 'watchdog', deviceId, {
+      ...ws.liveDeskLiveOptions,
+      reuseExisting: true
+    });
+  }
+}
+
+function startFrameSubscriptionLive(
   ws,
   reason = 'subscribe',
   onlyDeviceId = '',
@@ -4218,9 +4234,10 @@ app.get('/api/remote/status', (_req, res) => {
     runtimeRole,
     deviceId: runtimeDeviceId,
     deviceName: runtimeDeviceName,
-    roleSource: runtimeRoleSource,
-    agentPackage: '@livedesk/client',
-    frameLanes: snapshotFrameLaneResourceHealth(),
+    roleSource: runtimeRoleSource,
+    agentPackage: '@livedesk/client',
+    consoleRelay: hubConsoleRelay?.inspect() || { enabled: false, state: 'starting' },
+    frameLanes: snapshotFrameLaneResourceHealth(),
     update: getLiveDeskUpdateStatus()
   });
 });
@@ -4408,19 +4425,19 @@ app.post('/api/auth/session', async (req, res) => {
     res.status(400).json({ ok: false, error: normalized.error });
     return;
   }
-  const { access_token: accessToken, refresh_token: refreshToken, expires_at: expiresAt } = normalized.session;
-  try {
-    const user = await verifySupabaseUser(accessToken);
-    const boundUserId = currentBoundHubUserId();
-    if (boundUserId && boundUserId !== user.id) {
-      res.status(403).json({ ok: false, error: 'hub-account-mismatch' });
-      return;
-    }
-    if (!boundUserId && !isLoopbackAddress(req.socket?.remoteAddress)) {
-      res.status(403).json({ ok: false, error: 'hub-first-account-binding-must-be-local' });
-      return;
-    }
-    runtimeAccessToken = accessToken;
+  const { access_token: accessToken, refresh_token: refreshToken, expires_at: expiresAt } = normalized.session;
+  try {
+    const user = await verifySupabaseUser(accessToken);
+    const boundUserId = currentBoundHubUserId();
+    if (boundUserId && boundUserId !== user.id) {
+      res.status(403).json({ ok: false, error: 'hub-account-mismatch' });
+      return;
+    }
+    if (!boundUserId && !isLoopbackAddress(req.socket?.remoteAddress)) {
+      res.status(403).json({ ok: false, error: 'hub-first-account-binding-must-be-local' });
+      return;
+    }
+    runtimeAccessToken = accessToken;
     runtimeRefreshToken = refreshToken;
     runtimeAccessTokenExpiresAt = normalizeSessionExpiryMs(expiresAt);
     runtimeManager.setAuthenticated(true, user.id);
@@ -4430,30 +4447,31 @@ app.post('/api/auth/session', async (req, res) => {
       expires_at: expiresAt,
       user
     });
-    const hostTarget = runtimeRole === 'hub'
-      ? {
-          ok: true,
-          pending: true,
-          active: remoteHub.getStatus({ includeSecrets: false }).hostTargetActive === true
-        }
-      : { ok: true, pending: false, active: false };
-    const uiSession = hubUiSessionAuthority.issue(user.id);
-    res.setHeader('Set-Cookie', serializeHubUiSessionCookie(uiSession.sessionId, uiSession.expiresAt, {
-      secure: isSecureHubHttpRequest(req)
-    }));
-    res.json({
-      ok: true,
-      authenticated: true,
-      persisted,
-      userId: user.id,
-      role: runtimeRole,
-      hostTarget,
-      uiSession: {
-        csrfToken: uiSession.csrfToken,
-        expiresAt: uiSession.expiresAt
-      }
+    const hostTarget = runtimeRole === 'hub'
+      ? {
+          ok: true,
+          pending: true,
+          active: remoteHub.getStatus({ includeSecrets: false }).hostTargetActive === true
+        }
+      : { ok: true, pending: false, active: false };
+    const uiSession = hubUiSessionAuthority.issue(user.id);
+    res.setHeader('Set-Cookie', serializeHubUiSessionCookie(uiSession.sessionId, uiSession.expiresAt, {
+      secure: isSecureHubHttpRequest(req)
+    }));
+    res.json({
+      ok: true,
+      authenticated: true,
+      persisted,
+      userId: user.id,
+      role: runtimeRole,
+      hostTarget,
+      uiSession: {
+        csrfToken: uiSession.csrfToken,
+        expiresAt: uiSession.expiresAt
+      }
     });
     if (runtimeRole === 'hub') {
+      hubConsoleRelay?.refresh();
       scheduleAuthenticatedHubHostTargetPublication('session-received');
     }
   } catch (error) {
@@ -4475,10 +4493,11 @@ function getHubHostTargetLeaseStatus() {
     ...hubHostTargetLeaseState,
     renewing: hubHostTargetRenewInFlight,
     renewalIntervalMs: HUB_HOST_TARGET_RENEW_MS,
-    leaseDurationMs: HUB_HOST_TARGET_LEASE_MS,
-    authenticated: Boolean(runtimeAccessToken),
-    timerActive: Boolean(hubHostTargetRenewTimer),
-    wake: { ...hubWakeNotificationState }
+    leaseDurationMs: HUB_HOST_TARGET_LEASE_MS,
+    authenticated: Boolean(runtimeAccessToken),
+    timerActive: Boolean(hubHostTargetRenewTimer),
+    wake: { ...hubWakeNotificationState },
+    consoleRelay: hubConsoleRelay?.inspect() || { enabled: false, state: 'starting' }
   };
 }
 
@@ -4741,36 +4760,36 @@ async function clearHubHostTarget(reason = 'shutdown') {
   return { ok: !error, error, lease: getHubHostTargetLeaseStatus() };
 }
 
-function startHubHostTargetLeaseRenewal() {
+function startHubHostTargetLeaseRenewal() {
   if (hubHostTargetRenewTimer || runtimeRole !== 'hub') {
     return;
   }
   hubHostTargetRenewTimer = setInterval(() => {
     void publishHubHostTargetWithPendingRoleTakeover('renewal');
   }, HUB_HOST_TARGET_RENEW_MS);
-  hubHostTargetRenewTimer.unref?.();
-}
-
-function scheduleAuthenticatedHubHostTargetPublication(reason = 'session-received') {
-  startHubHostTargetLeaseRenewal();
-  setImmediate(() => {
-    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}`);
-    });
-  });
-}
+  hubHostTargetRenewTimer.unref?.();
+}
 
-app.delete('/api/auth/session', async (req, res) => {
+function scheduleAuthenticatedHubHostTargetPublication(reason = 'session-received') {
+  startHubHostTargetLeaseRenewal();
+  setImmediate(() => {
+    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}`);
+    });
+  });
+}
+
+app.delete('/api/auth/session', async (req, res) => {
   noStore(res);
   const hostTarget = runtimeRole === 'hub'
     ? await clearHubHostTarget('logout')
     : { ok: true, active: false };
-  clearRuntimeSession();
-  res.setHeader('Set-Cookie', clearHubUiSessionCookie({ secure: isSecureHubHttpRequest(req) }));
-  res.json({ ok: true, authenticated: false, role: runtimeRole, hostTarget });
-});
+  clearRuntimeSession();
+  res.setHeader('Set-Cookie', clearHubUiSessionCookie({ secure: isSecureHubHttpRequest(req) }));
+  res.json({ ok: true, authenticated: false, role: runtimeRole, hostTarget });
+});
 
 app.get('/api/hub/status', (_req, res) => {
   noStore(res);
@@ -4782,10 +4801,11 @@ app.get('/api/hub/status', (_req, res) => {
     ...remoteHub.getStatus({ includeSecrets: false }),
     role: 'hub',
     deviceId: runtimeDeviceId,
-    deviceName: runtimeDeviceName,
-    roleSource: runtimeRoleSource,
-    runtimeStarted: true,
-    hostTargetLease: getHubHostTargetLeaseStatus(),
+    deviceName: runtimeDeviceName,
+    roleSource: runtimeRoleSource,
+    runtimeStarted: true,
+    consoleRelay: hubConsoleRelay?.inspect() || { enabled: false, state: 'starting' },
+    hostTargetLease: getHubHostTargetLeaseStatus(),
     update: getLiveDeskUpdateStatus()
   });
 });
@@ -5571,20 +5591,20 @@ if (existsSync(webIndexPath)) {
   });
 }
 
-httpServer.on('upgrade', (req, socket, head) => {
-  if (!isTrustedBrowserRequest(req)) {
-    socket.write('HTTP/1.1 403 Forbidden\r\nConnection: close\r\n\r\n');
-    socket.destroy();
-    return;
-  }
-  const authorization = authorizeHubUiRequest(req);
-  if (!authorization.ok) {
-    const label = authorization.status === 403 ? 'Forbidden' : 'Unauthorized';
-    socket.write(`HTTP/1.1 ${authorization.status} ${label}\r\nConnection: close\r\n\r\n`);
-    socket.destroy();
-    return;
-  }
-  try {
+httpServer.on('upgrade', (req, socket, head) => {
+  if (!isTrustedBrowserRequest(req)) {
+    socket.write('HTTP/1.1 403 Forbidden\r\nConnection: close\r\n\r\n');
+    socket.destroy();
+    return;
+  }
+  const authorization = authorizeHubUiRequest(req);
+  if (!authorization.ok) {
+    const label = authorization.status === 403 ? 'Forbidden' : 'Unauthorized';
+    socket.write(`HTTP/1.1 ${authorization.status} ${label}\r\nConnection: close\r\n\r\n`);
+    socket.destroy();
+    return;
+  }
+  try {
     const parsed = new URL(req.url || '/', `http://${req.headers.host || '127.0.0.1'}`);
     if (parsed.pathname === '/api/remote/frames/ws') {
       frameWss.handleUpgrade(req, socket, head, ws => frameWss.emit('connection', ws, req));
@@ -5631,11 +5651,11 @@ frameWss.on('connection', (ws, req) => {
   ws.on('message', data => {
     try {
       const payload = JSON.parse(Buffer.isBuffer(data) ? data.toString('utf8') : String(data || ''));
-      if (payload?.type === 'subscribe') {
-        updateFrameSubscription(ws, payload);
-      } else if (payload?.type === 'refresh-live') {
-        refreshFrameSubscriptionLive(ws, payload);
-      } else if (payload?.type === 'restart-live') {
+      if (payload?.type === 'subscribe') {
+        updateFrameSubscription(ws, payload);
+      } else if (payload?.type === 'refresh-live') {
+        refreshFrameSubscriptionLive(ws, payload);
+      } else if (payload?.type === 'restart-live') {
         restartFrameSubscriptionLive(ws, payload);
       }
     } catch {
@@ -5792,13 +5812,14 @@ hubSharedFolders.startAutoSync(
   () => remoteHub.listDevices({ includeDataUrl: false }).filter(device => device.connected).map(device => device.deviceId),
   () => process.env.LIVEDESK_REMOTE_DIRECTORY || 'Desktop/LiveDeskFiles'
 );
-httpServer.listen(httpPort, httpHost, () => {
+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(`[LiveDesk Hub] HTTP API http://${httpHost}:${httpPort}`);
+  console.log(`[LiveDesk Hub] Client endpoint ${status.agentEndpoint} pair=${status.pairTokenPreview}`);
+  hubConsoleRelay?.start();
+});
 
 const roleWatchTimer = runtimeRole === 'hub'
   ? setInterval(() => { void watchAuthoritativeRuntimeRole(); }, 5000)
@@ -5879,9 +5900,10 @@ function shutdownHub(signal) {
     const startedAt = Date.now();
     console.log(`[LiveDesk Hub] Shutdown started signal=${signal} grace=${hubShutdownGraceMs}ms timeout=${hubShutdownTimeoutMs}ms.`);
     if (roleWatchTimer) clearInterval(roleWatchTimer);
-    clearInterval(browserWebSocketHeartbeatTimer);
-    runSynchronousShutdownStep('update manager close', () => liveDeskUpdateManager?.close());
-    atlasClients.clear();
+    clearInterval(browserWebSocketHeartbeatTimer);
+    runSynchronousShutdownStep('update manager close', () => liveDeskUpdateManager?.close());
+    runSynchronousShutdownStep('mobile console relay close', () => hubConsoleRelay?.close());
+    atlasClients.clear();
     runSynchronousShutdownStep('shared folder close', () => hubSharedFolders.close());
 
     const httpClosed = new Promise(resolveClose => {

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

@@ -1,16 +1,16 @@
-import { effectiveDevicePolicy } from './settings-schema.js';
-
-export function buildEffectiveDevicePolicy(settings, { deviceId = '', capabilities = {} } = {}) {
-  const policy = effectiveDevicePolicy(settings);
-  return {
-    ...policy,
-    deviceId: String(deviceId || ''),
-    supported: {
-      control: capabilities.control !== false,
-      clipboardText: capabilities.clipboardText !== false,
-      fileTransfer: capabilities.fileTransfer !== false,
-      remoteAudio: capabilities.audio === true || capabilities.remoteAudio === true,
-      agent: Array.isArray(capabilities.agentTools) && capabilities.agentTools.length > 0
-    }
-  };
-}
+import { effectiveDevicePolicy } from './settings-schema.js';
+
+export function buildEffectiveDevicePolicy(settings, { deviceId = '', capabilities = {} } = {}) {
+  const policy = effectiveDevicePolicy(settings);
+  return {
+    ...policy,
+    deviceId: String(deviceId || ''),
+    supported: {
+      control: capabilities.control !== false,
+      clipboardText: capabilities.clipboardText !== false,
+      fileTransfer: capabilities.fileTransfer !== false,
+      remoteAudio: capabilities.audio === true || capabilities.remoteAudio === true,
+      agent: Array.isArray(capabilities.agentTools) && capabilities.agentTools.length > 0
+    }
+  };
+}