@spatius/avatarkit 1.3.1 → 1.3.2

package/CHANGELOG.md

@@ -5,6 +5,11 @@ 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.2] - 2026-08-08
+
+### Fixed
+- Internal telemetry only, no change to public API or runtime behaviour: fixed the diagnostics the SDK reports to Spatius. Connection setup is now reported as two separate steps (handshake and session confirmation) instead of a single total, steps faster than a millisecond no longer come back out of order, and cache lookups that complete instantly are no longer reported as loads.
+
 ## [1.3.1] - 2026-08-07
 
 Rolls up everything from the 1.3.1 beta line.

package/dist/{AvatarDownloader-DyhenPKd.js → AvatarDownloader-BDKn8AjO.js}

@@ -1,8 +1,8 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as AvatarSDK } from "./AvatarSDK-DgPvHU4L.js";
-import { S as recordHttpClientDuration, c as logEvent, kt as ErrorCode, l as logMetric, t as logger, v as hostOf, xt as AvatarError, yt as generateTraceId } from "./logger-BOpQ7u0w.js";
-import { n as APP_CONFIG, r as getFlameCdnBase, t as errorToMessage } from "./error-utils-BogEllAd.js";
-import { t as PwaCacheManager } from "./pwa-cache-manager-C7NbU52Q.js";
+import { t as AvatarSDK } from "./AvatarSDK-DqP8n0ex.js";
+import { S as recordHttpClientDuration, c as logEvent, kt as ErrorCode, l as logMetric, t as logger, v as hostOf, xt as AvatarError, yt as generateTraceId } from "./logger-gpv4NaPj.js";
+import { n as APP_CONFIG, r as getFlameCdnBase, t as errorToMessage } from "./error-utils-D7aLxFrw.js";
+import { t as PwaCacheManager } from "./pwa-cache-manager-CcFR2ARt.js";
 //#region core/AvatarDownloader.ts
 var AvatarDownloader_exports = /* @__PURE__ */ __exportAll({ AvatarDownloader: () => AvatarDownloader });
 /**

package/dist/{AvatarSDK-DgPvHU4L.js → AvatarSDK-DqP8n0ex.js}

@@ -1,6 +1,6 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { Mt as LogLevel, Ot as DrivingServiceMode, _ as fetchBootstrap, a as clientContextFields, b as cleanupOtelMetrics, c as logEvent, d as cleanupOtel, dt as OTEL_LOGS_ENDPOINT, f as initializeOtel, ft as OTEL_PASSWORD, g as clockSync, gt as OTEL_USERNAME, i as cleanupPostHog, n as setLogLevel, o as getLogsFeatureFlag, pt as OTEL_STREAM_NAME, r as logSink, s as initializePostHog, t as logger, u as updatePostHogPersonPropertiesForFlags, vt as idManager, x as initializeOtelMetrics } from "./logger-BOpQ7u0w.js";
-import { n as initializeOtelTrace, r as startInitTrace, t as cleanupOtelTrace } from "./otel-trace-Ct4T48nC.js";
+import { Mt as LogLevel, Ot as DrivingServiceMode, _ as fetchBootstrap, a as clientContextFields, b as cleanupOtelMetrics, c as logEvent, d as cleanupOtel, dt as OTEL_LOGS_ENDPOINT, f as initializeOtel, ft as OTEL_PASSWORD, g as clockSync, gt as OTEL_USERNAME, i as cleanupPostHog, n as setLogLevel, o as getLogsFeatureFlag, pt as OTEL_STREAM_NAME, r as logSink, s as initializePostHog, t as logger, u as updatePostHogPersonPropertiesForFlags, vt as idManager, x as initializeOtelMetrics } from "./logger-gpv4NaPj.js";
+import { i as startInitTrace, n as initializeOtelTrace, t as cleanupOtelTrace } from "./otel-trace-M2fi3yoE.js";
 //#region node_modules/.pnpm/@bufbuild+protobuf@2.10.1/node_modules/@bufbuild/protobuf/dist/esm/wire/varint.js
 /**
 * Read a 64 bit varint as two JS numbers.
@@ -3900,7 +3900,7 @@ var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.1";
+	static _version = "1.3.2";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;
@@ -4089,7 +4089,7 @@ var AvatarSDK = class {
 		logger.log("[AvatarSDK] Loading template resources...");
 		logEvent("template_init_start", "info", { stage: "sdk_init" });
 		try {
-			const { AvatarDownloader } = await import("./AvatarDownloader-DyhenPKd.js").then((n) => n.n);
+			const { AvatarDownloader } = await import("./AvatarDownloader-BDKn8AjO.js").then((n) => n.n);
 			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/{OpusCodec-CXU7ysrU.js → OpusCodec-B0YtpenN.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-BOpQ7u0w.js";
+import { t as logger } from "./logger-gpv4NaPj.js";
 /** Opus granule positions are always in 48 kHz samples, regardless of input rate. */
 var OPUS_GRANULE_RATE = 48e3;
 /**

package/dist/{OpusDecoderProxy-Cq8Z_MZY.js → OpusDecoderProxy-vGagApTz.js}

@@ -1,4 +1,4 @@
-import { t as logger } from "./logger-BOpQ7u0w.js";
+import { t as logger } from "./logger-gpv4NaPj.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-CXU7ysrU.js").then((n) => n.n);
+		const { OggOpusDecoder } = await import("./OpusCodec-B0YtpenN.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 */
-					"/assets/OpusDecoderWorker.worker-C2T0afkj.js",
+					"/assets/OpusDecoderWorker.worker-Cp7jmav3.js",
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {

package/dist/{OpusEncoderProxy-CzY-VckE.js → OpusEncoderProxy-sMAwGYqf.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-BOpQ7u0w.js";
+import { t as logger } from "./logger-gpv4NaPj.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-CXU7ysrU.js").then((n) => n.n);
+		const { OggOpusEncoder } = await import("./OpusCodec-B0YtpenN.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 */
-					"/assets/OpusEncoderWorker.worker-DLYO9vPK.js",
+					"/assets/OpusEncoderWorker.worker-CQct4FWr.js",
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {

package/dist/{StreamingAudioPlayer-CIJmBp3z.js → StreamingAudioPlayer-DXsCXseQ.js}

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

package/dist/assets/{AvatarDownloader-G5FO1bVl.js → AvatarDownloader-u-f7nYVa.js}

@@ -1,5 +1,5 @@
-import { bt as ErrorCode, c as logEvent, gt as AvatarError, h as hostOf, ht as generateTraceId, l as logMetric, pt as isDebugMode, t as logger, y as recordHttpClientDuration } from "./logger-YPooEAbA.js";
-import { t as AvatarSDK } from "./AvatarSDK-C_Anluwp.js";
+import { bt as ErrorCode, c as logEvent, gt as AvatarError, h as hostOf, ht as generateTraceId, l as logMetric, pt as isDebugMode, t as logger, y as recordHttpClientDuration } from "./logger-D7nCOkvy.js";
+import { t as AvatarSDK } from "./AvatarSDK-bSFhbb92.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";

package/dist/assets/{AvatarSDK-C_Anluwp.js → AvatarSDK-bSFhbb92.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { $ as ContextAPI, A as addHrTimes, B as ATTR_SERVICE_NAME, C as createResource, D as resourceFromAttributes, E as defaultResource, F as millisToHrTime, G as suppressTracing, H as getStringFromEnv, I as otperformance, J as context, K as trace, L as ATTR_EXCEPTION_MESSAGE, M as hrTimeDuration, N as isTimeInput, O as BindOnceFuture, P as isTimeInputHrTime, Q as TraceFlags, R as ATTR_EXCEPTION_STACKTRACE, S as createInstrumentationScope, T as OTLPExporterBase, U as globalErrorHandler, V as getNumberFromEnv, W as isTracingSuppressed, X as isValidTraceId, Y as isSpanContextValid, Z as INVALID_SPAN_CONTEXT, _ as cleanupOtelMetrics, a as clientContextFields, at as registerGlobal, b as createLegacyOtlpBrowserExportDelegate, c as logEvent, ct as OTEL_PASSWORD, d as cleanupOtel, dt as OTEL_TRACES_STREAM_NAME, et as createNoopMeter, f as initializeOtel, ft as OTEL_USERNAME, g as observeExporter, i as cleanupPostHog, it as getGlobal, j as hrTime, k as ExportResultCode, lt as OTEL_STREAM_NAME, m as fetchBootstrap, mt as idManager, n as setLogLevel, nt as createContextKey, o as getLogsFeatureFlag, ot as unregisterGlobal, p as clockSync, q as diag$1, r as logSink, rt as DiagAPI, s as initializePostHog, st as OTEL_LOGS_ENDPOINT, t as logger, tt as ROOT_CONTEXT, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_TRACES_ENDPOINT, v as initializeOtelMetrics, w as toAttributes, x as JSON_ENCODER, xt as LogLevel, yt as DrivingServiceMode, z as ATTR_EXCEPTION_TYPE } from "./logger-YPooEAbA.js";
+import { $ as ContextAPI, A as addHrTimes, B as ATTR_SERVICE_NAME, C as createResource, D as resourceFromAttributes, E as defaultResource, F as millisToHrTime, G as suppressTracing, H as getStringFromEnv, I as otperformance, J as context, K as trace, L as ATTR_EXCEPTION_MESSAGE, M as hrTimeDuration, N as isTimeInput, O as BindOnceFuture, P as isTimeInputHrTime, Q as TraceFlags, R as ATTR_EXCEPTION_STACKTRACE, S as createInstrumentationScope, T as OTLPExporterBase, U as globalErrorHandler, V as getNumberFromEnv, W as isTracingSuppressed, X as isValidTraceId, Y as isSpanContextValid, Z as INVALID_SPAN_CONTEXT, _ as cleanupOtelMetrics, a as clientContextFields, at as registerGlobal, b as createLegacyOtlpBrowserExportDelegate, c as logEvent, ct as OTEL_PASSWORD, d as cleanupOtel, dt as OTEL_TRACES_STREAM_NAME, et as createNoopMeter, f as initializeOtel, ft as OTEL_USERNAME, g as observeExporter, i as cleanupPostHog, it as getGlobal, j as hrTime, k as ExportResultCode, lt as OTEL_STREAM_NAME, m as fetchBootstrap, mt as idManager, n as setLogLevel, nt as createContextKey, o as getLogsFeatureFlag, ot as unregisterGlobal, p as clockSync, q as diag$1, r as logSink, rt as DiagAPI, s as initializePostHog, st as OTEL_LOGS_ENDPOINT, t as logger, tt as ROOT_CONTEXT, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_TRACES_ENDPOINT, v as initializeOtelMetrics, w as toAttributes, x as JSON_ENCODER, xt as LogLevel, yt as DrivingServiceMode, z as ATTR_EXCEPTION_TYPE } from "./logger-D7nCOkvy.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) {
@@ -2460,7 +2460,7 @@ function startInitTrace(sessionId, startTimeMs, attrs = {}) {
 						attributes: spanAttrs
 					}, rootCtx);
 					if (isError) sp.setStatus({ code: SpanStatusCode.ERROR });
-					sp.end(endMs);
+					sp.end(Math.max(endMs, startMs + 1));
 				} catch {}
 			},
 			group: () => NOOP_GROUP,
@@ -6223,7 +6223,7 @@ var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.1";
+	static _version = "1.3.2";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;
@@ -6412,7 +6412,7 @@ var AvatarSDK = class {
 		logger.log("[AvatarSDK] Loading template resources...");
 		logEvent("template_init_start", "info", { stage: "sdk_init" });
 		try {
-			const { AvatarDownloader } = await import("./AvatarDownloader-G5FO1bVl.js");
+			const { AvatarDownloader } = await import("./AvatarDownloader-u-f7nYVa.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-C2T0afkj.js → OpusDecoderWorker.worker-Cp7jmav3.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-YPooEAbA.js";
+import { t as logger } from "./logger-D7nCOkvy.js";
 //#region __vite-browser-external
 var require___vite_browser_external = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {};

package/dist/assets/{OpusEncoderWorker.worker-DLYO9vPK.js → OpusEncoderWorker.worker-CQct4FWr.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-YPooEAbA.js";
+import { t as logger } from "./logger-D7nCOkvy.js";
 //#region __vite-browser-external
 var require___vite_browser_external = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {};

package/dist/assets/{logger-YPooEAbA.js → logger-D7nCOkvy.js}

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

package/dist/{error-utils-BogEllAd.js → error-utils-D7aLxFrw.js}

@@ -1,4 +1,4 @@
-import { _t as isDebugMode } from "./logger-BOpQ7u0w.js";
+import { _t as isDebugMode } from "./logger-gpv4NaPj.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-DgPvHU4L.js";
-import { At as FrameStarvationMode, C as recordMetric, Ct as ConnectionState, Dt as DEFAULT_REGION_REQUEST, Et as DEFAULT_REGION, Ft as TransitionType, Mt as LogLevel, Nt as RENDER_QUALITY_PARAMS, Ot as DrivingServiceMode, Pt as RenderQuality, St as AvatarState, Tt as DEFAULT_OPUS_BITRATE, bt as AnimationType, c as logEvent, g as clockSync, h as resolveMarks, jt as LoadProgress, kt as ErrorCode, l as logMetric, m as monoTimestamp, p as monoMarkFrom, t as logger, vt as idManager, wt as ConversationState, xt as AvatarError } from "./logger-BOpQ7u0w.js";
-import { a as startPlaybackTrace, i as startLoadTrace, o as buildTraceparent } from "./otel-trace-Ct4T48nC.js";
-import { n as APP_CONFIG } from "./error-utils-BogEllAd.js";
-import { r as OggMuxer, t as OggPageSplitter } from "./OpusCodec-CXU7ysrU.js";
-import { n as setOpusEncodeFrameSink } from "./OpusEncoderProxy-CzY-VckE.js";
-import { t as AvatarDownloader } from "./AvatarDownloader-DyhenPKd.js";
+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-DqP8n0ex.js";
+import { At as FrameStarvationMode, C as recordMetric, Ct as ConnectionState, Dt as DEFAULT_REGION_REQUEST, Et as DEFAULT_REGION, Ft as TransitionType, Mt as LogLevel, Nt as RENDER_QUALITY_PARAMS, Ot as DrivingServiceMode, Pt as RenderQuality, St as AvatarState, Tt as DEFAULT_OPUS_BITRATE, bt as AnimationType, c as logEvent, g as clockSync, h as resolveMarks, jt as LoadProgress, kt as ErrorCode, l as logMetric, m as monoTimestamp, p as monoMarkFrom, t as logger, vt as idManager, wt as ConversationState, xt as AvatarError } from "./logger-gpv4NaPj.js";
+import { a as startLoadTrace, o as startPlaybackTrace, r as startConnectTrace, s as buildTraceparent } from "./otel-trace-M2fi3yoE.js";
+import { n as APP_CONFIG } from "./error-utils-D7aLxFrw.js";
+import { r as OggMuxer, t as OggPageSplitter } from "./OpusCodec-B0YtpenN.js";
+import { n as setOpusEncodeFrameSink } from "./OpusEncoderProxy-sMAwGYqf.js";
+import { t as AvatarDownloader } from "./AvatarDownloader-BDKn8AjO.js";
 //#region core/Avatar.ts
 var Avatar = class {
 	id;
@@ -311,8 +311,8 @@ var AnimationPlayer = class AnimationPlayer {
 	*/
 	async createAndInitializeStreamingPlayer() {
 		if (this.streamingPlayer) return;
-		const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-CIJmBp3z.js");
-		const { AvatarSDK } = await import("./AvatarSDK-DgPvHU4L.js").then((n) => n.n);
+		const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-DXsCXseQ.js");
+		const { AvatarSDK } = await import("./AvatarSDK-DqP8n0ex.js").then((n) => n.n);
 		const audioFormat = AvatarSDK.getAudioFormat();
 		this.streamingPlayer = new StreamingAudioPlayer({
 			sampleRate: audioFormat.sampleRate,
@@ -952,6 +952,15 @@ var AnimationWebSocketClient = class extends EventEmitter {
 	sessionConfigured = false;
 	connectionStartTime = 0;
 	/**
+	* 连接发起时刻（`new WebSocket()` 之前）。
+	*
+	* `ws_connect_latency` 与 connect trace 都以它为起点。与 `connectionStartTime`
+	* 分开：那个是「连接建立成功」的时刻，用来算 session 时长，语义不同。
+	*/
+	connectStartMs = 0;
+	/** 握手完成（onopen）时刻，用来把连接拆成握手 / 会话确认两段。 */
+	wsOpenMs = 0;
+	/**
 	* Opus encoder proxy, created only when the SDK-decided uplink is Opus. Null
 	* means audio is sent as raw PCM. Scoped to one connection: created
 	* on connect, destroyed on disconnect. Runs the encode off the main thread via
@@ -1343,7 +1352,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			return;
 		}
 		try {
-			const { OpusEncoderProxy } = await import("./OpusEncoderProxy-CzY-VckE.js").then((n) => n.t);
+			const { OpusEncoderProxy } = await import("./OpusEncoderProxy-sMAwGYqf.js").then((n) => n.t);
 			const bitrate = opusBitrate ?? 48e3;
 			this.opusEncoder = await OpusEncoderProxy.create(sampleRate, bitrate);
 			this.uplinkIsOpus = true;
@@ -1399,19 +1408,39 @@ var AnimationWebSocketClient = class extends EventEmitter {
 		if (connectionId) url.searchParams.set("connection_id", connectionId);
 		return url.toString();
 	}
+	/**
+	* 发一条建连 trace：`connect` 下挂 `ws_handshake` / `session_confirm` 两段。
+	*
+	* 在会话确认时一次性回填（两段的时刻都已知），而不是实时开 span——建连全程只有
+	* 两个边界点，回填式更简单，也与 init / load trace 的做法一致。
+	*/
+	emitConnectTrace(confirmMs) {
+		const start = this.connectStartMs;
+		const open = this.wsOpenMs;
+		if (start <= 0 || open <= 0) return;
+		const t = startConnectTrace(start, {
+			connection_id: idManager.getConnectionId() ?? "",
+			region: AvatarSDK.configuration?.region ?? ""
+		});
+		t.span("ws_handshake", start, open, { dur_ms: open - start });
+		t.span("session_confirm", open, confirmMs, { dur_ms: confirmMs - open });
+		t.end(true, confirmMs, { dur_ms: confirmMs - start });
+		this.wsOpenMs = 0;
+	}
 	connectWebSocket(url) {
 		return new Promise((resolve, reject) => {
 			try {
 				const urlForLog = this.sanitizeUrlForLog(url);
 				logger.log(`[AnimationWebSocketClient] Connecting to WebSocket: ${urlForLog}`);
-				const connectStartMs = Date.now();
+				this.connectStartMs = Date.now();
+				this.wsOpenMs = 0;
 				this.ws = new WebSocket(url);
 				this.ws.onopen = () => {
 					this.isConnecting = false;
 					this.currentRetryCount = 0;
 					this.isManuallyDisconnected = false;
 					this.connectionStartTime = Date.now();
-					logMetric("ws_connect_latency", this.connectionStartTime - connectStartMs, {}, { connection_id: idManager.getConnectionId() || "" });
+					this.wsOpenMs = this.connectionStartTime;
 					logger.log(`[AnimationWebSocketClient] WebSocket connected successfully`);
 					this.configureSession();
 					this.emit("connected");
@@ -1586,6 +1615,12 @@ var AnimationWebSocketClient = class extends EventEmitter {
 						idManager.setConnectionId(connectionId);
 						logger.log(`[AnimationWebSocketClient] Session confirmed, connection_id updated: ${connectionId}`);
 					} 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() || "" });
+						this.emitConnectTrace(confirmMs);
+						this.connectStartMs = 0;
+					}
 					this.flushPendingAudio();
 					this.emit("sessionConfirmed", connectionId);
 					return;
@@ -2759,7 +2794,7 @@ var AvatarController = class {
 		const { inputAudioFormat } = AvatarSDK.getAudioFormat();
 		if (inputAudioFormat !== "opus" || this.inputOpusDecoderProxy) return;
 		try {
-			const { OpusDecoderProxy } = await import("./OpusDecoderProxy-Cq8Z_MZY.js");
+			const { OpusDecoderProxy } = await import("./OpusDecoderProxy-vGagApTz.js");
 			this.inputOpusDecoderProxy = await OpusDecoderProxy.create();
 			this.inputDecodeChain = Promise.resolve();
 		} catch (error) {
@@ -4059,7 +4094,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-C7NbU52Q.js").then((n) => n.n);
+				const { PwaCacheManager } = await import("./pwa-cache-manager-CcFR2ARt.js").then((n) => n.n);
 				await PwaCacheManager.clearCharacterCache(id);
 			}
 		}
@@ -4138,13 +4173,7 @@ var AvatarManager = class AvatarManager {
 	* @returns Avatar instance, or undefined if not in cache
 	*/
 	retrieve(id) {
-		const trace = startLoadTrace(id, Date.now(), { source: "cache" });
-		const cached = this.avatarCache.get(id);
-		trace.end(true, Date.now(), {
-			result: cached ? "hit" : "miss",
-			cache_hit: cached !== void 0
-		});
-		return cached;
+		return this.avatarCache.get(id);
 	}
 	/**
 	* Clear cached avatar for specified ID

package/dist/internal-telemetry.js

@@ -1,5 +1,5 @@
-import { C as recordMetric$1, g as clockSync } from "./logger-BOpQ7u0w.js";
-import { a as startPlaybackTrace$1 } from "./otel-trace-Ct4T48nC.js";
+import { C as recordMetric$1, g as clockSync } from "./logger-gpv4NaPj.js";
+import { o as startPlaybackTrace$1 } from "./otel-trace-M2fi3yoE.js";
 //#region internal-telemetry.ts
 /**
 * Internal telemetry surface for the companion RTC SDK.

package/dist/{logger-BOpQ7u0w.js → logger-gpv4NaPj.js}

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

package/dist/{otel-trace-Ct4T48nC.js → otel-trace-M2fi3yoE.js}

@@ -1,4 +1,4 @@
-import { $ as isSpanContextValid, A as defaultResource, B as otperformance, D as createResource, E as createInstrumentationScope, F as hrTime, G as getNumberFromEnv, H as ATTR_EXCEPTION_STACKTRACE, I as hrTimeDuration, J as isTracingSuppressed, K as getStringFromEnv, L as isTimeInput, M as BindOnceFuture, N as ExportResultCode, O as toAttributes, P as addHrTimes, Q as context, R as isTimeInputHrTime, T as JSON_ENCODER, U as ATTR_EXCEPTION_TYPE, V as ATTR_EXCEPTION_MESSAGE, W as ATTR_SERVICE_NAME, X as trace, Y as suppressTracing, Z as diag$1, a as clientContextFields, at as ROOT_CONTEXT, ct as getGlobal, et as isValidTraceId, ft as OTEL_PASSWORD, gt as OTEL_USERNAME, ht as OTEL_TRACES_STREAM_NAME, it as createNoopMeter, j as resourceFromAttributes, k as OTLPExporterBase, lt as registerGlobal, mt as OTEL_TRACES_ENDPOINT, nt as TraceFlags, ot as createContextKey, q as globalErrorHandler, rt as ContextAPI, st as DiagAPI, t as logger, tt as INVALID_SPAN_CONTEXT, ut as unregisterGlobal, vt as idManager, w as createLegacyOtlpBrowserExportDelegate, y as observeExporter, z as millisToHrTime } from "./logger-BOpQ7u0w.js";
+import { $ as isSpanContextValid, A as defaultResource, B as otperformance, D as createResource, E as createInstrumentationScope, F as hrTime, G as getNumberFromEnv, H as ATTR_EXCEPTION_STACKTRACE, I as hrTimeDuration, J as isTracingSuppressed, K as getStringFromEnv, L as isTimeInput, M as BindOnceFuture, N as ExportResultCode, O as toAttributes, P as addHrTimes, Q as context, R as isTimeInputHrTime, T as JSON_ENCODER, U as ATTR_EXCEPTION_TYPE, V as ATTR_EXCEPTION_MESSAGE, W as ATTR_SERVICE_NAME, X as trace, Y as suppressTracing, Z as diag$1, a as clientContextFields, at as ROOT_CONTEXT, ct as getGlobal, et as isValidTraceId, ft as OTEL_PASSWORD, gt as OTEL_USERNAME, ht as OTEL_TRACES_STREAM_NAME, it as createNoopMeter, j as resourceFromAttributes, k as OTLPExporterBase, lt as registerGlobal, mt as OTEL_TRACES_ENDPOINT, nt as TraceFlags, ot as createContextKey, q as globalErrorHandler, rt as ContextAPI, st as DiagAPI, t as logger, tt as INVALID_SPAN_CONTEXT, ut as unregisterGlobal, vt as idManager, w as createLegacyOtlpBrowserExportDelegate, y as observeExporter, z as millisToHrTime } from "./logger-gpv4NaPj.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) {
@@ -2399,7 +2399,7 @@ function startInitTrace(sessionId, startTimeMs, attrs = {}) {
 						attributes: spanAttrs
 					}, rootCtx);
 					if (isError) sp.setStatus({ code: SpanStatusCode.ERROR });
-					sp.end(endMs);
+					sp.end(Math.max(endMs, startMs + 1));
 				} catch {}
 			},
 			group: () => NOOP_GROUP,
@@ -2436,7 +2436,7 @@ function startLoadTrace(avatarId, startTimeMs, attrs = {}) {
 						attributes: spanAttrs
 					}, rootCtx);
 					if (isError) s.setStatus({ code: SpanStatusCode.ERROR });
-					s.end(endMs);
+					s.end(Math.max(endMs, startMs + 1));
 				} catch {}
 			},
 			group: () => NOOP_GROUP,
@@ -2454,6 +2454,52 @@ function startLoadTrace(avatarId, startTimeMs, attrs = {}) {
 	}
 }
 /**
+* 开一条建连 trace。root span 名 `connect`，下挂 `ws_handshake` / `session_confirm` 两段。
+*
+* 与 `ws_connect_latency` 互补：那条 metric 只给出总耗时，而慢在哪一段——TLS/网络握手，
+* 还是服务端校验 token、分配资源——只有拆开才看得出。两段的边界就是 `onopen`。
+*
+* 与 load / playback 是三条独立 trace，靠 session_id 关联。
+* @param startTimeMs root span 起点（发起连接那一刻，epoch ms）。
+* @internal
+*/
+function startConnectTrace(startTimeMs, attrs = {}) {
+	if (!tracer || !tracerProvider) return NOOP_TRACE;
+	try {
+		const root = tracer.startSpan("connect", {
+			startTime: startTimeMs,
+			attributes: {
+				session_id: idManager.getSessionId(),
+				...attrs
+			}
+		}, ROOT_CONTEXT);
+		const rootCtx = trace.setSpan(ROOT_CONTEXT, root);
+		return {
+			span(name, startMs, endMs, spanAttrs = {}, isError = false) {
+				try {
+					const s = tracer.startSpan(name, {
+						startTime: startMs,
+						attributes: spanAttrs
+					}, rootCtx);
+					if (isError) s.setStatus({ code: SpanStatusCode.ERROR });
+					s.end(Math.max(endMs, startMs + 1));
+				} catch {}
+			},
+			group: () => NOOP_GROUP,
+			end(ok = true, endTimeMs, endAttrs = {}) {
+				try {
+					for (const [k, v] of Object.entries(endAttrs)) root.setAttribute(k, v);
+					root.setStatus({ code: ok ? SpanStatusCode.OK : SpanStatusCode.ERROR });
+					root.end(endTimeMs);
+				} catch {}
+			}
+		};
+	} catch (error) {
+		logger.warn("[OTel-Trace] Failed to start connect trace:", error instanceof Error ? error.message : String(error));
+		return NOOP_TRACE;
+	}
+}
+/**
 * 开一条播放 trace。root span 名 `playback`，trace_id 由 conversation_id 确定性派生，
 * conversation_id 同时作为 span 属性（无论是否与后端串成一条 trace，都能按它关联查询）。
 * @param startTimeMs root span 起点（首包音频 tap_0 的真实时刻，epoch ms）；省略则用当前时刻。
@@ -2497,7 +2543,7 @@ function startPlaybackTrace(conversationId, startTimeMs, attrs = {}) {
 					startTime: startMs
 				}, ctx);
 				if (isError) s.setStatus({ code: SpanStatusCode.ERROR });
-				s.end(endMs);
+				s.end(Math.max(endMs, startMs + 1));
 			} catch {}
 		};
 		return {
@@ -2562,4 +2608,4 @@ function cleanupOtelTrace() {
 	}
 }
 //#endregion
-export { startPlaybackTrace as a, startLoadTrace as i, initializeOtelTrace as n, buildTraceparent as o, startInitTrace as r, cleanupOtelTrace as t };
+export { startLoadTrace as a, startInitTrace as i, initializeOtelTrace as n, startPlaybackTrace as o, startConnectTrace as r, buildTraceparent as s, cleanupOtelTrace as t };

package/dist/{pwa-cache-manager-C7NbU52Q.js → pwa-cache-manager-CcFR2ARt.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-BOpQ7u0w.js";
+import { t as logger } from "./logger-gpv4NaPj.js";
 //#region utils/pwa-cache-manager.ts
 /**
 * PWA Cache Manager

package/package.json

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