Struct ModelClient 

pub struct ModelClient { /* private fields */ }

A session-scoped client for model-provider API calls.

This holds configuration and state that should be shared across turns within a Codex session (auth, provider selection, thread id, and transport fallback state).

WebSocket fallback is session-scoped: once a turn activates the HTTP fallback, subsequent turns will also use HTTP for the remainder of the session.

Turn-scoped settings (model selection, reasoning controls, telemetry context, and turn metadata) are passed explicitly to the relevant methods to keep turn lifetime visible at the call site.

Implementations

impl ModelClient

pub fn new( auth_manager: Option<Arc<AuthManager>>, agent_identity_policy: AgentIdentityAuthPolicy, thread_id: ThreadId, provider_info: ModelProviderInfo, session_source: SessionSource, originator: String, model_verbosity: Option<VerbosityConfig>, enable_request_compression: bool, include_timing_metrics: bool, beta_features_header: Option<String>, concurrent_reasoning_summaries_enabled: bool, attestation_provider: Option<Arc<dyn AttestationProvider>>, http_client_factory: HttpClientFactory, ) -> Self

Creates a new session-scoped ModelClient.

All arguments are expected to be stable for the lifetime of a Codex session. Per-turn values are passed to ModelClientSession::stream (and other turn-scoped methods) explicitly. The HTTP client factory must come from the effective session configuration so every transport observes the resolved outbound proxy policy.

pub fn new_session(&self) -> ModelClientSession

Creates a fresh turn-scoped streaming session.

This constructor does not perform network I/O itself; the session opens a websocket lazily when the first stream request is issued.

pub async fn summarize_memories( &self, raw_memories: Vec<ApiRawMemory>, model_info: &ModelInfo, effort: Option<ReasoningEffortConfig>, session_telemetry: &SessionTelemetry, ) -> Result<Vec<ApiMemorySummarizeOutput>>

Builds memory summaries for each provided normalized raw memory.

This is a unary call (no streaming) to /v1/memories/trace_summarize.

The model selection, reasoning effort, and telemetry context are passed explicitly to keep ModelClient session-scoped.

pub fn responses_websocket_enabled(&self) -> bool

Returns whether the Responses-over-WebSocket transport is active for this session.

WebSocket use is controlled by provider capability and session-scoped fallback state.

Trait Implementations

impl Clone for ModelClient

fn clone(&self) -> ModelClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelClient

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

Formats the value using the given formatter.