Struct Sessions 

pub struct Sessions<'a> { /* private fields */ }

Available on crate feature managed-agents-preview only.

Namespace handle for the Sessions API.

Obtained via Client::managed_agents.

Implementations

impl<'a> Sessions<'a>

pub async fn create(&self, request: CreateSessionRequest) -> Result<Session>

Create a session. Returns the freshly-provisioned Session.

pub async fn retrieve(&self, session_id: &str) -> Result<Session>

Fetch a session by ID.

pub async fn list( &self, params: ListSessionsParams, ) -> Result<Paginated<Session>>

List sessions, paginated.

pub async fn update( &self, session_id: &str, request: UpdateSessionRequest, ) -> Result<Session>

Update a session. All fields on UpdateSessionRequest are optional with merge-patch semantics: omit a field to preserve its current value.

pub async fn archive(&self, session_id: &str) -> Result<Session>

Archive a session. Archived sessions cannot accept new events but preserve their event history.

pub fn events(&self, session_id: impl Into<String>) -> Events<'_>

Sub-namespace for the session-events API (/v1/sessions/{id}/events and the SSE stream).

pub fn resources(&self, session_id: impl Into<String>) -> Resources<'_>

Sub-namespace for resource operations on a session (/v1/sessions/{id}/resources).

pub fn threads(&self, session_id: impl Into<String>) -> Threads<'_>

Sub-namespace for thread operations on a multi-agent session (/v1/sessions/{id}/threads). Sub-agent threads are spawned at runtime when the coordinator delegates to a callable_agent.

pub async fn delete(&self, session_id: &str) -> Result<()>

Delete a session permanently. The session must not be running; send a user.interrupt event first if necessary. Files, memory stores, environments, and agents are independent and not affected.