@mastra/slack 1.1.1 → 1.2.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { Mastra } from '@mastra/core/mastra';
-import { ChannelProvider, ChannelConnectResult, ChannelInstallationInfo, ChannelPlatformInfo } from '@mastra/core/channels';
+import { ChannelAdapterConfig, ChannelConfig, ChannelHandlers, ChannelProvider, ChannelConnectResult, ChannelInstallationInfo, ChannelPlatformInfo } from '@mastra/core/channels';
 import { ApiRoute } from '@mastra/core/server';
-import { SlackAdapter } from '@chat-adapter/slack';
+import { SlackAdapterConfig, SlackAdapter } from '@chat-adapter/slack';
 export { SlackAdapter, createSlackAdapter } from '@chat-adapter/slack';
 import { z } from 'zod';
 import { ChannelsStorage } from '@mastra/core/storage';
@@ -203,10 +203,50 @@ interface SlackConfigTokens {
     updatedAt: Date;
 }
 
+/**
+ * Per-adapter overrides forwarded to the SlackAdapter entry inside
+ * `AgentChannels.adapters` — equivalent to passing
+ * `{ adapter, ...adapterConfig }` when wiring up `AgentChannels` manually.
+ * The `adapter` instance itself is created by the provider.
+ */
+type SlackAdapterChannelConfig = Omit<ChannelAdapterConfig, 'adapter'>;
+/** AgentChannels fields that the provider forwards. `adapters` and `userName` are provider-managed. */
+type ForwardedAgentChannelsOptions = Pick<ChannelConfig, 'inlineMedia' | 'inlineLinks' | 'state' | 'threadContext' | 'tools' | 'chatOptions'>;
 /**
  * Configuration for SlackProvider at the Mastra level.
+ *
+ * In addition to the provider-specific fields documented below, this accepts
+ * options that are forwarded to the underlying `AgentChannels` instances
+ * managed by the provider — for example `handlers`, `inlineMedia`, and
+ * `adapterConfig`.
  */
