<!-- 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

1. Call waitforevent with {projectdir, eventkinds, timeout_ms}.
2. On kind=convexerror/nexterror: decode and fix it. On kind=proderror: triage (see sentinel) and fix. On kind=featurerequest: build it. On kind=quiet: loop.
3. 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.