@chat-adapter/slack 4.11.0 → 4.13.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CardElement, BaseFormatConverter, AdapterPostableMessage, Root, Logger, Adapter, ChatInstance, WebhookOptions, RawMessage, EphemeralMessage, ModalElement, EmojiValue, StreamOptions, FetchOptions, FetchResult, ThreadInfo, Message, FormattedContent } from 'chat';
+import { CardElement, BaseFormatConverter, AdapterPostableMessage, Root, Logger, Adapter, ChatInstance, WebhookOptions, RawMessage, EphemeralMessage, ModalElement, EmojiValue, StreamOptions, FetchOptions, FetchResult, ThreadInfo, Message, ListThreadsOptions, ListThreadsResult, ChannelInfo, FormattedContent } from 'chat';
 
 /**
  * Slack Block Kit converter for cross-platform cards.
@@ -121,6 +121,10 @@ interface SlackEvent {
     }>;
     team?: string;
     team_id?: string;
+    /** Number of replies in the thread (present on thread parent messages) */
+    reply_count?: number;
+    /** Timestamp of the latest reply (present on thread parent messages) */
+    latest_reply?: string;
 }
 /** Slack reaction event payload */
 interface SlackReactionEvent {
@@ -214,6 +218,11 @@ declare class SlackAdapter implements Adapter<SlackThreadId, unknown> {
      * These are sent as form-urlencoded with a `payload` JSON field.
      */
     private handleInteractivePayload;
+    /**
+     * Handle Slack slash command payloads.
+     * Slash commands are sent as form-urlencoded with command, text, user_id, channel_id, etc.
+     */
+    private handleSlashCommand;
     /**
      * Handle block_actions payload (button clicks in Block Kit).
      */
@@ -232,6 +241,55 @@ declare class SlackAdapter implements Adapter<SlackThreadId, unknown> {
      * Handle reaction events from Slack (reaction_added, reaction_removed).
      */
     private handleReactionEvent;
+    /**
+     * Handle assistant_thread_started events from Slack's Assistants API.
+     * Fires when a user opens a new assistant thread (DM with the bot).
+     */
+    private handleAssistantThreadStarted;
+    /**
+     * Handle assistant_thread_context_changed events from Slack's Assistants API.
+     * Fires when a user navigates to a different channel with the assistant panel open.
+     */
+    private handleAssistantContextChanged;
+    /**
+     * Handle app_home_opened events from Slack.
+     * Fires when a user opens the bot's Home tab.
+     */
+    private handleAppHomeOpened;
+    /**
+     * Publish a Home tab view for a user.
+     * Slack API: views.publish
+     */
+    publishHomeView(userId: string, view: Record<string, unknown>): Promise<void>;
+    /**
+     * Set suggested prompts for an assistant thread.
+     * Slack Assistants API: assistant.threads.setSuggestedPrompts
+     */
+    setSuggestedPrompts(channelId: string, threadTs: string, prompts: Array<{
+        title: string;
+        message: string;
+    }>, title?: string): Promise<void>;
+    /**
+     * Set status/thinking indicator for an assistant thread.
+     * Slack Assistants API: assistant.threads.setStatus
+     */
+    setAssistantStatus(channelId: string, threadTs: string, status: string, loadingMessages?: string[]): Promise<void>;
+    /**
+     * Set title for an assistant thread (shown in History tab).
+     * Slack Assistants API: assistant.threads.setTitle
+     */
+    setAssistantTitle(channelId: string, threadTs: string, title: string): Promise<void>;
+    /**
+     * Resolve inline user mentions in Slack mrkdwn text.
+     * Converts <@U123> to <@U123|displayName> so that toAst/extractPlainText
+     * renders them as @displayName instead of @U123.
+     *
+     * @param skipSelfMention - When true, skips the bot's own user ID so that
+     *   mention detection (which looks for @botUserId in the text) continues to
+     *   work. Set to false when parsing historical/channel messages where mention
+     *   detection doesn't apply.
+     */
+    private resolveInlineMentions;
     private parseSlackMessage;
     /**
      * Create an Attachment object from a Slack file.
@@ -304,6 +362,30 @@ declare class SlackAdapter implements Adapter<SlackThreadId, unknown> {
      * Used for parseMessage interface - falls back to user ID for username.
      */
     private parseSlackMessageSync;
+    /**
+     * Derive channel ID from a Slack thread ID.
+     * Slack thread IDs are "slack:CHANNEL:THREAD_TS", channel ID is "slack:CHANNEL".
+     */
+    channelIdFromThreadId(threadId: string): string;
+    /**
+     * Fetch channel-level messages (conversations.history, not thread replies).
+     */
+    fetchChannelMessages(channelId: string, options?: FetchOptions): Promise<FetchResult<unknown>>;
+    private fetchChannelMessagesForward;
+    private fetchChannelMessagesBackward;
+    /**
+     * List threads in a Slack channel.
+     * Fetches channel history and filters for messages with replies.
+     */
+    listThreads(channelId: string, options?: ListThreadsOptions): Promise<ListThreadsResult<unknown>>;
+    /**
+     * Fetch Slack channel info/metadata.
+     */
+    fetchChannelInfo(channelId: string): Promise<ChannelInfo>;
+    /**
+     * Post a top-level message to a channel (not in a thread).
+     */
+    postChannelMessage(channelId: string, message: AdapterPostableMessage): Promise<RawMessage<unknown>>;
     renderFormatted(content: FormattedContent): string;
     /**
      * Check if a Slack event is from this bot.