Struct CompactedHistory 

pub struct CompactedHistory { /* private fields */ }

Compacted view over a SessionGraph’s event log.

External operators implementing Compactor for a custom strategy (LLM-summary compaction, importance-weighted retention, …) construct the initial form via CompactedHistory::group and return either the same value or one rebuilt with CompactedHistory::from_turns after filtering. The tool_call / tool_result pair invariant stays type-enforced: the only path to a ToolPair is the internal grouping code, so external impls can drop or pass through tool round-trips but can’t synthesize unmatched ones.

Implementations

impl CompactedHistory

pub fn group(events: &[GraphEvent]) -> Result<Self>

Group events into the type-enforced Turn shape and return the un-trimmed compaction. The grouping rejects an event log that violates the pair invariant before compaction (e.g. ToolResult without a preceding ToolCall); a well-formed SessionGraph never hits the error path.

External Compactor impls call this to get the initial grouped form, then choose which turns to retain.

pub const fn from_turns(turns: Vec<Turn>) -> Self

Build a CompactedHistory from a pre-grouped Vec<Turn>. External Compactor impls reach for this after filtering or transforming the turns returned by CompactedHistory::group. The pair invariant survives the round-trip because the only path to a ToolPair is still the internal grouping — operators pass them through but can’t synthesize new ones.

pub fn turns(&self) -> &[Turn]

Borrow the compacted turns.

pub const fn len(&self) -> usize

Number of turns retained.

pub const fn is_empty(&self) -> bool

Whether the compacted history is empty.

pub fn to_messages(&self) -> Vec<Message>

Render as Vec<Message> suitable for ChatModel::complete. Mirrors crate::SessionGraph::current_branch_messages but over the compacted view: every assistant turn’s tool_use blocks are followed by a synthetic Role::Tool message per ToolPair, so the wire-side codec sees the matched pairs the vendor expects.

Trait Implementations

impl Clone for CompactedHistory

fn clone(&self) -> CompactedHistory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompactedHistory

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

Formats the value using the given formatter.