@mysten-incubation/oc-memwal 0.0.5-dev.0 → 0.0.5-dev.1

package/dist/capture.d.ts

@@ -1,25 +1,11 @@
 /**
  * Capture filtering — determines whether a conversation turn
  * is worth sending to analyze() for fact extraction.
- *
- * Prevents wasted server calls on trivial turns like "ok", "thanks", emoji.
- * Based on patterns from LanceDB's shouldCapture() implementation.
- */
-/**
- * Check if text looks like a prompt injection attempt.
- * Used by both capture (reject on store) and recall (reject on inject).
  */
+/** Normalize text by stripping invisible/format characters, decomposing Unicode, and mapping confusable scripts. */
+export declare function normalizeForInjectionCheck(text: string): string;
+/** Check if text matches known prompt injection patterns. */
 export declare function looksLikeInjection(text: string): boolean;
-/**
- * Determine whether a conversation text is worth capturing.
- *
- * Applies a multi-step filter chain: rejects short text, filler responses,
- * XML/system content, emoji-heavy messages, and injection attempts.
- * Accepts immediately if a trigger pattern matches (e.g. "remember", "prefer").
- * Falls through to accept if text is long enough for the server LLM to evaluate.
- *
- * @param text - Raw message text (user or assistant)
- * @returns `true` if the text likely contains memorable facts
- */
+/** Determine whether a conversation turn is worth capturing. */
 export declare function shouldCapture(text: string): boolean;
 //# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAsBnD"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkDH,oHAAoH;AACpH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW/D;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKxD;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYnD"}

package/dist/capture.js

@@ -1,76 +1,86 @@
 /**
  * Capture filtering — determines whether a conversation turn
  * is worth sending to analyze() for fact extraction.
- *
- * Prevents wasted server calls on trivial turns like "ok", "thanks", emoji.
- * Based on patterns from LanceDB's shouldCapture() implementation.
  */
 import { MIN_CAPTURE_LENGTH, MAX_EMOJI_COUNT } from "./constants.js";
 /** Filler patterns — exact-match trivial responses. */
 const FILLER_PATTERN = /^(ok|okay|sure|thanks|thank you|thx|yes|yep|yeah|no|nope|nah|got it|hmm|hm|ah|oh|lol|haha|nice|cool|great|right|alright|fine|k|kk)\s*[.!?]*$/i;
