@spatius/avatarkit 1.3.1-beta.7 → 1.3.1

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

@@ -1156,6 +1156,28 @@ let 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;
 }({});
 let LogLevel = /* @__PURE__ */ function(LogLevel) {
@@ -7111,7 +7133,7 @@ let customRandom = (alphabet, defaultSize, getRandom) => {
 	};
 };
 let customAlphabet = (alphabet, size = 21) => customRandom(alphabet, size | 0, random);
-let nanoid$1 = (size = 21) => {
+let nanoid$2 = (size = 21) => {
 	let id = "";
 	let bytes = crypto.getRandomValues(new Uint8Array(size |= 0));
 	while (size--) id += urlAlphabet[bytes[size] & 63];
@@ -7136,11 +7158,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
@@ -7158,7 +7180,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)
 */
-const nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
+const nanoid$1 = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
 /**
 * Generate unified conversation ID
 * 
@@ -7173,7 +7195,7 @@ const nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvw
 const 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
@@ -7182,9 +7204,12 @@ function generateConversationId() {
 * Unified management of all types of IDs in SDK
 * @internal
 */
+/** 与 conversation_id 同字符集：URL 安全、无连字符。 */
+const nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
 var IdManager = class {
 	ids = {
 		clientId: "",
+		sessionId: "",
 		userId: null,
 		appId: null,
 		sessionToken: null,
@@ -7267,10 +7292,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
@@ -13329,119 +13360,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
-*/
-const DB_NAME = "avatarkit_events";
-const STORE_NAME = "events";
-const 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([]);
-			};
-		});
-	}
-};
-const 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) {
@@ -13826,13 +13744,49 @@ const 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
+	]]
 ];
 const METRIC_EXPORT_INTERVAL_MS = 1e4;
 let sdkVersion$2 = "1.0.0";
