@mastra/mcp-docs-server 0.13.20 → 0.13.21-alpha.0

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

@@ -1,5 +1,14 @@
 # @mastra/pg
 
+## 0.15.2-alpha.0
+
+### Patch Changes
+
+- remove debug logs ([#7708](https://github.com/mastra-ai/mastra/pull/7708))
+
+- Updated dependencies [[`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`dd9119b`](https://github.com/mastra-ai/mastra/commit/dd9119b175a8f389082f75c12750e51f96d65dca), [`d34aaa1`](https://github.com/mastra-ai/mastra/commit/d34aaa1da5d3c5f991740f59e2fe6d28d3e2dd91), [`ce1e580`](https://github.com/mastra-ai/mastra/commit/ce1e580f6391e94a0c6816a9c5db0a21566a262f), [`b2babfa`](https://github.com/mastra-ai/mastra/commit/b2babfa9e75b22f2759179e71d8473f6dc5421ed), [`d8c3ba5`](https://github.com/mastra-ai/mastra/commit/d8c3ba516f4173282d293f7e64769cfc8738d360), [`a566c4e`](https://github.com/mastra-ai/mastra/commit/a566c4e92d86c1671707c54359b1d33934f7cc13), [`af333aa`](https://github.com/mastra-ai/mastra/commit/af333aa30fe6d1b127024b03a64736c46eddeca2), [`3863c52`](https://github.com/mastra-ai/mastra/commit/3863c52d44b4e5779968b802d977e87adf939d8e), [`6424c7e`](https://github.com/mastra-ai/mastra/commit/6424c7ec38b6921d66212431db1e0958f441b2a7), [`db94750`](https://github.com/mastra-ai/mastra/commit/db94750a41fd29b43eb1f7ce8e97ba8b9978c91b), [`a66a371`](https://github.com/mastra-ai/mastra/commit/a66a3716b00553d7f01842be9deb34f720b10fab), [`69fc3cd`](https://github.com/mastra-ai/mastra/commit/69fc3cd0fd814901785bdcf49bf536ab1e7fd975)]:
+  - @mastra/core@0.16.3-alpha.0
+
 ## 0.15.1
 
 ### Patch Changes
@@ -290,13 +299,4 @@
 
 ## 0.13.3-alpha.0
 
-### Patch Changes
-
-- 3e49b7a: Fix PostgreSQL vector metadata filtering for Memory system - changed default minScore to -1 to include all similarity results and added comprehensive metadata filtering tests
-- Updated dependencies [cd0042e]
-  - @mastra/core@0.13.1-alpha.0
-
-## 0.13.2
-
-
-... 2283 more lines hidden. See full changelog in package directory.
+... 2292 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,25 @@
 # @mastra/playground-ui
 
+## 6.1.3-alpha.0
+
+### Patch Changes
+
+- AN packages ([#7711](https://github.com/mastra-ai/mastra/pull/7711))
+
+- fix playground UI issue about dynmic workflow exec in agent thread ([#7665](https://github.com/mastra-ai/mastra/pull/7665))
+
+- Updated dependencies [[`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`dd9119b`](https://github.com/mastra-ai/mastra/commit/dd9119b175a8f389082f75c12750e51f96d65dca), [`d34aaa1`](https://github.com/mastra-ai/mastra/commit/d34aaa1da5d3c5f991740f59e2fe6d28d3e2dd91), [`ce1e580`](https://github.com/mastra-ai/mastra/commit/ce1e580f6391e94a0c6816a9c5db0a21566a262f), [`b2babfa`](https://github.com/mastra-ai/mastra/commit/b2babfa9e75b22f2759179e71d8473f6dc5421ed), [`d8c3ba5`](https://github.com/mastra-ai/mastra/commit/d8c3ba516f4173282d293f7e64769cfc8738d360), [`a566c4e`](https://github.com/mastra-ai/mastra/commit/a566c4e92d86c1671707c54359b1d33934f7cc13), [`0666082`](https://github.com/mastra-ai/mastra/commit/06660820230dcb1fa7c1d51c8254107afd68cd67), [`af333aa`](https://github.com/mastra-ai/mastra/commit/af333aa30fe6d1b127024b03a64736c46eddeca2), [`3863c52`](https://github.com/mastra-ai/mastra/commit/3863c52d44b4e5779968b802d977e87adf939d8e), [`6424c7e`](https://github.com/mastra-ai/mastra/commit/6424c7ec38b6921d66212431db1e0958f441b2a7), [`db94750`](https://github.com/mastra-ai/mastra/commit/db94750a41fd29b43eb1f7ce8e97ba8b9978c91b), [`a66a371`](https://github.com/mastra-ai/mastra/commit/a66a3716b00553d7f01842be9deb34f720b10fab), [`779d469`](https://github.com/mastra-ai/mastra/commit/779d469366bb9f7fcb6d1638fdabb9f3acc49218), [`69fc3cd`](https://github.com/mastra-ai/mastra/commit/69fc3cd0fd814901785bdcf49bf536ab1e7fd975)]:
+  - @mastra/core@0.16.3-alpha.0
+  - @mastra/client-js@0.12.3-alpha.0
+
+## 6.1.2
+
+### Patch Changes
+
+- Updated dependencies [[`61926ef`](https://github.com/mastra-ai/mastra/commit/61926ef40d415b805a63527cffe27a50542e15e5)]:
+  - @mastra/core@0.16.2
+  - @mastra/client-js@0.12.2
+
 ## 6.1.2-alpha.0
 
 ### Patch Changes
@@ -278,25 +298,5 @@
 
 ### Patch Changes
 
-- [`95b2aa9`](https://github.com/mastra-ai/mastra/commit/95b2aa908230919e67efcac0d69005a2d5745298) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix peerdeps @mastra/core
-
-- Updated dependencies []:
-  - @mastra/core@0.15.1
-  - @mastra/client-js@0.11.1
-
-## 5.2.2
-
-### Patch Changes
-
-- [#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
-
-- [#6967](https://github.com/mastra-ai/mastra/pull/6967) [`01be5d3`](https://github.com/mastra-ai/mastra/commit/01be5d358fad8faa101e5c69dfa54562c02cc0af) Thanks [@YujohnNattrass](https://github.com/YujohnNattrass)! - Implement AI traces for server apis and client sdk
-
-- [#6944](https://github.com/mastra-ai/mastra/pull/6944) [`a93f3ba`](https://github.com/mastra-ai/mastra/commit/a93f3ba05eef4cf17f876d61d29cf0841a9e70b7) Thanks [@wardpeet](https://github.com/wardpeet)! - Add support for zod v4
-
-- Updated dependencies [[`0778757`](https://github.com/mastra-ai/mastra/commit/07787570e4addbd501522037bd2542c3d9e26822), [`943a7f3`](https://github.com/mastra-ai/mastra/commit/943a7f3dbc6a8ab3f9b7bc7c8a1c5b319c3d7f56), [`01be5d3`](https://github.com/mastra-ai/mastra/commit/01be5d358fad8faa101e5c69dfa54562c02cc0af), [`bf504a8`](https://github.com/mastra-ai/mastra/commit/bf504a833051f6f321d832cc7d631f3cb86d657b), [`00ef6c1`](https://github.com/mastra-ai/mastra/commit/00ef6c1d3c76708712acd3de7f39c4d6b0f3b427), [`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), [`e6f5046`](https://github.com/mastra-ai/mastra/commit/e6f50467aff317e67e8bd74c485c3fbe2a5a6db1), [`82d9f64`](https://github.com/mastra-ai/mastra/commit/82d9f647fbe4f0177320e7c05073fce88599aa95), [`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6), [`1191ce9`](https://github.com/mastra-ai/mastra/commit/1191ce946b40ed291e7877a349f8388e3cff7e5c), [`4189486`](https://github.com/mastra-ai/mastra/commit/4189486c6718fda78347bdf4ce4d3fc33b2236e1), [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01), [`9613558`](https://github.com/mastra-ai/mastra/commit/9613558e6475f4710e05d1be7553a32ee7bddc20)]:
-  - @mastra/core@0.15.0
-  - @mastra/client-js@0.11.0
-
 
-... 2897 more lines hidden. See full changelog in package directory.
+... 2917 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md

@@ -1,5 +1,11 @@
 # @mastra/schema-compat
 
+## 0.11.3-alpha.0
+
+### Patch Changes
+
+- Change SchemaCompat zodToJsonSchema ref strategy from none to relative, leading to less schema warnings and smaller converted schema sizes ([#7697](https://github.com/mastra-ai/mastra/pull/7697))
+
 ## 0.11.2
 
 ### Patch Changes

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

@@ -1,5 +1,21 @@
 # @mastra/server
 
+## 0.16.3-alpha.0
+
+### Patch Changes
+
+- an part 3 ([#7705](https://github.com/mastra-ai/mastra/pull/7705))
+
+- Updated dependencies [[`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`dd9119b`](https://github.com/mastra-ai/mastra/commit/dd9119b175a8f389082f75c12750e51f96d65dca), [`d34aaa1`](https://github.com/mastra-ai/mastra/commit/d34aaa1da5d3c5f991740f59e2fe6d28d3e2dd91), [`ce1e580`](https://github.com/mastra-ai/mastra/commit/ce1e580f6391e94a0c6816a9c5db0a21566a262f), [`b2babfa`](https://github.com/mastra-ai/mastra/commit/b2babfa9e75b22f2759179e71d8473f6dc5421ed), [`d8c3ba5`](https://github.com/mastra-ai/mastra/commit/d8c3ba516f4173282d293f7e64769cfc8738d360), [`a566c4e`](https://github.com/mastra-ai/mastra/commit/a566c4e92d86c1671707c54359b1d33934f7cc13), [`af333aa`](https://github.com/mastra-ai/mastra/commit/af333aa30fe6d1b127024b03a64736c46eddeca2), [`3863c52`](https://github.com/mastra-ai/mastra/commit/3863c52d44b4e5779968b802d977e87adf939d8e), [`6424c7e`](https://github.com/mastra-ai/mastra/commit/6424c7ec38b6921d66212431db1e0958f441b2a7), [`db94750`](https://github.com/mastra-ai/mastra/commit/db94750a41fd29b43eb1f7ce8e97ba8b9978c91b), [`a66a371`](https://github.com/mastra-ai/mastra/commit/a66a3716b00553d7f01842be9deb34f720b10fab), [`69fc3cd`](https://github.com/mastra-ai/mastra/commit/69fc3cd0fd814901785bdcf49bf536ab1e7fd975)]:
+  - @mastra/core@0.16.3-alpha.0
+
+## 0.16.2
+
+### Patch Changes
+
+- Updated dependencies [[`61926ef`](https://github.com/mastra-ai/mastra/commit/61926ef40d415b805a63527cffe27a50542e15e5)]:
+  - @mastra/core@0.16.2
+
 ## 0.16.2-alpha.0
 
 ### Patch Changes
@@ -283,20 +299,4 @@
 
 ## 0.15.0-alpha.4
 
-### 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
-
-### Patch Changes
-
-- Updated dependencies [[`1191ce9`](https://github.com/mastra-ai/mastra/commit/1191ce946b40ed291e7877a349f8388e3cff7e5c)]:
-  - @mastra/core@0.15.0-alpha.4
-
-## 0.15.0-alpha.3
-
-### Minor Changes
-
-- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
-
-
-... 3256 more lines hidden. See full changelog in package directory.
+... 3272 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,9 @@
 # create-mastra
 
+## 0.12.3-alpha.0
+
+## 0.12.2
+
 ## 0.12.2-alpha.0
 
 ## 0.12.1
@@ -294,9 +298,5 @@
 
 ## 0.10.13-alpha.0
 
-### Patch Changes
-
-- 0bf0bc8: fix link in shared components + add e2e tests
-- 7827943: Handle streaming large data
 
-... 1370 more lines hidden. See full changelog in package directory.
+... 1374 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,25 @@
 # mastra
 
+## 0.12.3-alpha.0
+
+### Patch Changes
+
+- Add new scorers to list ([#7614](https://github.com/mastra-ai/mastra/pull/7614))
+
+- fix playground UI issue about dynmic workflow exec in agent thread ([#7665](https://github.com/mastra-ai/mastra/pull/7665))
+
+- Updated dependencies [[`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`dd9119b`](https://github.com/mastra-ai/mastra/commit/dd9119b175a8f389082f75c12750e51f96d65dca), [`d34aaa1`](https://github.com/mastra-ai/mastra/commit/d34aaa1da5d3c5f991740f59e2fe6d28d3e2dd91), [`ce1e580`](https://github.com/mastra-ai/mastra/commit/ce1e580f6391e94a0c6816a9c5db0a21566a262f), [`b2babfa`](https://github.com/mastra-ai/mastra/commit/b2babfa9e75b22f2759179e71d8473f6dc5421ed), [`d8c3ba5`](https://github.com/mastra-ai/mastra/commit/d8c3ba516f4173282d293f7e64769cfc8738d360), [`a566c4e`](https://github.com/mastra-ai/mastra/commit/a566c4e92d86c1671707c54359b1d33934f7cc13), [`0666082`](https://github.com/mastra-ai/mastra/commit/06660820230dcb1fa7c1d51c8254107afd68cd67), [`af333aa`](https://github.com/mastra-ai/mastra/commit/af333aa30fe6d1b127024b03a64736c46eddeca2), [`3863c52`](https://github.com/mastra-ai/mastra/commit/3863c52d44b4e5779968b802d977e87adf939d8e), [`6424c7e`](https://github.com/mastra-ai/mastra/commit/6424c7ec38b6921d66212431db1e0958f441b2a7), [`db94750`](https://github.com/mastra-ai/mastra/commit/db94750a41fd29b43eb1f7ce8e97ba8b9978c91b), [`a66a371`](https://github.com/mastra-ai/mastra/commit/a66a3716b00553d7f01842be9deb34f720b10fab), [`69fc3cd`](https://github.com/mastra-ai/mastra/commit/69fc3cd0fd814901785bdcf49bf536ab1e7fd975)]:
+  - @mastra/core@0.16.3-alpha.0
+  - @mastra/deployer@0.16.3-alpha.0
+
+## 0.12.2
+
+### Patch Changes
+
+- Updated dependencies [[`61926ef`](https://github.com/mastra-ai/mastra/commit/61926ef40d415b805a63527cffe27a50542e15e5)]:
+  - @mastra/core@0.16.2
+  - @mastra/deployer@0.16.2
+
 ## 0.12.2-alpha.0
 
 ### Patch Changes
@@ -278,25 +298,5 @@
 
 - [#7044](https://github.com/mastra-ai/mastra/pull/7044) [`3308c9f`](https://github.com/mastra-ai/mastra/commit/3308c9ff1da7594925d193a825f33da2880fb9c1) Thanks [@mfrachet](https://github.com/mfrachet)! - fix dev:playground command
 
-- [#7101](https://github.com/mastra-ai/mastra/pull/7101) [`d99baf6`](https://github.com/mastra-ai/mastra/commit/d99baf6e69bbf83e9a286fbd18c47543de12cb58) Thanks [@mfrachet](https://github.com/mfrachet)! - change outline
-
-- Updated dependencies [[`00c74e7`](https://github.com/mastra-ai/mastra/commit/00c74e73b1926be0d475693bb886fb67a22ff352), [`6f715fe`](https://github.com/mastra-ai/mastra/commit/6f715fe524296e1138a319e56bcf8e4214bd5dd5), [`3e0153a`](https://github.com/mastra-ai/mastra/commit/3e0153adcf2309f3ffb01c9ac9e0f5adc0caa259), [`af90672`](https://github.com/mastra-ai/mastra/commit/af906722d8da28688882193b1e531026f9e2e81e), [`a6e2254`](https://github.com/mastra-ai/mastra/commit/a6e225469159950bb69e8d240d510ec57dc0d79a), [`56041d0`](https://github.com/mastra-ai/mastra/commit/56041d018863a3da6b98c512e47348647c075fb3), [`5de1555`](https://github.com/mastra-ai/mastra/commit/5de15554d3d6695211945a36928f6657e76cddc9), [`1ed5a3e`](https://github.com/mastra-ai/mastra/commit/1ed5a3e19330374c4347a4237cd2f4b9ffb60376)]:
-  - @mastra/core@0.15.3-alpha.0
-  - @mastra/deployer@0.15.3-alpha.0
-  - @mastra/mcp@0.11.3-alpha.0
-
-## 0.11.2
-
-### Patch Changes
-
-- [`c6113ed`](https://github.com/mastra-ai/mastra/commit/c6113ed7f9df297e130d94436ceee310273d6430) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix peerdpes for @mastra/core
-
-- Updated dependencies [[`c6113ed`](https://github.com/mastra-ai/mastra/commit/c6113ed7f9df297e130d94436ceee310273d6430)]:
-  - @mastra/deployer@0.15.2
-  - @mastra/loggers@0.10.9
-  - @mastra/mcp@0.11.2
-  - @mastra/core@0.15.2
-
-## 0.11.1
 
-... 5428 more lines hidden. See full changelog in package directory.
+... 5448 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/agent.md

@@ -757,6 +757,32 @@ export const chefModelV2Agent = new Agent({
   memory,
 });
 
+const weatherAgent = new Agent({
+  name: 'Weather Agent',
+  instructions: `You are a weather agent that can help you get weather information for a given city`,
+  description: `An agent that can help you get weather information for a given city`,
+  model: openai_v5('gpt-4o-mini'),
+  tools: { weatherInfo },
+  workflows: {
+    myWorkflow,
+  },
+});
+
+export const networkAgent = new Agent({
+  name: 'Chef Network',
+  description:
+    'A chef agent that can help you cook great meals with whatever ingredients you have available based on your location and current weather.',
+  instructions: `You are a the manager of several agent, tools, and workflows. Use the best primitives based on what the user wants to accomplish your task.`,
+  model: openai_v5('gpt-4o-mini'),
+  workflows: {
+    myWorkflow,
+  },
+  agents: {
+    weatherAgent,
+  },
+  memory,
+});
+
 ```
 
 ### mastra/index.ts
@@ -768,7 +794,7 @@ import { LibSQLStore } from '@mastra/libsql';
 import { agentThatHarassesYou, chefAgent, chefAgentResponses, dynamicAgent, evalAgent } from './agents/index';
 import { myMcpServer, myMcpServerTwo } from './mcp/server';
 import { myWorkflow } from './workflows';
-import { chefModelV2Agent } from './agents/model-v2-agent';
+import { chefModelV2Agent, networkAgent } from './agents/model-v2-agent';
 import { createScorer } from '@mastra/core/scores';
 
 const storage = new LibSQLStore({
@@ -790,6 +816,7 @@ export const mastra = new Mastra({
     agentThatHarassesYou,
     evalAgent,
     chefModelV2Agent,
+    networkAgent,
   },
   logger: new PinoLogger({ name: 'Chef', level: 'debug' }),
   storage,
@@ -1078,7 +1105,7 @@ import { z } from 'zod';
 
 export const cookingTool = createTool({
   id: 'cooking-tool',
-  description: 'My cooking tool description',
+  description: 'Used to cook given an ingredient',
   inputSchema: z.object({
     ingredient: z.string(),
   }),
@@ -1099,8 +1126,8 @@ import { createStep, createWorkflow } from '@mastra/core/workflows';
 import { z } from 'zod';
 
 export const myWorkflow = createWorkflow({
-  id: 'my-workflow',
-  description: 'My workflow description',
+  id: 'recipe-maker',
+  description: 'Returns a recipe based on an ingredient',
   inputSchema: z.object({
     ingredient: z.string(),
   }),
@@ -1119,6 +1146,7 @@ const step = createStep({
     result: z.string(),
   }),
   execute: async ({ inputData }) => {
+    await new Promise(resolve => setTimeout(resolve, 3000));
     return {
       result: inputData.ingredient,
     };
@@ -1134,11 +1162,8 @@ const step2 = createStep({
   outputSchema: z.object({
     result: z.string(),
   }),
-  execute: async ({ inputData, mastra, tracingContext }) => {
-    const agent = mastra.getAgent('chefAgentResponses');
-    const response = await agent.generate(inputData.result, {
-      tracingContext,
-    });
+  execute: async () => {
+    await new Promise(resolve => setTimeout(resolve, 3000));
     return {
       result: 'suh',
     };

package/.docs/organized/code-examples/ai-sdk-v5.md

@@ -3,15 +3,15 @@
 {
   "name": "mastra-ai-sdk-v5-use-chat-example",
   "dependencies": {
-    "@ai-sdk/openai": "2.0.15",
-    "@ai-sdk/react": "2.0.15",
-    "@mastra/core": "0.16.0",
-    "@mastra/libsql": "0.14.0",
-    "@mastra/loggers": "0.10.11",
-    "@mastra/memory": "0.14.4",
-    "@mastra/pg": "0.15.0",
-    "@mastra/rag": "0.10.3",
-    "@mastra/server": "0.16.0",
+    "@ai-sdk/openai": "^2.0.28",
+    "@ai-sdk/react": "^2.0.39",
+    "@mastra/core": "latest",
+    "@mastra/libsql": "latest",
+    "@mastra/loggers": "latest",
+    "@mastra/memory": "latest",
+    "@mastra/pg": "latest",
+    "@mastra/rag": "latest",
+    "@mastra/server": "latest",
     "next": "15.4.7",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
@@ -25,7 +25,7 @@
     "@types/react-dom": "^19.1.7",
     "eslint": "^9",
     "eslint-config-next": "15.1.7",
-    "mastra": "0.12.0",
+    "mastra": "latest",
     "postcss": "^8",
     "tailwindcss": "^3.4.1",
     "typescript": "^5.8.3"
@@ -80,15 +80,17 @@ export const weatherAgent = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { ConsoleLogger } from "@mastra/core/logger";
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
+import { PinoLogger } from "@mastra/loggers";
 
 import { weatherAgent } from "./agents";
 
 export const mastra = new Mastra({
   agents: { weatherAgent },
-  logger: new ConsoleLogger(),
-  // aiSdkCompat: "v4",
+  logger: new PinoLogger({
+    name: "Mastra",
+    level: "info",
+  }),
 });
 
 ```

package/.docs/organized/code-examples/heads-up-game.md

@@ -7,15 +7,15 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^1.3.23",
-    "@mastra/core": "^0.16.0",
+    "@mastra/core": "^0.16.2",
     "@mastra/libsql": "^0.14.0",
     "@mastra/loggers": "^0.10.11",
-    "@mastra/memory": "^0.14.4",
+    "@mastra/memory": "^0.15.0",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "mastra": "^0.12.0",
+    "mastra": "^0.12.2",
     "typescript": "^5.9.2"
   }
 }

package/.docs/raw/auth/clerk.mdx

@@ -0,0 +1,142 @@
+---
+title: "MastraAuthClerk Class"
+description: "Documentation for the MastraAuthClerk class, which authenticates Mastra applications using Clerk authentication."
+---
+
+import { Tabs, Tab } from "@/components/tabs";
+
+# MastraAuthClerk Class
+
+The `MastraAuthClerk` class provides authentication for Mastra using Clerk. It verifies incoming requests using Clerk's authentication system and integrates with the Mastra server using the `experimental_auth` option.
+
+## Prerequisites
+
+This example uses Clerk authentication. Make sure to add your Clerk credentials to your `.env` file and ensure your Clerk project is properly configured.
+
+```env filename=".env" copy
+CLERK_PUBLISHABLE_KEY=pk_test_...
+CLERK_SECRET_KEY=sk_test_...
+CLERK_JWKS_URI=https://your-clerk-domain.clerk.accounts.dev/.well-known/jwks.json
+```
+
+> **Note:** You can find these keys in your Clerk Dashboard under "API Keys".
+
+## Installation
+
+Before you can use the `MastraAuthClerk` class you have to install the `@mastra/clerk-auth` package.
+
+```bash copy
+npm install @mastra/clerk-auth@latest
+```
+
+## Usage example
+
+```typescript {2,7-11} filename="src/mastra/index.ts" showLineNumbers copy
+import { Mastra } from "@mastra/core/mastra";
+import { MastraAuthClerk } from '@mastra/clerk-auth';
+
+export const mastra = new Mastra({
+  // ..
+  server: {
+    experimental_auth: new MastraAuthClerk({
+      publishableKey: process.env.CLERK_PUBLISHABLE_KEY,
+      secretKey: process.env.CLERK_SECRET_KEY,
+      jwksUri: process.env.CLERK_JWKS_URI
+    }),
+  },
+});
+```
+
+> **Note:** The default `authorizeUser` method allows all authenticated users. To customize user authorization, provide a custom `authorizeUser` function when constructing the provider.
+
+> See the [MastraAuthClerk](/reference/auth/clerk.mdx) API reference for all available configuration options.
+
+## Client-side setup
+
+When using Clerk auth, you'll need to retrieve the access token from Clerk on the client side and pass it to your Mastra requests.
+
+### Retrieving the access token
+
+Use the Clerk React hooks to authenticate users and retrieve their access token:
+
+```typescript filename="lib/auth.ts" showLineNumbers copy
+import { useAuth } from "@clerk/nextjs";
+
+export const useClerkAuth = () => {
+  const { getToken } = useAuth();
+  
+  const getAccessToken = async () => {
+    const token = await getToken();
+    return token;
+  };
+  
+  return { getAccessToken };
+};
+```
+
+> Refer to the [Clerk documentation](https://clerk.com/docs) for more information.
+
+## Configuring `MastraClient`
+
+When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Clerk access token in the `Authorization` header:
+
+```typescript {6} filename="lib/mastra/mastra-client.ts" showLineNumbers copy
+import { MastraClient } from "@mastra/client-js";
+
+export const mastraClient = new MastraClient({
+  baseUrl: "https://<mastra-api-url>",
+  headers: {
+    Authorization: `Bearer ${accessToken}`
+  }
+});
+```
+
+> **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
+> See [Mastra Client SDK](/docs/server-db/mastra-client.mdx) for more configuration options.
+
+### Making authenticated requests
+
+Once `MastraClient` is configured with the Clerk access token, you can send authenticated requests:
+
+<Tabs items={["MastraClient", "curl"]}>
+  <Tab>
+    ```tsx filename="src/components/test-agent.tsx" showLineNumbers copy
+    "use client";
+
+    import { useAuth } from "@clerk/nextjs";
+    import { MastraClient } from "@mastra/client-js";
+
+    export const TestAgent = () => {
+      const { getToken } = useAuth();
+
+      async function handleClick() {
+        const token = await getToken();
+
+        const client = new MastraClient({
+          baseUrl: "http://localhost:4111",
+          headers: token ? { Authorization: `Bearer ${token}` } : undefined,
+        });
+
+        const weatherAgent = client.getAgent("weatherAgent");
+        const response = await weatherAgent.generate({
+          messages: "What's the weather like in New York",
+        });
+
+        console.log({ response });
+      }
+
+      return <button onClick={handleClick}>Test Agent</button>;
+    };
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
+      -H "Content-Type: application/json" \
+      -H "Authorization: Bearer <your-clerk-access-token>" \
+      -d '{
+        "messages": "Weather in London"
+      }'
+    ```
+  </Tab>
+</Tabs>

package/.docs/raw/getting-started/installation.mdx

@@ -228,7 +228,9 @@ touch tsconfig.json
 
 Add the following configuration:
 
-```json filename="tsconfig.json" copy
+Mastra requires `module` and `moduleResolution` values that support modern Node.js versions. Older settings like `CommonJS` or `node` are incompatible with Mastra’s packages and will cause resolution errors.
+
+```json {4-5} filename="tsconfig.json" copy
 {
   "compilerOptions": {
     "target": "ES2022",

package/.docs/raw/getting-started/model-providers.mdx

@@ -3,7 +3,7 @@ title: "Model Providers | Getting Started | Mastra Docs"
 description: "Learn how to configure and use different model providers with Mastra."
 ---
 
-import { Callout } from 'nextra/components'
+import { Callout } from "nextra/components"
 
 # Model Providers
 
@@ -62,18 +62,18 @@ Here's an example using the OpenAI provider:
 
 ```typescript showLineNumbers copy filename="src/mastra/agents/weather-agent.ts" {1,4-8,13}
 import { createOpenAI } from "@ai-sdk/openai";
-import { Agent } from "@mastra/core/agent"
+import { Agent } from "@mastra/core/agent";
 
 const openai = createOpenAI({
-    baseUrl: "<your-custom-base-url>",
-    apiKey: "<your-custom-api-key>",
-    ...otherOptions
+  baseUrl: "<your-custom-base-url>",
+  apiKey: "<your-custom-api-key>",
+  ...otherOptions,
 });
 
 const agent = new Agent({
-    name: "WeatherAgent",
-    instructions: "Instructions for the agent...",
-    model: openai("<model-name>"),
+  name: "WeatherAgent",
+  instructions: "Instructions for the agent...",
+  model: openai("<model-name>"),
 });
 ```
 
@@ -88,21 +88,21 @@ import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 import { Agent } from "@mastra/core/agent";
 
 const openaiCompatible = createOpenAICompatible({
-    name: "<model-name>",
-    baseUrl: "<base-url>",
-    apiKey: "<api-key>",
-    headers: {},
-    queryParams: {},
-    fetch: async (url, options) => {
-        // custom fetch logic
-        return fetch(url, options);
-    }
+  name: "<model-name>",
+  baseUrl: "<base-url>",
+  apiKey: "<api-key>",
+  headers: {},
+  queryParams: {},
+  fetch: async (url, options) => {
+    // custom fetch logic
+    return fetch(url, options);
+  },
 });
 
 const agent = new Agent({
-    name: "WeatherAgent",
-    instructions: "Instructions for the agent...",
-    model: openaiCompatible("<model-name>"),
+  name: "WeatherAgent",
+  instructions: "Instructions for the agent...",
+  model: openaiCompatible("<model-name>"),
 });
 ```
 
@@ -114,36 +114,36 @@ The AI SDK provides a [Language Model Specification](https://github.com/vercel/a
 Following this specification, you can create your own model provider compatible with the AI SDK.
 
 Some community providers have implemented this specification and are compatible with the AI SDK.
-We will look at one such provider, the Ollama provider available in the [`ollama-ai-provider`](https://github.com/sgomez/ollama-ai-provider) package.
+We will look at one such provider, the Ollama provider available in the [`ollama-ai-provider-v2`](https://github.com/nordwestt/ollama-ai-provider-v2) package.
 
 Here's an example:
 
 ```typescript showLineNumbers copy filename="src/mastra/agents/weather-agent.ts" {1,7}
-import { ollama } from "ollama-ai-provider";
+import { ollama } from "ollama-ai-provider-v2";
 import { Agent } from "@mastra/core/agent";
 
 const agent = new Agent({
-    name: "WeatherAgent",
-    instructions: "Instructions for the agent...",
-    model: ollama("llama3.2:latest"),
+  name: "WeatherAgent",
+  instructions: "Instructions for the agent...",
+  model: ollama("llama3.2:latest"),
 });
 ```
 
 You can also configure the Ollama provider like so:
 
 ```typescript showLineNumbers copy filename="src/mastra/agents/weather-agent.ts" {1,4-7,12}
-import { createOllama } from "ollama-ai-provider";
+import { createOllama } from "ollama-ai-provider-v2";
 import { Agent } from "@mastra/core/agent";
 
 const ollama = createOllama({
-    baseUrl: "<your-custom-base-url>",
-    ...otherOptions,
+  baseUrl: "<your-custom-base-url>",
+  ...otherOptions,
 });
 
 const agent = new Agent({
-    name: "WeatherAgent",
-    instructions: "Instructions for the agent...",
-    model: ollama("llama3.2:latest"),
+  name: "WeatherAgent",
+  instructions: "Instructions for the agent...",
+  model: ollama("llama3.2:latest"),
 });
 ```