@openagentsy/memory 0.0.0-stage → 0.2.0

package/dist/tools.js

@@ -0,0 +1,108 @@
+import { defineTool, memoryToolNames } from '@openagentsy/core';
+import { z } from 'zod';
+/**
+ * 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 const MAX_SEARCH_LIMIT = 8;
+/** The results a search returns when the caller names no limit. */
+export const DEFAULT_SEARCH_LIMIT = 5;
+/** The most entries a list may return. */
+export const MAX_LIST_LIMIT = 20;
+/** The entries a list returns when the caller names no limit. */
+export const DEFAULT_LIST_LIMIT = 10;
+const searchArgs = z.object({
+    q: z.string().min(1),
+    category: z.string().optional(),
+    limit: z.number().int().min(1).max(MAX_SEARCH_LIMIT).optional(),
+    ordering: z.enum(['relevance', 'recency', 'lost-in-the-middle']).optional(),
+    includeUnverified: z.boolean().optional(),
+});
+const listArgs = z.object({
+    limit: z.number().int().min(1).max(MAX_LIST_LIMIT).optional(),
+});
+const decideArgs = z.object({
+    recordId: z.number().int(),
+    decision: z.enum(['approve', 'reject']),
+    decidedBy: z.string().min(1),
+});
+/**
+ * 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 function createMemoryTools(deps) {
+    return {
+        oa_memory_search: defineTool({
+            description: 'Search the memories a person decided to keep. Substring and keyword over the text and the category. Unverified memories are redacted unless includeUnverified is set.',
+            args: searchArgs,
+            async execute(args) {
+                const includeUnverified = args.includeUnverified ?? false;
+                const results = await deps.store.search({
+                    q: args.q,
+                    ...(args.category === undefined ? {} : { category: args.category }),
+                    limit: args.limit ?? DEFAULT_SEARCH_LIMIT,
+                    ordering: args.ordering ?? 'lost-in-the-middle',
+                });
+                return {
+                    hits: results.map((result) => hit(result.entry, includeUnverified)),
+                    total: results.length,
+                };
+            },
+        }),
+        oa_memory_list: defineTool({
+            description: 'The most recent memories, and how many candidates are waiting for a decision.',
+            args: listArgs,
+            async execute(args) {
+                const entries = await deps.store.entries();
+                const recent = [...entries]
+                    .sort((a, b) => (a.created_at < b.created_at ? 1 : a.created_at > b.created_at ? -1 : 0))
+                    .slice(0, args.limit ?? DEFAULT_LIST_LIMIT);
+                const pending = await deps.inbox.pending();
+                return {
+                    entries: recent.map((entry) => hit(entry, false)),
+                    pending: pending.length,
+                };
+            },
+        }),
+        oa_memory_decide: defineTool({
+            description: 'Decide on a candidate memory: approve it into the store, or reject it. A person decides, and the permission map keeps an agent from calling this.',
+            args: decideArgs,
+            async execute(args) {
+                return deps.inbox.decide(args.recordId, args.decision, args.decidedBy);
+            },
+        }),
+    };
+}
+/**
+ * The shape a memory takes in a result.
+ *
+ * The text of an unverified memory is replaced by a marker that names it,
+ * unless the caller asked for the unverified ones.
+ */
+function hit(entry, includeUnverified) {
+    return {
+        id: entry.id,
+        text: entry.verified || includeUnverified ? entry.text : `[unverified: ${entry.id}]`,
+        category: entry.category,
+        source: entry.source,
+        confidence: entry.confidence,
+        created_at: entry.created_at,
+        verified: entry.verified,
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/tools.test.d.ts

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

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

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

package/dist/tools.test.js

@@ -0,0 +1,142 @@
+import { describe, expect, it } from 'vitest';
+import { candidateRecord, fakeReader, temporaryRoot } from './fixtures.js';
+import { MemoryInbox } from './inbox.js';
+import { MemoryStore } from './store.js';
+import { createMemoryTools } from './tools.js';
+const ctx = { sessionID: 'test-session', agent: 'oa-builder' };
+/** A store whose clock steps forward, so the order of two memories is fixed. */
+function steppingStore(root) {
+    let tick = 0;
+    return new MemoryStore({
+        root,
+        now: () => {
+            tick += 1;
+            return new Date(Date.UTC(2026, 9, 26, 12, 0, tick));
+        },
+    });
+}
+async function toolsIn(root, records) {
+    const store = steppingStore(root);
+    const inbox = new MemoryInbox({ root, read: fakeReader(records), store });
+    return { tools: createMemoryTools({ store, inbox }), store, inbox };
+}
+describe('the memory tools', () => {
+    it('redacts an unverified memory in a search, unless the caller asks for it', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const { tools, store } = await toolsIn(root, []);
+            await store.append({
+                text: 'The lease guard refuses a write to a file no lease covers.',
+                category: 'build',
+                source: '7 · 2a-1',
+                confidence: 'inferred',
+                // A memory is trusted on write; this one is marked unverified, so
+                // the search redacts it until the caller asks for it.
+                verified: false,
+            });
+            const hidden = (await tools.oa_memory_search.execute({ q: 'lease' }, ctx));
+            expect(hidden.hits).toHaveLength(1);
+            expect(hidden.hits[0]?.text).toMatch(/^\[unverified: oa-mem-[A-Za-z0-9_-]{6}\]$/);
+            const shown = (await tools.oa_memory_search.execute({ q: 'lease', includeUnverified: true }, ctx));
+            expect(shown.hits[0]?.text).toContain('lease guard');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('orders the results so the best ones are where a model looks first', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const { tools, store } = await toolsIn(root, []);
+            await store.append({
+                text: 'alpha beta',
+                category: 'build',
+                source: '1 · a',
+                confidence: 'guess',
+            });
+            await store.append({
+                text: 'alpha',
+                category: 'build',
+                source: '2 · b',
+                confidence: 'guess',
+            });
+            await store.append({
+                text: 'beta',
+                category: 'build',
+                source: '3 · c',
+                confidence: 'guess',
+            });
+            const found = (await tools.oa_memory_search.execute({ q: 'alpha beta', includeUnverified: true }, ctx));
+            // The best match is first and the second best is last, so the two
+            // strongest results sit where a model looks first. The second best is
+            // 'beta': it scores the same as 'alpha' and is the newer of the two.
+            const texts = found.hits.map((hit) => hit.text);
+            expect(texts[0]).toBe('alpha beta');
+            expect(texts[texts.length - 1]).toBe('beta');
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('finds a memory by its category', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const { tools, store } = await toolsIn(root, []);
+            await store.append({
+                text: 'The lease guard refuses a write to a file no lease covers.',
+                category: 'guard',
+                source: '7 · 2a-1',
+                confidence: 'guess',
+            });
+            await store.append({
+                text: 'The redaction runs before an entry is appended.',
+                category: 'privacy',
+                source: '8 · 2a-2',
+                confidence: 'guess',
+            });
+            const found = (await tools.oa_memory_search.execute({ q: 'lease', category: 'guard' }, ctx));
+            expect(found.hits).toHaveLength(1);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('lists the recent memories and how many candidates wait', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const { tools, store } = await toolsIn(root, [
+                candidateRecord({ id: 1 }),
+                candidateRecord({ id: 2 }),
+            ]);
+            await store.append({
+                text: 'The lease guard refuses a write to a file no lease covers.',
+                category: 'build',
+                source: '7 · 2a-1',
+                confidence: 'guess',
+                // Marked unverified, so the listing redacts its text.
+                verified: false,
+            });
+            const listed = (await tools.oa_memory_list.execute({}, ctx));
+            expect(listed.entries).toHaveLength(1);
+            expect(listed.entries[0]?.text).toMatch(/^\[unverified: oa-mem-/);
+            expect(listed.pending).toBe(2);
+        }
+        finally {
+            await remove();
+        }
+    });
+    it('decides on a candidate', async () => {
+        const { root, remove } = await temporaryRoot();
+        try {
+            const { tools, store } = await toolsIn(root, [candidateRecord({ id: 7 })]);
+            const decided = (await tools.oa_memory_decide.execute({ recordId: 7, decision: 'approve', decidedBy: 'daniel' }, ctx));
+            expect(decided.ok).toBe(true);
+            expect(decided.state).toBe('promoted');
+            expect(await store.entries()).toHaveLength(1);
+        }
+        finally {
+            await remove();
+        }
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.test.js","sourceRoot":"","sources":["../src/tools.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,GAAG,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAE/D,gFAAgF;AAChF,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,IAAI,WAAW,CAAC;QACrB,IAAI;QACJ,GAAG,EAAE,GAAG,EAAE;YACR,IAAI,IAAI,CAAC,CAAC;YACV,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,OAA6C;IAChF,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACtE,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC,MAAM,CAAC;gBACjB,IAAI,EAAE,4DAA4D;gBAClE,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,UAAU;gBACtB,kEAAkE;gBAClE,sDAAsD;gBACtD,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAExE,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC;YAElF,MAAM,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,gBAAgB,CAAC,OAAO,CACjD,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,EACvC,GAAG,CACJ,CAAiC,CAAC;YACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACvD,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC,MAAM,CAAC;gBACjB,IAAI,EAAE,YAAY;gBAClB,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,OAAO;aACpB,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,MAAM,CAAC;gBACjB,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,OAAO;aACpB,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,MAAM,CAAC;gBACjB,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,OAAO;aACpB,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,gBAAgB,CAAC,OAAO,CACjD,EAAE,CAAC,EAAE,YAAY,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAC5C,GAAG,CACJ,CAAiC,CAAC;YACnC,kEAAkE;YAClE,sEAAsE;YACtE,qEAAqE;YACrE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC,MAAM,CAAC;gBACjB,IAAI,EAAE,4DAA4D;gBAClE,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,OAAO;aACpB,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,MAAM,CAAC;gBACjB,IAAI,EAAE,iDAAiD;gBACvD,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,OAAO;aACpB,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,gBAAgB,CAAC,OAAO,CACjD,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EACjC,GAAG,CACJ,CAAiC,CAAC;YACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE;gBAC3C,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;gBAC1B,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;aAC3B,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,MAAM,CAAC;gBACjB,IAAI,EAAE,4DAA4D;gBAClE,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,OAAO;gBACnB,sDAAsD;gBACtD,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAG1D,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;YAClE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3E,MAAM,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,gBAAgB,CAAC,OAAO,CACnD,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,EACzD,GAAG,CACJ,CAAmC,CAAC;YACrC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@openagentsy/memory",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "author": "Grand Slopulissimo <slopulissimo@voxslopuli.org>",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json"
+  },
+  "dependencies": {
+    "@openagentsy/core": "^0.2.0",
+    "nanoid": "6.0.2",
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
+  },
+  "license": "GPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/voxslopuli/openagentsy.git"
+  },
+  "homepage": "https://github.com/voxslopuli/openagentsy#readme",
+  "bugs": {
+    "url": "https://github.com/voxslopuli/openagentsy/issues"
+  },
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "The OpenAgentsy memory store: the decision, the store, and the way back in.",
+  "keywords": [
+    "agents",
+    "memory",
+    "opencode",
+    "llm"
+  ],
+  "files": [
+    "dist"
+  ]
+}