chat 4.30.0 → 4.32.0

package/dist/ai/index.d.ts

@@ -1,10 +1,10 @@
-import { x as Chat, w as ChannelVisibility } from '../chat-BPjXsoIl.js';
-export { d as AiAssistantMessage, e as AiFilePart, f as AiImagePart, g as AiMessage, h as AiMessagePart, i as AiTextPart, j as AiUserMessage, aZ as ToAiMessagesOptions, b7 as toAiMessages } from '../chat-BPjXsoIl.js';
+import { x as Chat, w as ChannelVisibility } from '../chat-Dm1vQU3i.js';
+export { d as AiAssistantMessage, e as AiFilePart, f as AiImagePart, g as AiMessage, h as AiMessagePart, i as AiTextPart, j as AiUserMessage, aZ as ToAiMessagesOptions, b7 as toAiMessages } from '../chat-Dm1vQU3i.js';
 import * as ai from 'ai';
 import { Tool } from 'ai';
 import '@workflow/serde';
 import 'mdast';
-import '../jsx-runtime-CnDs8rPr.js';
+import '../jsx-runtime-CzthIo1o.js';
 
 /**
  * The Chat instance used by all tools to dispatch operations.

package/dist/{chat-BPjXsoIl.d.ts → chat-Dm1vQU3i.d.ts}

@@ -1,6 +1,6 @@
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 import { Root } from 'mdast';
-import { n as ChatElement, g as CardElement, Q as ModalElement, $ as SelectOptionElement } from './jsx-runtime-CnDs8rPr.js';
+import { n as ChatElement, g as CardElement, Q as ModalElement, $ as SelectOptionElement } from './jsx-runtime-CzthIo1o.js';
 
 interface ThreadHistoryConfig {
     /** Maximum messages to keep per thread (default: 100) */
