Enum SamplingContent 

#[non_exhaustive]
pub enum SamplingContent {
    Text {
        text: String,
        annotations: Option<ContentAnnotations>,
        meta: Option<Value>,
    },
    Image {
        data: String,
        mime_type: String,
        annotations: Option<ContentAnnotations>,
        meta: Option<Value>,
    },
    Audio {
        data: String,
        mime_type: String,
        annotations: Option<ContentAnnotations>,
        meta: Option<Value>,
    },
    ToolUse {
        id: String,
        name: String,
        input: Value,
        meta: Option<Value>,
    },
    ToolResult {
        tool_use_id: String,
        content: Vec<SamplingContent>,
        structured_content: Option<Value>,
        is_error: Option<bool>,
        meta: Option<Value>,
    },
}

Content types for sampling messages

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

Text content

Fields

text: String

The text content

annotations: Option<ContentAnnotations>

Optional annotations for this content

meta: Option<Value>

Optional protocol-level metadata

Image

Image content

Fields

data: String

Base64-encoded image data

mime_type: String

MIME type of the image

annotations: Option<ContentAnnotations>

Optional annotations for this content

meta: Option<Value>

Optional protocol-level metadata

Audio

Audio content (if supported)

Fields

data: String

Base64-encoded audio data

mime_type: String

MIME type of the audio

annotations: Option<ContentAnnotations>

Optional annotations for this content

meta: Option<Value>

Optional protocol-level metadata

ToolUse

Tool use request from the model (SEP-1577)

Fields

id: String

Unique identifier for this tool use

name: String

Name of the tool being called

input: Value

Input arguments for the tool

meta: Option<Value>

Optional protocol-level metadata

ToolResult

Result of a tool invocation (SEP-1577)

Fields

tool_use_id: String

ID of the tool use this result corresponds to

content: Vec<SamplingContent>

The tool result content

structured_content: Option<Value>

Structured content from the tool result

is_error: Option<bool>

Whether the tool execution resulted in an error

meta: Option<Value>

Optional protocol-level metadata

Implementations

impl SamplingContent

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

Get the text content if this is a text variant.

Returns None if this is an image, audio, tool_use, or tool_result variant.

Example

use tower_mcp_types::protocol::SamplingContent;

let text_content = SamplingContent::Text { text: "Hello".into(), annotations: None, meta: None };
assert_eq!(text_content.as_text(), Some("Hello"));

let image_content = SamplingContent::Image {
    data: "base64...".into(),
    mime_type: "image/png".into(),
    annotations: None,
    meta: None,
};
assert_eq!(image_content.as_text(), None);

Trait Implementations

impl Clone for SamplingContent

fn clone(&self) -> SamplingContent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SamplingContent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SamplingContent

fn deserialize<__D>( __deserializer: __D, ) -> Result<SamplingContent, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SamplingContent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.