From 473f7df6583cd58cec857287862bc357581f31bd Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sun, 11 Jan 2026 02:31:45 +0000
Subject: [PATCH] docs: fix provider session key examples

---
 docs/providers/discord.md  | 2 +-
 docs/providers/imessage.md | 2 +-
 docs/providers/msteams.md  | 9 +++++----
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/providers/discord.md b/docs/providers/discord.md
index a3778f85e..dbd0c2608 100644
--- a/docs/providers/discord.md
+++ b/docs/providers/discord.md
@@ -53,7 +53,7 @@ Minimal config:
 12. Reactions: the agent can trigger reactions via the `discord` tool (gated by `discord.actions.*`).
     - Reaction removal semantics: see [/tools/reactions](/tools/reactions).
     - The `discord` tool is only exposed when the current provider is Discord.
-13. Native commands use isolated session keys (`discord:slash:${userId}`) rather than the shared `main` session.
+13. Native commands use isolated session keys (`agent:<agentId>:discord:slash:<userId>`) rather than the shared `main` session.
 
 Note: Discord does not provide a simple username → id lookup without extra guild context, so prefer ids or `<@id>` mentions for DM delivery targets.
 Note: Slugs are lowercase with spaces replaced by `-`. Channel names are slugged without the leading `#`.
diff --git a/docs/providers/imessage.md b/docs/providers/imessage.md
index c22cdfd65..b93698821 100644
--- a/docs/providers/imessage.md
+++ b/docs/providers/imessage.md
@@ -122,7 +122,7 @@ Groups:
 Some iMessage threads can have multiple participants but still arrive with `is_group=false` depending on how Messages stores the chat identifier.
 
 If you explicitly configure a `chat_id` under `imessage.groups`, Clawdbot treats that thread as a “group” for:
-- session isolation (separate `imessage:group:<chat_id>` session key)
+- session isolation (separate `agent:<agentId>:imessage:group:<chat_id>` session key)
 - group allowlisting / mention gating behavior
 
 Example:
diff --git a/docs/providers/msteams.md b/docs/providers/msteams.md
index f46f3f5e3..0ff8be17f 100644
--- a/docs/providers/msteams.md
+++ b/docs/providers/msteams.md
@@ -332,10 +332,11 @@ Key settings (see `/gateway/configuration` for shared provider patterns):
 - `msteams.teams.<teamId>.channels.<conversationId>.requireMention`: per-channel override.
 
 ## Routing & Sessions
-- Direct messages use session key: `msteams:<userId>` (shared main session).
-- Channel/group messages use session keys based on conversation id:
-  - `msteams:channel:<conversationId>`
-  - `msteams:group:<conversationId>`
+- Session keys follow the standard agent format (see [/concepts/session](/concepts/session)):
+  - Direct messages: `agent:<agentId>:msteams:dm:<userId>` (shared main session).
+  - Channel/group messages use conversation id:
+    - `agent:<agentId>:msteams:channel:<conversationId>`
+    - `agent:<agentId>:msteams:group:<conversationId>`
 
 ## Reply Style: Threads vs Posts