memdir 0.0.1 → 0.0.2

package/README.md

@@ -1,56 +1,80 @@
 # memdir
 
-File-based memory for AI agents.
+Lightweight memory manager for AI agents.
 
-Markdown is the source of truth. Embeddings are just a cache for semantic search.
+Core ideas:
+- Local-first — no network calls, no external services, private by design
+- File-based — memory is inspectable and editable
+- Embedding-based — semantic search without a vector DB
+- Plug-and-play — works with Ollama, llama.cpp, or any local LLM provider
 
-Fully local - no data leaves your machine, no dependencies, no API keys or subscriptions.
+Perfect if you’re developing small-medium agents that need to remember things across sessions without relying on vector DBs or paid services.
 
-## How it works
+## Installation
 
-`memdir` keeps two local sources of truth: facts worth remembering in `memory.md`, and chat history in daily logs. On startup, it rebuilds an in-memory semantic index from those files using the embedding model.
-
-Two storage files:
-
-- `memory.md` long-term memory
-- `YYYY-MM-DD.jsonl` past conversation logs
-
-On startup, it rebuilds an in-memory semantic index from `memory.md` and recent log files.
+```
+npm i memdir
+```
 
 ## Usage
 
-```js
+Ollama example:
+
+```ts
 import { Memory } from "memdir"
 import { Ollama } from "ollama"
-import { SOUL, AGENT } from "./systemPrompts.js"
 
 const memory = new Memory()
 const ollama = new Ollama()
 
-const { memoryPrompt, tools } = await memory.init(async (text) => {
-  const result = await ollama.embeddings({ model: "nomic-embed-text", prompt: text })
-  return result.embedding
-})
+async function embed(prompt) {
+  const { embedding } = await ollama.embeddings({
+    model: "nomic-embed-text",
+    prompt,
+  })
+  return embedding
+}
+
+const { memoryPrompt, tools } = await memory.init(embed)
+
+// Assemble the system prompt
+const systemPrompt = `You are a helpful agent. ${memoryPrompt}`
+
+let messages = [{ role: "system", content: systemPrompt }]
+```
+
+node-llama-cpp example:
+
+```ts
+import { Memory } from "memdir"
+import { getLlama } from "node-llama-cpp"
 
-const systemPrompt = `
-${SOUL}
+const memory = new Memory()
+
+const llama = await getLlama()
+const model = await llama.loadModel({ modelPath: "./models/bge-small-en-v1.5-q8_0.gguf" })
+const context = await model.createEmbeddingContext()
 
-${AGENT}
+async function embed(text) {
+  const embedding = await context.getEmbeddingFor(text)
+  return embedding.vector
+}
+const { memoryPrompt, tools } = await memory.init(embed)
 
-${memoryPrompt}
-`.trim()
+// Assemble the system prompt
+const systemPrompt = `You are a helpful agent. ${memoryPrompt}`
 
 let messages = [{ role: "system", content: systemPrompt }]
 ```
 
 `init()` returns two things to wire into your agent:
 
-- **`memoryPrompt`** — memory instructions and stored facts. Append to your own system prompt.
-- **`tools`** — `memory_write` and `memory_search` tools. Pass these to your model.
+- `memoryPrompt` — memory instructions and stored facts. Append to your own system prompt.
+- `tools` — `memory_write` and `memory_search` tools. Pass these to your model.
 
-Then after each turn:
+Then after each turn do:
 
-```js
+```ts
 messages = await memory.afterTurn(messages)
 ```
 
@@ -58,19 +82,17 @@ messages = await memory.afterTurn(messages)
 
 ### `new Memory({ dir? })`
 
-| Option | Default      | Description                          |
-| ------ | ------------ | ------------------------------------ |
-| `dir`  | `'./memory'` | Directory where all files are stored |
+Creates a new Memory instance. Accepts an optional `dir` option (default: `'./memory'`) telling where all files should be stored.
 
 ### `await memory.init(embedding)`
 
-Initialises the manager. Must be called once before anything else.
+Initializes the memory manager and builds semantic index. Must be called once before anything else.
 
-- **`embedding`** — `async (text) => number[]`
+- `embedding` — `async (text) => number[]`
 
 The embedding function must have this shape:
 
