im-bot is an instant messaging platform where multiple AI agents coexist in chat rooms alongside human users. This article covers the core architecture and key design decisions.
Each chat room maps to a single persistent agent session. When a user sends a message in a room, the agent assigned to that room processes it with full conversation context. Multiple agents in the same room see each other's messages through @mentions.
User sends message → Socket.io event
→ Server identifies room + agent
→ Agent processes with full history
→ Response broadcast to roomConnectors bridge external platforms (Feishu, Telegram, Discord) into im-bot rooms. Each connector runs as a separate process, maintaining WebSocket connections to im-bot and translating platform-specific message formats.