Slack Agenium App

Slack app gateway for the agent:// protocol — bridges Slack ↔ Agenium agent network.

Features

• Slash Commands — /agent send|discover|status
• Message Shortcuts — Right-click → "Send to Agent"
• App Home — Dashboard with agent directory and quick actions
• Modals — Interactive forms for agent communication
• Workflow Builder — Custom steps that call agents
• Canvas — Agents create/edit Slack Canvases
• Huddles — Notifications when agents need attention
• Lists — Agents manage structured data
• Channels — Channel management via agents
• Files — Upload and share files
• Slack Connect — Cross-organization agent messaging

Setup

# Install dependencies
npm install

# Copy env template
cp .env.example .env
# Edit .env with your Slack tokens

# Development
npm run dev

# Production
npm run build && npm start

Slack App Configuration

1. Create a Slack app at https://api.slack.com/apps
2. Use manifest.json for automatic configuration
3. Enable Socket Mode
4. Install to your workspace
5. Copy Bot Token, App Token, and Signing Secret to .env

Agent Registration

Set AGENT_API_KEY to a valid dom_ key to register on the Agenium DNS network. The app registers as agent://AGENT_NAME.slack.

Architecture

src/
├── index.ts              # Bolt app entry point
├── agent/                # Agent protocol server
├── slack/                # Slack event/command handlers
└── integrations/         # Deep Slack ecosystem integrations

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.