@mastra/mcp-docs-server 1.1.21-alpha.3 → 1.1.21-alpha.5

package/.docs/docs/agents/channels.md

@@ -0,0 +1,170 @@
+# Channels
+
+**Added in:** `@mastra/core@1.22.0`
+
+Channels connect your agents to messaging platforms like Slack, Discord, and Telegram. When a user sends a message on a platform, the agent receives it, processes it through the normal agent pipeline, and streams the response back to the conversation.
+
+## When to use channels
+
+Use channels when you want your agent to:
+
+- Respond to messages in Slack workspaces, Discord servers, or Telegram chats
+- Handle both direct messages and mentions in group conversations
+
+## Quickstart
+
+Configure channels directly on your agent using adapters from the [Chat SDK](https://chat-sdk.dev/adapters):
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { createSlackAdapter } from '@chat-adapter/slack'
+
+export const supportAgent = new Agent({
+  id: 'support-agent',
+  name: 'Support Agent',
+  instructions: 'You are a helpful support assistant.',
+  model: 'openai/gpt-5.4',
+  channels: {
+    adapters: {
+      slack: createSlackAdapter(),
+    },
+  },
+})
+```
+
+Register the agent in your Mastra instance with storage so channel state persists across restarts:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { LibSQLStore } from '@mastra/libsql'
+import { supportAgent } from './agents/support-agent'
+
+export const mastra = new Mastra({
+  agents: { supportAgent },
+  storage: new LibSQLStore({
+    url: process.env.DATABASE_URL,
+  }),
+})
+```
+
+Each adapter reads credentials from environment variables by default.
+
+## Platform setup
+
+Each platform requires credentials and event configuration. See the Chat SDK adapter docs for full setup: [Slack](https://chat-sdk.dev/adapters/slack), [Discord](https://chat-sdk.dev/adapters/discord), [Telegram](https://chat-sdk.dev/adapters/telegram).
+
+Mastra generates a webhook route for each platform at:
+
+```text
+/api/agents/{agentId}/channels/{platform}/webhook
+```
+
+For example: `/api/agents/support-agent/channels/slack/webhook`
+
+Point your platform's webhook or interactions URL to this path.
+
+### Local development
+
+Platform webhooks need a public URL to reach your local server. Use a tunnel to expose `localhost:4111`:
+
+```bash
+# ngrok
+ngrok http 4111
+
+# cloudflared
+cloudflared tunnel --url http://localhost:4111
+```
+
+Copy the generated URL and use it as the base for your webhook paths (e.g. `https://abc123.ngrok.io/api/agents/support-agent/channels/slack/webhook`).
+
+## Thread context
+
+When a user mentions the agent mid-conversation in a channel thread, the agent may not have prior context. By default, Mastra fetches the last 10 messages from the platform on the first mention.
+
+1. On the **first mention** in a thread, the agent fetches recent messages from the platform.
+2. These messages are prepended to the user's message as conversation context.
+3. After responding, the agent subscribes to the thread and has full history via Mastra's memory.
+4. Subsequent messages in that thread do **not** re-fetch from the platform.
+
+Set `threadContext: { maxMessages: 0 }` to disable this behavior. This only applies to non-DM threads.
+
+## Tool approval
+
+Tools with `requireApproval: true` render as interactive cards with Approve and Deny buttons:
+
+```typescript
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+
+const deleteFile = createTool({
+  id: 'delete-file',
+  description: 'Delete a file from the system',
+  inputSchema: z.object({
+    path: z.string().describe('Path to the file to delete'),
+  }),
+  requireApproval: true,
+  execute: async ({ path }) => {
+    await fs.unlink(path)
+    return { deleted: path }
+  },
+})
+```
+
+When the agent calls this tool, users see a card with the tool name, arguments, and Approve/Deny buttons. The tool only executes after approval.
+
+Set `cards: false` on an adapter to render tool calls as plain text instead of interactive cards. When cards are disabled and a tool requires approval, the agent uses `autoResumeSuspendedTools` to let the LLM decide based on the conversation context.
+
+## Multi-user awareness
+
+In group conversations, Mastra automatically prefixes each message with the sender's name and platform ID so the agent can distinguish between speakers:
+
+```text
+[Alice (@U123ABC)]: Can you help me with this?
+[Bob (@U456DEF)]: I have a question too.
+```
+
+## Multimodal content
+
+Models like Gemini can natively process images, video, and audio. Combine `inlineMedia` and `inlineLinks` to let users share rich content with your agent across platforms:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { createDiscordAdapter } from '@chat-adapter/discord'
+import { google } from '@ai-sdk/google'
+
+export const visionAgent = new Agent({
+  name: 'Vision Agent',
+  instructions: 'You can see images, watch videos, and listen to audio.',
+  model: google('gemini-3.1-flash-image-preview'),
+  channels: {
+    adapters: {
+      discord: createDiscordAdapter(),
+    },
+    inlineMedia: ['image/*', 'video/*', 'audio/*'],
+    inlineLinks: [
+      // Gemini treats YouTube URLs as native video file parts
+      { match: 'youtube.com', mimeType: 'video/*' },
+      { match: 'youtu.be', mimeType: 'video/*' },
+      'imgur.com', // HEAD-check imgur links; inline as file part if mimeType matches inlineMedia
+    ],
+  },
+})
+```
+
+With this configuration:
+
+- A user uploads a screenshot and the agent describes what it sees
+- A user uploads an `.mp4` clip and the agent summarizes the video
+- A user pastes a YouTube link and the agent watches and discusses the video
+- A user pastes an imgur link and the agent sees the image directly
+
+By default, only images are sent inline (`inlineMedia: ['image/*']`). Unsupported types are described as text summaries so the agent knows about the file without crashing models that reject them.
+
+> **Note:** See [Channels reference](https://mastra.ai/reference/agents/channels) for all `inlineMedia` patterns and [inlineLinks reference](https://mastra.ai/reference/agents/channels) for domain matching, HEAD detection, and forced mime types.
+
+## Related
+
+- [Agent overview](https://mastra.ai/docs/agents/overview)
+- [Tool approval](https://mastra.ai/docs/agents/agent-approval)
+- [Channels reference](https://mastra.ai/reference/agents/channels)
+- [Chat SDK adapters](https://chat-sdk.dev/adapters)

package/.docs/docs/agents/overview.md

@@ -87,6 +87,7 @@ Once your agent is running, use this table to find the right page for what you w
 | Keep your agent safe                                           | [Guardrails](https://mastra.ai/docs/agents/guardrails)                 |
 | Swap instructions or models based on request context           | [Dynamic configuration](https://mastra.ai/docs/server/request-context) |
 | Add speech-to-text or text-to-speech                           | [Voice](https://mastra.ai/docs/agents/adding-voice)                    |
+| Connect to Slack, Discord, or Telegram                         | [Channels](https://mastra.ai/docs/agents/channels)                     |
 
 ## Multi-agent systems
 

package/.docs/models/gateways/openrouter.md

@@ -1,6 +1,6 @@
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 167 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 168 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -173,6 +173,7 @@ ANTHROPIC_API_KEY=ant-...
 | `qwen/qwen3.5-397b-a17b`                                        |
 | `qwen/qwen3.5-plus-02-15`                                       |
 | `qwen/qwen3.6-plus-preview:free`                                |
+| `qwen/qwen3.6-plus:free`                                        |
 | `sourceful/riverflow-v2-fast-preview`                           |
 | `sourceful/riverflow-v2-max-preview`                            |
 | `sourceful/riverflow-v2-standard-preview`                       |

package/.docs/models/index.md

@@ -1,6 +1,6 @@
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3578 models from 95 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3580 models from 95 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/anthropic.md

@@ -1,6 +1,6 @@
 # ![Anthropic logo](https://models.dev/logos/anthropic.svg)Anthropic
 
-Access 23 Anthropic models through Mastra's model router. Authentication is handled automatically using the `ANTHROPIC_API_KEY` environment variable.
+Access 22 Anthropic models through Mastra's model router. Authentication is handled automatically using the `ANTHROPIC_API_KEY` environment variable.
 
 Learn more in the [Anthropic documentation](https://docs.anthropic.com/en/docs/about-claude/models).
 
@@ -37,7 +37,6 @@ for await (const chunk of stream) {
 | `anthropic/claude-3-5-sonnet-20240620` | 200K    |       |           |       |       |       | $3         | $15         |
 | `anthropic/claude-3-5-sonnet-20241022` | 200K    |       |           |       |       |       | $3         | $15         |
 | `anthropic/claude-3-7-sonnet-20250219` | 200K    |       |           |       |       |       | $3         | $15         |
-| `anthropic/claude-3-7-sonnet-latest`   | 200K    |       |           |       |       |       | $3         | $15         |
 | `anthropic/claude-3-haiku-20240307`    | 200K    |       |           |       |       |       | $0.25      | $1          |
 | `anthropic/claude-3-opus-20240229`     | 200K    |       |           |       |       |       | $15        | $75         |
 | `anthropic/claude-3-sonnet-20240229`   | 200K    |       |           |       |       |       | $3         | $15         |

package/.docs/models/providers/opencode-go.md

@@ -1,6 +1,6 @@
 # ![OpenCode Go logo](https://models.dev/logos/opencode-go.svg)OpenCode Go
 
-Access 4 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 6 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
 
 Learn more in the [OpenCode Go documentation](https://opencode.ai/docs/zen).
 
@@ -36,6 +36,8 @@ for await (const chunk of stream) {
 | -------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `opencode-go/glm-5`        | 205K    |       |           |       |       |       | $1         | $3          |
 | `opencode-go/kimi-k2.5`    | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `opencode-go/mimo-v2-omni` | 262K    |       |           |       |       |       | $0.40      | $2          |
+| `opencode-go/mimo-v2-pro`  | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `opencode-go/minimax-m2.5` | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `opencode-go/minimax-m2.7` | 205K    |       |           |       |       |       | $0.30      | $1          |
 

package/.docs/reference/agents/channels.md

@@ -0,0 +1,164 @@
+# Channels
+
+**Added in:** `@mastra/core@1.22.0`
+
+Channels connect agents to messaging platforms. Configure them via the `channels` property on the `Agent` constructor. See the [Channels guide](https://mastra.ai/docs/agents/channels) for concepts and platform setup instructions.
+
+## Usage example
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { createSlackAdapter } from '@chat-adapter/slack'
+import { createDiscordAdapter } from '@chat-adapter/discord'
+
+export const supportAgent = new Agent({
+  id: 'support-agent',
+  name: 'Support Agent',
+  instructions: 'You are a helpful support assistant.',
+  model: 'openai/gpt-5.4',
+  channels: {
+    adapters: {
+      slack: createSlackAdapter(),
+      discord: createDiscordAdapter(),
+    },
+  },
+})
+```
+
+## Parameters
+
+**adapters** (`Record<string, Adapter | ChannelAdapterConfig>`): Platform adapters keyed by name (e.g. \`slack\`, \`discord\`). Pass an \`Adapter\` directly for defaults, or a \`ChannelAdapterConfig\` object to customize per-adapter options.
+
+**handlers** (`ChannelHandlers`): Override default message handlers for DMs, mentions, and subscribed threads.
+
+**inlineMedia** (`string[] | ((mimeType: string) => boolean)`): Controls which attachment types are sent as file parts to the model. Types that do not match are described as text summaries. Accepts an array of mime type globs or a predicate function. (Default: `['image/*']`)
+
+**inlineLinks** (`InlineLinkEntry[]`): Promote URLs found in message text to file parts so the model can process linked content. Each entry matches a domain. Disabled by default.
+
+**tools** (`boolean`): Include channel-specific tools (\`add\_reaction\`, \`remove\_reaction\`). Set to \`false\` for models that do not support function calling. (Default: `true`)
+
+**state** (`StateAdapter`): State adapter for subscriptions and deduplication. Defaults to \`MastraStateAdapter\` backed by the Mastra instance storage. Channels require storage to be configured. (Default: `MastraStateAdapter (from Mastra storage)`)
+
+**userName** (`string`): Bot display name shown in platform messages. Defaults to the agent's \`name\`, or \`'Mastra'\` if no name is set. (Default: `` agent's `name` ``)
+
+**threadContext** (`{ maxMessages?: number }`): Fetch recent messages from the platform when the agent is first mentioned in a thread. Set \`maxMessages: 0\` to disable. Only applies to non-DM threads. (Default: `{ maxMessages: 10 }`)
+
+**chatOptions** (`Omit<ChatConfig, 'adapters' | 'state' | 'userName'>`): Additional options passed directly to the \[Chat SDK]\(https\://chat-sdk.dev/docs/usage). Use for advanced configuration such as \`dedupeTtlMs\`, \`fallbackStreamingPlaceholderText\`, \`lockScope\`, and \`messageHistory\`.
+
+## Per-adapter options
+
+Wrap an adapter in a `ChannelAdapterConfig` object to set per-adapter options:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { createDiscordAdapter } from '@chat-adapter/discord'
+import { createSlackAdapter } from '@chat-adapter/slack'
+
+const agent = new Agent({
+  name: 'Example',
+  instructions: '...',
+  model: 'openai/gpt-5.4',
+  channels: {
+    adapters: {
+      discord: {
+        adapter: createDiscordAdapter(),
+        cards: false,
+        gateway: false,
+      },
+      slack: createSlackAdapter(), // Plain adapter uses defaults
+    },
+  },
+})
+```
+
+**adapter** (`Adapter`): The Chat SDK adapter instance for this platform.
+
+**gateway** (`boolean`): Start a persistent Gateway WebSocket listener for receiving DMs, @mentions, and reactions. Set to \`false\` for serverless deployments that only need webhook-based interactions. (Default: `true`)
+
+**cards** (`boolean`): Render tool calls as interactive rich cards with buttons. Set to \`false\` to use plain text formatting instead. When disabled and a tool requires approval, the agent uses \`autoResumeSuspendedTools\` to let the LLM decide based on conversation context. (Default: `true`)
+
+**formatToolCall** (`(info: { toolName, args, result, isError? }) => PostableMessage | null`): Override how tool calls are rendered in the chat. Called once per tool invocation after the result is available. Return \`null\` to suppress the message entirely.
+
+**formatError** (`(error: Error) => PostableMessage`): Override how errors are rendered in the chat. Return a user-friendly message instead of exposing the raw error. (Default: `"❌ Error: <error.message>"`)
+
+## Handlers
+
+Override built-in event handlers. Each handler can be:
+
+- **Omitted**: uses the default Mastra handler (routes to `agent.stream` and posts the response)
+- **`false`**: disables the handler entirely
+- **A function** `(thread, message, defaultHandler) => Promise<void>`: wraps or replaces the default
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { createSlackAdapter } from '@chat-adapter/slack'
+
+const agent = new Agent({
+  name: 'Custom Handler Agent',
+  instructions: '...',
+  model: 'openai/gpt-5.4',
+  channels: {
+    adapters: {
+      slack: createSlackAdapter(),
+    },
+    handlers: {
+      onMention: async (thread, message, defaultHandler) => {
+        console.log('Received mention:', message.text)
+        await defaultHandler(thread, message)
+      },
+      onDirectMessage: false,
+    },
+  },
+})
+```
+
+**onDirectMessage** (`ChannelHandler | false`): Called when the bot receives a direct message.
+
+**onMention** (`ChannelHandler | false`): Called when the bot is @mentioned in a channel or thread.
+
+**onSubscribedMessage** (`ChannelHandler | false`): Called for messages in threads the agent has subscribed to.
+
+The `ChannelHandler` function signature:
+
+```typescript
+type ChannelHandler = (
+  thread: Thread,
+  message: Message,
+  defaultHandler: (thread: Thread, message: Message) => Promise<void>,
+) => Promise<void>
+```
+
+## Inline media
+
+Controls which attachment types (images, video, PDFs, etc.) are sent as file parts to the model. Types that do not match are described as text summaries so the agent knows about the file without crashing models that reject unsupported types.
+
+Supported glob patterns:
+
+| Pattern           | Matches                                           |
+| ----------------- | ------------------------------------------------- |
+| `image/*`         | All image types (`image/png`, `image/jpeg`, etc.) |
+| `video/*`         | All video types                                   |
+| `*` or `*/*`      | All types                                         |
+| `application/pdf` | Exact type match                                  |
+
+For platforms with private CDNs (e.g. Slack), attachments are fetched with authenticated credentials from the Chat SDK. For platforms with public CDNs (e.g. Discord), the URL is passed directly to the model.
+
+## Inline links
+
+Promotes URLs found in message text to file parts so the model can process linked content instead of seeing raw URL text. Each entry can be a string (domain pattern) or an object with a forced mime type.
+
+**String entries** match a domain and perform a HEAD request to detect the Content-Type. The resolved type is checked against `inlineMedia` and only matching types become file parts.
+
+**Object entries** match a domain and force a specific mime type, skipping the HEAD request and bypassing the `inlineMedia` check. This is useful for sites like YouTube where a HEAD request returns `text/html`, but the model treats the URL as video content.
+
+```typescript
+type InlineLinkEntry =
+  | string // Domain pattern (HEAD determines mime type)
+  | { match: string; mimeType: string } // Domain + forced mime type (skips HEAD)
+```
+
+## Related
+
+- [Channels guide](https://mastra.ai/docs/agents/channels) — concepts, quickstart, and platform setup
+- [Agent class](https://mastra.ai/reference/agents/agent) — constructor parameters and methods
+- [Chat SDK adapters](https://chat-sdk.dev/adapters) — adapter configuration and platform setup

package/.docs/reference/index.md

@@ -3,6 +3,7 @@
 The Reference section provides documentation of Mastra's API, including parameters, types and usage examples.
 
 - [Agent Class](https://mastra.ai/reference/agents/agent)
+- [Channels](https://mastra.ai/reference/agents/channels)
 - [.generate()](https://mastra.ai/reference/agents/generate)
 - [.generateLegacy()](https://mastra.ai/reference/agents/generateLegacy)
 - [.getDefaultGenerateOptionsLegacy()](https://mastra.ai/reference/agents/getDefaultGenerateOptions)

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 1.1.21-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`cb15509`](https://github.com/mastra-ai/mastra/commit/cb15509b58f6a83e11b765c945082afc027db972), [`80c5668`](https://github.com/mastra-ai/mastra/commit/80c5668e365470d3a96d3e953868fd7a643ff67c), [`3d478c1`](https://github.com/mastra-ai/mastra/commit/3d478c1e13f17b80f330ac49d7aa42ef929b93ff), [`6039f17`](https://github.com/mastra-ai/mastra/commit/6039f176f9c457304825ff1df8c83b8e457376c0), [`06b928d`](https://github.com/mastra-ai/mastra/commit/06b928dfc2f5630d023467476cc5919dfa858d0a), [`6a8d984`](https://github.com/mastra-ai/mastra/commit/6a8d9841f2933456ee1598099f488d742b600054)]:
+  - @mastra/core@1.22.0-alpha.2
+
 ## 1.1.21-alpha.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.21-alpha.3",
+  "version": "1.1.21-alpha.5",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "1.22.0-alpha.1",
+    "@mastra/core": "1.22.0-alpha.2",
     "@mastra/mcp": "^1.4.1"
   },
   "devDependencies": {
@@ -46,9 +46,9 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
-    "@internal/types-builder": "0.0.53",
-    "@mastra/core": "1.22.0-alpha.1",
-    "@internal/lint": "0.0.78"
+    "@internal/lint": "0.0.78",
+    "@mastra/core": "1.22.0-alpha.2",
+    "@internal/types-builder": "0.0.53"
   },
   "homepage": "https://mastra.ai",
   "repository": {