Feat: cxa-1833 update model/list (#12958)

### Summary
Update `model/list` in app server to include more upgrade information.
This commit is contained in:
Shijie Rao
2026-02-26 17:02:24 -08:00
committed by GitHub
parent a11da86b37
commit 8715a6ef84
10 changed files with 166 additions and 6 deletions

View File

@@ -90,20 +90,26 @@ directory (it returns the restored thread summary).
Fetch the catalog of models available in the current Codex build with `model/list`. The request accepts optional pagination inputs:
- `pageSize` number of models to return (defaults to a server-selected value)
- `limit` number of models to return (defaults to a server-selected value)
- `cursor` opaque string from the previous responses `nextCursor`
Each response yields:
- `items` ordered list of models. A model includes:
- `data` ordered list of models. A model includes:
- `id`, `model`, `displayName`, `description`
- `supportedReasoningEfforts` array of objects with:
- `reasoningEffort` one of `minimal|low|medium|high`
- `reasoningEffort` one of `none|minimal|low|medium|high|xhigh`
- `description` human-friendly label for the effort
- `defaultReasoningEffort` suggested effort for the UI
- `inputModalities` accepted input types for the model
- `supportsPersonality` whether the model supports personality-specific instructions
- `isDefault` whether the model is recommended for most users
- `upgrade` optional recommended upgrade model id
- `upgradeInfo` optional upgrade metadata object with:
- `model` recommended upgrade model id
- `upgradeCopy` optional display copy for the upgrade recommendation
- `modelLink` optional link for the upgrade recommendation
- `migrationMarkdown` optional markdown shown when presenting the upgrade
- `nextCursor` pass into the next request to continue paging (optional)
## Collaboration modes (experimental)