Struct SessionState 

pub struct SessionState {

    pub name: String,
    pub backend_type: String,
    pub prompt: String,
    pub model: Option<String>,
    pub cwd: Option<PathBuf>,
    pub max_turns: Option<i32>,
    pub allowed_tools: Vec<String>,
    pub permission_mode: Option<String>,
    pub reasoning_effort: Option<String>,
    pub env: HashMap<String, String>,
    pub memory_config: Option<MemoryConfig>,
    pub metadata: HashMap<String, String>,
    pub created_at: DateTime<Utc>,
}

Persisted state for a single agent session.

Stored at ~/.claude/teams/{team}/sessions/{agent}.json and used to re-spawn agents with the same configuration after an orchestrator restart.

Fields

name: String

Agent name.

backend_type: String

Backend type string (e.g. “claude-code”, “codex”, “gemini-cli”).

prompt: String

The prompt / system instruction.

model: Option<String>

Model override (if any).

cwd: Option<PathBuf>

Working directory.

max_turns: Option<i32>

Max turns.

allowed_tools: Vec<String>

Allowed tools.

permission_mode: Option<String>

Permission mode.

reasoning_effort: Option<String>

Reasoning effort.

env: HashMap<String, String>

Extra environment variables.

memory_config: Option<MemoryConfig>

Memory configuration for cross-turn context injection.

metadata: HashMap<String, String>

Backend-specific metadata (e.g. Codex thread ID for informational purposes).

created_at: DateTime<Utc>

Timestamp when the session was created.

Implementations

impl SessionState

pub fn from_config(config: &SpawnConfig, backend_type: &BackendType) -> Self

Create a new session state from a spawn config and backend type.

pub fn to_spawn_config(&self) -> SpawnConfig

Convert back to a SpawnConfig for re-spawning.

pub fn parse_backend_type(&self) -> Option<BackendType>

Parse the backend type string back to a BackendType enum.

Uses BackendType::from_str() so this stays in sync with Display.

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.