Enum ContentBlock 

pub enum ContentBlock {
    Text(TextContent),
    Image(ImageContent),
    Audio(AudioContent),
    ResourceLink(ResourceLink),
    EmbeddedResource(EmbeddedResource),
}

A content block that can be used in prompts and tool results.

Variants

Text(TextContent)

Text content.

Image(ImageContent)

Image content (base64-encoded).

Audio(AudioContent)

Audio content (base64-encoded).

ResourceLink(ResourceLink)

A resource link.

EmbeddedResource(EmbeddedResource)

An embedded resource.

Trait Implementations

impl Clone for ContentBlock

fn clone(&self) -> ContentBlock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentBlock

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentBlock

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<ContentBlock> for RichContentPart

Available on crate feature mcp only.

fn from(block: ContentBlock) -> Self

Converts to this type from the input type.

impl From<File> for ContentBlock

Direct conversion from a typed File to a ContentBlock. Multi-field collapse: file_data > file_url > file_id by precedence. Lower-priority fields are dropped; filename rides through via _meta.

fn from(file: File) -> Self

Converts to this type from the input type.

impl From<ImageUrl> for ContentBlock

Direct conversion from a typed ImageUrl to a ContentBlock. Same body as the RichContentPart::ImageUrl arm of [From<RichContentPart> for ContentBlock] — kept independent so per-leaf CommandResponse::into_mcp impls (whose Response is already an ImageUrl) can call image_url.into() without first wrapping in RichContentPart.

fn from(image_url: ImageUrl) -> Self

Converts to this type from the input type.

impl From<InputAudio> for ContentBlock

Direct conversion from a typed InputAudio to a ContentBlock. Same body as the RichContentPart::InputAudio arm of [From<RichContentPart> for ContentBlock].

fn from(input_audio: InputAudio) -> Self

Converts to this type from the input type.

impl From<RichContentPart> for ContentBlock

Convert a single RichContentPart into a ContentBlock.

Forward path produces only Text, Image, and Audio carriers — never EmbeddedResource or ResourceLink. See the module-level docs for the round-trip property and the _meta marker catalogue.

Upstream-specific converters (claude_agent_sdk, codex_sdk) use stricter TryFrom impls that reject unsupported parts. This From is the generic, round-trip-preserving path used by agent/completions/notify and the MCP tool-response formatter.

fn from(part: RichContentPart) -> Self

Converts to this type from the input type.

impl From<VideoUrl> for ContentBlock

Direct conversion from a typed VideoUrl to a ContentBlock. Shared forward path for both RichContentPart::InputVideo and RichContentPart::VideoUrl: data-URL videos round-trip via the default reverse heuristic (parse_data_url → video/* mime → InputVideo), so no marker. Remote URLs get META_KIND = "input_video_remote" so the reverse rebuilds an InputVideo. See the third round-trip exception in the module-level docs.

fn from(video_url: VideoUrl) -> Self

Converts to this type from the input type.

impl JsonSchema for ContentBlock

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for ContentBlock

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

where __S: Serializer,

Serialize this value into the given Serde serializer.