Struct ChatMessage 

pub struct ChatMessage {
    pub role: MessageRole,
    pub content: String,
    pub tool_calls: Option<Vec<ToolCallItem>>,
    pub tool_call_id: Option<String>,
    pub images: Option<Vec<ImageData>>,
    pub reasoning_content: Option<String>,
    pub sender_name: Option<String>,
    pub recipient_name: Option<String>,
    pub display_hint: DisplayHint,
}

对话消息

Fields

role: MessageRole

content: String

消息内容（tool_call 类消息可为空）

tool_calls: Option<Vec<ToolCallItem>>

LLM 发起的工具调用列表（仅 assistant 角色且有 tool_calls 时非 None）

tool_call_id: Option<String>

工具执行结果对应的 tool_call_id（仅 tool 角色时非 None）

images: Option<Vec<ImageData>>

图片数据（用于多模态 user message，不持久化到 session 文件）

reasoning_content: Option<String>

LLM 思考内容（thinking mode 返回的 reasoning_content，需传回下一轮请求）

sender_name: Option<String>

消息发送者名称（如 Teammate@Frontend、SubAgent@search）。 仅由 teammate/subagent 消息设置；主 agent 消息为 None。 不持久化到 session 文件，仅用于运行时 UI 渲染。

recipient_name: Option<String>

消息目标接收者名称（如 Counter2、Main）。 仅当消息有明确 @目标时设置；广播给所有人时为 None。 不持久化到 session 文件，仅用于运行时 UI 渲染。

display_hint: DisplayHint

显示提示（运行时 UI 渲染层专用，不持久化）。 Draft 表示 teammate 内部思考，用户可见但其他 agent 不可见。

Implementations

impl ChatMessage

pub fn text(role: MessageRole, content: impl Into<String>) -> Self

创建普通文本消息

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

设置消息发送者名称（Builder 模式）。

用于 teammate/subagent 消息标记发送者，UI 渲染层据此显示气泡标签。

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

设置消息目标接收者名称（Builder 模式）。

仅当消息有明确 @目标时设置，UI 渲染层据此显示 → Target 标识。

pub fn with_display_hint(self, hint: DisplayHint) -> Self

设置显示提示（Builder 模式）。

pub fn display_type(&self) -> DisplayType

推断显示类型（渲染层入口）

将 role + tool_calls 组合映射为精确的 DisplayType， 渲染层无需再做 role == "assistant" && tool_calls.is_some() 的判断。

Trait Implementations

impl Clone for ChatMessage

fn clone(&self) -> ChatMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChatMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChatMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ChatMessage

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

where __S: Serializer,

Serialize this value into the given Serde serializer.