@spatius/avatarkit 1.3.5 → 1.3.7

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.7] - 2026-08-17
+
+### Fixed
+- Internal telemetry only, no change to public API or runtime behaviour: diagnostic records now carry this SDK's own version alongside the reporting one. A companion SDK built on top of this one declares its own identity, which replaced the version outright, so records from those integrations gave no indication of which renderer produced them.
+- Internal telemetry only, no change to public API or runtime behaviour: the client environment fields (page host, locale, screen and viewport size) are now available to companion SDKs, whose records previously carried none of them.
+
+## [1.3.6] - 2026-08-15
+
+### Fixed
+- **Fixed the SDK continuing to send audio under an already-finished conversation id in direct mode.** After `send(audio, end=true)`, feeding new audio while that round had not started playing yet reused the same conversation id on the wire, so the driving service received new audio on a request it had already been told was over. A new round now always starts under a fresh id, whether or not the previous one had begun playing. Host mode never produced the symptom (it owns the id and has no uplink) but shared the same flaw internally and is aligned.
+- Internal telemetry only, no change to public API or runtime behaviour: the connection identifier is now attached automatically to the SDK's diagnostic events and traces. It previously had to be passed by hand at each call site and reached only two of the event types, which made it impractical to line up client-side events with the driving service's own records for the same session.
+- Internal telemetry only, no change to public API or runtime behaviour: widened the duration buckets for template and asset downloads. The previous ceilings sat well below what a cold start on a large template actually takes, so the slow tail — the part worth measuring — collapsed into a single overflow bucket and 11 seconds could not be told apart from 90.
+
 ## [1.3.5] - 2026-08-12
 
 ### Fixed

package/dist/assets/{OpusDecoderWorker.worker-BTHlnzwA.js → OpusDecoderWorker.worker-DbdfH4qX.js}

