@memberjunction/messaging-adapters 0.0.1 → 5.18.0

package/dist/index.js

@@ -0,0 +1,76 @@
+/**
+ * @module @memberjunction/messaging-adapters
+ *
+ * Messaging platform adapters for MemberJunction AI agents.
+ *
+ * This package provides Slack and Microsoft Teams integrations that allow
+ * MJ AI agents to be invoked directly from messaging platforms. Messages
+ * are received via webhooks, routed to the appropriate agent via
+ * `AgentRunner.RunAgent()`, and responses are streamed back as rich
+ * formatted messages (Slack Block Kit / Teams Adaptive Cards).
+ *
+ * ## Architecture
+ *
+ * Built on the MJServer Extension framework (`@memberjunction/server-extensions-core`):
+ * - `SlackMessagingExtension` and `TeamsMessagingExtension` extend `BaseServerExtension`
+ * - Auto-discovered via `@RegisterClass` and configured in `mj.config.cjs`
+ * - Zero MJServer source code changes needed per adapter
+ *
+ * ## Quick Start
+ *
+ * ```javascript
+ * // mj.config.cjs
+ * serverExtensions: [
+ *     {
+ *         Enabled: true,
+ *         DriverClass: 'SlackMessagingExtension',
+ *         RootPath: '/webhook/slack',
+ *         Settings: {
+ *             DefaultAgentName: 'Sage',
+ *             ContextUserEmail: 'bot@company.com',
+ *             BotToken: process.env.SLACK_BOT_TOKEN,
+ *             SigningSecret: process.env.SLACK_SIGNING_SECRET,
+ *         }
+ *     }
+ * ]
+ * ```
+ *
+ * @see {@link BaseMessagingAdapter} for the shared adapter base class
+ * @see {@link SlackMessagingExtension} for Slack integration
+ * @see {@link TeamsMessagingExtension} for Teams integration
+ */
+// Base adapter and types
+export { BaseMessagingAdapter } from './base/BaseMessagingAdapter.js';
+export { splitMarkdownIntoSections, convertToSlackMrkdwn, convertBoldToSlackFormat, convertLinksToSlackFormat, truncateText, splitTextIntoChunks, } from './base/message-formatter.js';
+// Slack adapter
+export { SlackMessagingExtension } from './slack/SlackMessagingExtension.js';
+export { SlackAdapter } from './slack/SlackAdapter.js';
+export { markdownToBlocks } from './slack/slack-formatter.js';
+export { verifySlackSignature } from './slack/slack-routes.js';
+export { handleSlackInteraction, registerActiveForm } from './slack/slack-interactivity.js';
+export { buildRichResponse, buildAgentContextBlock, buildTextBlocks, buildArtifactCard, buildActionButtons, buildMediaBlocks, buildErrorBlocks, buildMetadataFooter, buildDivider, buildResponseForm, buildFormModal, buildNotificationBlocks, getFullResponseText, } from './slack/slack-block-builder.js';
+// Teams adapter
+export { TeamsMessagingExtension } from './teams/TeamsMessagingExtension.js';
+export { TeamsAdapter } from './teams/TeamsAdapter.js';
+export { markdownToAdaptiveCard } from './teams/teams-formatter.js';
+export { buildRichAdaptiveCard, buildAgentHeader as buildTeamsAgentHeader, buildTextBody as buildTeamsTextBody, buildArtifactCard as buildTeamsArtifactCard, buildActionButtons as buildTeamsActionButtons, buildExplorerLink as buildTeamsExplorerLink, buildMetadataFooter as buildTeamsMetadataFooter, buildErrorCard as buildTeamsErrorCard, buildResponseFormElements as buildTeamsResponseFormElements, } from './teams/teams-card-builder.js';
+/**
+ * Tree-shaking prevention function.
+ *
+ * Import and call this function from your application's entry point
+ * (or include it in the class manifest) to ensure the `@RegisterClass`
+ * decorators on `SlackMessagingExtension` and `TeamsMessagingExtension`
+ * fire at module load time.
+ *
+ * @example
+ * ```typescript
+ * import { LoadMessagingAdapters } from '@memberjunction/messaging-adapters';
+ * LoadMessagingAdapters();
+ * ```
+ */
+export function LoadMessagingAdapters() {
+    // This function exists solely to create a static reference that
+    // prevents bundlers from tree-shaking the @RegisterClass decorators.
+    // The decorators fire as a side effect of importing the module.
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAUtE,OAAO,EACH,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,mBAAmB,GACtB,MAAM,6BAA6B,CAAC;AAErC,gBAAgB;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EACH,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,GACtB,MAAM,gCAAgC,CAAC;AAGxC,gBAAgB;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EACH,qBAAqB,EACrB,gBAAgB,IAAI,qBAAqB,EACzC,aAAa,IAAI,kBAAkB,EACnC,iBAAiB,IAAI,sBAAsB,EAC3C,kBAAkB,IAAI,uBAAuB,EAC7C,iBAAiB,IAAI,sBAAsB,EAC3C,mBAAmB,IAAI,wBAAwB,EAC/C,cAAc,IAAI,mBAAmB,EACrC,yBAAyB,IAAI,8BAA8B,GAC9D,MAAM,+BAA+B,CAAC;AAGvC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB;IACjC,gEAAgE;IAChE,qEAAqE;IACrE,gEAAgE;AACpE,CAAC"}

package/dist/slack/SlackAdapter.d.ts

@@ -0,0 +1,141 @@
+/**
+ * @module @memberjunction/messaging-adapters
+ * @description Slack-specific messaging adapter implementation.
+ *
+ * Extends `BaseMessagingAdapter` with Slack API calls for:
+ * - Posting and updating messages via the Web API with per-agent identity
+ * - Fetching thread history via `conversations.replies`
+ * - Rich Block Kit formatting with agent context, artifact cards, and metadata
+ * - Multi-word agent name matching via known-name lookup
+ * - Looking up user email addresses
+ * - Stripping bot @mentions from message text
+ */
+import { ExecuteAgentResult, MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';
+import { BaseMessagingAdapter } from '../base/BaseMessagingAdapter.js';
+import { IncomingMessage, FormattedResponse, MessagingAdapterSettings, AgentResponseMetadata } from '../base/types.js';
+/**
+ * Slack-specific adapter that implements all platform operations
+ * using the Slack Web API (`@slack/web-api`).
+ *
+ * ## Features
+ * - Per-agent identity: each agent's name and avatar appear on their messages
+ * - Thread-based conversation context via `conversations.replies`
+ * - Progressive streaming updates via `chat.postMessage` / `chat.update`
+ * - Rich Block Kit formatting with agent headers, artifact cards, and metadata
+ * - Multi-word agent name matching (e.g., `@Research Agent`)
+ * - User email lookup via `users.info` for MJ user mapping
+ * - Bot mention stripping for clean agent input
+ *
+ * ## Authentication
+ * Requires a Bot User OAuth Token (`xoxb-...`) with these scopes:
+ * - `chat:write` — Post and update messages
+ * - `chat:write.customize` — Post with custom username and icon
+ * - `channels:history` / `groups:history` / `im:history` — Read thread history
+ * - `users:read` / `users:read.email` — Look up user email addresses
+ * - `app_mentions:read` — Receive @mention events
+ */
+export declare class SlackAdapter extends BaseMessagingAdapter {
+    /** Slack Web API client. */
+    private client;
+    /** The bot's own Slack user ID (e.g., `U0123456`). */
+    private botUserID;
+    /**
+     * Message IDs of "Thinking..." indicators, keyed by `channelId:threadTs`.
+     * Per-thread keying prevents concurrent messages from overwriting each other's indicator.
+     */
+    private thinkingMessageIds;
+    /**
+     * Slack's maximum message text length. Messages exceeding this cause `msg_too_long`.
+     * The `text` field is the plain-text fallback when blocks are present; the rich
+     * content is in Block Kit blocks (already limited to 50 blocks with "View Full" button).
+     */
+    private static readonly MAX_TEXT_LENGTH;
+    protected get PlatformName(): string;
+    constructor(settings: MessagingAdapterSettings);
+    /**
+     * Convert a raw Slack event payload into a normalized `IncomingMessage`.
+     *
+     * Called by `SlackMessagingExtension` when a webhook event is received.
+     * Uses multi-word agent name matching against the loaded agent list.
+     *
+     * @param event - Raw Slack event object from the Events API.
+     * @returns Normalized incoming message.
+     */
+    MapSlackEvent(event: Record<string, unknown>): IncomingMessage;
+    /**
+     * Fetch the bot's own user ID from the Slack API.
+     * This is needed to identify bot messages in thread history.
+     */
+    protected onInitialize(): Promise<void>;
+    protected getBotUserId(): string;
+    /**
+     * Post a "Thinking..." message as the typing indicator.
+     * Shows the agent's identity if available. This message gets replaced
+     * in-place by the first streaming update.
+     */
+    protected showTypingIndicator(message: IncomingMessage, agent?: MJAIAgentEntityExtended): Promise<void>;
+    /**
+     * Fetch all messages in a Slack thread using `conversations.replies`.
+     */
+    protected fetchThreadHistory(channelId: string, threadId: string): Promise<IncomingMessage[]>;
+    /**
+     * Post a new streaming message or update an existing one.
+     * Shows the agent's identity on new messages.
+     */
+    protected sendOrUpdateStreamingMessage(originalMessage: IncomingMessage, currentContent: string, existingMessageId: string | null, agent?: MJAIAgentEntityExtended): Promise<string>;
+    /**
+     * Send the final formatted response. If a "Thinking..." message exists
+     * (no streaming occurred), update it in-place instead of posting a new message.
+     */
+    protected sendFinalMessage(originalMessage: IncomingMessage, response: FormattedResponse): Promise<void>;
+    /**
+     * Update the streaming progress message with the final formatted response.
+     */
+    protected updateFinalMessage(originalMessage: IncomingMessage, messageId: string, response: FormattedResponse): Promise<void>;
+    /**
+     * Format agent response as rich Slack Block Kit blocks.
+     *
+     * When a full `ExecuteAgentResult` is available, builds a rich layout with
+     * agent header, artifact cards, action buttons, and metadata footer.
+     * Falls back to simple markdown→blocks conversion for plain text.
+     */
+    protected formatResponse(result: ExecuteAgentResult | null, agent: MJAIAgentEntityExtended, responseText: string, metadata?: AgentResponseMetadata): Promise<FormattedResponse>;
+    /**
+     * Strip the bot's @mention from the message text.
+     * Slack @mentions use the format `<@U0123456>`.
+     */
+    protected stripBotMention(text: string): string;
+    /**
+     * Look up a Slack user's email address via the Web API.
+     *
+     * Requires the `users:read.email` scope on the bot token.
+     *
+     * @param platformUserId - Slack user ID (e.g., `U0123456`).
+     * @returns Email address, or `null` if not available.
+     */
+    protected lookupUserEmail(platformUserId: string): Promise<string | null>;
+    /** Build a unique key for per-thread state (thinking indicator). */
+    private threadKey;
+    /**
+     * Truncate text to Slack's message length limit.
+     * Appends an ellipsis note if truncated so users know content was cut.
+     */
+    private truncateForSlack;
+    /**
+     * Truncate text for use as the `text` fallback when Block Kit blocks are present.
+     * The `text` field is only shown in notifications/accessibility — the blocks contain
+     * the rich content. Keeping it short avoids `msg_too_long` when blocks are large.
+     */
+    private truncateForSlackFallback;
+    /**
+     * Build Slack API params for per-agent identity.
+     * Uses `username` and `icon_url` which require the `chat:write.customize` scope.
+     * Only includes `icon_url` if it's a valid HTTPS URL.
+     */
+    private buildIdentityParams;
+    /** Build identity params from an agent entity. */
+    private buildSlackIdentityParams;
+    /** Build identity params from an AgentIdentity object. */
+    private buildSlackIdentityParamsFromIdentity;
+}
+//# sourceMappingURL=SlackAdapter.d.ts.map

package/dist/slack/SlackAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlackAdapter.d.ts","sourceRoot":"","sources":["../../src/slack/SlackAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAIvH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAa,SAAQ,oBAAoB;IAClD,4BAA4B;IAC5B,OAAO,CAAC,MAAM,CAAY;IAE1B,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAc;IAE/B;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAA6B;IAEvD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAU;IAEjD,SAAS,KAAK,YAAY,IAAI,MAAM,CAAoB;gBAE5C,QAAQ,EAAE,wBAAwB;IAK9C;;;;;;;;OAQG;IACI,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe;IAiBrE;;;OAGG;cACa,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7C,SAAS,CAAC,YAAY,IAAI,MAAM;IAIhC;;;;OAIG;cACa,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7G;;OAEG;cACa,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAqBnG;;;OAGG;cACa,4BAA4B,CACxC,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,KAAK,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,MAAM,CAAC;IA2BlB;;;OAGG;cACa,gBAAgB,CAAC,eAAe,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB9G;;OAEG;cACa,kBAAkB,CAC9B,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;OAMG;cACa,cAAc,CAC1B,MAAM,EAAE,kBAAkB,GAAG,IAAI,EACjC,KAAK,EAAE,uBAAuB,EAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,qBAAqB,GACjC,OAAO,CAAC,iBAAiB,CAAC;IAiB7B;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/C;;;;;;;OAOG;cACa,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY/E,oEAAoE;IACpE,OAAO,CAAC,SAAS;IAIjB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAS3B,kDAAkD;IAClD,OAAO,CAAC,wBAAwB;IAIhC,0DAA0D;IAC1D,OAAO,CAAC,oCAAoC;CAG/C"}

package/dist/slack/SlackAdapter.js

@@ -0,0 +1,291 @@
+/**
+ * @module @memberjunction/messaging-adapters
+ * @description Slack-specific messaging adapter implementation.
+ *
+ * Extends `BaseMessagingAdapter` with Slack API calls for:
+ * - Posting and updating messages via the Web API with per-agent identity
+ * - Fetching thread history via `conversations.replies`
+ * - Rich Block Kit formatting with agent context, artifact cards, and metadata
+ * - Multi-word agent name matching via known-name lookup
+ * - Looking up user email addresses
+ * - Stripping bot @mentions from message text
+ */
+import { WebClient } from '@slack/web-api';
+import { LogStatus } from '@memberjunction/core';
+import { BaseMessagingAdapter } from '../base/BaseMessagingAdapter.js';
+import { buildRichResponse } from './slack-block-builder.js';
+/**
+ * Slack-specific adapter that implements all platform operations
+ * using the Slack Web API (`@slack/web-api`).
+ *
+ * ## Features
+ * - Per-agent identity: each agent's name and avatar appear on their messages
+ * - Thread-based conversation context via `conversations.replies`
+ * - Progressive streaming updates via `chat.postMessage` / `chat.update`
+ * - Rich Block Kit formatting with agent headers, artifact cards, and metadata
+ * - Multi-word agent name matching (e.g., `@Research Agent`)
+ * - User email lookup via `users.info` for MJ user mapping
+ * - Bot mention stripping for clean agent input
+ *
+ * ## Authentication
+ * Requires a Bot User OAuth Token (`xoxb-...`) with these scopes:
+ * - `chat:write` — Post and update messages
+ * - `chat:write.customize` — Post with custom username and icon
+ * - `channels:history` / `groups:history` / `im:history` — Read thread history
+ * - `users:read` / `users:read.email` — Look up user email addresses
+ * - `app_mentions:read` — Receive @mention events
+ */
+export class SlackAdapter extends BaseMessagingAdapter {
+    /**
+     * Slack's maximum message text length. Messages exceeding this cause `msg_too_long`.
+     * The `text` field is the plain-text fallback when blocks are present; the rich
+     * content is in Block Kit blocks (already limited to 50 blocks with "View Full" button).
+     */
+    static { this.MAX_TEXT_LENGTH = 39_000; }
+    get PlatformName() { return 'Slack'; }
+    constructor(settings) {
+        super(settings);
+        /** The bot's own Slack user ID (e.g., `U0123456`). */
+        this.botUserID = '';
+        /**
+         * Message IDs of "Thinking..." indicators, keyed by `channelId:threadTs`.
+         * Per-thread keying prevents concurrent messages from overwriting each other's indicator.
+         */
+        this.thinkingMessageIds = new Map();
+        this.client = new WebClient(settings.BotToken);
+    }
+    /**
+     * Convert a raw Slack event payload into a normalized `IncomingMessage`.
+     *
+     * Called by `SlackMessagingExtension` when a webhook event is received.
+     * Uses multi-word agent name matching against the loaded agent list.
+     *
+     * @param event - Raw Slack event object from the Events API.
+     * @returns Normalized incoming message.
+     */
+    MapSlackEvent(event) {
+        const text = event.text ?? '';
+        return {
+            MessageID: event.ts,
+            Text: text,
+            SenderID: event.user ?? event.bot_id ?? '',
+            SenderName: event.username ?? '',
+            ChannelID: event.channel,
+            ThreadID: event.thread_ts ?? null,
+            IsDirectMessage: event.channel_type === 'im',
+            IsBotMention: event.type === 'app_mention',
+            MentionedAgentNames: this.matchAgentMentions(text),
+            Timestamp: new Date(parseFloat(event.ts) * 1000),
+            RawEvent: event
+        };
+    }
+    /**
+     * Fetch the bot's own user ID from the Slack API.
+     * This is needed to identify bot messages in thread history.
+     */
+    async onInitialize() {
+        const authResult = await this.client.auth.test();
+        this.botUserID = authResult.user_id;
+    }
+    getBotUserId() {
+        return this.botUserID;
+    }
+    /**
+     * Post a "Thinking..." message as the typing indicator.
+     * Shows the agent's identity if available. This message gets replaced
+     * in-place by the first streaming update.
+     */
+    async showTypingIndicator(message, agent) {
+        const threadTs = message.ThreadID ?? message.MessageID;
+        const identityParams = agent ? this.buildSlackIdentityParams(agent) : {};
+        const result = await this.client.chat.postMessage({
+            channel: message.ChannelID,
+            thread_ts: threadTs,
+            text: '_Thinking..._',
+            ...identityParams
+        });
+        if (result.ts) {
+            this.thinkingMessageIds.set(this.threadKey(message), result.ts);
+        }
+    }
+    /**
+     * Fetch all messages in a Slack thread using `conversations.replies`.
+     */
+    async fetchThreadHistory(channelId, threadId) {
+        const result = await this.client.conversations.replies({
+            channel: channelId,
+            ts: threadId,
+            limit: this.settings.MaxThreadMessages ?? 50
+        });
+        return (result.messages ?? []).map(msg => ({
+            MessageID: msg.ts,
+            Text: msg.text ?? '',
+            SenderID: msg.user ?? msg.bot_id ?? '',
+            SenderName: msg.username ?? '',
+            ChannelID: channelId,
+            ThreadID: threadId,
+            IsDirectMessage: false,
+            IsBotMention: false,
+            Timestamp: new Date(parseFloat(msg.ts) * 1000),
+            RawEvent: msg
+        }));
+    }
+    /**
+     * Post a new streaming message or update an existing one.
+     * Shows the agent's identity on new messages.
+     */
+    async sendOrUpdateStreamingMessage(originalMessage, currentContent, existingMessageId, agent) {
+        // Reuse the "Thinking..." message for the first streaming update
+        const key = this.threadKey(originalMessage);
+        const messageToUpdate = existingMessageId ?? this.thinkingMessageIds.get(key) ?? null;
+        if (messageToUpdate) {
+            this.thinkingMessageIds.delete(key); // Consumed
+            await this.client.chat.update({
+                channel: originalMessage.ChannelID,
+                ts: messageToUpdate,
+                text: this.truncateForSlack(currentContent + ' ...')
+            });
+            return messageToUpdate;
+        }
+        else {
+            const threadTs = originalMessage.ThreadID ?? originalMessage.MessageID;
+            const identityParams = agent ? this.buildSlackIdentityParams(agent) : {};
+            const result = await this.client.chat.postMessage({
+                channel: originalMessage.ChannelID,
+                thread_ts: threadTs,
+                text: this.truncateForSlack(currentContent + ' ...'),
+                ...identityParams
+            });
+            return result.ts;
+        }
+    }
+    /**
+     * Send the final formatted response. If a "Thinking..." message exists
+     * (no streaming occurred), update it in-place instead of posting a new message.
+     */
+    async sendFinalMessage(originalMessage, response) {
+        const key = this.threadKey(originalMessage);
+        const thinkingId = this.thinkingMessageIds.get(key);
+        if (thinkingId) {
+            this.thinkingMessageIds.delete(key);
+            await this.updateFinalMessage(originalMessage, thinkingId, response);
+            return;
+        }
+        const threadTs = originalMessage.ThreadID ?? originalMessage.MessageID;
+        const identityParams = response.AgentIdentity
+            ? this.buildSlackIdentityParamsFromIdentity(response.AgentIdentity)
+            : {};
+        await this.client.chat.postMessage({
+            channel: originalMessage.ChannelID,
+            thread_ts: threadTs,
+            text: this.truncateForSlackFallback(response.PlainText),
+            blocks: response.RichPayload.blocks,
+            ...identityParams
+        });
+    }
+    /**
+     * Update the streaming progress message with the final formatted response.
+     */
+    async updateFinalMessage(originalMessage, messageId, response) {
+        await this.client.chat.update({
+            channel: originalMessage.ChannelID,
+            ts: messageId,
+            text: this.truncateForSlackFallback(response.PlainText),
+            blocks: response.RichPayload.blocks
+        });
+    }
+    /**
+     * Format agent response as rich Slack Block Kit blocks.
+     *
+     * When a full `ExecuteAgentResult` is available, builds a rich layout with
+     * agent header, artifact cards, action buttons, and metadata footer.
+     * Falls back to simple markdown→blocks conversion for plain text.
+     */
+    async formatResponse(result, agent, responseText, metadata) {
+        const identity = this.buildAgentIdentity(agent);
+        // Build rich Block Kit layout
+        const blocks = buildRichResponse(result, agent, responseText, {
+            explorerBaseURL: this.settings.ExplorerBaseURL,
+            artifactId: metadata?.ArtifactId,
+            conversationId: metadata?.ConversationId,
+        });
+        return {
+            PlainText: responseText,
+            RichPayload: { blocks },
+            AgentIdentity: identity
+        };
+    }
+    /**
+     * Strip the bot's @mention from the message text.
+     * Slack @mentions use the format `<@U0123456>`.
+     */
+    stripBotMention(text) {
+        return text.replace(new RegExp(`<@${this.botUserID}>`, 'g'), '').trim();
+    }
+    /**
+     * Look up a Slack user's email address via the Web API.
+     *
+     * Requires the `users:read.email` scope on the bot token.
+     *
+     * @param platformUserId - Slack user ID (e.g., `U0123456`).
+     * @returns Email address, or `null` if not available.
+     */
+    async lookupUserEmail(platformUserId) {
+        try {
+            const result = await this.client.users.info({ user: platformUserId });
+            return result.user?.profile?.email ?? null;
+        }
+        catch (error) {
+            LogStatus(`Slack user email lookup failed for '${platformUserId}' (falling back to service account)`);
+            return null;
+        }
+    }
+    // ─── Private helpers ─────────────────────────────────────────────
+    /** Build a unique key for per-thread state (thinking indicator). */
+    threadKey(message) {
+        return `${message.ChannelID}:${message.ThreadID ?? message.MessageID}`;
+    }
+    /**
+     * Truncate text to Slack's message length limit.
+     * Appends an ellipsis note if truncated so users know content was cut.
+     */
+    truncateForSlack(text) {
+        if (text.length <= SlackAdapter.MAX_TEXT_LENGTH)
+            return text;
+        return text.slice(0, SlackAdapter.MAX_TEXT_LENGTH - 50) + '\n\n... (message truncated due to length)';
+    }
+    /**
+     * Truncate text for use as the `text` fallback when Block Kit blocks are present.
+     * The `text` field is only shown in notifications/accessibility — the blocks contain
+     * the rich content. Keeping it short avoids `msg_too_long` when blocks are large.
+     */
+    truncateForSlackFallback(text) {
+        const MAX_FALLBACK = 4000;
+        if (text.length <= MAX_FALLBACK)
+            return text;
+        return text.slice(0, MAX_FALLBACK - 30) + '\n\n(See full response above)';
+    }
+    /**
+     * Build Slack API params for per-agent identity.
+     * Uses `username` and `icon_url` which require the `chat:write.customize` scope.
+     * Only includes `icon_url` if it's a valid HTTPS URL.
+     */
+    buildIdentityParams(name, iconUrl) {
+        const params = {};
+        if (name)
+            params.username = name;
+        if (iconUrl && typeof iconUrl === 'string' && iconUrl.startsWith('https://')) {
+            params.icon_url = iconUrl;
+        }
+        return params;
+    }
+    /** Build identity params from an agent entity. */
+    buildSlackIdentityParams(agent) {
+        return this.buildIdentityParams(agent.Name, agent.LogoURL);
+    }
+    /** Build identity params from an AgentIdentity object. */
+    buildSlackIdentityParamsFromIdentity(identity) {
+        return this.buildIdentityParams(identity.Name, identity.IconURL);
+    }
+}
+//# sourceMappingURL=SlackAdapter.js.map

package/dist/slack/SlackAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlackAdapter.js","sourceRoot":"","sources":["../../src/slack/SlackAdapter.ts"],"names":[],"mappings":"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"}