@@ -1458,7 +1458,7 @@ interface Author {
     fullName: string;
     /** Whether the author is a bot */
     isBot: boolean | "unknown";
-    /** Whether the author is this bot */
+    /** Whether this message was sent by this bot/runtime */
     isMe: boolean;
     /** Unique user ID */
     userId: string;
@@ -3138,6 +3138,7 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
      * subscription status, mention detection, and pattern matching.
      */
     private dispatchToHandlers;
+    private setMentionFlags;
     private createThread;
     /**
      * Detect if the bot was mentioned in the message.

package/dist/{chunk-V25FKIIL.js → chunk-LNXHNIFE.js}

@@ -361,6 +361,7 @@ function Button(options) {
 function LinkButton(options) {
   return {
     type: "link-button",
+    id: options.id,
     url: options.url,
     label: options.label,
     style: options.style
@@ -893,6 +894,7 @@ function resolveJSXElement(element) {
     }
     const label = processedChildren.length > 0 ? processedChildren.map(String).join("") : props.label ?? "";
     return LinkButton({
+      id: props.id,
       url: props.url,
       label,
       style: props.style

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { ay as PostableObject, b as Adapter, az as PostableObjectContext, aN as StreamChunk, aU as ThreadHistoryCache, aV as ThreadHistoryConfig, aO as StreamEvent, L as EmojiFormats, M as EmojiMapConfig, N as EmojiValue, b4 as WellKnownEmoji, G as CustomEmojiMap, c as AdapterPostableMessage } from './chat-BPjXsoIl.js';
-export { A as ActionEvent, a as ActionHandler, d as AiAssistantMessage, e as AiFilePart, f as AiImagePart, g as AiMessage, h as AiMessagePart, i as AiTextPart, j as AiUserMessage, k as AppHomeOpenedEvent, l as AppHomeOpenedHandler, m as AppendInput, n as AppendOptions, o as AssistantContextChangedEvent, p as AssistantContextChangedHandler, q as AssistantThreadStartedEvent, r as AssistantThreadStartedHandler, s as Attachment, t as Author, C as Channel, u as ChannelImpl, v as ChannelInfo, w as ChannelVisibility, x as Chat, y as ChatConfig, z as ChatInstance, B as ConcurrencyConfig, D as ConcurrencyStrategy, E as ConsoleLogger, F as CountQuery, H as DeleteTarget, I as DirectMessageHandler, J as DurationString, K as Emoji, O as EphemeralMessage, P as FetchDirection, Q as FetchOptions, R as FetchResult, S as FileUpload, T as FormattedContent, U as IdentityContext, V as IdentityResolver, W as LinkPreview, X as ListQuery, Y as ListThreadsOptions, Z as ListThreadsResult, _ as Lock, $ as LockScope, a0 as LockScopeContext, a1 as LogLevel, a2 as Logger, a3 as MarkdownTextChunk, a4 as MemberJoinedChannelEvent, a5 as MemberJoinedChannelHandler, a6 as MentionHandler, a7 as Message, a8 as MessageContext, a9 as MessageData, aa as MessageHandler, ab as MessageMetadata, ac as MessageSubject, ad as ModalClearResponse, ae as ModalCloseEvent, af as ModalCloseHandler, ag as ModalCloseResponse, ah as ModalErrorsResponse, ai as ModalPushResponse, aj as ModalResponse, ak as ModalSubmitEvent, al as ModalSubmitHandler, am as ModalUpdateResponse, an as OptionsLoadEvent, ao as OptionsLoadGroup, ap as OptionsLoadHandler, aq as OptionsLoadResult, ar as PlanUpdateChunk, as as PostEphemeralOptions, at as Postable, au as PostableAst, av as PostableCard, aw as PostableMarkdown, ax as PostableMessage, aA as PostableRaw, aB as QueueEntry, aC as RawMessage, aD as ReactionEvent, aE as ReactionHandler, aF as ScheduledMessage, aG as SentMessage, aH as SerializedChannel, aI as SerializedMessage, aJ as SerializedThread, aK as SlashCommandEvent, aL as SlashCommandHandler, aM as StateAdapter, aP as StreamOptions, aQ as SubscribedMessageHandler, aR as THREAD_STATE_TTL_MS, aS as TaskUpdateChunk, aT as Thread, aW as ThreadImpl, aX as ThreadInfo, aY as ThreadSummary, aZ as ToAiMessagesOptions, a_ as TranscriptEntry, a$ as TranscriptRole, b0 as TranscriptsApi, b1 as TranscriptsConfig, b2 as UserInfo, b3 as WebhookOptions, b5 as deriveChannelId, b6 as isPostableObject, b7 as toAiMessages } from './chat-BPjXsoIl.js';
+import { ay as PostableObject, b as Adapter, az as PostableObjectContext, aN as StreamChunk, aU as ThreadHistoryCache, aV as ThreadHistoryConfig, aO as StreamEvent, L as EmojiFormats, M as EmojiMapConfig, N as EmojiValue, b4 as WellKnownEmoji, G as CustomEmojiMap, c as AdapterPostableMessage } from './chat-Dm1vQU3i.js';
+export { A as ActionEvent, a as ActionHandler, d as AiAssistantMessage, e as AiFilePart, f as AiImagePart, g as AiMessage, h as AiMessagePart, i as AiTextPart, j as AiUserMessage, k as AppHomeOpenedEvent, l as AppHomeOpenedHandler, m as AppendInput, n as AppendOptions, o as AssistantContextChangedEvent, p as AssistantContextChangedHandler, q as AssistantThreadStartedEvent, r as AssistantThreadStartedHandler, s as Attachment, t as Author, C as Channel, u as ChannelImpl, v as ChannelInfo, w as ChannelVisibility, x as Chat, y as ChatConfig, z as ChatInstance, B as ConcurrencyConfig, D as ConcurrencyStrategy, E as ConsoleLogger, F as CountQuery, H as DeleteTarget, I as DirectMessageHandler, J as DurationString, K as Emoji, O as EphemeralMessage, P as FetchDirection, Q as FetchOptions, R as FetchResult, S as FileUpload, T as FormattedContent, U as IdentityContext, V as IdentityResolver, W as LinkPreview, X as ListQuery, Y as ListThreadsOptions, Z as ListThreadsResult, _ as Lock, $ as LockScope, a0 as LockScopeContext, a1 as LogLevel, a2 as Logger, a3 as MarkdownTextChunk, a4 as MemberJoinedChannelEvent, a5 as MemberJoinedChannelHandler, a6 as MentionHandler, a7 as Message, a8 as MessageContext, a9 as MessageData, aa as MessageHandler, ab as MessageMetadata, ac as MessageSubject, ad as ModalClearResponse, ae as ModalCloseEvent, af as ModalCloseHandler, ag as ModalCloseResponse, ah as ModalErrorsResponse, ai as ModalPushResponse, aj as ModalResponse, ak as ModalSubmitEvent, al as ModalSubmitHandler, am as ModalUpdateResponse, an as OptionsLoadEvent, ao as OptionsLoadGroup, ap as OptionsLoadHandler, aq as OptionsLoadResult, ar as PlanUpdateChunk, as as PostEphemeralOptions, at as Postable, au as PostableAst, av as PostableCard, aw as PostableMarkdown, ax as PostableMessage, aA as PostableRaw, aB as QueueEntry, aC as RawMessage, aD as ReactionEvent, aE as ReactionHandler, aF as ScheduledMessage, aG as SentMessage, aH as SerializedChannel, aI as SerializedMessage, aJ as SerializedThread, aK as SlashCommandEvent, aL as SlashCommandHandler, aM as StateAdapter, aP as StreamOptions, aQ as SubscribedMessageHandler, aR as THREAD_STATE_TTL_MS, aS as TaskUpdateChunk, aT as Thread, aW as ThreadImpl, aX as ThreadInfo, aY as ThreadSummary, aZ as ToAiMessagesOptions, a_ as TranscriptEntry, a$ as TranscriptRole, b0 as TranscriptsApi, b1 as TranscriptsConfig, b2 as UserInfo, b3 as WebhookOptions, b5 as deriveChannelId, b6 as isPostableObject, b7 as toAiMessages } from './chat-Dm1vQU3i.js';
 import { Root, List, Content, Blockquote, Code, Emphasis, InlineCode, Delete, Link, ListItem, Paragraph, Strong, TableCell, Table as Table$1, TableRow, Text } from 'mdast';
 export { Blockquote, Code, Content, Delete, Emphasis, InlineCode, Link, List, ListItem, Table as MdastTable, Nodes, Paragraph, Root, Strong, TableCell, TableRow, Text } from 'mdast';
-import { g as CardElement, C as CardChild, A as ActionsComponent, B as ButtonComponent, f as CardComponent, j as CardLinkComponent, a9 as TextComponent, D as DividerComponent, E as ExternalSelectComponent, F as FieldComponent, w as FieldsComponent, I as ImageComponent, L as LinkButtonComponent, P as ModalComponent, T as RadioSelectComponent, W as SectionComponent, Y as SelectComponent, _ as SelectOptionComponent, a3 as Table$2, ab as TextInputComponent, ah as cardChildToFallbackText$1, ai as fromReactElement$1, aj as fromReactModalElement$1, ak as isCardElement$1, am as isJSX$1, an as isModalElement$1, ar as toCardElement$1, as as toModalElement$1 } from './jsx-runtime-CnDs8rPr.js';
-export { a as ActionsElement, b as ButtonElement, c as ButtonOptions, d as ButtonProps, e as ButtonStyle, h as CardJSXElement, i as CardJSXProps, k as CardLinkProps, l as CardOptions, m as CardProps, n as ChatElement, o as ContainerProps, p as DividerElement, q as DividerProps, r as ExternalSelectElement, s as ExternalSelectOptions, t as ExternalSelectProps, u as FieldElement, v as FieldProps, x as FieldsElement, z as ImageElement, G as ImageProps, H as LinkButtonElement, K as LinkButtonOptions, M as LinkButtonProps, N as LinkElement, O as ModalChild, Q as ModalElement, R as ModalOptions, S as ModalProps, U as RadioSelectElement, V as RadioSelectOptions, X as SectionElement, Z as SelectElement, $ as SelectOptionElement, a0 as SelectOptionProps, a1 as SelectOptions, a2 as SelectProps, a4 as TableAlignment, a6 as TableElement, a7 as TableOptions, aa as TextElement, ac as TextInputElement, ad as TextInputOptions, ae as TextInputProps, af as TextProps, ag as TextStyle } from './jsx-runtime-CnDs8rPr.js';
+import { g as CardElement, C as CardChild, A as ActionsComponent, B as ButtonComponent, f as CardComponent, j as CardLinkComponent, a9 as TextComponent, D as DividerComponent, E as ExternalSelectComponent, F as FieldComponent, w as FieldsComponent, I as ImageComponent, L as LinkButtonComponent, P as ModalComponent, T as RadioSelectComponent, W as SectionComponent, Y as SelectComponent, _ as SelectOptionComponent, a3 as Table$2, ab as TextInputComponent, ah as cardChildToFallbackText$1, ai as fromReactElement$1, aj as fromReactModalElement$1, ak as isCardElement$1, am as isJSX$1, an as isModalElement$1, ar as toCardElement$1, as as toModalElement$1 } from './jsx-runtime-CzthIo1o.js';
+export { a as ActionsElement, b as ButtonElement, c as ButtonOptions, d as ButtonProps, e as ButtonStyle, h as CardJSXElement, i as CardJSXProps, k as CardLinkProps, l as CardOptions, m as CardProps, n as ChatElement, o as ContainerProps, p as DividerElement, q as DividerProps, r as ExternalSelectElement, s as ExternalSelectOptions, t as ExternalSelectProps, u as FieldElement, v as FieldProps, x as FieldsElement, z as ImageElement, G as ImageProps, H as LinkButtonElement, K as LinkButtonOptions, M as LinkButtonProps, N as LinkElement, O as ModalChild, Q as ModalElement, R as ModalOptions, S as ModalProps, U as RadioSelectElement, V as RadioSelectOptions, X as SectionElement, Z as SelectElement, $ as SelectOptionElement, a0 as SelectOptionProps, a1 as SelectOptions, a2 as SelectProps, a4 as TableAlignment, a6 as TableElement, a7 as TableOptions, aa as TextElement, ac as TextInputElement, ad as TextInputOptions, ae as TextInputProps, af as TextProps, ag as TextStyle } from './jsx-runtime-CzthIo1o.js';
 import '@workflow/serde';
 
 /**
@@ -53,6 +53,8 @@ interface StartPlanOptions {
     initialMessage: PlanContent;
 }
 interface AddTaskOptions {
+    /** When true (default), mark existing in_progress tasks complete before adding. */
+    autoCompletePrevious?: boolean;
     /** Task details/substeps. */
     children?: PlanContent;
     title: PlanContent;
@@ -74,6 +76,7 @@ interface CompletePlanOptions {
  *
  * Create a plan with `new Plan({ initialMessage: "..." })` and post it with `thread.post(plan)`.
  * After posting, use methods like `addTask()`, `updateTask()`, and `complete()` to update it.
+ * For parallel steps, pass `autoCompletePrevious: false` to `addTask()` and use `updateTask({ id })` to update individual tasks.
  *
  * @example
  * ```typescript

package/dist/index.js

@@ -60,7 +60,7 @@ import {
   toModalElement,
   toPlainText,
   walkAst
-} from "./chunk-V25FKIIL.js";
+} from "./chunk-LNXHNIFE.js";
 import {
   toAiMessages
 } from "./chunk-HD375J7S.js";
@@ -3020,7 +3020,7 @@ var Chat = class {
       author: event.user,
       metadata: { dateSent: /* @__PURE__ */ new Date(), edited: false },
       attachments: []
-    }) : {};
+    }) : void 0;
     const thread = event.threadId ? await this.createThread(
       event.adapter,
       event.threadId,
@@ -3140,7 +3140,7 @@ var Chat = class {
     const thread = await this.createThread(
       event.adapter,
       event.threadId,
-      event.message ?? {},
+      event.message,
       isSubscribed
     );
     const fullEvent = {
@@ -3228,7 +3228,7 @@ var Chat = class {
       );
     }
     const threadId = await adapter.openDM(userId);
-    return this.createThread(adapter, threadId, {}, false);
+    return this.createThread(adapter, threadId, void 0, false);
   }
   /**
    * Look up user information by user ID.
@@ -3333,7 +3333,7 @@ var Chat = class {
         "ADAPTER_NOT_FOUND"
       );
     }
-    return this.createThread(adapter, threadId, {}, false);
+    return this.createThread(adapter, threadId, void 0, false);
   }
   /**
    * Infer which adapter to use based on the userId format.
@@ -3754,7 +3754,7 @@ var Chat = class {
    * subscription status, mention detection, and pattern matching.
    */
   async dispatchToHandlers(adapter, threadId, message, context) {
-    message.isMention = message.isMention || this.detectMention(adapter, message);
+    const hasMention = this.setMentionFlags(adapter, message, context);
     const isSubscribed = await this._stateAdapter.isSubscribed(threadId);
     this.logger.debug("Subscription check", {
       threadId,
@@ -3814,7 +3814,7 @@ var Chat = class {
       );
       return;
     }
-    if (message.isMention) {
+    if (message.isMention || hasMention) {
       this.logger.debug("Bot mentioned", {
         threadId,
         text: message.text.slice(0, 100)
@@ -3850,6 +3850,15 @@ var Chat = class {
       });
     }
   }
+  setMentionFlags(adapter, message, context) {
+    message.isMention = message.isMention || this.detectMention(adapter, message);
+    let hasMention = message.isMention === true;
+    for (const skipped of context?.skipped ?? []) {
+      skipped.isMention = skipped.isMention || this.detectMention(adapter, skipped);
+      hasMention = hasMention || skipped.isMention === true;
+    }
+    return hasMention;
+  }
   createThread(adapter, threadId, initialMessage, isSubscribedContext = false) {
     const channelId = adapter.channelIdFromThreadId(threadId);
     const isDM = adapter.isDM?.(threadId) ?? false;
@@ -4064,9 +4073,12 @@ var Plan = class {
       return null;
     }
     const title = contentToPlainText(options.title) || "Task";
-    for (const task of this._model.tasks) {
-      if (task.status === "in_progress") {
-        task.status = "complete";
+    const autoCompletePrevious = options.autoCompletePrevious ?? true;
+    if (autoCompletePrevious) {
+      for (const task of this._model.tasks) {
+        if (task.status === "in_progress") {
+          task.status = "complete";
+        }
       }
     }
     const nextTask = {

package/dist/{jsx-runtime-CnDs8rPr.d.ts → jsx-runtime-CzthIo1o.d.ts}

@@ -68,6 +68,8 @@ interface ButtonElement {
 }
 /** Link button element that opens a URL */
 interface LinkButtonElement {
+    /** Optional action identifier emitted by platforms that report link clicks */
+    id?: string;
     /** Button label text */
     label: string;
     /** Visual style */
@@ -268,6 +270,8 @@ interface ButtonOptions {
 declare function Button(options: ButtonOptions): ButtonElement;
 /** Options for LinkButton */
 interface LinkButtonOptions {
+    /** Optional action identifier emitted by platforms that report link clicks */
+    id?: string;
     /** Button label text */
     label: string;
     /** Visual style */
@@ -546,6 +550,7 @@ interface ButtonProps {
 /** Props for LinkButton component in JSX */
 interface LinkButtonProps {
     children?: string | number | (string | number | undefined)[];
+    id?: string;
     label?: string;
     style?: ButtonStyle;
     url: string;

package/dist/jsx-runtime.d.ts

@@ -1 +1 @@
-export { A as ActionsComponent, B as ButtonComponent, d as ButtonProps, f as CardComponent, h as CardJSXElement, i as CardJSXProps, j as CardLinkComponent, k as CardLinkProps, m as CardProps, n as ChatElement, o as ContainerProps, D as DividerComponent, q as DividerProps, E as ExternalSelectComponent, t as ExternalSelectProps, F as FieldComponent, v as FieldProps, w as FieldsComponent, y as Fragment, I as ImageComponent, G as ImageProps, J as JSX, L as LinkButtonComponent, M as LinkButtonProps, P as ModalComponent, S as ModalProps, T as RadioSelectComponent, W as SectionComponent, Y as SelectComponent, _ as SelectOptionComponent, a0 as SelectOptionProps, a2 as SelectProps, a5 as TableComponent, a8 as TableProps, a9 as TextComponent, ab as TextInputComponent, ae as TextInputProps, af as TextProps, al as isCardLinkProps, am as isJSX, ao as jsx, ap as jsxDEV, aq as jsxs, ar as toCardElement, as as toModalElement } from './jsx-runtime-CnDs8rPr.js';
+export { A as ActionsComponent, B as ButtonComponent, d as ButtonProps, f as CardComponent, h as CardJSXElement, i as CardJSXProps, j as CardLinkComponent, k as CardLinkProps, m as CardProps, n as ChatElement, o as ContainerProps, D as DividerComponent, q as DividerProps, E as ExternalSelectComponent, t as ExternalSelectProps, F as FieldComponent, v as FieldProps, w as FieldsComponent, y as Fragment, I as ImageComponent, G as ImageProps, J as JSX, L as LinkButtonComponent, M as LinkButtonProps, P as ModalComponent, S as ModalProps, T as RadioSelectComponent, W as SectionComponent, Y as SelectComponent, _ as SelectOptionComponent, a0 as SelectOptionProps, a2 as SelectProps, a5 as TableComponent, a8 as TableProps, a9 as TextComponent, ab as TextInputComponent, ae as TextInputProps, af as TextProps, al as isCardLinkProps, am as isJSX, ao as jsx, ap as jsxDEV, aq as jsxs, ar as toCardElement, as as toModalElement } from './jsx-runtime-CzthIo1o.js';

package/dist/jsx-runtime.js

@@ -7,7 +7,7 @@ import {
   jsxs,
   toCardElement,
   toModalElement
-} from "./chunk-V25FKIIL.js";
+} from "./chunk-LNXHNIFE.js";
 export {
   Fragment,
   isCardLinkProps,

package/docs/adapters.mdx

@@ -1,146 +1,159 @@
 ---
-title: Platform Adapters
-description: Platform-specific adapters that connect your bot to any messaging platform.
+title: Overview
+description: Overview of Chat SDK adapters and the static adapter catalog.
 type: overview
 prerequisites:
   - /docs/getting-started
 ---
 
-Adapters handle webhook verification, message parsing, and API calls for each platform. Install only the adapters you need. Browse all available adapters — including community-built ones — on the [Adapters](/adapters) page.
+Adapters connect Chat SDK to messaging platforms and state backends. Install only the adapters you need, then register them on your `Chat` instance.
 
-Need a browser chat UI? See the [Web adapter](/adapters/official/web) — it speaks the AI SDK UI stream protocol and works with React (`@ai-sdk/react`), Vue (`@ai-sdk/vue`), and Svelte (`@ai-sdk/svelte`), so the same bot serves Slack, Teams, **and** any browser framework out of the box.
+Use the dedicated guides for adapter-specific concepts:
+
+- [Platform Adapters](/docs/platform-adapters) cover webhook verification, message parsing, API calls, feature support, and multi-platform bots.
+- [State Adapters](/docs/state-adapters) cover subscriptions, distributed locking, and caching.
+- Browse all official, vendor-official, and community adapters on the [Adapters](/adapters) listing page.
 
 Ready to build your own? Follow the [building](/docs/contributing/building) guide.
 
-## Feature matrix
-
-<GlobalFeatureMatrix type="platform" />
-### Messaging
-
-| Feature | [Slack](/adapters/slack) | [Teams](/adapters/teams) | [Google Chat](/adapters/google-chat) | [Discord](/adapters/discord) | [Telegram](/adapters/telegram) | [GitHub](/adapters/github) | [Linear](/adapters/linear) | [WhatsApp](/adapters/whatsapp) | [Messenger](/adapters/messenger) |
-|---------|-------|-------|-------------|---------|---------|--------|--------|-----------|-----------|
-| Post message | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> |
-| Edit message | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Warn /> Partial | <Cross /> | <Cross /> |
-| Delete message | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Warn /> Partial | <Cross /> | <Cross /> |
-| File uploads | <Check /> | <Check /> | <Cross /> | <Check /> | <Warn /> Single file/media | <Cross /> | <Cross /> | <Check /> Images, audio, docs | <Cross /> |
-| Streaming | <Check /> Native | <Warn /> Native (DMs) / Buffered | <Warn /> Post+Edit | <Warn /> Post+Edit | <Warn /> Private chat drafts / Post+Edit | <Warn /> Buffered | <Warn /> Agent sessions / Post+Edit | <Warn /> Buffered | <Warn /> Buffered |
-| Scheduled messages | <Check /> Native | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> |
-
-### Rich content
-
-| Feature | Slack | Teams | Google Chat | Discord | Telegram | GitHub | Linear | WhatsApp | Messenger |
-|---------|-------|-------|-------------|---------|----------|--------|--------|-----------|-----------|
-| Card format | Block Kit | Adaptive Cards | Google Chat Cards | Embeds | Markdown + inline keyboard buttons | GFM Markdown | Markdown | WhatsApp templates | Generic/Button Templates |
-| Buttons | <Check /> | <Check /> | <Check /> | <Check /> | <Warn /> Inline keyboard callbacks | <Cross /> | <Cross /> | <Check /> Interactive replies | <Warn /> Max 3, postback |
-| Link buttons | <Check /> | <Check /> | <Check /> | <Check /> | <Warn /> Inline keyboard URLs | <Cross /> | <Cross /> | <Cross /> | <Check /> |
-| Select menus | <Check /> | <Cross /> | <Check /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> |
-| Tables | <Check /> Block Kit | <Check /> GFM | <Warn /> ASCII | <Check /> GFM | <Warn /> ASCII | <Check /> GFM | <Check /> GFM | <Cross /> | <Warn /> ASCII |
-| Fields | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Warn /> Template variables | <Warn /> ASCII |
-| Images in cards | <Check /> | <Check /> | <Check /> | <Check /> | <Cross /> | <Check /> | <Cross /> | <Check /> | <Check /> |
-| Modals | <Check /> | <Check /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> |
-
-### Conversations
-
-| Feature | Slack | Teams | Google Chat | Discord | Telegram | GitHub | Linear | WhatsApp | Messenger |
-|---------|-------|-------|-------------|---------|----------|--------|--------|-----------|-----------|
-| Slash commands | <Check /> | <Cross /> | <Cross /> | <Check /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> |
-| Mentions | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Cross /> | <Check /> |
-| Add reactions | <Check /> | <Cross /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Cross /> |
-| Remove reactions | <Check /> | <Cross /> | <Check /> | <Check /> | <Check /> | <Warn /> | <Warn /> | <Check /> | <Cross /> |
-| Typing indicator | <Check /> | <Check /> | <Cross /> | <Check /> | <Check /> | <Cross /> | <Warn /> Agent sessions | <Warn /> | <Check /> |
-| DMs | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Cross /> | <Cross /> | <Check /> | <Check /> |
-| Ephemeral messages | <Check /> Native | <Cross /> | <Check /> Native | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> |
-| User lookup ([`getUser`](/docs/api/chat#getuser)) | <Check /> | <Warn /> Cached | <Warn /> Cached | <Check /> | <Warn /> Seen users | <Check /> | <Check /> | <Cross /> | <Cross /> |
-| Parent subject ([`message.subject`](/docs/subject)) | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Check /> | <Check /> | <Cross /> | <Cross /> |
-| Native client ([`.webClient` / `.octokit` / `.linearClient`](/docs/api/chat#getadapter)) | <Check /> | <Cross /> | <Cross /> | <Cross /> | <Cross /> | <Check /> | <Check /> | <Cross /> | <Cross /> |
-| Custom API endpoint (`apiUrl`) | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> |
-
-### Message history
-
-| Feature | Slack | Teams | Google Chat | Discord | Telegram | GitHub | Linear | WhatsApp | Messenger |
-|---------|-------|-------|-------------|---------|----------|--------|--------|-----------|-----------|
-| Fetch messages | <Check /> | <Check /> | <Check /> | <Check /> | <Warn /> Cached | <Check /> | <Check /> | <Warn /> Cached sent messages only | <Warn /> Cached sent messages only |
-| Fetch single message | <Check /> | <Cross /> | <Cross /> | <Cross /> | <Warn /> Cached | <Cross /> | <Cross /> | <Cross /> | <Warn /> Cached |
-| Fetch thread info | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> |
-| Fetch channel messages | <Check /> | <Check /> | <Check /> | <Check /> | <Warn /> Cached | <Check /> | <Cross /> | <Cross /> | <Warn /> Cached |
-| List threads | <Check /> | <Check /> | <Check /> | <Check /> | <Cross /> | <Check /> | <Cross /> | <Cross /> | <Cross /> |
-| Fetch channel info | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Cross /> | <Cross /> | <Check /> |
-| Post channel message | <Check /> | <Check /> | <Check /> | <Check /> | <Check /> | <Cross /> | <Cross /> | <Check /> | <Check /> |
-
-<Callout type="info">
-<Warn /> indicates partial support — the feature works with limitations. See individual adapter pages for details.
-</Callout>
-
-## How adapters work
-
-Each adapter implements a standard interface that the `Chat` class uses to route events and send messages. When a webhook arrives:
-
-1. The adapter verifies the request signature
-2. Parses the platform-specific payload into a normalized `Message`
-3. Routes to your handlers via the `Chat` class
-4. Converts outgoing messages from markdown/AST/cards to the platform's native format
-
-## Using multiple adapters
-
-Register multiple [adapters](/adapters) and your event handlers work across all of them:
-
-```typescript title="lib/bot.ts" lineNumbers
-import { Chat } from "chat";
-import { createSlackAdapter } from "@chat-adapter/slack";
-import { createTeamsAdapter } from "@chat-adapter/teams";
-import { createGoogleChatAdapter } from "@chat-adapter/gchat";
-import { createRedisState } from "@chat-adapter/state-redis";
-
-const bot = new Chat({
-  userName: "mybot",
-  adapters: {
-    slack: createSlackAdapter(),
-    teams: createTeamsAdapter(),
-    gchat: createGoogleChatAdapter(),
-  },
-  state: createRedisState(),
-});
-
-// This handler fires for mentions on any platform
-bot.onNewMention(async (thread) => {
-  await thread.subscribe();
-  await thread.post("Hello!");
-});
-```
+## Adapter catalog (`chat/adapters`)
 
-Each adapter auto-detects credentials from environment variables, so you only need to pass config when overriding defaults.
+The `chat/adapters` subpath is a static catalog of official and vendor-official adapters. It imports no adapter packages, so you can use it from setup screens, build scripts, or onboarding flows without pulling in Slack, Teams, Redis, or other platform SDKs.
 
-<Callout type="info">
-  The examples above use Redis for state. See [State Adapters](/docs/state) for all available options.
-</Callout>
+```typescript title="scripts/list-adapters.ts" lineNumbers
+import { ADAPTER_NAMES, getAdapter } from "chat/adapters";
 
-Each adapter creates a webhook handler accessible via `bot.webhooks.<name>`.
+for (const slug of ADAPTER_NAMES) {
+  const adapter = getAdapter(slug);
+  console.log(adapter.name, adapter.packageName, adapter.peerDeps);
+}
+```
 
-## Customizing an adapter via subclassing
+Use the env helpers when you need to show setup instructions or inject secrets for one adapter:
 
-Each official adapter exposes its extension surface as `protected` members so you can subclass it to override or extend platform-specific behavior without forking the package. Use this when you need to handle a payload type the built-in adapter doesn't cover, intercept verification, or wrap an existing handler.
+```typescript lineNumbers
+import { getAdapter, getSecretEnvVars } from "chat/adapters";
 
-```typescript title="lib/custom-telegram.ts" lineNumbers
-import { TelegramAdapter, type TelegramUpdate } from "@chat-adapter/telegram";
-import type { WebhookOptions } from "chat";
+const slack = getAdapter("slack");
+const secrets = getSecretEnvVars("slack").map((envVar) => envVar.key);
 
-export class CustomTelegramAdapter extends TelegramAdapter {
-  protected override processUpdate(
-    update: TelegramUpdate,
-    options?: WebhookOptions
-  ): void {
-    // Handle a payload type the base adapter doesn't, e.g. chat_join_request.
-    if ("chat_join_request" in update) {
-      this.logger.info("Received chat_join_request", { update });
-      return;
-    }
-    super.processUpdate(update, options);
-  }
-}
+console.log(slack.name, secrets);
 ```
 
-Construct your subclass anywhere you'd construct the base adapter — for example, `adapters: { telegram: new CustomTelegramAdapter({ ... }) }`. Members marked `private` (internal caches, in-flight runtime state, one-shot warning flags) intentionally remain inaccessible; if you find a hook you need that isn't `protected`, please open an issue.
-
-<Callout type="warn">
-  The `protected` extension surface is intentionally broader than the public API but is not yet considered fully stable. Method signatures may evolve (renames, parameter changes, new hook splits) in minor releases as we learn from real-world subclasses. Pin the adapter version you build against, watch the changelog for the affected adapter, and prefer overriding the smallest hook that solves your problem so upgrades stay easy. If you rely on a particular hook, please open an issue so we can promote it to a stable, documented extension point.
-</Callout>
+The catalog intentionally covers official and vendor-official adapters. Community adapters live on the [Adapters](/adapters) listing page.
+
+### Environment specs
+
+Each adapter entry includes an `env` spec:
+
+- `required` lists variables needed regardless of auth mode.
+- `credentialModes` groups mutually exclusive ways to authenticate, such as a bot token vs OAuth client credentials.
+- `optional` lists tuning variables that are safe to omit.
+- `config` lists constructor options that do not have an environment-variable equivalent.
+
+### Types
+
+The main `CatalogAdapter` metadata shape is:
+
+<TypeTable
+  type={{
+    slug: {
+      type: "string",
+      description: "Stable catalog slug. Matches the key in `ADAPTERS`.",
+    },
+    name: {
+      type: "string",
+      description: "Display name.",
+    },
+    description: {
+      type: "string",
+      description: "One-line summary of what the adapter connects to.",
+    },
+    packageName: {
+      type: "string",
+      description: "NPM package that provides the adapter implementation.",
+    },
+    type: {
+      type: '"platform" | "state"',
+      description: "Whether the adapter connects to a platform or stores Chat SDK state.",
+    },
+    group: {
+      type: '"official" | "vendor-official"',
+      description: "Catalog group used by the docs adapter listing.",
+    },
+    peerDeps: {
+      type: "readonly string[]",
+      description: "Runtime packages the adapter expects the consuming app to provide or install alongside it.",
+    },
+    env: {
+      type: "AdapterEnvSpec",
+      description: "Environment variables and constructor-only configuration.",
+    },
+  }}
+/>
+
+<TypeTable
+  type={{
+    required: {
+      type: "readonly EnvVar[]",
+      description: "Variables needed regardless of credential mode.",
+    },
+    credentialModes: {
+      type: "readonly EnvGroup[]",
+      description: "Mutually exclusive credential groups. A caller usually satisfies exactly one group.",
+    },
+    optional: {
+      type: "readonly EnvVar[]",
+      description: "Optional environment variables that tune behavior.",
+    },
+    config: {
+      type: "readonly string[]",
+      description: "Constructor options that have no environment-variable equivalent.",
+    },
+    notes: {
+      type: "string",
+      description: "Additional caveats that do not fit the structured fields.",
+    },
+  }}
+/>
+
+<TypeTable
+  type={{
+    label: {
+      type: "string",
+      description: "Human-readable name for this credential mode.",
+    },
+    vars: {
+      type: "readonly EnvVar[]",
+      description: "Variables that together satisfy this mode.",
+    },
+  }}
+/>
+
+<TypeTable
+  type={{
+    key: {
+      type: "string",
+      description: "Canonical environment variable name.",
+    },
+    description: {
+      type: "string",
+      description: "Short description of what the value configures.",
+    },
+    secret: {
+      type: "boolean",
+      description: "Whether the value should be masked in logs and setup UIs.",
+    },
+    aliases: {
+      type: "readonly string[]",
+      description: "Alternative variable names accepted for the same value.",
+    },
+  }}
+/>
+
+### Helpers
+
+- `getAdapter(slug)` returns one catalog entry, or `undefined` for unknown slugs.
+- `isAdapterSlug(slug)` narrows a string to `AdapterSlug`.
+- `listEnvVars(slug)` flattens required, credential-mode, and optional env vars, de-duplicated by key.
+- `getSecretEnvVars(slug)` returns the subset of `listEnvVars(slug)` marked as secrets.

package/docs/ai/index.mdx

@@ -64,6 +64,6 @@ bot.onSubscribedMessage(async (thread) => {
 
 ## Resources
 
-- [Human-in-the-Loop with Chat SDK and Workflow SDK](https://vercel.com/kb/guide/human-in-the-loop-with-chat-sdk-and-workflow-sdk) — Pause durable workflows on Slack approval cards using Chat SDK and Workflow SDK. Uses `createWebhook` to suspend workflows until a button click, with patterns for multi-stage approvals, timeouts via durable sleep, and approver validation.
+- [Human-in-the-Loop with Chat SDK and Workflow SDK](https://vercel.com/kb/guide/human-in-the-loop-with-chat-sdk-and-workflow-sdk?utm_source=chat-sdk_site&utm_medium=docs&utm_campaign=ai&utm_content=human-in-the-loop-with-chat-sdk-and-workflow-sdk) — Pause durable workflows on Slack approval cards using Chat SDK and Workflow SDK. Uses `createWebhook` to suspend workflows until a button click, with patterns for multi-stage approvals, timeouts via durable sleep, and approver validation.
 
-See all guides and templates on the [resources](/resources) page.
+See all guides and templates on the [resources](/resources?utm_source=chat-sdk_site&utm_medium=docs&utm_campaign=ai&utm_content=resources) page.

package/docs/api/cards.mdx

@@ -130,14 +130,21 @@ CardLink({ url: "https://example.com", label: "Visit Site" })
 
 ## LinkButton
 
-Button that opens a URL. No `onAction` handler needed.
+Button that opens a URL. No `onAction` handler needed for navigation. On
+platforms that emit link-button click events, such as Slack, pass `id` when you
+need a stable action identifier for routing or analytics.
 
 ```typescript
 LinkButton({ url: "https://example.com", label: "View Docs" })
+LinkButton({ id: "view_docs", url: "https://example.com", label: "View Docs" })
 ```
 
 <TypeTable
   type={{
+    id: {
+      description: 'Optional action identifier emitted by platforms that report link clicks.',
+      type: 'string',
+    },
     url: {
       description: 'URL to open when clicked.',
       type: 'string',

package/docs/api/message.mdx

@@ -90,7 +90,11 @@ import { Message } from "chat";
 
 ### How `isMe` works
 
-Each adapter detects whether a message came from the bot itself. The detection logic varies by platform:
+Each adapter detects whether a message came from the bot itself. Chat SDK filters `isMe: true` messages before handlers run so bot replies do not loop back into `onNewMessage`, `onNewMention`, or subscribed-thread handlers.
+
+`isMe` means "sent by this bot/runtime", not "sent by the authenticated user or account". For adapters backed by a user-owned account, do not blindly map platform fields like `fromMe` to `isMe`. Only set `isMe: true` for messages the adapter sent itself. If the platform echoes sent messages back through the webhook, track sent message IDs and mark only those echoes as `isMe: true`.
+
+The detection logic varies by platform:
 
 | Platform | Detection method |
 |----------|-----------------|

package/docs/cards.mdx

@@ -141,12 +141,20 @@ Or with children as the label:
 
 ### LinkButton
 
-Opens an external URL. No `onAction` handler needed.
+Opens an external URL. No `onAction` handler needed for navigation. On platforms
+that emit link-button click events, such as Slack, pass `id` when you need a
+stable action identifier for routing or analytics.
 
 ```tsx title="lib/bot.tsx"
 <LinkButton url="https://example.com/order/1234">View Order</LinkButton>
 ```
 
+```tsx title="lib/bot.tsx"
+<LinkButton id="view_order" url="https://example.com/order/1234">
+  View Order
+</LinkButton>
+```
+
 ### Actions
 
 Container for buttons and interactive elements.

package/docs/concurrency.mdx

@@ -5,7 +5,7 @@ type: guide
 prerequisites:
   - /docs/handling-events
 related:
-  - /docs/state
+  - /docs/state-adapters
   - /docs/streaming
 ---
 

package/docs/contributing/building.mdx

@@ -36,6 +36,10 @@ Chat SDK ships with Vercel-maintained adapters for Slack, Teams, Google Chat, Di
 - Documentation of the adapter in primary vendor docs.
 - Announcement of the adapter in blog post or changelog and social media.
 
+<Callout type="info">
+  Vendor-official adapters should include a Chat SDK docs PR that adds the adapter to the vendor-official listing and the [`chat/adapters` catalog](/docs/adapters#adapter-catalog-chatadapters). Include the package name, peer dependencies, environment variables, credential modes, and any constructor-only config so setup UIs and onboarding tools can discover the adapter without importing its package.
+</Callout>
+
 ## Project setup
 
 This guide uses a hypothetical **Matrix** adapter as a running example. Replace "matrix" with your platform name throughout.
@@ -339,6 +343,8 @@ async handleWebhook(
 
 Convert the raw platform message into a normalized `Message` instance. The `author` fields use `userId` and `userName`, and `isBot` accepts `boolean | "unknown"`. Include a `metadata` object with `dateSent` and `edited` instead of a top-level `createdAt`.
 
+Set `author.isMe` only when the message was sent by this adapter runtime and should be ignored by Chat SDK's handler dispatch. Do not map a platform "sent from my account" flag directly to `isMe` unless that account is the bot identity. For user-owned account adapters, keep user-authored messages as `isMe: false` and track message IDs returned by `postMessage`; if the platform echoes one of those IDs through the webhook, mark that echo as `isMe: true` and `isBot: true`.
+
 ```typescript title="src/adapter.ts" lineNumbers
 parseMessage(raw: unknown): Message<unknown> {
   const payload = raw as Record<string, unknown>;