dsh-delay-tools
DeepSeek Harness 的延迟唤醒：安排 N 分钟后的提醒，代理会在同一对话中唤醒并回复——不同于会创建新会话的 cron 调度器。还提供 wait（定时门控）工具，可阻塞当前回合，并可通过停止按钮中断。主机级计时器 + 官方 agent.followup() 唤醒通道。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:keyiadiannao/dsh-delay-tools#28b310173831e1fea9a911ef3d248546562ad1acDelay Tools 以 dsh-delay-tools 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →Delay utilities for DeepSeek Harness: two tools sharing one core concept — delay:
| Mode | Tool | What the agent does while waiting | User messages during the wait | Typical use |
|---|---|---|---|---|
| Wake | schedule_reminder | keeps working; wakes up in the SAME conversation when due | handled normally | "remind me in 3 minutes about X" |
| Gate | wait | blocks the current turn | queued, processed after | "wait 30 seconds, then continue", cooldowns |
A plain background shell timer cannot do "wake me in 3 minutes": DSH background
jobs are bound to the agent turn's lifecycle and get torn down when the turn
ends (ctx.jobs owner-scoped dispose — the process exits with 0xC000013A and
the cancel is misreported as completed). This plugin uses a host-level timer
(not bound to any turn) plus the official followup() wake channel to deliver
the message back into the same conversation.
dsh plugin add github:keyiadiannao/dsh-delay-tools#master
Tell the agent:
Call the
schedule_remindertool 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.
| 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 |
scheduled / due_at / delay_ms / pending (how many reminders are still
pending for this agent).
wait (timed gate)schedule_reminder means "wake later, keep working meanwhile"; wait is the
opposite — it blocks the current turn, and the agent only continues after
the countdown:
Call the
waittool for 30 seconds, then continue.
wait takes only delay_ms and returns waited_ms / elapsed_until / note.
Messages you send during the gate go into the inbox queue (the composer shows
"N queued messages") and are processed after the countdown — which makes it a
reliable trigger for testing queue/merge plugins such as
dsh-queue-merge.
wait observes exec.signal per the tools contract: pressing the stop
button mid-wait interrupts the gate immediately (returns
note: 'Wait interrupted by the user (stop).') instead of hanging for the full
delay.
- 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
user: "tell me X in 3 minutes"
↓
schedule_reminder(delay_ms, message)
↓
host setTimeout(delay).unref() ← not bound to any turn lifetime
↓ (turn ends, teardown, further turns — none of it matters)
due → agent.followup(userMessage) ← official wake channel
↓
agent (idle) opens a new turn → replies in the same conversation
Key points:
ctx.jobs (which dies
with the owning turn).setTimeout().unref() lets the process exit normally when only the timer is
left — it never blocks the DSH lifecycle.agent.followup() is the runtime's official wake channel: a wake submitted
while the agent is idle always opens a new turn boundary (see the runtime-types
comments), so cross-turn waking is a supported semantic.tests/ holds config-validation tests (pnpm test). End-to-end verification:
schedule_reminder with a 30 s delay;wait interruption: have the agent call wait for 40 s, press stop mid-way →
the turn ends immediately instead of hanging for the full 40 s.
cancel_reminder / list_reminders tools (per-agent, by reminder_id)reminders.json + re-hydrated timers on boot), so
reminders survive a DSH host restartMIT