From dcf1658e72e9b273d0bc54943d625f4a5cd9fccb Mon Sep 17 00:00:00 2001
From: DrMelone <27028174+Classic298@users.noreply.github.com>
Date: Sun, 11 Jan 2026 14:51:03 +0100
Subject: [PATCH] Update reserved-args.mdx

---
 docs/features/plugin/development/reserved-args.mdx | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/docs/features/plugin/development/reserved-args.mdx b/docs/features/plugin/development/reserved-args.mdx
index 738e774c..8b36d2f6 100644
--- a/docs/features/plugin/development/reserved-args.mdx
+++ b/docs/features/plugin/development/reserved-args.mdx
@@ -215,9 +215,15 @@ See the `body["messages"]` value above.
 
 ### `__chat_id__`
 
-The `str` of the `chat_id`.
+The `str` of the `chat_id`, representing the unique identifier of the current chat/conversation.
 
-See the `__metadata__["chat_id"]` value above.
+This parameter is reliably passed for all function invocations that originate from a chat context, including:
+- Regular user messages
+- Internal task calls (title generation, query generation, tag generation, etc.)
+
+This allows stateful functions/pipes/manifolds to maintain per-chat state without fragmentation.
+
+See also `__metadata__["chat_id"]` for accessing the same value via the metadata dict.
 
 ### `__session_id__`