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/` | The shared API gateway: the zero-Node TS wire contract (`src/api/`), the fetch carrier pair (`toFetchHandler` host-side, `AbstractApiClient` client-side), and the host implementation over `ctx.agents`/`ctx.workspace` | `ctx.apiProxy` |
| `webserver/` | Plain HTTP route-registration carrier: `node:http` server listening on activation; routes register as named `exact`/`prefix` handlers | `ctx.httpServer` |
| `directory-picker/` | Workspace-directory picking seam: discriminated `native`/`browse` capability the gateway's picker RPCs delegate to | `ctx.directoryPicker` |
| `directory-picker-native/` | Dual-face native interaction: OS-chooser backend (osascript / PowerShell / Zenity+KDialog, host-display only) + the browser half filling ui-workspace's directory-flow slots | (registers `ctx.directoryPicker`) |
| `directory-picker-browse/` | Dual-face browse interaction: listing/creation primitives over Node stdlib (remote-capable) + the browser half rendering the in-app Select Workspace Directory dialog | (registers `ctx.directoryPicker`) |
| `directory-picker-auto/` | Adaptive chooser: resolves the host's situation once at boot (bind host, SSH, display) and mounts the matching dual-face backend as an in-memory Loader entry | (mounts a backend row) |

`apiproxy` is transport-agnostic by design — it registers no routes; carriers wrap `ctx.apiProxy` themselves. The HTTP carrier route (with its `/api` browser-trust fence) is mounted by [`client/connection`](../client/connection/README.md)'s node half, which is why that package lives in the client group: it owns both ends of the wire.
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 \|`
			`\|---\|---\|---\|`
			\| `apiproxy/` \| The shared API gateway: the zero-Node TS wire contract (`src/api/`), the fetch carrier pair (`toFetchHandler` host-side, `AbstractApiClient` client-side), and the host implementation over `ctx.agents`/`ctx.workspace` \| `ctx.apiProxy` \|
			\| `webserver/` \| Plain HTTP route-registration carrier: `node:http` server listening on activation; routes register as named `exact`/`prefix` handlers \| `ctx.httpServer` \|
refactor(host): rename the directory-picker dialog backend and kind to native 2026-07-28 21:07:28 +08:00			\| `directory-picker/` \| Workspace-directory picking seam: discriminated `native`/`browse` capability the gateway's picker RPCs delegate to \| `ctx.directoryPicker` \|
feat(host,client): compose directory picking through slots — dual-face -native, no wire advertisement 2026-07-28 21:51:01 +08:00			\| `directory-picker-native/` \| Dual-face native interaction: OS-chooser backend (osascript / PowerShell / Zenity+KDialog, host-display only) + the browser half filling ui-workspace's directory-flow slots \| (registers `ctx.directoryPicker`) \|
feat(host,client): ship the in-app directory browser as the browse package's client half 2026-07-28 22:22:14 +08:00			\| `directory-picker-browse/` \| Dual-face browse interaction: listing/creation primitives over Node stdlib (remote-capable) + the browser half rendering the in-app Select Workspace Directory dialog \| (registers `ctx.directoryPicker`) \|
feat(host): adaptive directory-picker default via -auto chooser 2026-07-29 18:34:06 +08:00			\| `directory-picker-auto/` \| Adaptive chooser: resolves the host's situation once at boot (bind host, SSH, display) and mounts the matching dual-face backend as an in-memory Loader entry \| (mounts a backend row) \|
doc(packages): add the host/ and client/ group READMEs and table rows 2026-07-28 15:04:59 +08:00
			`apiproxy` is transport-agnostic by design — it registers no routes; carriers wrap `ctx.apiProxy` themselves. The HTTP carrier route (with its `/api` browser-trust fence) is mounted by [`client/connection`](../client/connection/README.md)'s node half, which is why that package lives in the client group: it owns both ends of the wire.