@mastra/mcp-docs-server 0.13.39 → 1.0.0-beta.1

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

@@ -12,31 +12,24 @@ Persists traces to Mastra's configured storage with automatic batching and retry
 ## Constructor
 
 ```typescript
-new DefaultExporter(config?: BatchingConfig, logger?: IMastraLogger)
+new DefaultExporter(config?: DefaultExporterConfig)
 ```
 
 <PropertiesTable
   props={[
     {
       name: "config",
-      type: "BatchingConfig",
-      description: "Batching configuration options",
-      required: false,
-    },
-    {
-      name: "logger",
-      type: "IMastraLogger",
-      description:
-        "Logger instance. Falls back to ConsoleLogger with INFO level if not provided",
+      type: "DefaultExporterConfig",
+      description: "Batching and configuration options",
       required: false,
     },
   ]}
 />
 
-## BatchingConfig
+## DefaultExporterConfig
 
 ```typescript
-interface BatchingConfig {
+interface DefaultExporterConfig extends BaseExporterConfig {
   /** Maximum number of spans per batch. Default: 1000 */
   maxBatchSize?: number;
 
@@ -52,15 +45,19 @@ interface BatchingConfig {
   /** Base retry delay in milliseconds (uses exponential backoff). Default: 500 */
   retryDelayMs?: number;
 
-  /** Tracing strategy or 'auto' for automatic selection. Default: 'auto' */
-  strategy?: TracingStrategy | "auto";
+  /** Tracing storage strategy or 'auto' for automatic selection. Default: 'auto' */
+  strategy?: TracingStorageStrategy | "auto";
 }
 ```
 
-## TracingStrategy
+Extends `BaseExporterConfig`, which includes:
+- `logger?: IMastraLogger` - Logger instance
+- `logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'` - Log level (default: INFO)
+
+## TracingStorageStrategy
 
 ```typescript
-type TracingStrategy = "realtime" | "batch-with-updates" | "insert-only";
+type TracingStorageStrategy = "realtime" | "batch-with-updates" | "insert-only";
 ```
 
 ### Strategy Behaviors
@@ -72,31 +69,34 @@ type TracingStrategy = "realtime" | "batch-with-updates" | "insert-only";
 ## Properties
 
 ```typescript
-readonly name = 'tracing-default-exporter';
+readonly name = 'mastra-default-observability-exporter';
 ```
 
 ## Methods
 
-### \_\_registerMastra
-
-```typescript
-__registerMastra(mastra: Mastra): void
-```
-
-Registers the Mastra instance. Called automatically after Mastra construction.
-
 ### init
 
 ```typescript
-init(): void
+init(options: InitExporterOptions): void
 ```
 
 Initializes the exporter after dependencies are ready. Resolves tracing strategy based on storage capabilities.
 
-### exportEvent
+<PropertiesTable
+  props={[
+    {
+      name: "options",
+      type: "InitExporterOptions",
+      description: "Initialization options containing Mastra instance and config",
+      required: true,
+    },
+  ]}
+/>
+
+### exportTracingEvent
 
 ```typescript
-async exportEvent(event: AITracingEvent): Promise<void>
+async exportTracingEvent(event: TracingEvent): Promise<void>
 ```
 
 Processes a tracing event according to the resolved strategy.
