Skip to main content

​
Run lifecycle

This guide is a short entry point. The full walkthrough (state machine, awaiting_input, SSE, polling) is in the repository: run-lifecycle.md.

​
Quick facts

  • Runs transition through queued → running → terminal (succeeded, failed, cancelled) or stalled pending recovery.
  • Progress is observable via GET /v1/runs/{id}/events or GET /v1/runs/{id}/events/stream (SSE).
  • Human-in-the-loop flows use POST /v1/runs/{id}/signal when the run is awaiting input.
Read run-lifecycle.md for diagrams, TypeScript-oriented examples, and operational notes.