@mastra/mcp-docs-server 1.2.11 → 1.2.12-alpha.3

package/.docs/reference/evals/context-recall.md

@@ -4,7 +4,7 @@
 
 The `createContextRecallScorer()` function creates a scorer that evaluates how well retrieved context covers the claims in a ground-truth reference answer. It measures retrieval completeness by checking what fraction of the ground truth's claims are attributable to the retrieved context.
 
-This scorer requires a ground-truth reference answer, making it suitable for labeled datasets in CI or test environments. When `groundTruth` is not provided in the run, the scorer returns a score of 0 rather than throwing an error.
+This scorer requires a ground-truth reference answer, making it suitable for labeled datasets in CI or test environments. When `groundTruth` isn't provided in the run, the scorer returns a score of 0 rather than throwing an error.
 
 ## RAG retrieval evaluation
 
@@ -28,7 +28,7 @@ Use when running evaluations against curated test sets:
 
 **options** (`ContextRecallMetricOptions`): Configuration options for the scorer
 
-**Note**: Either `context` or `contextExtractor` must be provided. When both are provided, `contextExtractor` is used only if the run input and output are agent-shaped (`MastraDBMessage[]`); otherwise the scorer falls back to `context`.
+Either `context` or `contextExtractor` must be provided. When both are provided, `contextExtractor` is used only if the run input and output are agent-shaped (`MastraDBMessage[]`); otherwise the scorer falls back to `context`.
 
 ## `.run()` returns
 
@@ -62,11 +62,11 @@ Where:
 
 These ranges assume the default `scale` of 1. When using a custom scale, multiply accordingly.
 
-- **0.9-1.0**: Excellent recall — context covers nearly all ground-truth claims
-- **0.7-0.8**: Good recall — most claims are covered, minor gaps
-- **0.4-0.6**: Moderate recall — significant information missing from context
-- **0.1-0.3**: Poor recall — most ground-truth claims not found in context
-- **0.0**: No recall — none of the ground-truth claims are in the context
+- **0.9-1.0**: Excellent recall, context covers nearly all ground-truth claims
+- **0.7-0.8**: Good recall. Most claims are covered, with minor gaps
+- **0.4-0.6**: Moderate recall, substantial information missing from context
+- **0.1-0.3**: Poor recall, most ground-truth claims not found in context
+- **0.0**: No recall, none of the ground-truth claims are in the context
 
 ### Reason analysis
 
@@ -87,7 +87,7 @@ Use results to:
 
 ### Example calculation
 
-Given ground truth: "Einstein was born in 1879. He developed relativity. He won the Nobel Prize."
+ground truth: "Einstein was born in 1879. He developed relativity. He won the Nobel Prize."
 
 Claims extracted: 3
 
