> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrative.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Internal Invariant Violated

> A workflow finalize step found a state that should be unreachable — a server-side bug.

**Surface:** `GET /agents/runs/{id}`, `error.type = "AgentLoopFinalizeInvariantViolated"`

## When this error occurs

`FinalizeAgentRunActivity` enforces several invariants that should be impossible to violate
given correct upstream code (e.g. attempting to finalize a run with a non-terminal status,
mismatch between the requested terminal status and the populated `TerminalFields`). This error
means one of those invariants tripped.

It is **always a server-side bug**, not a caller-recoverable condition.

## How to fix

Report the `log_id` and the run id to support. The workflow logs include the activity input
that triggered the assertion. Re-running the same conversation with a fresh run id will
typically work — the bug is deterministic on the inputs that triggered it.