-/** Prompt injection patterns — never capture these. */
+/** Visual lookalike character map (Cyrillic, Greek, Latin symbols). */
+const VISUAL_CONFUSABLES = {
+    "а": "a", "А": "a", "б": "b", "Б": "b", "в": "b", "В": "b", "ь": "b", "Ь": "b",
+    "с": "c", "С": "c", "д": "d", "Д": "d", "е": "e", "Е": "e", "ѐ": "e", "Ѐ": "e",
+    "ё": "e", "Ё": "e", "є": "e", "Є": "e", "і": "i", "І": "i", "ї": "i", "Ї": "i",
+    "ј": "j", "Ј": "j", "к": "k", "К": "k", "л": "l", "Л": "l", "м": "m", "М": "m",
+    "н": "h", "Н": "h", "п": "n", "П": "n", "о": "o", "О": "o", "ѻ": "o", "Ѻ": "o",
+    "р": "p", "Р": "p", "ҏ": "p", "Ҏ": "p", "ѕ": "s", "Ѕ": "s", "т": "t", "Т": "t",
+    "и": "u", "И": "u", "й": "u", "Й": "u", "у": "y", "У": "y", "х": "x", "Х": "x",
+    "α": "a", "Α": "a", "β": "b", "Β": "b", "γ": "y", "Γ": "r", "δ": "d", "Δ": "d",
+    "ε": "e", "Ε": "e", "ζ": "z", "Ζ": "z", "η": "n", "Η": "h", "θ": "o", "Θ": "o",
+    "ι": "i", "Ι": "i", "κ": "k", "Κ": "k", "λ": "l", "Λ": "l", "μ": "u", "Μ": "m",
+    "ν": "v", "Ν": "n", "ξ": "x", "Ξ": "x", "ο": "o", "Ο": "o", "π": "n", "Π": "n",
+    "ρ": "p", "Ρ": "p", "σ": "o", "Σ": "e", "ς": "s", "τ": "t", "Τ": "t", "υ": "u",
+    "Υ": "y", "φ": "o", "Φ": "o", "χ": "x", "Χ": "x", "ψ": "y", "Ψ": "y", "ω": "w",
+    "Ω": "o", "ℓ": "l", "ø": "o", "Ø": "o", "đ": "d", "Đ": "d", "ħ": "h", "Ħ": "h",
+    "ł": "l", "Ł": "l", "ŋ": "n", "Ŋ": "n", "ŧ": "t", "Ŧ": "t",
+};
+/** Prompt injection patterns — never capture or recall these. */
 const INJECTION_PATTERNS = [
-    /ignore (all|any|previous|above|prior) instructions/i,
-    /do not follow (the )?(system|developer)/i,
-    /system prompt/i,
-    /<\s*(system|assistant|developer|tool|function)\b/i,
-    /\b(run|execute|call|invoke)\b.{0,40}\b(tool|command)\b/i,
+    /\b(ign[o0a]re|disregard|override|f[o0]rget|bypass)\b[\s\S]{0,140}?\b(instruct\w*|instr\w{1,8}tions?|pr[o0]mpt|rules|c[o0]nstraints|guidelines|safety)\b/i,
+    /\b(ign[o0a]re|disregard|f[o0]rget|override)\b[\s\S]{0,80}?\b(everything|anything)\b[\s\S]{0,80}?\b(bef[o0]re|pri[o0]r|t[o0]ld|pr[o0]mpt)\b/i,
+    /\b(?:do\s+not|don\x27?t|st[o0]p)\s+f[o0]ll[o0]w(?:ing)?\b[\s\S]{0,80}?\b(?:system|devel[o0]per|safety|rules|instructions?|instr\w{1,8}tions?)\b/i,
+    /\b(?:new\s+instructions|system\s+override)\s*:\s*/i,
+    /\byou\s+are\s+now\s+(?:dan|unrestricted|jailbroken|unfiltered)\b/i,
+    /\bsystem\s+pr[o0]mpt\b/i,
+    /\breveal\s+(?:all\s+)?(?:your\s+)?(?:system\s+)?instructions?\b/i,
+    /<\s*\/?\s*(system|assistant|developer|tool|function|prompt)\b/i,
+    /\b(run|execute|call|invoke)\b.{0,40}\b(tool|command|shell|bash)\b/i,
 ];
-/** Memory trigger patterns — always capture if matched (whitelist boost). */
+/** Memory trigger patterns — always capture if matched. */
 const TRIGGER_PATTERNS = [
     /remember|prefer|radši|zapamatuj/i,
     /i (like|prefer|hate|love|want|need|use|am|work)/i,
     /my\s+\w+\s+is|is\s+my/i,
     /always|never|important/i,
     /decided|will use|switched to/i,
-    /\+\d{10,}/, // phone numbers
-    /[\w.-]+@[\w.-]+\.\w+/, // email addresses
+    /\+\d{10,}/,
+    /[\w.-]+@[\w.-]+\.\w+/,
 ];
-// ============================================================================
-// Functions
-// ============================================================================
-/**
- * Check if text looks like a prompt injection attempt.
- * Used by both capture (reject on store) and recall (reject on inject).
- */
+/** Normalize text by stripping invisible/format characters, decomposing Unicode, and mapping confusable scripts. */
+export function normalizeForInjectionCheck(text) {
+    const noInvisible = text.replace(/[\p{Cf}\p{Cc}\p{Co}\p{Cs}]/gu, "");
+    const decomposed = noInvisible
+        .normalize("NFKD")
+        .replace(/[\p{Diacritic}\p{M}]/gu, "");
+    let mapped = "";
+    for (const char of decomposed) {
+        mapped += VISUAL_CONFUSABLES[char] ?? char;
+    }
+    return mapped.replace(/\s+/g, " ").trim();
+}
+/** Check if text matches known prompt injection patterns. */
 export function looksLikeInjection(text) {
-    const normalized = text.replace(/\s+/g, " ").trim();
+    if (!text)
+        return false;
+    const normalized = normalizeForInjectionCheck(text);
     if (!normalized)
         return false;
     return INJECTION_PATTERNS.some((p) => p.test(normalized));
 }
