Enum RetryEvent 

pub enum RetryEvent<'a> {
    AttemptStart {
        attempt: u32,
        max_attempts: u32,
    },
    Success {
        attempt: u32,
    },
    GiveUp {
        attempt: u32,
        error: &'a VtCodeError,
        decision: &'a RetryDecision,
        category_was_retryable: bool,
    },
    Backoff {
        attempt: u32,
        error: &'a VtCodeError,
        decision: &'a RetryDecision,
        delay: Duration,
        category_was_retryable: bool,
    },
    Exhausted {
        last_error: Option<&'a VtCodeError>,
    },
}

Lifecycle event emitted by run_with_retry so callers can attach logging, metrics, or stats updates without re-implementing the loop.

category_was_retryable is provided alongside GiveUp and Backoff because call sites frequently need to distinguish “non-retryable category” from “retryable category, budget exhausted” — the distinction is otherwise invisible once step_for_vtcode_error collapses both into GiveUp.

Variants

AttemptStart

An attempt is about to start. attempt is 0-indexed.

Fields

attempt: u32

max_attempts: u32

Success

The operation succeeded on the given attempt.

Fields

attempt: u32

GiveUp

The policy decided to give up and surface error immediately.

Fields

attempt: u32

error: &'a VtCodeError

decision: &'a RetryDecision

category_was_retryable: bool

Backoff

The policy decided to back off and retry. The driver will sleep for delay before invoking the operation again.

Fields

attempt: u32

error: &'a VtCodeError

decision: &'a RetryDecision

delay: Duration

category_was_retryable: bool

Exhausted

All attempts were exhausted. last_error is the most recent error captured from a Backoff step.

Fields

last_error: Option<&'a VtCodeError>

Trait Implementations

impl<'a> Debug for RetryEvent<'a>

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

Formats the value using the given formatter.