Enum ToolSideEffect 

pub enum ToolSideEffect {
    ReadOnly,
    Mutating,
    External,
}

Classification of a tool’s observable side-effects on state outside the agent process. Used by orphan detection and safe-replay (g154) to decide how aggressively to retry or skip an unfinished tool call.

Distinct from crate::kernel::SideEffect, which tracks background-job scheduling; the two live in different modules and never collide.

Variants

ReadOnly

No mutation of any state outside the agent process. Safe to replay at any time. Examples: read_file, search_files, recall, checkpoint_list.

Mutating

Modifies local state (filesystem, scratchpad) in an idempotent- friendly way. Examples: write_file, apply_patch, remember.

External

Reaches out to the external world or triggers opaque side-effects. Cannot determine safe re-execution from local state alone. Examples: run_shell, sub_agent, schedule_wakeup. Default for any tool that does not override side_effect_class.

Trait Implementations

impl Clone for ToolSideEffect

fn clone(&self) -> ToolSideEffect

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ToolSideEffect

impl Debug for ToolSideEffect

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolSideEffect

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ToolSideEffect

impl PartialEq for ToolSideEffect

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

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 ToolSideEffect