Struct Conversation 

pub struct Conversation {
    pub id: u64,
    pub history: Vec<HistoryEntry>,
    pub title: String,
    pub uptime_secs: u64,
    pub created_at: Instant,
    pub handle: Option<ConversationHandle>,
    pub topic: Option<String>,
}

A conversation tied to a specific agent.

Pure working-context container. Persistence is delegated to the Storage trait via the session handle.

Fields

id: u64

Unique conversation identifier (monotonic counter, runtime-only).

history: Vec<HistoryEntry>

Conversation history (the working context for the LLM).

title: String

Conversation title (set by the set_title tool).

uptime_secs: u64

Accumulated active time in seconds.

created_at: Instant

When this conversation was loaded/created in this process.

handle: Option<ConversationHandle>

Persistent conversation identity, assigned by the storage layer. None until the first persistence call — and remains None for tmp chats that never enter a topic.

topic: Option<String>

Topic this conversation belongs to, if any. None = tmp chat (no storage, no resume). Set by switch_topic.

Implementations

impl Conversation

pub fn new(id: u64) -> Self

Create a new conversation with an empty history.

pub fn meta(&self, agent: &str, created_by: &str) -> ConversationMeta

Build a ConversationMeta snapshot from this conversation’s current state.

Trait Implementations

impl Clone for Conversation

fn clone(&self) -> Conversation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Conversation

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

Formats the value using the given formatter.