-/**
- * Determine whether a conversation text is worth capturing.
- *
- * Applies a multi-step filter chain: rejects short text, filler responses,
- * XML/system content, emoji-heavy messages, and injection attempts.
- * Accepts immediately if a trigger pattern matches (e.g. "remember", "prefer").
- * Falls through to accept if text is long enough for the server LLM to evaluate.
- *
- * @param text - Raw message text (user or assistant)
- * @returns `true` if the text likely contains memorable facts
- */
+/** Determine whether a conversation turn is worth capturing. */
 export function shouldCapture(text) {
-    // Too short to contain useful facts
     if (text.length < MIN_CAPTURE_LENGTH)
         return false;
-    // Pure filler response
     if (FILLER_PATTERN.test(text.trim()))
         return false;
-    // System/XML content (likely injected context, not user speech)
     if (text.trim().startsWith("<") && text.includes("</"))
         return false;
-    // Emoji-heavy (likely reactions, not factual content)
     const emojiCount = (text.match(/[\u{1F300}-\u{1F9FF}]/gu) || []).length;
     if (emojiCount > MAX_EMOJI_COUNT)
         return false;
-    // Prompt injection attempt — never store
-    if (INJECTION_PATTERNS.some((p) => p.test(text)))
+    if (looksLikeInjection(text))
         return false;
-    // If it matches a trigger pattern, definitely capture
     if (TRIGGER_PATTERNS.some((p) => p.test(text)))
         return true;
-    // Default: capture if it's long enough (the server LLM will decide what's worth keeping)
     return true;
 }
 //# sourceMappingURL=capture.js.map

package/dist/capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.js","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAErE,uDAAuD;AACvD,MAAM,cAAc,GAAG,+IAA+I,CAAC;AAEvK,uDAAuD;AACvD,MAAM,kBAAkB,GAAG;IACzB,qDAAqD;IACrD,0CAA0C;IAC1C,gBAAgB;IAChB,mDAAmD;IACnD,yDAAyD;CAC1D,CAAC;AAEF,6EAA6E;AAC7E,MAAM,gBAAgB,GAAG;IACvB,kCAAkC;IAClC,kDAAkD;IAClD,wBAAwB;IACxB,yBAAyB;IACzB,+BAA+B;IAC/B,WAAW,EAAwB,gBAAgB;IACnD,sBAAsB,EAAa,kBAAkB;CACtD,CAAC;AAEF,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,oCAAoC;IACpC,IAAI,IAAI,CAAC,MAAM,GAAG,kBAAkB;QAAE,OAAO,KAAK,CAAC;IAEnD,uBAAuB;IACvB,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnD,gEAAgE;IAChE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAErE,sDAAsD;IACtD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACxE,IAAI,UAAU,GAAG,eAAe;QAAE,OAAO,KAAK,CAAC;IAE/C,yCAAyC;IACzC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE/D,sDAAsD;IACtD,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5D,yFAAyF;IACzF,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAErE,uDAAuD;AACvD,MAAM,cAAc,GAAG,+IAA+I,CAAC;AAEvK,uEAAuE;AACvE,MAAM,kBAAkB,GAA2B;IACjD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAC9E,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAC3D,CAAC;AAEF,iEAAiE;AACjE,MAAM,kBAAkB,GAAG;IACzB,0JAA0J;IAC1J,6IAA6I;IAC7I,kJAAkJ;IAClJ,oDAAoD;IACpD,mEAAmE;IACnE,yBAAyB;IACzB,kEAAkE;IAClE,gEAAgE;IAChE,oEAAoE;CACrE,CAAC;AAEF,2DAA2D;AAC3D,MAAM,gBAAgB,GAAG;IACvB,kCAAkC;IAClC,kDAAkD;IAClD,wBAAwB;IACxB,yBAAyB;IACzB,+BAA+B;IAC/B,WAAW;IACX,sBAAsB;CACvB,CAAC;AAEF,oHAAoH;AACpH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,WAAW;SAC3B,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAEzC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,IAAI,CAAC,MAAM,GAAG,kBAAkB;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAErE,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACxE,IAAI,UAAU,GAAG,eAAe;QAAE,OAAO,KAAK,CAAC;IAE/C,IAAI,kBAAkB,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/config.d.ts

@@ -1,40 +1,16 @@
 /**
  * Config parsing, validation, and namespace resolution.
- *
- * Uses Zod for schema validation — all config errors surface at startup
- * with clear messages instead of failing at runtime.
  */
 import type { PluginConfig } from "./types.js";
