dsh-session-notify

DSH web plugin: session-stop alerts — a finished output (running → stopped) or a waiting-for-you stop (approval / plan review / question) — delivered as desktop notifications, a chime, and a title flash while the page is in the background. Click a notification to jump to that session.

Pure plugin-layer implementation; no DSH source changes.

Alert matrix

| Page state | Stopped session | Effect | |---|---|---| | Background (another window) | any session | notification + chime (if on) + title flash (if on) | | Foreground | a non-current session | notification + chime (when "foreground" pref is on) | | Foreground | the session you are watching | silent by design |

Notifications are clickable: click → focus the window → switch to that session.

Install

Official bundle channel (one command installs AND mounts):

dsh plugin --profile web add dsh-session-notify

Manual/dev install:

node build.mjs        # needs esbuild
cp -R lib cordis.patch.yml package.json ~/.dsh/profiles/web/node_modules/dsh-session-notify/
# then add to ~/.dsh/profiles/web/cordis.patch.yml:
# - insert:
#     - id: session-notify
#       name: 'dsh-session-notify'

Restart dsh web; hard-refresh the page after a bundle update.

Behavior notes

• Watches the client runtime's ctx.sessions.list store (same data source as the sidebar status dots: host/session-status frames + the pendingInteraction projection).
• Each alert uses a UNIQUE notification tag and explicitly closes the previous live notification for that session: macOS silently swallows re-deliveries of an identifier still present in Notification Center, so a stable per-session tag would drop every alert after the first.
• Preferences persist in localStorage (dsh-session-notify.prefs.v1), no host service needed.
• Copy is bilingual (zh/en) through the DSH locale service.
• Reload takes a silent baseline: no replay of alerts for already-waiting sessions.

Known limitations

• No alerts when the browser tab is closed (a client plugin lives in the page).
• Browser notification permission required (grant once from the settings section).
• Whether a banner appears is controlled at two levels: after the site permission is granted, macOS can still silence the browser App in System Settings → Notifications, and Focus/DND swallows banners — the JS new Notification() construct succeeds with no visible effect, and the plugin cannot detect this.
• The notification's origin line shows the page origin (e.g. 127.0.0.1:3080); browsers force this label and JS cannot change it.