Struct GovernanceRequest 

pub struct GovernanceRequest {
    pub agent_id: String,
    pub action: String,
    pub effect: EffectVector,
    pub context: HashMap<String, String>,
    pub node_id: Option<String>,
    pub principal: Option<GatePrincipal>,
}

Governance evaluation request.

Fields

agent_id: String

Agent identifier making the request.

action: String

Action being requested.

effect: EffectVector

Computed effect vector for the action.

context: HashMap<String, String>

Additional context for the evaluator.

node_id: Option<String>

Node ID of the requesting node (for distributed governance in K6).

principal: Option<GatePrincipal>

Optional attributed principal (WEFT-636). When set, propagates onto GovernanceResult::principal and chain audit payloads. When absent, the engine synthesises a principal from agent_id alone.

Implementations

impl GovernanceRequest

pub fn new(agent_id: impl Into<String>, action: impl Into<String>) -> Self

Create a new governance request.

pub fn with_node_id(self, node_id: impl Into<String>) -> Self

Set the node ID for distributed governance evaluation.

pub fn with_effect(self, effect: EffectVector) -> Self

Set the effect vector.

pub fn with_principal(self, principal: GatePrincipal) -> Self

Set the attributed principal (WEFT-636).

pub fn with_tool_context( self, tool_name: impl Into<String>, gate_action: impl Into<String>, effect: EffectVector, pid: u64, ) -> Self

Enrich the request with tool execution context (k3:D2).

Sets the context map with tool-specific fields so governance rules can distinguish between different tool invocations even when the action string is the generic "tool.exec".

Fields set

• tool — tool name (e.g. "fs.read_file")
• gate_action — the per-tool gate action from the catalog
• pid — stringified PID of the requesting agent

The effect field is set from the tool’s declared effect vector, enabling threshold-based governance that varies per tool.

pub fn with_context_entry( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Add a single key-value pair to the context map.

The reserved keys (crate::governance_project::RESERVED_CONTEXT_KEYS) are the kernel’s alone and are ignored here.

pub fn resolved_principal(&self) -> GatePrincipal

Resolve the principal for this request (explicit or synthesised), attributed to the kernel’s attested project when it has one.

impl GovernanceRequest

pub fn attributed(self) -> Self

Attribute this request to the kernel’s attested project (if any).

pub fn attributed_with( self, att: Option<&ProjectAttestation>, instance: Option<&str>, ) -> Self

attributed with an explicit attestation. With None the request ends up with no project_id / instance_id in its context or principal (the user daemon attributes nothing).

Trait Implementations

impl Clone for GovernanceRequest

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 GovernanceRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GovernanceRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GovernanceRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.