Enum ShellOutcome 

pub enum ShellOutcome {
    Exit(i32),
    Blocked,
}

Outcome of a shell execution, carried alongside the rendered text so the MCP dispatch layer can surface failures in protocol metadata instead of only as an [exit:N] text footer (GitHub #389: clients had no programmatic way to detect ctx_shell failures and resorted to fragile regex matching).

Variants

Exit(i32)

The command ran; carries its real exit code (0 = success).

Blocked

The command never ran (allowlist/validation rejection, or a precondition failure such as an unreadable/oversized input file).

Implementations

impl ShellOutcome

pub fn is_error(self) -> bool

Whether this outcome must be reported as a tool error (isError: true).

pub fn structured(self) -> Option<Value>

Structured payload for CallToolResult.structuredContent, so guards can read exitCode/blocked instead of parsing output text. Success (exit 0) intentionally returns None — the happy path stays token-neutral for clients that render structured content.

Trait Implementations

impl Clone for ShellOutcome

fn clone(&self) -> ShellOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ShellOutcome

impl Debug for ShellOutcome

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

Formats the value using the given formatter.

impl Eq for ShellOutcome

impl PartialEq for ShellOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ShellOutcome