@@ -105,7 +105,7 @@ Processes a tracing event according to the resolved strategy.
   props={[
     {
       name: "event",
-      type: "AITracingEvent",
+      type: "TracingEvent",
       description: "The tracing event to export",
       required: true,
     },
@@ -125,12 +125,12 @@ Flushes remaining buffered events and performs cleanup.
 When `strategy: 'auto'` (default), the exporter queries the storage adapter for its capabilities:
 
 ```typescript
-interface AITracingStrategy {
+interface TracingStrategy {
   /** Strategies supported by this adapter */
-  supported: TracingStrategy[];
+  supported: TracingStorageStrategy[];
 
   /** Preferred strategy for optimal performance */
-  preferred: TracingStrategy;
+  preferred: TracingStorageStrategy;
 }
 ```
 
@@ -171,7 +171,7 @@ For `batch-with-updates` strategy:
 ## Usage
 
 ```typescript
-import { DefaultExporter } from "@mastra/core/ai-tracing";
+import { DefaultExporter } from "@mastra/observability";
 
 // Default configuration
 const exporter = new DefaultExporter();
@@ -181,6 +181,7 @@ const customExporter = new DefaultExporter({
   maxBatchSize: 500,
   maxBatchWaitMs: 2000,
   strategy: "batch-with-updates",
+  logLevel: 'debug'
 });
 ```
 
@@ -188,17 +189,17 @@ const customExporter = new DefaultExporter({
 
 ### Documentation
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Complete guide
-- [Exporters](/docs/observability/ai-tracing/overview#exporters) - Exporter concepts
+- [Tracing Overview](/docs/v1/observability/tracing/overview) - Complete guide
+- [Exporters](/docs/v1/observability/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
+- [CloudExporter](/reference/v1/observability/tracing/exporters/cloud-exporter) - Mastra Cloud
+- [ConsoleExporter](/reference/v1/observability/tracing/exporters/console-exporter) - Debug output
+- [Langfuse](/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
+- [Braintrust](/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
 
 ### Reference
 
-- [Configuration](/reference/observability/ai-tracing/configuration) - Configuration options
-- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions
+- [Configuration](/reference/v1/observability/tracing/configuration) - Configuration options
+- [Interfaces](/reference/v1/observability/tracing/interfaces) - Type definitions

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

@@ -1,13 +1,13 @@
 ---
 title: "Reference: LangfuseExporter | Observability | Mastra Docs"
-description: Langfuse exporter for AI tracing
+description: Langfuse exporter for Tracing
 ---
 
 import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # LangfuseExporter
 
-Sends AI tracing data to Langfuse for observability.
+Sends Tracing data to Langfuse for observability.
 
 ## Constructor
 
@@ -18,16 +18,19 @@ new LangfuseExporter(config: LangfuseExporterConfig)
 ## LangfuseExporterConfig
 
 ```typescript
-interface LangfuseExporterConfig {
+interface LangfuseExporterConfig extends BaseExporterConfig {
   publicKey?: string;
   secretKey?: string;
   baseUrl?: string;
   realtime?: boolean;
-  logLevel?: "debug" | "info" | "warn" | "error";
   options?: any;
 }
 ```
 
+Extends `BaseExporterConfig`, which includes:
+- `logger?: IMastraLogger` - Logger instance
+- `logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'` - Log level (default: INFO)
+
 <PropertiesTable
   props={[
     {
@@ -71,10 +74,10 @@ interface LangfuseExporterConfig {
 
 ## Methods
 
-### exportEvent
+### exportTracingEvent
 
 ```typescript
-async exportEvent(event: AITracingEvent): Promise<void>
+async exportTracingEvent(event: TracingEvent): Promise<void>
 ```
 
 Exports a tracing event to Langfuse.
@@ -82,7 +85,7 @@ Exports a tracing event to Langfuse.
 ### export
 
 ```typescript
-async export(spans: ReadOnlyAISpan[]): Promise<void>
+async export(spans: ReadOnlySpan[]): Promise<void>
 ```
 
 Batch exports spans to Langfuse.

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

@@ -1,13 +1,13 @@
 ---
 title: "Reference: LangSmithExporter | Observability | Mastra Docs"
-description: LangSmith exporter for AI tracing
+description: LangSmith exporter for Tracing
 ---
 
 import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # LangSmithExporter
 
-Sends AI tracing data to LangSmith for observability.
+Sends Tracing data to LangSmith for observability.
 
 ## Constructor
 
@@ -18,12 +18,15 @@ new LangSmithExporter(config: LangSmithExporterConfig)
 ## LangSmithExporterConfig
 
 ```typescript
-interface LangSmithExporterConfig extends ClientConfig {
-  logLevel?: "debug" | "info" | "warn" | "error";
+interface LangSmithExporterConfig extends ClientConfig, BaseExporterConfig {
   client?: Client;
 }
 ```
 
+Extends both `ClientConfig` (from LangSmith SDK) and `BaseExporterConfig`:
+- From `BaseExporterConfig`: `logger?: IMastraLogger`, `logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'`
+- From `ClientConfig`: `apiKey`, `apiUrl`, `callerOptions`, `hideInputs`, `hideOutputs`, etc.
+
 <PropertiesTable
   props={[
     {
@@ -73,10 +76,10 @@ interface LangSmithExporterConfig extends ClientConfig {
 
 ## Methods
 
-### exportEvent
+### exportTracingEvent
 
 ```typescript
-async exportEvent(event: AITracingEvent): Promise<void>
+async exportTracingEvent(event: TracingEvent): Promise<void>
 ```
 
 Exports a tracing event to LangSmith.
@@ -103,7 +106,7 @@ const exporter = new LangSmithExporter({
 
 ## Span Type Mapping
 
-| AI Span Type       | LangSmith Type |
+| Span Type       | LangSmith Type |
 | ------------------ | -------------- |
 | `MODEL_GENERATION` | `llm`          |
 | `MODEL_CHUNK`      | `llm`          |

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

@@ -1,6 +1,6 @@
 ---
 title: "Reference: OtelExporter | Observability | Mastra Docs"
-description: OpenTelemetry exporter for AI tracing
+description: OpenTelemetry exporter for Tracing
 ---
 
 import PropertiesTable from "@site/src/components/PropertiesTable";
@@ -13,7 +13,7 @@ The OtelExporter is currently **experimental**. APIs and configuration options m
 
 :::
 
-Sends AI tracing data to any OpenTelemetry-compatible observability platform using standardized GenAI semantic conventions.
+Sends Tracing data to any OpenTelemetry-compatible observability platform using standardized GenAI semantic conventions.
 
 ## Constructor
 
@@ -266,10 +266,10 @@ interface CustomConfig {
 
 ## Methods
 
-### exportEvent
+### exportTracingEvent
 
 ```typescript
-async exportEvent(event: AITracingEvent): Promise<void>
+async exportTracingEvent(event: TracingEvent): Promise<void>
 ```
 
 Exports a tracing event to the configured OTEL backend.
@@ -362,7 +362,7 @@ Different providers require different OTEL exporter packages:
 
 ## Parent-Child Relationships
 
-The exporter preserves span hierarchy from Mastra's AI tracing:
+The exporter preserves span hierarchy from Mastra's Tracing:
 
 - Uses `parentSpanId` directly from Mastra spans
 - Maintains correct nesting for agents, workflows, LLM calls, and tools

package/.docs/raw/reference/observability/tracing/instances.mdx

@@ -0,0 +1,168 @@
+---
+title: "Reference: Tracing | Observability | Mastra Docs"
+description: Core Tracing classes and methods
+asIndexPage: true
+---
+
+import PropertiesTable from "@site/src/components/PropertiesTable";
+
+# Observability Instances
+
+## DefaultObservabilityInstance
+
+Default implementation of the ObservabilityInstance interface.
+
+### Constructor
+
+```typescript
+new DefaultObservabilityInstance(config: ObservabilityInstanceConfig)
+```
+
+Creates a new DefaultObservabilityInstance with the specified configuration.
+
+### Properties
+
+Inherits all properties and methods from BaseObservabilityInstance.
+
+## BaseObservabilityInstance
+
+Base class for custom ObservabilityInstance implementations.
+
+### Methods
+
+#### getConfig
+
+```typescript
+getConfig(): Readonly<Required<ObservabilityInstanceConfig>>
+```
+
+Returns the current observability configuration.
+
+#### getExporters
+
+```typescript
+getExporters(): readonly ObservabilityExporter[]
+```
+
+Returns all configured exporters.
+
+#### getSpanOutputProcessors
+
+```typescript
+getSpanOutputProcessors(): readonly SpanOutputProcessor[]
+```
+
+Returns all configured span output processors.
+
+#### getLogger
+
+```typescript
+getLogger(): IMastraLogger
+```
+
+Returns the logger instance for exporters and other components.
+
+#### startSpan
+
+```typescript
+startSpan<TType extends SpanType>(
+  options: StartSpanOptions<TType>
+): Span<TType>
+```
+
+Start a new span of a specific SpanType. Creates the root span of a trace if no parent is provided.
+
+<PropertiesTable
+  props={[
+    {
+      name: "type",
+      type: "SpanType",
+      description: "Type of span to create",
+      required: true,
+    },
+    {
+      name: "name",
+      type: "string",
+      description: "Name of the span",
+      required: true,
+    },
+    {
+      name: "parent",
+      type: "AnySpan",
+      description: "Parent span (if not root)",
+      required: false,
+    },
+    {
+      name: "attributes",
+      type: "SpanTypeMap[TType]",
+      description: "Type-specific attributes",
+      required: false,
+    },
+    {
+      name: "metadata",
+      type: "Record<string, any>",
+      description: "User-defined metadata",
+      required: false,
+    },
+    {
+      name: "input",
+      type: "any",
+      description: "Initial input data",
+      required: false,
+    },
+    {
+      name: "customSamplerOptions",
+      type: "CustomSamplerOptions",
+      description: "Options for custom sampler",
+      required: false,
+    },
+  ]}
+/>
+
+#### shutdown
+
+```typescript
+async shutdown(): Promise<void>
+```
+
+Shuts down all exporters and processors, cleaning up resources.
+
+## Custom Implementation
+
+To create a custom ObservabilityInstance implementation, extend BaseObservabilityInstance:
+
+```typescript
+class CustomObservabilityInstance extends BaseObservabilityInstance {
+  constructor(config: ObservabilityInstanceConfig) {
+    super(config);
+    // Custom initialization
+  }
+
+  // Override methods as needed
+  startSpan<TType extends SpanType>(
+    options: StartSpanOptions<TType>,
+  ): Span<TType> {
+    // Custom span creation logic
+    return super.startSpan(options);
+  }
+}
+```
+
+## See Also
+
+### Documentation
+
+- [Tracing Overview](/docs/v1/observability/tracing/overview) - Concepts and usage guide
+- [Configuration Reference](/reference/v1/observability/tracing/configuration) - Configuration options
+- [Interfaces Reference](/reference/v1/observability/tracing/interfaces) - Type definitions
+- [Spans Reference](/reference/v1/observability/tracing/spans) - Span lifecycle and methods
+
+### Examples
+
+- [Basic Tracing](/examples/v1/observability/basic-tracing) - Getting started example
+
+### Exporters
+
+- [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
+- [CloudExporter](/reference/v1/observability/tracing/exporters/cloud-exporter) - Mastra Cloud integration
+- [ConsoleExporter](/reference/v1/observability/tracing/exporters/console-exporter) - Debug output