@mastra/observability 1.17.2-alpha.0 → 1.17.2-alpha.2

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @mastra/observability
 
+## 1.17.2-alpha.2
+
+### Patch Changes
+
+- Added `span.endTree()` for closing a span together with every descendant span that is still open, so an operation that is abandoned rather than completed can still emit a full trace. The options you pass are applied to every span it closes, so a force-closed child is distinguishable from one that finished on its own. ([#22278](https://github.com/mastra-ai/mastra/pull/22278))
+
+  ```ts
+  // Ends the span and any child spans still open beneath it, marking each canceled
+  workflowSpan.endTree({ attributes: { status: 'canceled' } });
+  ```
+
+  Repeat calls to `span.end()` are now ignored. A span that was force-closed this way keeps the state it was closed with and reports its end exactly once, even if the work it covered finishes later and ends the span again.
+
+- Updated dependencies [[`b05f486`](https://github.com/mastra-ai/mastra/commit/b05f48612984d5fe2447ea2d6cdd5c604d285b97), [`7960688`](https://github.com/mastra-ai/mastra/commit/7960688828e04eaf3106e34f7758fa580257eef6)]:
+  - @mastra/core@1.62.0-alpha.10
+
+## 1.17.2-alpha.1
+
+### Patch Changes
+
+- Fix PostgreSQL observability writes failing on NUL characters and unpaired Unicode surrogates ([#21728](https://github.com/mastra-ai/mastra/pull/21728))
+
+  Span serialization truncated strings by UTF-16 code unit, so a cut inside an emoji left a lone surrogate that PostgreSQL rejected on the jsonb cast (`22P02`). NUL characters were rejected as well (`22P05`). Because observability events are inserted as a single multi-row statement, one malformed field discarded the entire batch.
+
+  Truncation now preserves complete surrogate pairs, and the v-next PostgreSQL observability encoder sanitizes NUL and unpaired surrogates before the jsonb cast, using the same sanitizer that workflow snapshots already rely on. Valid Unicode, including complete emoji, is preserved.
+
+- Updated dependencies [[`2c85f42`](https://github.com/mastra-ai/mastra/commit/2c85f428e04ccd63ea31a7ec80b5b327afdad555), [`11bbeb9`](https://github.com/mastra-ai/mastra/commit/11bbeb9b108ef2264e05acefc6dafb9cbb342921), [`1a485f3`](https://github.com/mastra-ai/mastra/commit/1a485f3538f5ec64d58bd8b5e1e99de0c695c87b), [`0d37487`](https://github.com/mastra-ai/mastra/commit/0d37487d9f349388a3f1cef6a536cf9dcc4b6273), [`8661d7d`](https://github.com/mastra-ai/mastra/commit/8661d7d7179f0a024456aabdd8679bcecd09ac28), [`575e343`](https://github.com/mastra-ai/mastra/commit/575e343900451021d96110916497d334af7bc252), [`cacb839`](https://github.com/mastra-ai/mastra/commit/cacb8392d9e74189b56d857290b0615f98a2683d), [`b47b26e`](https://github.com/mastra-ai/mastra/commit/b47b26e6fe95cb8a3482be2c5e52de157fe59d0b), [`0d37487`](https://github.com/mastra-ai/mastra/commit/0d37487d9f349388a3f1cef6a536cf9dcc4b6273), [`c46eb09`](https://github.com/mastra-ai/mastra/commit/c46eb09ce4987509af57a0ac582c61241a6dd2f1), [`30ed33e`](https://github.com/mastra-ai/mastra/commit/30ed33ee14084a26019aba15fceadda6d6ddefaf), [`91ad69d`](https://github.com/mastra-ai/mastra/commit/91ad69d64994c89199b0c55399e64ed91c61df2f), [`8dc408d`](https://github.com/mastra-ai/mastra/commit/8dc408d34438f9e13297f792c11a5cfd6cf952e1), [`c92def1`](https://github.com/mastra-ai/mastra/commit/c92def10a13c822972c96f0a4ca6ffc1f4258aed), [`c5eaec5`](https://github.com/mastra-ai/mastra/commit/c5eaec5a860d80d0e3805e67db0414b87ac8cbed), [`e66b2ba`](https://github.com/mastra-ai/mastra/commit/e66b2ba100db63eaeab6e21e1ea34b113f2ec781)]:
+  - @mastra/core@1.62.0-alpha.3
+
 ## 1.17.2-alpha.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -246,10 +246,18 @@ function mergeSerializationOptions(userOptions) {
 }
 /**
 * Hard-cap any string to prevent unbounded growth.
+*
+* The cut never splits a UTF-16 surrogate pair: if it would land immediately
+* after a lone high surrogate (U+D800..U+DBFF), it backs off one code unit so
+* the pair is dropped as a whole. `JSON.stringify` emits a lone `\ud83d` for a
+* split pair, which PostgreSQL rejects on a jsonb cast with 22P02
+* ("Unicode low surrogate must follow a high surrogate").
 */
 function truncateString(s, maxChars) {
 	if (s.length <= maxChars) return s;
-	return s.slice(0, maxChars) + "…[truncated]";
+	const code = s.charCodeAt(maxChars - 1);
+	const safeEnd = code >= 55296 && code <= 56319 ? maxChars - 1 : maxChars;
+	return s.slice(0, safeEnd) + "…[truncated]";
 }
 function formatSerializationError(error) {
 	return `[${error instanceof Error ? truncateString(error.message, 256) : "unknown error"}]`;
@@ -2710,7 +2718,7 @@ function getExternalParentId(options) {
 	if (parent.isInternal || parent.isExcluded) return parent.getParentSpanId(false);
 	return parent.id;
 }
-var BaseSpan = class {
+var BaseSpan = class BaseSpan {
 	name;
 	type;
 	attributes;
@@ -2760,6 +2768,8 @@ var BaseSpan = class {
 	isExcluded;
 	/** Cached canonical correlation context for this live span */
 	correlationContext;
+	/** Child spans that have started but not yet ended */
+	#openChildren;
 	/**
 	* Subclasses can override to unconditionally mark the span as excluded.
 	* NoOpSpan uses this because it is never exported regardless of config.
@@ -2781,6 +2791,8 @@ var BaseSpan = class {
 		this.isEvent = options.isEvent ?? false;
 		this.tracingPolicy = options.tracingPolicy;
 		this.traceState = options.traceState;
+		const parent = options.parent;
+		if (!this.isEvent && parent instanceof BaseSpan && parent.isValid) (parent.#openChildren ??= /* @__PURE__ */ new Set()).add(this);
 		this.tags = !options.parent && options.tags?.length ? options.tags : void 0;
 		const entityParent = this.getParentSpan(false);
 		this.entityType = options.entityType ?? entityParent?.entityType;
@@ -2818,6 +2830,16 @@ var BaseSpan = class {
 			return value;
 		}
 	}
+	/** End the span and any descendant spans that are still open, applying `options` to each */
+	endTree(options) {
+		if (this.#openChildren) for (const child of [...this.#openChildren]) child.endTree(options);
+		this.end(options);
+	}
+	/** Release this span from its parent's open-child set once it has ended */
+	detachFromParent() {
+		const parent = this.parent;
+		if (parent instanceof BaseSpan) parent.#openChildren?.delete(this);
+	}
 	createChildSpan(options) {
 		return this.observabilityInstance.startSpan({
 			...options,
@@ -3021,7 +3043,9 @@ var DefaultSpan = class extends BaseSpan {
 	}
 	end(options) {
 		if (this.isEvent) return;
+		if (this.endTime) return;
 		this.endTime = /* @__PURE__ */ new Date();
+		this.detachFromParent();
 		if (options?.metadata) this.metadata = {
 			...this.metadata,
 			...deepClean(this.prepareSpanMetadata(options.metadata), this.deepCleanOptions)
@@ -3477,6 +3501,7 @@ var BaseObservabilityInstance = class extends _mastra_core_base.MastraBase {
 				this.logger.warn(`End event is not available on event spans`);
 				return;
 			}
+			if (span.endTime) return;
 			const rollupTarget = this.captureModelUsageRollup(span, options);
 			const excludedModelUsage = this.captureExcludedModelUsage(span, options);
 			originalEnd(options);