ContextTraceEmitter
Defined in the 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
Optional[ContextTraceSink]
No description available.
str
default:"''"
No description available.
bool
default:"True"
No description available.
bool
default:"True"
No description available.
bool
default:"False"
No description available.
Methods
set_branch()
Set current branch context for parallel execution tracking.
clear_branch()
Clear the current branch context.
session_start()
Emit session start event.
session_end()
Emit session end event.
agent_start()
Emit agent start event.
agent_end()
Emit agent end event.
message_added()
Emit message added event.
tool_call_start()
Emit tool call start event.
tool_call_end()
Emit tool call end event.
llm_request()
Emit LLM request event.
llm_response()
Emit LLM response event.
context_snapshot()
Emit context snapshot event with full context state.
agent_handoff()
Emit agent handoff event for tracking agent-to-agent flow.
workflow_start()
A team, flow or agent run begins.
graph is its static graph.workflow_end()
The innermost open team/flow run ends.
task_start()
A team task starts (node_id
task:name or index).task_end()
A team task ends:
completed, failed or skipped.step_start()
An AgentFlow step (or a Route/Parallel/Loop/… pattern) starts.
step_end()
A flow step ends:
completed, failed, skipped or cached.approval_requested()
A person is asked to approve a tool call or a task’s output.
approval_decided()
The decision for
approval_id (parent_seq = the request).memory_store()
Emit memory store event for tracking memory writes.
memory_search()
Emit memory search event for tracking memory reads.
knowledge_search()
Emit knowledge search event for tracking knowledge retrieval.
knowledge_add()
Emit knowledge add event for tracking knowledge indexing.
flush()
Flush the sink.
close()
Close the sink.
session_id()
Get the session ID.
enabled()
Check if emitter is enabled.
enabled()
Set enabled state.
Usage
Source
View on GitHub
praisonaiagents/trace/context_events.py at line 589