diff --git a/tools/ui/src/lib/services/index.ts b/tools/ui/src/lib/services/index.ts
index 960109c036..be6261bd62 100644
--- a/tools/ui/src/lib/services/index.ts
+++ b/tools/ui/src/lib/services/index.ts
@@ -136,7 +136,7 @@ export { ConversationTransferService } from './conversation-transfer.service';
  *
  * **Server Mode Behavior:**
  * - **MODEL mode**: Only `list()` is relevant — single model always loaded
- * - **ROUTER mode**: Full lifecycle — `list()`, `load()`, `unload()`
+ * - **ROUTER mode**: Full lifecycle - `list()`, `load()`, `unload()`
  *
  * **Endpoints:**
  * - `GET /v1/models` — OpenAI-compatible model list (both modes)
diff --git a/tools/ui/src/lib/types/api.d.ts b/tools/ui/src/lib/types/api.d.ts
index e1c3d4876a..5191b03bd8 100644
--- a/tools/ui/src/lib/types/api.d.ts
+++ b/tools/ui/src/lib/types/api.d.ts
@@ -456,6 +456,11 @@ export interface ApiModelsLoadResponse {
 export interface ApiModelsListResponse {
 	object: string;
 	data: ApiModelDataEntry[];
+	/**
+	 * Optional details aligned by index with `data`: `models[i]` describes
+	 * `data[i]`. The server fills both arrays in one pass, so the pairing only
+	 * holds while neither array is filtered independently.
+	 */
 	models?: ApiModelDetails[];
 }