deepseek-harness/packages/host
Turtle d68ff7e66f Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants
# Conflicts:
#	docs/module-graph.i18n.yaml
#	docs/module-graph.md
#	docs/module-graph.zh.md
#	packages/session/session-projection/src/invariant.ts
#	tsconfig.base.json
2026-09-01 11:18:11 +08:00
..
directory-picker Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants 2026-09-01 11:18:11 +08:00
directory-picker-auto Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants 2026-09-01 11:18:11 +08:00
directory-picker-browse Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants 2026-09-01 11:18:11 +08:00
directory-picker-native Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants 2026-09-01 11:18:11 +08:00
frontend-static Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants 2026-09-01 11:18:11 +08:00
plugin-inventory Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants 2026-09-01 11:18:11 +08:00
webserver Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants 2026-09-01 11:18:11 +08:00
README.i18n.yaml docs(api): describe Connection-owned transport 2026-08-27 22:26:30 +08:00
README.md docs(api): describe Connection-owned transport 2026-08-27 22:26:30 +08:00
README.zh.md docs(api): describe Connection-owned transport 2026-08-27 22:26:30 +08:00

description kind
Package map for the web GUI host half: the HTTP and SPA servers, workspace-directory picking implementations, and the plugin inventory projection. package-group

host/ — web-GUI host half

English | 中文

Summary

The host/ group provides the web GUI's plain HTTP server, the SPA dist server that serves the built Web shell, the workspace-directory picking seam with its native, browse, and adaptive composition packages, and the read-only plugin inventory projection. All seven packages are product packages; the browser transport lives in client/, and the composed application is apps/cli booting the dsh-base bundle that serves the web app under apps/web/. The picker backends replace one another behind the shared seam.

Table of Contents


Packages

Seven packages play the host roles; each package README owns its contract and configuration.

Package Role ctx key
webserver/ Browser HTTP server: named routes, upgrades, index taps, and the fallback seat ctx.webServer
frontend-static/ SPA dist server on the webserver fallback seat consumes ctx.webServer
directory-picker/ Workspace-directory picking seam: capability contract and error vocabulary ctx.directoryPicker
directory-picker-native/ Native-OS-chooser backend for operators at the host display registers ctx.directoryPicker
directory-picker-browse/ In-app directory-browser backend, including for remote clients registers ctx.directoryPicker
directory-picker-auto/ Host-adaptive chooser that mounts the matching backend at boot mounts a backend
plugin-inventory/ Read-only projection of current Loader entries Remote pluginInventory/list

Start with the subsystem references for the transport and the workspace records, then the layering decision behind the Web client.

Dev Note

Working context for maintainers — click to expand

None.