dsh-turn-notify

You kick off a multi-turn task in DSH and walk away. Minutes later the Agent has stopped, waiting on you: approve a tool call, answer a question, review a plan, or investigate an error. Without a heads-up, that blocked state accumulates silently while you are at lunch or in a meeting. dsh-turn-notify turns every moment the Agent needs you into a Windows system toast—long banner, chime, and a short Q&A preview—so you notice it even when the monitor is off.

The plugin covers the full set of critical events: turn completion, goal state changes, aborted or interrupted sessions, turn errors, max-token hits, crash recovery, approval requests, proactive questions from the Agent, plan reviews, and mid-turn runtime errors. Each notification is a WinRT Toast with the session tag and a two-line preview (question / answer) truncated to a configurable length, in Chinese or English. The chime plays in sync with the banner via SoundPlayer, independent of the system notification sound setting. Child-agent sessions stay silent; only the root session fires notifications.

Concurrency is handled per session.id: completions queue serially, critical events bypass the queue, and same-type events within 1.5 s are merged to prevent storms. State is released on session disposal with a 128-session capacity cap so long runs stay memory-flat. The notifier prefers a standalone dsh-notify.exe (bypasses security software that blocks script hosts), falls back to PowerShell + WinRT Toast, then tray balloon, then log.

Built for Windows 10/11 users who let DSH run multi-turn tasks in the background and do not want to keep glancing at the screen, or who need to know the Agent is stuck while they are in a call or away from the desk. Once installed, a single chime in the corner is all you need to know something is waiting.