DevCom.AgenticRuntime.Plugin.Slack 1.1.0

DAP Slack Plugin

Trigger a DevCom Agentic Platform (DAP) agent by @mentioning a Slack bot in a channel, and get the agent's reply back in the same channel — threaded under the message that mentioned it.

Unlike the Telegram plugin (which long-polls), Slack pushes events to DAP over HTTPS via the Events API, so the plugin exposes a single public endpoint and does no polling.

Features

• slack-mention trigger — pairs a Slack app to an agent; an app_mention fires the agent with the message text (mention stripped) plus Slack context (channel, user, thread).
• Threaded, streamed replies — the agent's answer is posted back and edited in place as it streams, threaded under the triggering message by default (chat.update, debounced to respect Slack's ~1 msg/sec/channel limit).
• Session continuity — follow-up @mentions in the same thread continue the same agent conversation (session keyed by channel + thread).
• Per-agent pairing / multi-tenant — bot token, signing secret, and channel allow-list live on the per-agent trigger config, so one DAP deployment can pair multiple agents to multiple Slack apps/workspaces, each routed independently.
• Human-In-The-Loop (HITL) — when an agent needs input, the prompt is posted into Slack as a Block Kit message with one button per choice; the operator answers by clicking a button or @mentioning the bot in the thread, which resumes the run. The prompt's buttons are stripped once resolved (from any source). Optionally forward all of an agent's HITL prompts to a chosen channel (ForwardAllHitl).
• Request authenticity — every inbound event and interaction is verified (X-Slack-Signature HMAC-SHA256 + X-Slack-Request-Timestamp ±5-minute replay window); unverifiable requests get 401 and do nothing. Redeliveries are de-duplicated by event_id.

Configuration

The plugin has no plugin-wide settings. Configure each agent's Slack trigger with:

Slack app setup

1. Create an app at https://api.slack.com/apps → Create New App → From scratch.

2. Add scopes — OAuth & Permissions → Bot Token Scopes: add app_mentions:read and chat:write.

3. Install to workspace — Install App → copy the Bot User OAuth Token (xoxb-…).

4. Copy the Signing Secret — Basic Information → App Credentials → Signing Secret.

5. Create the DAP credential — in DAP, create a slack-mention credential with the bot token and signing secret, and click Test (runs auth.test) to confirm it connects.

6. Enable Event Subscriptions — Event Subscriptions → toggle on → Request URL:

   https://<your-dap-host>/api/x/DevCom.AgenticRuntime.Plugin.Slack/events
   

   Slack sends a one-time url_verification challenge; the endpoint answers it, so the URL shows Verified. The URL must be publicly reachable and registered per environment.

7. Subscribe to the event — Subscribe to bot events → add app_mention → Save Changes (reinstall the app if Slack prompts you to).

8. Enable Interactivity (required for HITL buttons) — Interactivity & Shortcuts → toggle on → Request URL:

   https://<your-dap-host>/api/x/DevCom.AgenticRuntime.Plugin.Slack/interactivity
   

   This is where Slack POSTs button clicks. Same host rules as the events URL (public, per environment). If you don't use HITL you can skip this step.

9. Bind the agent — add a slack-mention trigger to the agent, referencing the credential and (optionally) an allowed-channels list. Invite the bot to the channel (/invite @yourbot) and @mention it.

Human-In-The-Loop

When an agent runs a request human input step, the plugin posts the prompt into Slack:

• Session started in Slack → the prompt lands in that same thread.
• Session started elsewhere (web UI, schedule, API) → set Forward all HITL prompts + a HITL channel ID on the trigger config to receive it there.

The operator answers by clicking a button or @mentioning the bot in the thread (a plain reply won't reach the bot — Slack only delivers app_mention); the run resumes and the prompt's buttons are removed once resolved. Button HITL requires the Interactivity request URL (step 8); @mention-reply answers work with just the events URL.

Out of scope

Slash commands, modals/shortcuts, Socket Mode, direct messages, non-mention channel listening, and file/attachment ingestion — see the follow-up tickets.

Changelog

1.1.0

• feat(DAP-253, slack): Human-In-The-Loop over Slack via Block Kit — HITL prompts post as interactive button messages (or thread-reply prompts); button taps hit a new interactivity endpoint and thread replies resume the run; prompts are cleaned up on resolve from any source. Adds ForwardAllHitl + HitlChannel config and the Interactivity request URL.

1.0.1

• fix(DAP-251, slack): resolve a plugin-install failure — SlackEventProcessor (a bootstrapper singleton) can't have ITriggerContext constructor-injected because the plugin's inner DI container doesn't resolve it; it is now passed per-dispatch from the events endpoint.

1.0.0

• feat(DAP-251, slack): slack-mention trigger via the Slack Events API — signed app_mention events fire the bound agent and stream a threaded reply back into the channel; per-config credentials (bot token + signing secret), channel allow-list, thread session continuity, and event_id dedupe.