Struct Session 

#[non_exhaustive]
pub struct Session {

    pub id: String,
    pub kind: String,
    pub status: SessionStatus,
    pub agent: Option<SessionAgent>,
    pub environment_id: Option<String>,
    pub vault_ids: Vec<String>,
    pub title: Option<String>,
    pub metadata: HashMap<String, String>,
    pub usage: Option<SessionUsage>,
    pub stats: Option<SessionStats>,
    pub resources: Vec<SessionResource>,
    pub outcome_evaluations: Vec<Value>,
    pub created_at: Option<String>,
    pub updated_at: Option<String>,
    pub archived_at: Option<String>,
}

Available on crate feature managed-agents-preview only.

A Managed Agents session.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: String

Stable session identifier (sesn_...).

kind: String

Wire type; always "session".

status: SessionStatus

Lifecycle status.

agent: Option<SessionAgent>

Resolved snapshot of the agent at session-creation time. Pinned even if the underlying agent is later updated.

environment_id: Option<String>

ID of the environment this session runs in.

vault_ids: Vec<String>

Vault references for MCP credential resolution.

title: Option<String>

Optional human-readable title.

metadata: HashMap<String, String>

Free-form key-value metadata attached at create time.

usage: Option<SessionUsage>

Cumulative token usage. May be absent on freshly-created sessions.

stats: Option<SessionStats>

Wall-clock and active-runtime stats.

resources: Vec<SessionResource>

Mounted resources: file uploads, GitHub repositories, memory stores. Each carries a server-assigned id (sesrsc_...) used for Resources::update and Resources::delete.

outcome_evaluations: Vec<Value>

Outcome evaluations recorded against this session, when an outcome was defined. Research-preview: this field is populated only when the session uses the outcomes feature (user.define_outcome events, requires managed-agents-2026-04-01-research-preview beta header). Preserved as Vec<Value> until the outcomes types land.

created_at: Option<String>

Timestamp when the session was created (RFC3339 / ISO 8601).

updated_at: Option<String>

Timestamp of the most recent update.

archived_at: Option<String>

Set when the session has been archived.

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.