diff --git a/.gitignore b/.gitignore
index 1b1f680f..406a20e9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -31,3 +31,4 @@ Cargo.lock
 bin/
 obj/
 /src/cs/samples/ConsoleClient/test.http
+logs/
\ No newline at end of file
diff --git a/sdk_v2/cs/GENERATE-DOCS.md b/sdk_v2/cs/GENERATE-DOCS.md
new file mode 100644
index 00000000..4ff9b5a6
--- /dev/null
+++ b/sdk_v2/cs/GENERATE-DOCS.md
@@ -0,0 +1,45 @@
+# Generating API Reference Docs
+
+The `docs/api/` folder contains auto-generated markdown from the C# XML documentation comments. This guide explains how to regenerate them.
+
+## Prerequisites
+
+Install xmldoc2md as a global dotnet tool:
+
+```bash
+dotnet tool install -g XMLDoc2Markdown
+```
+
+## Steps
+
+### 1. Publish the SDK
+
+xmldoc2md needs the XML documentation file and all dependency DLLs in one folder. The project only generates the XML documentation file in **Release** mode (`-c Release`), so always publish with that configuration:
+
+```bash
+dotnet publish src/Microsoft.AI.Foundry.Local.csproj -c Release -o src/bin/publish
+```
+
+### 2. Generate the docs
+
+```bash
+dotnet xmldoc2md src/bin/publish/Microsoft.AI.Foundry.Local.dll --output docs/api --member-accessibility-level public
+```
+
+### All-in-one
+
+```powershell
+dotnet publish src/Microsoft.AI.Foundry.Local.csproj -c Release -o src/bin/publish
+dotnet xmldoc2md src/bin/publish/Microsoft.AI.Foundry.Local.dll --output docs/api --member-accessibility-level public
+```
+
+## Known Limitations
+
+xmldoc2md uses reflection metadata, which loses some C# language-level details:
+
+- **Nullable annotations stripped** — `Task<Model?>` renders as `Task<Model>`. The `<returns>` text documents nullability, but the generated signature does not show `?`.
+- **Record/init semantics lost** — Record types with `init`-only properties (e.g., `Runtime`, `ModelInfo`) are rendered with `{ get; set; }` instead of `{ get; init; }`.
+- **Default parameter values omitted** — Optional parameters like `CancellationToken? ct = null` appear without their defaults.
+- **Compiler-generated members surfaced** — Record types emit synthetic methods like `<Clone>$()`, `Equals(T)`, `GetHashCode()`, and `ToString()` that appear in the generated docs. These are not part of the intended public API and should be ignored.
+
+These are cosmetic issues in the generated docs. Always refer to the source code or IntelliSense for the authoritative API surface.
diff --git a/sdk_v2/cs/README.md b/sdk_v2/cs/README.md
index 0297937e..d00aa4ff 100644
--- a/sdk_v2/cs/README.md
+++ b/sdk_v2/cs/README.md
@@ -1,59 +1,308 @@
 # Foundry Local C# SDK
 
-## Installation
+The Foundry Local C# SDK provides a .NET interface for running AI models locally via the Foundry Local Core. Discover, download, load, and run inference entirely on your own machine — no cloud required.
+
+## Features
 
-To use the Foundry Local C# SDK, you need to install the NuGet package:
+- **Model catalog** — browse and search all available models; filter by cached or loaded state
+- **Lifecycle management** — download, load, unload, and remove models programmatically
+- **Chat completions** — synchronous and `IAsyncEnumerable` streaming via OpenAI-compatible types
+- **Audio transcription** — transcribe audio files with streaming support
+- **Download progress** — wire up an `Action<float>` callback for real-time download percentage
+- **Model variants** — select specific hardware/quantization variants per model alias
+- **Optional web service** — start an OpenAI-compatible REST endpoint (`/v1/chat_completions`, `/v1/models`)
+- **WinML acceleration** — opt-in Windows hardware acceleration with automatic EP download
+- **Full async/await** — every operation supports `CancellationToken` and async patterns
+- **IDisposable** — deterministic cleanup of native resources
+
+## Installation
 
 ```bash
 dotnet add package Microsoft.AI.Foundry.Local
 ```
 
 ### Building from source
-To build the SDK, run the following command in your terminal:
 
 ```bash
-cd sdk/cs
-dotnet build sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj
+cd sdk_v2/cs
+dotnet build src/Microsoft.AI.Foundry.Local.csproj
 ```
 
-You can also load [FoundryLocal.sln](./FoundryLocal.sln) in Visual Studio 2022 or VSCode.
+Or open [Microsoft.AI.Foundry.Local.SDK.sln](./Microsoft.AI.Foundry.Local.SDK.sln) in Visual Studio / VS Code.
 
-## Usage
+## WinML: Automatic Hardware Acceleration (Windows)
+
+On Windows, Foundry Local can leverage WinML for GPU/NPU hardware acceleration via ONNX Runtime execution providers (EPs). EPs are large binaries downloaded on first use and cached for subsequent runs.
+
+Install the WinML package variant instead:
+
+```bash
+dotnet add package Microsoft.AI.Foundry.Local.WinML
+```
+
+Or build from source with:
+
+```bash
+dotnet build src/Microsoft.AI.Foundry.Local.csproj /p:UseWinML=true
+```
 
-> [!NOTE]
-> For this example, you'll need the OpenAI Nuget package installed as well:
-> ```bash
-> dotnet add package OpenAI
-> ```
+### Triggering EP download
+
+EP download can be time-consuming. Call `EnsureEpsDownloadedAsync` early (after initialization) to separate the download step from catalog access:
+
+```csharp
+// Initialize the manager first (see Quick Start)
+await FoundryLocalManager.CreateAsync(
+    new Configuration { AppName = "my-app" },
+    NullLogger.Instance);
+
+await FoundryLocalManager.Instance.EnsureEpsDownloadedAsync();
+
+// Now catalog access won't trigger an EP download
+var catalog = await FoundryLocalManager.Instance.GetCatalogAsync();
+```
+
+If you skip this step, EPs are downloaded automatically the first time you access the catalog. Once cached, subsequent calls are fast.
+
+## Quick Start
 
 ```csharp
 using Microsoft.AI.Foundry.Local;
-using OpenAI;
-using OpenAI.Chat;
-using System.ClientModel;
-using System.Diagnostics.Metrics;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging.Abstractions;
+using Betalgo.Ranul.OpenAI.ObjectModels.RequestModels;
+
+// 1. Initialize the singleton manager
+await FoundryLocalManager.CreateAsync(
+    new Configuration { AppName = "my-app" },
+    NullLogger.Instance);
+
+// 2. Get the model catalog and look up a model
+var catalog = await FoundryLocalManager.Instance.GetCatalogAsync();
+var model = await catalog.GetModelAsync("phi-3.5-mini")
+    ?? throw new Exception("Model 'phi-3.5-mini' not found in catalog.");
+
+// 3. Download (if needed) and load the model
+await model.DownloadAsync();
+await model.LoadAsync();
+
+// 4. Get a chat client and run inference
+var chatClient = await model.GetChatClientAsync();
+var response = await chatClient.CompleteChatAsync(new[]
+{
+    ChatMessage.FromUser("Why is the sky blue?")
+});
+
+Console.WriteLine(response.Choices![0].Message.Content);
+
+// 5. Clean up
+FoundryLocalManager.Instance.Dispose();
+```
+
+## Usage
+
+### Initialization
+
+`FoundryLocalManager` is an async singleton. Call `CreateAsync` once at startup:
+
+```csharp
+await FoundryLocalManager.CreateAsync(
+    new Configuration { AppName = "my-app" },
+    loggerFactory.CreateLogger("FoundryLocal"));
+```
+
+Access it anywhere afterward via `FoundryLocalManager.Instance`. Check `FoundryLocalManager.IsInitialized` to verify creation.
+
+### Catalog
+
+The catalog lists all models known to the Foundry Local Core:
+
+```csharp
+var catalog = await FoundryLocalManager.Instance.GetCatalogAsync();
+
+// List all available models
+var models = await catalog.ListModelsAsync();
+foreach (var m in models)
+    Console.WriteLine($"{m.Alias} — {m.SelectedVariant.Info.DisplayName}");
+
+// Get a specific model by alias
+var model = await catalog.GetModelAsync("phi-3.5-mini")
+    ?? throw new Exception("Model 'phi-3.5-mini' not found in catalog.");
+
+// Get a specific variant by its unique model ID
+var variant = await catalog.GetModelVariantAsync("phi-3.5-mini-generic-gpu-4")
+    ?? throw new Exception("Variant 'phi-3.5-mini-generic-gpu-4' not found in catalog.");
+
+// List models already downloaded to the local cache
+var cached = await catalog.GetCachedModelsAsync();
+
+// List models currently loaded in memory
+var loaded = await catalog.GetLoadedModelsAsync();
+```
+
+### Model Lifecycle
+
+Each `Model` wraps one or more `ModelVariant` entries (different quantizations, hardware targets). The SDK auto-selects the best variant, or you can pick one:
+
+```csharp
+// Check and select variants
+Console.WriteLine($"Selected: {model.SelectedVariant.Id}");
+foreach (var v in model.Variants)
+    Console.WriteLine($"  {v.Id} (cached: {await v.IsCachedAsync()})");
+
+// Switch to a different variant
+model.SelectVariant(model.Variants[1]);
+```
+
+Download, load, and unload:
 
