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
export type ProviderFailureType =
| "authentication_error"
| "rate_limit"
| "quota_exhausted"
| "timeout"
| "network_error"
| "provider_5xx"
| "invalid_request"
| "model_unavailable"
| "permission_error"
| "unknown";
export interface ProviderFailure {
type: ProviderFailureType;
retryable: boolean;
providerId: string;
connectionId?: string;
statusCode?: number;
retryAfter?: number;
message: string;
}
export function classifyProviderFailure(input: {
providerId: string;
connectionId?: string;
statusCode?: number;
code?: string;
message?: string;
retryAfter?: number;
}): ProviderFailure {
const message = input.message?.trim() || "Provider request failed";
const normalized = `${input.code ?? ""} ${message}`.toLowerCase();
const status = input.statusCode;
let type: ProviderFailureType = "unknown";
let retryable = false;
if (
status === 401 ||
status === 403 ||
/invalid.*(key|token)|unauthori[sz]ed|forbidden/.test(normalized)
) {
type =
status === 403 || normalized.includes("permission")
? "permission_error"
: "authentication_error";
} else if (status === 408 || status === 504 || /timeout|timed out|etimedout/.test(normalized)) {
type = "timeout";
retryable = true;
} else if (status === 429 || /rate.?limit|too many requests|retry.?after/.test(normalized)) {
type = /quota|insufficient balance|credits exhausted|balance is \$0/.test(normalized)
? "quota_exhausted"
: "rate_limit";
retryable = type === "rate_limit";
} else if (status !== undefined && status >= 500) {
type = "provider_5xx";
retryable = true;
} else if (status === 400 || /invalid request|malformed|unsupported parameter/.test(normalized)) {
type = "invalid_request";
} else if (status === 404 || /model unavailable|model not found|unknown model/.test(normalized)) {
type = "model_unavailable";
} else if (/network|econnreset|econnrefused|enotfound|fetch failed|socket/.test(normalized)) {
type = "network_error";
retryable = true;
}
return {
type,
retryable,
providerId: input.providerId,
...(input.connectionId ? { connectionId: input.connectionId } : {}),
...(status !== undefined ? { statusCode: status } : {}),
...(input.retryAfter !== undefined ? { retryAfter: input.retryAfter } : {}),
message,
};
}