@deepwatch/dsh-memory

Host plugin: durable, correctable, scoped memory over an append-only event ledger

Part of DeepWatch — the agent workspace built on the official DeepSeek Harness and powered by Watch Skill for perception, evidence, memory and independent verification.

Host plugin — runs beside the agent in the DSH process. Composed by the bundle. Off unless a profile turns it on.

Exports

• @deepwatch/dsh-memory
• @deepwatch/dsh-memory/records
• @deepwatch/dsh-memory/tools

Peers

Provided by the host rather than installed here:

• @deepseek-ai/[email protected]
• @deepseek-ai/schemastery@^3.18.1

Install

npm install @deepwatch/dsh-memory

Rarely on its own. @deepwatch/dsh-bundle composes this package with the rest of DeepWatch and is what a profile normally depends on; installing this one directly is for embedding a single piece in a composition you control.

Example

Mounted as a profile row. Memory ships off; this turns it on for one profile:

- id: watch-memory
  name: '@deepwatch/dsh-memory'
  config:
    mode: 'local_personal'
    directory: .watch/memory
    tokenBudget: 600

Configuration

Supplied by the host when it mounts this plugin.

| Option | Type | | | --- | --- | --- | | mode | MemoryMode | What this profile permits. | | directory | string | Directory for the ledger and the Markdown projections. | | inferredThreshold | number | Confidence at or above which an inferred, low-impact memory acts. | | tokenBudget | number | Hard ceiling on what memory may cost one turn. | | writeProjections | boolean | Write taste.md and friends whenever memory changes. |

Requirements

• Node ^22.19.0 || >=24.0.0
• The peers above, supplied by the host composition

A writable directory for the ledger. The store is plaintext; it is created owner-only where the operating system enforces file modes, and there is no encryption at rest in this release.

Stability

0.1.4 — a stable release.

Stable means tested, documented and supported — not 1.0. This is a pre-1.0 line, and semantic versioning gives 0.x no compatibility guarantee across minor versions: a 0.MINOR bump may change or remove surface, and a patch will not. Depend on it with a tilde range (~0.1.4) if you want that difference enforced by your lockfile rather than by a changelog. The usual major-version promise starts at 1.0.

Side effects

Importing a module from this package evaluates no side effects, so a bundler may drop what a build does not use. Mounting it in a host is a separate matter: what it then reads or writes is governed by the workspace boundary and the host's permissions, not by this flag.

Where this fits

An append-only event ledger under the workspace boundary. @deepwatch/dsh-wiki projects it into pages and @deepwatch/dsh-client-memory presents it.

The twenty packages and how they compose: the package map. Running DeepWatch, and the gates a change has to pass: the workspace README.

Attribution

Built on DeepSeek Harness · Powered by Watch Skill

DeepWatch and Watch Skill are independent projects and are not affiliated with or endorsed by DeepSeek. MIT licensed; third-party notices are in THIRD_PARTY_NOTICES.md.