> ## 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 Trace Emitter • AI Agent SDK
> ContextTraceEmitter: Emitter for context trace events.
# ContextTraceEmitter
> Defined in the [**Context Events**](../modules/context_events) module.
AI Agent
Emitter for context trace events.
Provides a high-level API for emitting context events during
agent execution. Handles sequence numbering and redaction.
## Constructor
No description available.
No description available.
No description available.
No description available.
No description available.
## Methods
Set current branch context for parallel execution tracking.
Clear the current branch context.
Emit session start event.
Emit session end event.
Emit agent start event.
Emit agent end event.
Emit message added event.
Emit tool call start event.
Emit tool call end event.
Emit LLM request event.
Emit LLM response event.
Emit context snapshot event with full context state.
Emit agent handoff event for tracking agent-to-agent flow.
Emit memory store event for tracking memory writes.
Emit memory search event for tracking memory reads.
Emit knowledge search event for tracking knowledge retrieval.
Emit knowledge add event for tracking knowledge indexing.
Flush the sink.
Close the sink.
Get the session ID.
Check if emitter is enabled.
Set enabled state.
## Usage
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
sink = ContextListSink()
emitter = ContextTraceEmitter(sink=sink, session_id="my-session")
emitter.session_start()
emitter.agent_start("researcher")
emitter.message_added("researcher", "user", "Hello", 1, 10)
emitter.agent_end("researcher")
emitter.session_end()
```
## Source
`praisonaiagents/trace/context_events.py` at line 352
***
## Related Documentation