UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

88 lines (81 loc) • 4.51 kB
/** * Whether the Codex desktop app's model picker already shows the current catalog (#4761). * * `ocx system codex-restart` used to quit and relaunch the desktop shell every time, which * discards everything that lives only in the client: composer drafts, an unsent picker * selection, a pending approval prompt. Upstream's own restart (`codex app-server daemon * restart`) restarts only the app-server and lets clients reconnect, and the desktop app * already respawns its own app-server child when it exits. * * The one thing an app-server restart cannot refresh is the picker: the renderer builds * the roster once when the shell launches, and `model_catalog_json` is startup-only. So * a running shell has to restart unless there is affirmative evidence that it loaded the * current binding. The catalog writer skips byte-identical rewrites * (`src/codex/catalog/retained-sync.ts`), so a file timestamp alone is not that evidence. * * The mtime only means something for the catalog `config.toml` actually binds. With no * `model_catalog_json` the shell shows Codex's own roster, which no local file dates, so * an unbound config is `unknown`. `config.toml`'s own mtime is no substitute: injection * rewrites it on every sync even when the bytes are identical. A binding changed by THIS * request's sync is caught by the caller comparing it across the sync. If the shell is * newer than the catalog, however, its launch time cannot prove which binding it loaded: * an earlier sync may have rebound an already-existing, byte-identical catalog. * * Anything we cannot read answers `unknown`, and the caller falls back to the full * desktop restart: a stale picker the operator asked us to fix is the failure this * command exists to prevent, so missing evidence never skips it. */ import { statSync } from "node:fs"; import { readCodexCatalogBinding } from "../paths"; import { readProcessStartMsBatch } from "../app-server-processes"; import { listCodexDesktopShellPids, type DesktopAppRestartIo } from "../desktop-app-restart"; import { isTestHomeGuardArmed } from "../../lib/test-home-guard"; import type { CodexDesktopPickerState } from "../../lib/codex-restart-contract"; export type DesktopPickerState = CodexDesktopPickerState; /** * Pure decision. `shellStartsMs === null` means the shells could not be listed; a null * entry means one shell's start time was unreadable. * * A shell no newer than the catalog is definitely stale. A newer shell is `unknown`, not * current, because timestamps carry no evidence of which catalog binding it loaded. */ export function classifyDesktopPicker( shellStartsMs: readonly (number | null)[] | null, catalogMtimeMs: number | null, ): DesktopPickerState { if (shellStartsMs === null) return "unknown"; if (shellStartsMs.length === 0) return "not_running"; if (catalogMtimeMs === null) return "unknown"; if (shellStartsMs.some(start => start !== null && start <= catalogMtimeMs)) return "stale"; if (shellStartsMs.some(start => start === null)) return "unknown"; return "unknown"; } export interface DesktopPickerIo extends DesktopAppRestartIo { readStartMs?: (pids: readonly number[]) => Map<number, number | null>; /** The catalog `config.toml` binds, or null when it binds none or cannot be read. */ catalogBinding?: () => string | null; catalogMtimeMs?: (path: string) => number | null; } export { readCodexCatalogBinding }; function defaultCatalogMtimeMs(path: string): number | null { try { return statSync(path).mtimeMs; } catch { return null; } } export function readCodexDesktopPickerState(io: DesktopPickerIo = {}): DesktopPickerState { // An armed test process without an injected executor answers `unknown`, which keeps the // caller on the desktop-restart seam the test injected. Reading is harmless, but whether // the developer's own Codex is open must not decide which branch a test takes. if (!io.execFile && isTestHomeGuardArmed()) return "unknown"; const platform = io.platform ?? process.platform; const pids = listCodexDesktopShellPids(io); if (pids === null || pids.length === 0) return classifyDesktopPicker(pids, null); const starts = (io.readStartMs ?? (list => readProcessStartMsBatch(list, platform)))(pids); const binding = (io.catalogBinding ?? readCodexCatalogBinding)(); return classifyDesktopPicker( pids.map(pid => starts.get(pid) ?? null), binding === null ? null : (io.catalogMtimeMs ?? defaultCatalogMtimeMs)(binding), ); }