dsh-delay-tools

In DSH, background jobs are scoped to the agent turn lifecycle: the moment a turn ends the process is torn down, so a plain shell timer cannot deliver a remind-me-in-three-minutes message back into the same conversation. dsh-delay-tools runs a host-level timer in the plugin apply scope and uses the official followup wake channel to land the reminder precisely in the original conversation, regardless of how many intervening turns occur.

The plugin ships two complementary delay modes. schedule_reminder lets the agent keep working after scheduling, then wake up in the same conversation when the delay elapses; multiple reminders per agent are supported, each with a unique reminder_id. wait works the other way: it blocks the current turn in a countdown gate. Messages the user sends during the gate are queued and processed after the countdown finishes, making it a dependable trigger for cooldown control or for testing queue and merge plugins such as dsh-queue-merge. Both tools honour the stop signal, so pressing the stop button mid-wait interrupts immediately instead of hanging for the full delay.

Reach for this plugin when you need the agent to surface a reminder back in the same conversation after a set interval, when you want a controllable cooldown between tool calls, or when you are testing how DSH handles queued and merged messages. It fills the two gaps the DSH runtime otherwise leaves open: cross-turn scheduled wake-up and intra-turn blocking wait.