Struct SelectionRequest 

pub struct SelectionRequest<'a> {

    pub provider: OAuthProviderId,
    pub model: Option<&'a str>,
    pub now_ms: u64,
    pub max_snapshot_age_ms: u64,
    pub preference: &'a [String],
    pub explicit_account: Option<&'a str>,
    pub exclude: &'a [CredentialRef],
    pub strategy: Strategy,
    pub exhausted_at_percent: f64,
    pub current: Option<&'a CredentialRef>,
    pub urgent_horizon_ms: u64,
    pub sticky: bool,
    pub grace: &'a [AccountCapacity],
    pub grace_max_age_ms: u64,
}

A selection request. All times are epoch milliseconds.

Fields

provider: OAuthProviderId

model: Option<&'a str>

Model the request is for; None = any (model-scoped windows still apply).

now_ms: u64

max_snapshot_age_ms: u64

Observations older than this are stale (not capacity).

preference: &'a [String]

Operator preference (labels, default for the bare slot).

explicit_account: Option<&'a str>

Explicit account label; when set no other account is considered.

exclude: &'a [CredentialRef]

Accounts that must not be selected (e.g. a seat that just failed).

strategy: Strategy

exhausted_at_percent: f64

Utilization percent at/above which a window counts as exhausted.

current: Option<&'a CredentialRef>

The seat currently pinned for this provider, if any. Only consulted when sticky is set under Strategy::SoonestReset; it never bypasses eligibility or exclusion.

urgent_horizon_ms: u64

An anchored budget window resetting within this many ms of now_ms is urgent (tier 1). Default DEFAULT_URGENT_HORIZON_MS.

sticky: bool

Keep current when it is still eligible unless a candidate sits in a strictly higher tier (or both are tier 1 and the candidate resets strictly sooner). Avoids seat thrash and prompt-cache loss. Applies to Strategy::SoonestReset only; false in new so other strategies are unaffected.

grace: &'a [AccountCapacity]

Last successful readings for accounts whose current usage read failed transiently (usage-endpoint 429, 5xx, timeout, transport). Such an account (observation QuotaObservation::Unknown) is evaluated on its reading here instead: strictly younger than grace_max_age_ms, never past an exhausted window, an exclusion or a cooldown. Graced seats rank after every fresh one, but a graced sticky seat stays (a read failure alone is no reason to switch: the sticky rule judges the graced reading exactly as it would a fresh one). Empty in new.

grace_max_age_ms: u64

Oldest graced reading that still counts. Default USAGE_READ_GRACE.

Implementations

impl<'a> SelectionRequest<'a>

pub fn new( provider: OAuthProviderId, now_ms: u64, max_snapshot_age_ms: u64, ) -> SelectionRequest<'a>

Minimal request with defaults: any model, no preference/exclusions, lowest-utilization strategy, 100 % exhaustion threshold, no current seat, default urgent horizon, not sticky.

pub fn soonest_reset( provider: OAuthProviderId, now_ms: u64, max_snapshot_age_ms: u64, ) -> SelectionRequest<'a>

Like new but with Strategy::SoonestReset, sticky selection and the default urgent horizon. Set current for stickiness to have any effect.

Trait Implementations

impl<'a> Clone for SelectionRequest<'a>

fn clone(&self) -> SelectionRequest<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for SelectionRequest<'a>

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

Formats the value using the given formatter.