refactor: share reaction schemas and notes

docs/providers/discord.md

@@ -33,8 +33,7 @@ Status: ready for DM and guild text channels via the official Discord bot gatewa
     - Full command list + config: [Slash commands](/tools/slash-commands)
 11. Optional guild context history: set `discord.historyLimit` (default 20) to include the last N guild messages as context when replying to a mention. Set `0` to disable.
 12. Reactions: the agent can trigger reactions via the `discord` tool (gated by `discord.actions.*`).
-    - `emoji=""` removes the bot's reaction(s) on the message.
-    - `remove: true` removes the specific emoji reaction.
+    - 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.
 

docs/providers/slack.md

@@ -222,5 +222,5 @@ Slack tool actions can be gated with `slack.actions.*`:
 ## Notes
 - Mention gating is controlled via `slack.channels` (set `requireMention` to `true`); `routing.groupChat.mentionPatterns` also count as mentions.
 - Reaction notifications follow `slack.reactionNotifications` (use `reactionAllowlist` with mode `allowlist`).
-- For the Slack tool, `emoji=""` removes the bot's reaction(s) on the message; `remove: true` removes a specific emoji reaction.
+- For the Slack tool, reaction removal semantics are in [/tools/reactions](/tools/reactions).
 - Attachments are downloaded to the media store when permitted and under the size limit.

docs/providers/telegram.md

@@ -71,8 +71,7 @@ Controlled by `telegram.replyToMode`:
 
 ## Agent tool (reactions)
 - Tool: `telegram` with `react` action (`chatId`, `messageId`, `emoji`).
-- `emoji=""` removes the bot's reaction(s) on the message.
-- `remove: true` removes the reaction (Telegram only supports removing your own reaction).
+- Reaction removal semantics: see [/tools/reactions](/tools/reactions).
 - Tool gating: `telegram.actions.reactions` (default: enabled).
 
 ## Delivery targets (CLI/cron)

docs/providers/whatsapp.md

@@ -97,8 +97,7 @@ WhatsApp requires a real mobile number for verification. VoIP and virtual number
 ## Agent tool (reactions)
 - Tool: `whatsapp` with `react` action (`chatJid`, `messageId`, `emoji`, optional `remove`).
 - Optional: `participant` (group sender), `fromMe` (reacting to your own message), `accountId` (multi-account).
-- `emoji=""` removes the bot's reaction(s) on the message.
-- `remove: true` removes the bot's reaction (same effect as empty emoji).
+- Reaction removal semantics: see [/tools/reactions](/tools/reactions).
 - Tool gating: `whatsapp.actions.reactions` (default: enabled).
 
 ## Outbound send (text + media)

docs/tools/index.md

@@ -201,8 +201,7 @@ Notes:
 - `to` accepts `channel:<id>` or `user:<id>`.
 - Polls require 2–10 answers and default to 24 hours.
 - `reactions` returns per-emoji user lists (limited to 100 per reaction).
-- `emoji=""` on `react` removes the bot's reaction(s) on the message.
-- `remove: true` on `react` removes just that emoji.
+- Reaction removal semantics: see [/tools/reactions](/tools/reactions).
 - `discord.actions.*` gates Discord tool actions; `roles` + `moderation` default to `false`.
 - `searchMessages` follows the Discord preview spec (limit max 25, channel/author filters accept arrays).
 - The tool is only exposed when the current provider is Discord.
@@ -214,8 +213,7 @@ Core actions:
 - `react` (`chatJid`, `messageId`, `emoji`, optional `remove`, `participant`, `fromMe`, `accountId`)
 
 Notes:
-- `emoji=""` removes the bot's reaction(s) on the message.
-- `remove: true` removes the bot's reaction (same effect as empty emoji).
+- Reaction removal semantics: see [/tools/reactions](/tools/reactions).
 - `whatsapp.actions.*` gates WhatsApp tool actions.
 - The tool is only exposed when the current provider is WhatsApp.
 
@@ -226,8 +224,7 @@ Core actions:
 - `react` (`chatId`, `messageId`, `emoji`, optional `remove`)
 
 Notes:
-- `emoji=""` removes the bot's reaction(s) on the message.
-- `remove: true` removes the reaction (Telegram only supports removing your own reaction).
+- Reaction removal semantics: see [/tools/reactions](/tools/reactions).
 - `telegram.actions.*` gates Telegram tool actions.
 - The tool is only exposed when the current provider is Telegram.
 

docs/tools/reactions.md

@@ -0,0 +1,13 @@
+# Reaction tooling
+
+Shared reaction semantics across providers:
+
+- `emoji` is required for reactions.
+- `emoji=""` removes the bot's reaction(s) on the message.
+- `remove: true` removes the specified emoji when supported.
+
+Provider notes:
+
+- **Discord/Slack**: empty `emoji` removes all of the bot's reactions on the message; `remove: true` removes just that emoji.
+- **Telegram**: `remove: true` removes your own reaction (Bot API limitation).
+- **WhatsApp**: `remove: true` maps to empty emoji (remove bot reaction).