@mastra/mcp-docs-server 1.1.40-alpha.17 → 1.1.40-alpha.18
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.
|
@@ -180,6 +180,50 @@ interface ObservabilityExporter {
|
|
|
180
180
|
|
|
181
181
|
Event callback payloads use observability event bus envelopes: `TracingEvent` carries span lifecycle events with `exportedSpan`, `LogEvent` wraps `ExportedLog` in `log`, `MetricEvent` wraps `ExportedMetric` in `metric`, `ScoreEvent` wraps `ExportedScore` in `score`, and `FeedbackEvent` wraps `ExportedFeedback` in `feedback`. For Mastra platform exporter behavior for these callbacks, see [MastraPlatformExporter](https://mastra.ai/reference/observability/tracing/exporters/mastra-platform-exporter).
|
|
182
182
|
|
|
183
|
+
Like `LogEvent`, `MetricEvent`, and `FeedbackEvent`, `ScoreEvent` is an observability bus envelope that wraps a bounded payload. For scores, that payload is `ExportedScore`.
|
|
184
|
+
|
|
185
|
+
### `ScoreEvent`
|
|
186
|
+
|
|
187
|
+
Score events are sent to exporters through `onScoreEvent`. The event is a small envelope with the signal type and the score payload:
|
|
188
|
+
|
|
189
|
+
```typescript
|
|
190
|
+
interface ScoreEvent {
|
|
191
|
+
type: 'score'
|
|
192
|
+
score: ExportedScore
|
|
193
|
+
}
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
### `ExportedScore`
|
|
197
|
+
|
|
198
|
+
`ExportedScore` is the bounded payload that exporters receive inside `ScoreEvent.score`. It contains the score identity, target trace or span anchor, scorer details, value, optional explanation, and correlation metadata.
|
|
199
|
+
|
|
200
|
+
```typescript
|
|
201
|
+
interface ExportedScore {
|
|
202
|
+
scoreId: string
|
|
203
|
+
timestamp: Date
|
|
204
|
+
traceId?: string
|
|
205
|
+
spanId?: string
|
|
206
|
+
scorerId: string
|
|
207
|
+
scorerName?: string
|
|
208
|
+
scorerVersion?: string
|
|
209
|
+
source?: string
|
|
210
|
+
scoreSource?: string
|
|
211
|
+
score: number
|
|
212
|
+
reason?: string
|
|
213
|
+
experimentId?: string
|
|
214
|
+
scoreTraceId?: string
|
|
215
|
+
targetEntityType?: EntityType
|
|
216
|
+
correlationContext?: CorrelationContext
|
|
217
|
+
metadata?: Record<string, unknown>
|
|
218
|
+
}
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
`traceId` and `spanId` identify the trace or span being scored. `scoreTraceId` identifies the trace of the scoring run itself when that scorer was traced. For new exporters, prefer `scoreSource` over the deprecated `source` field, and prefer `correlationContext.experimentId` over the deprecated top-level `experimentId` field.
|
|
222
|
+
|
|
223
|
+
`EntityType` is Mastra's observability entity enum. Current values include `agent`, `scorer`, `rag_ingestion`, `trajectory`, `input_processor`, `input_step_processor`, `output_processor`, `output_step_processor`, `workflow_step`, `tool`, `workflow_run`, and `memory`.
|
|
224
|
+
|
|
225
|
+
`CorrelationContext` is the shared context snapshot attached to observability signals. It can carry entity hierarchy fields, user or organization identifiers, run, session, thread, request, environment, source, service name, experiment, and tags. Prefer the top-level `traceId` and `spanId` fields on `ExportedScore` for the scored target.
|
|
226
|
+
|
|
183
227
|
### `ObservabilityDropEvent`
|
|
184
228
|
|
|
185
229
|
Structured event emitted when the exporter pipeline drops observability events.
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# @mastra/mcp-docs-server
|
|
2
2
|
|
|
3
|
+
## 1.1.40-alpha.18
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`d72dc4b`](https://github.com/mastra-ai/mastra/commit/d72dc4b12d832546c05c20255fa96fe4eb515900)]:
|
|
8
|
+
- @mastra/core@1.37.0-alpha.9
|
|
9
|
+
|
|
3
10
|
## 1.1.40-alpha.17
|
|
4
11
|
|
|
5
12
|
### Patch Changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp-docs-server",
|
|
3
|
-
"version": "1.1.40-alpha.
|
|
3
|
+
"version": "1.1.40-alpha.18",
|
|
4
4
|
"description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"jsdom": "^26.1.0",
|
|
30
30
|
"local-pkg": "^1.1.2",
|
|
31
31
|
"zod": "^4.4.3",
|
|
32
|
-
"@mastra/core": "1.37.0-alpha.
|
|
32
|
+
"@mastra/core": "1.37.0-alpha.9",
|
|
33
33
|
"@mastra/mcp": "^1.8.1-alpha.0"
|
|
34
34
|
},
|
|
35
35
|
"devDependencies": {
|
|
@@ -46,9 +46,9 @@
|
|
|
46
46
|
"tsx": "^4.21.0",
|
|
47
47
|
"typescript": "^6.0.3",
|
|
48
48
|
"vitest": "4.1.5",
|
|
49
|
-
"@
|
|
49
|
+
"@internal/types-builder": "0.0.72",
|
|
50
50
|
"@internal/lint": "0.0.97",
|
|
51
|
-
"@
|
|
51
|
+
"@mastra/core": "1.37.0-alpha.9"
|
|
52
52
|
},
|
|
53
53
|
"homepage": "https://mastra.ai",
|
|
54
54
|
"repository": {
|