Codex model metadata projected from cli_subprocess_core.
Summary
Functions
Coerces a reasoning effort to the nearest supported value for a model.
Returns the SDK default model from the shared core registry.
Returns the default reasoning effort for the given model (or the default model).
Returns the description for a model, if known.
Returns the display name for a model, if known.
Returns the upgrade information for a model, if available.
Returns the list of supported models visible for the inferred auth mode.
Returns models visible in the model picker.
Parses a reasoning effort value into its canonical atom form.
Renders a normalized reasoning effort as the CLI-friendly string value.
Lists the valid reasoning effort values understood by the SDK.
Returns true if a model is supported via API key authentication.
Returns the supported reasoning efforts for a model.
Returns true when the given model supports tool execution.
Types
@type client_version() :: {non_neg_integer(), non_neg_integer(), non_neg_integer()}
@type model_preset() :: %{ id: String.t(), model: String.t(), display_name: String.t(), description: String.t(), default_reasoning_effort: reasoning_effort(), supported_reasoning_efforts: [reasoning_effort_preset()], is_default: boolean(), upgrade: model_upgrade() | nil, show_in_picker: boolean(), supported_in_api: boolean(), family: String.t() | nil }
@type model_upgrade() :: %{ id: String.t(), reasoning_effort_mapping: %{required(reasoning_effort()) => reasoning_effort()} | nil, migration_config_key: String.t(), model_link: String.t() | nil, upgrade_copy: String.t() | nil }
@type reasoning_effort() :: :none | :minimal | :low | :medium | :high | :xhigh
@type reasoning_effort_preset() :: %{ effort: reasoning_effort(), description: String.t() }
Functions
@spec coerce_reasoning_effort(String.t() | atom() | nil, reasoning_effort() | nil) :: reasoning_effort() | nil
Coerces a reasoning effort to the nearest supported value for a model.
Returns the input effort unchanged when the model is unknown or already supports it.
@spec default_model(:api | :chatgpt) :: String.t()
Returns the SDK default model from the shared core registry.
@spec default_reasoning_effort(String.t() | atom() | nil) :: reasoning_effort() | nil
Returns the default reasoning effort for the given model (or the default model).
Returns the description for a model, if known.
Returns the display name for a model, if known.
@spec get_upgrade(String.t()) :: model_upgrade() | nil
Returns the upgrade information for a model, if available.
@spec list() :: [model_preset()]
Returns the list of supported models visible for the inferred auth mode.
@spec list_visible( :api | :chatgpt, keyword() ) :: [model_preset()]
Returns models visible in the model picker.
@spec normalize_reasoning_effort(String.t() | atom() | nil) :: {:ok, reasoning_effort() | nil} | {:error, term()}
Parses a reasoning effort value into its canonical atom form.
@spec reasoning_effort_to_string(reasoning_effort()) :: String.t()
Renders a normalized reasoning effort as the CLI-friendly string value.
@spec reasoning_efforts() :: [reasoning_effort(), ...]
Lists the valid reasoning effort values understood by the SDK.
Returns true if a model is supported via API key authentication.
@spec supported_reasoning_efforts(String.t()) :: [reasoning_effort_preset()]
Returns the supported reasoning efforts for a model.
Returns true when the given model supports tool execution.