Struct Session 

pub struct Session {
    pub id: SessionId,
    pub user_id: String,
    pub user_messages: Vec<UserMessage>,
    pub agent_responses: Vec<AgentResponse>,
    pub trajectory_steps: Vec<TrajectoryStepRecord>,
    pub active_seed_id: Option<String>,
    pub active_persona_id: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub metadata: SessionMetadata,
}

A session represents a single user conversation.

Sessions track the full message history and metadata for a user conversation. They are created per user interaction and persisted for later retrieval.

Fields

id: SessionId

Unique session identifier.

user_id: String

User ID who owns this session.

user_messages: Vec<UserMessage>

All user messages in this session.

agent_responses: Vec<AgentResponse>

All agent responses in this session.

trajectory_steps: Vec<TrajectoryStepRecord>

RFC-015: tool execution trajectory accumulated for this session. Appended on each orchestrator run; consumed by the Web UI to render the execution timeline when the session is re-opened.

active_seed_id: Option<String>

Currently active seed ID (if any).

active_persona_id: Option<String>

Currently active persona ID (for future multi-persona support).

created_at: DateTime<Utc>

Timestamp when the session was created.

updated_at: DateTime<Utc>

Timestamp when the session was last updated.

metadata: SessionMetadata

Arbitrary key-value metadata.

Implementations

impl Session

pub fn new(user_id: impl Into<String>) -> Self

Creates a new session for a user.

pub fn with_id(user_id: impl Into<String>, session_id: SessionId) -> Self

Creates a session with a specific ID.

pub fn add_user_message(&mut self, content: impl Into<String>)

Adds a user message to the session.

pub fn add_agent_response(&mut self, response: AgentResponse)

Adds an agent response to the session.

pub fn extend_trajectory(&mut self, steps: Vec<TrajectoryStepRecord>)

Appends trajectory steps to the session (RFC-015).

Called by the orchestrator after each run so the Web UI can re-render the execution timeline when the user re-opens the session.

pub fn trajectory(&self) -> &[TrajectoryStepRecord]

Returns the trajectory steps recorded in this session.

pub fn set_active_seed(&mut self, seed_id: Option<String>)

Sets the active seed ID.

pub fn set_active_persona(&mut self, persona_id: Option<String>)

Sets the active persona ID.

pub fn set_metadata(&mut self, key: impl Into<String>, value: Value)

Sets a metadata value.

pub fn get_metadata(&self, key: &str) -> Option<&Value>

Gets a metadata value.

pub fn exchange_count(&self) -> usize

Returns the total number of exchanges in this session.

pub fn is_empty(&self) -> bool

Returns true if the session is empty (no messages).

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