Struct AgentRunEnvelope 

pub struct AgentRunEnvelope {

    pub adapter: String,
    pub version: String,
    pub action: AgentRunAction,
    pub run_id: RunId,
    pub step_id: StepId,
    pub attempt: i32,
    pub attestation_ids: Vec<Uuid>,
    pub subject_id: Option<String>,
    pub material_digests: Option<BTreeMap<String, String>>,
    pub policy_decision_id: Option<Uuid>,
    pub payload: Option<Value>,
    pub checkpoint: Option<Value>,
    pub error: Option<Value>,
    pub timestamp: DateTime<Utc>,
    pub traceparent: Option<String>,
    pub capability_token: Option<CapabilityToken>,
    pub capability_token_id: Option<String>,
}

Structured envelope that adapters emit to the runtime.

Fields

adapter: String

version: String

action: AgentRunAction

run_id: RunId

step_id: StepId

attempt: i32

attestation_ids: Vec<Uuid>

subject_id: Option<String>

material_digests: Option<BTreeMap<String, String>>

policy_decision_id: Option<Uuid>

payload: Option<Value>

checkpoint: Option<Value>

error: Option<Value>

timestamp: DateTime<Utc>

traceparent: Option<String>

capability_token: Option<CapabilityToken>

capability_token_id: Option<String>

Implementations

impl AgentRunEnvelope

pub fn new( adapter: impl Into<String>, version: impl Into<String>, action: AgentRunAction, ctx: &AgentRunContext, ) -> Self

Creates a baseline envelope for the supplied action.

pub fn with_payload(self, payload: Value) -> Self

Attaches a payload (for emit actions).

pub fn with_checkpoint(self, state: Value) -> Self

Attaches a checkpoint snapshot (for checkpoint actions).

pub fn with_error(self, error: Value) -> Self

Attaches error metadata (for error actions).

pub fn with_attestation_ids<I>(self, ids: I) -> Self

where I: IntoIterator<Item = Uuid>,

Registers attestation identifiers associated with this envelope.

pub fn with_subject_id<S: Into<String>>(self, subject_id: S) -> Self

Sets the trust subject identifier (run/step/adapter specific).

pub fn with_material_digests(self, digests: BTreeMap<String, String>) -> Self

Attaches material digests used to derive this step.

pub fn with_policy_decision_id(self, decision: Uuid) -> Self

Associates a policy decision identifier with the envelope.

pub fn validate(&self) -> Result<(), SchemaValidationError>

Validates the envelope against the embedded AgentRun JSON schema.

Trait Implementations

impl Clone for AgentRunEnvelope

fn clone(&self) -> AgentRunEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentRunEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentRunEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentRunEnvelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.