Files
oh-my-pi/packages/catalog
Voon Foo 61ff318e6d review: typed compat access, 0-disable lazy watchdog test, changelogs
- Replace the compat cast with an annotated CompatOf<Api> local narrowed
  via the in operator: assignment up-cast, compiler-checked field type,
  no as assertion.
- Cover the 0 sentinel end-to-end through the lazy wrapper with fake
  timers (mirrors the direct-Anthropic 0-disable test): advance 400s
  past the generic budget, assert no watchdog abort, then cancel
  cleanly.
- Add Unreleased changelog entries for pi-ai and pi-catalog with
  external attribution for #7892.
2026-08-07 15:39:04 +08:00
..
2026-08-06 13:32:34 +02:00

@oh-my-pi/pi-catalog

Model catalog for oh-my-pi: bundled model database, provider discovery, model identity, classification, and equivalence.

What's inside

Module Purpose
models.json + models Bundled model database (pricing, context windows, modalities, thinking support)
provider-models Provider catalog descriptors (CATALOG_PROVIDERS), per-provider model resolution rules
discovery Runtime model discovery for OpenAI-compatible endpoints, Gemini, Codex, Cursor, Antigravity, Ollama
identity Model id parsing and classification (family/version), reference resolution, equivalence, selection priority
model-thinking Thinking/reasoning metadata and generated per-model policies
model-manager / model-cache Runtime model registry with discovery refresh and on-disk caching
variant-collapse Collapsing provider-specific variants of the same underlying model
compat Request/response compatibility fixups for OpenAI- and Anthropic-shaped APIs
wire Wire-level helpers: Codex, Gemini headers, GitHub Copilot
effort Reasoning-effort level definitions

Import from subpaths (@oh-my-pi/pi-catalog/<module>) or the root barrel.

models.json is generated

Never edit src/models.json by hand — it is produced from upstream sources (stencil.so, provider catalog discovery, OpenCode docs) by scripts/generate-models.ts and the resolvers in src/provider-models/. Regenerate with:

bun run gen:models

To change an entry, fix the source: resolver overrides in provider-models/openai-compat.ts, provider entries in provider-models/descriptors.ts, generator fixups in scripts/generate-models.ts, or thinking policies in model-thinking.ts.

Install

bun add @oh-my-pi/pi-catalog

Ships TypeScript source directly (no build step); requires Bun ≥ 1.3.14.

References