@mastra/observability 1.21.1-alpha.0 → 1.21.1-alpha.2
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.
- package/dist/exporters/test.d.ts.map +1 -1
- package/dist/index.cjs +144 -110
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +143 -108
- package/dist/index.js.map +1 -1
- package/dist/instances/base.d.ts.map +1 -1
- package/dist/metrics/pricing-data.json +1070 -559
- package/dist/spans/base.d.ts +33 -1
- package/dist/spans/base.d.ts.map +1 -1
- package/dist/usage.d.ts +3 -0
- package/dist/usage.d.ts.map +1 -1
- package/package.json +8 -8
package/dist/spans/base.d.ts
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import { SpanType } from '@mastra/core/observability';
|
|
2
2
|
import type { Span, SpanTypeMap, AnySpan, ChildSpanOptions, ChildEventOptions, EndSpanOptions, ErrorSpanOptions, UpdateSpanOptions, CreateSpanOptions, ObservabilityInstance, ExportedSpan, SpanSnapshot, TraceState, IModelSpanTracker, ModelSpanTrackerOptions, AIModelGenerationSpan, EntityType, TracingPolicy, CorrelationContext, SpanLink } from '@mastra/core/observability';
|
|
3
3
|
import type { DeepCleanOptions } from './serialization.js';
|
|
4
|
+
/** Parent and root entity fields shared by exported spans and correlation context */
|
|
5
|
+
type SpanEntityLineage = Pick<ExportedSpan<SpanType>, 'parentEntityType' | 'parentEntityId' | 'parentEntityName' | 'parentEntityVersionId' | 'rootEntityType' | 'rootEntityId' | 'rootEntityName' | 'rootEntityVersionId'>;
|
|
4
6
|
/**
|
|
5
7
|
* Get the external parent span ID from CreateSpanOptions.
|
|
6
8
|
*
|
|
@@ -91,6 +93,17 @@ export declare abstract class BaseSpan<TType extends SpanType = any> implements
|
|
|
91
93
|
isExcluded: boolean;
|
|
92
94
|
/** Cached canonical correlation context for this live span */
|
|
93
95
|
protected correlationContext?: CorrelationContext;
|
|
96
|
+
/**
|
|
97
|
+
* Parent and root entity restored by `rebuildSpan()`. A rebuilt span has no
|
|
98
|
+
* live `parent`, so its original ancestors are only known from the cached export.
|
|
99
|
+
*/
|
|
100
|
+
protected restoredLineage?: SpanEntityLineage;
|
|
101
|
+
/**
|
|
102
|
+
* Version declared for this span's own entity, or inherited from a parent span
|
|
103
|
+
* of the same entity. Unlike `metadata.entityVersionId`, never an ancestor's
|
|
104
|
+
* version for a different entity.
|
|
105
|
+
*/
|
|
106
|
+
ownEntityVersionId?: string;
|
|
94
107
|
/**
|
|
95
108
|
* Subclasses can override to unconditionally mark the span as excluded.
|
|
96
109
|
* NoOpSpan uses this because it is never exported regardless of config.
|
|
@@ -161,7 +174,25 @@ export declare abstract class BaseSpan<TType extends SpanType = any> implements
|
|
|
161
174
|
protected getExportedExternalParentSpanId(includeInternalSpans?: boolean): string | undefined;
|
|
162
175
|
/** Find the closest parent span of a specific type by walking up the parent chain */
|
|
163
176
|
findParent<T extends SpanType>(spanType: T): Span<T> | undefined;
|
|
164
|
-
/**
|
|
177
|
+
/**
|
|
178
|
+
* Restore the parent and root entity a span had before it was exported and
|
|
179
|
+
* rebuilt (durable execution), so it and its new children keep their lineage.
|
|
180
|
+
*/
|
|
181
|
+
restoreEntityLineage(cached: SpanEntityLineage & Pick<SpanSnapshot<SpanType>, 'ownEntityVersionId'>): void;
|
|
182
|
+
/**
|
|
183
|
+
* Build and cache the canonical correlation context for this live span.
|
|
184
|
+
*
|
|
185
|
+
* Parent entity: the nearest ancestor that is not internal or excluded, the
|
|
186
|
+
* same rule used for entity inheritance. Root entity: the top of the
|
|
187
|
+
* in-process parent chain, which is not necessarily the distributed trace's
|
|
188
|
+
* root when the trace continues from another service. The root walk does not
|
|
189
|
+
* skip internal spans, so the root can name an entity whose span is not
|
|
190
|
+
* exported. Logs, metrics, scores and feedback share these values.
|
|
191
|
+
*
|
|
192
|
+
* When the top of the live chain was rebuilt, its original ancestors only
|
|
193
|
+
* survive in the restored lineage, so it supplies the root and, when no live
|
|
194
|
+
* ancestor qualifies, the parent.
|
|
195
|
+
*/
|
|
165
196
|
getCorrelationContext(): CorrelationContext;
|
|
166
197
|
/** Returns a lightweight span ready for export */
|
|
167
198
|
exportSpan(includeInternalSpans?: boolean): ExportedSpan<TType>;
|
|
@@ -179,4 +210,5 @@ export declare abstract class BaseSpan<TType extends SpanType = any> implements
|
|
|
179
210
|
*/
|
|
180
211
|
executeInContextSync<T>(fn: () => T): T;
|
|
181
212
|
}
|
|
213
|
+
export {};
|
|
182
214
|
//# sourceMappingURL=base.d.ts.map
|
package/dist/spans/base.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/spans/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACT,MAAM,4BAA4B,CAAC;AAKpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/spans/base.ts"],"names":[],"mappings":"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"}
|
package/dist/usage.d.ts
CHANGED
|
@@ -37,6 +37,9 @@ export declare function extractOpenRouterCost(providerMetadata?: ProviderMetadat
|
|
|
37
37
|
* - Google/Gemini: cachedContentTokenCount, thoughtsTokenCount in providerMetadata.google.usageMetadata
|
|
38
38
|
* - OpenRouter: Uses OpenAI-compatible structure (cache tokens in usage)
|
|
39
39
|
*
|
|
40
|
+
* Kept in sync with `packages/core/src/observability/usage.ts` (duplicated so exporters do not need a newer core).
|
|
41
|
+
* Change both copies together; `usage.parity.test.ts` fails if they drift.
|
|
42
|
+
*
|
|
40
43
|
* @param usage - The LanguageModelV2Usage from AI SDK response
|
|
41
44
|
* @param providerMetadata - Optional provider-specific metadata
|
|
42
45
|
* @returns UsageStats with inputDetails and outputDetails
|
package/dist/usage.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAyC,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA8BhF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,SAAS,CAoC3G;AAgDD
|
|
1
|
+
{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAyC,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA8BhF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,SAAS,CAoC3G;AAgDD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAkI/G;AA0CD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU,CAclF"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/observability",
|
|
3
|
-
"version": "1.21.1-alpha.
|
|
3
|
+
"version": "1.21.1-alpha.2",
|
|
4
4
|
"description": "Core observability package for Mastra - includes tracing and scoring features",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -23,19 +23,19 @@
|
|
|
23
23
|
},
|
|
24
24
|
"license": "Apache-2.0",
|
|
25
25
|
"devDependencies": {
|
|
26
|
-
"@types/node": "22.
|
|
27
|
-
"@vitest/coverage-v8": "4.1.
|
|
28
|
-
"@vitest/ui": "4.1.
|
|
26
|
+
"@types/node": "22.19.15",
|
|
27
|
+
"@vitest/coverage-v8": "4.1.12",
|
|
28
|
+
"@vitest/ui": "4.1.12",
|
|
29
29
|
"tsdown": "0.23.1",
|
|
30
|
-
"tsx": "^4.23.
|
|
30
|
+
"tsx": "^4.23.15",
|
|
31
31
|
"typescript": "^7.0.2",
|
|
32
|
-
"vitest": "4.1.
|
|
32
|
+
"vitest": "4.1.12",
|
|
33
33
|
"zod": "^4.6.7",
|
|
34
34
|
"@internal/ai-sdk-v4": "0.0.92",
|
|
35
|
-
"@internal/lint": "0.0.145",
|
|
36
35
|
"@internal/ai-sdk-v5": "0.0.92",
|
|
36
|
+
"@internal/lint": "0.0.145",
|
|
37
37
|
"@internal/types-builder": "0.0.120",
|
|
38
|
-
"@mastra/core": "1.80.0-alpha.
|
|
38
|
+
"@mastra/core": "1.80.0-alpha.4"
|
|
39
39
|
},
|
|
40
40
|
"peerDependencies": {
|
|
41
41
|
"@mastra/core": ">=1.16.0-0 <2.0.0-0",
|