Run Coordinators
Run coordinators keep active operations moving without losing track of state, retries, or terminal outcomes.
How To Use This Page
- Use coordinator behavior to understand why work wakes, waits, retries, or stops.
- Review operation status and recent events before triggering more work.
- Expect durable state to win over stale or duplicate callbacks.
Status And Event Map
Operation statuses: queued, running, waiting, blocked, completed, failed, canceled.
| Status | What It Means | User Review |
|---|---|---|
| queued | Work has been accepted but has not started. | Wait for the timeline to move or check queue health. |
| running | A bot, tool, provider, or container is actively working. | Review progress events before retrying. |
| waiting | The operation is waiting on a callback, schedule, user action, or follow-up turn. | Check what dependency is named in the timeline. |
| blocked | Work intentionally stopped until a person or external condition changes. | Read the blocking reason before taking action. |
| completed | Work reached a successful terminal state. | Inspect produced artifacts, blobs, links, or messages. |
| failed | Work reached an error terminal state. | Capture the failing step, visible error, and affected refs. |
| canceled | Work was stopped before completion. | Confirm whether a replacement operation exists. |
Review Checklist
- Start from the operation or artifact visible in the app.
- Follow events in timestamp order.
- Open produced artifacts or blobs before sharing conclusions.
- Capture status, route, artifact, operation, and visible error details when escalating.
Media To Add
- Diagram: coordinator claim, work step, callback, wake, and terminal commit. It helps developers understand runtime ownership. Source: operation runtime flow.