@mastra/observability 0.0.0-main-test-2-20251127211532 → 0.0.0-partial-response-backport-20251204204441

package/dist/exporters/default.d.ts

@@ -1,89 +0,0 @@
-import type { TracingEvent, InitExporterOptions, TracingStorageStrategy } from '@mastra/core/observability';
-import type { BaseExporterConfig } from './base.js';
-import { BaseExporter } from './base.js';
-interface DefaultExporterConfig extends BaseExporterConfig {
-    maxBatchSize?: number;
-    maxBufferSize?: number;
-    maxBatchWaitMs?: number;
-    maxRetries?: number;
-    retryDelayMs?: number;
-    strategy?: TracingStorageStrategy | 'auto';
-}
-export declare class DefaultExporter extends BaseExporter {
-    #private;
-    name: string;
-    private buffer;
-    private allCreatedSpans;
-    constructor(config?: DefaultExporterConfig);
-    /**
-     * Initialize the exporter (called after all dependencies are ready)
-     */
-    init(options: InitExporterOptions): void;
-    /**
-     * Initialize the resolved strategy once storage is available
-     */
-    private initializeStrategy;
-    /**
-     * Builds a unique span key for tracking
-     */
-    private buildSpanKey;
-    /**
-     * Gets the next sequence number for a span
-     */
-    private getNextSequence;
-    /**
-     * Handles out-of-order span updates by logging and skipping
-     */
-    private handleOutOfOrderUpdate;
-    /**
-     * Adds an event to the appropriate buffer based on strategy
-     */
-    private addToBuffer;
-    /**
-     * Checks if buffer should be flushed based on size or time triggers
-     */
-    private shouldFlush;
-    /**
-     * Resets the buffer after successful flush
-     */
-    private resetBuffer;
-    /**
-     * Schedules a flush using setTimeout
-     */
-    private scheduleFlush;
-    /**
-     * Serializes span attributes to storage record format
-     * Handles all Span types and their specific attributes
-     */
-    private serializeAttributes;
-    private buildCreateRecord;
-    private buildUpdateRecord;
-    /**
-     * Handles realtime strategy - processes each event immediately
-     */
-    private handleRealtimeEvent;
-    /**
-     * Handles batch-with-updates strategy - buffers events and processes in batches
-     */
-    private handleBatchWithUpdatesEvent;
-    /**
-     * Handles insert-only strategy - only processes SPAN_ENDED events in batches
-     */
-    private handleInsertOnlyEvent;
-    /**
-     * Calculates retry delay using exponential backoff
-     */
-    private calculateRetryDelay;
-    /**
-     * Flushes the current buffer to storage with retry logic
-     */
-    private flush;
-    /**
-     * Attempts to flush with exponential backoff retry logic
-     */
-    private flushWithRetries;
-    _exportTracingEvent(event: TracingEvent): Promise<void>;
-    shutdown(): Promise<void>;
-}
-export {};
-//# sourceMappingURL=default.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/exporters/default.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EAEZ,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,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;AAwDD,qBAAa,eAAgB,SAAQ,YAAY;;IAC/C,IAAI,SAA2C;IAK/C,OAAO,CAAC,MAAM,CAAc;IAI5B,OAAO,CAAC,eAAe,CAA0B;gBAErC,MAAM,GAAE,qBAA0B;IAoC9C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAUxC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAgFnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,iBAAiB;IAczB;;OAEG;YACW,mBAAmB;IAyCjC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgBnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;YACW,KAAK;IAsDnB;;OAEG;YACW,gBAAgB;IA2DxB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBvD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBhC"}

package/dist/exporters/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * Mastra Tracing Exporters
- */
-export * from './base.js';
-export { CloudExporter } from './cloud.js';
-export type { CloudExporterConfig } from './cloud.js';
-export * from './console.js';
-export * from './default.js';
-export * from './test.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exporters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,QAAQ,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}

