@openacme/memory 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Utkarsh Kanwat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/freshness.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Stale-memory mitigation. CC `memdir/memoryAge.ts` lift. Human age
+ * strings (not ISO) because models are poor at date arithmetic — "47
+ * days ago" triggers staleness reasoning that a raw timestamp doesn't.
+ */
+/** Floor-rounded days since mtime. Future mtimes clamp to 0. */
+export declare function memoryAgeDays(mtimeMs: number): number;
+export declare function memoryAge(mtimeMs: number): string;
+/** Plain-text caveat for entries >1 day old. Recall blocks use this
+ *  inside their own wrapper; standalone callers want `memoryFreshnessNote`. */
+export declare function memoryFreshnessText(mtimeMs: number): string;
+/** Wrapped variant for `view` of standalone entry files. */
+export declare function memoryFreshnessNote(mtimeMs: number): string;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../src/freshness.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;+EAC+E;AAC/E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI3D"}

package/dist/freshness.js

@@ -0,0 +1,37 @@
+/**
+ * Stale-memory mitigation. CC `memdir/memoryAge.ts` lift. Human age
+ * strings (not ISO) because models are poor at date arithmetic — "47
+ * days ago" triggers staleness reasoning that a raw timestamp doesn't.
+ */
+const ONE_DAY_MS = 86_400_000;
+/** Floor-rounded days since mtime. Future mtimes clamp to 0. */
+export function memoryAgeDays(mtimeMs) {
+    return Math.max(0, Math.floor((Date.now() - mtimeMs) / ONE_DAY_MS));
+}
+export function memoryAge(mtimeMs) {
+    const d = memoryAgeDays(mtimeMs);
+    if (d === 0)
+        return "today";
+    if (d === 1)
+        return "yesterday";
+    return `${d} days ago`;
+}
+/** Plain-text caveat for entries >1 day old. Recall blocks use this
+ *  inside their own wrapper; standalone callers want `memoryFreshnessNote`. */
+export function memoryFreshnessText(mtimeMs) {
+    const d = memoryAgeDays(mtimeMs);
+    if (d <= 1)
+        return "";
+    return (`This memory is ${d} days old. ` +
+        `Memories are point-in-time observations, not live state — ` +
+        `claims about code behavior or file:line citations may be outdated. ` +
+        `Verify against current code before asserting as fact.`);
+}
+/** Wrapped variant for `view` of standalone entry files. */
+export function memoryFreshnessNote(mtimeMs) {
+    const text = memoryFreshnessText(mtimeMs);
+    if (!text)
+        return "";
+    return `<system-reminder>${text}</system-reminder>\n`;
+}
+//# sourceMappingURL=freshness.js.map

package/dist/freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../src/freshness.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAChC,OAAO,GAAG,CAAC,WAAW,CAAC;AACzB,CAAC;AAED;+EAC+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,CACL,kBAAkB,CAAC,aAAa;QAChC,4DAA4D;QAC5D,qEAAqE;QACrE,uDAAuD,CACxD,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,oBAAoB,IAAI,sBAAsB,CAAC;AACxD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { MemoryStore, DEFAULT_MEMORY_CHAR_LIMIT, type IndexSnapshot, } from "./store.js";
+export { memoryAge, memoryAgeDays, memoryFreshnessNote, memoryFreshnessText, } from "./freshness.js";
+export { scanMemoryFiles, formatMemoryManifest, parseFrontmatterDescription, type MemoryHeader, } from "./scan.js";
+export { scanMemoryContent, type ScanResult } from "./threat-scanner.js";
+export { MEMORY_THREAT_PATTERNS, INVISIBLE_CHARS } from "./threat-patterns.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { MemoryStore, DEFAULT_MEMORY_CHAR_LIMIT, } from "./store.js";
+export { memoryAge, memoryAgeDays, memoryFreshnessNote, memoryFreshnessText, } from "./freshness.js";
+export { scanMemoryFiles, formatMemoryManifest, parseFrontmatterDescription, } from "./scan.js";
+export { scanMemoryContent } from "./threat-scanner.js";
+export { MEMORY_THREAT_PATTERNS, INVISIBLE_CHARS } from "./threat-patterns.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,yBAAyB,GAE1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,2BAA2B,GAE5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAmB,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/scan.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Memory-directory scan + manifest formatting. Shared by the recall
+ * selector and the extractor. CC `memdir/memoryScan.ts` lift; we drop
+ * the type taxonomy and parse `description` via a tight regex (keeps
+ * @openacme/memory dependency-free).
+ */
+export interface MemoryHeader {
+    /** Path relative to memoryDir. */
+    filename: string;
+    /** Absolute filesystem path. */
+    filePath: string;
+    mtimeMs: number;
+    description: string | null;
+}
+declare function readHead(filePath: string, maxLines: number): Promise<string>;
+/** Pull the `description` field out of YAML frontmatter, if present. */
+export declare function parseFrontmatterDescription(head: string): string | null;
+/** Recursive scan, sorted newest-first, capped at MAX_MEMORY_FILES.
+ *  Best-effort: per-file read failures dropped silently. */
+export declare function scanMemoryFiles(memoryDir: string, signal?: AbortSignal): Promise<MemoryHeader[]>;
+/** Format: `- <filename> (<iso-ts>): <description?>` per line. */
+export declare function formatMemoryManifest(headers: MemoryHeader[]): string;
+export declare const __test: {
+    readHead: typeof readHead;
+    MAX_MEMORY_FILES: number;
+    FRONTMATTER_MAX_LINES: number;
+};
+export {};
+//# sourceMappingURL=scan.d.ts.map

package/dist/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,iBAAe,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B3E;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUvE;AAED;4DAC4D;AAC5D,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAuCzB;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CASpE;AAED,eAAO,MAAM,MAAM;;;;CAAwD,CAAC"}

package/dist/scan.js

