Struct ConversationHistory 

pub struct ConversationHistory { /* private fields */ }

Conversation history manager with forge-style compaction support

Implementations

impl ConversationHistory

pub fn new() -> Self

pub fn with_config(config: CompactConfig) -> Self

Create with custom compaction configuration

pub fn aggressive() -> Self

Create with aggressive compaction for limited context windows

pub fn relaxed() -> Self

Create with relaxed compaction for large context windows

pub fn estimate_tokens(text: &str) -> usize

Estimate tokens in a string (~4 characters per token) Public so it can be used for pre-request context size estimation

pub fn add_turn( &mut self, user_message: String, assistant_response: String, tool_calls: Vec<ToolCallRecord>, )

Add a new conversation turn

pub fn add_turn_droppable( &mut self, user_message: String, assistant_response: String, tool_calls: Vec<ToolCallRecord>, droppable: bool, )

Add a turn with explicit droppable flag

pub fn needs_compaction(&self) -> bool

Check if compaction is needed using forge-style thresholds

pub fn compaction_reason(&self) -> Option<String>

Get the reason for compaction (for logging)

pub fn token_count(&self) -> usize

Get current token count

pub fn turn_count(&self) -> usize

Get number of turns

pub fn user_turn_count(&self) -> usize

Get number of user turns

pub fn clear(&mut self)

Clear all history

pub fn clear_turns_preserve_context(&mut self)

Clear turns but preserve the summary frame (for sync with truncated raw_chat_history)

Use this instead of clear() when raw_chat_history is truncated but we want to preserve the accumulated context from prior compaction.

pub fn compact(&mut self) -> Option<String>

Perform forge-style compaction with smart eviction Returns the summary that was created (for logging/display)

pub fn emergency_compact(&mut self) -> Option<String>

Emergency compaction - more aggressive than normal Used when “input too long” error occurs and we need to reduce context urgently. Temporarily switches to aggressive config, compacts, then restores original.

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

Convert history to Rig Message format for the agent Uses structured summary frames to preserve context

pub fn is_empty(&self) -> bool

Check if there’s any history

pub fn status(&self) -> String

Get a brief status string for display

pub fn files_read(&self) -> impl Iterator<Item = &str>

Get files that have been read during this session

pub fn files_written(&self) -> impl Iterator<Item = &str>

Get files that have been written during this session

pub fn to_json(&self) -> Result<String, Error>

Serialize to JSON for session persistence

pub fn from_json(json: &str) -> Result<Self, Error>

Deserialize from JSON (for session restore)

Trait Implementations

impl Clone for ConversationHistory

fn clone(&self) -> ConversationHistory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConversationHistory

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

Formats the value using the given formatter.

impl Default for ConversationHistory

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ConversationHistory

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ConversationHistory

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

where __S: Serializer,

Serialize this value into the given Serde serializer.