UNPKG

@bitkyc08/opencodex

Version:

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

64 lines (58 loc) • 2.87 kB
import { withConfigMutationLockSync } from "../config"; import { assertNoClientDisconnectPending, pendingClientConnectMayOwnToken, readClientConnectionState } from "./state"; import type { OcxClientConnectionConfig } from "../types"; export type RestoreBoundaryOwnership = "restore" | "hub-owned" | "unproven"; export type RestoreOwnershipRefusal = Exclude<RestoreBoundaryOwnership, "restore">; export class StopRestoreOwnershipError extends Error { constructor(readonly boundary: RestoreOwnershipRefusal) { super(`stop_restore_${boundary}`); } } /** Read only; the caller must exclude connection publication with L or C. */ export function inspectStopRestoreOwnership(read = readClientConnectionState): RestoreBoundaryOwnership { try { if (pendingClientConnectMayOwnToken()) return "unproven"; assertNoClientDisconnectPending(); const state = read(); if (state.kind === "invalid" || state.kind === "mismatched") return "unproven"; return state.kind === "connected" && state.value.transport !== "link" ? "hub-owned" : "restore"; } catch { return "unproven"; } } function restoreConnectionSnapshot(connection: OcxClientConnectionConfig) { // Normal sync changes these observations, not restoration ownership. All other // fields, including priorCatalog and future connection fields, remain guarded. const { catalogFingerprint: _fingerprint, catalogSyncedAt: _syncedAt, ...snapshot } = connection; return snapshot; } /** C is reentrant inside N/C; this never acquires L or N. No lease crosses an await. */ export function stopRestoreWriteGuard(expectedConnection?: OcxClientConnectionConfig) { const expected = expectedConnection && restoreConnectionSnapshot(structuredClone(expectedConnection)); let boundary: RestoreBoundaryOwnership = "restore"; return { boundary: () => boundary, run<T>(write: () => T): T { let entered = false; try { return withConfigMutationLockSync(() => { entered = true; if (boundary === "restore") boundary = inspectStopRestoreOwnership(); if (boundary === "restore" && expected) { try { if (expected.pendingOperation) throw new Error("client_rotation_pending"); const current = readClientConnectionState(); if (current.kind !== "connected" || !Bun.deepEquals(restoreConnectionSnapshot(current.value), expected, true)) { throw new Error("client_connection_changed"); } } catch { boundary = "unproven"; } } if (boundary !== "restore") throw new StopRestoreOwnershipError(boundary); return write(); }); } catch (error) { if (!entered) boundary = "unproven"; else if (error instanceof StopRestoreOwnershipError) boundary = error.boundary; throw error; } }, }; }