@mastra/mcp-docs-server 0.13.26 → 0.13.27

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

@@ -1,5 +1,67 @@
 # mastra
 
+## 0.14.0-alpha.0
+
+### Minor Changes
+
+- Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
+
+### Patch Changes
+
+- Remove log drains UI from the playground ([#8379](https://github.com/mastra-ai/mastra/pull/8379))
+
+- add refetch interval to traces to make it feel "instant" ([#8386](https://github.com/mastra-ai/mastra/pull/8386))
+
+- better memory message ([#8382](https://github.com/mastra-ai/mastra/pull/8382))
+
+- Add doc url to netlify gateway ([#8356](https://github.com/mastra-ai/mastra/pull/8356))
+
+- fix codeblock line number color contrast for legacy traces ([#8385](https://github.com/mastra-ai/mastra/pull/8385))
+
+- Model router documentation and playground UI improvements ([#8372](https://github.com/mastra-ai/mastra/pull/8372))
+
+  **Documentation generation (`@mastra/core`):**
+  - Fixed inverted dynamic model selection logic in provider examples
+  - Improved copy: replaced marketing language with action-oriented descriptions
+  - Added generated file comments with timestamps to all MDX outputs so maintainers know not to directly edit generated files
+
+  **Playground UI model picker (`@mastra/playground-ui`):**
+  - Fixed provider field clearing when typing in model input
+  - Added responsive layout (stacks on mobile, side-by-side on desktop)
+  - Improved general styling of provider/model pickers
+
+  **Environment variables (`@mastra/deployer`):**
+  - Properly handle array of env vars (e.g., NETLIFY_TOKEN, NETLIFY_SITE_ID)
+  - Added correct singular/plural handling for "environment variable(s)"
+
+- fix playground message history initial state for v1 models ([#8427](https://github.com/mastra-ai/mastra/pull/8427))
+
+- show thread list in desc order ([#8381](https://github.com/mastra-ai/mastra/pull/8381))
+
+- Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
+
+- Fix shell option breaking server start on windows env ([#8377](https://github.com/mastra-ai/mastra/pull/8377))
+
+- Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
+
+- Updated dependencies [[`00cb6bd`](https://github.com/mastra-ai/mastra/commit/00cb6bdf78737c0fac14a5a0c7b532a11e38558a), [`869ba22`](https://github.com/mastra-ai/mastra/commit/869ba222e1d6b58fc1b65e7c9fd55ca4e01b8c2f), [`1b73665`](https://github.com/mastra-ai/mastra/commit/1b73665e8e23f5c09d49fcf3e7d709c75259259e), [`989a4db`](https://github.com/mastra-ai/mastra/commit/989a4dbbaf07a2794d0e1863714c6d10f1244d6b), [`f7d7475`](https://github.com/mastra-ai/mastra/commit/f7d747507341aef60ed39e4b49318db1f86034a6), [`084b77b`](https://github.com/mastra-ai/mastra/commit/084b77b2955960e0190af8db3f77138aa83ed65c), [`a93ff84`](https://github.com/mastra-ai/mastra/commit/a93ff84b5e1af07ee236ac8873dac9b49aa5d501), [`bc5aacb`](https://github.com/mastra-ai/mastra/commit/bc5aacb646d468d325327e36117129f28cd13bf6), [`03622f8`](https://github.com/mastra-ai/mastra/commit/03622f86e9d7342197f80f95333ea3ff65c783ae), [`6b5af12`](https://github.com/mastra-ai/mastra/commit/6b5af12ce9e09066e0c32e821c203a6954498bea), [`bf60e4a`](https://github.com/mastra-ai/mastra/commit/bf60e4a89c515afd9570b7b79f33b95e7d07c397), [`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`e8fe13c`](https://github.com/mastra-ai/mastra/commit/e8fe13c4b4c255a42520127797ec394310f7c919), [`3ca833d`](https://github.com/mastra-ai/mastra/commit/3ca833dc994c38e3c9b4f9b4478a61cd8e07b32a), [`1edb8d1`](https://github.com/mastra-ai/mastra/commit/1edb8d1cfb963e72a12412990fb9170936c9904c), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
+  - @mastra/core@0.20.0-alpha.0
+  - @mastra/deployer@0.20.0-alpha.0
+  - @mastra/mcp@0.13.3-alpha.0
+  - @mastra/loggers@0.10.15-alpha.0
+
+## 0.13.4
+
+### Patch Changes
+
+- disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
+
+- Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
+
+- Updated dependencies [[`4a70ccc`](https://github.com/mastra-ai/mastra/commit/4a70ccc5cfa12ae9c2b36545a5814cd98e5a0ead), [`0992b8b`](https://github.com/mastra-ai/mastra/commit/0992b8bf0f4f1ba7ad9940883ec4bb8d867d3105), [`283bea0`](https://github.com/mastra-ai/mastra/commit/283bea07adbaf04a27fa3ad2df611095e0825195)]:
+  - @mastra/core@0.19.1
+  - @mastra/deployer@0.19.1
+
 ## 0.13.4-alpha.1
 
 ### Patch Changes
@@ -236,67 +298,5 @@
 
 - Playground ui -pass runtimeContext to client SDK get methods ([#7767](https://github.com/mastra-ai/mastra/pull/7767))
 
-- fix markdown rendering in agent in agent text-delta ([#7851](https://github.com/mastra-ai/mastra/pull/7851))
-
-- fix error message when fetching observability things ([#7956](https://github.com/mastra-ai/mastra/pull/7956))
-
-- fix workflows runs fetching and displaying ([#7852](https://github.com/mastra-ai/mastra/pull/7852))
-
-- fix empty state for scorers on agent page ([#7846](https://github.com/mastra-ai/mastra/pull/7846))
-
-- Updated dependencies [[`197cbb2`](https://github.com/mastra-ai/mastra/commit/197cbb248fc8cb4bbf61bf70b770f1388b445df2), [`b1c155b`](https://github.com/mastra-ai/mastra/commit/b1c155b57ce702674f207f1d4c6a4ebf94225f44), [`790f7d1`](https://github.com/mastra-ai/mastra/commit/790f7d17895d7a5f75b6b5d2d794c2e820b99d4c), [`3cd6538`](https://github.com/mastra-ai/mastra/commit/3cd6538811fc94f84a19dbd1064f46cb42e38c1d), [`197cbb2`](https://github.com/mastra-ai/mastra/commit/197cbb248fc8cb4bbf61bf70b770f1388b445df2), [`a1bb887`](https://github.com/mastra-ai/mastra/commit/a1bb887e8bfae44230f487648da72e96ef824561), [`6590763`](https://github.com/mastra-ai/mastra/commit/65907630ef4bf4127067cecd1cb21b56f55d5f1b), [`fb84c21`](https://github.com/mastra-ai/mastra/commit/fb84c21859d09bdc8f158bd5412bdc4b5835a61c), [`5802bf5`](https://github.com/mastra-ai/mastra/commit/5802bf57f6182e4b67c28d7d91abed349a8d14f3), [`5bda53a`](https://github.com/mastra-ai/mastra/commit/5bda53a9747bfa7d876d754fc92c83a06e503f62), [`c2eade3`](https://github.com/mastra-ai/mastra/commit/c2eade3508ef309662f065e5f340d7840295dd53), [`f26a8fd`](https://github.com/mastra-ai/mastra/commit/f26a8fd99fcb0497a5d86c28324430d7f6a5fb83), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382), [`7e82fbf`](https://github.com/mastra-ai/mastra/commit/7e82fbf3715175e274d2015eb59fb7f57dc9b09d), [`222965a`](https://github.com/mastra-ai/mastra/commit/222965a98ce8197b86673ec594244650b5960257), [`6047778`](https://github.com/mastra-ai/mastra/commit/6047778e501df460648f31decddf8e443f36e373), [`a0f5f1c`](https://github.com/mastra-ai/mastra/commit/a0f5f1ca39c3c5c6d26202e9fcab986b4fe14568), [`9d4fc09`](https://github.com/mastra-ai/mastra/commit/9d4fc09b2ad55caa7738c7ceb3a905e454f74cdd), [`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`0324ceb`](https://github.com/mastra-ai/mastra/commit/0324ceb8af9d16c12a531f90e575f6aab797ac81), [`d75ccf0`](https://github.com/mastra-ai/mastra/commit/d75ccf06dfd2582b916aa12624e3cd61b279edf1), [`0f9d227`](https://github.com/mastra-ai/mastra/commit/0f9d227890a98db33865abbea39daf407cd55ef7), [`b356f5f`](https://github.com/mastra-ai/mastra/commit/b356f5f7566cb3edb755d91f00b72fc1420b2a37), [`de056a0`](https://github.com/mastra-ai/mastra/commit/de056a02cbb43f6aa0380ab2150ea404af9ec0dd), [`f5ce05f`](https://github.com/mastra-ai/mastra/commit/f5ce05f831d42c69559bf4c0fdb46ccb920fc3a3), [`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`c93532a`](https://github.com/mastra-ai/mastra/commit/c93532a340b80e4dd946d4c138d9381de5f70399), [`6c33d7f`](https://github.com/mastra-ai/mastra/commit/6c33d7f7242804c32e969ad3ab33ff4a6aebda8b), [`6cb1fcb`](https://github.com/mastra-ai/mastra/commit/6cb1fcbc8d0378ffed0d17784c96e68f30cb0272), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a), [`f0ab020`](https://github.com/mastra-ai/mastra/commit/f0ab02034532a4afb71a1ef4fe243f9a8dffde84), [`9f6f30f`](https://github.com/mastra-ai/mastra/commit/9f6f30f04ec6648bbca798ea8aad59317c40d8db), [`547c621`](https://github.com/mastra-ai/mastra/commit/547c62104af3f7a551b3754e9cbdf0a3fbba15e4), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251), [`0fed8f2`](https://github.com/mastra-ai/mastra/commit/0fed8f2aa84b167b3415ea6f8f70755775132c8d), [`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689), [`1a1fbe6`](https://github.com/mastra-ai/mastra/commit/1a1fbe66efb7d94abc373ed0dd9676adb8122454), [`d706fad`](https://github.com/mastra-ai/mastra/commit/d706fad6e6e4b72357b18d229ba38e6c913c0e70), [`87fd07f`](https://github.com/mastra-ai/mastra/commit/87fd07ff35387a38728967163460231b5d33ae3b), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382), [`5c3768f`](https://github.com/mastra-ai/mastra/commit/5c3768fa959454232ad76715c381f4aac00c6881), [`2685a78`](https://github.com/mastra-ai/mastra/commit/2685a78f224b8b04e20d4fab5ac1adb638190071), [`36f39c0`](https://github.com/mastra-ai/mastra/commit/36f39c00dc794952dc3c11aab91c2fa8bca74b11), [`239b5a4`](https://github.com/mastra-ai/mastra/commit/239b5a497aeae2e8b4d764f46217cfff2284788e), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382)]:
-  - @mastra/core@0.17.0
-  - @mastra/deployer@0.17.0
-  - @mastra/loggers@0.10.12
-  - @mastra/mcp@0.13.0
-
-## 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
-
-- clean up console logs in monorepo ([#7926](https://github.com/mastra-ai/mastra/pull/7926))
-
-- fix scorers table link full row ([#7915](https://github.com/mastra-ai/mastra/pull/7915))
-
-- adjust the way we display scorers in agent metadata ([#7910](https://github.com/mastra-ai/mastra/pull/7910))
-
-- Updated dependencies [[`197cbb2`](https://github.com/mastra-ai/mastra/commit/197cbb248fc8cb4bbf61bf70b770f1388b445df2), [`197cbb2`](https://github.com/mastra-ai/mastra/commit/197cbb248fc8cb4bbf61bf70b770f1388b445df2), [`6590763`](https://github.com/mastra-ai/mastra/commit/65907630ef4bf4127067cecd1cb21b56f55d5f1b), [`c2eade3`](https://github.com/mastra-ai/mastra/commit/c2eade3508ef309662f065e5f340d7840295dd53), [`222965a`](https://github.com/mastra-ai/mastra/commit/222965a98ce8197b86673ec594244650b5960257), [`0324ceb`](https://github.com/mastra-ai/mastra/commit/0324ceb8af9d16c12a531f90e575f6aab797ac81), [`0f9d227`](https://github.com/mastra-ai/mastra/commit/0f9d227890a98db33865abbea39daf407cd55ef7), [`de056a0`](https://github.com/mastra-ai/mastra/commit/de056a02cbb43f6aa0380ab2150ea404af9ec0dd), [`c93532a`](https://github.com/mastra-ai/mastra/commit/c93532a340b80e4dd946d4c138d9381de5f70399), [`6c33d7f`](https://github.com/mastra-ai/mastra/commit/6c33d7f7242804c32e969ad3ab33ff4a6aebda8b), [`6cb1fcb`](https://github.com/mastra-ai/mastra/commit/6cb1fcbc8d0378ffed0d17784c96e68f30cb0272), [`2685a78`](https://github.com/mastra-ai/mastra/commit/2685a78f224b8b04e20d4fab5ac1adb638190071), [`239b5a4`](https://github.com/mastra-ai/mastra/commit/239b5a497aeae2e8b4d764f46217cfff2284788e)]:
-  - @mastra/core@0.17.0-alpha.6
-  - @mastra/deployer@0.17.0-alpha.6
-  - @mastra/loggers@0.10.12-alpha.1
-  - @mastra/mcp@0.13.0-alpha.2
-
-## 0.13.0-alpha.3
-
-### Patch Changes
-
-- update playground workflows to use createRunAsync instead of createRun ([#7903](https://github.com/mastra-ai/mastra/pull/7903))
-
-- Updated dependencies [[`6047778`](https://github.com/mastra-ai/mastra/commit/6047778e501df460648f31decddf8e443f36e373)]:
-  - @mastra/core@0.17.0-alpha.5
-  - @mastra/deployer@0.17.0-alpha.5
-
-## 0.13.0-alpha.2
-
-### Patch Changes
-
-- Updated dependencies [[`fb84c21`](https://github.com/mastra-ai/mastra/commit/fb84c21859d09bdc8f158bd5412bdc4b5835a61c), [`9d4fc09`](https://github.com/mastra-ai/mastra/commit/9d4fc09b2ad55caa7738c7ceb3a905e454f74cdd), [`d75ccf0`](https://github.com/mastra-ai/mastra/commit/d75ccf06dfd2582b916aa12624e3cd61b279edf1), [`0fed8f2`](https://github.com/mastra-ai/mastra/commit/0fed8f2aa84b167b3415ea6f8f70755775132c8d), [`87fd07f`](https://github.com/mastra-ai/mastra/commit/87fd07ff35387a38728967163460231b5d33ae3b)]:
-  - @mastra/core@0.17.0-alpha.4
-  - @mastra/mcp@0.13.0-alpha.1
-  - @mastra/deployer@0.17.0-alpha.4
-
-## 0.13.0-alpha.1
-
-### Minor Changes
 
-... 5829 more lines hidden. See full changelog in package directory.
+... 5891 more lines hidden. See full changelog in package directory.

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

@@ -180,7 +180,7 @@ const agent = mastra.getAgent('chefAgent');
 const responsesAgent = mastra.getAgent('chefAgentResponses');
 const agentThatHarassesYou = mastra.getAgent('agentThatHarassesYou');
 
-const stream = await agentThatHarassesYou.streamVNext('I want to fight you');
+const stream = await agentThatHarassesYou.stream('I want to fight you');
 
 for await (const chunk of stream.textStream) {
   console.log(`frontend received chunk: ${chunk}`);
@@ -737,13 +737,13 @@ export const chefModelV2Agent = new Agent({
       You explain cooking steps clearly and offer substitutions when needed, maintaining a friendly and encouraging tone throughout.
       `,
   model: 'netlify/openai/gpt-4.1',
-  // tools: {
-  //   cookingTool,
-  //   weatherInfo,
-  // },
-  // workflows: {
-  //   myWorkflow,
-  // },
+  tools: {
+    cookingTool,
+    weatherInfo,
+  },
+  workflows: {
+    myWorkflow,
+  },
   scorers: ({ mastra }) => {
     if (!mastra) {
       throw new Error('Mastra not found');
@@ -754,7 +754,7 @@ export const chefModelV2Agent = new Agent({
       scorer1: { scorer: scorer1, sampling: { rate: 1, type: 'ratio' } },
     };
   },
-  // memory,
+  memory,
 });
 
 const weatherAgent = new Agent({
@@ -762,8 +762,8 @@ const weatherAgent = new 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'),
-  workflows: {
-    myWorkflow,
+  tools: {
+    weatherInfo,
   },
 });
 
@@ -836,9 +836,14 @@ export const mastra = new Mastra({
   scorers: {
     testScorer,
   },
-  // telemetry: {
-  //   enabled: false,
-  // }
+  telemetry: {
+    enabled: false,
+  },
+  observability: {
+    default: {
+      enabled: true,
+    },
+  },
 });
 
 ```

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

@@ -7,15 +7,15 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^1.3.23",
-    "@mastra/core": "^0.18.0",
-    "@mastra/libsql": "^0.14.3",
-    "@mastra/loggers": "^0.10.13",
-    "@mastra/memory": "^0.15.3",
+    "@mastra/core": "^0.19.1",
+    "@mastra/libsql": "^0.15.0",
+    "@mastra/loggers": "^0.10.14",
+    "@mastra/memory": "^0.15.4",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "mastra": "^0.13.2",
+    "mastra": "^0.13.4",
     "typescript": "^5.9.2"
   }
 }

package/.docs/raw/agents/agent-memory.mdx

@@ -7,190 +7,151 @@ description: Documentation on how agents in Mastra use memory to store conversat
 
 Agents in Mastra can leverage a powerful memory system to store conversation history, recall relevant information, and maintain persistent context across interactions. This allows agents to have more natural, stateful conversations.
 
-## Enabling Memory for an Agent
+## Enabling memory for an agent
 
-To enable memory, simply instantiate the `Memory` class and pass it to your agent's configuration. You also need to install the memory package and a storage adapter:
+To enable memory, instantiate the `Memory` class and pass it to your agent's configuration using the `memory` parameter. You also need to install the memory package and a storage adapter:
 
 ```bash npm2yarn copy
 npm install @mastra/memory@latest @mastra/libsql@latest
 ```
 
-```typescript
+```typescript {2-3, 10-14} filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
 import { Agent } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";
 import { openai } from "@ai-sdk/openai";
 
-const memory = new Memory({
-  storage: new LibSQLStore({
-    url: "file:../../memory.db",
-  }),
-});
-
-const agent = new Agent({
-  name: "MyMemoryAgent",
+export const testAgent = new Agent({
+  name: "test-agent",
   instructions: "You are a helpful assistant with memory.",
   model: openai("gpt-4o"),
-  memory, // Attach the memory instance
+  memory: new Memory({
+    storage: new LibSQLStore({
+      url: "file:../../memory.db"
+    })
+  })
 });
 ```
 
-This basic setup uses the default settings. Visit the [Memory documentation](/docs/memory/overview) for more configuration info.
+This basic setup uses the default settings. Visit the [Memory documentation](../memory/overview.mdx) for more configuration info.
+
+## Memory in agent calls
+
+When calling `.generate()` or `.stream()`, include a `memory` object with both `resource` and `thread` to enable memory.
 
-## Dynamic Memory Configuration
+- `resource`: A stable identifier for the user or entity.
+- `thread`: An ID that isolates a specific conversation or session.
+
+These fields tell the agent where to store and retrieve context, enabling persistent, thread-aware memory across interactions.
+
+```typescript {3-4}
+const response = await testAgent.generate("Remember my favorite color is blue.", {
+  memory: {
+    resource: "user_alice",
+    thread: "preferences_thread",
+  }
+});
+```
 
-Similar to how you can configure dynamic [instructions, models, and tools](./dynamic-agents.mdx), you can also configure memory dynamically using runtime context. This allows you to:
+To recall information stored in memory, call the agent with the same `resource` and `thread` values used in the original interaction.
 
-- Use different memory systems based on user tiers or preferences
-- Switch between memory configurations for different environments
-- Enable or disable memory features based on feature flags
-- Customize memory behavior based on user context
+```typescript {3-4}
+const response = await testAgent.generate("What's my favorite color?", {
+  memory: {
+    resource: "user_alice",
+    thread: "preferences_thread",
+  }
+});
+```
 
-### Example: User Tier-Based Memory
+## Memory with `RuntimeContext`
 
-```typescript
+You can configure memory dynamically using [RuntimeContext](./runtime-context.mdx), just like `instructions`, `models`, and `tools`. This gives you fine-grained control over memory behavior. For example, you can select different memory systems per user, enable features conditionally, or adapt configurations across environments.
+
+### Agent configuration
+
+```typescript {18-20} filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
 import { Agent } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";
-import { PostgresStore } from "@mastra/pg";
 import { openai } from "@ai-sdk/openai";
 
-// Create different memory instances for different user tiers
 const premiumMemory = new Memory({
-  storage: new LibSQLStore({ url: "file:premium.db" }),
-  options: {
-    semanticRecall: { topK: 10, messageRange: 5 }, // More context for premium users
-    workingMemory: { enabled: true },
-  },
+ // ...
 });
 
 const standardMemory = new Memory({
-  storage: new LibSQLStore({ url: "file:standard.db" }),
-  options: {
-    semanticRecall: { topK: 3, messageRange: 2 }, // Basic recall for standard users
-    workingMemory: { enabled: false },
-  },
+  // ...
 });
 
-const agent = new Agent({
-  name: "TieredMemoryAgent",
+export const testAgent = new Agent({
+  name: "test-agent",
   instructions: "You are a helpful assistant with tiered memory capabilities.",
   model: openai("gpt-4o"),
   memory: ({ runtimeContext }) => {
     const userTier = runtimeContext.get("userTier");
     return userTier === "premium" ? premiumMemory : standardMemory;
-  },
-});
-```
-
-### Example: Environment-Based Memory
-
-```typescript
-const agent = new Agent({
-  name: "EnvironmentAwareAgent",
-  instructions: "You are a helpful assistant.",
-  model: openai("gpt-4o"),
-  memory: ({ runtimeContext }) => {
-    const environment = runtimeContext.get("environment");
-    
-    if (environment === "test") {
-      // Use local storage for testing
-      return new Memory({
-        storage: new LibSQLStore({ url: ":memory:" }),
-        options: {
-          workingMemory: { enabled: true },
-        },
-      });
-    } else if (environment === "production") {
-      // Use production database
-      return new Memory({
-        storage: new PostgresStore({ connectionString: process.env.PRODUCTION_DB_URL }),
-        options: {
-          workingMemory: { enabled: true },
-        },
-      });
-    }
-    
-    // Development environment
-    return new Memory({
-      storage: new LibSQLStore({ url: "file:dev.db" }),
-    });
-  },
-});
-```
-
-### Example: Async Memory Configuration
-
-```typescript
-const agent = new Agent({
-  name: "AsyncMemoryAgent",
-  instructions: "You are a helpful assistant.",
-  model: openai("gpt-4o"),
-  memory: async ({ runtimeContext }) => {
-    const userId = runtimeContext.get("userId");
-    
-    // Simulate async memory setup (e.g., database lookup)
-    await new Promise(resolve => setTimeout(resolve, 10));
-    
-    return new Memory({
-      storage: new LibSQLStore({ 
-        url: `file:user_${userId}.db` 
-      }),
-    });
-  },
+  }
 });
 ```
 
-### Using Dynamic Memory
+### Agent usage
 
-When using dynamic memory, pass the runtime context to your agent calls:
+Pass a configured `RuntimeContext` instance to an agent to enable conditional logic during execution. This allows the agent to adapt its behavior based on runtime values.
 
-```typescript
+```typescript {1,4,6, 13} showLineNumbers copy
 import { RuntimeContext } from "@mastra/core/runtime-context";
 
-// Create runtime context with user information
+const testAgent = mastra.getAgent("testAgent");
 const runtimeContext = new RuntimeContext();
+
 runtimeContext.set("userTier", "premium");
-runtimeContext.set("environment", "production");
 
-// Use the agent with runtime context
-const response = await agent.generate("Remember my favorite color is blue.", {
+const response = await testAgent.generate("Remember my favorite color is blue.", {
   memory: {
     resource: "user_alice",
-    thread: { id: "preferences_thread" },
+    thread: { id: "preferences_thread" }
   },
-  runtimeContext, // Pass the runtime context
+  runtimeContext
 });
 ```
 
-## Using Memory in Agent Calls
 
-To utilize memory during interactions, you **must** provide a `memory` object with `resource` and `thread` properties when calling the agent's `stream()` or `generate()` methods.
+## Async memory configuration
 
-- `resource`: Typically identifies the user or entity (e.g., `user_123`).
-- `thread`: Identifies a specific conversation thread (e.g., `support_chat_456`).
+Memory can be configured asynchronously to support use cases like fetching user-specific settings from a database, validating access with Auth, or loading additional data from a remote service.
 
-```typescript
-// Example agent call using memory
-await agent.stream("Remember my favorite color is blue.", {
-  memory: {
-    resource: "user_alice",
-    thread: "preferences_thread",
-  },
+```typescript {18, 22} filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
+import { Agent } from "@mastra/core/agent";
+import { Memory } from "@mastra/memory";
+import { LibSQLStore } from "@mastra/libsql";
+import { openai } from "@ai-sdk/openai";
+
+const premiumMemory = new Memory({
+ // ...
 });
 
-// Later in the same thread...
-const response = await agent.stream("What's my favorite color?", {
-  memory: {
-    resource: "user_alice",
-    thread: "preferences_thread",
-  },
+const standardMemory = new Memory({
+  // ...
 });
-// Agent will use memory to recall the favorite color.
-```
 
-These IDs ensure that conversation history and context are correctly stored and retrieved for the appropriate user and conversation.
+export const testAgent = new Agent({
+  name: "test-agent",
+  instructions: "You are a helpful assistant with tiered memory capabilities.",
+  model: openai("gpt-4o"),
+  memory: async ({ runtimeContext }) => {
+    const userId = runtimeContext.get("userId");
+
+    // Example database lookup using `userId`
+    const userTier = await query(`SELECT user_tier FROM users WHERE userId = $1`, [userId]);
+
+    return userTier === "premium" ? premiumMemory : standardMemory;
+  }
+});
+```
 
-## Next Steps
+## Related
 
-Keep exploring Mastra's [memory capabilities](/docs/memory/overview) like threads, conversation history, semantic recall, and working memory.
+- [Working Memory](../memory/working-memory.mdx)
+- [Semantic Recall](../memory/semantic-recall.mdx)
+- [Threads and Resources](../memory/threads-and-resources.mdx)

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

@@ -262,14 +262,14 @@ When creating custom processors:
 
 ## Integration with Agent Methods
 
-Input processors work with the `generate()`, `stream()`, and `streamVNext()` methods. The entire processor pipeline completes before the agent begins generating or streaming a response.
+Input processors work with the `generate()` and `stream()` methods. The entire processor pipeline completes before the agent begins generating or streaming a response.
 
 ```typescript copy showLineNumbers
 // Processors run before generate()
 const result = await agent.generate('Hello');
 
-// Processors also run before streamVNext()
-const stream = await agent.streamVNext('Hello');
+// Processors also run before stream()
+const stream = await agent.stream('Hello');
 for await (const chunk of stream) {
   console.log(chunk);
 }

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

@@ -259,7 +259,7 @@ When creating custom output processors:
 
 ## Integration with Agent Methods
 
-Output processors work with both `generate()` and `streamVNext()` methods. The processor pipeline completes after the agent generates a response but before it's returned to the user.
+Output processors work with both `generate()` and `stream()` methods. The processor pipeline completes after the agent generates a response but before it's returned to the user.
 
 ```typescript copy showLineNumbers
 // Processors run after generate() but before returning result
@@ -267,8 +267,8 @@ const result = await agent.generate('Hello');
 console.log(result.text); // Processed text
 console.log(result.object); // Structured data if applicable
 
-// Processors also run during streamVNext() for each part
-const stream = await agent.streamVNext('Hello');
+// Processors also run during stream() for each part
+const stream = await agent.stream('Hello');
 for await (const part of stream) {
   console.log(part); // Processed parts
 }
@@ -287,7 +287,7 @@ const result = await agent.generate('Hello', {
 });
 
 // Same for streaming
-const stream = await agent.streamVNext('Hello', {
+const stream = await agent.stream('Hello', {
   outputProcessors: [
     new TokenLimiterProcessor({ maxTokens: 500 }),
   ],