env-facts — DSH plugin: structured environment facts with an as-of stamp
A DeepSeek Harness (DSH) Host plugin that adds a machine-readable fact block with its
capture time to the runtime-context snapshot:
As of 2026-10-25T12:34:56.789Z
<env>
cwd: "F:\\workspace"
file_policy: danger-full-access
approval_policy: never
gui_url: http://127.0.0.1:3442
session: 019...
</env>
The built-in snapshot lists these facts as prose and carries no timestamp; this plugin adds
both a structured form and an As of time without touching the DSH installation.
Why the as-of stamp is computed this way
The snapshot text participates in DSH's dedupe: while the environment is stable the snapshot
is not re-sent (an audit of dsh-v0.2.1-rc.3 measured 186 model steps producing a single
snapshot). Writing a fresh timestamp every step would defeat that dedupe and emit one message
per step.
This plugin caches per session and only recomputes the text when the facts change. As of is
the moment those facts last changed (or were first captured), so the text stays byte-identical
while the environment is stable and the snapshot dedupe keeps working.
Facts and their sources
| Field | Source |
|---|
cwd | workingDirectory.get(session) |
file_policy | sandboxPolicy.resolve({ session }).mode |
approval_policy | approval.overrideOf(session) (omitted when unset) |
gui_url | webApp.getAdvertisedUrl() |
session | session.id |
A missing service or fact is simply omitted; it never fails assembly.
Install
Install the package directory as a local bundle with plugin_manager (install_bundle).
The package declares dsh.bundle.patch, which inserts the env-facts row.
upstream-patch/
This directory contains two patches against deepseek-ai/deepseek-harness tag
dsh-v0.2.1-rc.3 that move the same idea into the core (snapshot header constant + stamp at
emission, dedupe by body). They are provided for reference and for the upstream project; see
upstream-patch/PR.md.
License
MIT — see LICENSE.
