Struct Session 

pub struct Session {
    pub name: String,
    pub session_id: String,
    pub cwd: String,
    pub backend: String,
    pub jsonl_path: PathBuf,
    pub permission_mode: Option<String>,
    pub backend_version: Option<String>,
    pub created: u64,
}

Persisted identity of one driven session.

Fields

name: String

tmux session name (also the sidecar filename stem).

session_id: String

Pinned --session-id UUID; makes the transcript path deterministic.

cwd: String

Working directory the agent was spawned in.

backend: String

Backend that drives this session (claude, later codex).

jsonl_path: PathBuf

Path to the session transcript JSONL.

permission_mode: Option<String>

--permission-mode the session was spawned with, if any.

backend_version: Option<String>

Backend CLI version probed at spawn (the binary is pinned for the session’s lifetime, so state/ps can check marker drift without a per-poll subprocess). None when the probe failed or the sidecar predates this field.

created: u64

Unix epoch seconds at spawn — used to correlate plan files (which live in a global dir).

Implementations

impl Session

pub fn sidecar_path(name: &str) -> Result<PathBuf>

Where this session’s sidecar lives on disk. Validates name first so a hostile value (path separators, ..) can never escape the sessions directory on save/load/delete.

pub fn save(&self) -> Result<()>

Write the sidecar (creating the state dir if needed).

pub fn load(name: &str) -> Result<Session>

Load a sidecar by session name.

pub fn delete(name: &str) -> Result<()>

Remove the sidecar (best-effort; missing file is not an error).

pub fn list() -> Result<Vec<Session>>

All tracked sessions, sorted by name. Sidecars that fail to parse are skipped.

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.