-```js
+```ts
 async function embed(text) {
   return [
     /* numbers */
@@ -82,81 +104,8 @@ Returns `{ memoryPrompt, tools }`.
 
 ### `await memory.afterTurn(messages)`
 
-Convenience helper for completed turns. It finds the latest user/assistant pair
-already present in `messages`, appends it to today's log, then runs `maybeFlush()`
-and returns the updated message array.
-
-The latest completed user and assistant messages must already be in `messages`.
+Call this after each completed turn. It appends the latest user/assistant pair to today's log, trims and refreshes the chat if it has grown past the character threshold, and returns the updated message array.
 
 ### `await memory.reindex()`
 
 Rebuilds the in-memory index from `memory.md` and recent log files. Runs automatically on `init()`. Call it manually if you edit memory files outside the library.
-
-## Tools
-
-The agent gets two tools automatically:
-
-**`memory_write`** — saves a fact to `memory.md` that should persist across future conversations.
-
-**`memory_search`** — searches past conversations and stored facts by semantic similarity. Use when the current message likely depends on prior context.
-
-Your app should assemble the final system prompt itself. A good pattern is:
-
-```js
-import { SOUL, AGENT } from "./systemPrompts.js"
-
-const systemPrompt = `
-${SOUL}
-
-${AGENT}
-
-${memoryPrompt}
-`.trim()
-```
-
-## Embeddings
-
-The library does not create embeddings for you. You should pass a function that
-turns a single string into an embedding vector.
-
-Ollama example:
-
-```js
-import { Ollama } from "ollama"
-import { Memory } from "memdir"
-import agentPrompt from "./agentPrompt.js"
-
-const memory = new Memory()
-const ollama = new Ollama()
-
-async function embed(text) {
-  const { embedding } = await ollama.embeddings({
-    model: "nomic-embed-text",
-    prompt: text,
-  })
-  return embedding
-}
-
-const { systemContent, tools } = await memory.init(agentPrompt, embed)
-```
-
-node-llama-cpp example:
-
-```js
-import { getLlama } from "node-llama-cpp"
-import { Memory } from "memdir"
-import agentPrompt from "./agentPrompt.js"
-
-const memory = new Memory()
-
-const llama = await getLlama()
-const model = await llama.loadModel({ modelPath: "./models/bge-small-en-v1.5-q8_0.gguf" })
-const context = await model.createEmbeddingContext()
-
-async function embed(text) {
-  const embedding = await context.getEmbeddingFor(text)
-  return embedding.vector
-}
-
-const { systemContent, tools } = await memory.init(agentPrompt, embed)
-```

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+type EmbedFn = (text: string) => Promise<number[]>;
+export type Message = {
+    role: string;
+    content: string;
+};
+export type InitResult = {
+    memoryPrompt: string;
+    tools: object[];
+};
+export type FlushOptions = {
+    charThreshold?: number;
+    maxHistory?: number;
+    basePrompt?: string;
+};
+export type MemoryOptions = {
+    dir?: string;
+};
+export declare class Memory {
+    #private;
+    constructor({ dir }?: MemoryOptions);
+    init(embedFn: EmbedFn): Promise<InitResult>;
+    appendLog(userContent: string, assistantContent: string): Promise<void>;
+    afterTurn(messages: Message[]): Promise<Message[]>;
+    reindex(): Promise<void>;
+    maybeFlush(messages: Message[], { charThreshold, maxHistory, basePrompt, }?: FlushOptions): Promise<Message[] | null>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAQA,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AAGlD,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAYvD,MAAM,MAAM,UAAU,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAElE,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AA6G5C,qBAAa,MAAM;;gBAUL,EAAE,GAAgB,EAAE,GAAE,aAAkB;IAS9C,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAa3C,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;IAiBV,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAWlD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BxB,UAAU,CACd,QAAQ,EAAE,OAAO,EAAE,EACnB,EACE,aAAoC,EACpC,UAA8B,EAC9B,UAAe,GAChB,GAAE,YAAiB,GACnB,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;CA2R7B"}

package/dist/index.js

@@ -0,0 +1,389 @@
+import fs from "fs";
+import path from "path";
+import { createHash } from "crypto";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const FLUSH_CHAR_THRESHOLD = 24_000;
+const FLUSH_MAX_HISTORY = 50;
+const LOG_LOOKBACK_DAYS = 30;
+// ---------------------------------------------------------------------------
+// WriteQueue — serialises async mutations on a single promise chain
+// ---------------------------------------------------------------------------
+class WriteQueue {
+    #tail = Promise.resolve();
+    run(fn) {
+        const op = this.#tail.then(fn);
+        this.#tail = op.catch((err) => {
+            console.error("[WriteQueue]", err.message);
+        });
+        return op;
+    }
+}
+// ---------------------------------------------------------------------------
+// Pure helpers
+// ---------------------------------------------------------------------------
+const sha256 = (text) => createHash("sha256").update(text).digest("hex");
+function cosineSim(a, b) {
+    let dot = 0, ma = 0, mb = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        ma += a[i] * a[i];
+        mb += b[i] * b[i];
+    }
+    return ma === 0 || mb === 0 ? 0 : dot / (Math.sqrt(ma) * Math.sqrt(mb));
+}
+/**
+ * Atomic write: write to .tmp then rename into place.
+ * Falls back gracefully on Windows cross-device rename (EXDEV).
+ */
+async function atomicWrite(filePath, content) {
+    const tmp = `${filePath}.tmp`;
+    await fs.promises.writeFile(tmp, content, "utf-8");
+    try {
+        await fs.promises.rename(tmp, filePath);
+    }
+    catch (err) {
+        if (err.code !== "EXDEV")
+            throw err;
+        await fs.promises.writeFile(filePath, content, "utf-8");
+        await fs.promises.unlink(tmp).catch(() => { });
+    }
+}
+async function readSafe(filePath) {
+    try {
+        return await fs.promises.readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return "";
+        throw err;
+    }
+}
+function parseJsonl(text) {
+    return text
+        .split("\n")
+        .filter(Boolean)
+        .flatMap((line) => {
+        try {
+            return [JSON.parse(line)];
+        }
+        catch {
+            console.warn("[memory] skipping malformed line:", line.slice(0, 80));
+            return [];
+        }
+    });
+}
+function dateStr(offsetDays = 0) {
+    const d = new Date();
+    d.setDate(d.getDate() + offsetDays);
+    return d.toISOString().slice(0, 10);
+}
+function assertEmbedding(embedding) {
+    if (!Array.isArray(embedding)) {
+        throw new Error("embedding function must return a number[]");
+    }
+    return embedding;
+}
+function resolveEmbed(embed) {
+    if (typeof embed !== "function") {
+        throw new TypeError("init() requires an embedFn: async (text) => number[]");
+    }
+    return async (texts) => Promise.all(texts.map(async (text) => assertEmbedding(await embed(text))));
+}
+// ---------------------------------------------------------------------------
+// Memory
+// ---------------------------------------------------------------------------
+export class Memory {
+    #dir;
+    #memoryFile;
+    #embed = null;
+    #index = [];
+    #queue = new WriteQueue();
+    #indexQueue = new WriteQueue();
+    constructor({ dir = "./memory" } = {}) {
+        this.#dir = path.resolve(dir);
+        this.#memoryFile = path.join(this.#dir, "memory.md");
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    async init(embedFn) {
+        this.#embed = resolveEmbed(embedFn);
+        await fs.promises.mkdir(this.#dir, { recursive: true });
+        await this.reindex();
+        const memory = await this.#readMemory();
+        return {
+            memoryPrompt: this.#buildSystemContent(memory),
+            tools: this.#buildTools(),
+        };
+    }
+    async appendLog(userContent, assistantContent) {
+        this.#embedder; // guard
+        const entry = {
+            ts: new Date().toISOString(),
+            user: userContent,
+            assistant: assistantContent,
+        };
+        const file = path.join(this.#dir, `${dateStr()}.jsonl`);
+        await this.#queue.run(() => fs.promises.appendFile(file, JSON.stringify(entry) + "\n", "utf-8"));
+        await this.#indexText(this.#logEntryToText(entry), "log", dateStr());
+    }
+    async afterTurn(messages) {
+        this.#embedder; // guard
+        const exchange = this.#latestExchange(messages);
+        if (exchange) {
+            await this.appendLog(exchange.user, exchange.assistant);
+        }
+        return (await this.maybeFlush(messages)) ?? messages;
+    }
+    async reindex() {
+        this.#embedder; // guard
+        const [logChunks, memoryChunks] = await Promise.all([
+            this.#collectLogChunks(),
+            this.#collectMemoryChunks(),
+        ]);
+        const unique = [
+            ...new Map([...memoryChunks, ...logChunks].map((entry) => [entry.id, entry])).values(),
+        ];
+        await this.#indexQueue.run(async () => {
+            if (unique.length === 0) {
+                this.#index = [];
+                return;
+            }
+            const embeddings = await this.#embedder(unique.map((entry) => entry.text));
+            this.#index = unique.map((entry, i) => ({
+                ...entry,
+                embedding: embeddings[i],
+            }));
+        });
+    }
+    async maybeFlush(messages, { charThreshold = FLUSH_CHAR_THRESHOLD, maxHistory = FLUSH_MAX_HISTORY, basePrompt = "", } = {}) {
+        this.#embedder; // guard
+        if (messages.length === 0)
+            return null;
+        const totalChars = messages.reduce((n, m) => n + (m.content?.length ?? 0), 0);
+        if (totalChars < charThreshold)
+            return null;
+        const memory = await this.#readMemory();
+        const memoryPrompt = this.#buildSystemContent(memory);
+        const systemContent = [basePrompt, memoryPrompt]
+            .filter(Boolean)
+            .join("\n\n");
+        const system = { ...messages[0], content: systemContent };
+        const rest = messages.slice(1);
+        const tail = maxHistory > 1 ? rest.slice(-(maxHistory - 1)) : [];
+        return [system, ...tail];
+    }
+    // -------------------------------------------------------------------------
+    // Private: embedder guard
+    // -------------------------------------------------------------------------
+    get #embedder() {
+        if (!this.#embed) {
+            throw new Error("Memory not initialised — call init() first");
+        }
+        return this.#embed;
+    }
+    // -------------------------------------------------------------------------
+    // Private: memory.md
+    // -------------------------------------------------------------------------
+    #readMemory() {
+        return readSafe(this.#memoryFile);
+    }
+    async #writeMemory(content) {
+        const bullet = content.trim().startsWith("-")
+            ? content.trim()
+            : `- ${content.trim()}`;
+        await this.#queue.run(async () => {
+            const existing = await this.#readMemory();
+            const updated = existing
+                ? `${existing.trimEnd()}\n${bullet}\n`
+                : `${bullet}\n`;
+            await atomicWrite(this.#memoryFile, updated);
+        });
+        await this.#indexText(bullet, "memory");
+    }
+    // -------------------------------------------------------------------------
+    // Private: log helpers
+    // -------------------------------------------------------------------------
+    #logEntryToText({ ts, user, assistant }) {
+        return `[${ts}] user: ${user}\n[${ts}] assistant: ${assistant}`;
+    }
+    #latestExchange(messages) {
+        let assistant = null;
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const message = messages[i];
+            if (assistant === null &&
+                message?.role === "assistant" &&
+                typeof message.content === "string" &&
+                message.content.trim()) {
+                assistant = message.content;
+                continue;
+            }
+            if (assistant !== null &&
+                message?.role === "user" &&
+                typeof message.content === "string" &&
+                message.content.trim()) {
+                return { user: message.content, assistant };
+            }
+        }
+        return null;
+    }
+    async #collectLogChunks() {
+        let files;
+        try {
+            files = await fs.promises.readdir(this.#dir);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return [];
+            throw err;
+        }
+        const chunks = await Promise.all(files
+            .filter((f) => /^\d{4}-\d{2}-\d{2}\.jsonl$/.test(f))
+            .filter((f) => f.replace(".jsonl", "") >= dateStr(-LOG_LOOKBACK_DAYS))
+            .map(async (file) => {
+            const date = file.replace(".jsonl", "");
+            const content = await readSafe(path.join(this.#dir, file));
+            return parseJsonl(content).flatMap((entry) => {
+                if (typeof entry?.ts !== "string" ||
+                    typeof entry?.user !== "string" ||
+                    typeof entry?.assistant !== "string") {
+                    return [];
+                }
+                const logEntry = {
+                    ts: entry.ts,
+                    user: entry.user,
+                    assistant: entry.assistant,
+                };
+                const text = this.#logEntryToText(logEntry);
+                return [{ text, id: sha256(text), date, source: "log" }];
+            });
+        }));
+        return chunks.flat();
+    }
+    async #collectMemoryChunks() {
+        const content = await this.#readMemory();
+        return content
+            .split("\n")
+            .filter((l) => l.trim().startsWith("-"))
+            .map((bullet) => ({
+            text: bullet.trim(),
+            id: sha256(bullet.trim()),
+            source: "memory",
+        }));
+    }
+    async #indexText(text, source, date) {
+        await this.#indexQueue.run(async () => {
+            const id = sha256(text);
+            if (this.#index.some((entry) => entry.id === id))
+                return;
+            const [embedding] = await this.#embedder([text]);
+            this.#index = [...this.#index, { id, text, date, source, embedding }];
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Private: system prompt
+    // -------------------------------------------------------------------------
+    #buildSystemContent(memory) {
+        const memorySection = memory
+            ? `## Profile Memory\n\n${memory}\n\nProfile memory contains only stable facts across conversations. Do not surface it unless directly relevant to the current reply.`
+            : null;
+        const whenToAccess = [
+            "## When to access memories",
+            "- When memories seem relevant, or the user references prior-conversation work.",
+            "- You MUST use memory_search when the user explicitly asks you to check, recall, or remember.",
+            "- If the user says to ignore or not use memory: proceed as if memory were empty. Do not apply remembered facts, cite, compare against, or mention memory content.",
+            "- Memory records can become stale over time. Use memory as context for what was true at a given point in time. Before answering based solely on a memory, verify it is still correct. If a recalled memory conflicts with what you observe now, trust what you observe — and update or remove the stale memory.",
+        ].join("\n");
+        const beforeRecommending = [
+            "## Before recommending from memory",
+            "A memory that names a specific function, file, or flag is a claim that it existed when the memory was written. It may have been renamed, removed, or never merged. Before recommending it:",
+            "- If the user is about to act on your recommendation (not just asking about history), verify first.",
+            '"The memory says X exists" is not the same as "X exists now."',
+        ].join("\n");
+        const whenToSave = [
+            "## When to save memories",
+            "Save immediately when you learn something worth remembering — do not wait for the user to ask. Save when:",
+            "- You learn details about the user's role, preferences, responsibilities, or knowledge",
+            "- The user corrects your approach or confirms a non-obvious approach worked — include why, so edge cases can be judged later",
+            "- You learn about ongoing work, goals, or deadlines not derivable from the conversation",
+            "- The user explicitly asks you to remember something",
+            "Do not save:",
+            "- Ephemeral details: in-progress work, temporary state, or summaries of the current turn",
+            "- Guesses, assumptions, or one-off topics",
+        ].join("\n");
+        return [memorySection, whenToSave, whenToAccess, beforeRecommending]
+            .filter(Boolean)
+            .join("\n\n");
+    }
+    // -------------------------------------------------------------------------
+    // Private: tools
+    // -------------------------------------------------------------------------
+    #buildTools() {
+        return [
+            {
+                name: "memory_write",
+                description: "Save a fact about the user that is worth remembering.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        content: {
+                            type: "string",
+                            description: 'A single concise sentence. State only what was explicitly said — no inference, no editorializing. For behavioral guidance, add the reason after a dash: "Prefers concise responses — finds long explanations condescending."',
+                        },
+                    },
+                    required: ["content"],
+                },
+                function: async ({ content }) => {
+                    await this.#writeMemory(content);
+                    return "Memory saved.";
+                },
+            },
+            {
+                name: "memory_search",
+                description: "Search past conversations and stored facts by semantic similarity. " +
+                    "Call this only when the current message likely depends on prior context — " +
+                    "for example the user refers to a past conversation, an ongoing project, a saved " +
+                    "preference, or an unresolved task. Do not call it for greetings, acknowledgements, " +
+                    "or standalone factual questions.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "Natural language description of what you want to recall.",
+                        },
+                        k: {
+                            type: "number",
+                            description: "Number of results to return (default 5, max 20).",
+                        },
+                    },
+                    required: ["query"],
+                },
+                function: async ({ query, k = 5 }) => {
+                    if (this.#index.length === 0)
+                        return "No history indexed yet.";
+                    const [queryEmbedding] = await this.#embedder([query]);
+                    const safeK = Math.min(Math.max(1, k), 20);
+                    const results = this.#index
+                        .filter((e) => e.embedding?.length)
+                        .map((e) => ({
+                        ...e,
+                        score: cosineSim(queryEmbedding, e.embedding),
+                    }))
+                        .sort((a, b) => b.score - a.score)
+                        .slice(0, safeK);
+                    if (results.length === 0)
+                        return "No relevant history found.";
+                    return results
+                        .map((e) => e.date
+                        ? `[${e.source} / ${e.date}]\n${e.text}`
+                        : `[${e.source}]\n${e.text}`)
+                        .join("\n\n---\n\n");
+                },
+            },
+        ];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "memdir",
-  "version": "0.0.1",
-  "description": "File-based memory for AI agents.",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "files": ["index.js", "index.d.ts"],
+  "version": "0.0.2",
+  "description": "Lightweight memory manager for AI agents.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "tsc"
+  },
   "repository": {
     "type": "git",
     "url": "git+ssh://git@github.com/artiebits/memdir.git"
@@ -16,5 +22,9 @@
     "ai-memory",
     "semantic-search",
     "llm"
-  ]
+  ],
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  }
 }

