Struct ConversationHistory 

pub struct ConversationHistory {
    pub id: String,
    pub title: String,
    pub messages: Vec<ChatMessage>,
    pub model_name: String,
    pub project_path: String,
    pub created_at: DateTime<Local>,
    pub updated_at: DateTime<Local>,
    pub total_tokens: Option<usize>,
    pub compactions: Vec<CompactionRecord>,
    pub input_history: VecDeque<String>,
}

A complete conversation history

Fields

id: String

title: String

messages: Vec<ChatMessage>

model_name: String

project_path: String

created_at: DateTime<Local>

updated_at: DateTime<Local>

total_tokens: Option<usize>

compactions: Vec<CompactionRecord>

Metadata for context compactions performed in this conversation.

input_history: VecDeque<String>

History of user input prompts for navigation (up/down arrows)

Implementations

impl ConversationHistory

pub fn new( project_path: String, model_name: String, now: DateTime<Local>, ) -> Self

Create a new conversation history.

now is injected rather than read from the wall clock because this runs inside the pure reducer (/clear mints a fresh conversation, and State::new mints the initial one): the id and title are a deterministic function of the caller’s clock, so --replay reproduces them exactly.

pub fn add_messages(&mut self, messages: &[ChatMessage], now: DateTime<Local>)

Add messages to the conversation. now is the caller’s injected clock (state.now inside the reducer) — mutation methods never read the wall clock themselves so update() stays a pure function.

pub fn replace_messages( &mut self, messages: Vec<ChatMessage>, now: DateTime<Local>, )

Replace the model-visible message log without deriving a new title. Used by context compaction: the original title still describes the session better than the generated checkpoint. The messages keep their own timestamps (they rode in on the Msg payload); only updated_at is stamped, from the injected clock.

pub fn add_compaction(&mut self, record: CompactionRecord, now: DateTime<Local>)

Record a completed context compaction. now injected — see Self::add_messages.

pub fn add_to_input_history(&mut self, input: String)

Add input to history (with deduplication of consecutive identical inputs)

pub fn summary(&self) -> String

Get a summary for display

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<'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.