om-memory-system 4.25.0 → 4.26.1

package/dist/services/turso/ready.js

@@ -24,7 +24,7 @@ export async function ensureTursoReady() {
         }
         catch (error) {
             initPromise = null;
-            log("Turso ready gate failed", { error: String(error) });
+            log("Turso ready gate failed", { error: String(error) }, "error");
             throw error;
         }
     })();

package/dist/services/turso/shard-manager.js

@@ -359,7 +359,7 @@ export class TursoShardManager {
             log("Error validating shard DB", {
                 dbPath: shard.dbPath,
                 error: String(error),
-            });
+            }, "error");
             return false;
         }
     }
@@ -437,7 +437,7 @@ export class TursoShardManager {
             log("Error deleting shard file", {
                 dbPath: fullPath,
                 error: String(error),
-            });
+            }, "error");
         }
         await metadataDb.run(`DELETE FROM shards WHERE id = ?`, [shardId]);
     }

package/dist/services/turso/vector-search.js

@@ -199,7 +199,7 @@ export class TursoVectorSearch {
             log("Turso vector_top_k failed; falling back to exact scan", {
                 indexName,
                 error: String(error),
-            });
+            }, "warn");
             return exactScanKind(db, queryJson, k, containerTag, columnName);
         }
     }
@@ -211,7 +211,7 @@ export class TursoVectorSearch {
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
-                log("Shard search error", { shardId: shard.id, error: message });
+                log("Shard search error", { shardId: shard.id, error: message }, "error");
                 shardErrors.push({ shardId: shard.id, error: message });
                 return [];
             }
@@ -231,7 +231,7 @@ export class TursoVectorSearch {
             log("Vector search completed with partial shard failures", {
                 failedShards: shardErrors,
                 totalShards: shards.length,
-            });
+            }, "warn");
         }
         const allResults = resultsArray.flat();
         if (keywordMode === "rrf" && keywordBoost > 0) {

package/dist/services/user-profile/ai-cleanup-batches.js

@@ -145,7 +145,7 @@ export async function runInBatches(batches, { callBatch = cleanupBatch, onProgre
                 of: batches.length,
                 items: countItems(batch),
                 reason: failureReason(error),
-            });
+            }, "error");
         }
         onProgress?.(index + 1, batches.length, joined.failedBatches);
     }

package/dist/services/user-profile/ai-cleanup-job.js

@@ -48,7 +48,7 @@ export function startAiCleanupJob(userId, input, deps = {}) {
             if (job.stopped)
                 return;
             const reason = failureReason(error);
-            log("AI cleanup job: failed", { reason });
+            log("AI cleanup job: failed", { reason }, "error");
             job.status = {
                 state: "failed",
                 error: reason === "timeout"

package/dist/services/user-profile/auto-cleanup.js

@@ -24,7 +24,7 @@ export async function startAutoProfileCleanup(userId, options = {}) {
         return await run(userId, options);
     }
     catch (error) {
-        log("auto cleanup: failed", { reason: failureReason(error) });
+        log("auto cleanup: failed", { reason: failureReason(error) }, "error");
         return { status: "failed" };
     }
     finally {
@@ -58,7 +58,7 @@ async function run(userId, options) {
         return { status: "nothing-to-change" };
     }
     if (proposed > AUTO_CLEANUP_MAX_CHANGE_SHARE * sent) {
-        log("auto cleanup: skipped", { reason: "too-many-changes", proposed, sent });
+        log("auto cleanup: skipped", { reason: "too-many-changes", proposed, sent }, "warn");
         return { status: "too-many-changes" };
     }
     const job = { old: data, changes: result.diff, mergedItems: result.mergedItems };

package/dist/services/user-profile/category-cleanup-job.js

@@ -31,7 +31,7 @@ export function startCategoryCleanupJob(userId, deps = {}) {
         catch (error) {
             log("category cleanup job: failed", {
                 code: error instanceof Error ? error.name : "unknown",
-            });
+            }, "error");
             job.status = {
                 state: "failed",
                 error: error instanceof Error ? error.message : String(error),

package/dist/services/user-profile/category-cleanup.js

@@ -129,7 +129,7 @@ onProgress, cache) {
             log("category cleanup: model batch failed", {
                 groups: batch.length,
                 code: error instanceof Error ? error.name : "unknown",
-            });
+            }, "error");
             for (const group of batch)
                 named.set(group.id, fallback(group));
             return;
@@ -150,7 +150,7 @@ onProgress, cache) {
                 log("category cleanup: verdict save failed", {
                     groups: verdicts.size,
                     code: error instanceof Error ? error.name : "unknown",
-                });
+                }, "error");
             }
         }
     };
