📜 Event Stream

The event stream is an append-only log of everything that happens: user messages, tool calls, results, plans, timers, errors, and wake boundaries. Three scripts read it.

list_events.py

Paginated timeline of events. Use to browse or scan recent history in order.

• --limit default 50 | --cursor opaque pagination | --order asc|desc | --wake-id restrict to one wake
• Returns {"ok":true,"data":[...],"cursor":"..."} — reuse cursor until null

search_events.py

Full-text search over event payloads. Find mentions, tool outcomes, or event types without reading the whole stream.

• --query required | optional --event-type, --source, --since, --until (ISO timestamps)

fetch_event.py

Load one event by id. Expand a single row when search/list returned only a summary.

• --event-id required — the event_id field

All three scripts print a JSON envelope: {"ok":true,"data":...} on success, {"ok":false,"error":...} on failure.