Struct ToolResult 

pub struct ToolResult {
    pub code: i32,
    pub stdout: String,
    pub stderr: String,
    pub data: Option<Value>,
    pub output: Option<OutputData>,
    pub content_type: Option<String>,
    pub baggage: BTreeMap<String, String>,
    pub latch: Option<Box<LatchRequest>>,
}

Result from tool execution via backend.

Fields

code: i32

Exit code (0 = success).

stdout: String

Standard output.

stderr: String

Standard error.

data: Option<Value>

Structured data (if any).

output: Option<OutputData>

Structured output data for rendering (preserved from ExecResult).

content_type: Option<String>

MIME content type hint (propagated from ExecResult).

baggage: BTreeMap<String, String>

Opaque key-value context (propagated from ExecResult).

latch: Option<Box<LatchRequest>>

A pending confirmation-latch request (propagated from ExecResult), so a backend-tool latch survives the ExecResult↔ToolResult roundtrip. Its own typed field — never folded into data. Boxed to match ExecResult.latch (keeps the roundtrip a direct move; see that field for why).

Implementations

impl ToolResult

pub fn success(stdout: impl Into<String>) -> ToolResult

Create a successful result.

pub fn failure(code: i32, stderr: impl Into<String>) -> ToolResult

Create a failed result.

pub fn with_data(stdout: impl Into<String>, data: Value) -> ToolResult

Create a result with structured data.

pub fn ok(&self) -> bool

Check if the tool execution succeeded.

Trait Implementations

impl Clone for ToolResult

fn clone(&self) -> ToolResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolResult

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

Formats the value using the given formatter.

impl From<ExecResult> for ToolResult

fn from(exec: ExecResult) -> ToolResult

Converts to this type from the input type.

impl From<ToolResult> for ExecResult

fn from(result: ToolResult) -> ExecResult

The symmetric peer of From<ExecResult> for ToolResult above — every field that direction preserves, this direction must preserve too, or a backend-registered tool’s structured data/content_type/baggage silently vanishes crossing back into the kernel (the embedder seam: x=$(embedder_tool) and for r in $(embedder_tool) need .data to see typed results, not just stdout text).

data uses json_to_value_no_envelope rather than the internal round-trip conversion: a backend tool’s JSON is external input, so an object shaped like the byte envelope must stay a plain record, never silently auto-decode to Value::Bytes.