Channel: Slack Adapter

[ggondim]

Summary

Implement the Slack channel adapter using Vercel Chat SDK. Slack is the primary validation target — it has the richest API and tests the full flow (native threads, buttons, selects).

Tasks

• Register Slack bot (OAuth tokens, event subscriptions)
• Inbound: message events, app mentions, slash commands
• Outbound: text, blocks (mrkdwn), buttons (Block Kit actions), select menus
• Thread support: native Slack threads (1:1 mapping with OpenThreads threads)
• A2H inline (method 1): Block Kit buttons for AUTHORIZE, select menus for COLLECT
• Response capture (method 2): Slack interaction payloads (button clicks, menu selections), thread replies for free-text COLLECT
• Report capabilities: { threads: true, buttons: true, selectMenus: true, replyMessages: false, dms: true, fileUpload: true }
• Integration tests with Slack test workspace (manual/CI-optional)

Acceptance Criteria

• Adapter implements full ChannelAdapter interface
• Inbound messages from Slack are correctly parsed to normalized format
• Outbound messages render correctly in Slack (text, blocks, buttons)
• A2H AUTHORIZE renders as approve/deny buttons, callback returns response
• A2H COLLECT with options renders as select menu
• A2H COLLECT free-text captures thread reply
• Passes shared adapter conformance test suite

Dependencies

• Core: Data Model, Types & Interfaces #2 (Core: Data Model & Interfaces) — implements the ChannelAdapter interface

References

• VISION.md — Channel adapters
• PLAN.md — Phase 3.1

[claude]

@claude Implement this issue. Follow these steps precisely:

1. Checkout the base branch and create your working branch:
   git fetch origin meta/17 && git checkout meta/17 && git checkout -b claude/17-7-slack-adapter
2. Implement all tasks listed in this issue
3. Commit and push your branch:
   git push -u origin claude/17-7-slack-adapter
4. Create a PR targeting meta/17:
   gh pr create --base meta/17 --head claude/17-7-slack-adapter --title "Channel: Slack Adapter" --body "fixes Channel: Slack Adapter #7"

Enable auto-merge on the PR with: gh pr merge --auto --merge

[claude]

Claude finished @claude[bot]'s task in 14m 28s —— View job • claude/issue-7-20260410-2150 • Create PR ➔

---

Slack Channel Adapter — Implementation Complete

• Read VISION.md and understand project architecture
• Create monorepo workspace structure (package.json, tsconfig.base.json)
• Implement @openthreads/core — ChannelAdapter interface, A2H types, envelope types
• Implement @openthreads/channels-slack
  • Inbound: message events, app_mention events, /openthreads slash command
  • Outbound: text (mrkdwn), Block Kit blocks, buttons, select menus
  • Thread support: native Slack thread_ts ↔ OpenThreads threadId (1:1 mapping)
  • A2H AUTHORIZE → Block Kit Approve/Deny buttons with confirmation dialog (method 1)
  • A2H COLLECT with options → static_select menu (method 1)
  • A2H COLLECT free-text → thread reply capture (method 2)
  • A2H INFORM → plain-text fire-and-forget
  • Capabilities: { threads: true, buttons: true, selectMenus: true, replyMessages: false, dms: true, fileUpload: true }
• Write tests — 40+ tests across 4 files:
  • blocks.test.ts — Block Kit builder unit tests
  • normalize.test.ts — message normalization unit tests
  • SlackAdapter.test.ts — integration tests with mock App/WebClient
  • conformance.test.ts — shared adapter conformance suite
• Committed and pushed to claude/issue-7-20260410-2150
• PR creation (gh pr create requires approval) — use link below

---

Files added

package.json                                   (Bun workspace root)
tsconfig.base.json                             (shared TS config)
packages/core/
  package.json
  tsconfig.json
  src/types.ts                                 (ChannelAdapter, A2H types, envelopes)
  src/index.ts
packages/channels/slack/
  package.json
  tsconfig.json
  src/index.ts
  src/SlackAdapter.ts                          (main adapter — 300+ lines)
  src/utils/blocks.ts                          (Block Kit builders)
  src/utils/normalize.ts                       (message normalization)
  src/__tests__/blocks.test.ts
  src/__tests__/normalize.test.ts
  src/__tests__/SlackAdapter.test.ts
  src/__tests__/conformance.test.ts

[claude]

@claude Implement this issue. Follow these steps precisely:

1. Checkout the base branch and create your working branch:
   git fetch origin meta/17 && git checkout meta/17 && git checkout -b claude/17-7-slack-adapter
2. Implement all tasks listed in this issue
3. Commit and push your branch:
   git push -u origin claude/17-7-slack-adapter
4. Create a PR targeting meta/17:
   gh pr create --base meta/17 --head claude/17-7-slack-adapter --title "Channel: Slack Adapter" --body "fixes Channel: Slack Adapter #7"

Enable auto-merge on the PR with: gh pr merge --auto --merge

[claude]

Claude finished @claude[bot]'s task in 7m 28s —— View job • claude/issue-7-20260410-2200 • [Create PR ➔](https://github.com/deepducks/OpenThreads/compare/main...claude/issue-7-20260410-2200?quick_pull=1&title=Issue%20%237%3A%20Changes%20from%20Claude&body=This%20PR%20addresses%20issue%20%237%0A%0AGenerated%20with%20%5BClaude%20Code%5D(https%3A%2F%2Fclaude.ai%2Fcode)

---

Implementing Slack Channel Adapter

