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

package/.docs/raw/reference/scorers/textual-difference.mdx

@@ -0,0 +1,76 @@
+---
+title: "Reference: Textual Difference | Scorers | Mastra Docs"
+description: Documentation for the Textual Difference Scorer in Mastra, which measures textual differences between strings using sequence matching.
+---
+
+# Textual Difference Scorer
+
+The `createTextualDifferenceScorer()` function uses sequence matching to measure the textual differences between two strings. It provides detailed information about changes, including the number of operations needed to transform one text into another.
+
+For a usage example, see the [Textual Difference Examples](/examples/scorers/textual-difference).
+
+## Parameters
+
+The `createTextualDifferenceScorer()` function does not take any options.
+
+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.
+
+## .run() Returns
+
+<PropertiesTable
+  content={[
+    {
+      name: "runId",
+      type: "string",
+      description: "The id of the run (optional).",
+    },
+    {
+      name: "analyzeStepResult",
+      type: "object",
+      description: "Object with difference metrics: { confidence: number, changes: number, lengthDiff: number }",
+    },
+    {
+      name: "score",
+      type: "number",
+      description: "Similarity ratio (0-1) where 1 indicates identical texts.",
+    },
+  ]}
+/>
+
+## Scoring Details
+
+The scorer calculates several measures:
+
+- **Similarity Ratio**: Based on sequence matching between texts (0-1)
+- **Changes**: Count of non-matching operations needed
+- **Length Difference**: Normalized difference in text lengths
+- **Confidence**: Inversely proportional to length difference
+
+### Scoring Process
+
+1. Analyzes textual differences:
+   - Performs sequence matching between input and output
+   - Counts the number of change operations required
+   - Measures length differences
+2. Calculates metrics:
+   - Computes similarity ratio
+   - Determines confidence score
+   - Combines into weighted score
+
+Final score: `(similarity_ratio * confidence) * scale`
+
+### Score interpretation
+
+(0 to scale, default 0-1)
+
+- 1.0: Identical texts - no differences
+- 0.7-0.9: Minor differences - few changes needed
+- 0.4-0.6: Moderate differences - significant changes
+- 0.1-0.3: Major differences - extensive changes
+- 0.0: Completely different texts
+
+## Related
+
+- [Content Similarity Scorer](./content-similarity)
+- [Completeness Scorer](./completeness)
+- [Keyword Coverage Scorer](./keyword-coverage)

package/.docs/raw/reference/scorers/tone-consistency.mdx

@@ -0,0 +1,75 @@
+---
+title: "Reference: Tone Consistency | Scorers | Mastra Docs"
+description: Documentation for the Tone Consistency Scorer in Mastra, which evaluates emotional tone and sentiment consistency in text.
+---
+
+# Tone Consistency Scorer
+
+The `createToneScorer()` function evaluates the text's emotional tone and sentiment consistency. It can operate in two modes: comparing tone between input/output pairs or analyzing tone stability within a single text.
+
+For a usage example, see the [Tone Consistency Examples](/examples/scorers/tone-consistency).
+
+## Parameters
+
+The `createToneScorer()` function does not take any options.
+
+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.
+
+## .run() Returns
+
+<PropertiesTable
+  content={[
+    {
+      name: "runId",
+      type: "string",
+      description: "The id of the run (optional).",
+    },
+    {
+      name: "analyzeStepResult",
+      type: "object",
+      description: "Object with tone metrics: { responseSentiment: number, referenceSentiment: number, difference: number } (for comparison mode) OR { avgSentiment: number, sentimentVariance: number } (for stability mode)",
+    },
+    {
+      name: "score",
+      type: "number",
+      description: "Tone consistency/stability score (0-1).",
+    },
+  ]}
+/>
+
+## Scoring Details
+
+The scorer evaluates sentiment consistency through tone pattern analysis and mode-specific scoring.
+
+### Scoring Process
+
+1. Analyzes tone patterns:
+   - Extracts sentiment features
+   - Computes sentiment scores
+   - Measures tone variations
+2. Calculates mode-specific score:
+   **Tone Consistency** (input and output):
+   - Compares sentiment between texts
+   - Calculates sentiment difference
+   - Score = 1 - (sentiment_difference / max_difference)
+   **Tone Stability** (single input):
+   - Analyzes sentiment across sentences
+   - Calculates sentiment variance
+   - Score = 1 - (sentiment_variance / max_variance)
+
+Final score: `mode_specific_score * scale`
+
+### Score interpretation
+
+(0 to scale, default 0-1)
+
+- 1.0: Perfect tone consistency/stability
+- 0.7-0.9: Strong consistency with minor variations
+- 0.4-0.6: Moderate consistency with noticeable shifts
+- 0.1-0.3: Poor consistency with major tone changes
+- 0.0: No consistency - completely different tones
+
+## Related
+
+- [Content Similarity Scorer](./content-similarity)
+- [Toxicity Scorer](./toxicity)

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

