@mastra/mcp-docs-server 0.13.37 → 0.13.39-alpha.0

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

@@ -1,5 +1,38 @@
 # mastra
 
+## 0.18.0-alpha.0
+
+### Minor Changes
+
+- Update peer dependencies to match core package version bump (0.23.4) ([#9487](https://github.com/mastra-ai/mastra/pull/9487))
+
+### Patch Changes
+
+- update peerdeps ([`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc))
+
+- Fixes issue where clicking the reset button in the model picker would fail to restore the original LanguageModelV2 (or any other types) object that was passed during agent construction. ([#9487](https://github.com/mastra-ai/mastra/pull/9487))
+
+- Updated dependencies [[`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc), [`2437a90`](https://github.com/mastra-ai/mastra/commit/2437a90d94a0ff94fa8dd42d2558d73c124972d3), [`6d7e90d`](https://github.com/mastra-ai/mastra/commit/6d7e90db09713e6250f4d6c3d3cff1b4740e50f9), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`f78b908`](https://github.com/mastra-ai/mastra/commit/f78b9080e11af765969b36b4a619761056030840), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`3e6c29a`](https://github.com/mastra-ai/mastra/commit/3e6c29a8924f63da4def2cf95180f671b3b2c89c), [`139588d`](https://github.com/mastra-ai/mastra/commit/139588df7755c9111a3060f72a789c1a8c95e091), [`186b29b`](https://github.com/mastra-ai/mastra/commit/186b29bd51ac1dcc24ad3825fdb7207a6d6391a6), [`4e92a19`](https://github.com/mastra-ai/mastra/commit/4e92a19aef1bd7f608482b366b1e46873a9dc6c7), [`e365eda`](https://github.com/mastra-ai/mastra/commit/e365eda45795b43707310531cac1e2ce4e5a0712), [`dbb705e`](https://github.com/mastra-ai/mastra/commit/dbb705e61999ec655b912ea8b5d77ae4792989a7)]:
+  - @mastra/deployer@0.24.0-alpha.0
+  - @mastra/loggers@0.10.19-alpha.0
+  - @mastra/core@0.24.0-alpha.0
+
+## 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
@@ -265,38 +298,5 @@
   - @mastra/deployer@0.21.0-alpha.0
   - @mastra/core@0.21.0-alpha.0
   - @mastra/loggers@0.10.16-alpha.0
-  - @mastra/mcp@0.13.5-alpha.0
-
-## 0.15.1
-
-### 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))
-
-- 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 [[`07eaf25`](https://github.com/mastra-ai/mastra/commit/07eaf25aada9e42235dbf905854de53da4d8121b), [`0d71771`](https://github.com/mastra-ai/mastra/commit/0d71771f5711164c79f8e80919bc84d6bffeb6bc), [`0d6e55e`](https://github.com/mastra-ai/mastra/commit/0d6e55ecc5a2e689cd4fc9c86525e0eb54d82372), [`68b1111`](https://github.com/mastra-ai/mastra/commit/68b11118a1303f93e9c0c157850c0751309304c5)]:
-  - @mastra/core@0.20.2
-  - @mastra/deployer@0.20.2
-
-## 0.15.1-alpha.1
-
-### 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.
+... 6396 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)