@@ -0,0 +1,108 @@
+/**
+ * Memory-directory scan + manifest formatting. Shared by the recall
+ * selector and the extractor. CC `memdir/memoryScan.ts` lift; we drop
+ * the type taxonomy and parse `description` via a tight regex (keeps
+ * @openacme/memory dependency-free).
+ */
+import { readdir, stat } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { createReadStream } from "node:fs";
+const MAX_MEMORY_FILES = 200;
+const FRONTMATTER_MAX_LINES = 30;
+const INDEX_FILE = "MEMORY.md";
+async function readHead(filePath, maxLines) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let lines = 0;
+        let buf = "";
+        const stream = createReadStream(filePath, { encoding: "utf-8" });
+        let settled = false;
+        const finish = (s) => {
+            if (settled)
+                return;
+            settled = true;
+            stream.destroy();
+            resolve(s);
+        };
+        stream.on("data", (chunk) => {
+            buf += chunk;
+            let idx;
+            while ((idx = buf.indexOf("\n")) >= 0 && lines < maxLines) {
+                chunks.push(buf.slice(0, idx + 1));
+                buf = buf.slice(idx + 1);
+                lines++;
+            }
+            if (lines >= maxLines)
+                finish(chunks.join(""));
+        });
+        stream.on("end", () => finish(chunks.join("") + buf));
+        stream.on("error", (e) => {
+            if (settled)
+                return;
+            settled = true;
+            reject(e);
+        });
+    });
+}
+/** Pull the `description` field out of YAML frontmatter, if present. */
+export function parseFrontmatterDescription(head) {
+    if (!head.startsWith("---"))
+        return null;
+    const close = head.indexOf("\n---", 3);
+    if (close < 0)
+        return null;
+    const block = head.slice(3, close);
+    // Tolerate optional surrounding quotes.
+    const m = /^description:\s*(?:"([^"]*)"|'([^']*)'|(.*))\s*$/m.exec(block);
+    if (!m)
+        return null;
+    const v = (m[1] ?? m[2] ?? m[3] ?? "").trim();
+    return v.length > 0 ? v : null;
+}
+/** Recursive scan, sorted newest-first, capped at MAX_MEMORY_FILES.
+ *  Best-effort: per-file read failures dropped silently. */
+export async function scanMemoryFiles(memoryDir, signal) {
+    let entries;
+    try {
+        entries = await readdir(memoryDir, { recursive: true });
+    }
+    catch {
+        return [];
+    }
+    if (signal?.aborted)
+        return [];
+    const candidates = entries.filter((f) => f.endsWith(".md") &&
+        basename(f) !== INDEX_FILE &&
+        !f.split("/").some((seg) => seg.startsWith(".")));
+    const results = await Promise.allSettled(candidates.map(async (rel) => {
+        const filePath = join(memoryDir, rel);
+        const [head, st] = await Promise.all([
+            readHead(filePath, FRONTMATTER_MAX_LINES),
+            stat(filePath),
+        ]);
+        return {
+            filename: rel,
+            filePath,
+            mtimeMs: st.mtimeMs,
+            description: parseFrontmatterDescription(head),
+        };
+    }));
+    return results
+        .filter((r) => r.status === "fulfilled")
+        .map((r) => r.value)
+        .sort((a, b) => b.mtimeMs - a.mtimeMs)
+        .slice(0, MAX_MEMORY_FILES);
+}
+/** Format: `- <filename> (<iso-ts>): <description?>` per line. */
+export function formatMemoryManifest(headers) {
+    return headers
+        .map((m) => {
+        const ts = new Date(m.mtimeMs).toISOString();
+        return m.description
+            ? `- ${m.filename} (${ts}): ${m.description}`
+            : `- ${m.filename} (${ts})`;
+    })
+        .join("\n");
+}
+export const __test = { readHead, MAX_MEMORY_FILES, FRONTMATTER_MAX_LINES };
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Per-agent persistent memory store — directory-backed, six-op shape
+ * matching Anthropic's `memory_20250818` tool spec.
+ *
+ * Layout per agent:
+ *
+ *   <agentsDir>/<agentId>/memory/
+ *     MEMORY.md            ← always-injected index of one-line pointers
+ *     <topic>.md           ← agent-created entry files (read on demand)
+ *     <subdir>/<topic>.md  ← agent-organized; we don't enforce layout
+ *
+ * Tool calls reference paths in the agent's virtual view: `/memories/...`.
+ * The store translates to filesystem paths internally and rejects anything
+ * that escapes the per-agent root (path-traversal protection per Anthropic
+ * security note).
+ *
+ * Concurrency: per-agent in-process async mutex serializes
+ * read-modify-write. Cross-process safety is NOT provided — atomic rename
+ * keeps readers consistent, and we assume one process owns a given dataDir
+ * at a time.
+ *
+ * Caps:
+ *   - Per-file line cap = 999,999 (Anthropic spec verbatim).
+ *   - MEMORY.md index has a write-time char cap (`memoryCharLimit`,
+ *     default 2200 — Hermes default). Writes that would push it over
+ *     return OpenAcme's existing guidance string ("Memory at X/Y
+ *     chars. ...Replace or remove existing entries first.") so the
+ *     agent has consolidation pressure rather than infinite append.
+ *   - Per-entry files have NO char cap (they're not auto-injected;
+ *     only the per-file line cap applies).
+ *
+ * Return strings: each op returns the EXACT string Anthropic specifies
+ * (line-number format, directory listing format, error wording). Models
+ * are trained against those literals; matching them is what makes
+ * `memory_20250818`-trained behavior carry over without prompt
+ * engineering.
+ */
+/** Hermes default. Single source of truth for the index char cap. */
+export declare const DEFAULT_MEMORY_CHAR_LIMIT = 2200;
+export interface IndexSnapshot {
+    /** Raw `MEMORY.md` content, untruncated. Empty string if the file is
+     *  missing or empty. */
+    content: string;
+    /** Byte length of `content`. */
+    used: number;
+    /** Configured char cap (write-time). */
+    limit: number;
+    /** Number of `.md` files under `<agentDir>/memory/` excluding
+     *  `MEMORY.md` itself. Used by prompt builder to decide when to append
+     *  Anthropic's "keep your memory folder organized" instruction. */
+    entryCount: number;
+}
+declare function formatBytes(n: number): string;
+/** Format a 1-indexed line number in 6-char right-aligned form (Anthropic). */
+declare function fmtLineNo(n: number): string;
+/** Render file contents with Anthropic's line-number format. */
+declare function withLineNumbers(content: string): string;
+/**
+ * Per-agent memory store. One instance per `agentsDir` — multiple
+ * instances with different roots get independent mutex maps, which
+ * matters for tests and multi-tenant deployments.
+ */
+export declare class MemoryStore {
+    readonly agentsDir: string;
+    private readonly inFlight;
+    constructor(agentsDir: string);
+    /** Absolute path to an agent's memory directory. Does not create it. */
+    dirPath(agentId: string): string;
+    /** Absolute path to the index file for an agent. Does not create it. */
+    indexPath(agentId: string): string;
+    /**
+     * Translate a virtual `/memories/...` path (as the agent sees it) to
+     * an absolute filesystem path under `<agentsDir>/<agentId>/memory/`.
+     * Rejects:
+     *   - Paths not starting with `/memories`
+     *   - URL-encoded traversal sequences (`%2e%2e%2f`, etc.)
+     *   - Resolved paths that escape the per-agent root
+     *
+     * Returns the absolute path on success, or an error string in the
+     * same wording Anthropic uses for "path does not exist" so the model
+     * sees a familiar shape.
+     */
+    private translatePath;
+    /** True if the virtual path points at the index file specifically. */
+    private isIndexPath;
+    /**
+     * Snapshot of the agent's index for system-prompt injection.
+     * Synchronous; safe for render paths. Counts entry files for the
+     * prompt builder's "cluttered memory" trigger.
+     */
+    readIndex(agentId: string, charLimit: number): IndexSnapshot;
+    /**
+     * `view` — show directory contents (2 levels deep) or file contents
+     * with optional line range. For entry files (anything other than
+     * `MEMORY.md`) older than 1 day, prepends `memoryFreshnessNote`.
+     *
+     * Synchronous; no mutex needed (read-only).
+     */
+    view(agentId: string, virtualPath: string, viewRange?: readonly [number, number]): string;
+    /**
+     * Directory listing in Anthropic's format, adapted for OpenAcme:
+     * the `node_modules` exclusion clause from the upstream spec is
+     * dropped because OpenAcme's memory dir can never contain one (no
+     * shell access, no package manager runs against it). We still
+     * exclude hidden dotfiles so internal artifacts (future
+     * coordination locks, sidecar state) stay out of the agent's view.
+     */
+    private viewDirectory;
+    /**
+     * `create` — create a new file. Errors if a file already exists at
+     * the target path. For writes targeting `MEMORY.md`, enforces the
+     * write-time char cap with OpenAcme's guidance string. For all
+     * files, enforces the 999,999-line cap.
+     */
+    create(agentId: string, virtualPath: string, fileText: string, indexCharLimit?: number): Promise<string>;
+    /**
+     * `str_replace` — replace `oldStr` with `newStr` in a file. Errors
+     * on missing file, missing match, or multiple matches (Anthropic's
+     * exact wording).
+     */
+    strReplace(agentId: string, virtualPath: string, oldStr: string, newStr: string, indexCharLimit?: number): Promise<string>;
+    /**
+     * `insert` — insert text at a specific line in a file. `insertLine` is
+     * 0-indexed in Anthropic's spec (0 = before first line, N = after last).
+     */
+    insert(agentId: string, virtualPath: string, insertLine: number, insertText: string, indexCharLimit?: number): Promise<string>;
+    /**
+     * `delete` — recursively delete a file or directory. Anthropic's spec
+     * says "Deletes the directory and all its contents recursively" so
+     * we use `rm -rf` semantics for directories.
+     */
+    delete(agentId: string, virtualPath: string): Promise<string>;
+    /**
+     * `rename` — move or rename a file/directory. Errors if source is
+     * missing or destination already exists (no overwrite).
+     */
+    rename(agentId: string, oldVirtualPath: string, newVirtualPath: string): Promise<string>;
+    /** Atomic write — tmp file + fsync + rename. */
+    private writeFileAtomic;
+    /**
+     * Per-agent mutex. Map stores only the settle-completion of each
+     * outstanding write, never its rejection — so a thrown error inside
+     * one writer can't poison the chain for the next.
+     */
+    private withMutex;
+}
+export declare const __test: {
+    withLineNumbers: typeof withLineNumbers;
+    formatBytes: typeof formatBytes;
+    fmtLineNo: typeof fmtLineNo;
+};
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAmBH,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAQ9C,MAAM,WAAW,aAAa;IAC5B;4BACwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd;;uEAEmE;IACnE,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,iBAAS,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtC;AAED,+EAA+E;AAC/E,iBAAS,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpC;AAED,gEAAgE;AAChE,iBAAS,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGhD;AAiCD;;;;GAIG;AACH,qBAAa,WAAW;IAGV,QAAQ,CAAC,SAAS,EAAE,MAAM;IAFtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;gBAExC,SAAS,EAAE,MAAM;IAItC,wEAAwE;IACxE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAShC,wEAAwE;IACxE,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIlC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IA8CrB,sEAAsE;IACtE,OAAO,CAAC,WAAW;IASnB;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa;IAiC5D;;;;;;OAMG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM;IAoET;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IA2DrB;;;;;OAKG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC;IAqClB;;;;OAIG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC;IAkElB;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC;IAwDlB;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BnE;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;IA6BlB,gDAAgD;YAClC,eAAe;IAiC7B;;;;OAIG;YACW,SAAS;CAYxB;AAGD,eAAO,MAAM,MAAM;;;;CAA8C,CAAC"}

