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.