host/

August 12, 2026 · View on GitHub

English | 中文

The host side of the dsh web GUI: the API gateway every client shape shares, and the plain HTTP server it rides on. The browser side lives in client/; the composed application is apps/cli booting the dsh-base bundle serving apps/web. All product packages.

PackageRolectx key
apiproxy/Shared host API gateway and wire contractctx.apiProxy
webserver/HTTP route carrierctx.webServer
frontend-static/SPA dist server on the webserver fallback seatconsumes ctx.webServer
directory-picker/Workspace-directory picking seamctx.directoryPicker
directory-picker-native/Native directory-picker backend and browser interactionregisters ctx.directoryPicker
directory-picker-browse/In-app directory-browser backend and interactionregisters ctx.directoryPicker
directory-picker-auto/Host-adaptive picker compositionmounts a backend
plugin-inventory/Read-only projection of current Loader entriesRemote pluginInventory/list

apiproxy remains transport-independent; client/connection supplies the browser/HTTP carrier. Picker implementations replace one another behind the shared seam.

The subsystem references: web-server.md and workspace.md (the picker seam).