Struct ToolResult 

pub struct ToolResult {
    pub success: bool,
    pub output: String,
    pub data: Option<Value>,
    pub documents: Vec<ContentSource>,
    pub duration_ms: Option<u64>,
}

Result of a tool execution

Fields

success: bool

Whether the tool execution succeeded

output: String

Output content (displayed to user and fed back to LLM)

data: Option<Value>

Optional structured data

documents: Vec<ContentSource>

Optional documents (PDFs, images) to pass back to the LLM as native content blocks. The agent appends these as ContentBlock::Document / ContentBlock::Image blocks in the same user message as the tool result, so the model can read them directly.

duration_ms: Option<u64>

Duration of the tool execution in milliseconds

Implementations

impl ToolResult

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

pub fn success_with_data(output: impl Into<String>, data: Value) -> Self

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

pub const fn with_duration(self, duration_ms: u64) -> Self

pub fn with_documents(self, documents: Vec<ContentSource>) -> Self

Attach documents (PDFs, images) to be sent back to the LLM as native content blocks.

Use this when a tool produces a binary document that the model should read directly, e.g. a decrypted PDF that Anthropic can parse natively via its document API.

Example

use agent_sdk::{ToolResult, ContentSource};

Ok(ToolResult::success("PDF decrypted.").with_documents(vec![
    ContentSource::new("application/pdf", base64_data),
]))

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolResult

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ToolResult

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.