livedesk 0.1.504 → 0.1.506

package/README.md

@@ -4,8 +4,10 @@
 RemoteFast package for the current operating system and CPU, so Windows, macOS,
 and Linux native binaries are no longer downloaded together.
 
-One-command LiveDesk application. The same launcher resolves this computer's
-Hub or Client role, then starts only the runtime required by that role.
+One-command LiveDesk application. The same launcher resolves this computer's
+Hub or Client role. A Client starts one managed Agent. A Hub starts the Hub
+server plus one headless Self Agent, so the Hub computer also appears on the
+wall and can be controlled like the other computers.
 
 The `hub/`, `client/`, `runtime-core/`, and `web/` folders in this package are
 generated copies. Edit the source packages and run
@@ -43,7 +45,11 @@ npx -y --prefer-online livedesk@latest --force-role client
 npx -y --prefer-online livedesk@latest hub
 ```
 
-This starts the LiveDesk Hub, opens the local screen wall, and accepts clients.
+This starts the LiveDesk Hub, opens the local screen wall, accepts clients, and
+connects one local Self Agent through loopback TCP. The Self Agent reuses the
+Hub computer's stable device identity and does not open another login or status
+page. Hub shutdown, update, and role change drain that exact Agent tree before
+the launcher exits or hands off.
 The Hub UI/API listens on `127.0.0.1` by default while the client endpoint
 continues to listen on the LAN.
 

package/bin/livedesk.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { createRequire } from 'node:module';
 import net from 'node:net';
@@ -46,7 +46,11 @@ import {
   readDeadWindowsOwnedProcessManifest,
   readWindowsOwnedProcessManifest
 } from '../client/src/runtime/windows-owned-process-manifest.js';
-import { inspectMacDiagnosticLease } from '../diagnostics/livedesk-mac-physical-isolation.mjs';
+import { inspectMacDiagnosticLease } from '../diagnostics/livedesk-mac-physical-isolation.mjs';
+import {
+  buildHubSelfAgentLaunchSpec,
+  createHubSelfAgentSupervisor
+} from '../bootstrap/hub-self-agent.js';
 
 const require = createRequire(import.meta.url);
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -2536,9 +2540,47 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
   let updateStopTimer = null;
   let updateHardStopTimer = null;
   let launcherShutdownSignal = '';
-  let launcherShutdownHardStopTimer = null;
-  let runtimeShutdownWatcher = null;
-  const launcherSignalHandlers = new Map();
+  let launcherShutdownHardStopTimer = null;
+  let runtimeShutdownWatcher = null;
+  let selfAgentStopPromise = null;
+  const launcherSignalHandlers = new Map();
+
+  let hubSelfAgent = null;
+  try {
+    const clientEntry = resolve(packageRoot, 'client', 'bin', 'livedesk-client.js');
+    if (!existsSync(clientEntry)) {
+      throw new Error('the packaged Client runtime is missing');
+    }
+    hubSelfAgent = createHubSelfAgentSupervisor({
+      launch: buildHubSelfAgentLaunchSpec({
+        nodePath: process.execPath,
+        clientEntry,
+        remotePort,
+        pairToken,
+        deviceId: env.LIVEDESK_DEVICE_ID,
+        deviceName: env.LIVEDESK_DEVICE_NAME,
+        stateDir: MANAGER_STATE_DIR,
+        runtimeOwner,
+        baseEnv: env
+      }),
+      report: reportLauncherUpdate
+    });
+  } catch (error) {
+    reportLauncherUpdate(
+      `[LiveDesk Hub] Self Agent is unavailable: ${error?.message || error}. Remote Clients remain available.`,
+      true
+    );
+  }
+
+  const stopHubSelfAgent = reason => {
+    if (!hubSelfAgent) return Promise.resolve({ ok: true, skipped: true });
+    if (!selfAgentStopPromise) {
+      selfAgentStopPromise = hubSelfAgent.stop(reason).finally(() => {
+        selfAgentStopPromise = null;
+      });
+    }
+    return selfAgentStopPromise;
+  };
 
   const removeLauncherSignalHandlers = () => {
     for (const [signal, handler] of launcherSignalHandlers) {
@@ -2547,7 +2589,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
     launcherSignalHandlers.clear();
   };
 
-  const requestLauncherShutdown = signal => {
+  const requestLauncherShutdown = signal => {
     if (launcherShutdownSignal) return;
     launcherShutdownSignal = signal;
     restartRequest = null;
@@ -2559,15 +2601,18 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
       clearTimeout(updateStopTimer);
       updateStopTimer = null;
     }
-    if (updateHardStopTimer) {
+    if (updateHardStopTimer) {
       clearTimeout(updateHardStopTimer);
-      updateHardStopTimer = null;
-    }
-    const child = activeChild;
-    if (!child || child.exitCode !== null || child.signalCode) {
-      try { hubLogStream?.end(); } catch {}
-      process.exit(0);
-      return;
+      updateHardStopTimer = null;
+    }
+    void stopHubSelfAgent(`launcher-${signal}`);
+    const child = activeChild;
+    if (!child || child.exitCode !== null || child.signalCode) {
+      void stopHubSelfAgent(`launcher-${signal}`).finally(() => {
+        try { hubLogStream?.end(); } catch {}
+        process.exit(0);
+      });
+      return;
     }
     reportLauncherUpdate(
       `[LiveDesk Hub] Launcher received ${signal}; requesting graceful Hub shutdown for pid=${child.pid || 'unknown'}.`
@@ -2814,16 +2859,17 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
           failPreflight(message);
           return;
         }
-        restartRequest = {
+        restartRequest = {
           ...request,
           latestVersion: requestedVersion,
           pid: requestPid,
           operationId,
           _neutralCwd: neutralCwd,
           _originalCwd: UPDATE_ORIGINAL_CWD
-        };
-        reportLauncherUpdate(`[LiveDesk Hub] Restart requested for update ${request.operationId || 'unknown'} target=${requestedVersion}.`);
-        const updateChild = activeChild;
+        };
+        reportLauncherUpdate(`[LiveDesk Hub] Restart requested for update ${request.operationId || 'unknown'} target=${requestedVersion}.`);
+        void stopHubSelfAgent('hub-update');
+        const updateChild = activeChild;
         let shutdownFallbackStarted = false;
         const forceStop = reason => {
           if (!updateChild || updateChild.exitCode !== null || updateChild.signalCode) return;
@@ -2864,7 +2910,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
     }
   };
 
-  const startHubProcess = () => {
+  const startHubProcess = () => {
     const stderrChunks = [];
     let stderrLength = 0;
     const child = spawn(process.execPath, [hubEntry, ...options.forwarded], {
@@ -2872,7 +2918,22 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
       stdio: ['inherit', 'pipe', 'pipe'],
       windowsHide: !debugConsole
     });
-    activeChild = child;
+    activeChild = child;
+
+    void waitForManager(hubProbeBaseUrl).then(ok => {
+      if (!ok
+        || activeChild !== child
+        || child.exitCode !== null
+        || child.signalCode
+        || launcherShutdownSignal
+        || restartRequest) return;
+      hubSelfAgent?.start();
+    }).catch(error => {
+      reportLauncherUpdate(
+        `[LiveDesk Hub] Self Agent startup wait failed: ${error?.message || error}.`,
+        true
+      );
+    });
 
     child.stdout.on('data', chunk => {
       appendHubLog(chunk.toString());
@@ -2896,17 +2957,19 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
     });
     child.once('exit', (code, signal) => {
       const startupOutput = stderrChunks.join('');
-      if (launcherShutdownSignal) {
+      if (launcherShutdownSignal) {
         if (launcherShutdownHardStopTimer) {
           clearTimeout(launcherShutdownHardStopTimer);
           launcherShutdownHardStopTimer = null;
         }
-        runtimeShutdownWatcher?.stop();
-        removeLauncherSignalHandlers();
-        try { hubLogStream?.end(); } catch {}
-        process.exit(0);
-        return;
-      }
+        runtimeShutdownWatcher?.stop();
+        removeLauncherSignalHandlers();
+        void stopHubSelfAgent(`launcher-${launcherShutdownSignal}`).finally(() => {
+          try { hubLogStream?.end(); } catch {}
+          process.exit(0);
+        });
+        return;
+      }
       if (restartRequest) {
         const request = restartRequest;
         restartRequest = null;
@@ -2922,7 +2985,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
           clearInterval(updatePollId);
           updatePollId = null;
         }
-        void restartWithLatest(request).catch(error => {
+        void stopHubSelfAgent('hub-update').then(() => restartWithLatest(request)).catch(error => {
           const message = `The Hub restart handoff failed after shutdown: ${error instanceof Error ? error.message : String(error)}`;
           reportLauncherUpdate(`[LiveDesk Hub] ${message}. Restarting the unchanged Hub.`, true);
           try {
@@ -2949,7 +3012,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
           } catch {
             // The unchanged Hub still restarts even if diagnostics are read-only.
           }
-          startHubProcess();
+          startHubProcess();
           if (!updatePollId) {
             updatePollId = setInterval(pollUpdateRequest, HUB_UPDATE_POLL_MS);
             updatePollId.unref?.();
@@ -2957,39 +3020,44 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
         });
         return;
       }
-      if (!signal && code === ROLE_TRANSITION_EXIT_CODE) {
-        if (updatePollId) {
-          clearInterval(updatePollId);
-          updatePollId = null;
-        }
-        try {
-          runtimeLock?.updateRole?.('client');
-        } catch (error) {
-          console.error(
-            `[LiveDesk Hub] The shared runtime lock could not transition to Client: ${error?.message || error}. `
-            + 'The launcher will exit so a clean invocation can recover.'
-          );
-          runtimeShutdownWatcher?.stop();
-          removeLauncherSignalHandlers();
-          try { hubLogStream?.end(); } catch {}
-          process.exit(1);
-          return;
-        }
-        writeRoleCache({
-          role: 'client',
-          deviceId: resolvedRole?.deviceId || process.env.LIVEDESK_DEVICE_ID || '',
-          deviceName: resolvedRole?.deviceName || os.hostname(),
-          source: 'supabase',
-          isOfflineFallback: false
-        }, { stateDir: MANAGER_STATE_DIR });
-        console.log('[LiveDesk Hub] Role transition accepted. Starting the Client runtime.');
-        runtimeShutdownWatcher?.stop();
-        removeLauncherSignalHandlers();
-        void runClient([], { ...resolvedRole, role: 'client', source: 'supabase', roleTransition: true }, runtimeLock).catch(error => {
-          console.error(`Failed to start LiveDesk Client runtime: ${error?.message || error}`);
-          process.exitCode = 1;
-        });
-        return;
+      if (!signal && code === ROLE_TRANSITION_EXIT_CODE) {
+        if (updatePollId) {
+          clearInterval(updatePollId);
+          updatePollId = null;
+        }
+        void stopHubSelfAgent('role-transition').then(() => {
+          try {
+            runtimeLock?.updateRole?.('client');
+          } catch (error) {
+            console.error(
+              `[LiveDesk Hub] The shared runtime lock could not transition to Client: ${error?.message || error}. `
+              + 'The launcher will exit so a clean invocation can recover.'
+            );
+            runtimeShutdownWatcher?.stop();
+            removeLauncherSignalHandlers();
+            try { hubLogStream?.end(); } catch {}
+            process.exit(1);
+            return;
+          }
+          writeRoleCache({
+            role: 'client',
+            deviceId: resolvedRole?.deviceId || process.env.LIVEDESK_DEVICE_ID || '',
+            deviceName: resolvedRole?.deviceName || os.hostname(),
+            source: 'supabase',
+            isOfflineFallback: false
+          }, { stateDir: MANAGER_STATE_DIR });
+          console.log('[LiveDesk Hub] Role transition accepted. Starting the Client runtime.');
+          runtimeShutdownWatcher?.stop();
+          removeLauncherSignalHandlers();
+          void runClient([], { ...resolvedRole, role: 'client', source: 'supabase', roleTransition: true }, runtimeLock).catch(error => {
+            console.error(`Failed to start LiveDesk Client runtime: ${error?.message || error}`);
+            process.exitCode = 1;
+          });
+        }).catch(error => {
+          console.error(`[LiveDesk Hub] Self Agent did not stop for role transition: ${error?.message || error}`);
+          process.exit(1);
+        });
+        return;
       }
       if (!signal
         && code !== 0
@@ -3011,11 +3079,11 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
           });
         return;
       }
-      if (signal) {
-        process.kill(process.pid, signal);
-        return;
-      }
-      process.exit(code ?? 0);
+      if (signal) {
+        void stopHubSelfAgent(`hub-signal-${signal}`).finally(() => process.kill(process.pid, signal));
+        return;
+      }
+      void stopHubSelfAgent('hub-exited').finally(() => process.exit(code ?? 0));
     });
   };
 
@@ -3321,12 +3389,12 @@ async function main() {
     await stopProcessesOnPorts([replacementCleanup.runtimePort, remotePort]);
   }
 
-  if (resolvedRole.role === 'client') {
-    // A launcher and Agent can both die while an independently spawned FFmpeg
-    // survives. Before any new Client process starts, consume only the exact
-    // manifest generation returned by the stale-lock compare-and-swap. No
-    // process-name scan participates in this recovery path.
-    const reclaimedManifestDrain = await drainReclaimedWindowsClientManifest(lock.reclaimedOwner);
+  if (resolvedRole.role === 'client' || resolvedRole.role === 'hub') {
+    // A launcher and Agent can both die while an independently spawned capture
+    // helper survives. This applies to a normal Client and to the Hub-owned
+    // Self Agent. Consume only the exact manifest generation returned by the
+    // stale-lock compare-and-swap; no process-name scan participates here.
+    const reclaimedManifestDrain = await drainReclaimedWindowsClientManifest(lock.reclaimedOwner);
     const testHoldAfterDrainMs = Number(
       process.env.LIVEDESK_TEST_HOLD_AFTER_RECLAIMED_WINDOWS_DRAIN_MS || 0
     );
@@ -3334,9 +3402,12 @@ async function main() {
         && process.env.LIVEDESK_DEBUG === '1'
         && Number.isFinite(testHoldAfterDrainMs)
         && testHoldAfterDrainMs > 0) {
-      console.log('[LiveDesk test] Holding after reclaimed manifest drain before Client startup.');
-      await waitMilliseconds(Math.min(60_000, Math.round(testHoldAfterDrainMs)));
-    }
+      console.log('[LiveDesk test] Holding after reclaimed manifest drain before Agent startup.');
+      await waitMilliseconds(Math.min(60_000, Math.round(testHoldAfterDrainMs)));
+    }
+  }
+
+  if (resolvedRole.role === 'client') {
     const clientRuntimePort = normalizePort(
       process.env.LIVEDESK_CLIENT_RUNTIME_PORT || process.env.LIVEDESK_LOCAL_RUNTIME_PORT,
       DEFAULT_MANAGER_HTTP_PORT

package/bootstrap/hub-self-agent.js

@@ -0,0 +1,243 @@
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+
+const SELF_AGENT_SHUTDOWN_MESSAGE = 'livedesk.self-agent.shutdown';
+const SELF_AGENT_READY_MESSAGE = 'livedesk.self-agent.ready';
+
+function normalizeText(value) {
+  return String(value || '').trim();
+}
+
+function normalizePort(value) {
+  const port = Number(value);
+  return Number.isInteger(port) && port >= 1 && port <= 65535 ? port : 0;
+}
+
+export function buildHubSelfAgentLaunchSpec({
+  nodePath = process.execPath,
+  clientEntry,
+  remotePort,
+  pairToken,
+  deviceId,
+  deviceName,
+  stateDir,
+  runtimeOwner = null,
+  baseEnv = process.env
+} = {}) {
+  const normalizedNodePath = normalizeText(nodePath);
+  const normalizedClientEntry = normalizeText(clientEntry);
+  const normalizedRemotePort = normalizePort(remotePort);
+  const normalizedPairToken = normalizeText(pairToken);
+  const normalizedDeviceId = normalizeText(deviceId);
+  const normalizedDeviceName = normalizeText(deviceName);
+  const normalizedStateDir = normalizeText(stateDir);
+  if (!normalizedNodePath) throw new Error('Hub Self Agent requires the current Node executable.');
+  if (!normalizedClientEntry) throw new Error('Hub Self Agent requires the packaged Client entry.');
+  if (!normalizedRemotePort) throw new Error('Hub Self Agent requires a valid local Hub Client port.');
+  if (!normalizedPairToken) throw new Error('Hub Self Agent requires the current Hub pair token.');
+  if (!normalizedDeviceId) throw new Error('Hub Self Agent requires the Hub device identity.');
+
+  const manager = `127.0.0.1:${normalizedRemotePort}`;
+  const env = {
+    ...baseEnv,
+    LIVEDESK_HUB_SELF_AGENT: '1',
+    LIVEDESK_NPM_LAUNCHER_NAME: 'livedesk',
+    LIVEDESK_NPM_LAUNCHER_VERSION: String(
+      baseEnv.LIVEDESK_MANAGER_VERSION || baseEnv.LIVEDESK_NPM_LAUNCHER_VERSION || ''
+    ),
+    LIVEDESK_UNIFIED_RUNTIME: '1',
+    LIVEDESK_RUNTIME_ROLE: 'client',
+    LIVEDESK_ROLE_SOURCE: 'hub-self-agent',
+    LIVEDESK_SKIP_BROWSER_OPEN: '1',
+    LIVEDESK_CLIENT_ENGINE: 'fast',
+    LIVEDESK_CLIENT_REQUIRE_FAST: '1',
+    LIVEDESK_CLIENT_TRANSPORT: 'tcp',
+    LIVEDESK_CLIENT_MANAGER: manager,
+    LIVEDESK_CLIENT_PAIR_TOKEN: normalizedPairToken,
+    LIVEDESK_DEVICE_ID: normalizedDeviceId,
+    LIVEDESK_DEVICE_NAME: normalizedDeviceName,
+    LIVEDESK_CLIENT_NAME: normalizedDeviceName,
+    LIVEDESK_STATE_DIR: normalizedStateDir,
+    LIVEDESK_CLIENT_UPDATE_STATE_PATH: normalizedStateDir
+      ? join(normalizedStateDir, 'hub-self-agent-update.json')
+      : '',
+    LIVEDESK_RUNTIME_OWNER_PID: String(runtimeOwner?.pid || ''),
+    LIVEDESK_RUNTIME_OWNER_TOKEN: String(runtimeOwner?.ownerToken || ''),
+    LIVEDESK_RUNTIME_OWNER_INSTANCE_MARKER: String(runtimeOwner?.ownerInstanceMarker || ''),
+    LIVEDESK_RUNTIME_OWNER_START_ORDER: String(runtimeOwner?.ownerStartOrder || '')
+  };
+
+  return {
+    command: normalizedNodePath,
+    args: [
+      normalizedClientEntry,
+      '--no-login',
+      '--no-open',
+      '--fast',
+      '--transport',
+      'tcp',
+      '--device-id',
+      normalizedDeviceId
+    ],
+    options: {
+      env,
+      stdio: ['ignore', 'pipe', 'pipe', 'ipc'],
+      windowsHide: true
+    },
+    manager
+  };
+}
+
+export function createHubSelfAgentSupervisor({
+  launch,
+  spawnImpl = spawn,
+  report = () => undefined,
+  restartBaseDelayMs = 1_000,
+  restartMaxDelayMs = 8_000,
+  shutdownTimeoutMs = 12_000
+} = {}) {
+  if (!launch || typeof launch !== 'object') {
+    throw new TypeError('Hub Self Agent launch specification is required.');
+  }
+
+  let child = null;
+  let restartTimer = null;
+  let stopping = false;
+  let consecutiveFailures = 0;
+  let stopPromise = null;
+
+  const clearRestartTimer = () => {
+    if (!restartTimer) return;
+    clearTimeout(restartTimer);
+    restartTimer = null;
+  };
+
+  const scheduleRestart = () => {
+    if (stopping || restartTimer) return;
+    consecutiveFailures += 1;
+    const delayMs = Math.min(
+      Math.max(100, Number(restartMaxDelayMs) || 8_000),
+      Math.max(100, Number(restartBaseDelayMs) || 1_000) * (2 ** Math.min(3, consecutiveFailures - 1))
+    );
+    report(`[LiveDesk Hub] Self Agent stopped unexpectedly; retrying in ${delayMs}ms.`, true);
+    restartTimer = setTimeout(() => {
+      restartTimer = null;
+      start();
+    }, delayMs);
+    restartTimer.unref?.();
+  };
+
+  const start = () => {
+    stopping = false;
+    clearRestartTimer();
+    if (child && child.exitCode === null && !child.signalCode) return false;
+
+    let spawned;
+    try {
+      spawned = spawnImpl(launch.command, launch.args, launch.options);
+    } catch (error) {
+      report(`[LiveDesk Hub] Self Agent launch failed: ${error?.message || error}.`, true);
+      scheduleRestart();
+      return false;
+    }
+    child = spawned;
+    let settled = false;
+
+    spawned.stdout?.on?.('data', chunk => process.stdout.write(chunk));
+    spawned.stderr?.on?.('data', chunk => process.stderr.write(chunk));
+    spawned.on?.('message', message => {
+      if (message?.type !== SELF_AGENT_READY_MESSAGE) return;
+      consecutiveFailures = 0;
+      report(`[LiveDesk Hub] Self Agent ready pid=${spawned.pid || 'unknown'} manager=${launch.manager}.`);
+    });
+    spawned.once?.('error', error => {
+      if (settled) return;
+      settled = true;
+      if (child === spawned) child = null;
+      report(`[LiveDesk Hub] Self Agent process error: ${error?.message || error}.`, true);
+      scheduleRestart();
+    });
+    spawned.once?.('exit', (code, signal) => {
+      if (settled) return;
+      settled = true;
+      if (child === spawned) child = null;
+      if (!stopping) {
+        report(
+          `[LiveDesk Hub] Self Agent exited code=${code ?? 'none'} signal=${signal || 'none'}.`,
+          true
+        );
+        scheduleRestart();
+      }
+    });
+    report(`[LiveDesk Hub] Starting Self Agent pid=${spawned.pid || 'pending'} manager=${launch.manager}.`);
+    return true;
+  };
+
+  const stop = (reason = 'hub-stopping') => {
+    stopping = true;
+    clearRestartTimer();
+    if (stopPromise) return stopPromise;
+    const ownedChild = child;
+    if (!ownedChild || ownedChild.exitCode !== null || ownedChild.signalCode) {
+      child = null;
+      return Promise.resolve({ ok: true, alreadyStopped: true });
+    }
+
+    stopPromise = new Promise(resolveStop => {
+      let finished = false;
+      let hardStopTimer = null;
+      const finish = result => {
+        if (finished) return;
+        finished = true;
+        if (hardStopTimer) clearTimeout(hardStopTimer);
+        if (child === ownedChild) child = null;
+        stopPromise = null;
+        resolveStop(result);
+      };
+      ownedChild.once?.('exit', (code, signal) => finish({ ok: true, code, signal }));
+      try {
+        ownedChild.send?.({
+          type: SELF_AGENT_SHUTDOWN_MESSAGE,
+          signal: 'SIGTERM',
+          reason: normalizeText(reason).slice(0, 120)
+        });
+      } catch (error) {
+        report(`[LiveDesk Hub] Self Agent shutdown message failed: ${error?.message || error}.`, true);
+      }
+      hardStopTimer = setTimeout(() => {
+        if (ownedChild.exitCode !== null || ownedChild.signalCode) {
+          finish({ ok: true });
+          return;
+        }
+        report(
+          `[LiveDesk Hub] Self Agent pid=${ownedChild.pid || 'unknown'} exceeded graceful shutdown; force-stopping that exact child root.`,
+          true
+        );
+        try {
+          ownedChild.kill('SIGKILL');
+        } catch (error) {
+          finish({ ok: false, error });
+        }
+      }, Math.max(1_000, Number(shutdownTimeoutMs) || 12_000));
+      hardStopTimer.unref?.();
+    });
+    return stopPromise;
+  };
+
+  return {
+    start,
+    stop,
+    getStatus: () => ({
+      running: !!child && child.exitCode === null && !child.signalCode,
+      pid: Number(child?.pid || 0),
+      stopping,
+      restartScheduled: !!restartTimer,
+      consecutiveFailures
+    })
+  };
+}
+
+export const HUB_SELF_AGENT_MESSAGES = Object.freeze({
+  shutdown: SELF_AGENT_SHUTDOWN_MESSAGE,
+  ready: SELF_AGENT_READY_MESSAGE
+});

package/client/bin/livedesk-client-fast.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';

package/client/bin/livedesk-client-node.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import net from 'net';
 import os from 'os';