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

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,12 @@
 # @mastra/mcp-docs-server
 
+## 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-alpha.6",
   "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-alpha.4",
     "@mastra/mcp": "^1.15.0"
   },
   "devDependencies": {
@@ -47,7 +47,7 @@
     "vitest": "4.1.10",
     "@internal/lint": "0.0.117",
     "@internal/types-builder": "0.0.92",
-    "@mastra/core": "1.54.0-alpha.3"
+    "@mastra/core": "1.54.0-alpha.4"
   },
   "homepage": "https://mastra.ai",
   "repository": {