chat 4.22.0 → 4.23.0

package/dist/index.d.ts

@@ -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
@@ -513,6 +531,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) */
@@ -862,6 +890,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 +991,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 +1162,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;
@@ -3136,4 +3170,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

@@ -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
     });
@@ -3192,6 +3201,7 @@ var Chat = class {
     const parts = threadId.split(":");
     const channelId = parts[1] || "";
     const isDM = adapter.isDM?.(threadId) ?? false;
+    const channelVisibility = adapter.getChannelVisibility?.(threadId) ?? "unknown";
     return new ThreadImpl({
       id: threadId,
       adapter,
@@ -3200,6 +3210,7 @@ var Chat = class {
       initialMessage,
       isSubscribedContext,
       isDM,
+      channelVisibility,
       currentMessage: initialMessage,
       logger: this.logger,
       streamingUpdateIntervalMs: this._streamingUpdateIntervalMs,