> ## 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.

# Stage Context • AI Agent SDK

> StageContext: Context passed between escalation stages.

# StageContext

> Defined in the [**types**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/types.md) module.

AI Agent

Context passed between escalation stages.

Maintains state across stage transitions.

## Properties

**stage** `EscalationStage`

No description available.

**prompt** `str`

No description available.

**signals** `Set[EscalationSignal]`

No description available.

**steps** `List`

No description available.

**tool\_results** `List`

No description available.

**context\_summary** `str`

No description available.

**files\_read** `Set[str]`

No description available.

**files\_modified** `Set[str]`

No description available.

**tokens\_used** `int`

No description available.

**tool\_calls** `int`

No description available.

**time\_elapsed** `float`

No description available.

**checkpoint\_ids** `List[str]`

No description available.

**session\_id** `Optional[str]`

No description available.

## Methods

> [card] [add\_step()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/StageContext-add_step.md)
>
> Add a step to history.

> [card] [add\_tool\_result()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/StageContext-add_tool_result.md)
>
> Add a tool result.

> [card] [should\_escalate()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/StageContext-should_escalate.md)
>
> Check if escalation is needed based on current state.

> [card] [should\_deescalate()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/StageContext-should_deescalate.md)
>
> Check if de-escalation is appropriate.

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/escalation/types.py#L146)
>
> `praisonaiagents/escalation/types.py` at line 146

***

## Related Documentation

> [card] [Context Concept](https://praison.ai/docs/docs/concepts/context)

> [card] [Context Management](https://praison.ai/docs/docs/features/context-management)

> [card] [Context Strategies](https://praison.ai/docs/docs/features/context-strategies)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.