Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

docs(desktop-app): clarify active endpoint match precedence

Josuéaf6aa35a14c1
diff --git a/docs/how-to/desktop-setup-and-updates.md b/docs/how-to/desktop-setup-and-updates.md
index f8e5a306b..a6e195aff 100644
--- a/docs/how-to/desktop-setup-and-updates.md
+++ b/docs/how-to/desktop-setup-and-updates.md
@@ -60,7 +60,8 @@ saved environment with the exact External REST API URL. If the current session
uses another REST URL, Desktop signs out before switching. If no exact match is
saved, Desktop asks before adding the environment; after confirmation, the
External REST API supplies the RPC proxy URL. Multiple saved exact matches are
-rejected for manual resolution.
+rejected for manual resolution, unless the already-active environment itself
+matches the requested REST endpoint; that exact active environment is retained.
The handoff is disabled by default. A release operator can enable it by setting
the `PROFILE_DESKTOP_HANDOFF_ENABLED` repository variable to `true` when
diff --git a/docs/surfaces/desktop-app.md b/docs/surfaces/desktop-app.md
index 1f96e0a30..1d0636a70 100644
--- a/docs/surfaces/desktop-app.md
+++ b/docs/surfaces/desktop-app.md
@@ -200,8 +200,9 @@ service, a teammate's, or local `make`-forwarded services — from the app's own
proxy address follows from that environment; there is no second URL to enter.
When Profile-to-Desktop handoff is enabled, Profile UI's
`evenfire://desktop-environment` link selects one exact saved REST URL or asks
-the user before adding it; the REST API supplies the RPC proxy URL. This
-producer is disabled by default. Release operators enable the
+the user before adding it; an already-active exact REST endpoint is retained
+before duplicate saved matches are rejected. The REST API supplies the RPC
+proxy URL. This producer is disabled by default. Release operators enable the
`PROFILE_DESKTOP_HANDOFF_ENABLED` image-build variable only after releasing the
updated Desktop client and retiring older supported clients. While the gate is
off, users can copy the REST URL from Profile UI Settings and add it in Desktop.