Skip to content

docs(discord): document bot-to-bot comms as unsupported (#32791) - #54063

Merged
teknium1 merged 2 commits into
mainfrom
docs/discord-no-bot2bot-32791
Jun 28, 2026
Merged

docs(discord): document bot-to-bot comms as unsupported (#32791)#54063
teknium1 merged 2 commits into
mainfrom
docs/discord-no-bot2bot-32791

Conversation

@teknium1

Copy link
Copy Markdown
Contributor

Summary

Documents that multi-profile bot-to-bot conversation is not a supported topology, and that DISCORD_ALLOW_BOTS=none (the default) is the safe setting that prevents the ack-loop reported in #32791.

The reported death-loop is only reachable when an operator opts into DISCORD_ALLOW_BOTS=mentions/all across multiple Hermes profiles to make them reply to each other. We don't support that, so the fix is a documented stance, not new gateway machinery.

Changes

  • website/docs/user-guide/messaging/discord.md: add a warning admonition under the env-var table explaining the unsupported topology, the safe default, and why it loops (Discord's reply auto-mention satisfies the mentions gate every turn).

Why not a code fix

  • On current main, DISCORD_ALLOW_BOTS=none already blocks all bot-originated messages at the on_message gate — before free_response_channels is ever consulted. The issue's Layer-1 premise (free-response bypasses allow_bots) does not hold.
  • Adding a per-channel circuit breaker + operator-HALT (as proposed in fix(discord): add multi-layer safety against bot-to-bot death-loops (#32791) #33985) guards an unsupported configuration and would require new DISCORD_* behavioral env vars, which is against the secrets-only .env policy.

Validation

Result
npx docusaurus build (en + zh-Hans) SUCCESS, no MDX errors

Infographic

Bot-to-bot not supported

teknium1 added 2 commits June 28, 2026 00:53
Multi-profile bot-to-bot conversation is not a supported topology.
DISCORD_ALLOW_BOTS=none (the default) blocks all bot-originated
messages; setting mentions/all across multiple Hermes profiles to make
them reply to each other ack-loops because Discord's reply auto-mention
satisfies the mention gate every turn. Document the safe default and
the loop hazard so operators don't wire it up.

@tonydwb tonydwb left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review Summary

Verdict: Approved

Documentation-only change adding a clear warning about bot-to-bot conversation not being supported. Explains the DISCORD_ALLOW_BOTS setting, the ack-loop risk, and why there's no circuit breaker. Clean and accurate.


Reviewed by Hermes Agent

@alt-glitch alt-glitch added type/docs Documentation improvements platform/discord Discord bot adapter P3 Low — cosmetic, nice to have labels Jun 28, 2026
@teknium1
teknium1 merged commit de6e9ac into main Jun 28, 2026
28 checks passed
@teknium1
teknium1 deleted the docs/discord-no-bot2bot-32791 branch June 28, 2026 08:15
pai-scaffolde pushed a commit to pai-scaffolde/hermes-agent that referenced this pull request Jun 28, 2026
…#32791) (NousResearch#54063)

* docs(discord): document bot-to-bot comms as unsupported (NousResearch#32791)

Multi-profile bot-to-bot conversation is not a supported topology.
DISCORD_ALLOW_BOTS=none (the default) blocks all bot-originated
messages; setting mentions/all across multiple Hermes profiles to make
them reply to each other ack-loops because Discord's reply auto-mention
satisfies the mention gate every turn. Document the safe default and
the loop hazard so operators don't wire it up.

* docs(discord): infographic for bot-to-bot unsupported stance (NousResearch#32791)
waefrebeorn pushed a commit to waefrebeorn/slermes that referenced this pull request Jul 2, 2026
…#32791) (NousResearch#54063)

* docs(discord): document bot-to-bot comms as unsupported (NousResearch#32791)

Multi-profile bot-to-bot conversation is not a supported topology.
DISCORD_ALLOW_BOTS=none (the default) blocks all bot-originated
messages; setting mentions/all across multiple Hermes profiles to make
them reply to each other ack-loops because Discord's reply auto-mention
satisfies the mention gate every turn. Document the safe default and
the loop hazard so operators don't wire it up.

* docs(discord): infographic for bot-to-bot unsupported stance (NousResearch#32791)
Jasper6439 pushed a commit to Jasper6439/hermes-agent that referenced this pull request Jul 5, 2026
…#32791) (NousResearch#54063)

* docs(discord): document bot-to-bot comms as unsupported (NousResearch#32791)

Multi-profile bot-to-bot conversation is not a supported topology.
DISCORD_ALLOW_BOTS=none (the default) blocks all bot-originated
messages; setting mentions/all across multiple Hermes profiles to make
them reply to each other ack-loops because Discord's reply auto-mention
satisfies the mention gate every turn. Document the safe default and
the loop hazard so operators don't wire it up.

* docs(discord): infographic for bot-to-bot unsupported stance (NousResearch#32791)
habarmc1223-sudo pushed a commit to habarmc1223-sudo/hermes-agent-fluxmem that referenced this pull request Jul 8, 2026
…#32791) (NousResearch#54063)

* docs(discord): document bot-to-bot comms as unsupported (NousResearch#32791)

Multi-profile bot-to-bot conversation is not a supported topology.
DISCORD_ALLOW_BOTS=none (the default) blocks all bot-originated
messages; setting mentions/all across multiple Hermes profiles to make
them reply to each other ack-loops because Discord's reply auto-mention
satisfies the mention gate every turn. Document the safe default and
the loop hazard so operators don't wire it up.

* docs(discord): infographic for bot-to-bot unsupported stance (NousResearch#32791)
santhreal pushed a commit to santhreal/hermes-agent that referenced this pull request Jul 13, 2026
…#32791) (NousResearch#54063)

* docs(discord): document bot-to-bot comms as unsupported (NousResearch#32791)

Multi-profile bot-to-bot conversation is not a supported topology.
DISCORD_ALLOW_BOTS=none (the default) blocks all bot-originated
messages; setting mentions/all across multiple Hermes profiles to make
them reply to each other ack-loops because Discord's reply auto-mention
satisfies the mention gate every turn. Document the safe default and
the loop hazard so operators don't wire it up.

* docs(discord): infographic for bot-to-bot unsupported stance (NousResearch#32791)
Gravezzz pushed a commit to Gravezzz/hermes-agent that referenced this pull request Jul 21, 2026
…#32791) (NousResearch#54063)

* docs(discord): document bot-to-bot comms as unsupported (NousResearch#32791)

Multi-profile bot-to-bot conversation is not a supported topology.
DISCORD_ALLOW_BOTS=none (the default) blocks all bot-originated
messages; setting mentions/all across multiple Hermes profiles to make
them reply to each other ack-loops because Discord's reply auto-mention
satisfies the mention gate every turn. Document the safe default and
the loop hazard so operators don't wire it up.

* docs(discord): infographic for bot-to-bot unsupported stance (NousResearch#32791)
leewenjie pushed a commit to leewenjie/hermes-agent that referenced this pull request Aug 7, 2026
…#32791) (NousResearch#54063)

* docs(discord): document bot-to-bot comms as unsupported (NousResearch#32791)

Multi-profile bot-to-bot conversation is not a supported topology.
DISCORD_ALLOW_BOTS=none (the default) blocks all bot-originated
messages; setting mentions/all across multiple Hermes profiles to make
them reply to each other ack-loops because Discord's reply auto-mention
satisfies the mention gate every turn. Document the safe default and
the loop hazard so operators don't wire it up.

* docs(discord): infographic for bot-to-bot unsupported stance (NousResearch#32791)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low — cosmetic, nice to have platform/discord Discord bot adapter type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants