@mastra/mcp-docs-server 0.0.0-error-handler-fix-20251020202607 → 0.0.0-execa-dynamic-import-20260304221256

package/.docs/raw/reference/observability/otel-tracing/providers/langwatch.mdx

@@ -1,43 +0,0 @@
----
-title: "Reference: LangWatch Integration | Mastra Observability Docs"
-description: Documentation for integrating LangWatch with Mastra, a specialized observability platform for LLM applications.
----
-
-# LangWatch
-
-LangWatch is a specialized observability platform for LLM applications.
-
-## Configuration
-
-To use LangWatch with Mastra, configure these environment variables:
-
-```env
-LANGWATCH_API_KEY=your_api_key
-```
-
-## Implementation
-
-Here's how to configure Mastra to use LangWatch:
-
-```typescript
-import { Mastra } from "@mastra/core";
-import { LangWatchExporter } from "langwatch";
-
-export const mastra = new Mastra({
-  // ... other config
-  telemetry: {
-    serviceName: "ai", // this must be set to "ai" so that the LangWatchExporter thinks it's an AI SDK trace
-    enabled: true,
-    export: {
-      type: "custom",
-      exporter: new LangWatchExporter({
-        apiKey: process.env.LANGWATCH_API_KEY
-      }),
-    },
-  },
-});
-```
-
-## Dashboard
-
-Access your LangWatch dashboard at [app.langwatch.ai](https://app.langwatch.ai)

package/.docs/raw/reference/observability/otel-tracing/providers/new-relic.mdx

@@ -1,40 +0,0 @@
----
-title: "Reference: New Relic Integration | Mastra Observability Docs"
-description: Documentation for integrating New Relic with Mastra, a comprehensive observability platform supporting OpenTelemetry for full-stack monitoring.
----
-
-# New Relic
-
-New Relic is a comprehensive observability platform that supports OpenTelemetry (OTLP) for full-stack monitoring.
-
-## Configuration
-
-To use New Relic with Mastra via OTLP, configure these environment variables:
-
-```env
-OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.nr-data.net:4317
-OTEL_EXPORTER_OTLP_HEADERS="api-key=your_license_key"
-```
-
-## Implementation
-
-Here's how to configure Mastra to use New Relic:
-
-```typescript
-import { Mastra } from "@mastra/core";
-
-export const mastra = new Mastra({
-  // ... other config
-  telemetry: {
-    serviceName: "your-service-name",
-    enabled: true,
-    export: {
-      type: "otlp",
-    },
-  },
-});
-```
-
-## Dashboard
-
-View your telemetry data in the New Relic One dashboard at [one.newrelic.com](https://one.newrelic.com)

package/.docs/raw/reference/observability/otel-tracing/providers/signoz.mdx

@@ -1,40 +0,0 @@
----
-title: "Reference: SigNoz Integration | Mastra Observability Docs"
-description: Documentation for integrating SigNoz with Mastra, an open-source APM and observability platform providing full-stack monitoring through OpenTelemetry.
----
-
-# SigNoz
-
-SigNoz is an open-source APM and observability platform that provides full-stack monitoring capabilities through OpenTelemetry.
-
-## Configuration
-
-To use SigNoz with Mastra, configure these environment variables:
-
-```env
-OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.{region}.signoz.cloud:443
-OTEL_EXPORTER_OTLP_HEADERS=signoz-ingestion-key=your_signoz_token
-```
-
-## Implementation
-
-Here's how to configure Mastra to use SigNoz:
-
-```typescript
-import { Mastra } from "@mastra/core";
-
-export const mastra = new Mastra({
-  // ... other config
-  telemetry: {
-    serviceName: "your-service-name",
-    enabled: true,
-    export: {
-      type: "otlp",
-    },
-  },
-});
-```
-
-## Dashboard
-
-Access your SigNoz dashboard at [signoz.io](https://signoz.io/)

package/.docs/raw/reference/observability/otel-tracing/providers/traceloop.mdx

@@ -1,40 +0,0 @@
----
-title: "Reference: Traceloop Integration | Mastra Observability Docs"
-description: Documentation for integrating Traceloop with Mastra, an OpenTelemetry-native observability platform for LLM applications.
----
-
-# Traceloop
-
-Traceloop is an OpenTelemetry-native observability platform specifically designed for LLM applications.
-
-## Configuration
-
-To use Traceloop with Mastra, configure these environment variables:
-
-```env
-OTEL_EXPORTER_OTLP_ENDPOINT=https://api.traceloop.com
-OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your_api_key, x-traceloop-destination-id=your_destination_id"
-```
-
-## Implementation
-
-Here's how to configure Mastra to use Traceloop:
-
-```typescript
-import { Mastra } from "@mastra/core";
-
-export const mastra = new Mastra({
-  // ... other config
-  telemetry: {
-    serviceName: "your-service-name",
-    enabled: true,
-    export: {
-      type: "otlp",
-    },
-  },
-});
-```
-
-## Dashboard
-
-Access your traces and analytics in the Traceloop dashboard at [app.traceloop.com](https://app.traceloop.com)

package/.docs/raw/reference/processors/batch-parts-processor.mdx

@@ -1,111 +0,0 @@
----
-title: "Reference: Batch Parts Processor | Processors | Mastra Docs"
-description: "Documentation for the BatchPartsProcessor in Mastra, which batches multiple stream parts together to reduce frequency of emissions."
----
-
-# BatchPartsProcessor
-
-The `BatchPartsProcessor` is an **output processor** that batches multiple stream parts together to reduce the frequency of emissions during streaming. This processor is useful for reducing network overhead, improving user experience by consolidating small text chunks, and optimizing streaming performance by controlling when parts are emitted to the client.
-
-## Usage example
-
-```typescript copy
-import { BatchPartsProcessor } from "@mastra/core/processors";
-
-const processor = new BatchPartsProcessor({
-  batchSize: 5,
-  maxWaitTime: 100,
-  emitOnNonText: true
-});
-```
-
-## Constructor parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "options",
-      type: "Options",
-      description: "Configuration options for batching stream parts",
-      isOptional: true,
-    },
-  ]}
-/>
-
-### Options
-
-<PropertiesTable
-  content={[
-    {
-      name: "batchSize",
-      type: "number",
-      description: "Number of parts to batch together before emitting",
-      isOptional: true,
-      default: "5",
-    },
-    {
-      name: "maxWaitTime",
-      type: "number",
-      description: "Maximum time to wait before emitting a batch (in milliseconds). If set, will emit the current batch even if it hasn't reached batchSize",
-      isOptional: true,
-      default: "undefined (no timeout)",
-    },
-    {
-      name: "emitOnNonText",
-      type: "boolean",
-      description: "Whether to emit immediately when a non-text part is encountered",
-      isOptional: true,
-      default: "true",
-    },
-  ]}
-/>
-
-## Returns
-
-<PropertiesTable
-  content={[
-    {
-      name: "name",
-      type: "string",
-      description: "Processor name set to 'batch-parts'",
-      isOptional: false,
-    },
-    {
-      name: "processOutputStream",
-      type: "(args: { part: ChunkType; streamParts: ChunkType[]; state: Record<string, any>; abort: (reason?: string) => never }) => Promise<ChunkType | null>",
-      description: "Processes streaming output parts to batch them together",
-      isOptional: false,
-    },
-    {
-      name: "flush",
-      type: "(state?: BatchPartsState) => ChunkType | null",
-      description: "Force flush any remaining batched parts when the stream ends",
-      isOptional: false,
-    },
-  ]}
-/>
-
-## Extended usage example
-
-```typescript filename="src/mastra/agents/batched-agent.ts" showLineNumbers copy
-import { openai } from "@ai-sdk/openai";
-import { Agent } from "@mastra/core/agent";
-import { BatchPartsProcessor } from "@mastra/core/processors";
-
-export const agent = new Agent({
-  name: "batched-agent",
-  instructions: "You are a helpful assistant",
-  model: openai("gpt-4o-mini"),
-  outputProcessors: [
-    new BatchPartsProcessor({
-      batchSize: 5,
-      maxWaitTime: 100,
-      emitOnNonText: true
-    })
-  ]
-});
-```
-
-## Related
-
-- [Output Processors documentation](/docs/agents/output-processors)

package/.docs/raw/reference/processors/language-detector.mdx

@@ -1,154 +0,0 @@
----
-title: "Reference: Language Detector | Processors | Mastra Docs"
-description: "Documentation for the LanguageDetector in Mastra, which detects language and can translate content in AI responses."
----
-
-# LanguageDetector
-
-The `LanguageDetector` is an **input processor** that identifies the language of input text and optionally translates it to a target language for consistent processing. This processor helps maintain language consistency by detecting the language of incoming messages and providing flexible strategies for handling multilingual content, including automatic translation to ensure all content is processed in the target language.
-
-## Usage example
-
-```typescript copy
-import { openai } from "@ai-sdk/openai";
-import { LanguageDetector } from "@mastra/core/processors";
-
-const processor = new LanguageDetector({
-  model: openai("gpt-4.1-nano"),
-  targetLanguages: ["English", "en"],
-  threshold: 0.8,
-  strategy: "translate"
-});
-```
-
-## Constructor parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "options",
-      type: "Options",
-      description: "Configuration options for language detection and translation",
-      isOptional: false,
-    },
-  ]}
-/>
-
-### Options
-
-<PropertiesTable
-  content={[
-    {
-      name: "model",
-      type: "MastraLanguageModel",
-      description: "Model configuration for the detection/translation agent",
-      isOptional: false,
-    },
-    {
-      name: "targetLanguages",
-      type: "string[]",
-      description: "Target language(s) for the project. If content is detected in a different language, it may be translated. Can be language name ('English') or ISO code ('en')",
-      isOptional: true,
-      default: "['English', 'en']",
-    },
-    {
-      name: "threshold",
-      type: "number",
-      description: "Confidence threshold for language detection (0-1). Only process when detection confidence exceeds this threshold",
-      isOptional: true,
-      default: "0.7",
-    },
-    {
-      name: "strategy",
-      type: "'detect' | 'translate' | 'block' | 'warn'",
-      description: "Strategy when non-target language is detected: 'detect' only detects language, 'translate' automatically translates to target language, 'block' rejects content not in target language, 'warn' logs warning but allows through",
-      isOptional: true,
-      default: "'detect'",
-    },
-    {
-      name: "preserveOriginal",
-      type: "boolean",
-      description: "Whether to preserve original content in message metadata. Useful for audit trails and debugging",
-      isOptional: true,
-      default: "true",
-    },
-    {
-      name: "instructions",
-      type: "string",
-      description: "Custom detection instructions for the agent. If not provided, uses default instructions",
-      isOptional: true,
-      default: "undefined",
-    },
-    {
-      name: "minTextLength",
-      type: "number",
-      description: "Minimum text length to perform detection. Short text is often unreliable for language detection",
-      isOptional: true,
-      default: "10",
-    },
-    {
-      name: "includeDetectionDetails",
-      type: "boolean",
-      description: "Whether to include detailed detection info in logs",
-      isOptional: true,
-      default: "false",
-    },
-    {
-      name: "translationQuality",
-      type: "'speed' | 'quality' | 'balanced'",
-      description: "Translation quality preference: 'speed' prioritizes fast translation, 'quality' prioritizes accuracy, 'balanced' balances between speed and quality",
-      isOptional: true,
-      default: "'quality'",
-    },
-  ]}
-/>
-
-## Returns
-
-<PropertiesTable
-  content={[
-    {
-      name: "name",
-      type: "string",
-      description: "Processor name set to 'language-detector'",
-      isOptional: false,
-    },
-    {
-      name: "processInput",
-      type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",
-      description: "Processes input messages to detect language and optionally translate content before sending to LLM",
-      isOptional: false,
-    },
-  ]}
-/>
-
-## Extended usage example
-
-```typescript filename="src/mastra/agents/multilingual-agent.ts" showLineNumbers copy
-import { openai } from "@ai-sdk/openai";
-import { Agent } from "@mastra/core/agent";
-import { LanguageDetector } from "@mastra/core/processors";
-
-export const agent = new Agent({
-  name: "multilingual-agent",
-  instructions: "You are a helpful assistant",
-  model: openai("gpt-4o-mini"),
-  inputProcessors: [
-    new LanguageDetector({
-      model: openai("gpt-4.1-nano"),
-      targetLanguages: ["English", "en"],
-      threshold: 0.8,
-      strategy: "translate",
-      preserveOriginal: true,
-      instructions: "Detect language and translate non-English content to English while preserving original intent",
-      minTextLength: 10,
-      includeDetectionDetails: true,
-      translationQuality: "quality"
-    })
-  ]
-});
-```
-
-## Related
-
-- [Input Processors](/docs/agents/input-processors)

