feat: LiveKit audio recordings and traces

.changeset/shared-audio-recording.md

@@ -0,0 +1,7 @@
+---
+"@braintrust/audio": minor
+---
+
+feat(audio): add shared progressive audio recordings
+
+Add an optional, framework-independent audio recorder with progressive segmentation, WAV and Ogg/Opus encoding in a worker, and ordinary attachment uploads. Bound source memory and worker admission; publish ready recordings and playback selections only after upload succeeds. Preserve uploaded audio when later capture or trace publication fails.

.changeset/solid-donuts-drop.md

@@ -0,0 +1,9 @@
+---
+"braintrust": minor
+---
+
+feat(livekit): add automatic voice traces and optional recordings
+
+Add automatic LiveKit Agents tracing through the standard loader and logger, with turn, transcript, model, synthesis, and tool spans for cascade, realtime, duplex, and half-cascade sessions. Build realtime turns and model content from LiveKit’s common events and streams, including delayed caller transcripts. Preserve native usage even when metrics arrive before inference setup, retain selected LiveKit metadata, and suppress redundant provider spans only within tracked inference work.
+
+Support opt-in caller and agent recordings through the optional `@braintrust/audio` package, with direct playback selections on turns and speaking spans. Default recordings to Ogg; preserve text and metadata tracing when the extension is unavailable. Include `braintrust/livekit` APIs for manually managed telemetry.

e2e/config/pr-comment-scenarios.json

@@ -920,5 +920,20 @@
         "label": "v1 latest"
       }
     ]
+  },
+  {
+    "scenarioDirName": "livekit-instrumentation",
+    "label": "LiveKit voice instrumentation (streaming cascade, realtime, duplex, half-cascade, reconnect, interruption recovery; automatic and manual)",
+    "metadataScenario": "livekit-instrumentation",
+    "variants": [
+      {
+        "variantKey": "livekit-v1",
+        "label": "v1.9 pinned"
+      },
+      {
+        "variantKey": "livekit-v1-latest",
+        "label": "v1.9 latest"
+      }
+    ]
   }
 ]

e2e/package.json

@@ -20,6 +20,7 @@
     "tsx": "^4.21.0",
     "typescript": "5.4.4",
     "vitest": "4.1.11",
-    "zod": "4.3.6"
+    "zod": "4.3.6",
+    "@braintrust/audio": "workspace:^"
   }
 }