@mastra/mcp-docs-server 0.13.10 → 0.13.11-alpha.1

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

@@ -1,5 +1,12 @@
 # @mastra/schema-compat
 
+## 0.10.7-alpha.0
+
+### Patch Changes
+
+- dd94a26: Dont rely on the full language model for schema compat
+- 2fff911: Fix vnext working memory tool schema when model is incompatible with schema
+
 ## 0.10.6
 
 ### Patch Changes

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

@@ -1,5 +1,30 @@
 # @mastra/deployer
 
+## 0.13.2-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [2e74797]
+- Updated dependencies [63449d0]
+  - @mastra/core@0.13.2-alpha.1
+
+## 0.13.2-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [8388649]
+- Updated dependencies [dd94a26]
+- Updated dependencies [3ba6772]
+- Updated dependencies [2fff911]
+  - @mastra/core@0.13.2-alpha.0
+
+## 0.13.1
+
+### Patch Changes
+
+- Updated dependencies [cd0042e]
+  - @mastra/core@0.13.1
+
 ## 0.13.1-alpha.0
 
 ### Patch Changes
@@ -273,30 +298,5 @@
 
 ### Patch Changes
 
-- 62007b3: Fix upserting memory messages via hono endpoints
-  - @mastra/core@0.11.0-alpha.3
-
-## 0.11.0-alpha.2
-
-### Patch Changes
-
-- f248d53: Adding `getMessagesPaginated` to the serve, deployer, and client-js
-- 35b1155: Added "Semantic recall search" to playground UI chat sidebar, to search for messages and find them in the chat list
-- 65e3395: Add Scores playground-ui and add scorer hooks
-- bea9dd1: Refactor Agent class to consolidate LLM generate and stream methods and improve type safety. This includes
-  extracting common logic into prepareLLMOptions(), enhancing type definitions, and fixing test annotations.
-
-  This changeset entry follows the established format in your project:
-  - Targets the @mastra/core package with a patch version bump
-  - Provides a concise description of the refactoring and type safety improvements
-  - Mentions the key changes without being too verbose
-
-- dcd4802: scores mastra server
-- Updated dependencies [f248d53]
-- Updated dependencies [2affc57]
-- Updated dependencies [66e13e3]
-- Updated dependencies [edd9482]
-- Updated dependencies [18344d7]
-- Updated dependencies [9d372c2]
 
-... 2717 more lines hidden. See full changelog in package directory.
+... 2742 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,15 @@
 # create-mastra
 
+## 0.10.21-alpha.1
+
+## 0.10.21-alpha.0
+
+### Patch Changes
+
+- 7aad750: Fix tool ui showing after message when chat is refreshed
+
+## 0.10.20
+
 ## 0.10.20-alpha.0
 
 ## 0.10.19
