roboomp
289cc19325
The shared SQLite model cache wrapped every read/write in a blanket catch that swallowed unrecoverable SQLITE_CORRUPT*/SQLITE_NOTADB failures as best-effort misses, and getSharedDb cached the broken handle. A physically corrupt models.db therefore permanently disabled cached catalogs across processes: a successful live discovery could never overwrite the corrupt cache, so a runtime extension with no bundled catalog was stuck with only its bootstrap model. On those unrecoverable codes the cache now self-heals: close the handle, quarantine models.db(+-wal/-shm) to models.db.corrupt-<ts>, recreate a fresh database, and retry the operation once. SQLITE_BUSY, permission, and unrelated errors keep their existing best-effort paths. The SQLITE_BUSY/corruption classifiers moved to @oh-my-pi/pi-utils so the credential store and model cache share one implementation. Fixes #8867
@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.