Struct Session 

pub struct Session {
    pub id: String,
    pub title: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub messages: Vec<Message>,
    pub tool_uses: Vec<ToolUse>,
    pub usage: Usage,
    pub agent: String,
    pub metadata: SessionMetadata,
}

A conversation session

Fields

id: String

title: Option<String>

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

messages: Vec<Message>

tool_uses: Vec<ToolUse>

usage: Usage

agent: String

metadata: SessionMetadata

Implementations

impl Session

pub async fn new() -> Result<Self>

Create a new session

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

Load an existing session

pub async fn last_for_directory(workspace: Option<&Path>) -> Result<Self>

Load the last session, optionally scoped to a workspace directory

When workspace is Some, only considers sessions created in that directory. When None, returns the most recent session globally (legacy behavior).

pub async fn last() -> Result<Self>

Load the last session (global, unscoped — legacy compatibility)

pub async fn save(&self) -> Result<()>

Save the session to disk

pub fn add_message(&mut self, message: Message)

Add a message to the session

pub async fn prompt(&mut self, message: &str) -> Result<SessionResult>

Execute a prompt and get the result

pub async fn prompt_with_events( &mut self, message: &str, event_tx: Sender<SessionEvent>, registry: Arc<ProviderRegistry>, ) -> Result<SessionResult>

Process a user message with real-time event streaming for UI updates. Events are sent through the provided channel as tool calls execute.

Accepts a pre-loaded ProviderRegistry to avoid re-fetching secrets from Vault on every message (which was the primary TUI performance bottleneck).

pub async fn generate_title(&mut self) -> Result<()>

Generate a title for the session based on the first message Only sets title if not already set (for initial title generation)

pub async fn regenerate_title(&mut self) -> Result<()>

Regenerate the title based on the first message, even if already set Use this for on-demand title updates or after context changes

pub fn set_title(&mut self, title: impl Into<String>)

Set a custom title for the session

pub fn clear_title(&mut self)

Clear the title, allowing it to be regenerated

pub async fn on_context_change(&mut self, regenerate_title: bool) -> Result<()>

Handle context change - updates metadata and optionally regenerates title Call this when the session context changes (e.g., directory change, model change)

pub async fn from_opencode( session_id: &str, storage: &OpenCodeStorage, ) -> Result<Self>

Import an OpenCode session into CodeTether

Loads messages and parts from OpenCode storage and converts them into a CodeTether session that can be resumed.

pub async fn last_opencode_for_directory(dir: &Path) -> Result<Self>

Try to load the last OpenCode session for a directory as a fallback

pub async fn delete(id: &str) -> Result<()>

Delete a session by ID

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.