@voxevolv/client 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to `@voxevolv/client` are recorded here.
 
+## 0.2.0 - 2026-07-20
+
+- Add `session.outputStream`: a stable `MediaStream` that always holds the
+  agent's current remote audio tracks across track arrival, reconnects, and
+  rejoin.
+- `connect()` now also waits for the first remote agent audio track (within
+  the same `readyTimeoutMs` budget) before resolving, so media is flowing when
+  connect resolves. Pass `waitForRemoteAudio: false` to restore the previous
+  signaling-only readiness.
+
 ## 0.1.0 - 2026-07-18
 
 - Add application-owned audio-track publication and remote-audio access.

package/README.md

@@ -100,6 +100,27 @@ a native `MediaStreamTrack` and single-track `MediaStream` for recording,
 metering, or another application-owned audio graph. Both listener registration
 methods return an unsubscribe function.
 
+## Agent audio readiness
+
+By default `connect()` resolves only after the agent reported readiness *and*
+the first remote agent audio track arrived, both within the same
+`readyTimeoutMs` budget (15 s by default). Agent media is therefore already
+flowing when `connect()` resolves, so recording or metering set up right after
+`connect()` does not race track arrival.
+
+`session.outputStream` is a stable `MediaStream` available from session
+creation. The stream object never changes; remote agent audio tracks are added
+when they arrive and removed when they end, including across `rejoin()` and
+reconnects. Note that Web Audio's `createMediaStreamSource()` requires the
+stream to already contain an audio track, so audio-graph consumers should
+still attach inside `onRemoteAudioTrack`.
+
+Applications that intentionally run without agent audio can opt out:
+
+```ts
+await session.connect({ waitForRemoteAudio: false });
+```
+
 ## Rejoin and end
 
 `rejoin()` can be called from a connected or disconnected state. It obtains a