package/dist/exporters/test.d.ts

@@ -1,13 +0,0 @@
-import type { TracingEvent } from '@mastra/core/observability';
-import { BaseExporter } from './base.js';
-import type { BaseExporterConfig } from './base.js';
-export declare class TestExporter extends BaseExporter {
-    #private;
-    name: string;
-    constructor(config?: BaseExporterConfig);
-    protected _exportTracingEvent(event: TracingEvent): Promise<void>;
-    clearEvents(): void;
-    get events(): TracingEvent[];
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=test.d.ts.map

package/dist/exporters/test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/exporters/test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,qBAAa,YAAa,SAAQ,YAAY;;IAC5C,IAAI,SAA2B;gBAGnB,MAAM,GAAE,kBAAuB;cAI3B,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,WAAW;IAIX,IAAI,MAAM,IAAI,YAAY,EAAE,CAE3B;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/instances/base.d.ts

@@ -1,110 +0,0 @@
-/**
- * BaseObservability - Abstract base class for Observability implementations
- */
-import { MastraBase } from '@mastra/core/base';
-import type { RequestContext } from '@mastra/core/di';
-import type { IMastraLogger } from '@mastra/core/logger';
-import type { Span, SpanType, ObservabilityExporter, ObservabilityBridge, SpanOutputProcessor, TracingEvent, AnySpan, StartSpanOptions, CreateSpanOptions, ObservabilityInstance, CustomSamplerOptions, AnyExportedSpan, TraceState, TracingOptions } from '@mastra/core/observability';
-import type { ObservabilityInstanceConfig } from '../config.js';
-/**
- * Abstract base class for all Observability implementations in Mastra.
- */
-export declare abstract class BaseObservabilityInstance extends MastraBase implements ObservabilityInstance {
-    protected config: ObservabilityInstanceConfig;
-    constructor(config: ObservabilityInstanceConfig);
-    /**
-     * Override setLogger to add Observability specific initialization log
-     * and propagate logger to exporters and bridge
-     */
-    __setLogger(logger: IMastraLogger): void;
-    protected get exporters(): ObservabilityExporter[];
-    protected get spanOutputProcessors(): SpanOutputProcessor[];
-    /**
-     * Start a new span of a specific SpanType
-     */
-    startSpan<TType extends SpanType>(options: StartSpanOptions<TType>): Span<TType>;
-    /**
-     * Create a new span (called after sampling)
-     *
-     * Implementations should:
-     * 1. Create a plain span with the provided attributes
-     * 2. Return the span - base class handles all tracing lifecycle automatically
-     *
-     * The base class will automatically:
-     * - Set trace relationships
-     * - Wire span lifecycle callbacks
-     * - Emit span_started event
-     */
-    protected abstract createSpan<TType extends SpanType>(options: CreateSpanOptions<TType>): Span<TType>;
-    /**
-     * Get current configuration
-     */
-    getConfig(): Readonly<ObservabilityInstanceConfig>;
-    /**
-     * Get all exporters
-     */
-    getExporters(): readonly ObservabilityExporter[];
-    /**
-     * Get all span output processors
-     */
-    getSpanOutputProcessors(): readonly SpanOutputProcessor[];
-    /**
-     * Get the bridge instance if configured
-     */
-    getBridge(): ObservabilityBridge | undefined;
-    /**
-     * Get the logger instance (for exporters and other components)
-     */
-    getLogger(): IMastraLogger;
-    /**
-     * Automatically wires up Observability lifecycle events for any span
-     * This ensures all spans emit events regardless of implementation
-     */
-    private wireSpanLifecycle;
-    /**
-     * Check if a trace should be sampled
-     */
-    protected shouldSample(options?: CustomSamplerOptions): boolean;
-    /**
-     * Compute TraceState for a new trace based on configured and per-request keys
-     */
-    protected computeTraceState(tracingOptions?: TracingOptions): TraceState | undefined;
-    /**
-     * Extract metadata from RequestContext using TraceState
-     */
-    protected extractMetadataFromRequestContext(requestContext: RequestContext | undefined, explicitMetadata: Record<string, any> | undefined, traceState: TraceState | undefined): Record<string, any> | undefined;
-    /**
-     * Extract specific keys from RequestContext
-     */
-    protected extractKeys(requestContext: RequestContext, keys: string[]): Record<string, any>;
-    /**
-     * Process a span through all output processors
-     */
-    private processSpan;
-    getSpanForExport(span: AnySpan): AnyExportedSpan | undefined;
-    /**
-     * Emit a span started event
-     */
-    protected emitSpanStarted(span: AnySpan): void;
-    /**
-     * Emit a span ended event (called automatically when spans end)
-     */
-    protected emitSpanEnded(span: AnySpan): void;
-    /**
-     * Emit a span updated event
-     */
-    protected emitSpanUpdated(span: AnySpan): void;
-    /**
-     * Export tracing event through all exporters and bridge (realtime mode)
-     */
-    protected exportTracingEvent(event: TracingEvent): Promise<void>;
-    /**
-     * Initialize Observability (called by Mastra during component registration)
-     */
-    init(): void;
-    /**
-     * Shutdown Observability and clean up resources
-     */
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=base.d.ts.map

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

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

package/dist/instances/default.d.ts

@@ -1,8 +0,0 @@
-import type { SpanType, Span, CreateSpanOptions } from '@mastra/core/observability';
-import type { ObservabilityInstanceConfig } from '../config.js';
-import { BaseObservabilityInstance } from './base.js';
-export declare class DefaultObservabilityInstance extends BaseObservabilityInstance {
-    constructor(config: ObservabilityInstanceConfig);
-    protected createSpan<TType extends SpanType>(options: CreateSpanOptions<TType>): Span<TType>;
-}
-//# sourceMappingURL=default.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/instances/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AAEnD,qBAAa,4BAA6B,SAAQ,yBAAyB;gBAC7D,MAAM,EAAE,2BAA2B;IAI/C,SAAS,CAAC,UAAU,CAAC,KAAK,SAAS,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;CAI7F"}

package/dist/instances/index.d.ts

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,48 +0,0 @@
-/**
- * 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, EndSpanOptions, ErrorSpanOptions, TracingContext, UpdateSpanOptions } from '@mastra/core/observability';
-/**
- * Manages MODEL_STEP and MODEL_CHUNK span tracking for streaming Model responses.
- *
- * Should be instantiated once per MODEL_GENERATION span and shared across
- * all streaming steps (including after tool calls).
- */
-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
-     */
-    endGeneration(options?: EndSpanOptions<SpanType.MODEL_GENERATION>): 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

@@ -1 +0,0 @@
-{"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,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAGpC;;;;;GAKG;AACH,qBAAa,gBAAgB;;gBAQf,SAAS,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAIvD;;;OAGG;IACH,iBAAiB,IAAI,cAAc;IAMnC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAIjF;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAIxE;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI;IA4O7E;;;;;OAKG;IACH,UAAU,CAAC,CAAC,SAAS;QAAE,WAAW,EAAE,QAAQ,CAAA;KAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC;CAyE9D"}

package/dist/registry.d.ts

@@ -1,49 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,85 +0,0 @@
-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.
- * - 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.
-     */
-    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;
-    /**
-     * 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

@@ -1 +0,0 @@
-{"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;;;;;;;;;;GAUG;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;;;OAGG;IACH,OAAO,CAAC,UAAU;IAgClB,OAAO,CAAC,SAAS;IAQjB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAOnB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAab,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/spans/base.d.ts

@@ -1,109 +0,0 @@
-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>;
-    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

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

package/dist/spans/default.d.ts

@@ -1,13 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,7 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,15 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}