Enum ContentPart 

pub enum ContentPart {
    Text {
        text: String,
    },
    Reasoning {
        text: String,
    },
    FileData {
        file_uri: String,
        mime_type: Option<String>,
    },
    InlineData {
        mime_type: String,
        data: ByteBufB64,
    },
    ToolCall {
        name: String,
        args: Json,
        call_id: Option<String>,
    },
    ToolOutput {
        name: String,
        output: Json,
        is_error: Option<bool>,
        call_id: Option<String>,
        remote_id: Option<Principal>,
    },
    Action {
        name: String,
        payload: Json,
        recipients: Option<Vec<Principal>>,
        signature: Option<ByteBufB64>,
    },
    Any(Json),
}

A single content item inside a chat message.

The enum supports Anda’s normalized content types while preserving unknown provider-specific JSON payloads in ContentPart::Any.

Variants

Text

Visible text content.

Fields

text: String

Text body.

Reasoning

Provider reasoning or thinking text.

Fields

text: String

Reasoning text body.

FileData

File content referenced by URI.

Fields

file_uri: String

URI pointing to the file data.

mime_type: Option<String>

MIME type if known.

InlineData

Inline binary data with an explicit MIME type.

Fields

mime_type: String

MIME type for the inline bytes.

data: ByteBufB64

Base64-encoded binary payload.

ToolCall

Tool call requested by a model.

Fields

name: String

Tool function name.

args: Json

JSON arguments for the tool call.

call_id: Option<String>

Provider call identifier used to correlate tool outputs.

ToolOutput

Tool output returned to a model.

Fields

name: String

Tool function name.

output: Json

JSON output payload.

is_error: Option<bool>

Whether the tool output represents an error.

call_id: Option<String>

Provider call identifier this output answers.

remote_id: Option<Principal>

Remote engine principal when the tool call was delegated.

Action

Signed action payload emitted by an agent.

Fields

name: String

Action name.

payload: Json

Action-specific payload.

recipients: Option<Vec<Principal>>

Principals that should receive the action.

signature: Option<ByteBufB64>

Optional signature over the action payload.

Any(Json)

Provider-specific content part preserved as raw JSON.

Implementations

impl ContentPart

pub fn any_from<T>(ty: &str, val: T) -> Self

where T: Serialize,

Creates a content part of type Any with the given type tag and value.

The type tag is only added when val serializes to a JSON object.

pub fn any_into<T>(self, ty: &str) -> Result<T, Box<Self>>

where T: DeserializeOwned,

Attempts to convert this content part of type Any into the specified type if the type tag matches.

pub fn estimated_tokens(&self) -> usize

Estimates the number of tokens in this content part for usage accounting and pruning.

Trait Implementations

impl Clone for ContentPart

fn clone(&self) -> ContentPart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentPart

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentPart

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ContentPart

impl From<String> for ContentPart

fn from(text: String) -> Self

Converts to this type from the input type.

impl From<Value> for ContentPart

fn from(val: Json) -> Self

Converts to this type from the input type.

impl PartialEq for ContentPart

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContentPart

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 ContentPart

impl TryFrom<Resource> for ContentPart

type Error = Resource

The type returned in the event of a conversion error.

fn try_from(res: Resource) -> Result<Self, Self::Error>

Performs the conversion.