Container Callbacks
Container callbacks return results from first-party container-backed tools such as document rendering, dataset rendering, forecasts, recordings, and optimization.
How To Use This Page
- Review source artifact, container output, and operation events together.
- Use callback status to distinguish processing delay from failure.
- Confirm output blobs are available before sharing results.
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
- Sequence diagram: container request to callback to output blob and operation completion. It helps users understand long-running tool results. Source: document renderer operation.