UNPKG

@bitkyc08/opencodex

Version:

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

39 lines (34 loc) • 1.65 kB
/** * OCX-11 fallback policy (`fallback` in config.json). Every leaf is optional and absence keeps * today's behavior: model and provider fallback allowed, local fallback not granted. * * Contract and precedence: `src/routing/fallback-policy.ts` and `structure/fallback-policy.md`. */ /** A fallback kind this policy governs. Intra-pool account or key rotation is not one of them. */ export type OcxFallbackKind = "model" | "provider"; export interface OcxFallbackSwitches { /** false refuses a hop to another model of the same provider. */ model?: boolean; /** false refuses a hop to another provider. */ provider?: boolean; } export interface OcxFallbackDeviceConfig extends OcxFallbackSwitches { /** * Permission only: true tells GOAT it may move this device's work to the device's own * providers while the Home is unreachable. OpenCodex itself never serves a Child or Hub client * from local providers; absent or false means no permission. */ localFallback?: boolean; } export interface OcxFallbackConfig extends OcxFallbackSwitches { /** * Keyed by the provider a hop leaves: the resolved provider of the target that just failed or * is known unavailable. In combo [a, b, c] with providers.b.provider false, a to b is allowed and * b to c is refused. */ providers?: Record<string, OcxFallbackSwitches>; /** Keyed by an exact public selector: combo/<id>, policy/<id>, provider/model or an alias. */ routes?: Record<string, OcxFallbackSwitches>; /** Keyed by a Remote Link id (lnk_…) or a Hub-client data key id. Read on the Home. */ devices?: Record<string, OcxFallbackDeviceConfig>; }