@mastra/observability 1.17.0-alpha.0 → 1.17.0

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

@@ -1,5 +1,5 @@
 import type { SpanOutputProcessor, AnySpan } from '@mastra/core/observability';
-export type RedactionStyle = 'full' | 'partial';
+export type RedactionStyle = 'full' | 'partial' | 'indexed';
 /**
  * Options for configuring the SensitiveDataFilter.
  */
@@ -21,6 +21,13 @@ export interface SensitiveDataFilterOptions {
      * Style of redaction to use:
      * - "full": always replace with redactionToken.
      * - "partial": show 3 characters from the start and end, redact the middle.
+     * - "indexed": replace each unique value with a stable token derived from the
+     *   matched field name, e.g. `[APIKEY_1]`. The same value maps to the same
+     *   token across the spans of a trace while the trace's mapping is retained,
+     *   so redacted values stay correlatable without exposing the raw value.
+     *   Mapping is scoped per trace and bounded: state is kept for the 1000 most
+     *   recently used traces, and each trace tracks up to 1000 unique values
+     *   (further new values fall back to the full redaction token).
      *
      * Default: "full"
      */
@@ -32,8 +39,10 @@ export interface SensitiveDataFilterOptions {
  * 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.
+ * - Sensitive values are redacted using full, partial, or indexed redaction.
  * - Partial redaction always keeps 3 chars at the start and end.
+ * - Indexed redaction assigns each unique value a stable `[LABEL_N]` token,
+ *   consistent across all spans of a trace.
  * - JSON strings containing sensitive fields are parsed and redacted.
  * - If filtering a field fails, the field is replaced with:
  *   `{ error: { processor: "sensitive-data-filter" } }`
@@ -43,6 +52,7 @@ export declare class SensitiveDataFilter implements SpanOutputProcessor {
     private sensitiveFields;
     private redactionToken;
     private redactionStyle;
+    private traceStates;
     constructor(options?: SensitiveDataFilterOptions);
     /**
      * Process a span by filtering sensitive data across its key fields.
@@ -52,6 +62,12 @@ export declare class SensitiveDataFilter implements SpanOutputProcessor {
      * @returns A new span with sensitive values redacted
      */
     process(span: AnySpan): AnySpan;
+    /**
+     * Get (or create) the indexed-redaction state for a trace.
+     * Uses the Map's insertion order as an LRU: accessed traces are re-inserted,
+     * and the least recently used trace is evicted once the cap is exceeded.
+     */
+    private getTraceState;
     /**
      * Recursively filter objects/arrays for sensitive keys.
      * Handles circular references by replacing with a marker.
@@ -83,8 +99,11 @@ export declare class SensitiveDataFilter implements SpanOutputProcessor {
      * Redact a sensitive value.
      * - Full style: replaces with a fixed token.
      * - Partial style: shows 3 chars at start and end, hides the middle.
+     * - Indexed style: replaces with a stable `[LABEL_N]` token, where the label
+     *   comes from the normalized field name and the same value always maps to
+     *   the same token within a trace.
      *
-     * Non-string values are converted to strings before partial redaction.
+     * Non-string values are converted to strings before partial or indexed redaction.
      */
     private redactValue;
     shutdown(): Promise<void>;

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

@@ -1 +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;IA8ClB,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"}
+{"version":3,"file":"sensitive-data-filter.d.ts","sourceRoot":"","sources":["../../src/span_processors/sensitive-data-filter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE/E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AA0B5D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;;;;;;;;;GAaG;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;IACvC,OAAO,CAAC,WAAW,CAA4C;gBAEnD,OAAO,GAAE,0BAA+B;IAyBpD;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAU/B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IA8ClB,OAAO,CAAC,SAAS;IAQjB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAOnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;;;;;;;;OASG;IACH,OAAO,CAAC,WAAW;IA8Bb,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/observability",
-  "version": "1.17.0-alpha.0",
+  "version": "1.17.0",
   "description": "Core observability package for Mastra - includes tracing and scoring features",
   "type": "module",
   "main": "dist/index.js",
@@ -32,11 +32,11 @@
     "typescript": "^6.0.3",
     "vitest": "4.1.10",
     "zod": "^4.4.3",
-    "@internal/ai-sdk-v4": "0.0.69",
-    "@internal/lint": "0.0.122",
-    "@internal/ai-sdk-v5": "0.0.69",
-    "@internal/types-builder": "0.0.97",
-    "@mastra/core": "1.59.0-alpha.0"
+    "@internal/lint": "0.0.123",
+    "@internal/types-builder": "0.0.98",
+    "@internal/ai-sdk-v4": "0.0.70",
+    "@internal/ai-sdk-v5": "0.0.70",
+    "@mastra/core": "1.59.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.16.0-0 <2.0.0-0",