Enum Touches 

pub enum Touches {
    Reads(Scope),
    Writes(Scope),
    Independent,
}

What a tool call may read and change, so calls that touch different things run side by side.

Variants

Reads(Scope)

Reads what the scope names and changes nothing: run again after a restart.

Writes(Scope)

Reads and may change what the scope names.

Independent

Changes nothing the other calls of its reply see, such as handing work to another agent. It may read anything, so it waits behind an earlier writer; it is never run again after a restart.

Implementations

impl Touches

pub fn conflicts_with(&self, other: &Touches) -> bool

Whether a call touching self must not run beside one touching other: one of them writes what the other reads or writes. Independent counts as Reads(Anything) here.

pub fn reads_only(&self) -> bool

Whether it only reads: Reads, and nothing else.

pub fn normalized(self) -> Touches

The footprint with its scope normalized.

pub fn from_annotations(annotations: &ToolAnnotations) -> Self

From the annotations a tool’s own code declares, such as a Tool’s: Reads(Anything) when it says it only reads, else Writes(Anything). For annotations from elsewhere, such as an MCP server’s, from_hints.

pub fn from_hints(annotations: &ToolAnnotations) -> Self

From annotations rig cannot check, such as those an MCP server sends: a tool that says it only reads is Independent, so its calls still run beside readers but are never run again after a restart; any other is Writes(Anything). Only a local declaration makes a call Reads.

Trait Implementations

impl Clone for Touches

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Touches

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Touches

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Touches

impl PartialEq for Touches

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Touches

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 Touches