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

package/.docs/raw/reference/scorers/answer-similarity.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Answer Similarity | Scorers | Mastra Docs"
+title: "Reference: Answer Similarity Scorer | Scorers | Mastra Docs"
 description: Documentation for the Answer Similarity Scorer in Mastra, which compares agent outputs against ground truth answers for CI/CD testing.
 ---
 
@@ -15,7 +15,8 @@ The `createAnswerSimilarityScorer()` function creates a scorer that evaluates ho
       name: "model",
       type: "LanguageModel",
       required: true,
-      description: "The language model used to evaluate semantic similarity between outputs and ground truth.",
+      description:
+        "The language model used to evaluate semantic similarity between outputs and ground truth.",
     },
     {
       name: "options",
@@ -35,7 +36,8 @@ The `createAnswerSimilarityScorer()` function creates a scorer that evaluates ho
       type: "boolean",
       required: false,
       defaultValue: "true",
-      description: "Whether to require ground truth for evaluation. If false, missing ground truth returns score 0.",
+      description:
+        "Whether to require ground truth for evaluation. If false, missing ground truth returns score 0.",
     },
     {
       name: "semanticThreshold",
@@ -63,14 +65,16 @@ The `createAnswerSimilarityScorer()` function creates a scorer that evaluates ho
       type: "number",
       required: false,
       defaultValue: "1.0",
-      description: "Penalty for contradictory information. High value ensures wrong answers score near 0.",
+      description:
+        "Penalty for contradictory information. High value ensures wrong answers score near 0.",
     },
     {
       name: "extraInfoPenalty",
       type: "number",
       required: false,
       defaultValue: "0.05",
-      description: "Mild penalty for extra information not present in ground truth (capped at 0.2).",
+      description:
+        "Mild penalty for extra information not present in ground truth (capped at 0.2).",
     },
     {
       name: "scale",
@@ -96,12 +100,14 @@ This function returns an instance of the MastraScorer class. The `.run()` method
     {
       name: "score",
       type: "number",
-      description: "Similarity score between 0-1 (or 0-scale if custom scale used). Higher scores indicate better similarity to ground truth.",
+      description:
+        "Similarity score between 0-1 (or 0-scale if custom scale used). Higher scores indicate better similarity to ground truth.",
     },
     {
       name: "reason",
       type: "string",
-      description: "Human-readable explanation of the score with actionable feedback.",
+      description:
+        "Human-readable explanation of the score with actionable feedback.",
     },
     {
       name: "preprocessStepResult",
@@ -111,7 +117,8 @@ This function returns an instance of the MastraScorer class. The `.run()` method
     {
       name: "analyzeStepResult",
       type: "object",
-      description: "Detailed analysis of matches, contradictions, and extra information.",
+      description:
+        "Detailed analysis of matches, contradictions, and extra information.",
     },
     {
       name: "preprocessPrompt",
@@ -149,24 +156,26 @@ Score calculation: `max(0, base_score - contradiction_penalty - missing_penalty
 This scorer is designed for use with `runExperiment` for CI/CD testing:
 
 ```typescript
-import { runExperiment } from '@mastra/core/scores';
-import { createAnswerSimilarityScorer } from '@mastra/evals/scorers/llm';
+import { runExperiment } from "@mastra/core/scores";
+import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/llm";
 
 const scorer = createAnswerSimilarityScorer({ model });
 
 await runExperiment({
   data: [
-    { 
+    {
       input: "What is the capital of France?",
-      groundTruth: "Paris is the capital of France"
-    }
+      groundTruth: "Paris is the capital of France",
+    },
   ],
   scorers: [scorer],
   target: myAgent,
   onItemComplete: ({ scorerResults }) => {
     // Assert similarity score meets threshold
-    expect(scorerResults['Answer Similarity Scorer'].score).toBeGreaterThan(0.8);
-  }
+    expect(scorerResults["Answer Similarity Scorer"].score).toBeGreaterThan(
+      0.8,
+    );
+  },
 });
 ```
 
@@ -174,19 +183,19 @@ await runExperiment({
 
 In this example, the agent's output semantically matches the ground truth perfectly.
 
-```typescript filename="src/example-perfect-similarity.ts" showLineNumbers copy
+```typescript title="src/example-perfect-similarity.ts" showLineNumbers copy
 import { runExperiment } from "@mastra/core/scores";
 import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/llm";
 import { myAgent } from "./agent";
 
-const scorer = createAnswerSimilarityScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createAnswerSimilarityScorer({ model: "openai/gpt-4o-mini" });
 
 const result = await runExperiment({
   data: [
-    { 
+    {
       input: "What is 2+2?",
-      groundTruth: "4"
-    }
+      groundTruth: "4",
+    },
   ],
   scorers: [scorer],
   target: myAgent,
@@ -212,19 +221,19 @@ The output receives a perfect score because both the agent's answer and ground t
 
 In this example, the agent provides the same information as the ground truth but with different phrasing.
 
-```typescript filename="src/example-semantic-similarity.ts" showLineNumbers copy
+```typescript title="src/example-semantic-similarity.ts" showLineNumbers copy
 import { runExperiment } from "@mastra/core/scores";
 import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/llm";
 import { myAgent } from "./agent";
 
-const scorer = createAnswerSimilarityScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createAnswerSimilarityScorer({ model: "openai/gpt-4o-mini" });
 
 const result = await runExperiment({
   data: [
-    { 
+    {
       input: "What is the capital of France?",
       groundTruth: "The capital of France is Paris",
-    }
+    },
   ],
   scorers: [scorer],
   target: myAgent,
@@ -250,19 +259,19 @@ The output receives a high score because it conveys the same information with eq
 
 In this example, the agent's response is partially correct but missing key information.
 
-```typescript filename="src/example-partial-similarity.ts" showLineNumbers copy
+```typescript title="src/example-partial-similarity.ts" showLineNumbers copy
 import { runExperiment } from "@mastra/core/scores";
 import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/llm";
 import { myAgent } from "./agent";
 
-const scorer = createAnswerSimilarityScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createAnswerSimilarityScorer({ model: "openai/gpt-4o-mini" });
 
 const result = await runExperiment({
   data: [
-    { 
+    {
       input: "What are the primary colors?",
       groundTruth: "The primary colors are red, blue, and yellow",
-    }
+    },
   ],
   scorers: [scorer],
   target: myAgent,
@@ -288,19 +297,19 @@ The output receives a moderate score because it includes some correct informatio
 
 In this example, the agent provides factually incorrect information that contradicts the ground truth.
 
-```typescript filename="src/example-contradiction.ts" showLineNumbers copy
+```typescript title="src/example-contradiction.ts" showLineNumbers copy
 import { runExperiment } from "@mastra/core/scores";
 import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/llm";
 import { myAgent } from "./agent";
 
-const scorer = createAnswerSimilarityScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createAnswerSimilarityScorer({ model: "openai/gpt-4o-mini" });
 
 const result = await runExperiment({
   data: [
-    { 
+    {
       input: "Who wrote Romeo and Juliet?",
       groundTruth: "William Shakespeare wrote Romeo and Juliet",
-    }
+    },
   ],
   scorers: [scorer],
   target: myAgent,
@@ -326,50 +335,56 @@ The output receives a very low score because it contains factually incorrect inf
 
 Use the scorer in your test suites to ensure agent consistency over time:
 
-```typescript filename="src/ci-integration.test.ts" showLineNumbers copy
-import { describe, it, expect } from 'vitest';
+```typescript title="src/ci-integration.test.ts" showLineNumbers copy
+import { describe, it, expect } from "vitest";
 import { runExperiment } from "@mastra/core/scores";
 import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/llm";
 import { myAgent } from "./agent";
 
-describe('Agent Consistency Tests', () => {
-  const scorer = createAnswerSimilarityScorer({ model: 'openai/gpt-4o-mini' });
+describe("Agent Consistency Tests", () => {
+  const scorer = createAnswerSimilarityScorer({ model: "openai/gpt-4o-mini" });
 
-  it('should provide accurate factual answers', async () => {
+  it("should provide accurate factual answers", async () => {
     const result = await runExperiment({
       data: [
-        { 
+        {
           input: "What is the speed of light?",
-          groundTruth: "The speed of light in vacuum is 299,792,458 meters per second"
+          groundTruth:
+            "The speed of light in vacuum is 299,792,458 meters per second",
         },
-        { 
+        {
           input: "What is the capital of Japan?",
-          groundTruth: "Tokyo is the capital of Japan"
-        }
+          groundTruth: "Tokyo is the capital of Japan",
+        },
       ],
       scorers: [scorer],
       target: myAgent,
     });
 
     // Assert all answers meet similarity threshold
-    expect(result.scores['Answer Similarity Scorer'].score).toBeGreaterThan(0.8);
+    expect(result.scores["Answer Similarity Scorer"].score).toBeGreaterThan(
+      0.8,
+    );
   });
 
-  it('should maintain consistency across runs', async () => {
-    const testData = { 
+  it("should maintain consistency across runs", async () => {
+    const testData = {
       input: "Define machine learning",
-      groundTruth: "Machine learning is a subset of AI that enables systems to learn and improve from experience"
+      groundTruth:
+        "Machine learning is a subset of AI that enables systems to learn and improve from experience",
     };
 
     // Run multiple times to check consistency
     const results = await Promise.all([
       runExperiment({ data: [testData], scorers: [scorer], target: myAgent }),
       runExperiment({ data: [testData], scorers: [scorer], target: myAgent }),
-      runExperiment({ data: [testData], scorers: [scorer], target: myAgent })
+      runExperiment({ data: [testData], scorers: [scorer], target: myAgent }),
     ]);
 
     // Check that all runs produce similar scores (within 0.1 tolerance)
-    const scores = results.map(r => r.scores['Answer Similarity Scorer'].score);
+    const scores = results.map(
+      (r) => r.scores["Answer Similarity Scorer"].score,
+    );
     const maxDiff = Math.max(...scores) - Math.min(...scores);
     expect(maxDiff).toBeLessThan(0.1);
   });
@@ -380,44 +395,45 @@ describe('Agent Consistency Tests', () => {
 
 Customize the scorer behavior for specific use cases:
 
-```typescript filename="src/custom-config.ts" showLineNumbers copy
+```typescript title="src/custom-config.ts" showLineNumbers copy
 import { runExperiment } from "@mastra/core/scores";
 import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/llm";
 import { myAgent } from "./agent";
 
 // Configure for strict exact matching with high scale
-const strictScorer = createAnswerSimilarityScorer({ 
-  model: 'openai/gpt-4o-mini',
+const strictScorer = createAnswerSimilarityScorer({
+  model: "openai/gpt-4o-mini",
   options: {
-    exactMatchBonus: 0.5,        // Higher bonus for exact matches
-    contradictionPenalty: 2.0,   // Very strict on contradictions
-    missingPenalty: 0.3,         // Higher penalty for missing info
-    scale: 10                    // Score out of 10 instead of 1
-  }
+    exactMatchBonus: 0.5, // Higher bonus for exact matches
+    contradictionPenalty: 2.0, // Very strict on contradictions
+    missingPenalty: 0.3, // Higher penalty for missing info
+    scale: 10, // Score out of 10 instead of 1
+  },
 });
 
 // Configure for lenient semantic matching
-const lenientScorer = createAnswerSimilarityScorer({ 
-  model: 'openai/gpt-4o-mini',
+const lenientScorer = createAnswerSimilarityScorer({
+  model: "openai/gpt-4o-mini",
   options: {
-    semanticThreshold: 0.6,      // Lower threshold for semantic matches
-    contradictionPenalty: 0.5,   // More forgiving on minor contradictions
-    extraInfoPenalty: 0,         // No penalty for extra information
-    requireGroundTruth: false    // Allow missing ground truth
-  }
+    semanticThreshold: 0.6, // Lower threshold for semantic matches
+    contradictionPenalty: 0.5, // More forgiving on minor contradictions
+    extraInfoPenalty: 0, // No penalty for extra information
+    requireGroundTruth: false, // Allow missing ground truth
+  },
 });
 
 const result = await runExperiment({
   data: [
-    { 
+    {
       input: "Explain photosynthesis",
-      groundTruth: "Photosynthesis is the process by which plants convert light energy into chemical energy"
-    }
+      groundTruth:
+        "Photosynthesis is the process by which plants convert light energy into chemical energy",
+    },
   ],
   scorers: [strictScorer, lenientScorer],
   target: myAgent,
 });
 
-console.log('Strict scorer:', result.scores['Answer Similarity Scorer'].score); // Out of 10
-console.log('Lenient scorer:', result.scores['Answer Similarity Scorer'].score); // Out of 1
+console.log("Strict scorer:", result.scores["Answer Similarity Scorer"].score); // Out of 10
+console.log("Lenient scorer:", result.scores["Answer Similarity Scorer"].score); // Out of 1
 ```

package/.docs/raw/reference/scorers/bias.mdx

@@ -1,16 +1,14 @@
 ---
-title: "Reference: Bias | Scorers | Mastra Docs"
+title: "Reference: Bias Scorer | Scorers | Mastra Docs"
 description: Documentation for the Bias Scorer in Mastra, which evaluates LLM outputs for various forms of bias, including gender, political, racial/ethnic, or geographical bias.
 ---
 
 # Bias Scorer
-The `createBiasScorer()` function accepts a single options object with the following properties:
 
-For a usage example, see the [Bias Examples](/examples/scorers/bias).
+The `createBiasScorer()` function accepts a single options object with the following properties:
 
 ## Parameters
 
-
 <PropertiesTable
   content={[
     {
@@ -48,22 +46,26 @@ This function returns an instance of the MastraScorer class. The `.run()` method
     {
       name: "preprocessPrompt",
       type: "string",
-      description: "The prompt sent to the LLM for the preprocess step (optional).",
+      description:
+        "The prompt sent to the LLM for the preprocess step (optional).",
     },
     {
       name: "analyzeStepResult",
       type: "object",
-      description: "Object with results: { results: Array<{ result: 'yes' | 'no', reason: string }> }",
+      description:
+        "Object with results: { results: Array<{ result: 'yes' | 'no', reason: string }> }",
     },
     {
       name: "analyzePrompt",
       type: "string",
-      description: "The prompt sent to the LLM for the analyze step (optional).",
+      description:
+        "The prompt sent to the LLM for the analyze step (optional).",
     },
     {
       name: "score",
       type: "number",
-      description: "Bias score (0 to scale, default 0-1). Higher scores indicate more bias.",
+      description:
+        "Bias score (0 to scale, default 0-1). Higher scores indicate more bias.",
     },
     {
       name: "reason",
@@ -73,7 +75,8 @@ This function returns an instance of the MastraScorer class. The `.run()` method
     {
       name: "generateReasonPrompt",
       type: "string",
-      description: "The prompt sent to the LLM for the generateReason step (optional).",
+      description:
+        "The prompt sent to the LLM for the generateReason step (optional).",
     },
   ]}
 />
@@ -126,17 +129,17 @@ A bias score between 0 and 1:
 
 In this example, the response contains overtly biased language and generalizations. The assumptions are explicit and strongly reinforce stereotypes or discriminatory views.
 
-```typescript filename="src/example-high-bias.ts" showLineNumbers copy
+```typescript title="src/example-high-bias.ts" showLineNumbers copy
 import { createBiasScorer } from "@mastra/evals/scorers/llm";
 
-const scorer = createBiasScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createBiasScorer({ model: "openai/gpt-4o-mini" });
 
 const query = "What makes someone a good leader?";
 const response =
   "Men naturally make better leaders due to their assertiveness and decisiveness. Women tend to be too emotional and collaborative, which can slow down decision-making processes.";
 
 const result = await scorer.run({
-  input: [{ role: 'user', content: query }],
+  input: [{ role: "user", content: query }],
   output: { text: response },
 });
 
@@ -158,17 +161,17 @@ The output receives a high score because it's a clear example of discriminatory
 
 In this example, the response contains a mix of reasonable points with subtle bias. While parts of the response are fair, underlying bias is still present.
 
-```typescript filename="src/example-mixed-bias.ts" showLineNumbers copy
+```typescript title="src/example-mixed-bias.ts" showLineNumbers copy
 import { createBiasScorer } from "@mastra/evals/scorers/llm";
 
-const scorer = createBiasScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createBiasScorer({ model: "openai/gpt-4o-mini" });
 
 const query = "How do different age groups perform at work?";
 const response =
   "Younger workers tend to be more innovative and quick to adapt, though they can be somewhat unreliable and job-hop frequently. Older employees are generally more stable and experienced, but sometimes struggle to keep up with rapid changes in technology. Middle-aged workers often provide the best balance of skills and reliability.";
 
 const result = await scorer.run({
-  input: [{ role: 'user', content: query }],
+  input: [{ role: "user", content: query }],
   output: { text: response },
 });
 
@@ -190,17 +193,17 @@ The output receives a lower score because the response introduces bias in a more
 
 In this example, the response focuses on objective and neutral criteria without introducing biased assumptions.
 
-```typescript filename="src/example-low-bias.ts" showLineNumbers copy
+```typescript title="src/example-low-bias.ts" showLineNumbers copy
 import { createBiasScorer } from "@mastra/evals/scorers/llm";
 
-const scorer = createBiasScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createBiasScorer({ model: "openai/gpt-4o-mini" });
 
 const query = "What is the best hiring practice?";
 const response =
   "Effective hiring practices focus on objective criteria such as skills, experience, and demonstrated abilities. Using structured interviews and standardized assessments helps ensure fair evaluation of all candidates based on merit.";
 
 const result = await scorer.run({
-  input: [{ role: 'user', content: query }],
+  input: [{ role: "user", content: query }],
   output: { text: response },
 });
 
@@ -222,4 +225,4 @@ The output receives a low score because it does not exhibit biased language or r
 
 - [Toxicity Scorer](./toxicity)
 - [Faithfulness Scorer](./faithfulness)
-- [Hallucination Scorer](./hallucination)
+- [Hallucination Scorer](./hallucination)

package/.docs/raw/reference/scorers/completeness.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Completeness | Scorers | Mastra Docs"
+title: "Reference: Completeness Scorer | Scorers | Mastra Docs"
 description: Documentation for the Completeness Scorer in Mastra, which evaluates how thoroughly LLM outputs cover key elements present in the input.
 ---
 
@@ -25,12 +25,14 @@ This function returns an instance of the MastraScorer class. See the [MastraScor
     {
       name: "preprocessStepResult",
       type: "object",
-      description: "Object with extracted elements and coverage details: { inputElements: string[], outputElements: string[], missingElements: string[], elementCounts: { input: number, output: number } }",
+      description:
+        "Object with extracted elements and coverage details: { inputElements: string[], outputElements: string[], missingElements: string[], elementCounts: { input: number, output: number } }",
     },
     {
       name: "score",
       type: "number",
-      description: "Completeness score (0-1) representing the proportion of input elements covered in the output.",
+      description:
+        "Completeness score (0-1) representing the proportion of input elements covered in the output.",
     },
   ]}
 />
@@ -109,17 +111,18 @@ A completeness score between 0 and 1:
 
 In this example, the response comprehensively addresses all aspects of the query with detailed information covering multiple dimensions.
 
-```typescript filename="src/example-high-completeness.ts" showLineNumbers copy
+```typescript title="src/example-high-completeness.ts" showLineNumbers copy
 import { createCompletenessScorer } from "@mastra/evals/scorers/llm";
 
-const scorer = createCompletenessScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createCompletenessScorer({ model: "openai/gpt-4o-mini" });
 
-const query = "Explain the process of photosynthesis, including the inputs, outputs, and stages involved.";
+const query =
+  "Explain the process of photosynthesis, including the inputs, outputs, and stages involved.";
 const response =
   "Photosynthesis is the process by which plants convert sunlight into chemical energy. Inputs: Carbon dioxide (CO2) from the air enters through stomata, water (H2O) is absorbed by roots, and sunlight provides energy captured by chlorophyll. The process occurs in two main stages: 1) Light-dependent reactions in the thylakoids convert light energy to ATP and NADPH while splitting water and releasing oxygen. 2) Light-independent reactions (Calvin cycle) in the stroma use ATP, NADPH, and CO2 to produce glucose. Outputs: Glucose (C6H12O6) serves as food for the plant, and oxygen (O2) is released as a byproduct. The overall equation is: 6CO2 + 6H2O + light energy → C6H12O6 + 6O2.";
 
 const result = await scorer.run({
-  input: [{ role: 'user', content: query }],
+  input: [{ role: "user", content: query }],
   output: { text: response },
 });
 
@@ -141,17 +144,18 @@ The output receives a high score because it addresses all requested aspects: inp
 
 In this example, the response addresses some key points but misses important aspects or lacks sufficient detail.
 
-```typescript filename="src/example-partial-completeness.ts" showLineNumbers copy
+```typescript title="src/example-partial-completeness.ts" showLineNumbers copy
 import { createCompletenessScorer } from "@mastra/evals/scorers/llm";
 
-const scorer = createCompletenessScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createCompletenessScorer({ model: "openai/gpt-4o-mini" });
 
-const query = "What are the benefits and drawbacks of remote work for both employees and employers?";
+const query =
+  "What are the benefits and drawbacks of remote work for both employees and employers?";
 const response =
   "Remote work offers several benefits for employees including flexible schedules, no commuting time, and better work-life balance. It also reduces costs for office space and utilities for employers. However, remote work can lead to isolation and communication challenges for employees.";
 
 const result = await scorer.run({
-  input: [{ role: 'user', content: query }],
+  input: [{ role: "user", content: query }],
   output: { text: response },
 });
 
@@ -173,17 +177,18 @@ The output receives a moderate score because it covers employee benefits and som
 
 In this example, the response only partially addresses the query and misses several important aspects.
 
-```typescript filename="src/example-low-completeness.ts" showLineNumbers copy
+```typescript title="src/example-low-completeness.ts" showLineNumbers copy
 import { createCompletenessScorer } from "@mastra/evals/scorers/llm";
 
-const scorer = createCompletenessScorer({ model: 'openai/gpt-4o-mini' });
+const scorer = createCompletenessScorer({ model: "openai/gpt-4o-mini" });
 
-const query = "Compare renewable and non-renewable energy sources in terms of cost, environmental impact, and sustainability.";
+const query =
+  "Compare renewable and non-renewable energy sources in terms of cost, environmental impact, and sustainability.";
 const response =
   "Renewable energy sources like solar and wind are becoming cheaper. They're better for the environment than fossil fuels.";
 
 const result = await scorer.run({
-  input: [{ role: 'user', content: query }],
+  input: [{ role: "user", content: query }],
   output: { text: response },
 });
 
@@ -206,4 +211,4 @@ The output receives a low score because it only briefly mentions cost and enviro
 - [Answer Relevancy Scorer](./answer-relevancy)
 - [Content Similarity Scorer](./content-similarity)
 - [Textual Difference Scorer](./textual-difference)
-- [Keyword Coverage Scorer](./keyword-coverage)
+- [Keyword Coverage Scorer](./keyword-coverage)

package/.docs/raw/reference/scorers/content-similarity.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Content Similarity | Scorers | Mastra Docs"
+title: "Reference: Content Similarity Scorer | Scorers | Mastra Docs"
 description: Documentation for the Content Similarity Scorer in Mastra, which measures textual similarity between strings and provides a matching score.
 ---
 
@@ -44,7 +44,8 @@ This function returns an instance of the MastraScorer class. See the [MastraScor
     {
       name: "preprocessStepResult",
       type: "object",
-      description: "Object with processed input and output: { processedInput: string, processedOutput: string }",
+      description:
+        "Object with processed input and output: { processedInput: string, processedOutput: string }",
     },
     {
       name: "analyzeStepResult",
@@ -54,7 +55,8 @@ This function returns an instance of the MastraScorer class. See the [MastraScor
     {
       name: "score",
       type: "number",
-      description: "Similarity score (0-1) where 1 indicates perfect similarity.",
+      description:
+        "Similarity score (0-1) where 1 indicates perfect similarity.",
     },
   ]}
 />
@@ -82,7 +84,7 @@ Final score: `similarity_value * scale`
 
 In this example, the response closely resembles the query in both structure and meaning. Minor differences in tense and phrasing do not significantly affect the overall similarity.
 
-```typescript filename="src/example-high-similarity.ts" showLineNumbers copy
+```typescript title="src/example-high-similarity.ts" showLineNumbers copy
 import { createContentSimilarityScorer } from "@mastra/evals/scorers/llm";
 
 const scorer = createContentSimilarityScorer();
@@ -91,7 +93,7 @@ const query = "The quick brown fox jumps over the lazy dog.";
 const response = "A quick brown fox jumped over a lazy dog.";
 
 const result = await scorer.run({
-  input: [{ role: 'user', content: query }],
+  input: [{ role: "user", content: query }],
   output: { text: response },
 });
 
@@ -115,7 +117,7 @@ The output receives a high score because the response preserves the intent and c
 
 In this example, the response shares some conceptual overlap with the query but diverges in structure and wording. Key elements remain present, but the phrasing introduces moderate variation.
 
-```typescript filename="src/example-moderate-similarity.ts" showLineNumbers copy
+```typescript title="src/example-moderate-similarity.ts" showLineNumbers copy
 import { createContentSimilarityScorer } from "@mastra/evals/scorers/llm";
 
 const scorer = createContentSimilarityScorer();
@@ -124,7 +126,7 @@ const query = "A brown fox quickly leaps across a sleeping dog.";
 const response = "The quick brown fox jumps over the lazy dog.";
 
 const result = await scorer.run({
-  input: [{ role: 'user', content: query }],
+  input: [{ role: "user", content: query }],
   output: { text: response },
 });
 
@@ -148,7 +150,7 @@ The output receives a mid-range score because the response captures the general
 
 In this example, the response and query are unrelated in meaning, despite having a similar grammatical structure. There is little to no shared content overlap.
 
-```typescript filename="src/example-low-similarity.ts" showLineNumbers copy
+```typescript title="src/example-low-similarity.ts" showLineNumbers copy
 import { createContentSimilarityScorer } from "@mastra/evals/scorers/llm";
 
 const scorer = createContentSimilarityScorer();
@@ -157,7 +159,7 @@ const query = "The cat sleeps on the windowsill.";
 const response = "The quick brown fox jumps over the lazy dog.";
 
 const result = await scorer.run({
-  input: [{ role: 'user', content: query }],
+  input: [{ role: "user", content: query }],
   output: { text: response },
 });
 
@@ -192,4 +194,4 @@ A similarity score between 0 and 1:
 - [Completeness Scorer](./completeness)
 - [Textual Difference Scorer](./textual-difference)
 - [Answer Relevancy Scorer](./answer-relevancy)
-- [Keyword Coverage Scorer](./keyword-coverage)
+- [Keyword Coverage Scorer](./keyword-coverage)