snav
d863773c81
feat(discord): add thread_require_mention for multi-bot threads
...
By default, once Hermes participates in a Discord thread (auto-created on
@mention or replied in once) it auto-responds to every subsequent message
in that thread without requiring further @mentions. That's the right default
for one-on-one conversations and isolated channel threads.
But it's a confirmed footgun in multi-bot threads. When a user invokes one
bot per turn — addressing Codex first, then Hermes — every other bot in the
thread also fires on every message, burning credits and spamming the channel.
Author has hit this personally in active multi-bot research-team threads.
Add a new `discord.thread_require_mention` config key (env:
`DISCORD_THREAD_REQUIRE_MENTION`), default `false` to preserve existing
behavior. When `true`, the in-thread mention shortcut is disabled and
threads are gated the same way channels are. Explicit @mentions still pass
through as expected.
Mirrors the existing helper shape (config.extra > env > default) and the
existing yaml→env bridge pattern used by `require_mention`.
Changes:
- gateway/platforms/discord.py: new `_discord_thread_require_mention()`
helper; in_bot_thread shortcut now AND's with `not _discord_thread_require_mention()`
- gateway/config.py: bridge `discord.thread_require_mention` from config.yaml
to `DISCORD_THREAD_REQUIRE_MENTION` env var (mirrors the existing
`require_mention` bridge two lines above)
- hermes_cli/config.py: add `thread_require_mention: False` default to
DEFAULT_CONFIG['discord']
- tests/gateway/test_discord_free_response.py: 4 new tests covering default
behaviour (in-thread shortcut still works), enabled behaviour (mention
required in threads), enabled+mentioned (mention still passes through),
and yaml-via-config.extra path. Also clears DISCORD_* env vars in the
`adapter` fixture so process-env state from the contributor's shell
doesn't leak into per-test behaviour.
- tests/gateway/test_config.py: 2 new tests covering the yaml→env bridge
(both the apply-from-yaml and env-precedence-over-yaml paths)
- website/docs/user-guide/messaging/discord.md: document the new env var
+ config key with multi-bot rationale; cross-link from `auto_thread`
section
Tested on Ubuntu 24.04.
2026-05-13 22:21:43 -07:00
..
2026-02-26 03:20:08 +03:00
2026-04-30 01:19:34 -07:00
2026-04-30 01:19:34 -07:00
2026-04-30 20:30:31 -07:00
2026-05-07 05:16:38 -07:00
2026-04-30 04:32:33 -07:00
2026-05-08 14:55:40 -07:00
2026-05-09 11:54:04 -07:00
2026-03-29 21:29:13 -07:00
2026-04-10 16:51:44 -07:00
2026-04-21 00:50:58 -07:00
2026-04-20 04:16:13 -07:00
2026-04-12 18:03:16 -07:00
2026-05-08 14:55:40 -07:00
2026-04-07 03:28:44 -07:00
2026-05-12 15:04:54 -07:00
2026-04-30 19:46:27 -07:00
2026-04-24 05:35:43 -07:00
2026-04-14 16:56:49 -07:00
2026-05-09 01:39:37 -07:00
2026-05-07 05:16:38 -07:00
2026-05-09 13:38:25 -07:00
2026-04-24 16:04:37 -07:00
2026-04-26 18:21:29 -07:00
2026-04-30 04:29:15 -07:00
2026-04-19 01:48:42 -07:00
2026-04-26 12:29:02 -07:00
2026-05-03 03:54:03 -07:00
2026-04-24 03:10:52 -07:00
2026-04-23 19:38:33 -05:00
2026-04-30 23:03:54 -07:00
2026-04-24 02:55:43 -07:00
2026-04-24 02:55:43 -07:00
2026-04-29 07:22:33 -07:00
2026-05-02 02:08:06 -07:00
2026-05-13 22:21:43 -07:00
2026-04-22 11:59:39 -07:00
2026-05-01 14:01:26 -07:00
2026-05-09 11:04:46 -07:00
2026-05-09 11:11:10 -07:00
2026-04-24 03:04:42 -07:00
2026-04-17 04:08:42 -07:00
2026-04-17 04:59:03 -07:00
2026-04-17 05:48:26 -07:00
2026-03-09 02:20:57 -07:00
2026-04-09 23:25:27 -07:00
2026-04-19 18:12:55 -07:00
2026-04-10 05:19:26 -07:00
2026-05-03 03:44:55 -07:00
2026-05-06 18:12:35 -07:00
2026-05-04 12:36:47 -07:00
2026-05-13 22:21:43 -07:00
2026-03-14 09:32:05 -07:00
2026-03-13 08:52:54 -07:00
2026-04-24 03:33:29 -07:00
2026-03-14 14:27:21 +03:00
2026-04-19 11:08:10 -07:00
2026-04-10 03:52:00 -07:00
2026-05-05 04:58:23 -07:00
2026-05-07 05:51:56 -07:00
2026-05-10 22:41:26 -07:00
2026-05-07 05:51:56 -07:00
2026-05-03 03:44:55 -07:00
2026-03-23 06:50:09 -07:00
2026-05-05 10:13:55 -07:00
2026-05-10 22:22:25 -07:00
2026-05-10 18:09:31 -07:00
2026-04-03 13:16:26 -07:00
2026-04-30 03:27:08 -07:00
2026-05-09 13:35:50 -07:00
2026-04-30 23:05:48 -07:00
2026-03-17 01:47:34 -07:00
2026-04-10 21:16:56 -07:00
2026-04-28 06:57:23 -07:00
2026-05-09 02:32:55 -07:00
2026-04-30 20:30:31 -07:00
2026-04-30 20:30:31 -07:00
2026-04-17 19:04:11 -07:00
2026-04-17 19:04:11 -07:00
2026-05-07 05:09:39 -07:00
2026-05-06 10:52:51 -07:00
2026-04-30 20:29:19 -07:00
2026-05-03 17:00:09 -07:00
2026-04-08 20:01:06 -07:00
2026-04-27 07:41:42 -07:00
2026-05-07 06:31:08 -07:00
2026-05-07 17:33:09 -07:00
2026-05-11 07:06:27 -07:00
2026-05-09 02:56:29 -07:00
2026-05-03 08:47:49 -07:00
2026-04-17 01:05:09 -07:00
2026-04-22 16:23:21 -07:00
2026-04-15 17:54:16 -07:00
2026-04-21 01:33:10 -07:00
2026-03-15 03:50:45 -07:00
2026-05-09 02:56:29 -07:00
2026-05-10 14:27:59 -07:00
2026-04-27 19:09:32 -07:00
2026-05-10 06:40:46 -07:00
2026-04-27 21:22:44 -07:00
2026-04-27 21:22:44 -07:00
2026-04-16 20:43:41 -07:00
2026-05-07 06:05:44 -07:00
2026-04-17 01:05:09 -07:00
2026-04-26 18:20:17 -07:00
2026-02-28 03:38:27 -05:00
2026-04-26 18:51:51 -07:00
2026-04-26 18:31:24 -07:00
2026-04-10 03:07:00 -07:00
2026-04-10 02:58:42 -07:00
2026-05-08 10:29:58 -07:00
2026-04-30 20:26:35 -07:00
2026-05-01 13:33:06 -07:00
2026-05-07 07:18:21 -07:00
2026-04-30 05:00:25 -07:00
2026-04-18 19:32:26 -07:00
2026-04-19 03:03:57 -07:00
2026-04-10 03:44:43 -07:00
2026-05-07 05:20:10 -07:00
2026-05-08 10:29:58 -07:00
2026-05-02 02:23:37 -07:00
2026-04-29 05:00:37 -07:00
2026-05-13 22:20:30 -07:00
2026-04-29 21:56:51 -07:00
2026-05-07 05:04:37 -07:00
2026-04-24 03:02:03 -07:00
2026-04-24 14:31:04 -07:00
2026-05-07 07:48:15 -07:00
2026-04-26 11:55:09 -07:00
2026-04-30 20:40:46 -07:00
2026-04-29 21:07:47 -07:00
2026-05-02 02:00:11 -07:00
2026-05-09 14:47:33 -07:00
2026-04-21 13:33:02 -07:00
2026-05-12 18:49:33 -07:00
2026-05-07 05:16:38 -07:00
2026-04-17 21:17:33 -07:00
2026-05-07 05:05:34 -07:00
2026-04-29 04:57:22 -07:00
2026-03-14 21:19:22 -07:00
2026-03-10 23:34:52 -07:00
2026-05-07 05:04:37 -07:00
2026-04-26 05:47:37 -07:00
2026-05-06 10:52:51 -07:00
2026-03-28 14:25:12 -07:00
2026-05-09 17:53:46 -07:00
2026-04-26 07:15:23 -07:00
2026-05-07 05:49:16 -07:00
2026-04-28 06:50:04 -07:00
2026-05-08 18:50:25 -07:00
2026-03-27 04:03:13 -07:00
2026-04-30 04:28:08 -07:00
2026-04-04 19:05:34 -07:00
2026-04-25 08:21:14 -07:00
2026-05-09 14:18:20 +03:00
2026-04-10 03:01:59 -07:00
2026-04-16 02:26:14 -07:00
2026-04-28 05:43:12 -07:00
2026-04-25 18:47:53 -07:00
2026-04-26 18:49:48 -07:00
2026-05-07 06:29:27 -07:00
2026-04-26 19:01:50 -07:00
2026-04-30 20:37:27 -07:00
2026-03-22 09:33:39 -07:00
2026-04-23 05:15:52 -07:00
2026-04-17 15:18:23 -07:00
2026-04-20 03:10:19 -07:00
2026-04-30 20:25:52 -07:00
2026-04-12 13:05:56 -07:00
2026-04-21 00:54:46 -07:00
2026-04-26 12:51:53 -07:00
2026-05-10 09:01:51 -07:00
2026-04-27 06:41:16 -07:00
2026-04-29 04:38:17 -07:00
2026-04-30 04:28:08 -07:00
2026-04-30 19:42:59 -07:00
2026-04-26 12:35:16 -07:00
2026-04-26 18:25:41 -07:00
2026-05-07 06:54:29 -07:00
2026-05-13 18:58:14 -07:00
2026-05-10 12:33:54 -07:00
2026-05-10 12:33:54 -07:00
2026-05-04 05:25:09 -07:00
2026-03-27 11:33:19 -07:00
2026-03-15 23:04:34 -07:00
2026-04-30 20:41:18 -07:00
2026-05-12 16:33:09 -07:00
2026-04-18 04:17:18 -07:00
2026-04-02 20:54:27 -07:00
2026-03-01 05:28:12 -08:00
2026-05-10 20:02:50 -07:00
2026-04-26 17:26:37 -07:00
2026-05-10 15:20:40 -07:00
2026-05-10 22:02:56 -07:00
2026-04-11 14:43:53 -07:00
2026-04-14 17:08:35 -07:00
2026-05-08 11:18:14 -07:00
2026-05-09 02:56:29 -07:00
2026-05-10 18:09:31 -07:00
2026-04-07 14:08:59 -07:00
2026-05-12 16:33:33 -07:00
2026-04-11 13:59:52 -07:00
2026-05-07 04:51:46 -07:00
2026-05-10 22:02:56 -07:00
2026-05-09 11:54:04 -07:00
2026-04-20 00:10:22 -07:00
2026-05-10 18:09:31 -07:00
2026-05-02 01:55:04 -07:00
2026-05-05 04:42:59 -07:00
2026-04-13 10:50:24 -07:00
2026-05-12 17:02:29 -07:00
2026-05-05 04:58:23 -07:00
2026-05-09 11:10:36 -07:00
2026-05-10 22:22:25 -07:00
2026-03-17 02:49:57 -07:00
2026-05-09 01:39:37 -07:00
2026-05-09 11:04:46 -07:00
2026-04-21 06:23:09 -07:00
2026-04-19 00:09:38 -07:00
2026-05-04 03:14:50 -07:00
2026-05-13 14:53:04 -07:00
2026-05-12 13:59:22 -04:00
2026-04-29 21:07:55 -07:00
2026-05-02 02:00:09 -07:00
2026-04-22 16:23:21 -07:00
2026-04-30 20:19:23 -07:00
2026-05-12 13:59:22 -04:00
2026-04-21 01:56:35 -07:00
2026-05-12 13:59:22 -04:00
2026-04-27 12:37:33 -07:00
2026-05-09 01:39:37 -07:00
2026-04-19 22:36:00 -07:00
2026-04-12 18:05:41 -07:00
2026-05-07 07:38:43 -07:00
2026-05-07 07:38:43 -07:00
2026-03-28 14:33:35 -07:00
2026-04-07 17:27:09 -07:00
2026-04-19 22:45:08 -07:00
2026-04-11 15:22:49 -07:00
2026-05-07 05:09:39 -07:00
2026-05-07 06:08:06 -07:00
2026-05-02 02:08:06 -07:00
2026-05-07 06:27:47 -07:00
2026-04-20 11:56:19 -07:00
2026-03-17 10:44:37 -07:00
2026-04-14 01:43:45 -07:00
2026-04-13 16:32:04 -07:00