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

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

@@ -1,5 +1,25 @@
 # mastra
 
+## 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
@@ -278,25 +298,5 @@
 - 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.
+
+... 4817 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.",
     },
   ]}
 />
+