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-flash-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 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 circuit_breaker(&self) -> Option<&CircuitBreaker>

Returns the circuit breaker for this provider (optional).

fn build_headers(&self) -> HeaderMap

Builds HTTP headers for API requests.

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)>> + Send + 'async_trait>>

where T: 'async_trait + DeserializeOwned, 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 review_pr<'life0, 'life1, 'async_trait>( &'life0 self, pr: &'life1 PrDetails, ) -> Pin<Box<dyn Future<Output = Result<(PrReviewResponse, AiStats)>> + 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(pr: &PrDetails) -> 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.

fn generate_release_notes<'life0, 'life1, 'async_trait>( &'life0 self, prs: Vec<PrSummary>, version: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(ReleaseNotesResponse, AiStats)>> + Send + 'async_trait>>

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

Generate release notes from PR summaries.

fn build_release_notes_prompt(prs: &[PrSummary], version: &str) -> String

Build the user prompt for release notes generation.

impl Debug for AiClient

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

Formats the value using the given formatter.