Enum ModelContentItem 

pub enum ModelContentItem {
    System(SystemModelContent),
    User(UserModelContent),
    Agent(AgentModelContent),
    MergeDownstream(String),
    MergeUpstream(String),
}

An enum that represents a single piece of content in a conversation or prompt sent to a model. It distinguishes between system instructions, user input, and agent responses.

Each variant wraps a specific content type ([SystemModelContent], [UserModelContent], [AgentModelContent]), allowing the execution engine to categorize and format different parts of a prompt appropriately for an external model.

Variants

System(SystemModelContent)

Content provided by the system, typically for instructions or context.

User(UserModelContent)

Content provided by the user, representing direct input or queries.

Agent(AgentModelContent)

Content generated by an AI agent or a previous model response.

MergeDownstream(String)

Content to merge to next message as a prefix. This is used internally to handle special merging logic during prompt construction.

MergeUpstream(String)

Content to merge to previous message as a postfix. This is used internally to handle special merging logic during prompt construction.

Implementations

impl ModelContentItem

pub fn user(text: &str) -> Self

Creates a new ModelContentItem::User from a string slice.

Arguments

• text - The text content for the user message.

Returns

A ModelContentItem variant containing the user’s text.

pub fn system(text: &str) -> Self

Creates a new ModelContentItem::System from a string slice.

Arguments

• text - The text content for the system message.

Returns

A ModelContentItem variant containing the system’s text.

pub fn agent(author: Option<String>, text: &str) -> Self

Creates a new ModelContentItem::Agent from a string slice.

Arguments

• author - The author of the agent message.
• text - The text content for the agent’s message.

Returns

A ModelContentItem variant containing the agent’s text.

pub fn merge_downstream(text: &str) -> Self

Creates a new ModelContentItem::MergeDownstream from a string slice.

This variant is used internally to indicate that its content should be prepended to the next non-merge ModelContentItem during prompt construction.

Arguments

• text - The text content to be merged downstream.

Returns

A ModelContentItem::MergeDownstream variant.

pub fn merge_upstream(text: &str) -> Self

Creates a new ModelContentItem::MergeUpstream from a string slice.

This variant is used internally to indicate that its content should be appended to the previous non-merge ModelContentItem during prompt construction.

Arguments

• text - The text content to be merged upstream.

Returns

A ModelContentItem::MergeUpstream variant.

pub fn is_empty(&self) -> bool

Checks if the content of the ModelContentItem is empty or contains only whitespace.

This is useful for filtering out empty messages during prompt construction.

Returns

true if the item’s text content is empty or only whitespace, false otherwise.

Trait Implementations

impl Clone for ModelContentItem

fn clone(&self) -> ModelContentItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelContentItem

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ModelContentItem

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ModelContentItem

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToString for ModelContentItem

fn to_string(&self) -> String

Converts the ModelContentItem into its raw text content.

This implementation of ToString simply returns the underlying text of the content item, without any additional formatting or headers.

Returns

A String containing the raw text content.