chat 4.23.0 → 4.24.0

package/dist/{chunk-JW7GYSMH.js → chunk-OPV5U4WG.js}

@@ -353,7 +353,8 @@ function Button(options) {
     label: options.label,
     style: options.style,
     value: options.value,
-    disabled: options.disabled
+    disabled: options.disabled,
+    actionType: options.actionType
   };
 }
 function LinkButton(options) {
@@ -475,7 +476,9 @@ function fromReactElement(element) {
         id: props.id,
         label: props.label ?? label,
         style: props.style,
-        value: props.value
+        value: props.value,
+        actionType: props.actionType,
+        disabled: props.disabled
       });
     }
     case "LinkButton": {
@@ -851,7 +854,9 @@ function resolveJSXElement(element) {
       id: props.id,
       label,
       style: props.style,
-      value: props.value
+      value: props.value,
+      actionType: props.actionType,
+      disabled: props.disabled
     });
   }
   if (type === LinkButton) {
@@ -1103,4 +1108,3 @@ export {
   toModalElement,
   isJSX
 };
-//# sourceMappingURL=chunk-JW7GYSMH.js.map

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 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, Paragraph, Root, Strong, TableCell, TableRow, Text } from 'mdast';
-import { C as ChatElement, a as CardElement, M as ModalElement, b as CardChild, A as ActionsComponent, B as ButtonComponent, c as CardComponent, d as cardChildToFallbackText$1, e as CardLinkComponent, T as TextComponent, D as DividerComponent, F as FieldComponent, f as FieldsComponent, g as fromReactElement$1, I as ImageComponent, i as isCardElement$1, h as isJSX$1, L as LinkButtonComponent, S as SectionComponent, j as Table$2, t as toCardElement$1, k as toModalElement$1, l as fromReactModalElement$1, m as isModalElement$1, n as ModalComponent, R as RadioSelectComponent, o as SelectComponent, p as SelectOptionComponent, q as TextInputComponent } from './jsx-runtime-DraWieqP.js';
-export { r as ActionsElement, s as ButtonElement, u as ButtonOptions, V as ButtonProps, v as ButtonStyle, W as CardJSXElement, X as CardJSXProps, Y as CardLinkProps, w as CardOptions, Z as CardProps, _ as ContainerProps, x as DividerElement, $ as DividerProps, y as FieldElement, a0 as FieldProps, z as FieldsElement, E as ImageElement, a1 as ImageProps, G as LinkButtonElement, H as LinkButtonOptions, a2 as LinkButtonProps, J as LinkElement, a8 as ModalChild, a9 as ModalOptions, a3 as ModalProps, aa as RadioSelectElement, ab as RadioSelectOptions, K as SectionElement, ac as SelectElement, ad as SelectOptionElement, a4 as SelectOptionProps, ae as SelectOptions, a5 as SelectProps, N as TableAlignment, O as TableElement, P as TableOptions, Q as TextElement, af as TextInputElement, ag as TextInputOptions, a6 as TextInputProps, a7 as TextProps, U as TextStyle } from './jsx-runtime-DraWieqP.js';
+import { C as ChatElement, a as CardElement, M as ModalElement, b as CardChild, A as ActionsComponent, B as ButtonComponent, c as CardComponent, d as cardChildToFallbackText$1, e as CardLinkComponent, T as TextComponent, D as DividerComponent, F as FieldComponent, f as FieldsComponent, g as fromReactElement$1, I as ImageComponent, i as isCardElement$1, h as isJSX$1, L as LinkButtonComponent, S as SectionComponent, j as Table$2, t as toCardElement$1, k as toModalElement$1, l as fromReactModalElement$1, m as isModalElement$1, n as ModalComponent, R as RadioSelectComponent, o as SelectComponent, p as SelectOptionComponent, q as TextInputComponent } from './jsx-runtime-DxATbnrP.js';
+export { r as ActionsElement, s as ButtonElement, u as ButtonOptions, V as ButtonProps, v as ButtonStyle, W as CardJSXElement, X as CardJSXProps, Y as CardLinkProps, w as CardOptions, Z as CardProps, _ as ContainerProps, x as DividerElement, $ as DividerProps, y as FieldElement, a0 as FieldProps, z as FieldsElement, E as ImageElement, a1 as ImageProps, G as LinkButtonElement, H as LinkButtonOptions, a2 as LinkButtonProps, J as LinkElement, a8 as ModalChild, a9 as ModalOptions, a3 as ModalProps, aa as RadioSelectElement, ab as RadioSelectOptions, K as SectionElement, ac as SelectElement, ad as SelectOptionElement, a4 as SelectOptionProps, ae as SelectOptions, a5 as SelectProps, N as TableAlignment, O as TableElement, P as TableOptions, Q as TextElement, af as TextInputElement, ag as TextInputOptions, a6 as TextInputProps, a7 as TextProps, U as TextStyle } from './jsx-runtime-DxATbnrP.js';
 
 interface MessageHistoryConfig {
     /** Maximum messages to keep per thread (default: 100) */
@@ -436,6 +436,18 @@ interface ChatConfig<TAdapters extends Record<string, Adapter> = Record<string,
  * Options for webhook handling.
  */
 interface WebhookOptions {
+    /**
+     * Override the default modal-opening behavior to handle it inline
+     * within the current webhook response cycle.
+     * When provided, called instead of adapter.openModal().
+     * Used by Teams to return modal content in the HTTP invoke response.
+     *
+     * The returned `viewId` is platform-specific (e.g. Slack's view ID).
+     * Adapters that don't produce a view ID may return void.
+     */
+    onOpenModal?: (modal: ModalElement, contextId: string) => Promise<{
+        viewId: string;
+    } | undefined>;
     /**
      * Function to run message handling in the background.
      * Use this to ensure fast webhook responses while processing continues.
@@ -726,7 +738,7 @@ interface ChatInstance {
      */
     processAction(event: Omit<ActionEvent, "thread" | "openModal"> & {
         adapter: Adapter;
-    }, options?: WebhookOptions): void;
+    }, options: WebhookOptions | undefined): Promise<void>;
     processAppHomeOpened(event: AppHomeOpenedEvent, options?: WebhookOptions): void;
     processAssistantContextChanged(event: AssistantContextChangedEvent, options?: WebhookOptions): void;
     processAssistantThreadStarted(event: AssistantThreadStartedEvent, options?: WebhookOptions): void;
