Memory & Contextdsh-plugin

dsh-headroom

dsh-headroom is a DeepSeek Harness plugin that compresses tool output before it enters model context. It routes JSON, search, log, tabular, and long-text content through dedicated compressors; lossy compressions store originals in a local CCR store and inject a marker for retrieval via headroom_retrieve(id=…).

Stars
2
Forks
0
Open issues
0
Last push
Aug 23, 2026
Latest release
—
24h Growth
+0
7d Growth
+0

Installation

dsh plugin --profile web add github:giter00/dsh-headroom

Overview

dsh-headroom is a DeepSeek Harness plugin that compresses tool output before it enters model context. It routes JSON, search, log, tabular, and long-text content through dedicated compressors; lossy compressions store originals in a local CCR store and inject a marker for retrieval via headroom_retrieve(id=…).

  • Registers tools/post-execute and replaces tool result text before it is materialized.
  • Routes JSON, grep/ripgrep, build/test/log, CSV/TSV/markdown table, and long-text output to dedicated compressors.
  • Stores originals of lossy compressions in a local CCR store and injects a short marker for retrieval.
  • Provides headroom_retrieve, headroom_compress, and headroom_stats tools.
  • Persists the CCR store to <DSH_HOME>/storages/dsh-headroom-ccr.json with debounce, atomic replacement, TTL, and max entries.
  • Skips short text, code, error output, excluded tools, and the plugin's own tools.
  • Supports a Kompress-style text pipeline and an optional ONNX scorer via kompress.scorer: 'onnx'.
  • Uses pure JavaScript and Node built-in modules; DSH_HOME can be overridden by environment variable.

Related plugins