chat 4.29.0 → 4.31.0

package/dist/ai/index.d.ts

@@ -1,10 +1,10 @@
-import { r as Chat, R as ChannelVisibility } from '../chat-D9UYaaNO.js';
-export { g as AiAssistantMessage, h as AiFilePart, i as AiImagePart, j as AiMessage, k as AiMessagePart, l as AiTextPart, m as AiUserMessage, n as ToAiMessagesOptions, t as toAiMessages } from '../chat-D9UYaaNO.js';
+import { x as Chat, w as ChannelVisibility } from '../chat-BjhJs_sP.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-BjhJs_sP.js';
 import * as ai from 'ai';
 import { Tool } from 'ai';
 import '@workflow/serde';
 import 'mdast';
-import '../jsx-runtime-CFq1K_Ve.js';
+import '../jsx-runtime-CzthIo1o.js';
 
 /**
  * The Chat instance used by all tools to dispatch operations.

package/dist/{chat-D9UYaaNO.d.ts → chat-BjhJs_sP.d.ts}

@@ -1,6 +1,6 @@
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 import { Root } from 'mdast';
-import { Z as ChatElement, C as CardElement, ac as ModalElement, ah as SelectOptionElement } from './jsx-runtime-CFq1K_Ve.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) */
@@ -761,7 +761,9 @@ interface Adapter<TThreadId = unknown, TRawMessage = unknown> {
      * Stream a message using platform-native streaming APIs.
      *
      * The adapter consumes the async iterable and handles the entire streaming lifecycle.
-     * Only available on platforms with native streaming support (e.g., Slack).
+     * Available on platforms with native streaming or preview APIs.
+     * Adapters may return `null` before consuming any chunks to delegate back to
+     * Chat SDK's built-in post+edit fallback for the current thread.
      *
      * The stream can yield plain strings (text chunks) or {@link StreamChunk} objects
      * for rich content like task progress cards. Adapters that don't support structured
@@ -770,9 +772,9 @@ interface Adapter<TThreadId = unknown, TRawMessage = unknown> {
      * @param threadId - The thread to stream to
      * @param textStream - Async iterable of text chunks or structured StreamChunk objects
      * @param options - Platform-specific streaming options
-     * @returns The raw message after streaming completes
+     * @returns The raw message after streaming completes, or `null` to use core fallback
      */
-    stream?(threadId: string, textStream: AsyncIterable<string | StreamChunk>, options?: StreamOptions): Promise<RawMessage<TRawMessage>>;
+    stream?(threadId: string, textStream: AsyncIterable<string | StreamChunk>, options?: StreamOptions): Promise<RawMessage<TRawMessage> | null>;
     /** Bot username (can override global userName) */
     readonly userName: string;
 }
@@ -1221,8 +1223,8 @@ interface Thread<TState = Record<string, unknown>, TRawMessage = unknown> extend
      * Post a message to this thread.
      *
      * Supports text, markdown, cards, and streaming from async iterables.
-     * When posting a stream (e.g., from AI SDK), uses platform-native streaming
-     * APIs when available (Slack), or falls back to post + edit with throttling.
+     * When posting a stream (e.g., from AI SDK), uses adapter-native streaming
+     * when available, or falls back to post + edit with throttling.
      *
      * @param message - String, PostableMessage, JSX Card, or AsyncIterable<string>
      * @returns A SentMessage with methods to edit, delete, or add reactions
@@ -1456,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;
@@ -3153,4 +3155,4 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
     private runHandlers;
 }
 
