@mastra/observability 1.12.0-alpha.0 → 1.12.0-alpha.1
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/CHANGELOG.md +19 -0
- package/dist/bus/observability-bus.d.ts +21 -4
- package/dist/bus/observability-bus.d.ts.map +1 -1
- package/dist/bus/route-event.d.ts +8 -1
- package/dist/bus/route-event.d.ts.map +1 -1
- package/dist/default.d.ts.map +1 -1
- package/dist/exporters/default.d.ts +2 -0
- package/dist/exporters/default.d.ts.map +1 -1
- package/dist/exporters/event-buffer.d.ts +4 -4
- package/dist/exporters/event-buffer.d.ts.map +1 -1
- package/dist/features.d.ts +39 -0
- package/dist/features.d.ts.map +1 -0
- package/dist/index.cjs +301 -44
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +301 -45
- package/dist/index.js.map +1 -1
- package/dist/model-tracing.d.ts +34 -4
- package/dist/model-tracing.d.ts.map +1 -1
- package/dist/recorded.d.ts.map +1 -1
- package/dist/spans/base.d.ts.map +1 -1
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,24 @@
|
|
|
1
1
|
# @mastra/observability
|
|
2
2
|
|
|
3
|
+
## 1.12.0-alpha.1
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- `DefaultExporter` now notifies custom exporters and connected integrations when it cannot persist observability events, such as unsupported storage or retries being exceeded. ([#16111](https://github.com/mastra-ai/mastra/pull/16111))
|
|
8
|
+
|
|
9
|
+
- Added new `MODEL_INFERENCE` span type under `MODEL_STEP`, covering only the model provider call. Use it to measure model latency separately from input/output processors and tool executions. ([#16267](https://github.com/mastra-ai/mastra/pull/16267))
|
|
10
|
+
|
|
11
|
+
### Patch Changes
|
|
12
|
+
|
|
13
|
+
- Fixed cost estimation for OpenRouter models. The **Model Usage & Cost** panel now shows costs for OpenRouter `vendor/model` ids (e.g. `openai/gpt-5-mini-2025-08-07`, `xiaomi/mimo-v2-pro-20260318`) that previously rendered an empty cost column. ([#16206](https://github.com/mastra-ai/mastra/pull/16206))
|
|
14
|
+
|
|
15
|
+
- Score events now include scorer names and target entity types. ([#16185](https://github.com/mastra-ai/mastra/pull/16185))
|
|
16
|
+
|
|
17
|
+
- Fixed `MODEL_INFERENCE` span timing so it measures pure model latency. ([#16357](https://github.com/mastra-ai/mastra/pull/16357))
|
|
18
|
+
|
|
19
|
+
- Updated dependencies [[`6742347`](https://github.com/mastra-ai/mastra/commit/6742347d71955d7639adc9ddf6ff8282de7ee3ba), [`7b0ad1f`](https://github.com/mastra-ai/mastra/commit/7b0ad1f5c53dc118c6da12ae82ae2587037dc2b8), [`62666c3`](https://github.com/mastra-ai/mastra/commit/62666c367eaeac3941ead454b1d38810cc855721), [`4af2160`](https://github.com/mastra-ai/mastra/commit/4af2160322f4718cac421930cce85641e9512389), [`136c959`](https://github.com/mastra-ai/mastra/commit/136c9592fb0eeb0cd212f28629d8a29b7557a2fc), [`4df7cc7`](https://github.com/mastra-ai/mastra/commit/4df7cc79342fd065fe7fdeef93c094db14b12bcd), [`aca3121`](https://github.com/mastra-ai/mastra/commit/aca31211233dac25459f140ea4fcfb3a5af64c18), [`9cdf38e`](https://github.com/mastra-ai/mastra/commit/9cdf38e58506e1109c8b38f97cd7770978a4218e), [`990851e`](https://github.com/mastra-ai/mastra/commit/990851edcb0e30be5c2c18b6532f1a876cc2d335), [`6068a6c`](https://github.com/mastra-ai/mastra/commit/6068a6c42950fad3ebfc92346417896ba60803d2), [`00106be`](https://github.com/mastra-ai/mastra/commit/00106bede59b81e5b0e9cd6aad8d3b5dbc336387), [`e2a079c`](https://github.com/mastra-ai/mastra/commit/e2a079cc3755b1895f7bd5dc36e9be81b11c7c22), [`534a456`](https://github.com/mastra-ai/mastra/commit/534a456a25e4df1e5407e7e632f4cb3b1fa14f9d), [`36bae07`](https://github.com/mastra-ai/mastra/commit/36bae07c0e70b1b3006f2fd20830e8883dcbd066)]:
|
|
20
|
+
- @mastra/core@1.33.0-alpha.7
|
|
21
|
+
|
|
3
22
|
## 1.12.0-alpha.0
|
|
4
23
|
|
|
5
24
|
### Minor Changes
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
* Handler presence = signal support. If a handler does not implement a method,
|
|
10
10
|
* events of that type are silently skipped for that handler.
|
|
11
11
|
*/
|
|
12
|
-
import type { ObservabilityExporter, ObservabilityBridge, ObservabilityEvent, SerializationOptions } from '@mastra/core/observability';
|
|
12
|
+
import type { ObservabilityExporter, ObservabilityBridge, ObservabilityEvent, ObservabilityDropEvent, SerializationOptions } from '@mastra/core/observability';
|
|
13
13
|
import { BaseObservabilityEventBus } from './base.js';
|
|
14
14
|
/**
|
|
15
15
|
* Unified event bus for all observability signals (tracing, logs, metrics, scores, feedback).
|
|
@@ -20,6 +20,8 @@ export declare class ObservabilityBus extends BaseObservabilityEventBus<Observab
|
|
|
20
20
|
private bridge?;
|
|
21
21
|
/** In-flight handler promises from routeToHandler. Self-cleaning via .finally(). */
|
|
22
22
|
private pendingHandlers;
|
|
23
|
+
private handlerBufferFlushDepth;
|
|
24
|
+
private dropEventsEmittedDuringHandlerFlush;
|
|
23
25
|
/** Resolved deepClean options applied to non-tracing events before fan-out. */
|
|
24
26
|
private deepCleanOptions;
|
|
25
27
|
constructor(opts?: {
|
|
@@ -69,13 +71,24 @@ export declare class ObservabilityBus extends BaseObservabilityEventBus<Observab
|
|
|
69
71
|
* and can be drained via flush().
|
|
70
72
|
*/
|
|
71
73
|
emit(event: ObservabilityEvent): void;
|
|
74
|
+
/**
|
|
75
|
+
* Emit exporter pipeline drop events to exporters and the bridge.
|
|
76
|
+
*
|
|
77
|
+
* Drop events describe exporter health, not user observability data, so they
|
|
78
|
+
* are intentionally not delivered to generic event-bus subscribers.
|
|
79
|
+
*/
|
|
80
|
+
emitDropEvent(event: ObservabilityDropEvent): void;
|
|
72
81
|
/**
|
|
73
82
|
* Track an async handler promise so flush() can await it.
|
|
74
83
|
* No-ops for sync (void) results.
|
|
75
84
|
*/
|
|
76
85
|
private trackPromise;
|
|
86
|
+
/** Await in-flight routed handler promises, draining until empty. */
|
|
87
|
+
private drainPendingHandlers;
|
|
88
|
+
/** Drain exporter and bridge SDK-internal buffers. */
|
|
89
|
+
private flushHandlerBuffers;
|
|
77
90
|
/**
|
|
78
|
-
*
|
|
91
|
+
* Multi-phase flush to ensure all observability data is fully exported.
|
|
79
92
|
*
|
|
80
93
|
* **Phase 1 — Delivery:** Await all in-flight handler promises (exporters,
|
|
81
94
|
* bridge, and base-class subscribers). After this resolves, all event data
|
|
@@ -83,8 +96,12 @@ export declare class ObservabilityBus extends BaseObservabilityEventBus<Observab
|
|
|
83
96
|
*
|
|
84
97
|
* **Phase 2 — Buffer drain:** Call flush() on each exporter and bridge to
|
|
85
98
|
* drain their SDK-internal buffers (e.g., OTEL BatchSpanProcessor, Langfuse
|
|
86
|
-
* client queue). Phases are sequential —
|
|
87
|
-
*
|
|
99
|
+
* client queue). Phases are sequential — buffer drains must not start until
|
|
100
|
+
* delivery completes, otherwise exporters would flush empty buffers.
|
|
101
|
+
*
|
|
102
|
+
* Exporter flushes can emit drop events. When that happens, flush loops
|
|
103
|
+
* through delivery and buffer drain again so alerting integrations that buffer
|
|
104
|
+
* drop notifications are drained before returning.
|
|
88
105
|
*/
|
|
89
106
|
flush(): Promise<void>;
|
|
90
107
|
/** Flush all pending events and exporter buffers, then clear subscribers. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"observability-bus.d.ts","sourceRoot":"","sources":["../../src/bus/observability-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AAsCnD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,yBAAyB,CAAC,kBAAkB,CAAC;IACjF,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAC,CAAsB;IAErC,oFAAoF;IACpF,OAAO,CAAC,eAAe,CAAiC;IAExD,+EAA+E;IAC/E,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,IAAI,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;KAAE;IAKlE;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAOvD;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO;IAS5D;;OAEG;IACH,YAAY,IAAI,SAAS,qBAAqB,EAAE;IAIhD;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAOjD;;;;OAIG;IACH,gBAAgB,IAAI,OAAO;IAQ3B;;OAEG;IACH,SAAS,IAAI,mBAAmB,GAAG,SAAS;IAI5C;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAoBrC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAQpB
|
|
1
|
+
{"version":3,"file":"observability-bus.d.ts","sourceRoot":"","sources":["../../src/bus/observability-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AAsCnD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,yBAAyB,CAAC,kBAAkB,CAAC;IACjF,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAC,CAAsB;IAErC,oFAAoF;IACpF,OAAO,CAAC,eAAe,CAAiC;IAExD,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,mCAAmC,CAAK;IAEhD,+EAA+E;IAC/E,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,IAAI,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;KAAE;IAKlE;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAOvD;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO;IAS5D;;OAEG;IACH,YAAY,IAAI,SAAS,qBAAqB,EAAE;IAIhD;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAOjD;;;;OAIG;IACH,gBAAgB,IAAI,OAAO;IAQ3B;;OAEG;IACH,SAAS,IAAI,mBAAmB,GAAG,SAAS;IAI5C;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAoBrC;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAclD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAQpB,qEAAqE;YACvD,oBAAoB;IAoBlC,sDAAsD;YACxC,mBAAmB;IAiBjC;;;;;;;;;;;;;;;OAeG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B,6EAA6E;IACvE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
* the ObservabilityBus (for exporters) and BaseObservabilityInstance (for bridges).
|
|
8
8
|
*/
|
|
9
9
|
import type { IMastraLogger } from '@mastra/core/logger';
|
|
10
|
-
import type { ObservabilityEvents, ObservabilityEvent } from '@mastra/core/observability';
|
|
10
|
+
import type { ObservabilityEvents, ObservabilityEvent, ObservabilityDropEvent } from '@mastra/core/observability';
|
|
11
11
|
/**
|
|
12
12
|
* Any handler that can receive routed observability events.
|
|
13
13
|
* Both ObservabilityExporter and ObservabilityBridge extend
|
|
@@ -28,4 +28,11 @@ export type ObservabilityHandler = ObservabilityEvents & {
|
|
|
28
28
|
* Sync throws are caught so one failing handler doesn't break others.
|
|
29
29
|
*/
|
|
30
30
|
export declare function routeToHandler(handler: ObservabilityHandler, event: ObservabilityEvent, logger: IMastraLogger): void | Promise<void>;
|
|
31
|
+
/**
|
|
32
|
+
* Route exporter pipeline drop events to a handler.
|
|
33
|
+
*
|
|
34
|
+
* Drop events are meta-events for alerting and health reporting, so they use a
|
|
35
|
+
* dedicated hook instead of the normal observability signal router.
|
|
36
|
+
*/
|
|
37
|
+
export declare function routeDropToHandler(handler: ObservabilityHandler, event: ObservabilityDropEvent, logger: IMastraLogger): void | Promise<void>;
|
|
31
38
|
//# sourceMappingURL=route-event.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"route-event.d.ts","sourceRoot":"","sources":["../../src/bus/route-event.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EAMnB,kBAAkB,
|
|
1
|
+
{"version":3,"file":"route-event.d.ts","sourceRoot":"","sources":["../../src/bus/route-event.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EAMnB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAGpC;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAa1E;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,aAAa,GACpB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDtB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,aAAa,GACpB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtB"}
|
package/dist/default.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../src/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,aAAa,EAEb,uBAAuB,
|
|
1
|
+
{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../src/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,aAAa,EAEb,uBAAuB,EAEvB,qBAAqB,EACrB,aAAa,EACb,UAAU,EAEX,MAAM,4BAA4B,CAAC;AAIpC,OAAO,KAAK,EAA+B,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAuBzF;;;GAGG;AACH,qBAAa,aAAc,SAAQ,UAAW,YAAW,uBAAuB;;gBAIlE,MAAM,EAAE,2BAA2B;IAgJ/C,yFAAyF;IACzF,gBAAgB,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAkCnD,sFAAsF;IACtF,SAAS,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI;IAOnD,0FAA0F;IAC1F,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,qBAAqB,GAAG,SAAS;IAIhF,gBAAgB,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA6B1E,QAAQ,CAAC,IAAI,EAAE;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;QACxC,KAAK,EAAE,UAAU,CAAC;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCX,WAAW,CAAC,IAAI,EAAE;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;QACxC,QAAQ,EAAE,aAAa,CAAC;KACzB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCjB,iFAAiF;IACjF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,SAAS,UAAQ,GAAG,IAAI;IAWxF,yCAAyC;IACzC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI5D,8CAA8C;IAC9C,kBAAkB,IAAI,qBAAqB,GAAG,SAAS;IAIvD,mDAAmD;IACnD,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAI3D,gFAAgF;IAChF,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC,mEAAmE;IACnE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC,qEAAqE;IACrE,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIjD,8DAA8D;IAC9D,KAAK,IAAI,IAAI;IAIb,qEAAqE;IAC/D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAqDhC"}
|
|
@@ -37,6 +37,8 @@ export declare class DefaultExporter extends BaseExporter {
|
|
|
37
37
|
* Returns the flush promise when flushing so callers can await it.
|
|
38
38
|
*/
|
|
39
39
|
private handleBatchedFlush;
|
|
40
|
+
private sanitizeDropError;
|
|
41
|
+
private emitDrop;
|
|
40
42
|
/**
|
|
41
43
|
* Flush a batch of create events for a single signal type.
|
|
42
44
|
* On "not implemented" errors, disables the signal for future flushes.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/exporters/default.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,aAAa,
|
|
1
|
+
{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/exporters/default.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,aAAa,EAId,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAwB,sBAAsB,EAAwB,MAAM,sBAAsB,CAAC;AAS/G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,sFAAsF;AACtF,UAAU,qBAAsB,SAAQ,kBAAkB;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;CAC5C;AA6BD;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,YAAY;;IAC/C,IAAI,SAA2C;gBAgBnC,MAAM,GAAE,qBAA0B;IAiB9C;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDvD;;OAEG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;;;OAIG;YACW,kBAAkB;IAQhC,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,QAAQ;IAsBhB;;;;OAIG;YACW,YAAY;IA6B1B;;;OAGG;YACW,gBAAgB;IAoD9B;;;;;;;OAOG;YACW,WAAW;IAmHnB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D;;;;OAIG;YACW,WAAW;IAOzB;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYhC"}
|
|
@@ -33,10 +33,10 @@ export declare class EventBuffer {
|
|
|
33
33
|
private pushUpdate;
|
|
34
34
|
/** Route an event to the create or update buffer based on its type and the storage strategy. */
|
|
35
35
|
addEvent(event: ObservabilityEvent): void;
|
|
36
|
-
/** Re-add failed create events to the buffer,
|
|
37
|
-
reAddCreates(events: BufferedEvent[]):
|
|
38
|
-
/** Re-add failed update events to the buffer,
|
|
39
|
-
reAddUpdates(events: BufferedEvent[]):
|
|
36
|
+
/** Re-add failed create events to the buffer, returning events that exceed max retries. */
|
|
37
|
+
reAddCreates(events: BufferedEvent[]): BufferedEvent[];
|
|
38
|
+
/** Re-add failed update events to the buffer, returning events that exceed max retries. */
|
|
39
|
+
reAddUpdates(events: BufferedEvent[]): BufferedEvent[];
|
|
40
40
|
/** Snapshot of buffered create events. */
|
|
41
41
|
get creates(): BufferedEvent[];
|
|
42
42
|
/** Snapshot of buffered update events. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"event-buffer.d.ts","sourceRoot":"","sources":["../../src/exporters/event-buffer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7G,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,UAAU,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,WAAW;;gBASV,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;IAIxC,yEAAyE;IACzE,IAAI,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,4BAA4B,CAAA;KAAE,GAAG,IAAI;IAU5D,qEAAqE;IACrE,KAAK;IAML,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,UAAU;IAKlB,gGAAgG;IAChG,QAAQ,CAAC,KAAK,EAAE,kBAAkB;IAmDlC,
|
|
1
|
+
{"version":3,"file":"event-buffer.d.ts","sourceRoot":"","sources":["../../src/exporters/event-buffer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7G,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,UAAU,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,WAAW;;gBASV,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;IAIxC,yEAAyE;IACzE,IAAI,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,4BAA4B,CAAA;KAAE,GAAG,IAAI;IAU5D,qEAAqE;IACrE,KAAK;IAML,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,UAAU;IAKlB,gGAAgG;IAChG,QAAQ,CAAC,KAAK,EAAE,kBAAkB;IAmDlC,2FAA2F;IAC3F,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE;IAoBtD,2FAA2F;IAC3F,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE;IAoBtD,0CAA0C;IAC1C,IAAI,OAAO,IAAI,aAAa,EAAE,CAE7B;IAED,0CAA0C;IAC1C,IAAI,OAAO,IAAI,aAAa,EAAE,CAE7B;IAED,2DAA2D;IAC3D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,4EAA4E;IAC5E,IAAI,OAAO,IAAI,MAAM,CAKpB;IAED;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB,6FAA6F;IAC7F,eAAe,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,gBAAgB,EAAE,CAAA;KAAE,GAAG,IAAI;IAc5D,gFAAgF;IAChF,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO;IAI1C,uFAAuF;IACvF,gBAAgB,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;KAAE,GAAG,IAAI;CAS/D"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Feature flags for @mastra/observability
|
|
3
|
+
*
|
|
4
|
+
* Tracks which features are available in the current version of
|
|
5
|
+
* @mastra/observability. Downstream exporter packages (e.g.
|
|
6
|
+
* @mastra/datadog, @mastra/laminar) can check for feature availability
|
|
7
|
+
* before relying on a span shape, attribute, or hierarchy that this
|
|
8
|
+
* package may not yet emit.
|
|
9
|
+
*
|
|
10
|
+
* Pair these checks with `coreFeatures` from `@mastra/core/features` so a
|
|
11
|
+
* consumer only opts in when BOTH packages support the feature.
|
|
12
|
+
*
|
|
13
|
+
* @example Old-version-safe usage
|
|
14
|
+
*
|
|
15
|
+
* A static named import of `observabilityFeatures` will throw a link-time
|
|
16
|
+
* `SyntaxError` in strict Node ESM when paired with an `@mastra/observability`
|
|
17
|
+
* that predates this export. Use a dynamic import so the exporter degrades
|
|
18
|
+
* gracefully against any version of `@mastra/observability`:
|
|
19
|
+
*
|
|
20
|
+
* ```ts
|
|
21
|
+
* import { coreFeatures } from "@mastra/core/features"
|
|
22
|
+
*
|
|
23
|
+
* let observabilityFeatures: Set<string> | undefined
|
|
24
|
+
* try {
|
|
25
|
+
* ({ observabilityFeatures } = await import("@mastra/observability"))
|
|
26
|
+
* } catch {
|
|
27
|
+
* // older @mastra/observability that does not export this symbol
|
|
28
|
+
* }
|
|
29
|
+
*
|
|
30
|
+
* if (
|
|
31
|
+
* observabilityFeatures?.has("model-inference-span") &&
|
|
32
|
+
* coreFeatures.has("model-inference-span")
|
|
33
|
+
* ) {
|
|
34
|
+
* // safe
|
|
35
|
+
* }
|
|
36
|
+
* ```
|
|
37
|
+
*/
|
|
38
|
+
export declare const observabilityFeatures: ReadonlySet<string>;
|
|
39
|
+
//# sourceMappingURL=features.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAqC,CAAC"}
|