@@ -267,7 +267,7 @@ async function openVerdictCache(profileId, groupIds) {
     catch (error) {
         log("category cleanup: verdict store unavailable", {
             code: error instanceof Error ? error.name : "unknown",
-        });
+        }, "warn");
         return undefined;
     }
 }

package/dist/services/user-profile/merge-and-save.js

@@ -9,7 +9,7 @@ export async function saveProfile(profile, data, summary, promptsAnalyzed = 0, s
     const target = store ?? (await import("./user-profile-manager.js")).userProfileManager;
     const saved = await target.updateProfile(profile.id, data, promptsAnalyzed, summary, profile.version);
     if (!saved)
-        log("profile save skipped", { code: "version-changed" });
+        log("profile save skipped", { code: "version-changed" }, "warn");
     return saved;
 }
 /**

package/dist/services/user-profile/profile-context.js

@@ -50,7 +50,7 @@ export async function getUserProfileContext(userId, queryVector) {
     }
     catch (e) {
         // A single corrupt row must not break context injection for everyone.
-        log("profile context: failed to parse stored profileData", { error: String(e) });
+        log("profile context: failed to parse stored profileData", { error: String(e) }, "error");
         return null;
     }
     const parts = [];

package/dist/services/user-profile/profile-model.js

@@ -19,7 +19,7 @@ export async function resolveHostProfileModel() {
     catch (error) {
         log("profile model: host model unavailable, falling back to external API", {
             error: String(error),
-        });
+        }, "warn");
         return null;
     }
 }

package/dist/services/user-profile/user-profile-manager.js

@@ -103,7 +103,7 @@ export class UserProfileManager {
             catch (error) {
                 this.initPromise = null;
                 this.db = null;
-                log("user-profile-manager: db init failed", { error: String(error) });
+                log("user-profile-manager: db init failed", { error: String(error) }, "error");
                 throw error;
             }
         })();
@@ -508,7 +508,7 @@ export class UserProfileManager {
         // pair. They match only in the strong band and never absorb other workflows.
         const isWorkflow = itemType === "workflow";
         if (!useEmbedding) {
-            log("profile embedding skipped: model not warmed up");
+            log("profile embedding skipped: model not warmed up", undefined, "warn");
         }
         for (const item of existing) {
             this.lazyMigrateAlpha(item);
@@ -530,7 +530,7 @@ export class UserProfileManager {
                     log("profile centroid migration failed", {
                         desc: item.description.substring(0, 30),
                         error: String(e),
-                    });
+                    }, "error");
                 }
             }
         }
@@ -1059,7 +1059,7 @@ export class UserProfileManager {
                 log("ensureArray: failed to parse JSON string, returning []", {
                     val: String(val).substring(0, 100),
                     error: String(e),
-                });
+                }, "error");
                 return [];
             }
         }
@@ -1186,7 +1186,7 @@ Answer JSON only: { "duplicate": true|false, "reason": "one sentence explanation
                 return result.duplicate || false;
             }
             catch (e) {
-                log("profile dedup check: native provider failed", { error: String(e) });
+                log("profile dedup check: native provider failed", { error: String(e) }, "warn");
             }
         }
         if (CONFIG.memoryModel && CONFIG.memoryApiUrl) {
@@ -1221,7 +1221,7 @@ Answer JSON only: { "duplicate": true|false, "reason": "one sentence explanation
                 return parsed.duplicate || false;
             }
             catch (e) {
-                log("profile dedup check: external API failed", { error: String(e) });
+                log("profile dedup check: external API failed", { error: String(e) }, "error");
             }
         }
         return false;
@@ -1356,7 +1356,7 @@ Answer JSON only: { "conflict": true|false, "reason": "one sentence explanation"
                 return result.conflict || false;
             }
             catch (e) {
-                log("profile conflict check: native provider failed", { error: String(e) });
+                log("profile conflict check: native provider failed", { error: String(e) }, "warn");
             }
         }
         if (CONFIG.memoryModel && CONFIG.memoryApiUrl) {
@@ -1401,7 +1401,7 @@ Answer JSON only: { "conflict": true|false, "reason": "one sentence explanation"
                 return parsed.conflict || false;
             }
             catch (e) {
-                log("profile conflict check: external API failed", { error: String(e) });
+                log("profile conflict check: external API failed", { error: String(e) }, "error");
             }
         }
         return false;
@@ -1452,7 +1452,7 @@ Generate a concise, abstract description of the user's general behavioral tenden
             catch (e) {
                 log("profile description evolution: native provider failed, trying external API", {
                     error: String(e),
-                });
+                }, "error");
             }
         }
         if (!newDescription && CONFIG.memoryModel && CONFIG.memoryApiUrl) {
@@ -1460,7 +1460,7 @@ Generate a concise, abstract description of the user's general behavioral tenden
                 newDescription = await this.callExternalAPI(systemPrompt, userPrompt);
             }
             catch (e) {
-                log("profile description evolution: external API failed", { error: String(e) });
+                log("profile description evolution: external API failed", { error: String(e) }, "error");
                 return null;
             }
         }
@@ -1541,7 +1541,7 @@ Generate a concise, abstract description of the user's general behavioral tenden
                 else {
                     log("profile description evolution: embedding not warmed up, skipping validation", {
                         type: itemType,
-                    });
+                    }, "warn");
                 }
                 const oldDesc = item.description;
                 item.description = evolved;
@@ -1555,7 +1555,7 @@ Generate a concise, abstract description of the user's general behavioral tenden
             }
         }
         catch (e) {
-            log("profile description evolve error", { type: itemType, error: String(e) });
+            log("profile description evolve error", { type: itemType, error: String(e) }, "error");
         }
     }
     async callHostModel(model, systemPrompt, userPrompt) {

package/dist/services/web-autostart.js

@@ -284,7 +284,7 @@ export function restartWebAutostart(options = {}) {
     catch (error) {
         log("OMMS login item restart failed", {
             code: error instanceof Error ? error.name : "unknown",
-        });
+        }, "error");
         return false;
     }
 }
@@ -301,6 +301,6 @@ export function reconcileWebAutostart(config = CONFIG, options = {}) {
     catch (error) {
         log("OMMS login item reconciliation failed", {
             code: error instanceof Error ? error.name : "unknown",
-        });
+        }, "error");
     }
 }

package/dist/services/web-route-modules.js

@@ -1,4 +1,5 @@
 import { routeChat } from "./chat/chat-routes.js";
+import { routeMemoryHosts } from "./memory-host-routes.js";
 import { routeProfileCleanup } from "./profile-cleanup-routes.js";
 /**
  * Route modules that live outside web-server.ts, which sits at its size
@@ -11,5 +12,8 @@ export async function routeModules(path, method, url, req, config) {
     const cleanup = await routeProfileCleanup(path, method, url, readBody);
     if (cleanup !== undefined)
         return { status: 200, body: cleanup };
+    const hosts = await routeMemoryHosts(path, method, url, readBody, config);
+    if (hosts !== undefined)
+        return hosts;
     return routeChat(path, method, readBody, config);
 }

package/dist/services/web-server.js

@@ -114,7 +114,7 @@ function serveFetch(opts) {
         const onListening = () => {
             server.off("error", onError);
             // Keep a listener, so a later server error is logged instead of crashing the process.
-            server.on("error", (error) => log("Web server error", { error: String(error) }));
+            server.on("error", (error) => log("Web server error", { error: String(error) }, "error"));
             resolve({
                 stop: () => {
                     server.closeAllConnections();
@@ -271,7 +271,7 @@ export class WebServer {
                 await callback(action);
             }
             catch (error) {
-                log("Power action callback error", { action, error: String(error) });
+                log("Power action callback error", { action, error: String(error) }, "error");
             }
             finally {
                 this.powerActionRunning = false;
@@ -474,7 +474,7 @@ export class WebServer {
                     await this.onStepAsideCallback();
                 }
                 catch (error) {
-                    log("Step-aside callback error", { error: String(error) });
+                    log("Step-aside callback error", { error: String(error) }, "error");
                 }
                 return;
             }
@@ -543,7 +543,7 @@ export class WebServer {
         catch (error) {
             log("Importing webServerApiToken failed", {
                 code: error instanceof Error ? error.name : "unknown",
-            });
+            }, "error");
         }
         assertWebServerNetworkAuth(this.config.host, tokens.hasUnexpiredApiToken(), this.config.auth?.isEnabled() ?? false);
         try {
@@ -574,7 +574,7 @@ export class WebServer {
             else {
                 this.isOwner = false;
                 this.server = null;
-                log("Web server failed to start", { error: errorMsg });
+                log("Web server failed to start", { error: errorMsg }, "error");
                 throw error;
             }
         }
@@ -609,7 +609,7 @@ export class WebServer {
             await this.onStepAsideCallback();
         }
         catch (error) {
-            log("Step-aside callback error", { error: String(error) });
+            log("Step-aside callback error", { error: String(error) }, "error");
         }
     }
     /** True when `web update` asked web apps started before this one to retire. */
