session_events
Poll a session's events to observe new agent output as it works. Filter by event type and use pagination to only receive updates since last check.
Instructions
Read a session's events — the agent's output and activity. POLL this to observe.
To observe new output as the agent works, poll: pass the returned next_since
back as since on the next call to fetch only events recorded after the last
batch (events are returned oldest-first). Filter with types (e.g.
["agent.message"] for just the agent's text, or ["agent.tool_use",
"agent.tool_result"] for tool activity). When has_more is true within a
batch, pass the returned next_page token as page. Large payloads truncated.
Common types: agent.message (text), agent.thinking, agent.tool_use / agent.tool_result, agent.mcp_tool_use, session.status_idle (with stop_reason).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_id": "<session_id>"
},
"name": "session_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | ||
| types | No | ||
| since | No | ||
| limit | No | ||
| page | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||