@mastra/mcp-docs-server 1.2.11-alpha.5 → 1.2.11

package/.docs/models/gateways/vercel.md

@@ -2,7 +2,7 @@
 
 # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
 
-Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 307 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 306 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -134,7 +134,6 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-2.5-pro`                  |
 | `google/gemini-3-flash`                  |
 | `google/gemini-3-pro-image`              |
-| `google/gemini-3-pro-preview`            |
 | `google/gemini-3.1-flash-image`          |
 | `google/gemini-3.1-flash-image-preview`  |
 | `google/gemini-3.1-flash-lite`           |

package/.docs/models/index.md

@@ -2,7 +2,7 @@
 
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 5107 models from 162 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 5115 models from 162 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/aiand.md

@@ -2,7 +2,7 @@
 
 # ![ai&](https://models.dev/logos/aiand.svg)ai&
 
-Access 10 ai& models through Mastra's model router. Authentication is handled automatically using the `AIAND_API_KEY` environment variable.
+Access 8 ai& models through Mastra's model router. Authentication is handled automatically using the `AIAND_API_KEY` environment variable.
 
 Learn more in the [ai& documentation](https://docs.aiand.com/).
 
@@ -39,12 +39,10 @@ for await (const chunk of stream) {
 | `aiand/deepseek-ai/deepseek-v4-flash` | 1.0M    |       |           |       |       |       | $0.15      | $0.25       |
 | `aiand/deepseek-ai/deepseek-v4-pro`   | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `aiand/google/gemma-4-31b-it`         | 262K    |       |           |       |       |       | $0.20      | $0.50       |
-| `aiand/moonshotai/kimi-k2.6`          | 262K    |       |           |       |       |       | $0.85      | $4          |
 | `aiand/moonshotai/kimi-k2.7-code`     | 262K    |       |           |       |       |       | $0.75      | $4          |
 | `aiand/moonshotai/kimi-k3`            | 1.0M    |       |           |       |       |       | $3         | $13         |
 | `aiand/openai/gpt-oss-120b`           | 131K    |       |           |       |       |       | $0.15      | $0.60       |
 | `aiand/qwen/qwen3.6-27b`              | 262K    |       |           |       |       |       | —          | —           |
-| `aiand/zai-org/glm-5.1`               | 200K    |       |           |       |       |       | $1         | $4          |
 | `aiand/zai-org/glm-5.2`               | 1.0M    |       |           |       |       |       | $1         | $4          |
 
 ## Advanced configuration

package/.docs/models/providers/berget.md

@@ -2,7 +2,7 @@
 
 # ![Berget.AI logo](https://models.dev/logos/berget.svg)Berget.AI
 
-Access 8 Berget.AI models through Mastra's model router. Authentication is handled automatically using the `BERGET_API_KEY` environment variable.
+Access 9 Berget.AI models through Mastra's model router. Authentication is handled automatically using the `BERGET_API_KEY` environment variable.
 
 Learn more in the [Berget.AI documentation](https://api.berget.ai).
 
@@ -41,6 +41,7 @@ for await (const chunk of stream) {
 | `berget/mistralai/Mistral-Medium-3.5-128B`             | 262K    |       |           |       |       |       | $2         | $6          |
 | `berget/mistralai/Mistral-Small-3.2-24B-Instruct-2506` | 32K     |       |           |       |       |       | $0.33      | $0.33       |
 | `berget/moonshotai/Kimi-K2.6`                          | 262K    |       |           |       |       |       | $0.83      | $4          |
+| `berget/moonshotai/Kimi-K3`                            | 328K    |       |           |       |       |       | $3         | $15         |
 | `berget/openai/gpt-oss-120b`                           | 128K    |       |           |       |       |       | $0.22      | $0.83       |
 | `berget/zai-org/GLM-4.7`                               | 128K    |       |           |       |       |       | $0.77      | $3          |
 | `berget/zai-org/GLM-5.2`                               | 524K    |       |           |       |       |       | $2         | $5          |

package/.docs/models/providers/hyper.md

@@ -38,18 +38,18 @@ for await (const chunk of stream) {
 | ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `hyper/deepseek-v4-flash`                            | 1.0M    |       |           |       |       |       | $0.20      | $0.40       |
 | `hyper/deepseek-v4-pro`                              | 1.0M    |       |           |       |       |       | $2         | $5          |
-| `hyper/gemma-4-26b-a4b-it`                           | 256K    |       |           |       |       |       | $0.11      | $0.40       |
-| `hyper/glm-5`                                        | 203K    |       |           |       |       |       | $0.91      | $3          |
+| `hyper/gemma-4-26b-a4b-it`                           | 256K    |       |           |       |       |       | $0.13      | $0.42       |
+| `hyper/glm-5`                                        | 203K    |       |           |       |       |       | $0.81      | $3          |
 | `hyper/glm-5.1`                                      | 203K    |       |           |       |       |       | $2         | $5          |
 | `hyper/glm-5.2`                                      | 1.0M    |       |           |       |       |       | $1         | $4          |
-| `hyper/gpt-oss-120b`                                 | 131K    |       |           |       |       |       | $0.18      | $0.68       |
+| `hyper/gpt-oss-120b`                                 | 131K    |       |           |       |       |       | $0.18      | $0.65       |
 | `hyper/kimi-k2.5`                                    | 262K    |       |           |       |       |       | $0.53      | $3          |
 | `hyper/kimi-k2.6`                                    | 262K    |       |           |       |       |       | $0.95      | $4          |
-| `hyper/kimi-k2.7-code`                               | 262K    |       |           |       |       |       | $0.95      | $4          |
+| `hyper/kimi-k2.7-code`                               | 256K    |       |           |       |       |       | $0.95      | $4          |
 | `hyper/llama-3.3-70b-instruct`                       | 128K    |       |           |       |       |       | $0.61      | $1          |
-| `hyper/llama-4-maverick-17b-128e-instruct-fp8`       | 430K    |       |           |       |       |       | $0.27      | $0.92       |
-| `hyper/minimax-m2.7`                                 | 205K    |       |           |       |       |       | $0.42      | $2          |
-| `hyper/qwen3-coder-480b-a35b-instruct-int4-mixed-ar` | 106K    |       |           |       |       |       | $0.60      | $2          |
+| `hyper/llama-4-maverick-17b-128e-instruct-fp8`       | 430K    |       |           |       |       |       | $0.28      | $0.93       |
+| `hyper/minimax-m2.7`                                 | 205K    |       |           |       |       |       | $0.35      | $1          |
+| `hyper/qwen3-coder-480b-a35b-instruct-int4-mixed-ar` | 106K    |       |           |       |       |       | $0.57      | $2          |
 | `hyper/qwen3-next-80b-a3b-instruct`                  | 262K    |       |           |       |       |       | $0.12      | $1          |
 | `hyper/qwen3.6-flash`                                | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `hyper/qwen3.6-max`                                  | 256K    |       |           |       |       |       | $2         | $12         |

package/.docs/models/providers/xpersona.md

@@ -2,7 +2,7 @@
 
 # ![Xpersona logo](https://models.dev/logos/xpersona.svg)Xpersona
 
-Access 3 Xpersona models through Mastra's model router. Authentication is handled automatically using the `XPERSONA_API_KEY` environment variable.
+Access 13 Xpersona models through Mastra's model router. Authentication is handled automatically using the `XPERSONA_API_KEY` environment variable.
 
 Learn more in the [Xpersona documentation](https://www.xpersona.co/docs).
 
@@ -36,7 +36,17 @@ for await (const chunk of stream) {
 
 | Model                             | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | --------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `xpersona/claude-fable-5`         | 1.0M    |       |           |       |       |       | $3         | $18         |
+| `xpersona/claude-fable-5`         | 1.0M    |       |           |       |       |       | $3         | $19         |
+| `xpersona/claude-haiku-4-5`       | 200K    |       |           |       |       |       | $0.60      | $4          |
+| `xpersona/claude-opus-4-8`        | 200K    |       |           |       |       |       | $2         | $9          |
+| `xpersona/claude-sonnet-4-6`      | 200K    |       |           |       |       |       | $0.90      | $6          |
+| `xpersona/gemini-3.5-flash`       | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `xpersona/gpt-5.4`                | 1.1M    |       |           |       |       |       | $0.75      | $6          |
+| `xpersona/gpt-5.4-mini`           | 272K    |       |           |       |       |       | $0.38      | $4          |
+| `xpersona/gpt-5.5`                | 1.1M    |       |           |       |       |       | $2         | $12         |
+| `xpersona/gpt-5.6`                | 372K    |       |           |       |       |       | $2         | $12         |
+| `xpersona/gpt-5.6-sol`            | 372K    |       |           |       |       |       | $2         | $12         |
+| `xpersona/gpt-5.6-terra`          | 372K    |       |           |       |       |       | $2         | $2          |
 | `xpersona/xpersona-frieren-coder` | 1.0M    |       |           |       |       |       | $2         | $6          |
 | `xpersona/xpersona-gpt-5.5`       | 1.0M    |       |           |       |       |       | $3         | $18         |
 

package/.docs/reference/evals/mastra-scorer.md

@@ -76,7 +76,8 @@ const result = await scorer.run({
 The optional `judge` record contains details about the judge model calls made by prompt-based scorer steps. Its known keys are `preprocess`, `analyze`, `generateScore`, and `generateReason`. Each key contains an ordered `executions` array.
 
 ```typescript
