Summary
The published Codex config reference and the generated config schema disagree on the default for model_providers.<id>.wire_api.
Current docs
The public config reference says:
model_providers.<id>.wire_api
chat | responses
Protocol used by the provider (defaults to \chat` if omitted).`
Source:
Current schema / repo source
The generated schema says default: "responses":
codex-rs/core/config.schema.json
- current repo snapshot shows:
"wire_api": {
"allOf": [
{
"$ref": "#/definitions/WireApi"
}
],
"default": "responses",
"description": "Which wire protocol this provider expects."
}
Why this matters
This changes the effective meaning of a config that omits wire_api, and it makes it hard to build an accurate config.toml reference from the official sources.
Request
Please make the docs and schema agree on the default for model_providers.<id>.wire_api.
If responses is the real default, the public config reference should be updated.
If chat is still intended, the generated schema should be updated instead.
Summary
The published Codex config reference and the generated config schema disagree on the default for
model_providers.<id>.wire_api.Current docs
The public config reference says:
model_providers.<id>.wire_apichat | responsesProtocol used by the provider (defaults to \chat` if omitted).`Source:
Current schema / repo source
The generated schema says
default: "responses":codex-rs/core/config.schema.jsonWhy this matters
This changes the effective meaning of a config that omits
wire_api, and it makes it hard to build an accurateconfig.tomlreference from the official sources.Request
Please make the docs and schema agree on the default for
model_providers.<id>.wire_api.If
responsesis the real default, the public config reference should be updated.If
chatis still intended, the generated schema should be updated instead.