Enum SearchProvider 

pub enum SearchProvider {
    Brave,
    Tavily,
    SerpApi,
    Firecrawl,
}

A web-search backend the gateway’s search tool can use instead of scraping DuckDuckGo’s keyless HTML endpoint.

Variants

Brave

Brave Search API — the default and the only one that predates this enum. Free tier covers a personal deep-research user.

Tavily

Tavily — search API built for LLM agents.

SerpApi

SerpApi — Google results via a scraping API.

Firecrawl

Firecrawl — search + page extraction.

Implementations

impl SearchProvider

pub fn all() -> [SearchProvider; 4]

Every provider, in preference order.

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

Lowercase identifier used in the CLI flag (--brave), the keychain account, and the config key prefix. One slug drives all three so they cannot drift apart.

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

How the provider writes its own name, for anything a human reads.

pub fn config_key_ref(self) -> String

research_gateway.<this> — the config.yaml key holding a SecretRef string rather than the secret itself.

pub fn config_key_plain(self) -> String

research_gateway.<this> — the legacy plaintext key. Still read (an existing brave_api_key must keep working) but never written by mur deep-research secret.

pub fn env_var(self) -> String

Environment override, highest precedence of all.

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

Keychain account this provider’s key is stored under.

pub fn keychain_ref(self) -> String

The SecretRef string written into config.yaml — the reference is safe to commit and log; the key itself never enters the file.

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

Where a user gets a key. Printed by the setup command, because “get an API key” without a URL is a scavenger hunt.

Trait Implementations

impl Clone for SearchProvider

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for SearchProvider

impl Debug for SearchProvider

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

Formats the value using the given formatter.

impl Display for SearchProvider

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

Formats the value using the given formatter.

impl Eq for SearchProvider

impl FromStr for SearchProvider

fn from_str(s: &str) -> Result<Self, Self::Err>

Accepts the slug in any case, plus the spellings a user is likely to type by hand (serp-api, serp_api) — a rejected name here costs a round trip for no safety gain.

type Err = String

The associated error which can be returned from parsing.

impl Hash for SearchProvider

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for SearchProvider

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for SearchProvider

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for SearchProvider

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for SearchProvider