@mastra/slack 1.2.1-alpha.0 → 1.3.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @mastra/slack
 
+## 1.3.0-alpha.0
+
+### Minor Changes
+
+- Improved Slack channel UX: ([#16937](https://github.com/mastra-ai/mastra/pull/16937))
+  - **Flat adapter config** — `SlackProvider` now accepts per-adapter options (`formatError`, `streaming`, `typingStatus`, `toolDisplay`) directly at the top level instead of nesting under `adapterConfig`. The `adapterConfig` field still works as a deprecated fallback.
+  - **Breaking change** — the `cards: boolean` and `formatToolCall` fields have been removed from `SlackProviderConfig`/`SlackAdapterChannelConfig`. Migrate `cards: false` → `toolDisplay: 'text'`, and `formatToolCall: (info) => msg` → `toolDisplay: (event) => event.kind === 'result' ? { kind: 'post', message: msg } : undefined`.
+  - **Opinionated defaults** — `SlackProvider` now defaults `streaming: true` and `toolDisplay: 'grouped'` since the grouped "Thinking Steps" widget renders well in Slack's AI Assistant UI. When `streaming: false` is explicitly set, `toolDisplay` falls back to `'cards'` since `'grouped'` requires streaming. Override either per-config to restore other modes.
+  - **AI Assistant manifest** — `assistant:write` is now part of `DEFAULT_BOT_SCOPES` and the generated manifest declares the matching `assistant_view` feature, so newly generated app manifests support the AI Assistant surface and thread context in DMs.
+  - **Slack DM tool-approval routing** — clicks on tool-approval cards in Slack DMs now resume the correct Mastra thread.
+
+  ```ts
+  import { SlackProvider } from '@mastra/slack';
+
+  const slack = new SlackProvider({
+    // Top-level options (preferred):
+    streaming: true,
+    toolDisplay: 'grouped', // or 'cards' | 'text' | 'timeline' | 'hidden' | ToolDisplayFn
+  });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`0cbece9`](https://github.com/mastra-ai/mastra/commit/0cbece9d832cb134a74cdbf3682d390a058215a4), [`7dfe1bc`](https://github.com/mastra-ai/mastra/commit/7dfe1bcfe71d261a6fd6bbf29b1dec49d78fb98f), [`70cb714`](https://github.com/mastra-ai/mastra/commit/70cb7149c8f16f478e15b58498254a53181750a4), [`7f9da22`](https://github.com/mastra-ai/mastra/commit/7f9da22efd5aa595e138a31de55a5f0f2f28b33d)]:
+  - @mastra/core@1.37.0-alpha.6
+
+## 1.2.1
+
+### Patch Changes
+
+- - `SlackProvider.connect()` now merges with existing channel adapters instead of replacing them, preserving adapters the agent author already configured (e.g. Discord). ([#16517](https://github.com/mastra-ai/mastra/pull/16517))
+  - Slack interactive payloads (button clicks, modal submissions) no longer return `400 Malformed JSON body`. The provider only JSON-parses the body for the events callback path and forwards form-urlencoded payloads to the adapter's webhook handler unchanged.
+  - Bumped `chat` to `^4.29.0`.
+- Updated dependencies [[`452036a`](https://github.com/mastra-ai/mastra/commit/452036a0d965b4f4c1efd93606e4f03b50b807a5), [`c272d50`](https://github.com/mastra-ai/mastra/commit/c272d50610a54496b6b6d92ccd4d37b333a2613a), [`27fd1b7`](https://github.com/mastra-ai/mastra/commit/27fd1b79ac62eb7694f92587eb7d1be05b59be01), [`5ba7253`](https://github.com/mastra-ai/mastra/commit/5ba7253745c85e8df8012a76d954c640ffa336f7), [`5556cc1`](https://github.com/mastra-ai/mastra/commit/5556cc1befec71518d84f826b3bfe3a079a9daf7), [`f73980d`](https://github.com/mastra-ai/mastra/commit/f73980d651eb5f7f1ab20582de4615a1b6f10fce), [`5499303`](https://github.com/mastra-ai/mastra/commit/54993032c1ebc09642625b78d2014e0cf84a3cae), [`a702009`](https://github.com/mastra-ai/mastra/commit/a702009d3cfaa745120f501e21c783ed4d6a3072), [`9aee493`](https://github.com/mastra-ai/mastra/commit/9aee493ed6089b5133472623dcce49934bf2d509), [`d8692af`](https://github.com/mastra-ai/mastra/commit/d8692afa253028e39cdce2aafa0ac414071a762e), [`1a9cc60`](https://github.com/mastra-ai/mastra/commit/1a9cc6069f9910fc3d59e4953ac8cd95d89ad6f5), [`8cdb86c`](https://github.com/mastra-ai/mastra/commit/8cdb86ceed1137bc2768e147dce85a0692b9fb26), [`8534d79`](https://github.com/mastra-ai/mastra/commit/8534d791fa1cb70fe1c19e2604c4b63cc10dd051), [`eda90c5`](https://github.com/mastra-ai/mastra/commit/eda90c5bfd7de11805ecc9f4552716c895fbaf78), [`a935b0a`](https://github.com/mastra-ai/mastra/commit/a935b0a0977ae3f196b33ec7621f528069c82db0), [`9c88701`](https://github.com/mastra-ai/mastra/commit/9c8870195b41a38dc40b6ba2aa55eda04df8fa69), [`c78f8cd`](https://github.com/mastra-ai/mastra/commit/c78f8cd6222a86e6c60ae5210b6929ad5221b6fb), [`e146aad`](https://github.com/mastra-ai/mastra/commit/e146aadbba66c410ba0e74bac4c50135495cb8dd), [`ac79462`](https://github.com/mastra-ai/mastra/commit/ac79462b98f1062394c45093aa515b0766f27ee2), [`1a0ec78`](https://github.com/mastra-ai/mastra/commit/1a0ec789a26cae443744e9abbd62ed6ee676af39), [`e47bca7`](https://github.com/mastra-ai/mastra/commit/e47bca7b72866d3abd173b9f530ac4318113a8ff), [`afc004f`](https://github.com/mastra-ai/mastra/commit/afc004f5cc7e30697809e7021820b9f5881e6719), [`0031d0f`](https://github.com/mastra-ai/mastra/commit/0031d0f13831d7843ac5d498734a7d92862e2ce3), [`841a222`](https://github.com/mastra-ai/mastra/commit/841a222560d8c19238f8213713f30535cdd82284), [`64c1e0b`](https://github.com/mastra-ai/mastra/commit/64c1e0b35165c96b659818bd0177aa18794ef11f), [`40d83a9`](https://github.com/mastra-ai/mastra/commit/40d83a90d9be31a1b83e04649edb703eb7753e33), [`4e88dc6`](https://github.com/mastra-ai/mastra/commit/4e88dc6b89f154c0eae37221c8126be0c23c569f), [`19018f0`](https://github.com/mastra-ai/mastra/commit/19018f05722af74a5978781a7731a654b26f7f2a), [`19281c7`](https://github.com/mastra-ai/mastra/commit/19281c70424f757219782de16c2699743c5e04d0), [`3498b49`](https://github.com/mastra-ai/mastra/commit/3498b4946be94f4313cd817733589680dcda5278), [`d52b6fe`](https://github.com/mastra-ai/mastra/commit/d52b6fe1c56853eb38864baae0bbfa75cc739ccb), [`408be73`](https://github.com/mastra-ai/mastra/commit/408be73449dfab92b51eab8c6623b6c443debc25), [`359439b`](https://github.com/mastra-ai/mastra/commit/359439bb8c635e048176306828195f8297f50021), [`71a820b`](https://github.com/mastra-ai/mastra/commit/71a820b2353fa1406772c50760a3732058a8b337), [`1698f5e`](https://github.com/mastra-ai/mastra/commit/1698f5ec141d34f22a873efdb145ce3cdf848a5e)]:
+  - @mastra/core@1.36.0
+
 ## 1.2.1-alpha.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -305,7 +305,9 @@ var DEFAULT_BOT_SCOPES = [
   "users:read",
   // Reactions and files
   "reactions:write",
-  "files:read"
+  "files:read",
+  // Assistant mode (enables thread context for DMs and AI Assistant surface)
+  "assistant:write"
 ];
 var DEFAULT_BOT_EVENTS = [
   "app_mention",
@@ -338,6 +340,11 @@ function buildManifest(options) {
       bot_user: {
         display_name: name,
         always_online: true
+      },
+      // Required by Slack when `assistant:write` scope is present.
+      // Surfaces the app in the AI Assistant picker.
+      assistant_view: {
+        assistant_description: shortDescription
       }
     },
     oauth_config: {
@@ -14757,6 +14764,44 @@ var SlackProvider = class {
     const candidate = { handlers, inlineMedia, inlineLinks, state, threadContext, tools, chatOptions };
     return Object.fromEntries(Object.entries(candidate).filter(([, value]) => value !== void 0));
   }
+  /**
+   * Resolve the per-adapter config applied to the Slack entry in
+   * `AgentChannels.adapters`. Top-level fields on `SlackProviderConfig` win;
+   * the deprecated `adapterConfig` is merged in as a fallback for backwards
+   * compatibility. Undefined values are filtered so they don't clobber the
+   * fallback or preserved options.
+   */
+  #resolveSlackAdapterConfig() {
+    const {
+      adapterConfig,
+      cors,
+      gateway,
+      formatError: formatError2,
+      streaming: topLevelStreaming,
+      typingStatus,
+      toolDisplay: topLevelToolDisplay
+    } = this.#channelConfig;
+    const topLevel = {
+      cors,
+      gateway,
+      formatError: formatError2,
+      streaming: topLevelStreaming,
+      typingStatus,
+      toolDisplay: topLevelToolDisplay
+    };
+    const filteredTopLevel = Object.fromEntries(Object.entries(topLevel).filter(([, value]) => value !== void 0));
+    const filteredAdapterConfig = Object.fromEntries(
+      Object.entries(adapterConfig ?? {}).filter(([, value]) => value !== void 0)
+    );
+    const merged = { ...filteredAdapterConfig, ...filteredTopLevel };
+    const streaming = merged.streaming ?? true;
+    const toolDisplay = merged.toolDisplay ?? (streaming ? "grouped" : "cards");
+    return {
+      ...merged,
+      streaming,
+      toolDisplay
+    };
+  }
   /**
    * Create AgentChannels for an agent with the Slack adapter.
    * SlackProvider owns the AgentChannels lifecycle for platform-managed agents.
@@ -14768,8 +14813,8 @@ var SlackProvider = class {
    * previous instance are torn down before we replace it.
    */
   #createAgentChannels(agent, adapter) {
-    const { adapterConfig } = this.#channelConfig;
-    const slackEntry = adapterConfig ? { adapter, ...adapterConfig } : adapter;
+    const adapterConfig = this.#resolveSlackAdapterConfig();
+    const slackEntry = Object.keys(adapterConfig).length > 0 ? { adapter, ...adapterConfig } : adapter;
     const existing = agent.getChannels();
     const existingConfig = existing?.channelConfig;
     existing?.close();