Struct LoopRecord 

pub struct LoopRecord {

    pub loop_id: String,
    pub session_id: String,
    pub agent_id: String,
    pub parent_loop_id: Option<String>,
    pub continuation_kind: ContinuationKind,
    pub started_at: DateTime<Utc>,
    pub ended_at: Option<DateTime<Utc>>,
    pub status: LoopStatus,
    pub rejection: Option<String>,
    pub config: Option<LoopConfigSnapshot>,
    pub messages: Vec<AgentMessage>,
    pub turns: Vec<Turn>,
    pub usage: Usage,
    pub metadata: Option<Value>,
    pub events: Vec<LoopEvent>,
    pub children_loop_ids: Vec<String>,
    pub child_loop_refs: Vec<ChildLoopRef>,
    pub parallel_group: Option<ParallelGroupRecord>,
    pub compaction_block: Option<CompactionBlock>,
}

A complete record of one agent-loop execution.

Loop origin classification

parent_loop_id	continuation_kind	Meaning
None	Initial	Fresh origin loop (agent_loop)
Some(p), same session	Default	Regular continuation
Some(p), same session	Rerun	Retry / error recovery
Some(p), same session	Branch	Branch exploration
Some(p), different session	Initial	Sub-agent loop (spawned by a tool)

Tree navigation

• Parent → children: iterate children_loop_ids
• Child → parent: read parent_loop_id
• Sub-agent children (cross-session): iterate child_loop_refs

Fields

loop_id: String

Unique identifier for this loop execution.

session_id: String

Session this loop belongs to.

agent_id: String

Agent that ran this loop.

parent_loop_id: Option<String>

loop_id of the loop that directly preceded this one (if any).

• None for origin loops (started by agent_loop).
• Some(id) for continuations started by agent_loop_continue.
• For sub-agent loops, parent_loop_id refers to the tool call loop in a different session.

continuation_kind: ContinuationKind

How this loop relates to its parent.

• Initial for origin loops (agent_loop) and sub-agent loops.
• Default for regular same-session continuations.
• Rerun for retries / error recovery.
• Branch {..} for branch explorations.

started_at: DateTime<Utc>

Timestamp from AgentStart.

ended_at: Option<DateTime<Utc>>

Timestamp from AgentEnd (None while running or pending).

status: LoopStatus

rejection: Option<String>

Set when AgentEnd.rejection is Some(_) (input filter blocked the run).

config: Option<LoopConfigSnapshot>

Identifies the model and provider that ran this loop.

Populated from the first Message::Assistant seen in the loop. None if the loop ended before any assistant message was produced.

messages: Vec<AgentMessage>

All new messages produced by this loop — taken directly from AgentEnd.messages.

These are the authoritative messages for replay and branching. To resume from a loop, reconstruct an AgentContext with the full message history (prior loop messages + these) and call agent_loop_continue.

turns: Vec<Turn>

Materialized turn records, one per LLM call-response cycle.

Built by [SessionRecorder] from TurnStart/TurnEnd event pairs. Empty for old sessions that predate turn materialization, or for loops that ended before any turn completed (rejected, aborted).

usage: Usage

Token usage from AgentEnd.usage.

metadata: Option<Value>

Opaque metadata passed to AgentStart by the caller (e.g. request id).

events: Vec<LoopEvent>

Ordered event stream for this loop.

MessageUpdate (streaming delta) events are included only when [SessionRecorderConfig::include_streaming_events] is true.

children_loop_ids: Vec<String>

loop_ids of same-session child loops (continuations / reruns / branches).

This is the parent→children direction of the bidirectional loop tree. The inverse (children → parent) is parent_loop_id.

Does not include cross-session sub-agent children — those are in child_loop_refs.

child_loop_refs: Vec<ChildLoopRef>

Cross-session links to sub-agent loops spawned by tool calls in this loop.

Each entry corresponds to a ToolExecutionEnd.child_loop_id that is Some(_). Use the child_session_id to load the child Session.

parallel_group: Option<ParallelGroupRecord>

Set when this loop was part of an evaluational-parallelism group.

compaction_block: Option<CompactionBlock>

Non-destructive compaction overlay. When Some, the context loader uses this block instead of raw self.messages. The original messages remain untouched.

Implementations

impl LoopRecord

pub fn get_turn(&self, turn_index: u32) -> Option<&Turn>

Get a turn by its index. Returns None if turns are not materialized or the index is out of range.

pub fn turn_count(&self) -> usize

Number of materialized turns. Returns 0 if turns are not materialized.

Trait Implementations

impl Clone for LoopRecord

fn clone(&self) -> LoopRecord

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LoopRecord

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LoopRecord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LoopRecord

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.