Struct Session 

pub struct Session {
    pub id: SessionId,
    pub name: String,
    pub working_dir: PathBuf,
    pub created_at: u64,
    pub updated_at: u64,
    pub messages: Vec<Message>,
    pub user_renamed: bool,
}

A session represents an independent conversation context.

Fields

id: SessionId

Unique identifier.

name: String

Display name (AI-generated or user-specified).

working_dir: PathBuf

Working directory this session is associated with.

created_at: u64

Creation timestamp (seconds since UNIX epoch).

updated_at: u64

Last update timestamp.

messages: Vec<Message>

Conversation messages.

user_renamed: bool

True once the user has explicitly run /rename. Drives the session-name badge above the input box: auto-named sessions (default / session-* / first-message-derived) stay badge-less so the chrome doesn’t get noisy on every fresh conversation — the badge is reserved for names the user deliberately chose. #[serde(default)] so sessions saved before this field exists load as false (i.e., behave like auto-named).

Implementations

impl Session

pub fn new(working_dir: PathBuf) -> Self

Create a new session for the given working directory.

pub fn default_session(working_dir: PathBuf) -> Self

Create a default session (used on first launch).

pub fn rename(&mut self, name: String)

Update the session’s name in response to an explicit user /rename. Also flips user_renamed so the session-name badge becomes visible — auto_name_from_messages must NOT call this.

pub fn auto_name_from_messages(&mut self)

Auto-name an untouched session from the first real user message.

This mirrors the TUI persistence behavior: default names are replaced by the first non-synthetic user turn, while user-renamed sessions are left alone.

pub fn touch(&mut self)

Update the last modified timestamp.

pub fn short_id(&self) -> &str

Get a short display ID (first 8 chars of UUID).

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Session

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Session> for SessionMeta

fn from(session: &Session) -> Self

Converts to this type from the input type.

impl Serialize for Session

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

where __S: Serializer,

Serialize this value into the given Serde serializer.