@mastra/mcp-docs-server 0.13.37 → 0.13.38

package/.docs/raw/reference/observability/ai-tracing/exporters/default-exporter.mdx

@@ -1,9 +1,9 @@
 ---
-title: "DefaultExporter | Exporters | AI Tracing | Reference"
+title: "Reference: DefaultExporter | Observability | Mastra Docs"
 description: API reference for the DefaultExporter
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # DefaultExporter
 
@@ -26,7 +26,8 @@ new DefaultExporter(config?: BatchingConfig, logger?: IMastraLogger)
     {
       name: "logger",
       type: "IMastraLogger",
-      description: "Logger instance. Falls back to ConsoleLogger with INFO level if not provided",
+      description:
+        "Logger instance. Falls back to ConsoleLogger with INFO level if not provided",
       required: false,
     },
   ]}
@@ -38,28 +39,28 @@ new DefaultExporter(config?: BatchingConfig, logger?: IMastraLogger)
 interface BatchingConfig {
   /** Maximum number of spans per batch. Default: 1000 */
   maxBatchSize?: number;
-  
+
   /** Maximum total buffer size before emergency flush. Default: 10000 */
   maxBufferSize?: number;
-  
+
   /** Maximum time to wait before flushing batch in milliseconds. Default: 5000 */
   maxBatchWaitMs?: number;
-  
+
   /** Maximum number of retry attempts. Default: 4 */
   maxRetries?: number;
-  
+
   /** Base retry delay in milliseconds (uses exponential backoff). Default: 500 */
   retryDelayMs?: number;
-  
+
   /** Tracing strategy or 'auto' for automatic selection. Default: 'auto' */
-  strategy?: TracingStrategy | 'auto';
+  strategy?: TracingStrategy | "auto";
 }
 ```
 
 ## TracingStrategy
 
 ```typescript
-type TracingStrategy = 'realtime' | 'batch-with-updates' | 'insert-only';
+type TracingStrategy = "realtime" | "batch-with-updates" | "insert-only";
 ```
 
 ### Strategy Behaviors
@@ -76,7 +77,7 @@ readonly name = 'tracing-default-exporter';
 
 ## Methods
 
-### __registerMastra
+### \_\_registerMastra
 
 ```typescript
 __registerMastra(mastra: Mastra): void
@@ -127,13 +128,14 @@ When `strategy: 'auto'` (default), the exporter queries the storage adapter for
 interface AITracingStrategy {
   /** Strategies supported by this adapter */
   supported: TracingStrategy[];
-  
+
   /** Preferred strategy for optimal performance */
   preferred: TracingStrategy;
 }
 ```
 
 The exporter will:
+
 1. Use the storage adapter's preferred strategy if available
 2. Fall back to the first supported strategy if preferred isn't available
 3. Log a warning if a user-specified strategy isn't supported
@@ -143,6 +145,7 @@ The exporter will:
 ### Flush Triggers
 
 The buffer flushes when any of these conditions are met:
+
 - Buffer size reaches `maxBatchSize`
 - Time since first buffered event exceeds `maxBatchWaitMs`
 - Buffer size reaches `maxBufferSize` (emergency flush)
@@ -151,6 +154,7 @@ The buffer flushes when any of these conditions are met:
 ### Retry Logic
 
 Failed flushes are retried with exponential backoff:
+
 - Retry delay: `retryDelayMs * 2^attempt`
 - Maximum attempts: `maxRetries`
 - Batch is dropped after all retries fail
@@ -158,6 +162,7 @@ Failed flushes are retried with exponential backoff:
 ### Out-of-Order Handling
 
 For `batch-with-updates` strategy:
+
 - Tracks which spans have been created
 - Rejects updates/ends for spans not yet created
 - Logs warnings for out-of-order events
@@ -166,7 +171,7 @@ For `batch-with-updates` strategy:
 ## Usage
 
 ```typescript
-import { DefaultExporter } from '@mastra/core/ai-tracing';
+import { DefaultExporter } from "@mastra/core/ai-tracing";
 
 // Default configuration
 const exporter = new DefaultExporter();