@@ -777,7 +789,7 @@ interface ChatInstance {
     processSlashCommand(event: Omit<SlashCommandEvent, "channel" | "openModal"> & {
         adapter: Adapter;
         channelId: string;
-    }, options?: WebhookOptions): void;
+    }, options: WebhookOptions | undefined): void;
 }
 /** Lock scope determines which messages contend for the same lock. */
 type LockScope = "thread" | "channel";
@@ -1787,7 +1799,7 @@ interface ModalCloseResponse {
     action: "close";
 }
 type ModalResponse = ModalCloseResponse | ModalErrorsResponse | ModalUpdateResponse | ModalPushResponse;
-type ModalSubmitHandler = (event: ModalSubmitEvent) => void | Promise<ModalResponse | undefined>;
+type ModalSubmitHandler = (event: ModalSubmitEvent) => void | Promise<ModalResponse | void | undefined>;
 type ModalCloseHandler = (event: ModalCloseEvent) => void | Promise<void>;
 /**
  * Event emitted when a user invokes a slash command.
@@ -2411,8 +2423,48 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
      */
     onAction(handler: ActionHandler): void;
     onAction(actionIds: string[] | string, handler: ActionHandler): void;
+    /**
+     * Register a handler for modal form submissions.
+     *
+     * @example
+     * ```typescript
+     * // Handle specific modal
+     * chat.onModalSubmit("settings-modal", async (event) => {
+     *   const name = event.values["name"];
+     *   await event.relatedThread?.post(`Updated name to ${name}`);
+     * });
+     *
+     * // Handle all modal submissions
+     * chat.onModalSubmit(async (event) => {
+     *   console.log(`Modal ${event.callbackId} submitted`);
+     * });
+     * ```
+     *
+     * @param callbackIdOrHandler - Either a callback ID, array of callback IDs, or the handler
+     * @param handler - The handler (if callback ID filter is provided)
+     */
     onModalSubmit(handler: ModalSubmitHandler): void;
     onModalSubmit(callbackIds: string[] | string, handler: ModalSubmitHandler): void;