@@ -13866,11 +13820,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: [{
@@ -13907,6 +13861,23 @@ function getHistogram(name) {
 	return h;
 }
 /**
+* 本周期内是否写入过**业务** metric。
+*
+* 观测遥测通道自身的那条记录（http.client.request.duration 的 /v1/* operation）有意
+* 不弄脏它：那条记录本身产生于「导出」这个动作，若也算数，就成了
+* 导出 → 写入 → 下周期非空 → 又导出 → 又写入 的永动机，用户什么都不做也每 10s 发一包。
+*
+* 只有真实业务 metric 才把它置真；metrics 导出前若为假就整轮跳过，观测记录攒着等下一趟
+* 真有业务数据的车捎走。
+*/
+let hasBusinessMetric = false;
+/** 供导出侧读取并复位。@internal */
+function takeBusinessMetricFlag() {
+	const v = hasBusinessMetric;
+	hasBusinessMetric = false;
+	return v;
+}
+/**
 * 记录一个 metric 数据点（Histogram）。
 * @param name metric 名
 * @param value 数值（延迟 ms / 帧率 / 时长 / 次数 / 比率等）
@@ -13919,6 +13890,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));
@@ -13937,12 +13909,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);
@@ -13967,6 +13940,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 进来」这类异常下才会堆积。
+*/
+const pending = [];
+const 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
+*/
+const DB_NAME = "avatarkit_events";
+const STORE_NAME = "events";
+const 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([]);
+			};
+		});
+	}
+};
+const eventStore = new EventStore();
+//#endregion
 //#region utils/bootstrap.ts
 /**
 * Bootstrap 全球接入入口
@@ -14356,13 +14549,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;
@@ -15241,7 +15434,7 @@ async function writeToLocalLog(message, level, extra = {}) {
 	try {
 		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
 		if (!shouldPersist) return;
-		const { AvatarSDK } = await import("./AvatarSDK-CPEeTeLT.js").then((n) => n.n);
+		const { AvatarSDK } = await import("./AvatarSDK-C_Anluwp.js").then((n) => n.n);
 		const version = AvatarSDK.version;
 		const appId = idManager.getAppId();
 		const userId = idManager.getUserId();
@@ -15331,4 +15524,4 @@ function captureErrorContext(level, error) {
 	});
 }
 //#endregion
-export { ROOT_CONTEXT as $, hrTimeDuration as A, getStringFromEnv as B, OTLPExporterBase as C, ExportResultCode as D, BindOnceFuture as E, ATTR_EXCEPTION_MESSAGE as F, diag as G, isTracingSuppressed as H, ATTR_EXCEPTION_STACKTRACE as I, isValidTraceId as J, context as K, ATTR_EXCEPTION_TYPE as L, isTimeInputHrTime as M, millisToHrTime as N, addHrTimes as O, otperformance as P, createNoopMeter as Q, ATTR_SERVICE_NAME as R, toAttributes$1 as S, resourceFromAttributes as T, suppressTracing as U, globalErrorHandler as V, trace as W, TraceFlags as X, INVALID_SPAN_CONTEXT as Y, ContextAPI as Z, recordHttpClientDuration as _, DrivingServiceMode as _t, clientContextFields as a, OTEL_LOGS_ENDPOINT as at, createInstrumentationScope as b, logEvent as c, OTEL_TRACES_ENDPOINT as ct, cleanupOtel as d, isDebugMode as dt, createContextKey as et, initializeOtel as f, idManager as ft, initializeOtelMetrics as g, DEFAULT_REGION_REQUEST as gt, cleanupOtelMetrics as h, DEFAULT_REGION as ht, cleanupPostHog as i, unregisterGlobal as it, isTimeInput as j, hrTime as k, logMetric as l, OTEL_TRACES_STREAM_NAME as lt, fetchBootstrap as m, AvatarError as mt, setLogLevel as n, getGlobal as nt, getLogsFeatureFlag as o, OTEL_PASSWORD as ot, clockSync as p, generateTraceId as pt, isSpanContextValid as q, logSink as r, registerGlobal as rt, initializePostHog as s, OTEL_STREAM_NAME as st, logger as t, DiagAPI as tt, updatePostHogPersonPropertiesForFlags as u, OTEL_USERNAME as ut, createLegacyOtlpBrowserExportDelegate as v, ErrorCode as vt, defaultResource as w, createResource as x, JSON_ENCODER as y, LogLevel as yt, getNumberFromEnv as z };
+export { ContextAPI as $, addHrTimes as A, ATTR_SERVICE_NAME as B, createResource as C, resourceFromAttributes as D, defaultResource as E, millisToHrTime as F, suppressTracing as G, getStringFromEnv as H, otperformance as I, context as J, trace as K, ATTR_EXCEPTION_MESSAGE as L, hrTimeDuration as M, isTimeInput as N, BindOnceFuture as O, isTimeInputHrTime as P, TraceFlags as Q, ATTR_EXCEPTION_STACKTRACE as R, createInstrumentationScope as S, OTLPExporterBase as T, globalErrorHandler as U, getNumberFromEnv as V, isTracingSuppressed as W, isValidTraceId as X, isSpanContextValid as Y, INVALID_SPAN_CONTEXT as Z, cleanupOtelMetrics as _, DEFAULT_REGION as _t, clientContextFields as a, registerGlobal as at, createLegacyOtlpBrowserExportDelegate as b, ErrorCode as bt, logEvent as c, OTEL_PASSWORD as ct, cleanupOtel as d, OTEL_TRACES_STREAM_NAME as dt, createNoopMeter as et, initializeOtel as f, OTEL_USERNAME as ft, observeExporter as g, AvatarError as gt, hostOf as h, generateTraceId as ht, cleanupPostHog as i, getGlobal as it, hrTime as j, ExportResultCode as k, logMetric as l, OTEL_STREAM_NAME as lt, fetchBootstrap as m, idManager as mt, setLogLevel as n, createContextKey as nt, getLogsFeatureFlag as o, unregisterGlobal as ot, clockSync as p, isDebugMode as pt, diag as q, logSink as r, DiagAPI as rt, initializePostHog as s, OTEL_LOGS_ENDPOINT as st, logger as t, ROOT_CONTEXT as tt, updatePostHogPersonPropertiesForFlags as u, OTEL_TRACES_ENDPOINT as ut, initializeOtelMetrics as v, DEFAULT_REGION_REQUEST as vt, toAttributes$1 as w, JSON_ENCODER as x, LogLevel as xt, recordHttpClientDuration as y, DrivingServiceMode as yt, ATTR_EXCEPTION_TYPE as z };

package/dist/core/AvatarController.d.ts

@@ -95,6 +95,16 @@ export declare class AvatarController {
      * frames received). Reset per conversation alongside latencyMarks.
      */
     private traceActions;
+    /** 上行编码分段的接收钩子，构造时装上、dispose 时卸下（见 setOpusEncodeSegmentSink）。 */
+    private readonly onEncodeSegment;
+    /**
+     * 解码 span 的聚合状态：累计满 1 秒 PCM 收一段。
+     *
+     * 跨 chunk 累计——宿主流式喂时一块可能远不足 1 秒，按块收段会碎成几百个 span。
+     * `decodeSpanStart` 是上一段的收尾时刻（null = 用本次 decode 的发起时刻当起点）。
+     */
+    private decodeSpanStart;
+    private decodeSpanBytes;
     /**
      * Highest Ogg granule forwarded so far this round, for Opus input. The granule
      * accumulates across a stream, so a send's audio seconds is its own end granule

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

@@ -1,4 +1,4 @@
-import { mt as isDebugMode } from "./logger-DdmfSEn-.js";
+import { _t as isDebugMode } from "./logger-BOpQ7u0w.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";