@mastra/observability 0.0.0-sidebar-window-undefined-fix-20251029233656 → 0.0.0-top-level-fix-20251211103030

package/dist/instances/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mastra Observability Instances
+ */
+export * from './base.js';
+export * from './default.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instances/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

package/dist/model-tracing.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Model Span Tracing
+ *
+ * Provides span tracking for Model generations, including:
+ * - MODEL_STEP spans (one per Model API call)
+ * - MODEL_CHUNK spans (individual streaming chunks within a step)
+ *
+ * Hierarchy: MODEL_GENERATION -> MODEL_STEP -> MODEL_CHUNK
+ */
+import { SpanType } from '@mastra/core/observability';
+import type { Span, EndGenerationOptions, ErrorSpanOptions, TracingContext, UpdateSpanOptions } from '@mastra/core/observability';
+export declare class ModelSpanTracker {
+    #private;
+    constructor(modelSpan?: Span<SpanType.MODEL_GENERATION>);
+    /**
+     * Get the tracing context for creating child spans.
+     * Returns the current step span if active, otherwise the model span.
+     */
+    getTracingContext(): TracingContext;
+    /**
+     * Report an error on the generation span
+     */
+    reportGenerationError(options: ErrorSpanOptions<SpanType.MODEL_GENERATION>): void;
+    /**
+     * End the generation span with optional raw usage data.
+     * If usage is provided, it will be converted to UsageStats with cache token details.
+     */
+    endGeneration(options?: EndGenerationOptions): void;
+    /**
+     * Update the generation span
+     */
+    updateGeneration(options: UpdateSpanOptions<SpanType.MODEL_GENERATION>): void;
+    /**
+     * Wraps a stream with model tracing transform to track MODEL_STEP and MODEL_CHUNK spans.
+     *
+     * This should be added to the stream pipeline to automatically
+     * create MODEL_STEP and MODEL_CHUNK spans for each semantic unit in the stream.
+     */
+    wrapStream<T extends {
+        pipeThrough: Function;
+    }>(stream: T): T;
+}
+//# sourceMappingURL=model-tracing.d.ts.map

package/dist/model-tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-tracing.d.ts","sourceRoot":"","sources":["../src/model-tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,KAAK,EACV,IAAI,EACJ,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAuBpC,qBAAa,gBAAgB;;gBAaf,SAAS,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAcvD;;;OAGG;IACH,iBAAiB,IAAI,cAAc;IAMnC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAIjF;;;OAGG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAWnD;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI;IA+V7E;;;;;OAKG;IACH,UAAU,CAAC,CAAC,SAAS;QAAE,WAAW,EAAE,QAAQ,CAAA;KAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC;CAwG9D"}

