Enum A2aVersion 

pub enum A2aVersion {
    V1_0,
    Unknown {
        major: u16,
        minor: u16,
    },
}

A published A2A revision, or one published after this build was compiled.

Ordered by major then minor, oldest to newest. See the module docs for why that is an invariant rather than a coincidence.

Ord and PartialOrd are hand-written (the derive is removed) for the reason in the module docs: a derived Ord orders enum variants by declaration order first, which would put V1_0 (the first variant) before Unknown { major: 1, minor: 0 } even though they carry the same wire value. The hand impl compares by (major, minor) only, so the two are Ordering::Equal. The 1.98 derive fast path that assumes a derived PartialOrd agrees with a hand-written Ord does not apply here — this is the case the rule was written for.

Variants

V1_0

The first A2A version with the A2A-Version header. Establishes the JSON-RPC binding the protocol-neutral core already speaks, plus the agent card well-known path.

Unknown

A version published after this build, identified by its Major.Minor. Carries the same major/minor as a known revision would; what changes between a known revision and its Unknown peer is whether this build’s per-version codec has types for it.

Fields

major: u16

The peer-named major version. u16 because the A2A Major.Minor wire form is decimal; a major number that overflows u16 is not a real A2A version.

minor: u16

The peer-named minor version.

Implementations

impl A2aVersion

pub const KNOWN: [Self; 1]

Every revision this build has wire types for, oldest first.

pub const fn as_str(&self) -> &'static str

The canonical wire string, e.g. "1.0". An Unknown formats the same way the spec defines, so the on-the-wire form does not distinguish a known revision from a future one — the dispatcher’s VersionNotSupportedError does.

pub const fn is_known(&self) -> bool

True if this version is a build-time known revision. A VersionNotSupportedError is the right response to a peer that names a Known revision we don’t speak yet and an Unknown we have no codec for; the dispatcher’s table decides which side of the line a given string falls on.

Trait Implementations

impl Clone for A2aVersion

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for A2aVersion

impl Debug for A2aVersion

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for A2aVersion

The wire form round-trips through FromStr; a version that does not parse is a ParseA2aVersionError, which surfaces as a serde error so a malformed protocolVersion field is the typed answer the spec expects, not a 500.

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for A2aVersion

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

Formats the value using the given formatter.

impl Eq for A2aVersion

impl FromStr for A2aVersion

type Err = ParseA2aVersionError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for A2aVersion

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for A2aVersion

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for A2aVersion

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for A2aVersion

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for A2aVersion

The wire form of an A2aVersion is the Display form: "1.0", "0.3", etc. A Serialize impl that delegates to Display keeps the wire form and the in-memory form in lockstep — a change to one without the other would break the protocol and the type would catch it.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for A2aVersion