Struct AiClient 

pub struct AiClient { /* private fields */ }

Typed AI client. Construct via AiClient::new.

Implementations

impl AiClient

pub fn new(config: Config) -> Result<Self, AiError>

Build a client. Validates config.base_url, builds the underlying HTTP client, and stamps the appropriate backend (Anthropic-direct or genai).

Errors

AiError::InvalidConfig on a bad base URL, an empty API key, or a reqwest::Client build failure.

pub async fn chat(&self, req: ChatRequest) -> Result<ChatResponse, AiError>

One-shot chat completion.

Errors

Any AiError variant — provider errors (4xx / 5xx), HTTP transport failures, rate-limit responses.

pub async fn chat_stream(&self, req: ChatRequest) -> Result<ChatStream, AiError>

Streaming chat completion.

Errors

Connection-time errors surface synchronously; per-event errors surface as ChatStreamEvent::Error inside the returned stream.

pub async fn chat_structured<T>(&self, req: ChatRequest) -> Result<T, AiError>

where T: DeserializeOwned + JsonSchema,

Structured output: validates the response against T’s JsonSchema before deserialising.

The request is augmented to instruct the model to emit JSON matching the schema — see ChatRequest::system; the caller’s system prompt (if any) is prepended.

Errors

AiError::SchemaValidation when the response doesn’t match the schema; AiError::Deserialize when it matches the schema but serde::Deserialize for T rejects it; any underlying AiError from the chat call.

Trait Implementations

impl Debug for AiClient

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

Formats the value using the given formatter.