From 956793aeacc0ef130d0c17ee84f1b6e57cdb129b Mon Sep 17 00:00:00 2001 From: Teknium <127238744+teknium1@users.noreply.github.com> Date: Fri, 11 Sep 2026 07:24:40 -0700 Subject: [PATCH] docs(multi-profile): profile sessions keep their own keys and store on every gateway path --- website/docs/user-guide/multi-profile-gateways.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/website/docs/user-guide/multi-profile-gateways.md b/website/docs/user-guide/multi-profile-gateways.md index 979a4ed99d..3bba3c2825 100644 --- a/website/docs/user-guide/multi-profile-gateways.md +++ b/website/docs/user-guide/multi-profile-gateways.md @@ -208,7 +208,18 @@ Each profile's sessions live under an `agent::…` namespace so two profiles on the same platform/chat never collide in the shared session store. The **default** profile keeps the historical `agent:main:…` namespace byte-for-byte, so existing default-profile sessions are unaffected — no -migration, no orphaned history. +migration, no orphaned history. Every gateway path that reads a key back — +delegation completions after a restart, shutdown notices, a per-user-thread +`/stop` of a sibling's run, `/undo`, QQ approval buttons — accepts the +`agent::…` shape too, so secondary profiles get the same behaviour +as the default one. + +Each profile's rows land in **its own** `state.db`: a named profile's under +`profiles//state.db`, the default profile's under the launch home — even +when the write happens inside another profile's routed turn or background tick. +The Desktop/TUI backend's own store is likewise pinned to the home it launched +under, and a Bot Chat's side agents (`prompt.background`) persist next to their +parent conversation. #### 5. One PID/lock and one status surface