Refactored and documented the HTTP API

server/src/http/model.rs

@@ -1,10 +1,15 @@
 use crate::http::context::{AppContext, OpenApiResult, bad_request};
 use crate::io::fs;
 use crate::llm::chat;
-use poem_openapi::{Object, OpenApi, param::Query, payload::Json};
+use poem_openapi::{Object, OpenApi, Tags, param::Query, payload::Json};
 use serde::Deserialize;
 use std::sync::Arc;
 
+#[derive(Tags)]
+enum ModelTags {
+    Model,
+}
+
 #[derive(Deserialize, Object)]
 struct ModelPayload {
     model: String,
@@ -14,20 +19,24 @@ pub struct ModelApi {
     pub ctx: Arc<AppContext>,
 }
 
-#[OpenApi]
+#[OpenApi(tag = "ModelTags::Model")]
 impl ModelApi {
+    /// Get the currently selected model preference, if any.
     #[oai(path = "/model", method = "get")]
     async fn get_model_preference(&self) -> OpenApiResult<Json<Option<String>>> {
         let result = fs::get_model_preference(self.ctx.store.as_ref()).map_err(bad_request)?;
         Ok(Json(result))
     }
 
+    /// Persist the selected model preference.
     #[oai(path = "/model", method = "post")]
     async fn set_model_preference(&self, payload: Json<ModelPayload>) -> OpenApiResult<Json<bool>> {
         fs::set_model_preference(payload.0.model, self.ctx.store.as_ref()).map_err(bad_request)?;
         Ok(Json(true))
     }
 
+    /// Fetch available model names from an Ollama server.
+    /// Optionally override the base URL via query string.
     #[oai(path = "/ollama/models", method = "get")]
     async fn get_ollama_models(
         &self,