Struct ResourceTraceEnvelope 

pub struct ResourceTraceEnvelope {
    pub version: u32,
    pub resource: String,
    pub operation: String,
    pub trace_kind: String,
    pub input_summary: Value,
    pub output_summary: Value,
    pub reason: Option<String>,
    pub metadata: Value,
}

Machine-readable trace envelope for resource-side decisions.

This is intentionally local to rig-resources. It proves a stable shape for graph, security, baseline, and memory-resource metadata before any trace API is promoted into the rig-compose kernel.

Fields

version: u32

Trace shape version.

resource: String

Category such as graph, security, baseline, or memory.

operation: String

Specific operation performed by the resource.

trace_kind: String

Machine-readable trace kind such as graph_expansion.

input_summary: Value

Compact, non-secret input summary.

output_summary: Value

Compact output summary.

reason: Option<String>

Optional reason code for skip, suppress, deny, or not-applicable paths.

metadata: Value

Additional resource-specific metadata.

Implementations

impl ResourceTraceEnvelope

pub const VERSION: u32 = 1

Current envelope version.

pub fn new( resource: impl Into<String>, operation: impl Into<String>, trace_kind: impl Into<String>, ) -> Self

Create a trace envelope with empty summaries.

pub fn with_input_summary(self, input_summary: Value) -> Self

Attach the input summary.

pub fn with_output_summary(self, output_summary: Value) -> Self

Attach the output summary.

pub fn with_reason(self, reason: impl Into<String>) -> Self

Attach a machine-readable reason code.

pub fn with_metadata(self, metadata: Value) -> Self

Attach resource-specific metadata.

pub fn to_value(&self) -> Value

Convert the trace envelope into JSON metadata.

Trait Implementations

impl Clone for ResourceTraceEnvelope

fn clone(&self) -> ResourceTraceEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResourceTraceEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ResourceTraceEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ResourceTraceEnvelope

fn eq(&self, other: &ResourceTraceEnvelope) -> 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 ResourceTraceEnvelope

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 ResourceTraceEnvelope