discd

What it is

In plain terms, discd is the connector that plugs Discord into arizuko, so the agent can read and reply in Discord channels and DMs.

discd is the Discord channel adapter. It opens a Discord gateway websocket (via discordgo), posts inbound messages and reactions to routd, and sends outbound via the Discord REST API. JID prefix is discord:; messages are keyed by discord:<channel_id> for direct/guild chats and discord:<guild>/<channel> for the routing layer.

Why it exists

Discord is the canonical community channel for arizuko deployments — guild channels for team chat, threads for tasks, DMs for one-on-one. Talking to the Discord gateway directly is what lets discd surface reactions as like / dislike events and keep the websocket alive across rolling restarts.

How it fits

Discord (gateway.discord.gg)
        |  websocket: MESSAGE_CREATE, MESSAGE_REACTION_ADD, ...
        v
      discd     (LISTEN_ADDR=:8080)
        |  POST /v1/messages    (signed by CHANNEL_SECRET)
        v
      routd
        |  POST /send           (callback to discd)
        v
      discd     (REST: channels/.../messages, reactions, ...)
        |
        v
      Discord

Wired verbs (discd/bot.go, discd/server.go): send (chunked at 2000 chars, honours reply_to via message_reference), send_file (multipart), typing, edit, delete, like (default 👍), quote. dislike, forward, post, repost are 501-with-hint — the agent gets pointers like like(emoji='👎') rather than a generic capability error.

Inbound: messages where the bot is in m.Mentions or is the parent author of a reply ride verb=mention; everything else in guilds is verb=message (v0.39.1 made reply-to-bot and reactions count as mentions). Reactions MessageReactionAdd emit synthetic like/dislike inbound rows classified by chanlib.ClassifyEmoji.

Attachments use direct Discord CDN URLs cached via the shared chanlib.URLCache.

Standalone usage

discd is a plain Go binary. It needs a reachable routd and a Discord bot or user token.

export ROUTER_URL=http://routd:8080
export CHANNEL_SECRET=$(grep ^CHANNEL_SECRET .env | cut -d= -f2)
export LISTEN_ADDR=:8080
export DISCORD_BOT_TOKEN=...
export ASSISTANT_NAME=arizuko
./discd

Discord-side setup: create an application at discord.com/developers, add a bot, copy the token. Required gateway intents: GUILDS, GUILD_MESSAGES, GUILD_MESSAGE_REACTIONS, MESSAGE_CONTENT, DIRECT_MESSAGES. Invite the bot with the OAuth URL.

User mode (DISCORD_USER_TOKEN instead of bot token) authenticates as a Discord user account — useful where a bot account is not allowed. It skips gateway intents, which user tokens cannot request.

GET /health returns 503 when the websocket is disconnected; discordgo reconnects automatically, so a persistent 503 means token revoked or Discord-side outage.

Go deeper

components/channels — cross-adapter verb matrix.
discd/README.md — verb table, file map.