AI Agent Hub
Back to plugins
🧩

dsh-restart-resume

admin-security Updated 2026.08.21

Run the following command in DeepSeek Harness:

dsh plugin install Asteroid0449/dsh-restart-resume

Paste the following prompt into your AI chat to install this plugin:

Install the plugin in the DeepSeek Harness Web interface by running dsh plugin install Asteroid0449/dsh-restart-resume; the full source is available at https://github.com/Asteroid0449/dsh-restart-resume .

About this plugin

Restarting a DeepSeek Harness backend for plugin updates, configuration changes, or bundle upgrades usually means killing the process outright, which severs active sessions, published sub-agents, and background jobs along with the user context. dsh-restart-resume introduces a safety protocol for this high-risk path: it waits for all in-flight work to drain, requests a supervised relaunch via exit code 75, persists the resume marker, and automatically reconnects the Web page so the user never has to refresh or re-issue a task.

The plugin registers three fixed tools, dsh_restart, dsh_restart_status, and dsh_restart_cancel, always exposed in the same order and schema, so the model-request tool prefix never shifts with state changes. Before the final countdown the plugin enters a drain-wait phase; if new work appears it reverts gracefully, and a drain timeout cancels the restart rather than force-killing sessions. Rate limiting, atomic markers, TTLs, and idempotent messages together prevent restart loops. The resumeMode setting distinguishes continue (resuming unfinished configuration, validation, and delivery in the original task) from report-only (isolated test runs), keeping test cycles from being mistaken for production resumes.

It is aimed at administrators or teams that already run Harness under a supervisor process. The launcher must mint a fresh boot ID before every spawn and only relaunch on exit code 75, with frequency limits enforced on both the plugin and the supervisor side. In that architecture dsh-restart-resume turns a dangerous hard-kill into an observable, cancellable, resumable standard flow, letting the Agent pick up unfinished work seamlessly instead of leaving the user staring at a blank page.

Use Cases

  • Restart the backend after a plugin update or config change while preserving the active session and unfinished work
  • Reload the frontend process after a bundle upgrade without force-killing running sub-agents or background jobs
  • Safely restart under an exit-code contract in multi-instance setups to avoid restart loops and duplicate resumes

Best For

  • Operations administrators running DeepSeek Harness under a supervisor process
  • Technical teams that need minimal-downtime backend restarts
  • Developers who want the Agent to automatically resume unfinished tasks after a restart without user intervention