-var alias = "phi-3.5-mini";
+```csharp
+// Download with progress reporting
+await model.DownloadAsync(progress =>
+    Console.WriteLine($"Download: {progress:F1}%"));
+
+// Load into memory
+await model.LoadAsync();
 
-var manager = await FoundryLocalManager.StartModelAsync(aliasOrModelId: alias);
+// Unload when done
+await model.UnloadAsync();
+
+// Remove from local cache entirely
+await model.RemoveFromCacheAsync();
+```
+
+### Chat Completions
+
+```csharp
+var chatClient = await model.GetChatClientAsync();
 
-var model = await manager.GetModelInfoAsync(aliasOrModelId: alias);
-ApiKeyCredential key = new ApiKeyCredential(manager.ApiKey);
-OpenAIClient client = new OpenAIClient(key, new OpenAIClientOptions
+var response = await chatClient.CompleteChatAsync(new[]
 {
-    Endpoint = manager.Endpoint
+    ChatMessage.FromSystem("You are a helpful assistant."),
+    ChatMessage.FromUser("Explain async/await in C#.")
 });
 
-var chatClient = client.GetChatClient(model?.ModelId);
+Console.WriteLine(response.Choices![0].Message.Content);
+```
+
+#### Streaming
 
-var completionUpdates = chatClient.CompleteChatStreaming("Why is the sky blue'");
+Use `IAsyncEnumerable` for token-by-token output:
+
+```csharp
+using var cts = new CancellationTokenSource();
 
-Console.Write($"[ASSISTANT]: ");
-foreach (var completionUpdate in completionUpdates)
+await foreach (var chunk in chatClient.CompleteChatStreamingAsync(
+    new[] { ChatMessage.FromUser("Write a haiku about .NET") }, cts.Token))
 {
-    if (completionUpdate.ContentUpdate.Count > 0)
-    {
-        Console.Write(completionUpdate.ContentUpdate[0].Text);
-    }
+    Console.Write(chunk.Choices?[0]?.Delta?.Content);
+}
+```
+
+#### Chat Settings
+
+Tune generation parameters per client:
+
+```csharp
+chatClient.Settings.Temperature = 0.7f;
+chatClient.Settings.MaxTokens = 256;
+chatClient.Settings.TopP = 0.9f;
+chatClient.Settings.FrequencyPenalty = 0.5f;
+```
+
+### Audio Transcription
+
+```csharp
+var audioClient = await model.GetAudioClientAsync();
+
+// One-shot transcription
+var result = await audioClient.TranscribeAudioAsync("recording.mp3");
+Console.WriteLine(result.Text);
+
+// Streaming transcription
+await foreach (var chunk in audioClient.TranscribeAudioStreamingAsync("recording.mp3", CancellationToken.None))
+{
+    Console.Write(chunk.Text);
 }
 ```
