opencode-mem 2.4.0 → 2.5.0

package/README.md

@@ -55,35 +55,31 @@ Configure at `~/.config/opencode/opencode-mem.jsonc`:
   "embeddingModel": "Xenova/nomic-embed-text-v1",
   "webServerEnabled": true,
   "webServerPort": 4747,
+  
   "autoCaptureEnabled": true,
+  "autoCaptureLanguage": "auto",
   "memoryProvider": "openai-chat",
-  "memoryModel": "gpt-4",
+  "memoryModel": "gpt-4o-mini",
+  "memoryApiUrl": "https://api.openai.com/v1",
+  "memoryApiKey": "sk-...",
+  
+  "showAutoCaptureToasts": true,
+  "showUserProfileToasts": true,
+  "showErrorToasts": true,
+  
   "userProfileAnalysisInterval": 10,
   "maxMemories": 10
 }
 ```
 
-Full documentation available in our [Configuration Guide](https://github.com/tickernelz/opencode-mem/wiki/Configuration-Guide).
-
-## Important: v2.3 Breaking Changes
-
-User-scoped memories removed. All memories now project-scoped. Update configuration:
-
+**API Key Formats:**
 ```jsonc
-// OLD: Remove these
-{
-  "userMemoryAnalysisInterval": 10,
-  "maxProjectMemories": 10
-}
-
-// NEW: Use only
-{
-  "userProfileAnalysisInterval": 10,
-  "maxMemories": 10
-}
+"memoryApiKey": "sk-..."
+"memoryApiKey": "file://~/.config/opencode/api-key.txt"
+"memoryApiKey": "env://OPENAI_API_KEY"
 ```
 
-Remove `scope` parameter from all `memory()` calls. See [Migration Guide](https://github.com/tickernelz/opencode-mem/wiki/Migration-v2-3) for details.
+Full documentation available in our [Configuration Guide](https://github.com/tickernelz/opencode-mem/wiki/Configuration-Guide).
 
 ## Documentation
 

package/dist/config.d.ts

@@ -13,6 +13,7 @@ export declare const CONFIG: {
     autoCaptureEnabled: boolean;
     autoCaptureMaxIterations: number;
     autoCaptureIterationTimeout: number;
+    autoCaptureLanguage: string | undefined;
     memoryProvider: "openai-chat" | "openai-responses" | "anthropic";
     memoryModel: string | undefined;
     memoryApiUrl: string | undefined;
@@ -32,6 +33,9 @@ export declare const CONFIG: {
     userProfileMaxWorkflows: number;
     userProfileConfidenceDecayDays: number;
     userProfileChangelogRetentionCount: number;
+    showAutoCaptureToasts: boolean;
+    showUserProfileToasts: boolean;
+    showErrorToasts: boolean;
 };
 export declare function isConfigured(): boolean;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAuVA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;oBAwBb,aAAa,GACb,kBAAkB,GAClB,WAAW;;;;;;;;;;;;;;;;;;;CAyBhB,CAAC;AAEF,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAuXA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;oBAyBb,aAAa,GACb,kBAAkB,GAClB,WAAW;;;;;;;;;;;;;;;;;;;;;;CA4BhB,CAAC;AAEF,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/config.js

@@ -2,6 +2,7 @@ import { existsSync, readFileSync, mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 import { stripJsoncComments } from "./services/jsonc.js";
+import { resolveSecretValue } from "./services/secret-resolver.js";
 const CONFIG_DIR = join(homedir(), ".config", "opencode");
 const DATA_DIR = join(homedir(), ".opencode-mem");
 const CONFIG_FILES = [
@@ -41,6 +42,9 @@ const DEFAULTS = {
     userProfileMaxWorkflows: 10,
     userProfileConfidenceDecayDays: 30,
     userProfileChangelogRetentionCount: 5,
+    showAutoCaptureToasts: true,
+    showUserProfileToasts: true,
+    showErrorToasts: true,
 };
 function expandPath(path) {
     if (path.startsWith("~/")) {
@@ -158,6 +162,11 @@ const CONFIG_TEMPLATE = `{
   "memoryModel": "gpt-4o-mini",
   "memoryApiUrl": "https://api.openai.com/v1",
   "memoryApiKey": "sk-...",
+
+  // API Key Formats:
+  // Direct value:        "sk-..."
+  // From file:           "file://~/.config/litellm-key.txt"
+  // From env variable:   "env://LITELLM_API_KEY"
   
   // Examples for different providers:
   // OpenAI Chat Completion (default, backward compatible):
@@ -193,6 +202,23 @@ const CONFIG_TEMPLATE = `{
   // Days to keep AI session history before cleanup
   "aiSessionRetentionDays": 7,
 
+  // Language for auto-capture summaries (default: "auto" for auto-detection)
+  // Options: "auto", "en", "id", "zh", "ja", "es", "fr", "de", "ru", "pt", "ar", "ko"
+  // "autoCaptureLanguage": "auto",
+
+  // ============================================
+  // Toast Notifications
+  // ============================================
+
+  // Show toast when memory is auto-captured
+  "showAutoCaptureToasts": true,
+
+  // Show toast when user profile is updated
+  "showUserProfileToasts": true,
+
+  // Show toast for error messages
+  "showErrorToasts": true,
+
   // ============================================
   // User Profile System
   // ============================================
@@ -285,7 +311,7 @@ export const CONFIG = {
         getEmbeddingDimensions(fileConfig.embeddingModel ?? DEFAULTS.embeddingModel),
     embeddingApiUrl: fileConfig.embeddingApiUrl,
     embeddingApiKey: fileConfig.embeddingApiUrl
-        ? (fileConfig.embeddingApiKey ?? process.env.OPENAI_API_KEY)
+        ? resolveSecretValue(fileConfig.embeddingApiKey ?? process.env.OPENAI_API_KEY)
         : undefined,
     similarityThreshold: fileConfig.similarityThreshold ?? DEFAULTS.similarityThreshold,
     maxMemories: fileConfig.maxMemories ?? DEFAULTS.maxMemories,
@@ -295,10 +321,11 @@ export const CONFIG = {
     autoCaptureEnabled: fileConfig.autoCaptureEnabled ?? DEFAULTS.autoCaptureEnabled,
     autoCaptureMaxIterations: fileConfig.autoCaptureMaxIterations ?? DEFAULTS.autoCaptureMaxIterations,
     autoCaptureIterationTimeout: fileConfig.autoCaptureIterationTimeout ?? DEFAULTS.autoCaptureIterationTimeout,
+    autoCaptureLanguage: fileConfig.autoCaptureLanguage,
     memoryProvider: (fileConfig.memoryProvider ?? "openai-chat"),
     memoryModel: fileConfig.memoryModel,
     memoryApiUrl: fileConfig.memoryApiUrl,
-    memoryApiKey: fileConfig.memoryApiKey,
+    memoryApiKey: resolveSecretValue(fileConfig.memoryApiKey),
     aiSessionRetentionDays: fileConfig.aiSessionRetentionDays ?? DEFAULTS.aiSessionRetentionDays,
     webServerEnabled: fileConfig.webServerEnabled ?? DEFAULTS.webServerEnabled,
     webServerPort: fileConfig.webServerPort ?? DEFAULTS.webServerPort,
@@ -314,6 +341,9 @@ export const CONFIG = {
     userProfileMaxWorkflows: fileConfig.userProfileMaxWorkflows ?? DEFAULTS.userProfileMaxWorkflows,
     userProfileConfidenceDecayDays: fileConfig.userProfileConfidenceDecayDays ?? DEFAULTS.userProfileConfidenceDecayDays,
     userProfileChangelogRetentionCount: fileConfig.userProfileChangelogRetentionCount ?? DEFAULTS.userProfileChangelogRetentionCount,
+    showAutoCaptureToasts: fileConfig.showAutoCaptureToasts ?? DEFAULTS.showAutoCaptureToasts,
+    showUserProfileToasts: fileConfig.showUserProfileToasts ?? DEFAULTS.showUserProfileToasts,
+    showErrorToasts: fileConfig.showErrorToasts ?? DEFAULTS.showErrorToasts,
 };
 export function isConfigured() {
     return true;

package/dist/index.js

@@ -148,7 +148,7 @@ export const OpenCodeMemPlugin = async (ctx) => {
             }
             catch (error) {
                 log("chat.message: ERROR", { error: String(error) });
-                if (ctx.client?.tui) {
+                if (ctx.client?.tui && CONFIG.showErrorToasts) {
                     await ctx.client.tui
                         .showToast({
                         body: {
@@ -392,7 +392,7 @@ export const OpenCodeMemPlugin = async (ctx) => {
                 })
                     .catch((err) => {
                     log("Auto-cleanup failed", { error: String(err) });
-                    if (ctx.client?.tui) {
+                    if (ctx.client?.tui && CONFIG.showErrorToasts) {
                         ctx.client.tui
                             .showToast({
                             body: {

package/dist/services/auto-capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-capture.d.ts","sourceRoot":"","sources":["../../src/services/auto-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAcvD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAgGf"}
+{"version":3,"file":"auto-capture.d.ts","sourceRoot":"","sources":["../../src/services/auto-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAcvD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAoGf"}

package/dist/services/auto-capture.js

@@ -37,7 +37,7 @@ export async function performAutoCapture(ctx, sessionID, directory) {
         const tags = getTags(directory);
         const latestMemory = await getLatestProjectMemory(tags.project.tag);
         const context = buildMarkdownContext(prompt.content, textResponses, toolCalls, latestMemory);
-        const summaryResult = await generateSummary(context, sessionID);
+        const summaryResult = await generateSummary(context, sessionID, prompt.content);
         if (!summaryResult || summaryResult.type === "skip") {
             log("Auto-capture: skipped non-technical conversation", { sessionID });
             userPromptManager.deletePrompt(prompt.id);
@@ -59,31 +59,35 @@ export async function performAutoCapture(ctx, sessionID, directory) {
         if (result.success) {
             userPromptManager.linkMemoryToPrompt(prompt.id, result.id);
             userPromptManager.markAsCaptured(prompt.id);
+            if (CONFIG.showAutoCaptureToasts) {
+                await ctx.client?.tui
+                    .showToast({
+                    body: {
+                        title: "Memory Captured",
+                        message: "Project memory saved from conversation",
+                        variant: "success",
+                        duration: 3000,
+                    },
+                })
+                    .catch(() => { });
+            }
+        }
+    }
+    catch (error) {
+        log("Auto-capture error", { sessionID, error: String(error) });
+        if (CONFIG.showErrorToasts) {
             await ctx.client?.tui
                 .showToast({
                 body: {
-                    title: "Memory Captured",
-                    message: "Project memory saved from conversation",
-                    variant: "success",
-                    duration: 3000,
+                    title: "Auto-Capture Failed",
+                    message: String(error),
+                    variant: "error",
+                    duration: 5000,
                 },
             })
                 .catch(() => { });
         }
     }
-    catch (error) {
-        log("Auto-capture error", { sessionID, error: String(error) });
-        await ctx.client?.tui
-            .showToast({
-            body: {
-                title: "Auto-Capture Failed",
-                message: String(error),
-                variant: "error",
-                duration: 5000,
-            },
-        })
-            .catch(() => { });
-    }
 }
 function extractAIContent(messages) {
     const textResponses = [];
@@ -180,11 +184,12 @@ function buildMarkdownContext(userPrompt, textResponses, toolCalls, latestMemory
     }
     return sections.join("\n");
 }
-async function generateSummary(context, sessionID) {
+async function generateSummary(context, sessionID, userPrompt) {
     if (!CONFIG.memoryModel || !CONFIG.memoryApiUrl) {
         throw new Error("External API not configured for auto-capture");
     }
     const { AIProviderFactory } = await import("./ai/ai-provider-factory.js");
+    const { detectLanguage, getLanguageName } = await import("./language-detector.js");
     const providerConfig = {
         model: CONFIG.memoryModel,
         apiUrl: CONFIG.memoryApiUrl,
@@ -193,6 +198,10 @@ async function generateSummary(context, sessionID) {
         iterationTimeout: CONFIG.autoCaptureIterationTimeout,
     };
     const provider = AIProviderFactory.createProvider(CONFIG.memoryProvider, providerConfig);
+    const targetLang = CONFIG.autoCaptureLanguage === "auto" || !CONFIG.autoCaptureLanguage
+        ? detectLanguage(userPrompt)
+        : CONFIG.autoCaptureLanguage;
+    const langName = getLanguageName(targetLang);
     const systemPrompt = `You are a technical memory recorder for a software development project.
 
 RULES:
@@ -200,34 +209,18 @@ RULES:
 2. SKIP non-technical by returning type="skip"
 3. NO meta-commentary or behavior analysis
 4. Include specific file names, functions, technical details
-5. DETECT the language used by the user. You MUST write the summary and reasoning in that SAME language.
+5. You MUST write the summary in ${langName}.
 
 FORMAT:
 ## Request
-[1-2 sentences: what was requested, in user's language]
+[1-2 sentences: what was requested, in ${langName}]
 
 ## Outcome
-[1-2 sentences: what was done, include files/functions, in user's language]
+[1-2 sentences: what was done, include files/functions, in ${langName}]
 
 SKIP if: greetings, casual chat, no code/decisions made
-CAPTURE if: code changed, bug fixed, feature added, decision made
-
-EXAMPLES:
-Technical (English) → type="feature":
-## Request
-Fix function returning null.
-## Outcome
-Changed searchMemories() to listMemories() in auto-capture.ts:166.
-
-Technical (Indonesian) → type="feature":
-## Request
-Perbaiki fungsi yang mengembalikan null.
-## Outcome
-Mengubah searchMemories() menjadi listMemories() di auto-capture.ts:166.
-
-Non-technical → type="skip", summary="":
-User greeted, AI introduced capabilities.`;
-    const userPrompt = `${context}
+CAPTURE if: code changed, bug fixed, feature added, decision made`;
+    const aiPrompt = `${context}
 
 Analyze this conversation. If it contains technical work (code, bugs, features, decisions), create a concise summary. If it's non-technical (greetings, casual chat, incomplete requests), return type="skip" with empty summary.`;
     const toolSchema = {
@@ -251,7 +244,7 @@ Analyze this conversation. If it contains technical work (code, bugs, features,
             },
         },
     };
-    const result = await provider.executeToolCall(systemPrompt, userPrompt, toolSchema, sessionID);
+    const result = await provider.executeToolCall(systemPrompt, aiPrompt, toolSchema, sessionID);
     if (!result.success || !result.data) {
         throw new Error(result.error || "Failed to generate summary");
     }

package/dist/services/language-detector.d.ts

@@ -0,0 +1,3 @@
+export declare function detectLanguage(text: string): string;
+export declare function getLanguageName(code: string): string;
+//# sourceMappingURL=language-detector.d.ts.map

package/dist/services/language-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detector.d.ts","sourceRoot":"","sources":["../../src/services/language-detector.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/services/language-detector.js

@@ -0,0 +1,16 @@
+import { franc } from "franc-min";
+import { iso6393, iso6393To1 } from "iso-639-3";
+export function detectLanguage(text) {
+    if (!text || text.trim().length === 0) {
+        return "en";
+    }
+    const detected = franc(text, { minLength: 10 });
+    if (detected === "und") {
+        return "en";
+    }
+    return iso6393To1[detected] || "en";
+}
+export function getLanguageName(code) {
+    const lang = iso6393.find((l) => l.iso6391 === code);
+    return lang?.name || "English";
+}

package/dist/services/secret-resolver.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveSecretValue(value: string | undefined): string | undefined;
+//# sourceMappingURL=secret-resolver.d.ts.map

package/dist/services/secret-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-resolver.d.ts","sourceRoot":"","sources":["../../src/services/secret-resolver.ts"],"names":[],"mappings":"AAiCA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAkChF"}

package/dist/services/secret-resolver.js

@@ -0,0 +1,55 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { homedir, platform } from "node:os";
+function expandPath(path) {
+    if (path.startsWith("~/")) {
+        return join(homedir(), path.slice(2));
+    }
+    if (path === "~") {
+        return homedir();
+    }
+    return path;
+}
+function checkFilePermissions(filePath) {
+    if (platform() === "win32") {
+        return;
+    }
+    try {
+        const stats = statSync(filePath);
+        const mode = stats.mode & 0o777;
+        if (mode > 0o600) {
+            console.warn(`Warning: Secret file ${filePath} has permissive permissions (${mode.toString(8)}). Recommend chmod 600.`);
+        }
+    }
+    catch (error) {
+        console.warn(`Warning: Could not check file permissions for ${filePath}`);
+    }
+}
+export function resolveSecretValue(value) {
+    if (!value) {
+        return undefined;
+    }
+    if (value.startsWith("file://")) {
+        const filePath = expandPath(value.slice(7));
+        if (!existsSync(filePath)) {
+            throw new Error(`Secret file not found: ${filePath}`);
+        }
+        try {
+            checkFilePermissions(filePath);
+            const content = readFileSync(filePath, "utf-8");
+            return content.trim();
+        }
+        catch (error) {
+            throw new Error(`Failed to read secret file ${filePath}: ${error}`);
+        }
+    }
+    if (value.startsWith("env://")) {
+        const envVar = value.slice(6);
+        const envValue = process.env[envVar];
+        if (!envValue) {
+            throw new Error(`Environment variable not found: ${envVar}`);
+        }
+        return envValue;
+    }
+    return value;
+}

package/dist/services/user-memory-learning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-memory-learning.d.ts","sourceRoot":"","sources":["../../src/services/user-memory-learning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASvD,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAmFf"}
+{"version":3,"file":"user-memory-learning.d.ts","sourceRoot":"","sources":["../../src/services/user-memory-learning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASvD,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuFf"}

package/dist/services/user-memory-learning.js

@@ -32,16 +32,18 @@ export async function performUserProfileLearning(ctx, directory) {
             userProfileManager.createProfile(userId, tags.user.displayName || "Unknown", tags.user.userName || "unknown", tags.user.userEmail || "unknown", updatedProfileData, prompts.length);
         }
         userPromptManager.markMultipleAsUserLearningCaptured(prompts.map((p) => p.id));
-        await ctx.client?.tui
-            .showToast({
-            body: {
-                title: "User Profile Updated",
-                message: `Analyzed ${prompts.length} prompts and updated your profile`,
-                variant: "success",
-                duration: 3000,
-            },
-        })
-            .catch(() => { });
+        if (CONFIG.showUserProfileToasts) {
+            await ctx.client?.tui
+                .showToast({
+                body: {
+                    title: "User Profile Updated",
+                    message: `Analyzed ${prompts.length} prompts and updated your profile`,
+                    variant: "success",
+                    duration: 3000,
+                },
+            })
+                .catch(() => { });
+        }
     }
     catch (error) {
         const errorStack = error instanceof Error ? error.stack : undefined;
@@ -50,16 +52,18 @@ export async function performUserProfileLearning(ctx, directory) {
             stack: errorStack,
             errorType: error instanceof Error ? error.constructor.name : typeof error,
         });
-        await ctx.client?.tui
-            .showToast({
-            body: {
-                title: "User Profile Update Failed",
-                message: String(error),
-                variant: "error",
-                duration: 5000,
-            },
-        })
-            .catch(() => { });
+        if (CONFIG.showErrorToasts) {
+            await ctx.client?.tui
+                .showToast({
+                body: {
+                    title: "User Profile Update Failed",
+                    message: String(error),
+                    variant: "error",
+                    duration: 5000,
+                },
+            })
+                .catch(() => { });
+        }
     }
 }
 function generateChangeSummary(oldProfile, newProfile) {
@@ -136,7 +140,7 @@ async function analyzeUserProfile(context, existingProfile) {
 
 Your task is to analyze user prompts and ${existingProfile ? "update" : "create"} a comprehensive user profile.
 
-CRITICAL: Detect the language used by the user. You MUST output all descriptions and text in the SAME language as the user's prompts.
+CRITICAL: Detect the language used by the user in their prompts. You MUST output all descriptions, categories, and text in the SAME language as the user's prompts.
 
 Use the update_user_profile tool to save the ${existingProfile ? "updated" : "new"} profile.`;
     const toolSchema = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-mem",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "OpenCode plugin that gives coding agents persistent memory using local vector database",
   "type": "module",
   "main": "dist/plugin.js",
@@ -34,6 +34,8 @@
   "dependencies": {
     "@opencode-ai/plugin": "^1.0.162",
     "@xenova/transformers": "^2.17.2",
+    "franc-min": "^6.2.0",
+    "iso-639-3": "^3.0.1",
     "sqlite-vec": "^0.1.7-alpha.2"
   },
   "devDependencies": {