vercel · dancer · Aug 5, 2026 · May 22, 2026 · May 22, 2026 · May 22, 2026
diff --git a/.changeset/legal-ways-reply.md b/.changeset/legal-ways-reply.md
@@ -0,0 +1,6 @@
+---
+"@chat-adapter/slack": minor
+"chat": minor
+---
+
+Add message update and delete lifecycle callbacks, with Slack message_changed and message_deleted dispatch support.
@@ -27,6 +27,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: yes

@@ -31,6 +31,8 @@ features:
     status: yes
     label: Tapbacks
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup:

@@ -41,6 +41,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: yes
   userLookup: yes

@@ -27,6 +27,8 @@ features:
   addReactions: no
   removeReactions: no
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -33,6 +33,8 @@ features:
   addReactions: no
   removeReactions: no
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: yes

@@ -33,6 +33,8 @@ features:
   addReactions: no
   removeReactions: no
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -27,6 +27,8 @@ features:
   addReactions: no
   removeReactions: no
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -35,6 +35,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: yes

@@ -31,6 +31,8 @@ features:
   addReactions: no
   removeReactions: no
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -35,6 +35,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: yes

@@ -37,6 +37,8 @@ features:
     status: yes
     label: Workspace Events
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages:
     status: yes
     label: Requires delegation

@@ -35,6 +35,8 @@ features:
     status: partial
     label: ""
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: no
   ephemeralMessages: no
   userLookup: yes

@@ -41,6 +41,8 @@ features:
   typingIndicator:
     status: partial
     label: Agent sessions
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: no
   ephemeralMessages: no
   userLookup: yes

@@ -39,6 +39,8 @@ features:
   addReactions: no
   removeReactions: no
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   customApiEndpoint: yes

@@ -38,6 +38,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: yes
+  messageDeletedEvents: yes
   directMessages: yes
   ephemeralMessages:
     status: yes

@@ -33,6 +33,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages:
     status: yes

@@ -37,6 +37,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup:

@@ -35,6 +35,8 @@ features:
   addReactions: no
   removeReactions: no
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   customApiEndpoint: yes

@@ -33,6 +33,8 @@ features:
   addReactions: no
   removeReactions: no
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   customApiEndpoint: yes

@@ -37,6 +37,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   customApiEndpoint: yes

@@ -43,6 +43,8 @@ features:
     status: partial
     label: Likes only
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   customApiEndpoint: yes

@@ -41,6 +41,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   customApiEndpoint:

@@ -33,6 +33,8 @@ features:
     label: iMessage only
   removeReactions: no
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -39,6 +39,8 @@ features:
   typingIndicator:
     status: partial
     label: iMessage numbers only; silently ignored on SMS
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -37,6 +37,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -43,6 +43,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -41,6 +41,8 @@ features:
   typingIndicator:
     status: partial
     label: DMs only
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -41,6 +41,8 @@ features:
     status: yes
     label: Unicode emoji
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: no
   ephemeralMessages: no
   userLookup:

@@ -31,6 +31,8 @@ features:
   addReactions: yes
   removeReactions: yes
   typingIndicator: yes
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: yes

@@ -31,6 +31,8 @@ features:
   addReactions: yes
   removeReactions: no
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages:
     status: partial
     label: Inbound only (no openDM in v1)

@@ -41,6 +41,8 @@ features:
   typingIndicator:
     status: partial
     label: Remote only
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -33,6 +33,8 @@ features:
   addReactions: no
   removeReactions: no
   typingIndicator: no
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: no

@@ -35,6 +35,8 @@ features:
   typingIndicator:
     status: partial
     label: 1:1 only
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup:

@@ -51,6 +51,8 @@ features:
   typingIndicator:
     status: partial
     label: FB, Telegram
+  messageUpdatedEvents: no
+  messageDeletedEvents: no
   directMessages: yes
   ephemeralMessages: no
   userLookup: yes

@@ -288,6 +288,60 @@ bot.onReaction(["bookmark"], async (event) => {
 });
 ```
 
+## Handling edits and deletes
+
+`onMessageUpdated` fires when a user edits a message, and `onMessageDeleted` when one is removed. Both are lifecycle events: they never route through `onNewMessage`, `onNewMention`, or `onSubscribedMessage`, and the concurrency strategies do not apply to them.
+
+```typescript title="lib/bot.ts" lineNumbers
+bot.onMessageUpdated(async (thread, message, previousMessage) => {
+  await mirror.update(message.id, message.text);
+  if (previousMessage) {
+    await audit.record(`"${previousMessage.text}" became "${message.text}"`);
+  }
+});
+
+bot.onMessageDeleted(async (event) => {
+  await mirror.remove(event.messageId);
+});
+```
+
+`previousMessage` is the message as it read before the edit, supplied when the platform sends it. Slack does, so you can diff the change rather than only seeing the result. Treat it as optional: a platform that reports edits without the prior text leaves it `undefined`.
+
+The bot's own edits are filtered out, so a streamed reply that renders through post-and-edit does not call `onMessageUpdated` back once per delta.
+
+### Why the two shapes differ
+
+`onMessageUpdated` receives `(thread, message, previousMessage?)` like the other message handlers, because an edit carries a full replacement message.
+
+`onMessageDeleted` receives a single event instead. A delete has no message: platforms usually report only the id of what was removed, and `previousMessage` is best-effort. Use `chat.thread(event.threadId)` when you need a `Thread`, for example to post a notice in the conversation:
+
+```typescript title="lib/bot.ts" lineNumbers
+bot.onMessageDeleted(async (event) => {
+  if (!event.previousMessage) {
+    return;
+  }
+  await chat
+    .thread(event.threadId)
+    .post(`A message from ${event.previousMessage.author.userName} was deleted`);
+});
+```
+
+### MessageDeletedEvent
+
+| Property | Type | Description |
+|---|---|---|
+| `messageId` | `string` | Platform-native id of the deleted message |
+| `threadId` | `string` | Thread the message was in |
+| `channelId` | `string` | Channel the message was in |
+| `platform` | `string` | Adapter name, e.g. `"slack"` |
+| `previousMessage` | `Message \| undefined` | Snapshot, when the platform supplied enough to parse one |
+| `deletedAt` | `Date \| undefined` | When the delete happened, when reported |
+| `raw` | `unknown` | Platform-specific delete event |
+
+<Callout type="warn">
+Only the Slack adapter emits these events today. Registering the handlers on another platform is harmless but nothing will call them. Check the **Message edit events** and **Message delete events** rows on each [adapter page](/adapters) before relying on them.
+</Callout>
+
 ## Handling interactions
 
 For button clicks, slash commands, and modal forms, see the dedicated guides:

@@ -55,6 +55,8 @@ export const PLATFORM_FEATURE_CATEGORIES: AdapterFeatureCategory[] = [
       { key: "addReactions", label: "Add reactions" },
       { key: "removeReactions", label: "Remove reactions" },
       { key: "typingIndicator", label: "Typing indicator" },
+      { key: "messageUpdatedEvents", label: "Message edit events" },
+      { key: "messageDeletedEvents", label: "Message delete events" },
       { key: "directMessages", label: "DMs" },
       { key: "ephemeralMessages", label: "Ephemeral messages" },
       { key: "userLookup", label: "User lookup" },