Struct UpstreamCandidate 

pub struct UpstreamCandidate {
    pub upstream_id: Uuid,
    pub name: String,
    pub kind: UpstreamKind,
    pub observed_rate_limits: Vec<RateLimitObservation>,
    pub subscription_quotas: Vec<SubscriptionQuotaCandidateSnapshot>,
    pub observed_at_unix_secs: u64,
    pub cache_score: Option<CacheScore>,
    pub base_url: Option<String>,
}

Available upstream candidate for routing decisions.

The router receives a list of available upstream candidates sorted by upstream_id in ascending order (Uuid byte order). This stable ordering allows plugins to implement deterministic routing algorithms.

Fields

upstream_id: Uuid

Stable upstream identifier.

name: String

Operator-facing upstream name.

kind: UpstreamKind

Upstream kind used to select compatible routing strategies.

observed_rate_limits: Vec<RateLimitObservation>

Latest rate-limit observations for this candidate.

subscription_quotas: Vec<SubscriptionQuotaCandidateSnapshot>

Latest subscription quota snapshots for this candidate.

observed_at_unix_secs: u64

Unix timestamp in seconds for the candidate observation snapshot.

cache_score: Option<CacheScore>

Predicted cache utility for this candidate, if available.

base_url: Option<String>

Resolved upstream base URL. Populated by the host so that v2 plugins that self-reference for shape can construct the dispatch URL against the configured upstream instead of hardcoding api.anthropic.com.

Trait Implementations

impl Clone for UpstreamCandidate

fn clone(&self) -> UpstreamCandidate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpstreamCandidate

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UpstreamCandidate

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for UpstreamCandidate

fn eq(&self, other: &UpstreamCandidate) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for UpstreamCandidate

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UpstreamCandidate