Struct HistoryEntry 

pub struct HistoryEntry {
    pub agent: String,
    pub sender: String,
    pub auto_injected: bool,
    pub message: Message,
}

A single conversation history entry.

The inner message is the wire-level shape sent to providers. The runtime-only fields are stripped from the wire but persisted to the session Storage for reload (except sender and auto_injected, which are session-local state that resets on reload).

Fields

agent: String

Which agent produced this assistant message. Empty = the conversation’s primary agent. Non-empty = a guest agent pulled in via an @ mention or guest turn. Persisted so reloads can reconstruct multi-agent state.

sender: String

The sender identity (runtime-only, never serialized).

auto_injected: bool

Whether this entry was auto-injected by the runtime (runtime-only). Auto-injected entries are stripped before each new run and never persisted as session steps.

message: Message

The wire-level message sent to providers.

Implementations

impl HistoryEntry

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

Create a new system entry.

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

Create a new user entry.

pub fn user_with_sender( content: impl Into<String>, sender: impl Into<String>, ) -> Self

Create a new user entry with sender identity.

pub fn assistant( content: impl Into<String>, reasoning: Option<String>, tool_calls: Option<&[ToolCall]>, ) -> Self

Create a new assistant entry.

Preserves the content: null vs empty-string discrimination:

• assistant + non-empty tool_calls + empty content → "content": null
• assistant + empty tool_calls + empty content → "content": ""
• anything else → "content": "<the text>"

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

Create a new tool-result entry.

pub fn from_message(message: Message) -> Self

Wrap an existing crabllm_core::Message.

pub fn auto_injected(self) -> Self

Mark this entry as auto-injected (chainable).

pub fn role(&self) -> &Role

The role of the underlying message.

pub fn text(&self) -> &str

The text content of the message, or "" if absent / empty / non-string.

pub fn reasoning(&self) -> &str

The reasoning content, or empty if absent.

pub fn tool_calls(&self) -> &[ToolCall]

The tool calls on this entry, or an empty slice if absent.

pub fn tool_call_id(&self) -> &str

The tool call ID on this (tool) entry, or empty if absent.

pub fn estimate_tokens(&self) -> usize

Estimate the number of tokens in this entry (~4 chars per token).

pub fn to_wire_message(&self) -> Message

Project to a crabllm_core::Message for sending to a provider.

If this is a guest assistant message (agent non-empty and role is Assistant), wraps the content in <from agent="..."> tags so other agents can distinguish speakers in multi-agent conversations.

Trait Implementations

impl Clone for HistoryEntry

fn clone(&self) -> HistoryEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HistoryEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HistoryEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HistoryEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.