@mastra/mcp-docs-server 0.13.37 → 0.13.38

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

@@ -1,5 +1,19 @@
 # @mastra/react-hooks
 
+## 0.0.14
+
+### Patch Changes
+
+- Updated dependencies [[`b55bbce`](https://github.com/mastra-ai/mastra/commit/b55bbce89404d35fdd967012dd503fae343d4c2d), [`e742d37`](https://github.com/mastra-ai/mastra/commit/e742d371f24ef8059670cc05e9aee308eac068b9)]:
+  - @mastra/client-js@0.16.8
+
+## 0.0.14-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`b55bbce`](https://github.com/mastra-ai/mastra/commit/b55bbce89404d35fdd967012dd503fae343d4c2d), [`e742d37`](https://github.com/mastra-ai/mastra/commit/e742d371f24ef8059670cc05e9aee308eac068b9)]:
+  - @mastra/client-js@0.16.8-alpha.0
+
 ## 0.0.13
 
 ### Patch Changes
@@ -284,19 +298,5 @@
 
 ### Patch Changes
 
-- generateVNext into react SDK + to asistant ui message ([#8345](https://github.com/mastra-ai/mastra/pull/8345))
-
-- distinguish between legacy and regular messages in agent chat for useChat usage ([#8409](https://github.com/mastra-ai/mastra/pull/8409))
-
-- Updated dependencies [[`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
-  - @mastra/client-js@0.15.0
-
-## 0.0.3-alpha.0
-
-### Patch Changes
-
-- generateVNext into react SDK + to asistant ui message ([#8345](https://github.com/mastra-ai/mastra/pull/8345))
-
-- distinguish between legacy and regular messages in agent chat for useChat usage ([#8409](https://github.com/mastra-ai/mastra/pull/8409))
 
-... 50 more lines hidden. See full changelog in package directory.
+... 64 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,27 @@
 # @mastra/server
 
+## 0.23.3
+
+### Patch Changes
+
+- Make step optional in all resume APIs ([#9462](https://github.com/mastra-ai/mastra/pull/9462))
+
+- Make step optional in resumeStreamVNext API ([#9461](https://github.com/mastra-ai/mastra/pull/9461))
+
+- Updated dependencies [[`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3)]:
+  - @mastra/core@0.23.3
+
+## 0.23.3-alpha.0
+
+### Patch Changes
+
+- Make step optional in all resume APIs ([#9462](https://github.com/mastra-ai/mastra/pull/9462))
+
+- Make step optional in resumeStreamVNext API ([#9461](https://github.com/mastra-ai/mastra/pull/9461))
+
+- Updated dependencies [[`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3)]:
+  - @mastra/core@0.23.3-alpha.0
+
 ## 0.23.2
 
 ### Patch Changes
@@ -277,26 +299,4 @@
 - Updated dependencies [[`c621613`](https://github.com/mastra-ai/mastra/commit/c621613069173c69eb2c3ef19a5308894c6549f0), [`12b1189`](https://github.com/mastra-ai/mastra/commit/12b118942445e4de0dd916c593e33ec78dc3bc73), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`076b092`](https://github.com/mastra-ai/mastra/commit/076b0924902ff0f49d5712d2df24c4cca683713f), [`2aee9e7`](https://github.com/mastra-ai/mastra/commit/2aee9e7d188b8b256a4ddc203ccefb366b4867fa), [`c582906`](https://github.com/mastra-ai/mastra/commit/c5829065a346260f96c4beb8af131b94804ae3ad), [`fa2eb96`](https://github.com/mastra-ai/mastra/commit/fa2eb96af16c7d433891a73932764960d3235c1d), [`ee9108f`](https://github.com/mastra-ai/mastra/commit/ee9108fa29bb8368fc23df158c9f0645b2d7b65c), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`a739d0c`](https://github.com/mastra-ai/mastra/commit/a739d0c8b37cd89569e04a6ca0827083c6167e19), [`603e927`](https://github.com/mastra-ai/mastra/commit/603e9279db8bf8a46caf83881c6b7389ccffff7e), [`cd45982`](https://github.com/mastra-ai/mastra/commit/cd4598291cda128a88738734ae6cbef076ebdebd), [`874f74d`](https://github.com/mastra-ai/mastra/commit/874f74da4b1acf6517f18132d035612c3ecc394a), [`b728a45`](https://github.com/mastra-ai/mastra/commit/b728a45ab3dba59da0f5ee36b81fe246659f305d), [`0baf2ba`](https://github.com/mastra-ai/mastra/commit/0baf2bab8420277072ef1f95df5ea7b0a2f61fe7), [`10e633a`](https://github.com/mastra-ai/mastra/commit/10e633a07d333466d9734c97acfc3dbf757ad2d0), [`a6d69c5`](https://github.com/mastra-ai/mastra/commit/a6d69c5fb50c0875b46275811fece5862f03c6a0), [`84199af`](https://github.com/mastra-ai/mastra/commit/84199af8673f6f9cb59286ffb5477a41932775de), [`7f431af`](https://github.com/mastra-ai/mastra/commit/7f431afd586b7d3265075e73106eb73167edbb86), [`26e968d`](https://github.com/mastra-ai/mastra/commit/26e968db2171ded9e4d47aa1b4f19e1e771158d0), [`cbd3fb6`](https://github.com/mastra-ai/mastra/commit/cbd3fb65adb03a7c0df193cb998aed5ac56675ee)]:
   - @mastra/core@0.20.1
 
-## 0.20.1-alpha.4
-
-### Patch Changes
-
-- Updated dependencies [[`b728a45`](https://github.com/mastra-ai/mastra/commit/b728a45ab3dba59da0f5ee36b81fe246659f305d)]:
-  - @mastra/core@0.20.1-alpha.4
-
-## 0.20.1-alpha.3
-
-### Patch Changes
-
-- Fix TypeScript errors with provider-defined tools by updating ai-v5 and openai-v5 to matching provider-utils versions. This ensures npm deduplicates to a single provider-utils instance, resolving type incompatibility issues when passing provider tools to Agent. ([#8584](https://github.com/mastra-ai/mastra/pull/8584))
-
-  Also adds deprecation warning to Agent import from root path to encourage using the recommended subpath import.
-
-- Updated dependencies [[`a6d69c5`](https://github.com/mastra-ai/mastra/commit/a6d69c5fb50c0875b46275811fece5862f03c6a0), [`84199af`](https://github.com/mastra-ai/mastra/commit/84199af8673f6f9cb59286ffb5477a41932775de), [`7f431af`](https://github.com/mastra-ai/mastra/commit/7f431afd586b7d3265075e73106eb73167edbb86)]:
-  - @mastra/core@0.20.1-alpha.3
-
-## 0.20.1-alpha.2
-
-### Patch Changes
-
-... 3909 more lines hidden. See full changelog in package directory.
+... 3931 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,9 @@
 # create-mastra
 
+## 0.17.7
+
+## 0.17.7-alpha.0
+
 ## 0.17.6
 
 ### Patch Changes
@@ -294,9 +298,5 @@
 
 ## 0.13.4-alpha.0
 
-### Patch Changes
-
-- Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
-
 
-... 1800 more lines hidden. See full changelog in package directory.
+... 1804 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,21 @@
 # mastra
 
+## 0.17.7
+
+### Patch Changes
+
+- Updated dependencies [[`b55bbce`](https://github.com/mastra-ai/mastra/commit/b55bbce89404d35fdd967012dd503fae343d4c2d), [`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3), [`e742d37`](https://github.com/mastra-ai/mastra/commit/e742d371f24ef8059670cc05e9aee308eac068b9)]:
+  - @mastra/deployer@0.23.3
+  - @mastra/core@0.23.3
+
+## 0.17.7-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`b55bbce`](https://github.com/mastra-ai/mastra/commit/b55bbce89404d35fdd967012dd503fae343d4c2d), [`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3), [`e742d37`](https://github.com/mastra-ai/mastra/commit/e742d371f24ef8059670cc05e9aee308eac068b9)]:
+  - @mastra/deployer@0.23.3-alpha.0
+  - @mastra/core@0.23.3-alpha.0
+
 ## 0.17.6
 
 ### Patch Changes
@@ -283,20 +299,4 @@
 
 ### Patch Changes
 
-- Marked telemetry as disabled in the default template, in preperation for the Nov 4th deprecation. ([#8618](https://github.com/mastra-ai/mastra/pull/8618))
-
-## 0.15.1-alpha.0
-
-### Patch Changes
-
-- Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
-
-- Updated dependencies [[`0d71771`](https://github.com/mastra-ai/mastra/commit/0d71771f5711164c79f8e80919bc84d6bffeb6bc), [`0d6e55e`](https://github.com/mastra-ai/mastra/commit/0d6e55ecc5a2e689cd4fc9c86525e0eb54d82372)]:
-  - @mastra/core@0.20.2-alpha.0
-  - @mastra/deployer@0.20.2-alpha.0
-
-## 0.15.0
-
-### Minor Changes
-
-... 6363 more lines hidden. See full changelog in package directory.
+... 6379 more lines hidden. See full changelog in package directory.

package/.docs/raw/agents/adding-voice.mdx

@@ -1,3 +1,7 @@
+---
+title: "Adding Voice to Agents | Agents | Mastra Docs"
+---
+
 # Adding Voice to Agents
 
 Mastra agents can be enhanced with voice capabilities, allowing them to speak responses and listen to user input. You can configure an agent to use either a single voice provider or combine multiple providers for different operations.
@@ -163,7 +167,7 @@ The following files are created:
 - **hybrid-question.mp3** – Hybrid agent's spoken question.
 - **unified-response.mp3** – Unified agent's spoken response.
 
-```typescript filename="src/test-voice-agents.ts" showLineNumbers copy
+```typescript title="src/test-voice-agents.ts" showLineNumbers copy
 import "dotenv/config";
 
 import path from "path";
@@ -175,7 +179,10 @@ import { Mastra } from "@mastra/core/mastra";
 import { openai } from "@ai-sdk/openai";
 
 // Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
-export const saveAudioToFile = async (audio: NodeJS.ReadableStream, filename: string): Promise<void> => {
+export const saveAudioToFile = async (
+  audio: NodeJS.ReadableStream,
+  filename: string,
+): Promise<void> => {
   const audioDir = path.join(process.cwd(), "audio");
   const filePath = path.join(audioDir, filename);
 
@@ -190,7 +197,9 @@ export const saveAudioToFile = async (audio: NodeJS.ReadableStream, filename: st
 };
 
 // Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
-export const convertToText = async (input: string | NodeJS.ReadableStream): Promise<string> => {
+export const convertToText = async (
+  input: string | NodeJS.ReadableStream,
+): Promise<string> => {
   if (typeof input === "string") {
     return input;
   }
@@ -209,20 +218,20 @@ export const hybridVoiceAgent = new Agent({
   instructions: "You can speak and listen using different providers.",
   voice: new CompositeVoice({
     input: new OpenAIVoice(),
-    output: new OpenAIVoice()
-  })
+    output: new OpenAIVoice(),
+  }),
 });
- 
+
 export const unifiedVoiceAgent = new Agent({
   name: "unified-voice-agent",
   instructions: "You are an agent with both STT and TTS capabilities.",
   model: openai("gpt-4o"),
-  voice: new OpenAIVoice()
+  voice: new OpenAIVoice(),
 });
 
 export const mastra = new Mastra({
   // ...
-  agents: { hybridVoiceAgent, unifiedVoiceAgent }
+  agents: { hybridVoiceAgent, unifiedVoiceAgent },
 });
 
 const hybridVoiceAgent = mastra.getAgent("hybridVoiceAgent");
@@ -234,7 +243,9 @@ const hybridSpoken = await hybridVoiceAgent.voice.speak(question);
 
 await saveAudioToFile(hybridSpoken!, "hybrid-question.mp3");
 
-const audioStream = createReadStream(path.join(process.cwd(), "audio", "hybrid-question.mp3"));
+const audioStream = createReadStream(
+  path.join(process.cwd(), "audio", "hybrid-question.mp3"),
+);
 const unifiedHeard = await unifiedVoiceAgent.voice.listen(audioStream);
 
 const inputText = await convertToText(unifiedHeard!);

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

@@ -3,9 +3,10 @@ title: "Agent Memory | Agents | Mastra Docs"
 description: Learn how to add memory to agents to store conversation history and maintain context across interactions.
 ---
 
-import { Steps } from "nextra/components";
+import Steps from "@site/src/components/Steps";
+import StepItem from "@site/src/components/StepItem";
 
-## Agent memory
+# Agent memory
 
 Agents use memory to maintain context across interactions. LLMs are stateless and don't retain information between calls, so agents need memory to track conversation history and recall relevant information.
 
@@ -25,17 +26,16 @@ npm install @mastra/memory@latest @mastra/libsql@latest
 
 ## Storage providers
 
-Memory requires a storage provider to persist conversation history, including user messages and agent responses. For more details on available providers and how storage works in Mastra, see the [Storage](../server-db/storage.mdx) documentation.
+Memory requires a storage provider to persist conversation history, including user messages and agent responses. For more details on available providers and how storage works in Mastra, see the [Storage](/docs/server-db/storage) documentation.
 
 ## Configuring memory
 
 <Steps>
-
-### Agent memory
+  <StepItem>
 
 Enable memory by creating a `Memory` instance and passing it to the agent’s `memory` option.
 
-```typescript {6-9} filename="src/mastra/agents/memory-agent.ts" showLineNumbers copy
+```typescript {6-9} title="src/mastra/agents/memory-agent.ts" copy
 import { Agent } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
 
@@ -43,37 +43,48 @@ export const memoryAgent = new Agent({
   // ...
   memory: new Memory({
     options: {
-      lastMessages: 20
-    }
-  })
+      lastMessages: 20,
+    },
+  }),
 });
 ```
 
-> See the [Memory Class](../../reference/memory/Memory.mdx) for a full list of configuration options.
+:::note
+
+See the [Memory Class](/reference/memory/memory-class) docs for a full list of configuration options.
+
+:::
 
-### Mastra storage
+  </StepItem>
+
+  <StepItem>
 
 Add a storage provider to your main Mastra instance to enable memory across all configured agents.
 
-```typescript {6-8} filename="src/mastra/index.ts" showLineNumbers copy
+```typescript {6-8} title="src/mastra/index.ts" copy
 import { Mastra } from "@mastra/core/mastra";
 import { LibSQLStore } from "@mastra/libsql";
 
 export const mastra = new Mastra({
   // ..
   storage: new LibSQLStore({
-    url: ":memory:"
+    url: ":memory:",
   }),
 });
 ```
 
-> See the [LibSQL Storage](../../reference/storage/libsql.mdx) for a full list of configuration options.
+:::note
+
+See the [LibSQL Storage](/reference/storage/libsql) docs for a full list of configuration options.
+
+:::
 
+  </StepItem>
 </Steps>
 
 Alternatively, add storage directly to an agent’s memory to keep data separate or use different providers per agent.
 
-```typescript {7-10} filename="src/mastra/agents/memory-agent.ts" showLineNumbers copy
+```typescript {7-10} title="src/mastra/agents/memory-agent.ts" copy
 import { Agent } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";
@@ -82,9 +93,9 @@ export const memoryAgent = new Agent({
   // ...
   memory: new Memory({
     storage: new LibSQLStore({
-      url: ":memory:"
-    })
-  })
+      url: ":memory:",
+    }),
+  }),
 });
 ```
 
@@ -98,12 +109,15 @@ Include a `memory` object with both `resource` and `thread` to track conversatio
 These fields tell the agent where to store and retrieve context, enabling persistent, thread-aware memory across a conversation.
 
 ```typescript {3-4}
-const response = await memoryAgent.generate("Remember my favorite color is blue.", {
-  memory: {
-    thread: "user-123",
-    resource: "test-123"
-  }
-});
+const response = await memoryAgent.generate(
+  "Remember my favorite color is blue.",
+  {
+    memory: {
+      thread: "user-123",
+      resource: "test-123",
+    },
+  },
+);
 ```
 
 To recall information stored in memory, call the agent with the same `resource` and `thread` values used in the original conversation.
@@ -112,24 +126,24 @@ To recall information stored in memory, call the agent with the same `resource`
 const response = await memoryAgent.generate("What's my favorite color?", {
   memory: {
     thread: "user-123",
-    resource: "test-123"
-  }
+    resource: "test-123",
+  },
 });
 ```
 
-To learn more about memory see the [Memory](../memory/overview.mdx) documentation.
+To learn more about memory see the [Memory](../memory/overview) documentation.
 
 ## Using `RuntimeContext`
 
-Use [RuntimeContext](../server-db/runtime-context.mdx) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
+Use [RuntimeContext](/docs/server-db/runtime-context) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
 
-```typescript filename="src/mastra/agents/memory-agent.ts" showLineNumbers
+```typescript title="src/mastra/agents/memory-agent.ts" showLineNumbers
 export type UserTier = {
   "user-tier": "enterprise" | "pro";
 };
 
 const premiumMemory = new Memory({
- // ...
+  // ...
 });
 
 const standardMemory = new Memory({
@@ -141,18 +155,20 @@ export const memoryAgent = new Agent({
   memory: ({ runtimeContext }) => {
     const userTier = runtimeContext.get("user-tier") as UserTier["user-tier"];
 
-    return userTier === "enterprise"
-      ? premiumMemory
-      : standardMemory;
-  }
+    return userTier === "enterprise" ? premiumMemory : standardMemory;
+  },
 });
 ```
 
-> See [Runtime Context](../server-db/runtime-context.mdx) for more information.
+:::note
+
+See [Runtime Context](/docs/server-db/runtime-context) docs for more information.
+
+:::
 
 ## Related
 
-- [Working Memory](../memory/working-memory.mdx)
-- [Semantic Recall](../memory/semantic-recall.mdx)
-- [Threads and Resources](../memory/threads-and-resources.mdx)
-- [Runtime Context](../server-db/runtime-context.mdx)
+- [Working Memory](../memory/working-memory)
+- [Semantic Recall](../memory/semantic-recall)
+- [Threads and Resources](../memory/threads-and-resources)
+- [Runtime Context](/docs/server-db/runtime-context)