package/dist/registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Observability Registry for Mastra
+ *
+ * Provides registry for Observability instances.
+ */
+import type { ObservabilityInstance, ConfigSelectorOptions, ConfigSelector } from '@mastra/core/observability';
+/**
+ * Registry for Observability instances.
+ */
+export declare class ObservabilityRegistry {
+    #private;
+    /**
+     * Register a tracing instance
+     */
+    register(name: string, instance: ObservabilityInstance, isDefault?: boolean): void;
+    /**
+     * Get a tracing instance by name
+     */
+    get(name: string): ObservabilityInstance | undefined;
+    /**
+     * Get the default tracing instance
+     */
+    getDefault(): ObservabilityInstance | undefined;
+    /**
+     * Set the tracing selector function
+     */
+    setSelector(selector: ConfigSelector): void;
+    /**
+     * Get the selected tracing instance based on context
+     */
+    getSelected(options: ConfigSelectorOptions): ObservabilityInstance | undefined;
+    /**
+     * Unregister a tracing instance
+     */
+    unregister(name: string): boolean;
+    /**
+     * Shutdown all instances and clear the registry
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Clear all instances without shutdown
+     */
+    clear(): void;
+    /**
+     * list all registered instances
+     */
+    list(): ReadonlyMap<string, ObservabilityInstance>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAM/G;;GAEG;AACH,qBAAa,qBAAqB;;IAKhC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,SAAS,UAAQ,GAAG,IAAI;IAahF;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAIpD;;OAEG;IACH,UAAU,IAAI,qBAAqB,GAAG,SAAS;IAI/C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAI3C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,qBAAqB,GAAG,SAAS;IAa9E;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAYjC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,IAAI,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC;CAGnD"}

package/dist/span_processors/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Mastra Span Processors
+ */
+export * from './sensitive-data-filter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/span_processors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAC"}

package/dist/span_processors/sensitive-data-filter.d.ts

@@ -0,0 +1,92 @@
+import type { SpanOutputProcessor, AnySpan } from '@mastra/core/observability';
+export type RedactionStyle = 'full' | 'partial';
+/**
+ * Options for configuring the SensitiveDataFilter.
+ */
+export interface SensitiveDataFilterOptions {
+    /**
+     * List of sensitive field names to redact.
+     * Matching is case-insensitive and normalizes separators (`api-key`, `api_key`, `Api Key` → `apikey`).
+     *
+     * Defaults include: password, token, secret, key, apikey, auth, authorization,
+     * bearer, bearertoken, jwt, credential, clientsecret, privatekey, refresh, ssn.
+     */
+    sensitiveFields?: string[];
+    /**
+     * The token used for full redaction.
+     * Default: "[REDACTED]"
+     */
+    redactionToken?: string;
+    /**
+     * Style of redaction to use:
+     * - "full": always replace with redactionToken.
+     * - "partial": show 3 characters from the start and end, redact the middle.
+     *
+     * Default: "full"
+     */
+    redactionStyle?: RedactionStyle;
+}
+/**
+ * SensitiveDataFilter
+ *
+ * An SpanOutputProcessor that redacts sensitive information from span fields.
+ *
+ * - Sensitive keys are matched case-insensitively, normalized to remove separators.
+ * - Sensitive values are redacted using either full or partial redaction.
+ * - Partial redaction always keeps 3 chars at the start and end.
+ * - JSON strings containing sensitive fields are parsed and redacted.
+ * - If filtering a field fails, the field is replaced with:
+ *   `{ error: { processor: "sensitive-data-filter" } }`
+ */
+export declare class SensitiveDataFilter implements SpanOutputProcessor {
+    name: string;
+    private sensitiveFields;
+    private redactionToken;
+    private redactionStyle;
+    constructor(options?: SensitiveDataFilterOptions);
+    /**
+     * Process a span by filtering sensitive data across its key fields.
+     * Fields processed: attributes, metadata, input, output, errorInfo.
+     *
+     * @param span - The input span to filter
+     * @returns A new span with sensitive values redacted
+     */
+    process(span: AnySpan): AnySpan;
+    /**
+     * Recursively filter objects/arrays for sensitive keys.
+     * Handles circular references by replacing with a marker.
+     * Also attempts to parse and redact JSON strings.
+     */
+    private deepFilter;
+    private tryFilter;
+    /**
+     * Normalize keys by lowercasing and stripping non-alphanumeric characters.
+     * Ensures consistent matching for variants like "api-key", "api_key", "Api Key".
+     */
+    private normalizeKey;
+    /**
+     * Check whether a normalized key exactly matches any sensitive field.
+     * Both key and sensitive fields are normalized by removing all non-alphanumeric
+     * characters and converting to lowercase before comparison.
+     *
+     * Examples:
+     * - "api_key", "api-key", "ApiKey" all normalize to "apikey" → MATCHES "apikey"
+     * - "promptTokens", "prompt_tokens" normalize to "prompttokens" → DOES NOT MATCH "token"
+     */
+    private isSensitive;
+    /**
+     * Attempt to parse a string as JSON and redact sensitive fields within it.
+     * If parsing fails or no sensitive data is found, returns the original string.
+     */
+    private redactJsonString;
+    /**
+     * Redact a sensitive value.
+     * - Full style: replaces with a fixed token.
+     * - Partial style: shows 3 chars at start and end, hides the middle.
+     *
+     * Non-string values are converted to strings before partial redaction.
+     */
+    private redactValue;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=sensitive-data-filter.d.ts.map

package/dist/span_processors/sensitive-data-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitive-data-filter.d.ts","sourceRoot":"","sources":["../../src/span_processors/sensitive-data-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE/E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,IAAI,SAA2B;IAC/B,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAiB;gBAE3B,OAAO,GAAE,0BAA+B;IAyBpD;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAS/B;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAwClB,OAAO,CAAC,SAAS;IAQjB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAOnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAab,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/spans/base.d.ts

@@ -0,0 +1,110 @@
+import type { Span, SpanTypeMap, AnySpan, ChildSpanOptions, ChildEventOptions, EndSpanOptions, ErrorSpanOptions, UpdateSpanOptions, CreateSpanOptions, ObservabilityInstance, ExportedSpan, TraceState, IModelSpanTracker, AIModelGenerationSpan } from '@mastra/core/observability';
+import { SpanType } from '@mastra/core/observability';
+/**
+ * Get the external parent span ID from CreateSpanOptions.
+ *
+ * If the parent is internal, walks up the parent chain to find
+ * the closest external ancestor. If the parent is already external,
+ * returns its ID directly.
+ *
+ * This is useful when exporting spans to external observability systems
+ * that shouldn't include internal framework spans.
+ *
+ * @param options - Span creation options
+ * @returns The external parent span ID, or undefined if no external parent exists
+ *
+ * @example
+ * ```typescript
+ * // Parent is external - returns parent.id
+ * const externalParent = { id: 'span-123', isInternal: false };
+ * const options = { parent: externalParent, ... };
+ * getExternalParentId(options); // 'span-123'
+ *
+ * // Parent is internal - walks up to find external ancestor
+ * const externalGrandparent = { id: 'span-456', isInternal: false };
+ * const internalParent = { id: 'span-123', isInternal: true, parent: externalGrandparent };
+ * const options = { parent: internalParent, ... };
+ * getExternalParentId(options); // 'span-456'
+ * ```
+ */
+export declare function getExternalParentId(options: CreateSpanOptions<any>): string | undefined;
+export declare abstract class BaseSpan<TType extends SpanType = any> implements Span<TType> {
+    abstract id: string;
+    abstract traceId: string;
+    name: string;
+    type: TType;
+    attributes: SpanTypeMap[TType];
+    parent?: AnySpan;
+    startTime: Date;
+    endTime?: Date;
+    isEvent: boolean;
+    isInternal: boolean;
+    observabilityInstance: ObservabilityInstance;
+    input?: any;
+    output?: any;
+    errorInfo?: {
+        message: string;
+        id?: string;
+        domain?: string;
+        category?: string;
+        details?: Record<string, any>;
+    };
+    metadata?: Record<string, any>;
+    tags?: string[];
+    traceState?: TraceState;
+    /** Parent span ID (for root spans that are children of external spans) */
+    protected parentSpanId?: string;
+    constructor(options: CreateSpanOptions<TType>, observabilityInstance: ObservabilityInstance);
+    /** End the span */
+    abstract end(options?: EndSpanOptions<TType>): void;
+    /** Record an error for the span, optionally end the span as well */
+    abstract error(options: ErrorSpanOptions<TType>): void;
+    /** Update span attributes */
+    abstract update(options: UpdateSpanOptions<TType>): void;
+    createChildSpan(options: ChildSpanOptions<SpanType.MODEL_GENERATION>): AIModelGenerationSpan;
+    createEventSpan<TChildType extends SpanType>(options: ChildEventOptions<TChildType>): Span<TChildType>;
+    /**
+     * Create a ModelSpanTracker for this span (only works if this is a MODEL_GENERATION span)
+     * Returns undefined for non-MODEL_GENERATION spans
+     */
+    createTracker(): IModelSpanTracker | undefined;
+    /** Returns `TRUE` if the span is the root span of a trace */
+    get isRootSpan(): boolean;
+    /** Returns `TRUE` if the span is a valid span (not a NO-OP Span) */
+    abstract get isValid(): boolean;
+    /** Get the closest parent spanId that isn't an internal span */
+    getParentSpanId(includeInternalSpans?: boolean): string | undefined;
+    /** Find the closest parent span of a specific type by walking up the parent chain */
+    findParent<T extends SpanType>(spanType: T): Span<T> | undefined;
+    /** Returns a lightweight span ready for export */
+    exportSpan(includeInternalSpans?: boolean): ExportedSpan<TType>;
+    get externalTraceId(): string | undefined;
+    /**
+     * Execute an async function within this span's tracing context.
+     * Delegates to the bridge if available.
+     */
+    executeInContext<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute a synchronous function within this span's tracing context.
+     * Delegates to the bridge if available.
+     */
+    executeInContextSync<T>(fn: () => T): T;
+}
+export interface DeepCleanOptions {
+    keysToStrip?: Set<string>;
+    maxDepth?: number;
+}
+/**
+ * Recursively cleans a value by removing circular references and stripping problematic or sensitive keys.
+ * Circular references are replaced with "[Circular]". Unserializable values are replaced with error messages.
+ * Keys like "logger" and "tracingContext" are stripped by default.
+ * A maximum recursion depth is enforced to avoid stack overflow or excessive memory usage.
+ *
+ * @param value - The value to clean (object, array, primitive, etc.)
+ * @param options - Optional configuration:
+ *   - keysToStrip: Set of keys to remove from objects (default: logger, tracingContext)
+ *   - maxDepth: Maximum recursion depth before values are replaced with "[MaxDepth]" (default: 10)
+ * @returns A cleaned version of the input with circular references, specified keys, and overly deep values handled
+ */
+export declare function deepClean(value: any, options?: DeepCleanOptions, _seen?: WeakSet<any>, _depth?: number): any;
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/spans/base.ts"],"names":[],"mappings":"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"}

package/dist/spans/default.d.ts

@@ -0,0 +1,13 @@
+import type { SpanType, ObservabilityInstance, EndSpanOptions, ErrorSpanOptions, UpdateSpanOptions, CreateSpanOptions } from '@mastra/core/observability';
+import { BaseSpan } from './base.js';
+export declare class DefaultSpan<TType extends SpanType> extends BaseSpan<TType> {
+    id: string;
+    traceId: string;
+    constructor(options: CreateSpanOptions<TType>, observabilityInstance: ObservabilityInstance);
+    end(options?: EndSpanOptions<TType>): void;
+    error(options: ErrorSpanOptions<TType>): void;
+    update(options: UpdateSpanOptions<TType>): void;
+    get isValid(): boolean;
+    export(): Promise<string>;
+}
+//# sourceMappingURL=default.d.ts.map

package/dist/spans/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/spans/default.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAa,MAAM,QAAQ,CAAC;AAE7C,qBAAa,WAAW,CAAC,KAAK,SAAS,QAAQ,CAAE,SAAQ,QAAQ,CAAC,KAAK,CAAC;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,qBAAqB,EAAE,qBAAqB;IAqC3F,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IAiB1C,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI;IAoC7C,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI;IAoB/C,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAUhC"}

package/dist/spans/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Mastra Spans
+ */
+export * from './base.js';
+export * from './default.js';
+export * from './no-op.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spans/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/spans/no-op.d.ts

@@ -0,0 +1,15 @@
+/**
+ * NoOpSpan Implementation for Mastra Observability
+ */
+import type { ObservabilityInstance, SpanType, CreateSpanOptions, EndSpanOptions, UpdateSpanOptions, ErrorSpanOptions } from '@mastra/core/observability';
+import { BaseSpan } from './base.js';
+export declare class NoOpSpan<TType extends SpanType = any> extends BaseSpan<TType> {
+    id: string;
+    traceId: string;
+    constructor(options: CreateSpanOptions<TType>, observabilityInstance: ObservabilityInstance);
+    end(_options?: EndSpanOptions<TType>): void;
+    error(_options: ErrorSpanOptions<TType>): void;
+    update(_options: UpdateSpanOptions<TType>): void;
+    get isValid(): boolean;
+}
+//# sourceMappingURL=no-op.d.ts.map

package/dist/spans/no-op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op.d.ts","sourceRoot":"","sources":["../../src/spans/no-op.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,qBAAa,QAAQ,CAAC,KAAK,SAAS,QAAQ,GAAG,GAAG,CAAE,SAAQ,QAAQ,CAAC,KAAK,CAAC;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,qBAAqB,EAAE,qBAAqB;IAM3F,GAAG,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IAE3C,KAAK,CAAC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI;IAE9C,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI;IAEhD,IAAI,OAAO,IAAI,OAAO,CAErB;CACF"}

package/dist/tracing-options.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Composable Tracing Options Builder
+ */
+import type { TracingOptions } from '@mastra/core/observability';
+/**
+ * A function that updates TracingOptions.
+ */
+export type TracingOptionsUpdater = (options: TracingOptions) => TracingOptions;
+/**
+ * Builds TracingOptions by composing one or more updater functions.
+ *
+ * @example
+ * ```typescript
+ * import { buildTracingOptions } from '@mastra/observability';
+ * import { withLangfusePrompt } from '@mastra/langfuse';
+ *
+ * const prompt = await langfuse.getPrompt('my-prompt');
+ *
+ * const agent = new Agent({
+ *   defaultGenerateOptions: {
+ *     tracingOptions: buildTracingOptions(withLangfusePrompt(prompt)),
+ *   },
+ * });
+ * ```
+ */
+export declare function buildTracingOptions(...updaters: TracingOptionsUpdater[]): TracingOptions;
+//# sourceMappingURL=tracing-options.d.ts.map

package/dist/tracing-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-options.d.ts","sourceRoot":"","sources":["../src/tracing-options.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,cAAc,CAAC;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,QAAQ,EAAE,qBAAqB,EAAE,GAAG,cAAc,CAExF"}

package/dist/usage.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Usage extraction utilities for converting AI SDK usage to Mastra UsageStats
+ */
+import type { UsageStats } from '@mastra/core/observability';
+import type { LanguageModelUsage, ProviderMetadata } from '@mastra/core/stream';
+/**
+ * Extracts and normalizes token usage from AI SDK response, including
+ * provider-specific cache tokens from providerMetadata.
+ *
+ * Handles:
+ * - OpenAI: cachedInputTokens in usage object
+ * - Anthropic: cacheCreationInputTokens, cacheReadInputTokens in providerMetadata.anthropic
+ * - Google/Gemini: cachedContentTokenCount, thoughtsTokenCount in providerMetadata.google.usageMetadata
+ * - OpenRouter: Uses OpenAI-compatible structure (cache tokens in usage)
+ *
+ * @param usage - The LanguageModelV2Usage from AI SDK response
+ * @param providerMetadata - Optional provider-specific metadata
+ * @returns UsageStats with inputDetails and outputDetails
+ */
+export declare function extractUsageMetrics(usage?: LanguageModelUsage, providerMetadata?: ProviderMetadata): UsageStats;
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

@@ -0,0 +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;AAoBhF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,UAAU,CA4E/G"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mastra/observability",
-  "version": "0.0.0-sidebar-window-undefined-fix-20251029233656",
-  "description": "Core observability package for Mastra - includes AI tracing and scoring features",
+  "version": "0.0.0-top-level-fix-20251211103030",
+  "description": "Core observability package for Mastra - includes tracing and scoring features",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,20 +23,26 @@
     "./package.json": "./package.json"
   },
   "license": "Apache-2.0",
-  "dependencies": {},
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.8",
-    "@types/node": "^20.19.0",
+    "@types/node": "22.13.17",
+    "@vitest/coverage-v8": "4.0.12",
+    "@vitest/ui": "4.0.12",
+    "ai": "^4.3.16",
+    "ai-v5": "npm:ai@5.0.97",
     "eslint": "^9.37.0",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4",
-    "@internal/lint": "0.0.0-sidebar-window-undefined-fix-20251029233656",
-    "@mastra/core": "0.0.0-sidebar-window-undefined-fix-20251029233656",
-    "@internal/types-builder": "0.0.0-sidebar-window-undefined-fix-20251029233656"
+    "vitest": "4.0.12",
+    "@internal/types-builder": "0.0.0-top-level-fix-20251211103030",
+    "@mastra/core": "0.0.0-top-level-fix-20251211103030",
+    "@internal/lint": "0.0.0-top-level-fix-20251211103030"
+  },
+  "dependencies": {
+    "zod": "^3.25.76"
   },
   "peerDependencies": {
-    "@mastra/core": "0.0.0-sidebar-window-undefined-fix-20251029233656"
+    "@mastra/core": "0.0.0-top-level-fix-20251211103030"
   },
   "homepage": "https://mastra.ai",
   "repository": {
@@ -47,6 +53,9 @@
   "bugs": {
     "url": "https://github.com/mastra-ai/mastra/issues"
   },
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "build": "tsup --silent --config tsup.config.ts",
     "build:watch": "pnpm build --watch",