Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors
TypeScript a2aai-agentsai-gatewayanthropicclaudeclaude-codeclinecodexcopilotcursordeepseekfree-aigeminikimillm-gatewaymcpopenaiopenai-proxyqwentoken-saver
/** Exact Codex model ids retired after discovery merge. */
export const CODEX_DISCOVERY_EXCLUDED_IDS: ReadonlySet<string> = new Set([
// Retired upstream: absent from every openai/codex models manifest
// (0.153.4 / 0.155.0 / 0.157.1 / main) and rejected at inference by the
// ChatGPT-account Codex backend with `400 The 'gpt-5.3-codex-spark' model is
// not supported when using Codex with a ChatGPT account.` The live OAuth
// catalog can keep returning it, so it needs an explicit retired entry
// instead of a prefix family.
"gpt-5.3-codex-spark",
]);
/**
* Codex model-id families retired after discovery merge. Delimiter-aware
* matching prevents prefixes such as `gpt-5.40` from being removed.
*/
export const CODEX_DISCOVERY_EXCLUDED_ID_PREFIXES: readonly string[] = ["gpt-5.4"];
export type CodexDiscoveryMode = "off" | "safe" | "all";
export type CodexDiscoverySource = "live" | "github";
export type CodexDiscoveryStatus = "active" | "candidate" | "incompatible" | "retired";
export type CodexDiscoveryModelIdentity = {
id?: unknown;
visibility?: unknown;
supportedInApi?: unknown;
minimalClientVersion?: unknown;
};
export type CodexDiscoveryCompatibilityResult =
{ status: "active" } | { status: Exclude<CodexDiscoveryStatus, "active">; reason: string };
export function isCodexDiscoveryModelExcluded(model: CodexDiscoveryModelIdentity): boolean {
const id = typeof model?.id === "string" ? model.id.trim().toLowerCase() : "";
if (!id) return true;
if (CODEX_DISCOVERY_EXCLUDED_IDS.has(id)) return true;
return CODEX_DISCOVERY_EXCLUDED_ID_PREFIXES.some((prefix) => {
const normalizedPrefix = prefix.toLowerCase();
return (
id === normalizedPrefix ||
id.startsWith(`${normalizedPrefix}-`) ||
id.startsWith(`${normalizedPrefix}_`) ||
id.startsWith(`${normalizedPrefix}.`)
);
});
}
export function compareCodexDiscoveryVersions(left: string, right: string): number | null {
const parse = (version: string) => {
const parts = version.trim().split(".").map(Number);
return parts.length > 0 && parts.every((part) => Number.isInteger(part) && part >= 0)
? parts
: null;
};
const leftParts = parse(left);
const rightParts = parse(right);
if (!leftParts || !rightParts) return null;
for (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {
const difference = (leftParts[index] || 0) - (rightParts[index] || 0);
if (difference !== 0) return difference;
}
return 0;
}
/** Classifies remote metadata without granting compatibility by default. */
export function classifyCodexDiscoveryModel(
model: CodexDiscoveryModelIdentity,
{
source,
mode,
implementedClientVersion,
}: {
source: CodexDiscoverySource;
mode: CodexDiscoveryMode;
implementedClientVersion: string;
}
): CodexDiscoveryCompatibilityResult {
if (isCodexDiscoveryModelExcluded(model)) return { status: "retired", reason: "denylisted" };
// Upstream visibility controls the picker, not account inference access.
// Internal models such as the approval reviewer are intentionally hidden.
if (model.supportedInApi === false)
return { status: "incompatible", reason: "api-not-supported" };
if (typeof model.minimalClientVersion === "string") {
const versionComparison = compareCodexDiscoveryVersions(
model.minimalClientVersion,
implementedClientVersion
);
if (versionComparison === null)
return { status: "candidate", reason: "invalid-minimal-client-version" };
if (versionComparison > 0) return { status: "candidate", reason: "requires-newer-client" };
}
if (source === "github" && mode === "safe") {
if (model.visibility !== "list") {
return { status: "candidate", reason: "missing-explicit-list-visibility" };
}
if (model.supportedInApi !== true) {
return { status: "candidate", reason: "missing-explicit-api-support" };
}
}
return { status: "active" };
}
export function getCodexDiscoveryMode(providerSpecificData: unknown): CodexDiscoveryMode {
const data =
providerSpecificData && typeof providerSpecificData === "object" ? providerSpecificData : {};
const explicitMode = (data as Record<string, unknown>).codexDiscoveryMode;
if (explicitMode === "off" || explicitMode === "safe" || explicitMode === "all")
return explicitMode;
return (data as Record<string, unknown>).autoFetchModels === true ? "safe" : "off";
}