Telemetry

.cargo/config.toml

@@ -8,16 +8,18 @@ rustflags = ["-C", "target-feature=+crt-static"]
 [target.aarch64-pc-windows-msvc]
 rustflags = ["-C", "target-feature=+crt-static"]
 
+# `-headerpad_max_install_names` on macOS: Flutter's native-assets step rewrites the cdylib's
+# install name with install_name_tool, which fails without the padding.
 # `-ObjC` must also be passed to rustdoc: doctest binaries are linked by rustdoc
 # and do not inherit `rustflags`. Without it the ObjC categories in libwebrtc's
 # static lib (e.g. `NSString (StdString)`) are not loaded, and static
 # initializers such as RTCH264ProfileLevelId.mm abort at process startup.
 [target.x86_64-apple-darwin]
-rustflags = ["-C", "link-args=-ObjC"]
+rustflags = ["-C", "link-args=-ObjC -Wl,-headerpad_max_install_names"]
 rustdocflags = ["-C", "link-args=-ObjC"]
 
 [target.aarch64-apple-darwin]
-rustflags = ["-C", "link-args=-ObjC"]
+rustflags = ["-C", "link-args=-ObjC -Wl,-headerpad_max_install_names"]
 rustdocflags = ["-C", "link-args=-ObjC"]
 
 [target.aarch64-apple-ios]

.changeset/add-livekit-telemetry-crate.md

@@ -0,0 +1,13 @@
+---
+livekit-telemetry: minor
+---
+
+Add `livekit-telemetry`, the shared client telemetry core: events are buffered on-device,
+batched and exported as OTLP/HTTP log records through a pluggable `TelemetryTransport`. Batches are
+written to a `BatchCache` (in memory by default, on disk with `storage_dir`) before upload, so
+failed uploads, crashes and offline shutdowns lose nothing. Pipeline health is exposed as `Telemetry::stats` and shipped as `lk.telemetry.report`
+events; hosts push `DeviceState` (thermal, low power, foreground/background) and the core emits
+the `lk.device.*.changed` events and stretches its cadence under pressure. Log records (`Warn`/`Error` only), a flood guard for discrete events, on-device RTC
+stats windows (`record_stats` → `lk.rtc.stats.sample`) and session-wide attributes complete the
+design doc's v0 surface. Spans (`begin_span`/`add_span_event`/`end_span`, one attempt per span, the session as the
+trace) ship on the traces signal through the same cache; every record carries the session trace id.

.changeset/uniffi-telemetry.md

@@ -0,0 +1,6 @@
+---
+livekit-uniffi: minor
+---
+
+Expose the client telemetry core over UniFFI: `Telemetry` (emit / flush / shutdown /
+droppedCount) with a host-implemented `TelemetryTransport`.

.changeset/unify-prost.md

@@ -0,0 +1,11 @@
+---
+livekit-protocol: patch
+livekit: patch
+livekit-api: patch
+livekit-data-stream: patch
+livekit-uniffi: patch
+---
+
+Unify `prost` on the workspace version (0.14, with `pbjson`/`pbjson-types` 0.9) across
+`livekit-protocol`, `livekit`, `livekit-api`, `livekit-data-stream` and `livekit-uniffi`, so
+binaries that combine these crates link a single prost. The committed generated code is unchanged.

.gitignore

@@ -6,3 +6,4 @@ soxr-sys/test-output.wav
 .env
 .cursor
 __pycache__
+/target-*/