From da7045e2d576133d988efca9d8a102ff99aea4f3 Mon Sep 17 00:00:00 2001 From: kenny lopez Date: Wed, 29 Jul 2026 19:32:57 +0100 Subject: [PATCH] docs(desktop): document model display labels Signed-off-by: kenny lopez --- desktop/src/features/agents/AGENTS.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/desktop/src/features/agents/AGENTS.md b/desktop/src/features/agents/AGENTS.md index 35ad4a63a..c69034746 100644 --- a/desktop/src/features/agents/AGENTS.md +++ b/desktop/src/features/agents/AGENTS.md @@ -114,6 +114,11 @@ with a TypeScript lookup table or an id comparison in a component. published or removed. A queued update must stay visibly queued, and the catalog itself must render only relay-confirmed publications — never an optimistic local persona. +11. **Model IDs are runtime values; model labels are presentation.** Preserve + the exact discovered or configured ID when selecting and persisting a + model. Any user-facing Databricks gateway model name must go through + `lib/formatAgentModelLabel.ts` so its `databricks-` endpoint prefix is + removed consistently without changing the value sent to the runtime. ## The tests that enforce this