Struct InterstitialPolicy 

pub struct InterstitialPolicy {
    pub queue_interval: Duration,
    pub queue_max_retries: u32,
    pub challenge_solve_budget: Duration,
    pub hard_block_escalation: StrategyUsed,
    pub transient_follow_redirect: bool,
    pub max_transient_hops: u32,
    pub short_circuit_on_classified: bool,
}

Routing tunables for InterstitialRouter.

All fields have safe defaults that the production acquisition path uses unchanged. Callers can override any field via the with_* builders.

Example

use stygian_browser::interstitial_router::InterstitialPolicy;
use std::time::Duration;

let policy = InterstitialPolicy {
    queue_interval: Duration::from_secs(10),
    ..InterstitialPolicy::default()
};
assert_eq!(policy.queue_interval, Duration::from_secs(10));
assert!(policy.short_circuit_on_classified);

Fields

queue_interval: Duration

Wait interval between queue retries.

queue_max_retries: u32

Maximum retries for a queue page.

challenge_solve_budget: Duration

Challenge solve budget.

hard_block_escalation: StrategyUsed

Strategy to escalate to on a hard block.

transient_follow_redirect: bool

Whether to follow redirects on a transient page.

max_transient_hops: u32

Maximum redirect hops to follow on a transient page.

short_circuit_on_classified: bool

When true (default), a non-Transient classification short-circuits the runner with a structured StageFailureKind::InterstitialRouted failure so the calling layer can route via the dedicated strategy. When false, the decision is only attached to the result — the runner still executes the strategy ladder.

Implementations

impl InterstitialPolicy

pub const fn with_queue_interval(self, interval: Duration) -> Self

Build a policy with an explicit queue interval.

pub const fn with_queue_max_retries(self, max_retries: u32) -> Self

Build a policy with an explicit max retries value.

pub const fn with_challenge_solve_budget(self, budget: Duration) -> Self

Build a policy with an explicit challenge solve budget.

pub const fn with_hard_block_escalation(self, strategy: StrategyUsed) -> Self

Build a policy with an explicit hard-block escalation strategy.

pub const fn with_transient_follow_redirect(self, follow: bool) -> Self

Build a policy with an explicit follow-redirect flag.

pub const fn with_max_transient_hops(self, max_hops: u32) -> Self

Build a policy with an explicit max-hops value.

pub const fn with_short_circuit(self, short_circuit: bool) -> Self

Build a policy with an explicit short-circuit flag.

Trait Implementations

impl Clone for InterstitialPolicy

fn clone(&self) -> InterstitialPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InterstitialPolicy

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

Formats the value using the given formatter.

impl Default for InterstitialPolicy

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for InterstitialPolicy

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InterstitialPolicy

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.