Enum Message

pub enum Message {
    System {
        content: String,
        metadata: HashMap<String, Value>,
    },
    User {
        content: Content,
        name: Option<String>,
        metadata: HashMap<String, Value>,
    },
    Assistant {
        content: Option<Content>,
        tool_calls: Vec<ToolCall>,
        metadata: HashMap<String, Value>,
    },
    Tool {
        tool_call_id: String,
        content: String,
        metadata: HashMap<String, Value>,
    },
}

Represents a message in a conversation

Variants

System

Message from the system (instructions)

Fields

content: String

The content of the system message

metadata: HashMap<String, Value>

Additional provider-specific metadata

User

Message from the user

Fields

content: Content

The content of the user message

name: Option<String>

The name of the user (optional)

metadata: HashMap<String, Value>

Additional provider-specific metadata

Assistant

Message from the assistant

Fields

content: Option<Content>

The content of the assistant message

tool_calls: Vec<ToolCall>

The tool calls made by the assistant

metadata: HashMap<String, Value>

Additional provider-specific metadata

Tool

Message from a tool

Fields

tool_call_id: String

The ID of the tool call this message is responding to

content: String

The content of the tool response

metadata: HashMap<String, Value>

Additional provider-specific metadata

Implementations

impl Message

pub fn system(content: impl Into<String>) -> Self

Creates a new system message

Examples

use language_barrier_core::message::Message;

let msg = Message::system("You are a helpful assistant.");

pub fn user(content: impl Into<String>) -> Self

Creates a new user message

Examples

use language_barrier_core::message::Message;

let msg = Message::user("Hello, can you help me?");

pub fn user_with_name( name: impl Into<String>, content: impl Into<String>, ) -> Self

Creates a new user message with a name

Examples

use language_barrier_core::message::Message;

let msg = Message::user_with_name("John", "Hello, can you help me?");

pub fn user_with_parts(parts: Vec<ContentPart>) -> Self

Creates a new user message with multimodal content

Examples

use language_barrier_core::message::{Message, Content, ContentPart};

let parts = vec![
    ContentPart::text("Look at this image:"),
    ContentPart::image_url("https://example.com/image.jpg"),
];
let msg = Message::user_with_parts(parts);

pub fn assistant(content: impl Into<String>) -> Self

Creates a new assistant message

Examples

use language_barrier_core::message::Message;

let msg = Message::assistant("I'm here to help you.");

pub fn assistant_with_tool_calls(tool_calls: Vec<ToolCall>) -> Self

Creates a new assistant message with tool calls

Examples

use language_barrier_core::message::{Message, ToolCall, Function};

let tool_call = ToolCall {
    id: "call_123".to_string(),
    tool_type: "function".to_string(),
    function: Function {
        name: "get_weather".to_string(),
        arguments: "{\"location\":\"San Francisco\"}".to_string(),
    },
};
let msg = Message::assistant_with_tool_calls(vec![tool_call]);

pub fn tool(tool_call_id: impl Into<String>, content: impl Into<String>) -> Self

Creates a new tool message

Examples

use language_barrier_core::message::Message;

let msg = Message::tool("tool123", "The result is 42.");

pub fn tool_from_call(tool_call: &ToolCall, content: impl Into<String>) -> Self

Creates a new tool message from the tool call that originated it.

pub fn role_str(&self) -> &'static str

Returns the role of the message as a string

Examples

use language_barrier_core::message::Message;

let msg = Message::user("Hello");
assert_eq!(msg.role_str(), "user");

pub fn with_metadata(self, key: impl Into<String>, value: Value) -> Self

Adds metadata and returns a new message

Examples

use language_barrier_core::message::Message;
use serde_json::json;

let msg = Message::user("Hello")
    .with_metadata("priority", json!(5));

Trait Implementations

impl Clone for Message

fn clone(&self) -> Message

Returns a copy 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 PartialEq for Message

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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.

impl StructuralPartialEq for Message