OpenSana Docs
CLI Internals

CLI Lifecycle

Follow a thread from session registration to streamed completion or failure.

Session Lifecycle

  1. CLI resolves profile config.
  2. CLI registers a session with the backend.
  3. CLI sends periodic heartbeats.
  4. CLI listens for pending thread work.

Thread Lifecycle

  1. pending thread discovered
  2. thread claimed with a lease
  3. unprocessed user messages batched
  4. assistant envelope created
  5. runtime executed
  6. chunks appended during streaming
  7. assistant finalized as completed or failed

Important Property

A single thread is processed sequentially under its claim, even when the CLI handles multiple threads concurrently overall.

CLI Architecture Overview

Understand the CLI as the bridge between OpenSana threads and local agent runtimes.

Claims, Heartbeats, Retries, and Failures

Understand the reliability model behind CLI thread execution.

On this page

Session LifecycleThread LifecycleImportant Property