From ccd5b7e27947e9699f57a4bb9569b81077e1451e Mon Sep 17 00:00:00 2001
From: Eric Traut <etraut@openai.com>
Date: Sun, 12 Apr 2026 13:56:36 -0700
Subject: [PATCH] codex: document injected message event payload

---
 codex-rs/protocol/src/protocol.rs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/codex-rs/protocol/src/protocol.rs b/codex-rs/protocol/src/protocol.rs
index 75569ee353..f8dac0fe02 100644
--- a/codex-rs/protocol/src/protocol.rs
+++ b/codex-rs/protocol/src/protocol.rs
@@ -2286,9 +2286,16 @@ pub struct UserMessageEvent {
     pub text_elements: Vec<crate::user_input::TextElement>,
 }
 
+/// Display-only event for a timer-fired or external queued message.
+///
+/// The corresponding model-visible XML is recorded separately as a raw response
+/// item. Clients should render this event's content instead of parsing or
+/// hiding that XML themselves.
 #[derive(Debug, Clone, Deserialize, Serialize, JsonSchema, TS, PartialEq, Eq)]
 pub struct InjectedMessageEvent {
+    /// Human-facing message text to show in transcript views.
     pub content: String,
+    /// Origin label for the injected input, such as "external" or "timer <id>".
     pub source: String,
 }