<!-- GENERATED from convex-agents content/capabilities/monitor.json — do not edit by hand. -->
Watch for the next thing to react to
Block on the next typed event instead of polling. Races local error logs, deployment subscriptions, and Sentinel prod-error rows; returns the first to fire (or a quiet heartbeat).
Workflow
Call
wait_for_event
with {project_dir, event_kinds, timeout_ms}.
On kind=convex_error/next_error: decode and fix it. On kind=prod_error: triage (see sentinel) and fix. On kind=feature_request: build it. On kind=quiet: loop.
Where a harness has no blocking MCP (e.g. Copilot cloud), the pack runs a poll loop with the SAME event contract — same behavior, different mechanism.
Rules
Prefer the blocking tool; fall back to a poll loop only where blocking MCP is weak.
The event schema is fixed and versioned — the same trigger yields the same typed event.
Prod events (kind=prod_error) require a deployed cloud app plus Sentinel.