feat(discord): add discord_server tool with 15 actions

[suryanshsrivastava]

Summary

Restores teknium's discord_server tool (originally from commit 2f323ec4, lost during rebase) and adds a new fetch_message action that accepts Discord message URLs for easy single-message retrieval.

What's included

New file: tools/discord_tool.py — 15 actions covering Discord server introspection and basic moderation:

Action	Description
list_guilds	List all guilds the bot is in
server_info	Detailed guild info (member count, channels, roles, features)
list_channels	All channels grouped by category
channel_info	Detailed channel info (topic, NSFW, slowmode, thread metadata)
list_roles	All roles with colors and permissions
member_info	Member details (roles, join date, boosting status)
search_members	Search members by query
fetch_messages	Fetch message history from a channel (with pagination)
fetch_message	NEW — Fetch a single message by ID or Discord URL
list_pins	List pinned messages in a channel
pin_message	Pin a message
unpin_message	Unpin a message
create_thread	Create a thread in a channel
add_role	Add a role to a member
remove_role	Remove a role from a member

Gated on DISCORD_BOT_TOKEN — the tool auto-registers when the env var is set, zero cost for non-Discord platforms.

Added to hermes-discord toolset in toolsets.py.

New: fetch_message

The original tool had fetch_messages for channel history but no way to look up a single message. fetch_message accepts:

• Direct IDs: channel_id=123, message_id=456
• Discord URL: message_url=https://discord.com/channels/GUILD/CHANNEL/MESSAGE

This is particularly useful for bot-to-bot communication where one bot posts a message and another needs to read it.

Related PRs & Issues

This PR builds on and complements several existing efforts:

• feat: support discord bot-to-bot interaction #9053 — feat: support discord bot-to-bot interaction — our fetch_message action enables bot-to-bot message reading, which is a core requirement for that feature.
• [codex] Add Discord read tools #4677 — [codex] Add Discord read tools — similar goal of exposing Discord read capabilities as tools. This PR provides a broader set of 15 actions (including read operations) with the added fetch_message URL-based lookup.
• feat(discord): add channel history tool #10736 — feat(discord): add channel history tool — our fetch_messages action covers channel history access. This PR packages it alongside the full introspection toolset.
• feat: /history slash command for Discord #3308 — feat: /history slash command for Discord — related to making message history accessible. This PR provides the underlying tool that such a slash command could call.
• RFC(discord): richer Discord-native UX prototype #2041 — RFC(discord): richer Discord-native UX prototype — broader Discord UX improvements this tool can feed into.

Closes

• Closes Feature: Add discord_fetch_message tool #2105
• Partially addresses [Feature]: Discord Gateway v2: Full Server Management & Message History Access #1559
• References Feature: Slack gateway should expose conversations.history as an agent tool #6345

Tests

48 unit tests in tests/tools/test_discord_tool.py covering all 15 actions, URL parsing, error handling, and toolset inclusion. Registry snapshot test updated.

All tests pass: pytest tests/tools/test_discord_tool.py tests/tools/test_registry.py -v → 79 passed.

Attribution

Original implementation by @teknium1 (commit 2f323ec4, Apr 3, 2026). Restored with the fetch_message addition.

[teknium1]

Thanks for preserving the direct single-message lookup idea. Current main already contains the broader server capability, but the PR needs a narrow salvage into the current architecture.

Problems

• tools/discord_tool.py:573 restores discord_server, while commit 81987f0350b68ab5cf8a1c6d1129a523fe32dcf4 split that interface into discord and discord_admin. Main's dynamic schema path only rebuilds those two tools (model_tools.py:471-493), so restoring the monolith would bypass the current split/schema flow.
• The direct URL lookup is still missing on main: the current action map at tools/discord_tool.py:633-655 has fetch_messages but not fetch_message, and its schema at tools/discord_tool.py:823-875 has no message_url property.

Suggested changes

• Salvage _fetch_message through the current discord core-action path, including the manifest, schema, handler defaults, action allowlist, and ID/URL tests.
• Keep the current discord / discord_admin split and its intent-aware dynamic schema behavior.

This is an automated hermes-sweeper review.

[teknium1]

Current main no longer exposes monolithic discord_server: commit 81987f0350b68ab5cf8a1c6d1129a523fe32dcf4 split it, and model_tools.py:471-493 dynamically rebuilds only discord and discord_admin. Please salvage fetch_message through those existing paths instead of adding this registration.