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
import type { CodexQuotaScope } from "../../config/codexQuotaScopes.ts";
/** The persisted Codex connection that owns credentials and provider state. */
export interface CodexAccountConnection {
readonly id: string;
readonly provider: string;
readonly providerSpecificData: Readonly<Record<string, unknown>>;
}
/** Structured identity for a virtual account; it can never be confused with a DB ID. */
export interface CodexAccountKey<TScope extends CodexQuotaScope | null> {
readonly parentConnectionId: string;
readonly scope: TScope;
}
interface CodexAccountBase<TScope extends CodexQuotaScope | null> {
readonly key: CodexAccountKey<TScope>;
/** The actual persisted connection ID. Children never get a synthetic DB ID. */
readonly connectionId: string;
readonly connection: CodexAccountConnection;
}
/** The runtime view of the persisted credential-owning connection. */
export interface CodexParentAccount extends CodexAccountBase<null> {
readonly kind: "parent";
readonly scope: null;
}
/** One virtual runtime quota/cooldown child of the persisted connection. */
export interface CodexChildAccount extends CodexAccountBase<CodexQuotaScope> {
readonly kind: "child";
readonly scope: CodexQuotaScope;
}
export type CodexAccount = CodexParentAccount | CodexChildAccount;
export interface CodexAccountPool {
readonly parent: CodexParentAccount;
readonly children: readonly [CodexChildAccount, CodexChildAccount];
readonly accounts: readonly [CodexParentAccount, CodexChildAccount, CodexChildAccount];
}
export type CodexAccountPoolStatus = "available" | "partially_limited" | "fully_limited";
export interface CodexAccountPoolState {
readonly kind: "parent";
readonly status: CodexAccountPoolStatus;
readonly limitedScopes: readonly CodexQuotaScope[];
}
export interface CodexChildAccountState {
readonly kind: "child";
readonly scope: CodexQuotaScope;
readonly unavailable: boolean;
readonly rateLimitedUntil: string | null;
}
export type CodexAccountState = CodexAccountPoolState | CodexChildAccountState;
export interface CodexQuotaWindowSnapshot {
readonly usage: number | null;
readonly limit: number | null;
readonly resetAt: string | null;
readonly usedPercentage: number | null;
}
export interface CodexChildAccountProjection {
readonly key: CodexAccountKey<CodexQuotaScope>;
readonly unavailable: boolean;
readonly cooldown: {
readonly active: boolean;
readonly rateLimitedUntil: string | null;
};
readonly quota: {
readonly exhaustedWindow: "5h" | "7d" | null;
readonly observedAt: string | null;
readonly windows: {
readonly "5h": CodexQuotaWindowSnapshot | null;
readonly "7d": CodexQuotaWindowSnapshot | null;
};
};
}
export interface CodexAccountPoolProjection {
readonly parentConnectionId: string;
readonly aggregate: {
readonly status: CodexAccountPoolStatus;
readonly limitedChildCount: number;
};
readonly children: readonly [CodexChildAccountProjection, CodexChildAccountProjection];
}
export interface CodexPersistedQuotaState {
readonly usage5h?: number;
readonly limit5h?: number;
readonly resetAt5h?: string | null;
readonly usage7d?: number;
readonly limit7d?: number;
readonly resetAt7d?: string | null;
readonly observedAt?: string | null;
}
export interface CodexChildQuotaHydration {
readonly scope: CodexQuotaScope;
readonly quotaState: CodexPersistedQuotaState | null;
readonly exhaustedWindow: "5h" | "7d" | null;
readonly rateLimitedUntil: string | null;
}
export interface CodexParentAccountDiagnostic {
readonly status: CodexAccountPoolStatus;
readonly limitedScopeCount: number;
readonly cooldown: {
readonly coolingDown: boolean;
readonly soonestRetryAfterMs: number;
};
readonly quota: {
readonly observedScopeCount: number;
};
}
export interface CodexChildCooldown {
readonly account: CodexChildAccount;
readonly until: string;
}