Struct RetryPolicy 

pub struct RetryPolicy {
    pub max_retries: u32,
    pub base: Duration,
    pub max: Duration,
    pub jitter: bool,
}

Exponential-backoff retry policy.

delay(attempt) = min(max, base * 2^(attempt-1)), optionally spread with equal jitter (half fixed, half random) to avoid synchronized retries when several agents hammer the same hosted endpoint.

Fields

max_retries: u32

Number of retries after the first attempt. 0 disables retrying.

base: Duration

Base delay before the first retry.

max: Duration

Ceiling for any single backoff delay.

jitter: bool

Whether to apply equal jitter to each delay.

Implementations

impl RetryPolicy

pub fn from_env() -> Self

Build from environment variables, falling back to RetryPolicy::default.

Variables (all optional, unset/invalid values are silently ignored):

• NEWT_HTTP_MAX_RETRIES — retry count after the first attempt
• NEWT_HTTP_BACKOFF_BASE_MS — base delay in milliseconds
• NEWT_HTTP_BACKOFF_MAX_MS — ceiling delay in milliseconds
• NEWT_HTTP_JITTER — 0/false/off disables jitter

pub fn from_env_or(base: Self) -> Self

Like from_env but starts from base instead of Default. Use this when a caller has different default thresholds from the crate default but still wants the env vars to override them.

pub fn for_local_inference() -> Self

A policy tuned for slow, home-lab local inference endpoints (e.g. a DGX that can drop for 30–60 s under load). More patient than the default hosted-API policy:

• 6 retries (7 attempts total)
• 2 s base doubling to a 30 s ceiling, with jitter
• Total resilience window: ~90 s

Env-var overrides (NEWT_HTTP_MAX_RETRIES etc.) still apply.

pub fn immediate(max_retries: u32) -> Self

A zero-delay policy with max_retries retries — for tests that want to exercise the retry loop without sleeping.

pub fn delay_for(&self, attempt: u32) -> Duration

Delay before the attempt-th retry (attempt is 1-based: 1 is the first retry). Deterministic when jitter is false.

Trait Implementations

impl Clone for RetryPolicy

fn clone(&self) -> RetryPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetryPolicy

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

Formats the value using the given formatter.

impl Default for RetryPolicy

fn default() -> Self

Production default: 4 retries (5 attempts total), 500 ms base doubling to an 8 s ceiling, with jitter — roughly 15 s of resilience against a flaky hosted endpoint.