@log0u7/opencode-memory 0.2.0 → 0.4.0

package/dist/plugin-v2.js

@@ -1,48 +1,63 @@
 import { Plugin } from "@opencode/plugin";
 import { openMemoryDb } from "./lib/db.js";
-import { forget, list, save, search, SecretDetectedError } from "./lib/store.js";
-import { SYSTEM_GUIDANCE, COMPACTION_CONTEXT, defaultDbPath, } from "./plugin.js";
+import { TOOL_DESCRIPTIONS, createMemoryOps, memoryInventory, oncePerSession, } from "./lib/memory-ops.js";
+import { createReflection, parseReflectionConfig } from "./lib/reflection.js";
+import { SYSTEM_GUIDANCE, COMPACTION_CONTEXT, defaultScope, defaultDbPath, } from "./plugin.js";
 const textPart = (text) => ({ type: "text", text });
+/** Reconnect backoff for the v2 event stream: short first retry, capped growth. */
+const RECONNECT_MIN_MS = 250;
+const RECONNECT_MAX_MS = 5000;
+/** Session tail as plain text: user messages verbatim, assistant text parts joined. */
+async function transcriptV2(ctx, sessionID) {
+    const messages = await ctx.session.context({ sessionID });
+    const lines = [];
+    for (const message of messages) {
+        if (message.type === "user") {
+            lines.push(`user: ${message.text}`);
+        }
+        else if (message.type === "assistant") {
+            const text = message.content
+                .filter((part) => part.type === "text")
+                .map((part) => part.text)
+                .join(" ")
+                .trim();
+            if (text) {
+                lines.push(`assistant: ${text}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
 export const MemoryV2 = Plugin.define({
     id: "@log0u7/opencode-memory",
     async setup(ctx) {
         const options = ctx.options;
+        const dbPath = defaultDbPath(options);
         let db = null;
+        let disposed = false;
+        // After cleanup the store is closed for good: a late path (tool call, in-flight
+        // reflection) must not silently reopen a connection that nobody closes again.
         const getDb = () => {
-            if (!db) {
-                db = openMemoryDb(defaultDbPath(options));
+            if (disposed) {
+                throw new Error("memory store is closed");
             }
+            db ??= openMemoryDb(dbPath);
             return db;
         };
-        // Tool results are shown to the model: caught errors become readable text, so
-        // a rejected save is guidance instead of a crashed tool call.
-        const run = async (fn) => {
-            try {
-                return fn();
-            }
-            catch (error) {
-                if (error instanceof SecretDetectedError) {
-                    return "refused: the content looks like a credential; secrets must never be stored in memory";
-                }
-                if (error instanceof Error) {
-                    return `error: ${error.message}`;
-                }
-                throw error;
-            }
-        };
-        // v1 scoped entries per session worktree; the v2 tool context carries no
-        // worktree, so entries default to the plugin location's directory.
-        const defaultScope = ctx.location.directory;
+        const ops = createMemoryOps(getDb);
+        // Request and compaction hooks carry no directory: the instance scope is the project.
+        const projectScope = defaultScope(undefined, ctx.location.directory);
+        const injected = oncePerSession();
         await ctx.tool.transform((editor) => {
             editor.add({
                 name: "memory_save",
-                description: "Save a durable entry to shared working memory (decisions, facts, preferences, gotchas). Never store credentials.",
+                description: TOOL_DESCRIPTIONS.save,
                 input: {
                     type: "object",
                     properties: {
                         kind: {
                             type: "string",
-                            description: "Entry type, e.g. decision, fact, preference, gotcha",
+                            description: "Entry type, e.g. decision, fact, preference, gotcha, lesson",
                         },
                         title: { type: "string", description: "Short title (max 120 chars)" },
                         body: { type: "string", description: "Entry content (max 8000 chars)" },
@@ -56,23 +71,13 @@ export const MemoryV2 = Plugin.define({
                 async execute(args) {
                     const a = args;
                     return {
-                        content: await run(() => {
-                            const entry = save(getDb(), {
-                                scope: a.scope ?? defaultScope,
-                                kind: a.kind,
-                                title: a.title,
-                                body: a.body,
-                                tags: a.tags ?? [],
-                                expires_at: a.expires_at ?? null,
-                            });
-                            return `saved ${entry.id} (${entry.scope})`;
-                        }),
+                        content: ops.save(a, defaultScope(undefined, a.scope ?? ctx.location.directory)),
                     };
                 },
             });
             editor.add({
                 name: "memory_search",
-                description: "Search shared working memory (all sessions on this machine). Results include this project's scope and global entries.",
+                description: TOOL_DESCRIPTIONS.search,
                 input: {
                     type: "object",
                     properties: {
@@ -86,23 +91,13 @@ export const MemoryV2 = Plugin.define({
                 async execute(args) {
                     const a = args;
                     return {
-                        content: await run(() => {
-                            const hits = search(getDb(), {
-                                query: a.query,
-                                scope: a.scope ?? defaultScope,
-                                ...(a.limit !== undefined ? { limit: a.limit } : {}),
-                            });
-                            if (hits.length === 0) {
-                                return "no matching memory entries";
-                            }
-                            return JSON.stringify(hits, null, 2);
-                        }),
+                        content: ops.search({ query: a.query, ...(a.limit !== undefined ? { limit: a.limit } : {}) }, defaultScope(undefined, a.scope ?? ctx.location.directory)),
                     };
                 },
             });
             editor.add({
                 name: "memory_list",
-                description: "List recent memory entries for a scope (default: the project directory), newest first.",
+                description: TOOL_DESCRIPTIONS.list,
                 input: {
                     type: "object",
                     properties: {
@@ -114,22 +109,13 @@ export const MemoryV2 = Plugin.define({
                 async execute(args) {
                     const a = args;
                     return {
-                        content: await run(() => {
-                            const entries = list(getDb(), {
-                                scope: a.scope ?? defaultScope,
-                                ...(a.limit !== undefined ? { limit: a.limit } : {}),
-                            });
-                            if (entries.length === 0) {
-                                return "no memory entries";
-                            }
-                            return JSON.stringify(entries, null, 2);
-                        }),
+                        content: ops.list(a.limit !== undefined ? { limit: a.limit } : {}, defaultScope(undefined, a.scope ?? ctx.location.directory)),
                     };
                 },
             });
             editor.add({
                 name: "memory_forget",
-                description: "Delete memory entries by id, or all entries matching a query.",
+                description: TOOL_DESCRIPTIONS.forget,
                 input: {
                     type: "object",
                     properties: {
@@ -140,35 +126,109 @@ export const MemoryV2 = Plugin.define({
                 },
                 async execute(args) {
                     const a = args;
-                    return {
-                        content: await run(() => {
-                            if (a.id !== undefined) {
-                                const deleted = forget(getDb(), { id: a.id });
-                                return `deleted ${deleted} entr${deleted === 1 ? "y" : "ies"}`;
-                            }
-                            if (a.query !== undefined) {
-                                const deleted = forget(getDb(), { query: a.query });
-                                return `deleted ${deleted} entr${deleted === 1 ? "y" : "ies"}`;
-                            }
-                            return "provide id or query";
-                        }),
-                    };
+                    return { content: ops.forget(a, defaultScope(undefined, ctx.location.directory)) };
+                },
+            });
+            editor.add({
+                name: "memory_stats",
+                description: TOOL_DESCRIPTIONS.stats,
+                input: {
+                    type: "object",
+                    properties: {
+                        scope: { type: "string", description: "Scope key; defaults to the project directory" },
+                    },
+                    additionalProperties: false,
+                },
+                async execute(args) {
+                    const a = args;
+                    return { content: ops.stats(defaultScope(undefined, a.scope ?? ctx.location.directory)) };
                 },
             });
         });
-        // experimental.chat.system.transform -> context hook (edit event.system)
+        // The v1 system transform maps to the v2 context hook: guidance first, then the
+        // once-per-session inventory.
         await ctx.session.hook("context", (event) => {
             event.system.push(textPart(SYSTEM_GUIDANCE));
+            if (disposed) {
+                return;
+            }
+            const inventory = injected.inject(event.sessionID, () => memoryInventory(getDb, dbPath, projectScope));
+            if (inventory !== null) {
+                event.system.push(textPart(inventory));
+            }
         });
         // experimental.session.compacting -> compaction hook
         await ctx.session.hook("compaction", (event) => {
             event.system.push(textPart(COMPACTION_CONTEXT));
+            if (disposed) {
+                return;
+            }
+            const inventory = memoryInventory(getDb, dbPath, projectScope);
+            if (inventory !== null) {
+                event.system.push(textPart(inventory));
+            }
         });
         const cleanup = async () => {
+            disposed = true;
+            injected.reset();
             db?.close();
             db = null;
         };
-        return cleanup;
+        const reflection = parseReflectionConfig(options.reflection);
+        if (!reflection) {
+            return cleanup;
+        }
+        const onIdle = createReflection(reflection, {
+            isSubagent: async (sessionID) => {
+                const session = await ctx.session.get({ sessionID });
+                return !!session.parentID;
+            },
+            transcript: (sessionID) => transcriptV2(ctx, sessionID),
+            generate: async (prompt, _sessionID, signal) => {
+                const model = modelRefV2(reflection.model);
+                const result = await ctx.generate.text({ prompt, ...(model ? { model } : {}) }, { signal });
+                return result.text;
+            },
+            saveLesson: (title, body) => {
+                ops.save({ kind: "lesson", title, body }, projectScope);
+            },
+        });
+        // The host keeps the event stream alive through this controller; aborting it stops
+        // the idle loop without touching the tool or session hooks. A stream that errors is
+        // retried with a capped backoff instead of ending the loop for good.
+        const controller = new AbortController();
+        void (async () => {
+            let delay = RECONNECT_MIN_MS;
+            while (!controller.signal.aborted) {
+                let failed = false;
+                try {
+                    for await (const event of ctx.event.subscribe({ signal: controller.signal })) {
+                        if (event.type === "session.idle") {
+                            onIdle(event.data.sessionID);
+                        }
+                    }
+                }
+                catch {
+                    failed = true;
+                }
+                if (!failed || controller.signal.aborted) {
+                    break;
+                }
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                delay = Math.min(delay * 2, RECONNECT_MAX_MS);
+            }
+        })();
+        return async () => {
+            controller.abort();
+            await cleanup();
+        };
     },
 });
+function modelRefV2(model) {
+    if (!model) {
+        return undefined;
+    }
+    const [providerID, id] = model.split("/", 2);
+    return providerID && id ? { providerID, id } : undefined;
+}
 //# sourceMappingURL=plugin-v2.js.map

package/dist/plugin-v2.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-v2.js","sourceRoot":"","sources":["../src/plugin-v2.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin-v2.js","sourceRoot":"","sources":["../src/plugin-v2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,aAAa,GAEd,MAAM,aAAa,CAAC;AAErB,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AAErE,mFAAmF;AACnF,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,uFAAuF;AACvF,KAAK,UAAU,YAAY,CAAC,GAAmB,EAAE,SAAiB;IAChE,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO;iBACzB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;iBACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;iBACxB,IAAI,CAAC,GAAG,CAAC;iBACT,IAAI,EAAE,CAAC;YACV,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,yBAAyB;IAC7B,KAAK,CAAC,KAAK,CAAC,GAAG;QACb,MAAM,OAAO,GAAG,GAAG,CAAC,OAAwB,CAAC;QAC7C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,EAAE,GAAoB,IAAI,CAAC;QAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,gFAAgF;QAChF,8EAA8E;QAC9E,MAAM,KAAK,GAAG,GAAa,EAAE;YAC3B,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;YACD,EAAE,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAEnC,sFAAsF;QACtF,MAAM,YAAY,GAAG,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;QAElC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YAClC,MAAM,CAAC,GAAG,CAAC;gBACT,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,iBAAiB,CAAC,IAAI;gBACnC,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,6DAA6D;yBAC3E;wBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;wBACrE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;wBACvE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;wBACtF,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE;wBAChF,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;qBACxE;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;oBACnC,oBAAoB,EAAE,KAAK;iBAC5B;gBACD,KAAK,CAAC,OAAO,CAAC,IAAI;oBAChB,MAAM,CAAC,GAAG,IAOT,CAAC;oBACF,OAAO;wBACL,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;qBACjF,CAAC;gBACJ,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC;gBACT,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,iBAAiB,CAAC,MAAM;gBACrC,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;wBACzD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;wBACtF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;qBACnE;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;oBACnB,oBAAoB,EAAE,KAAK;iBAC5B;gBACD,KAAK,CAAC,OAAO,CAAC,IAAI;oBAChB,MAAM,CAAC,GAAG,IAAyD,CAAC;oBACpE,OAAO;wBACL,OAAO,EAAE,GAAG,CAAC,MAAM,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EACxE,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC3D;qBACF,CAAC;gBACJ,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC;gBACT,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,iBAAiB,CAAC,IAAI;gBACnC,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;wBACtF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;qBACnE;oBACD,oBAAoB,EAAE,KAAK;iBAC5B;gBACD,KAAK,CAAC,OAAO,CAAC,IAAI;oBAChB,MAAM,CAAC,GAAG,IAA0C,CAAC;oBACrD,OAAO;wBACL,OAAO,EAAE,GAAG,CAAC,IAAI,CACf,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAC/C,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC3D;qBACF,CAAC;gBACJ,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC;gBACT,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,iBAAiB,CAAC,MAAM;gBACrC,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;wBACzD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;qBACjF;oBACD,oBAAoB,EAAE,KAAK;iBAC5B;gBACD,KAAK,CAAC,OAAO,CAAC,IAAI;oBAChB,MAAM,CAAC,GAAG,IAAuC,CAAC;oBAClD,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACrF,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC;gBACT,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,iBAAiB,CAAC,KAAK;gBACpC,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;qBACvF;oBACD,oBAAoB,EAAE,KAAK;iBAC5B;gBACD,KAAK,CAAC,OAAO,CAAC,IAAI;oBAChB,MAAM,CAAC,GAAG,IAA0B,CAAC;oBACrC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBAC5F,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,gFAAgF;QAChF,8BAA8B;QAC9B,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;YAC7C,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,CACtD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,CAC7C,CAAC;YACF,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,qDAAqD;QACrD,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YAC7C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAChD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;YAC/D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,QAAQ,GAAG,IAAI,CAAC;YAChB,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,EAAE,EAAE,KAAK,EAAE,CAAC;YACZ,EAAE,GAAG,IAAI,CAAC;QACZ,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,EAAE;YAC1C,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;gBAC9B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;gBACrD,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC5B,CAAC;YACD,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC;YACvD,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE;gBAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC3C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC5F,OAAO,MAAM,CAAC,IAAI,CAAC;YACrB,CAAC;YACD,UAAU,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;YAC1D,CAAC;SACF,CAAC,CAAC;QACH,mFAAmF;QACnF,oFAAoF;QACpF,qEAAqE;QACrE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,KAAK,GAAG,gBAAgB,CAAC;YAC7B,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClC,IAAI,MAAM,GAAG,KAAK,CAAC;gBACnB,IAAI,CAAC;oBACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;wBAC7E,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;4BAClC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;wBAC/B,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,GAAG,IAAI,CAAC;gBAChB,CAAC;gBACD,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACzC,MAAM;gBACR,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC3D,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC;YAChD,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,KAAK,IAAI,EAAE;YAChB,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,KAA0B;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC"}

package/dist/plugin.d.ts

@@ -1,9 +1,16 @@
 import type { Plugin } from "@opencode-ai/plugin";
 export type PluginOptions = {
     dbPath?: string;
+    reflection?: unknown;
 };
-export declare const SYSTEM_GUIDANCE = "You have persistent working memory shared with all OpenCode sessions on this machine.\nAt the start of a non-trivial task, run memory_search for relevant decisions and facts about this project.\nWhen you make a durable decision or learn a lasting fact, call memory_save (kinds: decision, fact, preference, gotcha).\nNever store credentials, tokens, or API keys in memory; the store refuses them.";
+export declare const REFLECTION_SESSION_TITLE = "[memory-reflect] lessons";
+export declare const SYSTEM_GUIDANCE = "You have persistent working memory shared with all OpenCode sessions on this machine.\nRecent entries are listed above when present; run memory_search for anything older or more specific.\nWhen you make a durable decision or learn a lasting fact, call memory_save (kinds: decision, fact, preference, gotcha).\nWhen a non-obvious approach clearly fails or succeeds, save the lesson (kind=lesson) as soon as it is confirmed, and check stored lessons before retrying a failed approach.\nNever store credentials, tokens, or API keys in memory; the store refuses them.";
 export declare const COMPACTION_CONTEXT: string;
 export declare function defaultDbPath(options?: PluginOptions): string;
+/**
+ * Scope of a session: the v1 tool context carries a worktree, so that is the canonical
+ * key. `directory` is the fallback so the same project does not get two scopes.
+ */
+export declare function defaultScope(worktree?: string, directory?: string): string;
 export declare const MemoryPlugin: Plugin;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAMzD,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,eAAe,gZAGoD,CAAC;AAEjF,eAAO,MAAM,kBAAkB,QAEoE,CAAC;AAEpG,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAM7D;AAED,eAAO,MAAM,YAAY,EAAE,MA6H1B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,MAAM,EAAe,MAAM,qBAAqB,CAAC;AAiBtE,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAqBnE,eAAO,MAAM,eAAe,wjBAIoD,CAAC;AAEjF,eAAO,MAAM,kBAAkB,QAG0B,CAAC;AAE1D,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAM7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1E;AA8DD,eAAO,MAAM,YAAY,EAAE,MA4I1B,CAAC"}

package/dist/plugin.js

@@ -1,12 +1,32 @@
-import { openMemoryDb } from "./lib/db.js";
-import { forget, list, save, search, SecretDetectedError } from "./lib/store.js";
 import { tool } from "@opencode-ai/plugin";
+import { openMemoryDb } from "./lib/db.js";
+import { TOOL_DESCRIPTIONS, createMemoryOps, memoryInventory, oncePerSession, } from "./lib/memory-ops.js";
+import { parseReflectionConfig, createReflection, } from "./lib/reflection.js";
+import { canonicalScope } from "./lib/store.js";
+export const REFLECTION_SESSION_TITLE = "[memory-reflect] lessons";
+const REFLECTION_SYSTEM = "You extract durable lessons for a memory store. Reply with the JSON array only; do not call any tool.";
+function transcriptText(messages, chars) {
+    const lines = [];
+    for (const { info, parts } of messages) {
+        const text = parts
+            .filter((part) => part.type === "text")
+            .map((part) => part.text ?? "")
+            .join(" ")
+            .trim();
+        if (text) {
+            lines.push(`${info.role}: ${text}`);
+        }
+    }
+    return lines.join("\n").slice(-chars);
+}
 export const SYSTEM_GUIDANCE = `You have persistent working memory shared with all OpenCode sessions on this machine.
-At the start of a non-trivial task, run memory_search for relevant decisions and facts about this project.
+Recent entries are listed above when present; run memory_search for anything older or more specific.
 When you make a durable decision or learn a lasting fact, call memory_save (kinds: decision, fact, preference, gotcha).
+When a non-obvious approach clearly fails or succeeds, save the lesson (kind=lesson) as soon as it is confirmed, and check stored lessons before retrying a failed approach.
 Never store credentials, tokens, or API keys in memory; the store refuses them.`;
 export const COMPACTION_CONTEXT = "The session is being compacted. After compaction, call memory_save for every durable decision still relevant " +
-    "(kind=decision) and any newly learned facts (kind=fact), so other sessions keep this knowledge.";
+    "(kind=decision), any newly learned facts (kind=fact), and every reusable lesson confirmed this session " +
+    "(kind=lesson), so other sessions keep this knowledge.";
 export function defaultDbPath(options) {
     if (typeof options?.dbPath === "string" && options.dbPath.length > 0) {
         return options.dbPath;
@@ -14,22 +34,93 @@ export function defaultDbPath(options) {
     const dataHome = process.env.XDG_DATA_HOME ?? `${process.env.HOME ?? ""}/.local/share`;
     return `${dataHome}/opencode-memory/memory.db`;
 }
-export const MemoryPlugin = async (_input, options) => {
+/**
+ * Scope of a session: the v1 tool context carries a worktree, so that is the canonical
+ * key. `directory` is the fallback so the same project does not get two scopes.
+ */
+export function defaultScope(worktree, directory) {
+    return canonicalScope(worktree, directory);
+}
+/** One ephemeral child session per reflection: the transcript tail is distilled with a
+ * synchronous prompt on that child (system pins the model to JSON-only, no tools), the
+ * reply is parsed here, and the child is deleted. Fire-and-forget: the host event loop
+ * never waits on the LLM. */
+function reflectionDeps(client, config, ops, projectScope) {
+    const model = modelRef(config.model);
+    return {
+        isSubagent: async (sessionID) => {
+            const session = await client.session.get({ path: { id: sessionID } });
+            return !!session.data?.parentID;
+        },
+        transcript: async (sessionID) => {
+            const result = await client.session.messages({ path: { id: sessionID } });
+            return transcriptText(result.data ?? [], config.transcriptChars);
+        },
+        generate: async (prompt, sessionID, signal) => {
+            const child = await client.session.create({
+                body: { parentID: sessionID, title: REFLECTION_SESSION_TITLE },
+            });
+            const id = child.data?.id;
+            if (!id) {
+                throw new Error("reflection session could not be created");
+            }
+            try {
+                const reply = await client.session.prompt({
+                    path: { id },
+                    body: {
+                        parts: [{ type: "text", text: prompt }],
+                        system: REFLECTION_SYSTEM,
+                        ...(model ? { model } : {}),
+                    },
+                    signal,
+                });
+                return (reply.data?.parts ?? [])
+                    .filter((part) => part.type === "text")
+                    .map((part) => part.text ?? "")
+                    .join("\n");
+            }
+            finally {
+                await client.session.delete({ path: { id } }).catch(() => { });
+            }
+        },
+        saveLesson: (title, body) => {
+            ops.save({ kind: "lesson", title, body }, projectScope);
+        },
+    };
+}
+function modelRef(model) {
+    if (!model) {
+        return undefined;
+    }
+    const [providerID, modelID] = model.split("/", 2);
+    return providerID && modelID ? { providerID, modelID } : undefined;
+}
+export const MemoryPlugin = async (input, options) => {
+    const dbPath = defaultDbPath(options);
     let db = null;
+    let disposed = false;
+    // After dispose the store is closed for good: a late path (tool call, in-flight
+    // reflection) must not silently reopen a connection that nobody closes again.
     const getDb = () => {
-        if (!db) {
-            db = openMemoryDb(defaultDbPath(options));
+        if (disposed) {
+            throw new Error("memory store is closed");
         }
+        db ??= openMemoryDb(dbPath);
         return db;
     };
+    const ops = createMemoryOps(getDb);
+    // Request and compaction hooks carry no directory: the instance scope is the project.
+    const projectScope = defaultScope(input.worktree, input.directory);
+    const injected = oncePerSession();
+    const reflection = parseReflectionConfig(options?.reflection);
     const hooks = {
         tool: {
             memory_save: tool({
-                description: "Save a durable entry to shared working memory (decisions, facts, preferences, gotchas). Never store credentials.",
+                description: TOOL_DESCRIPTIONS.save,
                 args: {
                     kind: tool.schema
                         .string()
-                        .describe("Entry type, e.g. decision, fact, preference, gotcha"),
+                        .describe("Entry type, e.g. decision, fact, preference, gotcha, lesson"),
                     title: tool.schema.string().describe("Short title (max 120 chars)"),
                     body: tool.schema.string().describe("Entry content (max 8000 chars)"),
                     scope: tool.schema
@@ -39,20 +130,10 @@ export const MemoryPlugin = async (_input, options) => {
                     tags: tool.schema.array(tool.schema.string()).optional().describe("Optional tags"),
                     expires_at: tool.schema.number().optional().describe("Optional epoch ms expiry"),
                 },
-                execute: (args, context) => run(() => {
-                    const entry = save(getDb(), {
-                        scope: args.scope ?? context.worktree,
-                        kind: args.kind,
-                        title: args.title,
-                        body: args.body,
-                        tags: args.tags ?? [],
-                        expires_at: args.expires_at ?? null,
-                    });
-                    return `saved ${entry.id} (${entry.scope})`;
-                }),
+                execute: async (args, context) => ops.save(args, defaultScope(args.scope ?? context.worktree ?? context.directory)),
             }),
             memory_search: tool({
-                description: "Search shared working memory (all sessions on this machine). Results include this project's scope and global entries.",
+                description: TOOL_DESCRIPTIONS.search,
                 args: {
                     query: tool.schema.string().describe("Free-text query"),
                     scope: tool.schema
@@ -61,20 +142,10 @@ export const MemoryPlugin = async (_input, options) => {
                         .describe("Scope key; defaults to this session's worktree"),
                     limit: tool.schema.number().optional().describe("Max results (default 10)"),
                 },
-                execute: (args, context) => run(() => {
-                    const hits = search(getDb(), {
-                        query: args.query,
-                        scope: args.scope ?? context.worktree,
-                        ...(args.limit !== undefined ? { limit: args.limit } : {}),
-                    });
-                    if (hits.length === 0) {
-                        return "no matching memory entries";
-                    }
-                    return JSON.stringify(hits, null, 2);
-                }),
+                execute: async (args, context) => ops.search({ query: args.query, ...(args.limit !== undefined ? { limit: args.limit } : {}) }, defaultScope(args.scope ?? context.worktree ?? context.directory)),
             }),
             memory_list: tool({
-                description: "List recent memory entries for a scope (default: this session's worktree), newest first.",
+                description: TOOL_DESCRIPTIONS.list,
                 args: {
                     scope: tool.schema
                         .string()
@@ -82,65 +153,64 @@ export const MemoryPlugin = async (_input, options) => {
                         .describe("Scope key; defaults to this session's worktree"),
                     limit: tool.schema.number().optional().describe("Max results (default 20)"),
                 },
-                execute: (args, context) => run(() => {
-                    const entries = list(getDb(), {
-                        scope: args.scope ?? context.worktree,
-                        ...(args.limit !== undefined ? { limit: args.limit } : {}),
-                    });
-                    if (entries.length === 0) {
-                        return "no memory entries";
-                    }
-                    return JSON.stringify(entries, null, 2);
-                }),
+                execute: async (args, context) => ops.list(args.limit !== undefined ? { limit: args.limit } : {}, defaultScope(args.scope ?? context.worktree ?? context.directory)),
             }),
             memory_forget: tool({
-                description: "Delete memory entries by id, or all entries matching a query.",
+                description: TOOL_DESCRIPTIONS.forget,
                 args: {
                     id: tool.schema.string().optional().describe("Entry id to delete"),
-                    query: tool.schema.string().optional().describe("Delete every entry matching this query"),
+                    query: tool.schema.string().optional().describe("Delete every entry matching a query"),
+                },
+                execute: async (args, context) => ops.forget(args, defaultScope(context.worktree, context.directory)),
+            }),
+            memory_stats: tool({
+                description: TOOL_DESCRIPTIONS.stats,
+                args: {
+                    scope: tool.schema
+                        .string()
+                        .optional()
+                        .describe("Scope key; defaults to this session's worktree"),
                 },
-                execute: (args, _context) => run(() => {
-                    if (args.id !== undefined) {
-                        const deleted = forget(getDb(), { id: args.id });
-                        return `deleted ${deleted} entr${deleted === 1 ? "y" : "ies"}`;
-                    }
-                    if (args.query !== undefined) {
-                        const deleted = forget(getDb(), { query: args.query });
-                        return `deleted ${deleted} entr${deleted === 1 ? "y" : "ies"}`;
-                    }
-                    return "provide id or query";
-                }),
+                execute: async (args, context) => ops.stats(defaultScope(args.scope ?? context.worktree ?? context.directory)),
             }),
         },
     };
+    if (reflection) {
+        const onIdle = createReflection(reflection, reflectionDeps(input.client, reflection, ops, projectScope));
+        hooks.event = async ({ event }) => {
+            if (event.type === "session.idle") {
+                onIdle(event.properties.sessionID);
+            }
+        };
+    }
     return {
         ...hooks,
-        "experimental.chat.system.transform": async (_input, output) => {
+        "experimental.chat.system.transform": async (input, output) => {
             output.system.push(SYSTEM_GUIDANCE);
+            if (disposed) {
+                return;
+            }
+            const inventory = injected.inject(input.sessionID, () => memoryInventory(getDb, dbPath, projectScope));
+            if (inventory !== null) {
+                output.system.push(inventory);
+            }
         },
         "experimental.session.compacting": async (_input, output) => {
             output.context.push(COMPACTION_CONTEXT);
+            if (disposed) {
+                return;
+            }
+            const inventory = memoryInventory(getDb, dbPath, projectScope);
+            if (inventory !== null) {
+                output.context.push(inventory);
+            }
         },
         dispose: async () => {
+            disposed = true;
+            injected.reset();
             db?.close();
             db = null;
         },
     };
 };
-// Tool results are shown to the model: caught errors become readable text, so
-// a rejected save is guidance instead of a crashed tool call.
-async function run(fn) {
-    try {
-        return fn();
-    }
-    catch (error) {
-        if (error instanceof SecretDetectedError) {
-            return "refused: the content looks like a credential; secrets must never be stored in memory";
-        }
-        if (error instanceof Error) {
-            return `error: ${error.message}`;
-        }
-        throw error;
-    }
-}
 //# sourceMappingURL=plugin.js.map