Read new events of a Berrys agent run
playground_run_eventsReturn only what changed in a run since afterSeq: compact events, a status line, pending approvals, the final response once it ends, nextAfterSeq, and retry_after_seconds (wait that long before polling again; null once the run has ended). Give runId, or conversationId for the latest run in that conversation (e.g. after reconnecting). Pass waitSeconds (up to 25) to have the server wait for new events or a status change before answering. Read-only.
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": {
"projectId": "<projectId>"
},
"name": "playground_run_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results to return in this page. | |
| runId | No | Run ID returned by preparation or execution for this project. | |
| afterSeq | No | Last event sequence number already received; return only later events. | |
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. | |
| waitSeconds | No | Maximum seconds to wait for new events or a job update; prefer long polling over repeated immediate requests. Optional long poll: wait up to this many seconds (0–25, default 0) on the server for a change before returning. | |
| conversationId | No | Conversation ID for filtering or continuing the associated agent work. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | Suggested next action; it does not authorize spending. | |
| error | Yes | ||
| runId | Yes | ||
| events | Yes | ||
| status | Yes | ||
| hasMore | Yes | ||
| response | Yes | ||
| statusLine | Yes | ||
| nextAfterSeq | Yes | ||
| conversationId | Yes | ||
| pendingApprovals | Yes | ||
| retry_after_seconds | Yes |