NovaSonicSession

Whether the session is currently active.

Start the bidirectional streaming session.

Sends the session start, prompt start, and system prompt events in the required order.

Send a text message as user input.

Start an audio input stream.

Call this before sending audio chunks. When done, call :meth:end_audio_input.

Send a chunk of audio data to the stream.

End the current audio input stream.

Receive and yield parsed events from the model.

Yields dictionaries with the following possible structures:

• {"type": "text", "role": str, "text": str} for text output
• {"type": "audio", "audio": bytes} for audio output
• {"type": "content_start", "role": str, ...} for content start
• {"type": "content_end"} for content end

Signal end of input to the model.

Sends promptEnd and sessionEnd events and closes the input stream. The output stream remains readable so that receive_events can continue to yield responses.

End the session and close the stream.

Sends prompt end and session end events (if not already sent), then marks the session as inactive.