Struct Session 

pub struct Session { /* private fields */ }

Unique opaque provider-native interactive session supplied for OpenAI models.

This example requires valid credentials and a live model with native session support. Sessions are unique, mutable, and non-Clone. Consuming close settles the session transport; the Provider retains separate shared shutdown authority. Ordinary multi-turn generation instead uses messages and continuation.

Examples

use providers_kit::{Provider, ProviderBackend, ProviderConfig, config::{ApiKey, OpenAiConfig, ProviderKind, TransportConfig}};
let provider = Provider::from_config(ProviderConfig::new(ProviderKind::OpenAi(OpenAiConfig::new(ApiKey::new("replace-with-your-key")?)), TransportConfig::default()))?;
use providers_kit::{ModelBackend, ModelId, SessionBackend, session::{SessionConfig, SessionInput}};
let model = provider.model(ModelId::new("your-exact-session-model-id")?)?;
let observed = async {
    let mut session = model.open_session(SessionConfig::default()).await?;
    assert!(!session.id().is_empty());
    assert_eq!(session.model_id(), model.model_id());
    let closed = session.close().await;
    closed
}.await;
let cleanup = provider.shutdown().await;
observed?;
cleanup?;

Trait Implementations

impl Debug for Session

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl SessionBackend for Session

fn id(&self) -> &str

Stable session identifier.

fn model_id(&self) -> &ModelId

Exact selected model.

async fn send(&mut self, input: SessionInput) -> Result<(), KitError>

Sends interactive input.

async fn recv(&mut self) -> Result<SessionEvent, KitError>

Receives the next interactive event.

async fn close(self) -> Result<(), KitError>

Closes the unique session and its transport.