@dsh-cc/memory-consolidation 0.5.0

package/lib/prompts.js

@@ -0,0 +1,60 @@
+/**
+ * Prompt builders for the extraction and dream forks. Both are pure text
+ * assembly so they are unit-testable and stable model-visible contracts.
+ *
+ * The forks hold no write tools: they report their file set through the
+ * driver-injected `structured_output` tool, and the plugin writes the files
+ * host-side (see `writeback.ts`). The prompts below are the model-facing half
+ * of that contract.
+ * @module @dsh-cc/memory-consolidation/prompts
+ */
+import { MEMORY_AGENT_TOOLS } from "./tools.js";
+/** The always-loaded index filename (mirrors `dsh-memory`'s export). */
+const ENTRYPOINT_NAME = 'MEMORY.md';
+/**
+ * Build the <system-reminder> user prompt that extracts durable facts from a
+ * batch of recent model-visible messages into structured memory writes.
+ * @param surfaceMessageCount - how many model-visible surface events (user/message
+ *   + assistant/message + tool/result) this run reviews.
+ * @param memoryDir - the memory directory the reported files belong to.
+ * @param existingIndex - a prior topic manifest, if any.
+ * @returns the prompt text.
+ */
+export function buildExtractionPrompt(surfaceMessageCount, memoryDir, existingIndex) {
+    return [
+        `Extract durable memories from the last ${surfaceMessageCount} messages of this conversation and report them via the \`structured_output\` tool.`,
+        'A memory is a fact or preference that will be useful in FUTURE conversations, not ephemeral task detail.',
+        `Return \`{ "writes": [{ "path", "content" }] }\`: each entry is one file in the memory directory \`${memoryDir}\` — \`path\` is a flat \`.md\` filename (no directories), \`content\` is the complete file body. The plugin writes the files for you; you have no write tools.`,
+        'Write each memory to its own `.md` topic file with YAML frontmatter: name, description, and type (`user` | `feedback` | `project` | `reference`).',
+        `Add or update a one-line pointer in \`${ENTRYPOINT_NAME}\` for each topic (.md). Do not put memory bodies in the index.`,
+        'Never duplicate a topic listed under "Existing topics" below; prefer updating the matching topic file instead of creating a new one (read it first).',
+        `You may use only: ${MEMORY_AGENT_TOOLS.join(', ')}. Read only inside \`${memoryDir}\`.`,
+        'The conversation to review is already in your context — do not open files or browse directories outside the memory directory.',
+        'If the reviewed messages contain no new durable fact worth remembering, return an empty `writes` array and finish immediately.',
+        '',
+        'Existing topics:',
+        existingIndex.length > 0 ? existingIndex : '(none yet)',
+    ].join('\n');
+}
+/**
+ * Build the <system-reminder> user prompt that reviews past sessions and
+ * consolidates them into the memory directory, returned as structured writes.
+ * @param memoryDir - the memory directory being rewritten.
+ * @param transcriptDir - the directory holding past session transcripts.
+ * @param sessionHints - a list of session ids to review.
+ * @returns the prompt text.
+ */
+export function buildConsolidationPrompt(memoryDir, transcriptDir, sessionHints) {
+    return [
+        `You are consolidating persistent memory from past sessions. Review the sessions listed below (transcripts in \`${transcriptDir}\`), distill durable facts, and rewrite the memory directory \`${memoryDir}\`.`,
+        'The memory directory contains MEMORY.md (an index of topic files) and topic `.md` files with YAML frontmatter (name, description, type).',
+        'Return the complete rewritten file set via the `structured_output` tool as `{ "writes": [{ "path", "content" }] }` — flat `.md` filenames with complete bodies. Only the files you return are written; omitted files stay unchanged on disk.',
+        `Rewrite \`${ENTRYPOINT_NAME}\` to be a concise index (one line per topic) and keep topic files organized by semantic topic, not chronology.`,
+        'Remove memories that are wrong or outdated from the index. Do not drop a fact that is still load-bearing.',
+        `You may use only: ${MEMORY_AGENT_TOOLS.join(', ')}.`,
+        '',
+        'Sessions since the last consolidation:',
+        ...sessionHints.map(id => `- ${id}`),
+    ].join('\n');
+}
+//# sourceMappingURL=prompts.js.map

