# `LlmCall.Reasoning`
[🔗](https://github.com/gilbertwong96/llm_call/blob/main/lib/llm_call/reasoning.ex#L1)

Canonical reasoning controls.

Providers expose different axes, so `effort` is a hint, `budget_tokens` is for
explicit thinking budgets, and `summary` is for a separate reasoning-summary
control. A codec that cannot express a non-nil field returns a validation
error instead of dropping it.

# `effort`

```elixir
@type effort() :: level() | nil
```

# `level`

```elixir
@type level() :: :none | :minimal | :low | :medium | :high | :xhigh | :max
```

# `summary`

```elixir
@type summary() :: :auto | :concise | :detailed | nil
```

# `t`

```elixir
@type t() :: %LlmCall.Reasoning{
  budget_tokens: pos_integer() | nil,
  effort: effort(),
  provider_options: map(),
  summary: summary()
}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
