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 compactions: Vec<CompactionRecord>,
    pub input_history: VecDeque<String>,
    pub git_branch: Option<String>,
    pub safety_mode: Option<SafetyMode>,
    pub plan: Option<PlanState>,
    pub last_token_usage: Option<TokenUsageTotals>,
    pub cumulative_token_usage: TokenUsageTotals,
    pub context_usage: Option<ContextUsageSnapshot>,
    pub forked_from: Option<String>,
    pub parent_session: Option<String>,
    pub cli_version: Option<String>,
    pub git_sha: Option<String>,
    pub tasks: TaskStore,
}

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>

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)

git_branch: Option<String>

Git branch this session was worked on, for the --resume picker. Captured at startup (impure) — ConversationHistory::new leaves it None so the pure reducer / --replay stay deterministic. Empty for non-git dirs and for sessions saved before this field existed.

safety_mode: Option<SafetyMode>

Live session state that rides on Session (which is NOT serialized — only this ConversationHistory is), snapshotted here on every save via Session::snapshot_conversation so --resume/--continue restore the safety mode and token/context meters instead of resetting them. All #[serde(default)]: sessions saved before these existed omit them, and a None safety mode falls back to the config default on resume.

plan: Option<PlanState>

Plan-mode-in-progress (see domain::PlanState): Some only when the session was saved mid-planning, so --resume re-enters plan mode with the same plan file and restore target.

last_token_usage: Option<TokenUsageTotals>

cumulative_token_usage: TokenUsageTotals

context_usage: Option<ContextUsageSnapshot>

forked_from: Option<String>

Session lineage / provenance, all #[serde(default)] (older files omit them). Stamped in the impure startup path, never the pure reducer. forked_from/parent_session are set when a session is branched from another; cli_version and git_sha record the environment at creation.

parent_session: Option<String>

cli_version: Option<String>

git_sha: Option<String>

tasks: TaskStore

The task checklist (task_create/task_update tools + /tasks command). Snapshotted on every save so –resume/–continue restore an in-flight plan; sessions saved before this field existed load an empty store.

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.