packages/host/README.md

# host/ — web-GUI host half

English | [中文](README.zh.md)

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/`](../client/README.md); the composed application is [`apps/cli`](../../apps/cli/config/base.cordis.yml) serving [`apps/web`](../../apps/web/). All **product** packages.

| Package | Role | ctx key |
|---|---|---|
| [`apiproxy/`](apiproxy/README.md) | Shared host API gateway and wire contract | `ctx.apiProxy` |
| [`webserver/`](webserver/README.md) | HTTP route carrier | `ctx.httpServer` |
| [`directory-picker/`](directory-picker/README.md) | Workspace-directory picking seam | `ctx.directoryPicker` |
| [`directory-picker-native/`](directory-picker-native/README.md) | Native directory-picker backend and browser interaction | registers `ctx.directoryPicker` |
| [`directory-picker-browse/`](directory-picker-browse/README.md) | In-app directory-browser backend and interaction | registers `ctx.directoryPicker` |
| [`directory-picker-auto/`](directory-picker-auto/README.md) | Host-adaptive picker composition | mounts a backend |

`apiproxy` remains transport-independent; [`client/connection`](../client/connection/README.md) supplies the browser/HTTP carrier. Picker implementations replace one another behind the shared seam.
doc(packages): add the host/ and client/ group READMEs and table rows 2026-07-28 15:04:59 +08:00			`# host/ — web-GUI host half`

			`English \| [中文](README.zh.md)`

docs: repair links to consolidated CLI 2026-07-30 10:45:08 +08:00			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/`](../client/README.md); the composed application is [`apps/cli`](../../apps/cli/config/base.cordis.yml) serving [`apps/web`](../../apps/web/). All product packages.
doc(packages): add the host/ and client/ group READMEs and table rows 2026-07-28 15:04:59 +08:00
			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [`apiproxy/`](apiproxy/README.md) \| Shared host API gateway and wire contract \| `ctx.apiProxy` \|
			\| [`webserver/`](webserver/README.md) \| HTTP route carrier \| `ctx.httpServer` \|
			\| [`directory-picker/`](directory-picker/README.md) \| Workspace-directory picking seam \| `ctx.directoryPicker` \|
			\| [`directory-picker-native/`](directory-picker-native/README.md) \| Native directory-picker backend and browser interaction \| registers `ctx.directoryPicker` \|
			\| [`directory-picker-browse/`](directory-picker-browse/README.md) \| In-app directory-browser backend and interaction \| registers `ctx.directoryPicker` \|
			\| [`directory-picker-auto/`](directory-picker-auto/README.md) \| Host-adaptive picker composition \| mounts a backend \|
doc(packages): add the host/ and client/ group READMEs and table rows 2026-07-28 15:04:59 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`apiproxy` remains transport-independent; [`client/connection`](../client/connection/README.md) supplies the browser/HTTP carrier. Picker implementations replace one another behind the shared seam.