poll_events
Retrieve new events recorded by watches and hooks since a sequence number, with optional label filtering and clearing.
Instructions
Drain events recorded by watches and hooks. Read-only.
since is a sequence number, exclusive: pass back the next from the previous call to get
only what is new. label filters to one stream. clear=True drops the returned rows.
Returns {events, next, dropped, buffered}. Each row is {seq, t, label, kind} plus, for a
watch, {path, before, after}, and for a hook, {fn, self, args}. The buffer holds 2000
events across all streams; dropped counts what the cap evicted before you read it.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "poll_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clear | No | ||
| label | No | ||
| limit | No | ||
| since | No |