import type { Writable } from "node:stream"; import { readBestEffortConfig } from "../../config/config.js"; import { resolveIsNixMode } from "../../config/paths.js"; import { checkTokenDrift } from "../../daemon/service-audit.js"; import type { GatewayService } from "../../daemon/service.js"; import { renderSystemdUnavailableHints } from "../../daemon/systemd-hints.js"; import { isSystemdUserServiceAvailable } from "../../daemon/systemd.js"; import { isGatewaySecretRefUnavailableError } from "../../gateway/credentials.js"; import { isWSL } from "../../infra/wsl.js"; import { defaultRuntime } from "../../runtime.js"; import { resolveGatewayTokenForDriftCheck } from "./gateway-token-drift.js"; import { buildDaemonServiceSnapshot, createNullWriter, type DaemonAction, type DaemonActionResponse, emitDaemonActionJson, } from "./response.js"; type DaemonLifecycleOptions = { json?: boolean; }; type RestartPostCheckContext = { json: boolean; stdout: Writable; warnings: string[]; fail: (message: string, hints?: string[]) => void; }; async function maybeAugmentSystemdHints(hints: string[]): Promise { if (process.platform !== "linux") { return hints; } const systemdAvailable = await isSystemdUserServiceAvailable().catch(() => false); if (systemdAvailable) { return hints; } return [...hints, ...renderSystemdUnavailableHints({ wsl: await isWSL() })]; } function createActionIO(params: { action: DaemonAction; json: boolean }) { const stdout = params.json ? createNullWriter() : process.stdout; const emit = (payload: Omit) => { if (!params.json) { return; } emitDaemonActionJson({ action: params.action, ...payload }); }; const fail = (message: string, hints?: string[]) => { if (params.json) { emit({ ok: false, error: message, hints }); } else { defaultRuntime.error(message); } defaultRuntime.exit(1); }; return { stdout, emit, fail }; } async function handleServiceNotLoaded(params: { serviceNoun: string; service: GatewayService; loaded: boolean; renderStartHints: () => string[]; json: boolean; emit: ReturnType["emit"]; }) { const hints = await maybeAugmentSystemdHints(params.renderStartHints()); params.emit({ ok: true, result: "not-loaded", message: `${params.serviceNoun} service ${params.service.notLoadedText}.`, hints, service: buildDaemonServiceSnapshot(params.service, params.loaded), }); if (!params.json) { defaultRuntime.log(`${params.serviceNoun} service ${params.service.notLoadedText}.`); for (const hint of hints) { defaultRuntime.log(`Start with: ${hint}`); } } } async function resolveServiceLoadedOrFail(params: { serviceNoun: string; service: GatewayService; fail: ReturnType["fail"]; }): Promise { try { return await params.service.isLoaded({ env: process.env }); } catch (err) { params.fail(`${params.serviceNoun} service check failed: ${String(err)}`); return null; } } export async function runServiceUninstall(params: { serviceNoun: string; service: GatewayService; opts?: DaemonLifecycleOptions; stopBeforeUninstall: boolean; assertNotLoadedAfterUninstall: boolean; }) { const json = Boolean(params.opts?.json); const { stdout, emit, fail } = createActionIO({ action: "uninstall", json }); if (resolveIsNixMode(process.env)) { fail("Nix mode detected; service uninstall is disabled."); return; } let loaded = false; try { loaded = await params.service.isLoaded({ env: process.env }); } catch { loaded = false; } if (loaded && params.stopBeforeUninstall) { try { await params.service.stop({ env: process.env, stdout }); } catch { // Best-effort stop; final loaded check gates success when enabled. } } try { await params.service.uninstall({ env: process.env, stdout }); } catch (err) { fail(`${params.serviceNoun} uninstall failed: ${String(err)}`); return; } loaded = false; try { loaded = await params.service.isLoaded({ env: process.env }); } catch { loaded = false; } if (loaded && params.assertNotLoadedAfterUninstall) { fail(`${params.serviceNoun} service still loaded after uninstall.`); return; } emit({ ok: true, result: "uninstalled", service: buildDaemonServiceSnapshot(params.service, loaded), }); } export async function runServiceStart(params: { serviceNoun: string; service: GatewayService; renderStartHints: () => string[]; opts?: DaemonLifecycleOptions; }) { const json = Boolean(params.opts?.json); const { stdout, emit, fail } = createActionIO({ action: "start", json }); const loaded = await resolveServiceLoadedOrFail({ serviceNoun: params.serviceNoun, service: params.service, fail, }); if (loaded === null) { return; } if (!loaded) { await handleServiceNotLoaded({ serviceNoun: params.serviceNoun, service: params.service, loaded, renderStartHints: params.renderStartHints, json, emit, }); return; } try { await params.service.restart({ env: process.env, stdout }); } catch (err) { const hints = params.renderStartHints(); fail(`${params.serviceNoun} start failed: ${String(err)}`, hints); return; } let started = true; try { started = await params.service.isLoaded({ env: process.env }); } catch { started = true; } emit({ ok: true, result: "started", service: buildDaemonServiceSnapshot(params.service, started), }); } export async function runServiceStop(params: { serviceNoun: string; service: GatewayService; opts?: DaemonLifecycleOptions; }) { const json = Boolean(params.opts?.json); const { stdout, emit, fail } = createActionIO({ action: "stop", json }); const loaded = await resolveServiceLoadedOrFail({ serviceNoun: params.serviceNoun, service: params.service, fail, }); if (loaded === null) { return; } if (!loaded) { emit({ ok: true, result: "not-loaded", message: `${params.serviceNoun} service ${params.service.notLoadedText}.`, service: buildDaemonServiceSnapshot(params.service, loaded), }); if (!json) { defaultRuntime.log(`${params.serviceNoun} service ${params.service.notLoadedText}.`); } return; } try { await params.service.stop({ env: process.env, stdout }); } catch (err) { fail(`${params.serviceNoun} stop failed: ${String(err)}`); return; } let stopped = false; try { stopped = await params.service.isLoaded({ env: process.env }); } catch { stopped = false; } emit({ ok: true, result: "stopped", service: buildDaemonServiceSnapshot(params.service, stopped), }); } export async function runServiceRestart(params: { serviceNoun: string; service: GatewayService; renderStartHints: () => string[]; opts?: DaemonLifecycleOptions; checkTokenDrift?: boolean; postRestartCheck?: (ctx: RestartPostCheckContext) => Promise; }): Promise { const json = Boolean(params.opts?.json); const { stdout, emit, fail } = createActionIO({ action: "restart", json }); const loaded = await resolveServiceLoadedOrFail({ serviceNoun: params.serviceNoun, service: params.service, fail, }); if (loaded === null) { return false; } if (!loaded) { await handleServiceNotLoaded({ serviceNoun: params.serviceNoun, service: params.service, loaded, renderStartHints: params.renderStartHints, json, emit, }); return false; } const warnings: string[] = []; if (params.checkTokenDrift) { // Check for token drift before restart (service token vs config token) try { const command = await params.service.readCommand(process.env); const serviceToken = command?.environment?.OPENCLAW_GATEWAY_TOKEN; const cfg = await readBestEffortConfig(); const configToken = resolveGatewayTokenForDriftCheck({ cfg, env: process.env }); const driftIssue = checkTokenDrift({ serviceToken, configToken }); if (driftIssue) { const warning = driftIssue.detail ? `${driftIssue.message} ${driftIssue.detail}` : driftIssue.message; warnings.push(warning); if (!json) { defaultRuntime.log(`\n⚠️ ${driftIssue.message}`); if (driftIssue.detail) { defaultRuntime.log(` ${driftIssue.detail}\n`); } } } } catch (err) { if (isGatewaySecretRefUnavailableError(err, "gateway.auth.token")) { const warning = "Unable to verify gateway token drift: gateway.auth.token SecretRef is configured but unavailable in this command path."; warnings.push(warning); if (!json) { defaultRuntime.log(`\n⚠️ ${warning}\n`); } } } } try { await params.service.restart({ env: process.env, stdout }); if (params.postRestartCheck) { await params.postRestartCheck({ json, stdout, warnings, fail }); } let restarted = true; try { restarted = await params.service.isLoaded({ env: process.env }); } catch { restarted = true; } emit({ ok: true, result: "restarted", service: buildDaemonServiceSnapshot(params.service, restarted), warnings: warnings.length ? warnings : undefined, }); return true; } catch (err) { const hints = params.renderStartHints(); fail(`${params.serviceNoun} restart failed: ${String(err)}`, hints); return false; } }