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
/**
* #11481 — explicit model exposure allow/deny list for the `/v1/models` catalog.
*
* Mirrors the opt-in shape of `hidePaidModels`/`hideAutoCombos`
* (`src/lib/db/settings.ts`): default-off, two independent string arrays
* (`modelVisibilityDenylist` / `modelVisibilityAllowlist`). An entry may be an
* exact catalog id ("provider/model" or a bare "model") or a glob pattern
* (`*`/`?`) via the shared `globToRegex` matcher already used by
* `ModelRoutingSection`'s per-model combo mappings and
* `freeModels.ts::matchesOnlyPaidModels` — no new matching logic.
*
* This predicate is the single chokepoint called from BOTH places the catalog
* template requires (#6512's lesson: a catalog-only filter still leaks into
* `auto/*` combo routing):
* - `src/app/api/v1/models/catalog.ts` (the `/v1/models` listing itself)
* - `open-sse/services/autoCombo/modelExposureFilter.ts` (the `auto/*`
* candidate-pool mirror)
*
* A model id sent EXPLICITLY (not via `auto/*`) is never blocked at dispatch —
* only catalog advertisement / candidate-pool membership is filtered, exactly
* like `hideAutoCombos` already behaves.
*/
import { globToRegex } from "./globPattern";
export interface ModelExposureListSettings {
modelVisibilityAllowlist?: unknown;
modelVisibilityDenylist?: unknown;
}
function normalizeList(value: unknown): string[] {
if (!Array.isArray(value)) return [];
return value.filter((v): v is string => typeof v === "string" && v.trim() !== "");
}
/** Whether any entry in `list` matches one of `candidates` — exact string match
* first (the common case, no regex cost), falling back to a glob match only
* when the entry actually contains a wildcard character. */
function listMatchesAny(list: string[], candidates: string[]): boolean {
return list.some((entry) => {
if (candidates.includes(entry)) return true;
if (!/[*?]/.test(entry)) return false;
let regex: RegExp;
try {
regex = globToRegex(entry);
} catch {
return false;
}
return candidates.some((candidate) => regex.test(candidate));
});
}
/**
* Whether a (provider, model) pair should be exposed given the operator's
* allow/deny lists. Empty lists (the default) always expose — opt-in, off by
* default, matching Hard Rule #20's "never mutate the operator's behaviour on
* their behalf by default" spirit. Denylist is checked first (deny wins over
* an overlapping allow entry); when the allowlist is non-empty, only entries
* it matches survive.
*/
export function isModelExposureAllowed(
provider: string,
modelId: string,
settings: ModelExposureListSettings | null | undefined
): boolean {
const denylist = normalizeList(settings?.modelVisibilityDenylist);
const allowlist = normalizeList(settings?.modelVisibilityAllowlist);
if (denylist.length === 0 && allowlist.length === 0) return true;
const candidates = [modelId, `${provider}/${modelId}`];
if (listMatchesAny(denylist, candidates)) return false;
if (allowlist.length === 0) return true;
return listMatchesAny(allowlist, candidates);
}