fix(voice): align session.start recording with Python primary-session semantics

[toubatbrian]

Summary

Follow-up to #1702 (granular RecordingOptions). That PR ported the recording-options model but left the primary-session designation out of parity with the Python SDK. This aligns it:

• The primary/secondary AgentSession designation now happens in start() before initRecording, so a demoted secondary session never configures cloud recording. (Previously the designation lived in _startImpl, which runs after start() already called initRecording.)
• A non-primary session whose record was not explicitly given now silently disables its recording, instead of throwing. It still throws only when record was passed explicitly — mirroring Python's record_is_given logic in agent_session.py:629-655.
• Added the ctx._primaryAgentSession === this re-entry case to match Python's is None or is self.

Why this matters

record defaults to the server-side job.enableRecording (often true). Before this change, a second AgentSession in the same job would throw on start() even though the user never asked to record it. Python avoids this by auto-disabling the secondary session; this PR brings JS to parity.

Test plan

Verified end-to-end by driving a real agent through agents-cli against LiveKit Cloud (voice mode), with temporary instrumentation on every recording gate. Confirmed via runtime logs:

record	local audio (audio.ogg)	cloud tracer	upload	parts attached
true	started	yes	yes	chat_history + audio
false	none	skipped	none	—
{audio-only}	started	skipped	yes	audio only
{transcript-only}	none	skipped	yes	chat_history only

• pnpm build:agents passes
• agent_session unit tests pass
• Lint clean

[changeset-bot]

🦋 Changeset detected

Latest commit: e570c88

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 34 packages

Name	Type
@livekit/agents	Patch
@livekit/agents-plugin-anam	Patch
@livekit/agents-plugin-assemblyai	Patch
@livekit/agents-plugin-baseten	Patch
@livekit/agents-plugin-bey	Patch
@livekit/agents-plugin-cartesia	Patch
@livekit/agents-plugin-cerebras	Patch
@livekit/agents-plugin-deepgram	Patch
@livekit/agents-plugin-elevenlabs	Patch
@livekit/agents-plugin-fishaudio	Patch
@livekit/agents-plugin-google	Patch
@livekit/agents-plugin-hedra	Patch
@livekit/agents-plugin-hume	Patch
@livekit/agents-plugin-inworld	Patch
@livekit/agents-plugin-lemonslice	Patch
@livekit/agents-plugin-liveavatar	Patch
@livekit/agents-plugin-livekit	Patch
@livekit/agents-plugin-minimax	Patch
@livekit/agents-plugin-mistral	Patch
@livekit/agents-plugin-mistralai	Patch
@livekit/agents-plugin-neuphonic	Patch
@livekit/agents-plugin-openai	Patch
@livekit/agents-plugin-perplexity	Patch
@livekit/agents-plugin-phonic	Patch
@livekit/agents-plugin-resemble	Patch
@livekit/agents-plugin-rime	Patch
@livekit/agents-plugin-runway	Patch
@livekit/agents-plugin-sarvam	Patch
@livekit/agents-plugin-silero	Patch
@livekit/agents-plugin-soniox	Patch
@livekit/agents-plugin-tavus	Patch
@livekit/agents-plugins-test	Patch
@livekit/agents-plugin-trugen	Patch
@livekit/agents-plugin-xai	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 3 additional findings.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e570c889f5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".