@haisto/opencode-mem 2.14.3-beta.0

package/README.md

@@ -0,0 +1,165 @@
+# OpenCode Memory
+
+[![npm version](https://img.shields.io/npm/v/opencode-mem.svg)](https://www.npmjs.com/package/opencode-mem)
+[![npm downloads](https://img.shields.io/npm/dm/opencode-mem.svg)](https://www.npmjs.com/package/opencode-mem)
+[![license](https://img.shields.io/npm/l/opencode-mem.svg)](https://www.npmjs.com/package/opencode-mem)
+
+![OpenCode Memory Banner](.github/banner.png)
+
+A persistent memory system for AI coding agents that enables long-term context retention across sessions using local vector database technology.
+
+## Visual Overview
+
+**Project Memory Timeline:**
+
+![Project Memory Timeline](.github/screenshot-project-memory.png)
+
+**User Profile Viewer:**
+
+![User Profile Viewer](.github/screenshot-user-profile.png)
+
+## Core Features
+
+Local vector database with SQLite + USearch-first vector indexing and ExactScan fallback, persistent project memories, automatic user profile learning, unified memory-prompt timeline, full-featured web UI, intelligent prompt-based memory extraction, multi-provider AI support (OpenAI, Anthropic), 12+ local embedding models, smart deduplication, and built-in privacy protection.
+
+## Prerequisites
+
+This plugin uses `USearch` for preferred in-memory vector indexing with automatic ExactScan fallback. No custom SQLite build or browser runtime shim is required.
+
+**Recommended runtime:**
+
+- Bun
+- Standard OpenCode plugin environment
+
+**Notes:**
+
+- If `USearch` is unavailable or fails at runtime, the plugin automatically falls back to exact vector scanning.
+- SQLite remains the source of truth; search indexes are rebuilt from SQLite data when needed.
+
+## Getting Started
+
+Add to your OpenCode configuration at `~/.config/opencode/opencode.json`:
+
+```jsonc
+{
+  "plugin": ["opencode-mem"],
+}
+```
+
+The plugin downloads automatically on next startup.
+
+## Usage Examples
+
+```typescript
+memory({ mode: "add", content: "Project uses microservices architecture" });
+memory({ mode: "search", query: "architecture decisions" });
+memory({ mode: "search", query: "architecture decisions", scope: "all-projects" });
+memory({ mode: "profile" });
+memory({ mode: "list", limit: 10 });
+```
+
+Access the web interface at `http://127.0.0.1:4747` for visual memory browsing and management.
+
+## Configuration Essentials
+
+Configure at `~/.config/opencode/opencode-mem.jsonc`:
+
+```jsonc
+{
+  "storagePath": "~/.opencode-mem/data",
+  "userEmailOverride": "user@example.com",
+  "userNameOverride": "John Doe",
+  "embeddingModel": "Xenova/nomic-embed-text-v1",
+  "memory": {
+    "defaultScope": "project",
+  },
+  "webServerEnabled": true,
+  "webServerPort": 4747,
+
+  "autoCaptureEnabled": true,
+  "autoCaptureLanguage": "auto",
+
+  "opencodeProvider": "anthropic",
+  "opencodeModel": "claude-haiku-4-5-20251001",
+
+  "showAutoCaptureToasts": true,
+  "showUserProfileToasts": true,
+  "showErrorToasts": true,
+
+  "userProfileAnalysisInterval": 10,
+  "maxMemories": 10,
+
+  "compaction": {
+    "enabled": true,
+    "memoryLimit": 10,
+  },
+  "chatMessage": {
+    "enabled": true,
+    "maxMemories": 3,
+    "excludeCurrentSession": true,
+    "maxAgeDays": undefined,
+    "injectOn": "first",
+  },
+}
+```
+
+### Memory Scope
+
+- `scope: "project"`: query only the current project. This is the default.
+- `scope: "all-projects"`: query `search` / `list` across all project shards.
+- `memory.defaultScope` sets the default query scope when no explicit scope is provided.
+
+### Auto-Capture AI Provider
+
+**Recommended:** Use any provider that is already authenticated in opencode (no separate API key needed in this plugin):
+
+```jsonc
+"opencodeProvider": "anthropic",
+"opencodeModel": "claude-haiku-4-5-20251001",
+```
+
+The plugin issues structured-output requests to opencode's session API instead of calling provider endpoints directly, so opencode owns the auth, token refresh, and provider routing. Whatever you configured in opencode just works — Claude Pro/Max via OAuth, GitHub Copilot (personal & business), OpenAI / Anthropic API keys, custom providers, etc.
+
+Supported providers: any provider listed by `opencode providers list` (e.g. `anthropic`, `openai`, `github-copilot`, ...).
+
+**Fallback:** Manual API configuration (if not using opencodeProvider):
+
+```jsonc
+"memoryProvider": "openai-chat",
+"memoryModel": "gpt-4o-mini",
+"memoryApiUrl": "https://api.openai.com/v1",
+"memoryApiKey": "sk-...",
+```
+
+**API Key Formats:**
+
+```jsonc
+"memoryApiKey": "sk-..."
+"memoryApiKey": "file://~/.config/opencode/api-key.txt"
+"memoryApiKey": "env://OPENAI_API_KEY"
+```
+
+Full documentation available in this README.
+
+## Development & Contribution
+
+Build and test locally:
+
+```bash
+bun install
+bun run build
+bun run typecheck
+bun run format
+```
+
+This project is actively seeking contributions to become the definitive memory plugin for AI coding agents. Whether you are fixing bugs, adding features, improving documentation, or expanding embedding model support, your contributions are critical. The codebase is well-structured and ready for enhancement. If you hit a blocker or have improvement ideas, submit a pull request - we review and merge contributions quickly.
+
+## License & Links
+
+MIT License - see LICENSE file
+
+- **Repository**: https://github.com/tickernelz/opencode-mem
+- **Issues**: https://github.com/tickernelz/opencode-mem/issues
+- **OpenCode Platform**: https://opencode.ai
+
+Inspired by [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory)

package/dist/config.d.ts

@@ -0,0 +1,62 @@
+export declare let CONFIG: {
+    storagePath: string;
+    userEmailOverride: string | undefined;
+    userNameOverride: string | undefined;
+    embeddingModel: string;
+    embeddingDimensions: number;
+    embeddingApiUrl: string | undefined;
+    embeddingApiKey: string | undefined;
+    similarityThreshold: number;
+    maxMemories: number;
+    maxProfileItems: number;
+    injectProfile: boolean;
+    containerTagPrefix: string;
+    autoCaptureEnabled: boolean;
+    autoCaptureMaxIterations: number;
+    autoCaptureIterationTimeout: number;
+    autoCaptureLanguage: string | undefined;
+    memoryProvider: "openai-chat" | "openai-responses" | "anthropic";
+    memoryModel: string | undefined;
+    memoryApiUrl: string | undefined;
+    memoryApiKey: string | undefined;
+    memoryTemperature: number | false | undefined;
+    memoryExtraParams: Record<string, unknown> | undefined;
+    opencodeProvider: string | undefined;
+    opencodeModel: string | undefined;
+    vectorBackend: "usearch-first" | "usearch" | "exact-scan";
+    aiSessionRetentionDays: number;
+    webServerEnabled: boolean;
+    webServerPort: number;
+    webServerHost: string;
+    maxVectorsPerShard: number;
+    autoCleanupEnabled: boolean;
+    autoCleanupRetentionDays: number;
+    deduplicationEnabled: boolean;
+    deduplicationSimilarityThreshold: number;
+    userProfileAnalysisInterval: number;
+    userProfileMaxPreferences: number;
+    userProfileMaxPatterns: number;
+    userProfileMaxWorkflows: number;
+    userProfileConfidenceDecayDays: number;
+    userProfileChangelogRetentionCount: number;
+    showAutoCaptureToasts: boolean;
+    showUserProfileToasts: boolean;
+    showErrorToasts: boolean;
+    memory: {
+        defaultScope: "project" | "all-projects" | undefined;
+    };
+    compaction: {
+        enabled: boolean | undefined;
+        memoryLimit: number | undefined;
+    };
+    chatMessage: {
+        enabled: boolean | undefined;
+        maxMemories: number | undefined;
+        excludeCurrentSession: boolean | undefined;
+        maxAgeDays: number | undefined;
+        injectOn: "first" | "always";
+    };
+};
+export declare function initConfig(directory: string): void;
+export declare function isConfigured(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA2jBA,eAAO,IAAI,MAAM;;;;;;;;;;;;;;;;;oBA3DT,aAAa,GACb,kBAAkB,GAClB,WAAW;;;;;;;;mBASX,eAAe,GACf,SAAS,GACT,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuCV,OAAO,GACP,QAAQ;;CAMgC,CAAC;AAEnD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CASlD;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/config.js

@@ -0,0 +1,457 @@
+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 = [
+    join(CONFIG_DIR, "opencode-mem.jsonc"),
+    join(CONFIG_DIR, "opencode-mem.json"),
+];
+if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+}
+if (!existsSync(DATA_DIR)) {
+    mkdirSync(DATA_DIR, { recursive: true });
+}
+const DEFAULTS = {
+    storagePath: join(DATA_DIR, "data"),
+    embeddingModel: "Xenova/nomic-embed-text-v1",
+    embeddingDimensions: 768,
+    similarityThreshold: 0.6,
+    maxMemories: 10,
+    maxProfileItems: 5,
+    injectProfile: true,
+    containerTagPrefix: "opencode",
+    autoCaptureEnabled: true,
+    autoCaptureMaxIterations: 5,
+    autoCaptureIterationTimeout: 30000,
+    vectorBackend: "usearch-first",
+    aiSessionRetentionDays: 7,
+    webServerEnabled: true,
+    webServerPort: 4747,
+    webServerHost: "127.0.0.1",
+    maxVectorsPerShard: 50000,
+    autoCleanupEnabled: true,
+    autoCleanupRetentionDays: 30,
+    deduplicationEnabled: true,
+    deduplicationSimilarityThreshold: 0.9,
+    userProfileAnalysisInterval: 10,
+    userProfileMaxPreferences: 20,
+    userProfileMaxPatterns: 15,
+    userProfileMaxWorkflows: 10,
+    userProfileConfidenceDecayDays: 30,
+    userProfileChangelogRetentionCount: 5,
+    showAutoCaptureToasts: true,
+    showUserProfileToasts: true,
+    showErrorToasts: true,
+    memory: {
+        defaultScope: "project",
+    },
+    compaction: {
+        enabled: true,
+        memoryLimit: 10,
+    },
+    chatMessage: {
+        enabled: true,
+        maxMemories: 3,
+        excludeCurrentSession: true,
+        maxAgeDays: undefined,
+        injectOn: "first",
+    },
+};
+function expandPath(path) {
+    if (path.startsWith("~/")) {
+        return join(homedir(), path.slice(2));
+    }
+    if (path === "~") {
+        return homedir();
+    }
+    return path;
+}
+function loadConfigFromPaths(paths) {
+    for (const path of paths) {
+        if (existsSync(path)) {
+            try {
+                const content = readFileSync(path, "utf-8");
+                const json = stripJsoncComments(content);
+                return JSON.parse(json);
+            }
+            catch { }
+        }
+    }
+    return {};
+}
+const CONFIG_TEMPLATE = `{
+  // ============================================
+  // OpenCode Memory Plugin Configuration
+  // ============================================
+  
+  // Storage location for vector database
+  "storagePath": "~/.opencode-mem/data",
+
+  "userEmailOverride": "",
+  "userNameOverride": "",
+  
+  // ============================================
+  // Embedding Model (for similarity search)
+  // ============================================
+  
+  // Default: Nomic Embed v1 (768 dimensions, 8192 context, multilingual)
+  "embeddingModel": "Xenova/nomic-embed-text-v1",
+  
+  // Auto-detected dimensions (no need to set manually)
+  // "embeddingDimensions": 768,
+  
+  // Other recommended models:
+  // "embeddingModel": "Xenova/jina-embeddings-v2-base-en",  // 768 dims, English-only, 8192 context
+  // "embeddingModel": "Xenova/jina-embeddings-v2-small-en", // 512 dims, faster, 8192 context
+  // "embeddingModel": "Xenova/all-MiniLM-L6-v2",            // 384 dims, very fast, 512 context
+  // "embeddingModel": "Xenova/all-mpnet-base-v2",           // 768 dims, good quality, 512 context
+  
+  // Optional: Use OpenAI-compatible API for embeddings
+  // "embeddingApiUrl": "https://api.openai.com/v1",
+  // "embeddingApiKey": "sk-...",
+  // "embeddingModel": "text-embedding-3-small",  // 1536 dims, auto-detected
+  
+  // ============================================
+  // Web Server Settings
+  // ============================================
+  
+  // Enable web UI for managing memories (accessible at http://localhost:4747)
+  "webServerEnabled": true,
+  
+  // Port for web UI server
+  "webServerPort": 4747,
+  
+  // Host address for web UI (use 127.0.0.1 for local only, 0.0.0.0 for network access)
+  "webServerHost": "127.0.0.1",
+  
+  // ============================================
+  // Database Settings
+  // ============================================
+  
+  // Maximum vectors per database shard (auto-creates new shard when limit reached)
+  "maxVectorsPerShard": 50000,
+  
+  // Automatically delete old memories based on retention period
+  "autoCleanupEnabled": true,
+  
+  // Days to keep memories before auto-cleanup (only if autoCleanupEnabled is true)
+  "autoCleanupRetentionDays": 30,
+  
+  // Automatically detect and remove duplicate memories
+  "deduplicationEnabled": true,
+  
+   // Similarity threshold (0-1) for detecting duplicates (higher = stricter)
+   "deduplicationSimilarityThreshold": 0.90,
+   
+  // ============================================
+  // Memory Scope Settings
+  // ============================================
+
+  // Default scope for memory list/search queries
+  // "project" keeps queries within the current project, "all-projects" searches across all project shards
+  "memory": {
+    "defaultScope": "project"
+  },
+
+  // ============================================
+  // OpenCode Provider Settings (RECOMMENDED)
+  // ============================================
+
+   // Use any provider that is already authenticated in opencode for auto-capture
+   // and user profile learning. The plugin calls opencode's session.prompt API
+   // (with structured output) instead of talking to provider HTTPS endpoints
+   // directly, so opencode owns the auth, token refresh, and provider routing.
+   //
+   // No separate API key is needed in this plugin — whatever you configured in
+   // opencode (OAuth like Claude Pro/Max, GitHub Copilot personal/business,
+   // bring-your-own API key, custom provider, ...) just works.
+   //
+   // If NOT set, falls back to the manual config (memoryApiKey/memoryApiUrl/memoryModel below).
+   //
+   // Examples (the provider name must be one returned by 'opencode providers list'):
+   //   Anthropic (OAuth/API key): "opencodeProvider": "anthropic",      "opencodeModel": "claude-haiku-4-5-20251001"
+   //   OpenAI (API key):          "opencodeProvider": "openai",          "opencodeModel": "gpt-4o-mini"
+   //   GitHub Copilot:            "opencodeProvider": "github-copilot",  "opencodeModel": "gpt-4o-mini"
+   //
+   // "opencodeProvider": "anthropic",
+   // "opencodeModel": "claude-haiku-4-5-20251001",
+
+   // ============================================
+   // Auto-Capture Settings (REQUIRES EXTERNAL API)
+   // ============================================
+  
+  // IMPORTANT: Auto-capture ONLY works with external API
+  // It runs in background without blocking your main session
+  // Note: Ollama may not support tool calling. Use OpenAI, Anthropic, or Groq for best results.
+  
+  "autoCaptureEnabled": true,
+  
+  // Provider type: "openai-chat" | "openai-responses" | "anthropic"
+  // Note: "openai-chat" is a generic OpenAI API-compatible mode.
+  // Any service that follows the OpenAI Chat Completions API can use it via custom "memoryApiUrl".
+  "memoryProvider": "openai-chat",
+  
+  // REQUIRED for auto-capture (all 3 must be set):
+  "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:
+  // Any OpenAI-compatible endpoint can use the "openai-chat" provider pattern below.
+  // Common examples: DeepSeek, Qwen (via Alibaba Cloud ModelStudio),
+  // Zhipu GLM (BigModel platform), and Kimi (Moonshot AI platform).
+
+  // OpenAI Chat Completion (default, backward compatible):
+  //   "memoryProvider": "openai-chat"
+  //   "memoryModel": "gpt-4o-mini"
+  //   "memoryApiUrl": "https://api.openai.com/v1"
+  //   "memoryApiKey": "sk-..."
+
+  // DeepSeek (OpenAI-compatible example):
+  //   "memoryProvider": "openai-chat"
+  //   "memoryModel": "deepseek-chat"
+  //   "memoryApiUrl": "https://api.deepseek.com/v1"
+  //   "memoryApiKey": "sk-..."
+  
+  // OpenAI Responses API (recommended, with session support):
+  //   "memoryProvider": "openai-responses"
+  //   "memoryModel": "gpt-4o"
+  //   "memoryApiUrl": "https://api.openai.com/v1"
+  //   "memoryApiKey": "sk-..."
+  
+  // Anthropic (with session support):
+  //   "memoryProvider": "anthropic"
+  //   "memoryModel": "claude-3-5-haiku-20241022"
+  //   "memoryApiUrl": "https://api.anthropic.com/v1"
+  //   "memoryApiKey": "sk-ant-..."
+  
+  // Groq (OpenAI-compatible, use openai-chat provider):
+  //   "memoryProvider": "openai-chat"
+  //   "memoryModel": "llama-3.3-70b-versatile"
+  //   "memoryApiUrl": "https://api.groq.com/openai/v1"
+  //   "memoryApiKey": "gsk_..."
+  
+  // Maximum iterations for multi-turn AI analysis (for openai-responses and anthropic)
+  "autoCaptureMaxIterations": 5,
+   
+  // Timeout per iteration in milliseconds (30 seconds default)
+  "autoCaptureIterationTimeout": 30000,
+   
+  // Days to keep AI session history before cleanup
+  "aiSessionRetentionDays": 7,
+
+  // Temperature for AI API requests (set to false to omit parameter for models that don't support it)
+  // Some reasoning models (like o1, o3, gpt-5) don't support temperature parameter
+  // Set to false and add "memoryTemperature": false in config when using such models
+  "memoryTemperature": 0.3,
+
+  // Extra parameters to include in API request body
+  // Useful for local inference servers (e.g. llama-server with --jinja) that support
+  // additional parameters like disabling thinking/reasoning mode
+  // Example for Qwen3 models: { "enable_thinking": false }
+  // "memoryExtraParams": {},
+
+  // 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
+  // ============================================
+
+  // Analyze user prompts every N prompts to build/update your user profile
+  // When N uncaptured prompts accumulate, AI will analyze them to identify:
+  // - User preferences (code style, communication style, tool preferences)
+  // - User patterns (recurring topics, problem domains, technical interests)
+  // - User workflows (development habits, sequences, learning style)
+  // - Skill level (overall and per-domain assessment)
+  "userProfileAnalysisInterval": 10,
+  
+  // Maximum number of preferences to keep in user profile (sorted by confidence)
+  // Preferences are things like "prefers code without comments", "likes concise responses"
+  "userProfileMaxPreferences": 20,
+  
+  // Maximum number of patterns to keep in user profile (sorted by frequency)
+  // Patterns are recurring topics like "often asks about database optimization"
+  "userProfileMaxPatterns": 15,
+  
+  // Maximum number of workflows to keep in user profile (sorted by frequency)
+  // Workflows are sequences like "usually asks for tests after implementation"
+  "userProfileMaxWorkflows": 10,
+  
+  // Days before preference confidence starts to decay (if not reinforced)
+  // Preferences that aren't seen again will gradually lose confidence and be removed
+  "userProfileConfidenceDecayDays": 30,
+  
+  // Number of profile versions to keep in changelog (for rollback/debugging)
+  // Older versions are automatically cleaned up
+  "userProfileChangelogRetentionCount": 5,
+  
+  // ============================================
+  // Search Settings
+  // ============================================
+  
+  // Minimum similarity score (0-1) for memory search results
+  "similarityThreshold": 0.6,
+
+  // Maximum number of memories to return in search results
+  "maxMemories": 10,
+
+  // ============================================
+  // Advanced Settings
+  // ============================================
+  
+  // Inject user profile into AI context (preferences, patterns, workflows)
+  "injectProfile": true
+}
+`;
+function ensureConfigExists() {
+    const configPath = join(CONFIG_DIR, "opencode-mem.jsonc");
+    if (!existsSync(configPath)) {
+        try {
+            writeFileSync(configPath, CONFIG_TEMPLATE, "utf-8");
+            console.log(`\n✓ Created config template: ${configPath}`);
+            console.log("  Edit this file to customize opencode-mem settings.\n");
+        }
+        catch { }
+    }
+}
+ensureConfigExists();
+function getEmbeddingDimensions(model) {
+    const dimensionMap = {
+        // Local Xenova models
+        "Xenova/nomic-embed-text-v1": 768,
+        "Xenova/nomic-embed-text-v1-unsupervised": 768,
+        "Xenova/nomic-embed-text-v1-ablated": 768,
+        "Xenova/jina-embeddings-v2-base-en": 768,
+        "Xenova/jina-embeddings-v2-base-zh": 768,
+        "Xenova/jina-embeddings-v2-base-de": 768,
+        "Xenova/jina-embeddings-v2-small-en": 512,
+        "Xenova/all-MiniLM-L6-v2": 384,
+        "Xenova/all-MiniLM-L12-v2": 384,
+        "Xenova/all-mpnet-base-v2": 768,
+        "Xenova/bge-base-en-v1.5": 768,
+        "Xenova/bge-small-en-v1.5": 384,
+        "Xenova/gte-small": 384,
+        "Xenova/GIST-small-Embedding-v0": 384,
+        "Xenova/text-embedding-ada-002": 1536,
+        // OpenAI API models
+        "text-embedding-3-small": 1536,
+        "text-embedding-3-large": 3072,
+        "text-embedding-ada-002": 1536,
+        // Cohere API models
+        "embed-english-v3.0": 1024,
+        "embed-multilingual-v3.0": 1024,
+        "embed-english-light-v3.0": 384,
+        "embed-multilingual-light-v3.0": 384,
+        // Google API models
+        "text-embedding-004": 768,
+        "text-multilingual-embedding-002": 768,
+        // Voyage AI models
+        "voyage-3": 1024,
+        "voyage-3-lite": 512,
+        "voyage-code-3": 1024,
+    };
+    return dimensionMap[model] || 768;
+}
+function buildConfig(fileConfig) {
+    return {
+        storagePath: expandPath(fileConfig.storagePath ?? DEFAULTS.storagePath),
+        userEmailOverride: fileConfig.userEmailOverride,
+        userNameOverride: fileConfig.userNameOverride,
+        embeddingModel: fileConfig.embeddingModel ?? DEFAULTS.embeddingModel,
+        embeddingDimensions: fileConfig.embeddingDimensions ??
+            getEmbeddingDimensions(fileConfig.embeddingModel ?? DEFAULTS.embeddingModel),
+        embeddingApiUrl: fileConfig.embeddingApiUrl,
+        embeddingApiKey: fileConfig.embeddingApiUrl
+            ? resolveSecretValue(fileConfig.embeddingApiKey ?? process.env.OPENAI_API_KEY)
+            : undefined,
+        similarityThreshold: fileConfig.similarityThreshold ?? DEFAULTS.similarityThreshold,
+        maxMemories: fileConfig.maxMemories ?? DEFAULTS.maxMemories,
+        maxProfileItems: fileConfig.maxProfileItems ?? DEFAULTS.maxProfileItems,
+        injectProfile: fileConfig.injectProfile ?? DEFAULTS.injectProfile,
+        containerTagPrefix: fileConfig.containerTagPrefix ?? DEFAULTS.containerTagPrefix,
+        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: resolveSecretValue(fileConfig.memoryApiKey),
+        memoryTemperature: fileConfig.memoryTemperature,
+        memoryExtraParams: fileConfig.memoryExtraParams,
+        opencodeProvider: fileConfig.opencodeProvider,
+        opencodeModel: fileConfig.opencodeModel,
+        vectorBackend: (fileConfig.vectorBackend ?? "usearch-first"),
+        aiSessionRetentionDays: fileConfig.aiSessionRetentionDays ?? DEFAULTS.aiSessionRetentionDays,
+        webServerEnabled: fileConfig.webServerEnabled ?? DEFAULTS.webServerEnabled,
+        webServerPort: fileConfig.webServerPort ?? DEFAULTS.webServerPort,
+        webServerHost: fileConfig.webServerHost ?? DEFAULTS.webServerHost,
+        maxVectorsPerShard: fileConfig.maxVectorsPerShard ?? DEFAULTS.maxVectorsPerShard,
+        autoCleanupEnabled: fileConfig.autoCleanupEnabled ?? DEFAULTS.autoCleanupEnabled,
+        autoCleanupRetentionDays: fileConfig.autoCleanupRetentionDays ?? DEFAULTS.autoCleanupRetentionDays,
+        deduplicationEnabled: fileConfig.deduplicationEnabled ?? DEFAULTS.deduplicationEnabled,
+        deduplicationSimilarityThreshold: fileConfig.deduplicationSimilarityThreshold ?? DEFAULTS.deduplicationSimilarityThreshold,
+        userProfileAnalysisInterval: fileConfig.userProfileAnalysisInterval ?? DEFAULTS.userProfileAnalysisInterval,
+        userProfileMaxPreferences: fileConfig.userProfileMaxPreferences ?? DEFAULTS.userProfileMaxPreferences,
+        userProfileMaxPatterns: fileConfig.userProfileMaxPatterns ?? DEFAULTS.userProfileMaxPatterns,
+        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,
+        memory: {
+            defaultScope: fileConfig.memory?.defaultScope ?? DEFAULTS.memory.defaultScope,
+        },
+        compaction: {
+            enabled: fileConfig.compaction?.enabled ?? DEFAULTS.compaction.enabled,
+            memoryLimit: fileConfig.compaction?.memoryLimit ?? DEFAULTS.compaction.memoryLimit,
+        },
+        chatMessage: {
+            enabled: fileConfig.chatMessage?.enabled ?? DEFAULTS.chatMessage.enabled,
+            maxMemories: fileConfig.chatMessage?.maxMemories ?? DEFAULTS.chatMessage.maxMemories,
+            excludeCurrentSession: fileConfig.chatMessage?.excludeCurrentSession ?? DEFAULTS.chatMessage.excludeCurrentSession,
+            maxAgeDays: fileConfig.chatMessage?.maxAgeDays,
+            injectOn: (fileConfig.chatMessage?.injectOn ?? DEFAULTS.chatMessage.injectOn),
+        },
+    };
+}
+let _globalFileConfig = loadConfigFromPaths(CONFIG_FILES);
+export let CONFIG = buildConfig(_globalFileConfig);
+export function initConfig(directory) {
+    const projectPaths = [
+        join(directory, ".opencode", "opencode-mem.jsonc"),
+        join(directory, ".opencode", "opencode-mem.json"),
+    ];
+    const globalConfig = loadConfigFromPaths(CONFIG_FILES);
+    const projectConfig = loadConfigFromPaths(projectPaths);
+    const merged = { ...globalConfig, ...projectConfig };
+    CONFIG = buildConfig(merged);
+}
+export function isConfigured() {
+    return true;
+}