Struct ToolError 

pub struct ToolError {
    pub code: &'static str,
    pub message: String,
    pub errors: Vec<String>,
    pub hint: Option<String>,
}

A domain failure surfaced to the agent as an MCP tool error (never a JSON-RPC error): {code, message, errors?, hint?}.

Fields

code: &'static str

message: String

errors: Vec<String>

hint: Option<String>

Implementations

impl ToolError

fn new(code: &'static str, message: impl Into<String>) -> Self

fn with_hint(self, hint: impl Into<String>) -> Self

pub fn not_found(what: &str, name: &str) -> Self

pub fn invalid_input(msg: impl Into<String>) -> Self

pub fn invalid_config(errors: Vec<String>) -> Self

pub fn debug_disabled() -> Self

pub fn sandbox_disabled() -> Self

pub fn forbidden(have: McpScope) -> Self

pub fn invalid_payload(msg: impl Into<String>) -> Self

A definition that did not parse (validate_/put_): the hint spells out the argument shape every write tool shares.

pub fn sandbox_bad_request(msg: impl Into<String>) -> Self

A malformed run_sandbox payload: the message says what failed, the hint shows the accepted shape so the caller can fix it in one step.

pub fn unsaved_changes(pending: Vec<String>) -> Self

reload_config would revert live edits that were never written to gateway.yaml; errors lists them.

pub fn store_error(msg: impl Into<String>) -> Self

pub fn unknown_tool(name: &str) -> Self

pub fn internal(msg: impl Into<String>) -> Self

pub fn to_json(&self) -> Value

The body of the isError tool result. Only called from src/mcp/server.rs (outside #[cfg(test)], which uses it too).

Trait Implementations

impl Clone for ToolError

fn clone(&self) -> ToolError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolError

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

Formats the value using the given formatter.

impl Eq for ToolError

impl PartialEq for ToolError

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