dsh-subagent-idle-delivery

Background subagents finish their work, settle, and file reports, but the parent session is often still busy: the model is mid-output, tools are mid-execution. Dropping a subagent notice into the inbox at that moment pollutes the next input step, hijacks model attention, and derails whatever is in flight. dsh-subagent-idle-delivery fixes this timing mismatch by holding such notices until the parent session is fully idle, then delivering them as a fresh conversation turn--no interruption, no interleaving, no attention theft.

Under the hood, the plugin intercepts only two message kinds: subagent-settled (settlement notices) and subagent-report (proactive reports). User messages, steering interjections, and approval notifications are never touched. Held messages are pulled from the inbox and parked; the UI stops flashing queue previews. Once the current turn completes normally, the parked messages arrive as a new turn. If a hold exceeds the maxHoldMs release valve and the session is still busy, messages are released as a queue appended after the current turn, never spliced into an in-flight one.

This plugin is a drop-in fit for deployments that lean heavily on background continuable subagents: built-in subagent, subagent_model with backgroundMode enabled, schedspawn, and similar workflows all benefit immediately. No configuration is required after mounting, and the only requirement is DSH >= 0.1.0-rc.7, keeping existing workflows completely untouched.