om-memory-system 4.24.0-next.147 → 4.25.1

package/dist/services/web-server.js

@@ -14,7 +14,7 @@ import { WebAuth } from "./web-auth.js";
 import { NODE_HTTP_IDLE_TIMEOUT_MS } from "./request-timeouts.js";
 import { testReranker } from "./reranker-test.js";
 import { handleListTags, handleListKeywords, handleListMemories, handleAddMemory, handleDeleteMemory, handleBulkDelete, handleUpdateMemory, handleSearch, handleStats, handlePinMemory, handleUnpinMemory, handleRunCleanup, handleRunDeduplication, handleDetectMigration, handleRunMigration, handleDetectTagMigration, handleRunTagMigrationBatch, handleGetTagMigrationProgress, handleDeletePrompt, handleBulkDeletePrompts, handleGetUserProfile, handleGetProfileChangelog, handleGetProfileSnapshot, handleRefreshProfile, handleCategoryCleanupApply, handleCategoryCleanupStart, handleCategoryCleanupStatus, handleCategoryCleanupUndo, handleUpdateProfileItem, } from "./api-handlers.js";
-import { routeProfileCleanup } from "./profile-cleanup-routes.js";
+import { routeModules } from "./web-route-modules.js";
 const isBun = typeof globalThis.Bun !== "undefined";
 const MIN_FAILED_TAKEOVERS = 3;
 export function attachNodeDisconnectHandlers(req, res, onDisconnect) {
@@ -1349,9 +1349,10 @@ export class WebServer {
                 const result = await handleRefreshProfile(userId);
                 return this.jsonResponse(result);
             }
-            const cleanup = await routeProfileCleanup(path, method, url, () => req.json().catch(() => ({})));
-            if (cleanup !== undefined)
-                return this.jsonResponse(cleanup);
+            const { CONFIG: config } = await import("../config.js");
+            const routed = await routeModules(path, method, url, req, config);
+            if (routed)
+                return this.jsonResponse(routed.body, routed.status);
             if (path === "/api/user-profile/category-cleanup" && method === "POST") {
                 const body = (await req.json().catch(() => ({})));
                 return this.jsonResponse(await handleCategoryCleanupStart(body.userId || undefined));

package/dist/utils/keyword-boost.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The `keywordBoost` and `keywordMode` settings (openspec change hook-search-keywords-and-profile):
+ * how much a memory that contains a word of the prompt gains in search. Pure,
+ * so config.ts and tests share one rule without importing CONFIG.
+ */
+export declare const KEYWORD_BOOST_DEFAULT = 0.1;
+export declare const KEYWORD_BOOST_MAX = 0.5;
+/**
+ * The setting from the file: the default when absent, otherwise a number from
+ * 0 to 0.5. The message names the setting and its accepted values only.
+ */
+export declare function checkedKeywordBoost(value: unknown): number;
+/** How word matches join the results: an added boost, or rank fusion (experimental). */
+export type KeywordMode = "boost" | "rrf";
+export declare const KEYWORD_MODES: readonly KeywordMode[];
+/** The `keywordMode` setting from the file: `boost` when absent, otherwise `boost` or `rrf`. */
+export declare function checkedKeywordMode(value: unknown): KeywordMode;

package/dist/utils/keyword-boost.js

@@ -0,0 +1,32 @@
+/**
+ * The `keywordBoost` and `keywordMode` settings (openspec change hook-search-keywords-and-profile):
+ * how much a memory that contains a word of the prompt gains in search. Pure,
+ * so config.ts and tests share one rule without importing CONFIG.
+ */
+export const KEYWORD_BOOST_DEFAULT = 0.1;
+export const KEYWORD_BOOST_MAX = 0.5;
+/**
+ * The setting from the file: the default when absent, otherwise a number from
+ * 0 to 0.5. The message names the setting and its accepted values only.
+ */
+export function checkedKeywordBoost(value) {
+    if (value === undefined)
+        return KEYWORD_BOOST_DEFAULT;
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value < 0 ||
+        value > KEYWORD_BOOST_MAX) {
+        throw new Error(`Invalid keywordBoost config (accepted: numbers from 0 to ${KEYWORD_BOOST_MAX})`);
+    }
+    return value;
+}
+export const KEYWORD_MODES = ["boost", "rrf"];
+/** The `keywordMode` setting from the file: `boost` when absent, otherwise `boost` or `rrf`. */
+export function checkedKeywordMode(value) {
+    if (value === undefined)
+        return "boost";
+    if (value !== "boost" && value !== "rrf") {
+        throw new Error(`Invalid keywordMode config (accepted: ${KEYWORD_MODES.join(", ")})`);
+    }
+    return value;
+}

package/dist/utils/reranker-settings.d.ts

@@ -0,0 +1,13 @@
+export interface RerankerFileSettings {
+    rerankerEnabled?: boolean;
+    rerankerApiUrl?: string;
+    rerankerModel?: string;
+    rerankerApiKey?: string;
+    rerankerTimeoutMs?: number;
+}
+/**
+ * Validate the five opt-in reranker keys when present (openspec change
+ * retrieval-threshold-and-reranker). Messages name the setting and its
+ * accepted values only; the value is never quoted back.
+ */
+export declare function checkedRerankerSettings(fileConfig: RerankerFileSettings): void;

package/dist/utils/reranker-settings.js

@@ -0,0 +1,48 @@
+/**
+ * Validation of the opt-in reranker keys. Lives outside src/config.ts, which is
+ * at its size ceiling; config.ts calls it while building CONFIG.
+ */
+import { RERANKER_TIMEOUT_MAX_MS, RERANKER_TIMEOUT_MIN_MS } from "../services/request-timeouts.js";
+/** The reranker key must be a reference, never a literal secret in the file. */
+function isRerankerKeyReference(value) {
+    return /^(env:\/\/[A-Za-z_][A-Za-z0-9_]*|file:\/\/.+)$/.test(value.trim());
+}
+/**
+ * Validate the five opt-in reranker keys when present (openspec change
+ * retrieval-threshold-and-reranker). Messages name the setting and its
+ * accepted values only; the value is never quoted back.
+ */
+export function checkedRerankerSettings(fileConfig) {
+    const invalid = (setting, accepted) => new Error(`Invalid ${setting} config (accepted: ${accepted})`);
+    if (fileConfig.rerankerEnabled !== undefined && typeof fileConfig.rerankerEnabled !== "boolean") {
+        throw invalid("rerankerEnabled", "boolean");
+    }
+    for (const key of ["rerankerApiUrl", "rerankerModel"]) {
+        const value = fileConfig[key];
+        if (value === undefined)
+            continue;
+        if (typeof value !== "string" || value.trim().length === 0) {
+            throw invalid(key, "a non-empty string");
+        }
+    }
+    if (fileConfig.rerankerApiUrl !== undefined &&
+        !/^https?:\/\/\S+$/.test(fileConfig.rerankerApiUrl.trim())) {
+        throw invalid("rerankerApiUrl", "an http:// or https:// URL");
+    }
+    if (fileConfig.rerankerApiKey !== undefined) {
+        if (typeof fileConfig.rerankerApiKey !== "string" ||
+            !isRerankerKeyReference(fileConfig.rerankerApiKey)) {
+            throw invalid("rerankerApiKey", "an env:// or file:// secret reference");
+        }
+    }
+    if (fileConfig.rerankerTimeoutMs !== undefined) {
+        const value = fileConfig.rerankerTimeoutMs;
+        const ok = typeof value === "number" &&
+            Number.isSafeInteger(value) &&
+            value >= RERANKER_TIMEOUT_MIN_MS &&
+            value <= RERANKER_TIMEOUT_MAX_MS;
+        if (!ok) {
+            throw invalid("rerankerTimeoutMs", `integers from ${RERANKER_TIMEOUT_MIN_MS} to ${RERANKER_TIMEOUT_MAX_MS}`);
+        }
+    }
+}