@@ -288,15 +298,5 @@
   - Updated dependency [`posthog-node@^4.18.0` ↗︎](https://www.npmjs.com/package/posthog-node/v/4.18.0) (from `^4.10.1`, in `dependencies`)
 - 5f2aa3e: Move workflow hooks to playground
 - 44ba52d: Add proper error message when installation of mastra fails
-- 311132e: move useWorkflow to playground instead of playground-ui
-- 3270d9d: Fix runtime context being undefined
-- 53d3c37: Get workflows from an agent if not found from Mastra instance #5083
-- fc677d7: For final result for a workflow
-
-## 0.10.5-alpha.2
-
-### Patch Changes
-
-- 5f2aa3e: Move workflow hooks to playground
 
-... 1161 more lines hidden. See full changelog in package directory.
+... 1171 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,35 @@
 # mastra
 
+## 0.10.21-alpha.1
+
+### Patch Changes
+
+- 63449d0: Change the globbing of tools to exclude test files. Files inside `__tests__` directory and files with `.test.` or `.spec.` in their file name are now excluded from bundling.
+- Updated dependencies [2e74797]
+- Updated dependencies [63449d0]
+  - @mastra/core@0.13.2-alpha.1
+  - @mastra/deployer@0.13.2-alpha.1
+
+## 0.10.21-alpha.0
+
+### Patch Changes
+
+- 7aad750: Fix tool ui showing after message when chat is refreshed
+- Updated dependencies [8388649]
+- Updated dependencies [dd94a26]
+- Updated dependencies [3ba6772]
+- Updated dependencies [2fff911]
+  - @mastra/core@0.13.2-alpha.0
+  - @mastra/deployer@0.13.2-alpha.0
+
+## 0.10.20
+
+### Patch Changes
+
+- Updated dependencies [cd0042e]
+  - @mastra/core@0.13.1
+  - @mastra/deployer@0.13.1
+
 ## 0.10.20-alpha.0
 
 ### Patch Changes
@@ -269,34 +299,4 @@
 
 ### Patch Changes
 
-- dd2a4c9: change the way we start the dev process of playground
-- af1f902: share thread list between agent, network and cloud
-- 8f89bcd: fix traces pagination + sharing trace view with cloud
-- 0bf0bc8: fix link in shared components + add e2e tests
-- 2affc57: Fix output type of network loop
-- 51192f8: Spread the loaded env into the main process
-- f6c4d75: fix date picker on change
-- 59f0dcd: Add light background color for step statuses
-- 698518b: Allow external templates from github
-- cf8d497: factorize tabs component between cloud and core
-- 7827943: Handle streaming large data
-- 808b493: wrap runtime context with tooltip provider for usage in cloud
-- 8364fac: Fix displaying scorer input
-- 09464dd: Share AgentMetadata component with cloud
-- 80692d5: refactor: sharing only the UI and not data fetching for traces
-- 80c2b06: Fix agent chat stop button to cancel stream/generate reqs in the playground
-- Updated dependencies [f248d53]
-- Updated dependencies [82c6860]
-- Updated dependencies [2affc57]
-- Updated dependencies [66e13e3]
-- Updated dependencies [edd9482]
-- Updated dependencies [0938991]
-- Updated dependencies [18344d7]
-- Updated dependencies [7ba91fa]
-- Updated dependencies [a512ede]
-- Updated dependencies [35b1155]
-- Updated dependencies [9d372c2]
-- Updated dependencies [45469c5]
-- Updated dependencies [40c2525]
-
-... 4797 more lines hidden. See full changelog in package directory.
+... 4827 more lines hidden. See full changelog in package directory.

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

@@ -10,6 +10,7 @@
     "@mastra/libsql": "latest",
     "@mastra/loggers": "latest",
     "@mastra/memory": "latest",
+    "mastra": "latest",
     "zod": "^3.25.67"
   }
 }
