@mastra/observability 1.9.1-alpha.1 → 1.9.1

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # @mastra/observability
 
+## 1.9.1
+
+### Patch Changes
+
+- Fixed double-counting of Anthropic cache tokens in usage metrics ([#15316](https://github.com/mastra-ai/mastra/pull/15316))
+
+- Cost estimates now use the latest model pricing rates for more accurate calculations ([#15362](https://github.com/mastra-ai/mastra/pull/15362))
+
+- Update references to "Mastra Cloud" to "Mastra platform" ([#15297](https://github.com/mastra-ai/mastra/pull/15297))
+
+- Reduced observability overhead for `MODEL_STEP` spans by storing a lightweight message preview of request bodies. ([#15249](https://github.com/mastra-ai/mastra/pull/15249))
+
+  This keeps span previews readable and avoids pulling large payloads into exporter input.
+
+- Fixed cost lookup for models with date suffixes. Providers like OpenAI often return model names with date suffixes (e.g., `gpt-5.4-mini-2026-03-17`) that don't exactly match pricing data entries. The lookup now tries multiple variants including stripping date suffixes and converting dots to dashes. ([#15349](https://github.com/mastra-ai/mastra/pull/15349))
+
+- Added `entityVersionId`, `parentEntityVersionId`, and `rootEntityVersionId` to span correlation context, enabling version information to propagate to scores, metrics, logs, and feedback emitted during traced execution. ([#15317](https://github.com/mastra-ai/mastra/pull/15317))
+
+- Fixed stack traces for errors reported to Sentry. Exceptions now point to the code that threw the error instead of `SentryExporter.handleSpanEnded` inside the exporter, so issues in Sentry are actually debuggable. ([#15343](https://github.com/mastra-ai/mastra/pull/15343))
+
+  This was caused by two issues, both fixed:
+  - `@mastra/sentry` passed the error message as a string to `Sentry.captureException`, which made Sentry synthesize a stack trace from the exporter's call site. It now passes an `Error` instance with the captured stack attached.
+  - `@mastra/observability` stored the wrapping `MastraError`'s stack on the span, hiding the original error's location. When the `MastraError` has a cause, the cause's stack is now preserved.
+
+  Fixes [#15337](https://github.com/mastra-ai/mastra/issues/15337).
+
+- Updated dependencies [[`87df955`](https://github.com/mastra-ai/mastra/commit/87df955c028660c075873fd5d74af28233ce32eb), [`8fad147`](https://github.com/mastra-ai/mastra/commit/8fad14759804179c8e080ce4d9dec6ef1a808b31), [`582644c`](https://github.com/mastra-ai/mastra/commit/582644c4a87f83b4f245a84d72b9e8590585012e), [`cbdf3e1`](https://github.com/mastra-ai/mastra/commit/cbdf3e12b3d0c30a6e5347be658e2009648c130a), [`8fe46d3`](https://github.com/mastra-ai/mastra/commit/8fe46d354027f3f0f0846e64219772348de106dd), [`18c67db`](https://github.com/mastra-ai/mastra/commit/18c67dbb9c9ebc26f26f65f7d3ff836e5691ef46), [`4ba3bb1`](https://github.com/mastra-ai/mastra/commit/4ba3bb1e465ad2ddaba3bbf2bc47e0faec32985e), [`5d84914`](https://github.com/mastra-ai/mastra/commit/5d84914e0e520c642a40329b210b413fcd139898), [`8dcc77e`](https://github.com/mastra-ai/mastra/commit/8dcc77e78a5340f5848f74b9e9f1b3da3513c1f5), [`aa67fc5`](https://github.com/mastra-ai/mastra/commit/aa67fc59ee8a5eeff1f23eb05970b8d7a536c8ff), [`fd2f314`](https://github.com/mastra-ai/mastra/commit/fd2f31473d3449b6b97e837ef8641264377f41a7), [`fa8140b`](https://github.com/mastra-ai/mastra/commit/fa8140bcd4251d2e3ac85fdc5547dfc4f372b5be), [`190f452`](https://github.com/mastra-ai/mastra/commit/190f45258b0640e2adfc8219fa3258cdc5b8f071), [`e80fead`](https://github.com/mastra-ai/mastra/commit/e80fead1412cc0d1b2f7d6a1ce5017d9e0098ff7), [`0287b64`](https://github.com/mastra-ai/mastra/commit/0287b644a5c3272755cf3112e71338106664103b), [`7e7bf60`](https://github.com/mastra-ai/mastra/commit/7e7bf606886bf374a6f9d4ca9b09dd83d0533372), [`184907d`](https://github.com/mastra-ai/mastra/commit/184907d775d8609c03c26e78ccaf37315f3aa287), [`075e91a`](https://github.com/mastra-ai/mastra/commit/075e91a4549baf46ad7a42a6a8ac8dfa78cc09e6), [`0c4cd13`](https://github.com/mastra-ai/mastra/commit/0c4cd131931c04ac5405373c932a242dbe88edd6), [`b16a753`](https://github.com/mastra-ai/mastra/commit/b16a753d5748440248d7df82e29bb987a9c8386c)]:
+  - @mastra/core@1.25.0
+
+## 1.9.1-alpha.2
+
+### Patch Changes
+
+- Cost estimates now use the latest model pricing rates for more accurate calculations ([#15362](https://github.com/mastra-ai/mastra/pull/15362))
+
+- Reduced observability overhead for `MODEL_STEP` spans by storing a lightweight message preview of request bodies. ([#15249](https://github.com/mastra-ai/mastra/pull/15249))
+
+  This keeps span previews readable and avoids pulling large payloads into exporter input.
+
+- Fixed cost lookup for models with date suffixes. Providers like OpenAI often return model names with date suffixes (e.g., `gpt-5.4-mini-2026-03-17`) that don't exactly match pricing data entries. The lookup now tries multiple variants including stripping date suffixes and converting dots to dashes. ([#15349](https://github.com/mastra-ai/mastra/pull/15349))
+
+- Added `entityVersionId`, `parentEntityVersionId`, and `rootEntityVersionId` to span correlation context, enabling version information to propagate to scores, metrics, logs, and feedback emitted during traced execution. ([#15317](https://github.com/mastra-ai/mastra/pull/15317))
+
+- Fixed stack traces for errors reported to Sentry. Exceptions now point to the code that threw the error instead of `SentryExporter.handleSpanEnded` inside the exporter, so issues in Sentry are actually debuggable. ([#15343](https://github.com/mastra-ai/mastra/pull/15343))
+
+  This was caused by two issues, both fixed:
+  - `@mastra/sentry` passed the error message as a string to `Sentry.captureException`, which made Sentry synthesize a stack trace from the exporter's call site. It now passes an `Error` instance with the captured stack attached.
+  - `@mastra/observability` stored the wrapping `MastraError`'s stack on the span, hiding the original error's location. When the `MastraError` has a cause, the cause's stack is now preserved.
+
+  Fixes [#15337](https://github.com/mastra-ai/mastra/issues/15337).
+
+- Updated dependencies [[`cbdf3e1`](https://github.com/mastra-ai/mastra/commit/cbdf3e12b3d0c30a6e5347be658e2009648c130a), [`8fe46d3`](https://github.com/mastra-ai/mastra/commit/8fe46d354027f3f0f0846e64219772348de106dd), [`18c67db`](https://github.com/mastra-ai/mastra/commit/18c67dbb9c9ebc26f26f65f7d3ff836e5691ef46), [`8dcc77e`](https://github.com/mastra-ai/mastra/commit/8dcc77e78a5340f5848f74b9e9f1b3da3513c1f5), [`aa67fc5`](https://github.com/mastra-ai/mastra/commit/aa67fc59ee8a5eeff1f23eb05970b8d7a536c8ff), [`fa8140b`](https://github.com/mastra-ai/mastra/commit/fa8140bcd4251d2e3ac85fdc5547dfc4f372b5be), [`190f452`](https://github.com/mastra-ai/mastra/commit/190f45258b0640e2adfc8219fa3258cdc5b8f071), [`7e7bf60`](https://github.com/mastra-ai/mastra/commit/7e7bf606886bf374a6f9d4ca9b09dd83d0533372), [`184907d`](https://github.com/mastra-ai/mastra/commit/184907d775d8609c03c26e78ccaf37315f3aa287), [`0c4cd13`](https://github.com/mastra-ai/mastra/commit/0c4cd131931c04ac5405373c932a242dbe88edd6), [`b16a753`](https://github.com/mastra-ai/mastra/commit/b16a753d5748440248d7df82e29bb987a9c8386c)]:
+  - @mastra/core@1.25.0-alpha.3
+
 ## 1.9.1-alpha.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -18093,6 +18093,7 @@ var PricingRegistry = class _PricingRegistry {
   constructor(pricingModels) {
     this.pricingModels = pricingModels;
   }
+  pricingModels;
   static globalRegistry = null;
   static fromText(pricingModelText) {
     return new _PricingRegistry(parsePricingModelText(pricingModelText));
@@ -18109,12 +18110,11 @@ var PricingRegistry = class _PricingRegistry {
     return _PricingRegistry.globalRegistry;
   }
   get(args) {
-    const key = makePricingKey(args);
-    const exact = this.pricingModels.get(key);
-    if (exact) return exact;
-    const dashedKey = makePricingKey({ provider: args.provider, model: args.model.replace(/\./g, "-") });
-    if (dashedKey !== key) {
-      return this.pricingModels.get(dashedKey) ?? null;
+    const variants = getModelVariants(args.model);
+    for (const variant of variants) {
+      const key = makePricingKey({ provider: args.provider, model: variant });
+      const match = this.pricingModels.get(key);
+      if (match) return match;
     }
     return null;
   }
@@ -18204,6 +18204,18 @@ function normalizeProvider(provider) {
   const dotIndex = normalized.indexOf(".");
   return dotIndex !== -1 ? normalized.substring(0, dotIndex) : normalized;
 }
+function getModelVariants(model) {
+  const dashed = model.replace(/\./g, "-");
+  return [model, dashed, stripDateSuffix(model), stripDateSuffix(dashed)];
+}
+function stripDateSuffix(model) {
+  let stripped = model.replace(/-20\d{2}-\d{2}-\d{2}$/, "");
+  if (stripped !== model) return stripped;
+  stripped = model.replace(/-20\d{6}(-[a-z]+)?$/, "$1");
+  if (stripped !== model) return stripped;
+  stripped = model.replace(/-\d{2}-20\d{2}$/, "");
+  return stripped;
+}
 
 // src/metrics/types.ts
 var PricingMeter = {
@@ -18634,15 +18646,150 @@ function sumDefinedValues(obj, keys) {
 }
 
 // src/model-tracing.ts
+function formatPreviewLabel(label, fallback) {
+  return typeof label === "string" && label.length > 0 ? label : fallback;
+}
+function summarizePart(part) {
+  if (typeof part === "string") {
+    return part;
+  }
+  if (!part || typeof part !== "object") {
+    return "";
+  }
+  if ("text" in part && typeof part.text === "string") {
+    return part.text;
+  }
+  if ("parts" in part && Array.isArray(part.parts)) {
+    return part.parts.map(summarizePart).filter(Boolean).join("");
+  }
+  if ("inlineData" in part && part.inlineData && typeof part.inlineData === "object") {
+    return `[${formatPreviewLabel(part.inlineData.mimeType, "binary")}]`;
+  }
+  if ("image_url" in part) {
+    return "[image]";
+  }
+  if ("functionCall" in part && part.functionCall && typeof part.functionCall === "object") {
+    return `[tool: ${formatPreviewLabel(part.functionCall.name, "unknown")}]`;
+  }
+  if ("function_call" in part && part.function_call && typeof part.function_call === "object") {
+    return `[tool: ${formatPreviewLabel(part.function_call.name, "unknown")}]`;
+  }
+  if ("function" in part && part.function && typeof part.function === "object") {
+    return `[tool: ${formatPreviewLabel(part.function.name, "unknown")}]`;
+  }
+  if ("toolName" in part) {
+    return `[tool: ${formatPreviewLabel(part.toolName, "unknown")}]`;
+  }
+  if ("type" in part && typeof part.type === "string") {
+    switch (part.type) {
+      case "image":
+        return "[image]";
+      case "file":
+        return "[file]";
+      case "reasoning":
+        return "[reasoning]";
+      case "tool-call":
+        return `[tool: ${formatPreviewLabel(part.toolName, "unknown")}]`;
+      case "tool-result":
+        return "[tool-result]";
+      default:
+        return `[${part.type}]`;
+    }
+  }
+  if ("content" in part && typeof part.content === "string") {
+    return part.content;
+  }
+  return "[object]";
+}
+function summarizeMessageContent(content) {
+  if (typeof content === "string") {
+    return content;
+  }
+  if (Array.isArray(content)) {
+    return content.map(summarizePart).filter(Boolean).join("");
+  }
+  if (content && typeof content === "object") {
+    if ("parts" in content && Array.isArray(content.parts)) {
+      return content.parts.map(summarizePart).filter(Boolean).join("");
+    }
+    return summarizePart(content);
+  }
+  if (content == null) {
+    return "";
+  }
+  return String(content);
+}
+function appendToolPreview(preview, toolCalls) {
+  if (!Array.isArray(toolCalls) || toolCalls.length === 0) {
+    return preview;
+  }
+  const toolPreview = toolCalls.map((toolCall) => summarizePart(toolCall)).filter(Boolean).join(" ");
+  if (!toolPreview) {
+    return preview;
+  }
+  return preview ? `${preview} ${toolPreview}` : toolPreview;
+}
+function appendPreview(preview, addition) {
+  if (!addition) {
+    return preview;
+  }
+  return preview ? `${preview} ${addition}` : addition;
+}
+function normalizeMessages(messages) {
+  return messages.map((message) => {
+    if (!message || typeof message !== "object") {
+      return { role: "user", content: summarizeMessageContent(message) };
+    }
+    const role = typeof message.role === "string" ? message.role : "user";
+    const baseContent = summarizeMessageContent(message.content);
+    const contentWithToolArrays = appendToolPreview(
+      appendToolPreview(baseContent, message.toolCalls),
+      message.tool_calls
+    );
+    const functionCall = message.functionCall;
+    const functionCallPreview = functionCall === void 0 ? "" : summarizePart({ functionCall });
+    const functionCallSnakeCase = message.function_call;
+    const functionCallSnakeCasePreview = functionCallSnakeCase === void 0 ? "" : summarizePart({ function_call: functionCallSnakeCase });
+    const contentWithFunctionCall = appendPreview(
+      appendPreview(contentWithToolArrays, functionCallPreview),
+      functionCallSnakeCasePreview
+    );
+    return { role, content: contentWithFunctionCall };
+  });
+}
+function summarizeRequestBody(body) {
+  if (body == null) {
+    return void 0;
+  }
+  if (typeof body !== "object") {
+    return typeof body === "string" ? body : String(body);
+  }
+  if (Array.isArray(body.messages)) {
+    return normalizeMessages(body.messages);
+  }
+  if (Array.isArray(body.contents)) {
+    return body.contents.map((item) => ({
+      role: typeof item?.role === "string" ? item.role : "user",
+      content: Array.isArray(item?.parts) ? item.parts.map(summarizePart).filter(Boolean).join("") : ""
+    }));
+  }
+  const summary = {};
+  if (typeof body.model === "string") {
+    summary.model = body.model;
+  }
+  const bodyKeys = Object.keys(body).filter((key) => key !== "body");
+  if (bodyKeys.length > 0) {
+    summary.keys = bodyKeys;
+  }
+  return Object.keys(summary).length > 0 ? summary : "[request body]";
+}
 function extractStepInput(request) {
   if (!request) return void 0;
   const { body } = request;
   if (body == null) return request;
   try {
     const parsed = typeof body === "string" ? JSON.parse(body) : body;
-    if (Array.isArray(parsed?.messages)) return parsed.messages;
-    if (Array.isArray(parsed?.contents)) return parsed.contents;
-    return parsed;
+    return summarizeRequestBody(parsed);
   } catch {
     return request;
   }
@@ -19229,6 +19376,10 @@ var BaseSpan = class {
     }
     const metadata = this.metadata ?? {};
     const getMetadataString = (key) => typeof metadata[key] === "string" ? metadata[key] : void 0;
+    const getSpanMetadataString = (span, key) => {
+      const m = span?.metadata;
+      return m && typeof m[key] === "string" ? m[key] : void 0;
+    };
     const parentSpan = this.getParentSpan(false);
     let rootSpan = this;
     while (rootSpan.parent) {
@@ -19242,12 +19393,15 @@ var BaseSpan = class {
       entityType: this.entityType,
       entityId: this.entityId,
       entityName: this.entityName,
+      entityVersionId: getMetadataString("entityVersionId"),
       parentEntityType: parentSpan?.entityType,
       parentEntityId: parentSpan?.entityId,
       parentEntityName: parentSpan?.entityName,
+      parentEntityVersionId: getSpanMetadataString(parentSpan, "entityVersionId"),
       rootEntityType: rootSpan.entityType,
       rootEntityId: rootSpan.entityId,
       rootEntityName: rootSpan.entityName,
+      rootEntityVersionId: getSpanMetadataString(rootSpan, "entityVersionId"),
       userId: getMetadataString("userId"),
       organizationId: getMetadataString("organizationId"),
       resourceId: getMetadataString("resourceId"),
@@ -19384,7 +19538,10 @@ var DefaultSpan = class extends BaseSpan {
         domain: error48.domain,
         message: error48.message,
         name: error48.name,
-        stack: error48.stack
+        // 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,