Struct AnthropicClient 

pub struct AnthropicClient { /* private fields */ }

Client for the Anthropic Messages API.

Prompt caching is on by default: the client marks the tool list, the system prompt, and the newest message as cache breakpoints, so each loop step and each scheduled run re-reads the stable prefix from the cache.

Implementations

impl AnthropicClient

pub const API_VERSION: &'static str = "2023-06-01"

Anthropic API version header sent with every request.

pub fn new( base_url: impl Into<String>, model: impl Into<String>, api_key: impl Into<String>, ) -> Result<Self, AgentError>

Build a client. The key never leaves this struct except as a header.

Errors

Returns AgentError when the underlying HTTP client cannot be built.

pub fn with_timeout(self, timeout: Duration) -> Result<Self, AgentError>

Replace the request timeout.

Errors

Returns AgentError when the underlying HTTP client cannot be rebuilt.

pub const fn with_prompt_caching(self, enabled: bool) -> Self

Turn the cache_control breakpoints on or off.

pub fn messages_url(&self) -> String

Messages endpoint URL.

Trait Implementations

impl Debug for AnthropicClient

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

Formats the value using the given formatter.

impl LlmClient for AnthropicClient

fn chat<'a>( &'a self, request: &'a ChatRequest, ) -> Pin<Box<dyn Future<Output = Result<ChatResponse, AgentError>> + Send + 'a>>

Send one chat request and decode the response.

fn list_models( &self, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>, AgentError>> + Send + '_>>

List available model ids. Cheap and read-only: the health check uses it.

fn provider_name(&self) -> &'static str

Human-readable provider name for logs and health details.