event_cursor
Return a stream's current end as a cursor in O(1) without scanning, letting you monitor only events appended after now. Empty streams return 0.
Instructions
Return the stream's CURRENT END as a cursor (O(1), no scan) - the pre-flight monitor anchor so you see only events appended after now. Returns {cursor} (0 for empty).
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": {
"project_root": "<project_root>",
"agent_id": "<agent_id>",
"stream": "<stream>"
},
"name": "event_cursor"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stream | Yes | Event stream to read - one of: workspace, agent, handoff. message.created, the message.delivered/message.read receipts and artifact.created are on workspace. | |
| agent_id | Yes | Your agent_id; scopes per-event visibility (you only see events you may see). | |
| project_root | Yes | Absolute path to the project (defines the workspace scope). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||