@mastra/mcp-docs-server 0.13.22-alpha.6 → 0.13.22-alpha.8

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

@@ -1,5 +1,19 @@
 # @mastra/client-js
 
+## 0.13.0-alpha.8
+
+### Patch Changes
+
+- Updated dependencies [[`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a)]:
+  - @mastra/core@0.17.0-alpha.8
+
+## 0.13.0-alpha.7
+
+### Patch Changes
+
+- Updated dependencies [[`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689)]:
+  - @mastra/core@0.17.0-alpha.7
+
 ## 0.13.0-alpha.6
 
 ### Minor Changes
@@ -284,19 +298,5 @@
 ### Patch Changes
 
 - Updated dependencies [[`4474d04`](https://github.com/mastra-ai/mastra/commit/4474d0489b1e152e0985c33a4f529207317d27b5), [`4106a58`](https://github.com/mastra-ai/mastra/commit/4106a58b15b4c0a060a4a9ccab52d119d00d8edb)]:
-  - @mastra/core@0.15.3-alpha.8
-
-## 0.11.3-alpha.7
-
-### Patch Changes
-
-- Updated dependencies [[`7149d8d`](https://github.com/mastra-ai/mastra/commit/7149d8d4bdc1edf0008e0ca9b7925eb0b8b60dbe)]:
-  - @mastra/core@0.15.3-alpha.7
-
-## 0.11.3-alpha.6
-
-### Patch Changes
-
-- Updated dependencies [[`c19bcf7`](https://github.com/mastra-ai/mastra/commit/c19bcf7b43542b02157b5e17303e519933a153ab), [`b42a961`](https://github.com/mastra-ai/mastra/commit/b42a961a5aefd19d6e938a7705fc0ecc90e8f756), [`45e4d39`](https://github.com/mastra-ai/mastra/commit/45e4d391a2a09fc70c48e4d60f505586ada1ba0e), [`0302f50`](https://github.com/mastra-ai/mastra/commit/0302f50861a53c66ff28801fc371b37c5f97e41e), [`74db265`](https://github.com/mastra-ai/mastra/commit/74db265b96aa01a72ffd91dcae0bc3b346cca0f2), [`7f3b8da`](https://github.com/mastra-ai/mastra/commit/7f3b8da6dd21c35d3672e44b4f5dd3502b8f8f92), [`905352b`](https://github.com/mastra-ai/mastra/commit/905352bcda134552400eb252bca1cb05a7975c14), [`f2cda47`](https://github.com/mastra-ai/mastra/commit/f2cda47ae911038c5d5489f54c36517d6f15bdcc), [`cfd377a`](https://github.com/mastra-ai/mastra/commit/cfd377a3a33a9c88b644f6540feed9cd9832db47)]:
 
-... 2558 more lines hidden. See full changelog in package directory.
+... 2572 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,19 @@
 # @mastra/core
 
+## 0.17.0-alpha.8
+
+### Patch Changes
+
+- Improve error message when using V1 model with streamVNext ([#7948](https://github.com/mastra-ai/mastra/pull/7948))
+
+- Fix VNext generate/stream usage tokens. They used to be undefined, now we are receiving the proper values. ([#7901](https://github.com/mastra-ai/mastra/pull/7901))
+
+## 0.17.0-alpha.7
+
+### Patch Changes
+
+- fix error message when fetching observability things ([#7956](https://github.com/mastra-ai/mastra/pull/7956))
+
 ## 0.17.0-alpha.6
 
 ### Minor Changes
@@ -284,19 +298,5 @@
 
 - Vnext output schema injection ([#6990](https://github.com/mastra-ai/mastra/pull/6990))
 
-- removed duplicate 'float' switch case ([#7516](https://github.com/mastra-ai/mastra/pull/7516))
-
-- 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.3
-
-### Patch Changes
-
-- Add prepareStep to generate/stream VNext options. ([#7646](https://github.com/mastra-ai/mastra/pull/7646))
-
-## 0.16.1-alpha.2
-
-### Patch Changes
-
 
-... 3388 more lines hidden. See full changelog in package directory.
+... 3402 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,21 @@
 # @mastra/deployer-cloud
 
+## 0.17.0-alpha.8
+
+### Patch Changes
+
+- Updated dependencies [[`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a)]:
+  - @mastra/core@0.17.0-alpha.8
+  - @mastra/deployer@0.17.0-alpha.8
+
+## 0.17.0-alpha.7
+
+### Patch Changes
+
+- Updated dependencies [[`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689)]:
+  - @mastra/core@0.17.0-alpha.7
+  - @mastra/deployer@0.17.0-alpha.7
+
 ## 0.17.0-alpha.6
 
 ### Patch Changes
@@ -283,20 +299,4 @@
 
 ### Patch Changes
 
-- Updated dependencies [[`599d04c`](https://github.com/mastra-ai/mastra/commit/599d04cebe92c1d536fee3190434941b8c91548e)]:
-  - @mastra/core@0.15.3-alpha.9
-  - @mastra/deployer@0.15.3-alpha.9
-
-## 0.15.3-alpha.8
-
-### Patch Changes
-
-- Updated dependencies [[`4474d04`](https://github.com/mastra-ai/mastra/commit/4474d0489b1e152e0985c33a4f529207317d27b5), [`4106a58`](https://github.com/mastra-ai/mastra/commit/4106a58b15b4c0a060a4a9ccab52d119d00d8edb)]:
-  - @mastra/core@0.15.3-alpha.8
-  - @mastra/deployer@0.15.3-alpha.8
-
-## 0.15.3-alpha.7
-
-### Patch Changes
-
-... 127 more lines hidden. See full changelog in package directory.
+... 143 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,21 @@
 # @mastra/deployer
 
+## 0.17.0-alpha.8
+
+### Patch Changes
+
+- Updated dependencies [[`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a)]:
+  - @mastra/core@0.17.0-alpha.8
+  - @mastra/server@0.17.0-alpha.8
+
+## 0.17.0-alpha.7
+
+### Patch Changes
+
+- Updated dependencies [[`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689)]:
+  - @mastra/core@0.17.0-alpha.7
+  - @mastra/server@0.17.0-alpha.7
+
 ## 0.17.0-alpha.6
 
 ### Minor Changes
@@ -283,20 +299,4 @@
   - @mastra/core@0.16.0
   - @mastra/server@0.16.0
 
-## 0.16.0-alpha.1
-
-### Minor Changes
-
-- 376913a: Update peerdeps of @mastra/core
-
-### Patch Changes
-
-- Updated dependencies [8fbf79e]
-- Updated dependencies [376913a]
-  - @mastra/core@0.16.0-alpha.1
-  - @mastra/server@0.16.0-alpha.1
-
-## 0.16.0-alpha.0
-
-
-... 4158 more lines hidden. See full changelog in package directory.
+... 4174 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 0.13.22-alpha.8
+
+### Patch Changes
+
+- Updated dependencies [[`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a)]:
+  - @mastra/core@0.17.0-alpha.8
+
+## 0.13.22-alpha.7
+
+### Patch Changes
+
+- Updated dependencies [[`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689)]:
+  - @mastra/core@0.17.0-alpha.7
+
 ## 0.13.22-alpha.6
 
 ### Patch Changes
@@ -284,19 +298,5 @@
 
 ### Patch Changes
 
-- [#5816](https://github.com/mastra-ai/mastra/pull/5816) [`ab48c97`](https://github.com/mastra-ai/mastra/commit/ab48c979098ea571faf998a55d3a00e7acd7a715) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
-  - Updated dependency [`zod@^3.25.76` ↗︎](https://www.npmjs.com/package/zod/v/3.25.76) (from `^3.25.67`, in `dependencies`)
-  - Updated dependency [`zod-to-json-schema@^3.24.6` ↗︎](https://www.npmjs.com/package/zod-to-json-schema/v/3.24.6) (from `^3.24.5`, in `dependencies`)
-
-- [#7238](https://github.com/mastra-ai/mastra/pull/7238) [`9a98f3c`](https://github.com/mastra-ai/mastra/commit/9a98f3c524f37fb3ebd94c41cd6efed0698a6a2a) Thanks [@alliehowe29](https://github.com/alliehowe29)! - Validate file path after `path.join()`
-
-- Updated dependencies [[`ab48c97`](https://github.com/mastra-ai/mastra/commit/ab48c979098ea571faf998a55d3a00e7acd7a715), [`ff89505`](https://github.com/mastra-ai/mastra/commit/ff895057c8c7e91a5535faef46c5e5391085ddfa), [`183dc95`](https://github.com/mastra-ai/mastra/commit/183dc95596f391b977bd1a2c050b8498dac74891), [`a1111e2`](https://github.com/mastra-ai/mastra/commit/a1111e24e705488adfe5e0a6f20c53bddf26cb22), [`61debef`](https://github.com/mastra-ai/mastra/commit/61debefd80ad3a7ed5737e19df6a23d40091689a), [`9beaeff`](https://github.com/mastra-ai/mastra/commit/9beaeffa4a97b1d5fd01a7f8af8708b16067f67c), [`ad78bfc`](https://github.com/mastra-ai/mastra/commit/ad78bfc4ea6a1fff140432bf4f638e01af7af668), [`9eee594`](https://github.com/mastra-ai/mastra/commit/9eee594e35e0ca2a650fcc33fa82009a142b9ed0), [`979912c`](https://github.com/mastra-ai/mastra/commit/979912cfd180aad53287cda08af771df26454e2c), [`7dcf4c0`](https://github.com/mastra-ai/mastra/commit/7dcf4c04f44d9345b1f8bc5d41eae3f11ac61611), [`ad78bfc`](https://github.com/mastra-ai/mastra/commit/ad78bfc4ea6a1fff140432bf4f638e01af7af668), [`0ce418a`](https://github.com/mastra-ai/mastra/commit/0ce418a1ccaa5e125d4483a9651b635046152569), [`8387952`](https://github.com/mastra-ai/mastra/commit/838795227b4edf758c84a2adf6f7fba206c27719), [`5eca5d2`](https://github.com/mastra-ai/mastra/commit/5eca5d2655788863ea0442a46c9ef5d3c6dbe0a8)]:
-  - @mastra/core@0.15.3-alpha.4
-  - @mastra/mcp@0.11.3-alpha.1
-
-## 0.13.17-alpha.3
-
-### Patch Changes
-
 
-... 1782 more lines hidden. See full changelog in package directory.
+... 1796 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md

@@ -1,5 +1,27 @@
 # @mastra/playground-ui
 
+## 6.2.0-alpha.5
+
+### Patch Changes
+
+- Fix VNext generate/stream usage tokens. They used to be undefined, now we are receiving the proper values. ([#7901](https://github.com/mastra-ai/mastra/pull/7901))
+
+- Updated dependencies [[`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a)]:
+  - @mastra/core@0.17.0-alpha.8
+  - @mastra/client-js@0.13.0-alpha.8
+
+## 6.2.0-alpha.4
+
+### Patch Changes
+
+- Fixed createRun change in agent builder that was missed ([#7966](https://github.com/mastra-ai/mastra/pull/7966))
+
+- fix error message when fetching observability things ([#7956](https://github.com/mastra-ai/mastra/pull/7956))
+
+- Updated dependencies [[`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689)]:
+  - @mastra/core@0.17.0-alpha.7
+  - @mastra/client-js@0.13.0-alpha.7
+
 ## 6.2.0-alpha.3
 
 ### Minor Changes
@@ -276,27 +298,5 @@
 - Updated dependencies [f643c65]
 - Updated dependencies [00c74e7]
 - Updated dependencies [fef7375]
-- Updated dependencies [e3d8fea]
-- Updated dependencies [45e4d39]
-- Updated dependencies [9eee594]
-- Updated dependencies [7149d8d]
-- Updated dependencies [822c2e8]
-- Updated dependencies [979912c]
-- Updated dependencies [7dcf4c0]
-- Updated dependencies [4106a58]
-- Updated dependencies [ad78bfc]
-- Updated dependencies [48f0742]
-- Updated dependencies [0302f50]
-- Updated dependencies [6ac697e]
-- Updated dependencies [74db265]
-- Updated dependencies [0ce418a]
-- Updated dependencies [af90672]
-- Updated dependencies [8387952]
-- Updated dependencies [7f3b8da]
-- Updated dependencies [905352b]
-- Updated dependencies [599d04c]
-- Updated dependencies [56041d0]
-- Updated dependencies [3412597]
-- Updated dependencies [5eca5d2]
-
-... 3015 more lines hidden. See full changelog in package directory.
+
+... 3037 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,19 @@
 # @mastra/server
 
+## 0.17.0-alpha.8
+
+### Patch Changes
+
+- Updated dependencies [[`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a)]:
+  - @mastra/core@0.17.0-alpha.8
+
+## 0.17.0-alpha.7
+
+### Patch Changes
+
+- Updated dependencies [[`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689)]:
+  - @mastra/core@0.17.0-alpha.7
+
 ## 0.17.0-alpha.6
 
 ### Minor Changes
@@ -284,19 +298,5 @@
 - [#7394](https://github.com/mastra-ai/mastra/pull/7394) [`f0dfcac`](https://github.com/mastra-ai/mastra/commit/f0dfcac4458bdf789b975e2d63e984f5d1e7c4d3) Thanks [@NikAiyer](https://github.com/NikAiyer)! - updated core peerdep
 
 - Updated dependencies [[`7149d8d`](https://github.com/mastra-ai/mastra/commit/7149d8d4bdc1edf0008e0ca9b7925eb0b8b60dbe)]:
-  - @mastra/core@0.15.3-alpha.7
-
-## 0.15.3-alpha.6
-
-### Patch Changes
-
-- [#7388](https://github.com/mastra-ai/mastra/pull/7388) [`03d0c39`](https://github.com/mastra-ai/mastra/commit/03d0c3963a748294577dd232a53ee01e1e5bcc12) Thanks [@NikAiyer](https://github.com/NikAiyer)! - temp disable agent-builder workflows import
-
-- Updated dependencies [[`c19bcf7`](https://github.com/mastra-ai/mastra/commit/c19bcf7b43542b02157b5e17303e519933a153ab), [`b42a961`](https://github.com/mastra-ai/mastra/commit/b42a961a5aefd19d6e938a7705fc0ecc90e8f756), [`45e4d39`](https://github.com/mastra-ai/mastra/commit/45e4d391a2a09fc70c48e4d60f505586ada1ba0e), [`0302f50`](https://github.com/mastra-ai/mastra/commit/0302f50861a53c66ff28801fc371b37c5f97e41e), [`74db265`](https://github.com/mastra-ai/mastra/commit/74db265b96aa01a72ffd91dcae0bc3b346cca0f2), [`7f3b8da`](https://github.com/mastra-ai/mastra/commit/7f3b8da6dd21c35d3672e44b4f5dd3502b8f8f92), [`905352b`](https://github.com/mastra-ai/mastra/commit/905352bcda134552400eb252bca1cb05a7975c14), [`f2cda47`](https://github.com/mastra-ai/mastra/commit/f2cda47ae911038c5d5489f54c36517d6f15bdcc), [`cfd377a`](https://github.com/mastra-ai/mastra/commit/cfd377a3a33a9c88b644f6540feed9cd9832db47)]:
-  - @mastra/core@0.15.3-alpha.6
-
-## 0.15.3-alpha.5
-
-### Patch Changes
 
-... 3363 more lines hidden. See full changelog in package directory.
+... 3377 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/create-mastra.md

@@ -1,5 +1,7 @@
 # create-mastra
 
+## 0.13.0-alpha.5
+
 ## 0.13.0-alpha.4
 
 ### Patch Changes
@@ -296,7 +298,5 @@
 - d8dec5e: add a cta to invite to deploy to cloud
 - 89d2f4e: add TTS to the playground
 
-## 0.10.13
-
 
-... 1412 more lines hidden. See full changelog in package directory.
+... 1414 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,15 @@
 # mastra
 
+## 0.13.0-alpha.5
+
+### Patch Changes
+
+- fix error message when fetching observability things ([#7956](https://github.com/mastra-ai/mastra/pull/7956))
+
+- Updated dependencies [[`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689)]:
+  - @mastra/core@0.17.0-alpha.7
+  - @mastra/deployer@0.17.0-alpha.7
+
 ## 0.13.0-alpha.4
 
 ### Patch Changes
@@ -288,15 +298,5 @@
 - 6f715fe: Fix plyground baseUrl, default api baseUrl to playground baseUrl
 - 01264f1: Mastra dev- load env vars before watch
 - 3308c9f: fix dev:playground command
-- d99baf6: change outline
-- 8f22a2c: During package installation do not print audit, funding or any non-error logs
-- Updated dependencies [ab48c97]
-- Updated dependencies [3e0bd2a]
-- Updated dependencies [2b64943]
-- Updated dependencies [85ef90b]
-- Updated dependencies [aedbbfa]
-- Updated dependencies [ff89505]
-- Updated dependencies [637f323]
-- Updated dependencies [de3cbc6]
-
-... 5569 more lines hidden. See full changelog in package directory.
+
+... 5579 more lines hidden. See full changelog in package directory.

package/.docs/raw/agents/input-processors.mdx

@@ -37,7 +37,7 @@ const agent = new Agent({
 
 Available options:
 - `stripControlChars`: Remove control characters (default: false)
-- `preserveEmojis`: Keep emojis intact (default: true) 
+- `preserveEmojis`: Keep emojis intact (default: true)
 - `collapseWhitespace`: Collapse multiple spaces/newlines (default: true)
 - `trim`: Remove leading/trailing whitespace (default: true)
 
@@ -184,11 +184,11 @@ You can chain multiple processors. They execute sequentially in the order they a
 
 ```typescript copy showLineNumbers {9-18}
 import { Agent } from "@mastra/core/agent";
-import { 
-  UnicodeNormalizer, 
-  ModerationProcessor, 
+import {
+  UnicodeNormalizer,
+  ModerationProcessor,
   PromptInjectionDetector,
-  PIIDetector 
+  PIIDetector
 } from "@mastra/core/processors";
 
 const secureAgent = new Agent({
@@ -209,17 +209,19 @@ const secureAgent = new Agent({
 
 You can create custom processors by implementing the `Processor` interface. A Processor can be used for input processing when it implements the `processInput` method.
 
-```typescript copy showLineNumbers {4-19,23-26}
-import type { Processor, MastraMessageV2, TripWire } from "@mastra/core/processors";
+```typescript copy showLineNumbers {5,10-33,39}
+import type { Processor } from "@mastra/core/processors";
+import type { MastraMessageV2 } from "@mastra/core/agent/message-list";
+import { TripWire } from "@mastra/core/agent";
 
 class MessageLengthLimiter implements Processor {
   readonly name = 'message-length-limiter';
-  
+
   constructor(private maxLength: number = 1000) {}
 
-  processInput({ messages, abort }: { 
-    messages: MastraMessageV2[]; 
-    abort: (reason?: string) => never 
+  processInput({ messages, abort }: {
+    messages: MastraMessageV2[];
+    abort: (reason?: string) => never
   }): MastraMessageV2[] {
     // Check total message length
     try {
@@ -228,7 +230,7 @@ class MessageLengthLimiter implements Processor {
           .filter(part => part.type === 'text')
           .reduce((partSum, part) => partSum + (part as any).text.length, 0);
       }, 0);
-      
+
       if (totalLength > this.maxLength) {
         abort(`Message too long: ${totalLength} characters (max: ${this.maxLength})`); // throws a TripWire error
       }
@@ -238,7 +240,7 @@ class MessageLengthLimiter implements Processor {
       }
       throw new Error(`Length validation failed: ${error instanceof Error ? error.message : 'Unknown error'}`); // application level throw a standard error
     }
-    
+
     return messages;
   }
 }
@@ -279,4 +281,4 @@ If any processor calls `abort()`, the request terminates immediately and subsequ
 
 While input processors handle user messages before they reach the language model, **output processors** handle the LLM's responses after generation but before they're returned to the user. This is useful for response validation, content filtering, and safety controls on LLM-generated content.
 
-See the [Output Processors documentation](/docs/agents/output-processors) for details on processing LLM responses. 
+See the [Output Processors documentation](/docs/agents/output-processors) for details on processing LLM responses.

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

@@ -20,9 +20,10 @@ The dependency injection system allows you to:
 
 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
+```typescript {7-8,15} filename="src/mastra/agents/test-weather-agent.ts" showLineNumbers copy
 import { openai } from "@ai-sdk/openai";
 import { Agent } from "@mastra/core/agent";
+import { testWeatherTool } from "../tools/test-weather-tool";
 
 export const testWeatherAgent = new Agent({
   name: "test-weather-agent",
@@ -38,7 +39,47 @@ export const testWeatherAgent = new Agent({
     - If no city is mentioned, ask for a city name
     `;
   },
-  model: openai("gpt-4o-mini")
+  model: openai("gpt-4o-mini"),
+  tools: { testWeatherTool }
+});
+```
+
+### Example tool
+
+This tool exports a `WeatherRuntimeContext` type, which can be used anywhere `RuntimeContext` is used to enable type-safe access to runtime configuration.
+
+```typescript {4-6} filename="src/mastra/tools/test-weather-tool.ts" showLineNumbers copy
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+
+export type WeatherRuntimeContext = {
+  "temperature-unit": "celsius" | "fahrenheit";
+};
+
+export const testWeatherTool = createTool({
+  id: "test-weather-tool",
+  description: "Get weather for a location",
+  inputSchema: z.object({
+    location: z.string()
+  }),
+  outputSchema: z.object({
+    metric: z.string(),
+    temperature: z.number(),
+    weather: z.string()
+  }),
+  execute: async ({ context, runtimeContext }) => {
+    const { location } = context;
+    const unit = runtimeContext.get("temperature-unit") as WeatherRuntimeContext["temperature-unit"];
+
+    const temperature = 30;
+    const weather = "Sunny";
+
+    return {
+      metric: unit === "celsius" ? "°C" : "°F",
+      temperature,
+      weather
+    };
+  }
 });
 ```
 
@@ -46,16 +87,13 @@ export const testWeatherAgent = new Agent({
 
 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
+```typescript {9, 12} filename="src/test-weather-agent.ts" showLineNumbers copy
 import { mastra } from "./mastra";
 import { RuntimeContext } from "@mastra/core/runtime-context";
+import { WeatherRuntimeContext } from "./mastra/tools/test-weather-tool";
 
 const agent = mastra.getAgent("testWeatherAgent");
 
-export type WeatherRuntimeContext = {
-  "temperature-unit": "celsius" | "fahrenheit";
-};
-
 const runtimeContext = new RuntimeContext<WeatherRuntimeContext>();
 
 runtimeContext.set("temperature-unit", "fahrenheit");
@@ -71,14 +109,11 @@ console.log(response.text);
 
 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
+```typescript {2,4,9-18} 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";
-};
+import { WeatherRuntimeContext } from "./mastra/tools/test-weather-tool";
 
 export const mastra = new Mastra({
   agents: { testWeatherAgent },

package/.docs/raw/reference/streaming/agents/MastraModelOutput.mdx

@@ -124,7 +124,7 @@ These properties resolve to final values after the stream completes:
     },
     {
       name: "usage",
-      type: "Promise<Record<string, number>>",
+      type: "Promise<LanguageModelUsage>",
       description: "Token usage statistics including input tokens, output tokens, total tokens, and reasoning tokens (for reasoning models).",
       properties: [{
         type: "Record",
@@ -133,6 +133,7 @@ These properties resolve to final values after the stream completes:
           { name: "outputTokens", type: "number", description: "Tokens generated in the response" },
           { name: "totalTokens", type: "number", description: "Sum of input and output tokens" },
           { name: "reasoningTokens", type: "number", isOptional: true, description: "Hidden reasoning tokens (for reasoning models)" }
+          { name: "cachedInputTokens", type: "number", isOptional: true, description: "Number of input tokens that were a cache hit" }
         ]
       }]
     },

package/.docs/raw/reference/streaming/workflows/streamVNext.mdx

@@ -63,7 +63,7 @@ const stream = run.streamVNext({
     },
     {
       name: "stream.usage",
-      type: "Promise<{ promptTokens: number; completionTokens: number; totalTokens: number }>",
+      type: "Promise<{ inputTokens: number; outputTokens: number; totalTokens: number, reasoningTokens?: number, cacheInputTokens?: number }>",
       description: "A promise that resolves to token usage statistics",
     },
   ]}

package/.docs/raw/streaming/overview.mdx

@@ -63,6 +63,8 @@ An agent stream provides access to various response properties:
 
 ### AI SDK v5 Compatibility
 
+AI SDK v5 uses `LanguageModelV2` for the model providers. If you are getting an error that you are using an AI SDK v4 model you will need to upgrade your model package to the next major version.
+
 For integration with AI SDK v5, use `format` 'aisdk' to get an `AISDKV5OutputStream`:
 
 ```typescript {5} showLineNumbers copy

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 0.13.22-alpha.8
+
+### Patch Changes
+
+- Updated dependencies [[`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a)]:
+  - @mastra/core@0.17.0-alpha.8
+
+## 0.13.22-alpha.7
+
+### Patch Changes
+
+- Updated dependencies [[`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689)]:
+  - @mastra/core@0.17.0-alpha.7
+
 ## 0.13.22-alpha.6
 
 ### Patch Changes

package/package.json

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