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