Enum ContentBlock 

pub enum ContentBlock {
    Text {
        text: String,
    },
    Thinking {
        thinking: String,
        signature: Option<String>,
        encrypted_content: Option<String>,
        id: Option<String>,
        provenance: Option<ReasoningProvenance>,
        redacted: bool,
    },
    Image {
        source: ImageSource,
    },
    ToolUse {
        id: String,
        name: String,
        input: Value,
    },
    ToolResult {
        tool_use_id: String,
        content: ToolResultContent,
        is_error: bool,
    },
    HostedToolSearch {
        call: HostedToolSearchCall,
    },
    HostedWebSearch {
        call: HostedWebSearchCall,
    },
    ImageGeneration {
        call: ImageGenerationCall,
    },
}

The per-turn steering seam, whole: the trait a host implements and every type its signatures make that host name.

Re-exported rather than wrapped, under the rule stated on CancellationToken — a mentra type basis’s surface asks a caller to write is a name basis re-exports, or the caller pins mentra in their own manifest to spell it. And like the token, a strategy is an identity rather than a value: TurnOptions::with_round_strategy hands mentra the caller’s own Arc, so a basis-owned mirror of RoundDecision would be a translation layer with opinions of its own — the opposite of a seam.

The set is exactly what implementing costs. RoundStrategy is the trait (spelled with async_trait, which basis already re-exports); RoundContext and RoundBoundary are its question; RoundDecision, RoundAdjustment, ReasoningChange and RoundToolResult are its vocabulary for answering. The last three are here because the vocabulary’s own signatures demand them: RoundDecision::inject takes ContentBlocks, RoundAdjustment::with_model a ModelInfo, and ReasoningChange::Set a ReasoningOptions — whose effort field an Effort converts into, so switching effort mid-run never names mentra’s own level enum. A provider-neutral content block exchanged with models.

Variants

Text

Fields

text: String

Thinking

Fields

thinking: String

signature: Option<String>

encrypted_content: Option<String>

id: Option<String>

provenance: Option<ReasoningProvenance>

redacted: bool

Image

Fields

source: ImageSource

ToolUse

Fields

id: String

name: String

input: Value

ToolResult

Fields

tool_use_id: String

content: ToolResultContent

is_error: bool

HostedToolSearch

Fields

call: HostedToolSearchCall

HostedWebSearch

Fields

call: HostedWebSearchCall

ImageGeneration

Fields

call: ImageGenerationCall

Implementations

impl ContentBlock

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

pub fn thinking(thinking: impl Into<String>) -> ContentBlock

pub fn image_bytes( media_type: impl Into<String>, data: impl Into<Vec<u8>>, ) -> ContentBlock

pub fn image_url(url: impl Into<String>) -> ContentBlock

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<(), Error>

Formats the value using the given formatter.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ContentBlock

impl PartialEq for ContentBlock

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContentBlock

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.

impl StructuralPartialEq for ContentBlock

impl TryFrom<(AnthropicContentBlock, ReasoningProvenance)> for ContentBlock

type Error = ProviderError

The type returned in the event of a conversion error.

fn try_from( _: (AnthropicContentBlock, ReasoningProvenance), ) -> Result<ContentBlock, <ContentBlock as TryFrom<(AnthropicContentBlock, ReasoningProvenance)>>::Error>

Performs the conversion.