-/**
- * Parse and validate raw plugin config from openclaw.json.
- *
- * Resolves ${ENV_VAR} placeholders in string fields, then validates
- * the full config against the Zod schema. Throws with clear field-level
- * error messages on invalid config.
- *
- * @param raw - Raw config object from `api.pluginConfig`
- * @returns Validated config with all defaults applied
- * @throws {Error} If config is missing, or any field fails validation
- */
 export declare function parseConfig(raw: unknown): PluginConfig;
 export interface ResolvedAgent {
     namespace: string;
+    legacyNamespace?: string;
     agentName: string;
 }
-/**
- * Resolve agent name and namespace from OpenClaw's sessionKey.
- *
- * Parses agent name from format "agent:\<name\>:\<uuid\>".
- * Each agent gets its own namespace for memory isolation.
- * Falls back to defaultNamespace for main agent or unknown sessions.
- *
- * @param defaultNamespace - Fallback namespace (used for main agent)
- * @param sessionKey - OpenClaw session key, e.g. "agent:researcher:uuid-456"
- * @returns Resolved namespace and human-readable agent name
- */
+/** Derive a collision-resistant namespace for an agent name. */
+export declare function deriveAgentNamespace(rawName: string): string;
+/** Resolve agent namespace and human-readable name from sessionKey. */
 export declare function resolveAgent(defaultNamespace: string, sessionKey?: string): ResolvedAgent;
-/**
- * Format key for safe logging (first 4 + last 4 chars).
- */
 export declare function keyPreview(key: string): string;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqD/C;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAkBtD;AAMD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAQzF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqD/C,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAetD;AAMD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgB5D;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAmBzF;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/config.js

@@ -1,9 +1,7 @@
 /**
  * Config parsing, validation, and namespace resolution.
- *
- * Uses Zod for schema validation — all config errors surface at startup
- * with clear messages instead of failing at runtime.
  */
+import { createHash } from "node:crypto";
 import { z } from "zod";
 // ============================================================================
 // Schema
