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

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

@@ -1,5 +1,5 @@
 ---
-title: "Default Exporter | AI Tracing | Observability | Mastra Docs"
+title: "Default Exporter | Tracing | Observability | Mastra Docs"
 description: "Store traces locally for development and debugging"
 ---
 
@@ -7,15 +7,6 @@ description: "Store traces locally for development and debugging"
 
 The `DefaultExporter` persists traces to your configured storage backend, making them accessible through Studio. It's automatically enabled when using the default observability configuration and requires no external services.
 
-## When to Use DefaultExporter
-
-DefaultExporter is ideal for:
-
-- **Local development** - Debug and analyze traces offline
-- **Data ownership** - Complete control over your trace data
-- **Zero dependencies** - No external services required
-- **Studio integration** - View traces in Studio
-
 ## Configuration
 
 ### Prerequisites
@@ -27,21 +18,22 @@ DefaultExporter is ideal for:
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
-import { DefaultExporter } from "@mastra/core/ai-tracing";
+import { Observability, DefaultExporter } from "@mastra/observability";
 import { LibSQLStore } from "@mastra/libsql";
 
 export const mastra = new Mastra({
   storage: new LibSQLStore({
+    id: 'mastra-storage',
     url: "file:./mastra.db", // Required for trace persistence
   }),
-  observability: {
+  observability: new Observability({
     configs: {
       local: {
         serviceName: "my-service",
         exporters: [new DefaultExporter()],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -50,13 +42,17 @@ export const mastra = new Mastra({
 When using the default observability configuration, DefaultExporter is automatically included:
 
 ```typescript
+import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
+import { LibSQLStore } from "@mastra/libsql";
 export const mastra = new Mastra({
   storage: new LibSQLStore({
+    id: 'mastra-storage',
     url: "file:./mastra.db",
   }),
-  observability: {
+  observability: new Observability({
     default: { enabled: true }, // Automatically includes DefaultExporter
-  },
+  }),
 });
 ```
 
@@ -106,8 +102,8 @@ If you set the strategy to `'auto'`, the `DefaultExporter` automatically selects
 
 | Storage Provider                                | Preferred Strategy | Supported Strategies                      | Notes                                 |
 | ----------------------------------------------- | ------------------ | ----------------------------------------- | ------------------------------------- |
-| **[LibSQL](/reference/storage/libsql)**         | batch-with-updates | realtime, batch-with-updates, insert-only | Default storage, good for development |
-| **[PostgreSQL](/reference/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only           | Recommended for production            |
+| **[LibSQL](/reference/v1/storage/libsql)**         | batch-with-updates | realtime, batch-with-updates, insert-only | Default storage, good for development |
+| **[PostgreSQL](/reference/v1/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only           | Recommended for production            |
 
 ### Strategy Benefits
 
@@ -162,6 +158,6 @@ new DefaultExporter({
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
-- [CloudExporter](/docs/observability/ai-tracing/exporters/cloud)
-- [Storage Configuration](/docs/server-db/storage)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
+- [CloudExporter](/docs/v1/observability/tracing/exporters/cloud)
+- [Storage Configuration](/docs/v1/server-db/storage)

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

@@ -1,26 +1,16 @@
 ---
-title: "Langfuse Exporter | AI Tracing | Observability | Mastra Docs"
-description: "Send AI traces to Langfuse for LLM observability and analytics"
+title: "Langfuse Exporter | Tracing | Observability | Mastra Docs"
+description: "Send traces to Langfuse for LLM observability and analytics"
 ---
 
 # Langfuse Exporter
 
-[Langfuse](https://langfuse.com/) is an open-source observability platform specifically designed for LLM applications. The Langfuse exporter sends your AI traces to Langfuse, providing detailed insights into model performance, token usage, and conversation flows.
-
-## When to Use Langfuse
-
-Langfuse is ideal when you need:
-
-- **LLM-specific analytics** - Token usage, costs, latency breakdown
-- **Conversation tracking** - Session-based trace grouping
-- **Quality scoring** - Manual and automated evaluation scores
-- **Model comparison** - A/B testing and version comparisons
-- **Self-hosted option** - Deploy on your own infrastructure
+[Langfuse](https://langfuse.com/) is an open-source observability platform specifically designed for LLM applications. The Langfuse exporter sends your traces to Langfuse, providing detailed insights into model performance, token usage, and conversation flows.
 
 ## Installation
 
 ```bash npm2yarn
-npm install @mastra/langfuse
+npm install @mastra/langfuse@beta
 ```
 
 ## Configuration
@@ -41,10 +31,11 @@ LANGFUSE_BASE_URL=https://cloud.langfuse.com  # Or your self-hosted URL
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
 import { LangfuseExporter } from "@mastra/langfuse";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       langfuse: {
         serviceName: "my-service",
@@ -60,7 +51,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -118,5 +109,5 @@ new LangfuseExporter({
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
 - [Langfuse Documentation](https://langfuse.com/docs)

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

@@ -1,26 +1,16 @@
 ---
-title: "LangSmith Exporter | AI Tracing | Observability | Mastra Docs"
-description: "Send AI traces to LangSmith for LLM observability and evaluation"
+title: "LangSmith Exporter | Tracing | Observability | Mastra Docs"
+description: "Send traces to LangSmith for LLM observability and evaluation"
 ---
 
 # LangSmith Exporter
 
-[LangSmith](https://smith.langchain.com/) is LangChain's platform for monitoring and evaluating LLM applications. The LangSmith exporter sends your AI traces to LangSmith, providing insights into model performance, debugging capabilities, and evaluation workflows.
-
-## When to Use LangSmith
-
-LangSmith is ideal when you need:
-
-- **LangChain ecosystem integration** - Native support for LangChain applications
-- **Debugging and testing** - Detailed trace visualization and replay
-- **Evaluation pipelines** - Built-in evaluation and dataset management
-- **Prompt versioning** - Track and compare prompt variations
-- **Collaboration features** - Team workspaces and shared projects
+[LangSmith](https://smith.langchain.com/) is LangChain's platform for monitoring and evaluating LLM applications. The LangSmith exporter sends your traces to LangSmith, providing insights into model performance, debugging capabilities, and evaluation workflows.
 
 ## Installation
 
 ```bash npm2yarn
-npm install @mastra/langsmith
+npm install @mastra/langsmith@beta
 ```
 
 ## Configuration
@@ -40,10 +30,11 @@ LANGSMITH_BASE_URL=https://api.smith.langchain.com  # Optional for self-hosted
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
 import { LangSmithExporter } from "@mastra/langsmith";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       langsmith: {
         serviceName: "my-service",
@@ -54,7 +45,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -84,5 +75,5 @@ new LangSmithExporter({
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
 - [LangSmith Documentation](https://docs.smith.langchain.com/)

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

@@ -1,6 +1,6 @@
 ---
-title: "OpenTelemetry Exporter | AI Tracing | Observability | Mastra Docs"
-description: "Send AI traces to any OpenTelemetry-compatible observability platform"
+title: "OpenTelemetry Exporter | Tracing | Observability | Mastra Docs"
+description: "Send traces to any OpenTelemetry-compatible observability platform"
 ---
 
 # OpenTelemetry Exporter
@@ -11,17 +11,7 @@ The OpenTelemetry exporter is currently **experimental**. APIs and configuration
 
 :::
 
-The OpenTelemetry (OTEL) exporter sends your AI traces to any OTEL-compatible observability platform using standardized [OpenTelemetry Semantic Conventions for GenAI](https://opentelemetry.io/docs/specs/semconv/gen-ai/). This ensures broad compatibility with platforms like Datadog, New Relic, SigNoz, Dash0, Traceloop, Laminar, and more.
-
-## When to Use OTEL Exporter
-
-The OTEL exporter is ideal when you need:
-
-- **Platform flexibility** - Send traces to any OTEL-compatible backend
-- **Standards compliance** - Follow OpenTelemetry GenAI semantic conventions
-- **Multi-vendor support** - Configure once, switch providers easily
-- **Enterprise platforms** - Integrate with existing observability infrastructure
-- **Custom collectors** - Send to your own OTEL collector
+The OpenTelemetry (OTEL) exporter sends your traces to any OTEL-compatible observability platform using standardized [OpenTelemetry Semantic Conventions for GenAI](https://opentelemetry.io/docs/specs/semconv/gen-ai/). This ensures broad compatibility with platforms like Datadog, New Relic, SigNoz, Dash0, Traceloop, Laminar, and more.
 
 ## Installation
 
@@ -30,19 +20,19 @@ Each provider requires specific protocol packages. Install the base exporter plu
 ### For HTTP/Protobuf Providers (SigNoz, New Relic, Laminar)
 
 ```bash npm2yarn
-npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-proto
+npm install @mastra/otel-exporter@beta @opentelemetry/exporter-trace-otlp-proto
 ```
 
 ### For gRPC Providers (Dash0)
 
 ```bash npm2yarn
-npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-grpc @grpc/grpc-js
+npm install @mastra/otel-exporter@beta @opentelemetry/exporter-trace-otlp-grpc @grpc/grpc-js
 ```
 
 ### For HTTP/JSON Providers (Traceloop)
 
 ```bash npm2yarn
-npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-http
+npm install @mastra/otel-exporter@beta @opentelemetry/exporter-trace-otlp-http
 ```
 
 ## Provider Configurations
@@ -53,10 +43,11 @@ npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-http
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
 import { OtelExporter } from "@mastra/otel-exporter";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       otel: {
         serviceName: "my-service",
@@ -77,7 +68,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -89,7 +80,7 @@ Get your Dash0 endpoint from your dashboard. It should be in the format `ingress
 
 ### SigNoz
 
-[SigNoz](https://signoz.io/) is an open-source APM alternative with built-in AI tracing support.
+[SigNoz](https://signoz.io/) is an open-source APM alternative with built-in Tracing support.
 
 ```typescript title="src/mastra/index.ts"
 new OtelExporter({
@@ -258,6 +249,6 @@ Install the suggested package for your provider.
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
 - [OpenTelemetry GenAI Conventions](https://opentelemetry.io/docs/specs/semconv/gen-ai/)
-- [OTEL Exporter Reference](/reference/observability/ai-tracing/exporters/otel)
+- [OTEL Exporter Reference](/reference/v1/observability/tracing/exporters/otel)