diff --git a/work-items/open/20260530-054927-refresh-builtin-model-catalog/item.md b/work-items/open/20260530-054927-refresh-builtin-model-catalog/item.md new file mode 100644 index 00000000..d66040e3 --- /dev/null +++ b/work-items/open/20260530-054927-refresh-builtin-model-catalog/item.md @@ -0,0 +1,56 @@ +--- +id: 20260530-054927-refresh-builtin-model-catalog +slug: refresh-builtin-model-catalog +title: Refresh builtin model catalog to current provider recommendations +status: open +kind: task +priority: P2 +labels: [models, providers, catalog, research] +created_at: 2026-05-30T05:49:27Z +updated_at: 2026-05-30T05:50:04Z +assignee: null +legacy_ticket: null +--- + +## Background + +`resources/models/builtin.toml` contains the built-in model catalog used by the Profile/Manifest resolver. It currently includes a small set of Anthropic, Codex/OpenAI OAuth, Ollama, and OpenRouter entries. Some entries may be stale, provider-specific recommendations may have changed, and context-window/effective-window metadata should be checked against current provider documentation before public release. + +The goal is to research the current provider-recommended model set for the providers already represented in the catalog and update the built-in catalog accordingly. This should not become a broad provider integration redesign. + +Current catalog files: + +- `resources/models/builtin.toml` +- `resources/providers/builtin.toml` +- `resources/profiles/default.lua` references `codex-oauth/gpt-5.5` + +## Requirements + +- Research current provider-recommended model IDs and metadata for providers currently represented in the built-in catalog: + - Anthropic direct provider; + - OpenAI/Codex OAuth provider; + - OpenRouter provider; + - Ollama local placeholder entries, if applicable. +- Use authoritative provider documentation or model-list endpoints where practical. Record sources in the ticket thread or an artifact. +- Update `resources/models/builtin.toml` to replace stale models with current recommended models. +- Preserve or intentionally update default profile model choice in `resources/profiles/default.lua`; if changing it, explain why. +- Verify context window and effective context window metadata, especially for models used by default profiles and compaction heuristics. +- Keep provider definitions in `resources/providers/builtin.toml` unchanged unless model catalog research proves a provider entry itself is stale or wrong. +- Avoid adding speculative models that are not generally available or not supported by the current provider client implementation. +- Keep local/Ollama entries generic unless a specific local model recommendation is clearly justified. + +## Non-goals + +- Do not add a new provider client implementation. +- Do not redesign provider authentication or model routing. +- Do not add dynamic model discovery at runtime. +- Do not remove user override support for `~/.config/insomnia/models.toml` / `providers.toml`. +- Do not change Profile authoring semantics. + +## Acceptance criteria + +- A short research note is recorded with provider sources and selected model IDs. +- `resources/models/builtin.toml` is updated to the current recommended set or explicitly confirmed current. +- Default profile model choice is confirmed or updated with rationale. +- Catalog parsing/merge tests pass. +- Validation includes at least `cargo test -p provider`, `cargo test -p manifest model`, `cargo fmt --check`, and `./tickets.sh doctor`. diff --git a/work-items/open/20260530-054927-refresh-builtin-model-catalog/thread.md b/work-items/open/20260530-054927-refresh-builtin-model-catalog/thread.md new file mode 100644 index 00000000..f7f005ae --- /dev/null +++ b/work-items/open/20260530-054927-refresh-builtin-model-catalog/thread.md @@ -0,0 +1,26 @@ + + +## Created + +Created by tickets.sh create. + +--- + + + +## Plan + +## Preflight + +Classification: research-first / implementation-ready after sources are recorded. + +The work is mostly data/catalog maintenance. It should begin with current provider documentation/model-list research and a short source note before editing the catalog. Implementation should be limited to `resources/models/builtin.toml` and directly related docs/tests unless research proves a provider definition is wrong. + +Critical risks: +- Do not guess model IDs or context windows from memory. +- Do not add models that the current provider client cannot address. +- Do not churn provider definitions unless needed. +- If changing the default profile model, explain the product reason and verify compaction/effective window metadata. + + +---