UNPKG

@bitkyc08/opencodex

Version:

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

92 lines (84 loc) • 4.65 kB
/** Cross-process admission for Link sync while its local runtime shuts down. */ import { lstatSync } from "node:fs"; import { ConfigMutationLockError, withConfigMutationLockSync } from "../config"; import { getRuntimePortPath, isValidRuntimePortState, writeRuntimePort, type ClientStopOwner, type RuntimePortState } from "../config/process-state"; import { readBoundedRegularFileSync } from "../lib/bounded-file-read"; export class ClientSyncRuntimeError extends Error { constructor(readonly code: "client_runtime_stopping" | "client_runtime_changed" | "client_runtime_unverified") { super(`${code}: retry sync after the Child has started; ocx start/stop can reconcile a stale runtime record`); } } export function readSyncRuntime(): RuntimePortState | null { const path = getRuntimePortPath(); try { lstatSync(path); } catch (error) { if ((error as NodeJS.ErrnoException).code === "ENOENT") return null; throw new ClientSyncRuntimeError("client_runtime_unverified"); } try { const value: unknown = JSON.parse(readBoundedRegularFileSync(path, 16 * 1024).toString("utf8")); if (!isValidRuntimePortState(value)) throw new Error("invalid runtime record"); return value; } catch { throw new ClientSyncRuntimeError("client_runtime_unverified"); } } /** Capture and recheck under C. Proven no-runtime sync keeps its existing offline behavior. */ export function clientSyncRuntimeGuard(): () => void { const expected = readSyncRuntime(); if (expected?.clientStopping) throw new ClientSyncRuntimeError("client_runtime_stopping"); return () => { const current = readSyncRuntime(); if (current?.clientStopping) throw new ClientSyncRuntimeError("client_runtime_stopping"); if (!Bun.deepEquals(current, expected, true)) throw new ClientSyncRuntimeError("client_runtime_changed"); }; } /** Offline enrollment keeps the configured port. A published runtime must agree before apply. */ export function assertRouteIntentPort(port: number): void { const runtime = readSyncRuntime(); if (runtime?.clientStopping) throw new ClientSyncRuntimeError("client_runtime_stopping"); if (runtime && runtime.port !== port) throw new ClientSyncRuntimeError("client_runtime_changed"); } /** The same C transaction excludes every sync commit; never mark a replacement runtime. */ export function markClientRuntimeStopping( expected: Required<Pick<RuntimePortState, "pid" | "port" | "attestationSecret">>, stopOwner?: ClientStopOwner, ): void { withConfigMutationLockSync(() => { const current = readSyncRuntime(); if (!current || current.pid !== expected.pid || current.port !== expected.port || current.attestationSecret !== expected.attestationSecret) { throw new ClientSyncRuntimeError("client_runtime_changed"); } if (!current.clientStopping || (stopOwner && !Bun.deepEquals(current.clientStopOwner, stopOwner, true))) { writeRuntimePort({ ...current, clientStopping: true, ...(stopOwner ? { clientStopRequested: true, clientStopOwner: stopOwner } : {}) }); } }); } /** Finish only this parent's exact-runtime stop; sync stays fenced until its process exits. */ export function finishClientRuntimeStop( expected: Required<Pick<RuntimePortState, "pid" | "port" | "attestationSecret">>, stopOwner: ClientStopOwner, ): void { withConfigMutationLockSync(() => { const current = readSyncRuntime(); if (current?.pid === expected.pid && current.port === expected.port && current.attestationSecret === expected.attestationSecret && current.clientStopRequested === true && Bun.deepEquals(current.clientStopOwner, stopOwner, true)) { const { clientStopOwner: _finished, ...retained } = current; writeRuntimePort({ ...retained, clientStopRequested: false }); } }); } /** Yield only for proved SQLite contention; storage/identity failures remain immediate refusals. */ export async function markClientRuntimeStoppingWithRetry( expected: Required<Pick<RuntimePortState, "pid" | "port" | "attestationSecret">>, deps: { mark?: () => void; sleep?: (ms: number) => Promise<unknown> } = {}, ): Promise<boolean> { for (let attempt = 0; attempt < 20; attempt += 1) { try { (deps.mark ?? (() => markClientRuntimeStopping(expected)))(); return true; } catch (error) { const cause = error instanceof ConfigMutationLockError ? error.cause : undefined; const code = cause && typeof cause === "object" && "code" in cause ? cause.code : undefined; if ((code !== "SQLITE_BUSY" && code !== "SQLITE_LOCKED") || attempt === 19) return false; await (deps.sleep ?? Bun.sleep)(50); } } return false; }