chat 4.12.0 → 4.13.1

package/dist/index.d.ts

@@ -269,6 +269,8 @@ interface StreamOptions {
     recipientTeamId?: string;
     /** Minimum interval between updates in ms (default: 1000). Used for fallback mode (GChat/Teams). */
     updateIntervalMs?: number;
+    /** Block Kit elements to attach when stopping the stream (Slack only, via chat.stopStream) */
+    stopBlocks?: unknown[];
 }
 /** Internal interface for Chat instance passed to adapters */
 interface ChatInstance {
@@ -333,6 +335,9 @@ interface ChatInstance {
         adapter: Adapter;
         channelId: string;
     }, options?: WebhookOptions): void;
+    processAssistantThreadStarted(event: AssistantThreadStartedEvent, options?: WebhookOptions): void;
+    processAssistantContextChanged(event: AssistantContextChangedEvent, options?: WebhookOptions): void;
+    processAppHomeOpened(event: AppHomeOpenedEvent, options?: WebhookOptions): void;
     getState(): StateAdapter;
     getUserName(): string;
     /** Get the configured logger, optionally with a child prefix */
@@ -1256,6 +1261,42 @@ interface SlashCommandEvent<TState = Record<string, unknown>> {
  * ```
  */
 type SlashCommandHandler<TState = Record<string, unknown>> = (event: SlashCommandEvent<TState>) => Promise<void>;
+interface AssistantThreadStartedEvent {
+    threadId: string;
+    userId: string;
+    channelId: string;
+    threadTs: string;
+    context: {
+        channelId?: string;
+        teamId?: string;
+        enterpriseId?: string;
+        threadEntryPoint?: string;
+        forceSearch?: boolean;
+    };
+    adapter: Adapter;
+}
+type AssistantThreadStartedHandler = (event: AssistantThreadStartedEvent) => Promise<void>;
+interface AssistantContextChangedEvent {
+    threadId: string;
+    userId: string;
+    channelId: string;
+    threadTs: string;
+    context: {
+        channelId?: string;
+        teamId?: string;
+        enterpriseId?: string;
+        threadEntryPoint?: string;
+        forceSearch?: boolean;
+    };
+    adapter: Adapter;
+}
+type AssistantContextChangedHandler = (event: AssistantContextChangedEvent) => Promise<void>;
+interface AppHomeOpenedEvent {
+    userId: string;
+    channelId: string;
+    adapter: Adapter;
+}
+type AppHomeOpenedHandler = (event: AppHomeOpenedEvent) => Promise<void>;
 
 /**
  * Message class with serialization support for workflow engines.
@@ -1552,6 +1593,9 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
     private modalSubmitHandlers;
     private modalCloseHandlers;
     private slashCommandHandlers;
+    private assistantThreadStartedHandlers;
+    private assistantContextChangedHandlers;
+    private appHomeOpenedHandlers;
     /** Initialization state */
     private initPromise;
     private initialized;
@@ -1748,6 +1792,9 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
     onSlashCommand(handler: SlashCommandHandler<TState>): void;
     onSlashCommand(command: string, handler: SlashCommandHandler<TState>): void;
     onSlashCommand(commands: string[], handler: SlashCommandHandler<TState>): void;
+    onAssistantThreadStarted(handler: AssistantThreadStartedHandler): void;
+    onAssistantContextChanged(handler: AssistantContextChangedHandler): void;
+    onAppHomeOpened(handler: AppHomeOpenedHandler): void;
     /**
      * Get an adapter by name with type safety.
      */
@@ -1802,6 +1849,9 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
         adapter: Adapter;
         channelId: string;
     }, options?: WebhookOptions): void;
+    processAssistantThreadStarted(event: AssistantThreadStartedEvent, options?: WebhookOptions): void;
+    processAssistantContextChanged(event: AssistantContextChangedEvent, options?: WebhookOptions): void;
+    processAppHomeOpened(event: AppHomeOpenedEvent, options?: WebhookOptions): void;
     /**
      * Handle a slash command event internally.
      */
@@ -2457,4 +2507,4 @@ declare const Select: typeof Select$1;
 declare const SelectOption: typeof SelectOption$1;
 declare const TextInput: typeof TextInput$1;
 
-export { type ActionEvent, type ActionHandler, Actions, type Adapter, type AdapterPostableMessage, type Attachment, type Author, BaseFormatConverter, Button, Card, CardChild, CardElement, CardJSXElement, CardText, type Channel, ChannelImpl, type ChannelInfo, Chat, type ChatConfig, ChatError, type ChatInstance, ConsoleLogger, type CustomEmojiMap, DEFAULT_EMOJI_MAP, Divider, type Emoji, type EmojiFormats, type EmojiMapConfig, EmojiResolver, type EmojiValue, type EphemeralMessage, type FetchDirection, type FetchOptions, type FetchResult, Field, Fields, type FileUpload, type FormatConverter, type FormattedContent, Image, LinkButton, type ListThreadsOptions, type ListThreadsResult, type Lock, LockError, type LogLevel, type Logger, type MarkdownConverter, type MentionHandler, Message, type MessageData, type MessageHandler, type MessageMetadata, Modal, type ModalCloseEvent, type ModalCloseHandler, type ModalCloseResponse, ModalElement, type ModalErrorsResponse, type ModalPushResponse, type ModalResponse, type ModalSubmitEvent, type ModalSubmitHandler, type ModalUpdateResponse, NotImplementedError, type PostEphemeralOptions, type Postable, type PostableAst, type PostableCard, type PostableMarkdown, type PostableMessage, type PostableRaw, RadioSelect, RateLimitError, type RawMessage, type ReactionEvent, type ReactionHandler, Section, Select, SelectOption, type SentMessage, type SerializedChannel, type SerializedMessage, type SerializedThread, type SlashCommandEvent, type SlashCommandHandler, type StateAdapter, type StreamOptions, type SubscribedMessageHandler, THREAD_STATE_TTL_MS, TextInput, type Thread, ThreadImpl, type ThreadInfo, type ThreadSummary, type WebhookOptions, type WellKnownEmoji, blockquote, codeBlock, convertEmojiPlaceholders, createEmoji, defaultEmojiResolver, deriveChannelId, emoji, emphasis, fromReactElement, fromReactModalElement, getEmoji, getNodeChildren, getNodeValue, inlineCode, isBlockquoteNode, isCardElement, isCodeNode, isDeleteNode, isEmphasisNode, isInlineCodeNode, isJSX, isLinkNode, isListItemNode, isListNode, isModalElement, isParagraphNode, isStrongNode, isTextNode, link, markdownToPlainText, paragraph, parseMarkdown, root, strikethrough, stringifyMarkdown, strong, text, toCardElement, toModalElement, toPlainText, walkAst };
+export { type ActionEvent, type ActionHandler, Actions, type Adapter, type AdapterPostableMessage, type AppHomeOpenedEvent, type AppHomeOpenedHandler, type AssistantContextChangedEvent, type AssistantContextChangedHandler, type AssistantThreadStartedEvent, type AssistantThreadStartedHandler, type Attachment, type Author, BaseFormatConverter, Button, Card, CardChild, CardElement, CardJSXElement, CardText, type Channel, ChannelImpl, type ChannelInfo, Chat, type ChatConfig, ChatError, type ChatInstance, ConsoleLogger, type CustomEmojiMap, DEFAULT_EMOJI_MAP, Divider, type Emoji, type EmojiFormats, type EmojiMapConfig, EmojiResolver, type EmojiValue, type EphemeralMessage, type FetchDirection, type FetchOptions, type FetchResult, Field, Fields, type FileUpload, type FormatConverter, type FormattedContent, Image, LinkButton, type ListThreadsOptions, type ListThreadsResult, type Lock, LockError, type LogLevel, type Logger, type MarkdownConverter, type MentionHandler, Message, type MessageData, type MessageHandler, type MessageMetadata, Modal, type ModalCloseEvent, type ModalCloseHandler, type ModalCloseResponse, ModalElement, type ModalErrorsResponse, type ModalPushResponse, type ModalResponse, type ModalSubmitEvent, type ModalSubmitHandler, type ModalUpdateResponse, NotImplementedError, type PostEphemeralOptions, type Postable, type PostableAst, type PostableCard, type PostableMarkdown, type PostableMessage, type PostableRaw, RadioSelect, RateLimitError, type RawMessage, type ReactionEvent, type ReactionHandler, Section, Select, SelectOption, type SentMessage, type SerializedChannel, type SerializedMessage, type SerializedThread, type SlashCommandEvent, type SlashCommandHandler, type StateAdapter, type StreamOptions, type SubscribedMessageHandler, THREAD_STATE_TTL_MS, TextInput, type Thread, ThreadImpl, type ThreadInfo, type ThreadSummary, type WebhookOptions, type WellKnownEmoji, blockquote, codeBlock, convertEmojiPlaceholders, createEmoji, defaultEmojiResolver, deriveChannelId, emoji, emphasis, fromReactElement, fromReactModalElement, getEmoji, getNodeChildren, getNodeValue, inlineCode, isBlockquoteNode, isCardElement, isCodeNode, isDeleteNode, isEmphasisNode, isInlineCodeNode, isJSX, isLinkNode, isListItemNode, isListNode, isModalElement, isParagraphNode, isStrongNode, isTextNode, link, markdownToPlainText, paragraph, parseMarkdown, root, strikethrough, stringifyMarkdown, strong, text, toCardElement, toModalElement, toPlainText, walkAst };

package/dist/index.js

@@ -1358,6 +1358,9 @@ var Chat = class {
   modalSubmitHandlers = [];
   modalCloseHandlers = [];
   slashCommandHandlers = [];
+  assistantThreadStartedHandlers = [];
+  assistantContextChangedHandlers = [];
+  appHomeOpenedHandlers = [];
   /** Initialization state */
   initPromise = null;
   initialized = false;
@@ -1590,6 +1593,18 @@ var Chat = class {
       });
     }
   }
+  onAssistantThreadStarted(handler) {
+    this.assistantThreadStartedHandlers.push(handler);
+    this.logger.debug("Registered assistant thread started handler");
+  }
+  onAssistantContextChanged(handler) {
+    this.assistantContextChangedHandlers.push(handler);
+    this.logger.debug("Registered assistant context changed handler");
+  }
+  onAppHomeOpened(handler) {
+    this.appHomeOpenedHandlers.push(handler);
+    this.logger.debug("Registered app home opened handler");
+  }
   /**
    * Get an adapter by name with type safety.
    */
@@ -1744,6 +1759,51 @@ var Chat = class {
       options.waitUntil(task);
     }
   }
+  processAssistantThreadStarted(event, options) {
+    const task = (async () => {
+      for (const handler of this.assistantThreadStartedHandlers) {
+        await handler(event);
+      }
+    })().catch((err) => {
+      this.logger.error("Assistant thread started handler error", {
+        error: err,
+        threadId: event.threadId
+      });
+    });
+    if (options?.waitUntil) {
+      options.waitUntil(task);
+    }
+  }
+  processAssistantContextChanged(event, options) {
+    const task = (async () => {
+      for (const handler of this.assistantContextChangedHandlers) {
+        await handler(event);
+      }
+    })().catch((err) => {
+      this.logger.error("Assistant context changed handler error", {
+        error: err,
+        threadId: event.threadId
+      });
+    });
+    if (options?.waitUntil) {
+      options.waitUntil(task);
+    }
+  }
+  processAppHomeOpened(event, options) {
+    const task = (async () => {
+      for (const handler of this.appHomeOpenedHandlers) {
+        await handler(event);
+      }
+    })().catch((err) => {
+      this.logger.error("App home opened handler error", {
+        error: err,
+        userId: event.userId
+      });
+    });
+    if (options?.waitUntil) {
+      options.waitUntil(task);
+    }
+  }
   /**
    * Handle a slash command event internally.
    */
@@ -1904,12 +1964,12 @@ var Chat = class {
       metadata: { dateSent: /* @__PURE__ */ new Date(), edited: false },
       attachments: []
     }) : {};
-    const thread = await this.createThread(
+    const thread = event.threadId ? await this.createThread(
       event.adapter,
       event.threadId,
       messageForThread,
       isSubscribed
-    );
+    ) : null;
     const fullEvent = {
       ...event,
       thread,