@@ -18,7 +16,12 @@ const ConfigSchema = z.object({
     serverUrl: z.string()
         .min(1, "required")
         .url("must be a valid URL"),
-    defaultNamespace: z.string().default("default"),
+    defaultNamespace: z.string()
+        .min(1, "must not be empty")
+        .refine((ns) => !/[\r\n"]/.test(ns), {
+        message: 'defaultNamespace must not contain quotes (") or newline characters',
+    })
+        .default("default"),
     autoRecall: z.boolean().default(true),
     autoCapture: z.boolean().default(true),
     maxRecallResults: z.number().min(1).max(20).default(5),
@@ -28,7 +31,6 @@ const ConfigSchema = z.object({
 // ============================================================================
 // Env Var Resolution
 // ============================================================================
-/** Replace ${ENV_VAR} placeholders with process.env values. */
 function resolveEnvVar(value) {
     return value.replace(/\$\{([^}]+)\}/g, (_, name) => {
         const v = process.env[name];
@@ -37,10 +39,6 @@ function resolveEnvVar(value) {
         return v;
     });
 }
-/**
- * Resolve ${ENV_VAR} placeholders in all string fields of a config object.
- * Non-string fields are passed through unchanged.
- */
 function resolveEnvVars(raw) {
     const resolved = {};
     for (const [key, value] of Object.entries(raw)) {
@@ -51,24 +49,11 @@ function resolveEnvVars(raw) {
 // ============================================================================
 // Config Parser
 // ============================================================================
-/**
- * Parse and validate raw plugin config from openclaw.json.
- *
- * Resolves ${ENV_VAR} placeholders in string fields, then validates
- * the full config against the Zod schema. Throws with clear field-level
- * error messages on invalid config.
- *
- * @param raw - Raw config object from `api.pluginConfig`
- * @returns Validated config with all defaults applied
- * @throws {Error} If config is missing, or any field fails validation
- */
 export function parseConfig(raw) {
     if (!raw || typeof raw !== "object") {
         throw new Error("memory-memwal: config is required");
     }
-    // Resolve env vars before validation
     const resolved = resolveEnvVars(raw);
-    // Validate with Zod — clear error messages per field
     const result = ConfigSchema.safeParse(resolved);
     if (!result.success) {
         const issues = result.error.issues
@@ -78,29 +63,40 @@ export function parseConfig(raw) {
     }
     return result.data;
 }
-/**
- * Resolve agent name and namespace from OpenClaw's sessionKey.
- *
- * Parses agent name from format "agent:\<name\>:\<uuid\>".
- * Each agent gets its own namespace for memory isolation.
- * Falls back to defaultNamespace for main agent or unknown sessions.
- *
- * @param defaultNamespace - Fallback namespace (used for main agent)
- * @param sessionKey - OpenClaw session key, e.g. "agent:researcher:uuid-456"
- * @returns Resolved namespace and human-readable agent name
- */
+/** Derive a collision-resistant namespace for an agent name. */
+export function deriveAgentNamespace(rawName) {
+    const normalized = rawName.normalize("NFKC").trim();
+    const lower = normalized.toLowerCase();
+    // Domain 1: Safe standard names (1-64 ASCII alphanumeric/hyphen/underscore)
+    if (/^[a-zA-Z0-9_-]{1,64}$/.test(normalized)) {
+        return lower;
+    }
+    // Domain 2: Unsafe names (hash length >= 68 chars prevents domain collision)
+    const slug = lower
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 32);
+    const hash = createHash("sha256").update(lower).digest("hex");
+    return slug && slug !== "main" ? `_h_${slug}_${hash}` : `_h_agent_${hash}`;
+}
+/** Resolve agent namespace and human-readable name from sessionKey. */
 export function resolveAgent(defaultNamespace, sessionKey) {
     if (!sessionKey)
         return { namespace: defaultNamespace, agentName: "main" };
     const match = sessionKey.match(/^agent:([^:]+):/);
-    const name = match?.[1];
-    if (!name || name === "main")
+    const rawName = match?.[1];
+    if (!rawName || rawName === "main") {
+        return { namespace: defaultNamespace, agentName: "main" };
+    }
+    const trimmed = rawName.trim();
+    if (trimmed === "main" || trimmed.toLowerCase() === "main") {
         return { namespace: defaultNamespace, agentName: "main" };
-    return { namespace: name, agentName: name };
+    }
+    const namespace = deriveAgentNamespace(rawName);
+    const legacyNamespace = rawName !== namespace && /^[a-zA-Z0-9_-]{1,64}$/.test(trimmed) ? rawName : undefined;
+    const agentName = trimmed.normalize("NFKC").slice(0, 64) || namespace;
+    return { namespace, legacyNamespace, agentName };
 }
-/**
- * Format key for safe logging (first 4 + last 4 chars).
- */
 export function keyPreview(key) {
     return key.length > 8 ? `${key.slice(0, 4)}...${key.slice(-4)}` : "****";
 }

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/hooks/recall.d.ts

@@ -1,9 +1,5 @@
 /**
  * Auto-recall hook — before_prompt_build.
- *
- * Searches Walrus Memory for memories relevant to the user's prompt and injects
- * them into the LLM context. Also injects a namespace instruction so
- * tools scope to the correct agent's memory.
  */
 import type { MemWal } from "@mysten-incubation/memwal";
 import type { PluginConfig } from "../types.js";

package/dist/hooks/recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/hooks/recall.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAIxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAwDvF"}
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/hooks/recall.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAIxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA8EvF"}

package/dist/hooks/recall.js

@@ -1,9 +1,5 @@
 /**
  * Auto-recall hook — before_prompt_build.
- *
- * Searches Walrus Memory for memories relevant to the user's prompt and injects
- * them into the LLM context. Also injects a namespace instruction so
- * tools scope to the correct agent's memory.
  */
 import { resolveAgent } from "../config.js";
 import { looksLikeInjection } from "../capture.js";
@@ -12,28 +8,46 @@ import { MIN_PROMPT_LENGTH } from "../constants.js";
 /** Register the before_prompt_build hook for auto-recall. */
 export function registerRecallHook(api, client, config) {
     api.on("before_prompt_build", async (event, ctx) => {
-        // Skip trivial prompts ("ok", "y") — not worth a server round-trip
         if (!event.prompt || event.prompt.length < MIN_PROMPT_LENGTH)
             return;
-        const { namespace, agentName } = resolveAgent(config.defaultNamespace, ctx?.sessionKey);
-        // The LLM doesn't know which agent it is. This instruction guides
-        // memory_search/memory_store tool calls to the correct namespace.
-        // Returned via appendSystemContext in ALL code paths (including errors)
-        // so tools still scope correctly even when recall itself fails.
+        const { namespace, legacyNamespace, agentName } = resolveAgent(config.defaultNamespace, ctx?.sessionKey);
         const namespaceInstruction = `When using memory_search or memory_store tools, ` +
-            `pass namespace="${namespace}" to scope operations to the current agent's memory.`;
+            `pass namespace=${JSON.stringify(namespace)} to scope operations to the current agent's memory.`;
         try {
-            const result = await client.recall(event.prompt, config.maxRecallResults, namespace);
-            if (!result.results?.length) {
+            const recallPromises = [
+                client.recall(event.prompt, config.maxRecallResults, namespace),
+            ];
+            if (legacyNamespace && legacyNamespace !== namespace) {
+                recallPromises.push(client.recall(event.prompt, config.maxRecallResults, legacyNamespace));
+            }
+            const resultsList = await Promise.allSettled(recallPromises);
+            const primaryResult = resultsList[0];
+            if (primaryResult?.status === "rejected") {
+                api.logger.warn(`memory-memwal: canonical recall failed: ${String(primaryResult.reason)}`);
+            }
+            const candidates = [];
+            const seen = new Set();
+            for (const res of resultsList) {
+                if (res.status === "fulfilled" && res.value?.results?.length) {
+                    for (const item of res.value.results) {
+                        const key = item.blob_id || item.text;
+                        if (!seen.has(key)) {
+                            seen.add(key);
+                            candidates.push(item);
+                        }
+                    }
+                }
+            }
+            if (!candidates.length) {
                 return { appendSystemContext: namespaceInstruction };
             }
-            // Two filters: relevance threshold (drop noise) and injection
-            // detection (drop memories containing prompt manipulation attempts)
-            const relevant = result.results.filter((r) => (1 - r.distance) >= config.minRelevance &&
+            const filtered = candidates.filter((r) => (1 - r.distance) >= config.minRelevance &&
                 !looksLikeInjection(r.text));
-            if (!relevant.length) {
+            if (!filtered.length) {
                 return { appendSystemContext: namespaceInstruction };
             }
+            filtered.sort((a, b) => a.distance - b.distance);
+            const relevant = filtered.slice(0, config.maxRecallResults);
             api.logger.info(`memory-memwal: auto-recall injected ${relevant.length} memories ` +
                 `(agent: ${agentName}, namespace: ${namespace})`);
             return {

package/dist/hooks/recall.js.map

@@ -1 +1 @@
-{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../src/hooks/recall.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,GAAQ,EAAE,MAAc,EAAE,MAAoB;IAC/E,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,KAAK,EAAE,KAAU,EAAE,GAAQ,EAAE,EAAE;QAC3D,mEAAmE;QACnE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,iBAAiB;YAAE,OAAO;QAErE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,gBAAgB,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAExF,kEAAkE;QAClE,kEAAkE;QAClE,wEAAwE;QACxE,gEAAgE;QAChE,MAAM,oBAAoB,GACxB,kDAAkD;YAClD,mBAAmB,SAAS,sDAAsD,CAAC;QAErF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,KAAK,CAAC,MAAM,EACZ,MAAM,CAAC,gBAAgB,EACvB,SAAS,CACV,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC5B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAC;YACvD,CAAC;YAED,8DAA8D;YAC9D,oEAAoE;YACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CACpC,CAAC,CAAM,EAAE,EAAE,CACT,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,YAAY;gBACvC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9B,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACrB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAC;YACvD,CAAC;YAED,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,uCAAuC,QAAQ,CAAC,MAAM,YAAY;gBAClE,WAAW,SAAS,gBAAgB,SAAS,GAAG,CACjD,CAAC;YAEF,OAAO;gBACL,cAAc,EAAE,uBAAuB,CACrC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAC7C;gBACD,mBAAmB,EAAE,oBAAoB;aAC1C,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,sCAAsC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpD,CAAC;YACF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../src/hooks/recall.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mysten-incubation/oc-memwal",
-  "version": "0.0.5-dev.0",
+  "version": "0.0.5-dev.1",
   "type": "module",
   "description": "NemoClaw/OpenClaw memory plugin — encrypted, decentralized long-term memory via Walrus Memory",
   "license": "Apache-2.0",
@@ -36,7 +36,7 @@
   "dependencies": {
     "@sinclair/typebox": "0.34.48",
     "zod": "^3.23.0",
-    "@mysten-incubation/memwal": "0.0.7"
+    "@mysten-incubation/memwal": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -50,6 +50,7 @@
   "scripts": {
     "build": "tsc",
     "typecheck": "tsc --noEmit",
+    "test": "tsc && node --test \"test/**/*.test.mjs\"",
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
   }
 }