Struct SessionState 

pub struct SessionState {
    pub messages: Vec<ConversationMessage>,
    pub tool_calls: Vec<SessionToolCall>,
    pub activity_log: Vec<SessionActivityEvent>,
    pub working_memory: SessionWorkingMemory,
    pub total_tokens: u64,
    pub context_cache_key: Option<String>,
    pub workspace_dir: Option<PathBuf>,
    pub llm_config: Option<SessionLlmConfig>,
    pub voice_config: Option<SessionVoiceConfig>,
    pub tool_settings: Option<SessionToolSettings>,
    pub reflection_settings: Option<SessionReflectionSettings>,
    pub paused_execution: Option<PausedExecutionState>,
}

Persisted session state.

Fields

messages: Vec<ConversationMessage>

Conversation history.

tool_calls: Vec<SessionToolCall>

Tool call history.

activity_log: Vec<SessionActivityEvent>

Replayable session activity timeline used to restore rich UI state.

working_memory: SessionWorkingMemory

Short-term working memory for this session.

total_tokens: u64

Total tokens used in this session (best-effort).

context_cache_key: Option<String>

Last context cache key (for smart context reduction).

workspace_dir: Option<PathBuf>

Workspace directory for sandboxed file/shell operations.

llm_config: Option<SessionLlmConfig>

Session-scoped LLM configuration.

voice_config: Option<SessionVoiceConfig>

Session-scoped voice configuration.

tool_settings: Option<SessionToolSettings>

Session-scoped tool settings.

reflection_settings: Option<SessionReflectionSettings>

Session-scoped experiential reflection settings.

paused_execution: Option<PausedExecutionState>

Paused execution state for resumable sessions.

When the user pauses (cancels) a streaming response, the execution state is captured here so it can be resumed later via @continue (CLI) or the resume button (GUI).

Implementations

impl SessionState

pub fn with_workspace(workspace_dir: PathBuf) -> Self

Create a new session state with a workspace directory.

pub fn get_recent_messages(&self, limit: usize) -> Vec<&ConversationMessage>

Get the most recent messages in the session.

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

Add a user message.

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

Add an assistant message.

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

Remember an assistant summary without appending a new conversation message.

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

Append streamed continuation content to the most recent assistant message.

Returns true when the last conversation entry was an assistant message and the additional content/thinking was merged into that entry.

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

Add a tool result message.

pub fn record_tool_call(&mut self, call: SessionToolCall)

Record a tool call.

pub fn record_activity_event( &mut self, event_type: impl Into<String>, payload: Option<Value>, )

Append a replay/export activity event to the session timeline.

pub fn remember_decision( &mut self, summary: impl Into<String>, rationale: Option<String>, tags: Vec<String>, )

Add a decision to session working memory.

pub fn remember_blocker( &mut self, summary: impl Into<String>, detail: Option<String>, )

Add or refresh a blocker in session working memory.

pub fn resolve_blocker(&mut self, summary: &str)

Resolve an existing blocker in session working memory.

pub fn remember_resource( &mut self, kind: SessionMemoryResourceKind, label: impl Into<String>, value: impl Into<String>, source: impl Into<String>, )

Track an explicit resource in session working memory.

pub fn relevant_working_memory_sections( &self, query: &str, limit: usize, ) -> Vec<String>

Return prompt-ready short-term memory sections relevant to the query.

pub fn promotion_candidates( &self, limit: usize, ) -> Vec<SessionMemoryPromotionCandidate>

Return high-value short-term memory candidates for durable promotion.

pub fn to_pipeline_messages(&self) -> Vec<Message>

Convert to pipeline messages.

Trait Implementations

impl Clone for SessionState

fn clone(&self) -> SessionState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionState

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

Formats the value using the given formatter.

impl Default for SessionState

fn default() -> SessionState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SessionState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.