@mastra/observability 1.5.1 → 1.6.0-alpha.0

package/dist/instances/base.d.ts

@@ -96,19 +96,6 @@ export declare abstract class BaseObservabilityInstance extends MastraBase imple
      * to registered exporters based on event type.
      */
     getObservabilityBus(): ObservabilityBus;
-    /**
-     * Extract entity context labels from a span's entity hierarchy by
-     * walking the parent chain.
-     *
-     * Returns labels for: entity_type/name, parent_type/name, root_type/name.
-     * Internal spans are skipped when resolving parent and root entities.
-     */
-    private extractEntityLabels;
-    /**
-     * Resolve tags for a span. Uses the span's own tags if present,
-     * otherwise walks to the root span to inherit its tags.
-     */
-    private resolveSpanTags;
     /**
      * Get a LoggerContext correlated to a span.
      * Called by the context-factory in core (deriveLoggerContext) so that
@@ -116,7 +103,7 @@ export declare abstract class BaseObservabilityInstance extends MastraBase imple
      */
     getLoggerContext(span?: AnySpan): LoggerContext;
     /**
-     * Get a MetricsContext, optionally tagged from a span's entity info.
+     * Get a MetricsContext correlated to a span.
      * Called by the context-factory in core (deriveMetricsContext) so that
      * `observabilityContext.metrics` is a real metrics context instead of no-op.
      */
@@ -156,28 +143,25 @@ export declare abstract class BaseObservabilityInstance extends MastraBase imple
     getSpanForExport(span: AnySpan): AnyExportedSpan | undefined;
     /**
      * Emit a span started event.
-     * Routes through the ObservabilityBus so exporters receive it via onTracingEvent
-     * and auto-extracted metrics are generated.
+     * Routes through the ObservabilityBus so exporters receive it via onTracingEvent.
      */
     protected emitSpanStarted(span: AnySpan): void;
     /**
      * Emit a span ended event (called automatically when spans end).
-     * Routes through the ObservabilityBus so exporters receive it via onTracingEvent
-     * and auto-extracted metrics are generated.
+     * Emits any auto-extracted metrics while the live span tree is still available,
+     * then routes the exported tracing event through the ObservabilityBus.
      */
     protected emitSpanEnded(span: AnySpan): void;
     /**
      * Emit a span updated event.
-     * Routes through the ObservabilityBus so exporters receive it via onTracingEvent
-     * and auto-extracted metrics are generated.
+     * Routes through the ObservabilityBus so exporters receive it via onTracingEvent.
      */
     protected emitSpanUpdated(span: AnySpan): void;
     /**
      * Emit a tracing event through the bus.
      *
      * The bus routes the event to each registered exporter's and bridge's
-     * onTracingEvent handler and triggers auto-extracted metrics (e.g.,
-     * mastra_agent_duration_ms, mastra_model_duration_ms).
+     * onTracingEvent handler.
      */
     private emitTracingEvent;
     /**

package/dist/instances/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/instances/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EACV,IAAI,EACJ,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,OAAO,EAGP,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACT,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AAI7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D;;GAEG;AACH,8BAAsB,yBAA0B,SAAQ,UAAW,YAAW,qBAAqB;IACjG,SAAS,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE9C;;;OAGG;IACH,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAE7C;;OAEG;IACH,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;gBAEnC,MAAM,EAAE,2BAA2B;IAuC/C;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,aAAa;IAyBjC,SAAS,KAAK,SAAS,IAAI,qBAAqB,EAAE,CAEjD;IAED,SAAS,KAAK,oBAAoB,IAAI,mBAAmB,EAAE,CAE1D;IAMD;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,KAAK,SAAS,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAqEhF;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,KAAK,SAAS,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IA2B7E;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,SAAS,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAMrG;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,2BAA2B,CAAC;IAQlD;;OAEG;IACH,YAAY,IAAI,SAAS,qBAAqB,EAAE;IAIhD;;OAEG;IACH,uBAAuB,IAAI,SAAS,mBAAmB,EAAE;IAIzD;;OAEG;IACH,SAAS,IAAI,mBAAmB,GAAG,SAAS;IAI5C;;OAEG;IACH,SAAS;IAIT;;;;OAIG;IACH,mBAAmB,IAAI,gBAAgB;IAQvC;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa;IAuB/C;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc;IAgBjD;;;;OAIG;IACH,SAAS,CAAC,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAQjE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkCzB;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO;IA0B/D;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,UAAU,GAAG,SAAS;IAsBpF;;OAEG;IACH,SAAS,CAAC,iCAAiC,CACzC,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACjD,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAkBlC;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA2B1F;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB,mGAAmG;IACnG,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS;IAQ5D;;;;OAIG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAQ9C;;;;OAIG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAQ5C;;;;OAIG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAQ9C;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;;;OAKG;cACa,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BtE;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;;;;;;;;OASG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAyBhC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/instances/base.ts"],"names":[],"mappings":"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"}

package/dist/metrics/auto-extract.d.ts

@@ -1,31 +1,11 @@
 /**
- * AutoExtractedMetrics - Converts TracingEvents into MetricEvents automatically.
- *
- * When a tracing span ends, this class emits metric events for duration
- * and token usage (for model spans).
+ * Emits metrics derived from live spans.
  */
