Struct GatePrincipal 

pub struct GatePrincipal {
    pub agent_id: String,
    pub user_id: Option<String>,
    pub parent_agent_id: Option<String>,
    pub conv_id: Option<String>,
    /* private fields */
}

Attributed principal for a governance / gate evaluation (WEFT-636).

Control already holds via agent_id; this type makes who authorized the action and which child is acting first-class so chain records and multi-tenant spawn paths carry attribution, not just a bare agent id.

Fields

agent_id: String

Acting agent id (child or concierge). Always the evaluation principal key when non-empty (see GovernanceEngine::eval_principal_key).

user_id: Option<String>

Human / user authority under which the agent acts (spawn-at-user-level).

parent_agent_id: Option<String>

Parent agent when this evaluation is for a spawned child.

conv_id: Option<String>

Conversation scope for attribution (parent or child conv id).

Implementations

impl GatePrincipal

pub fn agent(agent_id: impl Into<String>) -> Self

Build a principal for a bare agent (no user / parent attribution).

pub fn with_project(self, project: &ProjectAttestation) -> Self

Attribute the action to a verified project (ADR-103 A6).

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

The attributed project, if one was verified.

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

The evaluating kernel’s node id, if recorded.

pub fn with_instance(self, instance_id: impl Into<String>) -> Self

Record the evaluating kernel’s node id.

pub fn with_user(self, user_id: impl Into<String>) -> Self

Attach a user authority (WEFT-635 / WEFT-636).

pub fn with_parent(self, parent_agent_id: impl Into<String>) -> Self

Attach parent agent attribution for a child spawn.

pub fn with_conv(self, conv_id: impl Into<String>) -> Self

Attach conversation scope.

pub fn eval_key(&self) -> &str

Effective rate-limit / evaluation key: prefer non-empty agent_id.

Trait Implementations

impl Clone for GatePrincipal

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 GatePrincipal

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

Formats the value using the given formatter.

impl Default for GatePrincipal

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GatePrincipal

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for GatePrincipal

impl PartialEq for GatePrincipal

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for GatePrincipal

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GatePrincipal