# Configuration Reference

All OpenResponses configuration lives under the `:open_responses` application key.

## Provider routing

Controls which adapter is used for each model name pattern.

```elixir
config :open_responses, :routing, %{
  ~r/^gpt-/ => OpenResponses.Adapters.OpenAI,
  ~r/^claude-/ => OpenResponses.Adapters.Anthropic,
  ~r/^gemini-/ => OpenResponses.Adapters.Gemini,
  ~r/^llama|^mistral|^phi|^qwen/ => OpenResponses.Adapters.Ollama,
  "default" => OpenResponses.Adapters.Mock
}
```

Keys may be a `Regex` (matched with `Regex.match?/2`) or the string `"default"`. Patterns are evaluated in insertion order; the first match wins. The `"default"` key matches any model that no pattern matched.

---

## Provider credentials

```elixir
config :open_responses, :provider_config, %{
  openai: [
    api_key: System.fetch_env!("OPENAI_API_KEY"),
    base_url: "https://api.openai.com/v1"         # optional override
  ],
  anthropic: [
    api_key: System.fetch_env!("ANTHROPIC_API_KEY"),
    base_url: "https://api.anthropic.com/v1"      # optional override
  ],
  gemini: [
    api_key: System.fetch_env!("GEMINI_API_KEY"),
    base_url: "https://generativelanguage.googleapis.com/v1beta"  # optional
  ]
}
```

Put this in `config/runtime.exs` so secrets are read at runtime, not compile time.

---

## Hosted tools

Maps tool names to modules that implement `OpenResponses.Tool`.

```elixir
config :open_responses, :hosted_tools, %{
  "get_time" => MyApp.Tools.TimeZone,
  "search_docs" => MyApp.Tools.DocSearch
}
```

Default: `%{}` (no hosted tools — all function calls are external).

---

## Middleware

List of modules implementing `OpenResponses.Middleware`, applied in order.

```elixir
config :open_responses, :middlewares, [
  MyApp.Middleware.AuditLog,
  MyApp.Middleware.TokenBudget
]
```

Default: `[]` (no middleware).

---

## MCP servers

Pre-configured MCP server connections available to all requests.

```elixir
config :open_responses, :mcp_servers, [
  %{
    name: "docs",
    url: "https://docs-mcp.example.com",
    headers: [{"authorization", "Bearer #{System.get_env("MCP_TOKEN")}"}]
  }
]
```

Default: `[]` (no pre-configured MCP servers).

---

## Ash domains

Required for Ash framework integration. The installer sets this automatically.

```elixir
config :open_responses, :ash_domains, [OpenResponses.Responses]
```

---

## Ash async

Controls Ash's internal async behaviour. Set to `false` in development to simplify debugging.

```elixir
config :ash, :disable_async?, false
```

---

## Cachex

The response cache is a standard Cachex instance named `:response_cache`. Configure it in your supervision tree:

```elixir
# Limit to 10,000 entries, default TTL 24h
{Cachex, name: :response_cache, limit: 10_000}
```

See the [Cachex documentation](https://hexdocs.pm/cachex) for full options.

---

## PromEx

```elixir
config :open_responses, OpenResponses.PromEx,
  manual_metrics_start: :no_async,
  drop_metrics_groups: [],
  grafana: :disabled,
  metrics_server: :disabled
```

See the [PromEx documentation](https://hexdocs.pm/prom_ex) for full options including Grafana dashboard upload.

---

## Request timeouts

The default timeout for non-streaming requests waiting for loop completion is 30 seconds. For long-running agentic loops, use streaming mode (`"stream": true`).

To change the non-streaming timeout, override the controller in your application and adjust the `receive ... after` block.

---

## Full example

A complete `config/runtime.exs` for production:

```elixir
import Config

config :open_responses, :provider_config, %{
  openai: [api_key: System.fetch_env!("OPENAI_API_KEY")],
  anthropic: [api_key: System.fetch_env!("ANTHROPIC_API_KEY")],
  gemini: [api_key: System.fetch_env!("GEMINI_API_KEY")]
}

config :open_responses, :routing, %{
  ~r/^gpt-/ => OpenResponses.Adapters.OpenAI,
  ~r/^claude-/ => OpenResponses.Adapters.Anthropic,
  ~r/^gemini-/ => OpenResponses.Adapters.Gemini,
  "default" => OpenResponses.Adapters.OpenAI
}

config :open_responses, :hosted_tools, %{
  "search_docs" => MyApp.Tools.DocSearch
}

config :open_responses, :middlewares, [
  MyApp.Middleware.AuditLog,
  MyApp.Middleware.RateLimit
]
```