-import type { TracingEvent } from '@mastra/core/observability';
-import type { ObservabilityBus } from '../bus/index.js';
-/**
- * Converts tracing span lifecycle events into metric events automatically.
- * Emits duration metrics for agent, tool, workflow, and model spans, plus
- * token usage metrics for model generation spans.
- */
-export declare class AutoExtractedMetrics {
-    private observabilityBus;
-    constructor(observabilityBus: ObservabilityBus);
-    /**
-     * Route a tracing event to the appropriate handler.
-     * SPAN_ENDED emits duration and token metrics (for model spans).
-     */
-    processTracingEvent(event: TracingEvent): void;
-    /** Emit duration and token metrics when a span ends. */
-    private onSpanEnded;
-    /** Build base metric labels from a span's entity and model attributes. */
-    private extractLabels;
-    /** Emit token usage metrics from UsageStats. */
-    private extractTokenMetrics;
-    /** Map a span type to its `*_duration_ms` metric name, or `null` for unsupported types. */
-    private getDurationMetricName;
-}
+import type { AnySpan, MetricsContext } from '@mastra/core/observability';
+/** Emit duration metrics for a live span. */
+export declare function emitDurationMetrics(span: AnySpan, metrics: MetricsContext): void;
+/** Emit token usage metrics for a model-generation span. */
+export declare function emitTokenMetrics(span: AnySpan, metrics: MetricsContext): void;
+/** Emit all auto-extracted metrics for a live span end. */
+export declare function emitAutoExtractedMetrics(span: AnySpan, metrics: MetricsContext): void;
 //# sourceMappingURL=auto-extract.d.ts.map

package/dist/metrics/auto-extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-extract.d.ts","sourceRoot":"","sources":["../../src/metrics/auto-extract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA0D,MAAM,4BAA4B,CAAC;AAEvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAEtD;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAM9C,wDAAwD;IACxD,OAAO,CAAC,WAAW;IAqBnB,0EAA0E;IAC1E,OAAO,CAAC,aAAa;IAiBrB,gDAAgD;IAChD,OAAO,CAAC,mBAAmB;IA4B3B,2FAA2F;IAC3F,OAAO,CAAC,qBAAqB;CAc9B"}
+{"version":3,"file":"auto-extract.d.ts","sourceRoot":"","sources":["../../src/metrics/auto-extract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAe,cAAc,EAA6B,MAAM,4BAA4B,CAAC;AAKlH,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAUhF;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAW7E;AAED,2DAA2D;AAC3D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAGrF"}

package/dist/metrics/estimator.d.ts

@@ -0,0 +1,9 @@
+import type { CostContext, UsageStats } from '@mastra/core/observability';
+import { PricingRegistry } from './pricing-registry.js';
+import { TokenMetrics } from './types.js';
+export declare function estimateCosts(args: {
+    provider: string;
+    model: string;
+    usage: UsageStats;
+}, pricingRegistry?: PricingRegistry | null): Map<TokenMetrics, CostContext>;
+//# sourceMappingURL=estimator.d.ts.map

package/dist/metrics/estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimator.d.ts","sourceRoot":"","sources":["../../src/metrics/estimator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAC;AAGrD,wBAAgB,aAAa,CAC3B,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;CACnB,EACD,eAAe,GAAE,eAAe,GAAG,IAAkC,GACpE,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,CAyIhC"}

package/dist/metrics/index.d.ts

@@ -2,5 +2,4 @@
  * Metrics implementations for observability.
  */
 export { CardinalityFilter } from './cardinality.js';
-export { AutoExtractedMetrics } from './auto-extract.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/metrics/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}