Enum Message 

pub enum Message {
    System {
        content: Vec<ContentBlock>,
    },
    User {
        content: Vec<ContentBlock>,
    },
    Assistant {
        content: Vec<ContentBlock>,
    },
    ToolResult {
        tool_call_id: String,
        is_error: bool,
        content: Vec<ContentBlock>,
    },
}

对话中的单条消息。

Variants

System

Fields

content: Vec<ContentBlock>

User

Fields

content: Vec<ContentBlock>

Assistant

Fields

content: Vec<ContentBlock>

ToolResult

Fields

tool_call_id: String

is_error: bool

工具执行是否失败（供 Provider API 映射，如 Anthropic is_error: true）

content: Vec<ContentBlock>

Implementations

impl Message

pub fn system_text(s: &str) -> Self

便捷构造：纯文本 System 消息。

use lellm_core::Message;

// 之前：
// Message::System { content: lellm_core::text_block("you are helpful".to_string()) }

// 现在：
let msg = Message::system_text("you are helpful");

pub fn user_text(s: &str) -> Self

便捷构造：纯文本 User 消息。

use lellm_core::Message;

let msg = Message::user_text("hello");

pub fn assistant_text(s: &str) -> Self

便捷构造：纯文本 Assistant 消息。

pub fn user_text_image(text: &str, media_type: String, data: String) -> Self

便捷构造：带图片的 User 消息（文本 + 图片）。

use lellm_core::Message;

let msg = Message::user_text_image(
    "what's in this image?",
    "image/png".to_string(),
    "base64_encoded_data".to_string(),
);

pub fn user_image(media_type: String, data: String) -> Self

便捷构造：仅图片的 User 消息。

pub fn system(content: Vec<ContentBlock>) -> Self

便捷构造：System 消息（自定义 ContentBlock）。

pub fn user(content: Vec<ContentBlock>) -> Self

便捷构造：User 消息（自定义 ContentBlock）。

pub fn assistant(content: Vec<ContentBlock>) -> Self

便捷构造：Assistant 消息（自定义 ContentBlock）。

pub fn tool_result_ok(call_id: impl Into<String>, content: String) -> Self

便捷构造：ToolResult 消息（成功）。

pub fn tool_error(call_id: impl Into<String>, error: String) -> Self

便捷构造：ToolResult 消息（失败）。

pub fn content(&self) -> &Vec<ContentBlock>

返回内容块的引用（用于 provider 适配器序列化）

pub fn tool_call_id(&self) -> String

返回 ToolResult 的 tool_call_id（仅 ToolResult 变体有效，其他返回 None）

pub fn is_tool_error(&self) -> bool

返回 ToolResult 的 is_error 标记（仅 ToolResult 变体有效）

pub fn tool_result(call: &ToolCall, result: &ToolResult) -> Self

从工具调用结果构建 Message::ToolResult

成功 → 序列化 serde_json::Value 为文本，is_error: false 失败 → "tool error: {e}" 文本 content，is_error: true

pub fn validate(&self) -> Result<(), ParseError>

语义校验 — 检查 Message 变体与 ContentBlock 的合法性。

v0.1 核心规则：

1. ToolResult 禁止包含 ToolCall 或 Thinking
2. ToolResult.tool_call_id 非空
3. Assistant 中的 ToolCall.id 非空
4. User 禁止包含 Thinking

pub fn extract_tool_calls(&self) -> Vec<ToolCall>

提取所有 ToolCall（仅 Assistant 消息包含）

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.