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

# Run Outcome • AI Agent SDK

> Structured run outcome types for agent execution results.

# run\_outcome

<Badge color="blue">AI Agent</Badge>

Structured run outcome types for agent execution results.

Provides a typed, closed discriminant union for agent run completions,
task validation outcomes, and handoff results across the SDK.

Replaces freeform string-based validation outcomes with type-safe status
values that enable exhaustive error handling and structured metadata.

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import run_outcome
```

## Classes

<CardGroup cols={2}>
  <Card title="TerminationReason" icon="brackets-curly" href="../classes/TerminationReason">
    Typed terminal reasons for an autonomous run.
  </Card>

  <Card title="AgentRunOutcome" icon="brackets-curly" href="../classes/AgentRunOutcome">
    Structured outcome for agent execution, validation, and handoff operations.
  </Card>
</CardGroup>

## Functions

<CardGroup cols={2}>
  <Card title="termination_to_run_status()" icon="function" href="../functions/termination_to_run_status">
    Map a `TerminationReason` (or its string value) to a `RunStatus`.
  </Card>

  <Card title="validate_decision_string()" icon="function" href="../functions/validate_decision_string">
    Convert legacy validation decision strings to typed RunStatus.
  </Card>
</CardGroup>