Struct DefaultSession 

pub struct DefaultSession { /* private fields */ }

Trait Implementations

impl Drop for DefaultSession

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Session for DefaultSession

fn id(&self) -> &SessionId

fn provider_info(&self) -> ProviderInfo

Provider metadata used by the current session.

fn current_model(&self) -> String

The model ID used by the current session.

fn list_models(&self) -> BoxFuture<'_, Result<Vec<ModelInfo>, ProviderError>>

List the model candidates available from the current provider for this session.

fn list_candidates( &self, ) -> BoxFuture<'_, Result<Vec<ModelCandidate>, ProviderError>>

List the (provider, model) candidate pairs visible to the session. Under a multi-provider setup, the same session may switch models across providers, so ACP rendering needs to annotate each candidate with its provider.

fn set_model( &self, selection: ModelSelection, ) -> BoxFuture<'_, Result<(), ProviderError>>

Switches the model for the current session.

fn current_mode(&self) -> Option<String>

The current active permission mode ID. Returns None if no mode catalog is loaded.

fn available_modes(&self) -> Vec<ModeDescriptor>

The list of permission modes available to this session, in assembly order. Returns an empty list when no mode directory is mounted. Maps to ACP SessionModeState::available_modes.

fn set_mode(&self, mode_id: String) -> Result<(), AgentError>

Switch the current permission mode. The change takes effect on subsequent turns; the in-flight turn retains its original policy (same semantics as Self::set_model — the policy is snapshotted when run_turn starts).

fn current_reasoning_effort(&self) -> Option<ReasoningEffort>

The current reasoning_effort level (None = unset, falling back to the provider default). Maps to the current value of the ACP thought-level configuration item.

fn set_reasoning_effort(&self, effort: Option<ReasoningEffort>)

Sets the reasoning_effort level. None clears the override (falls back to the provider default). Takes effect on subsequent turns. Providers that do not support this concept ignore it when assembling requests.

fn subscribe(&self) -> EventStream

Subscribe to the event stream. Three independent consumers (acp / storage / tracing) each call this once without interfering with each other — internally uses mpsc with fan-out so that slow consumers only experience backpressure without dropping events.

fn history_snapshot(&self) -> Vec<Message>

A read-only snapshot of the current history, used to replay the transcript to the client after a session load.

fn run_turn( &self, prompt: Vec<ContentBlock>, ) -> BoxFuture<'_, Result<StopReason, TurnError>>

Starts a turn.

fn cancel_turn(&self)

Cancels the current turn. Idempotent: no-op if no turn is in progress.

fn resolve_permission(&self, id: ToolCallId, outcome: PermissionResolution)

Writes back the client response to the ACP reverse request session/request_permission to the main loop.