import os from "node:os";

import path from "node:path";

import { formatErrorMessage } from "../infra/errors.js";

import { sanitizeHostExecEnv } from "../infra/host-env-security.js";

import { normalizeOptionalString } from "../shared/string-coerce.js";

import { sanitizeForLog } from "../terminal/ansi.js";

import { resolveGatewayLaunchAgentLabel } from "./constants.js";

const START_AFTER_EXIT_PRINT_RETRY_COUNT = 15;

const START_AFTER_EXIT_PRINT_RETRY_DELAY_SECONDS = 0.2;

type LaunchdRestartLogEnv = {

HOME?: string;

USERPROFILE?: string;

OPENCLAW_STATE_DIR?: string;

OPENCLAW_PROFILE?: string;

};

function assertValidLaunchAgentLabel(label: string): string {

const trimmed = label.trim();

if (!/^[A-Za-z0-9._-]+$/.test(trimmed)) {

return `gui/${process.getuid()}`;

}

function collectStringEnvOverrides(

env?: Record<string, string | undefined>,

): Record<string, string> | undefined {

const overrides = Object.fromEntries(

Object.entries(env ?? {}).filter(

(entry): entry is [string, string] => typeof entry[1] === "string",

),

);

return Object.keys(overrides).length > 0 ? overrides : undefined;

}

function collectRestartLogEnv(env?: Record<string, string | undefined>): LaunchdRestartLogEnv {

const source = { ...process.env, ...env };

return {

HOME: source.HOME,

USERPROFILE: source.USERPROFILE,

OPENCLAW_STATE_DIR: source.OPENCLAW_STATE_DIR,

OPENCLAW_PROFILE: source.OPENCLAW_PROFILE,

};

}

function resolveLaunchAgentLabel(env?: Record<string, string | undefined>): string {

const envLabel = normalizeOptionalString(env?.OPENCLAW_LAUNCHD_LABEL);

if (envLabel) {

function buildLaunchdRestartScript(

mode: LaunchdRestartHandoffMode,

env: Record<string, string | undefined>,

restartLogEnv: LaunchdRestartLogEnv,

): string {

const waitForCallerPid = `wait_pid="$4"

label="$5"

${renderPosixRestartLogSetup(env)}

${renderPosixRestartLogSetup(restartLogEnv)}

printf '[%s] openclaw restart attempt source=launchd-handoff mode=${mode} target=%s waitPid=%s\\n' "$(date -u +%FT%TZ)" "$service_target" "$wait_pid" >&2

if [ -n "$wait_pid" ] && [ "$wait_pid" -gt 1 ] 2>/dev/null; then

while kill -0 "$wait_pid" >/dev/null 2>&1; do

typeof params.waitForPid === "number" && Number.isFinite(params.waitForPid)

? Math.floor(params.waitForPid)

: 0;

const restartEnv = { ...process.env, ...params.env };

const restartLogEnv = collectRestartLogEnv(params.env);

const restartEnv = sanitizeHostExecEnv({

baseEnv: process.env,

overrides: collectStringEnvOverrides(params.env),

});

try {

const child = spawn(

"/bin/sh",

[

"-c",

buildLaunchdRestartScript(params.mode, restartEnv),

buildLaunchdRestartScript(params.mode, restartLogEnv),

"openclaw-launchd-restart-handoff",

target.serviceTarget,

target.domain,