@@ -175,22 +180,25 @@ const exporter = new DefaultExporter();
 const customExporter = new DefaultExporter({
   maxBatchSize: 500,
   maxBatchWaitMs: 2000,
-  strategy: 'batch-with-updates'
+  strategy: "batch-with-updates",
 });
 ```
 
 ## See Also
 
 ### Documentation
+
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Complete guide
 - [Exporters](/docs/observability/ai-tracing/overview#exporters) - Exporter concepts
 
 ### Other Exporters
+
 - [CloudExporter](/reference/observability/ai-tracing/exporters/cloud-exporter) - Mastra Cloud
 - [ConsoleExporter](/reference/observability/ai-tracing/exporters/console-exporter) - Debug output
 - [Langfuse](/reference/observability/ai-tracing/exporters/langfuse) - Langfuse integration
 - [Braintrust](/reference/observability/ai-tracing/exporters/braintrust) - Braintrust integration
 
 ### Reference
+
 - [Configuration](/reference/observability/ai-tracing/configuration) - Configuration options
-- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions
+- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions

package/.docs/raw/reference/observability/ai-tracing/exporters/langfuse.mdx

@@ -1,9 +1,9 @@
 ---
-title: "LangfuseExporter | Exporters | AI Tracing | Reference"
+title: "Reference: LangfuseExporter | Observability | Mastra Docs"
 description: Langfuse exporter for AI tracing
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # LangfuseExporter
 
@@ -23,7 +23,7 @@ interface LangfuseExporterConfig {
   secretKey?: string;
   baseUrl?: string;
   realtime?: boolean;
-  logLevel?: 'debug' | 'info' | 'warn' | 'error';
+  logLevel?: "debug" | "info" | "warn" | "error";
   options?: any;
 }
 ```
@@ -98,12 +98,12 @@ Flushes pending data and shuts down the client.
 ## Usage
 
 ```typescript
-import { LangfuseExporter } from '@mastra/langfuse';
+import { LangfuseExporter } from "@mastra/langfuse";
 
 const exporter = new LangfuseExporter({
   publicKey: process.env.LANGFUSE_PUBLIC_KEY,
   secretKey: process.env.LANGFUSE_SECRET_KEY,
-  baseUrl: 'https://cloud.langfuse.com',
+  baseUrl: "https://cloud.langfuse.com",
   realtime: true,
 });
 ```
