Add Slack membership and DM writes (#157)

* Add Slack membership and DM writes

- Implement invite, kick, open, close, mark, and conversation type filtering.

- Model IM and MPIM conversations and support DM posting by user ID.

- Cover routes, Slack SDK calls, events, docs, and coverage matrix.

* Address Slack DM review findings

* Fix Slack direct conversation visibility

* Fix Slack direct conversation write guards

* Fix Slack private conversation guards

* Fix Slack membership review issues

* Fix Slack scheduled and legacy membership guards

* Fix Slack skill DM examples

* Fix Slack reaction access guards

* Fix Slack DM events and leave guards

Author: ctate

README.md

@@ -598,11 +598,11 @@ OAuth 2.0, OpenID Connect, and mutable Google Workspace-style surfaces for local
 
 ## Slack API
 
-Fully stateful Slack Web API emulation with channels, messages, threads, reactions, OAuth v2, and incoming webhooks. Chat writes preserve common rich message fields such as `blocks`, `attachments`, `metadata`, formatting flags, unfurl flags, and client message ids. Conversation lifecycle writes update archive state, names, topics, and purposes.
+Fully stateful Slack Web API emulation with channels, messages, threads, reactions, OAuth v2, and incoming webhooks. Chat writes preserve common rich message fields such as `blocks`, `attachments`, `metadata`, formatting flags, unfurl flags, and client message ids. Conversation writes update archive state, names, topics, purposes, membership, DMs, MPIMs, and read cursors.
 
 ### Auth & Chat
 - `POST /api/auth.test` - test authentication
-- `POST /api/chat.postMessage` - post message with text or rich payload fields (supports threads via `thread_ts`)
+- `POST /api/chat.postMessage` - post message with text or rich payload fields (supports threads via `thread_ts` and DM user IDs)
 - `POST /api/chat.postEphemeral` - post ephemeral message outside channel history
 - `POST /api/chat.update` - update message text and rich payload fields
 - `POST /api/chat.delete` - delete message
@@ -613,7 +613,7 @@ Fully stateful Slack Web API emulation with channels, messages, threads, reactio
 - `POST /api/chat.meMessage` - /me message
 
 ### Conversations
-- `POST /api/conversations.list` - list channels (cursor pagination)
+- `POST /api/conversations.list` - list conversations (cursor pagination, `types`, `exclude_archived`)
 - `POST /api/conversations.info` - get channel info
 - `POST /api/conversations.create` - create channel
 - `POST /api/conversations.archive` / `conversations.unarchive` - archive/restore channel
@@ -622,6 +622,9 @@ Fully stateful Slack Web API emulation with channels, messages, threads, reactio
 - `POST /api/conversations.history` - channel history with rich message fields
 - `POST /api/conversations.replies` - thread replies with rich message fields
 - `POST /api/conversations.join` / `conversations.leave` - join/leave
+- `POST /api/conversations.invite` / `conversations.kick` - manage membership
+- `POST /api/conversations.open` / `conversations.close` - open/close DMs and MPIMs
+- `POST /api/conversations.mark` - mark read cursor
 - `POST /api/conversations.members` - list members
 
 ### Users & Reactions

apps/web/app/docs/slack/page.mdx

@@ -1,14 +1,14 @@
 # Slack API
 
-Fully stateful Slack Web API emulation with channels, messages, threads, reactions, OAuth v2, and incoming webhooks. Chat writes preserve common rich message fields such as `blocks`, `attachments`, `metadata`, formatting flags, unfurl flags, and client message ids. Conversation lifecycle writes update archive state, names, topics, and purposes. State changes dispatch `event_callback` payloads to configured webhook URLs.
+Fully stateful Slack Web API emulation with channels, messages, threads, reactions, OAuth v2, and incoming webhooks. Chat writes preserve common rich message fields such as `blocks`, `attachments`, `metadata`, formatting flags, unfurl flags, and client message ids. Conversation writes update archive state, names, topics, purposes, membership, DMs, MPIMs, and read cursors. State changes dispatch `event_callback` payloads to configured webhook URLs.
 
 ## Auth
 
 - `POST /api/auth.test` - test authentication
 
 ## Chat
 
-- `POST /api/chat.postMessage` - post message with text or rich payload fields (supports threads via `thread_ts`)
+- `POST /api/chat.postMessage` - post message with text or rich payload fields (supports threads via `thread_ts` and DM user IDs)
 - `POST /api/chat.postEphemeral` - post ephemeral message outside channel history
 - `POST /api/chat.update` - update message text and rich payload fields
 - `POST /api/chat.delete` - delete message
@@ -20,7 +20,7 @@ Fully stateful Slack Web API emulation with channels, messages, threads, reactio
 
 ## Conversations
 
-- `POST /api/conversations.list` - list channels (cursor pagination)
+- `POST /api/conversations.list` - list conversations (cursor pagination, `types`, `exclude_archived`)
 - `POST /api/conversations.info` - get channel info
 - `POST /api/conversations.create` - create channel
 - `POST /api/conversations.archive` - archive channel
@@ -32,6 +32,11 @@ Fully stateful Slack Web API emulation with channels, messages, threads, reactio
 - `POST /api/conversations.replies` - thread replies with rich message fields
 - `POST /api/conversations.join` - join channel
 - `POST /api/conversations.leave` - leave channel
+- `POST /api/conversations.invite` - invite user to a channel
+- `POST /api/conversations.kick` - remove user from a channel
+- `POST /api/conversations.open` - open or resume DM/MPIM
+- `POST /api/conversations.close` - close DM/MPIM
+- `POST /api/conversations.mark` - set read cursor
 - `POST /api/conversations.members` - list members
 
 ## Users
@@ -77,3 +82,5 @@ When messages are posted, updated, deleted, or reactions change, the emulator di
 - `group_archive` / `group_unarchive` for private lifecycle archive writes
 - `channel_rename` / `group_rename` and matching name message subtypes on `conversations.rename`
 - `message` with public `channel_topic` / `channel_purpose` or private `group_topic` / `group_purpose` subtypes on topic and purpose writes
+- `member_joined_channel` / `member_left_channel` on invite, join, leave, and kick writes
+- `im_created`, `im_open`, `im_close`, `im_marked`, and group open/close/marked events for DM and MPIM writes

packages/@emulators/slack/README.md

@@ -1,6 +1,6 @@
 # @emulators/slack
 
-Fully stateful Slack Web API emulation with channels, messages, threads, reactions, OAuth v2, and incoming webhooks. Chat writes preserve common rich message fields such as `blocks`, `attachments`, `metadata`, formatting flags, unfurl flags, and client message ids. Conversation lifecycle writes update archive state, names, topics, and purposes.
+Fully stateful Slack Web API emulation with channels, messages, threads, reactions, OAuth v2, and incoming webhooks. Chat writes preserve common rich message fields such as `blocks`, `attachments`, `metadata`, formatting flags, unfurl flags, and client message ids. Conversation writes update archive state, names, topics, purposes, membership, DMs, MPIMs, and read cursors.
 
 Part of [emulate](https://github.com/vercel-labs/emulate) — local drop-in replacement services for CI and no-network sandboxes.
 
@@ -14,7 +14,7 @@ npm install @emulators/slack
 
 ### Auth & Chat
 - `POST /api/auth.test` — test authentication
-- `POST /api/chat.postMessage` — post message with text or rich payload fields (supports threads via `thread_ts`)
+- `POST /api/chat.postMessage` — post message with text or rich payload fields (supports threads via `thread_ts` and DM user IDs)
 - `POST /api/chat.postEphemeral` — post ephemeral message outside channel history
 - `POST /api/chat.update` — update message text and rich payload fields
 - `POST /api/chat.delete` — delete message
@@ -25,7 +25,7 @@ npm install @emulators/slack
 - `POST /api/chat.meMessage` — /me message
 
 ### Conversations
-- `POST /api/conversations.list` — list channels (cursor pagination)
+- `POST /api/conversations.list` — list conversations (cursor pagination, `types`, `exclude_archived`)
 - `POST /api/conversations.info` — get channel info
 - `POST /api/conversations.create` — create channel
 - `POST /api/conversations.archive` / `conversations.unarchive` — archive/restore channel
@@ -34,6 +34,9 @@ npm install @emulators/slack
 - `POST /api/conversations.history` — channel history with rich message fields
 - `POST /api/conversations.replies` — thread replies with rich message fields
 - `POST /api/conversations.join` / `conversations.leave` — join/leave
+- `POST /api/conversations.invite` / `conversations.kick` — manage membership
+- `POST /api/conversations.open` / `conversations.close` — open/close DMs and MPIMs
+- `POST /api/conversations.mark` — mark read cursor
 - `POST /api/conversations.members` — list members
 
 ### Users & Reactions

packages/@emulators/slack/src/__tests__/slack-coverage.ts

@@ -25,7 +25,7 @@ export const slackCoverageMatrix: SlackCoverageEntry[] = [
     status: "partial",
     testedBy: ["slack.test.ts", "slack-sdk.test.ts", "slack-events.test.ts"],
     notes:
-      "Text, thread replies, blocks, attachments, metadata, formatting flags, unfurl flags, and client message ids round trip. DMs and membership checks are future work.",
+      "Text, thread replies, blocks, attachments, metadata, formatting flags, unfurl flags, client message ids, and DM user id posting round trip. Full membership checks are future work.",
   },
   {
     family: "chat",
@@ -97,7 +97,8 @@ export const slackCoverageMatrix: SlackCoverageEntry[] = [
     route: "POST /api/conversations.list",
     status: "partial",
     testedBy: ["slack.test.ts", "slack-sdk.test.ts"],
-    notes: "Lists channels with simple cursor pagination and supports exclude_archived. Type filtering is future work.",
+    notes:
+      "Lists conversations with simple cursor pagination, exclude_archived, and basic public/private/IM/MPIM type filtering.",
   },
   {
     family: "conversations",
@@ -200,6 +201,47 @@ export const slackCoverageMatrix: SlackCoverageEntry[] = [
     testedBy: ["slack.test.ts", "slack-sdk.test.ts"],
     notes: "Returns channel member ids with empty next cursor.",
   },
+  {
+    family: "conversations",
+    method: "conversations.invite",
+    route: "POST /api/conversations.invite",
+    status: "partial",
+    testedBy: ["slack.test.ts", "slack-sdk.test.ts", "slack-events.test.ts"],
+    notes:
+      "Adds users to public/private channels and MPIMs, with basic membership errors and member_joined_channel events.",
+  },
+  {
+    family: "conversations",
+    method: "conversations.kick",
+    route: "POST /api/conversations.kick",
+    status: "partial",
+    testedBy: ["slack.test.ts", "slack-sdk.test.ts", "slack-events.test.ts"],
+    notes: "Removes users from public/private channels and MPIMs, with basic errors and member_left_channel events.",
+  },
+  {
+    family: "conversations",
+    method: "conversations.open",
+    route: "POST /api/conversations.open",
+    status: "partial",
+    testedBy: ["slack.test.ts", "slack-sdk.test.ts", "slack-events.test.ts"],
+    notes: "Opens or resumes IM and MPIM conversations by user list or existing conversation id.",
+  },
+  {
+    family: "conversations",
+    method: "conversations.close",
+    route: "POST /api/conversations.close",
+    status: "partial",
+    testedBy: ["slack.test.ts", "slack-sdk.test.ts", "slack-events.test.ts"],
+    notes: "Closes IM and MPIM conversations and reports already_closed no-op responses.",
+  },
+  {
+    family: "conversations",
+    method: "conversations.mark",
+    route: "POST /api/conversations.mark",
+    status: "partial",
+    testedBy: ["slack.test.ts", "slack-sdk.test.ts", "slack-events.test.ts"],
+    notes: "Stores per-user read cursors for conversations and dispatches marked events.",
+  },
   {
     family: "users",
     method: "users.list",