om-memory-system 3.3.0-next.17 → 3.3.1

package/README.md

@@ -26,8 +26,7 @@ the other. Everything is stored locally on your machine.
   OpenCode v1.
 - **Learns your preferences.** A user profile of your habits builds up over
   time and follows you across projects.
-- **Imports your past sessions.** One command turns old OpenCode or Pi
-  history into memories and a profile.
+- **Imports your past sessions.** Pi and OpenCode import older history after startup. A command provides a preview and manual control.
 - **Lets you look and edit.** A local web page shows every memory and your
   profile.
 - **Keeps private things private.** Text inside `<private>` tags is never
@@ -98,13 +97,12 @@ See [Configuration](docs/configuration.md#choosing-the-model).
 ### 3. Check it works
 
 Work normally for a few turns, then open `http://127.0.0.1:4747` in your
-browser (OpenCode serves this page). New memories appear on the timeline.
+browser. OpenCode or the login web app serves this page. New memories appear on the timeline.
 You can also ask the agent: "search memory for what we changed today".
 
 ## Import your past history
 
-To turn earlier sessions into memories, preview first and then run it inside
-the agent:
+Older sessions import automatically after a host starts. This makes model calls. To opt out, set `"autoBackfill": false` in `~/.config/omms/omms.jsonc` before starting. For a manual import or custom source, preview inside the agent:
 
 ```text
 /memory-import-opencode-history --dry-run

package/dist/adapters/opencode/backfill-models.d.ts

@@ -0,0 +1,25 @@
+import { selectImportModel } from "../../importer/model-selection.js";
+import type { HistoryImportModels } from "../../importer/run-import.js";
+import { createOpencodeImportModels } from "../../services/ai/opencode-import-models.js";
+interface BackfillConfig {
+    opencodeBackfillModel?: string;
+    opencodeProvider?: string;
+    opencodeModel?: string;
+    memoryProvider?: string;
+    memoryModel?: string;
+    memoryApiUrl?: string;
+    memoryApiKey?: string;
+}
+export interface OpenCodeBackfillContext {
+    connected: string[];
+    directory: string;
+    configModel: () => Promise<string | null>;
+    makeModels?: typeof createOpencodeImportModels;
+    externalModels?: typeof selectImportModel;
+}
+/** Apply the live-model rule when inherit is selected; named models need sign-in. */
+export declare function resolveOpencodeBackfillModels(config: BackfillConfig | undefined, context: OpenCodeBackfillContext): Promise<{
+    model: string;
+    models: HistoryImportModels;
+}>;
+export {};

package/dist/adapters/opencode/backfill-models.js

@@ -0,0 +1,39 @@
+import { CONFIG } from "../../config.js";
+import { parseBackfillModel } from "../../importer/backfill-model.js";
+import { selectImportModel } from "../../importer/model-selection.js";
+import { getAutoCaptureProviderStatus } from "../../services/ai/live-model-choice.js";
+import { createOpencodeImportModels, } from "../../services/ai/opencode-import-models.js";
+/** Apply the live-model rule when inherit is selected; named models need sign-in. */
+export async function resolveOpencodeBackfillModels(config = CONFIG, context) {
+    const choice = parseBackfillModel(config, "opencode");
+    let ref;
+    if (choice === "inherit") {
+        const live = getAutoCaptureProviderStatus(config);
+        if (!live.ready)
+            throw new Error(`OpenCode backfill: ${live.issues.join("; ")}`);
+        if (live.mode === "manual") {
+            const external = (context.externalModels ?? selectImportModel)({});
+            return {
+                model: `${external.provider}/${external.modelId}`,
+                models: { capture: external.capture, profile: external.profile },
+            };
+        }
+        const selected = live.mode === "opencode"
+            ? `${config.opencodeProvider}/${config.opencodeModel}`
+            : await context.configModel();
+        if (!selected)
+            throw new Error("OpenCode backfill: no configured default model");
+        const parsed = parseBackfillModel({ opencodeBackfillModel: selected }, "opencode");
+        if (parsed === "inherit")
+            throw new Error("OpenCode backfill: no configured default model");
+        ref = { providerID: parsed.provider, modelID: parsed.model };
+    }
+    else {
+        ref = { providerID: choice.provider, modelID: choice.model };
+    }
+    if (!context.connected.includes(ref.providerID)) {
+        throw new Error(`OpenCode backfill provider ${ref.providerID} is not connected`);
+    }
+    const models = await (context.makeModels ?? createOpencodeImportModels)(ref, context.directory);
+    return { model: `${ref.providerID}/${ref.modelID}`, models };
+}

package/dist/adapters/opencode/backfill-startup.d.ts

@@ -0,0 +1,7 @@
+/** Start after connected providers load, without delaying plugin initialisation. */
+export declare function startOpencodeBackfill(input: {
+    directory: string;
+    connected: string[];
+    configModel: () => Promise<string | null>;
+    notify: (message: string) => void;
+}): Promise<void>;

package/dist/adapters/opencode/backfill-startup.js

@@ -0,0 +1,12 @@
+import { CONFIG } from "../../config.js";
+import { scheduleAutoBackfill } from "../../importer/auto-backfill.js";
+import { resolveOpencodeBackfillModels } from "./backfill-models.js";
+/** Start after connected providers load, without delaying plugin initialisation. */
+export function startOpencodeBackfill(input) {
+    return scheduleAutoBackfill({
+        host: "opencode",
+        cwd: input.directory,
+        resolveModels: () => resolveOpencodeBackfillModels(CONFIG, input),
+        notify: input.notify,
+    });
+}

package/dist/adapters/opencode/import-command.js

@@ -4,6 +4,7 @@ import { formatHistoryImportReport, summarizeHistoryImportReport, runHistoryImpo
 import { createOpencodeImportModels, } from "../../services/ai/opencode-import-models.js";
 export { createOpencodeImportModels } from "../../services/ai/opencode-import-models.js";
 import { loadOpencodeProvider } from "../../services/ai/opencode-provider-loader.js";
+import { beginManualImport } from "../../importer/manual-import-guard.js";
 import { memoryClient } from "../../services/client.js";
 import { log } from "../../services/logger.js";
 /**
@@ -42,6 +43,7 @@ export async function runOpencodeImportCommand(input) {
     if (importCommandRunning)
         return `${name}: an import is already running`;
     importCommandRunning = true;
+    const endManualImport = beginManualImport("opencode");
     try {
         let ref = null;
         if (parsed.model || importNeedsModel(parsed)) {
@@ -82,6 +84,7 @@ export async function runOpencodeImportCommand(input) {
         return `${name} failed: ${message}`;
     }
     finally {
+        endManualImport();
         importCommandRunning = false;
     }
 }

package/dist/adapters/pi/backfill-models.d.ts

@@ -0,0 +1,9 @@
+import type { HistoryImportModels } from "../../importer/run-import.js";
+import { type PiModelContext } from "./provider.js";
+/** Resolve the Pi backfill independently of the manual import's session-model rule. */
+export declare function resolvePiBackfillModels(ctx: PiModelContext, config?: {
+    piBackfillModel?: string;
+}): Promise<{
+    model: string;
+    models: HistoryImportModels;
+}>;

package/dist/adapters/pi/backfill-models.js

@@ -0,0 +1,30 @@
+import { CONFIG } from "../../config.js";
+import { parseBackfillModel } from "../../importer/backfill-model.js";
+import { createPiLiveModels } from "./live-model.js";
+import { adaptPiProfileModel } from "./profile.js";
+import { createPiCaptureProvider, resolveImportModel } from "./provider.js";
+/** Resolve the Pi backfill independently of the manual import's session-model rule. */
+export async function resolvePiBackfillModels(ctx, config = CONFIG) {
+    const choice = parseBackfillModel(config, "pi");
+    if (choice === "inherit") {
+        const live = createPiLiveModels(ctx);
+        const profile = live.profile();
+        if (!profile)
+            throw new Error("Pi backfill: no live-capture model is available");
+        const model = profile.modelId || CONFIG.memoryModel;
+        return {
+            model: `${profile.provider}/${model ?? "unknown"}`,
+            models: { capture: live.capture, profile },
+        };
+    }
+    const selected = resolveImportModel(ctx, `${choice.provider}/${choice.model}`);
+    if (!selected)
+        throw new Error(`Pi backfill model not found: ${choice.provider}/${choice.model}`);
+    return {
+        model: `${selected.provider}/${selected.modelId}`,
+        models: {
+            capture: createPiCaptureProvider(() => selected),
+            profile: adaptPiProfileModel(selected),
+        },
+    };
+}

package/dist/adapters/pi/extension.js

@@ -11,6 +11,7 @@ import { registerPiHistoryImportCommand } from "./import-command.js";
 import { performPiProfileLearning } from "./profile.js";
 import { buildRetrievalSection, wrapRetrievalSection } from "../../core/retrieval.js";
 const GLOBAL_PLUGIN_WARMUP_KEY = Symbol.for("omms.plugin.warmedup");
+const GLOBAL_PI_BACKFILL_KEY = Symbol.for("omms.pi.backfill.scheduled");
 const OMMS_STATUS_KEY = "omms";
 const MEMORY_TOOL_MODES = [
     "add",
@@ -70,6 +71,7 @@ export default function ommsPiExtension(pi) {
     // Latest session context, refreshed on session_start and consumed by the
     // import command (command contexts do not expose the model registry).
     let latestCtx = null;
+    let backfillSessionId = null;
     let statusVersion = 0;
     const startStatus = (ctx, status) => {
         const version = ++statusVersion;
@@ -101,7 +103,50 @@ export default function ommsPiExtension(pi) {
             // Runs even with tracing off, so turning it off does not leave old traces behind.
             pruneTraces(CONFIG);
             captureState = createPiCaptureState();
+            if (CONFIG.webServerAutoStart !== undefined &&
+                process.env.OMMS_DISABLE_WEB_AUTOSTART !== "1") {
+                void import("../../services/web-autostart.js")
+                    .then(({ reconcileWebAutostart }) => reconcileWebAutostart(CONFIG))
+                    .catch((error) => log("Pi login item reconciliation failed", {
+                    code: error instanceof Error ? error.name : "unknown",
+                }));
+            }
             const globalScope = globalThis;
+            const sessionId = ctx.sessionManager.getSessionId();
+            if (isConfigured() &&
+                CONFIG.autoBackfill &&
+                process.env.OMMS_DISABLE_AUTO_BACKFILL !== "1" &&
+                !globalScope[GLOBAL_PI_BACKFILL_KEY] &&
+                backfillSessionId !== sessionId) {
+                backfillSessionId = sessionId;
+                const controller = new AbortController();
+                const task = { controller, promise: Promise.resolve() };
+                globalScope[GLOBAL_PI_BACKFILL_KEY] = task;
+                task.promise = (async () => {
+                    const { scheduleAutoBackfill } = await import("../../importer/auto-backfill.js");
+                    await scheduleAutoBackfill({
+                        host: "pi",
+                        cwd: ctx.cwd,
+                        signal: controller.signal,
+                        resolveModels: async () => {
+                            const { resolvePiBackfillModels } = await import("./backfill-models.js");
+                            return resolvePiBackfillModels(ctx);
+                        },
+                        notify: (message) => {
+                            if (!controller.signal.aborted && ctx.hasUI)
+                                ctx.ui.notify(message, "info");
+                        },
+                    });
+                })()
+                    .catch((error) => log("Pi backfill failed", {
+                    error: error instanceof Error ? error.message : String(error),
+                }))
+                    .finally(() => {
+                    if (globalScope[GLOBAL_PI_BACKFILL_KEY] === task) {
+                        delete globalScope[GLOBAL_PI_BACKFILL_KEY];
+                    }
+                });
+            }
             if (!globalScope[GLOBAL_PLUGIN_WARMUP_KEY] && isConfigured()) {
                 (async () => {
                     try {
@@ -192,6 +237,11 @@ export default function ommsPiExtension(pi) {
         captureState = createPiCaptureState();
         promptsSinceProfileAnalysis = [];
         globalThis[GLOBAL_PLUGIN_WARMUP_KEY] = false;
+        const task = globalThis[GLOBAL_PI_BACKFILL_KEY];
+        task?.controller.abort();
+        if (task)
+            await task.promise;
+        backfillSessionId = null;
         try {
             await memoryClient.close();
         }

package/dist/adapters/pi/import-command.js

@@ -5,6 +5,7 @@ import { historyImportUsage, importNeedsModel, parseHistoryImportArgs, tokenizeI
 import { formatHistoryImportReport, summarizeHistoryImportReport, runHistoryImport, } from "../../importer/run-import.js";
 import { createPiCaptureProvider, resolveImportModel } from "./provider.js";
 import { adaptPiProfileModel } from "./profile.js";
+import { beginManualImport } from "../../importer/manual-import-guard.js";
 /**
  * Pi command surface for the historical-session importer:
  *
@@ -74,6 +75,7 @@ export function registerPiHistoryImportCommand(pi, getExtensionContext) {
                 return;
             }
             importCommandRunning = true;
+            const endManualImport = beginManualImport("pi");
             try {
                 // Best-effort warmup so failures surface as per-unit errors instead of
                 // every unit failing on embedding initialisation.
@@ -110,6 +112,7 @@ export function registerPiHistoryImportCommand(pi, getExtensionContext) {
                 notify(`memory-import-pi-history failed: ${message}`);
             }
             finally {
+                endManualImport();
                 importCommandRunning = false;
             }
         },

package/dist/cli/index.js

@@ -11,8 +11,10 @@ const usage = `Usage: om-memory-system <command> [options]
 Commands:
   import-opencode-history   Import OpenCode history into omms
   import-pi-history         Import Pi history into omms
+  web                       Start the web app in the foreground
+  web install|uninstall|status  Manage the web app login item
 
-Both commands take the same options; run one with --help to see them.
+Import commands take the same options; run one with --help to see them.
 Inside a session, /memory-import-opencode-history and /memory-import-pi-history
 use that session's model instead of an API key.`;
 export function parseImportArgs(argv) {
@@ -30,6 +32,16 @@ export async function runCli(argv) {
         console.log(usage);
         return 0;
     }
+    if (argv[0] === "web") {
+        try {
+            const { runWebCommand } = await import("./web-command.js");
+            return await runWebCommand(argv.slice(1));
+        }
+        catch (error) {
+            console.error(`OMMS web command failed: ${error instanceof Error ? error.message : String(error)}`);
+            return 1;
+        }
+    }
     const apiKeyEnv = argv.find((_, index) => argv[index - 1] === "--api-key-env") ??
         argv.find((value) => value.startsWith("--api-key-env="))?.slice("--api-key-env=".length);
     try {

package/dist/cli/web-command.d.ts

@@ -0,0 +1,3 @@
+import type { WebAutostartOptions } from "../services/web-autostart.js";
+/** Run the standalone web app or manage its per-user login item. */
+export declare function runWebCommand(args: string[], options?: WebAutostartOptions, online?: () => Promise<boolean>): Promise<number>;

package/dist/cli/web-command.js

@@ -0,0 +1,72 @@
+import { homedir } from "node:os";
+/** Run the standalone web app or manage its per-user login item. */
+export async function runWebCommand(args, options = {}, online) {
+    const home = options.home ?? homedir();
+    const config = await import("../config.js");
+    config.initConfig(home);
+    const { installWebAutostart, removeWebAutostart, webAutostartStatus } = await import("../services/web-autostart.js");
+    const [action, ...rest] = args;
+    if (rest.length ||
+        (action && !["install", "uninstall", "status", "--login-item"].includes(action))) {
+        console.error("Usage: om-memory-system web [install|uninstall|status]");
+        return 1;
+    }
+    if (action === "install" && !config.CONFIG.webServerEnabled) {
+        console.error("OMMS web server is disabled (webServerEnabled is false)");
+        return 1;
+    }
+    if (action === "install" || action === "uninstall") {
+        const { readGlobalConfigRevision, writeGlobalConfigKeys } = await import("../services/global-config-writer.js");
+        await writeGlobalConfigKeys({ webServerAutoStart: action === "install" }, readGlobalConfigRevision());
+        config.initConfig(home);
+        const result = action === "install"
+            ? installWebAutostart({ ...options, start: true })
+            : removeWebAutostart({ ...options, start: true });
+        console.log(`OMMS login item: ${result.state}`);
+        return action === "install" && result.state !== "installed" ? 1 : 0;
+    }
+    if (action === "status") {
+        const status = webAutostartStatus(options);
+        const check = online ??
+            (async () => {
+                const { WebServer } = await import("../services/web-server.js");
+                return new WebServer({
+                    port: config.CONFIG.webServerPort,
+                    host: config.CONFIG.webServerHost,
+                    enabled: true,
+                    apiToken: config.CONFIG.webServerApiToken,
+                }).checkServerAvailable();
+            });
+        console.log(JSON.stringify({ setting: config.CONFIG.webServerAutoStart, item: status, online: await check() }, null, 2));
+        return 0;
+    }
+    if (!config.CONFIG.webServerEnabled) {
+        console.error("OMMS web server is disabled (webServerEnabled is false)");
+        return 1;
+    }
+    const { WebAuth } = await import("../services/web-auth.js");
+    const { startWebServer } = await import("../services/web-server.js");
+    const server = await startWebServer({
+        directory: home,
+        port: config.CONFIG.webServerPort,
+        host: config.CONFIG.webServerHost,
+        enabled: true,
+        apiToken: config.CONFIG.webServerApiToken,
+        auth: new WebAuth({
+            password: config.CONFIG.webServerAuthPassword,
+            username: config.CONFIG.webServerAuthUsername,
+        }),
+    });
+    console.log(`OMMS web app: ${server.getUrl()}`);
+    // The Node HTTP adapter unrefs its socket for plugin use. Keep the CLI alive.
+    const keeper = setInterval(() => { }, 60_000);
+    const stop = () => {
+        clearInterval(keeper);
+        process.off("SIGINT", stop);
+        process.off("SIGTERM", stop);
+        void server.stop();
+    };
+    process.once("SIGINT", stop);
+    process.once("SIGTERM", stop);
+    return 0;
+}

package/dist/config.d.ts

@@ -42,6 +42,10 @@ interface OmmsConfig {
     captureTrace?: boolean;
     captureTraceRetentionDays?: number;
     captureAttemptRetentionDays?: number;
+    autoBackfill?: boolean;
+    opencodeBackfillModel?: string;
+    piBackfillModel?: string;
+    webServerAutoStart?: boolean;
     webServerEnabled?: boolean;
     webServerPort?: number;
     webServerHost?: string;
@@ -89,7 +93,7 @@ interface OmmsConfig {
         injectOn?: "first" | "always";
     };
 }
-export declare const CONFIG_TEMPLATE = "{\n  // ============================================\n  // omms (Opinionated Modular Memory System) Configuration\n  // ============================================\n  \n  // Storage location for the vector database. Leave unset to use the\n  // default ~/.omms/data (a legacy ~/.opencode-mem/data store is migrated\n  // there automatically on first start; see docs/omms-migration.md).\n  // \"storagePath\": \"~/.omms/data\",\n\n  \"userEmailOverride\": \"\",\n  \"userNameOverride\": \"\",\n  \n  // ============================================\n  // Embedding Model (for similarity search)\n  // ============================================\n  // Local = Hugging Face / ONNX via @huggingface/transformers (not Apple MLX).\n  // Remote = set BOTH embeddingApiUrl and embeddingApiKey (OpenAI-compatible /embeddings).\n  \n  // Default: Nomic Embed v1 (768 dimensions, 8192 context, multilingual)\n  \"embeddingModel\": \"Xenova/nomic-embed-text-v1\",\n\n  // Opt-in Nomic task prefixes (search_document: / search_query:). After enabling,\n  // re-index existing memories so store and query vectors stay aligned.\n  // \"embeddingUseTaskPrefixes\": true,\n  \n  // Auto-detected dimensions (no need to set manually)\n  // \"embeddingDimensions\": 768,\n  \n  // Other recommended local models:\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-base-en\",  // 768 dims, English-only, 8192 context\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-small-en\", // 512 dims, faster, 8192 context\n  // \"embeddingModel\": \"Xenova/all-MiniLM-L6-v2\",            // 384 dims, very fast, 512 context\n  // \"embeddingModel\": \"Xenova/all-mpnet-base-v2\",           // 768 dims, good quality, 512 context\n  \n  // Optional: OpenAI-compatible API for embeddings (both URL and key required)\n  // \"embeddingApiUrl\": \"https://api.openai.com/v1\",\n  // \"embeddingApiKey\": \"env://OPENAI_API_KEY\",  // or \"sk-...\" / \"file:///path/to/key\"\n  // \"embeddingModel\": \"text-embedding-3-small\",  // 1536 dims, auto-detected\n \n  // ============================================\n  // Web Server Settings\n  // ============================================\n  \n  // Enable web UI for managing memories (accessible at http://localhost:4747)\n  \"webServerEnabled\": true,\n  \n  // Port for web UI server\n  \"webServerPort\": 4747,\n  \n  // Host address for web UI (use 127.0.0.1 for local only, 0.0.0.0 for network access)\n  \"webServerHost\": \"127.0.0.1\",\n\n  // Optional HTTP Basic Auth for the web UI. Accepts literal, env://, or file:// secrets.\n  // \"webServerAuthPassword\": \"\",\n  // \"webServerAuthUsername\": \"\",\n\n  // Required when webServerHost is not loopback. Protects /api/* with Bearer / X-Opencode-Mem-Token.\n  // \"webServerApiToken\": \"env://OMMS_WEB_TOKEN\",\n  \n  // ============================================\n  // Database Settings\n  // ============================================\n  \n  // Maximum vectors per database shard (auto-creates new shard when limit reached)\n  \"maxVectorsPerShard\": 50000,\n  \n  // Automatically delete old memories based on retention period\n  \"autoCleanupEnabled\": true,\n  \n  // Days to keep memories before auto-cleanup (only if autoCleanupEnabled is true)\n  \"autoCleanupRetentionDays\": 30,\n  \n  // Automatically detect and remove duplicate memories\n  \"deduplicationEnabled\": true,\n  \n   // Similarity threshold (0-1) for detecting duplicates (higher = stricter)\n   \"deduplicationSimilarityThreshold\": 0.90,\n   \n  // ============================================\n  // Memory Scope Settings\n  // ============================================\n\n  // Default scope for memory list/search queries\n  // \"project\" keeps queries within the current project, \"all-projects\" searches across all project shards\n  \"memory\": {\n    \"defaultScope\": \"project\"\n  },\n\n  // ============================================\n  // Model for auto-capture and profile learning (same rule in OpenCode and Pi)\n  // ============================================\n\n   // Which model summarises your work, in this order:\n   //   1. The host model below: opencodeProvider/opencodeModel in OpenCode,\n   //      piProvider/piModel in Pi. Set the model to \"inherit\" to follow\n   //      whatever model the session is using.\n   //   2. If no host model is set: the external API (memoryModel/memoryApiUrl/\n   //      memoryApiKey further down).\n   //   3. If neither is set: the session's own model.\n   // If the host model fails and the external API is configured, the external\n   // API is used instead.\n   //\n   // Host models go through OpenCode's or Pi's own sign-in (OAuth like Claude\n   // Pro/Max, GitHub Copilot, ChatGPT, or your own key there), so no separate API\n   // key is needed here.\n   //\n   // Examples (OpenCode names from 'opencode providers list'; Pi names from its model list):\n   //   \"opencodeProvider\": \"anthropic\",    \"opencodeModel\": \"claude-haiku-4-5-20251001\"\n   //   \"opencodeProvider\": \"openai\",       \"opencodeModel\": \"inherit\"\n   //   \"piProvider\": \"openai-codex\",       \"piModel\": \"gpt-5.6-luna\"\n   //\n   // \"opencodeProvider\": \"anthropic\",\n   // \"opencodeModel\": \"claude-haiku-4-5-20251001\",\n   // \"piProvider\": \"openai-codex\",\n   // \"piModel\": \"gpt-5.6-luna\",\n\n   // ============================================\n   // Auto-Capture Settings\n   // ============================================\n  \n  // Auto-capture runs in the background without blocking your main session.\n  // Note: Ollama may not support tool calling. Use OpenAI, Anthropic, or Groq for best results.\n  \n  \"autoCaptureEnabled\": true,\n  \n  // Provider type: \"openai-chat\" | \"openai-responses\" | \"anthropic\" | \"minimax\" | \"orcarouter\"\n  // Note: \"openai-chat\" is a generic OpenAI API-compatible mode.\n  // Any service that follows the OpenAI Chat Completions API can use it via custom \"memoryApiUrl\".\n  \"memoryProvider\": \"openai-chat\",\n  \n  // External API (step 2 above, and the fallback when a host model fails).\n  // Uncomment all 3 lines and replace memoryApiKey before use:\n  // \"memoryModel\": \"gpt-4o-mini\",\n  // \"memoryApiUrl\": \"https://api.openai.com/v1\",\n  // \"memoryApiKey\": \"sk-...\",\n\n  // API Key Formats:\n  // Direct value:        \"sk-...\"\n  // From file:           \"file://~/.config/litellm-key.txt\"\n  // From env variable:   \"env://LITELLM_API_KEY\"\n  \n  // Examples for different providers:\n  // Any OpenAI-compatible endpoint can use the \"openai-chat\" provider pattern below.\n  // Common examples: DeepSeek, Qwen (via Alibaba Cloud ModelStudio),\n  // Zhipu GLM (BigModel platform), and Kimi (Moonshot AI platform).\n\n  // OpenAI Chat Completion (default, backward compatible):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"gpt-4o-mini\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n\n  // DeepSeek (OpenAI-compatible example):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"deepseek-chat\"\n  //   \"memoryApiUrl\": \"https://api.deepseek.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // OpenAI Responses API (recommended, with session support):\n  //   \"memoryProvider\": \"openai-responses\"\n  //   \"memoryModel\": \"gpt-4o\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // Anthropic (with session support):\n  //   \"memoryProvider\": \"anthropic\"\n  //   \"memoryModel\": \"claude-3-5-haiku-20241022\"\n  //   \"memoryApiUrl\": \"https://api.anthropic.com/v1\"\n  //   \"memoryApiKey\": \"sk-ant-...\"\n\n  // MiniMax (Anthropic Messages-compatible endpoint, with session support):\n  //   \"memoryProvider\": \"minimax\"\n  //   \"memoryModel\": \"MiniMax-M3\"\n  //   \"memoryApiUrl\": \"https://api.minimax.io\"        // global endpoint\n  //   \"memoryApiKey\": \"<MiniMax API key>\"\n  //   // China endpoint: \"memoryApiUrl\": \"https://api.minimaxi.com\"\n  //   // Optional adaptive thinking for MiniMax-M3:\n  //   \"memoryExtraParams\": { \"thinking\": { \"type\": \"adaptive\" } }\n\n  // OrcaRouter (OpenAI-compatible gateway, namespaced model IDs, with session support):\n  //   \"memoryProvider\": \"orcarouter\"\n  //   \"memoryApiKey\": \"<OrcaRouter API key>\"\n  //   // memoryApiUrl and memoryModel are optional \u2014 they default to\n  //   // https://api.orcarouter.ai/v1 and \"orcarouter/auto\" (a routing alias).\n  //   // OrcaRouter rejects bare model names, so if you set memoryModel, use a\n  //   // namespaced ID such as \"openai/gpt-5.5\" or \"deepseek/deepseek-v4-flash\".\n  //   \"memoryModel\": \"openai/gpt-5.5\"\n\n  // Groq (OpenAI-compatible, use openai-chat provider):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"llama-3.3-70b-versatile\"\n  //   \"memoryApiUrl\": \"https://api.groq.com/openai/v1\"\n  //   \"memoryApiKey\": \"gsk_...\"\n  \n  // Maximum iterations for multi-turn AI analysis (for openai-responses, anthropic, and minimax)\n  \"autoCaptureMaxIterations\": 5,\n   \n  // Timeout per iteration in milliseconds (30 seconds default)\n  \"autoCaptureIterationTimeout\": 30000,\n\n  // Maximum number of times to retry capturing a prompt if it fails (due to network, API errors, etc.)\n  \"autoCaptureMaxRetries\": 3,\n\n  // Maximum UTF-8 bytes for the auto-capture markdown context sent to the summary model.\n  // Prevents HTTP 400 context overflows on models with ~131K token windows (e.g. Groq Llama).\n  // Rough guide: tokens \u2248 bytes / 4 for mixed code/prose.\n  \"autoCaptureMaxContextBytes\": 131072,\n   \n  // Days to keep AI session history before cleanup\n  \"aiSessionRetentionDays\": 7,\n\n  // Capture diagnostics: every capture attempt always writes one metadata line\n  // (model, stop reason, sizes, outcome) to ~/.omms/omms.log, with no\n  // conversation text. Set captureTrace to true to also write each attempt's\n  // prompt and raw reply to ~/.omms/traces/ for debugging. Traces can contain\n  // conversation content: <private> text and common API key formats are\n  // redacted, files are readable only by you, and they are deleted after\n  // captureTraceRetentionDays. Only this global file can turn tracing on.\n  // \"captureTrace\": false,\n  // \"captureTraceRetentionDays\": 7,\n  // \"captureAttemptRetentionDays\": 30,\n\n  // Temperature for AI API requests (set to false to omit parameter for models that don't support it)\n  // Some reasoning models (like o1, o3, gpt-5) don't support temperature parameter\n  // Set to false and add \"memoryTemperature\": false in config when using such models\n  \"memoryTemperature\": 0.3,\n\n  // Extra parameters to include in API request body\n  // Useful for local inference servers (e.g. llama-server with --jinja) that support\n  // additional parameters like disabling thinking/reasoning mode\n  // Example for Qwen3 models: { \"enable_thinking\": false }\n  // \"memoryExtraParams\": {},\n\n  // Language for auto-capture summaries (default: \"auto\" for auto-detection)\n  // Options: \"auto\", \"en\", \"id\", \"zh\", \"ja\", \"es\", \"fr\", \"de\", \"ru\", \"pt\", \"ar\", \"ko\"\n  // \"autoCaptureLanguage\": \"auto\",\n\n  // ============================================\n  // Toast Notifications\n  // ============================================\n\n  // Show toast when memory is auto-captured\n  \"showAutoCaptureToasts\": true,\n\n  // Show toast when user profile is updated\n  \"showUserProfileToasts\": true,\n\n  // Show toast for error messages\n  \"showErrorToasts\": true,\n\n  // ============================================\n  // User Profile System\n  // ============================================\n\n  // Analyze user prompts every N prompts to build/update your user profile\n  // When N uncaptured prompts accumulate, AI will analyze them to identify:\n  // - User preferences (code style, communication style, tool preferences)\n  // - User patterns (recurring topics, problem domains, technical interests)\n  // - User workflows (development habits, sequences, learning style)\n  // - Skill level (overall and per-domain assessment)\n  \"userProfileAnalysisInterval\": 10,\n\n  // Days before inactive items (all types) are eligible for removal\n  \"userProfileStaleDays\": 2,\n\n  // Number of preferences shown in UI\n  \"userProfileDisplayPreferences\": 20,\n  \n  // Number of patterns shown in UI\n  \"userProfileDisplayPatterns\": 15,\n  \n  // Number of workflows shown in UI\n  \"userProfileDisplayWorkflows\": 10,\n  \n  // Number of preferences injected into LLM conversation context\n  // Keep this small \u2014 the strongest signals are enough; more dilute LLM attention\n  \"userProfileInjectPreferences\": 5,\n  \n  // Number of patterns injected into LLM conversation context\n  \"userProfileInjectPatterns\": 5,\n  \n  // Number of workflows injected into LLM conversation context\n  \"userProfileInjectWorkflows\": 3,\n  \n  // Days before preference confidence starts to decay (if not reinforced)\n  // Preferences that aren't seen again will gradually lose confidence and be removed\n  \"userProfileConfidenceDecayDays\": 30,\n  \n  // Number of profile versions to keep in changelog (for rollback/debugging)\n  // Older versions are automatically cleaned up\n  \"userProfileChangelogRetentionCount\": 5,\n\n  // Minimum evidence count for a preference/pattern to survive confidence decay\n  // Items confirmed fewer times are more likely to be pruned when confidence decays\n  \"userProfileMinEvidenceForRetention\": 3,\n\n  // Periodically merge duplicate or irrelevant profile items with the configured AI provider\n  \"userProfileAutoCleanupEnabled\": true,\n  // Number of analyzed user prompts between automatic AI cleanup runs\n  \"userProfileAutoCleanupInterval\": 100,\n\n  // Enable LLM validation of existing preferences against recent behavior.\n  // When enabled, each analysis round checks if top-5 preferences still match recent prompts.\n  // Experimental \u2014 disabled by default.\n  \"userProfileValidationEnabled\": false,\n\n  // ============================================\n  // Search Settings\n  // ============================================\n  \n  // Minimum similarity score (0-1) for memory search results\n  \"similarityThreshold\": 0.6,\n\n  // Maximum number of memories to return in search results\n  \"maxMemories\": 10,\n\n  // ============================================\n  // Advanced Settings\n  // ============================================\n  \n  // Inject user profile into AI context (preferences, patterns, workflows)\n  \"injectProfile\": true\n}\n";
+export declare const CONFIG_TEMPLATE = "{\n  // ============================================\n  // omms (Opinionated Modular Memory System) Configuration\n  // ============================================\n  \n  // Storage location for the vector database. Leave unset to use the\n  // default ~/.omms/data (a legacy ~/.opencode-mem/data store is migrated\n  // there automatically on first start; see docs/omms-migration.md).\n  // \"storagePath\": \"~/.omms/data\",\n\n  \"userEmailOverride\": \"\",\n  \"userNameOverride\": \"\",\n  \n  // ============================================\n  // Embedding Model (for similarity search)\n  // ============================================\n  // Local = Hugging Face / ONNX via @huggingface/transformers (not Apple MLX).\n  // Remote = set BOTH embeddingApiUrl and embeddingApiKey (OpenAI-compatible /embeddings).\n  \n  // Default: Nomic Embed v1 (768 dimensions, 8192 context, multilingual)\n  \"embeddingModel\": \"Xenova/nomic-embed-text-v1\",\n\n  // Opt-in Nomic task prefixes (search_document: / search_query:). After enabling,\n  // re-index existing memories so store and query vectors stay aligned.\n  // \"embeddingUseTaskPrefixes\": true,\n  \n  // Auto-detected dimensions (no need to set manually)\n  // \"embeddingDimensions\": 768,\n  \n  // Other recommended local models:\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-base-en\",  // 768 dims, English-only, 8192 context\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-small-en\", // 512 dims, faster, 8192 context\n  // \"embeddingModel\": \"Xenova/all-MiniLM-L6-v2\",            // 384 dims, very fast, 512 context\n  // \"embeddingModel\": \"Xenova/all-mpnet-base-v2\",           // 768 dims, good quality, 512 context\n  \n  // Optional: OpenAI-compatible API for embeddings (both URL and key required)\n  // \"embeddingApiUrl\": \"https://api.openai.com/v1\",\n  // \"embeddingApiKey\": \"env://OPENAI_API_KEY\",  // or \"sk-...\" / \"file:///path/to/key\"\n  // \"embeddingModel\": \"text-embedding-3-small\",  // 1536 dims, auto-detected\n \n  // ============================================\n  // Web Server Settings\n  // ============================================\n  \n  // Start a background import of past chats on each host's next start.\n  \"autoBackfill\": true,\n  // \"piBackfillModel\": \"inherit\", // or \"provider/model\"\n  // \"opencodeBackfillModel\": \"inherit\", // or \"provider/model\"\n\n  // Register the web app to start when you log in.\n  \"webServerAutoStart\": true,\n  // Enable web UI for managing memories (accessible at http://localhost:4747)\n  \"webServerEnabled\": true,\n  \n  // Port for web UI server\n  \"webServerPort\": 4747,\n  \n  // Host address for web UI (use 127.0.0.1 for local only, 0.0.0.0 for network access)\n  \"webServerHost\": \"127.0.0.1\",\n\n  // Optional HTTP Basic Auth for the web UI. Accepts literal, env://, or file:// secrets.\n  // \"webServerAuthPassword\": \"\",\n  // \"webServerAuthUsername\": \"\",\n\n  // Required when webServerHost is not loopback. Protects /api/* with Bearer / X-Opencode-Mem-Token.\n  // \"webServerApiToken\": \"env://OMMS_WEB_TOKEN\",\n  \n  // ============================================\n  // Database Settings\n  // ============================================\n  \n  // Maximum vectors per database shard (auto-creates new shard when limit reached)\n  \"maxVectorsPerShard\": 50000,\n  \n  // Automatically delete old memories based on retention period\n  \"autoCleanupEnabled\": true,\n  \n  // Days to keep memories before auto-cleanup (only if autoCleanupEnabled is true)\n  \"autoCleanupRetentionDays\": 30,\n  \n  // Automatically detect and remove duplicate memories\n  \"deduplicationEnabled\": true,\n  \n   // Similarity threshold (0-1) for detecting duplicates (higher = stricter)\n   \"deduplicationSimilarityThreshold\": 0.90,\n   \n  // ============================================\n  // Memory Scope Settings\n  // ============================================\n\n  // Default scope for memory list/search queries\n  // \"project\" keeps queries within the current project, \"all-projects\" searches across all project shards\n  \"memory\": {\n    \"defaultScope\": \"project\"\n  },\n\n  // ============================================\n  // Model for auto-capture and profile learning (same rule in OpenCode and Pi)\n  // ============================================\n\n   // Which model summarises your work, in this order:\n   //   1. The host model below: opencodeProvider/opencodeModel in OpenCode,\n   //      piProvider/piModel in Pi. Set the model to \"inherit\" to follow\n   //      whatever model the session is using.\n   //   2. If no host model is set: the external API (memoryModel/memoryApiUrl/\n   //      memoryApiKey further down).\n   //   3. If neither is set: the session's own model.\n   // If the host model fails and the external API is configured, the external\n   // API is used instead.\n   //\n   // Host models go through OpenCode's or Pi's own sign-in (OAuth like Claude\n   // Pro/Max, GitHub Copilot, ChatGPT, or your own key there), so no separate API\n   // key is needed here.\n   //\n   // Examples (OpenCode names from 'opencode providers list'; Pi names from its model list):\n   //   \"opencodeProvider\": \"anthropic\",    \"opencodeModel\": \"claude-haiku-4-5-20251001\"\n   //   \"opencodeProvider\": \"openai\",       \"opencodeModel\": \"inherit\"\n   //   \"piProvider\": \"openai-codex\",       \"piModel\": \"gpt-5.6-luna\"\n   //\n   // \"opencodeProvider\": \"anthropic\",\n   // \"opencodeModel\": \"claude-haiku-4-5-20251001\",\n   // \"piProvider\": \"openai-codex\",\n   // \"piModel\": \"gpt-5.6-luna\",\n\n   // ============================================\n   // Auto-Capture Settings\n   // ============================================\n  \n  // Auto-capture runs in the background without blocking your main session.\n  // Note: Ollama may not support tool calling. Use OpenAI, Anthropic, or Groq for best results.\n  \n  \"autoCaptureEnabled\": true,\n  \n  // Provider type: \"openai-chat\" | \"openai-responses\" | \"anthropic\" | \"minimax\" | \"orcarouter\"\n  // Note: \"openai-chat\" is a generic OpenAI API-compatible mode.\n  // Any service that follows the OpenAI Chat Completions API can use it via custom \"memoryApiUrl\".\n  \"memoryProvider\": \"openai-chat\",\n  \n  // External API (step 2 above, and the fallback when a host model fails).\n  // Uncomment all 3 lines and replace memoryApiKey before use:\n  // \"memoryModel\": \"gpt-4o-mini\",\n  // \"memoryApiUrl\": \"https://api.openai.com/v1\",\n  // \"memoryApiKey\": \"sk-...\",\n\n  // API Key Formats:\n  // Direct value:        \"sk-...\"\n  // From file:           \"file://~/.config/litellm-key.txt\"\n  // From env variable:   \"env://LITELLM_API_KEY\"\n  \n  // Examples for different providers:\n  // Any OpenAI-compatible endpoint can use the \"openai-chat\" provider pattern below.\n  // Common examples: DeepSeek, Qwen (via Alibaba Cloud ModelStudio),\n  // Zhipu GLM (BigModel platform), and Kimi (Moonshot AI platform).\n\n  // OpenAI Chat Completion (default, backward compatible):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"gpt-4o-mini\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n\n  // DeepSeek (OpenAI-compatible example):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"deepseek-chat\"\n  //   \"memoryApiUrl\": \"https://api.deepseek.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // OpenAI Responses API (recommended, with session support):\n  //   \"memoryProvider\": \"openai-responses\"\n  //   \"memoryModel\": \"gpt-4o\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // Anthropic (with session support):\n  //   \"memoryProvider\": \"anthropic\"\n  //   \"memoryModel\": \"claude-3-5-haiku-20241022\"\n  //   \"memoryApiUrl\": \"https://api.anthropic.com/v1\"\n  //   \"memoryApiKey\": \"sk-ant-...\"\n\n  // MiniMax (Anthropic Messages-compatible endpoint, with session support):\n  //   \"memoryProvider\": \"minimax\"\n  //   \"memoryModel\": \"MiniMax-M3\"\n  //   \"memoryApiUrl\": \"https://api.minimax.io\"        // global endpoint\n  //   \"memoryApiKey\": \"<MiniMax API key>\"\n  //   // China endpoint: \"memoryApiUrl\": \"https://api.minimaxi.com\"\n  //   // Optional adaptive thinking for MiniMax-M3:\n  //   \"memoryExtraParams\": { \"thinking\": { \"type\": \"adaptive\" } }\n\n  // OrcaRouter (OpenAI-compatible gateway, namespaced model IDs, with session support):\n  //   \"memoryProvider\": \"orcarouter\"\n  //   \"memoryApiKey\": \"<OrcaRouter API key>\"\n  //   // memoryApiUrl and memoryModel are optional \u2014 they default to\n  //   // https://api.orcarouter.ai/v1 and \"orcarouter/auto\" (a routing alias).\n  //   // OrcaRouter rejects bare model names, so if you set memoryModel, use a\n  //   // namespaced ID such as \"openai/gpt-5.5\" or \"deepseek/deepseek-v4-flash\".\n  //   \"memoryModel\": \"openai/gpt-5.5\"\n\n  // Groq (OpenAI-compatible, use openai-chat provider):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"llama-3.3-70b-versatile\"\n  //   \"memoryApiUrl\": \"https://api.groq.com/openai/v1\"\n  //   \"memoryApiKey\": \"gsk_...\"\n  \n  // Maximum iterations for multi-turn AI analysis (for openai-responses, anthropic, and minimax)\n  \"autoCaptureMaxIterations\": 5,\n   \n  // Timeout per iteration in milliseconds (30 seconds default)\n  \"autoCaptureIterationTimeout\": 30000,\n\n  // Maximum number of times to retry capturing a prompt if it fails (due to network, API errors, etc.)\n  \"autoCaptureMaxRetries\": 3,\n\n  // Maximum UTF-8 bytes for the auto-capture markdown context sent to the summary model.\n  // Prevents HTTP 400 context overflows on models with ~131K token windows (e.g. Groq Llama).\n  // Rough guide: tokens \u2248 bytes / 4 for mixed code/prose.\n  \"autoCaptureMaxContextBytes\": 131072,\n   \n  // Days to keep AI session history before cleanup\n  \"aiSessionRetentionDays\": 7,\n\n  // Capture diagnostics: every capture attempt always writes one metadata line\n  // (model, stop reason, sizes, outcome) to ~/.omms/omms.log, with no\n  // conversation text. Set captureTrace to true to also write each attempt's\n  // prompt and raw reply to ~/.omms/traces/ for debugging. Traces can contain\n  // conversation content: <private> text and common API key formats are\n  // redacted, files are readable only by you, and they are deleted after\n  // captureTraceRetentionDays. Only this global file can turn tracing on.\n  // \"captureTrace\": false,\n  // \"captureTraceRetentionDays\": 7,\n  // \"captureAttemptRetentionDays\": 30,\n\n  // Temperature for AI API requests (set to false to omit parameter for models that don't support it)\n  // Some reasoning models (like o1, o3, gpt-5) don't support temperature parameter\n  // Set to false and add \"memoryTemperature\": false in config when using such models\n  \"memoryTemperature\": 0.3,\n\n  // Extra parameters to include in API request body\n  // Useful for local inference servers (e.g. llama-server with --jinja) that support\n  // additional parameters like disabling thinking/reasoning mode\n  // Example for Qwen3 models: { \"enable_thinking\": false }\n  // \"memoryExtraParams\": {},\n\n  // Language for auto-capture summaries (default: \"auto\" for auto-detection)\n  // Options: \"auto\", \"en\", \"id\", \"zh\", \"ja\", \"es\", \"fr\", \"de\", \"ru\", \"pt\", \"ar\", \"ko\"\n  // \"autoCaptureLanguage\": \"auto\",\n\n  // ============================================\n  // Toast Notifications\n  // ============================================\n\n  // Show toast when memory is auto-captured\n  \"showAutoCaptureToasts\": true,\n\n  // Show toast when user profile is updated\n  \"showUserProfileToasts\": true,\n\n  // Show toast for error messages\n  \"showErrorToasts\": true,\n\n  // ============================================\n  // User Profile System\n  // ============================================\n\n  // Analyze user prompts every N prompts to build/update your user profile\n  // When N uncaptured prompts accumulate, AI will analyze them to identify:\n  // - User preferences (code style, communication style, tool preferences)\n  // - User patterns (recurring topics, problem domains, technical interests)\n  // - User workflows (development habits, sequences, learning style)\n  // - Skill level (overall and per-domain assessment)\n  \"userProfileAnalysisInterval\": 10,\n\n  // Days before inactive items (all types) are eligible for removal\n  \"userProfileStaleDays\": 2,\n\n  // Number of preferences shown in UI\n  \"userProfileDisplayPreferences\": 20,\n  \n  // Number of patterns shown in UI\n  \"userProfileDisplayPatterns\": 15,\n  \n  // Number of workflows shown in UI\n  \"userProfileDisplayWorkflows\": 10,\n  \n  // Number of preferences injected into LLM conversation context\n  // Keep this small \u2014 the strongest signals are enough; more dilute LLM attention\n  \"userProfileInjectPreferences\": 5,\n  \n  // Number of patterns injected into LLM conversation context\n  \"userProfileInjectPatterns\": 5,\n  \n  // Number of workflows injected into LLM conversation context\n  \"userProfileInjectWorkflows\": 3,\n  \n  // Days before preference confidence starts to decay (if not reinforced)\n  // Preferences that aren't seen again will gradually lose confidence and be removed\n  \"userProfileConfidenceDecayDays\": 30,\n  \n  // Number of profile versions to keep in changelog (for rollback/debugging)\n  // Older versions are automatically cleaned up\n  \"userProfileChangelogRetentionCount\": 5,\n\n  // Minimum evidence count for a preference/pattern to survive confidence decay\n  // Items confirmed fewer times are more likely to be pruned when confidence decays\n  \"userProfileMinEvidenceForRetention\": 3,\n\n  // Periodically merge duplicate or irrelevant profile items with the configured AI provider\n  \"userProfileAutoCleanupEnabled\": true,\n  // Number of analyzed user prompts between automatic AI cleanup runs\n  \"userProfileAutoCleanupInterval\": 100,\n\n  // Enable LLM validation of existing preferences against recent behavior.\n  // When enabled, each analysis round checks if top-5 preferences still match recent prompts.\n  // Experimental \u2014 disabled by default.\n  \"userProfileValidationEnabled\": false,\n\n  // ============================================\n  // Search Settings\n  // ============================================\n  \n  // Minimum similarity score (0-1) for memory search results\n  \"similarityThreshold\": 0.6,\n\n  // Maximum number of memories to return in search results\n  \"maxMemories\": 10,\n\n  // ============================================\n  // Advanced Settings\n  // ============================================\n  \n  // Inject user profile into AI context (preferences, patterns, workflows)\n  \"injectProfile\": true\n}\n";
 export declare function normalizeAutoCaptureMaxContextBytes(value: number): number;
 export declare function normalizeAutoCleanupRetentionDays(value: number): number;
 declare function buildConfig(fileConfig: OmmsConfig): {
@@ -127,6 +131,10 @@ declare function buildConfig(fileConfig: OmmsConfig): {
     captureTrace: boolean;
     captureTraceRetentionDays: number;
     captureAttemptRetentionDays: number;
+    autoBackfill: boolean;
+    opencodeBackfillModel: string;
+    piBackfillModel: string;
+    webServerAutoStart: boolean;
     webServerEnabled: boolean;
     webServerPort: number;
     webServerHost: string;
@@ -215,6 +223,10 @@ export declare let CONFIG: {
     captureTrace: boolean;
     captureTraceRetentionDays: number;
     captureAttemptRetentionDays: number;
+    autoBackfill: boolean;
+    opencodeBackfillModel: string;
+    piBackfillModel: string;
+    webServerAutoStart: boolean;
     webServerEnabled: boolean;
     webServerPort: number;
     webServerHost: string;

package/dist/config.js

@@ -6,6 +6,7 @@ import { log } from "./services/logger.js";
 import { resolveSecretValue } from "./services/secret-resolver.js";
 import { isPlaceholderApiKey } from "./services/ai/api-key-placeholder.js";
 import { getAutoCaptureProviderStatus } from "./services/ai/live-model-choice.js";
+import { parseBackfillModel } from "./importer/backfill-model.js";
 import { resolveDefaultStoragePath, runLegacyStoreMigration, legacyMigrationPaths, } from "./services/legacy-migration.js";
 const OMMS_CONFIG_DIR = join(homedir(), ".config", "omms");
 const DATA_DIR = join(homedir(), ".omms");
@@ -51,6 +52,10 @@ const DEFAULTS = {
     captureTrace: false,
     captureTraceRetentionDays: 7,
     captureAttemptRetentionDays: 30,
+    autoBackfill: true,
+    opencodeBackfillModel: "inherit",
+    piBackfillModel: "inherit",
+    webServerAutoStart: true,
     webServerEnabled: true,
     webServerPort: 4747,
     webServerHost: "127.0.0.1",
@@ -191,6 +196,13 @@ export const CONFIG_TEMPLATE = `{
   // Web Server Settings
   // ============================================
   
+  // Start a background import of past chats on each host's next start.
+  "autoBackfill": true,
+  // "piBackfillModel": "inherit", // or "provider/model"
+  // "opencodeBackfillModel": "inherit", // or "provider/model"
+
+  // Register the web app to start when you log in.
+  "webServerAutoStart": true,
   // Enable web UI for managing memories (accessible at http://localhost:4747)
   "webServerEnabled": true,
   
@@ -548,6 +560,13 @@ function buildConfig(fileConfig) {
         getEmbeddingDimensions(fileConfig.embeddingModel ?? DEFAULTS.embeddingModel);
     const autoCaptureMaxContextBytes = normalizeAutoCaptureMaxContextBytes(fileConfig.autoCaptureMaxContextBytes ?? DEFAULTS.autoCaptureMaxContextBytes);
     const userProfileAutoCleanupInterval = fileConfig.userProfileAutoCleanupInterval ?? DEFAULTS.userProfileAutoCleanupInterval;
+    parseBackfillModel(fileConfig, "pi");
+    parseBackfillModel(fileConfig, "opencode");
+    for (const key of ["autoBackfill", "webServerAutoStart"]) {
+        if (fileConfig[key] !== undefined && typeof fileConfig[key] !== "boolean") {
+            throw new Error(`Invalid ${key} config`);
+        }
+    }
     if (!Number.isInteger(embeddingDimensions) ||
         embeddingDimensions <= 0 ||
         embeddingDimensions > 65536) {
@@ -601,6 +620,10 @@ function buildConfig(fileConfig) {
         captureTrace: fileConfig.captureTrace === true,
         captureTraceRetentionDays: Math.max(1, Math.floor(fileConfig.captureTraceRetentionDays ?? DEFAULTS.captureTraceRetentionDays)),
         captureAttemptRetentionDays: normalizeAutoCleanupRetentionDays(fileConfig.captureAttemptRetentionDays ?? DEFAULTS.captureAttemptRetentionDays),
+        autoBackfill: fileConfig.autoBackfill ?? DEFAULTS.autoBackfill,
+        opencodeBackfillModel: fileConfig.opencodeBackfillModel ?? DEFAULTS.opencodeBackfillModel,
+        piBackfillModel: fileConfig.piBackfillModel ?? DEFAULTS.piBackfillModel,
+        webServerAutoStart: fileConfig.webServerAutoStart ?? DEFAULTS.webServerAutoStart,
         webServerEnabled: fileConfig.webServerEnabled ?? DEFAULTS.webServerEnabled,
         webServerPort: fileConfig.webServerPort ?? DEFAULTS.webServerPort,
         webServerHost: fileConfig.webServerHost ?? DEFAULTS.webServerHost,
@@ -751,6 +774,11 @@ export function initConfig(directory, options = {}) {
         delete projectOverrides.captureTrace;
     }
     delete projectOverrides.captureTraceRetentionDays;
+    delete projectOverrides.autoBackfill;
+    delete projectOverrides.opencodeBackfillModel;
+    delete projectOverrides.piBackfillModel;
+    delete projectOverrides.webServerAutoStart;
+    delete projectOverrides.webServerEnabled;
     const merged = { ...globalConfig, ...projectOverrides };
     const nextConfig = buildConfig(merged);
     lastFileConfig = merged;

package/dist/importer/auto-backfill.d.ts

@@ -0,0 +1,20 @@
+import type { BackfillHost } from "./backfill-model.js";
+import { runHistoryImport, type HistoryImportModels } from "./run-import.js";
+type Run = typeof runHistoryImport;
+export interface AutoBackfillOptions {
+    host: BackfillHost;
+    cwd: string;
+    resolveModels: () => Promise<{
+        model: string;
+        models: HistoryImportModels;
+    }>;
+    notify: (message: string) => void;
+    run?: Run;
+    wait?: () => Promise<void>;
+    now?: () => number;
+    enabled?: () => boolean;
+    signal?: AbortSignal;
+}
+/** Schedule one host's history import after startup; callers do not await it. */
+export declare function scheduleAutoBackfill(options: AutoBackfillOptions): Promise<void>;
+export {};