@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
59 lines (52 loc) • 2.4 kB
text/typescript
import { parseRetryAfterMs } from "../combos";
import { classifyError, parseRetryAfterFromMessage } from "./errors";
import { formatClientRetryAfter } from "./client-retry-after";
export { formatClientRetryAfter, MAX_CLIENT_RETRY_AFTER_SECONDS } from "./client-retry-after";
/** Small default when a retryable 429 has no upstream Retry-After (#507). */
export const DEFAULT_RETRYABLE_429_RETRY_AFTER_SEC = "2";
/**
* Validate a raw upstream Retry-After for client exposure.
* Instant-retry `"0"` is kept even though cooldown parsers reject it.
*/
export function validateClientRetryAfterHeader(
value: string | null | undefined,
now: number,
): string | undefined {
const trimmed = value?.trim();
if (!trimmed || trimmed.length > 128) return undefined;
// Instant-retry "0" is a valid client directive but rejected by cooldown parsers
// (parseRetryAfterMs requires seconds > 0). Preserve it for client headers.
if (trimmed === "0") return trimmed;
return parseRetryAfterMs(trimmed, now) !== undefined ? trimmed : undefined;
}
/**
* Pick a Retry-After value that clients (especially Codex) can back off on.
*
* Order: validated upstream header → delay embedded in the error message →
* small default for retryable rate-limit 429s. Quota-exhausted 429s get no
* default — hammering a spent quota is not a backoff problem.
*
* Pass `includeDefault: false` when the value feeds cooldown/failover metadata:
* the synthetic client fallback must not shorten combo cooldowns from 60s to 2s.
*/
export function resolveClientRetryAfter(opts: {
status: number;
message?: string;
upstreamRetryAfter?: string | null;
now?: number;
includeDefault?: boolean;
}): string | undefined {
const now = opts.now ?? Date.now();
const fromHeader = validateClientRetryAfterHeader(opts.upstreamRetryAfter, now);
if (fromHeader) return fromHeader;
const message = opts.message ?? "";
const fromMessage = parseRetryAfterFromMessage(message);
if (fromMessage !== undefined) return String(fromMessage);
if (opts.includeDefault === false) return undefined;
if (opts.status !== 429) return undefined;
const classified = classifyError(429, "rate_limit_error", message || "Too Many Requests");
if (classified.type === "insufficient_quota" || classified.code === "insufficient_quota") {
return undefined;
}
return DEFAULT_RETRYABLE_429_RETRY_AFTER_SEC;
}