Struct ServerConfig 

pub struct ServerConfig {

    pub max_download_mb: u32,
    pub max_result_length: usize,
    pub search_timeout: u64,
    pub oversampling_factor: u32,
    pub auto_recovery_fetch: bool,
    pub max_total_results: usize,
    pub max_query_budget: usize,
    pub max_search_queries: usize,
    pub results_per_query: usize,
    pub blocked_domains: Vec<String>,
    pub allowed_domains: Vec<String>,
    pub debug: bool,
    pub log_file: String,
    pub trace: bool,
    pub adaptive_budget: AdaptiveBudget,
    pub adaptive_budget_fetch_factor: u32,
    pub language: String,
}

Server-level settings and anti-flooding caps.

Fields

max_download_mb: u32

Streaming download cap per page in megabytes (default: 1).

max_result_length: usize

Hard character cap per cleaned page (default: 8000). Set to 0 to disable the cap entirely (no truncation).

search_timeout: u64

Per-request timeout in seconds for fetch and search calls (default: 8).

oversampling_factor: u32

Oversample multiplier: fetch results_per_query * factor candidates (default: 2).

auto_recovery_fetch: bool

When true, replace failed fetches with reserve-pool pages (default: false).

max_total_results: usize

Hard cap on total results returned per query call (default: 20).

max_query_budget: usize

Total character budget across all sources in a single query (default: 32000).

max_search_queries: usize

Maximum number of search queries per call, including LLM expansions (default: 5).

results_per_query: usize

Results requested per backend query (default: 5).

blocked_domains: Vec<String>

Domain blocklist — URLs matching these domains are silently dropped.

allowed_domains: Vec<String>

Domain allowlist — when non-empty, only these domains pass the filter.

debug: bool

Enable debug-level logging (default: false).

log_file: String

Path to a log file (empty = stderr only).

trace: bool

Enable trace-level logging (default: false).

adaptive_budget: AdaptiveBudget

Controls proportional budget allocation after BM25 reranking.

adaptive_budget_fetch_factor: u32

Fetch factor for adaptive budget: fetch up to max_result_length * factor chars before trimming proportionally (default: 3).

language: String

BCP-47 language tag passed to search backends (e.g. “en”, “it”, “all”). Empty string = let the backend decide.

Implementations

impl ServerConfig

pub fn max_download_bytes(&self) -> usize

Hard cap in bytes for streaming download.

Trait Implementations

impl Clone for ServerConfig

fn clone(&self) -> ServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerConfig

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

Formats the value using the given formatter.

impl Default for ServerConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ServerConfig

where ServerConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.