@@ -205,7 +206,7 @@ const agent1 = new Agent({
     'This agent is used to do research, but not create full responses. Answer in bullet points only and be concise.',
   description:
     'This agent is used to do research, but not create full responses. Answer in bullet points only and be concise.',
-  model: anthropic('claude-3-5-sonnet-20240620'),
+  model: openai('gpt-4o'),
 });
 
 const agent2 = new Agent({
@@ -213,7 +214,7 @@ const agent2 = new Agent({
   description: 'This agent is used to do text synthesis on researched material. It writes articles in full paragraphs.',
   instructions:
     'This agent is used to do text synthesis on researched material. Write a full report based on the researched material. Do not use bullet points. Write full paragraphs. There should not be a single bullet point in the final report. You write articles.',
-  model: anthropic('claude-3-5-sonnet-20240620'),
+  model: openai('gpt-4o'),
 });
 
 const agentStep1 = createStep({
@@ -275,7 +276,7 @@ export const v_nextNetwork = new NewAgentNetwork({
   name: 'Test Network',
   instructions:
     'You can research cities. You can also synthesize research material. You can also write a full report based on the researched material. You can also get weather information. workflow1 is the best primitive for researching an *individual* city and it should always be used when running multiple primitives to accomplish a task.',
-  model: anthropic('claude-3-5-sonnet-20240620'),
+  model: openai('gpt-4o'),
   agents: {
     agent1,
     agent2,

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

@@ -12,6 +12,7 @@
     "@mastra/memory": "latest",
     "@mastra/voice-openai": "latest",
     "@mastra/libsql": "latest",
+    "@mastra/evals": "latest",
     "ai": "^4.3.16",
     "fetch-to-node": "^2.1.0",
     "mastra": "latest",
@@ -469,6 +470,7 @@ import {
   ModerationInputProcessor,
 } from '@mastra/core/agent/input-processor/processors';
 import { MCPClient } from '@mastra/mcp';
+import { createAnswerRelevancyScorer } from '@mastra/evals/scorers/llm';
 
 const memory = new Memory();
 
@@ -645,6 +647,35 @@ export const chefAgentResponses = new Agent({
   ],
 });
 
+const answerRelevance = createAnswerRelevancyScorer({
+  model: openai('gpt-4o'),
+});
+
+console.log(`answerRelevance`, answerRelevance);
+
+export const evalAgent = new Agent({
+  name: 'Eval Agent',
+  instructions: `
+    You are a helpful assistant with a weather tool.
+    `,
+  model: openai('gpt-4o'),
+  tools: {
+    weatherInfo,
+  },
+  memory: new Memory({
+    options: {
+      workingMemory: {
+        enabled: true,
+      },
+    },
+  }),
+  scorers: {
+    answerRelevance: {
+      scorer: answerRelevance,
+    },
+  },
+});
+
 ```
 
 ### mastra/index.ts
@@ -653,7 +684,7 @@ import { Mastra } from '@mastra/core';
 import { PinoLogger } from '@mastra/loggers';
 import { LibSQLStore } from '@mastra/libsql';
 
-import { chefAgent, chefAgentResponses, dynamicAgent } from './agents/index';
+import { chefAgent, chefAgentResponses, dynamicAgent, evalAgent } from './agents/index';
 import { myMcpServer, myMcpServerTwo } from './mcp/server';
 import { myWorkflow } from './workflows';
 
@@ -662,7 +693,7 @@ const storage = new LibSQLStore({
 });
 
 export const mastra = new Mastra({
-  agents: { chefAgent, chefAgentResponses, dynamicAgent },
+  agents: { chefAgent, chefAgentResponses, dynamicAgent, evalAgent },
   logger: new PinoLogger({ name: 'Chef', level: 'debug' }),
   storage,
   mcpServers: {

package/.docs/raw/agents/overview.mdx

@@ -238,7 +238,7 @@ const response = await testAgent.generate(
 );
 ```
 
-### Streaming progress with `onStepFinish`
+### Using `onStepFinish`
 
 You can monitor the progress of multi-step operations using the `onStepFinish` callback. This is useful for debugging or providing progress updates to users.
 
@@ -256,6 +256,26 @@ const response = await testAgent.generate(
 );
 ```
 
+### Streaming steps with `onChunk`
+
+You can monitor the progress of multi-step operations using the `onChunk` callback. This is useful for debugging or providing progress updates to users.
+
+```typescript showLineNumbers copy
+const stream = await testAgent.stream(
+  [{ role: "user", content: "Calculate the taxi driver's daily earnings." }],
+  {
+    maxSteps: 5,
+    onChunk: ({ chunk }) => {
+      console.log("Chunk", chunk);
+    },
+  },
+);
+
+for await (const chunk of stream.textStream) {
+  console.log(chunk);
+}
+```
+
 ### Detecting completion with `onFinish`
 
 The `onFinish` callback is available when streaming responses and provides detailed information about the completed interaction. It is called after the LLM has finished generating its response and all tool executions have completed.

package/.docs/raw/getting-started/mcp-docs-server.mdx

@@ -51,7 +51,7 @@ To add the MCP Docs Server to an existing project, install it manually.
 
 - **Cursor**: Edit `.cursor/mcp.json` in your project root, or `~/.cursor/mcp.json` for global configuration
 - **Windsurf**: Edit `~/.codeium/windsurf/mcp_config.json` (only supports global configuration)
-- **VSCode**: Edit `~/.vscode/mcp.json` in your project root
+- **VSCode**: Either move the created `.vscode` folder into the top-level of your workspace or open the created folder as your new workspace root. Edit `~/.vscode/mcp.json` in your project root.
   Add the following configuration:
 
 ### MacOS/Linux
@@ -194,7 +194,7 @@ In both IDEs it may take a minute for the MCP server to start the first time as
   className="rounded-lg"
 />
 
-MCP only works in Agent mode in VSCode. Once you are in agent mode, open the `mcp.json` file and click the "start" button.
+MCP only works in Agent mode in VSCode. Once you are in agent mode, open the `mcp.json` file and click the "start" button. Note that the "start" button will only appear if the `.vscode` folder containing `mcp.json` is in your workspace root, or the highest level of the in-editor file explorer.
 
 <br />
 <img

package/.docs/raw/rag/chunking-and-embedding.mdx

@@ -22,6 +22,7 @@ Use `chunk` to split documents into manageable pieces. Mastra supports multiple
 - `character`: Simple character-based splits
 - `token`: Token-aware splitting
 - `markdown`: Markdown-aware splitting
+- `semantic-markdown`: Markdown splitting based on related header families
 - `html`: HTML structure-aware splitting
 - `json`: JSON structure-aware splitting
 - `latex`: LaTeX structure-aware splitting
@@ -56,6 +57,16 @@ const chunks = await doc.chunk({
 });
 ```
 
+For markdown documents where preserving the semantic relationships between sections is important, here's an example of how to use the `semantic-markdown` strategy:
+
+```ts showLineNumbers copy
+const chunks = await doc.chunk({
+  strategy: "semantic-markdown",
+  joinThreshold: 500,
+  modelName: "gpt-3.5-turbo",
+});
+```
+
 **Note:** Metadata extraction may use LLM calls, so ensure your API key is set.
 
 We go deeper into chunking strategies in our [chunk documentation](/reference/rag/chunk.mdx).

package/.docs/raw/reference/agents/agent.mdx

@@ -1,32 +1,35 @@
 ---
 title: "Reference: Agent | Agents | Mastra Docs"
-description: "Documentation for the Agent class in Mastra, which provides the foundation for creating AI agents with various capabilities."
+description: "Documentation for the `Agent` class in Mastra, which provides the foundation for creating AI agents with various capabilities."
 ---
 
 # Agent
 
 The `Agent` class is the foundation for creating AI agents in Mastra. It provides methods for generating responses, streaming interactions, and handling voice capabilities.
 
-## Importing
+## Usage example
 
-```typescript
+```typescript filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
+import { openai } from "@ai-sdk/openai";
 import { Agent } from "@mastra/core/agent";
-```
-
-## Constructor
 
-Creates a new Agent instance with the specified configuration.
-
-```typescript
-constructor(config: AgentConfig<TAgentId, TTools, TMetrics>)
+const agent = new Agent({
+  name: "test-agent",
+  instructions: 'message for agent',
+  model: openai("gpt-4o")
+});
 ```
 
-### Parameters
-
-<br />
+## Constructor parameters
 
 <PropertiesTable
   content={[
+    {
+      name: "id",
+      type: "string",
+      isOptional: true,
+      description: "Optional unique identifier for the agent. Defaults to `name` if not provided.",
+    },
     {
       name: "name",
       type: "string",
@@ -37,75 +40,98 @@ constructor(config: AgentConfig<TAgentId, TTools, TMetrics>)
       name: "description",
       type: "string",
       isOptional: true,
-      description:
-        "An optional description of the agent\'s purpose and capabilities.",
+      description: "Optional description of the agent's purpose and capabilities.",
     },
     {
       name: "instructions",
       type: "string | ({ runtimeContext: RuntimeContext }) => string | Promise<string>",
       isOptional: false,
-      description:
-        "Instructions that guide the agent's behavior. Can be a static string or a function that returns a string.",
+      description: "Instructions that guide the agent's behavior. Can be a static string or a function that returns a string dynamically.",
     },
     {
       name: "model",
       type: "MastraLanguageModel | ({ runtimeContext: RuntimeContext }) => MastraLanguageModel | Promise<MastraLanguageModel>",
       isOptional: false,
-      description:
-        "The language model to use for generating responses. Can be a model instance or a function that returns a model.",
+      description: "The language model used by the agent. Can be provided statically or resolved at runtime.",
     },
     {
       name: "tools",
       type: "ToolsInput | ({ runtimeContext: RuntimeContext }) => ToolsInput | Promise<ToolsInput>",
       isOptional: true,
-      description:
-        "Tools that the agent can use. Can be a static object or a function that returns tools.",
+      description: "Tools that the agent can access. Can be provided statically or resolved dynamically.",
     },
     {
-      name: "inputProcessors",
-      type: "InputProcessor[] | ({ runtimeContext: RuntimeContext }) => InputProcessor[] | Promise<InputProcessor[]>",
+      name: "workflows",
+      type: "Record<string, Workflow> | ({ runtimeContext: RuntimeContext }) => Record<string, Workflow> | Promise<Record<string, Workflow>>",
       isOptional: true,
-      description:
-        "Input processors that run sequentially before messages are sent to the language model. These middleware components can intercept, modify, validate, or filter messages. Each processor receives an array of MastraMessageV2 objects and an abort function for early termination. Can be a static array or a function that returns processors based on runtime context.",
+      description: "Workflows that the agent can execute. Can be static or dynamically resolved.",
     },
     {
       name: "defaultGenerateOptions",
-      type: "AgentGenerateOptions",
+      type: "AgentGenerateOptions | ({ runtimeContext: RuntimeContext }) => AgentGenerateOptions | Promise<AgentGenerateOptions>",
       isOptional: true,
-      description: "Default options to use when calling generate().",
+      description: "Default options used when calling `generate()`.",
     },
     {
       name: "defaultStreamOptions",
-      type: "AgentStreamOptions",
+      type: "AgentStreamOptions | ({ runtimeContext: RuntimeContext }) => AgentStreamOptions | Promise<AgentStreamOptions>",
       isOptional: true,
-      description: "Default options to use when calling stream().",
+      description: "Default options used when calling `stream()`.",
     },
     {
-      name: "workflows",
-      type: "Record<string, NewWorkflow> | ({ runtimeContext: RuntimeContext }) => Record<string, NewWorkflow> | Promise<Record<string, NewWorkflow>>",
+      name: "defaultVNextStreamOptions",
+      type: "AgentVNextStreamOptions | ({ runtimeContext: RuntimeContext }) => AgentVNextStreamOptions | Promise<AgentVNextStreamOptions>",
+      isOptional: true,
+      description: "Default options used when calling `stream()` in vNext mode.",
+    },
+    {
+      name: "mastra",
+      type: "Mastra",
+      isOptional: true,
+      description: "Reference to the Mastra runtime instance (injected automatically).",
+    },
+    {
+      name: "scorers",
+      type: "MastraScorers | ({ runtimeContext: RuntimeContext }) => MastraScorers | Promise<MastraScorers>",
       isOptional: true,
-      description:
-        "Workflows that the agent can execute. Can be a static object or a function that returns workflows.",
+      description: "Scoring configuration for runtime evaluation and telemetry. Can be static or dynamically provided.",
     },
     {
       name: "evals",
       type: "Record<string, Metric>",
       isOptional: true,
-      description: "Evaluation metrics for assessing agent performance.",
+      description: "Evaluation metrics for scoring agent responses.",
     },
     {
       name: "memory",
       type: "MastraMemory | ({ runtimeContext: RuntimeContext }) => MastraMemory | Promise<MastraMemory>",
       isOptional: true,
-      description:
-        "Memory system for the agent to store and retrieve information. Can be a static memory instance or a function that returns a memory instance based on runtime context.",
+      description: "Memory module used for storing and retrieving stateful context.",
     },
     {
       name: "voice",
       type: "CompositeVoice",
       isOptional: true,
-      description:
-        "Voice capabilities for speech-to-text and text-to-speech functionality.",
+      description: "Voice settings for speech input and output.",
+    },
+    {
+      name: "inputProcessors",
+      type: "InputProcessor[] | ({ runtimeContext: RuntimeContext }) => InputProcessor[] | Promise<InputProcessor[]>",
+      isOptional: true,
+      description: "Input processors that can modify or validate messages before they are processed by the agent.",
+    },
+  ]}
+/>
+
+## Returns
+
+<PropertiesTable
+  content={[
+    {
+      name: "agent",
+      type: "Agent<TAgentId, TTools, TMetrics>",
+      description: "A new Agent instance with the specified configuration.",
     },
   ]}
 />
+