package/dist/store.js

@@ -0,0 +1,620 @@
+/**
+ * Per-agent persistent memory store — directory-backed, six-op shape
+ * matching Anthropic's `memory_20250818` tool spec.
+ *
+ * Layout per agent:
+ *
+ *   <agentsDir>/<agentId>/memory/
+ *     MEMORY.md            ← always-injected index of one-line pointers
+ *     <topic>.md           ← agent-created entry files (read on demand)
+ *     <subdir>/<topic>.md  ← agent-organized; we don't enforce layout
+ *
+ * Tool calls reference paths in the agent's virtual view: `/memories/...`.
+ * The store translates to filesystem paths internally and rejects anything
+ * that escapes the per-agent root (path-traversal protection per Anthropic
+ * security note).
+ *
+ * Concurrency: per-agent in-process async mutex serializes
+ * read-modify-write. Cross-process safety is NOT provided — atomic rename
+ * keeps readers consistent, and we assume one process owns a given dataDir
+ * at a time.
+ *
+ * Caps:
+ *   - Per-file line cap = 999,999 (Anthropic spec verbatim).
+ *   - MEMORY.md index has a write-time char cap (`memoryCharLimit`,
+ *     default 2200 — Hermes default). Writes that would push it over
+ *     return OpenAcme's existing guidance string ("Memory at X/Y
+ *     chars. ...Replace or remove existing entries first.") so the
+ *     agent has consolidation pressure rather than infinite append.
+ *   - Per-entry files have NO char cap (they're not auto-injected;
+ *     only the per-file line cap applies).
+ *
+ * Return strings: each op returns the EXACT string Anthropic specifies
+ * (line-number format, directory listing format, error wording). Models
+ * are trained against those literals; matching them is what makes
+ * `memory_20250818`-trained behavior carry over without prompt
+ * engineering.
+ */
+import { randomBytes } from "node:crypto";
+import * as fs from "node:fs";
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { memoryFreshnessNote } from "./freshness.js";
+// ── Constants ──────────────────────────────────────────────────────────
+const MEMORIES_ROOT = "/memories";
+const MEMORY_DIR = "memory";
+const INDEX_FILE = "MEMORY.md";
+const TMP_PREFIX = ".mem_";
+/** Per-file line cap (Anthropic spec). */
+const MAX_FILE_LINES = 999_999;
+/** Hermes default. Single source of truth for the index char cap. */
+export const DEFAULT_MEMORY_CHAR_LIMIT = 2200;
+/** Same constraint agent-store uses; duplicated here so this module stays
+ * independent of `@openacme/config`. */
+const SAFE_ID = /^[A-Za-z0-9][A-Za-z0-9_.-]*$/;
+// ── Pure helpers ───────────────────────────────────────────────────────
+function formatBytes(n) {
+    if (n < 1024)
+        return `${n}`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)}K`;
+    if (n < 1024 * 1024 * 1024)
+        return `${(n / 1024 / 1024).toFixed(1)}M`;
+    return `${(n / 1024 / 1024 / 1024).toFixed(1)}G`;
+}
+/** Format a 1-indexed line number in 6-char right-aligned form (Anthropic). */
+function fmtLineNo(n) {
+    return String(n).padStart(6, " ");
+}
+/** Render file contents with Anthropic's line-number format. */
+function withLineNumbers(content) {
+    const lines = content.length === 0 ? [""] : content.split("\n");
+    return lines.map((line, i) => `${fmtLineNo(i + 1)}\t${line}`).join("\n");
+}
+/** Find ALL line numbers (1-indexed) where `needle` appears in `haystack`. */
+function findOccurrenceLines(haystack, needle) {
+    const lines = [];
+    let from = 0;
+    while (true) {
+        const idx = haystack.indexOf(needle, from);
+        if (idx < 0)
+            break;
+        // 1-indexed line number of the occurrence start
+        const lineNo = haystack.slice(0, idx).split("\n").length;
+        lines.push(lineNo);
+        from = idx + needle.length;
+    }
+    return lines;
+}
+/** Count occurrences of `needle` in `haystack`. */
+function countOccurrences(haystack, needle) {
+    if (needle.length === 0)
+        return 0;
+    let count = 0;
+    let from = 0;
+    while (true) {
+        const idx = haystack.indexOf(needle, from);
+        if (idx < 0)
+            break;
+        count++;
+        from = idx + needle.length;
+    }
+    return count;
+}
+// ── MemoryStore ────────────────────────────────────────────────────────
+/**
+ * Per-agent memory store. One instance per `agentsDir` — multiple
+ * instances with different roots get independent mutex maps, which
+ * matters for tests and multi-tenant deployments.
+ */
+export class MemoryStore {
+    agentsDir;
+    inFlight = new Map();
+    constructor(agentsDir) {
+        this.agentsDir = agentsDir;
+    }
+    // ── Path helpers ─────────────────────────────────────────────────────
+    /** Absolute path to an agent's memory directory. Does not create it. */
+    dirPath(agentId) {
+        if (!SAFE_ID.test(agentId)) {
+            throw new Error(`Invalid agent id ${JSON.stringify(agentId)}: must match ${SAFE_ID}`);
+        }
+        return path.join(this.agentsDir, agentId, MEMORY_DIR);
+    }
+    /** Absolute path to the index file for an agent. Does not create it. */
+    indexPath(agentId) {
+        return path.join(this.dirPath(agentId), INDEX_FILE);
+    }
+    /**
+     * Translate a virtual `/memories/...` path (as the agent sees it) to
+     * an absolute filesystem path under `<agentsDir>/<agentId>/memory/`.
+     * Rejects:
+     *   - Paths not starting with `/memories`
+     *   - URL-encoded traversal sequences (`%2e%2e%2f`, etc.)
+     *   - Resolved paths that escape the per-agent root
+     *
+     * Returns the absolute path on success, or an error string in the
+     * same wording Anthropic uses for "path does not exist" so the model
+     * sees a familiar shape.
+     */
+    translatePath(agentId, virtualPath) {
+        if (typeof virtualPath !== "string" || virtualPath.length === 0) {
+            return {
+                ok: false,
+                error: `The path ${virtualPath} does not exist. Please provide a valid path.`,
+            };
+        }
+        // Reject URL-encoded traversal before any normalization
+        const lowered = virtualPath.toLowerCase();
+        if (lowered.includes("%2e") || lowered.includes("%2f") || lowered.includes("%5c")) {
+            return {
+                ok: false,
+                error: `The path ${virtualPath} does not exist. Please provide a valid path.`,
+            };
+        }
+        if (!virtualPath.startsWith(MEMORIES_ROOT)) {
+            return {
+                ok: false,
+                error: `The path ${virtualPath} does not exist. Please provide a valid path.`,
+            };
+        }
+        // Strip /memories prefix; remainder may be "" (root), "/foo", "/foo/bar.md"
+        const remainder = virtualPath.slice(MEMORIES_ROOT.length);
+        if (remainder.length > 0 && !remainder.startsWith("/")) {
+            // e.g. /memoriesfoo — not actually under /memories
+            return {
+                ok: false,
+                error: `The path ${virtualPath} does not exist. Please provide a valid path.`,
+            };
+        }
+        const root = this.dirPath(agentId);
+        const abs = path.resolve(root, "." + remainder);
+        // Defense in depth: ensure the resolved path is still under root.
+        const rel = path.relative(root, abs);
+        if (rel.startsWith("..") || path.isAbsolute(rel)) {
+            return {
+                ok: false,
+                error: `The path ${virtualPath} does not exist. Please provide a valid path.`,
+            };
+        }
+        return { ok: true, abs };
+    }
+    /** True if the virtual path points at the index file specifically. */
+    isIndexPath(virtualPath) {
+        return (virtualPath === `${MEMORIES_ROOT}/${INDEX_FILE}` ||
+            virtualPath === `${MEMORIES_ROOT}/${INDEX_FILE}/`);
+    }
+    // ── Index accessor (for prompt builder) ──────────────────────────────
+    /**
+     * Snapshot of the agent's index for system-prompt injection.
+     * Synchronous; safe for render paths. Counts entry files for the
+     * prompt builder's "cluttered memory" trigger.
+     */
+    readIndex(agentId, charLimit) {
+        const indexFile = this.indexPath(agentId);
+        let content = "";
+        try {
+            content = fs.readFileSync(indexFile, "utf-8");
+        }
+        catch (e) {
+            if (e.code !== "ENOENT")
+                throw e;
+        }
+        const trimmed = content.trim();
+        const used = trimmed.length;
+        // Walk the dir for entry files (non-recursive — rare but possible
+        // sub-dirs are counted under the prompt-builder's "cluttered" cap
+        // via reading the same scan elsewhere; for the simple count signal
+        // a flat enumeration is enough).
+        let entryCount = 0;
+        const dir = this.dirPath(agentId);
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const e of entries) {
+                if (e.isFile() && e.name.endsWith(".md") && e.name !== INDEX_FILE) {
+                    entryCount++;
+                }
+            }
+        }
+        catch (e) {
+            if (e.code !== "ENOENT")
+                throw e;
+        }
+        return { content: trimmed, used, limit: charLimit, entryCount };
+    }
+    // ── view ─────────────────────────────────────────────────────────────
+    /**
+     * `view` — show directory contents (2 levels deep) or file contents
+     * with optional line range. For entry files (anything other than
+     * `MEMORY.md`) older than 1 day, prepends `memoryFreshnessNote`.
+     *
+     * Synchronous; no mutex needed (read-only).
+     */
+    view(agentId, virtualPath, viewRange) {
+        const t = this.translatePath(agentId, virtualPath);
+        if (!t.ok)
+            return t.error;
+        const abs = t.abs;
+        // Special case: viewing the root `/memories` of an agent that hasn't
+        // touched memory yet. Return the empty-listing form rather than
+        // "does not exist" — matches Anthropic's example (the header is
+        // emitted even for empty memory dirs) and matches the agent's
+        // mental model that the dir always exists.
+        const isRoot = virtualPath === MEMORIES_ROOT || virtualPath === `${MEMORIES_ROOT}/`;
+        let stat;
+        try {
+            stat = fs.statSync(abs);
+        }
+        catch (e) {
+            if (e.code === "ENOENT") {
+                if (isRoot)
+                    return this.viewDirectory(agentId, virtualPath, abs);
+                return `The path ${virtualPath} does not exist. Please provide a valid path.`;
+            }
+            throw e;
+        }
+        if (stat.isDirectory()) {
+            return this.viewDirectory(agentId, virtualPath, abs);
+        }
+        // File path. Read content; honor optional view_range.
+        let raw;
+        try {
+            raw = fs.readFileSync(abs, "utf-8");
+        }
+        catch (e) {
+            if (e.code === "ENOENT") {
+                return `The path ${virtualPath} does not exist. Please provide a valid path.`;
+            }
+            throw e;
+        }
+        const lines = raw.split("\n");
+        if (lines.length > MAX_FILE_LINES) {
+            return `File ${virtualPath} exceeds maximum line limit of 999,999 lines.`;
+        }
+        let displayLines = lines;
+        let startOffset = 0;
+        if (viewRange) {
+            const [from, to] = viewRange;
+            const start = Math.max(1, from) - 1;
+            const end = to <= 0 ? lines.length : Math.min(lines.length, to);
+            displayLines = lines.slice(start, end);
+            startOffset = start;
+        }
+        const numbered = displayLines
+            .map((line, i) => `${fmtLineNo(i + 1 + startOffset)}\t${line}`)
+            .join("\n");
+        const header = `Here's the content of ${virtualPath} with line numbers:`;
+        let out = `${header}\n${numbered}`;
+        // Freshness wrap for entry files (not the index).
+        if (!this.isIndexPath(virtualPath)) {
+            const note = memoryFreshnessNote(stat.mtimeMs);
+            if (note.length > 0)
+                out = note + out;
+        }
+        return out;
+    }
+    /**
+     * Directory listing in Anthropic's format, adapted for OpenAcme:
+     * the `node_modules` exclusion clause from the upstream spec is
+     * dropped because OpenAcme's memory dir can never contain one (no
+     * shell access, no package manager runs against it). We still
+     * exclude hidden dotfiles so internal artifacts (future
+     * coordination locks, sidecar state) stay out of the agent's view.
+     */
+    viewDirectory(agentId, virtualPath, absRoot) {
+        const lines = [
+            `Here're the files and directories up to 2 levels deep in ${virtualPath}, excluding hidden items:`,
+        ];
+        // Root entry — total size of contents at depth ≤ 2.
+        let rootBytes = 0;
+        const out = [];
+        const collect = (currentAbs, currentVirtual, depth) => {
+            if (depth > 2)
+                return;
+            let dirents;
+            try {
+                dirents = fs.readdirSync(currentAbs, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const d of dirents) {
+                if (d.name.startsWith("."))
+                    continue;
+                const childAbs = path.join(currentAbs, d.name);
+                const childVirtual = `${currentVirtual}/${d.name}`;
+                if (d.isDirectory()) {
+                    out.push({ virtual: childVirtual, bytes: 0 });
+                    collect(childAbs, childVirtual, depth + 1);
+                }
+                else if (d.isFile()) {
+                    let size = 0;
+                    try {
+                        size = fs.statSync(childAbs).size;
+                    }
+                    catch {
+                        // ignore — listing should not fail because one file vanished
+                    }
+                    out.push({ virtual: childVirtual, bytes: size });
+                    rootBytes += size;
+                }
+            }
+        };
+        // Ensure the dir exists; if not, fabricate an empty listing rather
+        // than erroring (Anthropic's example shows the root header even when
+        // there are no children — empty memory dir is normal).
+        if (fs.existsSync(absRoot)) {
+            collect(absRoot, virtualPath.replace(/\/$/, ""), 1);
+        }
+        lines.push(`${formatBytes(rootBytes)}\t${virtualPath.replace(/\/$/, "")}`);
+        for (const e of out) {
+            lines.push(`${formatBytes(e.bytes)}\t${e.virtual}`);
+        }
+        return lines.join("\n");
+    }
+    // ── create ───────────────────────────────────────────────────────────
+    /**
+     * `create` — create a new file. Errors if a file already exists at
+     * the target path. For writes targeting `MEMORY.md`, enforces the
+     * write-time char cap with OpenAcme's guidance string. For all
+     * files, enforces the 999,999-line cap.
+     */
+    async create(agentId, virtualPath, fileText, indexCharLimit) {
+        const t = this.translatePath(agentId, virtualPath);
+        if (!t.ok)
+            return t.error;
+        const abs = t.abs;
+        return this.withMutex(agentId, async () => {
+            // Existence check
+            try {
+                await fsp.stat(abs);
+                return `Error: File ${virtualPath} already exists`;
+            }
+            catch (e) {
+                if (e.code !== "ENOENT")
+                    throw e;
+            }
+            const lineCount = fileText.split("\n").length;
+            if (lineCount > MAX_FILE_LINES) {
+                return `File ${virtualPath} exceeds maximum line limit of 999,999 lines.`;
+            }
+            // Write-time cap on MEMORY.md
+            if (this.isIndexPath(virtualPath) && typeof indexCharLimit === "number") {
+                if (fileText.trim().length > indexCharLimit) {
+                    return (`Memory at 0/${indexCharLimit} chars. Adding this entry ` +
+                        `(${fileText.trim().length} chars) would exceed the limit. ` +
+                        `Replace or remove existing entries first.`);
+                }
+            }
+            await this.writeFileAtomic(abs, fileText);
+            return `File created successfully at: ${virtualPath}`;
+        });
+    }
+    // ── str_replace ──────────────────────────────────────────────────────
+    /**
+     * `str_replace` — replace `oldStr` with `newStr` in a file. Errors
+     * on missing file, missing match, or multiple matches (Anthropic's
+     * exact wording).
+     */
+    async strReplace(agentId, virtualPath, oldStr, newStr, indexCharLimit) {
+        const t = this.translatePath(agentId, virtualPath);
+        if (!t.ok)
+            return `Error: ${t.error}`;
+        const abs = t.abs;
+        return this.withMutex(agentId, async () => {
+            let stat;
+            try {
+                stat = await fsp.stat(abs);
+            }
+            catch (e) {
+                if (e.code === "ENOENT") {
+                    return `Error: The path ${virtualPath} does not exist. Please provide a valid path.`;
+                }
+                throw e;
+            }
+            // Directory passed → "file does not exist" error per Anthropic spec
+            if (stat.isDirectory()) {
+                return `Error: The path ${virtualPath} does not exist. Please provide a valid path.`;
+            }
+            const content = await fsp.readFile(abs, "utf-8");
+            const occurrences = countOccurrences(content, oldStr);
+            if (occurrences === 0) {
+                return `No replacement was performed, old_str \`${oldStr}\` did not appear verbatim in ${virtualPath}.`;
+            }
+            if (occurrences > 1) {
+                const lineNos = findOccurrenceLines(content, oldStr);
+                return `No replacement was performed. Multiple occurrences of old_str \`${oldStr}\` in lines: ${lineNos.join(", ")}. Please ensure it is unique`;
+            }
+            const next = content.replace(oldStr, newStr);
+            // Line-cap check on the result
+            if (next.split("\n").length > MAX_FILE_LINES) {
+                return `File ${virtualPath} exceeds maximum line limit of 999,999 lines.`;
+            }
+            // Write-time cap on MEMORY.md
+            if (this.isIndexPath(virtualPath) && typeof indexCharLimit === "number") {
+                const newLen = next.trim().length;
+                const oldLen = content.trim().length;
+                if (newLen > indexCharLimit) {
+                    return (`Memory at ${oldLen}/${indexCharLimit} chars. Replacement would push it to ` +
+                        `${newLen}/${indexCharLimit}. Shorten or remove other entries first.`);
+                }
+            }
+            await this.writeFileAtomic(abs, next);
+            // Return success + a snippet-with-line-numbers per Anthropic spec
+            const snippetLineNo = content.slice(0, content.indexOf(oldStr)).split("\n").length;
+            const snippetLines = next.split("\n");
+            const start = Math.max(0, snippetLineNo - 3);
+            const end = Math.min(snippetLines.length, snippetLineNo + 5);
+            const snippet = snippetLines
+                .slice(start, end)
+                .map((line, i) => `${fmtLineNo(i + 1 + start)}\t${line}`)
+                .join("\n");
+            return `The memory file has been edited.\n${snippet}`;
+        });
+    }
+    // ── insert ───────────────────────────────────────────────────────────
+    /**
+     * `insert` — insert text at a specific line in a file. `insertLine` is
+     * 0-indexed in Anthropic's spec (0 = before first line, N = after last).
+     */
+    async insert(agentId, virtualPath, insertLine, insertText, indexCharLimit) {
+        const t = this.translatePath(agentId, virtualPath);
+        if (!t.ok)
+            return `Error: ${t.error}`;
+        const abs = t.abs;
+        return this.withMutex(agentId, async () => {
+            let stat;
+            try {
+                stat = await fsp.stat(abs);
+            }
+            catch (e) {
+                if (e.code === "ENOENT") {
+                    return `Error: The path ${virtualPath} does not exist`;
+                }
+                throw e;
+            }
+            if (stat.isDirectory()) {
+                return `Error: The path ${virtualPath} does not exist`;
+            }
+            const content = await fsp.readFile(abs, "utf-8");
+            const lines = content.split("\n");
+            const nLines = lines.length;
+            if (insertLine < 0 || insertLine > nLines) {
+                return `Error: Invalid \`insert_line\` parameter: ${insertLine}. It should be within the range of lines of the file: [0, ${nLines}]`;
+            }
+            // Splice in insertText (treated as a single block — caller is
+            // responsible for trailing newlines if they want a clean break).
+            const next = [
+                ...lines.slice(0, insertLine),
+                insertText,
+                ...lines.slice(insertLine),
+            ].join("\n");
+            if (next.split("\n").length > MAX_FILE_LINES) {
+                return `File ${virtualPath} exceeds maximum line limit of 999,999 lines.`;
+            }
+            if (this.isIndexPath(virtualPath) && typeof indexCharLimit === "number") {
+                const newLen = next.trim().length;
+                const oldLen = content.trim().length;
+                if (newLen > indexCharLimit) {
+                    return (`Memory at ${oldLen}/${indexCharLimit} chars. Insertion would push it to ` +
+                        `${newLen}/${indexCharLimit}. Shorten or remove other entries first.`);
+                }
+            }
+            await this.writeFileAtomic(abs, next);
+            return `The file ${virtualPath} has been edited.`;
+        });
+    }
+    // ── delete ───────────────────────────────────────────────────────────
+    /**
+     * `delete` — recursively delete a file or directory. Anthropic's spec
+     * says "Deletes the directory and all its contents recursively" so
+     * we use `rm -rf` semantics for directories.
+     */
+    async delete(agentId, virtualPath) {
+        const t = this.translatePath(agentId, virtualPath);
+        if (!t.ok)
+            return `Error: ${t.error}`;
+        const abs = t.abs;
+        return this.withMutex(agentId, async () => {
+            let stat;
+            try {
+                stat = await fsp.stat(abs);
+            }
+            catch (e) {
+                if (e.code === "ENOENT") {
+                    return `Error: The path ${virtualPath} does not exist`;
+                }
+                throw e;
+            }
+            if (stat.isDirectory()) {
+                await fsp.rm(abs, { recursive: true, force: true });
+            }
+            else {
+                await fsp.unlink(abs);
+            }
+            return `Successfully deleted ${virtualPath}`;
+        });
+    }
+    // ── rename ───────────────────────────────────────────────────────────
+    /**
+     * `rename` — move or rename a file/directory. Errors if source is
+     * missing or destination already exists (no overwrite).
+     */
+    async rename(agentId, oldVirtualPath, newVirtualPath) {
+        const t1 = this.translatePath(agentId, oldVirtualPath);
+        if (!t1.ok)
+            return `Error: ${t1.error.replace("does not exist. Please provide a valid path.", "does not exist")}`;
+        const t2 = this.translatePath(agentId, newVirtualPath);
+        if (!t2.ok)
+            return `Error: ${t2.error.replace("does not exist. Please provide a valid path.", "does not exist")}`;
+        return this.withMutex(agentId, async () => {
+            try {
+                await fsp.stat(t1.abs);
+            }
+            catch (e) {
+                if (e.code === "ENOENT") {
+                    return `Error: The path ${oldVirtualPath} does not exist`;
+                }
+                throw e;
+            }
+            try {
+                await fsp.stat(t2.abs);
+                return `Error: The destination ${newVirtualPath} already exists`;
+            }
+            catch (e) {
+                if (e.code !== "ENOENT")
+                    throw e;
+            }
+            await fsp.mkdir(path.dirname(t2.abs), { recursive: true });
+            await fsp.rename(t1.abs, t2.abs);
+            return `Successfully renamed ${oldVirtualPath} to ${newVirtualPath}`;
+        });
+    }
+    // ── Internals ────────────────────────────────────────────────────────
+    /** Atomic write — tmp file + fsync + rename. */
+    async writeFileAtomic(absPath, content) {
+        const dir = path.dirname(absPath);
+        await fsp.mkdir(dir, { recursive: true });
+        const tmp = path.join(dir, `${TMP_PREFIX}${randomBytes(8).toString("hex")}.tmp`);
+        let fh = null;
+        try {
+            fh = await fsp.open(tmp, "w");
+            await fh.writeFile(content, "utf-8");
+            await fh.sync();
+            await fh.close();
+            fh = null;
+            await fsp.rename(tmp, absPath);
+        }
+        catch (e) {
+            if (fh) {
+                try {
+                    await fh.close();
+                }
+                catch {
+                    // ignore
+                }
+            }
+            try {
+                await fsp.unlink(tmp);
+            }
+            catch {
+                // ignore — best-effort cleanup
+            }
+            throw e;
+        }
+    }
+    /**
+     * Per-agent mutex. Map stores only the settle-completion of each
+     * outstanding write, never its rejection — so a thrown error inside
+     * one writer can't poison the chain for the next.
+     */
+    async withMutex(agentId, work) {
+        const prev = this.inFlight.get(agentId) ?? Promise.resolve();
+        const result = prev.then(work, work);
+        this.inFlight.set(agentId, result.then(() => undefined, () => undefined));
+        return result;
+    }
+}
+// Export so tests can verify the line-numbering helper.
+export const __test = { withLineNumbers, formatBytes, fmtLineNo };
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/dist/threat-patterns.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Threat-pattern data for the memory scanner. Ported verbatim from Hermes
+ * `tools/memory_tool.py:67-89`. Kept in its own file (no logic) so the
+ * pattern set is easy to audit and update independently of the scanner.
+ *
+ * `re.IGNORECASE` becomes the JS `i` flag; the regex syntax itself is
+ * identical (no Python-only features in these patterns).
+ */
+export declare const MEMORY_THREAT_PATTERNS: ReadonlyArray<readonly [RegExp, string]>;
+export declare const INVISIBLE_CHARS: ReadonlySet<string>;
+//# sourceMappingURL=threat-patterns.d.ts.map

