feat(desktop): session hygiene, archive, media streaming + connecting overlay by OutThisLife · Pull Request #37099 · NousResearch/hermes-agent

OutThisLife · 2026-06-02T00:53:57Z

Summary

A batch of desktop feedback fixes (Ben's nitpick list + the connecting-state polish).

Sessions

No more empty "Untitled" sessions. session.create in the TUI gateway pre-created a DB row on every launch/draft, so each hermes --tui / "New session" you never typed into left a message-less row behind. The row is now created lazily on the first prompt (_ensure_session_db_row, INSERT-OR-IGNORE, captures cwd), and the desktop sidebar lists with min_messages=1 so the existing backlog disappears too.
Archive / hide sessions. New archived column + set_session_archived, web API (/api/sessions?archived=exclude|only|include and PATCH {archived}), Ctrl/⌘-click a chat (or its context/⋯ menu) to archive, and an Archived Chats settings panel to restore or permanently delete.
+ per workspace to start a session in a directory you already have sessions in; "Group by workspace" toggle is now always visible (not hover-only).
Relabeled "New agent" → "New session" and "Agents" → "Sessions" (sidebar, fresh-draft title, command palette). The separate Agents overview page is untouched.

Background processes

A backgrounded shell script reported its completion in a different session. Completion events now carry the owning session_key, and each session's notification poller only consumes its own (foreign events are left/redelivered).

Media

Videos load. Replaced the capped (16 MB), in-memory data-URL path with a streaming hermes-media:// Electron protocol — no size cap and proper Range/seeking. Audio/video go through it; images keep the data-URL path.

Connecting overlay

New GatewayConnectingOverlay replaces the bare skeleton + "starting gateway" placeholder while the gateway connects: an ascii decode of CONNECTING (nousnet-web download-button style) with a blinking dither cursor, that on connect freezes, fades down + desaturates, holds, then fades the overlay out to reveal the app. Shows on cold start / reconnect; ?connecting=1 forces a looping preview in dev.

Test plan

apps/desktop: npm run type-check, npm run lint, npm test (markdown-text + chat-runtime) — green.
Python: scripts/run_tests.sh tests/test_hermes_state.py tests/hermes_cli/test_web_server.py tests/test_tui_gateway_server.py tests/tools/test_process_registry.py — green (the unrelated test_browser_manage_connect_default_local_reports_launch_hint fails identically on main).
Manual: archive via Ctrl-click + unarchive from settings; play a >16 MB video in chat; background a shell job in session A and confirm completion lands in A; cold-launch to see the connecting overlay.

Not included

Git worktree support (tracked separately per discussion).

… overlay Address a batch of desktop feedback: - Stop leaking empty "Untitled" sessions: the TUI gateway pre-created a DB row on every session.create (i.e. every launch/draft). Persist the row lazily on first prompt instead, and hide message-less rows in the sidebar. - Archive/hide sessions: new `archived` column + set_session_archived, web API (`?archived=` + PATCH archived), Ctrl/⌘-click and a context-menu item in the sidebar, and an "Archived Chats" settings panel to restore/delete. - Videos load via a streaming `hermes-media://` protocol instead of capped, in-memory data URLs (16 MB limit) — bypasses the cap and supports seeking. - Background-process completions route to the session that launched them: the completion event now carries session_key and each poller only consumes its own. - Sidebar: "Group by workspace" toggle is always visible; each workspace group gets a "+" to start a session in that directory; "New agent"/"Agents" relabeled to "New session"/"Sessions". - New gateway connecting overlay (ascii decode → fade out) replacing the bare skeleton/"starting gateway" state.

OutThisLife · 2026-06-02T01:01:16Z

bugbot run

cursor · 2026-06-02T01:01:19Z

Skipping Bugbot: Unable to authenticate your request. Please make sure Bugbot is properly installed and configured for this repository.

Copilot

Pull request overview

This PR improves Hermes Desktop/TUI session lifecycle and UX by preventing empty sessions from being persisted, adding soft-archive support end-to-end, correctly routing background-process completion notifications to the originating session, and enabling large audio/video playback via a streaming Electron protocol (plus a new connecting overlay).

Changes:

Make TUI gateway sessions persist lazily on first prompt submission (avoids empty “Untitled” rows) and add notification routing by session_key.
Add session soft-archive support in the SQLite state store + web API (list filtering + PATCH { archived }) with corresponding desktop UI affordances.
Stream audio/video via a custom hermes-media:// Electron protocol (Range/seek support; no data-URL size cap) and introduce a new connecting overlay component.

Reviewed changes

Copilot reviewed 26 out of 26 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
tui_gateway/server.py	Lazy session row persistence and session-key-based completion event routing in the TUI gateway.
tools/process_registry.py	Include `session_key` on process completion events.
tests/test_tui_gateway_server.py	Tests for lazy session persistence and notification event routing.
tests/test_hermes_state.py	Tests for session archive behavior in the state DB.
tests/hermes_cli/test_web_server.py	Web API tests for session archive PATCH and session listing behavior.
hermes_state.py	Add `archived` session column and filtering + setter APIs.
hermes_cli/web_server.py	Add `archived` query param to sessions listing and support `{ archived }` in PATCH.
apps/desktop/src/types/hermes.ts	Add `archived` to the desktop session type.
apps/desktop/src/lib/media.ts	Add `mediaStreamUrl()` for the streaming protocol.
apps/desktop/src/lib/icons.ts	Export archive icons for UI usage.
apps/desktop/src/hermes.ts	Add archived filtering to `listSessions()` and introduce `setSessionArchived()`.
apps/desktop/src/components/gateway-connecting-overlay.tsx	New animated connecting overlay component for gateway connect/reconnect.
apps/desktop/src/components/assistant-ui/markdown-text.tsx	Route audio/video sources through streaming protocol; keep images on data URLs.
apps/desktop/src/app/settings/types.ts	Add “sessions” to settings view/query types.
apps/desktop/src/app/settings/sessions-settings.tsx	New settings panel to restore/delete archived sessions.
apps/desktop/src/app/settings/index.tsx	Wire “Archived Chats” into the settings navigation and view routing.
apps/desktop/src/app/settings/constants.ts	Add search placeholder for archived sessions settings view.
apps/desktop/src/app/session/hooks/use-session-actions.ts	Add sidebar “Archive” action wiring via `setSessionArchived`.
apps/desktop/src/app/desktop-controller.tsx	Hide empty sessions in sidebar; add per-workspace “+” start; mount connecting overlay.
apps/desktop/src/app/command-center/index.tsx	Rename “New agent” → “New session” in command center.
apps/desktop/src/app/chat/sidebar/virtual-session-list.tsx	Thread archive callback through virtualized session list rows.
apps/desktop/src/app/chat/sidebar/session-row.tsx	Add ctrl/meta-click archive behavior + menu wiring.
apps/desktop/src/app/chat/sidebar/session-actions-menu.tsx	Add “Archive” item to per-session actions menu.
apps/desktop/src/app/chat/sidebar/index.tsx	Rename “Agents” → “Sessions”, make grouping toggle always visible, add per-workspace “+”.
apps/desktop/src/app/chat/index.tsx	Rename header fallback “New agent” → “New session”.
apps/desktop/electron/main.cjs	Register `hermes-media` protocol handler for streaming local media via Range-aware fetch.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

The shownRef latch kept the connecting overlay mounted behind BootFailureOverlay after a hard boot failure. Return null on boot.error so the failure recovery surface fully owns the screen.

github-actions · 2026-06-02T01:06:44Z

🔎 Lint report: `bb/desktop-sessions-media` vs `origin/main`

ruff

Total: 0 on HEAD, 0 on base (➖ 0)

🆕 New issues: none

✅ Fixed issues: none

Unchanged: 0 pre-existing issues carried over.

ty (type checker)

Total: 9600 on HEAD, 9598 on base (🆕 +2)

🆕 New issues: none

✅ Fixed issues: none

Unchanged: 4974 pre-existing issues carried over.

Diagnostics are surfaced as warnings — this check never fails the build.

- /api/sessions: validate `archived` (400 on unknown) and return `archived` as a JSON boolean instead of SQLite's 0/1. - PATCH /api/sessions/{id}: 400 (not a misleading 404) when the body has no updatable fields; stop conflating a no-op with "not found". - hermes-media protocol: drop `bypassCSP` — streaming only needs secure/standard/stream/supportFetchAPI. - Sidebar workspace header: split the toggle and the "+" into sibling buttons so we no longer nest interactive elements inside a <button>.

Copilot

Pull request overview

Copilot reviewed 26 out of 26 changed files in this pull request and generated 2 comments.

- hermes-media protocol: restrict streaming to an audio/video extension allowlist (415 otherwise) so it can't be used to read arbitrary local files. - Connecting overlay: use z-[1200] instead of the non-standard z-1200 utility.

Copilot

Pull request overview

Copilot reviewed 26 out of 26 changed files in this pull request and generated 1 comment.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 26 out of 26 changed files in this pull request and generated no new comments.

… overlay (NousResearch#37099) * feat(desktop): session hygiene, archive, media streaming + connecting overlay Address a batch of desktop feedback: - Stop leaking empty "Untitled" sessions: the TUI gateway pre-created a DB row on every session.create (i.e. every launch/draft). Persist the row lazily on first prompt instead, and hide message-less rows in the sidebar. - Archive/hide sessions: new `archived` column + set_session_archived, web API (`?archived=` + PATCH archived), Ctrl/⌘-click and a context-menu item in the sidebar, and an "Archived Chats" settings panel to restore/delete. - Videos load via a streaming `hermes-media://` protocol instead of capped, in-memory data URLs (16 MB limit) — bypasses the cap and supports seeking. - Background-process completions route to the session that launched them: the completion event now carries session_key and each poller only consumes its own. - Sidebar: "Group by workspace" toggle is always visible; each workspace group gets a "+" to start a session in that directory; "New agent"/"Agents" relabeled to "New session"/"Sessions". - New gateway connecting overlay (ascii decode → fade out) replacing the bare skeleton/"starting gateway" state. * fix(desktop): bail connecting overlay on boot error The shownRef latch kept the connecting overlay mounted behind BootFailureOverlay after a hard boot failure. Return null on boot.error so the failure recovery surface fully owns the screen. * fix(desktop): address Copilot review - /api/sessions: validate `archived` (400 on unknown) and return `archived` as a JSON boolean instead of SQLite's 0/1. - PATCH /api/sessions/{id}: 400 (not a misleading 404) when the body has no updatable fields; stop conflating a no-op with "not found". - hermes-media protocol: drop `bypassCSP` — streaming only needs secure/standard/stream/supportFetchAPI. - Sidebar workspace header: split the toggle and the "+" into sibling buttons so we no longer nest interactive elements inside a <button>. * fix(desktop): address Copilot re-review - hermes-media protocol: restrict streaming to an audio/video extension allowlist (415 otherwise) so it can't be used to read arbitrary local files. - Connecting overlay: use z-[1200] instead of the non-standard z-1200 utility. * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

OutThisLife requested a review from Copilot June 2, 2026 01:00

Copilot started reviewing on behalf of OutThisLife June 2, 2026 01:00 View session

Copilot AI reviewed Jun 2, 2026

View reviewed changes

Comment thread hermes_cli/web_server.py

Comment thread hermes_cli/web_server.py Outdated

Comment thread apps/desktop/electron/main.cjs

Comment thread apps/desktop/src/app/chat/sidebar/index.tsx Outdated

fix(desktop): bail connecting overlay on boot error

f692025

The shownRef latch kept the connecting overlay mounted behind BootFailureOverlay after a hard boot failure. Return null on boot.error so the failure recovery surface fully owns the screen.

OutThisLife requested a review from Copilot June 2, 2026 01:15

Copilot started reviewing on behalf of OutThisLife June 2, 2026 01:15 View session

Copilot AI reviewed Jun 2, 2026

View reviewed changes

Comment thread apps/desktop/electron/main.cjs

Comment thread apps/desktop/src/components/gateway-connecting-overlay.tsx Outdated

fix(desktop): address Copilot re-review

599291c

- hermes-media protocol: restrict streaming to an audio/video extension allowlist (415 otherwise) so it can't be used to read arbitrary local files. - Connecting overlay: use z-[1200] instead of the non-standard z-1200 utility.

OutThisLife requested a review from Copilot June 2, 2026 01:21

Copilot started reviewing on behalf of OutThisLife June 2, 2026 01:22 View session

Copilot AI reviewed Jun 2, 2026

View reviewed changes

Comment thread tui_gateway/server.py

Potential fix for pull request finding

e1a8fda

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

OutThisLife requested a review from Copilot June 2, 2026 01:25

Copilot started reviewing on behalf of OutThisLife June 2, 2026 01:25 View session

Copilot AI reviewed Jun 2, 2026

View reviewed changes

OutThisLife merged commit 85b65e2 into main Jun 2, 2026
31 of 32 checks passed

OutThisLife deleted the bb/desktop-sessions-media branch June 2, 2026 01:41

Iam-Gitman mentioned this pull request Jun 2, 2026

fix(desktop): correct sidebar session pagination and counts #37489

Open

13 tasks

BrewTestBot mentioned this pull request Jun 6, 2026

hermes-agent 2026.6.5 Homebrew/homebrew-core#286569

Merged

1 task

github-actions Bot mentioned this pull request Jun 6, 2026

chore: bump NousResearch/hermes-agent version from v2026.5.29.2 to v2026.6.5 Docker-Hub-sirmark/docker-hermes-agent#9

Merged

github-actions Bot mentioned this pull request Jun 12, 2026

Upstream Hermes v2026.6.5 disponible (ultimo sync: v2026.5.29.2) samuelgradientai-sys/clawksis-agent#22

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(desktop): session hygiene, archive, media streaming + connecting overlay#37099

feat(desktop): session hygiene, archive, media streaming + connecting overlay#37099
OutThisLife merged 5 commits into
mainfrom
bb/desktop-sessions-media

OutThisLife commented Jun 2, 2026

Uh oh!

OutThisLife commented Jun 2, 2026

Uh oh!

cursor Bot commented Jun 2, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jun 2, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

OutThisLife commented Jun 2, 2026

Summary

Sessions

Background processes

Media

Connecting overlay

Test plan

Not included

Uh oh!

OutThisLife commented Jun 2, 2026

Uh oh!

cursor Bot commented Jun 2, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jun 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔎 Lint report: bb/desktop-sessions-media vs origin/main

ruff

ty (type checker)

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions Bot commented Jun 2, 2026 •

edited

Loading

🔎 Lint report: `bb/desktop-sessions-media` vs `origin/main`