@@ -666,7 +666,7 @@ export class WebServer {
             log("Web server port held by a non-responsive process; falling back to next port", {
                 previousPort: this.config.port,
                 newPort: nextPort,
-            });
+            }, "warn");
             this.config.port = nextPort;
         }
         else if (this.config.port >= this.maxFallbackPort &&
@@ -694,7 +694,7 @@ export class WebServer {
                     await this.onTakeoverCallback();
                 }
                 catch (error) {
-                    log("Takeover callback error", { error: String(error) });
+                    log("Takeover callback error", { error: String(error) }, "error");
                 }
             }
         }
@@ -706,12 +706,12 @@ export class WebServer {
         log("Web server unavailable: every candidate port is held by a non-responsive process", {
             port: this.config.port,
             maxFallbackPort: this.maxFallbackPort,
-        });
+        }, "warn");
         try {
             this.onPortsExhaustedCallback?.();
         }
         catch (error) {
-            log("Ports exhausted callback error", { error: String(error) });
+            log("Ports exhausted callback error", { error: String(error) }, "error");
         }
     }
     async stop() {
@@ -973,7 +973,7 @@ export class WebServer {
                 catch (error) {
                     log("Settings saved, but reloading them failed", {
                         error: error instanceof Error ? error.message : String(error),
-                    });
+                    }, "error");
                 }
                 if (body.edits.captureRetryRetentionHours === 0) {
                     // Turning the queue off removes waiting turns now, not at the next cleanup.
@@ -987,7 +987,7 @@ export class WebServer {
                     catch (error) {
                         log("Settings saved, but clearing the capture retry queue failed", {
                             code: error instanceof Error ? error.name : "unknown",
-                        });
+                        }, "error");
                     }
                 }
                 return this.jsonResponse(result);
