@mastra/mcp-docs-server 0.13.19-alpha.1 → 0.13.19-alpha.2

package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md

@@ -1,5 +1,14 @@
 # @mastra/agent-builder
 
+## 0.0.3-alpha.1
+
+### Patch Changes
+
+- Move `zod` from `dependencies` to `devDependencies` and add it to `peerDependencies` ([#7585](https://github.com/mastra-ai/mastra/pull/7585))
+
+- Updated dependencies [[`827d876`](https://github.com/mastra-ai/mastra/commit/827d8766f36a900afcaf64a040f7ba76249009b3), [`7eaf1d1`](https://github.com/mastra-ai/mastra/commit/7eaf1d1cec7e828d7a98efc2a748ac395bbdba3b), [`f3427cd`](https://github.com/mastra-ai/mastra/commit/f3427cdaf9eecd63360dfc897a4acbf5f4143a4e), [`05f13b8`](https://github.com/mastra-ai/mastra/commit/05f13b8fb269ccfc4de98e9db58dbe16eae55a5e)]:
+  - @mastra/core@0.16.1-alpha.2
+
 ## 0.0.3-alpha.0
 
 ### Patch Changes

package/.docs/organized/changelogs/%40mastra%2Fclient-js.md

@@ -1,5 +1,12 @@
 # @mastra/client-js
 
+## 0.12.1-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`827d876`](https://github.com/mastra-ai/mastra/commit/827d8766f36a900afcaf64a040f7ba76249009b3), [`7eaf1d1`](https://github.com/mastra-ai/mastra/commit/7eaf1d1cec7e828d7a98efc2a748ac395bbdba3b), [`f3427cd`](https://github.com/mastra-ai/mastra/commit/f3427cdaf9eecd63360dfc897a4acbf5f4143a4e), [`05f13b8`](https://github.com/mastra-ai/mastra/commit/05f13b8fb269ccfc4de98e9db58dbe16eae55a5e)]:
+  - @mastra/core@0.16.1-alpha.2
+
 ## 0.12.1-alpha.1
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 
 - [#6949](https://github.com/mastra-ai/mastra/pull/6949) [`e6f5046`](https://github.com/mastra-ai/mastra/commit/e6f50467aff317e67e8bd74c485c3fbe2a5a6db1) Thanks [@CalebBarnes](https://github.com/CalebBarnes)! - stream/generate vnext: simplify internal output schema handling, improve types and typescript generics, and add jsdoc comments
 
-- Updated dependencies [[`0778757`](https://github.com/mastra-ai/mastra/commit/07787570e4addbd501522037bd2542c3d9e26822), [`bf504a8`](https://github.com/mastra-ai/mastra/commit/bf504a833051f6f321d832cc7d631f3cb86d657b), [`e6f5046`](https://github.com/mastra-ai/mastra/commit/e6f50467aff317e67e8bd74c485c3fbe2a5a6db1), [`9613558`](https://github.com/mastra-ai/mastra/commit/9613558e6475f4710e05d1be7553a32ee7bddc20)]:
-  - @mastra/core@0.14.2-alpha.0
-
-## 0.10.23
-
-### Patch Changes
-
 
-... 2409 more lines hidden. See full changelog in package directory.
+... 2416 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fcloud.md

@@ -1,5 +1,14 @@
 # @mastra/cloud
 
+## 0.1.13-alpha.0
+
+### Patch Changes
+
+- Rename cloud exporter to MastraCloudAITracingExporter and provide default value for trace endpoint ([#7600](https://github.com/mastra-ai/mastra/pull/7600))
+
+- Updated dependencies [[`827d876`](https://github.com/mastra-ai/mastra/commit/827d8766f36a900afcaf64a040f7ba76249009b3), [`7eaf1d1`](https://github.com/mastra-ai/mastra/commit/7eaf1d1cec7e828d7a98efc2a748ac395bbdba3b), [`f3427cd`](https://github.com/mastra-ai/mastra/commit/f3427cdaf9eecd63360dfc897a4acbf5f4143a4e), [`05f13b8`](https://github.com/mastra-ai/mastra/commit/05f13b8fb269ccfc4de98e9db58dbe16eae55a5e)]:
+  - @mastra/core@0.16.1-alpha.2
+
 ## 0.1.12
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 
 - 63f6b7d: dependencies updates:
   - Updated dependency [`@opentelemetry/otlp-transformer@^0.201.1` ↗︎](https://www.npmjs.com/package/@opentelemetry/otlp-transformer/v/0.201.1) (from `^0.201.0`, in `dependencies`)
-  - Updated dependency [`@opentelemetry/otlp-exporter-base@^0.201.1` ↗︎](https://www.npmjs.com/package/@opentelemetry/otlp-exporter-base/v/0.201.1) (from `^0.201.0`, in `dependencies`)
-- Updated dependencies [63f6b7d]
-- Updated dependencies [36f1c36]
-- Updated dependencies [10d352e]
-- Updated dependencies [53d3c37]
-  - @mastra/core@0.10.6-alpha.0
-
-## 0.1.2
-
 
-... 392 more lines hidden. See full changelog in package directory.
+... 401 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fcore.md

@@ -1,5 +1,17 @@
 # @mastra/core
 
+## 0.16.1-alpha.2
+
+### Patch Changes
+
+- Fixed provider defined tools for stream/generate vnext ([#7642](https://github.com/mastra-ai/mastra/pull/7642))
+
+- Change to createRunAsync ([#7632](https://github.com/mastra-ai/mastra/pull/7632))
+
+- Flatten loop config in stream options and pass to loop options ([#7643](https://github.com/mastra-ai/mastra/pull/7643))
+
+- Fix issue with response message id consistency between stream/generate response and the message ids saveed in the DB. Also fixed the custom generatorId implementation to work with this. ([#7606](https://github.com/mastra-ai/mastra/pull/7606))
+
 ## 0.16.1-alpha.1
 
 ### Patch Changes
@@ -287,16 +299,4 @@
 
 ## 0.15.2
 
-### Patch Changes
-
-- Updated dependencies [[`c6113ed`](https://github.com/mastra-ai/mastra/commit/c6113ed7f9df297e130d94436ceee310273d6430)]:
-  - @mastra/schema-compat@0.11.1
-
-## 0.15.0
-
-### Minor Changes
-
-- [#7032](https://github.com/mastra-ai/mastra/pull/7032) [`1191ce9`](https://github.com/mastra-ai/mastra/commit/1191ce946b40ed291e7877a349f8388e3cff7e5c) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump zod peerdep to 3.25.0 to support both v3/v4
-
-
-... 3082 more lines hidden. See full changelog in package directory.
+... 3094 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md

@@ -1,5 +1,13 @@
 # @mastra/deployer-cloud
 
+## 0.16.1-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`827d876`](https://github.com/mastra-ai/mastra/commit/827d8766f36a900afcaf64a040f7ba76249009b3), [`7eaf1d1`](https://github.com/mastra-ai/mastra/commit/7eaf1d1cec7e828d7a98efc2a748ac395bbdba3b), [`f3427cd`](https://github.com/mastra-ai/mastra/commit/f3427cdaf9eecd63360dfc897a4acbf5f4143a4e), [`05f13b8`](https://github.com/mastra-ai/mastra/commit/05f13b8fb269ccfc4de98e9db58dbe16eae55a5e)]:
+  - @mastra/core@0.16.1-alpha.2
+  - @mastra/deployer@0.16.1-alpha.2
+
 ## 0.16.1-alpha.1
 
 ### Patch Changes

package/.docs/organized/changelogs/%40mastra%2Fdeployer.md

@@ -1,5 +1,13 @@
 # @mastra/deployer
 
+## 0.16.1-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`827d876`](https://github.com/mastra-ai/mastra/commit/827d8766f36a900afcaf64a040f7ba76249009b3), [`7eaf1d1`](https://github.com/mastra-ai/mastra/commit/7eaf1d1cec7e828d7a98efc2a748ac395bbdba3b), [`f3427cd`](https://github.com/mastra-ai/mastra/commit/f3427cdaf9eecd63360dfc897a4acbf5f4143a4e), [`81d1383`](https://github.com/mastra-ai/mastra/commit/81d13836fe81c5f02a86e6f40416005898a405ba), [`05f13b8`](https://github.com/mastra-ai/mastra/commit/05f13b8fb269ccfc4de98e9db58dbe16eae55a5e)]:
+  - @mastra/core@0.16.1-alpha.2
+  - @mastra/server@0.16.1-alpha.2
+
 ## 0.16.1-alpha.1
 
 ### Patch Changes
@@ -291,12 +299,4 @@
 
 ### Patch Changes
 
-- [#6798](https://github.com/mastra-ai/mastra/pull/6798) [`e9a36bd`](https://github.com/mastra-ai/mastra/commit/e9a36bd03ed032528b60186a318f563ebf59c01a) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
-  - Updated dependency [`rollup@~4.46.4` ↗︎](https://www.npmjs.com/package/rollup/v/4.46.4) (from `~4.46.2`, in `dependencies`)
-
-- [#6965](https://github.com/mastra-ai/mastra/pull/6965) [`2b38a60`](https://github.com/mastra-ai/mastra/commit/2b38a60da0c1153028d8241c7748b41c5fb81121) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
-  - Updated dependency [`rollup@~4.47.1` ↗︎](https://www.npmjs.com/package/rollup/v/4.47.1) (from `~4.46.4`, in `dependencies`)
-
-- [#6995](https://github.com/mastra-ai/mastra/pull/6995) [`681252d`](https://github.com/mastra-ai/mastra/commit/681252d20e57fcee6821377dea96cacab3bc230f) Thanks [@wardpeet](https://github.com/wardpeet)! - Improve type resolving
-
-... 3927 more lines hidden. See full changelog in package directory.
+... 3935 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 0.13.19-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`827d876`](https://github.com/mastra-ai/mastra/commit/827d8766f36a900afcaf64a040f7ba76249009b3), [`7eaf1d1`](https://github.com/mastra-ai/mastra/commit/7eaf1d1cec7e828d7a98efc2a748ac395bbdba3b), [`f3427cd`](https://github.com/mastra-ai/mastra/commit/f3427cdaf9eecd63360dfc897a4acbf5f4143a4e), [`05f13b8`](https://github.com/mastra-ai/mastra/commit/05f13b8fb269ccfc4de98e9db58dbe16eae55a5e)]:
+  - @mastra/core@0.16.1-alpha.2
+
 ## 0.13.19-alpha.1
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 
 ### Patch Changes
 
-- Updated dependencies [[`6e7e120`](https://github.com/mastra-ai/mastra/commit/6e7e1207d6e8d8b838f9024f90bd10df1181ba27), [`a5a23d9`](https://github.com/mastra-ai/mastra/commit/a5a23d981920d458dc6078919992a5338931ef02)]:
-  - @mastra/core@0.14.1-alpha.0
-
-## 0.13.12
-
-### Patch Changes
-
 
-... 1663 more lines hidden. See full changelog in package directory.
+... 1670 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,16 @@
 # @mastra/server
 
+## 0.16.1-alpha.2
+
+### Patch Changes
+
+- Flatten loop config in stream options and pass to loop options ([#7643](https://github.com/mastra-ai/mastra/pull/7643))
+
+- Fix a bug where `typescript` was bundled into `dist` ([#7585](https://github.com/mastra-ai/mastra/pull/7585))
+
+- Updated dependencies [[`827d876`](https://github.com/mastra-ai/mastra/commit/827d8766f36a900afcaf64a040f7ba76249009b3), [`7eaf1d1`](https://github.com/mastra-ai/mastra/commit/7eaf1d1cec7e828d7a98efc2a748ac395bbdba3b), [`f3427cd`](https://github.com/mastra-ai/mastra/commit/f3427cdaf9eecd63360dfc897a4acbf5f4143a4e), [`05f13b8`](https://github.com/mastra-ai/mastra/commit/05f13b8fb269ccfc4de98e9db58dbe16eae55a5e)]:
+  - @mastra/core@0.16.1-alpha.2
+
 ## 0.16.1-alpha.1
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [[`943a7f3`](https://github.com/mastra-ai/mastra/commit/943a7f3dbc6a8ab3f9b7bc7c8a1c5b319c3d7f56), [`be49354`](https://github.com/mastra-ai/mastra/commit/be493546dca540101923ec700feb31f9a13939f2), [`d591ab3`](https://github.com/mastra-ai/mastra/commit/d591ab3ecc985c1870c0db347f8d7a20f7360536), [`ba82abe`](https://github.com/mastra-ai/mastra/commit/ba82abe76e869316bb5a9c95e8ea3946f3436fae), [`727f7e5`](https://github.com/mastra-ai/mastra/commit/727f7e5086e62e0dfe3356fb6dcd8bcb420af246), [`82d9f64`](https://github.com/mastra-ai/mastra/commit/82d9f647fbe4f0177320e7c05073fce88599aa95), [`4189486`](https://github.com/mastra-ai/mastra/commit/4189486c6718fda78347bdf4ce4d3fc33b2236e1), [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01)]:
   - @mastra/core@0.14.2-alpha.1
 
-## 0.14.2-alpha.0
-
-### Patch Changes
-
-- [#6933](https://github.com/mastra-ai/mastra/pull/6933) [`bf504a8`](https://github.com/mastra-ai/mastra/commit/bf504a833051f6f321d832cc7d631f3cb86d657b) Thanks [@NikAiyer](https://github.com/NikAiyer)! - Add util functions for workflow server handlers and made processor process function async
-
-- Updated dependencies [[`0778757`](https://github.com/mastra-ai/mastra/commit/07787570e4addbd501522037bd2542c3d9e26822), [`bf504a8`](https://github.com/mastra-ai/mastra/commit/bf504a833051f6f321d832cc7d631f3cb86d657b), [`e6f5046`](https://github.com/mastra-ai/mastra/commit/e6f50467aff317e67e8bd74c485c3fbe2a5a6db1), [`9613558`](https://github.com/mastra-ai/mastra/commit/9613558e6475f4710e05d1be7553a32ee7bddc20)]:
-  - @mastra/core@0.14.2-alpha.0
-
-## 0.14.1
-
 
-... 3220 more lines hidden. See full changelog in package directory.
+... 3231 more lines hidden. See full changelog in package directory.

package/.docs/raw/agents/dynamic-agents.mdx

@@ -5,7 +5,7 @@ description: Dynamically configure your agent's instruction, model, tools, and m
 
 # Dynamic Agents
 
-Dynamic agents use [runtime context](./runtime-variables), like user IDs and other important parameters, to adjust their settings in real-time.
+Dynamic agents use [runtime context](./runtime-context), like user IDs and other important parameters, to adjust their settings in real-time.
 
 This means they can change the model they use, update their instructions, select different tools, and configure memory as needed.
 
@@ -25,12 +25,12 @@ const supportAgent = new Agent({
 
     return `You are a customer support agent for our SaaS platform.
     The current user is on the ${userTier} tier and prefers ${language} language.
-    
+
     For ${userTier} tier users:
     ${userTier === "free" ? "- Provide basic support and documentation links" : ""}
     ${userTier === "pro" ? "- Offer detailed technical support and best practices" : ""}
     ${userTier === "enterprise" ? "- Provide priority support with custom solutions" : ""}
-    
+
     Always respond in ${language} language.`;
   },
 
@@ -58,7 +58,7 @@ const supportAgent = new Agent({
 
   memory: ({ runtimeContext }) => {
     const userTier = runtimeContext.get("user-tier");
-    
+
     if (userTier === "enterprise") {
       return new Memory({
         storage: new LibSQLStore({ url: "file:enterprise.db" }),
@@ -76,7 +76,7 @@ const supportAgent = new Agent({
         },
       });
     }
-    
+
     // Basic memory for free tier
     return new Memory({
       storage: new LibSQLStore({ url: "file:free.db" }),

package/.docs/raw/agents/runtime-context.mdx

@@ -0,0 +1,103 @@
+---
+title: "Runtime context | Agents | Mastra Docs"
+description: Learn how to use Mastra's RuntimeContext to provide dynamic, request-specific configuration to agents.
+---
+
+# Agent Runtime Context
+
+Mastra provides `RuntimeContext`, a dependency injection system that lets you configure agents with runtime variables. If you find yourself creating multiple agents that perform similar tasks, runtime context allows you to consolidate them into a single, more flexible agent.
+
+## Overview
+
+The dependency injection system allows you to:
+
+1. Pass runtime configuration variables to agents through a type-safe `runtimeContext`
+2. Access these variables within tool execution contexts
+3. Modify agent behavior without changing the underlying code
+4. Share configuration across multiple tools within the same agent
+
+## Using `runtimeContext` with agents
+
+Agents can access `runtimeContext` via the `instructions` parameter, and retrieve variables using `runtimeContext.get()`. This allows agent behavior to adapt dynamically based on user input or external configuration, without changing the underlying implementation.
+
+```typescript {6-7,14} filename="src/mastra/agents/test-weather-agent.ts" showLineNumbers copy
+import { openai } from "@ai-sdk/openai";
+import { Agent } from "@mastra/core/agent";
+
+export const testWeatherAgent = new Agent({
+  name: "test-weather-agent",
+  instructions: async ({ runtimeContext }) => {
+    const temperatureUnit = runtimeContext.get("temperature-unit");
+
+    return `You are a weather assistant that provides current weather information for any city.
+
+    When a user asks for weather:
+    - Extract the city name from their request
+    - Respond with: temperature, feels-like temperature, humidity, wind speed, and conditions
+    - Use ${temperatureUnit} for all temperature values
+    - If no city is mentioned, ask for a city name
+    `;
+  },
+  model: openai("gpt-4o-mini")
+});
+```
+
+### Example usage
+
+In this example, `temperature-unit` is set using `runtimeContext.set()` to either **celsius** or **fahrenheit**, allowing the agent to respond with temperatures in the appropriate unit.
+
+```typescript {12} filename="src/test-weather-agent.ts" showLineNumbers copy
+import { mastra } from "./mastra";
+import { RuntimeContext } from "@mastra/core/runtime-context";
+
+const agent = mastra.getAgent("testWeatherAgent");
+
+export type WeatherRuntimeContext = {
+  "temperature-unit": "celsius" | "fahrenheit";
+};
+
+const runtimeContext = new RuntimeContext<WeatherRuntimeContext>();
+
+runtimeContext.set("temperature-unit", "fahrenheit");
+
+const response = await agent.generate("What's the weather in London?", {
+  runtimeContext
+});
+
+console.log(response.text);
+```
+
+## Accessing `runtimeContext` with server middleware
+
+You can populate `runtimeContext` dynamically in server middleware by extracting information from the request. In this example, the `temperature-unit` is set based on the Cloudflare `CF-IPCountry` header to ensure responses match the user's locale.
+
+```typescript {2,12-21} filename="src/mastra/index.ts" showLineNumbers copy
+import { Mastra } from "@mastra/core/mastra";
+import { RuntimeContext } from "@mastra/core/runtime-context";
+import { testWeatherAgent } from "./agents/test-weather-agent";
+
+type WeatherRuntimeContext = {
+  "temperature-unit": "celsius" | "fahrenheit";
+};
+
+export const mastra = new Mastra({
+  agents: { testWeatherAgent },
+  server: {
+    middleware: [
+      async (context, next) => {
+        const country = context.req.header("CF-IPCountry");
+        const runtimeContext = context.get("runtimeContext") as RuntimeContext<WeatherRuntimeContext>;
+
+        runtimeContext.set("temperature-unit", country === "US" ? "fahrenheit" : "celsius");
+
+        await next();
+      }
+    ]
+  }
+});
+```
+
+## Related
+
+- [Dynamic Agents](./dynamic-agents.mdx)
+- [Tool Runtime Context](../tools-mcp/runtime-context.mdx)

package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx

@@ -287,7 +287,7 @@ export const mastra = new Mastra({
 });
 ```
 
-> You can then access this data in your tools via the `runtimeContext` parameter. See the [Runtime Context documentation](/docs/agents/runtime-variables) for more details.
+> You can then access this data in your tools via the `runtimeContext` parameter. See the [Agent Runtime Context documentation](/docs/agents/runtime-context) for more details.
 
 ## Streaming data
 

package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx

@@ -64,4 +64,4 @@ await agent.getDefaultGenerateOptions({
 ## Related
 
 - [Agent generation](../../docs/agents/overview.mdx#generate)
-- [Runtime variables](../../docs/agents/runtime-variables.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)

package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx

@@ -65,4 +65,4 @@ await agent.getDefaultStreamOptions({
 
 - [Generating responses](../../docs/agents/overview.mdx#generating-responses)
 - [Streaming responses](../../docs/agents/overview.mdx#streaming-responses)
-- [Runtime variables](../../docs/agents/runtime-variables.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)

package/.docs/raw/reference/agents/getDefaultVNextStreamOptions.mdx

@@ -64,4 +64,4 @@ await agent.getDefaultVNextStreamOptions({
 ## Related
 
 - [Streaming with agents](../../docs/streaming/overview.mdx#streaming-with-agents)
-- [Runtime variables](../../docs/agents/runtime-variables.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)

package/.docs/raw/reference/agents/getInstructions.mdx

@@ -64,4 +64,4 @@ await agent.getInstructions({
 ## Related
 
 - [Agents overview](../../docs/agents/overview.mdx)
-- [Runtime variables](../../docs/agents/runtime-variables.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)

package/.docs/raw/reference/agents/getLLM.mdx

@@ -71,4 +71,4 @@ await agent.getLLM({
 ## Related
 
 - [Agents overview](../../docs/agents/overview.mdx)
-- [Runtime variables](../../docs/agents/runtime-variables.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)

package/.docs/raw/reference/agents/getMemory.mdx

@@ -64,4 +64,4 @@ await agent.getMemory({
 ## Related
 
 - [Agent memory](../../docs/agents/agent-memory.mdx)
-- [Runtime variables](../../docs/agents/runtime-variables.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)

package/.docs/raw/reference/agents/getModel.mdx

@@ -64,4 +64,4 @@ await agent.getModel({
 ## Related
 
 - [Agents overview](../../docs/agents/overview.mdx)
-- [Runtime variables](../../docs/agents/runtime-variables.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)

package/.docs/raw/reference/agents/getScorers.mdx

@@ -64,4 +64,4 @@ await agent.getScorers({
 ## Related
 
 - [Agents overview](../../docs/agents/overview.mdx)
-- [Runtime variables](../../docs/agents/runtime-variables.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)

package/.docs/raw/reference/agents/streamVNext.mdx

@@ -41,7 +41,7 @@ const aiSdkStream = await agent.streamVNext("message for agent", {
   ]}
 />
 
-### Options parameters
+### Options
 
 <PropertiesTable
   content={[
@@ -52,16 +52,99 @@ const aiSdkStream = await agent.streamVNext("message for agent", {
       defaultValue: "'mastra'",
       description: "Determines the output stream format. Use 'mastra' for Mastra's native format (default) or 'aisdk' for AI SDK v5 compatibility.",
     },
+    {
+      name: "maxSteps",
+      type: "number",
+      isOptional: true,
+      description: "Maximum number of steps to run during execution.",
+    },
+    {
+      name: "scorers",
+      type: "MastraScorers | Record<string, { scorer: MastraScorer['name']; sampling?: ScoringSamplingConfig }>",
+      isOptional: true,
+      description: "Evaluation scorers to run on the execution results.",
+      properties: [
+        {
+          parameters: [{
+            name: "scorer",
+            type: "string",
+            isOptional: false,
+            description: "Name of the scorer to use."
+          }]
+        },
+        {
+          parameters: [{
+            name: "sampling",
+            type: "ScoringSamplingConfig",
+            isOptional: true,
+            description: "Sampling configuration for the scorer.",
+            properties: [
+              {
+                parameters: [{
+                  name: "type",
+                  type: "'none' | 'ratio'",
+                  isOptional: false,
+                  description: "Type of sampling strategy. Use 'none' to disable sampling or 'ratio' for percentage-based sampling."
+                }]
+              },
+              {
+                parameters: [{
+                  name: "rate",
+                  type: "number",
+                  isOptional: true,
+                  description: "Sampling rate (0-1). Required when type is 'ratio'."
+                }]
+              }
+            ]
+          }]
+        }
+      ]
+    },
+    {
+      name: "tracingContext",
+      type: "TracingContext",
+      isOptional: true,
+      description: "AI tracing context for span hierarchy and metadata.",
+    },
+    {
+      name: "returnScorerData",
+      type: "boolean",
+      isOptional: true,
+      description: "Whether to return detailed scoring data in the response.",
+    },
+    {
+      name: "onChunk",
+      type: "(chunk: ChunkType) => Promise<void> | void",
+      isOptional: true,
+      description: "Callback function called for each chunk during streaming."
+    },
+    {
+      name: "onError",
+      type: "({ error }: { error: Error | string }) => Promise<void> | void",
+      isOptional: true,
+      description: "Callback function called when an error occurs during streaming."
+    },
+    {
+      name: "onAbort",
+      type: "(event: any) => Promise<void> | void",
+      isOptional: true,
+      description: "Callback function called when the stream is aborted."
+    },
     {
       name: "abortSignal",
       type: "AbortSignal",
       isOptional: true,
-      description:
-        "Signal object that allows you to abort the agent's execution. When the signal is aborted, all ongoing operations will be terminated.",
+      description: "Signal object that allows you to abort the agent's execution. When the signal is aborted, all ongoing operations will be terminated."
+    },
+    {
+      name: "activeTools",
+      type: "Array<keyof ToolSet> | undefined",
+      isOptional: true,
+      description: "Array of active tool names that can be used during execution."
     },
     {
       name: "context",
-      type: "CoreMessage[]",
+      type: "ModelMessage[]",
       isOptional: true,
       description: "Additional context messages to provide to the agent.",
     },
@@ -83,8 +166,8 @@ const aiSdkStream = await agent.streamVNext("message for agent", {
           parameters: [{
             name: "model",
             type: "MastraLanguageModel",
-            isOptional: false,
-            description: "Model to use for the internal structuring agent."
+            isOptional: true,
+            description: "Model to use for the internal structuring agent. If not provided, falls back to the agent's model."
           }]
         },
         {
@@ -178,13 +261,6 @@ const aiSdkStream = await agent.streamVNext("message for agent", {
         }
       ]
     },
-    {
-      name: "maxRetries",
-      type: "number",
-      isOptional: true,
-      defaultValue: "2",
-      description: "Maximum number of retries. Set to 0 to disable retries.",
-    },
     {
       name: "memoryOptions",
       type: "MemoryConfig",
@@ -271,10 +347,10 @@ const aiSdkStream = await agent.streamVNext("message for agent", {
         },
         {
           parameters: [{
-            name: "maxTokens",
+            name: "maxRetries",
             type: "number",
             isOptional: true,
-            description: "Maximum number of tokens to generate."
+            description: "Maximum number of retries for failed requests."
           }]
         },
         {
@@ -317,14 +393,6 @@ const aiSdkStream = await agent.streamVNext("message for agent", {
             description: "Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated."
           }]
         },
-        {
-          parameters: [{
-            name: "seed",
-            type: "number",
-            isOptional: true,
-            description: "The seed (integer) to use for random sampling. If set and supported by the model, calls will generate deterministic results."
-          }]
-        }
       ]
     },
     {
@@ -443,12 +511,6 @@ const aiSdkStream = await agent.streamVNext("message for agent", {
       isOptional: true,
       description: "Runtime context for dependency injection and contextual information.",
     },
-    {
-      name: "experimental_generateMessageId",
-      type: "IDGenerator",
-      isOptional: true,
-      description: "Generate a unique ID for each message.",
-    },
     {
       name: "stopWhen",
       type: "StopCondition | StopCondition[]",
@@ -523,6 +585,35 @@ for await (const part of stream.fullStream) {
 return stream.toUIMessageStreamResponse();
 ```
 
+### Using Callbacks
+
+All callback functions are now available as top-level properties for a cleaner API experience.
+
+```typescript showLineNumbers copy
+const stream = await agent.streamVNext("Tell me a story", {
+  onFinish: (result) => {
+    console.log('Streaming finished:', result);
+  },
+  onStepFinish: (step) => {
+    console.log('Step completed:', step);
+  },
+  onChunk: (chunk) => {
+    console.log('Received chunk:', chunk);
+  },
+  onError: ({ error }) => {
+    console.error('Streaming error:', error);
+  },
+  onAbort: (event) => {
+    console.log('Stream aborted:', event);
+  },
+});
+
+// Process the stream
+for await (const chunk of stream.textStream) {
+  console.log(chunk);
+}
+```
+
 ### Advanced Example with Options
 
 ```typescript showLineNumbers copy

package/.docs/raw/reference/tools/create-tool.mdx

@@ -93,5 +93,5 @@ The `createTool()` function returns a `Tool` object.
 
 - [Tools Overview](/docs/tools-mcp/overview.mdx)
 - [Using Tools with Agents](/docs/agents/using-tools-and-mcp.mdx)
-- [Dynamic Tool Context](/docs/tools-mcp/dynamic-context.mdx)
+- [Tool Runtime Context](/docs/tools-mcp/runtime-context.mdx)
 - [Advanced Tool Usage](/docs/tools-mcp/advanced-usage.mdx)

package/.docs/raw/reference/tools/graph-rag-tool.mdx

@@ -253,8 +253,8 @@ const response = await agent.generate(
 
 For more information on runtime context, please see:
 
-- [Runtime Variables](../../docs/agents/runtime-variables.mdx)
-- [Dynamic Context](../../docs/tools-mcp/dynamic-context.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)
+- [Tool Runtime Context](../../docs/tools-mcp/runtime-context.mdx)
 
 ## Related
 

package/.docs/raw/reference/tools/vector-query-tool.mdx

@@ -558,8 +558,8 @@ const response = await agent.generate(
 
 For more information on runtime context, please see:
 
-- [Runtime Variables](../../docs/agents/runtime-variables.mdx)
-- [Dynamic Context](../../docs/tools-mcp/dynamic-context.mdx)
+- [Agent Runtime Context](../../docs/agents/runtime-context.mdx)
+- [Tool Runtime Context](../../docs/tools-mcp/runtime-context.mdx)
 
 ## Usage Without a Mastra Server
 

package/.docs/raw/tools-mcp/runtime-context.mdx

@@ -0,0 +1,63 @@
+---
+title: "Runtime context | Tools & MCP | Mastra Docs"
+description: Learn how to use Mastra's RuntimeContext to provide dynamic, request-specific configuration to tools.
+---
+
+import { Callout } from "nextra/components";
+
+# Tool Runtime Context
+
+Mastra provides `RuntimeContext`, a dependency injection system that lets you configure tools with runtime variables. If you find yourself creating multiple tools that perform similar tasks, runtime context allows you to consolidate them into a single, more flexible tool.
+
+## Overview
+
+The dependency injection system allows you to:
+
+1. Pass runtime configuration variables to tools through a type-safe `runtimeContext`.
+2. Access these variables within tool execution context.
+3. Modify tool behavior without changing the underlying code.
+4. Share configuration across multiple tools within the same agent.
+
+<Callout>
+  **Note:** `RuntimeContext` is primarily used for passing data *into* tool
+  executions. It's distinct from agent memory, which handles conversation
+  history and state persistence across multiple calls.
+</Callout>
+
+
+## Accessing `runtimeContext` in tools
+
+Tools can access the same `runtimeContext` used by their parent agent, allowing them to adjust behavior based on runtime configuration. In this example, the `temperature-unit` is retrieved within the tool’s `execute` function to ensure consistent formatting with the agent’s instructions.
+
+```typescript {14-15} filename="src/mastra/tools/test-weather-tool" showLineNumbers copy
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+
+type WeatherRuntimeContext = {
+  "temperature-unit": "celsius" | "fahrenheit";
+};
+
+export const testWeatherTool = createTool({
+  id: "getWeather",
+  description: "Get the current weather for a location",
+  inputSchema: z.object({
+    location: z.string().describe("The location to get weather for")
+  }),
+  execute: async ({ context, runtimeContext }) => {
+    const temperatureUnit = runtimeContext.get("temperature-unit") as WeatherRuntimeContext["temperature-unit"];
+
+    const weather = await fetchWeather(context.location, temperatureUnit);
+
+    return { result: weather };
+  }
+});
+
+async function fetchWeather(location: string, temperatureUnit: WeatherRuntimeContext["temperature-unit"]) {
+  // ...
+}
+```
+
+
+## Related
+
+[Agent Runtime Context](../agents/runtime-context.mdx)

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 0.13.19-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`827d876`](https://github.com/mastra-ai/mastra/commit/827d8766f36a900afcaf64a040f7ba76249009b3), [`7eaf1d1`](https://github.com/mastra-ai/mastra/commit/7eaf1d1cec7e828d7a98efc2a748ac395bbdba3b), [`f3427cd`](https://github.com/mastra-ai/mastra/commit/f3427cdaf9eecd63360dfc897a4acbf5f4143a4e), [`05f13b8`](https://github.com/mastra-ai/mastra/commit/05f13b8fb269ccfc4de98e9db58dbe16eae55a5e)]:
+  - @mastra/core@0.16.1-alpha.2
+
 ## 0.13.19-alpha.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.19-alpha.1",
+  "version": "0.13.19-alpha.2",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -33,8 +33,8 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6",
-    "@mastra/core": "0.16.1-alpha.1",
-    "@mastra/mcp": "^0.12.0-alpha.1"
+    "@mastra/mcp": "^0.12.0-alpha.1",
+    "@mastra/core": "0.16.1-alpha.2"
   },
   "devDependencies": {
     "@hono/node-server": "^1.17.1",
@@ -50,7 +50,7 @@
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
     "@internal/lint": "0.0.36",
-    "@mastra/core": "0.16.1-alpha.1"
+    "@mastra/core": "0.16.1-alpha.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {

package/.docs/raw/agents/runtime-variables.mdx

@@ -1,116 +0,0 @@
----
-title: "Runtime context | Agents | Mastra Docs"
-description: Learn how to use Mastra's dependency injection system to provide runtime configuration to agents and tools.
----
-
-# Agent Runtime Context
-
-Mastra provides runtime context, which is a system based on dependency injection that enables you to configure your agents and tools with runtime variables. If you find yourself creating several different agents that do very similar things, runtime context allows you to combine them into one agent.
-
-## Overview
-
-The dependency injection system allows you to:
-
-1. Pass runtime configuration variables to agents through a type-safe runtimeContext
-2. Access these variables within tool execution contexts
-3. Modify agent behavior without changing the underlying code
-4. Share configuration across multiple tools within the same agent
-
-## Basic Usage
-
-```typescript
-const agent = mastra.getAgent("weatherAgent");
-
-// Define your runtimeContext's type structure
-type WeatherRuntimeContext = {
-  "temperature-scale": "celsius" | "fahrenheit";
-};
-
-const runtimeContext = new RuntimeContext<WeatherRuntimeContext>();
-runtimeContext.set("temperature-scale", "celsius");
-
-const response = await agent.generate("What's the weather like today?", {
-  runtimeContext,
-});
-
-console.log(response.text);
-```
-
-## Using with REST API
-
-Here's how to dynamically set temperature units based on a user's location using the Cloudflare `CF-IPCountry` header:
-
-```typescript filename="src/index.ts"
-import { Mastra } from "@mastra/core";
-import { RuntimeContext } from "@mastra/core/di";
-import { agent as weatherAgent } from "./agents/weather";
-
-// Define RuntimeContext type with clear, descriptive types
-type WeatherRuntimeContext = {
-  "temperature-scale": "celsius" | "fahrenheit";
-};
-
-export const mastra = new Mastra({
-  agents: {
-    weather: weatherAgent,
-  },
-  server: {
-    middleware: [
-      async (c, next) => {
-        const country = c.req.header("CF-IPCountry");
-        const runtimeContext = c.get<WeatherRuntimeContext>("runtimeContext");
-
-        // Set temperature scale based on country
-        runtimeContext.set(
-          "temperature-scale",
-          country === "US" ? "fahrenheit" : "celsius",
-        );
-
-        await next(); // Don't forget to call next()
-      },
-    ],
-  },
-});
-```
-
-## Creating Tools with Variables
-
-Tools can access runtimeContext variables and must conform to the agent's runtimeContext type:
-
-```typescript
-import { createTool } from "@mastra/core/tools";
-import { z } from "zod";
-
-export const weatherTool = createTool({
-  id: "getWeather",
-  description: "Get the current weather for a location",
-  inputSchema: z.object({
-    location: z.string().describe("The location to get weather for"),
-  }),
-  execute: async ({ context, runtimeContext }) => {
-    // Type-safe access to runtimeContext variables
-    const temperatureUnit = runtimeContext.get("temperature-scale");
-
-    const weather = await fetchWeather(context.location, {
-      temperatureUnit,
-    });
-
-    return { result: weather };
-  },
-});
-
-async function fetchWeather(
-  location: string,
-  { temperatureUnit }: { temperatureUnit: "celsius" | "fahrenheit" },
-): Promise<WeatherResponse> {
-  // Implementation of weather API call
-  const response = await weatherApi.fetch(location, temperatureUnit);
-
-  return {
-    location,
-    temperature: "72°F",
-    conditions: "Sunny",
-    unit: temperatureUnit,
-  };
-}
-```

package/.docs/raw/tools-mcp/dynamic-context.mdx

@@ -1,131 +0,0 @@
----
-title: "Dynamic Tool Context | Tools & MCP | Mastra Docs"
-description: Learn how to use Mastra's RuntimeContext to provide dynamic, request-specific configuration to tools.
----
-
-import { Callout } from "nextra/components";
-
-# Dynamic Tool Context
-
-Mastra provides `RuntimeContext`, a system based on dependency injection, that allows you to pass dynamic, request-specific configuration to your tools during execution. This is useful when a tool's behavior needs to change based on user identity, request headers, or other runtime factors, without altering the tool's core code.
-
-<Callout>
-  **Note:** `RuntimeContext` is primarily used for passing data *into* tool
-  executions. It's distinct from agent memory, which handles conversation
-  history and state persistence across multiple calls.
-</Callout>
-
-## Basic Usage
-
-To use `RuntimeContext`, first define a type structure for your dynamic configuration. Then, create an instance of `RuntimeContext` typed with your definition and set the desired values. Finally, include the `runtimeContext` instance in the options object when calling `agent.generate()` or `agent.stream()`.
-
-```typescript
-import { RuntimeContext } from "@mastra/core/di";
-// Assume 'agent' is an already defined Mastra Agent instance
-
-// Define the context type
-type WeatherRuntimeContext = {
-  "temperature-scale": "celsius" | "fahrenheit";
-};
-
-// Instantiate RuntimeContext and set values
-const runtimeContext = new RuntimeContext<WeatherRuntimeContext>();
-runtimeContext.set("temperature-scale", "celsius");
-
-// Pass to agent call
-const response = await agent.generate("What's the weather like today?", {
-  runtimeContext, // Pass the context here
-});
-
-console.log(response.text);
-```
-
-## Accessing Context in Tools
-
-Tools receive the `runtimeContext` as part of the second argument to their `execute` function. You can then use the `.get()` method to retrieve values.
-
-```typescript filename="src/mastra/tools/weather-tool.ts"
-import { createTool } from "@mastra/core/tools";
-import { z } from "zod";
-// Assume WeatherRuntimeContext is defined as above and accessible here
-
-// Dummy fetch function
-async function fetchWeather(
-  location: string,
-  options: { temperatureUnit: "celsius" | "fahrenheit" },
-): Promise<any> {
-  console.log(`Fetching weather for ${location} in ${options.temperatureUnit}`);
-  // Replace with actual API call
-  return { temperature: options.temperatureUnit === "celsius" ? 20 : 68 };
-}
-
-export const weatherTool = createTool({
-  id: "getWeather",
-  description: "Get the current weather for a location",
-  inputSchema: z.object({
-    location: z.string().describe("The location to get weather for"),
-  }),
-  // The tool's execute function receives runtimeContext
-  execute: async ({ context, runtimeContext }) => {
-    // Type-safe access to runtimeContext variables
-    const temperatureUnit = runtimeContext.get("temperature-scale");
-
-    // Use the context value in the tool logic
-    const weather = await fetchWeather(context.location, {
-      temperatureUnit,
-    });
-
-    return {
-      result: `The temperature is ${weather.temperature}°${temperatureUnit === "celsius" ? "C" : "F"}`,
-    };
-  },
-});
-```
-
-When the agent uses `weatherTool`, the `temperature-scale` value set in the `runtimeContext` during the `agent.generate()` call will be available inside the tool's `execute` function.
-
-## Using with Server Middleware
-
-In server environments (like Express or Next.js), you can use middleware to automatically populate `RuntimeContext` based on incoming request data, such as headers or user sessions.
-
-Here's an example using Mastra's built-in server middleware support (which uses Hono internally) to set the temperature scale based on the Cloudflare `CF-IPCountry` header:
-
-```typescript filename="src/mastra/index.ts"
-import { Mastra } from "@mastra/core";
-import { RuntimeContext } from "@mastra/core/di";
-import { weatherAgent } from "./agents/weather"; // Assume agent is defined elsewhere
-
-// Define RuntimeContext type
-type WeatherRuntimeContext = {
-  "temperature-scale": "celsius" | "fahrenheit";
-};
-
-export const mastra = new Mastra({
-  agents: {
-    weather: weatherAgent,
-  },
-  server: {
-    middleware: [
-      async (c, next) => {
-        // Get the RuntimeContext instance
-        const runtimeContext =
-          c.get<RuntimeContext<WeatherRuntimeContext>>("runtimeContext");
-
-        // Get country code from request header
-        const country = c.req.header("CF-IPCountry");
-
-        // Set temperature scale based on country
-        runtimeContext.set(
-          "temperature-scale",
-          country === "US" ? "fahrenheit" : "celsius",
-        );
-
-        // Continue request processing
-        await next();
-      },
-    ],
-  },
-});
-```
-
-With this middleware in place, any agent call handled by this Mastra server instance will automatically have the `temperature-scale` set in its `RuntimeContext` based on the user's inferred country, and tools like `weatherTool` will use it accordingly.