Struct Session 

pub struct Session {

    pub session_id: String,
    pub task_id: String,
    pub grite_issue_id: String,
    pub role: SessionRole,
    pub session_type: SessionType,
    pub engine: String,
    pub worktree: String,
    pub pid: Option<u32>,
    pub status: SessionStatus,
    pub started_ts: i64,
    pub last_heartbeat_ts: Option<i64>,
    pub exit_code: Option<i32>,
    pub exit_reason: Option<String>,
    pub last_output_ref: Option<String>,
}

A parsed session from a task issue comment.

Sessions are stored as comments on task issues, not as separate issues. This struct represents the parsed session state from a [session]...[/session] block.

Fields

session_id: String

Brat session ID (e.g., “s-20250117-7b3d”).

task_id: String

Associated task ID.

grite_issue_id: String

Grit issue ID of the parent task.

role: SessionRole

Role executing the session.

session_type: SessionType

Session type (polecat/crew).

engine: String

Engine name (e.g., “codex”, “claude”, “shell”).

worktree: String

Path to worktree (for polecat sessions).

pid: Option<u32>

Process ID (if running).

status: SessionStatus

Session status.

started_ts: i64

Timestamp when session started (millis since epoch).

last_heartbeat_ts: Option<i64>

Last heartbeat timestamp (millis since epoch).

exit_code: Option<i32>

Exit code (if exited).

exit_reason: Option<String>

Exit reason (signal, timeout, crash, user-stop, completed).

last_output_ref: Option<String>

Reference to last output (sha256:).

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.