dsh-delete-archived
A DeepSeek Harness plugin to permanently delete archived conversations.
中文
What it does
- Host side (
lib/entry.js) registers two HTTP routes and one agent tool:
POST /plugin/dsh-delete-archived/delete with { "sessionId": "..." }GET /plugin/dsh-delete-archived/list- Tool
delete_archived_conversation(sessionId) — callable by the assistant in a conversation.
- Deletion removes the session's JSONL storage directory (all format generations) and clears
the workspace registry: the archive marker, the pin marker, and each workspace's session
accounting. Sessions that are not archived, or still resident in memory, are refused (a live
session would rewrite its log on the next flush and resurrect the data).
- Client side (
lib/client.js) adds a "Delete conversation" entry to the per-session "..." menu
in the sidebar, shown only for archived sessions (two-step confirm, inline error on refusal).
Difference from dsh-archived-chats
The community index already lists dsh-archived-chats, which also lists and permanently
removes archived conversations. This plugin does not re-implement that capability: the
increment here is (a) a "Delete conversation" row in the sidebar's per-session "..." menu for
archived sessions only, and (b) the model-callable delete_archived_conversation tool. If you
only need bulk cleanup, dsh-archived-chats is the smaller dependency.
Destructive tool
delete_archived_conversation is model-invocable: the assistant can call it without any
second confirmation. It removes the session's JSONL directory and its workspace registry
entries, and the deletion cannot be undone. The sidebar entry is the human-confirmed path
(two-step confirm); treat the tool as an automation-level capability and keep it out of
workflows you do not want deleting archived sessions on their own.
Behavior notes
- Only archived sessions can be deleted; archive a session first.
- Deletion is serialized per session. Being still held by the host is not a reason to refuse:
archiving already stopped the agent and the host's
ArchivedSessionGate refuses further steps,
so the log is no longer written; the response reports heldAtDelete as evidence.
- The session-search index in this deployment is
:memory:/openAt: never, so no index cleanup is
needed; deployments that enable content search clean up the SQLite rows automatically on the next search.
- Content-addressed image attachments may be shared across sessions and are intentionally not reference-counted.
Install
# Local directory — quit the Desktop app first; --profile is required.
dsh plugin --profile <profile> add <absolute/path/to/this/dir>
# From GitHub
dsh plugin --profile <profile> add github:<owner>/dsh-delete-archived
Then restart Harness so the new bundle composes. This package has zero runtime dependencies and
ships plain JavaScript, so a GitHub install needs no allowBuilds code-execution approval.
License
MIT