@@ -49550,6 +49550,7 @@ function buildTelemetryContext(event, level, contents) {
 	const sessionToken = idManager.getSessionToken() ?? "";
 	const context = {
 		session_token_suffix: sessionToken ? sessionToken.slice(-8) : "",
+		connection_id: idManager.getConnectionId() ?? "",
 		...clientContextFields(),
 		...contents
 	};

package/dist/assets/{OpusEncoderWorker.worker-DB_Lvnzc.js → OpusEncoderWorker.worker-DVnsr0L5.js}

@@ -49550,6 +49550,7 @@ function buildTelemetryContext(event, level, contents) {
 	const sessionToken = idManager.getSessionToken() ?? "";
 	const context = {
 		session_token_suffix: sessionToken ? sessionToken.slice(-8) : "",
+		connection_id: idManager.getConnectionId() ?? "",
 		...clientContextFields(),
 		...contents
 	};

package/dist/index.js

@@ -1,5 +1,5 @@
 import { n as __toESM, t as __commonJSMin } from "./rolldown-runtime-FDOR9p9I.js";
-import { $ as DEFAULT_REGION, A as clockSync, B as OTEL_LOGS_ENDPOINT, C as logMetric, D as monoMarkFrom, E as initializeOtel, F as recordHttpClientDuration, G as idManager, H as OTEL_STREAM_NAME, I as recordMetric, J as AvatarError, K as generateTraceId, L as getSdkPackage, M as hostOf, N as cleanupOtelMetrics, O as monoTimestamp, P as initializeOtelMetrics, Q as DEFAULT_OPUS_BITRATE, R as resolveSdkVersion, S as logEvent, T as cleanupOtel, U as OTEL_USERNAME, V as OTEL_PASSWORD, W as isDebugMode, X as ConnectionState, Y as AvatarState, Z as ConversationState, _ as logSink, a as startLoadTrace, at as LogLevel, b as getLogsFeatureFlag, c as AudioFormat, ct as TransitionType, d as MessageType, et as DEFAULT_REGION_REQUEST, f as TransportCompression, g as setLogLevel, h as logger, i as startInitTrace, it as LoadProgress, j as fetchBootstrap, k as resolveMarks, l as EgressType, lt as requireSDK, m as BinaryWriter, n as initializeOtelTrace, nt as ErrorCode, o as startPlaybackTrace, ot as RENDER_QUALITY_PARAMS, p as BinaryReader, q as AnimationType, r as startConnectTrace, rt as FrameStarvationMode, s as buildTraceparent, st as RenderQuality, t as cleanupOtelTrace, tt as DrivingServiceMode, u as Message, ut as setSDKRef, v as cleanupPostHog, w as updatePostHogPersonPropertiesForFlags, x as initializePostHog, y as clientContextFields } from "./otel-trace-CdspSqI0.js";
+import { $ as DEFAULT_REGION, A as clockSync, B as OTEL_LOGS_ENDPOINT, C as logMetric, D as monoMarkFrom, E as initializeOtel, F as recordHttpClientDuration, G as idManager, H as OTEL_STREAM_NAME, I as recordMetric, J as AvatarError, K as generateTraceId, L as getSdkPackage, M as hostOf, N as cleanupOtelMetrics, O as monoTimestamp, P as initializeOtelMetrics, Q as DEFAULT_OPUS_BITRATE, R as resolveSdkVersion, S as logEvent, T as cleanupOtel, U as OTEL_USERNAME, V as OTEL_PASSWORD, W as isDebugMode, X as ConnectionState, Y as AvatarState, Z as ConversationState, _ as logSink, a as startLoadTrace, at as LogLevel, b as getLogsFeatureFlag, c as AudioFormat, ct as TransitionType, d as MessageType, et as DEFAULT_REGION_REQUEST, f as TransportCompression, g as setLogLevel, h as logger, i as startInitTrace, it as LoadProgress, j as fetchBootstrap, k as resolveMarks, l as EgressType, lt as requireSDK, m as BinaryWriter, n as initializeOtelTrace, nt as ErrorCode, o as startPlaybackTrace, ot as RENDER_QUALITY_PARAMS, p as BinaryReader, q as AnimationType, r as startConnectTrace, rt as FrameStarvationMode, s as buildTraceparent, st as RenderQuality, t as cleanupOtelTrace, tt as DrivingServiceMode, u as Message, ut as setSDKRef, v as cleanupPostHog, w as updatePostHogPersonPropertiesForFlags, x as initializePostHog, y as clientContextFields } from "./otel-trace-Y_BtH06z.js";
 //#region core/Avatar.ts
 var Avatar = class {
 	id;
@@ -41912,7 +41912,7 @@ var OpusDecoderProxy = class OpusDecoderProxy {
 			try {
 				worker = new Worker(new URL(
 					/* @vite-ignore */
-					"" + new URL("assets/OpusDecoderWorker.worker-BTHlnzwA.js", import.meta.url).href,
+					"" + new URL("assets/OpusDecoderWorker.worker-DbdfH4qX.js", import.meta.url).href,
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {
@@ -45730,7 +45730,7 @@ var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.5";
+	static _version = "1.3.7";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;
@@ -46295,7 +46295,7 @@ var OpusEncoderProxy = class OpusEncoderProxy {
 			try {
 				worker = new Worker(new URL(
 					/* @vite-ignore */
-					"" + new URL("assets/OpusEncoderWorker.worker-DB_Lvnzc.js", import.meta.url).href,
+					"" + new URL("assets/OpusEncoderWorker.worker-DVnsr0L5.js", import.meta.url).href,
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {
@@ -46704,7 +46704,6 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			logger.error("[AnimationWebSocketClient] Failed to send audio data:", message);
 			logEvent("send_audio_failed", "error", {
 				conversation_id: conversationId || "",
-				connection_id: idManager.getConnectionId() || "",
 				description: message
 			});
 			this.emit("error", error);
@@ -46762,7 +46761,6 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			logger.error("[AnimationWebSocketClient] Failed to forward Opus audio:", message);
 			logEvent("send_audio_failed", "error", {
 				conversation_id: conversationId || "",
-				connection_id: idManager.getConnectionId() || "",
 				description: message
 			});
 			this.emit("error", error);
@@ -46860,7 +46858,6 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			logger.error("[AnimationWebSocketClient] Failed to send Opus audio:", message);
 			logEvent("send_audio_failed", "error", {
 				conversation_id: conversationId || "",
-				connection_id: idManager.getConnectionId() || "",
 				description: message
 			});
 			this.emit("error", error);
@@ -47028,7 +47025,6 @@ var AnimationWebSocketClient = class extends EventEmitter {
 					const readyStateText = readyState === WebSocket.CONNECTING ? "CONNECTING" : readyState === WebSocket.OPEN ? "OPEN" : readyState === WebSocket.CLOSING ? "CLOSING" : readyState === WebSocket.CLOSED ? "CLOSED" : "UNKNOWN";
 					logger.error(`[AnimationWebSocketClient] WebSocket error: readyState=${readyStateText}, url=${urlForLog}`);
 					logEvent("websocket_error", "error", {
-						connection_id: idManager.getConnectionId() || "",
 						ready_state: readyStateText,
 						description: `WebSocket error (readyState: ${readyStateText})`
 					});
@@ -47037,12 +47033,14 @@ var AnimationWebSocketClient = class extends EventEmitter {
 				};
 				this.ws.onclose = (event) => {
 					const sessionDurationMs = this.connectionStartTime > 0 ? Date.now() - this.connectionStartTime : 0;
+					const connectionId = idManager.getConnectionId() || "";
 					logger.log("[AnimationWebSocketClient] WebSocket closed:", {
 						code: event.code,
 						reason: event.reason || "(no reason)",
 						wasClean: event.wasClean,
 						url: urlForLog,
-						session_duration_ms: sessionDurationMs
+						session_duration_ms: sessionDurationMs,
+						connection_id: connectionId
 					});
 					this.emit("disconnected", event.reason || "Connection closed");
 					this.sessionConfigured = false;
@@ -47052,7 +47050,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 						case 4010:
 							sdkErrorCode = ErrorCode.sessionTokenInvalid;
 							logEvent("session_token_invalid", "warning", {
-								connection_id: idManager.getConnectionId() || "",
+								connection_id: connectionId,
 								description: reason || "Authentication failed",
 								session_duration_ms: sessionDurationMs
 							});
@@ -47060,7 +47058,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 						case 4001:
 							sdkErrorCode = ErrorCode.insufficientBalance;
 							logEvent("insufficient_balance", "warning", {
-								connection_id: idManager.getConnectionId() || "",
+								connection_id: connectionId,
 								description: reason || "Insufficient balance",
 								session_duration_ms: sessionDurationMs
 							});
@@ -47068,7 +47066,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 						case 4002:
 							sdkErrorCode = ErrorCode.sessionTimeout;
 							logEvent("session_timeout", "warning", {
-								connection_id: idManager.getConnectionId() || "",
+								connection_id: connectionId,
 								description: reason || "Session timeout",
 								session_duration_ms: sessionDurationMs
 							});
@@ -47076,14 +47074,14 @@ var AnimationWebSocketClient = class extends EventEmitter {
 						case 4003:
 							sdkErrorCode = ErrorCode.concurrentLimitExceeded;
 							logEvent("concurrent_limit_exceeded", "warning", {
-								connection_id: idManager.getConnectionId() || "",
+								connection_id: connectionId,
 								description: reason || "Concurrent connection limit exceeded",
 								session_duration_ms: sessionDurationMs
 							});
 							break;
 						case 1006:
 							logEvent("websocket_closed_abnormally", "error", {
-								connection_id: idManager.getConnectionId() || "",
+								connection_id: connectionId,
 								code: event.code,
 								description: reason || "Connection closed abnormally",
 								session_duration_ms: sessionDurationMs
@@ -47091,7 +47089,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 							break;
 						case 1012:
 							logEvent("service_restarted", "warning", {
-								connection_id: idManager.getConnectionId() || "",
+								connection_id: connectionId,
 								description: reason || "Service restart",
 								session_duration_ms: sessionDurationMs
 							});
@@ -47100,7 +47098,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 					if (this.connectStartMs > 0) {
 						const connectResult = sdkErrorCode ?? (event.code === 1006 ? "closed_abnormally" : "closed_before_confirm");
 						logMetric("ws_connect_latency", Date.now() - this.connectStartMs, { result: connectResult }, {
-							connection_id: idManager.getConnectionId() || "",
+							connection_id: connectionId,
 							close_code: event.code,
 							description: reason || `Closed with code ${event.code}`
 						});
@@ -47109,7 +47107,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 					if (sdkErrorCode) this.emit("error", new AvatarError(reason || `WebSocket connection failed with code ${event.code}`, sdkErrorCode));
 					else if (event.code !== 1e3) {
 						logEvent("websocket_closed_unexpected", "error", {
-							connection_id: idManager.getConnectionId() || "",
+							connection_id: connectionId,
 							code: event.code,
 							description: reason || `Unexpected close (code: ${event.code})`,
 							session_duration_ms: sessionDurationMs
@@ -47195,7 +47193,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 					} else logger.log("[AnimationWebSocketClient] Session confirmed by server");
 					if (this.connectStartMs > 0) {
 						const confirmMs = Date.now();
-						logMetric("ws_connect_latency", confirmMs - this.connectStartMs, { result: "success" }, { connection_id: idManager.getConnectionId() || "" });
+						logMetric("ws_connect_latency", confirmMs - this.connectStartMs, { result: "success" }, {});
 						this.emitConnectTrace(confirmMs);
 						this.connectStartMs = 0;
 					}
@@ -47463,7 +47461,6 @@ var NetworkLayer = class {
 		logger.error(`[NetworkLayer] Server error: conversationId=${conversationId}, code=${message.serverError.code}, message=${message.serverError.message}`);
 		logEvent("message_error", "error", {
 			conversation_id: conversationId,
-			connection_id: idManager.getConnectionId() || "",
 			description: message.serverError.message || `Server error: code=${message.serverError.code}`
 		});
 		const httpStatusCode = message.serverError.code;
@@ -47474,7 +47471,6 @@ var NetworkLayer = class {
 			sdkErrorCode = ErrorCode.sessionTokenExpired;
 			logEvent("session_token_expired", "warning", {
 				avatar_id: this.dataController.getAvatarId(),
-				connection_id: idManager.getConnectionId() || "",
 				description: errorMessage,
 				session_duration_ms: sessionDurationMs
 			});
@@ -47482,7 +47478,6 @@ var NetworkLayer = class {
 			sdkErrorCode = ErrorCode.sessionTokenInvalid;
 			logEvent("session_token_invalid", "warning", {
 				avatar_id: this.dataController.getAvatarId(),
-				connection_id: idManager.getConnectionId() || "",
 				description: errorMessage,
 				session_duration_ms: sessionDurationMs
 			});
@@ -47532,10 +47527,7 @@ var NetworkLayer = class {
 				this.heartbeatFailureCount++;
 				logger.warn(`[NetworkLayer] Driving service heartbeat failed (count: ${this.heartbeatFailureCount})`);
 				if (this.heartbeatFailureCount >= 3) {
-					logEvent("heartbeat_failed", "warning", {
-						connection_id: idManager.getConnectionId() || "",
-						description: `Driving service heartbeat failed ${this.heartbeatFailureCount} times`
-					});
+					logEvent("heartbeat_failed", "warning", { description: `Driving service heartbeat failed ${this.heartbeatFailureCount} times` });
 					this.heartbeatFailureCount = 0;
 				}
 			}
@@ -47543,10 +47535,7 @@ var NetworkLayer = class {
 			this.heartbeatFailureCount++;
 			logger.warn(`[NetworkLayer] Heartbeat check error (count: ${this.heartbeatFailureCount}):`, error instanceof Error ? error.message : String(error));
 			if (this.heartbeatFailureCount >= 3) {
-				logEvent("heartbeat_failed", "warning", {
-					connection_id: idManager.getConnectionId() || "",
-					description: `Heartbeat check error: ${error instanceof Error ? error.message : String(error)}`
-				});
+				logEvent("heartbeat_failed", "warning", { description: `Heartbeat check error: ${error instanceof Error ? error.message : String(error)}` });
 				this.heartbeatFailureCount = 0;
 			}
 		}
@@ -48476,7 +48465,11 @@ var AvatarController = class {
 			this.onError?.(new AvatarError("Network layer not available", ErrorCode.networkLayerNotAvailable));
 			return null;
 		}
-		if (this.reqEnd && this.isPlaying && this.currentConversationId) this.interrupt();
+		if (this.reqEnd && this.currentConversationId) if (this.isPlaying) this.interrupt();
+		else {
+			this.resetConversationIdState();
+			this.clearPlaybackData();
+		}
 		if (!this.currentConversationId) {
 			this.currentConversationId = this.generateAndLogNewConversationId();
 			this.reqEnd = false;
@@ -48617,8 +48610,12 @@ var AvatarController = class {
 			this.onError?.(error);
 			return null;
 		}
-		if (this.reqEnd && this.isPlaying && this.currentConversationId) {
-			this.interrupt();
+		if (this.reqEnd && this.currentConversationId) {
+			if (this.isPlaying) this.interrupt();
+			else {
+				this.resetConversationIdState();
+				this.clearPlaybackData();
+			}
 			this.currentConversationId = this.generateAndLogNewConversationId();
 			this.reqEnd = false;
 		}
@@ -49373,7 +49370,6 @@ var AvatarController = class {
 		logEvent("fallback_mode_entered", "warning", {
 			avatar_id: this.avatar.id,
 			reason,
-			connection_id: idManager.getConnectionId() || "",
 			conversation_id: this.currentConversationId || ""
 		});
 		this.emit("playFallback");

package/dist/internal-telemetry.d.ts

@@ -79,6 +79,24 @@ export declare function peekTraceparent(rawMessage: Uint8Array): string | undefi
  * dropped before it is sent.
  */
 export declare function recordMetric(name: string, value: number, attributes?: Attributes): void;
+/**
+ * The client environment fields this SDK stamps on every OTel log record —
+ * `host`, `domain`, `url`, `pathname`, `referrer`, `user_agent`, `locale`,
+ * screen/viewport size and `timezone`.
+ *
+ * Shared with the RTC SDK rather than re-derived there. These are record-level
+ * fields, not Resource attributes: they are read from `window.location` at emit
+ * time because `url`/`pathname` change as a single-page app routes. Sharing the
+ * OTel providers therefore does not carry them across — the RTC SDK emits
+ * through its own logger and would report no `host` at all, which is what
+ * prompted this export. Re-implementing the collection on that side would let
+ * the two drift apart in field names and in how each value is read, and the
+ * backend aggregates on exactly these names.
+ *
+ * Call at emit time, once per record; spread the result before the caller's own
+ * properties so an explicit value at the call site still wins.
+ */
+export declare function clientContextFields(): Record<string, string | number>;
 /**
  * Declare which SDK these records come from, as the `sdk.package` and
  * `sdk.version` resource attributes.

package/dist/internal-telemetry.js

@@ -1,4 +1,4 @@
-import { A as clockSync, I as recordMetric$1, o as startPlaybackTrace$1, u as Message, z as setSdkIdentity$1 } from "./otel-trace-CdspSqI0.js";
+import { A as clockSync, I as recordMetric$1, o as startPlaybackTrace$1, u as Message, y as clientContextFields$1, z as setSdkIdentity$1 } from "./otel-trace-Y_BtH06z.js";
 //#region internal-telemetry.ts
 /**
 * Internal telemetry surface for the companion RTC SDK.
@@ -91,6 +91,26 @@ function recordMetric(name, value, attributes = {}) {
 	recordMetric$1(name, value, attributes);
 }
 /**
+* The client environment fields this SDK stamps on every OTel log record —
+* `host`, `domain`, `url`, `pathname`, `referrer`, `user_agent`, `locale`,
+* screen/viewport size and `timezone`.
+*
+* Shared with the RTC SDK rather than re-derived there. These are record-level
+* fields, not Resource attributes: they are read from `window.location` at emit
+* time because `url`/`pathname` change as a single-page app routes. Sharing the
+* OTel providers therefore does not carry them across — the RTC SDK emits
+* through its own logger and would report no `host` at all, which is what
+* prompted this export. Re-implementing the collection on that side would let
+* the two drift apart in field names and in how each value is read, and the
+* backend aggregates on exactly these names.
+*
+* Call at emit time, once per record; spread the result before the caller's own
+* properties so an explicit value at the call site still wins.
+*/
+function clientContextFields() {
+	return clientContextFields$1();
+}
+/**
 * Declare which SDK these records come from, as the `sdk.package` and
 * `sdk.version` resource attributes.
 *
@@ -117,4 +137,4 @@ function setSdkIdentity(identity) {
 	setSdkIdentity$1(identity);
 }
 //#endregion
-export { isClockCalibrated, peekTraceparent, recordMetric, resolveMonoTimestamp, setSdkIdentity, startPlaybackTrace };
+export { clientContextFields, isClockCalibrated, peekTraceparent, recordMetric, resolveMonoTimestamp, setSdkIdentity, startPlaybackTrace };

package/dist/{otel-trace-CdspSqI0.js → otel-trace-Y_BtH06z.js}

@@ -14583,6 +14583,11 @@ var HTTP_CLIENT_DURATION_METRIC = "http.client.request.duration";
 * （浮点 duration 会被后端拒/丢），因此值与桶统一用整数毫秒，不用浮点秒。
 * 桶经后台确认调整：去掉 100ms 以下分级（网络 rt 极少落在此区、无区分价值），
 * 并在 1000~5000ms 高区段加密（2000/3000/4000）以便看清慢请求分布。（与 android/iOS 一致。）
+*
+* 5 秒之上再加 10/30/60/120 秒：这是所有 HTTP 请求共用的一条 metric（靠 operation
+* 标签区分），其中 `/assets/template` 是几十 MB 的大文件下载，实测约三成样本超过
+* 5 秒——原先全部挤进 +Inf，是 6 秒还是 60 秒完全看不出来。前段分档不变，API 请求
+* 的分辨率不受影响。
 */
 var HTTP_NETWORK_BUCKETS_MS = [
 	100,
@@ -14592,7 +14597,11 @@ var HTTP_NETWORK_BUCKETS_MS = [
 	2e3,
 	3e3,
 	4e3,
-	5e3
+	5e3,
+	1e4,
+	3e4,
+	6e4,
+	12e4
 ];
 /**
 * 播放指标的桶。默认桶（0/5/10/25/50/…/10000）对这批指标毫无分辨率：
@@ -14863,6 +14872,14 @@ var BUCKET_PROFILES = [
 	["playback_latency_anim_0_ms", ANIM_LATENCY_BUCKETS_MS],
 	["playback_latency_anim_1_ms", ANIM_LATENCY_BUCKETS_MS],
 	["playback_latency_anim_2_ms", ANIM_LATENCY_BUCKETS_MS],
+	["template_resources_load_measure", [
+		1e3,
+		1e4,
+		2e4,
+		3e4,
+		6e4,
+		12e4
+	]],
 	["rtc_playback_avg_fps", RTC_FPS_BUCKETS],
 	["rtc_playback_frame_count", RTC_FRAME_COUNT_BUCKETS],
 	["rtc_playback_skipped_frames", RTC_LOST_FRAME_BUCKETS],
@@ -14943,6 +14960,7 @@ function initializeOtelMetrics(version, resourceAttrs) {
 				"sdk.version": resolveSdkVersion(sdkVersion$3),
 				"sdk.platform": "web",
 				"sdk.package": getSdkPackage(),
+				"render_sdk_version": sdkVersion$3,
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
@@ -15701,6 +15719,7 @@ function initializeOtel(version, resourceAttrs) {
 				"sdk.version": resolveSdkVersion(sdkVersion$2),
 				"sdk.platform": "web",
 				"sdk.package": getSdkPackage(),
+				"render_sdk_version": sdkVersion$2,
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
@@ -16234,6 +16253,7 @@ function buildTelemetryContext(event, level, contents) {
 	const sessionToken = idManager.getSessionToken() ?? "";
 	const context = {
 		session_token_suffix: sessionToken ? sessionToken.slice(-8) : "",
+		connection_id: idManager.getConnectionId() ?? "",
 		...clientContextFields(),
 		...contents
 	};
@@ -20371,6 +20391,7 @@ function initializeOtelTrace(version, resourceAttrs) {
 				"sdk.version": resolveSdkVersion(sdkVersion),
 				"sdk.platform": "web",
 				"sdk.package": getSdkPackage(),
+				"render_sdk_version": sdkVersion,
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm,
@@ -20434,6 +20455,7 @@ function startInitTrace(sessionId, startTimeMs, attrs = {}) {
 			startTime: startTimeMs,
 			attributes: {
 				session_id: sessionId,
+				connection_id: idManager.getConnectionId() ?? "",
 				...attrs
 			}
 		}, ROOT_CONTEXT);
@@ -20471,6 +20493,7 @@ function startLoadTrace(avatarId, startTimeMs, attrs = {}) {
 			attributes: {
 				avatar_id: avatarId,
 				session_id: idManager.getSessionId(),
+				connection_id: idManager.getConnectionId() ?? "",
 				...attrs
 			}
 		}, ROOT_CONTEXT);
@@ -20573,6 +20596,7 @@ function startPlaybackTrace(conversationId, startTimeMs, attrs = {}, serverTrace
 			attributes: {
 				conversation_id: conversationId,
 				session_id: idManager.getSessionId(),
+				connection_id: idManager.getConnectionId() ?? "",
 				...attrs
 			},
 			...typeof startTimeMs === "number" ? { startTime: startTimeMs } : {}
@@ -20582,6 +20606,7 @@ function startPlaybackTrace(conversationId, startTimeMs, attrs = {}, serverTrace
 			attributes: {
 				conversation_id: conversationId,
 				session_id: idManager.getSessionId(),
+				connection_id: idManager.getConnectionId() ?? "",
 				...attrs
 			},
 			...typeof startTimeMs === "number" ? { startTime: startTimeMs } : {}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatius/avatarkit",
   "type": "module",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "packageManager": "pnpm@10.18.2",
   "description": "AvatarKit — real-time, audio-driven avatar rendering SDK for Web.",
   "homepage": "https://spatius.ai/",