feat: add Slack adapter with multi-platform ChatAdapter architecture

Cargo.toml

@@ -14,6 +14,8 @@ serenity = { version = "0.12", default-features = false, features = ["client", "
 uuid = { version = "1", features = ["v4"] }
 regex = "1"
 anyhow = "1"
+async-trait = "0.1"
+futures-util = "0.3"
 rand = "0.8"
 clap = { version = "4", features = ["derive"] }
 rpassword = "7"
@@ -22,3 +24,4 @@ base64 = "0.22"
 image = { version = "0.25", default-features = false, features = ["jpeg", "png", "gif", "webp"] }
 unicode-width = "0.2"
 libc = "0.2"
+tokio-tungstenite = { version = "0.21", features = ["rustls-tls-webpki-roots"] }

README.md

@@ -1,14 +1,17 @@
 # OpenAB — Open Agent Broker
 
-A lightweight, secure, cloud-native ACP harness that bridges Discord and any [Agent Client Protocol](https://github.com/anthropics/agent-protocol)-compatible coding CLI (Kiro CLI, Claude Code, Codex, Gemini, OpenCode, Copilot CLI, etc.) over stdio JSON-RPC — delivering the next-generation development experience.
+A lightweight, secure, cloud-native ACP harness that bridges **Discord, Slack**, and any [Agent Client Protocol](https://github.com/anthropics/agent-protocol)-compatible coding CLI (Kiro CLI, Claude Code, Codex, Gemini, OpenCode, Copilot CLI, etc.) over stdio JSON-RPC — delivering the next-generation development experience.
 
 🪼 **Join our community!** Come say hi on Discord — we'd love to have you: **[🪼 OpenAB — Official](https://discord.gg/YNksK9M6)** 🎉
 
 ```
 ┌──────────────┐  Gateway WS   ┌──────────────┐  ACP stdio    ┌──────────────┐
-│   Discord    │◄─────────────►│ openab       │──────────────►│  coding CLI  │
-│   User       │               │   (Rust)     │◄── JSON-RPC ──│  (acp mode)  │
-└──────────────┘               └──────────────┘               └──────────────┘
+│   Discord    │◄─────────────►│              │──────────────►│  coding CLI  │
+│   User       │               │    openab    │◄── JSON-RPC ──│  (acp mode)  │
+├──────────────┤  Socket Mode  │    (Rust)    │               └──────────────┘
+│   Slack      │◄─────────────►│              │
+│   User       │               └──────────────┘
+└──────────────┘
 ```
 
 ## Demo
@@ -17,6 +20,7 @@ A lightweight, secure, cloud-native ACP harness that bridges Discord and any [Ag
 
 ## Features
 
+- **Multi-platform** — supports Discord and Slack, run one or both simultaneously
 - **Pluggable agent backend** — swap between Kiro CLI, Claude Code, Codex, Gemini, OpenCode, Copilot CLI via config
 - **@mention trigger** — mention the bot in an allowed channel to start a conversation
 - **Thread-based multi-turn** — auto-creates threads; no @mention needed for follow-ups
@@ -29,10 +33,22 @@ A lightweight, secure, cloud-native ACP harness that bridges Discord and any [Ag
 
 ## Quick Start
 
-### 1. Create a Discord Bot
+### 1. Create a Bot
+
+<details>
+<summary><strong>Discord</strong></summary>
 
 See [docs/discord-bot-howto.md](docs/discord-bot-howto.md) for a detailed step-by-step guide.
 
+</details>
+
+<details>
+<summary><strong>Slack</strong></summary>
+
+See [docs/slack-bot-howto.md](docs/slack-bot-howto.md) for a detailed step-by-step guide.
+
+</details>
+
 ### 2. Install with Helm (Kiro CLI — default)
 
 ```bash
@@ -42,6 +58,13 @@ helm repo update
 helm install openab openab/openab \
   --set agents.kiro.discord.botToken="$DISCORD_BOT_TOKEN" \
   --set-string 'agents.kiro.discord.allowedChannels[0]=YOUR_CHANNEL_ID'
+
+# Slack
+helm install openab openab/openab \
+  --set agents.kiro.slack.enabled=true \
+  --set agents.kiro.slack.botToken="$SLACK_BOT_TOKEN" \
+  --set agents.kiro.slack.appToken="$SLACK_APP_TOKEN" \
+  --set-string 'agents.kiro.slack.allowedChannels[0]=C0123456789'
 ```
 
 ### 3. Authenticate (first time only)
@@ -60,6 +83,8 @@ In your Discord channel:
 
 The bot creates a thread. After that, just type in the thread — no @mention needed.
 
+**Slack:** `@YourBot explain this code` in a channel — same thread-based workflow as Discord.
+
 ## Other Agents
 
 | Agent | CLI | ACP Adapter | Guide |
@@ -91,6 +116,12 @@ bot_token = "${DISCORD_BOT_TOKEN}"   # supports env var expansion
 allowed_channels = ["123456789"]      # channel ID allowlist
 # allowed_users = ["987654321"]       # user ID allowlist (empty = all users)
 
+[slack]
+bot_token = "${SLACK_BOT_TOKEN}"     # Bot User OAuth Token (xoxb-...)
+app_token = "${SLACK_APP_TOKEN}"     # App-Level Token (xapp-...) for Socket Mode
+allowed_channels = ["C0123456789"]   # channel ID allowlist (empty = allow all)
+# allowed_users = ["U0123456789"]    # user ID allowlist (empty = allow all)
+
 [agent]
 command = "kiro-cli"                  # CLI command
 args = ["acp", "--trust-all-tools"]   # ACP mode args
@@ -179,15 +210,18 @@ kubectl apply -f k8s/deployment.yaml
 ├── config.toml.example # example config with all agent backends
 ├── k8s/                # Kubernetes manifests
 └── src/
-    ├── main.rs         # entrypoint: tokio + serenity + cleanup + shutdown
+    ├── main.rs         # entrypoint: multi-adapter startup, cleanup, shutdown
+    ├── adapter.rs      # ChatAdapter trait, AdapterRouter (platform-agnostic)
     ├── config.rs       # TOML config + ${ENV_VAR} expansion
-    ├── discord.rs      # Discord bot: mention, threads, edit-streaming
-    ├── format.rs       # message splitting (2000 char limit)
+    ├── discord.rs      # DiscordAdapter: serenity EventHandler + ChatAdapter impl
+    ├── slack.rs        # SlackAdapter: Socket Mode + ChatAdapter impl
+    ├── media.rs        # shared image resize/compress + STT download
+    ├── format.rs       # message splitting, thread name shortening
     ├── reactions.rs    # status reaction controller (debounce, stall detection)
     └── acp/
         ├── protocol.rs # JSON-RPC types + ACP event classification
         ├── connection.rs # spawn CLI, stdio JSON-RPC communication
-        └── pool.rs     # thread_id → AcpConnection map
+        └── pool.rs     # session key → AcpConnection map
 ```
 
 ## Inspired By

charts/openab/templates/NOTES.txt

@@ -1,15 +1,24 @@
 openab {{ .Chart.AppVersion }} has been installed!
 
-⚠️  Discord channel IDs must be set with --set-string (not --set) to avoid float64 precision loss.
+⚠️  Channel/user IDs must be set with --set-string (not --set) to avoid float64 precision loss.
 
 Agents deployed:
 {{- range $name, $cfg := .Values.agents }}
 {{- if ne (include "openab.agentEnabled" $cfg) "false" }}
   • {{ $name }} ({{ $cfg.command }})
-{{- if not $cfg.discord.botToken }}
+{{- if not (or (and ($cfg.discord).enabled ($cfg.discord).botToken) (and ($cfg.slack).enabled ($cfg.slack).botToken)) }}
     ⚠️  No bot token provided. Create the secret manually:
     kubectl create secret generic {{ include "openab.agentFullname" (dict "ctx" $ "agent" $name) }} \
-      --from-literal=discord-bot-token="YOUR_TOKEN"
+      --from-literal=discord-bot-token="YOUR_DISCORD_TOKEN"
+{{- end }}
+
+{{- if and ($cfg.discord).enabled ($cfg.discord).botToken }}
+    Discord: ✅ configured
+{{- end }}
+{{- if and ($cfg.slack).enabled ($cfg.slack).botToken }}
+    Slack: ✅ configured (Socket Mode)
+    Ensure your Slack app has these bot events: app_mention, message.channels, message.groups
+    Required scopes: app_mentions:read, chat:write, channels:history, groups:history, channels:read, groups:read, reactions:write, files:read
 {{- end }}
 
 {{- if eq $cfg.command "kiro-cli" }}

charts/openab/templates/_helpers.tpl

@@ -28,6 +28,15 @@ app.kubernetes.io/component: {{ .agent }}
 app.kubernetes.io/version: {{ .ctx.Chart.AppVersion | quote }}
 {{- end }}
 app.kubernetes.io/managed-by: {{ .ctx.Release.Service }}
+{{- with .ctx.Values.labels }}
+{{ toYaml . }}
+{{- end }}
+{{- end }}
+
+{{- define "openab.annotations" -}}
+{{- with .ctx.Values.annotations }}
+{{ toYaml . }}
+{{- end }}
 {{- end }}
 
 {{- define "openab.selectorLabels" -}}

charts/openab/templates/configmap.yaml

@@ -8,8 +8,13 @@ metadata:
   name: {{ include "openab.agentFullname" $d }}
   labels:
     {{- include "openab.labels" $d | nindent 4 }}
+  {{- with (include "openab.annotations" $d) }}
+  annotations:
+    {{- . | nindent 4 }}
+  {{- end }}
 data:
   config.toml: |
+    {{- if and ($cfg.discord).enabled ($cfg.discord).botToken }}
     [discord]
     bot_token = "${DISCORD_BOT_TOKEN}"
     {{- range $cfg.discord.allowedChannels }}
@@ -41,6 +46,25 @@ data:
     {{- if $cfg.discord.trustedBotIds }}
     trusted_bot_ids = {{ $cfg.discord.trustedBotIds | toJson }}
     {{- end }}
+    {{- end }}
+
+    {{- if and ($cfg.slack).enabled }}
+    [slack]
+    bot_token = "${SLACK_BOT_TOKEN}"
+    app_token = "${SLACK_APP_TOKEN}"
+    {{- range ($cfg.slack).allowedChannels }}
+    {{- if regexMatch "e\\+|E\\+" (toString .) }}
+    {{- fail (printf "slack.allowedChannels contains a mangled ID: %s — use --set-string instead of --set for channel IDs" (toString .)) }}
+    {{- end }}
+    {{- end }}
+    allowed_channels = {{ ($cfg.slack).allowedChannels | default list | toJson }}
+    {{- range ($cfg.slack).allowedUsers }}
+    {{- if regexMatch "e\\+|E\\+" (toString .) }}
+    {{- fail (printf "slack.allowedUsers contains a mangled ID: %s — use --set-string instead of --set for user IDs" (toString .)) }}
+    {{- end }}
+    {{- end }}
+    allowed_users = {{ ($cfg.slack).allowedUsers | default list | toJson }}
+    {{- end }}
 
     [agent]
     command = "{{ $cfg.command }}"

charts/openab/templates/deployment.yaml

@@ -9,6 +9,10 @@ metadata:
   name: {{ include "openab.agentFullname" $d }}
   labels:
     {{- include "openab.labels" $d | nindent 4 }}
+  {{- with (include "openab.annotations" $d) }}
+  annotations:
+    {{- . | nindent 4 }}
+  {{- end }}
 spec:
   # Hardcoded for PVC-backed agents: RWO volumes can't be shared across pods,
   # so rolling updates and multiple replicas are not supported.
@@ -22,9 +26,18 @@ spec:
     metadata:
       annotations:
         checksum/config: {{ $cfg | toJson | sha256sum }}
+        {{- with $cfg.podAnnotations }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
       labels:
         {{- include "openab.selectorLabels" $d | nindent 8 }}
+        {{- with $cfg.podLabels }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
     spec:
+      {{- if hasKey $.Values "automountServiceAccountToken" }}
+      automountServiceAccountToken: {{ $.Values.automountServiceAccountToken }}
+      {{- end }}
       {{- with $.Values.podSecurityContext }}
       securityContext:
         {{- toYaml . | nindent 8 }}
@@ -38,13 +51,27 @@ spec:
             {{- toYaml . | nindent 12 }}
           {{- end }}
           env:
-            {{- if $cfg.discord.botToken }}
+            {{- if and ($cfg.discord).enabled ($cfg.discord).botToken }}
             - name: DISCORD_BOT_TOKEN
               valueFrom:
                 secretKeyRef:
                   name: {{ include "openab.agentFullname" $d }}
                   key: discord-bot-token
             {{- end }}
+            {{- if and ($cfg.slack).enabled ($cfg.slack).botToken }}
+            - name: SLACK_BOT_TOKEN
+              valueFrom:
+                secretKeyRef:
+                  name: {{ include "openab.agentFullname" $d }}
+                  key: slack-bot-token
+            {{- end }}
+            {{- if and ($cfg.slack).enabled ($cfg.slack).appToken }}
+            - name: SLACK_APP_TOKEN
+              valueFrom:
+                secretKeyRef:
+                  name: {{ include "openab.agentFullname" $d }}
+                  key: slack-app-token
+            {{- end }}
             {{- if and ($cfg.stt).enabled ($cfg.stt).apiKey }}
             - name: STT_API_KEY
               valueFrom:

charts/openab/templates/pvc.yaml

@@ -9,6 +9,10 @@ metadata:
   name: {{ include "openab.agentFullname" $d }}
   labels:
     {{- include "openab.labels" $d | nindent 4 }}
+  {{- with (include "openab.annotations" $d) }}
+  annotations:
+    {{- . | nindent 4 }}
+  {{- end }}
 spec:
   accessModes:
     - ReadWriteOnce