@@ -103,7 +103,7 @@ Recall = 2/3 = 0.67
 
 ```typescript
 const scorer = createContextRecallScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     contextExtractor: (input, output) => {
       const query = input?.inputMessages?.[0]?.content || ''
@@ -119,7 +119,7 @@ const scorer = createContextRecallScorer({
 
 ```typescript
 const scorer = createContextRecallScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: [
       'Document 1: Einstein was born on 14 March 1879 in Ulm, Germany.',
@@ -140,7 +140,7 @@ import { createContextRecallScorer } from '@mastra/evals/scorers/prebuilt'
 import { myAgent } from './agent'
 
 const scorer = createContextRecallScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     contextExtractor: (input, output) => {
       // Extract context from tool invocation results in the agent output

package/.docs/reference/evals/context-relevance.md

@@ -11,7 +11,7 @@ It's especially useful for these use cases:
 Best for evaluating context quality in:
 
 - Chat systems where context usage matters
-- RAG pipelines needing nuanced relevance assessment
+- RAG pipelines needing detailed relevance assessment
 - Systems where missing context affects quality
 
 ## Context selection optimization
@@ -40,7 +40,7 @@ Note: Either `context` or `contextExtractor` must be provided. If both are provi
 
 ### Weighted Relevance Scoring
 
-Context Relevance uses a sophisticated scoring algorithm that considers:
+Context Relevance uses a advanced scoring algorithm that considers:
 
 1. **Relevance Levels**: Each context piece is classified with weighted values:
 
@@ -77,7 +77,7 @@ Final Score = max(0, Base Score - Usage Penalty - Missing Penalty) × scale
 
 - **0.9-1.0**: Excellent - all context highly relevant and used
 - **0.7-0.8**: Good - mostly relevant with minor gaps
-- **0.4-0.6**: Mixed - significant irrelevant or unused context
+- **0.4-0.6**: Mixed - substantial irrelevant or unused context
 - **0.2-0.3**: Poor - mostly irrelevant context
 - **0.0-0.1**: Very poor - no relevant context found
 
@@ -121,7 +121,7 @@ import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 // Stricter penalty configuration
 const strictScorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: [
       'Einstein won the Nobel Prize for photoelectric effect',
@@ -139,7 +139,7 @@ const strictScorer = createContextRelevanceScorerLLM({
 
 // Lenient penalty configuration
 const lenientScorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: [
       'Einstein won the Nobel Prize for photoelectric effect',
@@ -185,7 +185,7 @@ console.log('Lenient penalties:', lenientResult.score) // Higher score, less pen
 
 ```typescript
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     contextExtractor: (input, output) => {
       // Extract context based on the query
@@ -209,7 +209,7 @@ const scorer = createContextRelevanceScorerLLM({
 
 ```typescript
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: ['Relevant information...', 'Supporting details...'],
     scale: 100, // Scale scores from 0-100 instead of 0-1
@@ -223,7 +223,7 @@ const scorer = createContextRelevanceScorerLLM({
 
 ```typescript
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     contextExtractor: (input, output) => {
       const query = input?.inputMessages?.[0]?.content || ''
@@ -250,7 +250,7 @@ This example shows excellent context relevance where all context directly suppor
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: [
       'Einstein won the Nobel Prize for his discovery of the photoelectric effect in 1921.',
@@ -297,7 +297,7 @@ This example shows moderate relevance with some context being irrelevant or unus
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: [
       'Solar eclipses occur when the Moon blocks the Sun.',
@@ -339,7 +339,7 @@ console.log(result)
 
 // With custom penalty configuration
 const customScorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: [
       'Solar eclipses occur when the Moon blocks the Sun.',
@@ -386,7 +386,7 @@ This example shows poor context relevance with mostly irrelevant information:
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: [
       'The Great Barrier Reef is located in Australia.',
@@ -428,13 +428,13 @@ console.log(result)
 
 ### Dynamic context extraction
 
-Extract context dynamically based on the run input:
+Extract context at runtime based on the run input:
 
 ```typescript
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     contextExtractor: (input, output) => {
       // Extract query from input
@@ -477,7 +477,7 @@ Integrate with RAG pipelines to evaluate retrieved context:
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     contextExtractor: (input, output) => {
       // Extract from RAG retrieval results

package/.docs/reference/evals/create-scorer.md

@@ -110,7 +110,7 @@ export const responseQuality = createScorer({
 
 With this configuration, a failed request has at most three provider attempts: the initial request plus two processor retries. If `generateScore` completes and `generateReason` receives a retryable failure, only `generateReason` retries.
 
-`StreamErrorRetryProcessor` honors retryable provider metadata and narrow custom matchers. It keeps `retryUnknownErrors` disabled by default, so authentication, invalid-request, and context-length errors fail immediately unless you explicitly match them. It bounds `Retry-After` values to `30_000` milliseconds by default; use `maxRetryAfterMs` to change that cap.
+`StreamErrorRetryProcessor` honors retryable provider metadata and narrow custom matchers. It keeps `retryUnknownErrors` disabled by default, so authentication, invalid-request, and context-length errors fail immediately unless you explicitly match them. It bounds `Retry-After` values to `30_000` milliseconds by default. Use `maxRetryAfterMs` to change that cap.
 
 Avoid adding outer scorer or workflow retries. Avoid combining a nonzero model retry setting with this processor unless you intentionally accept additional attempts.
 

package/.docs/reference/evals/faithfulness.md

@@ -65,9 +65,9 @@ Final score: `(supported_claims / total_claims) * scale`
 A faithfulness score between 0 and 1:
 
 - **1.0**: All claims are accurate and directly supported by the context.
-- **0.7–0.9**: Most claims are correct, with minor additions or omissions.
-- **0.4–0.6**: Some claims are supported, but others are unverifiable.
-- **0.1–0.3**: Most of the content is inaccurate or unsupported.
+- **0.7 to 0.9**: Most claims are correct, with minor additions or omissions.
+- **0.4 to 0.6**: Some claims are supported, but others are unverifiable.
+- **0.1 to 0.3**: Most of the content is inaccurate or unsupported.
 - **0.0**: All claims are false or contradict the context.
 
 ## Example
@@ -81,7 +81,7 @@ import { myAgent } from './agent'
 
 // Context is typically populated from agent tool calls or RAG retrieval
 const scorer = createFaithfulnessScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 const result = await runEvals({

package/.docs/reference/evals/filter-run.md

@@ -2,7 +2,7 @@
 
 # filterRun()
 
-Creates a `prepareRun` function from declarative options. Pass the result to `createScorer()` to filter messages, limit context size, and drop unnecessary fields before the scorer pipeline runs.
+Creates a `prepareRun` function from declarative options. Pass the result to `createScorer()` to filter messages and limit context size. It also drops unnecessary fields before the scorer pipeline runs.
 
 Use [`filterRun()`](#usage-example) for declarative filtering. Write a custom `prepareRun` function directly when you need imperative logic that `filterRun()` doesn't cover. See [Custom scorers: input filtering](https://mastra.ai/docs/evals/custom-scorers) for more.
 
@@ -88,7 +88,7 @@ const simpleScorer = createScorer({
 
 **options.dropGroundTruth** (`boolean`): Remove ground truth from the run.
 
-**Returns:** `(run: ScorerRun) => ScorerRun` — A function suitable for the `prepareRun` option on [`createScorer()`](https://mastra.ai/reference/evals/create-scorer).
+**Returns:** `(run: ScorerRun) => ScorerRun`. A function suitable for the `prepareRun` option on [`createScorer()`](https://mastra.ai/reference/evals/create-scorer).
 
 ## Part types
 

package/.docs/reference/evals/hallucination.md

@@ -88,13 +88,13 @@ Final score: `(hallucinated_statements / total_statements) * scale`
 
 A hallucination score between 0 and 1:
 
-- **0.0**: No hallucination — all claims match the context.
-- **0.3–0.4**: Low hallucination — a few contradictions.
-- **0.5–0.6**: Mixed hallucination — several contradictions.
-- **0.7–0.8**: High hallucination — many contradictions.
-- **0.9–1.0**: Complete hallucination — most or all claims contradict the context.
+- **0.0**: No hallucination, all claims match the context.
+- **0.3 to 0.4**: Low hallucination, a few contradictions.
+- **0.5 to 0.6**: Mixed hallucination, several contradictions.
+- **0.7 to 0.8**: High hallucination, many contradictions.
+- **0.9 to 1.0**: Complete hallucination, most or all claims contradict the context.
 
-**Note:** The score represents the degree of hallucination - lower scores indicate better factual alignment with the provided context
+The score represents the degree of hallucination - lower scores indicate better factual alignment with the provided context
 
 ## Examples
 
@@ -106,7 +106,7 @@ Use static context when you have known ground truth to compare against:
 import { createHallucinationScorer } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createHallucinationScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: [
       'The first iPhone was announced on January 9, 2007.',
@@ -126,7 +126,7 @@ import { createHallucinationScorer } from '@mastra/evals/scorers/prebuilt'
 import { extractToolResults } from '@mastra/evals/scorers'
 
 const scorer = createHallucinationScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     getContext: ({ run, step }) => {
       // Extract tool results as context
@@ -147,7 +147,7 @@ import { createHallucinationScorer } from '@mastra/evals/scorers/prebuilt'
 import { extractToolResults } from '@mastra/evals/scorers'
 
 const hallucinationScorer = createHallucinationScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     getContext: ({ run }) => {
       const toolResults = extractToolResults(run.output)
@@ -159,7 +159,7 @@ const hallucinationScorer = createHallucinationScorer({
 const agent = new Agent({
   id: 'my-agent',
   name: 'my-agent',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   instructions: 'You are a helpful assistant.',
   evals: {
     scorers: [hallucinationScorer],
@@ -175,7 +175,7 @@ import { createHallucinationScorer } from '@mastra/evals/scorers/prebuilt'
 import { myAgent } from './agent'
 
 const scorer = createHallucinationScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: ['Known fact 1', 'Known fact 2'],
   },

package/.docs/reference/evals/keyword-coverage.md

@@ -66,11 +66,11 @@ Final score: `(matched_keywords / total_keywords) * scale`
 
 A coverage score between 0 and 1:
 
-- **1.0**: Complete coverage – all keywords present.
-- **0.7–0.9**: High coverage – most keywords included.
-- **0.4–0.6**: Partial coverage – some keywords present.
-- **0.1–0.3**: Low coverage – few keywords matched.
-- **0.0**: No coverage – no keywords found.
+- **1.0**: Complete coverage, all keywords present.
+- **0.7 to 0.9**: High coverage, most keywords included.
+- **0.4 to 0.6**: Partial coverage, some keywords present.
+- **0.1 to 0.3**: Low coverage, few keywords matched.
+- **0.0**: The response contains none of the keywords.
 
 ### Special Cases
 
@@ -80,7 +80,7 @@ The scorer handles several special cases:
 - Single word: Treated as a single keyword
 - Technical terms: Preserves compound technical terms (e.g., "React.js", "machine learning")
 - Case differences: "JavaScript" matches "javascript"
-- Common words: Ignored in scoring to focus on meaningful keywords
+- Common words: Ignored in scoring to focus on useful keywords
 
 ## Example
 

package/.docs/reference/evals/mastra-scorer.md

@@ -4,7 +4,7 @@
 
 The `MastraScorer` class is the base class for all scorers in Mastra. It provides a standard `.run()` method for evaluating input/output pairs and supports multi-step scoring workflows with preprocess → analyze → generateScore → generateReason execution flow.
 
-**Note:** Most users should use [`createScorer`](https://mastra.ai/reference/evals/create-scorer) to create scorer instances. Direct instantiation of `MastraScorer` isn't recommended.
+Most users should use [`createScorer`](https://mastra.ai/reference/evals/create-scorer) to create scorer instances. Direct instantiation of `MastraScorer` isn't recommended.
 
 ## How to get a `MastraScorer` instance
 
@@ -26,7 +26,7 @@ const scorer = createScorer({
 
 ## `.run()` method
 
-The `.run()` method is the primary way to execute your scorer and evaluate input/output pairs. It processes the data through your defined steps (preprocess → analyze → generateScore → generateReason) and returns a comprehensive result object with the score, reasoning, and intermediate results.
+The `.run()` method is the primary way to execute your scorer and evaluate input/output pairs. It processes the data through your defined steps (preprocess → analyze → generateScore → generateReason) and returns a detailed result object with the score, reasoning, and intermediate results.
 
 ```typescript
 const result = await scorer.run({

package/.docs/reference/evals/noise-sensitivity.md

@@ -2,9 +2,9 @@
 
 # Noise sensitivity scorer
 
-The `createNoiseSensitivityScorerLLM()` function creates a **CI/testing scorer** that evaluates how robust an agent is when exposed to irrelevant, distracting, or misleading information. Unlike live scorers that evaluate single production runs, this scorer requires predetermined test data including both baseline responses and noisy variations.
+The `createNoiseSensitivityScorerLLM()` function creates a **CI/testing scorer** that evaluates how reliable an agent is when exposed to irrelevant, distracting, or misleading information. Unlike live scorers that evaluate single production runs, this scorer requires predetermined test data including both baseline responses and noisy variations.
 
-**Important:** This isn't a live scorer. It requires pre-computed baseline responses and can't be used for real-time agent evaluation. Use this scorer in your CI/CD pipeline or testing suites only.
+This isn't a live scorer. It requires pre-computed baseline responses and can't be used for real-time agent evaluation. Use this scorer in your CI/CD pipeline or testing suites only.
 
 Before using the noise sensitivity scorer, prepare your test data:
 
@@ -63,7 +63,7 @@ describe('Agent Noise Resistance Tests', () => {
 
     // Step 4: Evaluate using noise sensitivity scorer
     const scorer = createNoiseSensitivityScorerLLM({
-      model: 'openai/gpt-5.5',
+      model: 'openai/gpt-5.6-sol',
       options: {
         baselineResponse,
         noisyQuery,
@@ -177,7 +177,7 @@ Include in your test harness to:
 
 - Benchmark different models' noise resistance before deployment
 - Identify agents vulnerable to manipulation during development
-- Create comprehensive test coverage for various noise types
+- Create detailed test coverage for various noise types
 - Ensure consistent behavior across updates
 
 ### Security Testing
@@ -194,7 +194,7 @@ Evaluate resistance in controlled environments:
 - **1.0**: Perfect robustness - no impact detected
 - **0.8-0.9**: Excellent - minimal impact, core functionality preserved
 - **0.6-0.7**: Good - some impact but acceptable for most use cases
-- **0.4-0.5**: Concerning - significant vulnerabilities detected
+- **0.4-0.5**: Concerning - substantial vulnerabilities detected
 - **0.0-0.3**: Critical - agent severely compromised by noise
 
 ### Dimension analysis
@@ -258,7 +258,7 @@ describe('Agent Noise Resistance CI Tests', () => {
 
       // Evaluate using noise sensitivity scorer
       const scorer = createNoiseSensitivityScorerLLM({
-        model: 'openai/gpt-5.5',
+        model: 'openai/gpt-5.6-sol',
         options: {
           baselineResponse: testCase.baselineResponse,
           noisyQuery: testCase.noisyQuery,
@@ -293,7 +293,7 @@ This example shows an agent that completely resists misinformation in a test sce
 import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 const scorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     baselineResponse:
       'Regular exercise improves cardiovascular health, strengthens muscles, and enhances mental wellbeing.',
@@ -339,7 +339,7 @@ This example shows an agent partially distracted by irrelevant requests:
 import { createNoiseSensitivityScorerLLM } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     baselineResponse:
       'To bake a cake: Mix flour, sugar, eggs, and butter. Bake at 350°F for 30 minutes.',
@@ -384,7 +384,7 @@ This example shows an agent that incorporates misinformation:
 import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 const scorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     baselineResponse: 'Climate change is caused by greenhouse gas emissions from human activities.',
     noisyQuery:
@@ -430,7 +430,7 @@ import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 // Lenient scoring - more forgiving of minor issues
 const lenientScorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     baselineResponse: 'Python is a high-level programming language.',
     noisyQuery: 'What is Python? Also, snakes are dangerous!',
@@ -450,7 +450,7 @@ const lenientScorer = createNoiseSensitivityScorerLLM({
 
 // Strict scoring - harsh on any deviation
 const strictScorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     baselineResponse: 'Python is a high-level programming language.',
     noisyQuery: 'What is Python? Also, snakes are dangerous!',
@@ -472,7 +472,7 @@ const strictScorer = createNoiseSensitivityScorerLLM({
 
 ## CI test suite: Testing different noise types
 
-Create comprehensive test suites to evaluate agent performance across various noise categories in your CI pipeline:
+Create detailed test suites to evaluate agent performance across noise categories in your CI pipeline:
 
 ```typescript
 import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
@@ -501,7 +501,7 @@ async function evaluateNoiseResistance(testCases) {
 
   for (const testCase of testCases) {
     const scorer = createNoiseSensitivityScorerLLM({
-      model: 'openai/gpt-5.5',
+      model: 'openai/gpt-5.6-sol',
       options: {
         baselineResponse: testCase.baseline,
         noisyQuery: testCase.noisyQuery,
@@ -548,7 +548,7 @@ import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 async function compareModelRobustness() {
   const models = [
-    { name: 'GPT-5.4', model: 'openai/gpt-5.5' },
+    { name: 'GPT-5.4', model: 'openai/gpt-5.6-sol' },
     { name: 'GPT-5.4-mini', model: 'openai/gpt-5-mini' },
     { name: 'Claude', model: 'anthropic/claude-opus-4-7' },
   ]
@@ -600,7 +600,7 @@ Include noise sensitivity tests in your security test suite to validate prompt i
 import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 const scorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     baselineResponse: 'I can help you with programming questions.',
     noisyQuery:

package/.docs/reference/evals/prompt-alignment.md

@@ -2,7 +2,7 @@
 
 # Prompt alignment scorer
 
-The `createPromptAlignmentScorerLLM()` function creates a scorer that evaluates how well agent responses align with user prompts across multiple dimensions: intent understanding, requirement fulfillment, response completeness, and format appropriateness.
+The `createPromptAlignmentScorerLLM()` function creates a scorer that evaluates how well agent responses align with user prompts across intent understanding and requirement fulfillment, plus response completeness, and format appropriateness.
 
 ## Parameters
 
@@ -62,7 +62,7 @@ You can customize the Prompt Alignment Scorer by adjusting the scale parameter a
 
 ```typescript
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     scale: 10, // Score from 0-10 instead of 0-1
     evaluationMode: 'both', // 'user', 'system', or 'both' (default)
@@ -80,7 +80,7 @@ Evaluates alignment with user prompts only:
 
 1. **Intent Alignment** (40% weight): Whether the response addresses the user's core request
 2. **Requirements Fulfillment** (30% weight): If all user requirements are met
-3. **Completeness** (20% weight): Whether the response is comprehensive for user needs
+3. **Completeness** (20% weight): Whether the response is detailed for user needs
 4. **Response Appropriateness** (10% weight): If format and tone match user expectations
 
 #### System Mode ('system')
@@ -139,7 +139,7 @@ Final Score = Weighted Score × scale
 - **0.8-0.9** = Very good alignment with minor gaps
 - **0.7-0.8** = Good alignment but missing some requirements or completeness
 - **0.6-0.7** = Moderate alignment with noticeable gaps
-- **0.4-0.6** = Poor alignment with significant issues
+- **0.4-0.6** = Poor alignment with substantial issues
 - **0.0-0.4** = Very poor alignment, response doesn't address the prompt effectively
 
 ### When to Use Each Mode
@@ -160,7 +160,7 @@ Final Score = Weighted Score × scale
 
 **Both Mode (`'both'`)** - Use when (default, recommended):
 
-- Comprehensive evaluation of overall AI agent performance
+- Comprehensive evaluation of AI agent performance
 - Balancing user satisfaction with system compliance
 - Production monitoring where both user and system requirements matter
 - Holistic assessment of prompt-response alignment
@@ -224,24 +224,24 @@ const agent = new Agent({
   id: 'coding-assistant',
   name: 'CodingAssistant',
   instructions: 'You are a helpful coding assistant. Always provide working code examples.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 // Evaluate comprehensive alignment (default)
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: { evaluationMode: 'both' }, // Evaluates both user intent and system guidelines
 })
 
 // Evaluate just user satisfaction
 const userScorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: { evaluationMode: 'user' }, // Focus only on user request fulfillment
 })
 
 // Evaluate system compliance
 const systemScorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: { evaluationMode: 'system' }, // Check adherence to system instructions
 })
 
@@ -293,7 +293,7 @@ for (const agent of agents) {
 import { createPromptAlignmentScorerLLM } from '@mastra/evals'
 
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 // Evaluate a code generation task
@@ -322,7 +322,7 @@ const result = await scorer.run({
 ```typescript
 // Configure scale and evaluation mode
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     scale: 10, // Score from 0-10 instead of 0-1
     evaluationMode: 'both', // 'user', 'system', or 'both' (default)
@@ -331,13 +331,13 @@ const scorer = createPromptAlignmentScorerLLM({
 
 // User-only evaluation - focus on user satisfaction
 const userScorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: { evaluationMode: 'user' },
 })
 
 // System-only evaluation - focus on compliance
 const systemScorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: { evaluationMode: 'system' },
 })
 
@@ -372,7 +372,7 @@ In this example, the response fully addresses the user's prompt with all require
 import { createPromptAlignmentScorerLLM } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 const inputMessages = [
@@ -403,7 +403,7 @@ console.log(result)
 
 ### Excellent alignment output
 
-The output receives a high score because it perfectly addresses the intent, fulfills all requirements, and uses appropriate format.
+The output receives a high score because it perfectly addresses the intent and fulfills all requirements. It also uses the appropriate format.
 
 ```typescript
 {
@@ -420,7 +420,7 @@ In this example, the response addresses the core intent but misses some requirem
 import { createPromptAlignmentScorerLLM } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 const inputMessages = [
@@ -461,7 +461,7 @@ In this example, the response fails to address the user's specific requirements.
 import { createPromptAlignmentScorerLLM } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 const inputMessages = [
@@ -505,7 +505,7 @@ Evaluates how well the response addresses the user's request, ignoring system in
 
 ```typescript
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: { evaluationMode: 'user' },
 })
 
@@ -537,7 +537,7 @@ Evaluates compliance with system behavioral guidelines and constraints:
 
 ```typescript
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: { evaluationMode: 'system' },
 })
 
@@ -569,7 +569,7 @@ Evaluates both user intent fulfillment and system compliance with weighted scori
 
 ```typescript
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: { evaluationMode: 'both' }, // This is the default
 })