@mastra/observability 1.9.1 → 1.9.2-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @mastra/observability
 
+## 1.9.2-alpha.1
+
+### Patch Changes
+
+- Improved tracing overhead when filtering spans. Spans dropped by `excludeSpanTypes` or the internal-span filter (`includeInternalSpans: false`) now skip payload serialization and retention entirely instead of paying the cost and discarding at export time. ([#15487](https://github.com/mastra-ai/mastra/pull/15487))
+
+- Updated dependencies [[`6315317`](https://github.com/mastra-ai/mastra/commit/63153175fe9a7b224e5be7c209bbebc01dd9b0d5), [`9d3b24b`](https://github.com/mastra-ai/mastra/commit/9d3b24b19407ae9c09586cf7766d38dc4dff4a69)]:
+  - @mastra/core@1.26.0-alpha.6
+
+## 1.9.2-alpha.0
+
+### Patch Changes
+
+- Fixed span serialization replacing tool parameter JSON schemas with lossy summaries like `"unknown (required)"`. JSON schemas in span data are now preserved as-is, keeping full type information for debugging in observability tools like Datadog. Also fixed MODEL_STEP span input showing only a keys summary instead of actual messages for AI SDK v5 providers. ([#15404](https://github.com/mastra-ai/mastra/pull/15404))
+
+- Fixed CloudExporter to default to observability.mastra.ai for Mastra platform exports. ([#15418](https://github.com/mastra-ai/mastra/pull/15418))
+
+- Updated dependencies [[`3d83d06`](https://github.com/mastra-ai/mastra/commit/3d83d06f776f00fb5f4163dddd32a030c5c20844), [`7e0e63e`](https://github.com/mastra-ai/mastra/commit/7e0e63e2e485e84442351f4c7a79a424c83539dc), [`9467ea8`](https://github.com/mastra-ai/mastra/commit/9467ea87695749a53dfc041576410ebf9ee7bb67), [`7338d94`](https://github.com/mastra-ai/mastra/commit/7338d949380cf68b095342e8e42610dc51d557c1)]:
+  - @mastra/core@1.26.0-alpha.2
+
 ## 1.9.1
 
 ### Patch Changes

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

@@ -1 +1 @@
-{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../../src/exporters/cloud.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EAEZ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA+LD,qBAAa,aAAc,SAAQ,YAAY;IAC7C,IAAI,SAAyC;IAE7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAA4B;gBAEvC,MAAM,GAAE,mBAAwB;cAgE5B,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjE,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1C,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1D,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,cAAc;YAMR,mBAAmB;IAYjC,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,aAAa;YAoBP,WAAW;IAoDzB;;OAEG;YACW,WAAW;YAuBX,gBAAgB;IA+B9B,OAAO,CAAC,WAAW;IAUnB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAiChC"}
+{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../../src/exporters/cloud.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EAEZ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA6LD,qBAAa,aAAc,SAAQ,YAAY;IAC7C,IAAI,SAAyC;IAE7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAA4B;gBAEvC,MAAM,GAAE,mBAAwB;cAgE5B,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjE,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1C,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1D,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,cAAc;YAMR,mBAAmB;IAYjC,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,aAAa;YAoBP,WAAW;IAoDzB;;OAEG;YACW,WAAW;YAuBX,gBAAgB;IA+B9B,OAAO,CAAC,WAAW;IAUnB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAiChC"}

package/dist/index.cjs

@@ -15058,7 +15058,6 @@ var SIGNAL_PUBLISH_SEGMENTS = {
   scores: "scores",
   feedback: "feedback"
 };
-var DEFAULT_CLOUD_ENDPOINT = "https://api.mastra.ai";
 function trimTrailingSlashes(value) {
   let end = value.length;
   while (end > 0 && value.charCodeAt(end - 1) === 47) {
@@ -15187,7 +15186,7 @@ var CloudExporter = class extends BaseExporter {
     if (tracesEndpointOverride) {
       tracesEndpoint = resolveExplicitSignalEndpoint("traces", tracesEndpointOverride, projectId);
     } else {
-      baseEndpoint = resolveBaseEndpoint(config2.endpoint ?? DEFAULT_CLOUD_ENDPOINT);
+      baseEndpoint = resolveBaseEndpoint(config2.endpoint ?? "https://observability.mastra.ai");
       tracesEndpoint = buildSignalEndpoint(baseEndpoint, "traces", projectId);
     }
     const resolveConfiguredSignalEndpoint = (signal, explicitEndpoint) => {
@@ -17436,51 +17435,6 @@ function isJsonSchema(val) {
   }
   return false;
 }
-function compressJsonSchema(schema, depth = 0) {
-  if (depth > 3) {
-    return schema.type || "object";
-  }
-  const compositionKeys = ["oneOf", "anyOf", "allOf"].filter((key) => Array.isArray(schema[key]));
-  if (compositionKeys.length > 0) {
-    const compressed2 = {};
-    for (const key of compositionKeys) {
-      compressed2[key] = schema[key].map((entry) => compressJsonSchema(entry, depth + 1));
-    }
-    if (typeof schema.type === "string") {
-      compressed2.type = schema.type;
-    }
-    return compressed2;
-  }
-  if (schema.type !== "object" || !schema.properties) {
-    return schema.type || schema;
-  }
-  const required2 = new Set(Array.isArray(schema.required) ? schema.required : []);
-  const compressed = {};
-  for (const [key, propSchema] of Object.entries(schema.properties)) {
-    const prop = propSchema;
-    let value = prop.type || "unknown";
-    if (prop.type === "object" && prop.properties) {
-      value = compressJsonSchema(prop, depth + 1);
-      if (required2.has(key)) {
-        compressed[key + " (required)"] = value;
-        continue;
-      }
-    } else if (prop.type === "array" && prop.items) {
-      if (prop.items.type === "object" && prop.items.properties) {
-        value = [compressJsonSchema(prop.items, depth + 1)];
-      } else {
-        value = `${prop.items.type || "any"}[]`;
-      }
-    } else if (prop.enum) {
-      value = prop.enum.map((v) => JSON.stringify(v)).join(" | ");
-    }
-    if (required2.has(key) && typeof value === "string") {
-      value += " (required)";
-    }
-    compressed[key] = value;
-  }
-  return compressed;
-}
 function deepClean(value, options = DEFAULT_DEEP_CLEAN_OPTIONS) {
   const { keysToStrip, maxDepth, maxStringLength, maxArrayLength, maxObjectKeys } = options;
   const stripSet = keysToStrip instanceof Set ? keysToStrip : new Set(Array.isArray(keysToStrip) ? keysToStrip : Object.keys(keysToStrip));
@@ -17660,11 +17614,7 @@ function deepClean(value, options = DEFAULT_DEEP_CLEAN_OPTIONS) {
         looksLikeJsonSchema = false;
       }
       if (looksLikeJsonSchema) {
-        try {
-          const compressed = compressJsonSchema(val);
-          return compressed === val ? "[JSONSchema]" : helper(compressed, depth);
-        } catch {
-        }
+        return val;
       }
       const cleaned = {};
       const keys = Object.keys(val).filter((key) => !stripSet.has(key));
@@ -18767,6 +18717,9 @@ function summarizeRequestBody(body) {
   if (Array.isArray(body.messages)) {
     return normalizeMessages(body.messages);
   }
+  if (Array.isArray(body.input)) {
+    return normalizeMessages(body.input);
+  }
   if (Array.isArray(body.contents)) {
     return body.contents.map((item) => ({
       role: typeof item?.role === "string" ? item.role : "user",
@@ -19286,32 +19239,58 @@ var BaseSpan = class {
   parentSpanId;
   /** Deep clean options for serialization */
   deepCleanOptions;
+  /**
+   * Whether this span is filtered out before export. When true, BaseSpan/
+   * DefaultSpan skip attaching attributes/input/output/errorInfo/requestContext
+   * entirely -- they are never read on excluded spans, and skipping avoids
+   * both the deepClean cost and holding references to large payloads for
+   * the lifetime of the span. Set when excludeSpanTypes drops the type,
+   * when the span is internal and includeInternalSpans is false, or when
+   * the subclass is always excluded (e.g., NoOpSpan).
+   *
+   * Note: metadata is still attached and deepCleaned because it is read in
+   * process by getCorrelationContext() and by getLoggerContext() /
+   * getMetricsContext() (which structuredClone it).
+   */
+  isExcluded;
   /** Cached canonical correlation context for this live span */
   correlationContext;
+  /**
+   * Subclasses can override to unconditionally mark the span as excluded.
+   * NoOpSpan uses this because it is never exported regardless of config.
+   */
+  get alwaysExcluded() {
+    return false;
+  }
   constructor(options, observabilityInstance) {
-    const serializationOptions = observabilityInstance.getConfig().serializationOptions;
-    this.deepCleanOptions = mergeSerializationOptions(serializationOptions);
+    const observabilityConfig = observabilityInstance.getConfig();
+    this.deepCleanOptions = mergeSerializationOptions(observabilityConfig.serializationOptions);
     this.name = options.name;
     this.type = options.type;
-    this.attributes = deepClean(options.attributes, this.deepCleanOptions) || {};
+    this.isInternal = isSpanInternal(this.type, options.tracingPolicy?.internal);
+    this.isExcluded = this.alwaysExcluded || observabilityConfig.excludeSpanTypes?.includes(this.type) === true || this.isInternal && !observabilityConfig.includeInternalSpans;
     this.metadata = deepClean(
       options.parent?.metadata || options.metadata ? { ...options.parent?.metadata, ...options.metadata } : void 0,
       this.deepCleanOptions
     );
-    if (options.requestContext && options.requestContext.size() > 0) {
-      this.requestContext = deepClean(options.requestContext.all, this.deepCleanOptions);
-    }
     this.parent = options.parent;
     this.startTime = options.startTime ?? /* @__PURE__ */ new Date();
     this.observabilityInstance = observabilityInstance;
     this.isEvent = options.isEvent ?? false;
-    this.isInternal = isSpanInternal(this.type, options.tracingPolicy?.internal);
     this.traceState = options.traceState;
     this.tags = !options.parent && options.tags?.length ? options.tags : void 0;
     const entityParent = this.getParentSpan(false);
     this.entityType = options.entityType ?? entityParent?.entityType;
     this.entityId = options.entityId ?? entityParent?.entityId;
     this.entityName = options.entityName ?? entityParent?.entityName;
+    if (this.isExcluded) {
+      this.attributes = {};
+      return;
+    }
+    this.attributes = deepClean(options.attributes, this.deepCleanOptions) || {};
+    if (options.requestContext && options.requestContext.size() > 0) {
+      this.requestContext = deepClean(options.requestContext.all, this.deepCleanOptions);
+    }
     if (this.isEvent) {
       this.output = deepClean(options.output, this.deepCleanOptions);
     } else {
@@ -19515,46 +19494,51 @@ var DefaultSpan = class extends BaseSpan {
       return;
     }
     this.endTime = /* @__PURE__ */ new Date();
+    if (options?.metadata) {
+      this.metadata = { ...this.metadata, ...deepClean(options.metadata, this.deepCleanOptions) };
+    }
+    if (this.isExcluded) {
+      return;
+    }
     if (options?.output !== void 0) {
       this.output = deepClean(options.output, this.deepCleanOptions);
     }
     if (options?.attributes) {
       this.attributes = { ...this.attributes, ...deepClean(options.attributes, this.deepCleanOptions) };
     }
-    if (options?.metadata) {
-      this.metadata = { ...this.metadata, ...deepClean(options.metadata, this.deepCleanOptions) };
-    }
   }
   error(options) {
     if (this.isEvent) {
       return;
     }
     const { error: error48, endSpan = true, attributes, metadata } = options;
-    this.errorInfo = deepClean(
-      error48 instanceof error$1.MastraError ? {
-        id: error48.id,
-        details: error48.details,
-        category: error48.category,
-        domain: error48.domain,
-        message: error48.message,
-        name: error48.name,
-        // Prefer the original cause's stack when available. MastraError wraps
-        // thrown errors, so its own stack points to the wrapping site rather
-        // than where the underlying error was thrown.
-        stack: error48.cause instanceof Error && error48.cause.stack || error48.stack
-      } : {
-        message: error48.message,
-        name: error48.name,
-        stack: error48.stack
-      },
-      this.deepCleanOptions
-    );
-    if (attributes) {
-      this.attributes = { ...this.attributes, ...deepClean(attributes, this.deepCleanOptions) };
-    }
     if (metadata) {
       this.metadata = { ...this.metadata, ...deepClean(metadata, this.deepCleanOptions) };
     }
+    if (!this.isExcluded) {
+      this.errorInfo = deepClean(
+        error48 instanceof error$1.MastraError ? {
+          id: error48.id,
+          details: error48.details,
+          category: error48.category,
+          domain: error48.domain,
+          message: error48.message,
+          name: error48.name,
+          // Prefer the original cause's stack when available. MastraError wraps
+          // thrown errors, so its own stack points to the wrapping site rather
+          // than where the underlying error was thrown.
+          stack: error48.cause instanceof Error && error48.cause.stack || error48.stack
+        } : {
+          message: error48.message,
+          name: error48.name,
+          stack: error48.stack
+        },
+        this.deepCleanOptions
+      );
+      if (attributes) {
+        this.attributes = { ...this.attributes, ...deepClean(attributes, this.deepCleanOptions) };
+      }
+    }
     if (endSpan) {
       this.end();
     } else {
@@ -19568,6 +19552,12 @@ var DefaultSpan = class extends BaseSpan {
     if (options.name !== void 0) {
       this.name = options.name;
     }
+    if (options.metadata) {
+      this.metadata = { ...this.metadata, ...deepClean(options.metadata, this.deepCleanOptions) };
+    }
+    if (this.isExcluded) {
+      return;
+    }
     if (options.input !== void 0) {
       this.input = deepClean(options.input, this.deepCleanOptions);
     }
@@ -19577,9 +19567,6 @@ var DefaultSpan = class extends BaseSpan {
     if (options.attributes) {
       this.attributes = { ...this.attributes, ...deepClean(options.attributes, this.deepCleanOptions) };
     }
-    if (options.metadata) {
-      this.metadata = { ...this.metadata, ...deepClean(options.metadata, this.deepCleanOptions) };
-    }
   }
   get isValid() {
     return true;
@@ -19655,6 +19642,10 @@ var NoOpSpan = class extends BaseSpan {
   get isValid() {
     return false;
   }
+  // NoOpSpan is never exported, so treat it as always excluded.
+  get alwaysExcluded() {
+    return true;
+  }
 };
 
 // src/instances/base.ts