Struct EffectRequest 

pub struct EffectRequest {
    pub id: String,
    pub kind: EffectKind,
    pub description: String,
    pub payload: Value,
    pub source: EffectSource,
    pub risk: RiskLevel,
    pub timeout: Option<Duration>,
    pub metadata: RunMetadata,
}

Request for an outer harness to govern and execute a side effect.

Fields

id: String

Effect id, unique within the process or harness session.

kind: EffectKind

Effect kind.

description: String

User-visible approval/audit description.

payload: Value

Kind-specific JSON payload.

source: EffectSource

Source tool-call metadata, when produced by a tool.

risk: RiskLevel

Request-declared risk.

timeout: Option<Duration>

Request-level timeout suggestion.

metadata: RunMetadata

Host/application metadata.

Implementations

impl EffectRequest

pub fn new( kind: EffectKind, description: impl Into<String>, payload: Value, ) -> Self

Constructs an effect request with a generated id.

pub fn with_id(self, id: impl Into<String>) -> Self

Overrides the generated effect id.

pub fn with_source( self, tool_call_id: impl Into<String>, tool_name: impl Into<String>, ) -> Self

Sets the source tool-call metadata.

pub fn with_source_if_missing( self, tool_call_id: impl Into<String>, tool_name: impl Into<String>, ) -> Self

Fills missing source fields without overwriting fields already set by the tool.

pub fn with_risk(self, risk: RiskLevel) -> Self

Sets the request-declared risk.

pub fn with_timeout(self, timeout: Duration) -> Self

Sets the request-level timeout suggestion.

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

Sets host/application metadata.

Trait Implementations

impl Clone for EffectRequest

fn clone(&self) -> EffectRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EffectRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EffectRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for EffectRequest

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for EffectRequest

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 EffectRequest