package/lib/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C,wEAAwE;AACxE,MAAM,eAAe,GAAG,WAAW,CAAA;AAEnC;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,mBAA2B,EAC3B,SAAiB,EACjB,aAAqB;IAErB,OAAO;QACL,0CAA0C,mBAAmB,oFAAoF;QACjJ,0GAA0G;QAC1G,sGAAsG,SAAS,iKAAiK;QAChR,mJAAmJ;QACnJ,yCAAyC,eAAe,iEAAiE;QACzH,sJAAsJ;QACtJ,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,SAAS,KAAK;QACxF,+HAA+H;QAC/H,gIAAgI;QAChI,EAAE;QACF,kBAAkB;QAClB,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY;KACxD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAiB,EACjB,aAAqB,EACrB,YAA+B;IAE/B,OAAO;QACL,kHAAkH,aAAa,kEAAkE,SAAS,KAAK;QAC/M,0IAA0I;QAC1I,8OAA8O;QAC9O,aAAa,eAAe,iHAAiH;QAC7I,2GAA2G;QAC3G,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACrD,EAAE;QACF,wCAAwC;QACxC,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;KACrC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/lib/tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Model-facing tool restrictions for memory subagents.
+ *
+ * Extraction and dream forks REVIEW broadly but hold no write capability: the
+ * memory directory lives outside the session workspace, so model-side writes
+ * are fenced by the fs sandbox with no escalation path from a background job.
+ * Instead the forks report their file set through the driver-injected
+ * `structured_output` tool and the plugin performs the writes host-side (see
+ * `writeback.ts`). `structured_output` is allow-listed defensively: the driver
+ * installs it AFTER the tool filter is applied, so a name-level filter must
+ * not shadow it.
+ *
+ * `read_image` pairs with `read` to mirror Claude Code's `Read`, which covers
+ * both text and images (the harness splits image reading into its own tool).
+ * @module @dsh-cc/memory-consolidation/tools
+ */
+/** Harness tool names a memory subagent may exercise. */
+export declare const MEMORY_AGENT_TOOLS: readonly string[];
+/** A `toolFilter` value usable as a subagent-start request restriction. */
+export declare const MEMORY_TOOL_FILTER: {
+    allow: readonly string[];
+};
+//# sourceMappingURL=tools.d.ts.map

package/lib/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAM/C,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,EAAE;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAE1D,CAAA"}

package/lib/tools.js

@@ -0,0 +1,29 @@
+/**
+ * Model-facing tool restrictions for memory subagents.
+ *
+ * Extraction and dream forks REVIEW broadly but hold no write capability: the
+ * memory directory lives outside the session workspace, so model-side writes
+ * are fenced by the fs sandbox with no escalation path from a background job.
+ * Instead the forks report their file set through the driver-injected
+ * `structured_output` tool and the plugin performs the writes host-side (see
+ * `writeback.ts`). `structured_output` is allow-listed defensively: the driver
+ * installs it AFTER the tool filter is applied, so a name-level filter must
+ * not shadow it.
+ *
+ * `read_image` pairs with `read` to mirror Claude Code's `Read`, which covers
+ * both text and images (the harness splits image reading into its own tool).
+ * @module @dsh-cc/memory-consolidation/tools
+ */
+/** Harness tool names a memory subagent may exercise. */
+export const MEMORY_AGENT_TOOLS = [
+    'read',
+    'read_image',
+    'grep',
+    'glob',
+    'structured_output',
+];
+/** A `toolFilter` value usable as a subagent-start request restriction. */
+export const MEMORY_TOOL_FILTER = {
+    allow: MEMORY_AGENT_TOOLS,
+};
+//# sourceMappingURL=tools.js.map

package/lib/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,MAAM;IACN,YAAY;IACZ,MAAM;IACN,MAAM;IACN,mBAAmB;CACpB,CAAA;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D,KAAK,EAAE,kBAAkB;CAC1B,CAAA"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@dsh-cc/memory-consolidation",
+  "description": "Background memory consolidation: turn-end extraction and three-gate dream rewrite",
+  "version": "0.5.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dsh-cc/dsh-cc.git",
+    "directory": "packages/memory/memory-consolidation"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-agent": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-fs": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-home-paths": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-invariants": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-jobs": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-subagent": ">=0.1.1-rc.2",
+    "@deepseek-ai/cordis": ">=0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "dependencies": {
+    "@dsh-cc/memory": "^0.5.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "link:../../../../deepseek-harness/vendor/cordis",
+    "@deepseek-ai/dsh-invariants": "link:../../../../deepseek-harness/packages/runtime-diagnostics/invariants",
+    "@deepseek-ai/schemastery": "link:../../../../deepseek-harness/vendor/schemastery",
+    "@deepseek-ai/dsh-agent": "link:../../../../deepseek-harness/packages/core/agent",
+    "@deepseek-ai/dsh-fs": "link:../../../../deepseek-harness/packages/fs/fs",
+    "@deepseek-ai/dsh-home-paths": "link:../../../../deepseek-harness/packages/util/home-paths",
+    "@deepseek-ai/dsh-jobs": "link:../../../../deepseek-harness/packages/jobs/jobs",
+    "@deepseek-ai/dsh-session": "link:../../../../deepseek-harness/packages/core/session",
+    "@deepseek-ai/dsh-subagent": "link:../../../../deepseek-harness/packages/subagent/subagent"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}