Struct Message 

pub struct Message {
    pub id: Uuid,
    pub from_palace: String,
    pub to_palace: String,
    pub purpose: String,
    pub sent_at: DateTime<Utc>,
    pub read: bool,
    pub content: String,
}

Decoded view of a message drawer.

Why: inbox-check and the HTTP GET /api/v1/messages endpoint both want a typed view of every message field, not the raw Vec<String> of tags. What: Owned strings plus the drawer id and content, populated by Message::from_drawer. Test: decode_message_from_drawer_round_trips.

Fields

id: Uuid

from_palace: String

to_palace: String

purpose: String

sent_at: DateTime<Utc>

read: bool

content: String

Implementations

impl Message

pub fn from_drawer(drawer: &Drawer) -> Option<Self>

Decode a drawer that carries the message tag namespace.

Why: drawers are stored verbatim and the message envelope lives in tags; centralising the parse keeps the inbox handler clean and surfaces any malformed-tag failures with a uniform error. What: returns Some(Message) when the drawer carries the MSG_MARKER_TAG and every required field is present and parseable; returns None (with a debug log) on any missing-field or parse error so a single corrupt drawer can’t poison the whole inbox. Unknown read values default to false — better to re-deliver a message than to silently swallow it. Test: decode_message_from_drawer_round_trips, decode_skips_non_message_drawer.

pub fn to_injection_block(&self) -> String

Format the message as the Markdown block the SessionStart hook injects via stdout.

Why: Claude Code’s SessionStart hook ingests stdout verbatim, so the receiver needs a self-contained, model-readable block per message (who, why, when, and the body) rather than raw JSON. What: returns a multi-line ## Message from <from> heading plus a purpose/sent-at metadata line and the body. The caller concatenates multiple messages with a blank line between them; the receiver agent then reads them in order. Test: formatted_message_includes_from_purpose_and_body.

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.