@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
82 lines (76 loc) • 4.91 kB
text/typescript
/**
* After `ocx sync` applies the Home's Codex settings on a Remote Link Child, restart the Child's
* runtime so it started after the apply (OCX-6, P5).
*
* Idempotent: the record keeps its apply time while the settings digest is unchanged, so a runtime
* that already started after it is left alone, and a sync after a failed restart retries it. The
* restart is `ocx restart`'s own (`handleProxyRestart`); this module only decides whether to call
* it and never starts a runtime that was not running, except to recover one an accepted restart
* left absent.
*/
import type { HomeCodexSettingsRecord } from "../client/link-home";
import { findLiveProxy, probeHostname, type LiveProxy } from "../server/proxy-liveness";
import type { ProxyRestartStartOutcome } from "./tray-proxy";
import { LEGACY_FLAG_OWNER_ADVICE, type RestartSupervisor } from "./restart-failure";
export type ApplyRestartOutcome =
| { kind: "current" }
| { kind: "not-running" }
| { kind: "connection-changed" }
| { kind: "restarted" }
| { kind: "deferred-supervisor"; supervisor: RestartSupervisor }
| { kind: "failed" };
export interface ApplyRestartDeps {
findLive?: () => Promise<LiveProxy | null>;
/** Epoch ms the live client runtime reports as its start, or null when it reports none. */
readStartedAt?: (live: LiveProxy) => Promise<number | null>;
restart: (startWhenStopped: (recoveringLiveRestart: boolean) => Promise<ProxyRestartStartOutcome>, onSupervised: (supervisor: RestartSupervisor) => void) => Promise<boolean>;
recoveryStart: (recoveringLiveRestart: boolean) => Promise<ProxyRestartStartOutcome>;
/** Still the connection this sync applied for (rechecked right before the restart). */
connectionUnchanged: () => boolean;
}
export async function readClientRuntimeStartedAt(live: LiveProxy, fetchImpl: typeof fetch = fetch): Promise<number | null> {
try {
const response = await fetchImpl(`http://${probeHostname(live.hostname)}:${live.port}/healthz`, {
headers: { accept: "application/json" },
redirect: "manual",
signal: AbortSignal.timeout(2_000),
});
if (!response.ok) return null;
const body = await response.json() as { pid?: unknown; startedAt?: unknown } | null;
if (body?.pid !== live.pid || typeof body.startedAt !== "string") return null;
const startedAt = Date.parse(body.startedAt);
return Number.isFinite(startedAt) ? startedAt : null;
} catch {
return null;
}
}
export async function restartRuntimeAfterApply(record: HomeCodexSettingsRecord, deps: ApplyRestartDeps): Promise<ApplyRestartOutcome> {
const live = await (deps.findLive ?? (() => findLiveProxy()))();
if (!live || live.role !== "client") return { kind: "not-running" };
const appliedAt = Date.parse(record.appliedAt);
// A runtime that reports no start time predates OCX-6 and cannot prove it is current.
const startedAt = await (deps.readStartedAt ?? (target => readClientRuntimeStartedAt(target)))(live);
if (startedAt !== null && Number.isFinite(appliedAt) && startedAt >= appliedAt) return { kind: "current" };
if (!deps.connectionUnchanged()) return { kind: "connection-changed" };
let supervisor: RestartSupervisor | undefined;
const ok = await deps.restart(async recovering => recovering
? deps.recoveryStart(true)
: { status: "skipped" }, value => { supervisor = value; });
if (!ok && supervisor) return { kind: "deferred-supervisor", supervisor };
return ok ? { kind: "restarted" } : { kind: "failed" };
}
/** One line for each outcome, printed by `ocx sync`. */
export function applyRestartMessage(outcome: ApplyRestartOutcome): string {
switch (outcome.kind) {
case "current": return "Client runtime already started after this apply; no restart needed.";
case "not-running": return "No client runtime is running; the applied settings take effect when it starts.";
case "connection-changed": return "The connection changed during sync; the client runtime was not restarted. Run 'ocx sync' again.";
case "restarted": return "Client runtime restarted after applying the Home's settings.";
case "deferred-supervisor": return outcome.supervisor === "desktop"
? "Client runtime restart deferred; the settings take effect when OpenCodex Desktop restarts it. Use Quit in the OpenCodex tray menu, then reopen OpenCodex."
: outcome.supervisor === "legacy-flag"
? `Client runtime restart deferred; nothing was stopped, and the settings take effect when the runtime restarts. ${LEGACY_FLAG_OWNER_ADVICE}`
: "Client runtime restart deferred; the settings take effect when the background service restarts it. Run `ocx service restart`.";
case "failed": return "The client runtime restart did not complete; the previous runtime keeps serving. If a background service or the desktop app owns it, restart it there; otherwise retry with 'ocx restart' or 'ocx sync'.";
}
}