• Read VISION.md and understand project guidelines
• Explore project structure (repo starts from scratch with VISION.md only)
• Set up Bun monorepo workspace root (package.json, tsconfig.json)
• Implement packages/core — ChannelAdapter interface and types
  • ChannelAdapter interface with send, start, stop, onMessage, onInteraction, getCapabilities
  • Full A2H intent types: AUTHORIZE, COLLECT, INFORM, ESCALATE, RESULT
  • Type guards (isA2HItem, isAuthorize, isCollect, isInform, isTextMessage)
  • normaliseMessages utility
• Implement packages/channels/slack
  • Package setup (package.json, tsconfig.json)
  • Inbound: message events, app_mention, slash commands (inbound.ts)
  • Outbound: text, Block Kit blocks, buttons, select menus (outbound.ts)
  • Thread support: native Slack thread_ts ↔ OpenThreads nativeThreadId (adapter.ts)
  • A2H AUTHORIZE → Block Kit approve/deny buttons (a2h.ts)
  • A2H COLLECT with options → static_select menu (a2h.ts)
  • A2H COLLECT free-text → thread reply capture (adapter.ts)
  • Report capabilities: { threads: true, buttons: true, selectMenus: true, replyMessages: false, dms: true, fileUpload: true } (capabilities.ts)
• Write unit and conformance tests
  • tests/inbound.test.ts — message parsing, timestamp conversion, bot mention stripping
  • tests/a2h.test.ts — Block Kit rendering, action_id encoding/parsing
  • tests/capabilities.test.ts — capability object shape
  • tests/conformance.test.ts — full adapter conformance suite with mock Slack clients
  • packages/core/tests/guards.test.ts — type guard unit tests
• Commit and push changes (branch: claude/issue-7-20260410-2200)
• Create PR targeting meta/17 (see link below — gh pr create requires approval)

---

Branch pushed. The gh pr create command was blocked by permissions. Please create the PR using the link below:

Create PR: "Channel: Slack Adapter" → meta/17

---

What was implemented

packages/core (@openthreads/core):

• ChannelAdapter interface: send(), start(), stop(), onMessage(), onInteraction(), getCapabilities()
• Full A2H intent types aligned with the Twilio A2H spec
• Type guards and message normalisation helpers

packages/channels/slack (@openthreads/channels-slack):

• SlackAdapter using @slack/bolt (event handling) and @slack/web-api (sending)
• Inbound: message, app_mention events, slash commands, thread replies
• Outbound: plain text, Block Kit sections, dividers, action buttons, static select menus
• A2H AUTHORIZE → approve/deny Block Kit buttons; response captured via onInteraction
• A2H COLLECT with options → static_select dropdown; response captured via onInteraction
• A2H COLLECT free-text → posts question, registers pending listener; next thread reply captured and returned via onInteraction
• A2H INFORM → plain mrkdwn message
• Supports both Socket Mode (dev) and HTTP (production) via config
  |

[claude]

@claude Implement this issue. Follow these steps precisely:

1. Checkout the base branch and create your working branch:
   git fetch origin meta/17 && git checkout meta/17 && git checkout -b claude/17-7-slack-adapter
2. Implement all tasks listed in this issue
3. Commit and push your branch:
   git push -u origin claude/17-7-slack-adapter
4. Create a PR targeting meta/17:
   gh pr create --base meta/17 --head claude/17-7-slack-adapter --title "Channel: Slack Adapter" --body "fixes Channel: Slack Adapter #7"

Enable auto-merge on the PR with: gh pr merge --auto --merge

[claude]

Claude finished @claude[bot]'s task in 9m 6s —— View job • claude/issue-7-20260410-2205 • Create PR ➔

---

Slack Channel Adapter — Implementation Complete

• Read VISION.md and understand project architecture
• Create monorepo workspace structure (package.json, tsconfig.base.json)
• Implement @openthreads/core — ChannelAdapter interface, A2H types, envelope types, conformance suite
• Implement @openthreads/channels-slack
  • Inbound: message events, app_mention events, /openthreads slash command
  • Outbound: text (mrkdwn), Block Kit blocks, buttons, select menus
  • Thread support: native Slack thread_ts ↔ OpenThreads threadId (1:1 mapping)
  • A2H AUTHORIZE → Block Kit Approve/Deny buttons with confirmation dialog (method 1)
  • A2H COLLECT with options → static_select menu (method 1)
  • A2H COLLECT free-text → thread reply capture (method 2)
  • A2H INFORM → plain-text fire-and-forget
  • Capabilities: { threads: true, buttons: true, selectMenus: true, replyMessages: false, dms: true, fileUpload: true }
• Write tests — 40+ tests across 4 files:
  • blocks.test.ts — Block Kit builder unit tests
  • normalize.test.ts — message normalization unit tests
  • SlackAdapter.test.ts — integration tests with mock App/WebClient
  • conformance.test.ts — shared adapter conformance suite
• Committed and pushed to claude/issue-7-20260410-2205
• PR creation requires approval — use link below

Files added

package.json                                   (Bun workspace root)
tsconfig.base.json                             (shared TS config)
packages/core/
  package.json
  tsconfig.json
  src/types.ts                                 (ChannelAdapter, A2H types, envelopes)
  src/index.ts
  src/testing/conformance.ts                   (shared conformance suite)
packages/channels/slack/
  package.json
  tsconfig.json
  src/index.ts
  src/SlackAdapter.ts                          (main adapter — 300+ lines)
  src/utils/blocks.ts                          (Block Kit builders)
  src/utils/normalize.ts                       (message normalization)
  src/__tests__/blocks.test.ts
  src/__tests__/normalize.test.ts
  src/__tests__/SlackAdapter.test.ts
  src/__tests__/conformance.test.ts

•