@@ -113,4 +113,4 @@ const exporter = new LangfuseExporter({
 - Root spans → Langfuse traces
 - `MODEL_GENERATION` spans → Langfuse generations
 - All other spans → Langfuse spans
-- Event spans → Langfuse events
+- Event spans → Langfuse events

package/.docs/raw/reference/observability/ai-tracing/exporters/langsmith.mdx

@@ -1,9 +1,9 @@
 ---
-title: "LangSmithExporter | Exporters | AI Tracing | Reference"
+title: "Reference: LangSmithExporter | Observability | Mastra Docs"
 description: LangSmith exporter for AI tracing
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # LangSmithExporter
 
@@ -19,7 +19,7 @@ new LangSmithExporter(config: LangSmithExporterConfig)
 
 ```typescript
 interface LangSmithExporterConfig extends ClientConfig {
-  logLevel?: 'debug' | 'info' | 'warn' | 'error';
+  logLevel?: "debug" | "info" | "warn" | "error";
   client?: Client;
 }
 ```
@@ -92,21 +92,21 @@ Ends all active spans and clears the trace map.
 ## Usage
 
 ```typescript
-import { LangSmithExporter } from '@mastra/langsmith';
+import { LangSmithExporter } from "@mastra/langsmith";
 
 const exporter = new LangSmithExporter({
   apiKey: process.env.LANGSMITH_API_KEY,
-  apiUrl: 'https://api.smith.langchain.com',
-  logLevel: 'info',
+  apiUrl: "https://api.smith.langchain.com",
+  logLevel: "info",
 });
 ```
 
 ## Span Type Mapping
 
-| AI Span Type | LangSmith Type |
-|--------------|----------------|
-| `MODEL_GENERATION` | `llm` |
-| `MODEL_CHUNK` | `llm` |
-| `TOOL_CALL` | `tool` |
-| `MCP_TOOL_CALL` | `tool` |
-| All others | `chain` |
+| AI Span Type       | LangSmith Type |
+| ------------------ | -------------- |
+| `MODEL_GENERATION` | `llm`          |
+| `MODEL_CHUNK`      | `llm`          |
+| `TOOL_CALL`        | `tool`         |
+| `MCP_TOOL_CALL`    | `tool`         |
+| All others         | `chain`        |

package/.docs/raw/reference/observability/ai-tracing/exporters/otel.mdx

@@ -1,16 +1,17 @@
 ---
-title: "OtelExporter | Exporters | AI Tracing | Reference"
+title: "Reference: OtelExporter | Observability | Mastra Docs"
 description: OpenTelemetry exporter for AI tracing
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
-import { Callout } from "nextra/components";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # OtelExporter
 
-<Callout type="warning">
+:::warning
+
 The OtelExporter is currently **experimental**. APIs and configuration options may change in future releases.
-</Callout>
+
+:::
 
 Sends AI tracing data to any OpenTelemetry-compatible observability platform using standardized GenAI semantic conventions.
 
@@ -27,7 +28,7 @@ interface OtelExporterConfig {
   provider?: ProviderConfig;
   timeout?: number;
   batchSize?: number;
-  logLevel?: 'debug' | 'info' | 'warn' | 'error';
+  logLevel?: "debug" | "info" | "warn" | "error";
 }
 ```
 
@@ -60,9 +61,10 @@ interface OtelExporterConfig {
     {
       name: "resourceAttributes",
       type: "DetectedResourceAttributes",
-      description: "Optional OpenTelemetry Resource Attributes (values here override any defaults)",
+      description:
+        "Optional OpenTelemetry Resource Attributes (values here override any defaults)",
       required: false,
-    }
+    },
   ]}
 />
 
@@ -89,7 +91,8 @@ interface Dash0Config {
     {
       name: "endpoint",
       type: "string",
-      description: "Dash0 ingress endpoint (e.g., ingress.us-west-2.aws.dash0.com:4317)",
+      description:
+        "Dash0 ingress endpoint (e.g., ingress.us-west-2.aws.dash0.com:4317)",
       required: true,
     },
     {
@@ -106,7 +109,7 @@ interface Dash0Config {
 ```typescript
 interface SignozConfig {
   apiKey: string;
-  region?: 'us' | 'eu' | 'in';
+  region?: "us" | "eu" | "in";
   endpoint?: string;
 }
 ```
@@ -154,7 +157,8 @@ interface NewRelicConfig {
     {
       name: "endpoint",
       type: "string",
-      description: "Custom endpoint (default: https://otlp.nr-data.net:443/v1/traces)",
+      description:
+        "Custom endpoint (default: https://otlp.nr-data.net:443/v1/traces)",
       required: false,
     },
   ]}
@@ -187,7 +191,8 @@ interface TraceloopConfig {
     {
       name: "endpoint",
       type: "string",
-      description: "Custom endpoint (default: https://api.traceloop.com/v1/traces)",
+      description:
+        "Custom endpoint (default: https://api.traceloop.com/v1/traces)",
       required: false,
     },
   ]}
@@ -231,7 +236,7 @@ interface LaminarConfig {
 ```typescript
 interface CustomConfig {
   endpoint: string;
-  protocol?: 'http/json' | 'http/protobuf' | 'grpc' | 'zipkin';
+  protocol?: "http/json" | "http/protobuf" | "grpc" | "zipkin";
   headers?: Record<string, string>;
 }
 ```
@@ -282,14 +287,14 @@ Flushes pending traces and shuts down the exporter.
 ### Basic Usage
 
 ```typescript
-import { OtelExporter } from '@mastra/otel-exporter';
+import { OtelExporter } from "@mastra/otel-exporter";
 
 const exporter = new OtelExporter({
   provider: {
     signoz: {
       apiKey: process.env.SIGNOZ_API_KEY,
-      region: 'us',
-    }
+      region: "us",
+    },
   },
 });
 ```
@@ -300,15 +305,15 @@ const exporter = new OtelExporter({
 const exporter = new OtelExporter({
   provider: {
     custom: {
-      endpoint: 'https://my-collector.example.com/v1/traces',
-      protocol: 'http/protobuf',
+      endpoint: "https://my-collector.example.com/v1/traces",
+      protocol: "http/protobuf",
       headers: {
-        'x-api-key': process.env.API_KEY,
+        "x-api-key": process.env.API_KEY,
       },
-    }
+    },
   },
   timeout: 60000,
-  logLevel: 'debug',
+  logLevel: "debug",
 });
 ```
 
@@ -317,12 +322,14 @@ const exporter = new OtelExporter({
 The exporter maps Mastra AI spans to OpenTelemetry spans following GenAI semantic conventions:
 
 ### Span Names
+
 - `MODEL_GENERATION` → `chat {model}` or `tool_selection {model}`
 - `TOOL_CALL` → `tool.execute {tool_name}`
 - `AGENT_RUN` → `agent.{agent_id}`
 - `WORKFLOW_RUN` → `workflow.{workflow_id}`
 
 ### Span Kinds
+
 - Root agent/workflow spans → `SERVER`
 - LLM calls → `CLIENT`
 - Tool calls → `INTERNAL` or `CLIENT`
@@ -332,30 +339,31 @@ The exporter maps Mastra AI spans to OpenTelemetry spans following GenAI semanti
 
 The exporter maps to standard OTEL GenAI attributes:
 
-| Mastra Attribute | OTEL Attribute |
-|------------------|----------------|
-| `model` | `gen_ai.request.model` |
-| `provider` | `gen_ai.system` |
-| `inputTokens` / `promptTokens` | `gen_ai.usage.input_tokens` |
-| `outputTokens` / `completionTokens` | `gen_ai.usage.output_tokens` |
-| `temperature` | `gen_ai.request.temperature` |
-| `maxOutputTokens` | `gen_ai.request.max_tokens` |
-| `finishReason` | `gen_ai.response.finish_reasons` |
+| Mastra Attribute                    | OTEL Attribute                   |
+| ----------------------------------- | -------------------------------- |
+| `model`                             | `gen_ai.request.model`           |
+| `provider`                          | `gen_ai.system`                  |
+| `inputTokens` / `promptTokens`      | `gen_ai.usage.input_tokens`      |
+| `outputTokens` / `completionTokens` | `gen_ai.usage.output_tokens`     |
+| `temperature`                       | `gen_ai.request.temperature`     |
+| `maxOutputTokens`                   | `gen_ai.request.max_tokens`      |
+| `finishReason`                      | `gen_ai.response.finish_reasons` |
 
 ## Protocol Requirements
 
 Different providers require different OTEL exporter packages:
 
-| Protocol | Required Package | Providers |
-|----------|------------------|-----------|
-| gRPC | `@opentelemetry/exporter-trace-otlp-grpc` | Dash0 |
+| Protocol      | Required Package                           | Providers                  |
+| ------------- | ------------------------------------------ | -------------------------- |
+| gRPC          | `@opentelemetry/exporter-trace-otlp-grpc`  | Dash0                      |
 | HTTP/Protobuf | `@opentelemetry/exporter-trace-otlp-proto` | SigNoz, New Relic, Laminar |
-| HTTP/JSON | `@opentelemetry/exporter-trace-otlp-http` | Traceloop, Custom |
-| Zipkin | `@opentelemetry/exporter-zipkin` | Zipkin collectors |
+| HTTP/JSON     | `@opentelemetry/exporter-trace-otlp-http`  | Traceloop, Custom          |
+| Zipkin        | `@opentelemetry/exporter-zipkin`           | Zipkin collectors          |
 
 ## Parent-Child Relationships
 
 The exporter preserves span hierarchy from Mastra's AI tracing:
+
 - Uses `parentSpanId` directly from Mastra spans
 - Maintains correct nesting for agents, workflows, LLM calls, and tools
-- Exports complete traces with all relationships intact
+- Exports complete traces with all relationships intact