Struct Hints 

pub struct Hints {
    pub readonly: Option<bool>,
    pub destructive: Option<bool>,
    pub idempotent: Option<bool>,
    pub open_world: Option<bool>,
    pub long_running: Option<bool>,
    pub concurrency_class: Option<String>,
    pub metadata: Option<Value>,
}

Semantic and host-owned annotations for a capability tool.

Boolean values are Option<bool> so unspecified remains distinct from false. Hints inform scheduling and clients; they do not grant authority.

Fields

readonly: Option<bool>

The tool does not modify state.

destructive: Option<bool>

The tool may irreversibly delete or destroy state.

idempotent: Option<bool>

Repeating a call with the same arguments is safe.

open_world: Option<bool>

The tool interacts with systems outside the local process.

long_running: Option<bool>

The tool may commonly take more than a few seconds.

concurrency_class: Option<String>

Calls sharing this non-empty key execute sequentially.

metadata: Option<Value>

Host-owned annotations. Never include credentials or sensitive data.

Implementations

impl Hints

pub fn readonly(self, value: bool) -> Self

Mark whether the tool is read-only.

pub fn destructive(self, value: bool) -> Self

Mark whether the tool can destroy state.

pub fn idempotent(self, value: bool) -> Self

Mark whether identical calls are safe to repeat.

pub fn open_world(self, value: bool) -> Self

Mark whether the tool reaches external systems.

pub fn long_running(self, value: bool) -> Self

Mark whether the tool is commonly long-running.

pub fn concurrency_class(self, value: impl Into<String>) -> Self

Serialize calls that share this scheduling class.

pub fn metadata(self, value: impl Into<Value>) -> Self

Attach host-owned JSON annotations.

Trait Implementations

impl Clone for Hints

fn clone(&self) -> Hints

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Hints

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

Formats the value using the given formatter.

impl Default for Hints

fn default() -> Hints

Returns the “default value” for a type.

impl PartialEq for Hints

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Hints