Struct ToolResultContent 

#[non_exhaustive]
pub struct ToolResultContent {
    pub blocks: Vec<ToolResultBlock>,
    pub is_error: bool,
}

Body of a tool reply sent back to the model in a UserBlock::ToolResult.

The body is a list of ToolResultBlocks (text, image, …) plus an is_error flag. The flag is the wire-level error signal — Anthropic emits it as tool_result.is_error; Chat Completions has no field for it and treats the body as the error message.

is_error is not a Rust Result::Err — both forms represent successful tool calls whose outcome the engine relays to the model. is_error = true flags the reply as a failure the model should account for (e.g. “the API returned 404”). Engine-level errors (panic in the handler, arguments that don’t deserialize, registry lookup miss) are converted to a synthesized error reply so the loop can continue; transport errors propagate through Result channels instead.

Most callers build replies through the Self::text / Self::error constructors; multi-block replies use Self::from_blocks.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

blocks: Vec<ToolResultBlock>

Content blocks in order. A “normal” text reply has a single ToolResultBlock::Text here.

is_error: bool

true flags the reply as a tool-reported failure (Anthropic is_error: true). Adapters that don’t speak the flag on the wire just emit the text body.

Implementations

impl ToolResultContent

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

Build a successful text-only tool reply (is_error = false).

pub fn error(text: impl Into<String>) -> Self

Build a failing text-only tool reply (is_error = true).

pub fn image(source: Source) -> Self

Build a successful image-only tool reply (is_error = false).

pub fn from_blocks(blocks: Vec<ToolResultBlock>) -> Self

Build a reply from arbitrary blocks. Defaults is_error: false; chain Self::with_is_error to flag failure.

pub fn with_is_error(self, is_error: bool) -> Self

Builder-style helper: set the is_error flag.

pub fn as_text(&self) -> Option<&str>

First ToolResultBlock::Text body, if any. Useful when the caller only cares about the text portion of a reply.

pub fn collect_text(&self) -> String

Concatenate every ToolResultBlock::Text body in order, joined by newlines. Returns an empty string when there are no text blocks (the reply was image-only).

Trait Implementations

impl Clone for ToolResultContent

fn clone(&self) -> ToolResultContent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolResultContent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolResultContent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&str> for ToolResultContent

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<String> for ToolResultContent

fn from(value: String) -> Self

Converts to this type from the input type.

impl PartialEq for ToolResultContent

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

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 ToolResultContent