Struct Message 

pub struct Message {
    pub role: Role,
    pub content: MessageContent,
    pub name: Option<String>,
    pub provider_options: Option<MessageProviderOptions>,
}

A message in a conversation

Fields

role: Role

The role of the message sender

content: MessageContent

The content of the message - can be a string or array of content parts

name: Option<String>

Optional name for the message sender

provider_options: Option<MessageProviderOptions>

Provider-specific options (e.g., cache control for Anthropic)

Implementations

impl Message

pub fn new(role: Role, content: impl Into<MessageContent>) -> Self

Create a new message with text content

pub fn text(&self) -> Option<String>

Get the text content of the message (if any)

pub fn parts(&self) -> Vec<ContentPart>

Get all content parts

pub fn with_name(self, name: impl Into<String>) -> Self

Set the message sender name

pub fn with_cache_control(self, cache_control: CacheControl) -> Self

Add Anthropic cache control to this message

Example

use stakai::{Message, Role, CacheControl};

let msg = Message::new(Role::System, "System prompt...")
    .with_cache_control(CacheControl::ephemeral());

pub fn with_provider_options(self, options: MessageProviderOptions) -> Self

Add provider-specific options to this message

pub fn cache_control(&self) -> Option<&CacheControl>

Get the cache control from provider options (if set for Anthropic)

Trait Implementations

impl Clone for Message

fn clone(&self) -> Message

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Message

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Message

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Message

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

where __S: Serializer,

Serialize this value into the given Serde serializer.