# @oh-my-pi/pi-catalog > Model catalog for omp: bundled model database, provider discovery descriptors, model identity, classification, and equivalence Latest version **18.3.0** (published 2026-09-24) · MIT license · 0 weekly downloads ## Install ```sh npm install @oh-my-pi/pi-catalog pnpm add @oh-my-pi/pi-catalog yarn add @oh-my-pi/pi-catalog bun add @oh-my-pi/pi-catalog ``` ## Health **Score 60/100 (C)** — status: active. Positive: no vulnerabilities; recently updated; high maintenance score; popular repo. Warnings: low downloads; no types; no esm support. ## Facts | | | |---|---| | Version | 18.3.0 | | Published | 2026-09-24 | | First published | 2026-06-10 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 0 | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 27349 | | Author | Stencil Labs, Inc. | | Maintainers | can1357 | | Keywords | ai, catalog, discovery, llm, models | ## Links - npm: https://www.npmjs.com/package/@oh-my-pi/pi-catalog - Repository: https://github.com/can1357/oh-my-pi - Homepage: https://omp.sh - Issues: https://github.com/can1357/oh-my-pi/issues - npm.io page: https://npm.io/package/@oh-my-pi/pi-catalog ## Alternatives - [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads - [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads - [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads - [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads - [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads ## Recent versions - 18.3.0 (latest) — 2026-09-24 - 18.2.11 — 2026-09-23 - 18.2.10 — 2026-09-22 - 18.2.9 — 2026-09-22 - 18.2.8 — 2026-09-21 - 18.2.7 — 2026-09-21 - 18.2.6 — 2026-09-18 - 18.2.5 — 2026-09-17 - 18.2.4 — 2026-09-17 - 18.2.3 — 2026-09-17 - 18.2.2 — 2026-09-16 - 18.2.1 — 2026-09-15 - 18.2.0 — 2026-09-15 - 18.1.22 — 2026-09-14 - 18.1.21 — 2026-09-14 - … 171 more at https://npm.io/package/@oh-my-pi/pi-catalog/versions ## README # @oh-my-pi/pi-catalog Model catalog for [omp](https://github.com/can1357/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 | | `compat/rules` | Checked-in KDL policy tree: taxonomy (classes/families/revisions), class/provider cascade rules, runtime behavior vocabulary; compiled by `bun run gen:compat` into the committed `rules.json` | | `compat` | The rule engine: `classifyModel` (taxonomy), `resolveModelPolicy` (cascade), behavior accessors (`api-routes`, `model-limits`, `exclude-models`, `pricing-peer`), collapse, and OpenAI/Anthropic wire builders that consume resolved records | | `identity` | Mechanical id utilities: reference resolution against the bundled index, dialects, selection priority, tokenizer families | | `model-thinking` | Runtime thinking helpers (`getSupportedEfforts`, effort clamping/mapping, wire-id routing) over resolved model records | | `model-manager` / `model-cache` | Runtime model registry with discovery refresh and on-disk caching | | `wire` | Wire-level helpers: Codex, Gemini headers, GitHub Copilot | | `effort` | Reasoning-effort level definitions | Import from subpaths (`@oh-my-pi/pi-catalog/`) or the root barrel. ## models.json and rules.json are generated Never edit `src/models.json` or `src/compat/rules.json` by hand. `models.json` is produced from upstream sources (stencil.so, provider catalog discovery, OpenCode docs) by `scripts/generate-models.ts`; `rules.json` is compiled from the KDL tree in `src/compat/rules/`. Regenerate with: ```sh bun run gen:compat # src/compat/rules/**/*.kdl -> src/compat/rules.json bun run gen:models # upstream sources + rules -> src/models.json ``` Model- or provider-conditional policy (identity, effort ladders, wire quirks, modality/limit/pricing corrections, API routing, roster exclusions) lives in the KDL tree — see `src/compat/rules/README.md` for the grammar and axis vocabulary. TypeScript changes are only for transport mechanics: provider entries in `provider-models/descriptors.ts`, discovery/request plumbing in `provider-models/openai-compat.ts`, and generator wiring in `scripts/generate-models.ts`. Commit `rules.json` (and a rebaked `models.json` when values change) alongside the `.kdl` edit. ## Install ```sh bun add @oh-my-pi/pi-catalog ``` Ships TypeScript source directly (no build step); requires Bun ≥ 1.3.14. ## Cost calculation The `models` subpath (also exported from the root) provides timestamp-aware pricing helpers: | API | Result | | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | | `calculateCost(model, usage, timestamp?)` | Updates and returns `usage.cost` using `model.cost`. | | `calculateUsageCost(cost, usage, timestamp?)` | Updates and returns `usage.cost` using a `ModelCost`. | | `calculateUncachedInputCost(cost, promptInputTokens, timestamp?)` | Returns the cost of a fully uncached prompt. | | `getTimeBasedPricingPeriod(cost, timestamp?)` | Returns `"peak"`, `"off-peak"`, or `undefined` without a schedule. | | `getNextTimeBasedPricingTransition(cost, timestamp?)` | Returns the next actual peak/off-peak change strictly after the timestamp, or `undefined` if none exists. | Timestamps are Unix milliseconds; omitted timestamps use the current time for scheduled pricing. Flat token prices are unaffected. Pricing selects the latest applicable effective rate card, then its long-context tier, then the peak/off-peak multiplier. A transition query concerns the recurring tariff, not dated rate-card changes. `ModelCost.timeBased` is optional typed metadata (`TimeBasedCost`): `offPeakMultiplier`, `peakWindows` (UTC `weekdays`, Sunday = 0, and start-inclusive/end-exclusive `startMinute`/`endMinute`), and optional `effectiveRates`. Each effective rate is a complete `TokenCost` with an `effectiveFrom` Unix-millisecond timestamp and optional `longContext` tier, replacing the base card from that instant. Pass the request-start timestamp when estimating request usage, then preserve the resulting monetary amounts rather than repricing history at display time. OMP does this using the assistant message timestamp; it is an estimation convention, not a claim about server billing across boundaries. Prefer monetary costs reported by a provider when available. Schedules are materialized from the [`time-based-cost` KDL axis](src/compat/rules/README.md#time-based-pricing); this does not add a `timeBased` input field to the coding agent's `models.yml`. See [user-facing pricing behavior](../../docs/models.md#usage-costs-and-time-based-pricing) for DeepSeek rates, dates, and footer indicators. ## References - [Monorepo README](https://github.com/can1357/oh-my-pi#readme) - [CHANGELOG](./CHANGELOG.md) --- _Source: https://npm.io/package/@oh-my-pi/pi-catalog · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._