Struct ChatMessage 

pub struct ChatMessage {
    pub role: MessageRole,
    pub content: String,
    pub streaming: bool,
    pub tool_name: Option<ToolName>,
    pub diff_data: Option<DiffData>,
    pub filter_stats: Option<String>,
    pub kept_lines: Option<Vec<usize>>,
    pub timestamp: String,
    pub paste_line_count: Option<usize>,
}

A single entry in the TUI chat history buffer.

Carries the rendered text, role metadata, optional tool context, an inline diff, and a wall-clock timestamp for display.

Examples

use zeph_tui::{ChatMessage, MessageRole};

let msg = ChatMessage::new(MessageRole::User, "Hello, agent!");
assert_eq!(msg.role, MessageRole::User);
assert_eq!(msg.content, "Hello, agent!");
assert!(!msg.streaming);

Fields

role: MessageRole

Role that determines rendering style.

content: String

Rendered text content of the message.

streaming: bool

true while the message is still being streamed from the LLM.

tool_name: Option<ToolName>

Name of the tool that produced this message, if any.

diff_data: Option<DiffData>

Inline diff attached to a tool-output message.

filter_stats: Option<String>

Human-readable filter statistics (e.g. “kept 12/40 lines”).

kept_lines: Option<Vec<usize>>

0-based line indices preserved by the output filter, used for highlighting in the diff widget.

timestamp: String

Wall-clock time formatted as HH:MM when the message was created.

paste_line_count: Option<usize>

Number of lines in the pasted content when this message was submitted from a paste. Some(n) (n >= 2) enables collapsible display in the chat renderer; None means normal display.

Implementations

impl ChatMessage

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

Create a new non-streaming message with the current local time as timestamp.

Examples

use zeph_tui::{ChatMessage, MessageRole};

let msg = ChatMessage::new(MessageRole::Assistant, "Done.");
assert_eq!(msg.role, MessageRole::Assistant);
assert!(!msg.streaming);

pub fn streaming(self) -> Self

Mark this message as actively streaming.

The chat widget renders a blinking cursor after the content while streaming is true.

Examples

use zeph_tui::{ChatMessage, MessageRole};

let msg = ChatMessage::new(MessageRole::Assistant, "").streaming();
assert!(msg.streaming);

pub fn with_tool(self, name: ToolName) -> Self

Attach a tool name to this message for display in the chat header.

Examples

use zeph_tui::{ChatMessage, MessageRole};

let msg = ChatMessage::new(MessageRole::Tool, "output")
    .with_tool(zeph_common::ToolName::new("bash"));
assert!(msg.tool_name.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.