Struct NegotiatedSession 

pub struct NegotiatedSession {
    pub version: ProtocolVersion,
    pub profile: FeatureProfile,
    pub client_caps: CapabilitySet,
    pub server_caps: CapabilitySet,
    pub transport: TransportKind,
    pub client_info: Option<PeerInfo>,
    pub server_info: Option<PeerInfo>,
    pub is_stateless: bool,
}

A session that has agreed on a version and a feature profile.

Deliberately not a connection: for 2026-07-28 this is per-request and nothing is retained, which is why Self::is_stateless is part of the value rather than a property of whatever holds it.

Fields

version: ProtocolVersion

The version both sides speak.

profile: FeatureProfile

What this session may do.

client_caps: CapabilitySet

What the client advertised.

server_caps: CapabilitySet

What the server advertised.

transport: TransportKind

The transport the session runs over.

client_info: Option<PeerInfo>

The client implementation, when it identified itself.

server_info: Option<PeerInfo>

The server implementation, when it identified itself.

is_stateless: bool

Whether this profile is recomputed per request with nothing retained.

Implementations

impl NegotiatedSession

pub fn new( version: ProtocolVersion, transport: TransportKind, client_caps: CapabilitySet, server_caps: CapabilitySet, ) -> Self

Builds a session from an agreed version and a pair of capability sets.

pub fn with_client_info(self, info: PeerInfo) -> Self

Attaches the client’s identity.

pub fn with_server_info(self, info: PeerInfo) -> Self

Attaches the server’s identity.

pub const fn negotiation(&self) -> Negotiation

The four inputs profile was resolved from.

Client::from_session reads the profile off a session and needs nothing else, so this is here for the callers that genuinely hold a bare Negotiation and want to make one. new already resolved from exactly these four fields, so re-resolving the value this returns reproduces profile rather than recomputing anything new — which is why it is a convenience and not the way to build a client.

pub fn allows(&self, feature: Feature) -> bool

Whether the session may do feature.

pub const fn len(&self) -> u32

How many features the session may do.

pub const fn is_empty(&self) -> bool

Whether the session may do nothing at all.

Trait Implementations

impl Clone for NegotiatedSession

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NegotiatedSession

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

Formats the value using the given formatter.

impl Eq for NegotiatedSession

impl PartialEq for NegotiatedSession

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for NegotiatedSession