Struct RequestContext 

pub struct RequestContext { /* private fields */ }

Who is calling, and which conversation the call belongs to.

Built by the transport adapter that accepted the request and passed down through TaskService to AsyncMessageHandler. One value rather than a widening parameter list: the session id, the principal and (later) the tenant are all facts about this request, and a handler that wants one usually wants the others.

Not to be confused with CallContext, which is interceptor metadata about the call being dispatched (method name, side of the wire) and says nothing about who made it.

The principal

principal is None when the agent serves anonymous callers — no authenticator is configured, so there is nobody to name. It is what AsyncConversationStore compares against a context’s recorded owner, which is why the transport has to carry it rather than the handler guessing: a handler that cannot tell two callers apart hands the second one the first one’s conversation.

Implementations

impl RequestContext

pub fn anonymous() -> Self

A call from nobody in particular: no session, no principal.

The right context for an internal caller that is not serving a request — a bridge invoking a handler directly, or a test.

pub fn with_session(self, session_id: impl Into<String>) -> Self

Name the conversation this call belongs to.

An empty string is the same as no session at all, which is what a wire message with an unset context_id decodes to.

pub fn with_principal(self, principal: impl Into<Option<AuthPrincipal>>) -> Self

Attach the principal the transport authenticated.

pub fn session_id(&self) -> Option<&str>

The context id the caller supplied.

pub fn principal(&self) -> Option<&AuthPrincipal>

The authenticated principal, with whatever claims the authenticator attached.

pub fn caller(&self) -> Option<&str>

The authenticated principal’s id — the identity a conversation is owned by.

Trait Implementations

impl Clone for RequestContext

fn clone(&self) -> RequestContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestContext

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

Formats the value using the given formatter.

impl Default for RequestContext

fn default() -> RequestContext

Returns the “default value” for a type.