03aea082d0
Remove redundant rationale from test body (test names already convey it) and trim the production comment to what/consequence/link (mechanism details live in #39760).
71 lines
2.4 KiB
TypeScript
71 lines
2.4 KiB
TypeScript
import { spawn } from "node:child_process";
|
|
import { triggerOpenClawRestart } from "./restart.js";
|
|
import { detectRespawnSupervisor } from "./supervisor-markers.js";
|
|
|
|
type RespawnMode = "spawned" | "supervised" | "disabled" | "failed";
|
|
|
|
export type GatewayRespawnResult = {
|
|
mode: RespawnMode;
|
|
pid?: number;
|
|
detail?: string;
|
|
};
|
|
|
|
function isTruthy(value: string | undefined): boolean {
|
|
if (!value) {
|
|
return false;
|
|
}
|
|
const normalized = value.trim().toLowerCase();
|
|
return normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on";
|
|
}
|
|
|
|
/**
|
|
* Attempt to restart this process with a fresh PID.
|
|
* - supervised environments (launchd/systemd/schtasks): caller should exit and let supervisor restart
|
|
* - OPENCLAW_NO_RESPAWN=1: caller should keep in-process restart behavior (tests/dev)
|
|
* - otherwise: spawn detached child with current argv/execArgv, then caller exits
|
|
*/
|
|
export function restartGatewayProcessWithFreshPid(): GatewayRespawnResult {
|
|
if (isTruthy(process.env.OPENCLAW_NO_RESPAWN)) {
|
|
return { mode: "disabled" };
|
|
}
|
|
const supervisor = detectRespawnSupervisor(process.env);
|
|
if (supervisor) {
|
|
// launchd: exit(0) is sufficient — KeepAlive=true restarts the service.
|
|
// Self-issued `kickstart -k` races with launchd's bootout state machine
|
|
// and can leave the LaunchAgent permanently unloaded.
|
|
// See: https://github.com/openclaw/openclaw/issues/39760
|
|
if (supervisor === "schtasks") {
|
|
const restart = triggerOpenClawRestart();
|
|
if (!restart.ok) {
|
|
return {
|
|
mode: "failed",
|
|
detail: restart.detail ?? `${restart.method} restart failed`,
|
|
};
|
|
}
|
|
}
|
|
return { mode: "supervised" };
|
|
}
|
|
if (process.platform === "win32") {
|
|
// Detached respawn is unsafe on Windows without an identified Scheduled Task:
|
|
// the child becomes orphaned if the original process exits.
|
|
return {
|
|
mode: "disabled",
|
|
detail: "win32: detached respawn unsupported without Scheduled Task markers",
|
|
};
|
|
}
|
|
|
|
try {
|
|
const args = [...process.execArgv, ...process.argv.slice(1)];
|
|
const child = spawn(process.execPath, args, {
|
|
env: process.env,
|
|
detached: true,
|
|
stdio: "inherit",
|
|
});
|
|
child.unref();
|
|
return { mode: "spawned", pid: child.pid ?? undefined };
|
|
} catch (err) {
|
|
const detail = err instanceof Error ? err.message : String(err);
|
|
return { mode: "failed", detail };
|
|
}
|
|
}
|