From 16604d59ca00a2dc59b4a057cbc6244bb590907d Mon Sep 17 00:00:00 2001
From: George Drury <1198104+georgedrury@users.noreply.github.com>
Date: Mon, 13 Jul 2026 09:41:53 +0100
Subject: [PATCH] docs(gateway): document typing_status_text on the Google Chat
 page

Mirrors the Slack docs, per review; notes the marker is a real posted
message (edited in place), unlike Slack's ephemeral status.
---
 .../docs/user-guide/messaging/google_chat.md    | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/website/docs/user-guide/messaging/google_chat.md b/website/docs/user-guide/messaging/google_chat.md
index eeeb69c6c9dc..70fe328b19e9 100644
--- a/website/docs/user-guide/messaging/google_chat.md
+++ b/website/docs/user-guide/messaging/google_chat.md
@@ -189,6 +189,23 @@ Send "hola" in the test DM. The bot posts a "Hermes is thinking…" marker, then
 edits that same message in place with the real response — no "message deleted"
 tombstones.
 
+### Customizing the working-state marker
+
+The marker text is configurable via `typing_status_text` in
+`~/.hermes/config.yaml` — e.g. a kitten assistant named Ada:
+
+```yaml
+platforms:
+  google_chat:
+    # Custom working-state marker text (default: "Hermes is thinking…").
+    typing_status_text: "is pouncing… 🐾"
+```
+
+Unlike Slack's ephemeral status line, this is a **real posted message** that
+gets edited in place with the response — so whatever you set here briefly
+appears in the chat as a normal message. Set `typing_indicator: false` to
+disable the marker entirely.
+
 ---
 
 ## Formatting and capabilities