dsh-delay-tools

Usage

Tell the agent:

Call the schedule_reminder tool and remind me in 30 seconds to drink water.

The agent calls the tool and returns the expected trigger time; when the delay elapses it wakes up and delivers the reminder in the same conversation. No matter how many other turns happen in between (including new messages you send), the reminder arrives on time. Multiple reminders per conversation are supported — each has its own reminder_id.

Durability note: reminders live in process memory. They survive agent turns (and plugin reloads cancel them cleanly), but restarting the DSH host cancels all pending reminders. Durable persistence is on the roadmap.

Tool parameters

Param	Type	Required	Description
delay_ms	number	no	Delay in ms, default 60000; clamped to minDelayMs..maxDelayMs
message	string	yes	The text the agent delivers to you when the delay elapses

Return value

scheduled / due_at / delay_ms / pending (how many reminders are still pending for this agent).

Configuration

- id: dsh-delay-tools
  config:
    defaultDelayMs: 60000       # default delay when delay_ms is omitted
    maxDelayMs: 3600000         # upper bound for a single delay
    minDelayMs: 1000            # lower bound, guards against instant re-entry