# `LLMProxy.Cache`
[🔗](https://github.com/elixir-vibe/llm_proxy/blob/v0.3.1/lib/llm_proxy/cache.ex#L1)

Behaviour for deterministic response cache adapters.

Configure one adapter with:

    config :llm_proxy, cache: MyApp.LLMCache

The adapter receives a deterministic cache key and context map. It stores and
returns `%LLMProxy.Response{}` values; external adapters can serialize the
response if needed. Cache access requires an API key with explicit content
capture because responses include model output and request context.

# `context`

```elixir
@type context() :: %{
  optional(:actor) => LLMProxy.Actor.t(),
  optional(:api_key) => map(),
  optional(:route) => atom(),
  optional(:model) => String.t(),
  optional(:provider) => module(),
  optional(:provider_name) => String.t() | nil,
  optional(:trace_id) => String.t(),
  optional(:cache_key) => String.t(),
  optional(:metadata) => map()
}
```

# `get`

```elixir
@callback get(String.t(), context()) ::
  {:hit, LLMProxy.Response.t()} | :miss | {:error, term()}
```

# `put`
*optional* 

```elixir
@callback put(String.t(), LLMProxy.Response.t(), context()) :: :ok | {:error, term()}
```

---

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