From 875d2279cbc4c171b2d93574a41b964071b91069 Mon Sep 17 00:00:00 2001
From: Charles Cunningham <ccunningham@openai.com>
Date: Tue, 3 Mar 2026 15:27:18 -0800
Subject: [PATCH] core: clarify leftover pending input lifecycle

---
 codex-rs/core/src/tasks/mod.rs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/codex-rs/core/src/tasks/mod.rs b/codex-rs/core/src/tasks/mod.rs
index 8d95b1c9e5..5133dc1e27 100644
--- a/codex-rs/core/src/tasks/mod.rs
+++ b/codex-rs/core/src/tasks/mod.rs
@@ -217,6 +217,9 @@ impl Session {
                 .collect::<Vec<_>>();
             for response_item in pending_response_items {
                 if let Some(TurnItem::UserMessage(user_message)) = parse_turn_item(&response_item) {
+                    // Keep leftover user input on the same persistence + lifecycle path as the
+                    // normal pre-sampling drain. This helper records the response item once, then
+                    // emits ItemStarted/UserMessage and ItemCompleted/UserMessage for clients.
                     self.record_user_prompt_and_emit_turn_item(
                         turn_context.as_ref(),
                         &user_message.content,