@mastra/mcp-docs-server 1.1.25-alpha.4 → 1.1.25-alpha.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/.docs/docs/agents/adding-voice.md +4 -4
  2. package/.docs/docs/deployment/mastra-server.md +4 -4
  3. package/.docs/docs/deployment/monorepo.md +3 -3
  4. package/.docs/docs/evals/custom-scorers.md +2 -2
  5. package/.docs/docs/mastra-platform/overview.md +1 -1
  6. package/.docs/docs/memory/memory-processors.md +3 -3
  7. package/.docs/docs/memory/message-history.md +2 -2
  8. package/.docs/docs/memory/observational-memory.md +1 -1
  9. package/.docs/docs/memory/working-memory.md +1 -1
  10. package/.docs/docs/observability/overview.md +1 -1
  11. package/.docs/docs/observability/tracing/bridges/otel.md +2 -2
  12. package/.docs/docs/observability/tracing/exporters/cloud.md +7 -7
  13. package/.docs/docs/observability/tracing/exporters/default.md +2 -2
  14. package/.docs/docs/observability/tracing/overview.md +21 -21
  15. package/.docs/docs/server/custom-adapters.md +5 -5
  16. package/.docs/docs/server/custom-api-routes.md +3 -3
  17. package/.docs/docs/server/middleware.md +0 -24
  18. package/.docs/docs/studio/observability.md +1 -1
  19. package/.docs/docs/voice/speech-to-text.md +7 -7
  20. package/.docs/docs/voice/text-to-speech.md +10 -10
  21. package/.docs/docs/workspace/filesystem.md +4 -4
  22. package/.docs/docs/workspace/skills.md +3 -3
  23. package/.docs/guides/agent-frameworks/ai-sdk.md +4 -4
  24. package/.docs/guides/build-your-ui/ai-sdk-ui.md +4 -4
  25. package/.docs/guides/deployment/mastra-platform.md +122 -3
  26. package/.docs/guides/migrations/mastra-cloud.md +3 -7
  27. package/.docs/guides/migrations/upgrade-to-v1/tracing.md +1 -1
  28. package/.docs/models/embeddings.md +3 -3
  29. package/.docs/models/gateways/openrouter.md +3 -2
  30. package/.docs/models/index.md +5 -5
  31. package/.docs/models/providers/huggingface.md +2 -1
  32. package/.docs/models/providers/kilo.md +25 -27
  33. package/.docs/models/providers/synthetic.md +3 -2
  34. package/.docs/models/providers/togetherai.md +2 -1
  35. package/.docs/reference/agents/channels.md +3 -3
  36. package/.docs/reference/ai-sdk/chat-route.md +2 -0
  37. package/.docs/reference/ai-sdk/handle-chat-stream.md +2 -0
  38. package/.docs/reference/ai-sdk/handle-network-stream.md +2 -0
  39. package/.docs/reference/ai-sdk/network-route.md +2 -0
  40. package/.docs/reference/client-js/observability.md +2 -2
  41. package/.docs/reference/core/addGateway.md +5 -5
  42. package/.docs/reference/core/getGateway.md +5 -5
  43. package/.docs/reference/core/getGatewayById.md +5 -5
  44. package/.docs/reference/core/getMCPServer.md +2 -2
  45. package/.docs/reference/core/getMCPServerById.md +2 -2
  46. package/.docs/reference/core/getScorer.md +3 -3
  47. package/.docs/reference/core/getScorerById.md +3 -3
  48. package/.docs/reference/core/listGateways.md +5 -5
  49. package/.docs/reference/core/listMCPServers.md +2 -2
  50. package/.docs/reference/core/listScorers.md +3 -3
  51. package/.docs/reference/core/mastra-model-gateway.md +5 -5
  52. package/.docs/reference/evals/context-precision.md +3 -3
  53. package/.docs/reference/evals/context-relevance.md +3 -3
  54. package/.docs/reference/evals/mastra-scorer.md +4 -4
  55. package/.docs/reference/evals/noise-sensitivity.md +6 -6
  56. package/.docs/reference/evals/prompt-alignment.md +12 -12
  57. package/.docs/reference/evals/run-evals.md +6 -6
  58. package/.docs/reference/evals/scorer-utils.md +3 -3
  59. package/.docs/reference/evals/trajectory-accuracy.md +3 -3
  60. package/.docs/reference/observability/tracing/bridges/otel.md +3 -3
  61. package/.docs/reference/observability/tracing/configuration.md +12 -12
  62. package/.docs/reference/observability/tracing/exporters/cloud-exporter.md +10 -10
  63. package/.docs/reference/observability/tracing/exporters/console-exporter.md +8 -8
  64. package/.docs/reference/observability/tracing/exporters/default-exporter.md +8 -8
  65. package/.docs/reference/observability/tracing/exporters/otel.md +3 -3
  66. package/.docs/reference/observability/tracing/instances.md +7 -7
  67. package/.docs/reference/observability/tracing/interfaces.md +6 -6
  68. package/.docs/reference/observability/tracing/spans.md +6 -6
  69. package/.docs/reference/processors/processor-interface.md +3 -3
  70. package/.docs/reference/server/create-route.md +3 -3
  71. package/.docs/reference/server/express-adapter.md +4 -4
  72. package/.docs/reference/server/fastify-adapter.md +4 -4
  73. package/.docs/reference/server/hono-adapter.md +4 -4
  74. package/.docs/reference/server/koa-adapter.md +4 -4
  75. package/.docs/reference/server/mastra-server.md +3 -3
  76. package/.docs/reference/server/register-api-route.md +4 -4
  77. package/.docs/reference/server/routes.md +2 -2
  78. package/.docs/reference/storage/overview.md +1 -1
  79. package/.docs/reference/streaming/ChunkType.md +3 -3
  80. package/.docs/reference/streaming/agents/MastraModelOutput.md +2 -2
  81. package/.docs/reference/voice/cloudflare.md +3 -3
  82. package/.docs/reference/voice/voice.connect.md +4 -4
  83. package/.docs/reference/voice/voice.listen.md +3 -3
  84. package/.docs/reference/workflows/run-methods/startAsync.md +1 -1
  85. package/.docs/reference/workspace/vercel.md +1 -1
  86. package/.docs/reference/workspace/workspace-class.md +1 -1
  87. package/CHANGELOG.md +8 -0
  88. package/package.json +4 -4
