[David Elner (delner)]

Based on #1067

Adds optional Opus encoding and Ogg container support so the shared recording pipeline. Install the extension alongside Braintrust and enabled recordings use Opus in Ogg automatically, with no encoder or middleware setup:

pip install braintrust-audio

Encoding can also be selected explicitly:

from braintrust.audio import AudioEncoding, AudioRecordingOptions

audio = AudioRecordingOptions(
    encoding=AudioEncoding(codec="opus", container="ogg"),
)

Session recording
  part-0.ogg   ▶ playable on its own
  part-1.ogg   ▶ playable on its own
  part-2.ogg   ▶ playable on its own

Design

flowchart LR
    C[Core audio contract] --> M[Optional codec middleware]
    M --> E[PyAV / Opus encoder]
    E --> O[Independent Ogg segments]

Loading

• Native codec dependencies live in a separate distribution, to avoid adding additional constraints to the main SDK package.
• The package includes codec round-trip tests and its own build/release CI.

[David Elner (delner)]

Still very much a work in progress: this is just a first pass right now. Not sure if the packaging as-is is the right way to go.