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

package/.docs/raw/reference/observability/{ai-tracing/span.mdx → tracing/spans.mdx}

@@ -1,18 +1,18 @@
 ---
-title: "Reference: Span | Observability | Mastra Docs"
+title: "Reference: Spans | Observability | Mastra Docs"
 description: Span interfaces, methods, and lifecycle events
 ---
 
 import PropertiesTable from "@site/src/components/PropertiesTable";
 
-# Span
+# Spans
 
 ## BaseSpan
 
 Base interface for all span types.
 
 ```typescript
-interface BaseSpan<TType extends AISpanType> {
+interface BaseSpan<TType extends SpanType> {
   /** Unique span identifier */
   id: string;
 
@@ -32,7 +32,7 @@ interface BaseSpan<TType extends AISpanType> {
   endTime?: Date;
 
   /** Type-specific attributes */
-  attributes?: AISpanTypeMap[TType];
+  attributes?: SpanTypeMap[TType];
 
   /** User-defined metadata */
   metadata?: Record<string, any>;
@@ -57,20 +57,20 @@ interface BaseSpan<TType extends AISpanType> {
 }
 ```
 
-## AISpan
+## Span
 
-AI Span interface, used internally for tracing. Extends BaseSpan with lifecycle methods and properties.
+Span interface, used internally for tracing. Extends BaseSpan with lifecycle methods and properties.
 
 ```typescript
-interface AISpan<TType extends AISpanType> extends BaseSpan<TType> {
+interface Span<TType extends SpanType> extends BaseSpan<TType> {
   /** Is an internal span? (spans internal to the operation of mastra) */
   isInternal: boolean;
 
   /** Parent span reference (undefined for root spans) */
-  parent?: AnyAISpan;
+  parent?: AnySpan;
 
-  /** Pointer to the AITracing instance */
-  aiTracing: AITracing;
+  /** Pointer to the ObservabilityInstance instance */
+  observabilityInstance: ObservabilityInstance;
 }
 ```
 
@@ -87,7 +87,7 @@ get isValid(): boolean
 getParentSpanId(includeInternalSpans?: boolean): string | undefined
 
 /** Returns a lightweight span ready for export */
-exportSpan(includeInternalSpans?: boolean): ExportedAISpan<TType> | undefined
+exportSpan(includeInternalSpans?: boolean): ExportedSpan<TType> | undefined
 ```
 
 ### Methods
@@ -116,7 +116,7 @@ Ends the span and triggers export to configured exporters. Sets the `endTime` an
     },
     {
       name: "attributes",
-      type: "Partial<AISpanTypeMap[TType]>",
+      type: "Partial<SpanTypeMap[TType]>",
       description: "Type-specific attributes to update",
       required: false,
     },
@@ -153,7 +153,7 @@ Records an error on the span. Sets the `errorInfo` field and can optionally end
     },
     {
       name: "attributes",
-      type: "Partial<AISpanTypeMap[TType]>",
+      type: "Partial<SpanTypeMap[TType]>",
       description: "Type-specific attributes to update",
       required: false,
     },
@@ -190,7 +190,7 @@ Updates span data while it's still active. Can modify `input`, `output`, `metada
     },
     {
       name: "attributes",
-      type: "Partial<AISpanTypeMap[TType]>",
+      type: "Partial<SpanTypeMap[TType]>",
       description: "Type-specific attributes to update",
       required: false,
     },
@@ -200,9 +200,9 @@ Updates span data while it's still active. Can modify `input`, `output`, `metada
 #### createChildSpan
 
 ```typescript
-createChildSpan<TChildType extends AISpanType>(
+createChildSpan<TChildType extends SpanType>(
   options: ChildSpanOptions<TChildType>
-): AISpan<TChildType>
+): Span<TChildType>
 ```
 
 Creates a child span under this span. Child spans track sub-operations and inherit the trace context.
