Struct SessionState 

pub struct SessionState {

    pub session_id: String,
    pub cli_version: Option<String>,
    pub base_commit: String,
    pub attribution_base_commit: Option<String>,
    pub worktree_path: Option<String>,
    pub worktree_id: Option<String>,
    pub started_at: String,
    pub ended_at: Option<String>,
    pub phase: Phase,
    pub turn_id: Option<String>,
    pub turn_checkpoint_ids: Vec<String>,
    pub last_interaction_time: Option<String>,
    pub step_count: i32,
    pub checkpoint_transcript_start: i64,
    pub untracked_files_at_start: Vec<String>,
    pub files_touched: Vec<String>,
    pub last_checkpoint_id: Option<CheckpointID>,
    pub agent_type: Option<String>,
    pub token_usage: Option<TokenUsage>,
    pub transcript_identifier_at_start: Option<String>,
    pub transcript_path: Option<String>,
    pub first_prompt: Option<String>,
    pub prompt_attributions: Vec<PromptAttribution>,
    pub pending_prompt_attribution: Option<PromptAttribution>,
    pub tools_used: HashSet<String>,
    pub tool_calls: i32,
    pub commits: Vec<String>,
    pub est_cost_usd: Option<f64>,
}

Session state persisted at .git/entire-sessions/<session-id>.json. Field names and JSON format match entire.io’s session.State.

Fields

session_id: String

entire.io uses sessionID (camelCase with capital ID).

cli_version: Option<String>

base_commit: String

attribution_base_commit: Option<String>

worktree_path: Option<String>

worktree_id: Option<String>

started_at: String

ended_at: Option<String>

phase: Phase

turn_id: Option<String>

turn_checkpoint_ids: Vec<String>

last_interaction_time: Option<String>

step_count: i32

checkpoint_transcript_start: i64

untracked_files_at_start: Vec<String>

files_touched: Vec<String>

last_checkpoint_id: Option<CheckpointID>

agent_type: Option<String>

token_usage: Option<TokenUsage>

transcript_identifier_at_start: Option<String>

transcript_path: Option<String>

first_prompt: Option<String>

prompt_attributions: Vec<PromptAttribution>

pending_prompt_attribution: Option<PromptAttribution>

tools_used: HashSet<String>

tool_calls: i32

commits: Vec<String>

est_cost_usd: Option<f64>

Implementations

impl SessionState

pub fn new(agent: &str, _model: Option<&str>) -> Self

Create a new session state.

impl SessionState

pub fn apply_event(&mut self, event: SessionEvent) -> bool

Apply a state machine event. Returns true if the transition was valid.

pub fn touch_file(&mut self, path: &str)

Add a file to the touched set. Absolute paths are relativized to the project root.

pub fn add_tokens(&mut self, tokens: &TokenUsage)

Add token usage from a tool call or response.

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<'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.