ticket: refresh builtin model catalog

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`.

work-items/open/20260530-054927-refresh-builtin-model-catalog/thread.md

@@ -0,0 +1,26 @@
+<!-- event: create author: tickets.sh at: 2026-05-30T05:49:27Z -->
+
+## Created
+
+Created by tickets.sh create.
+
+---
+
+<!-- event: plan author: hare at: 2026-05-30T05:50:04Z -->
+
+## 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.
+
+
+---