UNPKG

@bitkyc08/opencodex

Version:

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

56 lines (52 loc) • 2.74 kB
import type { ExportModel } from "../clients/config-export"; import type { HomeRouteIntentDocument, RouteClientId, RouteClientIntent, RouteClientOutcome } from "../link/route-intent"; import type { OcxConfig } from "../types"; import type { IntegrationStateStore } from "./store"; export type { RouteClientOutcome } from "../link/route-intent"; export interface RouteIntentReceipt { version: 1; linkId?: string; /** Last local served roster, retained for offline owned-conflict recovery. No credentials. */ models?: readonly ExportModel[]; document: HomeRouteIntentDocument; clients: Record<RouteClientId, RouteClientIntent>; sources: Record<RouteClientId, "builtin" | "default" | "device" | "native" | "local">; selectedClients: RouteClientId[]; outcomes: RouteClientOutcome[]; /** Null if any client failed, conflicts, or is not installed. Never a partial success. */ appliedRouteIntentDigest: string | null; appliedAt: string; /** Off intents are proved, while enabled clients await the local served model roster. */ catalogPending?: true; } export interface RouteIntentApplyInput { config: OcxConfig; linkId?: string; document: HomeRouteIntentDocument; /** The local served roster, never Home-generated client contributions. */ models: readonly ExportModel[]; home?: string; env?: NodeJS.ProcessEnv; store?: IntegrationStateStore; /** Isolates local opt-outs and receipts; defaults to the local config directory. */ statePath?: string; /** Home passes an empty list; undefined reads this Child's persistent local opt-outs. */ localOff?: readonly RouteClientId[]; overwriteConflict?: boolean; /** When a client toggle grants takeover, other clients retain ordinary conflict checks. */ overwriteClient?: RouteClientId; /** Rechecks connection/runtime ownership immediately before each writer commits. */ beforeWrite?: () => void; /** Reconcile only explicit local opt-outs when no Home document is available. */ onlyClients?: readonly RouteClientId[]; /** Clients skipped by onlyClients keep the previous receipt outcome for the same client intent. */ retainSkippedOutcomes?: boolean; /** Explicit disconnect recovery only: snapshot an owned conflicting block, then remove it. */ recoverConflicts?: boolean; /** Lifecycle exclusion around async file writers; native adapters manage their own lock order. */ withFileWrites?: <T>(work: () => Promise<T>) => Promise<T>; withReceiptWrite?: (write: () => void) => void; now?: () => Date; /** Native adapters retain their existing ownership/journal implementations. */ applyNative?: (client: "codex" | "claude" | "claude-desktop" | "grok", intent: RouteClientIntent) => Promise<RouteClientOutcome>; }