Relationships
#4914 The dashboard switcher lists a serve host's workspaces, read from workspace.list on the root
Opened by zack · 11/19/2026
Issue 18 of the execution plan in design/surfaces/serve-workspaces.md. One PR. Depends on swamp-club#4849 (workspace requests on the root), shipped, and swamp-club#4913 (dashboard sign-in under a workspace segment).
Problem
The dashboard's workspace switcher reads the local hub's list at /api/local/workspaces (packages/dashboard/src/client/workspace_list.ts). A serve host has no hub, so under a host the switcher has nothing to show. A person moves between a host's workspaces by editing the address.
Change
Under a host, the switcher lists what workspace.list on the root returns. The design section is Dashboard.
- The list. Each workspace's name and state, from the root. The root itself is an entry, and choosing it opens
/dashboard/. - Switching opens
/dashboard/w/<name>/, as the local dashboard's switcher does. The page reloads, and the workspace asks for its own sign-in if the browser has no session there. - State. A workspace that is stopped, starting or failed is listed and marked as such. Choosing it opens its page, which says the same.
- The current workspace is always shown, whether or not the list could be read.
- The local dashboard is unchanged. It still reads the hub's list.
workspace.list needs an authenticated principal on the root, so the switcher can read it only in a browser that is signed in to the root.
Decisions this issue makes
The PR states what it chose and updates the design doc.
- A browser signed in to a workspace and not to the root. The expected answer is that the switcher shows the current workspace and a link to sign in to the root, and makes no request the root would refuse.
- How the page reaches
workspace.list. A second connection to the root with the root's session, or another way. A workspace page's own connection goes to the workspace. - How often the list is read. States change as workspaces are resumed and suspended.
Done when
- Under a host, a browser signed in to the root sees every workspace
workspace.listreturns, each with its state, and the root. - Choosing a workspace opens its dashboard, and choosing the root opens the root's.
- A browser not signed in to the root sees the current workspace and the link, and the root's audit log shows no refused
workspace.listfrom it. - A workspace created or resumed while the page is open appears, or changes state, at the next read the PR chose.
- The local dashboard's switcher lists the hub's workspaces as before.
- The dashboard package's tests cover the host list, the local list and the not-signed-in case.
Out of scope
- Creating, suspending or resuming a workspace from the dashboard.
- Marking registered workspaces. swamp-club#4865 adds that to
workspace.list. - Signing in to several workspaces at once.
Open
No activity in this phase yet.
Sign in to post a ripple.