@openagentsy/memory 0.0.0-stage → 0.2.0

package/dist/store.js

@@ -0,0 +1,263 @@
+import { appendFile, mkdir, readFile, stat } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { etagOf, redact } from '@openagentsy/core';
+import { createMemoryId, isMemoryEntry, isMemoryMarker, isValidCategory, MAX_TEXT_LENGTH, normalizeText, } from './model.js';
+/**
+ * The store of what a person decided to keep.
+ *
+ * Append-only: an entry is written once and never changed. A person who
+ * forgets or verifies a memory appends a marker instead, and the view this
+ * class returns folds the markers into the entries. The file therefore only
+ * ever grows, and a line in it is never rewritten.
+ */
+export class MemoryStore {
+    root;
+    now;
+    onAudit;
+    cached;
+    constructor(options) {
+        this.root = options.root;
+        this.now = options.now ?? (() => new Date());
+        this.onAudit = options.onAudit;
+    }
+    /** The file the store lives in. */
+    get path() {
+        return join(this.root, '.openagentsy', 'memory.jsonl');
+    }
+    /**
+     * Add a memory.
+     *
+     * The redaction runs first: nothing reaches the file that carries a
+     * secret, and the count comes back with the outcome so the caller can
+     * report it. A text that is already a duplicate is refused with the id of
+     * the entry that holds it, because a memory that is already known is not
+     * a new thing.
+     */
+    async append(input) {
+        const redacted = redact(input.text);
+        const redactions = redacted.count;
+        const text = redacted.text.trim();
+        if (text.length === 0) {
+            return { ok: false, reason: 'invalid', detail: 'the text is empty', redactions };
+        }
+        if (text.length > MAX_TEXT_LENGTH) {
+            return {
+                ok: false,
+                reason: 'invalid',
+                detail: `the text is longer than ${MAX_TEXT_LENGTH} characters`,
+                redactions,
+            };
+        }
+        if (!isValidCategory(input.category)) {
+            return {
+                ok: false,
+                reason: 'invalid',
+                detail: 'the category is not a tag: a lowercase word, words joined by single hyphens',
+                redactions,
+            };
+        }
+        const { entries, tags } = await this.read();
+        const tag = etagOf(normalizeText(text));
+        for (const entry of entries) {
+            if (tags.get(entry.id) === tag) {
+                return { ok: false, reason: 'duplicate', id: entry.id, redactions };
+            }
+        }
+        const entry = {
+            id: createMemoryId(),
+            text,
+            category: input.category,
+            source: input.source,
+            confidence: input.confidence,
+            created_at: this.now().toISOString(),
+            // A memory is trusted on write (the human's decision of 2026-10-28):
+            // the archivist's judgement is the source, and a person marks a
+            // memory unverified when they disagree. The flag is what the search
+            // reads before anyone has said anything about the memory.
+            verified: input.verified ?? true,
+        };
+        await this.appendLine(entry);
+        return { ok: true, entry, redactions };
+    }
+    /** Every memory that is neither forgotten nor superseded. */
+    async entries() {
+        const { entries, markers } = await this.read();
+        const forgotten = new Set();
+        const verified = new Set();
+        for (const marker of markers) {
+            if (marker.kind === 'forget')
+                forgotten.add(marker.id);
+            else
+                verified.add(marker.id);
+        }
+        return entries
+            .filter((entry) => !forgotten.has(entry.id))
+            .map((entry) => (verified.has(entry.id) ? { ...entry, verified: true } : entry));
+    }
+    /**
+     * Find the memories that mention the terms of a query.
+     *
+     * The store is small - a target of under ten thousand entries - so the
+     * scan is over the parsed lines, and the parsed lines are cached against
+     * the file's stat, so a search that follows a search reads the file once.
+     */
+    async search(query) {
+        const entries = await this.entries();
+        const terms = termsOf(query.q);
+        const category = query.category?.toLowerCase();
+        const scored = entries
+            .filter((entry) => inCategory(entry, category))
+            .map((entry) => ({ entry, score: scoreOf(entry, terms) }))
+            .filter((result) => result.score > 0);
+        const ordering = query.ordering ?? 'lost-in-the-middle';
+        scored.sort(ordering === 'recency' ? byRecency : byRelevance);
+        const top = query.limit === undefined ? scored : scored.slice(0, query.limit);
+        return ordering === 'lost-in-the-middle' ? lostInTheMiddle(top) : top;
+    }
+    /**
+     * Forget a memory.
+     *
+     * The entry stays in the file and the store stops returning it. The
+     * removal command is a later phase; this is the path it will take, and
+     * the person who did it is on the marker.
+     */
+    async forget(id, by = 'unknown') {
+        const { entries } = await this.read();
+        if (!entries.some((entry) => entry.id === id))
+            return false;
+        await this.appendLine({ kind: 'forget', id, by, at: this.now().toISOString() });
+        await this.onAudit?.('oa.memory.forget', { id, decidedBy: by });
+        return true;
+    }
+    /**
+     * Mark a memory verified.
+     *
+     * A memory is trusted on write, and this is the other direction: a
+     * person says it is true. The archivist's label is not a verification:
+     * the archivist never looked at the memory.
+     */
+    async verify(id, decidedBy) {
+        const { entries } = await this.read();
+        if (!entries.some((entry) => entry.id === id))
+            return false;
+        await this.appendLine({ kind: 'verify', id, by: decidedBy, at: this.now().toISOString() });
+        await this.onAudit?.('oa.memory.verify', { id, decidedBy });
+        return true;
+    }
+    /** Append one line to the file. */
+    async appendLine(line) {
+        const path = this.path;
+        await mkdir(dirname(path), { recursive: true });
+        await appendFile(path, `${JSON.stringify(line)}\n`, 'utf8');
+    }
+    /**
+     * The parsed file, from the cache when the file has not changed.
+     *
+     * The key is the file's size and modification time, so a file that was
+     * appended to misses the cache and a file that was not is read once.
+     */
+    async read() {
+        const path = this.path;
+        let key;
+        try {
+            const info = await stat(path);
+            key = `${info.mtimeMs}:${info.size}`;
+        }
+        catch {
+            return { entries: [], markers: [], tags: new Map() };
+        }
+        if (this.cached?.key === key)
+            return this.cached.file;
+        const text = await readFile(path, 'utf8');
+        const entries = [];
+        const markers = [];
+        const tags = new Map();
+        for (const line of text.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed.length === 0)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(trimmed);
+            }
+            catch {
+                continue;
+            }
+            if (isMemoryEntry(parsed)) {
+                entries.push(parsed);
+                tags.set(parsed.id, etagOf(normalizeText(parsed.text)));
+            }
+            else if (isMemoryMarker(parsed)) {
+                markers.push(parsed);
+            }
+        }
+        const file = { entries, markers, tags };
+        this.cached = { key, file };
+        return file;
+    }
+}
+/** The terms of a query, lowercased. */
+function termsOf(query) {
+    return query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((term) => term.length > 0);
+}
+/** Whether an entry is in the category the query names. */
+function inCategory(entry, category) {
+    return category === undefined || entry.category.toLowerCase() === category;
+}
+/**
+ * The score of one entry against the terms of a query.
+ *
+ * A term in the text is worth more than a term in the category: the text is
+ * what the memory says, and the category only says what it is about.
+ */
+function scoreOf(entry, terms) {
+    const text = entry.text.toLowerCase();
+    const category = entry.category.toLowerCase();
+    let score = 0;
+    for (const term of terms) {
+        if (text.includes(term))
+            score += 2;
+        if (category.includes(term))
+            score += 1;
+    }
+    return score;
+}
+/** The best match first, and the newest of two equals first. */
+function byRelevance(a, b) {
+    if (b.score !== a.score)
+        return b.score - a.score;
+    if (a.entry.created_at !== b.entry.created_at) {
+        return a.entry.created_at < b.entry.created_at ? 1 : -1;
+    }
+    return a.entry.id.localeCompare(b.entry.id);
+}
+/** The newest first. */
+function byRecency(a, b) {
+    if (a.entry.created_at !== b.entry.created_at) {
+        return a.entry.created_at < b.entry.created_at ? 1 : -1;
+    }
+    return a.entry.id.localeCompare(b.entry.id);
+}
+/**
+ * The order that keeps the best results where a model looks first.
+ *
+ * A model attends to the start and the end of a context more than to the
+ * middle, so the strongest result goes first and the second strongest goes
+ * last, and the rest fill in between. The ranking is unchanged: only the
+ * positions move.
+ */
+export function lostInTheMiddle(ranked) {
+    const front = [];
+    const back = [];
+    ranked.forEach((item, index) => {
+        if (index % 2 === 0)
+            front.push(item);
+        else
+            back.push(item);
+    });
+    return [...front, ...back.reverse()];
+}
+//# 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/store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.test.d.ts.map

