Struct SessionDomain 

pub struct SessionDomain {

    pub id: SessionId,
    pub agent_type: AgentType,
    pub model: Model,
    pub model_display_override: Option<String>,
    pub status: SessionStatus,
    pub current_activity: Option<ActivityDetail>,
    pub context: ContextUsage,
    pub cost: Money,
    pub duration: SessionDuration,
    pub lines_changed: LinesChanged,
    pub started_at: DateTime<Utc>,
    pub last_activity: DateTime<Utc>,
    pub working_directory: Option<String>,
    pub claude_code_version: Option<String>,
    pub tmux_pane: Option<String>,
    pub project_root: Option<String>,
    pub worktree_path: Option<String>,
    pub worktree_branch: Option<String>,
    pub parent_session_id: Option<SessionId>,
    pub child_session_ids: Vec<SessionId>,
    pub first_prompt: Option<String>,
}

Core domain model for a Claude Code session.

Contains pure business logic and state. Does NOT include infrastructure concerns (PIDs, sockets, file paths).

Consistent with CONCURRENCY_MODEL.md RegistryActor ownership.

Fields

id: SessionId

Unique session identifier

agent_type: AgentType

Type of agent (main, subagent, etc.)

model: Model

Claude model being used

model_display_override: Option<String>

Display name override for unknown/non-Anthropic models. When model is Unknown, this holds the raw model ID or the provider-supplied display name for UI rendering.

status: SessionStatus

Current session status (3-state model)

current_activity: Option<ActivityDetail>

Current activity details (tool name, context, timing)

context: ContextUsage

Context window usage

cost: Money

Accumulated cost

duration: SessionDuration

Session duration tracking

lines_changed: LinesChanged

Lines of code changed

started_at: DateTime<Utc>

When the session started

last_activity: DateTime<Utc>

Last activity timestamp

working_directory: Option<String>

Working directory (project root)

claude_code_version: Option<String>

Claude Code version

tmux_pane: Option<String>

Tmux pane ID (e.g., “%5”) if session is running in tmux

project_root: Option<String>

Git project root (resolved from working_directory). Shared across all worktrees of the same repo.

worktree_path: Option<String>

Git worktree path (specific checkout directory). For the main checkout, this equals project_root.

worktree_branch: Option<String>

Git branch name for this worktree.

parent_session_id: Option<SessionId>

Parent session ID (set when this session is a subagent).

child_session_ids: Vec<SessionId>

Child subagent session IDs spawned by this session.

first_prompt: Option<String>

First user prompt (captured from the first UserPromptSubmit hook event).

Implementations

impl SessionDomain

pub fn new(id: SessionId, agent_type: AgentType, model: Model) -> Self

Creates a new SessionDomain with required fields.

pub fn from_status_line(data: &StatusLineData) -> Self

Creates a SessionDomain from Claude Code status line data.

pub fn update_from_status_line(&mut self, data: &StatusLineData) -> bool

Updates the session with new status line data.

When current_usage is null in Claude’s status line, all current_* values will be 0, which correctly resets context percentage to 0%.

Returns true if the working directory changed (caller should re-resolve git info).

pub fn apply_hook_event( &mut self, event_type: HookEventType, tool_name: Option<&str>, )

Updates status based on a hook event.

pub fn set_first_prompt(&mut self, prompt: &str)

Stores the first user prompt if not already set.

pub fn apply_notification(&mut self, notification_type: Option<&str>)

Updates status based on a notification event.

pub fn age(&self) -> Duration

Returns the session age (time since started).

pub fn time_since_activity(&self) -> Duration

Returns time since last activity.

pub fn needs_context_attention(&self) -> bool

Returns true if context usage needs attention.

Trait Implementations

impl Clone for SessionDomain

fn clone(&self) -> SessionDomain

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionDomain

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

Formats the value using the given formatter.

impl Default for SessionDomain

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SessionDomain

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&SessionDomain> for SessionView

fn from(session: &SessionDomain) -> Self

Converts to this type from the input type.

impl Serialize for SessionDomain

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

where __S: Serializer,

Serialize this value into the given Serde serializer.