# NousResearch/hermes-agent · Dashboard PTY WebSocket handshake and streaming fixes

## Open now

- 0 issues, 1 PR open on GitHub.
- PR #19938: fix(tui): accept WebSocket handshake before close to fix FastAPI 0.136 hang on /api/pty

Multiple bugs and fixes related to the dashboard's /api/pty WebSocket endpoint, covering handshake timeouts, empty responses, event loop blocking, and loopback connectivity for the PTY sidecar. The work spans FastAPI compatibility, in-container networking, and async offloading of PTY operations.

## TL;DR

- 8 member(s): 0 open issue(s), 3 closed issue(s), 1 open PR(s), 0 merged PR(s), 4 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.20`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #19914: Dashboard TUI WebSocket handshake hangs on FastAPI 0.136 — /api/pty times out
- #21948: Dashboard Chat stuck: /api/pty websocket handshake/connects but never streams frames
- #22864: Dashboard /chat PTY WebSocket can time out before HTTP 101 response flushes

## Prior & competing PRs

- **#19943: fix(cli): run dashboard PTY spawn off the event loop**. closed without merge · fix tier `suggested`
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#19938`
- **#22873: fix(dashboard): yield event loop after WebSocket accept in pty_ws handler**. closed without merge · fix tier `suggested`
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `d06104a9ee163e6369d3870f092de875b2f2ab0c`
  - _suggested-tier fix detail withheld; re-request with `?tier=all` to include it._
- **#19938: fix(tui): accept WebSocket handshake before close to fix FastAPI 0.136 hang on /api/pty**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `hermes_cli/web_server.py`, `plugins/kanban/dashboard/plugin_api.py`, `tests/hermes_cli/conftest.py`, `tests/hermes_cli/test_pty_ws_accept_ordering.py`, `tests/hermes_cli/test_web_server.py`, `tests/plugins/test_kanban_dashboard_plugin.py`, `tui_gateway/ws.py`
- **#21980: fix(dashboard): connect PTY sidecar via loopback**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#21988`
- **#21988: fix(dashboard): connect PTY sidecar via loopback**. closed without merge
  - maintainer direction: category `stale_abandoned`; implication `active`

## Fix status

- No merged fix on record.
- Subsystem: `dashboard`