UNPKG

@bitkyc08/opencodex

Version:

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

138 lines (123 loc) • 7.96 kB
import type { OcxConfig } from "../types"; import { MAIN_CODEX_ACCOUNT_ID } from "./account-id"; import { codexAccountUsesRemainingQuota } from "./account-use-remaining"; import { isDeclaredReasoningEffort } from "../reasoning-effort"; import { getMainPolicyQuota } from "./quota"; import { MAIN_ACCOUNT_HARD_LOCK_PERCENT, MAIN_ACCOUNT_HARD_LOCK_SHORT_PERCENT, MAIN_ACCOUNT_HARD_LOCK_MIN_PERCENT } from "./quota-types"; export { MAIN_ACCOUNT_HARD_LOCK_PERCENT }; export interface MainAccountHardLockStatus { enabled: boolean; state: "off" | "unknown" | "ready" | "blocked"; /** Unix milliseconds; absent when a blocking observation has no future reset. */ resetAt?: number; thresholds: { short: number; long: number }; window?: "short" | "long"; } type PolicyConfig = Pick<OcxConfig, "codexMainAccountHardLock" | "codexMainAccountHardLockThresholds" | "codexMainAccountHardLockFallback" | "codexUseRemainingQuotaAccountIds">; /** The reroute destination for requests the lock blocks, when one is configured and readable. */ export interface MainAccountHardLockFallback { model: string; reasoningEffort?: string; } /** * The configured fallback, or `undefined` when nothing qualifies. The dashboard row keeps * the configured model while its switch is off, so `enabled: false` pauses the reroute * without forgetting the destination. A malformed hand edit — blank or padded model, * undeclared effort — disables the reroute entirely rather than degrading into a * half-applied one: the request path must never guess which part of a broken setting to * keep. This is the same disable-don't-widen reading the compaction override takes, and * the load/write boundaries report the malformation separately. */ export function resolveMainAccountHardLockFallback(config: PolicyConfig | undefined): MainAccountHardLockFallback | undefined { const raw = config?.codexMainAccountHardLockFallback; if (!raw || raw.enabled === false) return undefined; const model = typeof raw.model === "string" ? raw.model : ""; if (model.length === 0 || model !== model.trim() || /\s/.test(model)) return undefined; if (raw.reasoningEffort !== undefined && (typeof raw.reasoningEffort !== "string" || !isDeclaredReasoningEffort(raw.reasoningEffort))) return undefined; return raw.reasoningEffort !== undefined ? { model, reasoningEffort: raw.reasoningEffort } : { model }; } export function resolveMainAccountHardLockThresholds(config: PolicyConfig | undefined): { short: number; long: number } { if (codexAccountUsesRemainingQuota(config, MAIN_CODEX_ACCOUNT_ID)) return { short: 100, long: 100 }; const valid = (value: unknown, fallback: number): number => typeof value === "number" && Number.isInteger(value) && value >= MAIN_ACCOUNT_HARD_LOCK_MIN_PERCENT && value <= 100 ? value : fallback; const long = valid(config?.codexMainAccountHardLockThresholds?.long, MAIN_ACCOUNT_HARD_LOCK_PERCENT); const short = valid(config?.codexMainAccountHardLockThresholds?.short, MAIN_ACCOUNT_HARD_LOCK_SHORT_PERCENT); return { short: Math.min(short, long), long }; } /** * Whether the main-account hard lock applies to this config (#5694). * * Absent key or `true` means on; only the persisted `false` opt-out turns it off. The * `undefined` branch is the trap this resolver cannot close on its own: no config object is * "the caller supplied no policy", not "the operator opted out", so a call site holding an * optional config must test for one before asking. Sites that hold a config always (a loaded * config, a resolved policy) call this directly. */ export function isMainAccountHardLockEnabled(config: PolicyConfig | undefined): boolean { return config?.codexMainAccountHardLock !== false; } function resetTimestamp(value: number | undefined): number | undefined { if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return undefined; return value < 10_000_000_000 ? value * 1000 : value; } type WindowReading = { kind: "short" | "long"; percent: number | undefined; resetAt: number | undefined }; /** * The windows that govern the lock. The 5h and weekly windows each govern on their own, so either * one at its configured threshold blocks even while the other has headroom. Monthly governs only a monthly-only account: * supplementary monthly data on a 5h/weekly account never becomes a lock. The list is never empty, * so a record with no readings at all classifies as unknown rather than vacuously ready. */ function governingWindows(quota: NonNullable<ReturnType<typeof getMainPolicyQuota>>): WindowReading[] { const hasShort = quota.shortPercent !== undefined || quota.shortResetAt !== undefined || quota.shortWindowSeconds !== undefined; const hasWeekly = quota.weeklyPercent !== undefined || quota.weeklyResetAt !== undefined; const windows: WindowReading[] = []; if (hasShort) windows.push({ kind: "short", percent: quota.shortPercent, resetAt: quota.shortResetAt }); if (hasWeekly) windows.push({ kind: "long", percent: quota.weeklyPercent, resetAt: quota.weeklyResetAt }); if (windows.length === 0) windows.push({ kind: "long", percent: quota.monthlyPercent, resetAt: quota.monthlyResetAt }); return windows; } function validPercent(percent: number | undefined): percent is number { // The routing score's unknown sentinel is 101. It is never a raw quota observation. return typeof percent === "number" && Number.isFinite(percent) && percent >= 0 && percent <= 100; } /** Observed admission policy, not a reservation of the account's remaining quota. */ export function getMainAccountHardLockStatus( config: PolicyConfig, now = Date.now(), ): MainAccountHardLockStatus { const thresholds = resolveMainAccountHardLockThresholds(config); if (!isMainAccountHardLockEnabled(config)) return { enabled: false, state: "off", thresholds }; const quota = getMainPolicyQuota(); if (!quota) return { enabled: true, state: "unknown", thresholds }; const windows = governingWindows(quota); const blocking = windows.filter(w => validPercent(w.percent) && w.percent >= thresholds[w.kind]); if (blocking.length > 0) { // The lock holds until every blocking window reads lower or is authoritatively absent, so the earliest possible unlock is // the latest blocking reset. One blocking window without a future reset makes it unknowable. // A predicted reset is not evidence of recovery; fresh lower usage or validated WHAM absence releases. const resets = blocking.map(w => resetTimestamp(w.resetAt)); const resetAt = resets.every(r => r !== undefined && r > now) ? Math.max(...(resets as number[])) : undefined; return { enabled: true, state: "blocked", thresholds, window: blocking[0]!.kind, ...(resetAt !== undefined ? { resetAt } : {}) }; } // Unknown admits, so an unreadable window never hides a blocking one and never blocks alone. if (windows.some(w => !validPercent(w.percent))) return { enabled: true, state: "unknown", thresholds }; return { enabled: true, state: "ready", thresholds }; } export function isMainAccountHardLocked(config: PolicyConfig, now = Date.now()): boolean { return getMainAccountHardLockStatus(config, now).state === "blocked"; } /** * Scheduling evidence only: the latest blocking reset even after it has passed, so recovery can * notice a revised reset that expired between sweeps. Never an admission or unlock signal. */ export function latestMainBlockingResetAt(config: PolicyConfig): number | undefined { if (!isMainAccountHardLockEnabled(config)) return undefined; const quota = getMainPolicyQuota(); if (!quota) return undefined; const thresholds = resolveMainAccountHardLockThresholds(config); const resets = governingWindows(quota) .filter(w => validPercent(w.percent) && w.percent >= thresholds[w.kind]).map(w => resetTimestamp(w.resetAt)); return resets.length > 0 && resets.every(r => r !== undefined) ? Math.max(...(resets as number[])) : undefined; }