package/dist/store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.d.ts","sourceRoot":"","sources":["../src/store.test.ts"],"names":[],"mappings":""}

package/dist/store.test.js

@@ -0,0 +1,223 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { temporaryRoot } from './fixtures.js';
+import { MemoryStore } from './store.js';
+/** A key that looks like an AWS access key, so the redaction finds it. */
+const SEEDED_KEY = 'AKIAIOSFODNN7EXAMPLE';
+async function storeIn(root, onAudit) {
+    return new MemoryStore({
+        root,
+        now: () => new Date('2026-10-26T12:00:00.000Z'),
+        ...(onAudit === undefined ? {} : { onAudit }),
+    });
+}
+describe('the memory store', () => {
+    it('writes one line per memory', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const store = await storeIn(root);
+            const outcome = await store.append({
+                text: 'The lease guard refuses a write to a file no lease covers.',
+                category: 'build',
+                source: '7 · 2a-1',
+                confidence: 'inferred',
+            });
+            expect(outcome.ok).toBe(true);
+            const path = join(root, '.openagentsy', 'memory.jsonl');
+            const lines = (await readFile(path, 'utf8')).trim().split('\n');
+            expect(lines).toHaveLength(1);
+            const entry = JSON.parse(lines[0] ?? '{}');
+            expect(entry.id).toMatch(/^oa-mem-[A-Za-z0-9_-]{6}$/);
+            expect(entry.category).toBe('build');
+            expect(entry.source).toBe('7 · 2a-1');
+            expect(entry.confidence).toBe('inferred');
+            expect(entry.created_at).toBe('2026-10-26T12:00:00.000Z');
+            // A memory is trusted on write; a person marks it unverified when
+            // they disagree (the human's decision of 2026-10-28).
+            expect(entry.verified).toBe(true);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('redacts before it writes, and says how much it redacted', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const store = await storeIn(root);
+            const outcome = await store.append({
+                text: `The key is ${SEEDED_KEY} and it must not be kept.`,
+                category: 'build',
+                source: '7 · 2a-1',
+                confidence: 'verified',
+            });
+            expect(outcome.ok).toBe(true);
+            expect(outcome.redactions).toBe(1);
+            const written = await readFile(join(root, '.openagentsy', 'memory.jsonl'), 'utf8');
+            expect(written).not.toContain(SEEDED_KEY);
+            expect(written).toContain('redacted:aws-access-key');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('refuses a duplicate with the id of the memory that holds it', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const store = await storeIn(root);
+            const first = await store.append({
+                text: 'The lease guard refuses a write to a file no lease covers.',
+                category: 'build',
+                source: '7 · 2a-1',
+                confidence: 'inferred',
+            });
+            expect(first.ok).toBe(true);
+            if (!first.ok)
+                return;
+            const second = await store.append({
+                text: '  The LEASE guard refuses a write to a file no lease covers.  ',
+                category: 'build',
+                source: '8 · 2a-2',
+                confidence: 'inferred',
+            });
+            expect(second.ok).toBe(false);
+            if (second.ok)
+                throw new Error('the duplicate was accepted');
+            expect(second.reason).toBe('duplicate');
+            if (second.reason !== 'duplicate')
+                throw new Error(`the outcome was ${second.reason}`);
+            expect(second.id).toBe(first.entry.id);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('refuses a text that is too long, and a category that is not a tag', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const store = await storeIn(root);
+            const long = await store.append({
+                text: 'x'.repeat(281),
+                category: 'build',
+                source: '7 · 2a-1',
+                confidence: 'guess',
+            });
+            expect(long.ok).toBe(false);
+            if (!long.ok)
+                expect(long.reason).toBe('invalid');
+            const tagged = await store.append({
+                text: 'A short enough text.',
+                category: 'Not A Tag',
+                source: '7 · 2a-1',
+                confidence: 'guess',
+            });
+            expect(tagged.ok).toBe(false);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('folds a forget marker into the view and keeps the line in the file', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const store = await storeIn(root);
+            const outcome = await store.append({
+                text: 'A memory that is about to be forgotten.',
+                category: 'build',
+                source: '7 · 2a-1',
+                confidence: 'guess',
+            });
+            expect(outcome.ok).toBe(true);
+            if (!outcome.ok)
+                return;
+            expect(await store.forget(outcome.entry.id, 'daniel')).toBe(true);
+            expect(await store.entries()).toEqual([]);
+            const lines = (await readFile(join(root, '.openagentsy', 'memory.jsonl'), 'utf8'))
+                .trim()
+                .split('\n');
+            expect(lines).toHaveLength(2);
+            expect(JSON.parse(lines[1] ?? '{}')).toMatchObject({
+                kind: 'forget',
+                id: outcome.entry.id,
+                by: 'daniel',
+            });
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('marks a memory verified, and audits who did it', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const audited = [];
+            const store = await storeIn(root, (policyId, detail) => {
+                audited.push({ policyId, detail });
+            });
+            const outcome = await store.append({
+                text: 'A memory that a person will verify.',
+                category: 'build',
+                source: '7 · 2a-1',
+                confidence: 'guess',
+                // A person marked it unverified when it was written; the call
+                // below marks it verified.
+                verified: false,
+            });
+            expect(outcome.ok).toBe(true);
+            if (!outcome.ok)
+                return;
+            expect(outcome.entry.verified).toBe(false);
+            expect(await store.verify(outcome.entry.id, 'daniel')).toBe(true);
+            const entries = await store.entries();
+            expect(entries[0]?.verified).toBe(true);
+            expect(audited).toEqual([
+                { policyId: 'oa.memory.verify', detail: { id: outcome.entry.id, decidedBy: 'daniel' } },
+            ]);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('reads the file once until it changes', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const store = await storeIn(root);
+            await store.append({
+                text: 'The first memory.',
+                category: 'build',
+                source: '7 · 2a-1',
+                confidence: 'guess',
+            });
+            expect(await store.entries()).toHaveLength(1);
+            // The cache is keyed on the file's stat, so a line written behind the
+            // store's back is seen on the next read.
+            const path = join(root, '.openagentsy', 'memory.jsonl');
+            const { appendFile } = await import('node:fs/promises');
+            await appendFile(path, `${JSON.stringify({
+                id: 'oa-mem-external',
+                text: 'A memory written by someone else.',
+                category: 'build',
+                source: '9 · 2a-9',
+                confidence: 'guess',
+                created_at: '2026-10-26T12:00:00.000Z',
+                verified: false,
+            })}\n`, 'utf8');
+            expect(await store.entries()).toHaveLength(2);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('has no file before the first memory', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const store = await storeIn(root);
+            expect(existsSync(join(root, '.openagentsy', 'memory.jsonl'))).toBe(false);
+            expect(await store.entries()).toEqual([]);
+        }
+        finally {
+            await remove();
+        }
+    });
+});
+//# sourceMappingURL=store.test.js.map

package/dist/store.test.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,86 @@
+import { memoryToolNames, type ToolDef } from '@openagentsy/core';
+import { z } from 'zod';
+import type { MemoryInbox } from './inbox.js';
+import type { MemoryStore } from './store.js';
+/**
+ * The memory tools.
+ *
+ * Three tools: search, list, and the decision. The decision tool exists and
+ * works, and the permission map is what keeps an agent from calling it: the
+ * map denies `oa_memory_decide` to every role, so only a person, through
+ * the command that will call this same code, decides what is kept.
+ */
+/**
+ * The tool names, for the base-tool vocabulary.
+ *
+ * The list lives in core, with the other tool names, so that the vocabulary
+ * which resolves a tool name back to its base name and the tools the
+ * server offers are one list.
+ */
+export { memoryToolNames };
+/** The most results a search may return. */
+export declare const MAX_SEARCH_LIMIT = 8;
+/** The results a search returns when the caller names no limit. */
+export declare const DEFAULT_SEARCH_LIMIT = 5;
+/** The most entries a list may return. */
+export declare const MAX_LIST_LIMIT = 20;
+/** The entries a list returns when the caller names no limit. */
+export declare const DEFAULT_LIST_LIMIT = 10;
+/** What the tools need. */
+export type MemoryToolDeps = {
+    store: MemoryStore;
+    inbox: MemoryInbox;
+};
+/**
+ * A memory, as a tool returns it.
+ *
+ * An unverified memory is redacted: the text becomes a marker that names
+ * the id, so the caller can ask for it again and say so. The rest of the
+ * entry stays, because what a memory is about is not a secret and a caller
+ * that cannot see the category cannot ask for the category.
+ */
+export type MemoryHit = {
+    id: string;
+    text: string;
+    category: string;
+    source: string;
+    confidence: string;
+    created_at: string;
+    verified: boolean;
+};
+declare const searchArgs: z.ZodObject<{
+    q: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    ordering: z.ZodOptional<z.ZodEnum<{
+        relevance: "relevance";
+        recency: "recency";
+        "lost-in-the-middle": "lost-in-the-middle";
+    }>>;
+    includeUnverified: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const listArgs: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const decideArgs: z.ZodObject<{
+    recordId: z.ZodNumber;
+    decision: z.ZodEnum<{
+        approve: "approve";
+        reject: "reject";
+    }>;
+    decidedBy: z.ZodString;
+}, z.core.$strip>;
+/** The three tools, each with the shape of its own arguments. */
+export type MemoryTools = {
+    oa_memory_search: ToolDef<typeof searchArgs>;
+    oa_memory_list: ToolDef<typeof listArgs>;
+    oa_memory_decide: ToolDef<typeof decideArgs>;
+};
+/**
+ * The three tools, defined once.
+ *
+ * The definitions are handed to the two runtimes through the helper in
+ * core, so the shape is the same in both OpenCode versions.
+ */
+export declare function createMemoryTools(deps: MemoryToolDeps): MemoryTools;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,0CAA0C;AAC1C,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,QAAA,MAAM,UAAU;;;;;;;;;;iBAMd,CAAC;AAEH,QAAA,MAAM,QAAQ;;iBAEZ,CAAC;AAEH,QAAA,MAAM,UAAU;;;;;;;iBAId,CAAC;AAEH,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG;IACxB,gBAAgB,EAAE,OAAO,CAAC,OAAO,UAAU,CAAC,CAAC;IAC7C,cAAc,EAAE,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAC;IACzC,gBAAgB,EAAE,OAAO,CAAC,OAAO,UAAU,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CA8CnE"}