@spatius/avatarkit 1.3.4 → 1.3.5-beta.1

package/dist/{OpusCodec-Cib3mtQ2.js → OpusCodec-BYwstcZb.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll, r as __toESM, t as __commonJSMin } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-B_tTFAYq.js";
+import { t as logger } from "./logger-BCrlTIt2.js";
 /** Opus granule positions are always in 48 kHz samples, regardless of input rate. */
 var OPUS_GRANULE_RATE = 48e3;
 /**

package/dist/{OpusDecoderProxy-Dz21UtCz.js → OpusDecoderProxy-DW_SVYwd.js}

@@ -1,4 +1,4 @@
-import { t as logger } from "./logger-B_tTFAYq.js";
+import { t as logger } from "./logger-BCrlTIt2.js";
 //#region audio/OpusDecoderProxy.ts
 var OpusDecoderProxy = class OpusDecoderProxy {
 	worker = null;
@@ -21,7 +21,7 @@ var OpusDecoderProxy = class OpusDecoderProxy {
 		} catch (err) {
 			logger.warn("[Opus][DecoderProxy] Worker unavailable, falling back to main-thread decode:", err instanceof Error ? err.message : String(err));
 		}
-		const { OggOpusDecoder } = await import("./OpusCodec-Cib3mtQ2.js").then((n) => n.n);
+		const { OggOpusDecoder } = await import("./OpusCodec-BYwstcZb.js").then((n) => n.n);
 		proxy.fallbackDecoder = new OggOpusDecoder();
 		proxy.backend = "main-thread";
 		return proxy;
@@ -32,7 +32,7 @@ var OpusDecoderProxy = class OpusDecoderProxy {
 			try {
 				worker = new Worker(new URL(
 					/* @vite-ignore */