@@ -148,8 +148,8 @@ Examples:
148
148
 
149
149
  ## Related
150
150
 
151
- - [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways) - Complete guide to creating custom gateways
152
- - [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway) - Add a gateway to Mastra
153
- - [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway) - Get gateway by registration key
154
- - [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById) - Get gateway by ID
155
- - [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways) - List all gateways
151
+ - [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways): Complete guide to creating custom gateways
152
+ - [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway): Add a gateway to Mastra
153
+ - [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway): Get gateway by registration key
154
+ - [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById): Get gateway by ID
155
+ - [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways): List all gateways
@@ -191,6 +191,6 @@ Choose the right scorer for your needs:
191
191
 
192
192
  ## Related
193
193
 
194
- - [Answer Relevancy Scorer](https://mastra.ai/reference/evals/answer-relevancy) - Evaluates if answers address the question
195
- - [Faithfulness Scorer](https://mastra.ai/reference/evals/faithfulness) - Measures answer groundedness in context
196
- - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers) - Creating your own evaluation metrics
194
+ - [Answer Relevancy Scorer](https://mastra.ai/reference/evals/answer-relevancy): Evaluates if answers address the question
195
+ - [Faithfulness Scorer](https://mastra.ai/reference/evals/faithfulness): Measures answer groundedness in context
196
+ - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers): Creating your own evaluation metrics
@@ -526,6 +526,6 @@ Choose the right scorer for your needs:
526
526
 
527
527
  ## Related
528
528
 
529
- - [Context Precision Scorer](https://mastra.ai/reference/evals/context-precision) - Evaluates context ranking using MAP
530
- - [Faithfulness Scorer](https://mastra.ai/reference/evals/faithfulness) - Measures answer groundedness in context
531
- - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers) - Creating your own evaluation metrics
529
+ - [Context Precision Scorer](https://mastra.ai/reference/evals/context-precision): Evaluates context ranking using MAP
530
+ - [Faithfulness Scorer](https://mastra.ai/reference/evals/faithfulness): Measures answer groundedness in context
531
+ - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers): Creating your own evaluation metrics
@@ -73,10 +73,10 @@ const result = await scorer.run({
73
73
 
74
74
  When you call `.run()`, the MastraScorer executes the defined steps in this order:
75
75
 
76
- 1. **preprocess** (optional) - Extracts or transforms data
77
- 2. **analyze** (optional) - Processes the input/output and preprocessed data
78
- 3. **generateScore** (required) - Computes the numerical score
79
- 4. **generateReason** (optional) - Provides explanation for the score
76
+ 1. **preprocess** (optional): Extracts or transforms data
77
+ 2. **analyze** (optional): Processes the input/output and preprocessed data
78
+ 3. **generateScore** (required): Computes the numerical score
79
+ 4. **generateReason** (optional): Provides explanation for the score
80
80
 
81
81
  Each step receives the results from previous steps, allowing you to build complex evaluation pipelines.
82
82
 
@@ -115,7 +115,7 @@ Checks if noise causes the agent to generate false or fabricated information tha
115
115
  ### Formula
116
116
 
117
117
  ```text
118
- Final Score = max(0, min(llm_score, calculated_score) - issues_penalty)
118
+ Final Score = max(0, min(llm_score, calculated_score): issues_penalty)
119
119
  ```
120
120
 
121
121
  Where:
@@ -661,7 +661,7 @@ jobs:
661
661
  - run: npm run test:noise-sensitivity
662
662
  - name: Check robustness threshold
663
663
  run: |
664
- if [ $(npm run test:noise-sensitivity -- --json | jq '.score') -lt 0.8 ]; then
664
+ if [ $(npm run test:noise-sensitivity -- --json | jq '.score'):lt 0.8 ]; then
665
665
  echo "Agent failed noise sensitivity threshold"
666
666
  exit 1
667
667
  fi
@@ -669,7 +669,7 @@ jobs:
669
669
 
670
670
  ## Related
671
671
 
672
- - [Scorers Overview](https://mastra.ai/docs/evals/overview) - Setting up scorer pipelines
673
- - [Hallucination Scorer](https://mastra.ai/reference/evals/hallucination) - Evaluates fabricated content
674
- - [Answer Relevancy Scorer](https://mastra.ai/reference/evals/answer-relevancy) - Measures response focus
675
- - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers) - Creating your own evaluation metrics
672
+ - [Scorers Overview](https://mastra.ai/docs/evals/overview): Setting up scorer pipelines
673
+ - [Hallucination Scorer](https://mastra.ai/reference/evals/hallucination): Evaluates fabricated content
674
+ - [Answer Relevancy Scorer](https://mastra.ai/reference/evals/answer-relevancy): Measures response focus
675
+ - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers): Creating your own evaluation metrics
@@ -76,19 +76,19 @@ Prompt Alignment evaluates responses across four key dimensions with weighted sc
76
76
 
77
77
  Evaluates alignment with user prompts only:
78
78
 
79
- 1. **Intent Alignment** (40% weight) - Whether the response addresses the user's core request
80
- 2. **Requirements Fulfillment** (30% weight) - If all user requirements are met
81
- 3. **Completeness** (20% weight) - Whether the response is comprehensive for user needs
82
- 4. **Response Appropriateness** (10% weight) - If format and tone match user expectations
79
+ 1. **Intent Alignment** (40% weight): Whether the response addresses the user's core request
80
+ 2. **Requirements Fulfillment** (30% weight): If all user requirements are met
81
+ 3. **Completeness** (20% weight): Whether the response is comprehensive for user needs
82
+ 4. **Response Appropriateness** (10% weight): If format and tone match user expectations
83
83
 
84
84
  #### System Mode ('system')
85
85
 
86
86
  Evaluates compliance with system guidelines only:
87
87
 
88
- 1. **Intent Alignment** (35% weight) - Whether the response follows system behavioral guidelines
89
- 2. **Requirements Fulfillment** (35% weight) - If all system constraints are respected
90
- 3. **Completeness** (15% weight) - Whether the response adheres to all system rules
91
- 4. **Response Appropriateness** (15% weight) - If format and tone match system specifications
88
+ 1. **Intent Alignment** (35% weight): Whether the response follows system behavioral guidelines
89
+ 2. **Requirements Fulfillment** (35% weight): If all system constraints are respected
90
+ 3. **Completeness** (15% weight): Whether the response adheres to all system rules
91
+ 4. **Response Appropriateness** (15% weight): If format and tone match system specifications
92
92
 
93
93
  #### Both Mode ('both' - default)
94
94
 
@@ -608,7 +608,7 @@ const result = await scorer.run({
608
608
 
609
609
  ## Related
610
610
 
611
- - [Answer Relevancy Scorer](https://mastra.ai/reference/evals/answer-relevancy) - Evaluates query-response relevance
612
- - [Faithfulness Scorer](https://mastra.ai/reference/evals/faithfulness) - Measures context groundedness
613
- - [Tool Call Accuracy Scorer](https://mastra.ai/reference/evals/tool-call-accuracy) - Evaluates tool selection
614
- - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers) - Creating your own evaluation metrics
611
+ - [Answer Relevancy Scorer](https://mastra.ai/reference/evals/answer-relevancy): Evaluates query-response relevance
612
+ - [Faithfulness Scorer](https://mastra.ai/reference/evals/faithfulness): Measures context groundedness
613
+ - [Tool Call Accuracy Scorer](https://mastra.ai/reference/evals/tool-call-accuracy): Evaluates tool selection
614
+ - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers): Creating your own evaluation metrics
@@ -246,9 +246,9 @@ const result = await runEvals({
246
246
 
247
247
  ## Related
248
248
 
249
- - [createScorer()](https://mastra.ai/reference/evals/create-scorer) - Create custom scorers for experiments
250
- - [MastraScorer](https://mastra.ai/reference/evals/mastra-scorer) - Learn about scorer structure and methods
251
- - [Trajectory Accuracy](https://mastra.ai/reference/evals/trajectory-accuracy) - Built-in trajectory evaluation scorers
252
- - [Scorer Utilities](https://mastra.ai/reference/evals/scorer-utils) - Helper functions for extracting trajectory data
253
- - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers) - Guide to building evaluation logic
254
- - [Scorers Overview](https://mastra.ai/docs/evals/overview) - Understanding scorer concepts
249
+ - [createScorer()](https://mastra.ai/reference/evals/create-scorer): Create custom scorers for experiments
250
+ - [MastraScorer](https://mastra.ai/reference/evals/mastra-scorer): Learn about scorer structure and methods
251
+ - [Trajectory Accuracy](https://mastra.ai/reference/evals/trajectory-accuracy): Built-in trajectory evaluation scorers
252
+ - [Scorer Utilities](https://mastra.ai/reference/evals/scorer-utils): Helper functions for extracting trajectory data
253
+ - [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers): Guide to building evaluation logic
254
+ - [Scorers Overview](https://mastra.ai/docs/evals/overview): Understanding scorer concepts
@@ -333,10 +333,10 @@ const trajectory = extractTrajectoryFromTrace(traceData.spans, rootSpanId)
333
333
 
334
334
  **Parameters:**
335
335
 
336
- - `spans` (`SpanRecord[]`) Array of span records from a trace query.
337
- - `rootSpanId` (`string`, optional) Span ID to use as the starting point. When omitted, uses spans with no parent.
336
+ - `spans` (`SpanRecord[]`): Array of span records from a trace query.
337
+ - `rootSpanId` (`string`, optional): Span ID to use as the starting point. When omitted, uses spans with no parent.
338
338
 
339
- **Returns:** `Trajectory` Contains `steps: TrajectoryStep[]` with recursive `children` and `totalDurationMs`.
339
+ **Returns:** `Trajectory`: Contains `steps: TrajectoryStep[]` with recursive `children` and `totalDurationMs`.
340
340
 
341
341
  #### Span type mapping
342
342
 
@@ -622,6 +622,6 @@ const result = await runEvals({
622
622
 
623
623
  ## Related
624
624
 
625
- - [runEvals reference](https://mastra.ai/reference/evals/run-evals) Pipeline that extracts trajectories and passes them to scorers
626
- - [MastraScorer reference](https://mastra.ai/reference/evals/mastra-scorer) Base scorer interface
627
- - [Scorer utils](https://mastra.ai/reference/evals/scorer-utils) Utility functions including `extractTrajectory` and `compareTrajectories`
625
+ - [runEvals reference](https://mastra.ai/reference/evals/run-evals): Pipeline that extracts trajectories and passes them to scorers
626
+ - [MastraScorer reference](https://mastra.ai/reference/evals/mastra-scorer): Base scorer interface
627
+ - [Scorer utils](https://mastra.ai/reference/evals/scorer-utils): Utility functions including `extractTrajectory` and `compareTrajectories`
@@ -126,6 +126,6 @@ This format ensures compatibility with all OTEL-compatible backends and collecto
126
126
 
127
127
  ## Related
128
128
 
129
- - [OtelBridge Guide](https://mastra.ai/docs/observability/tracing/bridges/otel) - Setup guide with examples
130
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - General tracing concepts
131
- - [OtelExporter Reference](https://mastra.ai/reference/observability/tracing/exporters/otel) - OTEL exporter for sending traces
129
+ - [OtelBridge Guide](https://mastra.ai/docs/observability/tracing/bridges/otel): Setup guide with examples
130
+ - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): General tracing concepts
131
+ - [OtelExporter Reference](https://mastra.ai/reference/observability/tracing/exporters/otel): OTEL exporter for sending traces
@@ -189,21 +189,21 @@ Shuts down all observability instances and clears the registry.
189
189
 
190
190
  ### Documentation
191
191
 
192
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Concepts and usage guide
193
- - [Sampling Strategies](https://mastra.ai/docs/observability/tracing/overview) - Sampling configuration details
194
- - [Multi-Config Setup](https://mastra.ai/docs/observability/tracing/overview) - Using multiple configurations
192
+ - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Concepts and usage guide
193
+ - [Sampling Strategies](https://mastra.ai/docs/observability/tracing/overview): Sampling configuration details
194
+ - [Multi-Config Setup](https://mastra.ai/docs/observability/tracing/overview): Using multiple configurations
195
195
 
196
196
  ### Reference
197
197
 
198
- - [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances) - Core tracing classes
199
- - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces) - Type definitions
200
- - [Spans Reference](https://mastra.ai/reference/observability/tracing/spans) - Span lifecycle
198
+ - [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances): Core tracing classes
199
+ - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces): Type definitions
200
+ - [Spans Reference](https://mastra.ai/reference/observability/tracing/spans): Span lifecycle
201
201
 
202
202
  ### Exporters
203
203
 
204
- - [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter) - Storage configuration
205
- - [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) - Cloud setup
206
- - [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust) - Braintrust integration
207
- - [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse) - Langfuse integration
208
- - [LangSmith](https://mastra.ai/reference/observability/tracing/exporters/langsmith) - LangSmith integration
209
- - [Span filtering](https://mastra.ai/reference/observability/tracing/span-filtering) - Selectively exclude spans
204
+ - [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter): Storage configuration
205
+ - [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter): Cloud setup
206
+ - [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust): Braintrust integration
207
+ - [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse): Langfuse integration
208
+ - [LangSmith](https://mastra.ai/reference/observability/tracing/exporters/langsmith): LangSmith integration
209
+ - [Span filtering](https://mastra.ai/reference/observability/tracing/span-filtering): Selectively exclude spans
@@ -1,6 +1,6 @@
1
1
  # CloudExporter
2
2
 
3
- Sends tracing spans, logs, metrics, scores, and feedback to Mastra Cloud for online visualization and monitoring.
3
+ Sends tracing spans, logs, metrics, scores, and feedback to the Mastra platform for online visualization and monitoring.
4
4
 
5
5
  ## Constructor
6
6
 
@@ -134,7 +134,7 @@ Every `FeedbackEvent` passed to this handler is buffered and exported to the Clo
134
134
  async flush(): Promise<void>
135
135
  ```
136
136
 
137
- Force flushes any buffered events to Mastra Cloud without shutting down the exporter. Useful in serverless environments where you need to ensure spans are exported before the runtime terminates.
137
+ Force flushes any buffered events to the Mastra platform without shutting down the exporter. Useful in serverless environments where you need to ensure spans are exported before the runtime terminates.
138
138
 
139
139
  ### shutdown
140
140
 
@@ -226,17 +226,17 @@ const customExporter = new CloudExporter({
226
226
 
227
227
  ### Documentation
228
228
 
229
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Complete guide
230
- - [Exporters](https://mastra.ai/docs/observability/tracing/overview) - Exporter concepts
229
+ - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide
230
+ - [Exporters](https://mastra.ai/docs/observability/tracing/overview): Exporter concepts
231
231
 
232
232
  ### Other Exporters
233
233
 
234
- - [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter) - Storage persistence
235
- - [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter) - Debug output
236
- - [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse) - Langfuse integration
237
- - [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust) - Braintrust integration
234
+ - [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter): Storage persistence
235
+ - [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter): Debug output
236
+ - [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse): Langfuse integration
237
+ - [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust): Braintrust integration
238
238
 
239
239
  ### Reference
240
240
 
241
- - [Configuration](https://mastra.ai/reference/observability/tracing/configuration) - Configuration options
242
- - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces) - Type definitions
241
+ - [Configuration](https://mastra.ai/reference/observability/tracing/configuration): Configuration options
242
+ - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces): Type definitions
@@ -119,17 +119,17 @@ const exporterWithLogger = new ConsoleExporter({
119
119
 
120
120
  ### Documentation
121
121
 
122
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Complete guide
123
- - [Exporters](https://mastra.ai/docs/observability/tracing/overview) - Exporter concepts
122
+ - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide
123
+ - [Exporters](https://mastra.ai/docs/observability/tracing/overview): Exporter concepts
124
124
 
125
125
  ### Other Exporters
126
126
 
127
- - [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter) - Storage persistence
128
- - [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) - Mastra Cloud
129
- - [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse) - Langfuse integration
130
- - [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust) - Braintrust integration
127
+ - [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter): Storage persistence
128
+ - [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter): Mastra platform
129
+ - [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse): Langfuse integration
130
+ - [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust): Braintrust integration
131
131
 
132
132
  ### Reference
133
133
 
134
- - [Configuration](https://mastra.ai/reference/observability/tracing/configuration) - Configuration options
135
- - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces) - Type definitions
134
+ - [Configuration](https://mastra.ai/reference/observability/tracing/configuration): Configuration options
135
+ - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces): Type definitions
@@ -158,17 +158,17 @@ const customExporter = new DefaultExporter({
158
158
 
159
159
  ### Documentation
160
160
 
161
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Complete guide
162
- - [Exporters](https://mastra.ai/docs/observability/tracing/overview) - Exporter concepts
161
+ - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide
162
+ - [Exporters](https://mastra.ai/docs/observability/tracing/overview): Exporter concepts
163
163
 
164
164
  ### Other Exporters
165
165
 
166
- - [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) - Mastra Cloud
167
- - [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter) - Debug output
168
- - [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse) - Langfuse integration
169
- - [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust) - Braintrust integration
166
+ - [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter): Mastra platform
167
+ - [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter): Debug output
168
+ - [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse): Langfuse integration
169
+ - [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust): Braintrust integration
170
170
 
171
171
  ### Reference
172
172
 
173
- - [Configuration](https://mastra.ai/reference/observability/tracing/configuration) - Configuration options
174
- - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces) - Type definitions
173
+ - [Configuration](https://mastra.ai/reference/observability/tracing/configuration): Configuration options
174
+ - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces): Type definitions
@@ -194,6 +194,6 @@ Tags are stored as a JSON-stringified array in the `mastra.tags` span attribute
194
194
 
195
195
  ## Related
196
196
 
197
- - [OtelExporter Guide](https://mastra.ai/docs/observability/tracing/exporters/otel) - Setup guide with provider configurations
198
- - [OtelBridge](https://mastra.ai/docs/observability/tracing/bridges/otel) - For bidirectional OTEL context integration
199
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - General tracing concepts
197
+ - [OtelExporter Guide](https://mastra.ai/docs/observability/tracing/exporters/otel): Setup guide with provider configurations
198
+ - [OtelBridge](https://mastra.ai/docs/observability/tracing/bridges/otel): For bidirectional OTEL context integration
199
+ - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): General tracing concepts
@@ -95,13 +95,13 @@ class CustomObservabilityInstance extends BaseObservabilityInstance {
95
95
 
96
96
  ### Documentation
97
97
 
98
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Concepts and usage guide
99
- - [Configuration Reference](https://mastra.ai/reference/observability/tracing/configuration) - Configuration options
100
- - [Interfaces Reference](https://mastra.ai/reference/observability/tracing/interfaces) - Type definitions
101
- - [Spans Reference](https://mastra.ai/reference/observability/tracing/spans) - Span lifecycle and methods
98
+ - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Concepts and usage guide
99
+ - [Configuration Reference](https://mastra.ai/reference/observability/tracing/configuration): Configuration options
100
+ - [Interfaces Reference](https://mastra.ai/reference/observability/tracing/interfaces): Type definitions
101
+ - [Spans Reference](https://mastra.ai/reference/observability/tracing/spans): Span lifecycle and methods
102
102
 
103
103
  ### Exporters
104
104
 
105
- - [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter) - Storage persistence
106
- - [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) - Mastra Cloud integration
107
- - [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter) - Debug output
105
+ - [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter): Storage persistence
106
+ - [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter): Mastra platform integration
107
+ - [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter): Debug output
@@ -735,12 +735,12 @@ enum InternalSpans {
735
735
 
736
736
  ### Documentation
737
737
 
738
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Complete guide to Tracing
739
- - [Creating Child Spans](https://mastra.ai/docs/observability/tracing/overview) - Working with span hierarchies
740
- - [Adding Custom Metadata](https://mastra.ai/docs/observability/tracing/overview) - Enriching traces
738
+ - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide to Tracing
739
+ - [Creating Child Spans](https://mastra.ai/docs/observability/tracing/overview): Working with span hierarchies
740
+ - [Adding Custom Metadata](https://mastra.ai/docs/observability/tracing/overview): Enriching traces
741
741
 
742
742
  ### Reference
743
743
 
744
- - [Configuration](https://mastra.ai/reference/observability/tracing/configuration) - Registry and configuration
745
- - [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances) - Core implementations
746
- - [Spans Reference](https://mastra.ai/reference/observability/tracing/spans) - Span lifecycle methods
744
+ - [Configuration](https://mastra.ai/reference/observability/tracing/configuration): Registry and configuration
745
+ - [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances): Core implementations
746
+ - [Spans Reference](https://mastra.ai/reference/observability/tracing/spans): Span lifecycle methods
@@ -215,12 +215,12 @@ A span that performs no operations. All methods are no-ops:
215
215
 
216
216
  ### Documentation
217
217
 
218
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Concepts and usage
219
- - [Creating Child Spans](https://mastra.ai/docs/observability/tracing/overview) - Practical examples
220
- - [Retrieving Trace IDs](https://mastra.ai/docs/observability/tracing/overview) - Using trace IDs
218
+ - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Concepts and usage
219
+ - [Creating Child Spans](https://mastra.ai/docs/observability/tracing/overview): Practical examples
220
+ - [Retrieving Trace IDs](https://mastra.ai/docs/observability/tracing/overview): Using trace IDs
221
221
 
222
222
  ### Reference
223
223
 
224
- - [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances) - Core tracing classes
225
- - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces) - Complete type reference
226
- - [Configuration](https://mastra.ai/reference/observability/tracing/configuration) - Configuration options
224
+ - [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances): Core tracing classes
225
+ - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces): Complete type reference
226
+ - [Configuration](https://mastra.ai/reference/observability/tracing/configuration): Configuration options
@@ -522,6 +522,6 @@ export class WordCounter implements Processor {
522
522
 
523
523
  ## Related
524
524
 
525
- - [Processors overview](https://mastra.ai/docs/agents/processors) - Conceptual guide to processors
526
- - [Guardrails](https://mastra.ai/docs/agents/guardrails) - Security and validation processors
527
- - [Memory Processors](https://mastra.ai/docs/memory/memory-processors) - Memory-specific processors
525
+ - [Processors overview](https://mastra.ai/docs/agents/processors): Conceptual guide to processors
526
+ - [Guardrails](https://mastra.ai/docs/agents/guardrails): Security and validation processors
527
+ - [Memory Processors](https://mastra.ai/docs/memory/memory-processors): Memory-specific processors
@@ -259,6 +259,6 @@ Common status codes:
259
259
 
260
260
  ## Related
261
261
 
262
- - [Server Routes](https://mastra.ai/reference/server/routes) - Default Mastra routes
263
- - [MastraServer](https://mastra.ai/reference/server/mastra-server) - Server adapter class
264
- - [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Using adapters
262
+ - [Server Routes](https://mastra.ai/reference/server/routes): Default Mastra routes
263
+ - [MastraServer](https://mastra.ai/reference/server/mastra-server): Server adapter class
264
+ - [Server Adapters](https://mastra.ai/docs/server/server-adapters): Using adapters
@@ -190,10 +190,10 @@ For custom middleware ordering, call each method separately instead of `init()`.
190
190
 
191
191
  ## Examples
192
192
 
193
- - [Express Adapter](https://github.com/mastra-ai/mastra/tree/main/examples/server-express-adapter) - Basic Express server setup
193
+ - [Express Adapter](https://github.com/mastra-ai/mastra/tree/main/examples/server-express-adapter): Basic Express server setup
194
194
 
195
195
  ## Related
196
196
 
197
- - [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Shared adapter concepts
198
- - [MastraServer Reference](https://mastra.ai/reference/server/mastra-server) - Full API reference
199
- - [createRoute() Reference](https://mastra.ai/reference/server/create-route) - Creating type-safe custom routes
197
+ - [Server Adapters](https://mastra.ai/docs/server/server-adapters): Shared adapter concepts
198
+ - [MastraServer Reference](https://mastra.ai/reference/server/mastra-server): Full API reference
199
+ - [createRoute() Reference](https://mastra.ai/reference/server/create-route): Creating type-safe custom routes
@@ -109,10 +109,10 @@ For custom middleware ordering, call each method separately instead of `init()`.
109
109
 
110
110
  ## Examples
111
111
 
112
- - [Fastify Adapter](https://github.com/mastra-ai/mastra/tree/main/examples/server-fastify-adapter) - Basic Fastify server setup
112
+ - [Fastify Adapter](https://github.com/mastra-ai/mastra/tree/main/examples/server-fastify-adapter): Basic Fastify server setup
113
113
 
114
114
  ## Related
115
115
 
116
- - [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Shared adapter concepts
117
- - [MastraServer Reference](https://mastra.ai/reference/server/mastra-server) - Full API reference
118
- - [createRoute() Reference](https://mastra.ai/reference/server/create-route) - Creating type-safe custom routes
116
+ - [Server Adapters](https://mastra.ai/docs/server/server-adapters): Shared adapter concepts
117
+ - [MastraServer Reference](https://mastra.ai/reference/server/mastra-server): Full API reference
118
+ - [createRoute() Reference](https://mastra.ai/reference/server/create-route): Creating type-safe custom routes
@@ -175,10 +175,10 @@ For custom middleware ordering, call each method separately instead of `init()`.
175
175
 
176
176
  ## Examples
177
177
 
178
- - [Hono Adapter](https://github.com/mastra-ai/mastra/tree/main/examples/server-hono-adapter) - Basic Hono server setup
178
+ - [Hono Adapter](https://github.com/mastra-ai/mastra/tree/main/examples/server-hono-adapter): Basic Hono server setup
179
179
 
180
180
  ## Related
181
181
 
182
- - [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Shared adapter concepts
183
- - [MastraServer Reference](https://mastra.ai/reference/server/mastra-server) - Full API reference
184
- - [createRoute() Reference](https://mastra.ai/reference/server/create-route) - Creating type-safe custom routes
182
+ - [Server Adapters](https://mastra.ai/docs/server/server-adapters): Shared adapter concepts
183
+ - [MastraServer Reference](https://mastra.ai/reference/server/mastra-server): Full API reference
184
+ - [createRoute() Reference](https://mastra.ai/reference/server/create-route): Creating type-safe custom routes
@@ -141,10 +141,10 @@ For custom middleware ordering, call each method separately instead of `init()`.
141
141
 
142
142
  ## Examples
143
143
 
144
- - [Koa Adapter](https://github.com/mastra-ai/mastra/tree/main/examples/server-koa-adapter) - Basic Koa server setup
144
+ - [Koa Adapter](https://github.com/mastra-ai/mastra/tree/main/examples/server-koa-adapter): Basic Koa server setup
145
145
 
146
146
  ## Related
147
147
 
148
- - [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Shared adapter concepts
149
- - [MastraServer Reference](https://mastra.ai/reference/server/mastra-server) - Full API reference
150
- - [createRoute() Reference](https://mastra.ai/reference/server/create-route) - Creating type-safe custom routes
148
+ - [Server Adapters](https://mastra.ai/docs/server/server-adapters): Shared adapter concepts
149
+ - [MastraServer Reference](https://mastra.ai/reference/server/mastra-server): Full API reference
150
+ - [createRoute() Reference](https://mastra.ai/reference/server/create-route): Creating type-safe custom routes
@@ -294,6 +294,6 @@ export class MyServer extends MastraServer<MyApp, MyRequest, MyResponse> {
294
294
 
295
295
  ## Related
296
296
 
297
- - [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Using adapters
298
- - [Custom Adapters](https://mastra.ai/docs/server/custom-adapters) - Creating custom adapters
299
- - [createRoute()](https://mastra.ai/reference/server/create-route) - Creating custom routes
297
+ - [Server Adapters](https://mastra.ai/docs/server/server-adapters): Using adapters
298
+ - [Custom Adapters](https://mastra.ai/docs/server/custom-adapters): Creating custom adapters
299
+ - [createRoute()](https://mastra.ai/reference/server/create-route): Creating custom routes
@@ -243,7 +243,7 @@ registerApiRoute('/items/:itemId', {
243
243
 
244
244
  ## Related
245
245
 
246
- - [Custom API Routes Guide](https://mastra.ai/docs/server/custom-api-routes) - Usage guide with examples
247
- - [Server Middleware](https://mastra.ai/docs/server/middleware) - Global middleware configuration
248
- - [createRoute()](https://mastra.ai/reference/server/create-route) - Type-safe route creation for server adapters
249
- - [Server Routes](https://mastra.ai/reference/server/routes) - Built-in Mastra server routes
246
+ - [Custom API Routes Guide](https://mastra.ai/docs/server/custom-api-routes): Usage guide with examples
247
+ - [Server Middleware](https://mastra.ai/docs/server/middleware): Global middleware configuration
248
+ - [createRoute()](https://mastra.ai/reference/server/create-route): Type-safe route creation for server adapters
249
+ - [Server Routes](https://mastra.ai/reference/server/routes): Built-in Mastra server routes
@@ -343,5 +343,5 @@ Common status codes:
343
343
 
344
344
  ## Related
345
345
 
346
- - [createRoute()](https://mastra.ai/reference/server/create-route) - Creating custom routes
347
- - [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Using adapters
346
+ - [createRoute()](https://mastra.ai/reference/server/create-route): Creating custom routes
347
+ - [Server Adapters](https://mastra.ai/docs/server/server-adapters): Using adapters
@@ -50,7 +50,7 @@ createdAttimestampNOT NULLupdatedAttimestampNOT NULLUsed for thread ordering his
50
50
 
51
51
  Stores user-specific data for resource-scoped working memory. Each resource represents a user or entity, allowing working memory to persist across all conversation threads for that user.
52
52
 
53
- idtextPRIMARYKEYNOT NULLResource identifier (user or entity ID) - same as resourceId used in threads and agent callsworkingMemorytextCAN BE NULLPersistent working memory data as Markdown text. Contains user profile, preferences, and contextual information that persists across conversation threads.metadatajsonbCAN BE NULLAdditional resource metadata as JSON. Example:
53
+ idtextPRIMARYKEYNOT NULLResource identifier (user or entity ID): same as resourceId used in threads and agent callsworkingMemorytextCAN BE NULLPersistent working memory data as Markdown text. Contains user profile, preferences, and contextual information that persists across conversation threads.metadatajsonbCAN BE NULLAdditional resource metadata as JSON. Example:
54
54
 
55
55
  ```json
56
56
  {
@@ -479,6 +479,6 @@ for await (const chunk of stream.fullStream) {
479
479
 
480
480
  ## Related types
481
481
 
482
- - [.stream()](https://mastra.ai/reference/streaming/agents/stream) - Method that returns streams emitting these chunks
483
- - [MastraModelOutput](https://mastra.ai/reference/streaming/agents/MastraModelOutput) - The stream object that emits these chunks
484
- - [workflow.stream()](https://mastra.ai/reference/streaming/workflows/stream) - Method that returns streams emitting these chunks for workflows
482
+ - [.stream()](https://mastra.ai/reference/streaming/agents/stream): Method that returns streams emitting these chunks
483
+ - [MastraModelOutput](https://mastra.ai/reference/streaming/agents/MastraModelOutput): The stream object that emits these chunks
484
+ - [workflow.stream()](https://mastra.ai/reference/streaming/workflows/stream): Method that returns streams emitting these chunks for workflows
@@ -248,5 +248,5 @@ if (stream.error) {
248
248
 
249
249
  ## Related types
250
250
 
251
- - [.stream()](https://mastra.ai/reference/streaming/agents/stream) - Method that returns MastraModelOutput
252
- - [ChunkType](https://mastra.ai/reference/streaming/ChunkType) - All possible chunk types in the full stream
251
+ - [.stream()](https://mastra.ai/reference/streaming/agents/stream): Method that returns MastraModelOutput
252
+ - [ChunkType](https://mastra.ai/reference/streaming/ChunkType): All possible chunk types in the full stream
@@ -78,6 +78,6 @@ Returns an array of available voice options, where each node contains:
78
78
 
79
79
  If you need speech-to-text capabilities in addition to text-to-speech, consider using one of these providers:
80
80
 
81
- - [OpenAI](https://mastra.ai/reference/voice/openai) - Provides both TTS and STT
82
- - [Google](https://mastra.ai/reference/voice/google) - Provides both TTS and STT
83
- - [Azure](https://mastra.ai/reference/voice/azure) - Provides both TTS and STT
81
+ - [OpenAI](https://mastra.ai/reference/voice/openai): Provides both TTS and STT
82
+ - [Google](https://mastra.ai/reference/voice/google): Provides both TTS and STT
83
+ - [Azure](https://mastra.ai/reference/voice/azure): Provides both TTS and STT
@@ -90,7 +90,7 @@ await voice.connect()
90
90
 
91
91
  ## Related methods
92
92
 
93
- - [voice.send()](https://mastra.ai/reference/voice/voice.send) - Sends audio data to the voice provider
94
- - [voice.answer()](https://mastra.ai/reference/voice/voice.answer) - Triggers the voice provider to respond
95
- - [voice.close()](https://mastra.ai/reference/voice/voice.close) - Disconnects from the real-time service
96
- - [voice.on()](https://mastra.ai/reference/voice/voice.on) - Registers an event listener for voice events
93
+ - [voice.send()](https://mastra.ai/reference/voice/voice.send): Sends audio data to the voice provider
94
+ - [voice.answer()](https://mastra.ai/reference/voice/voice.answer): Triggers the voice provider to respond
95
+ - [voice.close()](https://mastra.ai/reference/voice/voice.close): Disconnects from the real-time service
96
+ - [voice.on()](https://mastra.ai/reference/voice/voice.on): Registers an event listener for voice events
@@ -165,6 +165,6 @@ await voice.listen(microphoneStream)
165
165
 
166
166
  ## Related methods
167
167
 
168
- - [voice.speak()](https://mastra.ai/reference/voice/voice.speak) - Converts text to speech
169
- - [voice.send()](https://mastra.ai/reference/voice/voice.send) - Sends audio data to the voice provider in real-time
170
- - [voice.on()](https://mastra.ai/reference/voice/voice.on) - Registers an event listener for voice events
168
+ - [voice.speak()](https://mastra.ai/reference/voice/voice.speak): Converts text to speech
169
+ - [voice.send()](https://mastra.ai/reference/voice/voice.send): Sends audio data to the voice provider in real-time
170
+ - [voice.on()](https://mastra.ai/reference/voice/voice.on): Registers an event listener for voice events