Struct OxideClient 

pub struct OxideClient { /* private fields */ }

LlmClient backed by openai-oxide (Responses API).

With oxide-ws feature: call connect_ws() to upgrade to WebSocket mode. All subsequent calls go over persistent wss:// connection (-20-25% latency).

Implementations

impl OxideClient

pub fn from_config(config: &LlmConfig) -> Result<Self, SgrError>

Create from LlmConfig.

pub fn set_response_id(&self, id: Option<&str>)

Set response_id externally (for stateful session coordination with coach).

pub fn response_id(&self) -> Option<String>

Get current response_id.

pub async fn tools_call_stateful( &self, messages: &[Message], tools: &[ToolDef], previous_response_id: Option<&str>, ) -> Result<(Vec<ToolCall>, Option<String>), SgrError>

Function calling with explicit previous_response_id. Returns tool calls + new response_id for chaining.

Always sets store(true) so responses can be referenced by subsequent calls. When previous_response_id is provided, only delta messages need to be sent (server has full history from previous stored response).

Tool messages (role=Tool with tool_call_id) are converted to Responses API function_call_output items — required for chaining with previous_response_id.

Trait Implementations

impl LlmClient for OxideClient

fn structured_call<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, messages: &'life1 [Message], schema: &'life2 Value, ) -> Pin<Box<dyn Future<Output = Result<(Option<Value>, Vec<ToolCall>, String), SgrError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Structured call: send messages with schema injected into system prompt. Returns (parsed_output, native_tool_calls, raw_text).

fn tools_call<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, messages: &'life1 [Message], tools: &'life2 [ToolDef], ) -> Pin<Box<dyn Future<Output = Result<Vec<ToolCall>, SgrError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Native function calling: send messages + tool defs, get tool calls.

fn complete<'life0, 'life1, 'async_trait>( &'life0 self, messages: &'life1 [Message], ) -> Pin<Box<dyn Future<Output = Result<String, SgrError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Plain text completion (no schema, no tools).