Remove docs/design/dsh-tui-host-api.md (deleted upstream)
This commit is contained in:
parent
618dc4dd43
commit
c854759c36
|
|
@ -1,70 +0,0 @@
|
||||||
# dsh-TUI Remote Host API plan
|
|
||||||
|
|
||||||
Status: WSL Host smoke test complete. Android acceptance remains open for [issue #290](https://github.com/liguobao/ds-harness-remote/issues/290).
|
|
||||||
|
|
||||||
## Problem
|
|
||||||
|
|
||||||
The dsh-TUI profile can load the Remote Host entry without the Host Remote API suite.
|
|
||||||
Relay and Noise then connect, but Harness RPC calls cannot complete.
|
|
||||||
The Android client retries the connection.
|
|
||||||
|
|
||||||
Issue #290 reports a working manual profile patch.
|
|
||||||
The patch adds the Host Remote API packages to the dsh-TUI composition.
|
|
||||||
The maintainer plans to restore dsh-TUI support in a separate package after version 0.6.3.
|
|
||||||
|
|
||||||
## Release boundary
|
|
||||||
|
|
||||||
Keep the current browser and Desktop Host entry unchanged.
|
|
||||||
Add a separate dsh-TUI entry in a later release.
|
|
||||||
Do not activate two Host entries with the same device identity in one profile.
|
|
||||||
Do not claim that dsh-TUI works until a real profile passes the checks below.
|
|
||||||
|
|
||||||
## Implementation steps
|
|
||||||
|
|
||||||
1. Define the dsh-TUI package and its profile patch.
|
|
||||||
2. List the official Host API packages that the patch must load.
|
|
||||||
3. Check that the profile provides `connection`, `typertGateway`, and the Host Remote event source.
|
|
||||||
4. Report a missing service before the Host advertises usable Remote access.
|
|
||||||
5. Use the existing `ds-harness-remote` CLI for terminal login and status.
|
|
||||||
6. Keep the existing Remote authentication and peer ownership checks.
|
|
||||||
|
|
||||||
The package list needs a check against the selected Harness version.
|
|
||||||
The current list in issue #290 comes from a 0.2.1 profile.
|
|
||||||
The 0.2.2 package graph may require a different list or load order.
|
|
||||||
|
|
||||||
## Acceptance checks
|
|
||||||
|
|
||||||
- A clean dsh-TUI profile loads the package without manual patch edits.
|
|
||||||
- Host status reports the Remote API as available only when the API suite is active.
|
|
||||||
- Android opens a Harness workspace, session, and event stream over an encrypted connection.
|
|
||||||
- Prompt, approval, disconnect, and reconnect work with one Host process.
|
|
||||||
- A missing Host API package produces a clear startup error.
|
|
||||||
- The browser and Desktop Host still load one Remote entry.
|
|
||||||
- The test report records Harness, Plugin, dsh-TUI, Android, Node.js, and transport versions.
|
|
||||||
|
|
||||||
## WSL Host validation (2026-11-09)
|
|
||||||
|
|
||||||
The test used an isolated `DSH_HOME` and a local self-hosted Server.
|
|
||||||
The Host ran Harness `0.2.2-rc.1`, dsh-TUI `0.19.0`, and Node.js `24.15.0`.
|
|
||||||
The TUI package version was `0.1.0-alpha.0` from a local tarball.
|
|
||||||
The Server version was `0.5.21` from this repository.
|
|
||||||
The Server had no STUN or TURN configuration.
|
|
||||||
|
|
||||||
- The clean profile loaded the official Host API entries from the TUI package patch.
|
|
||||||
- The first patch left `session-controller` waiting for `fileUploads`.
|
|
||||||
- The corrected patch loaded `connection` and `file-upload` before the Remote entry.
|
|
||||||
- The corrected profile started without pending Host API entries.
|
|
||||||
- The Host connected to the local Server after account authorization.
|
|
||||||
- A separate Client identity listed one online Host.
|
|
||||||
- The Host control connection recovered after the Server stopped and restarted.
|
|
||||||
- A disabled `dsh-api-remotes` entry produced a clear startup error.
|
|
||||||
- The disabled entry kept the Host offline.
|
|
||||||
|
|
||||||
The test used `HostServerApi.authorizeWithAccount` for the local Server.
|
|
||||||
The `ds-harness-remote` CLI selects the public default Server.
|
|
||||||
This test did not use that CLI for local account authorization or status.
|
|
||||||
The TUI profile also warned about two missing optional TUI tool entries.
|
|
||||||
Those entries were `tool-ralph` and `tool-subagent-list-agents`.
|
|
||||||
|
|
||||||
Android workspace, session, event, prompt, approval, and reconnect checks remain open.
|
|
||||||
The separate TUI package also needs a release path.
|
|
||||||
Loading…
Reference in New Issue