Module reader 

UI-ready query API.

All functions read from the global SQLite DB and return structs that map directly to UI components (run list, conversation view, run tree).

Structs

AgentOverview

Per-agent overview within a run.

RunOverview

Aggregated overview of a run.

RunSummary

Run summary for list views.

SpanRow

Span row used to build the run orchestration tree.

TurnKindCount

TurnRow

One row of an agent’s conversation stream.

Functions

get_agent_overview

Single-agent overview (status, tokens, model).

get_agent_turns

List turns for an agent, in seq order. Paginated.

get_run_agents

All agents for a run.

get_run_overview

Aggregated run overview with turn counts.

get_run_spans

Orchestration spans for a run (caller assembles into a tree).

get_run_tree

Alias for backwards-compat with the design doc.

list_runs

List recent runs, newest first. Paginated.

search_turns

Search turns by free-text query (basic LIKE-based, sufficient for now; will be upgraded to FTS5 in P4).