Skip to content

Docs/schema mismatch: model_providers.<id>.wire_api default says 'chat' in docs but 'responses' in config schema #13628

@alhllc

Description

@alhllc

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    CLIIssues related to the Codex CLIcustom-modelIssues related to custom model providers (including local models)documentationImprovements or additions to documentation

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions