Enum SearchBackend 

#[non_exhaustive]
pub enum SearchBackend {
    Brave(BraveSearchProvider),
}

Concrete backend dispatch.

An enum (not Box<dyn ErasedSearchProvider>) keeps WebSearchExecutor non-generic and avoids erased-async-trait boilerplate for a small, closed backend set. New backends are new variants.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Brave(BraveSearchProvider)

Brave Search API (v1 default backend).

Implementations

impl SearchBackend

pub fn from_config( cfg: &SearchConfig, max_body_bytes: usize, api_key: Option<Secret>, ) -> Result<Self, SearchError>

Resolve a backend from config plus an optional pre-fetched API key.

max_body_bytes caps the response body size a provider will read (from [tools.scrape].max_body_bytes — the search tool has no independent body-size config, mirroring its denied_domains/ipi_filter_threshold inheritance).

Returns Err for a keyed backend (e.g. Brave) with no key. A future keyless backend (e.g. SearXNG) must be constructible with api_key: None — callers gate tool availability on this function’s success, not on “key present” (see FR-002).

Errors

Returns SearchError::MissingApiKey when the selected backend requires a key and none was supplied, or SearchError::Provider when cfg.endpoint is not a valid URL or cfg.backend names an unknown backend.

pub async fn search( &self, client: &Client, query: &str, limit: usize, ) -> Result<Vec<SearchResult>, SearchError>

See SearchProvider::search.

Errors

Returns SearchError on missing key, HTTP failure, timeout, or response parse failure.

pub fn endpoint(&self) -> &Url

See SearchProvider::endpoint.

pub fn name(&self) -> &'static str

See SearchProvider::name.

Trait Implementations

impl Debug for SearchBackend

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

Formats the value using the given formatter.