-interface SlackProviderConfig {
+interface SlackProviderConfig extends ForwardedAgentChannelsOptions {
+    /**
+     * Logger forwarded to the underlying `SlackAdapter` for internal error
+     * reporting. Defaults to the adapter's `ConsoleLogger`.
+     */
+    logger?: SlackAdapterConfig['logger'];
+    /**
+     * Override built-in event handlers (e.g. `onDirectMessage`, `onMention`).
+     * Forwarded to `AgentChannels` for every agent connected via this provider.
+     *
+     * @example
+     * ```ts
+     * handlers: {
+     *   onDirectMessage: async (thread, message, defaultHandler) => {
+     *     console.log('DM:', message.text);
+     *     await defaultHandler(thread, message);
+     *   },
+     * }
+     * ```
+     */
+    handlers?: ChannelHandlers;
+    /**
+     * Per-adapter overrides applied to the Slack adapter entry inside
+     * `AgentChannels.adapters` — for example `cards`, `formatToolCall`,
+     * `formatError`.
+     */
+    adapterConfig?: SlackAdapterChannelConfig;
     /**
      * Slack App Configuration access token for programmatic app creation.
      * Generate at: https://api.slack.com/apps > "Your App Configuration Tokens"
@@ -675,4 +715,4 @@ interface BuildManifestOptions {
  */
 declare function buildManifest(options: BuildManifestOptions): SlackAppManifest;
 
-export { DEFAULT_BOT_EVENTS, DEFAULT_BOT_SCOPES, type SlackAppManifest, type SlackBlock, type SlackConfigData, SlackConfigDataSchema, type SlackConfigTokens, type SlackConnectOptions, type SlackInstallation, type SlackInstallationData, SlackInstallationDataSchema, SlackManifestClient, type SlackMessage, type SlackPendingData, SlackPendingDataSchema, type SlackPendingInstallation, SlackProvider, type SlackProviderConfig, type SlashCommandConfig, buildManifest, parseSlackFormBody, verifySlackRequest };
+export { DEFAULT_BOT_EVENTS, DEFAULT_BOT_SCOPES, type SlackAdapterChannelConfig, type SlackAppManifest, type SlackBlock, type SlackConfigData, SlackConfigDataSchema, type SlackConfigTokens, type SlackConnectOptions, type SlackInstallation, type SlackInstallationData, SlackInstallationDataSchema, SlackManifestClient, type SlackMessage, type SlackPendingData, SlackPendingDataSchema, type SlackPendingInstallation, SlackProvider, type SlackProviderConfig, type SlashCommandConfig, buildManifest, parseSlackFormBody, verifySlackRequest };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Mastra } from '@mastra/core/mastra';
-import { ChannelProvider, ChannelConnectResult, ChannelInstallationInfo, ChannelPlatformInfo } from '@mastra/core/channels';
+import { ChannelAdapterConfig, ChannelConfig, ChannelHandlers, ChannelProvider, ChannelConnectResult, ChannelInstallationInfo, ChannelPlatformInfo } from '@mastra/core/channels';
 import { ApiRoute } from '@mastra/core/server';
-import { SlackAdapter } from '@chat-adapter/slack';
+import { SlackAdapterConfig, SlackAdapter } from '@chat-adapter/slack';
 export { SlackAdapter, createSlackAdapter } from '@chat-adapter/slack';
 import { z } from 'zod';
 import { ChannelsStorage } from '@mastra/core/storage';
@@ -203,10 +203,50 @@ interface SlackConfigTokens {
     updatedAt: Date;
 }
 
+/**
+ * Per-adapter overrides forwarded to the SlackAdapter entry inside
+ * `AgentChannels.adapters` — equivalent to passing
+ * `{ adapter, ...adapterConfig }` when wiring up `AgentChannels` manually.
+ * The `adapter` instance itself is created by the provider.
+ */
+type SlackAdapterChannelConfig = Omit<ChannelAdapterConfig, 'adapter'>;
+/** AgentChannels fields that the provider forwards. `adapters` and `userName` are provider-managed. */
+type ForwardedAgentChannelsOptions = Pick<ChannelConfig, 'inlineMedia' | 'inlineLinks' | 'state' | 'threadContext' | 'tools' | 'chatOptions'>;
 /**
  * Configuration for SlackProvider at the Mastra level.
+ *
+ * In addition to the provider-specific fields documented below, this accepts
+ * options that are forwarded to the underlying `AgentChannels` instances
+ * managed by the provider — for example `handlers`, `inlineMedia`, and
+ * `adapterConfig`.
  */
-interface SlackProviderConfig {
+interface SlackProviderConfig extends ForwardedAgentChannelsOptions {
+    /**
+     * Logger forwarded to the underlying `SlackAdapter` for internal error
+     * reporting. Defaults to the adapter's `ConsoleLogger`.
+     */
+    logger?: SlackAdapterConfig['logger'];
+    /**
+     * Override built-in event handlers (e.g. `onDirectMessage`, `onMention`).
+     * Forwarded to `AgentChannels` for every agent connected via this provider.
+     *
+     * @example
+     * ```ts
+     * handlers: {
+     *   onDirectMessage: async (thread, message, defaultHandler) => {
+     *     console.log('DM:', message.text);
+     *     await defaultHandler(thread, message);
+     *   },
+     * }
+     * ```
+     */
+    handlers?: ChannelHandlers;
+    /**
+     * Per-adapter overrides applied to the Slack adapter entry inside
+     * `AgentChannels.adapters` — for example `cards`, `formatToolCall`,
+     * `formatError`.
+     */
+    adapterConfig?: SlackAdapterChannelConfig;
     /**
      * Slack App Configuration access token for programmatic app creation.
      * Generate at: https://api.slack.com/apps > "Your App Configuration Tokens"
@@ -675,4 +715,4 @@ interface BuildManifestOptions {
  */
 declare function buildManifest(options: BuildManifestOptions): SlackAppManifest;
 
-export { DEFAULT_BOT_EVENTS, DEFAULT_BOT_SCOPES, type SlackAppManifest, type SlackBlock, type SlackConfigData, SlackConfigDataSchema, type SlackConfigTokens, type SlackConnectOptions, type SlackInstallation, type SlackInstallationData, SlackInstallationDataSchema, SlackManifestClient, type SlackMessage, type SlackPendingData, SlackPendingDataSchema, type SlackPendingInstallation, SlackProvider, type SlackProviderConfig, type SlashCommandConfig, buildManifest, parseSlackFormBody, verifySlackRequest };
+export { DEFAULT_BOT_EVENTS, DEFAULT_BOT_SCOPES, type SlackAdapterChannelConfig, type SlackAppManifest, type SlackBlock, type SlackConfigData, SlackConfigDataSchema, type SlackConfigTokens, type SlackConnectOptions, type SlackInstallation, type SlackInstallationData, SlackInstallationDataSchema, SlackManifestClient, type SlackMessage, type SlackPendingData, SlackPendingDataSchema, type SlackPendingInstallation, SlackProvider, type SlackProviderConfig, type SlashCommandConfig, buildManifest, parseSlackFormBody, verifySlackRequest };

package/dist/index.js

@@ -4908,6 +4908,7 @@ var SlackProvider = class {
     const agent = this.#mastra?.getAgentById(installation.agentId);
     const displayName = installation.name || agent?.name || installation.agentId;
     const adapter = createSlackAdapter({
+      ...this.#forwardedAdapterOptions(),
       botToken: installation.botToken,
       botUserId: installation.botUserId,
       signingSecret: installation.signingSecret,
@@ -4971,13 +4972,33 @@ var SlackProvider = class {
       }
     }
   }
+  /**
+   * Extract the SlackAdapter fields the provider forwards to every
+   * `createSlackAdapter()` call. Installation-managed credentials/identity are
+   * applied separately.
+   */
+  #forwardedAdapterOptions() {
+    const { logger } = this.#channelConfig;
+    return { logger };
+  }
+  /**
+   * Extract the AgentChannels fields the provider forwards. `adapters` and
+   * `userName` are applied separately by `#createAgentChannels`.
+   */
+  #forwardedChannelOptions() {
+    const { handlers, inlineMedia, inlineLinks, state, threadContext, tools, chatOptions } = this.#channelConfig;
+    return { handlers, inlineMedia, inlineLinks, state, threadContext, tools, chatOptions };
+  }
   /**
    * Create AgentChannels for an agent with the Slack adapter.
    * SlackProvider owns the AgentChannels lifecycle for platform-managed agents.
    */
   #createAgentChannels(agent, adapter) {
+    const { adapterConfig } = this.#channelConfig;
+    const slackEntry = adapterConfig ? { adapter, ...adapterConfig } : adapter;
     const agentChannels = new AgentChannels({
-      adapters: { slack: adapter },
+      ...this.#forwardedChannelOptions(),
+      adapters: { slack: slackEntry },
       userName: agent.name
     });
     agent.setChannels(agentChannels);
@@ -5365,6 +5386,7 @@ var SlackProvider = class {
       const agent = this.#mastra?.getAgentById(pending.agentId);
       const displayName = installation.name || agent?.name || pending.agentId;
       const adapter = createSlackAdapter({
+        ...this.#forwardedAdapterOptions(),
         botToken: installation.botToken,
         botUserId: installation.botUserId,
         signingSecret: installation.signingSecret,
@@ -5441,6 +5463,7 @@ var SlackProvider = class {
     }
     const displayName = installation.name || agent.name || installation.agentId;
     const currentAdapter = this.#adapters.get(installation.id) ?? createSlackAdapter({
+      ...this.#forwardedAdapterOptions(),
       botToken: installation.botToken,
       botUserId: installation.botUserId,
       signingSecret: installation.signingSecret,