Struct AiClient 

pub struct AiClient { /* private fields */ }

Generic AI client for all providers.

Holds HTTP client, API key, and model configuration for reuse across multiple requests. Uses the provider registry to get provider-specific configuration.

Implementations

impl AiClient

pub fn new(provider_name: &str, config: &AiConfig) -> Result<Self>

Creates a new AI client from configuration.

Validates the model against cost control settings and fetches the API key from the environment.

Arguments

• provider_name - Name of the provider (e.g., “openrouter”, “gemini”)
• config - AI configuration with model, timeout, and cost control settings

Errors

Returns an error if:

• Provider is not found in registry
• Model is not in free tier and allow_paid_models is false (for OpenRouter)
• API key environment variable is not set
• HTTP client creation fails

pub fn with_api_key( provider_name: &str, api_key: SecretString, model_name: &str, config: &AiConfig, ) -> Result<Self>

Creates a new AI client with a provided API key and validates the model exists.

This constructor validates that the model exists via the runtime model registry before creating the client. It allows callers to provide an API key directly, enabling multi-platform credential resolution (e.g., from iOS keychain via FFI).

Arguments

• provider_name - Name of the provider (e.g., “openrouter”, “gemini”)
• api_key - API key as a SecretString
• model_name - Model name to use (e.g., “gemini-3.1-flash-lite-preview”)
• config - AI configuration with timeout and cost control settings

Errors

Returns an error if:

• Provider is not found in registry
• Model is not in free tier and allow_paid_models is false (for OpenRouter)
• HTTP client creation fails

pub fn from_claude_credentials(config: &AiConfig) -> Result<Option<Self>>

Creates a new AI client from Claude credentials file (~/.claude/credentials.json).

Reads the credentials file, extracts the access token, stores it in the OS keyring, and returns an AiClient configured for the Anthropic provider.

Arguments

• config - AI configuration with timeout and cost control settings

Returns

Returns Ok(Some(AiClient)) if credentials are found and valid, Ok(None) if the credentials file is missing or invalid, or an error if keyring operations fail.

pub fn claude_credentials_path() -> Option<PathBuf>

Returns the path to the Claude credentials file if it exists.

This helper centralizes the path resolution logic for ~/.claude/credentials.json, keeping the CLI command layer thin and avoiding duplicate path construction.

Returns Some(path) if the file exists, None otherwise.

pub fn from_keyring_oauth(config: &AiConfig) -> Result<Option<Self>>

Attempts to retrieve a Claude OAuth token from the OS keyring.

Returns Ok(Some(AiClient)) if a token is found in the keyring, Ok(None) if no token is stored, or an error if keyring operations fail.

pub fn auth_method(&self) -> AuthMethod

Returns the authentication method used by this client.

pub fn circuit_breaker(&self) -> &CircuitBreaker

Get the circuit breaker for this client.

Trait Implementations

impl AiProvider for AiClient

fn name(&self) -> &str

Returns the name of the provider (e.g., “gemini”, “openrouter”).

fn api_url(&self) -> &str

Returns the API URL for this provider.

fn api_key_env(&self) -> &str

Returns the environment variable name for the API key.

fn http_client(&self) -> &Client

Returns the HTTP client for making requests.

fn api_key(&self) -> &SecretString

Returns the API key for authentication.

fn model(&self) -> &str

Returns the model name.

fn max_tokens(&self) -> u32

Returns the maximum tokens for API responses.

fn temperature(&self) -> f32

Returns the temperature for API requests.

fn max_attempts(&self) -> u32

Returns the maximum retry attempts for rate-limited requests.

fn circuit_breaker(&self) -> Option<&CircuitBreaker>

Returns the circuit breaker for this provider (optional).

fn custom_guidance(&self) -> Option<&str>

Returns the custom guidance string for system prompt injection, if set.

fn build_headers(&self) -> HeaderMap

Builds HTTP headers for API requests.

fn is_anthropic(&self) -> bool

Returns whether this provider is Anthropic-compatible and supports cache_control on message blocks.

fn validate_model(&self) -> Result<()>

Validates the model configuration.

fn send_request_inner<'life0, 'life1, 'async_trait>( &'life0 self, request: &'life1 ChatCompletionRequest, ) -> Pin<Box<dyn Future<Output = Result<ChatCompletionResponse>> + Send + 'async_trait>>

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

Sends a chat completion request to the provider’s API (HTTP-only, no retry).

fn send_and_parse<'life0, 'life1, 'async_trait, T>( &'life0 self, request: &'life1 ChatCompletionRequest, ) -> Pin<Box<dyn Future<Output = Result<(T, AiStats, Vec<String>)>> + Send + 'async_trait>>

where T: 'async_trait + DeserializeOwned + Send, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Sends a chat completion request and parses the response with retry logic.

fn analyze_issue<'life0, 'life1, 'async_trait>( &'life0 self, issue: &'life1 IssueDetails, ) -> Pin<Box<dyn Future<Output = Result<AiResponse>> + Send + 'async_trait>>

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

Analyzes a GitHub issue using the provider’s API.

fn create_issue<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, title: &'life1 str, body: &'life2 str, repo: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<(CreateIssueResponse, AiStats)>> + Send + 'async_trait>>

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

Creates a formatted GitHub issue using the provider’s API.

fn build_system_prompt(custom_guidance: Option<&str>) -> String

Builds the system prompt for issue triage.

fn build_user_prompt(issue: &IssueDetails) -> String

Builds the user prompt containing the issue details.

fn build_create_system_prompt(custom_guidance: Option<&str>) -> String

Builds the system prompt for issue creation/formatting.

fn build_create_user_prompt(title: &str, body: &str, _repo: &str) -> String

Builds the user prompt for issue creation/formatting.

fn estimate_pr_size( pr: &PrDetails, ast_context: &str, call_graph: &str, ) -> usize

Estimates the initial size of a PR review prompt in characters.

fn review_pr<'life0, 'life1, 'async_trait>( &'life0 self, ctx: ReviewContext, review_config: &'life1 ReviewConfig, ) -> Pin<Box<dyn Future<Output = Result<(PrReviewResponse, AiStats, Vec<String>)>> + Send + 'async_trait>>

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

Reviews a pull request using the provider’s API.

fn suggest_pr_labels<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, title: &'life1 str, body: &'life2 str, file_paths: &'life3 [String], ) -> Pin<Box<dyn Future<Output = Result<(Vec<String>, AiStats)>> + Send + 'async_trait>>

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

Suggests labels for a pull request using the provider’s API.

fn build_pr_review_system_prompt(custom_guidance: Option<&str>) -> String

Builds the system prompt for PR review.

fn build_pr_review_user_prompt(ctx: &mut ReviewContext) -> String

Builds the user prompt for PR review.

fn build_pr_label_system_prompt(custom_guidance: Option<&str>) -> String

Builds the system prompt for PR label suggestion.

fn build_pr_label_user_prompt( title: &str, body: &str, file_paths: &[String], ) -> String

Builds the user prompt for PR label suggestion.

impl Debug for AiClient

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

Formats the value using the given formatter.

impl Drop for AiClient

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.