package/dist/threat-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threat-patterns.d.ts","sourceRoot":"","sources":["../src/threat-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAmB3E,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAW9C,CAAC"}

package/dist/threat-patterns.js

@@ -0,0 +1,41 @@
+/**
+ * Threat-pattern data for the memory scanner. Ported verbatim from Hermes
+ * `tools/memory_tool.py:67-89`. Kept in its own file (no logic) so the
+ * pattern set is easy to audit and update independently of the scanner.
+ *
+ * `re.IGNORECASE` becomes the JS `i` flag; the regex syntax itself is
+ * identical (no Python-only features in these patterns).
+ */
+export const MEMORY_THREAT_PATTERNS = [
+    // Prompt injection
+    [/ignore\s+(previous|all|above|prior)\s+instructions/i, "prompt_injection"],
+    [/you\s+are\s+now\s+/i, "role_hijack"],
+    [/do\s+not\s+tell\s+the\s+user/i, "deception_hide"],
+    [/system\s+prompt\s+override/i, "sys_prompt_override"],
+    [/disregard\s+(your|all|any)\s+(instructions|rules|guidelines)/i, "disregard_rules"],
+    [
+        /act\s+as\s+(if|though)\s+you\s+(have\s+no|don't\s+have)\s+(restrictions|limits|rules)/i,
+        "bypass_restrictions",
+    ],
+    // Exfiltration via curl/wget with secrets
+    [/curl\s+[^\n]*\$\{?\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, "exfil_curl"],
+    [/wget\s+[^\n]*\$\{?\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, "exfil_wget"],
+    [/cat\s+[^\n]*(\.env|credentials|\.netrc|\.pgpass|\.npmrc|\.pypirc)/i, "read_secrets"],
+    // Persistence via shell rc / ssh
+    [/authorized_keys/i, "ssh_backdoor"],
+    [/\$HOME\/\.ssh|~\/\.ssh/i, "ssh_access"],
+    [/\$HOME\/\.openacme\/\.env|~\/\.openacme\/\.env/i, "openacme_env"],
+];
+export const INVISIBLE_CHARS = new Set([
+    "​",
+    "‌",
+    "‍",
+    "⁠",
+    "",
+    "‪",
+    "‫",
+    "‬",
+    "‭",
+    "‮",
+]);
+//# sourceMappingURL=threat-patterns.js.map

package/dist/threat-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threat-patterns.js","sourceRoot":"","sources":["../src/threat-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAA6C;IAC9E,mBAAmB;IACnB,CAAC,qDAAqD,EAAE,kBAAkB,CAAC;IAC3E,CAAC,qBAAqB,EAAE,aAAa,CAAC;IACtC,CAAC,+BAA+B,EAAE,gBAAgB,CAAC;IACnD,CAAC,6BAA6B,EAAE,qBAAqB,CAAC;IACtD,CAAC,+DAA+D,EAAE,iBAAiB,CAAC;IACpF;QACE,wFAAwF;QACxF,qBAAqB;KACtB;IACD,0CAA0C;IAC1C,CAAC,kEAAkE,EAAE,YAAY,CAAC;IAClF,CAAC,kEAAkE,EAAE,YAAY,CAAC;IAClF,CAAC,oEAAoE,EAAE,cAAc,CAAC;IACtF,iCAAiC;IACjC,CAAC,kBAAkB,EAAE,cAAc,CAAC;IACpC,CAAC,yBAAyB,EAAE,YAAY,CAAC;IACzC,CAAC,iDAAiD,EAAE,cAAc,CAAC;CACpE,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAS;IAClE,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;CACJ,CAAC,CAAC"}

package/dist/threat-scanner.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Memory content threat scanner.
+ *
+ * Memory entries get injected into the system prompt verbatim, so they're
+ * a privileged channel — anything that would prompt-inject the agent or
+ * exfiltrate secrets must be blocked at the gate. Scanner is a pure
+ * function over the pattern set in `./threat-patterns.ts`.
+ */
+export type ScanResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Scan content destined for MEMORY.md. Returns `{ok:true}` if safe;
+ * otherwise an error string in the same format Hermes uses (so error
+ * wording stays consistent between ports).
+ */
+export declare function scanMemoryContent(content: string): ScanResult;
+//# sourceMappingURL=threat-scanner.d.ts.map

package/dist/threat-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threat-scanner.d.ts","sourceRoot":"","sources":["../src/threat-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAqB7D"}

package/dist/threat-scanner.js

@@ -0,0 +1,35 @@
+/**
+ * Memory content threat scanner.
+ *
+ * Memory entries get injected into the system prompt verbatim, so they're
+ * a privileged channel — anything that would prompt-inject the agent or
+ * exfiltrate secrets must be blocked at the gate. Scanner is a pure
+ * function over the pattern set in `./threat-patterns.ts`.
+ */
+import { INVISIBLE_CHARS, MEMORY_THREAT_PATTERNS } from "./threat-patterns.js";
+/**
+ * Scan content destined for MEMORY.md. Returns `{ok:true}` if safe;
+ * otherwise an error string in the same format Hermes uses (so error
+ * wording stays consistent between ports).
+ */
+export function scanMemoryContent(content) {
+    for (const ch of content) {
+        if (INVISIBLE_CHARS.has(ch)) {
+            const codepoint = ch.codePointAt(0).toString(16).toUpperCase().padStart(4, "0");
+            return {
+                ok: false,
+                reason: `Blocked: content contains invisible unicode character U+${codepoint} (possible injection).`,
+            };
+        }
+    }
+    for (const [pattern, id] of MEMORY_THREAT_PATTERNS) {
+        if (pattern.test(content)) {
+            return {
+                ok: false,
+                reason: `Blocked: content matches threat pattern '${id}'. Memory entries are injected into the system prompt and must not contain injection or exfiltration payloads.`,
+            };
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=threat-scanner.js.map

package/dist/threat-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threat-scanner.js","sourceRoot":"","sources":["../src/threat-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAM/E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACjF,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,2DAA2D,SAAS,wBAAwB;aACrG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,sBAAsB,EAAE,CAAC;QACnD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,4CAA4C,EAAE,gHAAgH;aACvK,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@openacme/memory",
+  "version": "0.4.0",
+  "description": "Per-agent persistent memory for OpenAcme — bounded MEMORY.md store with atomic writes and threat scanning.",
+  "license": "MIT",
+  "author": "Utkarsh Kanwat",
+  "homepage": "https://github.com/ukanwat/OpenAcme/tree/main/packages/memory#readme",
+  "bugs": "https://github.com/ukanwat/OpenAcme/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ukanwat/OpenAcme.git",
+    "directory": "packages/memory"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "typescript": "5.9.2",
+    "vitest": "^2.1.9",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "check-types": "tsc --noEmit",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  }
+}