@@ -223,7 +223,7 @@ Creates a child span under this span. Child spans track sub-operations and inher
     },
     {
       name: "attributes",
-      type: "AISpanTypeMap[TChildType]",
+      type: "SpanTypeMap[TChildType]",
       description: "Type-specific attributes",
       required: false,
     },
@@ -245,9 +245,9 @@ Creates a child span under this span. Child spans track sub-operations and inher
 #### createEventSpan
 
 ```typescript
-createEventSpan<TChildType extends AISpanType>(
+createEventSpan<TChildType extends SpanType>(
   options: ChildEventOptions<TChildType>
-): AISpan<TChildType>
+): Span<TChildType>
 ```
 
 Creates an event span under this span. Event spans represent point-in-time occurrences with no duration.
@@ -268,7 +268,7 @@ Creates an event span under this span. Event spans represent point-in-time occur
     },
     {
       name: "attributes",
-      type: "AISpanTypeMap[TChildType]",
+      type: "SpanTypeMap[TChildType]",
       description: "Type-specific attributes",
       required: false,
     },
@@ -293,12 +293,12 @@ Creates an event span under this span. Event spans represent point-in-time occur
   ]}
 />
 
-## ExportedAISpan
+## ExportedSpan
 
-Exported AI Span interface, used for tracing exporters. A lightweight version of AISpan without methods or circular references.
+Exported Span interface, used for tracing exporters. A lightweight version of Span without methods or circular references.
 
 ```typescript
-interface ExportedAISpan<TType extends AISpanType> extends BaseSpan<TType> {
+interface ExportedSpan<TType extends SpanType> extends BaseSpan<TType> {
   /** Parent span id reference (undefined for root spans) */
   parentSpanId?: string;
 
@@ -311,10 +311,10 @@ interface ExportedAISpan<TType extends AISpanType> extends BaseSpan<TType> {
 
 Events emitted during the span lifecycle.
 
-### AITracingEventType
+### TracingEventType
 
 ```typescript
