diff --git a/packages/core/src/session/compaction.ts b/packages/core/src/session/compaction.ts
index 57cdbb2c2b..da7b71ef40 100644
--- a/packages/core/src/session/compaction.ts
+++ b/packages/core/src/session/compaction.ts
@@ -86,6 +86,7 @@ const textContext = (request: LLMRequest) => ({
   system: request.system,
   // TODO: Replace blanket attachment exclusion with model-aware media and file token accounting.
   messages: request.messages
+    // Text attachments are lowered into dedicated marked messages; the original prompt is emitted separately.
     .filter((message) => message.metadata?.attachment === undefined)
     .map((message) => ({
       id: message.id,