> ## 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.
# Agent Run Outcome • AI Agent SDK
> AgentRunOutcome: Structured outcome for agent execution, validation, and handoff operations.
# AgentRunOutcome
> Defined in the [**Run Outcome**](../modules/run_outcome) module.
AI Agent
Structured outcome for agent execution, validation, and handoff operations.
Replaces freeform string parsing with typed status values that callers
can match exhaustively. Provides structured metadata for debugging and
retry policies.
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#8B0000', 'primaryTextColor': '#fff', 'primaryBorderColor': '#710101', 'lineColor': '#189AB4', 'secondaryColor': '#189AB4', 'tertiaryColor': '#fff' }}}%%
graph LR
input["Input Data"] --> agent["Agent: AgentRunOutcome"]
agent --> output["Output Result"]
style agent fill:#8B0000,color:#fff
style input fill:#8B0000,color:#fff
style output fill:#8B0000,color:#fff
```
## Properties
No description available.
No description available.
No description available.
No description available.
No description available.
No description available.
No description available.
No description available.
## Methods
Create a successful outcome.
Create a general failure outcome.
Create a timeout outcome.
Create a cancelled outcome.
Create an invalid output outcome.
Check if the outcome represents successful completion.
Check if the outcome represents any kind of failure.
Check if this outcome represents a potentially retryable failure.
* **to\_dict**: Convert to dictionary for serialization or logging.
## Usage
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
Success case:
>>> outcome = AgentRunOutcome(status="success", output="Task completed")
>>> assert outcome.is_success()
Validation failure:
>>> outcome = AgentRunOutcome(
... status="invalid_output",
... error="Output format is invalid",
... error_category="validation"
... )
>>> assert outcome.is_retryable()
Timeout with context:
>>> outcome = AgentRunOutcome(
... status="timeout",
... error="Agent timed out after 30s",
... elapsed_s=30.0,
... agent_name="researcher"
... )
```
## Source
`praisonaiagents/run_outcome.py` at line 78
***
## Related Documentation