Enum Content 

#[non_exhaustive]
pub enum Content {
    Text(String),
    ToolUse(ToolCall),
    ToolResult(ToolResult),
    Image(ImageRef),
}

A single content block within a Message.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Text(String)

Plain text.

ToolUse(ToolCall)

A tool invocation emitted by the model.

ToolResult(ToolResult)

The result of a prior Content::ToolUse, fed back to the model.

Image(ImageRef)

A reference to an image (HTTP URL or data: URI).

Implementations

impl Content

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

Wraps s in a Content::Text variant.

pub fn tool_use( id: impl Into<String>, name: impl Into<String>, args_json: impl Into<String>, ) -> Self

Constructs a Content::ToolUse block.

pub fn tool_use_signed( id: impl Into<String>, name: impl Into<String>, args_json: impl Into<String>, signature: Option<String>, ) -> Self

Constructs a Content::ToolUse block carrying an opaque provider-specific signature (e.g. a thinking model’s thought signature, which some providers require echoed back on the next request that includes this call).

pub fn tool_result( tool_call_id: impl Into<String>, result_json: impl Into<String>, is_error: bool, first_party: bool, ) -> Self

Constructs a Content::ToolResult block.

first_party is the ingestion-time provenance bit (see ToolResult::first_party) — pass the caller’s already-computed verdict (the static per-tool-name check for an ordinary tool, or the worker-derived verdict for a __delegate_to result), not a fixed default: the whole point of carrying this on ToolResult is that the live same-turn taint scan needs the REAL per-call answer.

pub fn image(url: impl Into<String>, mime_type: Option<String>) -> Self

Constructs a Content::Image block.

Trait Implementations

impl Clone for Content

fn clone(&self) -> Content

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Content

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Content

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Content

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

where __S: Serializer,

Serialize this value into the given Serde serializer.