dsh-session-status-hub

Configuration

Config lives in localStorage under dsh-session-hub/config-v1; defaults are already "don't disturb me":

Key	Default	Meaning
enabled	true	Master switch (watermarks keep advancing; re-enabling never replays history)
onComplete / onFailure / onAnswer	true	completed / failed / needs your response
onMaxTokens	true	output-limit hits
onStopped	false	manual stop / interrupt
includeSubagents	false	also notify and list subagent Sessions
silenceCurrentWhenFocused	true	stay silent for the Session you are currently reading
silenceAllWhenFocused	false	never notify while the window is focused
requireVisibleForFocus	true	minimized/hidden counts as unfocused (notify anyway)
freshnessWindowMs	120000	edges older than this only advance watermarks (0 disables)
sound	true	system notification sound
colorMarkers	true	colour emoji in notification titles
colorMarkers	true	colour emoji in notification titles
raiseWindow	true	bring the desktop window forward on notification click
maxRememberedSessions	300	cap on the notification watermark table (newest by updatedAt kept)

Alongside config-v1, the plugin keeps a few state keys under the same prefix — worth knowing when troubleshooting, migrating or wiping data:

Key	Contents
watermarks-v1	notification watermarks: how far each Session has been consumed
error-acks-v1	acknowledged failures { sessionId: seq } (what turns the red chip off)
local-unread-v1	plugin-recorded "finished in background, unseen" { sessionId: seq }
recent-v1	cross-tab dedupe window (4 s)
notify-log-v1	last 20 notification landing results

From the DSH DevTools console:

__DSH_SESSION_HUB__.getConfig()
__DSH_SESSION_HUB__.setConfig({ silenceAllWhenFocused: true })

enabled / onComplete only mute notifications — the unread dot and the taskbar mark are state facts ("this turn finished and you haven't looked"), not interruptions.