# `MingaAgent.InferenceRoute`
[🔗](https://github.com/jsmestad/minga/blob/main/sdk/lib/minga_agent/inference_route.ex#L1)

Contract for a contributed model route that supplies model streams to Minga's native agent loop.

A route produces model output only. Minga runs every tool, approval, retry, compaction, and history step. A route never executes a tool. The contract uses only Minga-owned values, so it stays stable when Minga changes its internal model library.

This is a compile-time stub. At runtime, the real behaviour in Minga's BEAM VM is used.

# `availability`

```elixir
@type availability() ::
  {:ready, account_label :: String.t()}
  | {:unavailable, reason :: atom(), remedy :: String.t()}
```

# `error_kind`

```elixir
@type error_kind() ::
  :auth_failed
  | :rate_limited
  | :unreachable
  | :invalid_model
  | :context_transition_required
  | :request_admission_refused
  | :provider_error
  | :tool_error
  | :internal_error
  | :unknown
```

# `route_credential`

```elixir
@type route_credential() :: MingaAgent.InferenceRoute.Credential.t() | nil
```

# `availability`

```elixir
@callback availability(route_id :: String.t(), credential :: route_credential()) ::
  availability()
```

# `classify_error`

```elixir
@callback classify_error(term()) :: {error_kind(), message :: String.t()}
```

# `models`

```elixir
@callback models(config :: keyword()) :: [MingaAgent.InferenceRoute.Model.t()]
```

# `stream`

```elixir
@callback stream(MingaAgent.InferenceRoute.Request.t()) ::
  {:ok, MingaAgent.InferenceRoute.Response.t()} | {:error, term()}
```

---

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