Struct Message 

pub struct Message {
    pub role: Role,
    pub content: MessageContent,
}

Fields

role: Role

content: MessageContent

Implementations

impl Message

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

pub fn text(&self) -> Option<&str>

pub fn estimate_tokens(&self) -> usize

Rough token estimate: bytes / 4 with a per-message overhead.

Note on accuracy: this is a coarse approximation regardless of language. For OpenAI-style BPE tokenizers it tracks reality within ~30% on mixed English+CJK code/prose. We deliberately keep the formula simple and per-content-type aware (tool args expanded, ToolResultRef counted by what’s actually sent on the wire) — small refinements to the divisor are dwarfed by tokenizer differences across providers, so anything short of a real tokenizer would be false precision.

pub fn condensed(&self, tool_name: &str) -> Message

Create a condensed version of this message for context budget savings. Only condenses ToolResult messages (replaces full output with 1-line summary). tool_name is looked up by the caller via the paired ATC (see e.g. ctx::truncate::post_process_tool_results) — pass "" when unknown and this function will default to the generic first-line summary. ToolResultRef and other variants return as-is.

For tool_name == "read_file", emits a skeleton that keeps function signatures + line numbers so the model can still use line-number edit mode without re-reading. Previously this decision used a substring heuristic on the output format, which false-positived on bash outputs that happened to start with " N| ..." lines.

pub fn is_tool_result(&self) -> bool

Returns true if this message is a tool result (either inline or ref).

pub fn tool_result_call_id(&self) -> Option<&str>

Extract call_id from tool result variants.

pub fn tool_result_success(&self) -> Option<bool>

Extract success status from tool result variants.

pub fn tool_result_output(&self) -> Option<&str>

Extract the output text from tool result variants (summary for refs).

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.