Struct Principal 

pub struct Principal {
    pub id: String,
    pub role: Role,
    pub grants: Vec<String>,
    pub rate: Option<String>,
    pub budget: Option<Budget>,
    pub labels: BTreeMap<String, String>,
}

A resolved caller.

Fields

id: String

A stable id for logs/audit/context (operator, user:<sub>, agent:<id>).

role: Role

grants: Vec<String>

Explicit tool-name grants (patterns) beyond the role defaults.

rate: Option<String>

The rate quota ("<burst>/<per>s") and budget scope key, if any.

budget: Option<Budget>

labels: BTreeMap<String, String>

Operator-declared attributes that travel with everything this principal causes (the run, the MCP _meta, the audit line).

Implementations

impl Principal

pub fn anonymous() -> Principal

pub fn is_operator(&self) -> bool

pub fn is_anonymous(&self) -> bool

pub fn may(&self, method: &str, op: Option<&str>) -> bool

May this principal invoke A2A method method? op is the command tool name for a command DataPart (else None).

The matrix is deny-by-default: anonymous callers get nothing, operators get everything, and every other role is limited to the named read/task methods below — an unrecognised method falls through to false.

pub fn may_command(&self, tool: &str) -> bool

May this principal run command tool tool?

pub fn scope_key(&self) -> String

The governor scope this principal’s spend is charged to.

Trait Implementations

impl Clone for Principal

fn clone(&self) -> Principal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Principal

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

Formats the value using the given formatter.

impl PartialEq for Principal

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Principal