@alanzhao/dsh-memory-lite 0.1.1

package/lib/tools/update-memory.js

@@ -0,0 +1,46 @@
+/**
+ * The `update_memory` tool: replaces a memory's current content, archiving
+ * the previous current into its History section (ADD-only).
+ * @module dsh-memory-lite/src/tools/update-memory
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { assertNotSubagent, peerForExec } from '../tool-utils.js';
+import { normalizeContent, summaryOf } from '../memory-store.js';
+/** Register update_memory. */
+export function applyUpdateMemoryTool(ctx, deps) {
+    ctx.tools.register(defineTool({
+        name: 'update_memory',
+        description: "Replace a memory's current content with new content; the previous current content moves to its History section. Use when a memory is outdated or contradicts new facts.",
+        parameters: {
+            path: { type: 'string', required: true, description: 'Memory file path relative to the memory root, e.g. preferences/coding.md.' },
+            content: { type: 'string', required: true, description: 'The new current content of the memory.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    path: { type: 'string', required: true },
+                    content: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [
+                { type: 'text', text: `Updated ${value.path} (previous content moved to History).\n<content>\n${value.content}\n</content>` },
+            ],
+        },
+        async execute(args, exec) {
+            assertNotSubagent(exec);
+            const peer = peerForExec(exec, deps.config());
+            const content = normalizeContent(args.content);
+            if (content === '')
+                throw new Error('content must be a non-empty string');
+            await deps.store.updateCurrent(peer, args.path, content);
+            await deps.store.refreshIndexEntry(peer, args.path, summaryOf(content));
+            return { path: args.path, content };
+        },
+        presentCall(args) {
+            return { card: 'generic', title: `Update memory ${args.path}`, kind: 'edit', locations: [{ path: args.path }] };
+        },
+    }));
+}
+//# sourceMappingURL=update-memory.js.map

package/lib/tools/update-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-memory.js","sourceRoot":"","sources":["../../src/tools/update-memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGnD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEhE,8BAA8B;AAC9B,MAAM,UAAU,qBAAqB,CAAC,GAAY,EAAE,IAAgB;IAClE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5B,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,yKAAyK;QACtL,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2EAA2E,EAAE;YAClI,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wCAAwC,EAAE;SACnG;QACD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAC5C;aACF;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;gBACxB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,CAAC,IAAI,qDAAqD,KAAK,CAAC,OAAO,cAAc,EAAE;aAC9H;SACF;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;YACtB,iBAAiB,CAAC,IAAI,CAAC,CAAA;YACvB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;YAC7C,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAC9C,IAAI,OAAO,KAAK,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;YACzE,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACxD,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;YACvE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAA;QACrC,CAAC;QACD,WAAW,CAAC,IAAI;YACd,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAA;QACjH,CAAC;KACF,CAAC,CAAC,CAAA;AACL,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared type contracts for dsh-memory-lite.
+ * @module dsh-memory-lite/src/types
+ */
+/** The four memory categories the plugin generates. */
+export declare const MEMORY_CATEGORIES: readonly ["preferences", "entities", "events", "experiences"];
+/** One memory category name. */
+export type MemoryCategory = (typeof MEMORY_CATEGORIES)[number];
+/** One L0 index entry: a memory file and its one-line summary. */
+export interface IndexEntry {
+    /** First path segment of {@link path} (the containing directory). */
+    readonly category: string;
+    /** Memory file path relative to the peer's memories root, e.g. `preferences/coding.md`. */
+    readonly path: string;
+    /** One-line summary rendered in the L0 catalog. */
+    readonly summary: string;
+}
+/**
+ * Durable provider record for one published memory catalog message: the
+ * entries it published beside the model-facing prose, so a consumer never
+ * re-parses the `<system-reminder>` framing, whose prose exists for the model.
+ */
+export interface MemoryCatalogSource {
+    readonly kind: 'memory-catalog';
+    readonly form: 'catalog';
+    /** Marks a replacement catalog rather than this session's first publication. */
+    readonly update?: true;
+    /** Exactly the entries this message published, in catalog order. */
+    readonly entries: readonly IndexEntry[];
+}
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        'memory-catalog': MemoryCatalogSource;
+    }
+}

package/lib/types.js

@@ -0,0 +1,7 @@
+/**
+ * Shared type contracts for dsh-memory-lite.
+ * @module dsh-memory-lite/src/types
+ */
+/** The four memory categories the plugin generates. */
+export const MEMORY_CATEGORIES = ['preferences', 'entities', 'events', 'experiences'];
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAA"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@alanzhao/dsh-memory-lite",
+  "version": "0.1.1",
+  "description": "Lightweight zero-dependency memory plugin for DeepSeek Harness: Markdown-file memory store, L0 catalog injection, and 5 model-facing tools.",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "memory",
+    "deepseek-harness"
+  ],
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-atomic-write": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-home-paths": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.2",
+    "@deepseek-ai/dsh-agent": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-app-boot": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-tool-skill": "0.1.1-rc.2",
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2",
+    "@deepseek-ai/cordis-plugin-timer": "^1.1.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "clean": "rm -rf lib"
+  },
+  "exports": {
+    ".": {
+      "default": "./lib/index.js",
+      "types": "./lib/index.d.ts"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}