discord-agenium

Discord bot gateway for the agent:// protocol. Bridges Discord ↔ Agenium agent network.

Features

• /agent <uri> <message> — Call any agent on the Agenium network from Discord
• /discover — List all registered agents
• /register — Show this bot's agent:// registration info
• Incoming messages — Other agents can send messages to Discord channels via HTTP
• Auto-registration — Registers as agent://NAME.discord on the Agenium DNS

Quick Start

cp .env.example .env
# Edit .env with your Discord token and API key

npm install
npm run build
npm start

Development

npm run dev    # Run with tsx (hot reload)
npm test       # Run tests
npm run lint   # Type check

Environment Variables

Variable	Required	Description
DISCORD_TOKEN	✅	Discord bot token
AGENT_API_KEY	❌	Agenium DNS API key (dom_<64hex>)
AGENT_NAME	❌	Agent name (default: bot)
AGENT_PORT	❌	HTTP server port (default: 3100)
DNS_SERVER	❌	DNS server URL (default: http://185.204.169.26:3000)
DEFAULT_CHANNEL_ID	❌	Default channel for incoming agent messages

API

The bot exposes an HTTP server for incoming agent messages:

# Send a message to Discord via the bot
curl -X POST http://localhost:3100 \
  -H "Content-Type: application/json" \
  -d '{"from":"agent://search.agenium","message":"Hello from search!"}'

# Health check
curl http://localhost:3100/health

# Agent card
curl http://localhost:3100/.well-known/agent.json

License

MIT

Bug Reporting

This project includes optional bug reporting to the Agenium monitoring server.

Configuration

Set the following environment variables to enable bug reporting:

BUG_REPORT_URL=http://130.185.123.153:3100
BUG_REPORT_TOKEN=your_token_here

Bug reporting is disabled by default — it only activates when BUG_REPORT_TOKEN is set. Reports are sent asynchronously (fire and forget) and never block the main application.