How the catalog works
The catalog lives in@gatelit/model-catalog and is synced from provider APIs. The gateway uses it to:
- Clamp parameters — strip
temperaturefrom reasoning models, renamemax_tokens→max_completion_tokens - Show capabilities — the dashboard model picker shows context windows, pricing, and supported features
- Flag deprecations — models with a
deprecated_atdate get a warning badge; retired models are hidden
Enabling and disabling models
Go to Settings → Models. Each model has a toggle. Disabled models:- Won’t appear in the playground model picker
- Won’t appear in prompt editor model selectors
- Still work through the API — model toggles are a UX convenience, not a security boundary
model to the gateway’s token exchange endpoint or use org-scoped policies.
Model lifecycle
The catalog tracks three states:
The catalog is updated by running
pnpm dlx tsx packages/model-catalog/scripts/sync.ts — usually done during deployment.
Model format
Alwaysprovider/model-id:
The provider prefix tells the gateway which upstream API to call. Everything after
/ is passed to the provider as the model identifier.
