dominds 1.25.19 → 1.26.1

package/dist/server.js

@@ -1,50 +1,6 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startServer = startServer;
-/**
- * Module: server
- *
- * HTTP/WebSocket server for both development and production modes:
- * - Serves static files with MIME detection and SPA fallback (production)
- * - Provides `/api/*` endpoints and `/ws` WebSocket communication
- * - CLI bootstrap with optional cwd/port/host/mode parameters
- * - Development mode: `tsx --watch src/server.ts -p <port> --mode dev`
- * - Production mode: `node dist/server.js` (default port behavior: 5666-)
- */
-const path = __importStar(require("path"));
 const runtime_1 = require("./apps/runtime");
 const dialog_display_state_1 = require("./dialog-display-state");
 const kernel_driver_1 = require("./llm/kernel-driver");
@@ -54,7 +10,9 @@ const open_generation_recovery_1 = require("./recovery/open-generation-recovery"
 const reply_delivery_recovery_1 = require("./recovery/reply-delivery-recovery");
 const work_language_1 = require("./runtime/work-language");
 const auth_1 = require("./server/auth");
+const certificates_1 = require("./server/certificates");
 const dominds_self_update_1 = require("./server/dominds-self-update");
+const network_hosts_1 = require("./server/network-hosts");
 const port_selection_1 = require("./server/port-selection");
 const server_core_1 = require("./server/server-core");
 const websocket_handler_1 = require("./server/websocket-handler");
@@ -75,45 +33,6 @@ process.on('uncaughtException', (error) => {
     // Optionally, exit with code 1
     // process.exit(1);
 });
-function parseArgs(argv) {
-    const out = {};
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a === '-C' || a === '--chdir') {
-            out['C'] = argv[i + 1];
-            i++;
-            continue;
-        }
-        if (a === '-p' || a === '--port') {
-            out['p'] = argv[i + 1];
-            i++;
-            continue;
-        }
-        if (a.startsWith('--port=')) {
-            out['p'] = a.slice('--port='.length);
-            continue;
-        }
-        if (a === '-H' || a === '--host') {
-            out['H'] = argv[i + 1];
-            i++;
-            continue;
-        }
-        if (a.startsWith('--host=')) {
-            out['H'] = a.slice('--host='.length);
-            continue;
-        }
-        if (a === '--mode') {
-            out['mode'] = argv[i + 1];
-            i++;
-            continue;
-        }
-        if (a.startsWith('--mode=')) {
-            out['mode'] = a.slice('--mode='.length);
-            continue;
-        }
-    }
-    return out;
-}
 function attachPostListenStartupCancellation(httpServer, token) {
     const originalStop = httpServer.stop.bind(httpServer);
     httpServer.stop = async () => {
@@ -128,6 +47,15 @@ function getErrnoCode(error) {
     const withCode = error;
     return typeof withCode.code === 'string' ? withCode.code : undefined;
 }
+function buildAdjacentHttpsPortCandidates(params) {
+    if (params.preferredPort < 1 || params.preferredPort > 65535)
+        return [];
+    return (0, port_selection_1.buildWebuiPortCandidates)({
+        preferredPort: params.preferredPort,
+        strictPort: false,
+        direction: params.direction,
+    });
+}
 async function runPostListenStartup(params) {
     await new Promise((resolve) => {
         setImmediate(resolve);
@@ -177,7 +105,6 @@ async function startServer(opts = {}) {
         strictPort,
         direction: portAutoDirection,
     });
-    log.info(`Starting server in ${mode} mode on ${host}:${preferredPort} (${strictPort ? 'strict port' : `auto port ${portAutoDirection}`}; working language: ${(0, work_language_1.getWorkLanguage)()} from ${source})`);
     // WebSocket clients set
     const clients = new Set();
     const serverMode = mode === 'dev' ? 'development' : 'production';
@@ -185,6 +112,26 @@ async function startServer(opts = {}) {
         mode: serverMode,
         env: process.env,
     });
+    const certificateLookup = await (0, certificates_1.findAutoHttpsCertificateForHost)({
+        host,
+        certsDirAbs: opts.certsDirAbs,
+    });
+    for (const diagnostic of certificateLookup.diagnostics) {
+        log.warn(diagnostic.message);
+    }
+    const tls = certificateLookup.kind === 'found' && !strictPort ? certificateLookup.certificate : undefined;
+    const urlHost = (0, network_hosts_1.resolveHttpUrlHostForBindHost)(host);
+    log.info(`Starting server in ${mode} mode on ${(0, auth_1.formatServerOrigin)({
+        scheme: 'http',
+        host: urlHost,
+        port: preferredPort,
+    })} (bind ${host}; ${strictPort ? 'strict port' : `auto port ${portAutoDirection}`}; working language: ${(0, work_language_1.getWorkLanguage)()} from ${source})`);
+    if (certificateLookup.kind === 'found' && strictPort) {
+        log.info(`HTTPS certificate found but Dominds HTTPS is disabled for strict --port; assuming HTTPS, if needed, is handled by a front proxy (${certificateLookup.certificate.certPath})`);
+    }
+    else if (tls !== undefined) {
+        log.info(`HTTPS certificate available: ${tls.certPath} (matched host ${tls.matchedHost})`);
+    }
     let startedCore = null;
     let boundPort = null;
     for (const candidatePort of portCandidates) {
@@ -199,7 +146,6 @@ async function startServer(opts = {}) {
         const candidateServer = (0, server_core_1.createHttpServer)(config);
         try {
             boundPort = await candidateServer.start();
-            (0, websocket_handler_1.setupWebSocketServer)(candidateServer.getHttpServer(), clients, auth, (0, work_language_1.getWorkLanguage)(), config.mode);
             startedCore = candidateServer;
             break;
         }
@@ -209,9 +155,6 @@ async function startServer(opts = {}) {
                 log.warn(`WebUI port ${candidatePort} is already in use; trying the next ${nextDirection} port`);
                 continue;
             }
-            if (boundPort !== null && startedCore === null) {
-                await candidateServer.stop();
-            }
             throw error;
         }
     }
@@ -225,8 +168,66 @@ async function startServer(opts = {}) {
     if (!strictPort && boundPort !== preferredPort) {
         log.warn(`WebUI preferred port ${preferredPort} was unavailable; listening on ${boundPort}`);
     }
+    let httpsServer;
+    let httpsPort;
+    let httpsUrlHost;
+    if (tls !== undefined) {
+        const preferredHttpsPort = portAutoDirection === 'up' ? boundPort + 1 : boundPort - 1;
+        const httpsPortCandidates = buildAdjacentHttpsPortCandidates({
+            preferredPort: preferredHttpsPort,
+            direction: portAutoDirection,
+        });
+        for (const candidatePort of httpsPortCandidates) {
+            const config = {
+                mode: serverMode,
+                staticRoot: 'webapp/dist',
+                host,
+                port: candidatePort,
+                tls,
+                clients,
+                auth,
+            };
+            const candidateServer = (0, server_core_1.createHttpServer)(config);
+            try {
+                httpsPort = await candidateServer.start();
+                httpsServer = candidateServer;
+                httpsUrlHost = tls.matchedHost;
+                break;
+            }
+            catch (error) {
+                if (getErrnoCode(error) === 'EADDRINUSE') {
+                    const nextDirection = portAutoDirection === 'down' ? 'lower' : 'higher';
+                    log.warn(`WebUI HTTPS port ${candidatePort} is already in use; trying the next ${nextDirection} port`);
+                    continue;
+                }
+                await startedCore.stop();
+                throw error;
+            }
+        }
+        if (httpsServer === undefined || httpsPort === undefined || httpsUrlHost === undefined) {
+            await startedCore.stop();
+            throw new Error(`Failed to start WebUI HTTPS: no available adjacent port found from ${preferredHttpsPort}`);
+        }
+        log.info(`HTTPS WebUI ready: ${(0, auth_1.formatServerOrigin)({
+            scheme: 'https',
+            host: httpsUrlHost,
+            port: httpsPort,
+        })}`);
+    }
+    (0, websocket_handler_1.setupWebSocketServer)(httpsServer === undefined
+        ? startedCore.getHttpServer()
+        : [startedCore.getHttpServer(), httpsServer.getHttpServer()], clients, auth, (0, work_language_1.getWorkLanguage)(), serverMode);
     const postListenStartupToken = { canceled: false };
     const httpServer = attachPostListenStartupCancellation(startedCore, postListenStartupToken);
+    if (httpsServer !== undefined) {
+        const originalStop = httpServer.stop.bind(httpServer);
+        const httpsServerToStop = httpsServer;
+        httpServer.stop = async () => {
+            postListenStartupToken.canceled = true;
+            await httpsServerToStop.stop();
+            await originalStop();
+        };
+    }
     try {
         const rtwsRootAbs = process.cwd();
         (0, dominds_self_update_1.configureDomindsSelfUpdate)({
@@ -259,7 +260,7 @@ async function startServer(opts = {}) {
         }
         const postListenStartup = runPostListenStartup({
             rtwsRootAbs,
-            kernel: { host, port: boundPort },
+            kernel: { scheme: 'http', host: urlHost, port: boundPort },
             startBackendDriver,
             token: postListenStartupToken,
         });
@@ -279,41 +280,15 @@ async function startServer(opts = {}) {
         }
         throw error;
     }
-    return { httpServer, auth, host, port: boundPort, mode };
-}
-// Main function for CLI execution
-async function main() {
-    const cliArgs = parseArgs(process.argv.slice(2));
-    // Handle working directory change from -C flag
-    const wsDir = cliArgs['C'];
-    if (wsDir) {
-        if (!path.isAbsolute(wsDir)) {
-            throw new Error(`-C requires an absolute directory path: ${wsDir}`);
-        }
-        try {
-            process.chdir(wsDir);
-        }
-        catch (err) {
-            throw new Error(`Failed to change working directory to ${wsDir}: ${err instanceof Error ? err.message : String(err)}`);
-        }
-    }
-    // Get port, host, and mode from CLI args
-    const portSpecRaw = cliArgs['p'];
-    const parsedPort = typeof portSpecRaw === 'string' ? (0, port_selection_1.parseWebuiPortSpec)(portSpecRaw) : undefined;
-    if (portSpecRaw !== undefined && parsedPort === null) {
-        throw new Error('Invalid --port value: expected a port number, optionally suffixed with + or -');
-    }
-    const port = parsedPort?.port;
-    const strictPort = parsedPort?.strictPort;
-    const portAutoDirection = parsedPort?.portAutoDirection;
-    const host = cliArgs['H'] || undefined;
-    const mode = cliArgs['mode'] || undefined;
-    await startServer({ port, host, mode, strictPort, portAutoDirection, returnAfterListen: true });
-}
-// Start server if this file is run directly
-if (require.main === module) {
-    main().catch((error) => {
-        log.error('Web UI startup failed', error);
-        process.exit(1);
-    });
+    return {
+        httpServer,
+        httpsServer,
+        auth,
+        host,
+        urlHost,
+        port: boundPort,
+        httpsPort,
+        httpsUrlHost,
+        mode,
+    };
 }

package/dist/supervisor-protocol.d.ts

@@ -0,0 +1,15 @@
+import type { DomindsSelfUpdateRunKind } from '@longrun-ai/kernel/types';
+export declare const DOMINDS_SUPERVISOR_RESTART_WEBUI = "dominds.supervisor.restart_webui.v1";
+export type DomindsSupervisorRestartRunKind = Extract<DomindsSelfUpdateRunKind, 'global' | 'npx'>;
+export type DomindsSupervisorRestartWebuiMessage = Readonly<{
+    type: typeof DOMINDS_SUPERVISOR_RESTART_WEBUI;
+    cwd: string;
+    host: string;
+    port: number;
+    traceFile: string;
+    debugDir: string;
+    currentVersion: string;
+    targetVersion: string | null;
+    runKind: DomindsSupervisorRestartRunKind;
+}>;
+export type DomindsRunnerToSupervisorMessage = DomindsSupervisorRestartWebuiMessage;

package/dist/supervisor-protocol.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOMINDS_SUPERVISOR_RESTART_WEBUI = void 0;
+exports.DOMINDS_SUPERVISOR_RESTART_WEBUI = 'dominds.supervisor.restart_webui.v1';

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "dominds",
-  "version": "1.25.19",
+  "version": "1.26.1",
   "description": "Dominds CLI and aggregation shell for the LongRun AI kernel/runtime packages.",
   "type": "commonjs",
   "publishConfig": {
     "access": "public"
   },
   "bin": {
-    "dominds": "dist/cli.js"
+    "dominds": "dist/cli.js",
+    "dominds-runner": "dist/cli-runner.js"
   },
   "exports": {
     "./cli": {
@@ -52,9 +53,9 @@
     "ws": "^8.19.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
+    "@longrun-ai/kernel": "1.16.0",
     "@longrun-ai/codex-auth": "0.13.0",
-    "@longrun-ai/kernel": "1.15.12",
-    "@longrun-ai/shell": "1.15.12"
+    "@longrun-ai/shell": "1.16.0"
   },
   "devDependencies": {
     "@types/node": "^25.3.5",
@@ -83,6 +84,6 @@
     "lint:types": "pnpm -r --filter './packages/*' --filter ./webapp run lint:types && tsc -p main/tsconfig.dev.json --noEmit",
     "format": "prettier --write \"{main,webapp/src,docs,tests}/**/*.{js,jsx,ts,tsx}\" && prettier --write \"{main,webapp/src,docs,tests}/**/*.{css,md,json,html}\"",
     "format:check": "prettier --check \"{main,webapp/src,docs,tests}/**/*.{js,jsx,ts,tsx}\" && prettier --check \"{main,webapp/src,docs,tests}/**/*.{css,md,json,html}\"",
-    "build:backend": "pnpm -C tests run manual-size-guard && rm -rf ./dist && pnpm -r --filter './packages/*' --filter ./codex-auth run build && tsc -p main/tsconfig.json --rootDir main && mkdir -p dist/llm dist/minds dist/tools dist/snippets dist/docs && cp main/llm/defaults.yaml dist/llm/ && cp -r main/minds/builtin dist/minds/ && cp -r main/tools/prompts dist/tools/ && cp -r snippets/. dist/snippets/ && cp -r docs/. dist/docs/ && chmod +x ./dist/cli.js ./dist/cli/*.js 2>/dev/null"
+    "build:backend": "pnpm -C tests run manual-size-guard && rm -rf ./dist && pnpm -r --filter './packages/*' --filter ./codex-auth run build && tsc -p main/tsconfig.json --rootDir main && mkdir -p dist/llm dist/minds dist/tools dist/snippets dist/docs && cp main/llm/defaults.yaml dist/llm/ && cp -r main/minds/builtin dist/minds/ && cp -r main/tools/prompts dist/tools/ && cp -r snippets/. dist/snippets/ && cp -r docs/. dist/docs/ && chmod +x ./dist/cli.js ./dist/cli-runner.js ./dist/server-debug.js ./dist/cli/*.js 2>/dev/null"
   }
 }

package/dist/server/dominds-self-update-restart-helper.d.ts

@@ -1,15 +0,0 @@
-export type RestartHelperStdioMode = 'inherit' | 'ignore';
-export type RestartHelperPayload = Readonly<{
-    command: string;
-    args: readonly string[];
-    cwd: string;
-    host: string;
-    port: number;
-    retiringPid: number;
-    forceKillAfterMs: number;
-    probeIntervalMs: number;
-    portReleaseTimeoutMs: number;
-    stdioMode: RestartHelperStdioMode;
-    traceFile: string;
-    debugDir: string;
-}>;

package/dist/server/dominds-self-update-restart-helper.js

@@ -1,305 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const child_process_1 = require("child_process");
-const fs_1 = __importDefault(require("fs"));
-const net_1 = __importDefault(require("net"));
-const time_1 = require("@longrun-ai/kernel/utils/time");
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function isStringArray(value) {
-    return Array.isArray(value) && value.every((item) => typeof item === 'string');
-}
-function readString(value, key) {
-    const candidate = value[key];
-    if (typeof candidate !== 'string' || candidate.trim() === '') {
-        throw new Error(`Invalid Dominds restart helper payload: ${key} must be a non-empty string`);
-    }
-    return candidate;
-}
-function readNumber(value, key) {
-    const candidate = value[key];
-    if (typeof candidate !== 'number' || !Number.isFinite(candidate)) {
-        throw new Error(`Invalid Dominds restart helper payload: ${key} must be a finite number`);
-    }
-    return candidate;
-}
-function readPositiveInteger(value, key) {
-    const candidate = readNumber(value, key);
-    if (!Number.isInteger(candidate) || candidate <= 0) {
-        throw new Error(`Invalid Dominds restart helper payload: ${key} must be a positive integer`);
-    }
-    return candidate;
-}
-function readPort(value, key) {
-    const candidate = readPositiveInteger(value, key);
-    if (candidate > 65535) {
-        throw new Error(`Invalid Dominds restart helper payload: ${key} must be <= 65535`);
-    }
-    return candidate;
-}
-function parsePayload(raw) {
-    if (typeof raw !== 'string' || raw.trim() === '') {
-        throw new Error('Missing Dominds restart helper payload');
-    }
-    const parsed = JSON.parse(raw);
-    if (!isRecord(parsed)) {
-        throw new Error('Invalid Dominds restart helper payload: expected an object');
-    }
-    const args = parsed['args'];
-    if (!isStringArray(args)) {
-        throw new Error('Invalid Dominds restart helper payload: args must be a string array');
-    }
-    const stdioMode = parsed['stdioMode'];
-    if (stdioMode !== 'inherit' && stdioMode !== 'ignore') {
-        throw new Error('Invalid Dominds restart helper payload: stdioMode must be inherit or ignore');
-    }
-    return {
-        command: readString(parsed, 'command'),
-        args,
-        cwd: readString(parsed, 'cwd'),
-        host: readString(parsed, 'host'),
-        port: readPort(parsed, 'port'),
-        retiringPid: readPositiveInteger(parsed, 'retiringPid'),
-        forceKillAfterMs: readPositiveInteger(parsed, 'forceKillAfterMs'),
-        probeIntervalMs: readPositiveInteger(parsed, 'probeIntervalMs'),
-        portReleaseTimeoutMs: readPositiveInteger(parsed, 'portReleaseTimeoutMs'),
-        stdioMode,
-        traceFile: readString(parsed, 'traceFile'),
-        debugDir: readString(parsed, 'debugDir'),
-    };
-}
-function trace(payload, event, details = {}) {
-    const record = {
-        ...details,
-        event,
-        capturedAt: (0, time_1.formatUnifiedTimestamp)(new Date()),
-        helperPid: process.pid,
-        platform: process.platform,
-    };
-    try {
-        fs_1.default.mkdirSync(payload.debugDir, { recursive: true });
-        fs_1.default.appendFileSync(payload.traceFile, `${JSON.stringify(record)}\n`, 'utf8');
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`Failed to write Dominds restart helper trace: ${message}`);
-    }
-}
-function isPortBusy(payload) {
-    return new Promise((resolve) => {
-        const socket = net_1.default.createConnection({ host: payload.host, port: payload.port });
-        let settled = false;
-        const finish = (busy) => {
-            if (settled)
-                return;
-            settled = true;
-            socket.destroy();
-            resolve(busy);
-        };
-        socket.once('connect', () => finish(true));
-        socket.once('error', () => finish(false));
-        socket.setTimeout(1000, () => finish(true));
-    });
-}
-function getErrorCode(error) {
-    return isRecord(error) && typeof error['code'] === 'string' ? error['code'] : '';
-}
-function assertValidRetiringPid(payload) {
-    if (!Number.isInteger(payload.retiringPid) || payload.retiringPid <= 0) {
-        throw new Error(`Invalid retiring Dominds pid for restart: ${String(payload.retiringPid)}`);
-    }
-    if (payload.retiringPid === process.pid) {
-        throw new Error(`Refusing to kill restart helper pid ${String(process.pid)}`);
-    }
-}
-function isRetiringProcessAlive(payload) {
-    assertValidRetiringPid(payload);
-    try {
-        process.kill(payload.retiringPid, 0);
-        return true;
-    }
-    catch (error) {
-        const code = getErrorCode(error);
-        if (code === 'ESRCH')
-            return false;
-        if (code === 'EPERM')
-            return true;
-        throw error;
-    }
-}
-async function delayMs(ms) {
-    await new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
-}
-async function waitForRetiringProcessExit(payload, timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        if (!isRetiringProcessAlive(payload))
-            return true;
-        await delayMs(payload.probeIntervalMs);
-    }
-    return false;
-}
-async function waitForPortReleaseUntil(payload, deadline) {
-    let consecutiveReady = 0;
-    while (Date.now() < deadline) {
-        if (!(await isPortBusy(payload))) {
-            consecutiveReady += 1;
-            if (consecutiveReady >= 2)
-                return true;
-        }
-        else {
-            consecutiveReady = 0;
-        }
-        await delayMs(payload.probeIntervalMs);
-    }
-    return false;
-}
-async function runBestEffortKiller(payload, command, args) {
-    await new Promise((resolve) => {
-        trace(payload, 'helper.force_kill.spawn', { command, args });
-        const killer = (0, child_process_1.spawn)(command, [...args], {
-            stdio: payload.stdioMode,
-            windowsHide: payload.stdioMode !== 'inherit',
-        });
-        killer.once('error', (error) => {
-            trace(payload, 'helper.force_kill.error', { message: error.message });
-            resolve();
-        });
-        killer.once('exit', (code, signal) => {
-            trace(payload, 'helper.force_kill.exit', { code, signal });
-            resolve();
-        });
-    });
-}
-async function forceKillRetiringProcess(payload) {
-    assertValidRetiringPid(payload);
-    try {
-        process.kill(payload.retiringPid, 'SIGKILL');
-    }
-    catch (error) {
-        const code = getErrorCode(error);
-        if (code === 'ESRCH')
-            return;
-        if (process.platform !== 'win32')
-            throw error;
-    }
-    if (process.platform === 'win32') {
-        await runBestEffortKiller(payload, 'taskkill.exe', ['/PID', String(payload.retiringPid), '/F']);
-    }
-}
-async function runRestartHelper(payload) {
-    const detached = payload.stdioMode !== 'inherit';
-    trace(payload, 'helper.start', {
-        command: payload.command,
-        args: payload.args,
-        cwd: payload.cwd,
-        host: payload.host,
-        port: payload.port,
-        retiringPid: payload.retiringPid,
-        detached,
-        stdioMode: payload.stdioMode,
-        forceKillAfterMs: payload.forceKillAfterMs,
-        portReleaseTimeoutMs: payload.portReleaseTimeoutMs,
-        probeIntervalMs: payload.probeIntervalMs,
-    });
-    const forceKillDeadline = Date.now() + payload.forceKillAfterMs;
-    trace(payload, 'helper.wait_retiring_process_exit.start', {
-        retiringPid: payload.retiringPid,
-        timeoutMs: payload.forceKillAfterMs,
-    });
-    const exitedGracefully = await waitForRetiringProcessExit(payload, payload.forceKillAfterMs);
-    trace(payload, 'helper.wait_retiring_process_exit.finish', {
-        retiringPid: payload.retiringPid,
-        exited: exitedGracefully,
-    });
-    if (!exitedGracefully) {
-        trace(payload, 'helper.force_kill.start', { retiringPid: payload.retiringPid });
-        await forceKillRetiringProcess(payload);
-        trace(payload, 'helper.force_kill.finish', { retiringPid: payload.retiringPid });
-        trace(payload, 'helper.wait_retiring_process_exit_after_kill.start', {
-            retiringPid: payload.retiringPid,
-            timeoutMs: payload.portReleaseTimeoutMs,
-        });
-        const exitedAfterKill = await waitForRetiringProcessExit(payload, payload.portReleaseTimeoutMs);
-        trace(payload, 'helper.wait_retiring_process_exit_after_kill.finish', {
-            retiringPid: payload.retiringPid,
-            exited: exitedAfterKill,
-        });
-        if (!exitedAfterKill) {
-            throw new Error(`Dominds retiring process is still alive after force-killing pid ${String(payload.retiringPid)}`);
-        }
-    }
-    const portReleaseDeadline = Math.max(forceKillDeadline, Date.now() + payload.portReleaseTimeoutMs);
-    trace(payload, 'helper.wait_port_release.start', {
-        host: payload.host,
-        port: payload.port,
-        deadlineMsFromNow: portReleaseDeadline - Date.now(),
-    });
-    const portReleased = await waitForPortReleaseUntil(payload, portReleaseDeadline);
-    trace(payload, 'helper.wait_port_release.finish', {
-        host: payload.host,
-        port: payload.port,
-        released: portReleased,
-    });
-    if (!portReleased) {
-        throw new Error(`Dominds restart port is still busy after retiring pid ${String(payload.retiringPid)} exited; port=${String(payload.host)}:${String(payload.port)}`);
-    }
-    trace(payload, 'helper.spawn_new_process.start', {
-        command: payload.command,
-        args: payload.args,
-        cwd: payload.cwd,
-        detached,
-        stdioMode: payload.stdioMode,
-    });
-    const child = (0, child_process_1.spawn)(payload.command, [...payload.args], {
-        cwd: payload.cwd,
-        env: process.env,
-        detached,
-        stdio: payload.stdioMode,
-        shell: false,
-        windowsHide: payload.stdioMode !== 'inherit',
-    });
-    if (detached)
-        child.unref();
-    await new Promise((resolve, reject) => {
-        child.once('error', (error) => {
-            trace(payload, 'helper.spawn_new_process.error', {
-                command: payload.command,
-                args: payload.args,
-                cwd: payload.cwd,
-                message: error.message,
-                stack: error.stack ?? null,
-            });
-            reject(error);
-        });
-        child.once('spawn', resolve);
-    });
-    trace(payload, 'helper.spawn_new_process.finish', { childPid: child.pid ?? null });
-    trace(payload, 'helper.exit', { code: 0 });
-}
-async function main() {
-    let payload = null;
-    try {
-        payload = parsePayload(process.argv[2]);
-        await runRestartHelper(payload);
-        process.exit(0);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        const stack = error instanceof Error ? (error.stack ?? null) : null;
-        if (payload !== null) {
-            trace(payload, 'helper.error', { message, stack });
-        }
-        console.error(message);
-        process.exit(1);
-    }
-}
-if (require.main === module) {
-    void main();
-}