Struct SessionsClient 

pub struct SessionsClient { /* private fields */ }

Client for session operations.

Sessions enable multi-turn conversations with persistent history stored on the server.

Implementations

impl SessionsClient

pub async fn create( &self, req: SessionCreateRequest, ) -> Result<SessionResponse, Error>

Create a new session.

Sessions are project-scoped and can optionally be associated with a customer.

Example

let session = client.sessions().create(SessionCreateRequest {
    customer_id: Some(uuid::Uuid::parse_str("...")?),
    metadata: Some(serde_json::json!({"project": "my-app"})),
}).await?;
println!("Created session: {}", session.id);

pub async fn list( &self, opts: ListSessionsOptions, ) -> Result<SessionListResponse, Error>

List sessions with pagination.

Example

let resp = client.sessions().list(ListSessionsOptions {
    limit: Some(10),
    ..Default::default()
}).await?;

for session in resp.sessions {
    println!("Session {}: {} messages", session.id, session.message_count);
}

// Fetch next page using cursor
if let Some(cursor) = resp.next_cursor {
    let next_page = client.sessions().list(ListSessionsOptions {
        cursor: Some(cursor),
        ..Default::default()
    }).await?;
}

pub async fn get( &self, session_id: &str, ) -> Result<SessionWithMessagesResponse, Error>

Get a session by ID, including its full message history.

Example

let session = client.sessions().get("session-uuid").await?;
for msg in session.messages {
    println!("[{}] {:?}", msg.role, msg.content);
}

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

Delete a session.

Requires a secret key.

Example

client.sessions().delete("session-uuid").await?;

pub async fn add_message( &self, session_id: &str, req: SessionMessageCreateRequest, ) -> Result<SessionMessageResponse, Error>

Add a message to a session.

Messages can be user, assistant, or tool messages. Assistant messages can optionally include a run_id to link them to a workflow run.

Example

let msg = client.sessions().add_message("session-uuid", SessionMessageCreateRequest {
    role: "user".into(),
    content: vec![serde_json::json!({"type": "text", "text": "Hello!"})],
    run_id: None,
}).await?;
println!("Added message: {}", msg.id);

Trait Implementations

impl Clone for SessionsClient

fn clone(&self) -> SessionsClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.