opencode-claude-memory 1.7.5 → 1.7.6

package/README.md

@@ -217,6 +217,7 @@ Yes. Set `OPENCODE_MEMORY_AUTODREAM=0`. You can also tune gates with:
 - `OPENCODE_MEMORY_TERMINAL_LOG` (default `foreground-only`): set `1` to force terminal logs on, `0` to force them off
 - `OPENCODE_MEMORY_MODEL`: override model used for extraction
 - `OPENCODE_MEMORY_AGENT`: override agent used for extraction
+- `OPENCODE_MEMORY_EXTRACT_TIMEOUT_MS` (default `120000`): positive integer timeout for a native extraction request in milliseconds
 - `OPENCODE_MEMORY_RECALL_MODEL`: override model used for LLM memory recall selection
 - `OPENCODE_MEMORY_RECALL_AGENT` (default `opencode-memory-recall`): override agent used for LLM memory recall selection
 - `OPENCODE_MEMORY_AUTODREAM` (default `1`): set `0` to disable auto-dream consolidation

package/dist/index.js

@@ -6,6 +6,7 @@ import { isSupportedRecallSelectorClient, selectRelevantMemoryFilenames } from "
 import { scanMemoryFiles } from "./memoryScan.js";
 import { saveMemory, deleteMemory, listMemories, searchMemories, readMemory, MEMORY_TYPES, } from "./memory.js";
 import { getMemoryDir } from "./paths.js";
+import { getNativeExtractTimeoutMs, logNativeExtractionFailure } from "./nativeExtraction.js";
 const turnContextBySession = new Map();
 const selectorSessionIDs = new Set();
 function shouldIgnoreMemoryContext(query) {
@@ -282,7 +283,6 @@ For each memory worth saving, call \`memory_save\` with:
 5. Be selective: 0-3 memories per session is typical. Quality over quantity.
 6. Do NOT save a memory about the extraction process itself.`;
 const NATIVE_EXTRACT_DEBOUNCE_MS = 10000;
-const NATIVE_EXTRACT_TIMEOUT_MS = 120000; // hard cap on a single extraction fork (prevents permanent leak on hang)
 const NATIVE_EXTRACT_MAX_CONV_CHARS = 60000;
 const NATIVE_EXTRACT_GRACE_MS = 60000; // keep forkID in the guard after delete — covers the idle-race window
 const nativeIdleTimer = new Map();
@@ -335,7 +335,7 @@ function buildConversationForExtraction(messages) {
 }
 // Security: the extraction fork runs on raw, potentially-untrusted transcript content (fetched web
 // pages, tool output). It MUST be sandboxed to the memory tools only (no bash/edit/write) and capped
-// by a timeout so a hang can't leak the sub-session forever.
+// by a timeout so a hung prompt stops blocking best-effort sub-session cleanup.
 async function runNativeExtraction(client, sessionID, directory) {
     const c = client;
     if (!c?.session?.messages || !c.session.create || !c.session.prompt)
@@ -368,10 +368,10 @@ async function runNativeExtraction(client, sessionID, directory) {
         const extractModel = getNativeExtractModel();
         if (extractModel)
             body.model = extractModel;
-        // Race the prompt against a hard timeout so a hung/permission-gated fork can't leak.
+        // Race the prompt against a timeout so a hung/permission-gated fork stops blocking cleanup.
         let timer;
         const timeout = new Promise((_, reject) => {
-            timer = setTimeout(() => reject(new Error("native extraction timed out")), NATIVE_EXTRACT_TIMEOUT_MS);
+            timer = setTimeout(() => reject(new Error("native extraction timed out")), getNativeExtractTimeoutMs());
         });
         try {
             await Promise.race([
@@ -385,7 +385,7 @@ async function runNativeExtraction(client, sessionID, directory) {
         }
     }
     catch (e) {
-        console.error("[opencode-claude-memory] native extraction failed:", e?.message ?? e);
+        logNativeExtractionFailure(client, directory, sessionID, e);
     }
     finally {
         if (forkID) {
@@ -460,7 +460,7 @@ export const MemoryPlugin = async ({ worktree, directory, client }) => {
             nativeIdleTimer.set(sessionID, setTimeout(() => {
                 nativeIdleTimer.delete(sessionID);
                 void runNativeExtraction(client, sessionID, directory).catch((e) => {
-                    console.error("[opencode-claude-memory] native extraction failed:", e?.message ?? e);
+                    logNativeExtractionFailure(client, directory, sessionID, e);
                 });
             }, NATIVE_EXTRACT_DEBOUNCE_MS));
         },

package/dist/nativeExtraction.d.ts

@@ -0,0 +1,2 @@
+export declare function getNativeExtractTimeoutMs(raw?: string | undefined): number;
+export declare function logNativeExtractionFailure(client: unknown, directory: string, sessionID: string, error: unknown): void;

package/dist/nativeExtraction.js

@@ -0,0 +1,38 @@
+const DEFAULT_NATIVE_EXTRACT_TIMEOUT_MS = 120_000;
+const MAX_TIMER_DELAY_MS = 2_147_483_647;
+function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (error && typeof error === "object") {
+        const message = error.message;
+        if (typeof message === "string")
+            return message;
+    }
+    return String(error);
+}
+export function getNativeExtractTimeoutMs(raw = process.env.OPENCODE_MEMORY_EXTRACT_TIMEOUT_MS) {
+    const timeout = Number(raw);
+    return Number.isSafeInteger(timeout) && timeout > 0 && timeout <= MAX_TIMER_DELAY_MS
+        ? timeout
+        : DEFAULT_NATIVE_EXTRACT_TIMEOUT_MS;
+}
+export function logNativeExtractionFailure(client, directory, sessionID, error) {
+    const c = client;
+    if (!c?.app?.log)
+        return;
+    try {
+        const message = getErrorMessage(error);
+        void c.app.log({
+            body: {
+                service: "opencode-claude-memory",
+                level: "error",
+                message: "Native extraction failed",
+                extra: { error: message, sessionID },
+            },
+            query: { directory },
+        }).catch(() => { });
+    }
+    catch {
+        // Logging must stay best-effort: stderr is rendered into the OpenCode chat UI.
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-claude-memory",
-  "version": "1.7.5",
+  "version": "1.7.6",
   "type": "module",
   "description": "OpenCode plugin for Claude Code memory: persistent, local-first shared memory with Claude Code-compatible Markdown files, auto extraction, and auto-dream",
   "main": "dist/index.js",