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

# Context Events • AI Agent SDK

> Context Events for PraisonAI Agents.

# context\_events

AI Agent

Context Events for PraisonAI Agents.

Provides context-level tracing for replay functionality.
Tracks context changes during agent execution for debugging and replay.

Zero Performance Impact:

* NoOpSink is the default (zero overhead when not used)
* Disabled emitter has near-zero overhead
* Uses **slots** for memory efficiency

Schema Version: 1.1 (adds optional run\_id / parent\_seq / node\_id; 1.0 files still load)

## Import

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

## Classes

> [card] [ContextEventType](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ContextEventType.md)
>
> Types of context events for replay.

> [card] [ContextEvent](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ContextEvent.md)
>
> A single context event for replay.

> [card] [ContextTraceSinkProtocol](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ContextTraceSinkProtocol.md)
>
> Protocol for context trace event sinks.

> [card] [ContextNoOpSink](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ContextNoOpSink.md)
>
> No-operation sink that discards all events.

> [card] [ContextListSink](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ContextListSink.md)
>
> Sink that collects events in a list.

> [card] [ContextTraceEmitter](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ContextTraceEmitter.md)
>
> Emitter for context trace events.

## Functions

> [card] [get\_context\_emitter()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/get_context_emitter.md)
>
> Get the current context trace emitter.

> [card] [set\_context\_emitter()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/set_context_emitter.md)
>
> Set the context trace emitter for the current async context.

> [card] [reset\_context\_emitter()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/reset_context_emitter.md)
>
> Reset the context emitter to its previous state.

> [card] [trace\_context()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/trace_context.md)
>
> Context manager for trace emitter lifecycle.

> [card] [copy\_context\_to\_callable()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/copy_context_to_callable.md)
>
> Wrap a callable to copy the current context to the new thread/executor.

### Constants

| Name | Value |
| - | - |
| `CONTEXT_SCHEMA_VERSION` | `'1.1'` |
| `_SPAN_START` | `{'session_start': 'session', 'agent_start': 'agent', 'tool_call_start': 'tool_call', 'workflow_start': 'workflow', 'task_start': 'task', 'step_start': 'step', 'approval_requested': 'approval'}` |
| `_SPAN_END` | `{'session_end': 'session', 'agent_end': 'agent', 'tool_call_end': 'tool_call', 'workflow_end': 'workflow', 'task_end': 'task', 'step_end': 'step', 'approval_decided': 'approval'}` |
| `_PREVIEW_LIMIT` | `500` |
| `_UNSET` | `object()` |

***

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