Synchronize real-time audio API names (#692)

### Description

This PR standardizes the names of several real-time audio APIs across
the Foundry Local SDK language bindings. It also removes an extra unused
API in the JS SDK.

### Motivation and Context

The API names and their usage should be similar across the language
bindings. This ensures one language binding is not favored over another
language binding due to API usage.

### Copilot Summary

This pull request standardizes the naming of the real-time transcription
stream method across all SDKs by renaming methods like
`GetTranscriptionStream`, `getTranscriptionStream`, and
`get_transcription_stream` to `GetStream`, `getStream`, and `get_stream`
respectively. It also renames related files and updates all references
in documentation, tests, and code to match the new naming. Additionally,
C++ and JS client files are renamed for consistency. These changes
improve API clarity and make the SDKs more consistent across languages.

**SDK method and API renaming:**

* Renamed all real-time transcription stream methods to
`GetStream`/`getStream`/`get_stream` in C#, JS, Python, and Rust SDKs,
replacing previous names like `GetTranscriptionStream` and
`getTranscriptionStream`. All usages and documentation references are
updated accordingly.

**File and import renaming for consistency:**

* Renamed C++ and JS client files from `openai_live_audio_client.*` and
`liveAudioTranscriptionClient.js` to `openai_live_audio_session.*` and
`liveAudioSession.js`, updating all includes/imports throughout the
codebase.

**Interface and API cleanup:**

* Removed the `createLiveTranscriptionSession` method from the JS
`IModel` interface, reflecting the new naming and usage patterns.

These changes ensure a consistent and predictable developer experience
across all supported languages.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

Author: kunal-vaishnavi

.gitignore

@@ -38,3 +38,6 @@ logs/
 
 # Local NuGet packages built from source
 local-packages/
+
+# JS SDK downloaded native core binaries
+sdk/js/foundry-local-core/

samples/cs/live-audio-transcription/Program.cs

@@ -52,7 +52,7 @@ await model.DownloadAsync(progress =>
 {
     try
     {
-        await foreach (var result in session.GetTranscriptionStream())
+        await foreach (var result in session.GetStream())
         {
             var text = result.Content?[0]?.Text;
             if (result.IsFinal)

samples/cs/live-audio-transcription/README.md

@@ -36,7 +36,7 @@ dotnet run -- --synth
 2. Creates a `LiveAudioTranscriptionSession` with 16kHz/16-bit/mono PCM settings
 3. Captures microphone audio via `NAudio.WaveInEvent` (or generates synthetic audio as fallback)
 4. Pushes PCM chunks to the SDK via `session.AppendAsync()` through a bounded channel for backpressure
-5. Reads transcription results via `await foreach (var result in session.GetTranscriptionStream())`
+5. Reads transcription results via `await foreach (var result in session.GetStream())`
 6. Access text via `result.Content[0].Text` (OpenAI Realtime ConversationItem pattern)
 
 ## API
@@ -54,7 +54,7 @@ await session.StartAsync();
 await session.AppendAsync(pcmBytes);
 
 // Read results
-await foreach (var result in session.GetTranscriptionStream())
+await foreach (var result in session.GetStream())
 {
     Console.WriteLine(result.Content[0].Text);       // transcribed text
     Console.WriteLine(result.Content[0].Transcript); // alias (OpenAI compat)

samples/js/live-audio-transcription/README.md

@@ -30,7 +30,7 @@ Speak into your microphone. Transcription appears in real-time. Press `Ctrl+C` t
 2. Creates a `LiveAudioTranscriptionSession` with 16kHz/16-bit/mono PCM settings
 3. Captures microphone audio via `naudiodon2` (or generates synthetic audio as fallback)
 4. Pushes PCM chunks to the SDK via `session.append()`
-5. Reads transcription results via `for await (const result of session.getTranscriptionStream())`
+5. Reads transcription results via `for await (const result of session.getStream())`
 6. Access text via `result.content[0].text` (OpenAI Realtime ConversationItem pattern)
 
 ## API
@@ -48,7 +48,7 @@ await session.start();
 await session.append(pcmBytes);
 
 // Read results
-for await (const result of session.getTranscriptionStream()) {
+for await (const result of session.getStream()) {
     console.log(result.content[0].text);       // transcribed text
     console.log(result.content[0].transcript); // alias (OpenAI compat)
     console.log(result.is_final);              // true for final results

samples/js/live-audio-transcription/app.js

@@ -15,7 +15,7 @@ console.log();
 // Initialize the Foundry Local SDK
 console.log('Initializing Foundry Local SDK...');
 const manager = FoundryLocalManager.create({
-    appName: 'foundry',
+    appName: 'foundry_local_samples',
     logLevel: 'info'
 });
 console.log('✓ SDK initialized');
@@ -55,7 +55,7 @@ console.log('✓ Session started');
 // Read transcription results in background
 const readPromise = (async () => {
     try {
-        for await (const result of session.getTranscriptionStream()) {
+        for await (const result of session.getStream()) {
             const text = result.content?.[0]?.text;
             if (!text) continue;
 

samples/python/live-audio-transcription/README.md

@@ -41,7 +41,7 @@ python src/app.py --synth
 2. Creates a `LiveAudioTranscriptionSession` with 16kHz/16-bit/mono PCM settings
 3. Captures microphone audio via `pyaudio` (or generates synthetic audio as fallback)
 4. Pushes PCM chunks to the SDK via `session.append()`
-5. Reads transcription results in a background thread via `for result in session.get_transcription_stream()`
+5. Reads transcription results in a background thread via `for result in session.get_stream()`
 6. Access text via `result.content[0].text` (OpenAI Realtime ConversationItem pattern)
 
 ## API
@@ -59,7 +59,7 @@ session.start()
 session.append(pcm_bytes)
 
 # Read results (typically on a background thread)
-for result in session.get_transcription_stream():
+for result in session.get_stream():
     print(result.content[0].text)        # transcribed text
     print(result.content[0].transcript)  # alias (OpenAI compat)
     print(result.is_final)               # True for final results

samples/python/live-audio-transcription/src/app.py

@@ -53,7 +53,7 @@
 # --- Background thread reads transcription results (mirrors JS readPromise) ---
 
 def read_results():
-    for result in session.get_transcription_stream():
+    for result in session.get_stream():
         text = result.content[0].text if result.content else ""
         if result.is_final:
             print()

samples/rust/live-audio-transcription/src/main.rs

@@ -62,7 +62,7 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
     println!("✓ Session started\n");
 
     // --- Background task reads transcription results (mirrors JS readPromise) ---
-    let mut stream = session.get_transcription_stream().await?;
+    let mut stream = session.get_stream().await?;
     let read_task = tokio::spawn(async move {
         while let Some(result) = stream.next().await {
             match result {

sdk/cpp/CMakeLists.txt

@@ -52,10 +52,10 @@ endif()
 add_library(CppSdk STATIC
   src/model.cpp
   src/catalog.cpp
-  src/openai_chat_client.cpp
-  src/openai_audio_client.cpp
-  src/openai_live_audio_types.cpp
-  src/openai_live_audio_client.cpp
+  src/chat_client.cpp
+  src/audio_client.cpp
+  src/live_audio_types.cpp
+  src/live_audio_session.cpp
   src/foundry_local_manager.cpp
 )
 

sdk/cpp/include/foundry_local.h

@@ -13,8 +13,8 @@
 #include "model.h"
 #include "catalog.h"
 #include "foundry_local_manager.h"
-#include "openai/openai_tool_types.h"
-#include "openai/openai_chat_client.h"
-#include "openai/openai_audio_client.h"
-#include "openai/openai_live_audio_types.h"
-#include "openai/openai_live_audio_client.h"
+#include "openai/tool_types.h"
+#include "openai/chat_client.h"
+#include "openai/audio_client.h"
+#include "openai/live_audio_types.h"
+#include "openai/live_audio_session.h"