@mastra/slack 1.2.1 → 1.3.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @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

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();