Struct ApprovalRequest 

pub struct ApprovalRequest {

    pub approval_id: String,
    pub policy_id: String,
    pub subject_id: AgentId,
    pub capability_id: String,
    pub subject_public_key: Option<PublicKey>,
    pub tool_server: ServerId,
    pub tool_name: String,
    pub action: String,
    pub parameter_hash: String,
    pub expires_at: u64,
    pub callback_hint: Option<String>,
    pub created_at: u64,
    pub summary: String,
    pub governed_intent: Option<GovernedTransactionIntent>,
    pub trusted_approvers: Vec<PublicKey>,
    pub triggered_by: Vec<String>,
}

A request for human approval, produced when the approval guard returns Verdict::PendingApproval. Designed to be serialized into the approval store and the webhook payload without further wrapping.

Fields

approval_id: String

Unique request identifier. Caller-stable so the approval store can be keyed on this value. In production this is a UUIDv7.

policy_id: String

The policy / grant identifier that triggered the approval.

subject_id: AgentId

The calling agent’s identifier.

capability_id: String

Capability token ID bound to this request.

subject_public_key: Option<PublicKey>

Public key of the capability subject this approval is bound to. A presented approval token must carry the same subject.

tool_server: ServerId

Server hosting the target tool.

tool_name: String

Tool being invoked.

action: String

Short action verb for human summaries (e.g. invoke, charge).

parameter_hash: String

SHA-256 hex digest of the canonical JSON of the tool arguments / governed intent. Used to bind an approval token to this exact parameter set; a mutated argument payload will not satisfy the same approval.

expires_at: u64

Unix seconds after which the request auto-denies (or escalates, per timeout_action in the grant).

callback_hint: Option<String>

Hint for channels about where the human can respond (e.g. the URL of the dashboard or a Slack permalink). None means “dispatcher will fill this in after sending”.

created_at: u64

Unix seconds when the request was created.

summary: String

Short human-readable summary for dashboards.

governed_intent: Option<GovernedTransactionIntent>

Original governed intent, when one is bound. Required for threshold-based approvals so the approver sees the financial envelope they are signing off on.

trusted_approvers: Vec<PublicKey>

Public keys allowed to approve this request. The kernel fails closed when the set is empty or when the presented approver is not in the set.

triggered_by: Vec<String>

Guards that triggered the approval requirement.

Trait Implementations

impl Clone for ApprovalRequest

fn clone(&self) -> ApprovalRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ApprovalRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ApprovalRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ApprovalRequest

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ApprovalRequest

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 ApprovalRequest