Struct Session 

pub struct Session {

    pub id: String,
    pub model: String,
    pub created_at: String,
    pub updated_at: String,
    pub messages: Vec<Message>,
    pub total_tokens: u64,
    pub iteration_count: u32,
    pub tags: Vec<String>,
    pub notes: String,
    pub parent_id: Option<String>,
    pub root_id: Option<String>,
    pub branch_label: Option<String>,
    pub branch_depth: u32,
    pub labels: Vec<SessionLabel>,
}

A saved conversation session

Fields

id: String

Unique session ID

model: String

Model used for this session

created_at: String

When the session was created

updated_at: String

When the session was last updated

messages: Vec<Message>

Conversation messages

total_tokens: u64

Total tokens used in this session

iteration_count: u32

Number of iterations completed

tags: Vec<String>

User-defined tags for this session

notes: String

User notes/description for this session

parent_id: Option<String>

Parent session for branching

root_id: Option<String>

Root session of this branch

branch_label: Option<String>

User-provided branch name

branch_depth: u32

Depth in branch tree (cap at 5 when enforced by callers)

labels: Vec<SessionLabel>

Named bookmarks

Implementations

impl Session

pub fn new(model: &str) -> Self

Create a new session

pub fn new_with_id(id: String, model: &str, tags: Vec<String>) -> Self

Create a new session with a specific ID (e.g. for updates)

pub fn new_with_tags(model: &str, tags: Vec<String>) -> Self

Create a new session with tags

pub fn new_with_notes(model: &str, notes: String) -> Self

Create a new session with notes

pub fn sessions_dir() -> Result<PathBuf>

Get the sessions directory (~/.pawan/sessions/)

pub fn save(&mut self) -> Result<PathBuf>

Save session to disk

pub fn load(id: &str) -> Result<Self>

Load a session from disk by ID

pub fn add_tag(&mut self, tag: &str) -> Result<()>

Add a tag to the session (validates and prevents duplicates)

pub fn remove_tag(&mut self, tag: &str) -> Result<()>

Remove a tag from the session

pub fn clear_tags(&mut self)

Clear all tags from the session

pub fn has_tag(&self, tag: &str) -> bool

Check if session has a specific tag

pub fn from_json_file(path: impl AsRef<Path>) -> Result<Self>

Import a session from a JSON file

pub fn list() -> Result<Vec<SessionSummary>>

List all saved sessions (sorted by updated_at, newest first)

Trait Implementations

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