@scoutqa/mastra-core 0.24.6-fork.1

package/dist/ai-tracing/index.cjs

@@ -0,0 +1,148 @@
+'use strict';
+
+var chunkIAJHRFO4_cjs = require('../chunk-IAJHRFO4.cjs');
+
+
+
+Object.defineProperty(exports, "AISpanType", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.AISpanType; }
+});
+Object.defineProperty(exports, "AITracingEventType", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.AITracingEventType; }
+});
+Object.defineProperty(exports, "BaseAISpan", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.BaseAISpan; }
+});
+Object.defineProperty(exports, "BaseAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.BaseAITracing; }
+});
+Object.defineProperty(exports, "BaseExporter", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.BaseExporter; }
+});
+Object.defineProperty(exports, "CloudExporter", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.CloudExporter; }
+});
+Object.defineProperty(exports, "ConsoleExporter", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.ConsoleExporter; }
+});
+Object.defineProperty(exports, "DefaultAISpan", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.DefaultAISpan; }
+});
+Object.defineProperty(exports, "DefaultAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.DefaultAITracing; }
+});
+Object.defineProperty(exports, "DefaultExporter", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.DefaultExporter; }
+});
+Object.defineProperty(exports, "InternalSpans", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.InternalSpans; }
+});
+Object.defineProperty(exports, "ModelSpanTracker", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.ModelSpanTracker; }
+});
+Object.defineProperty(exports, "NoOpAISpan", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.NoOpAISpan; }
+});
+Object.defineProperty(exports, "SamplingStrategyType", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.SamplingStrategyType; }
+});
+Object.defineProperty(exports, "SensitiveDataFilter", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.SensitiveDataFilter; }
+});
+Object.defineProperty(exports, "clearAITracingRegistry", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.clearAITracingRegistry; }
+});
+Object.defineProperty(exports, "deepClean", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.deepClean; }
+});
+Object.defineProperty(exports, "getAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.getAITracing; }
+});
+Object.defineProperty(exports, "getAllAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.getAllAITracing; }
+});
+Object.defineProperty(exports, "getDefaultAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.getDefaultAITracing; }
+});
+Object.defineProperty(exports, "getNestedValue", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.getNestedValue; }
+});
+Object.defineProperty(exports, "getOrCreateSpan", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.getOrCreateSpan; }
+});
+Object.defineProperty(exports, "getSelectedAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.getSelectedAITracing; }
+});
+Object.defineProperty(exports, "getValidTraceId", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.getValidTraceId; }
+});
+Object.defineProperty(exports, "hasAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.hasAITracing; }
+});
+Object.defineProperty(exports, "isMastra", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.isMastra; }
+});
+Object.defineProperty(exports, "omitKeys", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.omitKeys; }
+});
+Object.defineProperty(exports, "registerAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.registerAITracing; }
+});
+Object.defineProperty(exports, "selectFields", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.selectFields; }
+});
+Object.defineProperty(exports, "setNestedValue", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.setNestedValue; }
+});
+Object.defineProperty(exports, "setSelector", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.setSelector; }
+});
+Object.defineProperty(exports, "setupAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.setupAITracing; }
+});
+Object.defineProperty(exports, "shutdownAITracingRegistry", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.shutdownAITracingRegistry; }
+});
+Object.defineProperty(exports, "unregisterAITracing", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.unregisterAITracing; }
+});
+Object.defineProperty(exports, "wrapMastra", {
+  enumerable: true,
+  get: function () { return chunkIAJHRFO4_cjs.wrapMastra; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/ai-tracing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/ai-tracing/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Mastra AI Tracing
+ */
+export * from './spans/index.js';
+export * from './tracers/index.js';
+export * from './types.js';
+export * from './registry.js';
+export * from './utils.js';
+export * from './context.js';
+export * from './exporters/index.js';
+export * from './span_processors/index.js';
+export * from './model-tracing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-tracing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/ai-tracing/index.js

@@ -0,0 +1,3 @@
+export { AISpanType, AITracingEventType, BaseAISpan, BaseAITracing, BaseExporter, CloudExporter, ConsoleExporter, DefaultAISpan, DefaultAITracing, DefaultExporter, InternalSpans, ModelSpanTracker, NoOpAISpan, SamplingStrategyType, SensitiveDataFilter, clearAITracingRegistry, deepClean, getAITracing, getAllAITracing, getDefaultAITracing, getNestedValue, getOrCreateSpan, getSelectedAITracing, getValidTraceId, hasAITracing, isMastra, omitKeys, registerAITracing, selectFields, setNestedValue, setSelector, setupAITracing, shutdownAITracingRegistry, unregisterAITracing, wrapMastra } from '../chunk-WIMFJ2BA.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/ai-tracing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

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

@@ -0,0 +1,63 @@
+/**
+ * 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 type { MastraError } from '../error/index.js';
+import { AISpanType } from './types.js';
+import type { AISpan, AnyAISpan, ModelGenerationAttributes } from './types.js';
+/**
+ * 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?: AISpan<AISpanType.MODEL_GENERATION>);
+    /**
+     * Get the tracing context for creating child spans.
+     * Returns the current step span if active, otherwise the model span.
+     */
+    getTracingContext(): {
+        currentSpan?: AnyAISpan;
+    };
+    /**
+     * Report an error on the generation span
+     */
+    reportGenerationError(options: {
+        error: MastraError | Error;
+        endSpan?: boolean;
+    }): void;
+    /**
+     * End the generation span
+     */
+    endGeneration(options?: {
+        output?: any;
+        attributes?: Partial<ModelGenerationAttributes>;
+        metadata?: Record<string, any>;
+    }): void;
+    /**
+     * Update the generation span
+     */
+    updateGeneration(options: {
+        input?: any;
+        output?: any;
+        attributes?: Partial<ModelGenerationAttributes>;
+        metadata?: Record<string, any>;
+    }): 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/ai-tracing/model-tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-tracing.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/model-tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAE5E;;;;;GAKG;AACH,qBAAa,gBAAgB;;gBAQf,SAAS,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAI3D;;;OAGG;IACH,iBAAiB,IAAI;QAAE,WAAW,CAAC,EAAE,SAAS,CAAA;KAAE;IAMhD;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAIvF;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE;QACtB,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,UAAU,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAChD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GAAG,IAAI;IAIR;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE;QACxB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,UAAU,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAChD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GAAG,IAAI;IA4OR;;;;;OAKG;IACH,UAAU,CAAC,CAAC,SAAS;QAAE,WAAW,EAAE,QAAQ,CAAA;KAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC;CAyE9D"}

package/dist/ai-tracing/registry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AI Tracing Registry for Mastra
+ *
+ * Provides a global registry for AI tracing instances.
+ */
+import type { AITracing, ConfigSelectorOptions, ConfigSelector, ObservabilityRegistryConfig } from './types.js';
+/**
+ * Register an AI tracing instance globally
+ */
+export declare function registerAITracing(name: string, instance: AITracing, isDefault?: boolean): void;
+/**
+ * Get an AI tracing instance from the registry
+ */
+export declare function getAITracing(name: string): AITracing | undefined;
+/**
+ * Get the default AI tracing instance
+ */
+export declare function getDefaultAITracing(): AITracing | undefined;
+/**
+ * Set the AI tracing config selector
+ */
+export declare function setSelector(selector: ConfigSelector): void;
+/**
+ * Get the selected AI tracing instance based on options
+ */
+export declare function getSelectedAITracing(options: ConfigSelectorOptions): AITracing | undefined;
+/**
+ * Unregister an AI tracing instance
+ */
+export declare function unregisterAITracing(name: string): boolean;
+/**
+ * Shutdown all AI tracing instances and clear the registry
+ */
+export declare function shutdownAITracingRegistry(): Promise<void>;
+/**
+ * Clear all AI tracing instances without shutdown
+ */
+export declare function clearAITracingRegistry(): void;
+/**
+ * Get all registered AI tracing instances
+ */
+export declare function getAllAITracing(): ReadonlyMap<string, AITracing>;
+/**
+ * Check if AI tracing is available and enabled
+ */
+export declare function hasAITracing(name: string): boolean;
+/**
+ * Setup AI tracing from the ObservabilityRegistryConfig
+ */
+export declare function setupAITracing(config: ObservabilityRegistryConfig): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/ai-tracing/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACV,SAAS,EACT,qBAAqB,EACrB,cAAc,EAEd,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AA2GjB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,UAAQ,GAAG,IAAI,CAE5F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,GAAG,SAAS,CAE3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,GAAG,SAAS,CAE1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASlD;AASD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,2BAA2B,GAAG,IAAI,CA+CxE"}

package/dist/ai-tracing/span_processors/index.d.ts

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

package/dist/ai-tracing/span_processors/index.d.ts.map

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

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

@@ -0,0 +1,85 @@
+import type { AISpanProcessor, AnyAISpan } from '../types.js';
+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 AISpanProcessor 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 AISpanProcessor {
+    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: AnyAISpan): AnyAISpan;
+    /**
+     * 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/ai-tracing/span_processors/sensitive-data-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitive-data-filter.d.ts","sourceRoot":"","sources":["../../../src/ai-tracing/span_processors/sensitive-data-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE3D,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,eAAe;IACzD,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,SAAS,GAAG,SAAS;IASnC;;;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/ai-tracing/spans/base.d.ts

@@ -0,0 +1,65 @@
+import type { AISpan, AISpanTypeMap, AnyAISpan, ChildSpanOptions, ChildEventOptions, EndSpanOptions, ErrorSpanOptions, UpdateSpanOptions, CreateSpanOptions, AITracing, ExportedAISpan, TraceState } from '../types.js';
+import { AISpanType } from '../types.js';
+export declare abstract class BaseAISpan<TType extends AISpanType = any> implements AISpan<TType> {
+    abstract id: string;
+    abstract traceId: string;
+    name: string;
+    type: TType;
+    attributes: AISpanTypeMap[TType];
+    parent?: AnyAISpan;
+    startTime: Date;
+    endTime?: Date;
+    isEvent: boolean;
+    isInternal: boolean;
+    aiTracing: AITracing;
+    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>, aiTracing: AITracing);
+    /** 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<TChildType extends AISpanType>(options: ChildSpanOptions<TChildType>): AISpan<TChildType>;
+    createEventSpan<TChildType extends AISpanType>(options: ChildEventOptions<TChildType>): AISpan<TChildType>;
+    /** 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 AISpanType>(spanType: T): AISpan<T> | undefined;
+    /** Returns a lightweight span ready for export */
+    exportSpan(includeInternalSpans?: boolean): ExportedAISpan<TType>;
+}
+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/ai-tracing/spans/base.d.ts.map

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

package/dist/ai-tracing/spans/default.d.ts

@@ -0,0 +1,13 @@
+import type { AISpanType, AITracing, EndSpanOptions, ErrorSpanOptions, UpdateSpanOptions, CreateSpanOptions } from '../types.js';
+import { BaseAISpan } from './base.js';
+export declare class DefaultAISpan<TType extends AISpanType> extends BaseAISpan<TType> {
+    id: string;
+    traceId: string;
+    constructor(options: CreateSpanOptions<TType>, aiTracing: AITracing);
+    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/ai-tracing/spans/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/ai-tracing/spans/default.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAa,MAAM,QAAQ,CAAC;AAE/C,qBAAa,aAAa,CAAC,KAAK,SAAS,UAAU,CAAE,SAAQ,UAAU,CAAC,KAAK,CAAC;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS;IAmCnE,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/ai-tracing/spans/index.d.ts

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

package/dist/ai-tracing/spans/index.d.ts.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * No Op Implementation for MastraAITracing
+ */
+import type { AITracing, AISpanType, CreateSpanOptions, EndSpanOptions, UpdateSpanOptions, ErrorSpanOptions } from '../types.js';
+import { BaseAISpan } from './base.js';
+export declare class NoOpAISpan<TType extends AISpanType = any> extends BaseAISpan<TType> {
+    id: string;
+    traceId: string;
+    constructor(options: CreateSpanOptions<TType>, aiTracing: AITracing);
+    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/ai-tracing/spans/no-op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op.d.ts","sourceRoot":"","sources":["../../../src/ai-tracing/spans/no-op.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,qBAAa,UAAU,CAAC,KAAK,SAAS,UAAU,GAAG,GAAG,CAAE,SAAQ,UAAU,CAAC,KAAK,CAAC;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS;IAMnE,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/ai-tracing/tracers/base.d.ts

@@ -0,0 +1,105 @@
+/**
+ * MastraAITracing - Abstract base class for AI Tracing implementations
+ */
+import { MastraBase } from '../../base.js';
+import type { IMastraLogger } from '../../logger/index.js';
+import type { RuntimeContext } from '../../runtime-context/index.js';
+import type { TracingConfig, AISpan, AISpanType, AITracingExporter, AISpanProcessor, AITracingEvent, AnyAISpan, StartSpanOptions, CreateSpanOptions, AITracing, CustomSamplerOptions, AnyExportedAISpan, TraceState, TracingOptions } from '../types.js';
+/**
+ * Abstract base class for all AI Tracing implementations in Mastra.
+ */
+export declare abstract class BaseAITracing extends MastraBase implements AITracing {
+    protected config: Required<TracingConfig>;
+    constructor(config: TracingConfig);
+    /**
+     * Override setLogger to add AI tracing specific initialization log
+     * and propagate logger to exporters
+     */
+    __setLogger(logger: IMastraLogger): void;
+    protected get exporters(): AITracingExporter[];
+    protected get processors(): AISpanProcessor[];
+    /**
+     * Start a new span of a specific AISpanType
+     */
+    startSpan<TType extends AISpanType>(options: StartSpanOptions<TType>): AISpan<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 AISpanType>(options: CreateSpanOptions<TType>): AISpan<TType>;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Readonly<Required<TracingConfig>>;
+    /**
+     * Get all exporters
+     */
+    getExporters(): readonly AITracingExporter[];
+    /**
+     * Get all processors
+     */
+    getProcessors(): readonly AISpanProcessor[];
+    /**
+     * Get the logger instance (for exporters and other components)
+     */
+    getLogger(): IMastraLogger;
+    /**
+     * Automatically wires up AI tracing lifecycle events for any span
+     * This ensures all spans emit events regardless of implementation
+     */
+    private wireSpanLifecycle;
+    /**
+     * Check if an AI 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 RuntimeContext using TraceState
+     */
+    protected extractMetadataFromRuntimeContext(runtimeContext: RuntimeContext | undefined, explicitMetadata: Record<string, any> | undefined, traceState: TraceState | undefined): Record<string, any> | undefined;
+    /**
+     * Extract specific keys from RuntimeContext
+     */
+    protected extractKeys(runtimeContext: RuntimeContext, keys: string[]): Record<string, any>;
+    /**
+     * Process a span through all processors
+     */
+    private processSpan;
+    getSpanForExport(span: AnyAISpan): AnyExportedAISpan | undefined;
+    /**
+     * Emit a span started event
+     */
+    protected emitSpanStarted(span: AnyAISpan): void;
+    /**
+     * Emit a span ended event (called automatically when spans end)
+     */
+    protected emitSpanEnded(span: AnyAISpan): void;
+    /**
+     * Emit a span updated event
+     */
+    protected emitSpanUpdated(span: AnyAISpan): void;
+    /**
+     * Export tracing event through all exporters (realtime mode)
+     */
+    protected exportEvent(event: AITracingEvent): Promise<void>;
+    /**
+     * Initialize AI tracing (called by Mastra during component registration)
+     */
+    init(): void;
+    /**
+     * Shutdown AI tracing and clean up resources
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/ai-tracing/tracers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/ai-tracing/tracers/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EACV,aAAa,EACb,MAAM,EACN,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,SAAS,EAGT,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACf,MAAM,UAAU,CAAC;AAQlB;;GAEG;AACH,8BAAsB,aAAc,SAAQ,UAAW,YAAW,SAAS;IACzE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;gBAE9B,MAAM,EAAE,aAAa;IAejC;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,aAAa;IAoBjC,SAAS,KAAK,SAAS,IAAI,iBAAiB,EAAE,CAE7C;IAED,SAAS,KAAK,UAAU,IAAI,eAAe,EAAE,CAE5C;IAMD;;OAEG;IACH,SAAS,CAAC,KAAK,SAAS,UAAU,EAAE,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IA4CpF;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,SAAS,UAAU,EAAE,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IAMzG;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAQ9C;;OAEG;IACH,YAAY,IAAI,SAAS,iBAAiB,EAAE;IAI5C;;OAEG;IACH,aAAa,IAAI,SAAS,eAAe,EAAE;IAI3C;;OAEG;IACH,SAAS;IAQT;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkCzB;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO;IAwB/D;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,UAAU,GAAG,SAAS;IAgBpF;;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,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,SAAS;IAQhE;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAShD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAS9C;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAShD;;OAEG;cACa,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjE;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAUhC"}

package/dist/ai-tracing/tracers/default.d.ts

@@ -0,0 +1,7 @@
+import type { AISpanType, AISpan, TracingConfig, CreateSpanOptions } from '../types.js';
+import { BaseAITracing } from './base.js';
+export declare class DefaultAITracing extends BaseAITracing {
+    constructor(config: TracingConfig);
+    protected createSpan<TType extends AISpanType>(options: CreateSpanOptions<TType>): AISpan<TType>;
+}
+//# sourceMappingURL=default.d.ts.map

package/dist/ai-tracing/tracers/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/ai-tracing/tracers/default.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,MAAM,EAAE,aAAa;IAIjC,SAAS,CAAC,UAAU,CAAC,KAAK,SAAS,UAAU,EAAE,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;CAIjG"}