chat 4.22.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) */
@@ -42,6 +42,7 @@ declare class MessageHistoryCache {
 interface SerializedChannel {
     _type: "chat:Channel";
     adapterName: string;
+    channelVisibility?: ChannelVisibility;
     id: string;
     isDM: boolean;
 }
@@ -50,6 +51,7 @@ interface SerializedChannel {
  */
 interface ChannelImplConfigWithAdapter {
     adapter: Adapter;
+    channelVisibility?: ChannelVisibility;
     id: string;
     isDM?: boolean;
     messageHistory?: MessageHistoryCache;
@@ -60,6 +62,7 @@ interface ChannelImplConfigWithAdapter {
  */
 interface ChannelImplConfigLazy {
     adapterName: string;
+    channelVisibility?: ChannelVisibility;
     id: string;
     isDM?: boolean;
 }
@@ -67,6 +70,7 @@ type ChannelImplConfig = ChannelImplConfigWithAdapter | ChannelImplConfigLazy;
 declare class ChannelImpl<TState = Record<string, unknown>> implements Channel<TState> {
     readonly id: string;
     readonly isDM: boolean;
+    readonly channelVisibility: ChannelVisibility;
     private _adapter?;
     private readonly _adapterName?;
     private _stateAdapterInstance?;
@@ -144,6 +148,7 @@ interface SerializedThread {
     _type: "chat:Thread";
     adapterName: string;
     channelId: string;
+    channelVisibility?: ChannelVisibility;
     currentMessage?: SerializedMessage;
     id: string;
     isDM: boolean;
@@ -154,6 +159,7 @@ interface SerializedThread {
 interface ThreadImplConfigWithAdapter {
     adapter: Adapter;
     channelId: string;
+    channelVisibility?: ChannelVisibility;
     currentMessage?: Message;
     fallbackStreamingPlaceholderText?: string | null;
     id: string;
@@ -172,6 +178,7 @@ interface ThreadImplConfigWithAdapter {
 interface ThreadImplConfigLazy {
     adapterName: string;
     channelId: string;
+    channelVisibility?: ChannelVisibility;
     currentMessage?: Message;
     fallbackStreamingPlaceholderText?: string | null;
     id: string;
@@ -186,6 +193,7 @@ declare class ThreadImpl<TState = Record<string, unknown>> implements Thread<TSt
     readonly id: string;
     readonly channelId: string;
     readonly isDM: boolean;
+    readonly channelVisibility: ChannelVisibility;
     /** Direct adapter instance (if provided) */
     private _adapter?;
     /** Adapter name for lazy resolution */
@@ -329,6 +337,16 @@ declare class NotImplementedError extends ChatError {
     constructor(message: string, feature?: string, cause?: unknown);
 }
 
+/**
+ * Represents the visibility scope of a channel.
+ *
+ * - `private`: Channel is only visible to invited members (e.g., private Slack channels)
+ * - `workspace`: Channel is visible to all workspace members (e.g., public Slack channels)
+ * - `external`: Channel is shared with external organizations (e.g., Slack Connect)
+ * - `unknown`: Visibility cannot be determined
+ */
+type ChannelVisibility = "private" | "workspace" | "external" | "unknown";
+
 /**
  * Chat configuration with type-safe adapter inference.
  * @template TAdapters - Record of adapter name to adapter instance
@@ -418,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.
@@ -513,6 +543,16 @@ interface Adapter<TThreadId = unknown, TRawMessage = unknown> {
     fetchMessages(threadId: string, options?: FetchOptions): Promise<FetchResult<TRawMessage>>;
     /** Fetch thread metadata */
     fetchThread(threadId: string): Promise<ThreadInfo>;
+    /**
+     * Get the visibility scope of a channel containing the thread.
+     *
+     * This distinguishes between private channels, workspace-visible channels,
+     * and externally shared channels (e.g., Slack Connect).
+     *
+     * @param threadId - The thread ID to check
+     * @returns The channel visibility scope
+     */
+    getChannelVisibility?(threadId: string): ChannelVisibility;
     /** Handle incoming webhook request */
     handleWebhook(request: Request, options?: WebhookOptions): Promise<Response>;
     /** Called when Chat instance is created (internal use) */
@@ -698,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;
@@ -749,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";
@@ -862,6 +902,8 @@ interface Lock {
 interface Postable<TState = Record<string, unknown>, TRawMessage = unknown> {
     /** The adapter this entity belongs to */
     readonly adapter: Adapter;
+    /** The visibility scope of this channel */
+    readonly channelVisibility: ChannelVisibility;
     /** Unique ID */
     readonly id: string;
     /** Whether this is a direct message conversation */
@@ -961,6 +1003,8 @@ interface ThreadSummary<TRawMessage = unknown> {
  * Channel metadata returned by fetchInfo().
  */
 interface ChannelInfo {
+    /** The visibility scope of this channel */
+    channelVisibility?: ChannelVisibility;
     id: string;
     isDM?: boolean;
     memberCount?: number;
@@ -1130,6 +1174,8 @@ interface Thread<TState = Record<string, unknown>, TRawMessage = unknown> extend
 interface ThreadInfo {
     channelId: string;
     channelName?: string;
+    /** The visibility scope of this channel */
+    channelVisibility?: ChannelVisibility;
     id: string;
     /** Whether this is a direct message conversation */
     isDM?: boolean;
@@ -1753,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.
@@ -2377,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;
     /**
@@ -2466,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;
     /**
@@ -2476,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;
@@ -3136,4 +3222,4 @@ declare const Select: SelectComponent;
 declare const SelectOption: SelectOptionComponent;
 declare const TextInput: TextInputComponent;
 
-export { type ActionEvent, type ActionHandler, Actions, ActionsComponent, type Adapter, type AdapterPostableMessage, type AiAssistantMessage, type AiFilePart, type AiImagePart, type AiMessage, type AiMessagePart, type AiTextPart, type AiUserMessage, type AppHomeOpenedEvent, type AppHomeOpenedHandler, type AssistantContextChangedEvent, type AssistantContextChangedHandler, type AssistantThreadStartedEvent, type AssistantThreadStartedHandler, type Attachment, type Author, BaseFormatConverter, Button, ButtonComponent, Card, CardChild, CardComponent, CardElement, CardLink, CardLinkComponent, CardText, type Channel, ChannelImpl, type ChannelInfo, Chat, type ChatConfig, ChatElement, ChatError, type ChatInstance, type ConcurrencyConfig, type ConcurrencyStrategy, ConsoleLogger, type CustomEmojiMap, DEFAULT_EMOJI_MAP, type DirectMessageHandler, Divider, DividerComponent, type Emoji, type EmojiFormats, type EmojiMapConfig, EmojiResolver, type EmojiValue, type EphemeralMessage, type FetchDirection, type FetchOptions, type FetchResult, Field, FieldComponent, Fields, FieldsComponent, type FileUpload, type FormatConverter, type FormattedContent, Image, ImageComponent, LinkButton, LinkButtonComponent, type LinkPreview, type ListThreadsOptions, type ListThreadsResult, type Lock, LockError, type LockScope, type LockScopeContext, type LogLevel, type Logger, type MarkdownConverter, type MarkdownTextChunk, type MemberJoinedChannelEvent, type MemberJoinedChannelHandler, type MentionHandler, Message, type MessageContext, type MessageData, type MessageHandler, MessageHistoryCache, type MessageHistoryConfig, type MessageMetadata, Modal, type ModalCloseEvent, type ModalCloseHandler, type ModalCloseResponse, ModalComponent, ModalElement, type ModalErrorsResponse, type ModalPushResponse, type ModalResponse, type ModalSubmitEvent, type ModalSubmitHandler, type ModalUpdateResponse, NotImplementedError, type PlanUpdateChunk, type PostEphemeralOptions, type Postable, type PostableAst, type PostableCard, type PostableMarkdown, type PostableMessage, type PostableRaw, type QueueEntry, RadioSelect, RadioSelectComponent, RateLimitError, type RawMessage, type ReactionEvent, type ReactionHandler, type ScheduledMessage, Section, SectionComponent, Select, SelectComponent, SelectOption, SelectOptionComponent, type SentMessage, type SerializedChannel, type SerializedMessage, type SerializedThread, type SlashCommandEvent, type SlashCommandHandler, type StateAdapter, type StreamChunk, type StreamEvent, type StreamOptions, StreamingMarkdownRenderer, type SubscribedMessageHandler, THREAD_STATE_TTL_MS, Table, type TaskUpdateChunk, TextComponent, TextInput, TextInputComponent, type Thread, ThreadImpl, type ThreadInfo, type ThreadSummary, type WebhookOptions, type WellKnownEmoji, blockquote, cardChildToFallbackText, codeBlock, convertEmojiPlaceholders, createEmoji, defaultEmojiResolver, deriveChannelId, emoji, emphasis, fromFullStream, fromReactElement, fromReactModalElement, getEmoji, getNodeChildren, getNodeValue, inlineCode, isBlockquoteNode, isCardElement, isCodeNode, isDeleteNode, isEmphasisNode, isInlineCodeNode, isJSX, isLinkNode, isListItemNode, isListNode, isModalElement, isParagraphNode, isStrongNode, isTableCellNode, isTableNode, isTableRowNode, isTextNode, link, markdownToPlainText, paragraph, parseMarkdown, root, strikethrough, stringifyMarkdown, strong, tableElementToAscii, tableToAscii, text, toAiMessages, toCardElement, toModalElement, toPlainText, walkAst };
+export { type ActionEvent, type ActionHandler, Actions, ActionsComponent, type Adapter, type AdapterPostableMessage, type AiAssistantMessage, type AiFilePart, type AiImagePart, type AiMessage, type AiMessagePart, type AiTextPart, type AiUserMessage, type AppHomeOpenedEvent, type AppHomeOpenedHandler, type AssistantContextChangedEvent, type AssistantContextChangedHandler, type AssistantThreadStartedEvent, type AssistantThreadStartedHandler, type Attachment, type Author, BaseFormatConverter, Button, ButtonComponent, Card, CardChild, CardComponent, CardElement, CardLink, CardLinkComponent, CardText, type Channel, ChannelImpl, type ChannelInfo, type ChannelVisibility, Chat, type ChatConfig, ChatElement, ChatError, type ChatInstance, type ConcurrencyConfig, type ConcurrencyStrategy, ConsoleLogger, type CustomEmojiMap, DEFAULT_EMOJI_MAP, type DirectMessageHandler, Divider, DividerComponent, type Emoji, type EmojiFormats, type EmojiMapConfig, EmojiResolver, type EmojiValue, type EphemeralMessage, type FetchDirection, type FetchOptions, type FetchResult, Field, FieldComponent, Fields, FieldsComponent, type FileUpload, type FormatConverter, type FormattedContent, Image, ImageComponent, LinkButton, LinkButtonComponent, type LinkPreview, type ListThreadsOptions, type ListThreadsResult, type Lock, LockError, type LockScope, type LockScopeContext, type LogLevel, type Logger, type MarkdownConverter, type MarkdownTextChunk, type MemberJoinedChannelEvent, type MemberJoinedChannelHandler, type MentionHandler, Message, type MessageContext, type MessageData, type MessageHandler, MessageHistoryCache, type MessageHistoryConfig, type MessageMetadata, Modal, type ModalCloseEvent, type ModalCloseHandler, type ModalCloseResponse, ModalComponent, ModalElement, type ModalErrorsResponse, type ModalPushResponse, type ModalResponse, type ModalSubmitEvent, type ModalSubmitHandler, type ModalUpdateResponse, NotImplementedError, type PlanUpdateChunk, type PostEphemeralOptions, type Postable, type PostableAst, type PostableCard, type PostableMarkdown, type PostableMessage, type PostableRaw, type QueueEntry, RadioSelect, RadioSelectComponent, RateLimitError, type RawMessage, type ReactionEvent, type ReactionHandler, type ScheduledMessage, Section, SectionComponent, Select, SelectComponent, SelectOption, SelectOptionComponent, type SentMessage, type SerializedChannel, type SerializedMessage, type SerializedThread, type SlashCommandEvent, type SlashCommandHandler, type StateAdapter, type StreamChunk, type StreamEvent, type StreamOptions, StreamingMarkdownRenderer, type SubscribedMessageHandler, THREAD_STATE_TTL_MS, Table, type TaskUpdateChunk, TextComponent, TextInput, TextInputComponent, type Thread, ThreadImpl, type ThreadInfo, type ThreadSummary, type WebhookOptions, type WellKnownEmoji, blockquote, cardChildToFallbackText, codeBlock, convertEmojiPlaceholders, createEmoji, defaultEmojiResolver, deriveChannelId, emoji, emphasis, fromFullStream, fromReactElement, fromReactModalElement, getEmoji, getNodeChildren, getNodeValue, inlineCode, isBlockquoteNode, isCardElement, isCodeNode, isDeleteNode, isEmphasisNode, isInlineCodeNode, isJSX, isLinkNode, isListItemNode, isListNode, isModalElement, isParagraphNode, isStrongNode, isTableCellNode, isTableNode, isTableRowNode, isTextNode, link, markdownToPlainText, paragraph, parseMarkdown, root, strikethrough, stringifyMarkdown, strong, tableElementToAscii, tableToAscii, text, toAiMessages, toCardElement, toModalElement, toPlainText, walkAst };

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 = [
@@ -469,6 +469,7 @@ function isAsyncIterable(value) {
 var ChannelImpl = class _ChannelImpl {
   id;
   isDM;
+  channelVisibility;
   _adapter;
   _adapterName;
   _stateAdapterInstance;
@@ -477,6 +478,7 @@ var ChannelImpl = class _ChannelImpl {
   constructor(config) {
     this.id = config.id;
     this.isDM = config.isDM ?? false;
+    this.channelVisibility = config.channelVisibility ?? "unknown";
     if (isLazyConfig(config)) {
       this._adapterName = config.adapterName;
     } else {
@@ -695,6 +697,7 @@ var ChannelImpl = class _ChannelImpl {
       _type: "chat:Channel",
       id: this.id,
       adapterName: this.adapter.name,
+      channelVisibility: this.channelVisibility,
       isDM: this.isDM
     };
   }
@@ -702,6 +705,7 @@ var ChannelImpl = class _ChannelImpl {
     const channel = new _ChannelImpl({
       id: json.id,
       adapterName: json.adapterName,
+      channelVisibility: json.channelVisibility,
       isDM: json.isDM
     });
     if (adapter) {
@@ -1099,6 +1103,7 @@ var ThreadImpl = class _ThreadImpl {
   id;
   channelId;
   isDM;
+  channelVisibility;
   /** Direct adapter instance (if provided) */
   _adapter;
   /** Adapter name for lazy resolution */
@@ -1122,6 +1127,7 @@ var ThreadImpl = class _ThreadImpl {
     this.id = config.id;
     this.channelId = config.channelId;
     this.isDM = config.isDM ?? false;
+    this.channelVisibility = config.channelVisibility ?? "unknown";
     this._isSubscribedContext = config.isSubscribedContext ?? false;
     this._currentMessage = config.currentMessage;
     this._logger = config.logger;
@@ -1212,6 +1218,7 @@ var ThreadImpl = class _ThreadImpl {
         adapter: this.adapter,
         stateAdapter: this._stateAdapter,
         isDM: this.isDM,
+        channelVisibility: this.channelVisibility,
         messageHistory: this._messageHistory
       });
     }
@@ -1573,6 +1580,7 @@ var ThreadImpl = class _ThreadImpl {
       _type: "chat:Thread",
       id: this.id,
       channelId: this.channelId,
+      channelVisibility: this.channelVisibility,
       currentMessage: this._currentMessage?.toJSON(),
       isDM: this.isDM,
       adapterName: this.adapter.name
@@ -1597,6 +1605,7 @@ var ThreadImpl = class _ThreadImpl {
       id: json.id,
       adapterName: json.adapterName,
       channelId: json.channelId,
+      channelVisibility: json.channelVisibility,
       currentMessage: json.currentMessage ? Message.fromJSON(json.currentMessage) : void 0,
       isDM: json.isDM
     });
@@ -2234,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,
@@ -2244,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);
@@ -2298,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,
@@ -2373,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,
@@ -2395,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`
           );
@@ -2414,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", {
@@ -2450,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.
@@ -2485,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) {
@@ -2504,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,
@@ -2540,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`
           );
@@ -2580,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", {
@@ -3189,9 +3214,9 @@ 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({
       id: threadId,
       adapter,
@@ -3200,6 +3225,7 @@ var Chat = class {
       initialMessage,
       isSubscribedContext,
       isDM,
+      channelVisibility,
       currentMessage: initialMessage,
       logger: this.logger,
       streamingUpdateIntervalMs: this._streamingUpdateIntervalMs,
@@ -3783,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/concurrency.mdx

@@ -1,5 +1,5 @@
 ---
-title: Concurrency
+title: Overlapping Messages
 description: Control how overlapping messages on the same thread are handled — queue, debounce, drop, or process concurrently.
 type: guide
 prerequisites:

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.