Struct Addressee 

pub struct Addressee {
    pub id: Option<String>,
    pub role: Option<Role>,
    pub labels: BTreeMap<String, String>,
}

Who must answer a gate. An ask_human/human to: declaration.

An addressee is what makes a gate’s record TRUE: “the finance lead approved this refund” is only worth writing down if someone else could not have satisfied it. Every declared condition must hold, so adding one always narrows — the same direction as security.policies matching, and for the same reason: an operator tightening a gate should never widen it by accident.

Declared either as a bare principal-id glob:

to: "*@finance.acme.example"

or structurally, when identity is better described than enumerated:

to: {role: user, labels: {team: finance}}

Labels are the durable form — people change, teams do not — and they come from a2a.principals[].labels, which is operator-declared and closed.

Fields

id: Option<String>

Principal-id glob (* suffix, or exact).

role: Option<Role>

labels: BTreeMap<String, String>

Every pair must be present on the principal with that value.

Implementations

impl Addressee

pub fn parse(v: &Value) -> Result<Addressee, String>

Parse a to: declaration. A string is an id glob; an object names any of id, role, labels.

pub fn matches(&self, p: &Principal) -> bool

Whether this principal is who the gate is waiting for.

pub fn describe(&self) -> String

A human-readable rendering, for the question, the task and the refusal — a gate that will not accept your answer has to say whose it wants.

Trait Implementations

impl Clone for Addressee

fn clone(&self) -> Addressee

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Addressee

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

Formats the value using the given formatter.

impl Default for Addressee

fn default() -> Addressee

Returns the “default value” for a type.

impl PartialEq for Addressee

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Addressee