@mastra/mcp-docs-server 1.0.0-beta.0 → 1.0.0-beta.2

package/.docs/raw/reference/core/listMCPServers.mdx

@@ -56,10 +56,10 @@ This method does not accept any parameters.
 
 ## Related Methods
 
-- [Mastra.getMCPServer()]/reference/v1/core/getMCPServer) - Retrieve an MCP server by its registry key
-- [Mastra.getMCPServerById()]/reference/v1/core/getMCPServerById) - Retrieve an MCP server by its intrinsic `id` property
+- [Mastra.getMCPServer()](/reference/v1/core/getMCPServer) - Retrieve an MCP server by its registry key
+- [Mastra.getMCPServerById()](/reference/v1/core/getMCPServerById) - Retrieve an MCP server by its intrinsic `id` property
 
 ## See Also
 
-- [MCP overview]/docs/v1/tools-mcp/mcp-overview)
-- [MCP server reference]/reference/v1/tools/mcp-server)
+- [MCP overview](/docs/v1/tools-mcp/mcp-overview)
+- [MCP server reference](/reference/v1/tools/mcp-server)

package/.docs/raw/reference/core/setLogger.mdx

@@ -45,5 +45,5 @@ This method does not return a value.
 
 ## Related
 
-- [Logging overview]/docs/v1/logging)
-- [Logger reference]/reference/v1/logging/pino-logger)
+- [Logging overview](/docs/v1/logging)
+- [Logger reference](/reference/v1/logging/pino-logger)

package/.docs/raw/reference/core/setTelemetry.mdx

@@ -32,5 +32,5 @@ This method does not return a value.
 
 ## Related
 
-- [Logging]/docs/v1/logging)
-- [PinoLogger]/reference/v1/logging/pino-logger)
+- [Logging](/docs/v1/logging)
+- [PinoLogger](/reference/v1/logging/pino-logger)

package/.docs/raw/reference/evals/create-scorer.mdx

@@ -12,8 +12,11 @@ Mastra provides a unified `createScorer` factory that allows you to define custo
 Use the `createScorer` factory to define your scorer with a name, description, and optional judge configuration. Then chain step methods to build your evaluation pipeline. You must provide at least a `generateScore` step.
 
 ```typescript
+import { createScorer } from "@mastra/core/evals";
+
 const scorer = createScorer({
-  name: "My Custom Scorer",
+  id: "my-custom-scorer",
+  name: "My Custom Scorer", // Optional, defaults to id
   description: "Evaluates responses based on custom criteria",
   type: "agent", // Optional: for agent evaluation with automatic typing
   judge: {
@@ -39,29 +42,35 @@ const scorer = createScorer({
 
 <PropertiesTable
   content={[
+    {
+      name: "id",
+      type: "string",
+      isOptional: false,
+      description: "Unique identifier for the scorer. Used as the name if `name` is not provided.",
+    },
     {
       name: "name",
       type: "string",
-      required: true,
-      description: "Name of the scorer.",
+      isOptional: true,
+      description: "Name of the scorer. Defaults to `id` if not provided.",
     },
     {
       name: "description",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "Description of what the scorer does.",
     },
     {
       name: "judge",
       type: "object",
-      required: false,
+      isOptional: true,
       description:
         "Optional judge configuration for LLM-based steps. See Judge Object section below.",
     },
     {
       name: "type",
       type: "string",
-      required: false,
+      isOptional: true,
       description:
         "Type specification for input/output. Use 'agent' for automatic agent types. For custom types, use the generic approach instead.",
     },
@@ -77,13 +86,13 @@ This function returns a scorer builder that you can chain step methods onto. See
     {
       name: "model",
       type: "LanguageModel",
-      required: true,
+      isOptional: false,
       description: "The LLM model instance to use for evaluation.",
     },
     {
       name: "instructions",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "System prompt/instructions for the LLM.",
     },
   ]}
@@ -98,7 +107,7 @@ You can specify input/output types when creating scorers for better type inferen
 For evaluating agents, use `type: 'agent'` to automatically get the correct types for agent input/output:
 
 ```typescript
