dsh-notify

Notifications that do not appear, clicks that land on the wrong session, and a flood of toasts after every single turn are the three most common complaints from DSH desktop-shell users. dsh-notify lifts the display-and-interaction layer into a pluggable web-side plugin: a global top-right toast stack that grades events by kind with distinct accent colors, per-kind auto-dismiss timing, and a five-toast cap with oldest-first eviction. Clicking a toast invokes the official dsh-client-runtime sessions store to programmatically select and open the exact session by ID with automatic retries during transient list phases, completely replacing the legacy __reactFiber$ DOM-walking hack. In a shell-less environment the plugin gracefully degrades to subscribing on the sessions store directly and drawing its own completed-turn toasts, so the notification path never breaks.

The guiding principle is strict shell-core separation: aggregation windows, channel routing, and per-turn versus batched policy are all decided by the shell-side hub and delivered downward. The plugin only paints events, sends click and seen acks, wraps every code path in try/catch so nothing leaks, and on uninstall tears down styles, the root container, and every toast in one pass. It never re-parents DSH slot nodes, avoiding the render-process lock-up documented in known issues.

It is built for DSH-Exoskeleton desktop-shell users who want a swappable notification layer that no longer depends on shell-internal DOM structure, and for web-side developers who still need lightweight session-completion cues. Detection logic (zstd watcher, service health, update probing) stays in the main process; the plugin owns only the render-and-interact surface.