# `ReqManagedAgents.OutcomeEvaluation`
[🔗](https://github.com/cash-mckeeman/req_managed_agents/blob/v0.17.0/req_managed_agents/lib/req_managed_agents/outcome_evaluation.ex#L1)

One completed grader evaluation of an outcome.

`result` is one of the five provider verdicts or `:unknown`; the provider's
own end event is kept verbatim in `raw`, including grader usage; the usage in
this end event is not added to `SessionResult.usage`. `new/1` validates
every field and never coerces; an empty `start_event_id` is valid (an interrupted evaluation).

# `raw`

```elixir
@type raw() :: map()
```

The provider's end event, verbatim; its keys and values are not interpreted here.

# `result`

```elixir
@type result() ::
  :satisfied
  | :needs_revision
  | :max_iterations_reached
  | :failed
  | :interrupted
  | :unknown
```

# `t`

```elixir
@type t() :: %ReqManagedAgents.OutcomeEvaluation{
  event_id: String.t() | nil,
  explanation: String.t() | nil,
  iteration: non_neg_integer() | nil,
  outcome_id: String.t(),
  processed_at: String.t() | nil,
  raw: raw(),
  result: result(),
  start_event_id: String.t() | nil
}
```

# `new`

```elixir
@spec new(map() | t()) :: {:ok, t()} | {:error, {:invalid_outcome_evaluation, atom()}}
```

Validates a closed atom-keyed attribute map or an existing struct.

---

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