Runtime
The runtime coordinates bot work, tool calls, callbacks, reminders, automations, geofences, recovery, and operation timelines.
How To Use This Page
- Use runtime docs to understand why a bot operation is queued, running, waiting, blocked, completed, failed, or canceled.
- Review operation timelines before retrying or escalating a failed workflow.
- Connect runtime behavior back to artifacts, links, blobs, and events.
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: operation lifecycle from request to run coordination, tool calls, callbacks, and final status. It helps users understand long-running work. Source: sample bot operation timeline.