+
+#### Audio Settings
+
+```csharp
+audioClient.Settings.Language = "en";
+audioClient.Settings.Temperature = 0.0f;
+```
+
+### Web Service
+
+Start an OpenAI-compatible REST endpoint for use by external tools or processes:
+
+```csharp
+// Configure the web service URL in your Configuration
+await FoundryLocalManager.CreateAsync(
+    new Configuration
+    {
+        AppName = "my-app",
+        Web = new Configuration.WebService { Urls = "http://127.0.0.1:5000" }
+    },
+    NullLogger.Instance);
+
+await FoundryLocalManager.Instance.StartWebServiceAsync();
+Console.WriteLine($"Listening on: {string.Join(", ", FoundryLocalManager.Instance.Urls!)}");
+
+// ... use the service ...
+
+await FoundryLocalManager.Instance.StopWebServiceAsync();
+```
+
+### Configuration
+
+| Property | Type | Default | Description |
+|---|---|---|---|
+| `AppName` | `string` | **(required)** | Your application name |
+| `AppDataDir` | `string?` | `~/.{AppName}` | Application data directory |
+| `ModelCacheDir` | `string?` | `{AppDataDir}/cache/models` | Where models are stored locally |
+| `LogsDir` | `string?` | `{AppDataDir}/logs` | Log output directory |
+| `LogLevel` | `LogLevel` | `Warning` | `Verbose`, `Debug`, `Information`, `Warning`, `Error`, `Fatal` |
+| `Web` | `WebService?` | `null` | Web service configuration (see below) |
+| `AdditionalSettings` | `IDictionary<string, string>?` | `null` | Extra key-value settings passed to Core |
+
+**`Configuration.WebService`**
+
+| Property | Type | Default | Description |
+|---|---|---|---|
+| `Urls` | `string?` | `127.0.0.1:0` | Bind address; semi-colon separated for multiple |
+| `ExternalUrl` | `Uri?` | `null` | URI for accessing the web service in a separate process |
+
+### Disposal
+
+`FoundryLocalManager` implements `IDisposable`. Dispose stops the web service (if running) and releases native resources:
+
+```csharp
+FoundryLocalManager.Instance.Dispose();
+```
+
+## API Reference
+
+Auto-generated API docs live in [`docs/api/`](./docs/api/). See [`GENERATE-DOCS.md`](./GENERATE-DOCS.md) to regenerate.
+
+Key types:
+
+| Type | Description |
+|---|---|
+| [`FoundryLocalManager`](./docs/api/microsoft.ai.foundry.local.foundrylocalmanager.md) | Singleton entry point — create, catalog, web service |
+| [`Configuration`](./docs/api/microsoft.ai.foundry.local.configuration.md) | Initialization settings |
+| [`ICatalog`](./docs/api/microsoft.ai.foundry.local.icatalog.md) | Model catalog interface |
+| [`Model`](./docs/api/microsoft.ai.foundry.local.model.md) | Model with variant selection |
+| [`ModelVariant`](./docs/api/microsoft.ai.foundry.local.modelvariant.md) | Specific model variant (hardware/quantization) |
+| [`OpenAIChatClient`](./docs/api/microsoft.ai.foundry.local.openaichatclient.md) | Chat completions (sync + streaming) |
+| [`OpenAIAudioClient`](./docs/api/microsoft.ai.foundry.local.openaiaudioclient.md) | Audio transcription (sync + streaming) |
+| [`ModelInfo`](./docs/api/microsoft.ai.foundry.local.modelinfo.md) | Full model metadata record |
+
+## Tests
+
+```bash
+dotnet test
+```
+
+See [`test/FoundryLocal.Tests/LOCAL_MODEL_TESTING.md`](./test/FoundryLocal.Tests/LOCAL_MODEL_TESTING.md) for prerequisites and local model setup.
diff --git a/sdk_v2/cs/docs/api/index.md b/sdk_v2/cs/docs/api/index.md
new file mode 100644
index 00000000..1dcc4e4c
--- /dev/null
+++ b/sdk_v2/cs/docs/api/index.md
@@ -0,0 +1,41 @@
+# Microsoft.AI.Foundry.Local
+
+## Microsoft.AI.Foundry.Local
+
+[Configuration](./microsoft.ai.foundry.local.configuration.md)
+
+[DeviceType](./microsoft.ai.foundry.local.devicetype.md)
+
+[FoundryLocalException](./microsoft.ai.foundry.local.foundrylocalexception.md)
+
+[FoundryLocalManager](./microsoft.ai.foundry.local.foundrylocalmanager.md)
+
+[ICatalog](./microsoft.ai.foundry.local.icatalog.md)
+
+[IModel](./microsoft.ai.foundry.local.imodel.md)
+
+[LogLevel](./microsoft.ai.foundry.local.loglevel.md)
+
+[Model](./microsoft.ai.foundry.local.model.md)
+
+[ModelInfo](./microsoft.ai.foundry.local.modelinfo.md)
+
+[ModelSettings](./microsoft.ai.foundry.local.modelsettings.md)
+
+[ModelVariant](./microsoft.ai.foundry.local.modelvariant.md)
+
+[OpenAIAudioClient](./microsoft.ai.foundry.local.openaiaudioclient.md)
+
+[OpenAIChatClient](./microsoft.ai.foundry.local.openaichatclient.md)
+
+[Parameter](./microsoft.ai.foundry.local.parameter.md)
+
+[PromptTemplate](./microsoft.ai.foundry.local.prompttemplate.md)
+
+[Runtime](./microsoft.ai.foundry.local.runtime.md)
+
+## Microsoft.AI.Foundry.Local.Detail
+
+[AsyncLock](./microsoft.ai.foundry.local.detail.asynclock.md)
+
+[CoreInteropRequest](./microsoft.ai.foundry.local.detail.coreinteroprequest.md)
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.configuration.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.configuration.md
new file mode 100644
index 00000000..a549a301
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.configuration.md
@@ -0,0 +1,117 @@
+# Configuration
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class Configuration
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [Configuration](./microsoft.ai.foundry.local.configuration.md)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute), [RequiredMemberAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.requiredmemberattribute)
+
+## Properties
+
+### **AppName**
+
+Your application name. MUST be set to a valid name.
+
+```csharp
+public string AppName { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **AppDataDir**
+
+Application data directory.
+ Default: {home}/.{appname}, where {home} is the user's home directory and {appname} is the AppName value.
+
+```csharp
+public string AppDataDir { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **ModelCacheDir**
+
+Model cache directory.
+ Default: {appdata}/cache/models, where {appdata} is the AppDataDir value.
+
+```csharp
+public string ModelCacheDir { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **LogsDir**
+
+Log directory.
+ Default: {appdata}/logs
+
+```csharp
+public string LogsDir { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **LogLevel**
+
+Logging level.
+ Valid values are: Verbose, Debug, Information, Warning, Error, Fatal.
+ Default: LogLevel.Warning
+
+```csharp
+public LogLevel LogLevel { get; set; }
+```
+
+#### Property Value
+
+[LogLevel](./microsoft.ai.foundry.local.loglevel.md)<br>
+
+### **Web**
+
+Optional configuration for the built-in web service.
+ NOTE: This is not included in all builds.
+
+```csharp
+public WebService Web { get; set; }
+```
+
+#### Property Value
+
+[WebService](./microsoft.ai.foundry.local.configuration.webservice.md)<br>
+
+### **AdditionalSettings**
+
+Additional settings that Foundry Local Core can consume.
+ Keys and values are strings.
+
+```csharp
+public IDictionary<string, string> AdditionalSettings { get; set; }
+```
+
+#### Property Value
+
+[IDictionary&lt;String, String&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2)<br>
+
+## Constructors
+
+### **Configuration()**
+
+#### Caution
+
+Constructors of types with required members are not supported in this version of your compiler.
+
+---
+
+```csharp
+public Configuration()
+```
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.detail.asynclock.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.detail.asynclock.md
new file mode 100644
index 00000000..56ccf77a
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.detail.asynclock.md
@@ -0,0 +1,47 @@
+# AsyncLock
+
+Namespace: Microsoft.AI.Foundry.Local.Detail
+
+```csharp
+public sealed class AsyncLock : System.IDisposable
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [AsyncLock](./microsoft.ai.foundry.local.detail.asynclock.md)<br>
+Implements [IDisposable](https://docs.microsoft.com/en-us/dotnet/api/system.idisposable)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Constructors
+
+### **AsyncLock()**
+
+```csharp
+public AsyncLock()
+```
+
+## Methods
+
+### **Dispose()**
+
+```csharp
+public void Dispose()
+```
+
+### **Lock()**
+
+```csharp
+public IDisposable Lock()
+```
+
+#### Returns
+
+[IDisposable](https://docs.microsoft.com/en-us/dotnet/api/system.idisposable)<br>
+
+### **LockAsync()**
+
+```csharp
+public Task<IDisposable> LockAsync()
+```
+
+#### Returns
+
+[Task&lt;IDisposable&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.detail.coreinteroprequest.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.detail.coreinteroprequest.md
new file mode 100644
index 00000000..5a2a1378
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.detail.coreinteroprequest.md
@@ -0,0 +1,30 @@
+# CoreInteropRequest
+
+Namespace: Microsoft.AI.Foundry.Local.Detail
+
+```csharp
+public class CoreInteropRequest
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [CoreInteropRequest](./microsoft.ai.foundry.local.detail.coreinteroprequest.md)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **Params**
+
+```csharp
+public Dictionary<string, string> Params { get; set; }
+```
+
+#### Property Value
+
+[Dictionary&lt;String, String&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.dictionary-2)<br>
+
+## Constructors
+
+### **CoreInteropRequest()**
+
+```csharp
+public CoreInteropRequest()
+```
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.devicetype.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.devicetype.md
new file mode 100644
index 00000000..f605fa0e
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.devicetype.md
@@ -0,0 +1,20 @@
+# DeviceType
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public enum DeviceType
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [ValueType](https://docs.microsoft.com/en-us/dotnet/api/system.valuetype) → [Enum](https://docs.microsoft.com/en-us/dotnet/api/system.enum) → [DeviceType](./microsoft.ai.foundry.local.devicetype.md)<br>
+Implements [IComparable](https://docs.microsoft.com/en-us/dotnet/api/system.icomparable), [ISpanFormattable](https://docs.microsoft.com/en-us/dotnet/api/system.ispanformattable), [IFormattable](https://docs.microsoft.com/en-us/dotnet/api/system.iformattable), [IConvertible](https://docs.microsoft.com/en-us/dotnet/api/system.iconvertible)<br>
+Attributes JsonConverterAttribute
+
+## Fields
+
+| Name | Value | Description |
+| --- | --: | --- |
+| Invalid | 0 |  |
+| CPU | 1 |  |
+| GPU | 2 |  |
+| NPU | 3 |  |
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.foundrylocalexception.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.foundrylocalexception.md
new file mode 100644
index 00000000..a28d1dcc
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.foundrylocalexception.md
@@ -0,0 +1,117 @@
+# FoundryLocalException
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class FoundryLocalException : System.Exception, System.Runtime.Serialization.ISerializable
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [Exception](https://docs.microsoft.com/en-us/dotnet/api/system.exception) → [FoundryLocalException](./microsoft.ai.foundry.local.foundrylocalexception.md)<br>
+Implements [ISerializable](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.serialization.iserializable)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **TargetSite**
+
+```csharp
+public MethodBase TargetSite { get; }
+```
+
+#### Property Value
+
+[MethodBase](https://docs.microsoft.com/en-us/dotnet/api/system.reflection.methodbase)<br>
+
+### **Message**
+
+```csharp
+public string Message { get; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Data**
+
+```csharp
+public IDictionary Data { get; }
+```
+
+#### Property Value
+
+[IDictionary](https://docs.microsoft.com/en-us/dotnet/api/system.collections.idictionary)<br>
+
+### **InnerException**
+
+```csharp
+public Exception InnerException { get; }
+```
+
+#### Property Value
+
+[Exception](https://docs.microsoft.com/en-us/dotnet/api/system.exception)<br>
+
+### **HelpLink**
+
+```csharp
+public string HelpLink { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Source**
+
+```csharp
+public string Source { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **HResult**
+
+```csharp
+public int HResult { get; set; }
+```
+
+#### Property Value
+
+[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)<br>
+
+### **StackTrace**
+
+```csharp
+public string StackTrace { get; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+## Constructors
+
+### **FoundryLocalException(String)**
+
+```csharp
+public FoundryLocalException(string message)
+```
+
+#### Parameters
+
+`message` [String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **FoundryLocalException(String, Exception)**
+
+```csharp
+public FoundryLocalException(string message, Exception innerException)
+```
+
+#### Parameters
+
+`message` [String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+`innerException` [Exception](https://docs.microsoft.com/en-us/dotnet/api/system.exception)<br>
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.foundrylocalmanager.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.foundrylocalmanager.md
new file mode 100644
index 00000000..93f162b7
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.foundrylocalmanager.md
@@ -0,0 +1,170 @@
+# FoundryLocalManager
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class FoundryLocalManager : System.IDisposable
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [FoundryLocalManager](./microsoft.ai.foundry.local.foundrylocalmanager.md)<br>
+Implements [IDisposable](https://docs.microsoft.com/en-us/dotnet/api/system.idisposable)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **IsInitialized**
+
+```csharp
+public static bool IsInitialized { get; }
+```
+
+#### Property Value
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **Instance**
+
+```csharp
+public static FoundryLocalManager Instance { get; }
+```
+
+#### Property Value
+
+[FoundryLocalManager](./microsoft.ai.foundry.local.foundrylocalmanager.md)<br>
+
+### **Urls**
+
+Bound Urls if the web service has been started. Null otherwise.
+ See [FoundryLocalManager.StartWebServiceAsync(Nullable&lt;CancellationToken&gt;)](./microsoft.ai.foundry.local.foundrylocalmanager.md#startwebserviceasyncnullablecancellationtoken).
+
+```csharp
+public String[] Urls { get; private set; }
+```
+
+#### Property Value
+
+[String[]](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+## Methods
+
+### **CreateAsync(Configuration, ILogger, Nullable&lt;CancellationToken&gt;)**
+
+Create the [FoundryLocalManager](./microsoft.ai.foundry.local.foundrylocalmanager.md) singleton instance.
+
+```csharp
+public static Task CreateAsync(Configuration configuration, ILogger logger, Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`configuration` [Configuration](./microsoft.ai.foundry.local.configuration.md)<br>
+Configuration to use.
+
+`logger` ILogger<br>
+Application logger to use.
+ Use Microsoft.Extensions.Logging.NullLogger.Instance if you wish to ignore log output from the SDK.
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token for the initialization.
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+Task creating the instance.
+
+#### Exceptions
+
+[FoundryLocalException](./microsoft.ai.foundry.local.foundrylocalexception.md)<br>
+
+### **GetCatalogAsync(Nullable&lt;CancellationToken&gt;)**
+
+Get the model catalog instance.
+
+```csharp
+public Task<ICatalog> GetCatalogAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task&lt;ICatalog&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+The model catalog.
+
+**Remarks:**
+
+The catalog is populated on first use.
+ If you are using a WinML build this will trigger a one-off execution provider download if not already done.
+ It is recommended to call [FoundryLocalManager.EnsureEpsDownloadedAsync(Nullable&lt;CancellationToken&gt;)](./microsoft.ai.foundry.local.foundrylocalmanager.md#ensureepsdownloadedasyncnullablecancellationtoken) first to separate out the two steps.
+
+### **StartWebServiceAsync(Nullable&lt;CancellationToken&gt;)**
+
+Start the optional web service. This will provide an OpenAI-compatible REST endpoint that supports
+ /v1/chat_completions
+ /v1/models to list downloaded models
+ /v1/models/{model_id} to get model details
+ 
+ [FoundryLocalManager.Urls](./microsoft.ai.foundry.local.foundrylocalmanager.md#urls) is populated with the actual bound Urls after startup.
+
+```csharp
+public Task StartWebServiceAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+Task starting the web service.
+
+### **StopWebServiceAsync(Nullable&lt;CancellationToken&gt;)**
+
+Stops the web service if started.
+
+```csharp
+public Task StopWebServiceAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+Task stopping the web service.
+
+### **EnsureEpsDownloadedAsync(Nullable&lt;CancellationToken&gt;)**
+
+Ensure execution providers are downloaded and registered.
+ Only relevant when using WinML.
+ 
+ Execution provider download can be time consuming due to the size of the packages.
+ Once downloaded, EPs are not re-downloaded unless a new version is available, so this method will be fast
+ on subsequent calls.
+
+```csharp
+public Task EnsureEpsDownloadedAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **Dispose()**
+
+```csharp
+public void Dispose()
+```
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.icatalog.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.icatalog.md
new file mode 100644
index 00000000..dc68c173
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.icatalog.md
@@ -0,0 +1,121 @@
+# ICatalog
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public interface ICatalog
+```
+
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute)
+
+## Properties
+
+### **Name**
+
+The catalog name.
+
+```csharp
+public abstract string Name { get; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+## Methods
+
+### **ListModelsAsync(Nullable&lt;CancellationToken&gt;)**
+
+List the available models in the catalog.
+
+```csharp
+Task<List<Model>> ListModelsAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional CancellationToken.
+
+#### Returns
+
+[Task&lt;List&lt;Model&gt;&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+List of Model instances.
+
+### **GetModelAsync(String, Nullable&lt;CancellationToken&gt;)**
+
+Lookup a model by its alias.
+
+```csharp
+Task<Model> GetModelAsync(string modelAlias, Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`modelAlias` [String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+Model alias.
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional CancellationToken.
+
+#### Returns
+
+[Task&lt;Model&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+The matching Model, or null if no model with the given alias exists.
+
+### **GetModelVariantAsync(String, Nullable&lt;CancellationToken&gt;)**
+
+Lookup a model variant by its unique model id.
+
+```csharp
+Task<ModelVariant> GetModelVariantAsync(string modelId, Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`modelId` [String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+Model id.
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional CancellationToken.
+
+#### Returns
+
+[Task&lt;ModelVariant&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+The matching ModelVariant, or null if no variant with the given id exists.
+
+### **GetCachedModelsAsync(Nullable&lt;CancellationToken&gt;)**
+
+Get a list of currently downloaded models from the model cache.
+
+```csharp
+Task<List<ModelVariant>> GetCachedModelsAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional CancellationToken.
+
+#### Returns
+
+[Task&lt;List&lt;ModelVariant&gt;&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+List of ModelVariant instances.
+
+### **GetLoadedModelsAsync(Nullable&lt;CancellationToken&gt;)**
+
+Get a list of the currently loaded models.
+
+```csharp
+Task<List<ModelVariant>> GetLoadedModelsAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional CancellationToken.
+
+#### Returns
+
+[Task&lt;List&lt;ModelVariant&gt;&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+List of ModelVariant instances.
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.imodel.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.imodel.md
new file mode 100644
index 00000000..d5d2b437
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.imodel.md
@@ -0,0 +1,187 @@
+# IModel
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public interface IModel
+```
+
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute)
+
+## Properties
+
+### **Id**
+
+```csharp
+public abstract string Id { get; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Alias**
+
+```csharp
+public abstract string Alias { get; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+## Methods
+
+### **IsCachedAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+Task<bool> IsCachedAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;Boolean&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **IsLoadedAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+Task<bool> IsLoadedAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;Boolean&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **DownloadAsync(Action&lt;Single&gt;, Nullable&lt;CancellationToken&gt;)**
+
+Download the model to local cache if not already present.
+
+```csharp
+Task DownloadAsync(Action<float> downloadProgress, Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`downloadProgress` [Action&lt;Single&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.action-1)<br>
+Optional progress callback for download progress.
+ Percentage download (0 - 100.0) is reported.
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **GetPathAsync(Nullable&lt;CancellationToken&gt;)**
+
+Gets the model path if cached.
+
+```csharp
+Task<string> GetPathAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task&lt;String&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+Path of model directory.
+
+### **LoadAsync(Nullable&lt;CancellationToken&gt;)**
+
+Load the model into memory if not already loaded.
+
+```csharp
+Task LoadAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **RemoveFromCacheAsync(Nullable&lt;CancellationToken&gt;)**
+
+Remove the model from the local cache.
+
+```csharp
+Task RemoveFromCacheAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **UnloadAsync(Nullable&lt;CancellationToken&gt;)**
+
+Unload the model if loaded.
+
+```csharp
+Task UnloadAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **GetChatClientAsync(Nullable&lt;CancellationToken&gt;)**
+
+Get an OpenAI API based ChatClient
+
+```csharp
+Task<OpenAIChatClient> GetChatClientAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task&lt;OpenAIChatClient&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+OpenAI.ChatClient
+
+### **GetAudioClientAsync(Nullable&lt;CancellationToken&gt;)**
+
+Get an OpenAI API based AudioClient
+
+```csharp
+Task<OpenAIAudioClient> GetAudioClientAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task&lt;OpenAIAudioClient&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+OpenAI.AudioClient
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.loglevel.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.loglevel.md
new file mode 100644
index 00000000..ac942c0d
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.loglevel.md
@@ -0,0 +1,21 @@
+# LogLevel
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public enum LogLevel
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [ValueType](https://docs.microsoft.com/en-us/dotnet/api/system.valuetype) → [Enum](https://docs.microsoft.com/en-us/dotnet/api/system.enum) → [LogLevel](./microsoft.ai.foundry.local.loglevel.md)<br>
+Implements [IComparable](https://docs.microsoft.com/en-us/dotnet/api/system.icomparable), [ISpanFormattable](https://docs.microsoft.com/en-us/dotnet/api/system.ispanformattable), [IFormattable](https://docs.microsoft.com/en-us/dotnet/api/system.iformattable), [IConvertible](https://docs.microsoft.com/en-us/dotnet/api/system.iconvertible)
+
+## Fields
+
+| Name | Value | Description |
+| --- | --: | --- |
+| Verbose | 0 |  |
+| Debug | 1 |  |
+| Information | 2 |  |
+| Warning | 3 |  |
+| Error | 4 |  |
+| Fatal | 5 |  |
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.model.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.model.md
new file mode 100644
index 00000000..c63b78a4
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.model.md
@@ -0,0 +1,228 @@
+# Model
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class Model : IModel
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [Model](./microsoft.ai.foundry.local.model.md)<br>
+Implements [IModel](./microsoft.ai.foundry.local.imodel.md)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **Variants**
+
+```csharp
+public List<ModelVariant> Variants { get; internal set; }
+```
+
+#### Property Value
+
+[List&lt;ModelVariant&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.list-1)<br>
+
+### **SelectedVariant**
+
+```csharp
+public ModelVariant SelectedVariant { get; internal set; }
+```
+
+#### Property Value
+
+[ModelVariant](./microsoft.ai.foundry.local.modelvariant.md)<br>
+
+### **Alias**
+
+```csharp
+public string Alias { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Id**
+
+```csharp
+public string Id { get; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+## Methods
+
+### **IsCachedAsync(Nullable&lt;CancellationToken&gt;)**
+
+Is the currently selected variant cached locally?
+
+```csharp
+public Task<bool> IsCachedAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;Boolean&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **IsLoadedAsync(Nullable&lt;CancellationToken&gt;)**
+
+Is the currently selected variant loaded in memory?
+
+```csharp
+public Task<bool> IsLoadedAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;Boolean&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **SelectVariant(ModelVariant)**
+
+Select a specific model variant from [Model.Variants](./microsoft.ai.foundry.local.model.md#variants) to use for [IModel](./microsoft.ai.foundry.local.imodel.md) operations.
+
+```csharp
+public void SelectVariant(ModelVariant variant)
+```
+
+#### Parameters
+
+`variant` [ModelVariant](./microsoft.ai.foundry.local.modelvariant.md)<br>
+Model variant to select. Must be one of the variants in [Model.Variants](./microsoft.ai.foundry.local.model.md#variants).
+
+#### Exceptions
+
+[FoundryLocalException](./microsoft.ai.foundry.local.foundrylocalexception.md)<br>
+If variant is not valid for this model.
+
+### **GetLatestVersion(ModelVariant)**
+
+Get the latest version of the specified model variant.
+
+```csharp
+public ModelVariant GetLatestVersion(ModelVariant variant)
+```
+
+#### Parameters
+
+`variant` [ModelVariant](./microsoft.ai.foundry.local.modelvariant.md)<br>
+Model variant.
+
+#### Returns
+
+[ModelVariant](./microsoft.ai.foundry.local.modelvariant.md)<br>
+ModelVariant for latest version. Same as `variant` if that is the latest version.
+
+#### Exceptions
+
+[FoundryLocalException](./microsoft.ai.foundry.local.foundrylocalexception.md)<br>
+If variant is not valid for this model.
+
+### **GetPathAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task<string> GetPathAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;String&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **DownloadAsync(Action&lt;Single&gt;, Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task DownloadAsync(Action<float> downloadProgress, Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`downloadProgress` [Action&lt;Single&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.action-1)<br>
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **LoadAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task LoadAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **GetChatClientAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task<OpenAIChatClient> GetChatClientAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;OpenAIChatClient&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **GetAudioClientAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task<OpenAIAudioClient> GetAudioClientAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;OpenAIAudioClient&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **UnloadAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task UnloadAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **RemoveFromCacheAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task RemoveFromCacheAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.modelinfo.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.modelinfo.md
new file mode 100644
index 00000000..750253c1
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.modelinfo.md
@@ -0,0 +1,297 @@
+# ModelInfo
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class ModelInfo : System.IEquatable`1[[Microsoft.AI.Foundry.Local.ModelInfo, Microsoft.AI.Foundry.Local, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [ModelInfo](./microsoft.ai.foundry.local.modelinfo.md)<br>
+Implements [IEquatable&lt;ModelInfo&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.iequatable-1)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute), [RequiredMemberAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.requiredmemberattribute)
+
+## Properties
+
+### **Id**
+
+```csharp
+public string Id { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Name**
+
+```csharp
+public string Name { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Version**
+
+```csharp
+public int Version { get; set; }
+```
+
+#### Property Value
+
+[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)<br>
+
+### **Alias**
+
+```csharp
+public string Alias { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **DisplayName**
+
+```csharp
+public string DisplayName { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **ProviderType**
+
+```csharp
+public string ProviderType { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Uri**
+
+```csharp
+public string Uri { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **ModelType**
+
+```csharp
+public string ModelType { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **PromptTemplate**
+
+```csharp
+public PromptTemplate PromptTemplate { get; set; }
+```
+
+#### Property Value
+
+[PromptTemplate](./microsoft.ai.foundry.local.prompttemplate.md)<br>
+
+### **Publisher**
+
+```csharp
+public string Publisher { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **ModelSettings**
+
+```csharp
+public ModelSettings ModelSettings { get; set; }
+```
+
+#### Property Value
+
+[ModelSettings](./microsoft.ai.foundry.local.modelsettings.md)<br>
+
+### **License**
+
+```csharp
+public string License { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **LicenseDescription**
+
+```csharp
+public string LicenseDescription { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Cached**
+
+```csharp
+public bool Cached { get; set; }
+```
+
+#### Property Value
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **Task**
+
+```csharp
+public string Task { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Runtime**
+
+```csharp
+public Runtime Runtime { get; set; }
+```
+
+#### Property Value
+
+[Runtime](./microsoft.ai.foundry.local.runtime.md)<br>
+
+### **FileSizeMb**
+
+```csharp
+public Nullable<int> FileSizeMb { get; set; }
+```
+
+#### Property Value
+
+[Nullable&lt;Int32&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+### **SupportsToolCalling**
+
+```csharp
+public Nullable<bool> SupportsToolCalling { get; set; }
+```
+
+#### Property Value
+
+[Nullable&lt;Boolean&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+### **MaxOutputTokens**
+
+```csharp
+public Nullable<long> MaxOutputTokens { get; set; }
+```
+
+#### Property Value
+
+[Nullable&lt;Int64&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+### **MinFLVersion**
+
+```csharp
+public string MinFLVersion { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **CreatedAtUnix**
+
+```csharp
+public long CreatedAtUnix { get; set; }
+```
+
+#### Property Value
+
+[Int64](https://docs.microsoft.com/en-us/dotnet/api/system.int64)<br>
+
+## Constructors
+
+### **ModelInfo()**
+
+#### Caution
+
+Constructors of types with required members are not supported in this version of your compiler.
+
+---
+
+```csharp
+public ModelInfo()
+```
+
+## Methods
+
+### **ToString()**
+
+```csharp
+public string ToString()
+```
+
+#### Returns
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **GetHashCode()**
+
+```csharp
+public int GetHashCode()
+```
+
+#### Returns
+
+[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)<br>
+
+### **Equals(Object)**
+
+```csharp
+public bool Equals(object obj)
+```
+
+#### Parameters
+
+`obj` [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **Equals(ModelInfo)**
+
+```csharp
+public bool Equals(ModelInfo other)
+```
+
+#### Parameters
+
+`other` [ModelInfo](./microsoft.ai.foundry.local.modelinfo.md)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **&lt;Clone&gt;$()**
+
+```csharp
+public ModelInfo <Clone>$()
+```
+
+#### Returns
+
+[ModelInfo](./microsoft.ai.foundry.local.modelinfo.md)<br>
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.modelsettings.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.modelsettings.md
new file mode 100644
index 00000000..68386377
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.modelsettings.md
@@ -0,0 +1,91 @@
+# ModelSettings
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class ModelSettings : System.IEquatable`1[[Microsoft.AI.Foundry.Local.ModelSettings, Microsoft.AI.Foundry.Local, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [ModelSettings](./microsoft.ai.foundry.local.modelsettings.md)<br>
+Implements [IEquatable&lt;ModelSettings&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.iequatable-1)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **Parameters**
+
+```csharp
+public Parameter[] Parameters { get; set; }
+```
+
+#### Property Value
+
+[Parameter[]](./microsoft.ai.foundry.local.parameter.md)<br>
+
+## Constructors
+
+### **ModelSettings()**
+
+```csharp
+public ModelSettings()
+```
+
+## Methods
+
+### **ToString()**
+
+```csharp
+public string ToString()
+```
+
+#### Returns
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **GetHashCode()**
+
+```csharp
+public int GetHashCode()
+```
+
+#### Returns
+
+[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)<br>
+
+### **Equals(Object)**
+
+```csharp
+public bool Equals(object obj)
+```
+
+#### Parameters
+
+`obj` [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **Equals(ModelSettings)**
+
+```csharp
+public bool Equals(ModelSettings other)
+```
+
+#### Parameters
+
+`other` [ModelSettings](./microsoft.ai.foundry.local.modelsettings.md)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **&lt;Clone&gt;$()**
+
+```csharp
+public ModelSettings <Clone>$()
+```
+
+#### Returns
+
+[ModelSettings](./microsoft.ai.foundry.local.modelsettings.md)<br>
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.modelvariant.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.modelvariant.md
new file mode 100644
index 00000000..1f674511
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.modelvariant.md
@@ -0,0 +1,183 @@
+# ModelVariant
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class ModelVariant : IModel
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [ModelVariant](./microsoft.ai.foundry.local.modelvariant.md)<br>
+Implements [IModel](./microsoft.ai.foundry.local.imodel.md)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **Info**
+
+```csharp
+public ModelInfo Info { get; }
+```
+
+#### Property Value
+
+[ModelInfo](./microsoft.ai.foundry.local.modelinfo.md)<br>
+
+### **Id**
+
+```csharp
+public string Id { get; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Alias**
+
+```csharp
+public string Alias { get; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Version**
+
+```csharp
+public int Version { get; set; }
+```
+
+#### Property Value
+
+[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)<br>
+
+## Methods
+
+### **IsLoadedAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task<bool> IsLoadedAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;Boolean&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **IsCachedAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task<bool> IsCachedAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;Boolean&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **GetPathAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task<string> GetPathAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;String&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **DownloadAsync(Action&lt;Single&gt;, Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task DownloadAsync(Action<float> downloadProgress, Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`downloadProgress` [Action&lt;Single&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.action-1)<br>
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **LoadAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task LoadAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **UnloadAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task UnloadAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **RemoveFromCacheAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task RemoveFromCacheAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task)<br>
+
+### **GetChatClientAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task<OpenAIChatClient> GetChatClientAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;OpenAIChatClient&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+
+### **GetAudioClientAsync(Nullable&lt;CancellationToken&gt;)**
+
+```csharp
+public Task<OpenAIAudioClient> GetAudioClientAsync(Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+
+#### Returns
+
+[Task&lt;OpenAIAudioClient&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.openaiaudioclient.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.openaiaudioclient.md
new file mode 100644
index 00000000..bcaefc04
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.openaiaudioclient.md
@@ -0,0 +1,73 @@
+# OpenAIAudioClient
+
+Namespace: Microsoft.AI.Foundry.Local
+
+Audio Client that uses the OpenAI API.
+ Implemented using Betalgo.Ranul.OpenAI SDK types.
+
+```csharp
+public class OpenAIAudioClient
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [OpenAIAudioClient](./microsoft.ai.foundry.local.openaiaudioclient.md)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **Settings**
+
+Settings to use for audio transcription using this client.
+
+```csharp
+public AudioSettings Settings { get; }
+```
+
+#### Property Value
+
+[AudioSettings](./microsoft.ai.foundry.local.openaiaudioclient.audiosettings.md)<br>
+
+## Methods
+
+### **TranscribeAudioAsync(String, Nullable&lt;CancellationToken&gt;)**
+
+Transcribe audio from a file.
+
+```csharp
+public Task<AudioCreateTranscriptionResponse> TranscribeAudioAsync(string audioFilePath, Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`audioFilePath` [String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+Path to file containing audio recording.
+ Supported formats: mp3
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task&lt;AudioCreateTranscriptionResponse&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+Transcription response.
+
+### **TranscribeAudioStreamingAsync(String, CancellationToken)**
+
+Transcribe audio from a file with streamed output.
+
+```csharp
+public IAsyncEnumerable<AudioCreateTranscriptionResponse> TranscribeAudioStreamingAsync(string audioFilePath, CancellationToken ct)
+```
+
+#### Parameters
+
+`audioFilePath` [String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+Path to file containing audio recording.
+ Supported formats: mp3
+
+`ct` [CancellationToken](https://docs.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken)<br>
+Cancellation token.
+
+#### Returns
+
+[IAsyncEnumerable&lt;AudioCreateTranscriptionResponse&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.iasyncenumerable-1)<br>
+An asynchronous enumerable of transcription responses.
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.openaichatclient.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.openaichatclient.md
new file mode 100644
index 00000000..251e474c
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.openaichatclient.md
@@ -0,0 +1,75 @@
+# OpenAIChatClient
+
+Namespace: Microsoft.AI.Foundry.Local
+
+Chat Client that uses the OpenAI API.
+ Implemented using Betalgo.Ranul.OpenAI SDK types.
+
+```csharp
+public class OpenAIChatClient
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [OpenAIChatClient](./microsoft.ai.foundry.local.openaichatclient.md)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **Settings**
+
+Settings to use for chat completions using this client.
+
+```csharp
+public ChatSettings Settings { get; }
+```
+
+#### Property Value
+
+[ChatSettings](./microsoft.ai.foundry.local.openaichatclient.chatsettings.md)<br>
+
+## Methods
+
+### **CompleteChatAsync(IEnumerable&lt;ChatMessage&gt;, Nullable&lt;CancellationToken&gt;)**
+
+Execute a chat completion request.
+ 
+ To continue a conversation, add the ChatMessage from the previous response and new prompt to the messages.
+
+```csharp
+public Task<ChatCompletionCreateResponse> CompleteChatAsync(IEnumerable<ChatMessage> messages, Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`messages` [IEnumerable&lt;ChatMessage&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1)<br>
+Chat messages. The system message is automatically added.
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional cancellation token.
+
+#### Returns
+
+[Task&lt;ChatCompletionCreateResponse&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+Chat completion response.
+
+### **CompleteChatStreamingAsync(IEnumerable&lt;ChatMessage&gt;, CancellationToken)**
+
+Execute a chat completion request with streamed output.
+ 
+ To continue a conversation, add the ChatMessage from the previous response and new prompt to the messages.
+
+```csharp
+public IAsyncEnumerable<ChatCompletionCreateResponse> CompleteChatStreamingAsync(IEnumerable<ChatMessage> messages, CancellationToken ct)
+```
+
+#### Parameters
+
+`messages` [IEnumerable&lt;ChatMessage&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1)<br>
+Chat messages. The system message is automatically added.
+
+`ct` [CancellationToken](https://docs.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken)<br>
+Optional cancellation token.
+
+#### Returns
+
+[IAsyncEnumerable&lt;ChatCompletionCreateResponse&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.iasyncenumerable-1)<br>
+Async enumerable of chat completion responses.
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.parameter.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.parameter.md
new file mode 100644
index 00000000..24a092c9
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.parameter.md
@@ -0,0 +1,107 @@
+# Parameter
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class Parameter : System.IEquatable`1[[Microsoft.AI.Foundry.Local.Parameter, Microsoft.AI.Foundry.Local, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [Parameter](./microsoft.ai.foundry.local.parameter.md)<br>
+Implements [IEquatable&lt;Parameter&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.iequatable-1)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute), [RequiredMemberAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.requiredmemberattribute)
+
+## Properties
+
+### **Name**
+
+```csharp
+public string Name { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Value**
+
+```csharp
+public string Value { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+## Constructors
+
+### **Parameter()**
+
+#### Caution
+
+Constructors of types with required members are not supported in this version of your compiler.
+
+---
+
+```csharp
+public Parameter()
+```
+
+## Methods
+
+### **ToString()**
+
+```csharp
+public string ToString()
+```
+
+#### Returns
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **GetHashCode()**
+
+```csharp
+public int GetHashCode()
+```
+
+#### Returns
+
+[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)<br>
+
+### **Equals(Object)**
+
+```csharp
+public bool Equals(object obj)
+```
+
+#### Parameters
+
+`obj` [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **Equals(Parameter)**
+
+```csharp
+public bool Equals(Parameter other)
+```
+
+#### Parameters
+
+`other` [Parameter](./microsoft.ai.foundry.local.parameter.md)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **&lt;Clone&gt;$()**
+
+```csharp
+public Parameter <Clone>$()
+```
+
+#### Returns
+
+[Parameter](./microsoft.ai.foundry.local.parameter.md)<br>
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.prompttemplate.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.prompttemplate.md
new file mode 100644
index 00000000..432f74db
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.prompttemplate.md
@@ -0,0 +1,121 @@
+# PromptTemplate
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class PromptTemplate : System.IEquatable`1[[Microsoft.AI.Foundry.Local.PromptTemplate, Microsoft.AI.Foundry.Local, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [PromptTemplate](./microsoft.ai.foundry.local.prompttemplate.md)<br>
+Implements [IEquatable&lt;PromptTemplate&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.iequatable-1)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **System**
+
+```csharp
+public string System { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **User**
+
+```csharp
+public string User { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Assistant**
+
+```csharp
+public string Assistant { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **Prompt**
+
+```csharp
+public string Prompt { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+## Constructors
+
+### **PromptTemplate()**
+
+```csharp
+public PromptTemplate()
+```
+
+## Methods
+
+### **ToString()**
+
+```csharp
+public string ToString()
+```
+
+#### Returns
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **GetHashCode()**
+
+```csharp
+public int GetHashCode()
+```
+
+#### Returns
+
+[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)<br>
+
+### **Equals(Object)**
+
+```csharp
+public bool Equals(object obj)
+```
+
+#### Parameters
+
+`obj` [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **Equals(PromptTemplate)**
+
+```csharp
+public bool Equals(PromptTemplate other)
+```
+
+#### Parameters
+
+`other` [PromptTemplate](./microsoft.ai.foundry.local.prompttemplate.md)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **&lt;Clone&gt;$()**
+
+```csharp
+public PromptTemplate <Clone>$()
+```
+
+#### Returns
+
+[PromptTemplate](./microsoft.ai.foundry.local.prompttemplate.md)<br>
diff --git a/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.runtime.md b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.runtime.md
new file mode 100644
index 00000000..3d0d9fd5
--- /dev/null
+++ b/sdk_v2/cs/docs/api/microsoft.ai.foundry.local.runtime.md
@@ -0,0 +1,101 @@
+# Runtime
+
+Namespace: Microsoft.AI.Foundry.Local
+
+```csharp
+public class Runtime : System.IEquatable`1[[Microsoft.AI.Foundry.Local.Runtime, Microsoft.AI.Foundry.Local, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
+```
+
+Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [Runtime](./microsoft.ai.foundry.local.runtime.md)<br>
+Implements [IEquatable&lt;Runtime&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.iequatable-1)<br>
+Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullablecontextattribute), [NullableAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.nullableattribute)
+
+## Properties
+
+### **DeviceType**
+
+```csharp
+public DeviceType DeviceType { get; set; }
+```
+
+#### Property Value
+
+[DeviceType](./microsoft.ai.foundry.local.devicetype.md)<br>
+
+### **ExecutionProvider**
+
+```csharp
+public string ExecutionProvider { get; set; }
+```
+
+#### Property Value
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+## Constructors
+
+### **Runtime()**
+
+```csharp
+public Runtime()
+```
+
+## Methods
+
+### **ToString()**
+
+```csharp
+public string ToString()
+```
+
+#### Returns
+
+[String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
+
+### **GetHashCode()**
+
+```csharp
+public int GetHashCode()
+```
+
+#### Returns
+
+[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)<br>
+
+### **Equals(Object)**
+
+```csharp
+public bool Equals(object obj)
+```
+
+#### Parameters
+
+`obj` [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **Equals(Runtime)**
+
+```csharp
+public bool Equals(Runtime other)
+```
+
+#### Parameters
+
+`other` [Runtime](./microsoft.ai.foundry.local.runtime.md)<br>
+
+#### Returns
+
+[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+### **&lt;Clone&gt;$()**
+
+```csharp
+public Runtime <Clone>$()
+```
+
+#### Returns
+
+[Runtime](./microsoft.ai.foundry.local.runtime.md)<br>
diff --git a/sdk_v2/cs/src/FoundryLocalManager.cs b/sdk_v2/cs/src/FoundryLocalManager.cs
index ce3712cd..639be3a2 100644
--- a/sdk_v2/cs/src/FoundryLocalManager.cs
+++ b/sdk_v2/cs/src/FoundryLocalManager.cs
@@ -94,7 +94,7 @@ public static async Task CreateAsync(Configuration configuration, ILogger logger
     /// <summary>
     /// Get the model catalog instance.
     /// </summary>
-    /// <param name="ct">Optional canellation token.</param>
+    /// <param name="ct">Optional cancellation token.</param>
     /// <returns>The model catalog.</returns>
     /// <remarks>
     /// The catalog is populated on first use.
diff --git a/sdk_v2/cs/src/ICatalog.cs b/sdk_v2/cs/src/ICatalog.cs
index 12347940..35285736 100644
--- a/sdk_v2/cs/src/ICatalog.cs
+++ b/sdk_v2/cs/src/ICatalog.cs
@@ -26,7 +26,7 @@ public interface ICatalog
     /// </summary>
     /// <param name="modelAlias">Model alias.</param>
     /// <param name="ct">Optional CancellationToken.</param>
-    /// <returns>Model if found.</returns>
+    /// <returns>The matching Model, or null if no model with the given alias exists.</returns>
     Task<Model?> GetModelAsync(string modelAlias, CancellationToken? ct = null);
 
     /// <summary>
@@ -34,7 +34,7 @@ public interface ICatalog
     /// </summary>
     /// <param name="modelId">Model id.</param>
     /// <param name="ct">Optional CancellationToken.</param>
-    /// <returns>Model variant if found.</returns>
+    /// <returns>The matching ModelVariant, or null if no variant with the given id exists.</returns>
     Task<ModelVariant?> GetModelVariantAsync(string modelId, CancellationToken? ct = null);
 
     /// <summary>
diff --git a/sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj b/sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj
index 6ee998f9..ef0ea35d 100644
--- a/sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj
+++ b/sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj
@@ -26,6 +26,7 @@
 
       <IncludeSymbols>true</IncludeSymbols>
       <SymbolPackageFormat>snupkg</SymbolPackageFormat>
+      <GenerateDocumentationFile Condition="'$(Configuration)' == 'Release'">true</GenerateDocumentationFile>
 
       <!-- 
       Set to 'true' to use OnnxRuntimeGenAI.WinML with EP download on Windows
diff --git a/sdk_v2/cs/src/Model.cs b/sdk_v2/cs/src/Model.cs
index 83bcef69..bbbbcb5b 100644
--- a/sdk_v2/cs/src/Model.cs
+++ b/sdk_v2/cs/src/Model.cs
@@ -58,10 +58,9 @@ internal void AddVariant(ModelVariant variant)
     }
 
     /// <summary>
-    /// Select a specific model variant by its unique model ID.
-    /// The selected variant will be used for <see cref="IModel"/> operations.
+    /// Select a specific model variant from <see cref="Variants"/> to use for <see cref="IModel"/> operations.
     /// </summary>
-    /// <param name="modelId">Model Id of the variant to select.</param>
+    /// <param name="variant">Model variant to select. Must be one of the variants in <see cref="Variants"/>.</param>
     /// <exception cref="FoundryLocalException">If variant is not valid for this model.</exception>
     public void SelectVariant(ModelVariant variant)
     {
diff --git a/sdk_v2/cs/src/OpenAI/AudioClient.cs b/sdk_v2/cs/src/OpenAI/AudioClient.cs
index 245fbdf5..11579d2f 100644
--- a/sdk_v2/cs/src/OpenAI/AudioClient.cs
+++ b/sdk_v2/cs/src/OpenAI/AudioClient.cs
@@ -42,7 +42,7 @@ public record AudioSettings
     }
 
     /// <summary>
-    /// Settings to use for chat completions using this client.
+    /// Settings to use for audio transcription using this client.
     /// </summary>
     public AudioSettings Settings { get; } = new();
 
@@ -129,7 +129,7 @@ private async IAsyncEnumerable<AudioCreateTranscriptionResponse> TranscribeAudio
                             AllowSynchronousContinuations = true
                         });
 
-        // The callback will push ChatResponse objects into the channel.
+        // The callback will push AudioCreateTranscriptionResponse objects into the channel.
         // The channel reader will return the values to the user.
         // This setup prevents the user from blocking the thread generating the responses.
         _ = Task.Run(async () =>
@@ -170,7 +170,7 @@ await _coreInterop.ExecuteCommandWithCallbackAsync(
             catch (Exception ex) when (ex is not OperationCanceledException)
             {
                 channel.Writer.TryComplete(
-                    new FoundryLocalException("Error executing streaming chat completion.", ex, _logger));
+                    new FoundryLocalException("Error executing streaming audio transcription.", ex, _logger));
             }
             catch (OperationCanceledException)
             {