@@ -0,0 +1,109 @@
+---
+title: "Reference: Toxicity | Scorers | Mastra Docs"
+description: Documentation for the Toxicity Scorer in Mastra, which evaluates LLM outputs for racist, biased, or toxic elements.
+---
+
+# Toxicity Scorer
+
+The `createToxicityScorer()` function evaluates whether an LLM's output contains racist, biased, or toxic elements. It uses a judge-based system to analyze responses for various forms of toxicity including personal attacks, mockery, hate speech, dismissive statements, and threats.
+
+For a usage example, see the [Toxicity Examples](/examples/scorers/toxicity).
+
+## Parameters
+
+The `createToxicityScorer()` function accepts a single options object with the following properties:
+
+<PropertiesTable
+  content={[
+    {
+      name: "model",
+      type: "LanguageModel",
+      required: true,
+      description: "Configuration for the model used to evaluate toxicity.",
+    },
+    {
+      name: "scale",
+      type: "number",
+      required: false,
+      defaultValue: "1",
+      description: "Maximum score value (default is 1).",
+    },
+  ]}
+/>
+
+This function returns an instance of the MastraScorer class. The `.run()` method accepts the same input as other scorers (see the [MastraScorer reference](./mastra-scorer)), but the return value includes LLM-specific fields as documented below.
+
+## .run() Returns
+
+<PropertiesTable
+  content={[
+    {
+      name: "runId",
+      type: "string",
+      description: "The id of the run (optional).",
+    },
+    {
+      name: "analyzeStepResult",
+      type: "object",
+      description: "Object with verdicts: { verdicts: Array<{ verdict: 'yes' | 'no', reason: string }> }",
+    },
+    {
+      name: "analyzePrompt",
+      type: "string",
+      description: "The prompt sent to the LLM for the analyze step (optional).",
+    },
+    {
+      name: "score",
+      type: "number",
+      description: "Toxicity score (0 to scale, default 0-1).",
+    },
+    {
+      name: "reason",
+      type: "string",
+      description: "Detailed explanation of the toxicity assessment.",
+    },
+    {
+      name: "reasonPrompt",
+      type: "string",
+      description: "The prompt sent to the LLM for the reason step (optional).",
+    },
+  ]}
+/>
+
+## Scoring Details
+
+The scorer evaluates toxicity through multiple aspects:
+
+- Personal attacks
+- Mockery or sarcasm
+- Hate speech
+- Dismissive statements
+- Threats or intimidation
+
+### Scoring Process
+
+1. Analyzes toxic elements:
+   - Identifies personal attacks and mockery
+   - Detects hate speech and threats
+   - Evaluates dismissive statements
+   - Assesses severity levels
+2. Calculates toxicity score:
+   - Weighs detected elements
+   - Combines severity ratings
+   - Normalizes to scale
+
+Final score: `(toxicity_weighted_sum / max_toxicity) * scale`
+
+### Score interpretation
+
+(0 to scale, default 0-1)
+
+- 0.8-1.0: Severe toxicity
+- 0.4-0.7: Moderate toxicity
+- 0.1-0.3: Mild toxicity
+- 0.0: No toxic elements detected
+
+## Related
+
+- [Tone Consistency Scorer](./tone-consistency)
+- [Bias Scorer](./bias)

package/.docs/raw/reference/storage/libsql.mdx