-enum AITracingEventType {
+enum TracingEventType {
   /** Emitted when a span is created and started */
   SPAN_STARTED = "span_started",
 
@@ -326,49 +326,67 @@ enum AITracingEventType {
 }
 ```
 
-### AITracingEvent
+### TracingEvent
 
 ```typescript
-type AITracingEvent =
-  | { type: "span_started"; exportedSpan: AnyExportedAISpan }
-  | { type: "span_updated"; exportedSpan: AnyExportedAISpan }
-  | { type: "span_ended"; exportedSpan: AnyExportedAISpan };
+type TracingEvent =
+  | { type: "span_started"; exportedSpan: AnyExportedSpan }
+  | { type: "span_updated"; exportedSpan: AnyExportedSpan }
+  | { type: "span_ended"; exportedSpan: AnyExportedSpan };
 ```
 
 Exporters receive these events to process and send trace data to observability platforms.
 
 ## Union Types
 
-### AnyAISpan
+### AnySpan
 
 ```typescript
-type AnyAISpan = AISpan<keyof AISpanTypeMap>;
+type AnySpan = Span<keyof SpanTypeMap>;
 ```
 
 Union type for cases that need to handle any span type.
 
-### AnyExportedAISpan
+### AnyExportedSpan
 
 ```typescript
-type AnyExportedAISpan = ExportedAISpan<keyof AISpanTypeMap>;
+type AnyExportedSpan = ExportedSpan<keyof SpanTypeMap>;
 ```
 
 Union type for cases that need to handle any exported span type.
 
+## NO-OP Spans
+
+When tracing is disabled (sampling returns false), NO-OP spans are returned:
+
+### NoOpSpan
+
+```typescript
+class NoOpSpan<TType extends SpanType> extends BaseSpan<TType>
+```
+
+A span that performs no operations. All methods are no-ops:
+
+- `id` returns `'no-op'`
+- `traceId` returns `'no-op-trace'`
+- `isValid` returns `false`
+- `end()`, `error()`, `update()` do nothing
+- `createChildSpan()` returns another NO-OP span
+
 ## See Also
 
 ### Documentation
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Concepts and usage
-- [Creating Child Spans](/docs/observability/ai-tracing/overview#creating-child-spans) - Practical examples
-- [Retrieving Trace IDs](/docs/observability/ai-tracing/overview#retrieving-trace-ids) - Using trace IDs
+- [Tracing Overview](/docs/v1/observability/tracing/overview) - Concepts and usage
+- [Creating Child Spans](/docs/v1/observability/tracing/overview#creating-child-spans) - Practical examples
+- [Retrieving Trace IDs](/docs/v1/observability/tracing/overview#retrieving-trace-ids) - Using trace IDs
 
 ### Reference
 
-- [AITracing Classes](/reference/observability/ai-tracing/) - Core tracing classes
-- [Interfaces](/reference/observability/ai-tracing/interfaces) - Complete type reference
-- [Configuration](/reference/observability/ai-tracing/configuration) - Configuration options
+- [Tracing Classes](/reference/v1/observability/tracing/instances) - Core tracing classes
+- [Interfaces](/reference/v1/observability/tracing/interfaces) - Complete type reference
+- [Configuration](/reference/v1/observability/tracing/configuration) - Configuration options
 
 ### Examples
 
-- [Basic AI Tracing](/examples/observability/basic-ai-tracing) - Working with spans
+- [Basic Tracing](/examples/v1/observability/basic-tracing) - Working with spans

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

@@ -65,11 +65,17 @@ const processor = new BatchPartsProcessor({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'batch-parts'",
+      description: "Processor identifier set to 'batch-parts'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processOutputStream",
       type: "(args: { part: ChunkType; streamParts: ChunkType[]; state: Record<string, any>; abort: (reason?: string) => never }) => Promise<ChunkType | null>",
@@ -107,4 +113,4 @@ export const agent = new Agent({
 
 ## Related
 
-- [Guardrails](/docs/agents/guardrails)
+- [Guardrails](/docs/v1/agents/guardrails)

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

@@ -107,11 +107,17 @@ const processor = new LanguageDetector({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'language-detector'",
+      description: "Processor identifier set to 'language-detector'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",
@@ -149,4 +155,4 @@ export const agent = new Agent({
 
 ## Related
 
-- [Guardrails](/docs/agents/guardrails)
+- [Guardrails](/docs/v1/agents/guardrails)

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

@@ -93,11 +93,17 @@ const processor = new ModerationProcessor({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'moderation'",
+      description: "Processor identifier set to 'moderation'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",
@@ -167,4 +173,4 @@ export const agent = new Agent({
 
 ## Related
 
-- [Guardrails](/docs/agents/guardrails)
+- [Guardrails](/docs/v1/agents/guardrails)

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

@@ -100,11 +100,17 @@ const processor = new PIIDetector({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'pii-detector'",
+      description: "Processor identifier set to 'pii-detector'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",
@@ -175,4 +181,4 @@ export const agent = new Agent({
 
 ## Related
 
-- [Guardrails](/docs/agents/guardrails)
+- [Guardrails](/docs/v1/agents/guardrails)

package/.docs/raw/reference/processors/prompt-injection-detector.mdx

@@ -86,11 +86,17 @@ const processor = new PromptInjectionDetector({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'prompt-injection-detector'",
+      description: "Processor identifier set to 'prompt-injection-detector'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",
@@ -125,4 +131,4 @@ export const agent = new Agent({
 
 ## Related
 
-- [Guardrails](/docs/agents/guardrails)
+- [Guardrails](/docs/v1/agents/guardrails)

package/.docs/raw/reference/processors/system-prompt-scrubber.mdx

@@ -94,11 +94,17 @@ const processor = new SystemPromptScrubber({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'system-prompt-scrubber'",
+      description: "Processor identifier set to 'system-prompt-scrubber'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processOutputStream",
       type: "(args: { part: ChunkType; streamParts: ChunkType[]; state: Record<string, any>; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<ChunkType | null>",
@@ -146,4 +152,4 @@ export const agent = new Agent({
 
 ## Related
 
-- [Guardrails](/docs/agents/guardrails)
+- [Guardrails](/docs/v1/agents/guardrails)

package/.docs/raw/reference/processors/token-limiter-processor.mdx

@@ -71,11 +71,17 @@ const processor = new TokenLimiterProcessor({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'token-limiter'",
+      description: "Processor identifier set to 'token-limiter'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processOutputStream",
       type: "(args: { part: ChunkType; streamParts: ChunkType[]; state: Record<string, any>; abort: (reason?: string) => never }) => Promise<ChunkType | null>",
@@ -131,4 +137,4 @@ export const agent = new Agent({
 
 ## Related
 
-- [Guardrails](/docs/agents/guardrails)
+- [Guardrails](/docs/v1/agents/guardrails)

package/.docs/raw/reference/processors/unicode-normalizer.mdx

@@ -71,11 +71,17 @@ const processor = new UnicodeNormalizer({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'unicode-normalizer'",
+      description: "Processor identifier set to 'unicode-normalizer'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never }) => MastraMessageV2[]",
@@ -110,4 +116,4 @@ export const agent = new Agent({
 
 ## Related
 
-- [Guardrails](/docs/agents/guardrails)
+- [Guardrails](/docs/v1/agents/guardrails)

package/.docs/raw/reference/rag/chunk.mdx

@@ -62,13 +62,6 @@ The following parameters are available for all chunking strategies.
       description:
         "Maximum size of each chunk. **Note:** Some strategy configurations (markdown with headers, HTML with headers) ignore this parameter.",
     },
-    {
-      name: "size",
-      type: "number",
-      isOptional: true,
-      description:
-        "**Deprecated:** Use `maxSize` instead. This parameter will be removed in the next major version.",
-    },
     {
       name: "overlap",
       type: "number",
@@ -113,7 +106,7 @@ The following parameters are available for all chunking strategies.
   ]}
 />
 
-See [ExtractParams reference](/reference/rag/extract-params) for details on the `extract` parameter.
+See [ExtractParams reference](/reference/v1/rag/extract-params) for details on the `extract` parameter.
 
 ## Strategy-Specific Options
 

package/.docs/raw/reference/rag/database-config.mdx

@@ -188,7 +188,7 @@ whereDocument: { "$contains": "API documentation" }
     ### Runtime Configuration Override
 
     ```typescript
-    import { RuntimeContext } from '@mastra/core/runtime-context';
+    import { RequestContext } from '@mastra/core/request-context';
 
     // Initial configuration
     const vectorTool = createVectorQueryTool({
@@ -203,8 +203,8 @@ whereDocument: { "$contains": "API documentation" }
     });
 
     // Override at runtime
-    const runtimeContext = new RuntimeContext();
-    runtimeContext.set('databaseConfig', {
+    const requestContext = new RequestContext();
+    requestContext.set('databaseConfig', {
       pinecone: {
         namespace: 'production'
       }
@@ -213,7 +213,7 @@ whereDocument: { "$contains": "API documentation" }
     await vectorTool.execute({
       context: { queryText: 'search query' },
       mastra,
-      runtimeContext
+      requestContext
     });
     ```
 
@@ -347,6 +347,6 @@ const vectorTool = createVectorQueryTool({
 
 ## Related
 
-- [createVectorQueryTool()](/reference/tools/vector-query-tool)
-- [Hybrid Vector Search](/examples/rag/query/hybrid-vector-search)
-- [Metadata Filters](/reference/rag/metadata-filters)
+- [createVectorQueryTool()](/reference/v1/tools/vector-query-tool)
+- [Hybrid Vector Search](/examples/v1/rag/query/hybrid-vector-search)
+- [Metadata Filters](/reference/v1/rag/metadata-filters)

package/.docs/raw/reference/rag/metadata-filters.mdx

@@ -12,7 +12,10 @@ Mastra provides a unified metadata filtering syntax across all vector stores, ba
 ```typescript
 import { PgVector } from "@mastra/pg";
 
-const store = new PgVector({ connectionString });
+const store = new PgVector({
+  id: 'pg-vector',
+  connectionString
+});
 
 const results = await store.query({
   indexName: "my_index",
@@ -332,13 +335,13 @@ const results = await store.query({
 
 ## Related
 
-- [Astra](/reference/vectors/astra)
-- [Chroma](/reference/vectors/chroma)
-- [Cloudflare Vectorize](/reference/vectors/vectorize)
-- [LibSQL](/reference/vectors/libsql)
-- [MongoDB](/reference/vectors/mongodb)
-- [PgStore](/reference/vectors/pg)
-- [Pinecone](/reference/vectors/pinecone)
-- [Qdrant](/reference/vectors/qdrant)
-- [Upstash](/reference/vectors/upstash)
-- [Amazon S3 Vectors](/reference/vectors/s3vectors)
+- [Astra](/reference/v1/vectors/astra)
+- [Chroma](/reference/v1/vectors/chroma)
+- [Cloudflare Vectorize](/reference/v1/vectors/vectorize)
+- [LibSQL](/reference/v1/vectors/libsql)
+- [MongoDB](/reference/v1/vectors/mongodb)
+- [PgStore](/reference/v1/vectors/pg)
+- [Pinecone](/reference/v1/vectors/pinecone)
+- [Qdrant](/reference/v1/vectors/qdrant)
+- [Upstash](/reference/v1/vectors/upstash)
+- [Amazon S3 Vectors](/reference/v1/vectors/s3vectors)

package/.docs/raw/reference/storage/cloudflare-d1.mdx

@@ -10,7 +10,7 @@ The Cloudflare D1 storage implementation provides a serverless SQL database solu
 ## Installation
 
 ```bash
-npm install @mastra/cloudflare-d1@latest
+npm install @mastra/cloudflare-d1@beta
 ```
 
 ## Usage

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

@@ -10,7 +10,7 @@ The Cloudflare KV storage implementation provides a globally distributed, server
 ## Installation
 
 ```bash copy
-npm install @mastra/cloudflare@latest
+npm install @mastra/cloudflare@beta
 ```
 
 ## Usage

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

@@ -19,11 +19,11 @@ The DynamoDB storage implementation provides a scalable and performant NoSQL dat
 ## Installation
 
 ```bash copy
-npm install @mastra/dynamodb@latest
+npm install @mastra/dynamodb@beta
 # or
-pnpm add @mastra/dynamodb@latest
+pnpm add @mastra/dynamodb@beta
 # or
-yarn add @mastra/dynamodb@latest
+yarn add @mastra/dynamodb@beta
 ```
 
 ## Prerequisites

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

@@ -10,7 +10,7 @@ The LanceDB storage implementation provides a high-performance storage solution
 ## Installation
 
 ```bash
-npm install @mastra/lance
+npm install @mastra/lance@beta
 ```
 
 ## Usage

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

@@ -10,7 +10,7 @@ The LibSQL storage implementation provides a SQLite-compatible storage solution
 ## Installation
 
 ```bash copy
-npm install @mastra/libsql@latest
+npm install @mastra/libsql@beta
 ```
 
 ## Usage
@@ -20,11 +20,13 @@ import { LibSQLStore } from "@mastra/libsql";
 
 // File database (development)
 const storage = new LibSQLStore({
+  id: 'libsql-storage',
   url: "file:./storage.db",
 });
 
 // Persistent database (production)
 const storage = new LibSQLStore({
+  id: 'libsql-storage',
   url: process.env.DATABASE_URL,
 });
 ```

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

@@ -10,7 +10,7 @@ The MongoDB storage implementation provides a scalable storage solution using Mo
 ## Installation
 
 ```bash copy
-npm install @mastra/mongodb@latest
+npm install @mastra/mongodb@beta
 ```
 
 ## Usage