-					"" + new URL("assets/OpusDecoderWorker.worker-BAd4MYA3.js", import.meta.url).href,
+					"" + new URL("assets/OpusDecoderWorker.worker-DkKhJmGs.js", import.meta.url).href,
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {

package/dist/{OpusEncoderProxy-BiX90p4q.js → OpusEncoderProxy-CQrj6ZjY.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-B_tTFAYq.js";
+import { t as logger } from "./logger-BCrlTIt2.js";
 //#region audio/OpusEncoderProxy.ts
 var OpusEncoderProxy_exports = /* @__PURE__ */ __exportAll({
 	OpusEncoderProxy: () => OpusEncoderProxy,
@@ -43,7 +43,7 @@ var OpusEncoderProxy = class OpusEncoderProxy {
 		} catch (err) {
 			logger.warn("[Opus][Proxy] Worker unavailable, falling back to main-thread encode:", err instanceof Error ? err.message : String(err));
 		}
-		const { OggOpusEncoder } = await import("./OpusCodec-Cib3mtQ2.js").then((n) => n.n);
+		const { OggOpusEncoder } = await import("./OpusCodec-BYwstcZb.js").then((n) => n.n);
 		proxy.fallbackEncoder = new OggOpusEncoder(sampleRate, bitrate);
 		proxy.backend = "main-thread";
 		return proxy;
@@ -54,7 +54,7 @@ var OpusEncoderProxy = class OpusEncoderProxy {
 			try {
 				worker = new Worker(new URL(
 					/* @vite-ignore */
-					"" + new URL("assets/OpusEncoderWorker.worker-DdhFHkno.js", import.meta.url).href,
+					"" + new URL("assets/OpusEncoderWorker.worker-Bu8QRO55.js", import.meta.url).href,
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {

package/dist/{StreamingAudioPlayer-D5_x6veD.js → StreamingAudioPlayer-BORop_1T.js}

@@ -1,5 +1,5 @@
-import { c as logEvent, t as logger } from "./logger-B_tTFAYq.js";
-import { n as APP_CONFIG, t as errorToMessage } from "./error-utils-B76Nf6d6.js";
+import { c as logEvent, t as logger } from "./logger-BCrlTIt2.js";
+import { n as APP_CONFIG, t as errorToMessage } from "./error-utils-CX5P3vnW.js";
 //#region audio/StreamingAudioPlayer.ts
 /**
 * Streaming Audio Player

package/dist/assets/{AvatarDownloader-DkReeoUZ.js → AvatarDownloader-DImd24mo.js}

@@ -1,5 +1,5 @@
-import { St as ErrorCode, _t as generateTraceId, c as logEvent, h as hostOf, ht as isDebugMode, l as logMetric, t as logger, vt as AvatarError, y as recordHttpClientDuration } from "./logger-__jZD7QG.js";
-import { t as AvatarSDK } from "./AvatarSDK-DX8_-oyi.js";
+import { St as ErrorCode, _t as generateTraceId, c as logEvent, h as hostOf, ht as isDebugMode, l as logMetric, t as logger, vt as AvatarError, y as recordHttpClientDuration } from "./logger-CnIdJBOF.js";
+import { t as AvatarSDK } from "./AvatarSDK-vQTYP0IB.js";
 //#region config/app-config.ts
 const GLOBAL_FLAME_CDN_BASE = "https://cdn.spatialwalk.cloud/public";
 const CN_FLAME_CDN_BASE = "https://cdn.spatialwalk.top/public";
@@ -393,7 +393,8 @@ var AvatarDownloader = class {
 			logMetric("template_resources_load_measure", duration, {
 				file_count: 1,
 				cache_hit: true,
-				cache_type: "pwa"
+				cache_type: "pwa",
+				result: "success"
 			});
 			return { unifiedModel: cached };
 		}
@@ -419,7 +420,8 @@ var AvatarDownloader = class {
 				logMetric("template_resources_load_measure", Date.now() - startTime, {
 					file_count: 1,
 					cache_hit: false,
-					cache_type: "none"
+					cache_type: "none",
+					result: "success"
 				});
 				recordAssetTransaction(templateOutcomes, Date.now() - startTime, TEMPLATE_OPERATION);
 				return { unifiedModel: buffer };
@@ -429,6 +431,16 @@ var AvatarDownloader = class {
 			}
 		}
 		recordAssetTransaction(templateOutcomes, Date.now() - startTime, TEMPLATE_OPERATION);
+		const lastStatus = templateOutcomes[0]?.statusCode;
+		logMetric("template_resources_load_measure", Date.now() - startTime, {
+			file_count: 1,
+			cache_hit: false,
+			cache_type: "none",
+			result: lastStatus !== void 0 && lastStatus >= 200 && lastStatus < 400 ? "decode_failed" : "download_failed"
+		}, {
+			description: lastError?.message ?? "unknown",
+			...lastStatus !== void 0 ? { last_status_code: lastStatus } : {}
+		});
 		throw lastError || /* @__PURE__ */ new Error(`Failed to download unified template after ${maxRetries} attempts`);
 	}
 	/**
@@ -559,6 +571,19 @@ var AvatarDownloader = class {
 		});
 		try {
 			await Promise.all(downloadPromises);
+		} catch (error) {
+			if (!(error instanceof Error && (error.name === "AbortError" || error.message === "Download cancelled"))) logMetric("download_avatar_assets_latency", Date.now() - totalStartTime, {
+				resolution: "default",
+				use_compressed_model: useCompressedModel,
+				file_count: filesToLoad.length,
+				cache_hit: false,
+				cache_type: "none",
+				result: "download_failed"
+			}, {
+				avatar_id: characterMeta.characterId ?? "unknown",
+				description: error instanceof Error ? error.message : String(error)
+			});
+			throw error;
 		} finally {
 			recordAssetTransaction(httpOutcomes, Date.now() - totalStartTime);
 		}
@@ -566,6 +591,17 @@ var AvatarDownloader = class {
 		const totalDuration = Date.now() - totalStartTime;
 		if (!characterData.shape || !characterData.pointCloud) {
 			const reason = "Failed to load character data";
+			logMetric("download_avatar_assets_latency", totalDuration, {
+				resolution: "default",
+				use_compressed_model: useCompressedModel,
+				file_count: filesToLoad.length,
+				cache_hit: false,
+				cache_type: "none",
+				result: "incomplete_data"
+			}, {
+				avatar_id: characterMeta.characterId ?? "unknown",
+				description: reason
+			});
 			logEvent("download_avatar_assets_failed", "error", {
 				avatar_id: characterMeta.characterId ?? "unknown",
 				description: reason
@@ -582,7 +618,8 @@ var AvatarDownloader = class {
 			use_compressed_model: useCompressedModel,
 			file_count: filesToLoad.length,
 			cache_hit: cacheHit,
-			cache_type: cacheType
+			cache_type: cacheType,
+			result: "success"
 		}, {
 			avatar_id: characterMeta.characterId ?? "unknown",
 			parallel_duration: parallelDuration,
@@ -760,7 +797,7 @@ var AvatarDownloader = class {
 				const serverMessage = firstError.detail || firstError.title || firstError.message || "Unknown server error";
 				throw new AvatarError(`${firstError.code || firstError.status || "SERVER_ERROR"}: ${serverMessage}`, ErrorCode.failedToFetchAvatarMetadata);
 			}
-			logMetric("fetch_avatar_metadata_latency", Date.now() - startTime, {}, {
+			logMetric("fetch_avatar_metadata_latency", Date.now() - startTime, { result: "success" }, {
 				avatar_id: characterId,
 				trace_id: traceId
 			});
@@ -775,6 +812,11 @@ var AvatarDownloader = class {
 			}
 			logger.error("Failed to fetch character:", error);
 			if (error instanceof AvatarError) {
+				logMetric("fetch_avatar_metadata_latency", Date.now() - startTime, { result: error.code }, {
+					avatar_id: characterId,
+					trace_id: traceId,
+					description: error.message
+				});
 				logEvent("fetch_avatar_metadata_failed", "error", {
 					avatar_id: characterId ?? "unknown",
 					description: error.message,
@@ -784,6 +826,11 @@ var AvatarDownloader = class {
 			}
 			const errorMessage = error && typeof error === "object" && "message" in error ? String(error.message) : "Failed to fetch character";
 			const dataMessage = error && typeof error === "object" && "data" in error && typeof error.data === "object" && error.data?.message ? String(error.data.message) : null;
+			logMetric("fetch_avatar_metadata_latency", Date.now() - startTime, { result: "network_error" }, {
+				avatar_id: characterId,
+				trace_id: traceId,
+				description: dataMessage || errorMessage
+			});
 			logEvent("fetch_avatar_metadata_failed", "error", {
 				avatar_id: characterId ?? "unknown",
 				description: dataMessage || errorMessage,

package/dist/assets/{AvatarSDK-DX8_-oyi.js → AvatarSDK-vQTYP0IB.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { $ as INVALID_SPAN_CONTEXT, A as BindOnceFuture, B as ATTR_EXCEPTION_STACKTRACE, C as JSON_ENCODER, Ct as LogLevel, D as OTLPExporterBase, E as toAttributes, F as isTimeInput, G as globalErrorHandler, H as ATTR_SERVICE_NAME, I as isTimeInputHrTime, J as trace, K as isTracingSuppressed, L as millisToHrTime, M as addHrTimes, N as hrTime, O as defaultResource, P as hrTimeDuration, Q as isValidTraceId, R as otperformance, S as createLegacyOtlpBrowserExportDelegate, T as createResource, U as getNumberFromEnv, V as ATTR_EXCEPTION_TYPE, W as getStringFromEnv, X as context, Y as diag$1, Z as isSpanContextValid, _ as cleanupOtelMetrics, a as clientContextFields, at as DiagAPI, b as getSdkPackage, c as logEvent, ct as unregisterGlobal, d as cleanupOtel, dt as OTEL_STREAM_NAME, et as TraceFlags, f as initializeOtel, ft as OTEL_TRACES_ENDPOINT, g as observeExporter, gt as idManager, i as cleanupPostHog, it as createContextKey, j as ExportResultCode, k as resourceFromAttributes, lt as OTEL_LOGS_ENDPOINT, m as fetchBootstrap, mt as OTEL_USERNAME, n as setLogLevel, nt as createNoopMeter, o as getLogsFeatureFlag, ot as getGlobal, p as clockSync, pt as OTEL_TRACES_STREAM_NAME, q as suppressTracing, r as logSink, rt as ROOT_CONTEXT, s as initializePostHog, st as registerGlobal, t as logger, tt as ContextAPI, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_PASSWORD, v as initializeOtelMetrics, w as createInstrumentationScope, x as resolveSdkVersion, xt as DrivingServiceMode, z as ATTR_EXCEPTION_MESSAGE } from "./logger-__jZD7QG.js";
+import { $ as INVALID_SPAN_CONTEXT, A as BindOnceFuture, B as ATTR_EXCEPTION_STACKTRACE, C as JSON_ENCODER, Ct as LogLevel, D as OTLPExporterBase, E as toAttributes, F as isTimeInput, G as globalErrorHandler, H as ATTR_SERVICE_NAME, I as isTimeInputHrTime, J as trace, K as isTracingSuppressed, L as millisToHrTime, M as addHrTimes, N as hrTime, O as defaultResource, P as hrTimeDuration, Q as isValidTraceId, R as otperformance, S as createLegacyOtlpBrowserExportDelegate, T as createResource, U as getNumberFromEnv, V as ATTR_EXCEPTION_TYPE, W as getStringFromEnv, X as context, Y as diag$1, Z as isSpanContextValid, _ as cleanupOtelMetrics, a as clientContextFields, at as DiagAPI, b as getSdkPackage, c as logEvent, ct as unregisterGlobal, d as cleanupOtel, dt as OTEL_STREAM_NAME, et as TraceFlags, f as initializeOtel, ft as OTEL_TRACES_ENDPOINT, g as observeExporter, gt as idManager, i as cleanupPostHog, it as createContextKey, j as ExportResultCode, k as resourceFromAttributes, lt as OTEL_LOGS_ENDPOINT, m as fetchBootstrap, mt as OTEL_USERNAME, n as setLogLevel, nt as createNoopMeter, o as getLogsFeatureFlag, ot as getGlobal, p as clockSync, pt as OTEL_TRACES_STREAM_NAME, q as suppressTracing, r as logSink, rt as ROOT_CONTEXT, s as initializePostHog, st as registerGlobal, t as logger, tt as ContextAPI, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_PASSWORD, v as initializeOtelMetrics, w as createInstrumentationScope, x as resolveSdkVersion, xt as DrivingServiceMode, z as ATTR_EXCEPTION_MESSAGE } from "./logger-CnIdJBOF.js";
 //#region node_modules/.pnpm/@opentelemetry+api@1.9.1/node_modules/@opentelemetry/api/build/esm/baggage/internal/baggage-impl.js
 var BaggageImpl = class BaggageImpl {
 	constructor(entries) {
@@ -5791,7 +5791,8 @@ function createBaseServerResponseAnimation() {
 		reqId: "",
 		end: false,
 		animation: void 0,
-		avatarId: ""
+		avatarId: "",
+		traceContext: void 0
 	};
 }
 const ServerResponseAnimation = {
@@ -5801,6 +5802,7 @@ const ServerResponseAnimation = {
 		if (message.end !== false) writer.uint32(24).bool(message.end);
 		if (message.animation !== void 0) FlameAnimation.encode(message.animation, writer.uint32(34).fork()).join();
 		if (message.avatarId !== "") writer.uint32(42).string(message.avatarId);
+		if (message.traceContext !== void 0) TraceContext.encode(message.traceContext, writer.uint32(50).fork()).join();
 		return writer;
 	},
 	decode(input, length) {
@@ -5830,6 +5832,10 @@ const ServerResponseAnimation = {
 					if (tag !== 42) break;
 					message.avatarId = reader.string();
 					continue;
+				case 6:
+					if (tag !== 50) break;
+					message.traceContext = TraceContext.decode(reader, reader.uint32());
+					continue;
 			}
 			if ((tag & 7) === 4 || tag === 0) break;
 			reader.skip(tag & 7);
@@ -5842,7 +5848,8 @@ const ServerResponseAnimation = {
 			reqId: isSet(object.reqId) ? globalThis.String(object.reqId) : isSet(object.req_id) ? globalThis.String(object.req_id) : "",
 			end: isSet(object.end) ? globalThis.Boolean(object.end) : false,
 			animation: isSet(object.animation) ? FlameAnimation.fromJSON(object.animation) : void 0,
-			avatarId: isSet(object.avatarId) ? globalThis.String(object.avatarId) : isSet(object.avatar_id) ? globalThis.String(object.avatar_id) : ""
+			avatarId: isSet(object.avatarId) ? globalThis.String(object.avatarId) : isSet(object.avatar_id) ? globalThis.String(object.avatar_id) : "",
+			traceContext: isSet(object.traceContext) ? TraceContext.fromJSON(object.traceContext) : isSet(object.trace_context) ? TraceContext.fromJSON(object.trace_context) : void 0
 		};
 	},
 	toJSON(message) {
@@ -5852,6 +5859,7 @@ const ServerResponseAnimation = {
 		if (message.end !== false) obj.end = message.end;
 		if (message.animation !== void 0) obj.animation = FlameAnimation.toJSON(message.animation);
 		if (message.avatarId !== "") obj.avatarId = message.avatarId;
+		if (message.traceContext !== void 0) obj.traceContext = TraceContext.toJSON(message.traceContext);
 		return obj;
 	},
 	create(base) {
@@ -5864,6 +5872,7 @@ const ServerResponseAnimation = {
 		message.end = object.end ?? false;
 		message.animation = object.animation !== void 0 && object.animation !== null ? FlameAnimation.fromPartial(object.animation) : void 0;
 		message.avatarId = object.avatarId ?? "";
+		message.traceContext = object.traceContext !== void 0 && object.traceContext !== null ? TraceContext.fromPartial(object.traceContext) : void 0;
 		return message;
 	}
 };
@@ -6223,7 +6232,7 @@ var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.4";
+	static _version = "1.3.5-beta.1";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;
@@ -6412,7 +6421,7 @@ var AvatarSDK = class {
 		logger.log("[AvatarSDK] Loading template resources...");
 		logEvent("template_init_start", "info", { stage: "sdk_init" });
 		try {
-			const { AvatarDownloader } = await import("./AvatarDownloader-DkReeoUZ.js");
+			const { AvatarDownloader } = await import("./AvatarDownloader-DImd24mo.js");
 			const templateResources = await new AvatarDownloader().loadUnifiedTemplate();
 			if (await this._avatarCore.loadTemplateResourcesFromBuffers(templateResources)) logger.log("[AvatarSDK] Template resources initialized successfully");
 			else logger.log("[AvatarSDK] Template resources already initialized, skipping...");

package/dist/assets/{OpusDecoderWorker.worker-BAd4MYA3.js → OpusDecoderWorker.worker-DkKhJmGs.js}

@@ -1,5 +1,5 @@
 import { r as __toESM, t as __commonJSMin } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-__jZD7QG.js";
+import { t as logger } from "./logger-CnIdJBOF.js";
 //#region __vite-browser-external
 var require___vite_browser_external = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {};

package/dist/assets/{OpusEncoderWorker.worker-DdhFHkno.js → OpusEncoderWorker.worker-Bu8QRO55.js}

@@ -1,5 +1,5 @@
 import { r as __toESM, t as __commonJSMin } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-__jZD7QG.js";
+import { t as logger } from "./logger-CnIdJBOF.js";
 //#region __vite-browser-external
 var require___vite_browser_external = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {};

package/dist/assets/{logger-__jZD7QG.js → logger-CnIdJBOF.js}

@@ -15449,7 +15449,7 @@ async function writeToLocalLog(message, level, extra = {}) {
 	try {
 		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
 		if (!shouldPersist) return;
-		const { AvatarSDK } = await import("./AvatarSDK-DX8_-oyi.js").then((n) => n.n);
+		const { AvatarSDK } = await import("./AvatarSDK-vQTYP0IB.js").then((n) => n.n);
 		const version = AvatarSDK.version;
 		const appId = idManager.getAppId();
 		const userId = idManager.getUserId();

package/dist/core/AvatarController.d.ts

@@ -87,6 +87,23 @@ export declare class AvatarController {
     private readonly MAX_AUDIO_TIME_STUCK_COUNT;
     private readonly AUDIO_TIME_STUCK_THRESHOLD;
     private latencyMarks;
+    /**
+     * W3C `traceparent` the driving service stamped on this round's animation
+     * packets (`ServerResponseAnimation.trace_context`), first one wins.
+     *
+     * Backend mode only, because only there is the SDK the FOLLOWER of the trace:
+     * the conversation_id is minted locally and never reaches the server, so the
+     * trace_id derived from it cannot match the server's and the round would
+     * otherwise report as a trace unrelated to the upstream one. In direct mode the
+     * SDK originates the trace (it sends buildTraceparent upstream on the first
+     * audio packet), so the echoed value is by construction the derived one and is
+     * not collected — see startPlaybackTrace.
+     *
+     * Read when the round's trace is built (at playback end), hence kept for the
+     * round rather than used on the spot. Reset per conversation alongside
+     * latencyMarks.
+     */
+    private serverTraceparent;
     /**
      * Per-call trace records for the current round, in call order. Unlike
      * latencyMarks (which aggregates arrival into per-second/per-group instants),

package/dist/{error-utils-B76Nf6d6.js → error-utils-CX5P3vnW.js}

@@ -1,4 +1,4 @@
-import { bt as isDebugMode } from "./logger-B_tTFAYq.js";
+import { bt as isDebugMode } from "./logger-BCrlTIt2.js";
 //#region config/app-config.ts
 var GLOBAL_FLAME_CDN_BASE = "https://cdn.spatialwalk.cloud/public";
 var CN_FLAME_CDN_BASE = "https://cdn.spatialwalk.top/public";

package/dist/index.js

@@ -1,10 +1,10 @@
-import { a as EgressType, c as TransportCompression, i as AudioFormat, l as BinaryReader, o as Message, r as avatarViewRegistry, s as MessageType, t as AvatarSDK, u as BinaryWriter } from "./AvatarSDK-BMjjoYiZ.js";
-import { At as DEFAULT_REGION_REQUEST, C as recordMetric, Ct as AnimationType, Dt as ConversationState, Et as ConnectionState, Ft as LogLevel, It as RENDER_QUALITY_PARAMS, Lt as RenderQuality, Mt as ErrorCode, Nt as FrameStarvationMode, Ot as DEFAULT_OPUS_BITRATE, Pt as LoadProgress, Rt as TransitionType, Tt as AvatarState, c as logEvent, g as clockSync, h as resolveMarks, jt as DrivingServiceMode, kt as DEFAULT_REGION, l as logMetric, m as monoTimestamp, p as monoMarkFrom, t as logger, wt as AvatarError, xt as idManager } from "./logger-B_tTFAYq.js";
-import { a as startLoadTrace, o as startPlaybackTrace, r as startConnectTrace, s as buildTraceparent } from "./otel-trace-DmmQrXv-.js";
-import { n as APP_CONFIG } from "./error-utils-B76Nf6d6.js";
-import { r as OggMuxer, t as OggPageSplitter } from "./OpusCodec-Cib3mtQ2.js";
-import { n as setOpusEncodeFrameSink } from "./OpusEncoderProxy-BiX90p4q.js";
-import { t as AvatarDownloader } from "./AvatarDownloader-CavxMpAz.js";
+import { a as startLoadTrace, c as AudioFormat, d as MessageType, f as TransportCompression, l as EgressType, m as BinaryWriter, o as startPlaybackTrace, p as BinaryReader, r as startConnectTrace, s as buildTraceparent, u as Message } from "./otel-trace-D2py5nQo.js";
+import { At as DEFAULT_REGION_REQUEST, C as recordMetric, Ct as AnimationType, Dt as ConversationState, Et as ConnectionState, Ft as LogLevel, It as RENDER_QUALITY_PARAMS, Lt as RenderQuality, Mt as ErrorCode, Nt as FrameStarvationMode, Ot as DEFAULT_OPUS_BITRATE, Pt as LoadProgress, Rt as TransitionType, Tt as AvatarState, c as logEvent, g as clockSync, h as resolveMarks, jt as DrivingServiceMode, kt as DEFAULT_REGION, l as logMetric, m as monoTimestamp, p as monoMarkFrom, t as logger, wt as AvatarError, xt as idManager } from "./logger-BCrlTIt2.js";
+import { n as APP_CONFIG } from "./error-utils-CX5P3vnW.js";
+import { r as OggMuxer, t as OggPageSplitter } from "./OpusCodec-BYwstcZb.js";
+import { r as avatarViewRegistry, t as AvatarSDK } from "./AvatarSDK-DCYDBMwd.js";
+import { n as setOpusEncodeFrameSink } from "./OpusEncoderProxy-CQrj6ZjY.js";
+import { t as AvatarDownloader } from "./AvatarDownloader-BLERPef7.js";
 //#region core/Avatar.ts
 var Avatar = class {
 	id;
@@ -125,11 +125,13 @@ function decodeAnimation(data, expectedAvatarId) {
 				avatarIdMismatch: true
 			};
 		}
+		const traceparent = response.traceContext?.traceparent || void 0;
 		return {
 			animation: {
 				keyframes: response.animation.keyframes,
 				avatarId,
-				end: response.end
+				end: response.end,
+				...traceparent ? { traceparent } : {}
 			},
 			avatarIdMismatch: false
 		};
@@ -311,8 +313,8 @@ var AnimationPlayer = class AnimationPlayer {
 	*/
 	async createAndInitializeStreamingPlayer() {
 		if (this.streamingPlayer) return;
-		const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-D5_x6veD.js");
-		const { AvatarSDK } = await import("./AvatarSDK-BMjjoYiZ.js").then((n) => n.n);
+		const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-BORop_1T.js");
+		const { AvatarSDK } = await import("./AvatarSDK-DCYDBMwd.js").then((n) => n.n);
 		const audioFormat = AvatarSDK.getAudioFormat();
 		this.streamingPlayer = new StreamingAudioPlayer({
 			sampleRate: audioFormat.sampleRate,
@@ -1352,7 +1354,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			return;
 		}
 		try {
-			const { OpusEncoderProxy } = await import("./OpusEncoderProxy-BiX90p4q.js").then((n) => n.t);
+			const { OpusEncoderProxy } = await import("./OpusEncoderProxy-CQrj6ZjY.js").then((n) => n.t);
 			const bitrate = opusBitrate ?? 48e3;
 			this.opusEncoder = await OpusEncoderProxy.create(sampleRate, bitrate);
 			this.uplinkIsOpus = true;
@@ -1528,6 +1530,15 @@ var AnimationWebSocketClient = class extends EventEmitter {
 							});
 							break;
 					}
+					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() || "",
+							close_code: event.code,
+							description: reason || `Closed with code ${event.code}`
+						});
+						this.connectStartMs = 0;
+					}
 					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", {
@@ -1617,7 +1628,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, {}, { connection_id: idManager.getConnectionId() || "" });
+						logMetric("ws_connect_latency", confirmMs - this.connectStartMs, { result: "success" }, { connection_id: idManager.getConnectionId() || "" });
 						this.emitConnectTrace(confirmMs);
 						this.connectStartMs = 0;
 					}
@@ -2274,6 +2285,23 @@ var AvatarController = class {
 		animGroupCount: 0
 	};
 	/**
+	* W3C `traceparent` the driving service stamped on this round's animation
+	* packets (`ServerResponseAnimation.trace_context`), first one wins.
+	*
+	* Backend mode only, because only there is the SDK the FOLLOWER of the trace:
+	* the conversation_id is minted locally and never reaches the server, so the
+	* trace_id derived from it cannot match the server's and the round would
+	* otherwise report as a trace unrelated to the upstream one. In direct mode the
+	* SDK originates the trace (it sends buildTraceparent upstream on the first
+	* audio packet), so the echoed value is by construction the derived one and is
+	* not collected — see startPlaybackTrace.
+	*
+	* Read when the round's trace is built (at playback end), hence kept for the
+	* round rather than used on the spot. Reset per conversation alongside
+	* latencyMarks.
+	*/
+	serverTraceparent = null;
+	/**
 	* Per-call trace records for the current round, in call order. Unlike
 	* latencyMarks (which aggregates arrival into per-second/per-group instants),
 	* these are one entry per actual API action, so each becomes a short span:
@@ -2604,7 +2632,7 @@ var AvatarController = class {
 			end_reason: this.playbackEndReason,
 			input_audio_format: resolveInputAudioFormat(),
 			uplink_audio_format: resolveUplinkAudioFormat()
-		});
+		}, this.serverTraceparent ?? void 0);
 		if (resolved && typeof tap0 === "number") {
 			const actionMarks = {};
 			this.traceActions.sends.forEach((s, i) => {
@@ -2794,7 +2822,7 @@ var AvatarController = class {
 		const { inputAudioFormat } = AvatarSDK.getAudioFormat();
 		if (inputAudioFormat !== "opus" || this.inputOpusDecoderProxy) return;
 		try {
-			const { OpusDecoderProxy } = await import("./OpusDecoderProxy-Dz21UtCz.js");
+			const { OpusDecoderProxy } = await import("./OpusDecoderProxy-DW_SVYwd.js");
 			this.inputOpusDecoderProxy = await OpusDecoderProxy.create();
 			this.inputDecodeChain = Promise.resolve();
 		} catch (error) {
@@ -3185,6 +3213,7 @@ var AvatarController = class {
 					logger.warn(`[AvatarController] Message chunk ${i + 1}: decode failed`);
 					continue;
 				}
+				if (!this.serverTraceparent && result.traceparent) this.serverTraceparent = result.traceparent;
 				allKeyframes.push(...result.keyframes);
 				if (result.end) isEnd = true;
 			} catch (error) {
@@ -3381,6 +3410,7 @@ var AvatarController = class {
 			decodes: [],
 			encodes: []
 		};
+		this.serverTraceparent = null;
 		this.decodeSpanStart = null;
 		this.decodeSpanBytes = 0;
 		this.lastOpusGranule = -1;
@@ -4021,6 +4051,7 @@ var AvatarManager = class AvatarManager {
 		const task = this.downloadQueue.shift();
 		this.currentTask = task;
 		logger.log(`[AvatarManager] Processing task: ${task.id} (${this.downloadQueue.length} items remaining)`);
+		const taskStartTime = Date.now();
 		try {
 			const avatar = await this.executeTask(task);
 			if (task.status === "cancelled") return;
@@ -4033,6 +4064,15 @@ var AvatarManager = class AvatarManager {
 			task.status = "failed";
 			const err = error instanceof Error ? error : new Error(String(error));
 			task._loadTrace?.end(false, Date.now(), { error: err.message });
+			logMetric("fetch_avatar_latency", Date.now() - taskStartTime, {
+				resolution: "default",
+				use_compressed_model: task.useCompressedModel,
+				cache_hit: false,
+				result: err instanceof AvatarError ? err.code : "unknown_error"
+			}, {
+				avatar_id: task.id,
+				description: err.message
+			});
 			this.notifyAllRequests(task, {
 				type: LoadProgress.failed,
 				error: err
@@ -4094,7 +4134,7 @@ var AvatarManager = class AvatarManager {
 			} else {
 				logger.log(`[AvatarManager] Avatar ${id} cache invalid: updatedAt=${cachedUpdatedAt}->${newUpdatedAt}, modelType=${cachedModelType}->${requestedModelType}, reloading...`);
 				this.avatarCache.delete(id);
-				const { PwaCacheManager } = await import("./pwa-cache-manager-BxeZI1BU.js").then((n) => n.n);
+				const { PwaCacheManager } = await import("./pwa-cache-manager-C7su6HpW.js").then((n) => n.n);
 				await PwaCacheManager.clearCharacterCache(id);
 			}
 		}
@@ -4138,7 +4178,8 @@ var AvatarManager = class AvatarManager {
 		logMetric("fetch_avatar_latency", Date.now() - startTime, {
 			resolution: "default",
 			use_compressed_model: task.useCompressedModel,
-			cache_hit: resources.cacheHit
+			cache_hit: resources.cacheHit,
+			result: "success"
 		}, { avatar_id: id });
 		return avatar;
 	}

package/dist/internal-telemetry.d.ts

@@ -48,7 +48,26 @@ export interface SpanGroup {
  * what lets the backend's spans join a round without threading state through;
  * reproducing that separately would mean two definitions of one wire contract.
  */
-export declare function startPlaybackTrace(conversationId: string, startTimeMs?: number, attrs?: Attributes): PlaybackTrace;
+export declare function startPlaybackTrace(conversationId: string, startTimeMs?: number, attrs?: Attributes, serverTraceparent?: string): PlaybackTrace;
+/**
+ * Read the W3C traceparent the driving service stamped on an animation
+ * message, without decoding its frames. Undefined when the message carries
+ * none, or is not parseable.
+ *
+ * For transports that hand the SDK an opaque animation payload and never see a
+ * request id — RTC being the case this exists for. There the round's id is
+ * minted locally and never travels upstream, so a trace_id derived from it has
+ * nothing to do with the server's, and one round reports as two unrelated
+ * traces. The traceparent riding the animation is what joins them; pass the
+ * result to `startPlaybackTrace`.
+ *
+ * Kept separate from decoding rather than folded into it: callers need this
+ * once per round while frames are decoded continuously.
+ *
+ * @param rawMessage the same bytes handed to the renderer — a serialized
+ *   `driveningress.v2.Message`.
+ */
+export declare function peekTraceparent(rawMessage: Uint8Array): string | undefined;
 /**
  * Record one measurement onto avatarkit's metric pipeline.
  *

package/dist/internal-telemetry.js

@@ -1,5 +1,5 @@
-import { C as recordMetric$1, E as setSdkIdentity$1, g as clockSync } from "./logger-B_tTFAYq.js";
-import { o as startPlaybackTrace$1 } from "./otel-trace-DmmQrXv-.js";
+import { o as startPlaybackTrace$1, u as Message } from "./otel-trace-D2py5nQo.js";
+import { C as recordMetric$1, E as setSdkIdentity$1, g as clockSync } from "./logger-BCrlTIt2.js";
 //#region internal-telemetry.ts
 /**
 * Internal telemetry surface for the companion RTC SDK.
@@ -50,8 +50,33 @@ function isClockCalibrated() {
 * what lets the backend's spans join a round without threading state through;
 * reproducing that separately would mean two definitions of one wire contract.
 */
-function startPlaybackTrace(conversationId, startTimeMs, attrs = {}) {
-	return startPlaybackTrace$1(conversationId, startTimeMs, attrs);
+function startPlaybackTrace(conversationId, startTimeMs, attrs = {}, serverTraceparent) {
+	return startPlaybackTrace$1(conversationId, startTimeMs, attrs, serverTraceparent);
+}
+/**
+* Read the W3C traceparent the driving service stamped on an animation
+* message, without decoding its frames. Undefined when the message carries
+* none, or is not parseable.
+*
+* For transports that hand the SDK an opaque animation payload and never see a
+* request id — RTC being the case this exists for. There the round's id is
+* minted locally and never travels upstream, so a trace_id derived from it has
+* nothing to do with the server's, and one round reports as two unrelated
+* traces. The traceparent riding the animation is what joins them; pass the
+* result to `startPlaybackTrace`.
+*
+* Kept separate from decoding rather than folded into it: callers need this
+* once per round while frames are decoded continuously.
+*
+* @param rawMessage the same bytes handed to the renderer — a serialized
+*   `driveningress.v2.Message`.
+*/
+function peekTraceparent(rawMessage) {
+	try {
+		return Message.decode(rawMessage).serverResponseAnimation?.traceContext?.traceparent || void 0;
+	} catch {
+		return;
+	}
 }
 /**
 * Record one measurement onto avatarkit's metric pipeline.
@@ -93,4 +118,4 @@ function setSdkIdentity(identity) {
 	setSdkIdentity$1(identity);
 }
 //#endregion
-export { isClockCalibrated, recordMetric, resolveMonoTimestamp, setSdkIdentity, startPlaybackTrace };
+export { isClockCalibrated, peekTraceparent, recordMetric, resolveMonoTimestamp, setSdkIdentity, startPlaybackTrace };

package/dist/{logger-B_tTFAYq.js → logger-BCrlTIt2.js}

@@ -15570,7 +15570,7 @@ async function writeToLocalLog(message, level, extra = {}) {
 	try {
 		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
 		if (!shouldPersist) return;
-		const { AvatarSDK } = await import("./AvatarSDK-BMjjoYiZ.js").then((n) => n.n);
+		const { AvatarSDK } = await import("./AvatarSDK-DCYDBMwd.js").then((n) => n.n);
 		const version = AvatarSDK.version;
 		const appId = idManager.getAppId();
 		const userId = idManager.getUserId();