package/index.d.ts

@@ -1,30 +0,0 @@
-export type EmbedFn = (text: string) => Promise<number[]>
-
-export type Message = {
-  role: string
-  content: string
-}
-
-export type InitResult = {
-  memoryPrompt: string
-  tools: object[]
-}
-
-export type FlushOptions = {
-  charThreshold?: number
-  maxHistory?: number
-  basePrompt?: string
-}
-
-export type MemoryOptions = {
-  dir?: string
-}
-
-export class Memory {
-  constructor(opts?: MemoryOptions)
-  init(embedFn: EmbedFn): Promise<InitResult>
-  appendLog(userContent: string, assistantContent: string): Promise<void>
-  afterTurn(messages: Message[]): Promise<Message[]>
-  reindex(): Promise<void>
-  maybeFlush(messages: Message[], opts?: FlushOptions): Promise<Message[] | null>
-}

package/index.js

@@ -1,532 +0,0 @@
-/**
- * memdir — agent memory management
- *
- * Directory layout:
- *   memory/
- *     memory.md          — long-term facts (human-readable markdown bullets)
- *     YYYY-MM-DD.jsonl   — daily conversation logs (one JSON entry per line)
- *
- * Usage:
- *   const memory = new Memory()
- *   const { systemContent, tools } = await memory.init(agentPrompt, async (text) => await embed(text))
- *
- *   messages = await memory.afterTurn(messages)
- *
- * @typedef {(text: string) => Promise<number[]>} EmbedFn
- * @typedef {(texts: string[]) => Promise<number[][]>} BatchEmbedFn
- * @typedef {{ role: string, content: string }} Message
- * @typedef {{ id: string, text: string, date?: string, source: 'log'|'memory', embedding?: number[] }} IndexEntry
- * @typedef {{ systemContent: string, tools: object[] }} InitResult
- */
-
-import fs from "fs"
-import path from "path"
-import { createHash } from "crypto"
-
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-
-const FLUSH_CHAR_THRESHOLD = 24_000
-const FLUSH_MAX_HISTORY = 50
-const LOG_LOOKBACK_DAYS = 30
-
-// ---------------------------------------------------------------------------
-// WriteQueue — serialises async mutations on a single promise chain
-// ---------------------------------------------------------------------------
-
-class WriteQueue {
-  #tail = Promise.resolve()
-
-  /** @param {() => Promise<void>} fn */
-  run(fn) {
-    const op = this.#tail.then(fn)
-    this.#tail = op.catch((err) => {
-      console.error("[WriteQueue]", err.message)
-    })
-    return op
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Pure helpers
-// ---------------------------------------------------------------------------
-
-/** @param {string} text @returns {string} */
-const sha256 = (text) => createHash("sha256").update(text).digest("hex")
-
-/**
- * @param {number[]} a
- * @param {number[]} b
- * @returns {number}
- */
-function cosineSim(a, b) {
-  let dot = 0,
-    ma = 0,
-    mb = 0
-  for (let i = 0; i < a.length; i++) {
-    dot += a[i] * b[i]
-    ma += a[i] * a[i]
-    mb += b[i] * b[i]
-  }
-  return ma === 0 || mb === 0 ? 0 : dot / (Math.sqrt(ma) * Math.sqrt(mb))
-}
-
-/**
- * Atomic write: write to .tmp then rename into place.
- * Falls back gracefully on Windows cross-device rename (EXDEV).
- * @param {string} filePath
- * @param {string} content
- */
-async function atomicWrite(filePath, content) {
-  const tmp = `${filePath}.tmp`
-  await fs.promises.writeFile(tmp, content, "utf-8")
-  try {
-    await fs.promises.rename(tmp, filePath)
-  } catch (err) {
-    if (err.code !== "EXDEV") throw err
-    await fs.promises.writeFile(filePath, content, "utf-8")
-    await fs.promises.unlink(tmp).catch(() => {})
-  }
-}
-
-/** @param {string} filePath @returns {Promise<string>} */
-async function readSafe(filePath) {
-  try {
-    return await fs.promises.readFile(filePath, "utf-8")
-  } catch (err) {
-    if (err.code === "ENOENT") return ""
-    throw err
-  }
-}
-
-/**
- * Parse a JSONL string, skipping malformed lines with a warning.
- * @template T
- * @param {string} text
- * @returns {T[]}
- */
-function parseJsonl(text) {
-  return text
-    .split("\n")
-    .filter(Boolean)
-    .flatMap((line) => {
-      try {
-        return [JSON.parse(line)]
-      } catch {
-        console.warn("[memory] skipping malformed line:", line.slice(0, 80))
-        return []
-      }
-    })
-}
-
-/** @param {number} offsetDays @returns {string} YYYY-MM-DD */
-function dateStr(offsetDays = 0) {
-  const d = new Date()
-  d.setDate(d.getDate() + offsetDays)
-  return d.toISOString().slice(0, 10)
-}
-
-/** @param {unknown} embedding @returns {number[]} */
-function assertEmbedding(embedding) {
-  if (!Array.isArray(embedding)) {
-    throw new Error("embedding function must return a number[]")
-  }
-  return embedding
-}
-
-/** @param {EmbedFn} embed @returns {BatchEmbedFn} */
-function resolveEmbed(embed) {
-  if (typeof embed !== "function") {
-    throw new TypeError("init() requires an embedFn: async (text) => number[]")
-  }
-  return async (texts) => Promise.all(texts.map(async (text) => assertEmbedding(await embed(text))))
-}
-
-// ---------------------------------------------------------------------------
-// Memory
-// ---------------------------------------------------------------------------
-
-export class Memory {
-  #dir
-  #memoryFile // <dir>/memory.md
-
-  /** @type {BatchEmbedFn|null} */
-  #embed = null
-  /** @type {IndexEntry[]} */
-  #index = []
-
-  #queue = new WriteQueue()
-  #indexQueue = new WriteQueue()
-
-  /** @param {{ dir?: string }} opts */
-  constructor({ dir = "./memory" } = {}) {
-    this.#dir = path.resolve(dir)
-    this.#memoryFile = path.join(this.#dir, "memory.md")
-  }
-
-  // -------------------------------------------------------------------------
-  // Public API
-  // -------------------------------------------------------------------------
-
-  /**
-   * Initialise the manager. Must be called once before anything else.
-   *
-   * @param {EmbedFn} embedFn
-   * @returns {Promise<{ memoryPrompt: string, tools: object[] }>}
-   */
-  async init(embedFn) {
-    this.#embed = resolveEmbed(embedFn)
-
-    await fs.promises.mkdir(this.#dir, { recursive: true })
-    await this.reindex()
-
-    const memory = await this.#readMemory()
-    return {
-      memoryPrompt: this.#buildSystemContent(memory),
-      tools: this.#buildTools(),
-    }
-  }
-
-  /**
-   * Append one exchange to today's JSONL log.
-   * Write is serialised through the queue, then the in-memory index is updated.
-   * Throws on write or indexing failure — callers should handle.
-   *
-   * @param {string} userContent
-   * @param {string} assistantContent
-   */
-  async appendLog(userContent, assistantContent) {
-    this.#assertReady()
-
-    const entry = {
-      ts: new Date().toISOString(),
-      user: userContent,
-      assistant: assistantContent,
-    }
-    const file = path.join(this.#dir, `${dateStr()}.jsonl`)
-
-    await this.#queue.run(() => fs.promises.appendFile(file, JSON.stringify(entry) + "\n", "utf-8"))
-
-    await this.#indexText(this.#logEntryToText(entry), "log", dateStr())
-  }
-
-  /**
-   * Convenience helper for completed turns. Logs the latest user/assistant pair
-   * already present in messages, then flushes if needed.
-   *
-   * @param {Message[]} messages
-   * @returns {Promise<Message[]>}
-   */
-  async afterTurn(messages) {
-    this.#assertReady()
-
-    const exchange = this.#latestExchange(messages)
-    if (exchange) {
-      await this.appendLog(exchange.user, exchange.assistant)
-    }
-
-    return (await this.maybeFlush(messages)) ?? messages
-  }
-
-  /**
-   * Rebuild the in-memory index from memory.md and recent log files.
-   */
-  async reindex() {
-    this.#assertReady()
-
-    const [logChunks, memoryChunks] = await Promise.all([this.#collectLogChunks(), this.#collectMemoryChunks()])
-
-    const unique = [...new Map([...memoryChunks, ...logChunks].map((entry) => [entry.id, entry])).values()]
-
-    await this.#indexQueue.run(async () => {
-      if (unique.length === 0) {
-        this.#index = []
-        return
-      }
-
-      const embeddings = await this.#embed(unique.map((entry) => entry.text))
-      this.#index = unique.map((entry, i) => ({
-        ...entry,
-        embedding: embeddings[i],
-      }))
-    })
-  }
-
-  /**
-   * Trim the conversation if it has grown past the char threshold, refreshing
-   * the system message with the latest memory.
-   *
-   * Returns a new array when trimmed, null when no action was needed.
-   * Usage: messages = await mm.maybeFlush(messages, { basePrompt }) ?? messages
-   *
-   * @param {Message[]} messages
-   * @param {{ charThreshold?: number, maxHistory?: number, basePrompt?: string }} opts
-   * @returns {Promise<Message[] | null>}
-   */
-  async maybeFlush(messages, { charThreshold = FLUSH_CHAR_THRESHOLD, maxHistory = FLUSH_MAX_HISTORY, basePrompt = '' } = {}) {
-    this.#assertReady()
-
-    if (messages.length === 0) return null
-
-    const totalChars = messages.reduce((n, m) => n + (m.content?.length ?? 0), 0)
-    if (totalChars < charThreshold) return null
-
-    const memory = await this.#readMemory()
-    const memoryPrompt = this.#buildSystemContent(memory)
-    const systemContent = [basePrompt, memoryPrompt].filter(Boolean).join('\n\n')
-    const system = { ...messages[0], content: systemContent }
-    const rest = messages.slice(1)
-    const tail = maxHistory > 1 ? rest.slice(-(maxHistory - 1)) : []
-
-    return [system, ...tail]
-  }
-
-  // -------------------------------------------------------------------------
-  // Private: memory.md
-  // -------------------------------------------------------------------------
-
-  /** @returns {Promise<string>} */
-  #readMemory() {
-    return readSafe(this.#memoryFile)
-  }
-
-  /**
-   * Append a markdown bullet to memory.md and index it.
-   * Read-modify-write is safe because all writes go through the queue.
-   * @param {string} content
-   */
-  async #writeMemory(content) {
-    const bullet = content.trim().startsWith("-") ? content.trim() : `- ${content.trim()}`
-
-    await this.#queue.run(async () => {
-      const existing = await this.#readMemory()
-      const updated = existing ? `${existing.trimEnd()}\n${bullet}\n` : `${bullet}\n`
-      await atomicWrite(this.#memoryFile, updated)
-    })
-
-    await this.#indexText(bullet, "memory")
-  }
-
-  // -------------------------------------------------------------------------
-  // Private: log helpers
-  // -------------------------------------------------------------------------
-
-  /** @param {{ ts: string, user: string, assistant: string }} entry @returns {string} */
-  #logEntryToText({ ts, user, assistant }) {
-    return `[${ts}] user: ${user}\n[${ts}] assistant: ${assistant}`
-  }
-
-  /** @param {Message[]} messages @returns {{ user: string, assistant: string } | null} */
-  #latestExchange(messages) {
-    let assistant = null
-
-    for (let i = messages.length - 1; i >= 0; i--) {
-      const message = messages[i]
-
-      if (
-        assistant === null &&
-        message?.role === "assistant" &&
-        typeof message.content === "string" &&
-        message.content.trim()
-      ) {
-        assistant = message.content
-        continue
-      }
-
-      if (
-        assistant !== null &&
-        message?.role === "user" &&
-        typeof message.content === "string" &&
-        message.content.trim()
-      ) {
-        return { user: message.content, assistant }
-      }
-    }
-
-    return null
-  }
-
-  /** @returns {Promise<Array<{ text: string, id: string, date: string, source: 'log' }>>} */
-  async #collectLogChunks() {
-    let files
-    try {
-      files = await fs.promises.readdir(this.#dir)
-    } catch (err) {
-      if (err.code === "ENOENT") return []
-      throw err
-    }
-
-    const chunks = await Promise.all(
-      files
-        .filter((f) => /^\d{4}-\d{2}-\d{2}\.jsonl$/.test(f))
-        .filter((f) => f.replace(".jsonl", "") >= dateStr(-LOG_LOOKBACK_DAYS))
-        .map(async (file) => {
-          const date = file.replace(".jsonl", "")
-          const content = await readSafe(path.join(this.#dir, file))
-          return parseJsonl(content).flatMap((entry) => {
-            if (
-              typeof entry?.ts !== "string" ||
-              typeof entry?.user !== "string" ||
-              typeof entry?.assistant !== "string"
-            ) {
-              return []
-            }
-            const text = this.#logEntryToText(entry)
-            return [{ text, id: sha256(text), date, source: /** @type {'log'} */ ("log") }]
-          })
-        }),
-    )
-    return chunks.flat()
-  }
-
-  /** @returns {Promise<Array<{ text: string, id: string, source: 'memory' }>>} */
-  async #collectMemoryChunks() {
-    const content = await this.#readMemory()
-    return content
-      .split("\n")
-      .filter((l) => l.trim().startsWith("-"))
-      .map((bullet) => ({
-        text: bullet.trim(),
-        id: sha256(bullet.trim()),
-        source: /** @type {'memory'} */ ("memory"),
-      }))
-  }
-
-  /**
-   * Embed a single text and add it to the in-memory index if not already present.
-   * @param {string} text
-   * @param {'log'|'memory'} source
-   * @param {string=} date
-   */
-  async #indexText(text, source, date) {
-    await this.#indexQueue.run(async () => {
-      const id = sha256(text)
-      if (this.#index.some((entry) => entry.id === id)) return
-
-      const [embedding] = await this.#embed([text])
-      this.#index = [...this.#index, { id, text, date, source, embedding }]
-    })
-  }
-
-  // -------------------------------------------------------------------------
-  // Private: system prompt
-  // -------------------------------------------------------------------------
-
-  /** @param {string} memory @returns {string} */
-  #buildSystemContent(memory) {
-    const memorySection = memory
-      ? `## Profile Memory\n\n${memory}\n\nProfile memory contains only stable facts across conversations. Do not surface it unless directly relevant to the current reply.`
-      : null
-
-    const whenToAccess = [
-      "## When to access memories",
-      "- When memories seem relevant, or the user references prior-conversation work.",
-      "- You MUST use memory_search when the user explicitly asks you to check, recall, or remember.",
-      "- If the user says to ignore or not use memory: proceed as if memory were empty. Do not apply remembered facts, cite, compare against, or mention memory content.",
-      "- Memory records can become stale over time. Use memory as context for what was true at a given point in time. Before answering based solely on a memory, verify it is still correct. If a recalled memory conflicts with what you observe now, trust what you observe — and update or remove the stale memory.",
-    ].join("\n")
-
-    const beforeRecommending = [
-      "## Before recommending from memory",
-      "A memory that names a specific function, file, or flag is a claim that it existed when the memory was written. It may have been renamed, removed, or never merged. Before recommending it:",
-      "- If the user is about to act on your recommendation (not just asking about history), verify first.",
-      '"The memory says X exists" is not the same as "X exists now."',
-    ].join("\n")
-
-    const whenToSave = [
-      "## When to save memories",
-      "Save immediately when you learn something worth remembering — do not wait for the user to ask. Save when:",
-      "- You learn details about the user's role, preferences, responsibilities, or knowledge",
-      "- The user corrects your approach or confirms a non-obvious approach worked — include why, so edge cases can be judged later",
-      "- You learn about ongoing work, goals, or deadlines not derivable from the conversation",
-      "- The user explicitly asks you to remember something",
-      "Do not save:",
-      "- Ephemeral details: in-progress work, temporary state, or summaries of the current turn",
-      "- Guesses, assumptions, or one-off topics",
-    ].join("\n")
-
-    return [memorySection, whenToSave, whenToAccess, beforeRecommending]
-      .filter(Boolean)
-      .join("\n\n")
-  }
-
-  // -------------------------------------------------------------------------
-  // Private: tools
-  // -------------------------------------------------------------------------
-
-  /** @returns {object[]} */
-  #buildTools() {
-    return [
-      {
-        name: "memory_write",
-        description: "Save a fact about the user that is worth remembering.",
-        parameters: {
-          type: "object",
-          properties: {
-            content: {
-              type: "string",
-              description: "A single concise sentence. State only what was explicitly said — no inference, no editorializing. For behavioral guidance, add the reason after a dash: \"Prefers concise responses — finds long explanations condescending.\"",
-            },
-          },
-          required: ["content"],
-        },
-        function: async ({ content }) => {
-          await this.#writeMemory(content)
-          return "Memory saved."
-        },
-      },
-      {
-        name: "memory_search",
-        description:
-          "Search past conversations and stored facts by semantic similarity. " +
-          "Call this only when the current message likely depends on prior context — " +
-          "for example the user refers to a past conversation, an ongoing project, a saved " +
-          "preference, or an unresolved task. Do not call it for greetings, acknowledgements, " +
-          "or standalone factual questions.",
-        parameters: {
-          type: "object",
-          properties: {
-            query: {
-              type: "string",
-              description: "Natural language description of what you want to recall.",
-            },
-            k: {
-              type: "number",
-              description: "Number of results to return (default 5, max 20).",
-            },
-          },
-          required: ["query"],
-        },
-        function: async ({ query, k = 5 }) => {
-          if (this.#index.length === 0) return "No history indexed yet."
-
-          const [queryEmbedding] = await this.#embed([query])
-          const safeK = Math.min(Math.max(1, k), 20)
-
-          const results = this.#index
-            .filter((e) => e.embedding?.length)
-            .map((e) => ({ ...e, score: cosineSim(queryEmbedding, e.embedding) }))
-            .sort((a, b) => b.score - a.score)
-            .slice(0, safeK)
-
-          if (results.length === 0) return "No relevant history found."
-
-          return results
-            .map((e) => (e.date ? `[${e.source} / ${e.date}]\n${e.text}` : `[${e.source}]\n${e.text}`))
-            .join("\n\n---\n\n")
-        },
-      },
-    ]
-  }
-
-  // -------------------------------------------------------------------------
-  // Private: guard
-  // -------------------------------------------------------------------------
-
-  #assertReady() {
-    if (!this.#embed) {
-      throw new Error("Memory not initialised — call init() first")
-    }
-  }
-}