@spatius/avatarkit 1.3.1-beta.6 → 1.3.1

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

@@ -1156,6 +1156,28 @@ var DrivingServiceMode = /* @__PURE__ */ function(DrivingServiceMode) {
 	DrivingServiceMode["direct"] = "direct";
 	/** Driven by host application */
 	DrivingServiceMode["backend"] = "backend";
+	/**
+	* Use this **only** when driving the avatar through the companion RTC SDK,
+	* `@spatius/avatarkit-rtc`. If you are not using that package, stay on
+	* `direct` / `backend` — do not switch to this because it looks newer.
+	*
+	* **Telemetry dimension only — it gates no behaviour.** Every session reports
+	* `dsm`; without a value of its own, RTC traffic would be indistinguishable
+	* from plain `backend` traffic on the dashboards.
+	*
+	* It deliberately does not unlock any API. RTC drives the avatar frame by
+	* frame through `AvatarView.renderFrame` / `renderFromProtobuf`, which put the
+	* view into pure-rendering mode on their own — it never calls the host-driven
+	* feeding path (`yieldAudioData` / `yieldFramesData`) that `backend` exists
+	* for. So the `=== backend` checks guarding those methods are left untouched:
+	* loosening them for `rtc` would widen the reachable API surface without
+	* enabling anything RTC actually uses.
+	*
+	* Note the two concepts sit at different levels and are not interchangeable:
+	* pure-rendering mode is a per-frame runtime state of the render loop, while
+	* this is a session-wide value declared once at `initialize`.
+	*/
+	DrivingServiceMode["rtc"] = "rtc";
 	return DrivingServiceMode;
 }({});
 /**
@@ -7190,7 +7212,7 @@ var customRandom = (alphabet, defaultSize, getRandom) => {
 	};
 };
 var customAlphabet = (alphabet, size = 21) => customRandom(alphabet, size | 0, random);
-var nanoid$1 = (size = 21) => {
+var nanoid$2 = (size = 21) => {
 	let id = "";
 	let bytes = crypto.getRandomValues(new Uint8Array(size |= 0));
 	while (size--) id += urlAlphabet[bytes[size] & 63];
@@ -7215,11 +7237,11 @@ function getOrCreateClientId() {
 	try {
 		const stored = localStorage.getItem(CLIENT_ID_STORAGE_KEY);
 		if (stored) return stored;
-		const clientId = nanoid$1(21);
+		const clientId = nanoid$2(21);
 		localStorage.setItem(CLIENT_ID_STORAGE_KEY, clientId);
 		return clientId;
 	} catch (error) {
-		return `temp_${nanoid$1(21)}_${Date.now()}`;
+		return `temp_${nanoid$2(21)}_${Date.now()}`;
 	}
 }
 //#endregion
@@ -7237,7 +7259,7 @@ function getOrCreateClientId() {
 * Custom character set: only uppercase, lowercase letters and numbers (URL safe, no hyphens)
 * Character set: A-Z, a-z, 0-9 (62 characters)
 */
-var nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
+var nanoid$1 = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
 /**
 * Generate unified conversation ID
 * 
@@ -7252,7 +7274,7 @@ var nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxy
 var generateTraceId = () => generateConversationId();
 function generateConversationId() {
 	const now = /* @__PURE__ */ new Date();
-	return `${`${now.getUTCFullYear()}${String(now.getUTCMonth() + 1).padStart(2, "0")}${String(now.getUTCDate()).padStart(2, "0")}${String(now.getUTCHours()).padStart(2, "0")}${String(now.getUTCMinutes()).padStart(2, "0")}${String(now.getUTCSeconds()).padStart(2, "0")}`}_${nanoid()}`;
+	return `${`${now.getUTCFullYear()}${String(now.getUTCMonth() + 1).padStart(2, "0")}${String(now.getUTCDate()).padStart(2, "0")}${String(now.getUTCHours()).padStart(2, "0")}${String(now.getUTCMinutes()).padStart(2, "0")}${String(now.getUTCSeconds()).padStart(2, "0")}`}_${nanoid$1()}`;
 }
 //#endregion
 //#region utils/id-manager.ts
