openhuman/docs/tinyagents-full-migration-plan/02-models/04-catalog.md

02.4 — One model catalog

Model metadata is currently split across several sources: cost/catalog.rs (pricing + windows), Config::model_registry seeding/enrichment, model_context.rs tier/pattern/local fallbacks, provider capability accessors, provider effective_context_window, and docs/inference-provider-catalog.md. Crate registry::ModelCatalog is the normalized shape (ModelCatalogEntry { provider, model_id, aliases, max_input_tokens, max_output_tokens, pricing, capabilities } incl. cache/reasoning rates).

Current status (2026-07-02): cost/catalog.rs is a 622-line static pricing and window table plus registry-enrichment/estimate helpers. The unused context_window convenience wrapper is gone, the raw pricing table is private, and context_window_for_model now consults the richer lookup row for concrete model ids before falling back to legacy model-context patterns. OpenHuman's ModelPrice currently has input, cached-input, and output rates; TinyAgents ModelPricing also models cache-creation and reasoning-token rates, so the projection must preserve those gaps explicitly rather than pretending the local table is already a complete crate catalog. First projection helpers landed: tinyagents_catalog_entry_for_model maps one static OpenHuman row to a TinyAgents ModelCatalogEntry, and tinyagents_catalog_snapshot maps the whole table to ModelCatalogSnapshot, with per-token input/cache-read/output rates and context windows. Cache-creation/reasoning prices and most runtime capability flags remain unset until the catalog source can own them authoritatively.

Steps

1. Build a ModelCatalogSnapshot from OpenHuman's data: seed from crate ModelCatalog::seed(), overlay cost/catalog.rs rates/windows and remaining model_context.rs pattern fallbacks, plus local-model profiles discovered at runtime (ollama). Partially done: cost/catalog.rs can now project one static row into TinyAgents ModelCatalogEntry and all static rows into a ModelCatalogSnapshot; crate-seed merging and local-model overlays remain.
2. Point consumers at the one projection: estimate_cost_usd (cost bridge), token budgeting / effective_context_window, model picker RPC, capability filter (02.1 profiles via ModelProfile::from_catalog_entry).
3. Keep the catalog OpenHuman-refreshable (config/update path) — crate seed is a fallback, not the source.

Deletions

• Duplicate per-MTok rate tables and window constants outside the catalog (cost/catalog.rs becomes the loader/owner of the snapshot rather than a second schema, or is folded into it).

Acceptance

• Pricing/window/capability lookups have exactly one code path; cost estimates unchanged (existing catalog tests re-pointed).
• Local models appear in the catalog with runtime-discovered profiles.