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
/**
* db/paramFilters.ts — Provider/Model parameter filter configuration.
*
* CRUD against the key_value table under namespace "provider_param_filters".
* Follows the established key_value pattern from databaseSettings.ts.
*/
import { getDbInstance } from "./core";
const NAMESPACE = "provider_param_filters";
// ── Types ───────────────────────────────────────────────────────────────────
export interface ModelParamFilter {
block?: string[];
allow?: string[];
}
export interface ProviderParamFilter {
/** Provider-level params to strip from all requests to this provider. */
block: string[];
/** Provider-level params to re-add after denylist stripping. */
allow: string[];
/** Model-specific overrides (stricter than provider-level). */
models?: Record<string, ModelParamFilter>;
/** When true, upstream 400 "Unsupported parameter" errors auto-populate block. */
autoLearn?: boolean;
}
// ── Cache ───────────────────────────────────────────────────────────────────
let filterCache: Map<string, ProviderParamFilter> | null = null;
let cacheGeneration = 0;
function bumpCacheGeneration(): void {
cacheGeneration++;
filterCache = null;
}
// ── Helpers ─────────────────────────────────────────────────────────────────
function isRecord(value: unknown): value is Record<string, unknown> {
return value !== null && typeof value === "object" && !Array.isArray(value);
}
function parseStoredValue(raw: unknown): unknown {
if (typeof raw !== "string") return raw;
try {
return JSON.parse(raw);
} catch {
return raw;
}
}
function toNormalizedString(value: unknown): string | null {
return typeof value === "string" && value.length > 0 ? value : null;
}
function toStringArray(value: unknown): string[] {
return Array.isArray(value) ? value.filter((k): k is string => typeof k === "string") : [];
}
function toModelParamFilter(raw: Record<string, unknown>): ModelParamFilter | null {
const block = toStringArray(raw.block);
const allow = toStringArray(raw.allow);
if (block.length === 0 && allow.length === 0) return null;
const filter: ModelParamFilter = {};
if (block.length > 0) filter.block = block;
if (allow.length > 0) filter.allow = allow;
return filter;
}
function toModelParamFilters(raw: unknown): Record<string, ModelParamFilter> {
const models: Record<string, ModelParamFilter> = {};
if (!isRecord(raw)) return models;
for (const [modelId, val] of Object.entries(raw)) {
if (!isRecord(val)) continue;
const filter = toModelParamFilter(val);
if (filter) models[modelId] = filter;
}
return models;
}
function toProviderParamFilter(raw: unknown): ProviderParamFilter | null {
if (!isRecord(raw)) return null;
const block = toStringArray(raw.block);
const allow = toStringArray(raw.allow);
const models = toModelParamFilters(raw.models);
const autoLearn = typeof raw.autoLearn === "boolean" ? raw.autoLearn : false;
return { block, allow, models: Object.keys(models).length > 0 ? models : undefined, autoLearn };
}
// ── Read ────────────────────────────────────────────────────────────────────
function readNamespace(namespace: string): Record<string, unknown> {
const db = getDbInstance();
const rows = db
.prepare("SELECT key, value FROM key_value WHERE namespace = ?")
.all(namespace) as Array<{ key: string; value: string }>;
const values: Record<string, unknown> = {};
for (const row of rows) {
values[row.key] = parseStoredValue(row.value);
}
return values;
}
function loadAllConfigs(): Map<string, ProviderParamFilter> {
const raw = readNamespace(NAMESPACE);
const map = new Map<string, ProviderParamFilter>();
for (const [key, value] of Object.entries(raw)) {
const parsed = toProviderParamFilter(value);
if (parsed) {
map.set(key, parsed);
}
}
return map;
}
// ── Public API ──────────────────────────────────────────────────────────────
/**
* Warm the cache on module load so the first call to getParamFilterConfig
* does not hit the DB. Idempotent — subsequent calls return the cached map.
*/
export function loadParamFilterConfigs(): Map<string, ProviderParamFilter> {
if (filterCache === null) {
filterCache = loadAllConfigs();
}
return filterCache;
}
/**
* Get the param filter config for a single provider, or null if not configured.
* Uses an in-memory cache refreshed on write.
*/
export function getParamFilterConfig(provider: string): ProviderParamFilter | null {
return toNormalizedString(provider) ? (loadParamFilterConfigs().get(provider) ?? null) : null;
}
/**
* Upsert the entire param filter config for a provider.
* Invalidates the in-memory cache.
*/
export function setParamFilterConfig(provider: string, config: ProviderParamFilter): void {
if (!toNormalizedString(provider)) return;
const db = getDbInstance();
const stmt = db.prepare(
"INSERT OR REPLACE INTO key_value (namespace, key, value) VALUES (?, ?, ?)"
);
// Normalize the filter before persisting
const normalized: ProviderParamFilter = {
block: config.block ?? [],
allow: config.allow ?? [],
autoLearn: config.autoLearn ?? false,
models: config.models && Object.keys(config.models).length > 0 ? config.models : undefined,
};
stmt.run(NAMESPACE, provider, JSON.stringify(normalized));
bumpCacheGeneration();
}
/**
* Delete the param filter config for a provider.
* Resets to no filtering for that provider.
*/
export function deleteParamFilterConfig(provider: string): void {
if (!toNormalizedString(provider)) return;
const db = getDbInstance();
const stmt = db.prepare("DELETE FROM key_value WHERE namespace = ? AND key = ?");
stmt.run(NAMESPACE, provider);
bumpCacheGeneration();
}
// ── Global auto-learn flag ──────────────────────────────────────────────────
const GLOBAL_AUTOLEARN_KEY = "__global__";
/**
* Check whether the global auto-learn flag is enabled.
* When enabled, ALL providers auto-learn unsupported params from 400 errors
* regardless of their per-provider autoLearn setting.
* Only fires when this is explicitly configured, else returns false.
*/
export function isAutoLearnGloballyEnabled(): boolean {
const globalCfg = getParamFilterConfig(GLOBAL_AUTOLEARN_KEY);
return globalCfg?.autoLearn === true;
}
/**
* Enable or disable global auto-learn globally for all providers.
* When enabled, the per-provider autoLearn flag is still honored after
* the global check (either being on is sufficient to trigger auto-learn).
*/
export function setGlobalAutoLearnEnabled(enabled: boolean): void {
const existing = getParamFilterConfig(GLOBAL_AUTOLEARN_KEY);
setParamFilterConfig(GLOBAL_AUTOLEARN_KEY, {
block: existing?.block ?? [],
allow: existing?.allow ?? [],
autoLearn: enabled,
});
}
/**
* Auto-learn helper: add a single parameter to a provider's block list.
* If the field is already in the block list (or the config does not exist),
* this is a no-op. Optionally scoped to a specific model.
*/
export function addParamToBlocklist(provider: string, paramName: string, model?: string): void {
if (!toNormalizedString(provider) || !toNormalizedString(paramName)) return;
const existing = getParamFilterConfig(provider) ?? {
block: [],
allow: [],
autoLearn: false,
};
if (model) {
// Model-level
const models = existing.models ?? {};
const modelCfg = models[model] ?? {};
if (Array.isArray(modelCfg.block) && modelCfg.block.includes(paramName)) return;
const updatedBlock = [...(modelCfg.block ?? []), paramName];
models[model] = { ...modelCfg, block: updatedBlock };
existing.models = models;
} else {
// Provider-level
if (existing.block.includes(paramName)) return;
existing.block = [...existing.block, paramName];
}
setParamFilterConfig(provider, existing);
}