docs(m163): --provider and --model are checked against the model catalogue

[indykish]

Documents the behaviour that shipped in agentsfleet#604 (merged), and brevity-passes the changelog.

What changed on the product

--provider used to take any string; a credential naming a provider the runner could not dial was stored, reported stored, and surfaced later as a fleet that could not reach any model. Both --provider and --model are now checked against GET /v1/models — the same catalogue the dashboard's model picker reads — so the terminal and the dashboard offer the same set, and a provider becomes available by being added to the catalogue rather than by upgrading the client.

Pages

Page	Change
changelog.mdx	The Aug 15 entry rewritten — the previous one described a design that did not ship (a 116-id list compiled into the client, exit code 2 at parse time). Now: catalogue-checked, the new agentsfleet models command, and the empty/unreachable degradations.
cli/agentsfleet.mdx	New Model catalogue section for models / models --provider; the secret create row covers both flags and notes that openai-compatible accepts any model.
fleets/model-providers.mdx	The how-to opens with agentsfleet models so both identifiers are looked up rather than guessed; troubleshooting entries for an unpriced provider and an unserved model.

One correction worth calling out: the how-to's worked example used --model gpt-5, which is not a catalogue id. The new check would have refused the page's own example. Now gpt-5.6-sol, in both the command and the tenant provider show output.

Changelog brevity pass

Two parts, in separate commits.

Cut to Jul 1, 2026 — 8 of 59 entries removed. They covered the pre-release period and described behaviour later entries supersede. An Archive entry points at the git history, which keeps the full record.

Brevity pass on what remains — the eight longest lead paragraphs and eight heaviest bullets. 982 → 944 lines, 13,514 → 13,295 words (-1.6%). All 52 entries remain, every label and tag set is byte-identical, and no Breaking-changes bullet moved sections.

That is well short of the ~35-40% this was scoped against, and the measurement is why:

 bullets 77% of the file 320 bullets, median 28 words
lead paragraphs 14%
3+ sentence bullets 11% of bullets

The eight heaviest bullets shed 72 words between them — about nine each. What remains is not padding. The 146-word lease-pruning bullet carries seven distinct operator facts: the window measured from settlement rather than start, the two activity records, running leases untouched, the Activity feed kept at any age, expired-lease handling, lifetime counts unaffected, and the export warning with its endpoint.

Reaching 35% would mean deleting the "what was broken before" clause from most bullets — the clause that tells a reader whether they were affected. "A metered platform stage is charged the catalogue rate" reads very differently without "instead of resolving to zero". That is a decision about what the changelog is for, not a copy-edit, so it is left open rather than taken unilaterally.

Verification

make lint passes on every commit; no broken links; 52 <Update> entries before and after.

Greptile Summary

The PR documents catalogue-backed provider and model validation, adds a model-provider setup guide to navigation, and condenses older changelog content.

• Adds agentsfleet models and provider-credential behavior to the CLI reference.
• Adds a guided flow for selecting, storing, activating, and removing a self-managed model provider.
• Replaces pre-July changelog entries with a version-history archive link and shortens several retained entries.

Confidence Score: 5/5

The PR appears safe to merge because no eligible or outstanding blocking failure remains.

No blocking failure remains.

Important Files Changed

Filename	Overview
changelog.mdx	Adds the catalogue-validation release entry, condenses retained release notes, and archives entries before July 2026.
cli/agentsfleet.mdx	Documents catalogue listing commands and catalogue-validated model-provider secret options.
docs.json	Adds the new model-provider guide to fleet navigation.
fleets/model-providers.mdx	Adds a complete how-to for configuring and troubleshooting a self-managed model provider.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
A[Run agentsfleet models] --> B[Choose provider and model]
B --> C[Create workspace provider secret]
C --> D[Select tenant provider]
D --> E[Run fleets with self-managed provider]
E --> F[Delete tenant provider to restore platform default]

Loading

_{Reviews (3): Last reviewed commit: "fix(docs): restore the </Update> the mer..." | Re-trigger Greptile}