+    /**
+     * Register a handler for modal close/cancel events.
+     * Only fires when the modal was created with `notifyOnClose: true`.
+     *
+     * @example
+     * ```typescript
+     * // Handle specific modal close
+     * chat.onModalClose("settings-modal", async (event) => {
+     *   console.log("User cancelled settings");
+     * });
+     *
+     * // Handle all modal close events
+     * chat.onModalClose(async (event) => {
+     *   console.log(`Modal ${event.callbackId} closed`);
+     * });
+     * ```
+     *
+     * @param callbackIdOrHandler - Either a callback ID, array of callback IDs, or the handler
+     * @param handler - The handler (if callback ID filter is provided)
+     */
     onModalClose(handler: ModalCloseHandler): void;
     onModalClose(callbackIds: string[] | string, handler: ModalCloseHandler): void;
     /**
@@ -2500,7 +2552,7 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
      */
     processAction(event: Omit<ActionEvent, "thread" | "openModal"> & {
         adapter: Adapter;
-    }, options?: WebhookOptions): void;
+    }, options: WebhookOptions | undefined): Promise<void>;
     processModalSubmit(event: Omit<ModalSubmitEvent, "relatedThread" | "relatedMessage" | "relatedChannel">, contextId?: string, _options?: WebhookOptions): Promise<ModalResponse | undefined>;
     processModalClose(event: Omit<ModalCloseEvent, "relatedThread" | "relatedMessage" | "relatedChannel">, contextId?: string, options?: WebhookOptions): void;
     /**
@@ -2510,7 +2562,7 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
     processSlashCommand(event: Omit<SlashCommandEvent, "channel" | "openModal"> & {
         adapter: Adapter;
         channelId: string;
-    }, options?: WebhookOptions): void;
+    }, options: WebhookOptions | undefined): void;
     processAssistantThreadStarted(event: AssistantThreadStartedEvent, options?: WebhookOptions): void;
     processAssistantContextChanged(event: AssistantContextChangedEvent, options?: WebhookOptions): void;
     processAppHomeOpened(event: AppHomeOpenedEvent, options?: WebhookOptions): void;

package/dist/index.js

@@ -59,7 +59,7 @@ import {
   toModalElement,
   toPlainText,
   walkAst
-} from "./chunk-JW7GYSMH.js";
+} from "./chunk-OPV5U4WG.js";
 
 // src/ai.ts
 var TEXT_MIME_PREFIXES = [
@@ -2243,7 +2243,7 @@ var Chat = class {
    * Handles waitUntil registration and error catching internally.
    */
   processAction(event, options) {
-    const task = this.handleActionEvent(event).catch((err) => {
+    const task = this.handleActionEvent(event, options).catch((err) => {
       this.logger.error("Action processing error", {
         error: err,
         actionId: event.actionId,
@@ -2253,6 +2253,7 @@ var Chat = class {
     if (options?.waitUntil) {
       options.waitUntil(task);
     }
+    return task;
   }
   async processModalSubmit(event, contextId, _options) {
     const { relatedThread, relatedMessage, relatedChannel } = await this.retrieveModalContext(event.adapter.name, contextId);
@@ -2307,7 +2308,7 @@ var Chat = class {
    * Handles waitUntil registration and error catching internally.
    */
   processSlashCommand(event, options) {
-    const task = this.handleSlashCommandEvent(event).catch((err) => {
+    const task = this.handleSlashCommandEvent(event, options).catch((err) => {
       this.logger.error("Slash command processing error", {
         error: err,
         command: event.command,
@@ -2382,7 +2383,7 @@ var Chat = class {
   /**
    * Handle a slash command event internally.
    */
-  async handleSlashCommandEvent(event) {
+  async handleSlashCommandEvent(event, options) {
     this.logger.debug("Incoming slash command", {
       adapter: event.adapter.name,
       command: event.command,
@@ -2404,11 +2405,11 @@ var Chat = class {
       ...event,
       channel,
       openModal: async (modal) => {
-        if (!event.triggerId) {
+        if (!(event.triggerId || options?.onOpenModal)) {
           this.logger.warn("Cannot open modal: no triggerId available");
           return void 0;
         }
-        if (!event.adapter.openModal) {
+        if (!(options?.onOpenModal || event.adapter.openModal)) {
           this.logger.warn(
             `Cannot open modal: ${event.adapter.name} does not support modals`
           );
@@ -2423,18 +2424,24 @@ var Chat = class {
           modalElement = converted;
         }
         const contextId = crypto.randomUUID();
-        this.storeModalContext(
+        await this.storeModalContext(
           event.adapter.name,
           contextId,
           void 0,
           void 0,
           channel
         );
-        return event.adapter.openModal(
-          event.triggerId,
-          modalElement,
-          contextId
-        );
+        if (options?.onOpenModal) {
+          return options.onOpenModal(modalElement, contextId);
+        }
+        if (event.triggerId && event.adapter.openModal) {
+          return event.adapter.openModal(
+            event.triggerId,
+            modalElement,
+            contextId
+          );
+        }
+        return void 0;
       }
     };
     this.logger.debug("Checking slash command handlers", {
@@ -2459,19 +2466,21 @@ var Chat = class {
    * Store modal context server-side with a context ID.
    * Called when opening a modal to preserve thread/message/channel for the submit handler.
    */
-  storeModalContext(adapterName, contextId, thread, message, channel) {
+  async storeModalContext(adapterName, contextId, thread, message, channel) {
     const key = `modal-context:${adapterName}:${contextId}`;
     const context = {
       thread: thread?.toJSON(),
       message: message?.toJSON(),
       channel: channel?.toJSON()
     };
-    this._stateAdapter.set(key, context, MODAL_CONTEXT_TTL_MS).catch((err) => {
+    try {
+      await this._stateAdapter.set(key, context, MODAL_CONTEXT_TTL_MS);
+    } catch (err) {
       this.logger.error("Failed to store modal context", {
         contextId,
         error: err
       });
-    });
+    }
   }
   /**
    * Retrieve and delete modal context from server-side storage.
@@ -2494,6 +2503,7 @@ var Chat = class {
         relatedChannel: void 0
       };
     }
+    await this._stateAdapter.delete(key);
     const adapter = this.adapters.get(adapterName);
     let relatedThread;
     if (stored.thread) {
@@ -2513,7 +2523,7 @@ var Chat = class {
   /**
    * Handle an action event internally.
    */
-  async handleActionEvent(event) {
+  async handleActionEvent(event, options) {
     this.logger.debug("Incoming action", {
       adapter: event.adapter.name,
       actionId: event.actionId,
@@ -2549,11 +2559,11 @@ var Chat = class {
       ...event,
       thread,
       openModal: async (modal) => {
-        if (!event.triggerId) {
+        if (!(event.triggerId || options?.onOpenModal)) {
           this.logger.warn("Cannot open modal: no triggerId available");
           return void 0;
         }
-        if (!event.adapter.openModal) {
+        if (!(options?.onOpenModal || event.adapter.openModal)) {
           this.logger.warn(
             `Cannot open modal: ${event.adapter.name} does not support modals`
           );
@@ -2589,18 +2599,24 @@ var Chat = class {
         }
         const contextId = crypto.randomUUID();
         const channel = thread ? thread.channel : void 0;
-        this.storeModalContext(
+        await this.storeModalContext(
           event.adapter.name,
           contextId,
           thread ? thread : void 0,
           message,
           channel
         );
-        return event.adapter.openModal(
-          event.triggerId,
-          modalElement,
-          contextId
-        );
+        if (options?.onOpenModal) {
+          return options.onOpenModal(modalElement, contextId);
+        }
+        if (event.triggerId && event.adapter.openModal) {
+          return event.adapter.openModal(
+            event.triggerId,
+            modalElement,
+            contextId
+          );
+        }
+        return void 0;
       }
     };
     this.logger.debug("Checking action handlers", {
@@ -3198,8 +3214,7 @@ var Chat = class {
     }
   }
   createThread(adapter, threadId, initialMessage, isSubscribedContext = false) {
-    const parts = threadId.split(":");
-    const channelId = parts[1] || "";
+    const channelId = adapter.channelIdFromThreadId(threadId);
     const isDM = adapter.isDM?.(threadId) ?? false;
     const channelVisibility = adapter.getChannelVisibility?.(threadId) ?? "unknown";
     return new ThreadImpl({
@@ -3794,4 +3809,3 @@ export {
   toPlainText,
   walkAst
 };
-//# sourceMappingURL=index.js.map

package/dist/{jsx-runtime-DraWieqP.d.ts → jsx-runtime-DxATbnrP.d.ts}

@@ -50,6 +50,8 @@ type ButtonStyle = "primary" | "danger" | "default";
 type TextStyle = "plain" | "bold" | "muted";
 /** Button element for interactive actions */
 interface ButtonElement {
+    /** Whether this button triggers a regular action or opens a modal dialog. Default: "action" */
+    actionType?: "action" | "modal";
     /** If true, the button is displayed in an inactive state and doesn't respond to user actions */
     disabled?: boolean;
     /** Unique action ID for callback routing */
@@ -237,6 +239,8 @@ declare function Section(children: CardChild[]): SectionElement;
 declare function Actions(children: (ButtonElement | LinkButtonElement | SelectElement | RadioSelectElement)[]): ActionsElement;
 /** Options for Button */
 interface ButtonOptions {
+    /** Whether this button triggers a regular action or opens a modal dialog. Default: "action" */
+    actionType?: "action" | "modal";
     /** If true, the button is displayed in an inactive state and doesn't respond to user actions */
     disabled?: boolean;
     /** Unique action ID for callback routing */
@@ -504,7 +508,9 @@ interface TextProps {
 }
 /** Props for Button component in JSX */
 interface ButtonProps {
+    actionType?: "action" | "modal";
     children?: string | number | (string | number | undefined)[];
+    disabled?: boolean;
     id: string;
     label?: string;
     style?: ButtonStyle;

package/dist/jsx-runtime.d.ts

@@ -1 +1 @@
-export { A as ActionsComponent, B as ButtonComponent, V as ButtonProps, c as CardComponent, W as CardJSXElement, X as CardJSXProps, e as CardLinkComponent, Y as CardLinkProps, Z as CardProps, C as ChatElement, _ as ContainerProps, D as DividerComponent, $ as DividerProps, F as FieldComponent, a0 as FieldProps, f as FieldsComponent, an as Fragment, I as ImageComponent, a1 as ImageProps, ao as JSX, L as LinkButtonComponent, a2 as LinkButtonProps, n as ModalComponent, a3 as ModalProps, R as RadioSelectComponent, S as SectionComponent, o as SelectComponent, p as SelectOptionComponent, a4 as SelectOptionProps, a5 as SelectProps, ai as TableComponent, ah as TableProps, T as TextComponent, q as TextInputComponent, a6 as TextInputProps, a7 as TextProps, aj as isCardLinkProps, h as isJSX, ak as jsx, am as jsxDEV, al as jsxs, t as toCardElement, k as toModalElement } from './jsx-runtime-DraWieqP.js';
+export { A as ActionsComponent, B as ButtonComponent, V as ButtonProps, c as CardComponent, W as CardJSXElement, X as CardJSXProps, e as CardLinkComponent, Y as CardLinkProps, Z as CardProps, C as ChatElement, _ as ContainerProps, D as DividerComponent, $ as DividerProps, F as FieldComponent, a0 as FieldProps, f as FieldsComponent, an as Fragment, I as ImageComponent, a1 as ImageProps, ao as JSX, L as LinkButtonComponent, a2 as LinkButtonProps, n as ModalComponent, a3 as ModalProps, R as RadioSelectComponent, S as SectionComponent, o as SelectComponent, p as SelectOptionComponent, a4 as SelectOptionProps, a5 as SelectProps, ai as TableComponent, ah as TableProps, T as TextComponent, q as TextInputComponent, a6 as TextInputProps, a7 as TextProps, aj as isCardLinkProps, h as isJSX, ak as jsx, am as jsxDEV, al as jsxs, t as toCardElement, k as toModalElement } from './jsx-runtime-DxATbnrP.js';

package/dist/jsx-runtime.js

@@ -7,7 +7,7 @@ import {
   jsxs,
   toCardElement,
   toModalElement
-} from "./chunk-JW7GYSMH.js";
+} from "./chunk-OPV5U4WG.js";
 export {
   Fragment,
   isCardLinkProps,
@@ -18,4 +18,3 @@ export {
   toCardElement,
   toModalElement
 };
-//# sourceMappingURL=jsx-runtime.js.map

package/docs/adapters.mdx

@@ -64,7 +64,7 @@ Ready to build your own? Follow the [building](/docs/contributing/building) guid
 ⚠️ indicates partial support — the feature works with limitations. See individual adapter pages for details.
 </Callout>
 
-## How adapters work
+## How [adapters](/adapters) work
 
 Each adapter implements a standard interface that the `Chat` class uses to route events and send messages. When a webhook arrives:
 
@@ -73,9 +73,9 @@ Each adapter implements a standard interface that the `Chat` class uses to route
 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
+## Using multiple [adapters](/adapters)
 
-Register multiple adapters and your event handlers work across all of them:
+Register multiple [adapters](/adapters) and your event handlers work across all of them:
 
 ```typescript title="lib/bot.ts" lineNumbers
 import { Chat } from "chat";

package/docs/getting-started.mdx

@@ -14,7 +14,7 @@ Learn the core patterns for handling incoming events and posting messages back t
   <Card title="Posting Messages" description="Different ways to render and send messages with thread.post()." href="/docs/posting-messages" />
 </Cards>
 
-## Adapters
+## [Adapters](/adapters)
 
 Connect your bot to chat platforms and persist state across restarts.
 
@@ -23,6 +23,8 @@ Connect your bot to chat platforms and persist state across restarts.
   <Card title="State Adapters" description="Pluggable state adapters for thread subscriptions, distributed locking, and caching." href="/docs/state" />
 </Cards>
 
+Browse all official and community adapters on the [Adapters](/adapters) page.
+
 ## Guides
 
 Step-by-step tutorials to get up and running on your platform of choice.

package/docs/index.mdx

@@ -11,7 +11,7 @@ Chat SDK is a TypeScript library for building chat bots that work across multipl
 Building a chat bot that works across multiple platforms typically means maintaining separate codebases, learning different APIs, and handling platform-specific quirks individually. Chat SDK abstracts these differences behind a unified interface.
 
 - **Single codebase** for all platforms
-- **Type-safe** adapters and event handlers with full TypeScript support
+- **Type-safe** [adapters](/adapters) and event handlers with full TypeScript support
 - **Event-driven** architecture with handlers for mentions, messages, reactions, button clicks, slash commands, and modals
 - **Thread subscriptions** for multi-turn conversations
 - **Rich UI** with JSX cards, buttons, and modals that render natively on each platform
@@ -22,8 +22,8 @@ Building a chat bot that works across multiple platforms typically means maintai
 
 Chat SDK has three core concepts:
 
-1. **Chat** — the main entry point that coordinates adapters and routes events to your handlers
-2. **Adapters** — platform-specific implementations that handle webhook parsing, message formatting, and API calls
+1. **Chat** — the main entry point that coordinates [adapters](/adapters) and routes events to your handlers
+2. **[Adapters](/adapters)** — platform-specific implementations that handle webhook parsing, message formatting, and API calls
 3. **State** — a pluggable persistence layer for thread subscriptions and distributed locking
 
 ```typescript title="lib/bot.ts" lineNumbers

package/docs/state.mdx

@@ -8,7 +8,7 @@ prerequisites:
 
 State adapters handle persistent storage for thread subscriptions, distributed locks (to prevent duplicate processing), and caching. You must provide a state adapter when creating a `Chat` instance. Browse all available state adapters on the [Adapters](/adapters) page.
 
-## What state adapters manage
+## What state [adapters](/adapters) manage
 
 ### Thread subscriptions
 

package/docs/usage.mdx

@@ -39,9 +39,9 @@ bot.onNewMention(async (thread) => {
 
 Each adapter factory auto-detects credentials from environment variables (`SLACK_BOT_TOKEN`, `SLACK_SIGNING_SECRET`, `REDIS_URL`, etc.), so you can get started with zero config. Pass explicit values to override.
 
-## Multiple adapters
+## Multiple [adapters](/adapters)
 
-Register multiple adapters to deploy your bot across platforms simultaneously:
+Register multiple [adapters](/adapters) to deploy your bot across platforms simultaneously:
 
 ```typescript title="lib/bot.ts" lineNumbers
 import { Chat } from "chat";
@@ -76,7 +76,7 @@ Your event handlers work identically across all registered adapters — the SDK
 | `fallbackStreamingPlaceholderText` | `string \| null` | `"..."` | Placeholder text while streaming starts. Set to `null` to skip |
 | `onLockConflict` | `'drop' \| 'force' \| (threadId, message) => 'drop' \| 'force'` | `"drop"` | Behavior when a thread lock is already held. `'force'` releases the existing lock and re-acquires it, enabling interrupt/steerability for long-running handlers |
 
-## Accessing adapters
+## Accessing [adapters](/adapters)
 
 Use `getAdapter` to access platform-specific APIs when you need functionality beyond the unified interface:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat",
-  "version": "4.23.0",
+  "version": "4.24.0",
   "description": "Unified chat abstraction for Slack, Teams, Google Chat, and Discord",
   "type": "module",
   "main": "./dist/index.js",