Rust SDK: Add info() to Model, get_latest_version to Catalog, update docs

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/rust/README.md

@@ -127,7 +127,7 @@ let loaded = catalog.get_loaded_models().await?;
 
 ### Model Lifecycle
 
-Each `Model` wraps one or more `ModelVariant` entries (different quantizations, hardware targets). The SDK auto-selects the best available variant, preferring cached versions.
+Each `Model` wraps one or more variant entries (different quantizations, hardware targets). The SDK auto-selects the best available variant, preferring cached versions.
 
 ```rust
 let model = catalog.get_model("phi-3.5-mini").await?;

sdk/rust/docs/api.md

@@ -134,6 +134,7 @@ pub struct Catalog { /* private fields */ }
 | `get_model_variant` | `async fn get_model_variant(&self, id: &str) -> Result<Arc<ModelVariant>, FoundryLocalError>` | Look up a variant by unique id. |
 | `get_cached_models` | `async fn get_cached_models(&self) -> Result<Vec<Arc<ModelVariant>>, FoundryLocalError>` | Return only variants cached on disk. |
 | `get_loaded_models` | `async fn get_loaded_models(&self) -> Result<Vec<Arc<ModelVariant>>, FoundryLocalError>` | Return model variants currently loaded in memory. |
+| `get_latest_version` | `async fn get_latest_version(&self, model: &Arc<Model>) -> Result<Arc<ModelVariant>, FoundryLocalError>` | Get the latest version of a model variant. Returns the latest variant matching the selected variant's name. |
 
 ---
 
@@ -149,6 +150,7 @@ pub struct Model { /* private fields */ }
 |--------|-----------|-------------|
 | `alias` | `fn alias(&self) -> &str` | Alias shared by all variants. |
 | `id` | `fn id(&self) -> &str` | Unique identifier of the selected variant. |
+| `info` | `fn info(&self) -> &ModelInfo` | Full metadata for the selected variant. |
 | `variants` | `fn variants(&self) -> &[Arc<ModelVariant>]` | All variants in this model. |
 | `selected_variant` | `fn selected_variant(&self) -> &ModelVariant` | Currently selected variant. |
 | `select_variant` | `fn select_variant(&self, id: &str) -> Result<(), FoundryLocalError>` | Select a variant by id. |

sdk/rust/src/catalog.rs

@@ -188,6 +188,45 @@ impl Catalog {
             .collect())
     }
 
+    /// 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.
+    ///
+    /// Returns the same `Arc<Model>` if the model already references the latest
+    /// version.
+    pub async fn get_latest_version(&self, model: &Arc<Model>) -> Result<Arc<ModelVariant>> {
+        self.update_models().await?;
+
+        let s = self.lock_state()?;
+        let catalog_model = s.models_by_alias.get(model.alias()).ok_or_else(|| {
+            FoundryLocalError::ModelOperation {
+                reason: format!(
+                    "Model with alias '{}' not found in catalog.",
+                    model.alias()
+                ),
+            }
+        })?;
+
+        let current_name = &model.selected_variant().info().name;
+
+        // variants are sorted by version, so the first one matching the name
+        // is the latest version for that variant.
+        let latest = catalog_model
+            .variants()
+            .iter()
+            .find(|v| &v.info().name == current_name)
+            .ok_or_else(|| FoundryLocalError::ModelOperation {
+                reason: format!(
+                    "Internal error. Mismatch between model (alias:{}) and variant (name:{}).",
+                    model.alias(),
+                    current_name
+                ),
+            })?;
+
+        Ok(Arc::clone(latest))
+    }
+
     async fn force_refresh(&self) -> Result<()> {
         let raw = self
             .core

sdk/rust/src/model.rs

@@ -11,6 +11,7 @@ use crate::error::{FoundryLocalError, Result};
 use crate::model_variant::ModelVariant;
 use crate::openai::AudioClient;
 use crate::openai::ChatClient;
+use crate::types::ModelInfo;
 
 /// A model groups one or more [`ModelVariant`]s that share the same alias.
 ///
@@ -102,6 +103,11 @@ impl Model {
         &self.alias
     }
 
+    /// The full [`ModelInfo`] metadata of the selected variant.
+    pub fn info(&self) -> &ModelInfo {
+        self.selected_variant().info()
+    }
+
     /// Unique identifier of the selected variant.
     pub fn id(&self) -> &str {
         self.selected_variant().id()