diff --git a/packages/ui/tui/src/components/xml-tool-output.ts b/packages/ui/tui/src/components/xml-tool-output.ts
index 3e88120f7d..24beb58c31 100644
--- a/packages/ui/tui/src/components/xml-tool-output.ts
+++ b/packages/ui/tui/src/components/xml-tool-output.ts
@@ -1,4 +1,8 @@
-/** Conservative readable-tree rendering for model-facing text containing one XML document. */
+/**
+ * Conservative readable-tree rendering for model-facing text containing one XML
+ * document, used by the transcript's tool and context cards.
+ * @module @deepseek-ai/dsh-tui/components/xml-tool-output
+ */
 
 import { SaxesParser } from 'saxes'