Struct AcpSessionData 

pub struct AcpSessionData {
    pub session_uuid: String,
    pub principal_id: Option<String>,
    pub agent_alias: String,
    pub workspace_dir: String,
    pub interaction_surface: Option<String>,
    pub token_count: u64,
    pub created_at: DateTime<Utc>,
    pub last_activity: DateTime<Utc>,
    pub messages: Vec<ConversationMessage>,
    pub trim_breadcrumb: bool,
    pub retained_context: Option<Vec<ConversationMessage>>,
}

Fields

session_uuid: String

principal_id: Option<String>

Owning principal (RFC 7141 session isolation). None marks an unscoped/legacy row, visible only to unscoped connections.

agent_alias: String

workspace_dir: String

interaction_surface: Option<String>

token_count: u64

created_at: DateTime<Utc>

last_activity: DateTime<Utc>

messages: Vec<ConversationMessage>

trim_breadcrumb: bool

Whether messages’ first non-system entry is the synthetic history-trim breadcrumb. Rows written after the trim_breadcrumb column was added carry this as recorded by the owning turn loop, never inferred from text. A row from before that column existed has no recorded value (NULL); for that one-time legacy case only, it is inferred from the first non-system message’s text, matching the interactive-session JSONL migration contract (see zeroclaw_runtime::agent::history::load_interactive_session_history_with_crumb).

retained_context: Option<Vec<ConversationMessage>>

Provider-facing retained context written by native RPC trims. None preserves the legacy provider-safe replay path.