diff --git a/codex-rs/tui/src/tui/focus_sequence.rs b/codex-rs/tui/src/tui/focus_sequence.rs
index 011f5bac7b..f9684b206f 100644
--- a/codex-rs/tui/src/tui/focus_sequence.rs
+++ b/codex-rs/tui/src/tui/focus_sequence.rs
@@ -19,6 +19,7 @@ pub(super) enum FocusSequenceState {
     EscBracket(KeyEvent, KeyEvent),
 }
 
+/// Coalesces split focus change escape sequences so they cannot masquerade as key input.
 #[derive(Debug)]
 pub(super) struct FocusSequenceBuffer {
     state: FocusSequenceState,