-import { createScorer } from "@mastra/core/scorers";
+import { createScorer } from "@mastra/core/evals";
 
 // Agent scorer with automatic typing
 const agentScorer = createScorer({
@@ -123,7 +132,7 @@ const agentScorer = createScorer({
 For custom input/output types, use the generic approach:
 
 ```typescript
-import { createScorer } from "@mastra/core/scorers";
+import { createScorer } from "@mastra/core/evals";
 
 type CustomInput = { query: string; context: string[] };
 type CustomOutput = { answer: string; confidence: number };
@@ -185,34 +194,34 @@ Function: `({ run, results }) => any`
     {
       name: "run.input",
       type: "any",
-      required: true,
+      isOptional: false,
       description:
         "Input records provided to the scorer. If the scorer is added to an agent, this will be an array of user messages, e.g. `[{ role: 'user', content: 'hello world' }]`. If the scorer is used in a workflow, this will be the input of the workflow.",
     },
     {
       name: "run.output",
       type: "any",
-      required: true,
+      isOptional: false,
       description:
         "Output record provided to the scorer. For agents, this is usually the agent's response. For workflows, this is the workflow's output.",
     },
     {
       name: "run.runId",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "Unique identifier for this scoring run.",
     },
     {
       name: "run.requestContext",
       type: "object",
-      required: false,
+      isOptional: true,
       description:
         "Request Context from the agent or workflow step being evaluated (optional).",
     },
     {
       name: "results",
       type: "object",
-      required: true,
+      isOptional: false,
       description: "Empty object (no previous steps).",
     },
   ]}
@@ -228,26 +237,26 @@ The method can return any value. The returned value will be available to subsequ
     {
       name: "description",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "Description of what this preprocessing step does.",
     },
     {
       name: "outputSchema",
       type: "ZodSchema",
-      required: true,
+      isOptional: false,
       description: "Zod schema for the expected output of the preprocess step.",
     },
     {
       name: "createPrompt",
       type: "function",
-      required: true,
+      isOptional: false,
       description:
         "Function: ({ run, results }) => string. Returns the prompt for the LLM.",
     },
     {
       name: "judge",
       type: "object",
-      required: false,
+      isOptional: true,
       description:
         "(Optional) LLM judge for this step (can override main judge). See Judge Object section.",
     },
@@ -266,34 +275,34 @@ Function: `({ run, results }) => any`
     {
       name: "run.input",
       type: "any",
-      required: true,
+      isOptional: false,
       description:
         "Input records provided to the scorer. If the scorer is added to an agent, this will be an array of user messages, e.g. `[{ role: 'user', content: 'hello world' }]`. If the scorer is used in a workflow, this will be the input of the workflow.",
     },
     {
       name: "run.output",
       type: "any",
-      required: true,
+      isOptional: false,
       description:
         "Output record provided to the scorer. For agents, this is usually the agent's response. For workflows, this is the workflow's output.",
     },
     {
       name: "run.runId",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "Unique identifier for this scoring run.",
     },
     {
       name: "run.requestContext",
       type: "object",
-      required: false,
+      isOptional: true,
       description:
         "Request Context from the agent or workflow step being evaluated (optional).",
     },
     {
       name: "results.preprocessStepResult",
       type: "any",
-      required: false,
+      isOptional: true,
       description: "Result from preprocess step, if defined (optional).",
     },
   ]}
@@ -309,26 +318,26 @@ The method can return any value. The returned value will be available to subsequ
     {
       name: "description",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "Description of what this analysis step does.",
     },
     {
       name: "outputSchema",
       type: "ZodSchema",
-      required: true,
+      isOptional: false,
       description: "Zod schema for the expected output of the analyze step.",
     },
     {
       name: "createPrompt",
       type: "function",
-      required: true,
+      isOptional: false,
       description:
         "Function: ({ run, results }) => string. Returns the prompt for the LLM.",
     },
     {
       name: "judge",
       type: "object",
-      required: false,
+      isOptional: true,
       description:
         "(Optional) LLM judge for this step (can override main judge). See Judge Object section.",
     },
@@ -347,40 +356,40 @@ Function: `({ run, results }) => number`
     {
       name: "run.input",
       type: "any",
-      required: true,
+      isOptional: false,
       description:
         "Input records provided to the scorer. If the scorer is added to an agent, this will be an array of user messages, e.g. `[{ role: 'user', content: 'hello world' }]`. If the scorer is used in a workflow, this will be the input of the workflow.",
     },
     {
       name: "run.output",
       type: "any",
-      required: true,
+      isOptional: false,
       description:
         "Output record provided to the scorer. For agents, this is usually the agent's response. For workflows, this is the workflow's output.",
     },
     {
       name: "run.runId",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "Unique identifier for this scoring run.",
     },
     {
       name: "run.requestContext",
       type: "object",
-      required: false,
+      isOptional: true,
       description:
         "Request Context from the agent or workflow step being evaluated (optional).",
     },
     {
       name: "results.preprocessStepResult",
       type: "any",
-      required: false,
+      isOptional: true,
       description: "Result from preprocess step, if defined (optional).",
     },
     {
       name: "results.analyzeStepResult",
       type: "any",
-      required: false,
+      isOptional: true,
       description: "Result from analyze step, if defined (optional).",
     },
   ]}
@@ -396,27 +405,27 @@ The method must return a numerical score.
     {
       name: "description",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "Description of what this scoring step does.",
     },
     {
       name: "outputSchema",
       type: "ZodSchema",
-      required: true,
+      isOptional: false,
       description:
         "Zod schema for the expected output of the generateScore step.",
     },
     {
       name: "createPrompt",
       type: "function",
-      required: true,
+      isOptional: false,
       description:
         "Function: ({ run, results }) => string. Returns the prompt for the LLM.",
     },
     {
       name: "judge",
       type: "object",
-      required: false,
+      isOptional: true,
       description:
         "(Optional) LLM judge for this step (can override main judge). See Judge Object section.",
     },
@@ -430,7 +439,7 @@ When using prompt object mode, you must also provide a `calculateScore` function
     {
       name: "calculateScore",
       type: "function",
-      required: true,
+      isOptional: false,
       description:
         "Function: ({ run, results, analyzeStepResult }) => number. Converts the LLM's structured output into a numerical score.",
     },
@@ -449,46 +458,46 @@ Function: `({ run, results, score }) => string`
     {
       name: "run.input",
       type: "any",
-      required: true,
+      isOptional: false,
       description:
         "Input records provided to the scorer. If the scorer is added to an agent, this will be an array of user messages, e.g. `[{ role: 'user', content: 'hello world' }]`. If the scorer is used in a workflow, this will be the input of the workflow.",
     },
     {
       name: "run.output",
       type: "any",
-      required: true,
+      isOptional: false,
       description:
         "Output record provided to the scorer. For agents, this is usually the agent's response. For workflows, this is the workflow's output.",
     },
     {
       name: "run.runId",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "Unique identifier for this scoring run.",
     },
     {
       name: "run.requestContext",
       type: "object",
-      required: false,
+      isOptional: true,
       description:
         "Request Context from the agent or workflow step being evaluated (optional).",
     },
     {
       name: "results.preprocessStepResult",
       type: "any",
-      required: false,
+      isOptional: true,
       description: "Result from preprocess step, if defined (optional).",
     },
     {
       name: "results.analyzeStepResult",
       type: "any",
-      required: false,
+      isOptional: true,
       description: "Result from analyze step, if defined (optional).",
     },
     {
       name: "score",
       type: "number",
-      required: true,
+      isOptional: false,
       description: "Score computed by the generateScore step.",
     },
   ]}
@@ -504,20 +513,20 @@ The method must return a string explaining the score.
     {
       name: "description",
       type: "string",
-      required: true,
+      isOptional: false,
       description: "Description of what this reasoning step does.",
     },
     {
       name: "createPrompt",
       type: "function",
-      required: true,
+      isOptional: false,
       description:
         "Function: ({ run, results, score }) => string. Returns the prompt for the LLM.",
     },
     {
       name: "judge",
       type: "object",
-      required: false,
+      isOptional: true,
       description:
         "(Optional) LLM judge for this step (can override main judge). See Judge Object section.",
     },

package/.docs/raw/reference/evals/mastra-scorer.mdx

@@ -14,6 +14,8 @@ The `MastraScorer` class is the base class for all scorers in Mastra. It provide
 Use the `createScorer` factory function, which returns a `MastraScorer` instance:
 
 ```typescript
+import { createScorer } from "@mastra/core/evals";
+
 const scorer = createScorer({
   name: "My Custom Scorer",
   description: "Evaluates responses based on custom criteria",

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

@@ -222,24 +222,24 @@ Shuts down all observability instances and clears the registry.
 
 ### Documentation
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview) - Concepts and usage guide
-- [Sampling Strategies]/docs/v1/observability/tracing/overview#sampling-strategies) - Sampling configuration details
-- [Multi-Config Setup]/docs/v1/observability/tracing/overview#multi-config-setup) - Using multiple configurations
+- [Tracing Overview](/docs/v1/observability/tracing/overview) - Concepts and usage guide
+- [Sampling Strategies](/docs/v1/observability/tracing/overview#sampling-strategies) - Sampling configuration details
+- [Multi-Config Setup](/docs/v1/observability/tracing/overview#multi-config-setup) - Using multiple configurations
 
 ### Reference
 
-- [Tracing Classes]/reference/v1/observability/tracing/instances) - Core tracing classes
-- [Interfaces]/reference/v1/observability/tracing/interfaces) - Type definitions
-- [Spans Reference]/reference/v1/observability/tracing/spans) - Span lifecycle
+- [Tracing Classes](/reference/v1/observability/tracing/instances) - Core tracing classes
+- [Interfaces](/reference/v1/observability/tracing/interfaces) - Type definitions
+- [Spans Reference](/reference/v1/observability/tracing/spans) - Span lifecycle
 
 ### Examples
 
-- [Basic Tracing]/examples/v1/observability/basic-tracing) - Getting started
+- [Basic Tracing](/examples/v1/observability/basic-tracing) - Getting started
 
 ### Exporters
 
-- [DefaultExporter]/reference/v1/observability/tracing/exporters/default-exporter) - Storage configuration
-- [CloudExporter]/reference/v1/observability/tracing/exporters/cloud-exporter) - Cloud setup
-- [Braintrust]/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
-- [Langfuse]/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
-- [LangSmith]/reference/v1/observability/tracing/exporters/langsmith) - LangSmith integration
+- [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage configuration
+- [CloudExporter](/reference/v1/observability/tracing/exporters/cloud-exporter) - Cloud setup
+- [Braintrust](/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
+- [Langfuse](/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
+- [LangSmith](/reference/v1/observability/tracing/exporters/langsmith) - LangSmith integration

package/.docs/raw/reference/observability/tracing/exporters/arize.mdx

@@ -159,6 +159,6 @@ The ArizeExporter implements [OpenInference Semantic Conventions](https://github
 
 ## Related
 
-- [ArizeExporter Documentation]/docs/v1/observability/tracing/exporters/arize)
+- [ArizeExporter Documentation](/docs/v1/observability/tracing/exporters/arize)
 - [Phoenix Documentation](https://docs.arize.com/phoenix)
 - [Arize AX Documentation](https://docs.arize.com/)

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

@@ -167,17 +167,17 @@ const customExporter = new CloudExporter({
 
 ### Documentation
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview) - Complete guide
-- [Exporters]/docs/v1/observability/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
 
-- [DefaultExporter]/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
-- [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
+- [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
+- [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/v1/observability/tracing/configuration) - Configuration options
-- [Interfaces]/reference/v1/observability/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/tracing/exporters/console-exporter.mdx

@@ -168,17 +168,17 @@ const exporterWithLogger = new ConsoleExporter({
 
 ### Documentation
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview) - Complete guide
-- [Exporters]/docs/v1/observability/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
 
-- [DefaultExporter]/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
-- [CloudExporter]/reference/v1/observability/tracing/exporters/cloud-exporter) - Mastra Cloud
-- [Langfuse]/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
-- [Braintrust]/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
+- [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
+- [CloudExporter](/reference/v1/observability/tracing/exporters/cloud-exporter) - Mastra Cloud
+- [Langfuse](/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
+- [Braintrust](/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
 
 ### Reference
 
-- [Configuration]/reference/v1/observability/tracing/configuration) - Configuration options
-- [Interfaces]/reference/v1/observability/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/tracing/exporters/default-exporter.mdx

@@ -189,17 +189,17 @@ const customExporter = new DefaultExporter({
 
 ### Documentation
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview) - Complete guide
-- [Exporters]/docs/v1/observability/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/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
+- [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/v1/observability/tracing/configuration) - Configuration options
-- [Interfaces]/reference/v1/observability/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/tracing/instances.mdx

@@ -152,17 +152,17 @@ class CustomObservabilityInstance extends BaseObservabilityInstance {
 
 ### 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
+- [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
+- [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
+- [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

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

@@ -698,16 +698,16 @@ enum InternalSpans {
 
 ### Documentation
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview) - Complete guide to Tracing
-- [Creating Child Spans]/docs/v1/observability/tracing/overview#creating-child-spans) - Working with span hierarchies
-- [Adding Custom Metadata]/docs/v1/observability/tracing/overview#adding-custom-metadata) - Enriching traces
+- [Tracing Overview](/docs/v1/observability/tracing/overview) - Complete guide to Tracing
+- [Creating Child Spans](/docs/v1/observability/tracing/overview#creating-child-spans) - Working with span hierarchies
+- [Adding Custom Metadata](/docs/v1/observability/tracing/overview#adding-custom-metadata) - Enriching traces
 
 ### Reference
 
-- [Configuration]/reference/v1/observability/tracing/configuration) - Registry and configuration
-- [Tracing Classes]/reference/v1/observability/tracing/instances) - Core implementations
-- [Spans Reference]/reference/v1/observability/tracing/spans) - Span lifecycle methods
+- [Configuration](/reference/v1/observability/tracing/configuration) - Registry and configuration
+- [Tracing Classes](/reference/v1/observability/tracing/instances) - Core implementations
+- [Spans Reference](/reference/v1/observability/tracing/spans) - Span lifecycle methods
 
 ### Examples
 
-- [Basic Tracing]/examples/v1/observability/basic-tracing) - Implementation example
+- [Basic Tracing](/examples/v1/observability/basic-tracing) - Implementation example

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

@@ -377,16 +377,16 @@ A span that performs no operations. All methods are no-ops:
 
 ### Documentation
 
-- [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
+- [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
 
-- [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
+- [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 Tracing]/examples/v1/observability/basic-tracing) - Working with spans
+- [Basic Tracing](/examples/v1/observability/basic-tracing) - Working with spans