@@ -7261,9 +7283,12 @@ function generateConversationId() {
 * Unified management of all types of IDs in SDK
 * @internal
 */
+/** 与 conversation_id 同字符集：URL 安全、无连字符。 */
+var nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
 var IdManager = class {
 	ids = {
 		clientId: "",
+		sessionId: "",
 		userId: null,
 		appId: null,
 		sessionToken: null,
@@ -7346,10 +7371,16 @@ var IdManager = class {
 	getLogContext() {
 		return {
 			client_id: this.ids.clientId,
+			session_id: this.ids.sessionId,
 			user_id: this.ids.userId || "",
 			app_id: this.ids.appId || ""
 		};
 	}
+	/** 本次启动的 session id；首次调用时生成。 @internal */
+	getSessionId() {
+		if (!this.ids.sessionId) this.ids.sessionId = nanoid();
+		return this.ids.sessionId;
+	}
 	/**
 	* Clear all IDs (for testing or reset)
 	* @internal
@@ -13404,119 +13435,6 @@ var OTLPLogExporter = class extends OTLPExporterBase {
 	}
 };
 //#endregion
-//#region utils/event-store.ts
-/**
-* Event Store - Persistent buffer for OTel telemetry events.
-*
-* Each emitted event is written here before being handed to the OTel
-* BatchProcessor. When the wrapper exporter picks a batch up for HTTP
-* upload it deletes those records — so anything still here on next
-* startup is unsent and gets re-emitted (replay).
-*
-* Schema is intentionally minimal: no status / retry_count. A record's
-* presence in the store means "not yet handed to inner.export".
-* @internal
-*/
-var DB_NAME = "avatarkit_events";
-var STORE_NAME = "events";
-var DB_VERSION = 1;
-var EventStore = class {
-	db = null;
-	initPromise = null;
-	initialize() {
-		if (this.db) return Promise.resolve();
-		if (this.initPromise) return this.initPromise;
-		this.initPromise = new Promise((resolve, reject) => {
-			const req = indexedDB.open(DB_NAME, DB_VERSION);
-			req.onerror = () => reject(/* @__PURE__ */ new Error("Failed to open avatarkit_events"));
-			req.onsuccess = () => {
-				this.db = req.result;
-				resolve();
-			};
-			req.onupgradeneeded = (e) => {
-				const db = e.target.result;
-				if (!db.objectStoreNames.contains(STORE_NAME)) db.createObjectStore(STORE_NAME, {
-					keyPath: "id",
-					autoIncrement: true
-				});
-			};
-		});
-		return this.initPromise;
-	}
-	/**
-	* Append a record, returning the auto-generated id.
-	* Caller must use this id as the `_index` attribute when emitting to OTel.
-	*/
-	async add(record) {
-		if (!this.db) await this.initialize();
-		if (!this.db) throw new Error("event-store not available");
-		return new Promise((resolve, reject) => {
-			const req = this.db.transaction([STORE_NAME], "readwrite").objectStore(STORE_NAME).add(record);
-			req.onsuccess = () => resolve(req.result);
-			req.onerror = () => reject(/* @__PURE__ */ new Error("event-store add failed"));
-		});
-	}
-	/**
-	* Atomically: for each id, check whether it still exists in the store;
-	* if so, delete it and include it in the returned set. Used by the
-	* wrapper exporter to claim ownership of a batch — only records the
-	* caller successfully "took" should be forwarded to inner.export.
-	*
-	* This is the multi-tab dedup mechanism: when Tab B starts and replays
-	* records that Tab A also still has in memory, only one tab will win
-	* the take and actually send.
-	*
-	* The get + delete pair runs inside a single readwrite transaction so
-	* concurrent tabs see consistent state.
-	*/
-	async takeIfExists(ids) {
-		const taken = /* @__PURE__ */ new Set();
-		if (ids.length === 0) return taken;
-		if (!this.db) await this.initialize();
-		if (!this.db) return taken;
-		return new Promise((resolve) => {
-			const tx = this.db.transaction([STORE_NAME], "readwrite");
-			const store = tx.objectStore(STORE_NAME);
-			let pending = ids.length;
-			const finish = () => {
-				if (--pending === 0) resolve(taken);
-			};
-			for (const id of ids) {
-				const req = store.get(id);
-				req.onsuccess = () => {
-					if (req.result !== void 0) {
-						taken.add(id);
-						store.delete(id);
-					}
-					finish();
-				};
-				req.onerror = () => finish();
-			}
-			tx.onerror = () => {
-				logger.warn("[event-store] takeIfExists tx failed");
-				resolve(taken);
-			};
-		});
-	}
-	/**
-	* Return all stored records. Used on startup to replay anything left
-	* over from a previous (possibly crashed) session.
-	*/
-	async getAll() {
-		if (!this.db) await this.initialize();
-		if (!this.db) return [];
-		return new Promise((resolve) => {
-			const req = this.db.transaction([STORE_NAME], "readonly").objectStore(STORE_NAME).getAll();
-			req.onsuccess = () => resolve(req.result || []);
-			req.onerror = () => {
-				logger.warn("[event-store] getAll failed");
-				resolve([]);
-			};
-		});
-	}
-};
-var eventStore = new EventStore();
-//#endregion
 //#region node_modules/.pnpm/@opentelemetry+exporter-metrics-otlp-http@0.218.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/exporter-metrics-otlp-http/build/esm/OTLPMetricExporterOptions.js
 var AggregationTemporalityPreference;
 (function(AggregationTemporalityPreference) {
@@ -13625,7 +13543,7 @@ var HTTP_NETWORK_BUCKETS_MS = [
 	5e3
 ];
 /**
-* RTC playback 指标的桶。默认桶（0/5/10/25/50/…/10000）对这批指标毫无分辨率：
+* 播放指标的桶。默认桶（0/5/10/25/50/…/10000）对这批指标毫无分辨率：
 * 帧率只可能落在 0~25，缺帧数和卡顿次数几乎全部挤在第一个桶里，分位数因此毫无意义。
 * 桶按各指标的实际值域给：
 *
@@ -13634,9 +13552,18 @@ var HTTP_NETWORK_BUCKETS_MS = [
 * - 卡顿次数：数的是次数不是帧，自成一组。
 * - 百分比：每 5% 一档，0~100。
 * - 时长：分两组——整轮播放是秒级，单次卡顿是一帧起步的毫秒级。
+* - 延迟：音频送入是等距（要看偏离整秒多少），动画到达是等比（两种用法差一个数量级）。
+* - GPU 耗时：个位数毫秒，按帧预算设档。
 *
-* 这些 metric 由 @spatius/avatarkit-rtc 发出（meter 名 spatius-avatarkit-rtc），
-* 但 view 只能配在创建 MeterProvider 的这一侧，所以桶定义留在这里。
+* 本 SDK 与 @spatius/avatarkit-rtc（meter 名 spatius-avatarkit-rtc）两边的指标都在这里配：
+* view 只能配在创建 MeterProvider 的这一侧，rtc 那批虽由另一个包发出，桶定义也得留在此处。
+* 同名概念两边共用一组桶，好让两条链路的分布能直接叠着比。
+*/
+/**
+* 上界给到 30 而非 25：25fps 是目标帧率，正常轮次全落在那一档，若把它当上界，
+* 每一轮健康播放都会挤进 +Inf 溢出桶，与真正超发的异常轮次混在一起，
+* 这条 metric 就只剩「是否达标」这一个比特的信息。25 单独成档、上面再留几格，
+* 达标与超发才分得开。
 */
 var RTC_FPS_BUCKETS = [
 	0,
@@ -13663,7 +13590,12 @@ var RTC_FPS_BUCKETS = [
 	21,
 	22,
 	23,
-	24
+	24,
+	25,
+	26,
+	27,
+	28,
+	30
 ];
 /**
 * 一轮播出的帧数。档位是播放时长桶除以帧间隔（40ms），和时长视角一一对应：
@@ -13765,8 +13697,120 @@ var RTC_STALL_DURATION_BUCKETS_MS = [
 	5120,
 	10240
 ];
+/**
+* 音频送入节奏：tap_N 是第 N 秒音频送入的时刻，metric 记的是相对首包（tap_0）的累计 Δ。
+* 流式输入下 tap_1/2/4 天然聚在 1000/2000/4000 附近，偏离多少正是要看的——喂得比实时慢，
+* 后台就攒不够音频、推理迟迟不触发。等距 200ms 让这三个中心各自落在档位边界上，
+* 偏移一两档就能读出来；等比会把它们挤进同一格。
+*
+* 上界 6000 而非 4000：4000 是 tap_4 的理想值，拿理想值当上界，正常轮次会全部挤进
+* +Inf 溢出桶，与真正喂得慢的轮次混在一起。
+*/
+var AUDIO_LATENCY_BUCKETS_MS = [
+	0,
+	200,
+	400,
+	600,
+	800,
+	1e3,
+	1200,
+	1400,
+	1600,
+	1800,
+	2e3,
+	2200,
+	2400,
+	2600,
+	2800,
+	3e3,
+	3200,
+	3400,
+	3600,
+	3800,
+	4e3,
+	4200,
+	4400,
+	4600,
+	4800,
+	5e3,
+	5200,
+	5400,
+	5600,
+	5800,
+	6e3
+];
+/**
+* 动画包到达：anim_N 是第 N 组动画包到达的时刻（同样相对 tap_0 的累计 Δ）。
+* 后台攒够音频（2s/4s/4s）就推理下发，所以这个值等于「攒音频的等待 + 推理 + 网络下行」，
+* 与播放进度无关：一次性灌入 10s 预制音频，三个包会连着回来，全落在低位；实时流式喂，
+* 则要等音频攒够，anim_2 可以到十几秒。两种用法差一个数量级，同一个直方图要都装得下，
+* 因此用等比而非等距——低位密到看清推理耗时，高位疏到兜住慢速流式。
+*
+* 200ms 起步：网络下行本身就要这个量级，再往下细分没有意义。
+*/
+var ANIM_LATENCY_BUCKETS_MS = [
+	0,
+	200,
+	400,
+	800,
+	1600,
+	3200,
+	6400,
+	12800,
+	25600
+];
+/**
+* 单帧 GPU 渲染耗时。实测中低端机器可以到 30ms 上下，因此值域按机型跨度给到 100ms，
+* 每 5ms 一档——而不是只覆盖高端机那几毫秒。40ms 是一帧的总预算，越过就意味着 GPU
+* 单独一项已经吃满整帧；再往上到 100ms 是给最差的机型留的观测空间。
+*
+* webgl 没有可移植的 GPU timer，取不到样本，那几轮整条 metric 不发（见 AvatarController），
+* 所以这里的分布只含 webgpu 的真实数据，不会被一堆 0 压在第一格。
+*/
+var GPU_RENDER_BUCKETS_MS = [
+	5,
+	10,
+	15,
+	20,
+	25,
+	30,
+	35,
+	40,
+	45,
+	50,
+	55,
+	60,
+	65,
+	70,
+	75,
+	80,
+	85,
+	90,
+	95,
+	100
+];
 /** metric 名 → 桶，供下面的 views 展开。 */
-var RTC_BUCKET_PROFILES = [
+var BUCKET_PROFILES = [
+	["playback_avg_fps", RTC_FPS_BUCKETS],
+	["playback_duration_ms", RTC_PLAYBACK_DURATION_BUCKETS_MS],
+	["playback_audio_duration_ms", RTC_PLAYBACK_DURATION_BUCKETS_MS],
+	["playback_animation_frame_count", RTC_FRAME_COUNT_BUCKETS],
+	["playback_jank_frame_count", RTC_LOST_FRAME_BUCKETS],
+	["playback_stall_count", RTC_STALL_COUNT_BUCKETS],
+	["playback_stall_max_ms", RTC_STALL_DURATION_BUCKETS_MS],
+	["playback_stall_total_ms", RTC_STALL_DURATION_BUCKETS_MS],
+	["playback_audio_stall_count", RTC_STALL_COUNT_BUCKETS],
+	["playback_audio_stall_max_ms", RTC_STALL_DURATION_BUCKETS_MS],
+	["playback_audio_stall_total_ms", RTC_STALL_DURATION_BUCKETS_MS],
+	["playback_gpu_render_p50_ms", GPU_RENDER_BUCKETS_MS],
+	["playback_gpu_render_p90_ms", GPU_RENDER_BUCKETS_MS],
+	["playback_gpu_render_p95_ms", GPU_RENDER_BUCKETS_MS],
+	["playback_latency_tap_1_ms", AUDIO_LATENCY_BUCKETS_MS],
+	["playback_latency_tap_2_ms", AUDIO_LATENCY_BUCKETS_MS],
+	["playback_latency_tap_4_ms", AUDIO_LATENCY_BUCKETS_MS],
+	["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],
 	["rtc_playback_avg_fps", RTC_FPS_BUCKETS],
 	["rtc_playback_frame_count", RTC_FRAME_COUNT_BUCKETS],
 	["rtc_playback_skipped_frames", RTC_LOST_FRAME_BUCKETS],
@@ -13775,13 +13819,49 @@ var RTC_BUCKET_PROFILES = [
 	["rtc_playback_start_transition_missing", RTC_LOST_FRAME_BUCKETS],
 	["rtc_playback_end_transition_missing", RTC_LOST_FRAME_BUCKETS],
 	["rtc_playback_skip_rate_pct", RTC_PERCENT_BUCKETS],
+	["rtc_playback_stall_rate_pct", RTC_PERCENT_BUCKETS],
 	["rtc_playback_duration_ms", RTC_PLAYBACK_DURATION_BUCKETS_MS],
 	["rtc_playback_stall_total_ms", RTC_STALL_DURATION_BUCKETS_MS],
 	["rtc_playback_stall_max_ms", RTC_STALL_DURATION_BUCKETS_MS],
 	["rtc_transport_packets_lost", RTC_LOST_FRAME_BUCKETS],
 	["rtc_transport_packets_recovered", RTC_LOST_FRAME_BUCKETS],
 	["rtc_transport_packets_dropped", RTC_LOST_FRAME_BUCKETS],
-	["rtc_transport_packets_out_of_order", RTC_LOST_FRAME_BUCKETS]
+	["rtc_transport_packets_out_of_order", RTC_LOST_FRAME_BUCKETS],
+	["rtc_transport_rtp_packets_lost", RTC_LOST_FRAME_BUCKETS],
+	["rtc_transport_rtp_loss_rate_pct", RTC_PERCENT_BUCKETS],
+	["rtc_transport_rtt_ms", [
+		10,
+		20,
+		30,
+		40,
+		50,
+		75,
+		100,
+		150,
+		200,
+		300,
+		400,
+		600,
+		800,
+		1e3
+	]],
+	["rtc_transport_jitter_ms", [
+		1,
+		2,
+		3,
+		5,
+		8,
+		12,
+		16,
+		20,
+		25,
+		30,
+		40,
+		60,
+		80,
+		120,
+		200
+	]]
 ];
 var METRIC_EXPORT_INTERVAL_MS = 1e4;
 var sdkVersion$2 = "1.0.0";
@@ -13816,11 +13896,11 @@ function initializeOtelMetrics(version, resourceAttrs) {
 				"dsm": resourceAttrs.dsm
 			}),
 			readers: [new PeriodicExportingMetricReader({
-				exporter: new OTLPMetricExporter({
+				exporter: observeExporter(new OTLPMetricExporter({
 					url: OTEL_METRICS_ENDPOINT,
 					headers: { "Authorization": buildBasicAuthHeader$1() },
 					temporalityPreference: AggregationTemporality.DELTA
-				}),
+				}), "/v1/metrics", OTEL_METRICS_ENDPOINT),
 				exportIntervalMillis: METRIC_EXPORT_INTERVAL_MS
 			})],
 			views: [{
@@ -13829,7 +13909,7 @@ function initializeOtelMetrics(version, resourceAttrs) {
 					type: AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
 					options: { boundaries: HTTP_NETWORK_BUCKETS_MS }
 				}
-			}, ...RTC_BUCKET_PROFILES.map(([instrumentName, boundaries]) => ({
+			}, ...BUCKET_PROFILES.map(([instrumentName, boundaries]) => ({
 				instrumentName,
 				aggregation: {
 					type: AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
@@ -13857,6 +13937,23 @@ function getHistogram(name) {
 	return h;
 }
 /**
+* 本周期内是否写入过**业务** metric。
+*
+* 观测遥测通道自身的那条记录（http.client.request.duration 的 /v1/* operation）有意
+* 不弄脏它：那条记录本身产生于「导出」这个动作，若也算数，就成了
+* 导出 → 写入 → 下周期非空 → 又导出 → 又写入 的永动机，用户什么都不做也每 10s 发一包。
+*
+* 只有真实业务 metric 才把它置真；metrics 导出前若为假就整轮跳过，观测记录攒着等下一趟
+* 真有业务数据的车捎走。
+*/
+var hasBusinessMetric = false;
+/** 供导出侧读取并复位。@internal */
+function takeBusinessMetricFlag() {
+	const v = hasBusinessMetric;
+	hasBusinessMetric = false;
+	return v;
+}
+/**
 * 记录一个 metric 数据点（Histogram）。
 * @param name metric 名
 * @param value 数值（延迟 ms / 帧率 / 时长 / 次数 / 比率等）
@@ -13869,6 +13966,7 @@ function recordMetric(name, value, attributes = {}) {
 	const h = getHistogram(name);
 	if (!h) return;
 	try {
+		if (name !== HTTP_CLIENT_DURATION_METRIC || !String(attributes.operation ?? "").startsWith("/v1/")) hasBusinessMetric = true;
 		h.record(value, attributes);
 	} catch (error) {
 		logger.warn(`[OTel-Metrics] Failed to record ${name}:`, error instanceof Error ? error.message : String(error));
@@ -13887,12 +13985,13 @@ function recordMetric(name, value, attributes = {}) {
 * @internal
 */
 function recordHttpClientDuration(params) {
-	const { operation, method, durationMs, statusCode, serverAddress } = params;
+	const { operation, method, durationMs, statusCode, serverAddress, cacheHit } = params;
 	const attrs = {
 		"http.request.method": method,
 		"operation": operation || "_OTHER"
 	};
 	if (serverAddress) attrs["server.address"] = serverAddress;
+	if (typeof cacheHit === "boolean") attrs["cache_hit"] = cacheHit;
 	if (typeof statusCode === "number") attrs["http.response.status_code"] = statusCode;
 	else attrs["error.type"] = "transport_error";
 	recordMetric(HTTP_CLIENT_DURATION_METRIC, durationMs, attrs);
@@ -13917,6 +14016,226 @@ function cleanupOtelMetrics() {
 	}
 }
 //#endregion
+//#region utils/otel-export-observer.ts
+/**
+* 遥测通道自身的送达可观测性 —— 给 OTLP 导出请求做 Transaction 上报。
+*
+* 三条通道（logs / metrics / traces）此前把导出结果直接透传给 BatchProcessor 就丢了：
+* 导出批量失败（网络、CDN 缓存、鉴权、后端 5xx）在后台侧只表现为「某个 app_id 数据变少」，
+* 分不清是真没数据还是上报挂了。之前 EdgeOne 边缘缓存无 ACAO 头导致 CORS 全挂就是这类。
+*
+* 复用业务请求那套 `http.client.request.duration`（同 metric 名、同 Network profile 桶、
+* 同成败判定），只是新增 operation 取值。后台不必为此建新看板。
+*
+* ## 自举局限（务必知悉）
+*
+* 这条上报**走的正是它要观测的通道**，所以：
+* - 通道整体挂掉时，这条 metric 同样发不出去 —— 覆盖不了「全挂」场景。全挂在后台侧的
+*   表现是该 app_id 数据整体消失，那本身才是信号。
+* - 真正能观测到的是**部分失败**（三条通道各自独立 exporter，logs 挂了 metrics 可能还通）
+*   与**间歇失败**（断续失败后恢复，失败计数随下一批发出）。
+*
+* ## 记录时机：暂存，等下一次导出搭车
+*
+* 导出结束时**不直接写 histogram**，只记进内存里的 pending 列表；等下一次导出发生时，
+* 才在其**开始**把 pending 写进 histogram。
+*
+* 这样做是为了让 metrics 通道自己也能被观测。直接写会形成自反馈：metrics 的导出由
+* `PeriodicExportingMetricReader` 周期驱动，写入产生数据点 → 下周期必须导出 → 导出
+* 又写入 —— 空闲时也永不静默。改成暂存后，**写入本身不触发任何导出**，只是等下一次
+* 本来就要发生的导出把它带走，环就断了。
+*
+* 代价是延迟一个周期：reader 先 `collect()` 快照、再 `_export()` 发送（见
+* PeriodicExportingMetricReader 的 _runOnce），所以在导出时写入必然错过本轮快照，
+* 数据落在下一轮。对成功率这种趋势指标，慢一个周期无妨。
+*
+* 副作用是最后一批 pending 会随页面关闭丢失（进程结束，没有"下一次导出"）。同样可接受：
+* 丢的是最后 10s 的成功率样本，不是业务数据。
+*
+* @internal
+*/
+/**
+* 已完成但尚未写进 histogram 的导出结果。上限用于兜底：正常情况下每个周期都会被
+* 排空，只有在「导出彻底停止但仍有 record 进来」这类异常下才会堆积。
+*/
+var pending = [];
+var PENDING_LIMIT = 256;
+/** 暂存一次 OTLP 导出的结果，等下一次导出搭车写入（见文件头「记录时机」）。 */
+function enqueueExportResult(p) {
+	if (pending.length >= PENDING_LIMIT) pending.shift();
+	pending.push(p);
+}
+/**
+* 把暂存的导出结果写进 histogram。在**导出开始时**调用：此时 reader 已完成本轮
+* collect 快照，写入的数据会随下一轮发出。
+*/
+function flushPendingExports() {
+	if (pending.length === 0) return;
+	const batch = pending.splice(0, pending.length);
+	for (const p of batch) recordHttpClientDuration({
+		operation: p.channel,
+		method: "POST",
+		durationMs: p.durationMs,
+		statusCode: p.success ? 200 : void 0,
+		serverAddress: p.serverAddress
+	});
+}
+/** 从 OTLP endpoint URL 取 host（低基数），取不到时退回 `_OTHER`。 */
+function hostOf(endpoint) {
+	try {
+		return new URL(endpoint).host;
+	} catch {
+		return "_OTHER";
+	}
+}
+/**
+* 给任意 OTLP exporter 包一层导出结果观测。原样透传参数与 callback，只在 callback
+* 回来时把结果暂存 —— 不改变导出行为，也不吞异常。
+*/
+function observeExporter(inner, channel, endpoint) {
+	const serverAddress = hostOf(endpoint);
+	const wrapped = new Proxy(inner, { get(target, prop, receiver) {
+		if (prop === "export") return observedExport;
+		const value = Reflect.get(target, prop, receiver);
+		return typeof value === "function" ? value.bind(target) : value;
+	} });
+	const observedExport = function(items, resultCallback) {
+		try {
+			flushPendingExports();
+		} catch {}
+		if (channel === "/v1/metrics" && !takeBusinessMetricFlag()) {
+			resultCallback({ code: 0 });
+			return;
+		}
+		const startMs = Date.now();
+		inner.export(items, (result) => {
+			try {
+				enqueueExportResult({
+					channel,
+					durationMs: Math.round(Date.now() - startMs),
+					success: result.code === 0,
+					serverAddress
+				});
+			} catch {}
+			resultCallback(result);
+		});
+	};
+	return wrapped;
+}
+//#endregion
+//#region utils/event-store.ts
+/**
+* Event Store - Persistent buffer for OTel telemetry events.
+*
+* Each emitted event is written here before being handed to the OTel
+* BatchProcessor. When the wrapper exporter picks a batch up for HTTP
+* upload it deletes those records — so anything still here on next
+* startup is unsent and gets re-emitted (replay).
+*
+* Schema is intentionally minimal: no status / retry_count. A record's
+* presence in the store means "not yet handed to inner.export".
+* @internal
+*/
+var DB_NAME = "avatarkit_events";
+var STORE_NAME = "events";
+var DB_VERSION = 1;
+var EventStore = class {
+	db = null;
+	initPromise = null;
+	initialize() {
+		if (this.db) return Promise.resolve();
+		if (this.initPromise) return this.initPromise;
+		this.initPromise = new Promise((resolve, reject) => {
+			const req = indexedDB.open(DB_NAME, DB_VERSION);
+			req.onerror = () => reject(/* @__PURE__ */ new Error("Failed to open avatarkit_events"));
+			req.onsuccess = () => {
+				this.db = req.result;
+				resolve();
+			};
+			req.onupgradeneeded = (e) => {
+				const db = e.target.result;
+				if (!db.objectStoreNames.contains(STORE_NAME)) db.createObjectStore(STORE_NAME, {
+					keyPath: "id",
+					autoIncrement: true
+				});
+			};
+		});
+		return this.initPromise;
+	}
+	/**
+	* Append a record, returning the auto-generated id.
+	* Caller must use this id as the `_index` attribute when emitting to OTel.
+	*/
+	async add(record) {
+		if (!this.db) await this.initialize();
+		if (!this.db) throw new Error("event-store not available");
+		return new Promise((resolve, reject) => {
+			const req = this.db.transaction([STORE_NAME], "readwrite").objectStore(STORE_NAME).add(record);
+			req.onsuccess = () => resolve(req.result);
+			req.onerror = () => reject(/* @__PURE__ */ new Error("event-store add failed"));
+		});
+	}
+	/**
+	* Atomically: for each id, check whether it still exists in the store;
+	* if so, delete it and include it in the returned set. Used by the
+	* wrapper exporter to claim ownership of a batch — only records the
+	* caller successfully "took" should be forwarded to inner.export.
+	*
+	* This is the multi-tab dedup mechanism: when Tab B starts and replays
+	* records that Tab A also still has in memory, only one tab will win
+	* the take and actually send.
+	*
+	* The get + delete pair runs inside a single readwrite transaction so
+	* concurrent tabs see consistent state.
+	*/
+	async takeIfExists(ids) {
+		const taken = /* @__PURE__ */ new Set();
+		if (ids.length === 0) return taken;
+		if (!this.db) await this.initialize();
+		if (!this.db) return taken;
+		return new Promise((resolve) => {
+			const tx = this.db.transaction([STORE_NAME], "readwrite");
+			const store = tx.objectStore(STORE_NAME);
+			let pending = ids.length;
+			const finish = () => {
+				if (--pending === 0) resolve(taken);
+			};
+			for (const id of ids) {
+				const req = store.get(id);
+				req.onsuccess = () => {
+					if (req.result !== void 0) {
+						taken.add(id);
+						store.delete(id);
+					}
+					finish();
+				};
+				req.onerror = () => finish();
+			}
+			tx.onerror = () => {
+				logger.warn("[event-store] takeIfExists tx failed");
+				resolve(taken);
+			};
+		});
+	}
+	/**
+	* Return all stored records. Used on startup to replay anything left
+	* over from a previous (possibly crashed) session.
+	*/
+	async getAll() {
+		if (!this.db) await this.initialize();
+		if (!this.db) return [];
+		return new Promise((resolve) => {
+			const req = this.db.transaction([STORE_NAME], "readonly").objectStore(STORE_NAME).getAll();
+			req.onsuccess = () => resolve(req.result || []);
+			req.onerror = () => {
+				logger.warn("[event-store] getAll failed");
+				resolve([]);
+			};
+		});
+	}
+};
+var eventStore = new EventStore();
+//#endregion
 //#region utils/bootstrap.ts
 /**
 * Bootstrap 全球接入入口
@@ -14213,6 +14532,23 @@ function monoTimestamp() {
 		value: performance.now()
 	};
 }
+/**
+* 把**已经取好**的 `performance.now()` 读数包成 MonoMark。
+*
+* 用于时刻不在当前线程/当前时机产生的场景：Opus 编解码在 Worker 里逐包打点，那些
+* 时刻随结果回传后才到主线程手上，不能用 `monoTimestamp()` 重新取（那会变成
+* 「整批结果回来」的时刻，把逐包的时间分布抹平）。
+*
+* ⚠️ 传进来的值必须已换算到**主线程**的 `performance.now()` 轴上。Worker 有自己的
+* time origin，直接回传它的 `performance.now()` 会得到负的 dur_ms（实测 -8292）；
+* 各 worker 均以 `timeOrigin + now()` 发绝对时刻，由 proxy 减去主线程 timeOrigin。
+*/
+function monoMarkFrom(value) {
+	return {
+		[MARK_KEY]: "mono",
+		value
+	};
+}
 function isMark(v) {
 	return typeof v === "object" && v !== null && MARK_KEY in v;
 }
@@ -14318,13 +14654,13 @@ function initializeOtel(version, resourceAttrs) {
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
 			}),
-			processors: [new BatchLogRecordProcessor(new ReliableExporter(new OTLPLogExporter({
+			processors: [new BatchLogRecordProcessor(new ReliableExporter(observeExporter(new OTLPLogExporter({
 				url: OTEL_LOGS_ENDPOINT,
 				headers: {
 					"Authorization": buildBasicAuthHeader(),
 					"stream-name": OTEL_STREAM_NAME
 				}
-			})))]
+			}), "/v1/logs", OTEL_LOGS_ENDPOINT)))]
 		});
 		logs.setGlobalLoggerProvider(loggerProvider);
 		isInitialized$1 = true;
@@ -15203,7 +15539,7 @@ async function writeToLocalLog(message, level, extra = {}) {
 	try {
 		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
 		if (!shouldPersist) return;
-		const { AvatarSDK } = await import("./AvatarSDK-CnZqa_X4.js").then((n) => n.n);
+		const { AvatarSDK } = await import("./AvatarSDK-DgPvHU4L.js").then((n) => n.n);
 		const version = AvatarSDK.version;
 		const appId = idManager.getAppId();
 		const userId = idManager.getUserId();
@@ -15291,4 +15627,4 @@ function captureErrorContext(level, error) {
 	});
 }
 //#endregion
-export { TraceFlags as $, ExportResultCode as A, RENDER_QUALITY_PARAMS as At, ATTR_EXCEPTION_TYPE as B, createInstrumentationScope as C, DEFAULT_REGION as Ct, defaultResource as D, FrameStarvationMode as Dt, OTLPExporterBase as E, ErrorCode as Et, isTimeInputHrTime as F, isTracingSuppressed as G, getNumberFromEnv as H, millisToHrTime as I, diag as J, suppressTracing as K, otperformance as L, hrTime as M, TransitionType as Mt, hrTimeDuration as N, resourceFromAttributes as O, LoadProgress as Ot, isTimeInput as P, INVALID_SPAN_CONTEXT as Q, ATTR_EXCEPTION_MESSAGE as R, JSON_ENCODER as S, DEFAULT_OPUS_BITRATE as St, toAttributes$1 as T, DrivingServiceMode as Tt, getStringFromEnv as U, ATTR_SERVICE_NAME as V, globalErrorHandler as W, isSpanContextValid as X, context as Y, isValidTraceId as Z, cleanupOtelMetrics as _, AnimationType as _t, clientContextFields as a, getGlobal as at, recordMetric as b, ConnectionState as bt, logEvent as c, OTEL_LOGS_ENDPOINT as ct, cleanupOtel as d, OTEL_TRACES_ENDPOINT as dt, ContextAPI as et, initializeOtel as f, OTEL_TRACES_STREAM_NAME as ft, fetchBootstrap as g, generateTraceId as gt, clockSync as h, idManager as ht, cleanupPostHog as i, DiagAPI as it, addHrTimes as j, RenderQuality as jt, BindOnceFuture as k, LogLevel as kt, logMetric as l, OTEL_PASSWORD as lt, resolveMarks as m, isDebugMode as mt, setLogLevel as n, ROOT_CONTEXT as nt, getLogsFeatureFlag as o, registerGlobal as ot, monoTimestamp as p, OTEL_USERNAME as pt, trace as q, logSink as r, createContextKey as rt, initializePostHog as s, unregisterGlobal as st, logger as t, createNoopMeter as tt, updatePostHogPersonPropertiesForFlags as u, OTEL_STREAM_NAME as ut, initializeOtelMetrics as v, AvatarError as vt, createResource as w, DEFAULT_REGION_REQUEST as wt, createLegacyOtlpBrowserExportDelegate as x, ConversationState as xt, recordHttpClientDuration as y, AvatarState as yt, ATTR_EXCEPTION_STACKTRACE as z };
+export { isSpanContextValid as $, defaultResource as A, FrameStarvationMode as At, otperformance as B, recordMetric as C, ConnectionState as Ct, createResource as D, DEFAULT_REGION_REQUEST as Dt, createInstrumentationScope as E, DEFAULT_REGION as Et, hrTime as F, TransitionType as Ft, getNumberFromEnv as G, ATTR_EXCEPTION_STACKTRACE as H, hrTimeDuration as I, isTracingSuppressed as J, getStringFromEnv as K, isTimeInput as L, BindOnceFuture as M, LogLevel as Mt, ExportResultCode as N, RENDER_QUALITY_PARAMS as Nt, toAttributes$1 as O, DrivingServiceMode as Ot, addHrTimes as P, RenderQuality as Pt, context as Q, isTimeInputHrTime as R, recordHttpClientDuration as S, AvatarState as St, JSON_ENCODER as T, DEFAULT_OPUS_BITRATE as Tt, ATTR_EXCEPTION_TYPE as U, ATTR_EXCEPTION_MESSAGE as V, ATTR_SERVICE_NAME as W, trace as X, suppressTracing as Y, diag as Z, fetchBootstrap as _, isDebugMode as _t, clientContextFields as a, ROOT_CONTEXT as at, cleanupOtelMetrics as b, AnimationType as bt, logEvent as c, getGlobal as ct, cleanupOtel as d, OTEL_LOGS_ENDPOINT as dt, isValidTraceId as et, initializeOtel as f, OTEL_PASSWORD as ft, clockSync as g, OTEL_USERNAME as gt, resolveMarks as h, OTEL_TRACES_STREAM_NAME as ht, cleanupPostHog as i, createNoopMeter as it, resourceFromAttributes as j, LoadProgress as jt, OTLPExporterBase as k, ErrorCode as kt, logMetric as l, registerGlobal as lt, monoTimestamp as m, OTEL_TRACES_ENDPOINT as mt, setLogLevel as n, TraceFlags as nt, getLogsFeatureFlag as o, createContextKey as ot, monoMarkFrom as p, OTEL_STREAM_NAME as pt, globalErrorHandler as q, logSink as r, ContextAPI as rt, initializePostHog as s, DiagAPI as st, logger as t, INVALID_SPAN_CONTEXT as tt, updatePostHogPersonPropertiesForFlags as u, unregisterGlobal as ut, hostOf as v, idManager as vt, createLegacyOtlpBrowserExportDelegate as w, ConversationState as wt, initializeOtelMetrics as x, AvatarError as xt, observeExporter as y, generateTraceId as yt, millisToHrTime as z };