use serde::{Deserialize, Serialize};
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "snake_case")]
pub enum SearchProvider {
Bing,
#[serde(alias = "duckduckgo")]
DuckDuckGo,
#[default]
Firecrawl,
Tavily,
Bocha,
#[serde(alias = "metaso")]
Metaso,
#[serde(alias = "searx", alias = "searx-ng", alias = "searx_ng")]
Searxng,
#[serde(
alias = "baidu-search",
alias = "baidu_ai_search",
alias = "baidu_search",
alias = "baidu-ai-search"
)]
Baidu,
#[serde(
alias = "volcengine",
alias = "ark",
alias = "volc",
alias = "volcengine-ark",
alias = "volcengine_ark",
alias = "volc-ark"
)]
Volcengine,
Sofya,
Serply,
#[serde(rename = "deepseek", alias = "deep-seek", alias = "deepseek-search")]
DeepSeek,
#[serde(rename = "searchapi", alias = "search-api", alias = "search_api")]
SearchApi,
}
impl SearchProvider {
#[must_use]
pub fn parse(value: &str) -> Option<Self> {
match value.trim().to_ascii_lowercase().as_str() {
"bing" => Some(Self::Bing),
"duckduckgo" | "duck-duck-go" | "duck_duck_go" | "ddg" => Some(Self::DuckDuckGo),
"firecrawl" | "fire-crawl" | "fire_crawl" => Some(Self::Firecrawl),
"tavily" => Some(Self::Tavily),
"bocha" => Some(Self::Bocha),
"metaso" => Some(Self::Metaso),
"searxng" | "searx" | "searx-ng" | "searx_ng" => Some(Self::Searxng),
"baidu" | "baidu-search" | "baidu_search" | "baidu-ai-search" | "baidu_ai_search" => {
Some(Self::Baidu)
}
"volcengine" | "ark" | "volc" | "volcengine-ark" => Some(Self::Volcengine),
"sofya" => Some(Self::Sofya),
"serply" => Some(Self::Serply),
"deepseek" | "deep-seek" | "deepseek-search" => Some(Self::DeepSeek),
"searchapi" | "search-api" | "search_api" => Some(Self::SearchApi),
_ => None,
}
}
#[must_use]
pub fn as_str(self) -> &'static str {
match self {
Self::Bing => "bing",
Self::DuckDuckGo => "duckduckgo",
Self::Firecrawl => "firecrawl",
Self::Tavily => "tavily",
Self::Bocha => "bocha",
Self::Metaso => "metaso",
Self::Searxng => "searxng",
Self::Baidu => "baidu",
Self::Volcengine => "volcengine",
Self::Sofya => "sofya",
Self::Serply => "serply",
Self::DeepSeek => "deepseek",
Self::SearchApi => "searchapi",
}
}
#[must_use]
pub fn names_hint() -> &'static str {
"bing, duckduckgo, firecrawl, tavily, bocha, metaso, searxng, baidu, volcengine, sofya, serply, deepseek, searchapi"
}
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum SearchProviderSource {
Default,
Config,
EnvOverride,
TavilyKey,
}
impl SearchProviderSource {
#[must_use]
pub fn as_str(self) -> &'static str {
match self {
Self::Default => "default",
Self::Config => "config",
Self::EnvOverride => "env override",
Self::TavilyKey => "tavily key",
}
}
}
#[must_use]
pub fn looks_like_tavily_key(value: &str) -> bool {
value.trim().starts_with("tvly-")
}
#[must_use]
pub fn tavily_env_key() -> Option<String> {
std::env::var("TAVILY_API_KEY")
.ok()
.map(|value| value.trim().to_string())
.filter(|value| !value.is_empty())
}
#[must_use]
pub fn tavily_key_from(search_api_key: Option<&str>) -> Option<String> {
if let Some(env_key) = tavily_env_key() {
return Some(env_key);
}
search_api_key
.map(str::trim)
.filter(|value| !value.is_empty() && looks_like_tavily_key(value))
.map(str::to_string)
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct SearchProviderResolution {
pub provider: SearchProvider,
pub source: SearchProviderSource,
}
#[derive(Debug, Clone, Deserialize, Default)]
pub struct SearchConfig {
#[serde(default)]
pub provider: Option<SearchProvider>,
#[serde(default)]
pub base_url: Option<String>,
#[serde(default)]
pub api_key: Option<String>,
#[serde(default)]
pub native: Option<bool>,
}