Update C# API docs to reflect IModel changes: ICatalog returns IModel, Model uses IModel variants

Agent-Logs-Url: https://github.com/microsoft/Foundry-Local/sessions/8082508c-1338-48b2-bdd3-6c2c8e35e195

Co-authored-by: baijumeswani <12852605+baijumeswani@users.noreply.github.com>

Author: Copilot

sdk/cs/docs/api/microsoft.ai.foundry.local.icatalog.md

@@ -29,7 +29,7 @@ public abstract string Name { get; }
 List the available models in the catalog.
 
 ```csharp
-Task<List<Model>> ListModelsAsync(Nullable<CancellationToken> ct)
+Task<List<IModel>> ListModelsAsync(Nullable<CancellationToken> ct)
 ```
 
 #### Parameters
@@ -39,15 +39,15 @@ 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.
+[Task&lt;List&lt;IModel&gt;&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+List of IModel instances.
 
 ### **GetModelAsync(String, Nullable&lt;CancellationToken&gt;)**
 
 Lookup a model by its alias.
 
 ```csharp
-Task<Model> GetModelAsync(string modelAlias, Nullable<CancellationToken> ct)
+Task<IModel> GetModelAsync(string modelAlias, Nullable<CancellationToken> ct)
 ```
 
 #### Parameters
@@ -60,15 +60,15 @@ 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.
+[Task&lt;IModel&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+The matching IModel, 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)
+Task<IModel> GetModelVariantAsync(string modelId, Nullable<CancellationToken> ct)
 ```
 
 #### Parameters
@@ -81,15 +81,15 @@ 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.
+[Task&lt;IModel&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+The matching IModel, 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)
+Task<List<IModel>> GetCachedModelsAsync(Nullable<CancellationToken> ct)
 ```
 
 #### Parameters
@@ -99,15 +99,15 @@ 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.
+[Task&lt;List&lt;IModel&gt;&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+List of IModel instances.
 
 ### **GetLoadedModelsAsync(Nullable&lt;CancellationToken&gt;)**
 
 Get a list of the currently loaded models.
 
 ```csharp
-Task<List<ModelVariant>> GetLoadedModelsAsync(Nullable<CancellationToken> ct)
+Task<List<IModel>> GetLoadedModelsAsync(Nullable<CancellationToken> ct)
 ```
 
 #### Parameters
@@ -117,5 +117,27 @@ 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.
+[Task&lt;List&lt;IModel&gt;&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+List of IModel instances.
+
+### **GetLatestVersionAsync(IModel, Nullable&lt;CancellationToken&gt;)**
+
+Get the latest version of a model.
+This is used to check if a newer version of a model is available in the catalog for download.
+
+```csharp
+Task<IModel> GetLatestVersionAsync(IModel model, Nullable<CancellationToken> ct)
+```
+
+#### Parameters
+
+`model` [IModel](./microsoft.ai.foundry.local.imodel.md)<br>
+The model to check for the latest version.
+
+`ct` [Nullable&lt;CancellationToken&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.nullable-1)<br>
+Optional CancellationToken.
+
+#### Returns
+
+[Task&lt;IModel&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
+The latest version of the model. Will match the input if it is the latest version.

sdk/cs/docs/api/microsoft.ai.foundry.local.imodel.md

@@ -30,6 +30,42 @@ public abstract string Alias { get; }
 
 [String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
 
+### **Info**
+
+Full catalog metadata for this model or variant.
+
+```csharp
+public abstract ModelInfo Info { get; }
+```
+
+#### Property Value
+
+[ModelInfo](./microsoft.ai.foundry.local.modelinfo.md)<br>
+
+### **Variants**
+
+Variants of the model that are available. Variants are optimized for different devices.
+
+```csharp
+public abstract IReadOnlyList<IModel> Variants { get; }
+```
+
+#### Property Value
+
+[IReadOnlyList&lt;IModel&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlylist-1)<br>
+
+### **SelectedVariant**
+
+Currently selected model variant in use.
+
+```csharp
+public abstract IModel SelectedVariant { get; }
+```
+
+#### Property Value
+
+[IModel](./microsoft.ai.foundry.local.imodel.md)<br>
+
 ## Methods
 
 ### **IsCachedAsync(Nullable&lt;CancellationToken&gt;)**
@@ -185,3 +221,16 @@ Optional cancellation token.
 
 [Task&lt;OpenAIAudioClient&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
 OpenAI.AudioClient
+
+### **SelectVariant(IModel)**
+
+Select a specific model variant from Variants to use for IModel operations.
+
+```csharp
+void SelectVariant(IModel variant)
+```
+
+#### Parameters
+
+`variant` [IModel](./microsoft.ai.foundry.local.imodel.md)<br>
+Model variant to select. Must be one of the variants in Variants.

sdk/cs/docs/api/microsoft.ai.foundry.local.model.md

@@ -15,22 +15,22 @@ Attributes [NullableContextAttribute](https://docs.microsoft.com/en-us/dotnet/ap
 ### **Variants**
 
 ```csharp
-public List<ModelVariant> Variants { get; internal set; }
+public IReadOnlyList<IModel> Variants { get; }
 ```
 
 #### Property Value
 
-[List&lt;ModelVariant&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.list-1)<br>
+[IReadOnlyList&lt;IModel&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlylist-1)<br>
 
 ### **SelectedVariant**
 
 ```csharp
-public ModelVariant SelectedVariant { get; internal set; }
+public IModel SelectedVariant { get; internal set; }
 ```
 
 #### Property Value
 
-[ModelVariant](./microsoft.ai.foundry.local.modelvariant.md)<br>
+[IModel](./microsoft.ai.foundry.local.imodel.md)<br>
 
 ### **Alias**
 
@@ -86,47 +86,24 @@ public Task<bool> IsLoadedAsync(Nullable<CancellationToken> ct)
 
 [Task&lt;Boolean&gt;](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1)<br>
 
-### **SelectVariant(ModelVariant)**
+### **SelectVariant(IModel)**
 
 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)
+public void SelectVariant(IModel variant)
 ```
 
 #### Parameters
 
-`variant` [ModelVariant](./microsoft.ai.foundry.local.modelvariant.md)<br>
+`variant` [IModel](./microsoft.ai.foundry.local.imodel.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

sdk/cs/docs/api/microsoft.ai.foundry.local.modelvariant.md

@@ -2,8 +2,10 @@
 
 Namespace: Microsoft.AI.Foundry.Local
 
+> **Note:** `ModelVariant` is an internal implementation detail. Use [`IModel`](./microsoft.ai.foundry.local.imodel.md) in public API code.
+
 ```csharp
-public class ModelVariant : IModel
+internal class ModelVariant : IModel
 ```
 
 Inheritance [Object](https://docs.microsoft.com/en-us/dotnet/api/system.object) → [ModelVariant](./microsoft.ai.foundry.local.modelvariant.md)<br>