@mastra/mcp-docs-server 0.13.14-alpha.0 → 0.13.14-alpha.2

package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md

@@ -1,5 +1,14 @@
 # @mastra/voice-sarvam
 
+## 0.10.9-alpha.0
+
+### Patch Changes
+
+- [#6942](https://github.com/mastra-ai/mastra/pull/6942) [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01) Thanks [@wardpeet](https://github.com/wardpeet)! - Add zod as peerdeps for all packages
+
+- Updated dependencies [[`943a7f3`](https://github.com/mastra-ai/mastra/commit/943a7f3dbc6a8ab3f9b7bc7c8a1c5b319c3d7f56), [`be49354`](https://github.com/mastra-ai/mastra/commit/be493546dca540101923ec700feb31f9a13939f2), [`d591ab3`](https://github.com/mastra-ai/mastra/commit/d591ab3ecc985c1870c0db347f8d7a20f7360536), [`ba82abe`](https://github.com/mastra-ai/mastra/commit/ba82abe76e869316bb5a9c95e8ea3946f3436fae), [`727f7e5`](https://github.com/mastra-ai/mastra/commit/727f7e5086e62e0dfe3356fb6dcd8bcb420af246), [`82d9f64`](https://github.com/mastra-ai/mastra/commit/82d9f647fbe4f0177320e7c05073fce88599aa95), [`4189486`](https://github.com/mastra-ai/mastra/commit/4189486c6718fda78347bdf4ce4d3fc33b2236e1), [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01)]:
+  - @mastra/core@0.14.2-alpha.1
+
 ## 0.10.8
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 - Updated dependencies [344f453]
 - Updated dependencies [0a3ae6d]
 - Updated dependencies [95911be]
-- Updated dependencies [5eb5a99]
-- Updated dependencies [7e632c5]
-- Updated dependencies [1e9fbfa]
-- Updated dependencies [b2ae5aa]
-- Updated dependencies [a7292b0]
-- Updated dependencies [0dcb9f0]
-  - @mastra/core@0.10.0-alpha.1
-
-## 0.1.14-alpha.0
 
-... 741 more lines hidden. See full changelog in package directory.
+... 750 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md

@@ -1,5 +1,14 @@
 # @mastra/voice-speechify
 
+## 0.10.9-alpha.0
+
+### Patch Changes
+
+- [#6942](https://github.com/mastra-ai/mastra/pull/6942) [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01) Thanks [@wardpeet](https://github.com/wardpeet)! - Add zod as peerdeps for all packages
+
+- Updated dependencies [[`943a7f3`](https://github.com/mastra-ai/mastra/commit/943a7f3dbc6a8ab3f9b7bc7c8a1c5b319c3d7f56), [`be49354`](https://github.com/mastra-ai/mastra/commit/be493546dca540101923ec700feb31f9a13939f2), [`d591ab3`](https://github.com/mastra-ai/mastra/commit/d591ab3ecc985c1870c0db347f8d7a20f7360536), [`ba82abe`](https://github.com/mastra-ai/mastra/commit/ba82abe76e869316bb5a9c95e8ea3946f3436fae), [`727f7e5`](https://github.com/mastra-ai/mastra/commit/727f7e5086e62e0dfe3356fb6dcd8bcb420af246), [`82d9f64`](https://github.com/mastra-ai/mastra/commit/82d9f647fbe4f0177320e7c05073fce88599aa95), [`4189486`](https://github.com/mastra-ai/mastra/commit/4189486c6718fda78347bdf4ce4d3fc33b2236e1), [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01)]:
+  - @mastra/core@0.14.2-alpha.1
+
 ## 0.10.8
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 - Updated dependencies [d0ee3c6]
 - Updated dependencies [b2ae5aa]
 - Updated dependencies [23f258c]
-- Updated dependencies [a7292b0]
-- Updated dependencies [0dcb9f0]
-- Updated dependencies [2672a05]
-  - @mastra/core@0.10.0
-
-## 0.2.0-alpha.1
-
-### Minor Changes
-
 
-... 1095 more lines hidden. See full changelog in package directory.
+... 1104 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,7 @@
 # create-mastra
 
+## 0.10.24-alpha.1
+
 ## 0.10.24-alpha.0
 
 ### Patch Changes
@@ -296,7 +298,5 @@
 - f78f399: Make AgentModelSettings shareable between cloud and playground
 - 57929df: agent network display
 
-## 0.10.8-alpha.0
-
 
-... 1240 more lines hidden. See full changelog in package directory.
+... 1242 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,16 @@
 # mastra
 
+## 0.10.24-alpha.1
+
+### Patch Changes
+
+- [#6942](https://github.com/mastra-ai/mastra/pull/6942) [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01) Thanks [@wardpeet](https://github.com/wardpeet)! - Add zod as peerdeps for all packages
+
+- Updated dependencies [[`2b38a60`](https://github.com/mastra-ai/mastra/commit/2b38a60da0c1153028d8241c7748b41c5fb81121), [`943a7f3`](https://github.com/mastra-ai/mastra/commit/943a7f3dbc6a8ab3f9b7bc7c8a1c5b319c3d7f56), [`681252d`](https://github.com/mastra-ai/mastra/commit/681252d20e57fcee6821377dea96cacab3bc230f), [`01be5d3`](https://github.com/mastra-ai/mastra/commit/01be5d358fad8faa101e5c69dfa54562c02cc0af), [`24d9ee3`](https://github.com/mastra-ai/mastra/commit/24d9ee3db1c09d15f27a5d0971b102abcfcf7dfd), [`be49354`](https://github.com/mastra-ai/mastra/commit/be493546dca540101923ec700feb31f9a13939f2), [`d591ab3`](https://github.com/mastra-ai/mastra/commit/d591ab3ecc985c1870c0db347f8d7a20f7360536), [`ba82abe`](https://github.com/mastra-ai/mastra/commit/ba82abe76e869316bb5a9c95e8ea3946f3436fae), [`727f7e5`](https://github.com/mastra-ai/mastra/commit/727f7e5086e62e0dfe3356fb6dcd8bcb420af246), [`82d9f64`](https://github.com/mastra-ai/mastra/commit/82d9f647fbe4f0177320e7c05073fce88599aa95), [`4189486`](https://github.com/mastra-ai/mastra/commit/4189486c6718fda78347bdf4ce4d3fc33b2236e1), [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01)]:
+  - @mastra/deployer@0.14.2-alpha.1
+  - @mastra/core@0.14.2-alpha.1
+  - @mastra/mcp@0.10.13-alpha.1
+
 ## 0.10.24-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [7b8172f]
 - Updated dependencies [cb36de0]
 - Updated dependencies [d0496e6]
-- Updated dependencies [a82b851]
-- Updated dependencies [ea0c5f2]
-- Updated dependencies [41a0a0e]
-- Updated dependencies [2871020]
-- Updated dependencies [9e792ef]
-- Updated dependencies [94f4812]
-- Updated dependencies [e202b82]
-- Updated dependencies [e00f6a0]
-- Updated dependencies [4a406ec]
-- Updated dependencies [b0e43c1]
-- Updated dependencies [5d377e5]
-
-... 5064 more lines hidden. See full changelog in package directory.
+
+... 5075 more lines hidden. See full changelog in package directory.

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

@@ -1113,10 +1113,10 @@ const step2 = createStep({
   outputSchema: z.object({
     result: z.string(),
   }),
-  execute: async ({ inputData, mastra, aiTracingContext }) => {
+  execute: async ({ inputData, mastra, tracingContext }) => {
     const agent = mastra.getAgent('chefAgentResponses');
     const response = await agent.generate(inputData.result, {
-      aiTracingContext,
+      tracingContext,
     });
     return {
       result: 'suh',

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

@@ -0,0 +1,276 @@
+### package.json
+```json
+{
+  "name": "example-headsup",
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "dependencies": {
+    "@ai-sdk/openai": "^1.3.23",
+    "@mastra/core": "^0.14.1",
+    "@mastra/libsql": "^0.13.4",
+    "@mastra/loggers": "^0.10.7",
+    "@mastra/memory": "^0.13.1",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "mastra": "^0.10.23",
+    "typescript": "^5.9.2"
+  }
+}
+```
+
+### mastra/agents/example-famous-person-agent.ts
+```typescript
+import { openai } from '@ai-sdk/openai';
+import { Agent } from '@mastra/core/agent';
+import { Memory } from '@mastra/memory';
+import { LibSQLVector } from '@mastra/libsql';
+
+export const famousPersonAgent = new Agent({
+  name: 'Famous Person Generator',
+  instructions: `You are a famous person generator for a "Heads Up" guessing game.
+
+Generate the name of a well-known famous person who:
+- Is recognizable to most people
+- Has distinctive characteristics that can be described with yes/no questions
+- Is appropriate for all audiences
+- Has a clear, unambiguous name
+
+IMPORTANT: Use your memory to check what famous people you've already suggested and NEVER repeat a person you've already suggested.
+
+Examples: Albert Einstein, Beyoncé, Leonardo da Vinci, Oprah Winfrey, Michael Jordan
+
+Return only the person's name, nothing else.`,
+  model: openai('gpt-4o'),
+  memory: new Memory({
+    vector: new LibSQLVector({
+      connectionUrl: 'file:../mastra.db',
+    }),
+    embedder: openai.embedding('text-embedding-3-small'),
+    options: {
+      lastMessages: 5,
+      semanticRecall: {
+        topK: 10,
+        messageRange: 1,
+      },
+    },
+  }),
+});
+
+```
+
+### mastra/agents/example-game-agent.ts
+```typescript
+import { openai } from '@ai-sdk/openai';
+import { Agent } from '@mastra/core/agent';
+
+export const gameAgent = new Agent({
+  name: 'Game Agent',
+  instructions: `You are a helpful game assistant for a "Heads Up" guessing game.
+
+CRITICAL: You know the famous person's name but you must NEVER reveal it in any response.
+
+When a user asks a question about the famous person:
+- Answer truthfully based on the famous person provided
+- Keep responses concise and friendly
+- NEVER mention the person's name, even if it seems natural
+- NEVER reveal gender, nationality, or other characteristics unless specifically asked about them
+- Answer yes/no questions with clear "Yes" or "No" responses
+- Be consistent - same question asked differently should get the same answer
+- Ask for clarification if a question is unclear
+- If multiple questions are asked at once, ask them to ask one at a time
+
+When they make a guess:
+- If correct: Congratulate them warmly
+- If incorrect: Politely correct them and encourage them to try again
+
+Encourage players to make a guess when they seem to have enough information.
+
+You must return a JSON object with:
+- response: Your response to the user
+- gameWon: true if they guessed correctly, false otherwise`,
+  model: openai('gpt-4o'),
+});
+
+```
+
+### mastra/index.ts
+```typescript
+import { Mastra } from '@mastra/core/mastra';
+import { PinoLogger } from '@mastra/loggers';
+import { LibSQLStore } from '@mastra/libsql';
+import { headsUpWorkflow } from './workflows/example-heads-up-workflow';
+
+import { famousPersonAgent } from './agents/example-famous-person-agent';
+import { gameAgent } from './agents/example-game-agent';
+import { guessVerifierAgent } from './agents/example-guess-verifier-agent';
+
+export const mastra = new Mastra({
+  workflows: { headsUpWorkflow },
+  agents: { famousPersonAgent, gameAgent, guessVerifierAgent },
+  storage: new LibSQLStore({
+    // stores telemetry, evals, ... into file storage for persistence across playground refreshes
+    url: 'file:../mastra.db',
+  }),
+  logger: new PinoLogger({
+    name: 'Mastra',
+    level: 'info',
+  }),
+});
+
+```
+
+### mastra/workflows/example-heads-up-workflow.ts
+```typescript
+import { createWorkflow, createStep } from '@mastra/core/workflows';
+import { z } from 'zod';
+import { Pool } from 'pg';
+
+// PostgreSQL client
+const pool = new Pool({
+  connectionString: process.env.DATABASE_URL!,
+});
+
+const startStep = createStep({
+  id: 'start-step',
+  description: "Generate a famous person's name",
+  inputSchema: z.object({
+    start: z.boolean(),
+  }),
+  outputSchema: z.object({
+    famousPerson: z.string(),
+    guessCount: z.number(),
+  }),
+  execute: async ({ mastra }) => {
+    const agent = mastra.getAgent('famousPersonAgent');
+    const response = await agent.generate("Generate a famous person's name", {
+      temperature: 1.2,
+      topP: 0.9,
+      memory: {
+        resource: 'heads-up-game',
+        thread: 'famous-person-generator',
+      },
+    });
+    const famousPerson = response.text.trim();
+    return { famousPerson, guessCount: 0 };
+  },
+});
+
+const gameStep = createStep({
+  id: 'game-step',
+  description: 'Handles the question-answer-continue loop',
+  inputSchema: z.object({
+    famousPerson: z.string(),
+    guessCount: z.number(),
+  }),
+  resumeSchema: z.object({
+    userMessage: z.string(),
+  }),
+  suspendSchema: z.object({
+    agentResponse: z.string(),
+  }),
+  outputSchema: z.object({
+    famousPerson: z.string(),
+    gameWon: z.boolean(),
+    agentResponse: z.string(),
+    guessCount: z.number(),
+  }),
+  execute: async ({ inputData, mastra, resumeData, suspend }) => {
+    let { famousPerson, guessCount } = inputData;
+    const { userMessage } = resumeData ?? {};
+
+    if (!userMessage) {
+      // First time - ask for a question
+      const message = "I'm thinking of a famous person. Ask me yes/no questions to figure out who it is!";
+
+      await suspend({
+        agentResponse: message,
+      });
+
+      return { famousPerson, gameWon: false, agentResponse: message, guessCount };
+    } else {
+      // Check if the user's message is a guess by using the guess verifier agent
+      const guessVerifier = mastra.getAgent('guessVerifierAgent');
+      const verificationResponse = await guessVerifier.generate(
+        [
+          {
+            role: 'user',
+            content: `Actual famous person: ${famousPerson}
+              User's guess: "${userMessage}"
+              Is this correct?`,
+          },
+        ],
+        {
+          output: z.object({
+            isCorrect: z.boolean(),
+          }),
+        },
+      );
+
+      const gameWon = verificationResponse.object.isCorrect;
+
+      // Let the agent handle the user's message (question or guess)
+      const agent = mastra.getAgent('gameAgent');
+      const response = await agent.generate(`
+      The famous person is: ${famousPerson}
+      The user asked: "${userMessage}"
+      Is this a correct guess: ${gameWon}
+      Please respond appropriately.
+    `);
+
+      const agentResponse = response.text;
+
+      // Increment the guess count
+      guessCount++;
+
+      return { famousPerson, gameWon, agentResponse, guessCount };
+    }
+  },
+});
+
+const winStep = createStep({
+  id: 'win-step',
+  description: 'Handle game win logic',
+  inputSchema: z.object({
+    famousPerson: z.string(),
+    gameWon: z.boolean(),
+    agentResponse: z.string(),
+    guessCount: z.number(),
+  }),
+  outputSchema: z.object({
+    famousPerson: z.string(),
+    gameWon: z.boolean(),
+    guessCount: z.number(),
+  }),
+  execute: async ({ inputData }) => {
+    const { famousPerson, gameWon, guessCount } = inputData;
+
+    await pool.query('INSERT INTO heads_up_games (famous_person, game_won, guess_count) VALUES ($1, $2, $3)', [
+      famousPerson,
+      gameWon,
+      guessCount,
+    ]);
+
+    return { famousPerson, gameWon, guessCount };
+  },
+});
+
+export const headsUpWorkflow = createWorkflow({
+  id: 'heads-up-workflow',
+  inputSchema: z.object({
+    start: z.boolean(),
+  }),
+  outputSchema: z.object({
+    famousPerson: z.string(),
+    gameWon: z.boolean(),
+    guessCount: z.number(),
+  }),
+})
+  .then(startStep)
+  .dountil(gameStep, async ({ inputData: { gameWon } }) => gameWon)
+  .then(winStep)
+  .commit();
+
+```

package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx

@@ -416,7 +416,7 @@ Mastra automatically handles AI SDK v4 data using its internal `MessageList` cla
 For cases where you need to manually convert messages between AI SDK and Mastra formats, use the `convertMessages` utility:
 
 ```typescript
-import { convertMessages } from '@mastra/core';
+import { convertMessages } from '@mastra/core/agent';
 
 // Convert AI SDK v4 messages to v5
 const aiv5Messages = convertMessages(aiv4Messages).to('AIV5.UI');

package/.docs/raw/reference/client-js/mastra-client.mdx

@@ -54,6 +54,12 @@ export const mastraClient = new MastraClient({
       description: "An object containing custom HTTP headers to include with every request.",
       isOptional: true,
     },
+    {
+      name: "credentials",
+      type: '"omit" | "same-origin" | "include"',
+      description: "Credentials mode for requests. See https://developer.mozilla.org/en-US/docs/Web/API/Request/credentials for more info.",
+      isOptional: true,
+    },
   ]}
 />
 

package/.docs/raw/reference/scorers/create-scorer.mdx

@@ -79,7 +79,7 @@ This function returns a scorer builder that you can chain step methods onto. See
 For better type inference and IntelliSense support, you can specify input/output types when creating scorers:
 
 ```typescript
-import { createScorer, ScorerRunInputForAgent, ScorerRunOutputForAgent } from '@mastra/core';
+import { createScorer, ScorerRunInputForAgent, ScorerRunOutputForAgent } from '@mastra/core/scorers';
 
 // For agent evaluation with full type safety
 const agentScorer = createScorer<ScorerRunInputForAgent, ScorerRunOutputForAgent>({

package/.docs/raw/reference/scorers/tool-call-accuracy.mdx

@@ -0,0 +1,211 @@
+---
+title: "Reference: Tool Call Accuracy | Scorers | Mastra Docs"
+description: Documentation for the Tool Call Accuracy Scorers in Mastra, which evaluate whether LLM outputs call the correct tools from available options.
+---
+
+# Tool Call Accuracy Scorers
+
+Mastra provides two tool call accuracy scorers for evaluating whether an LLM selects the correct tools from available options:
+
+1. **Code-based scorer** - Deterministic evaluation using exact tool matching
+2. **LLM-based scorer** - Semantic evaluation using AI to assess appropriateness
+
+For usage examples, see the [Tool Call Accuracy Examples](/examples/scorers/tool-call-accuracy).
+
+## Code-Based Tool Call Accuracy Scorer
+
+The `createToolCallAccuracyScorerCode()` function from `@mastra/evals/scorers/code` provides deterministic binary scoring based on exact tool matching and supports both strict and lenient evaluation modes, as well as tool calling order validation.
+
+### Parameters
+
+<PropertiesTable
+  content={[
+    {
+      name: "expectedTool",
+      type: "string",
+      description: "The name of the tool that should be called for the given task. Ignored when expectedToolOrder is provided.",
+      required: false,
+    },
+    {
+      name: "strictMode",
+      type: "boolean",
+      description: "Controls evaluation strictness. For single tool mode: only exact single tool calls accepted. For order checking mode: tools must match exactly with no extra tools allowed.",
+      required: false,
+      default: "false",
+    },
+    {
+      name: "expectedToolOrder",
+      type: "string[]",
+      description: "Array of tool names in the expected calling order. When provided, enables order checking mode and ignores expectedTool parameter.",
+      required: false,
+    },
+  ]}
+/>
+
+This function returns an instance of the MastraScorer class. See the [MastraScorer reference](./mastra-scorer) for details on the `.run()` method and its input/output.
+
+### Evaluation Modes
+
+The code-based scorer operates in two distinct modes:
+
+#### Single Tool Mode
+
+When `expectedToolOrder` is not provided, the scorer evaluates single tool selection:
+
+- **Standard Mode (strictMode: false)**: Returns `1` if the expected tool is called, regardless of other tools
+- **Strict Mode (strictMode: true)**: Returns `1` only if exactly one tool is called and it matches the expected tool
+
+#### Order Checking Mode
+
+When `expectedToolOrder` is provided, the scorer validates tool calling sequence:
+
+- **Strict Order (strictMode: true)**: Tools must be called in exactly the specified order with no extra tools
+- **Flexible Order (strictMode: false)**: Expected tools must appear in correct relative order (extra tools allowed)
+
+### Examples
+
+```typescript
+import { createToolCallAccuracyScorerCode } from '@mastra/evals/scorers/code';
+
+// Single tool validation
+const scorer = createToolCallAccuracyScorerCode({
+  expectedTool: 'weather-tool'
+});
+
+// Strict single tool (no other tools allowed)
+const strictScorer = createToolCallAccuracyScorerCode({
+  expectedTool: 'calculator-tool',
+  strictMode: true
+});
+
+// Tool order validation
+const orderScorer = createToolCallAccuracyScorerCode({
+  expectedTool: 'search-tool', // ignored when order is specified
+  expectedToolOrder: ['search-tool', 'weather-tool'],
+  strictMode: true // exact match required
+});
+```
+
+## LLM-Based Tool Call Accuracy Scorer
+
+The `createToolCallAccuracyScorerLLM()` function from `@mastra/evals/scorers/llm` uses an LLM to evaluate whether the tools called by an agent are appropriate for the given user request, providing semantic evaluation rather than exact matching.
+
+### Parameters
+
+<PropertiesTable
+  content={[
+    {
+      name: "model",
+      type: "MastraLanguageModel",
+      description: "The LLM model to use for evaluating tool appropriateness",
+      required: true,
+    },
+    {
+      name: "availableTools",
+      type: "Array<{name: string, description: string}>",
+      description: "List of available tools with their descriptions for context",
+      required: true,
+    },
+  ]}
+/>
+
+### Features
+
+The LLM-based scorer provides:
+
+- **Semantic Evaluation**: Understands context and user intent
+- **Appropriateness Assessment**: Distinguishes between "helpful" and "appropriate" tools
+- **Clarification Handling**: Recognizes when agents appropriately ask for clarification
+- **Missing Tool Detection**: Identifies tools that should have been called
+- **Reasoning Generation**: Provides explanations for scoring decisions
+
+### Evaluation Process
+
+1. **Extract Tool Calls**: Identifies tools mentioned in agent output
+2. **Analyze Appropriateness**: Evaluates each tool against user request
+3. **Generate Score**: Calculates score based on appropriate vs total tool calls
+4. **Generate Reasoning**: Provides human-readable explanation
+
+### Examples
+
+```typescript
+import { createToolCallAccuracyScorerLLM } from '@mastra/evals/scorers/llm';
+import { openai } from '@ai-sdk/openai';
+
+const llmScorer = createToolCallAccuracyScorerLLM({
+  model: openai('gpt-4o-mini'),
+  availableTools: [
+    {
+      name: 'weather-tool',
+      description: 'Get current weather information for any location'
+    },
+    {
+      name: 'search-tool',
+      description: 'Search the web for information'
+    },
+    {
+      name: 'calendar-tool',
+      description: 'Check calendar events and scheduling'
+    }
+  ]
+});
+
+const result = await llmScorer.run(agentRun);
+console.log(result.score); // 0.0 to 1.0
+console.log(result.reason); // Explanation of the score
+```
+
+## Choosing Between Scorers
+
+### Use the Code-Based Scorer When:
+
+- You need **deterministic, reproducible** results
+- You want to test **exact tool matching**
+- You need to validate **specific tool sequences**
+- Speed and cost are priorities (no LLM calls)
+- You're running automated tests
+
+### Use the LLM-Based Scorer When:
+
+- You need **semantic understanding** of appropriateness
+- Tool selection depends on **context and intent**
+- You want to handle **edge cases** like clarification requests
+- You need **explanations** for scoring decisions
+- You're evaluating **production agent behavior**
+
+## Scoring Details
+
+### Code-Based Scoring
+
+- **Binary scores**: Always returns 0 or 1
+- **Deterministic**: Same input always produces same output
+- **Fast**: No external API calls
+
+### LLM-Based Scoring
+
+- **Fractional scores**: Returns values between 0.0 and 1.0
+- **Context-aware**: Considers user intent and appropriateness
+- **Explanatory**: Provides reasoning for scores
+
+## Use Cases
+
+### Code-Based Scorer Use Cases
+
+- **Unit Testing**: Verify specific tool selection behavior
+- **Regression Testing**: Ensure tool selection doesn't change
+- **Workflow Validation**: Check tool sequences in multi-step processes
+- **CI/CD Pipelines**: Fast, deterministic validation
+
+### LLM-Based Scorer Use Cases
+
+- **Quality Assurance**: Evaluate production agent behavior
+- **A/B Testing**: Compare different agent implementations
+- **User Intent Alignment**: Ensure tools match user needs
+- **Edge Case Handling**: Evaluate clarification and error scenarios
+
+## Related
+
+- [Answer Relevancy Scorer](./answer-relevancy)
+- [Completeness Scorer](./completeness)
+- [Faithfulness Scorer](./faithfulness)
+- [Custom Scorers](/docs/scorers/custom-scorers)

package/.docs/raw/scorers/off-the-shelf-scorers.mdx

@@ -19,6 +19,7 @@ These scorers evaluate how correct, truthful, and complete your agent's answers
 - [`completeness`](/reference/scorers/completeness): Checks if responses include all necessary information (`0-1`, higher is better)
 - [`content-similarity`](/reference/scorers/content-similarity): Measures textual similarity using character-level matching (`0-1`, higher is better)
 - [`textual-difference`](/reference/scorers/textual-difference): Measures textual differences between strings (`0-1`, higher means more similar)
+- [`tool-call-accuracy`](/reference/scorers/tool-call-accuracy): Evaluates whether the LLM selects the correct tool from available options (`0-1`, higher is better)
 
 ### Output Quality
 

package/.docs/raw/tools-mcp/mcp-overview.mdx

@@ -341,7 +341,7 @@ When a tool includes an `outputSchema`, its `execute` function **must** return a
 Here's an example of a tool with an `outputSchema`:
 
 ```typescript filename="src/tools/structured-tool.ts"
-import { createTool } from '@mastra/core';
+import { createTool } from '@mastra/core/tools';
 import { z } from 'zod';
 
 export const structuredTool = createTool({

package/.docs/raw/workflows/control-flow.mdx

@@ -55,6 +55,8 @@ This executes `step1` and `step2` concurrently, then continues to `step3` after
 
 > See [Parallel Execution with Steps](/examples/workflows/parallel-steps) for more information.
 
+> 📹 Watch: How to run steps in parallel and optimize your Mastra workflow → [YouTube (3 minutes)](https://youtu.be/pTSOSWbreE0)
+
 ## Conditional logic with `.branch()`
 
 Execute steps conditionally using `.branch()`: