AI Agent Hub
Back to plugins
🧩

dsh-session-repair

admin-security Updated 2026.08.25

Run the following command in DeepSeek Harness:

dsh plugin install Equinox7379/dsh-session-repair

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

Run dsh plugin install Equinox7379/dsh-session-repair inside DeepSeek Harness to install this plugin; the full source is available at https://github.com/Equinox7379/dsh-session-repair .

About this plugin

In dsh 0.1.0-rc.x there is no registration mechanism for third-party event types. When an external plugin writes custom events (such as message-edit or version) into a session log, restoring that session after a service restart throws SessionFormatUnsupportedError and the session becomes permanently unopenable. dsh-session-repair exists to solve exactly this problem.

The plugin exposes three actions: scan (zero modification, report-only), repair (adds the officially supported ignorable flag to every non-live session and rewrites the log in compliant frame format — first line is a single header frame, subsequent lines are one frame each, compressed with checksum), and repair_id (same repair scoped to one specific session). A .before-ignorable backup is created before any write, already-flagged events are skipped for idempotency, and if decompression fails or the first line is invalid the plugin aborts that file and reports the error rather than forcing a write-back.

It is aimed at administrators running DeepSeek Harness with external plugins that inject custom session events and have ended up with corrupted logs. The plugin has zero runtime dependencies, introduces no new session events, and exposes no HTTP routes — a lightweight, surgical repair tool.

Use Cases

  • A custom plugin's events trigger SessionFormatUnsupportedError on restart, making the session permanently unopenable
  • Read-only scan across all non-live sessions to identify which logs are missing the ignorable flag
  • Targeted repair on one specific session with automatic backup and compliant frame rewrite, leaving other files untouched

Best For

  • dsh administrators running external plugins that inject custom session events
  • Operators facing corrupted session logs who need a fast, safe recovery path
  • DeepSeek Harness users who value frame format compliance and zero runtime dependencies