package/.docs/raw/reference/processors/moderation-processor.mdx

@@ -1,145 +0,0 @@
----
-title: "Reference: Moderation Processor | Processors | Mastra Docs"
-description: "Documentation for the ModerationProcessor in Mastra, which provides content moderation using LLM to detect inappropriate content across multiple categories."
----
-
-# ModerationProcessor
-
-The `ModerationProcessor` is a **hybrid processor** that can be used for both input and output processing to provide content moderation using an LLM to detect inappropriate content across multiple categories. This processor helps maintain content safety by evaluating messages against configurable moderation categories with flexible strategies for handling flagged content.
-
-## Usage example
-
-```typescript copy
-import { openai } from "@ai-sdk/openai";
-import { ModerationProcessor } from "@mastra/core/processors";
-
-const processor = new ModerationProcessor({
-  model: openai("gpt-4.1-nano"),
-  threshold: 0.7,
-  strategy: "block",
-  categories: ["hate", "harassment", "violence"]
-});
-```
-
-## Constructor parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "options",
-      type: "Options",
-      description: "Configuration options for content moderation",
-      isOptional: false,
-    },
-  ]}
-/>
-
-### Options
-
-<PropertiesTable
-  content={[
-    {
-      name: "model",
-      type: "MastraLanguageModel",
-      description: "Model configuration for the moderation agent",
-      isOptional: false,
-    },
-    {
-      name: "categories",
-      type: "string[]",
-      description: "Categories to check for moderation. If not specified, uses default OpenAI categories",
-      isOptional: true,
-      default: "['hate', 'hate/threatening', 'harassment', 'harassment/threatening', 'self-harm', 'self-harm/intent', 'self-harm/instructions', 'sexual', 'sexual/minors', 'violence', 'violence/graphic']",
-    },
-    {
-      name: "threshold",
-      type: "number",
-      description: "Confidence threshold for flagging (0-1). Content is flagged if any category score exceeds this threshold",
-      isOptional: true,
-      default: "0.5",
-    },
-    {
-      name: "strategy",
-      type: "'block' | 'warn' | 'filter'",
-      description: "Strategy when content is flagged: 'block' rejects with error, 'warn' logs warning but allows through, 'filter' removes flagged messages",
-      isOptional: true,
-      default: "'block'",
-    },
-    {
-      name: "instructions",
-      type: "string",
-      description: "Custom moderation instructions for the agent. If not provided, uses default instructions based on categories",
-      isOptional: true,
-      default: "undefined",
-    },
-    {
-      name: "includeScores",
-      type: "boolean",
-      description: "Whether to include confidence scores in logs. Useful for tuning thresholds and debugging",
-      isOptional: true,
-      default: "false",
-    },
-    {
-      name: "chunkWindow",
-      type: "number",
-      description: "Number of previous chunks to include for context when moderating stream chunks. If set to 1, includes the previous part, etc.",
-      isOptional: true,
-      default: "0 (no context window)",
-    },
-  ]}
-/>
-
-## Returns
-
-<PropertiesTable
-  content={[
-    {
-      name: "name",
-      type: "string",
-      description: "Processor name set to 'moderation'",
-      isOptional: false,
-    },
-    {
-      name: "processInput",
-      type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",
-      description: "Processes input messages to moderate content before sending to LLM",
-      isOptional: false,
-    },
-    {
-      name: "processOutputStream",
-      type: "(args: { part: ChunkType; streamParts: ChunkType[]; state: Record<string, any>; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<ChunkType | null | undefined>",
-      description: "Processes streaming output parts to moderate content during streaming",
-      isOptional: false,
-    },
-  ]}
-/>
-
-## Extended usage example
-
-```typescript filename="src/mastra/agents/moderated-agent.ts" showLineNumbers copy
-import { openai } from "@ai-sdk/openai";
-import { Agent } from "@mastra/core/agent";
-import { ModerationProcessor } from "@mastra/core/processors";
-
-export const agent = new Agent({
-  name: "moderated-agent",
-  instructions: "You are a helpful assistant",
-  model: openai("gpt-4o-mini"),
-  inputProcessors: [
-    new ModerationProcessor({
-      model: openai("gpt-4.1-nano"),
-      categories: ["hate", "harassment", "violence"],
-      threshold: 0.7,
-      strategy: "block",
-      instructions: "Detect and flag inappropriate content in user messages",
-      includeScores: true,
-      chunkWindow: 1
-    })
-  ]
-});
-```
-
-## Related
-
-- [Input Processors](/docs/agents/input-processors)
-- [Output Processors](/docs/agents/output-processors)