@@ -65,7 +65,10 @@ For production use cases, use a persistent database URL: `libsql://your-database
 
 The storage implementation handles schema creation and updates automatically. It creates the following tables:
 
-- `threads`: Stores conversation threads
-- `messages`: Stores individual messages
-- `resources`: Stores user-specific data for resource-scoped working memory
-- `metadata`: Stores additional metadata for threads and messages
+- `mastra_workflow_snapshot`: Stores workflow state and execution data
+- `mastra_evals`: Stores evaluation results and metadata  
+- `mastra_threads`: Stores conversation threads
+- `mastra_messages`: Stores individual messages
+- `mastra_traces`: Stores telemetry and tracing data
+- `mastra_scorers`: Stores scoring and evaluation data
+- `mastra_resources`: Stores resource working memory data

package/.docs/raw/reference/storage/mssql.mdx

@@ -88,9 +88,13 @@ const store5 = new MSSQLStore({
 
 The storage implementation handles schema creation and updates automatically. It creates the following tables:
 
-- `threads`: Stores conversation threads
-- `messages`: Stores individual messages
-- `metadata`: Stores additional metadata for threads and messages
+- `mastra_workflow_snapshot`: Stores workflow state and execution data
+- `mastra_evals`: Stores evaluation results and metadata  
+- `mastra_threads`: Stores conversation threads
+- `mastra_messages`: Stores individual messages
+- `mastra_traces`: Stores telemetry and tracing data
+- `mastra_scorers`: Stores scoring and evaluation data
+- `mastra_resources`: Stores resource working memory data
 
 ### Direct Database and Pool Access
 

package/.docs/raw/reference/storage/postgresql.mdx

@@ -88,9 +88,13 @@ const store5 = new PostgresStore({
 
 The storage implementation handles schema creation and updates automatically. It creates the following tables:
 
-- `threads`: Stores conversation threads
-- `messages`: Stores individual messages
-- `metadata`: Stores additional metadata for threads and messages
+- `mastra_workflow_snapshot`: Stores workflow state and execution data
+- `mastra_evals`: Stores evaluation results and metadata  
+- `mastra_threads`: Stores conversation threads
+- `mastra_messages`: Stores individual messages
+- `mastra_traces`: Stores telemetry and tracing data
+- `mastra_scorers`: Stores scoring and evaluation data
+- `mastra_resources`: Stores resource working memory data
 
 ### Direct Database and Pool Access
 

package/.docs/raw/reference/templates.mdx

@@ -0,0 +1,228 @@
+---
+title: "Templates Reference"
+description: "Complete guide to creating, using, and contributing Mastra templates"
+---
+
+import { FileTree, Tabs, Callout } from 'nextra/components'
+
+This reference provides comprehensive information about Mastra templates, including how to use existing templates, create your own, and contribute to the community ecosystem.
+
+## Overview
+
+Mastra templates are pre-built project structures that demonstrate specific use cases and patterns. They provide:
+
+- **Working examples** - Complete, functional Mastra applications
+- **Best practices** - Proper project structure and coding conventions
+- **Educational resources** - Learn Mastra patterns through real implementations
+- **Quick starts** - Bootstrap projects faster than building from scratch
+
+## Using Templates
+
+### Installation
+
+Install a template using the `create-mastra` command:
+
+```bash copy
+npx create-mastra@latest --template template-name
+```
+
+This creates a complete project with all necessary code and configuration.
+
+### Setup Process
+
+After installation:
+
+1. **Navigate to project directory**:
+
+   ```bash copy
+   cd your-project-name
+   ```
+
+2. **Configure environment variables**:
+
+   ```bash copy
+   cp .env.example .env
+   ```
+
+   Edit `.env` with required API keys as documented in the template's README.
+
+3. **Install dependencies** (if not done automatically):
+
+   ```bash copy
+   npm install
+   ```
+
+4. **Start development server**:
+
+   ```bash copy
+   npm run dev
+   ```
+
+### Template Structure
+
+All templates follow this standardized structure:
+
+<FileTree>
+  <FileTree.Folder name="template-name" defaultOpen>
+    <FileTree.Folder name="src" defaultOpen>
+      <FileTree.Folder name="mastra" defaultOpen>
+        <FileTree.Folder name="agents">
+          <FileTree.File name="example-agent.ts" />
+        </FileTree.Folder>
+        <FileTree.Folder name="tools">
+          <FileTree.File name="example-tool.ts" />
+        </FileTree.Folder>
+        <FileTree.Folder name="workflows">
+          <FileTree.File name="example-workflow.ts" />
+        </FileTree.Folder>
+        <FileTree.File name="index.ts" />
+      </FileTree.Folder>
+    </FileTree.Folder>
+    <FileTree.File name=".env.example" />
+    <FileTree.File name="package.json" />
+    <FileTree.File name="README.md" />
+    <FileTree.File name="tsconfig.json" />
+  </FileTree.Folder>
+</FileTree>
+
+## Creating Templates
+
+### Requirements
+
+Templates must meet these technical requirements:
+
+#### Project Structure
+
+- **Mastra code location**: All Mastra code must be in `src/mastra/` directory
+- **Component organization**:
+  - Agents: `src/mastra/agents/`
+  - Tools: `src/mastra/tools/`
+  - Workflows: `src/mastra/workflows/`
+  - Main config: `src/mastra/index.ts`
+
+#### TypeScript Configuration
+
+Use the standard Mastra TypeScript configuration:
+
+```json filename="tsconfig.json"
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "outDir": "dist"
+  },
+  "include": ["src/**/*"]
+}
+```
+
+#### Environment Configuration
+
+Include a `.env.example` file with all required environment variables:
+
+```bash filename=".env.example"
+# LLM provider API keys (choose one or more)
+OPENAI_API_KEY=your_openai_api_key_here
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+GOOGLE_GENERATIVE_AI_API_KEY=your_google_api_key_here
+
+# Other service API keys as needed
+OTHER_SERVICE_API_KEY=your_api_key_here
+```
+
+### Code Standards
+
+#### LLM Provider
+
+We recommend using OpenAI, Anthropic, or Google model providers for templates. Choose the provider that best fits your use case:
+
+```typescript filename="src/mastra/agents/example-agent.ts"
+import { Agent } from '@mastra/core/agent';
+import { openai } from '@ai-sdk/openai';
+// Or use: import { anthropic } from '@ai-sdk/anthropic';
+// Or use: import { google } from '@ai-sdk/google';
+
+const agent = new Agent({
+  name: 'example-agent',
+  model: openai('gpt-4'), // or anthropic('') or google('')
+  instructions: 'Your agent instructions here',
+  // ... other configuration
+});
+```
+
+#### Compatibility Requirements
+
+Templates must be:
+
+- **Single projects** - Not monorepos with multiple applications
+- **Framework-free** - No Next.js, Express, or other web framework boilerplate
+- **Mastra-focused** - Demonstrate Mastra functionality without additional layers
+- **Mergeable** - Structure code for easy integration into existing projects
+- **Node.js compatible** - Support Node.js 18 and higher
+- **ESM modules** - Use ES modules (`"type": "module"` in package.json)
+
+### Documentation Requirements
+
+#### README Structure
+
+Every template must include a comprehensive README:
+
+```markdown filename="README.md"
+# Template Name
+
+Brief description of what the template demonstrates.
+
+## Overview
+
+Detailed explanation of the template's functionality and use case.
+
+## Setup
+
+1. Copy `.env.example` to `.env` and fill in your API keys
+2. Install dependencies: `npm install`  
+3. Run the project: `npm run dev`
+
+## Environment Variables
+
+- `OPENAI_API_KEY`: Your OpenAI API key. Get one at [OpenAI Platform](https://platform.openai.com/api-keys)
+- `ANTHROPIC_API_KEY`: Your Anthropic API key. Get one at [Anthropic Console](https://console.anthropic.com/settings/keys)
+- `GOOGLE_GENERATIVE_AI_API_KEY`: Your Google AI API key. Get one at [Google AI Studio](https://makersuite.google.com/app/apikey)
+- `OTHER_API_KEY`: Description of what this key is for
+
+## Usage
+
+Instructions on how to use the template and examples of expected behavior.
+
+## Customization
+
+Guidelines for modifying the template for different use cases.
+```
+
+#### Code Comments
+
+Include clear comments explaining:
+
+- Complex logic or algorithms
+- API integrations and their purpose
+- Configuration options and their effects
+- Example usage patterns
+
+### Quality Standards
+
+Templates must demonstrate:
+
+- **Code quality** - Clean, well-commented, maintainable code
+- **Error handling** - Proper handling for external APIs and user inputs
+- **Type safety** - Full TypeScript typing with Zod validation
+- **Testing** - Verified functionality with fresh installations
+
+For information on contributing your own templates to the Mastra ecosystem, see the [Contributing Templates](/docs/community/contributing-templates) guide in the community section.
+
+<Callout type="info">
+  Templates provide an excellent way to learn Mastra patterns and accelerate development. Contributing templates helps the entire community build better AI applications.
+</Callout>