@spec add_parallel_tool_calls(map(), keyword(), keyword()) :: map()

Adds parallel_tool_calls option to the request body.

Checks multiple option sources for the value:

• opts[:parallel_tool_calls]
• provider_opts[:openai_parallel_tool_calls]
• provider_opts[:parallel_tool_calls]

@spec add_response_format(
  map(),
  keyword()
) :: map()

Adds response_format to the request body with schema normalization.

Handles json_schema response formats by converting ReqLLM schema DSL to JSON Schema format. Supports both atom and string key maps.

@spec add_strict_to_tools(map()) :: map()

Adds strict mode settings to tools that have strict: true on their function.

For tools with strict mode enabled:

• Sets additionalProperties: false on the parameters schema
• Makes all properties required

@spec add_token_limits(map(), String.t(), keyword()) :: map()

Adds appropriate token limit parameters based on model type.

For reasoning models (o1, o3, o4, gpt-4.1, gpt-5):

• Uses max_completion_tokens instead of max_tokens
• Falls back to max_tokens value if max_completion_tokens not specified

For standard models:

• Uses max_tokens and optionally max_completion_tokens

Cleans up any existing token limit keys to ensure consistent state.

@spec codex_model?(term()) :: boolean()

Checks if model is a Codex model (codex-mini, gpt-5-codex, etc.).

@spec deepseek_model?(term()) :: boolean()

Checks if model is a DeepSeek model.

@spec ensure_all_properties_required(map()) :: map()

Ensures all properties in a function's parameters schema are required.

Also sets additionalProperties: false for strict JSON schema compliance.

@spec gpt4o_model?(term()) :: boolean()

Checks if model is a GPT-4o family model.

@spec gpt5_model?(term()) :: boolean()

Checks if model is a GPT-5 reasoning model (excludes gpt-5-chat-latest).

@spec gpt41_model?(term()) :: boolean()

Checks if model is a GPT-4.1 model.

@spec o_series_model?(term()) :: boolean()

Checks if model is an o-series reasoning model (o1, o3, o4).

@spec reasoning_model?(term()) :: boolean()

Checks if a model ID corresponds to an OpenAI reasoning model.

Reasoning models (o-series, gpt-4.1, gpt-5, codex) require special handling:

• Use max_completion_tokens instead of max_tokens
• Support reasoning_effort parameter

Note: gpt-5-chat-latest is a non-reasoning variant that uses standard conventions.

@spec responses_model?(term()) :: boolean()

Checks if a model ID should default to the Responses API.

This includes reasoning/codex families plus GPT-4o models, which support Responses even when older metadata has not been updated yet.

@spec translate_tool_choice_format(map()) :: map()

Translates ReqLLM's tool_choice format to OpenAI's function format.

ReqLLM uses %{type: "tool", name: "tool_name"} for specific tool selection. OpenAI requires %{type: "function", function: %{name: "tool_name"}}.

Handles both atom and string key maps.