Struct AgentSession 

pub struct AgentSession {
    pub id: String,
    pub title: String,
    pub created_at: DateTime<Utc>,
    pub last_active: DateTime<Utc>,
    pub model: Option<String>,
    pub state: SessionState,
}

A persisted agent session.

Fields

id: String

Unique session id.

title: String

Human-friendly title.

created_at: DateTime<Utc>

Creation time.

last_active: DateTime<Utc>

Last activity time.

model: Option<String>

Optional model hint (primarily for CLI).

state: SessionState

Unified session state (conversation history, tool calls, configs, etc.).

Implementations

impl AgentSession

pub fn new_sandbox(model: Option<String>) -> Result<Self, AppError>

Create a new session with an auto-generated sandbox workspace.

pub fn new_with_workspace( workspace_dir: PathBuf, model: Option<String>, ) -> Result<Self, AppError>

Create a new session using an existing directory as its workspace.

pub fn fork(&self) -> Self

Clone this session into a new persisted session with a fresh identity.

The fork preserves conversation history, model hints, and workspace association while assigning a new session id and fresh timestamps.

pub fn add_user_message(&mut self, content: &str, source: MessageSource)

Append a user message.

pub fn add_assistant_message(&mut self, content: &str, thinking: Option<String>)

Append an assistant message.

pub fn add_tool_message(&mut self, tool_call_id: &str, content: &str)

Append a tool result message.

pub fn message_count(&self) -> usize

Return the message count.

pub fn workspace_dir(&self) -> Option<&PathBuf>

Return the configured workspace directory.

pub fn to_pipeline_messages_limited(&self, limit: usize) -> Vec<Message>

Convert the last limit messages into pipeline messages.

pub fn to_pretty_json(&self) -> Result<String, AppError>

Serialize this session as pretty JSON.

Trait Implementations

impl Clone for AgentSession

fn clone(&self) -> AgentSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentSession

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentSession

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentSession

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

where __S: Serializer,

Serialize this value into the given Serde serializer.