List recent agent sessions with aggregated stats — call count, total cost, token usage, and start time. Use this to find a session_id before calling get_session or to get a cost overview.

Retrieve the full captured trace for a single LLM call. Returns the prompt, system prompt, tool calls, model response, token usage, cost, and latency.

Retrieve all LLM calls in an agent run in chronological order. Use this to reconstruct the full decision chain — every prompt, tool call, and model response the agent made during a session.

Full-text search across all captured LLM calls. Searches prompts, outputs, system prompts, agent names, and user IDs. Use this to find calls related to a topic, error, or agent.

List loop runs (explicit x-agentledger-run-id or auto-inferred fresh-context loops, e.g. Ralph overnight runs) with iterations, sessions, cost, flagged-call counts, and status (running / flagged / complete).

Status of one loop run: iterations so far, total cost and tokens, flagged calls, and whether the completion promise was seen (status=complete). Loop runners and agents can use this to decide whether to continue iterating.