From bc75a6198298560d2ab533c8b3f5404c40536bcc Mon Sep 17 00:00:00 2001
From: Yongrui Lin <yongrlin@outlook.com>
Date: Tue, 10 Mar 2026 12:29:18 -0700
Subject: [PATCH] docs(cli): mention per-model token usage in stream-json
 result event (#21908)

---
 docs/cli/headless.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/cli/headless.md b/docs/cli/headless.md
index dd9a385313..c83ce70d0e 100644
--- a/docs/cli/headless.md
+++ b/docs/cli/headless.md
@@ -31,7 +31,8 @@ Returns a stream of newline-delimited JSON (JSONL) events.
   - `tool_use`: Tool call requests with arguments.
   - `tool_result`: Output from executed tools.
   - `error`: Non-fatal warnings and system errors.
-  - `result`: Final outcome with aggregated statistics.
+  - `result`: Final outcome with aggregated statistics and per-model token usage
+    breakdowns.
 
 ## Exit codes