-interface ScorerJudgeExecution {
+interface ScorerJudgeExecutionSuccess {
+  status: 'success'
   prompt: string
   output: JSONValue
   judgeModelId: string
@@ -92,6 +93,8 @@ interface ScorerJudgeExecution {
   }
 }
 
+type ScorerJudgeExecution = ScorerJudgeExecutionSuccess
+
 interface ScorerJudgeUsage {
   inputTokens?: number
   outputTokens?: number
@@ -114,11 +117,14 @@ Use the step key to access its judge execution details:
 ```typescript
 const execution = result.judge?.generateScore?.executions[0]
 
+console.log(execution?.status)
 console.log(execution?.judgeModelId)
 console.log(execution?.usage.totalTokens)
 console.log(execution?.durationMs)
 ```
 
+The `status` value describes the outcome of the logical prompt-step execution, not the quality of the evaluated response. A structured-output fallback that eventually succeeds creates one `success` execution with an `attemptCount` greater than one.
+
 `attemptCount` counts judge invocations, including a structured-output fallback. `modelCallCount` counts the completed model steps across those attempts. `durationMs` covers the full prompt-step execution.
 
 Function steps don't create `judge` entries. Usage in this record belongs to the scorer's judge model, not the agent or workflow being evaluated. The optional `cost` field is present only when the execution directly reports an authoritative cost, source, and unit.

package/.docs/reference/index.md

@@ -287,6 +287,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Retention (prune)](https://mastra.ai/reference/storage/retention)
 - [Upstash Storage](https://mastra.ai/reference/storage/upstash)
 - [ChunkType](https://mastra.ai/reference/streaming/ChunkType)
+- [smoothStream()](https://mastra.ai/reference/streaming/smoothStream)
 - [MastraModelOutput](https://mastra.ai/reference/streaming/agents/MastraModelOutput)
 - [.stream()](https://mastra.ai/reference/streaming/agents/stream)
 - [.streamLegacy()](https://mastra.ai/reference/streaming/agents/streamLegacy)

package/.docs/reference/streaming/smoothStream.md

@@ -0,0 +1,135 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# `smoothStream()`
+
+`smoothStream()` creates an experimental transform stream that buffers text and reasoning deltas before emitting them in consistent chunks. Use it to make streamed responses appear at a steadier pace when a model emits uneven deltas.
+
+Non-text chunks pass through unchanged. Any buffered content is emitted before a tool, control, or completion chunk.
+
+## Usage example
+
+Pipe an agent's `fullStream` through the transform:
+
+```typescript
+import { smoothStream } from '@mastra/core/stream'
+
+const result = await agent.stream('Explain how rainbows form')
+
+const stream = result.fullStream.pipeThrough(
+  smoothStream({
+    delayInMs: 20,
+    chunking: 'word',
+  }),
+)
+
+for await (const chunk of stream) {
+  if (chunk.type === 'text-delta') {
+    process.stdout.write(chunk.payload.text)
+  }
+}
+```
+
+The transform changes only the piped stream. Promise properties and callbacks on the original `MastraModelOutput`, such as `result.text` and `onChunk`, keep the model's original chunk timing.
+
+## AI SDK routes
+
+Import `smoothStream()` from `@mastra/ai-sdk` to smooth an agent before `handleChatStream()` converts its output to AI SDK UI chunks:
+
+```typescript
+import { handleChatStream, smoothStream } from '@mastra/ai-sdk'
+import { createUIMessageStreamResponse } from 'ai'
+import { mastra } from '@/src/mastra'
+
+export async function POST(req: Request) {
+  const params = await req.json()
+  const stream = await handleChatStream({
+    mastra,
+    agentId: 'weatherAgent',
+    params,
+    experimentalTransform: smoothStream({
+      delayInMs: 20,
+      chunking: 'word',
+    }),
+  })
+
+  return createUIMessageStreamResponse({ stream })
+}
+```
+
+The `@mastra/ai-sdk` export returns a reusable transform factory so route configuration creates a fresh `TransformStream` for every request. The `@mastra/core/stream` export returns a `TransformStream` for direct use with `pipeThrough()`.
+
+The reusable factory can also be passed to `Agent.stream()`:
+
+```typescript
+import { smoothStream } from '@mastra/ai-sdk'
+
+const result = await agent.stream('Explain how rainbows form', {
+  experimentalTransform: smoothStream({ delayInMs: 20 }),
+})
+
+for await (const chunk of result.fullStream) {
+  // Consume the transformed Mastra chunks.
+}
+```
+
+## Parameters
+
+**options** (`SmoothStreamOptions`): Controls the delay and chunk boundaries for the transformed stream.
+
+**options.delayInMs** (`number | null`): Delay in milliseconds after each emitted chunk. Set this value to null to disable the delay.
+
+**options.chunking** (`'word' | 'line' | RegExp | SmoothStreamChunkDetector | Intl.Segmenter`): Controls how buffered text and reasoning are divided into chunks.
+
+The `chunking` option accepts:
+
+- `'word'`: Emits complete words, including trailing whitespace.
+- `'line'`: Emits content through each newline.
+- `RegExp`: Emits content through the first match.
+- `Intl.Segmenter`: Uses locale-aware segmentation, which is useful for languages without spaces between words.
+- `SmoothStreamChunkDetector`: Calls a function with the current buffer. The function returns a non-empty prefix to emit, or `null` or `undefined` to wait for more content.
+
+## Custom chunking
+
+Use a regular expression to define a chunk boundary:
+
+```typescript
+const stream = result.fullStream.pipeThrough(
+  smoothStream({
+    chunking: /[^,]*,\s*/,
+  }),
+)
+```
+
+Use `Intl.Segmenter` for locale-aware segmentation:
+
+```typescript
+const stream = result.fullStream.pipeThrough(
+  smoothStream({
+    chunking: new Intl.Segmenter('ja', { granularity: 'word' }),
+  }),
+)
+```
+
+Use a detector function when chunk boundaries depend on custom logic. The returned value must be a prefix of the buffer:
+
+```typescript
+const stream = result.fullStream.pipeThrough(
+  smoothStream({
+    chunking: buffer => {
+      const boundary = buffer.indexOf('. ')
+      return boundary === -1 ? null : buffer.slice(0, boundary + 2)
+    },
+  }),
+)
+```
+
+## Returns
+
+`TransformStream<ChunkType<OUTPUT>, ChunkType<OUTPUT>>`
+
+The transform emits smoothed `text-delta` and `reasoning-delta` chunks. It preserves chunk identifiers, run identifiers, sources, and metadata.
+
+## Related
+
+- [`MastraModelOutput`](https://mastra.ai/reference/streaming/agents/MastraModelOutput)
+- [`ChunkType`](https://mastra.ai/reference/streaming/ChunkType)

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.2.11
+
+### Patch Changes
+
+- Updated dependencies [[`ce93a3c`](https://github.com/mastra-ai/mastra/commit/ce93a3c114ea1cbfbd576f3db41d7c26c9844f5b), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`a211d09`](https://github.com/mastra-ai/mastra/commit/a211d09185dc65a746534914cf38b67f21ee9bac), [`0dca9d0`](https://github.com/mastra-ai/mastra/commit/0dca9d0b1356024a53b72ea6f040db528b126caa), [`6218217`](https://github.com/mastra-ai/mastra/commit/62182171b6cfca0b099f1c6a77a2e65e7639ab86), [`5807d3a`](https://github.com/mastra-ai/mastra/commit/5807d3ae1d259b8b7d6df7e5bf2b485c694af9c8), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`05db566`](https://github.com/mastra-ai/mastra/commit/05db566fcbdcbf33d0bffca0c72ec30129e2e3ca), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`d1b7e3a`](https://github.com/mastra-ai/mastra/commit/d1b7e3a978a309a5653eeaa490d2d6c7c53bd093), [`29c584a`](https://github.com/mastra-ai/mastra/commit/29c584a13a88831e5ed1fdeb0ff8e82eae180433), [`c093146`](https://github.com/mastra-ai/mastra/commit/c0931466404d3c521308ea119cb165bb7e695155), [`8124754`](https://github.com/mastra-ai/mastra/commit/8124754ae89fbc69f8136d1df4a91904d0f84c4e), [`d12b2e4`](https://github.com/mastra-ai/mastra/commit/d12b2e4023fd9e3d3e93a9169f5088bcee2a849c)]:
+  - @mastra/core@1.54.0
+
+## 1.2.11-alpha.6
+
+### Patch Changes
+
+- Updated dependencies [[`6218217`](https://github.com/mastra-ai/mastra/commit/62182171b6cfca0b099f1c6a77a2e65e7639ab86), [`d12b2e4`](https://github.com/mastra-ai/mastra/commit/d12b2e4023fd9e3d3e93a9169f5088bcee2a849c)]:
+  - @mastra/core@1.54.0-alpha.4
+
 ## 1.2.11-alpha.5
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.11-alpha.5",
+  "version": "1.2.11",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/core": "1.54.0-alpha.3",
+    "@mastra/core": "1.54.0",
     "@mastra/mcp": "^1.15.0"
   },
   "devDependencies": {
@@ -45,9 +45,9 @@
     "tsx": "^4.23.1",
     "typescript": "^6.0.3",
     "vitest": "4.1.10",
-    "@internal/lint": "0.0.117",
-    "@internal/types-builder": "0.0.92",
-    "@mastra/core": "1.54.0-alpha.3"
+    "@internal/lint": "0.0.118",
+    "@internal/types-builder": "0.0.93",
+    "@mastra/core": "1.54.0"
   },
   "homepage": "https://mastra.ai",
   "repository": {