@@ -1186,7 +1186,7 @@ export class WebServer {
             }
             if (path === "/api/settings/log" && method === "GET") {
                 const { readSettingsLog } = await import("./settings-log.js");
-                return this.jsonResponse(await readSettingsLog(Number(url.searchParams.get("lines") ?? 200), url.searchParams.get("filter") === "capture"));
+                return this.jsonResponse(await readSettingsLog(Object.fromEntries(url.searchParams)));
             }
             if (path === "/api/tags" && method === "GET") {
                 const result = await handleListTags();

package/dist/services/web-update.d.ts

@@ -1,3 +1,4 @@
+import type { LogLevel } from "./logger.js";
 export declare const UPDATE_CHECK_INTERVAL_MS: number;
 /** An open page triggers a new check once the last one is this old. */
 export declare const STATUS_RECHECK_AFTER_MS: number;
@@ -23,7 +24,7 @@ export interface WebUpdateDeps {
     setInterval: (callback: () => void, ms: number) => {
         unref?: () => void;
     };
-    log: (message: string, data: Record<string, unknown>) => void;
+    log: (message: string, data: Record<string, unknown>, level?: LogLevel) => void;
     /** The runtime of this web app; npm must sit beside it. */
     execPath: string;
     platform: NodeJS.Platform;

package/dist/services/web-update.js

@@ -51,7 +51,7 @@ export class WebUpdate {
         this.lastCheck = this.deps.now();
         const latest = await latestNpmVersion(this.deps.fetch);
         if (latest === null) {
-            this.deps.log("Web app update check failed", { code: "unreachable" });
+            this.deps.log("Web app update check failed", { code: "unreachable" }, "error");
             return;
         }
         this.available = availableUpdate(this.deps.version, latest);

package/dist/services/write-health-checks.d.ts

@@ -0,0 +1,3 @@
+import { type WriteHealthResult } from "./write-health.js";
+/** Whether a new memory can be saved now. Reuses a result for 30 seconds unless `fresh`. */
+export declare function checkWriteHealth(fresh?: boolean): Promise<WriteHealthResult>;

package/dist/services/write-health-checks.js

@@ -0,0 +1,20 @@
+import { join } from "node:path";
+import { CONFIG } from "../config.js";
+import { createWriteHealth } from "./write-health.js";
+const writeHealth = createWriteHealth({
+    openStore: async () => {
+        const { tursoConnectionManager } = await import("./turso/connection-manager.js");
+        const db = await tursoConnectionManager.getConnection(join(CONFIG.storagePath, "user-prompts.db"));
+        await db.all("SELECT 1");
+    },
+    embed: async () => {
+        const { embeddingService } = await import("./embedding.js");
+        const vector = await embeddingService.embedWithTimeout("OMMS health check", { task: "query" });
+        return vector.length;
+    },
+    secrets: () => [CONFIG.embeddingApiKey, CONFIG.memoryApiKey],
+});
+/** Whether a new memory can be saved now. Reuses a result for 30 seconds unless `fresh`. */
+export function checkWriteHealth(fresh = false) {
+    return writeHealth.check({ fresh });
+}

package/dist/services/write-health.d.ts

@@ -0,0 +1,26 @@
+export interface WriteHealthResult {
+    ok: boolean;
+    /** One short line for the page; null when memories can be saved. */
+    reason: string | null;
+    checkedAt: number;
+}
+export interface WriteHealthOptions {
+    /** Open the memory store and run a trivial query. */
+    openStore: () => Promise<void>;
+    /** Embed one fixed test string and return the vector length. */
+    embed: () => Promise<number>;
+    /** Credentials to remove from any reason. */
+    secrets: () => Array<string | undefined>;
+    now?: () => number;
+}
+/**
+ * Whether a new memory can be saved right now: the store opens and the
+ * embedding service answers. A result is reused for 30 seconds and one probe
+ * serves every caller that starts while it runs, so open tabs cause few
+ * embedding calls. The probe sends a fixed string, never conversation text.
+ */
+export declare function createWriteHealth(options: WriteHealthOptions): {
+    check(request?: {
+        fresh?: boolean;
+    }): Promise<WriteHealthResult>;
+};

package/dist/services/write-health.js

@@ -0,0 +1,58 @@
+import { safeHealthError } from "./safe-health-error.js";
+const CACHE_MS = 30_000;
+const MAX_REASON = 140;
+function embeddingReason(error, secrets) {
+    const message = safeHealthError(error, secrets);
+    const status = /\b([45]\d{2})\b/.exec(message)?.[1];
+    if (status)
+        return `Embedding server error (${status})`;
+    const line = message.replace(/\s+/g, " ").trim();
+    const text = `Embedding failed: ${line}`;
+    return text.length > MAX_REASON ? `${text.slice(0, MAX_REASON - 1)}…` : text;
+}
+/**
+ * Whether a new memory can be saved right now: the store opens and the
+ * embedding service answers. A result is reused for 30 seconds and one probe
+ * serves every caller that starts while it runs, so open tabs cause few
+ * embedding calls. The probe sends a fixed string, never conversation text.
+ */
+export function createWriteHealth(options) {
+    const now = options.now ?? Date.now;
+    let last = null;
+    let running = null;
+    async function probe() {
+        const secrets = options.secrets();
+        let reason = null;
+        try {
+            await options.openStore();
+        }
+        catch {
+            reason = "Memory store cannot be opened";
+        }
+        if (reason === null) {
+            try {
+                const length = await options.embed();
+                if (!length)
+                    reason = "Embedding service returned no values";
+            }
+            catch (error) {
+                reason = embeddingReason(error, secrets);
+            }
+        }
+        return { ok: reason === null, reason, checkedAt: now() };
+    }
+    return {
+        async check(request = {}) {
+            if (running)
+                return running;
+            if (!request.fresh && last && now() - last.checkedAt < CACHE_MS)
+                return last;
+            running = probe()
+                .then((result) => (last = result))
+                .finally(() => {
+                running = null;
+            });
+            return running;
+        },
+    };
+}

package/dist/v2/adapter.js

@@ -95,7 +95,7 @@ export async function registerV2Adapter(ctx, legacy, memory) {
                 await memory.recordPrompt(sessionID, prompt.messageID, prompt.text);
             }
             catch (error) {
-                log("v2 context: failed to record user prompt", { sessionID, error: String(error) });
+                log("v2 context: failed to record user prompt", { sessionID, error: String(error) }, "error");
             }
         }
         if (remaining.length > 0)
@@ -178,7 +178,7 @@ export async function registerV2Adapter(ctx, legacy, memory) {
         // Start the search now with the entry snapshot, so it overlaps prompt admission.
         // An edit during retrieval must not change this request's allowance.
         const promise = memory.retrieve(text, sessionID, budgetBytes).catch((error) => {
-            log("v2 prompt: memory retrieval failed", { sessionID, error: String(error) });
+            log("v2 prompt: memory retrieval failed", { sessionID, error: String(error) }, "error");
             return null;
         });
         setBounded(retrievals, sessionID, { promise, budgetBytes });
@@ -230,7 +230,7 @@ export async function registerV2Adapter(ctx, legacy, memory) {
                 restored.delete(sessionID);
         }
         catch (error) {
-            log("v2 compaction: failed to load session memories", { sessionID, error: String(error) });
+            log("v2 compaction: failed to load session memories", { sessionID, error: String(error) }, "error");
         }
     });
     const controller = new AbortController();
@@ -250,7 +250,7 @@ export async function registerV2Adapter(ctx, legacy, memory) {
         }
         catch (error) {
             if (!controller.signal.aborted) {
-                log("omms v2 event bridge failed", { error: String(error) });
+                log("omms v2 event bridge failed", { error: String(error) }, "error");
             }
         }
     })();