What changed since a cursor — the polling primitive
get_feed_changesOne stream, two checkpoint owners. Stateful callers pass cursor:"latest", then store each next_cursor themselves; that first call only establishes the checkpoint and returns no events, so poll again with the returned next_cursor. Stateless scheduled agents pass consumer_id; smry retains the acknowledged position and the consumer's saved where predicate. Pass exactly one. Managed batches repeat until their next_cursor is acknowledged. Every response also carries a capped source-health attention block. To read what is already there rather than what changes next, use query_feeds. Example: {"cursor":"latest","limit":20} Example: {"consumer_id":7,"limit":20}
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": "get_feed_changes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| where | No | Entry selection predicate: fields AND together; omit a field to not filter on it. Source queries/mutations accept only collection and source; use query having for source-health filters. | |
| cursor | No | Caller-managed progress: "latest" to start, then the next_cursor you stored. | |
| fields | No | Project event entries to these fields; ["id"] is the cheapest diff. id is always included. | |
| consumer_id | No | smry-managed progress: poll this consumer's saved predicate. Omit cursor and where. | |
| attention_limit | No | Sources listed per attention bucket (default 5; the *_count fields always carry the full tally). Pass up to 500 for the exhaustive roster, 0 for counts only. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| events | Yes | ||
| object | Yes | ||
| has_more | Yes | ||
| attention | Yes | Source health, capped to five per bucket (stalled: longest silent first; erroring and never_produced: alphabetical); the *_count fields carry the full tally. Query select:"sources" with having for the complete list. | |
| checkpoint | Yes | ||
| next_cursor | Yes |