Enum AgentMessage 

pub enum AgentMessage {
    ToolCallRequest {
        id: String,
        capability_token: Box<CapabilityToken>,
        server_id: String,
        tool: String,
        params: Box<Value>,
        governed_intent: Option<Box<GovernedTransactionIntent>>,
        approval_token: Option<Box<GovernedApprovalToken>>,
        approval_tokens: Vec<GovernedApprovalToken>,
        threshold_approval_proposal: Option<Box<ThresholdApprovalProposal>>,
        supplemental_authorization: Option<Box<OpaqueSupplementalAuthorization>>,
        execution_nonce: Option<Box<SignedExecutionNonce>>,
    },
    ListCapabilities,
    Heartbeat,
}

Messages sent from the Agent to the Kernel.

Variants

ToolCallRequest

Request to invoke a tool, presenting a capability token as authority.

Fields

id: String

Correlation ID (UUIDv7 recommended).

capability_token: Box<CapabilityToken>

The signed capability token authorizing this call.

server_id: String

Target tool server for this invocation.

tool: String

Name of the tool to invoke (must be in the token’s scope).

params: Box<Value>

Tool input parameters.

governed_intent: Option<Box<GovernedTransactionIntent>>

Governed transaction the agent is asking the kernel to authorize.

approval_token: Option<Box<GovernedApprovalToken>>

Single approval covering the governed intent.

approval_tokens: Vec<GovernedApprovalToken>

Approvals collected for a threshold proposal.

threshold_approval_proposal: Option<Box<ThresholdApprovalProposal>>

Threshold policy the collected approvals are counted against.

supplemental_authorization: Option<Box<OpaqueSupplementalAuthorization>>

Opaque authorization extension carried through to the kernel.

execution_nonce: Option<Box<SignedExecutionNonce>>

Kernel-issued nonce from a strict execution preflight for this request.

ListCapabilities

Request a listing of the agent’s current capabilities.

Heartbeat

Liveness probe.

Implementations

impl AgentMessage

pub fn authorization_conflict(&self) -> Option<&'static str>

Reports why the message’s authorization fields cannot be honoured together, or None when the combination is admissible.

The wire schema states these rules, but a peer that ignores the schema must still be refused rather than evaluated against a partial authorization set.

Trait Implementations

impl Clone for AgentMessage

fn clone(&self) -> AgentMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentMessage

fn deserialize<__D>( __deserializer: __D, ) -> Result<AgentMessage, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentMessage

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

where __S: Serializer,

Serialize this value into the given Serde serializer.