Struct FetchOptions 

pub struct FetchOptions {
    pub force_refresh: bool,
    pub ssrf_level: SsrfLevel,
    pub ssrf_project_root: Option<PathBuf>,
    pub har_recorder: Option<Arc<HarRecorder>>,
    pub ignore_robots: bool,
    pub user_agent: String,
    pub headless_mode: HeadlessMode,
    pub synchronous_revalidation: bool,
}

Fields

force_refresh: bool

ssrf_level: SsrfLevel

ssrf_project_root: Option<PathBuf>

Required (some) when ssrf_level == Project. Must be pre-canonicalized.

har_recorder: Option<Arc<HarRecorder>>

Optional HAR recorder. When Some, every round-trip is recorded.

ignore_robots: bool

When true, skip the robots gate. Used by --ignore-robots.

user_agent: String

User-Agent used for robots.txt UA-rule evaluation. Must match [fetch] user_agent.

headless_mode: HeadlessMode

M9: per-call mode selection.

synchronous_revalidation: bool

When true, the caller opts out of the stale-while-revalidate fast-path: on an expired cache entry, fetch_with_cache performs the network refresh inline rather than serving stale and queueing a background revalidate task.

Set this from any caller that does NOT have a running task scheduler in the same process — chiefly the one-shot CLI. The MCP server’s tools leave this false so the agent gets a fast response and the in-process scheduler refreshes the row.

Independently of this flag, the row is also re-fetched synchronously when the row expired more than [cache] stale_while_revalidate_window ago, so callers never receive arbitrarily old content.

Trait Implementations

impl Clone for FetchOptions

fn clone(&self) -> FetchOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FetchOptions

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

Formats the value using the given formatter.