-export { type DirectMessageHandler as $, type Adapter as A, type AppendInput as B, type CustomEmojiMap as C, type AppendOptions as D, type EmojiMapConfig as E, type AppHomeOpenedEvent as F, type AppHomeOpenedHandler as G, type AssistantContextChangedEvent as H, type AssistantContextChangedHandler as I, type AssistantThreadStartedEvent as J, type AssistantThreadStartedHandler as K, type Attachment as L, Message as M, type Author as N, type Channel as O, type PostableObject as P, type ChannelInfo as Q, type ChannelVisibility as R, type StreamChunk as S, ThreadHistoryCache as T, type ChatConfig as U, type ChatInstance as V, type WellKnownEmoji as W, type ConcurrencyConfig as X, type ConcurrencyStrategy as Y, type CountQuery as Z, type DeleteTarget as _, type PostableObjectContext as a, type ThreadSummary as a$, type DurationString as a0, type Emoji as a1, type EphemeralMessage as a2, type FetchDirection as a3, type FetchOptions as a4, type FetchResult as a5, type FileUpload as a6, type FormattedContent as a7, type IdentityContext as a8, type IdentityResolver as a9, type ModalUpdateResponse as aA, type OptionsLoadEvent as aB, type OptionsLoadGroup as aC, type OptionsLoadHandler as aD, type OptionsLoadResult as aE, type PlanUpdateChunk as aF, type Postable as aG, type PostableAst as aH, type PostableCard as aI, type PostableMarkdown as aJ, type PostableMessage as aK, type PostableRaw as aL, type PostEphemeralOptions as aM, type QueueEntry as aN, type RawMessage as aO, type ReactionEvent as aP, type ReactionHandler as aQ, type ScheduledMessage as aR, type SentMessage as aS, type SlashCommandEvent as aT, type SlashCommandHandler as aU, type StateAdapter as aV, type StreamOptions as aW, type SubscribedMessageHandler as aX, type TaskUpdateChunk as aY, type Thread as aZ, type ThreadInfo as a_, type LinkPreview as aa, type ListQuery as ab, type ListThreadsOptions as ac, type ListThreadsResult as ad, type Lock as ae, type LockScope as af, type LockScopeContext as ag, type Logger as ah, type LogLevel as ai, type MarkdownTextChunk as aj, type MemberJoinedChannelEvent as ak, type MemberJoinedChannelHandler as al, type MentionHandler as am, type MessageContext as an, type MessageHandler as ao, type MessageMetadata as ap, type MessageSubject as aq, type ModalClearResponse as ar, type ModalCloseEvent as as, type ModalCloseHandler as at, type ModalCloseResponse as au, type ModalErrorsResponse as av, type ModalPushResponse as aw, type ModalResponse as ax, type ModalSubmitEvent as ay, type ModalSubmitHandler as az, type ThreadHistoryConfig as b, type TranscriptEntry as b0, type TranscriptRole as b1, type TranscriptsApi as b2, type TranscriptsConfig as b3, type UserInfo as b4, type WebhookOptions as b5, ConsoleLogger as b6, THREAD_STATE_TTL_MS as b7, type StreamEvent as c, type EmojiValue as d, type EmojiFormats as e, type AdapterPostableMessage as f, type AiAssistantMessage as g, type AiFilePart as h, type AiImagePart as i, type AiMessage as j, type AiMessagePart as k, type AiTextPart as l, type AiUserMessage as m, type ToAiMessagesOptions as n, ChannelImpl as o, deriveChannelId as p, type SerializedChannel as q, Chat as r, type MessageData as s, toAiMessages as t, type SerializedMessage as u, isPostableObject as v, type SerializedThread as w, ThreadImpl as x, type ActionEvent as y, type ActionHandler as z };
+export { type LockScope as $, type ActionEvent as A, type ConcurrencyConfig as B, type Channel as C, type ConcurrencyStrategy as D, ConsoleLogger as E, type CountQuery as F, type CustomEmojiMap as G, type DeleteTarget as H, type DirectMessageHandler as I, type DurationString as J, type Emoji as K, type EmojiFormats as L, type EmojiMapConfig as M, type EmojiValue as N, type EphemeralMessage as O, type FetchDirection as P, type FetchOptions as Q, type FetchResult as R, type FileUpload as S, type FormattedContent as T, type IdentityContext as U, type IdentityResolver as V, type LinkPreview as W, type ListQuery as X, type ListThreadsOptions as Y, type ListThreadsResult as Z, type Lock as _, type ActionHandler as a, type TranscriptRole as a$, type LockScopeContext as a0, type LogLevel as a1, type Logger as a2, type MarkdownTextChunk as a3, type MemberJoinedChannelEvent as a4, type MemberJoinedChannelHandler as a5, type MentionHandler as a6, Message as a7, type MessageContext as a8, type MessageData as a9, type PostableRaw as aA, type QueueEntry as aB, type RawMessage as aC, type ReactionEvent as aD, type ReactionHandler as aE, type ScheduledMessage as aF, type SentMessage as aG, type SerializedChannel as aH, type SerializedMessage as aI, type SerializedThread as aJ, type SlashCommandEvent as aK, type SlashCommandHandler as aL, type StateAdapter as aM, type StreamChunk as aN, type StreamEvent as aO, type StreamOptions as aP, type SubscribedMessageHandler as aQ, THREAD_STATE_TTL_MS as aR, type TaskUpdateChunk as aS, type Thread as aT, ThreadHistoryCache as aU, type ThreadHistoryConfig as aV, ThreadImpl as aW, type ThreadInfo as aX, type ThreadSummary as aY, type ToAiMessagesOptions as aZ, type TranscriptEntry as a_, type MessageHandler as aa, type MessageMetadata as ab, type MessageSubject as ac, type ModalClearResponse as ad, type ModalCloseEvent as ae, type ModalCloseHandler as af, type ModalCloseResponse as ag, type ModalErrorsResponse as ah, type ModalPushResponse as ai, type ModalResponse as aj, type ModalSubmitEvent as ak, type ModalSubmitHandler as al, type ModalUpdateResponse as am, type OptionsLoadEvent as an, type OptionsLoadGroup as ao, type OptionsLoadHandler as ap, type OptionsLoadResult as aq, type PlanUpdateChunk as ar, type PostEphemeralOptions as as, type Postable as at, type PostableAst as au, type PostableCard as av, type PostableMarkdown as aw, type PostableMessage as ax, type PostableObject as ay, type PostableObjectContext as az, type Adapter as b, type TranscriptsApi as b0, type TranscriptsConfig as b1, type UserInfo as b2, type WebhookOptions as b3, type WellKnownEmoji as b4, deriveChannelId as b5, isPostableObject as b6, toAiMessages as b7, type AdapterPostableMessage as c, type AiAssistantMessage as d, type AiFilePart as e, type AiImagePart as f, type AiMessage as g, type AiMessagePart as h, type AiTextPart as i, type AiUserMessage as j, type AppHomeOpenedEvent as k, type AppHomeOpenedHandler as l, type AppendInput as m, type AppendOptions as n, type AssistantContextChangedEvent as o, type AssistantContextChangedHandler as p, type AssistantThreadStartedEvent as q, type AssistantThreadStartedHandler as r, type Attachment as s, type Author as t, ChannelImpl as u, type ChannelInfo as v, type ChannelVisibility as w, Chat as x, type ChatConfig as y, type ChatInstance as z };

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 { P as PostableObject, A as Adapter, a as PostableObjectContext, S as StreamChunk, T as ThreadHistoryCache, b as ThreadHistoryConfig, c as StreamEvent, E as EmojiMapConfig, d as EmojiValue, W as WellKnownEmoji, e as EmojiFormats, C as CustomEmojiMap, f as AdapterPostableMessage } from './chat-D9UYaaNO.js';
-export { y as ActionEvent, z as ActionHandler, g as AiAssistantMessage, h as AiFilePart, i as AiImagePart, j as AiMessage, k as AiMessagePart, l as AiTextPart, m as AiUserMessage, F as AppHomeOpenedEvent, G as AppHomeOpenedHandler, B as AppendInput, D as AppendOptions, H as AssistantContextChangedEvent, I as AssistantContextChangedHandler, J as AssistantThreadStartedEvent, K as AssistantThreadStartedHandler, L as Attachment, N as Author, O as Channel, o as ChannelImpl, Q as ChannelInfo, R as ChannelVisibility, r as Chat, U as ChatConfig, V as ChatInstance, X as ConcurrencyConfig, Y as ConcurrencyStrategy, b6 as ConsoleLogger, Z as CountQuery, _ as DeleteTarget, $ as DirectMessageHandler, a0 as DurationString, a1 as Emoji, a2 as EphemeralMessage, a3 as FetchDirection, a4 as FetchOptions, a5 as FetchResult, a6 as FileUpload, a7 as FormattedContent, a8 as IdentityContext, a9 as IdentityResolver, aa as LinkPreview, ab as ListQuery, ac as ListThreadsOptions, ad as ListThreadsResult, ae as Lock, af as LockScope, ag as LockScopeContext, ai as LogLevel, ah as Logger, aj as MarkdownTextChunk, ak as MemberJoinedChannelEvent, al as MemberJoinedChannelHandler, am as MentionHandler, M as Message, an as MessageContext, s as MessageData, ao as MessageHandler, ap as MessageMetadata, aq as MessageSubject, ar as ModalClearResponse, as as ModalCloseEvent, at as ModalCloseHandler, au as ModalCloseResponse, av as ModalErrorsResponse, aw as ModalPushResponse, ax as ModalResponse, ay as ModalSubmitEvent, az as ModalSubmitHandler, aA as ModalUpdateResponse, aB as OptionsLoadEvent, aC as OptionsLoadGroup, aD as OptionsLoadHandler, aE as OptionsLoadResult, aF as PlanUpdateChunk, aM as PostEphemeralOptions, aG as Postable, aH as PostableAst, aI as PostableCard, aJ as PostableMarkdown, aK as PostableMessage, aL as PostableRaw, aN as QueueEntry, aO as RawMessage, aP as ReactionEvent, aQ as ReactionHandler, aR as ScheduledMessage, aS as SentMessage, q as SerializedChannel, u as SerializedMessage, w as SerializedThread, aT as SlashCommandEvent, aU as SlashCommandHandler, aV as StateAdapter, aW as StreamOptions, aX as SubscribedMessageHandler, b7 as THREAD_STATE_TTL_MS, aY as TaskUpdateChunk, aZ as Thread, x as ThreadImpl, a_ as ThreadInfo, a$ as ThreadSummary, n as ToAiMessagesOptions, b0 as TranscriptEntry, b1 as TranscriptRole, b2 as TranscriptsApi, b3 as TranscriptsConfig, b4 as UserInfo, b5 as WebhookOptions, p as deriveChannelId, v as isPostableObject, t as toAiMessages } from './chat-D9UYaaNO.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-BjhJs_sP.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-BjhJs_sP.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 { C as CardElement, a as CardChild, A as ActionsComponent, B as ButtonComponent, b as CardComponent, c as cardChildToFallbackText$1, d as CardLinkComponent, T as TextComponent, D as DividerComponent, F as FieldComponent, e as FieldsComponent, f as fromReactElement$1, I as ImageComponent, i as isCardElement$1, g as isJSX$1, L as LinkButtonComponent, S as SectionComponent, h as Table$2, t as toCardElement$1, j as toModalElement$1, k as fromReactModalElement$1, l as isModalElement$1, E as ExternalSelectComponent, M as ModalComponent, R as RadioSelectComponent, m as SelectComponent, n as SelectOptionComponent, o as TextInputComponent } from './jsx-runtime-CFq1K_Ve.js';
-export { p as ActionsElement, q as ButtonElement, r as ButtonOptions, U as ButtonProps, s as ButtonStyle, V as CardJSXElement, W as CardJSXProps, X as CardLinkProps, u as CardOptions, Y as CardProps, Z as ChatElement, _ as ContainerProps, v as DividerElement, $ as DividerProps, a9 as ExternalSelectElement, aa as ExternalSelectOptions, a0 as ExternalSelectProps, w as FieldElement, a1 as FieldProps, x as FieldsElement, y as ImageElement, a2 as ImageProps, z as LinkButtonElement, G as LinkButtonOptions, a3 as LinkButtonProps, H as LinkElement, ab as ModalChild, ac as ModalElement, ad as ModalOptions, a4 as ModalProps, ae as RadioSelectElement, af as RadioSelectOptions, J as SectionElement, ag as SelectElement, ah as SelectOptionElement, a5 as SelectOptionProps, ai as SelectOptions, a6 as SelectProps, K as TableAlignment, N as TableElement, O as TableOptions, P as TextElement, aj as TextInputElement, ak as TextInputOptions, a7 as TextInputProps, a8 as TextProps, Q as TextStyle } from './jsx-runtime-CFq1K_Ve.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';
 
 /**

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";
@@ -1504,7 +1504,10 @@ var ThreadImpl = class _ThreadImpl {
    */
   async handleStream(rawStream, callerOptions) {
     const textStream = fromFullStream(rawStream);
-    const options = { ...callerOptions };
+    const options = {
+      updateIntervalMs: this._streamingUpdateIntervalMs,
+      ...callerOptions
+    };
     if (this._currentMessage) {
       options.recipientUserId = this._currentMessage.author.userId;
       options.recipientTeamId = this.extractSlackRecipientTeamId(
@@ -1533,15 +1536,17 @@ var ThreadImpl = class _ThreadImpl {
         }
       };
       const raw = await this.adapter.stream(this.id, wrappedStream, options);
-      const sent = this.createSentMessage(
-        raw.id,
-        { markdown: accumulated },
-        raw.threadId
-      );
-      if (this._threadHistory) {
-        await this._threadHistory.append(this.id, new Message(sent));
+      if (raw) {
+        const sent = this.createSentMessage(
+          raw.id,
+          { markdown: accumulated },
+          raw.threadId
+        );
+        if (this._threadHistory) {
+          await this._threadHistory.append(this.id, new Message(sent));
+        }
+        return sent;
       }
-      return sent;
     }
     const textOnlyStream = {
       [Symbol.asyncIterator]: () => {

package/dist/{jsx-runtime-CFq1K_Ve.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;
@@ -779,4 +784,4 @@ declare namespace JSX {
     }
 }
 
-export { type DividerProps as $, type ActionsComponent as A, type ButtonComponent as B, type CardElement as C, type DividerComponent as D, type ExternalSelectComponent as E, type FieldComponent as F, type LinkButtonOptions as G, type LinkElement as H, type ImageComponent as I, type SectionElement as J, type TableAlignment as K, type LinkButtonComponent as L, type ModalComponent as M, type TableElement as N, type TableOptions as O, type TextElement as P, type TextStyle as Q, type RadioSelectComponent as R, type SectionComponent as S, type TextComponent as T, type ButtonProps as U, type CardJSXElement as V, type CardJSXProps as W, type CardLinkProps as X, type CardProps as Y, type ChatElement as Z, type ContainerProps as _, type CardChild as a, type ExternalSelectProps as a0, type FieldProps as a1, type ImageProps as a2, type LinkButtonProps as a3, type ModalProps as a4, type SelectOptionProps as a5, type SelectProps as a6, type TextInputProps as a7, type TextProps as a8, type ExternalSelectElement as a9, type ExternalSelectOptions as aa, type ModalChild as ab, type ModalElement as ac, type ModalOptions as ad, type RadioSelectElement as ae, type RadioSelectOptions as af, type SelectElement as ag, type SelectOptionElement as ah, type SelectOptions as ai, type TextInputElement as aj, type TextInputOptions as ak, type TableProps as al, type TableComponent as am, isCardLinkProps as an, jsx as ao, jsxs as ap, jsxDEV as aq, Fragment as ar, JSX as as, type CardComponent as b, cardChildToFallbackText as c, type CardLinkComponent as d, type FieldsComponent as e, fromReactElement as f, isJSX as g, Table as h, isCardElement as i, toModalElement as j, fromReactModalElement as k, isModalElement as l, type SelectComponent as m, type SelectOptionComponent as n, type TextInputComponent as o, type ActionsElement as p, type ButtonElement as q, type ButtonOptions as r, type ButtonStyle as s, toCardElement as t, type CardOptions as u, type DividerElement as v, type FieldElement as w, type FieldsElement as x, type ImageElement as y, type LinkButtonElement as z };
+export { type SelectOptionElement as $, type ActionsComponent as A, type ButtonComponent as B, type CardChild as C, type DividerComponent as D, type ExternalSelectComponent as E, type FieldComponent as F, type ImageProps as G, type LinkButtonElement as H, type ImageComponent as I, JSX as J, type LinkButtonOptions as K, type LinkButtonComponent as L, type LinkButtonProps as M, type LinkElement as N, type ModalChild as O, type ModalComponent as P, type ModalElement as Q, type ModalOptions as R, type ModalProps as S, type RadioSelectComponent as T, type RadioSelectElement as U, type RadioSelectOptions as V, type SectionComponent as W, type SectionElement as X, type SelectComponent as Y, type SelectElement as Z, type SelectOptionComponent as _, type ActionsElement as a, type SelectOptionProps as a0, type SelectOptions as a1, type SelectProps as a2, Table as a3, type TableAlignment as a4, type TableComponent as a5, type TableElement as a6, type TableOptions as a7, type TableProps as a8, type TextComponent as a9, type TextElement as aa, type TextInputComponent as ab, type TextInputElement as ac, type TextInputOptions as ad, type TextInputProps as ae, type TextProps as af, type TextStyle as ag, cardChildToFallbackText as ah, fromReactElement as ai, fromReactModalElement as aj, isCardElement as ak, isCardLinkProps as al, isJSX as am, isModalElement as an, jsx as ao, jsxDEV as ap, jsxs as aq, toCardElement as ar, toModalElement as as, type ButtonElement as b, type ButtonOptions as c, type ButtonProps as d, type ButtonStyle as e, type CardComponent as f, type CardElement as g, type CardJSXElement as h, type CardJSXProps as i, type CardLinkComponent as j, type CardLinkProps as k, type CardOptions as l, type CardProps as m, type ChatElement as n, type ContainerProps as o, type DividerElement as p, type DividerProps as q, type ExternalSelectElement as r, type ExternalSelectOptions as s, type ExternalSelectProps as t, type FieldElement as u, type FieldProps as v, type FieldsComponent as w, type FieldsElement as x, Fragment as y, type ImageElement as z };

package/dist/jsx-runtime.d.ts

@@ -1 +1 @@
-export { A as ActionsComponent, B as ButtonComponent, U as ButtonProps, b as CardComponent, V as CardJSXElement, W as CardJSXProps, d as CardLinkComponent, X as CardLinkProps, Y as CardProps, Z as ChatElement, _ as ContainerProps, D as DividerComponent, $ as DividerProps, E as ExternalSelectComponent, a0 as ExternalSelectProps, F as FieldComponent, a1 as FieldProps, e as FieldsComponent, ar as Fragment, I as ImageComponent, a2 as ImageProps, as as JSX, L as LinkButtonComponent, a3 as LinkButtonProps, M as ModalComponent, a4 as ModalProps, R as RadioSelectComponent, S as SectionComponent, m as SelectComponent, n as SelectOptionComponent, a5 as SelectOptionProps, a6 as SelectProps, am as TableComponent, al as TableProps, T as TextComponent, o as TextInputComponent, a7 as TextInputProps, a8 as TextProps, an as isCardLinkProps, g as isJSX, ao as jsx, aq as jsxDEV, ap as jsxs, t as toCardElement, j as toModalElement } from './jsx-runtime-CFq1K_Ve.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 /> 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 | <Cross /> | <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

@@ -61,3 +61,9 @@ bot.onSubscribedMessage(async (thread) => {
 - import { toAiMessages } from "chat";
 + import { toAiMessages } from "chat/ai";
 ```
+
+## 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?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?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.