Class AgentSession

atomic-agent/src/turn/session.rs:106–221

/// separate session IDs and separate files.
#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct AgentSession {
    /// Unique session identifier (assigned by the agent).
    ///
    /// Format varies by agent — UUID for Claude Code, path-derived for Gemini CLI.
    pub session_id: String,

    /// The Atomic view name for this session's turn changes.
    ///
    /// Format: `agent-{session_id}`. Created on first turn recording.
    #[serde(alias = "stack_name")]
    pub view_name: String,

    /// Current lifecycle phase.
    pub phase: Phase,

    /// Number of turns completed in this session.
    ///
    /// Incremented after each successful turn recording. Turn 1 is the first
    /// turn after the session starts.
    pub turn_count: u32,

    /// Agent registry key (e.g., "claude-code", "gemini-cli").
    pub agent_name: String,

    /// Human-readable agent name (e.g., "Claude Code", "Gemini CLI").
    pub agent_display_name: String,

    /// AI vendor identifier (e.g., "anthropic", "google").
    #[serde(default)]
    pub agent_vendor: String,

    /// AI model identifier (e.g., "claude-sonnet-4-20250514").
    #[serde(default)]
    pub model: String,

    /// When the session was created.
    pub started_at: DateTime<Utc>,

    /// When the session was last interacted with (any hook callback).
    ///
    /// Updated by `apply_common_actions` via the `SessionState` trait impl.
    /// Used for stale session detection in `atomic agent status`.
    #[serde(default)]
    pub last_interaction: Option<DateTime<Utc>>,

    /// When the session ended (agent process exited).
    ///
    /// `None` while the session is active. Set when `SessionStop` is received.
    /// Cleared if the session is re-entered via `SessionStart`.
    #[serde(default)]
    pub ended_at: Option<DateTime<Utc>>,

    /// The view that was current when this session started.
    ///
    /// The agent view is forked from this view so it inherits all existing
    /// changes (e.g., `.atomicignore`, project config). When the session ends,
    /// changes can be applied back to this view.
    ///