Struct Message 

pub struct Message {
    pub id: String,
    pub role: Role,
    pub content: String,
    pub timestamp: i64,
    pub tool_calls: Vec<ToolCall>,
    pub tool_result: Option<ToolResult>,
    pub token_count: Option<u32>,
    pub pinned: bool,
}

A single message in the conversation.

Fields

id: String

Stable identifier for the message (used to address pins and tool results).

role: Role

Who produced the message.

content: String

The message text.

timestamp: i64

Creation time as a Unix timestamp in milliseconds.

tool_calls: Vec<ToolCall>

Tool calls made by the assistant (only when role = Assistant).

tool_result: Option<ToolResult>

Tool execution result (only when role = ToolResult).

token_count: Option<u32>

Token count for this message (populated after tokenization).

pinned: bool

Whether this message is pinned. Pinned messages always survive context pruning, regardless of the token budget or prune strategy.

Implementations

impl Message

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

Build a system message.

use orion_core::Message;
let sys = Message::system("msg-1", "You are helpful.");
assert_eq!(sys.content, "You are helpful.");

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

Build a user message.

pub fn assistant(id: impl Into<String>, content: impl Into<String>) -> Self

Build an assistant message.

pub fn tool_result( id: impl Into<String>, tool_call_id: impl Into<String>, tool_name: impl Into<String>, content: impl Into<String>, is_error: bool, ) -> Self

Build a tool-result message, linking it back to the assistant’s ToolCall via tool_call_id.

use orion_core::Message;
let result = Message::tool_result(
    "msg-4",            // message id
    "call-1",           // tool_call_id (links to the assistant's request)
    "read_file",        // tool name
    "file contents...", // result content
    false,              // is_error
);
assert!(result.tool_result.is_some());

pub fn pinned(self) -> Self

Mark this message as pinned (survives context pruning). Builder-style.

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.