@agenr/agenr-plugin 1.7.4 → 1.8.1

package/dist/index.js

@@ -1,37 +1,33 @@
 import {
   OpenClawTranscriptParser,
+  createOpenClawRepository,
   deriveOpenClawSessionIdFromFilePath,
   ingestEpisodeTranscript,
-  normalizeClaimKey,
   openClawTranscriptParser,
   parseTuiSessionKey,
   readOpenClawSessionsStore,
   storeEntriesDetailed
-} from "./chunk-NXCCTZ4G.js";
-import {
-  runUnifiedRecall
-} from "./chunk-IZDGXMTQ.js";
+} from "./chunk-O45JQ6O3.js";
 import {
   EMBEDDING_DIMENSIONS,
   ENTRY_TYPES,
   EXPIRY_LEVELS,
-  VECTOR_INDEX_NAME,
-  buildActiveEntryClause,
   createDatabase,
   createEmbeddingClient,
   createRecallAdapter,
-  mapEntryRow,
+  normalizeManualClaimKeyUpdate,
   readConfig,
-  readNumber,
-  readOptionalString,
-  readRequiredString,
   resolveClaimExtractionConfig,
   resolveConfigPath,
   resolveDbPath,
   resolveEmbeddingApiKey,
-  resolveEmbeddingModel
-} from "./chunk-NIQKTINU.js";
-import "./chunk-7WL5EAQZ.js";
+  resolveEmbeddingModel,
+  runUnifiedRecall,
+  validateTemporalValidityRange
+} from "./chunk-LVDQXSHP.js";
+import {
+  resolveClaimSlotPolicy
+} from "./chunk-GUDCFFRV.js";
 
 // src/adapters/openclaw/index.ts
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
@@ -123,6 +119,14 @@ function buildSessionSourceFile(ctx) {
   const target = ctx.sessionKey ?? ctx.sessionId ?? ctx.agentId ?? "unknown";
   return `openclaw-session:${target}`;
 }
+function buildToolCallClaimSupport(ctx, toolName, observedAt) {
+  return {
+    claim_support_source_kind: "tool_call",
+    claim_support_locator: `${buildSessionSourceFile(ctx)}#${toolName}`,
+    claim_support_observed_at: observedAt,
+    claim_support_mode: "explicit"
+  };
+}
 function logToolCall(logger, toolName, ctx, summary, sanitizedParams) {
   logger.info(`[agenr] tool=${toolName} ${formatToolSessionContext(ctx)} ${summary}`);
   logger.info(`[agenr] tool=${toolName} ${formatToolSessionContext(ctx)} params=${JSON.stringify(sanitizedParams)}`);
@@ -171,6 +175,9 @@ function formatRecallToolSummary(params) {
   if (params.tags.length > 0) {
     parts.push(`tags=${JSON.stringify(params.tags)}`);
   }
+  if (params.asOf) {
+    parts.push(`as_of=${JSON.stringify(params.asOf)}`);
+  }
   return parts.join(" ");
 }
 function sanitizeRecallToolParams(params) {
@@ -180,7 +187,8 @@ function sanitizeRecallToolParams(params) {
     ...params.limit !== void 0 ? { limit: params.limit } : {},
     ...params.threshold !== void 0 ? { threshold: params.threshold } : {},
     ...params.types.length > 0 ? { types: params.types } : {},
-    ...params.tags.length > 0 ? { tags: params.tags } : {}
+    ...params.tags.length > 0 ? { tags: params.tags } : {},
+    ...params.asOf ? { asOf: params.asOf } : {}
   };
 }
 function sanitizeRetireToolParams(params) {
@@ -220,15 +228,24 @@ function formatUnifiedRecallResults(result) {
     lines.push(`${result.timeWindow.start} -> ${result.timeWindow.end} (${result.timeWindow.timezone}) from ${JSON.stringify(result.timeWindow.resolvedFrom)}`);
     lines.push("");
   }
+  if (result.asOf) {
+    lines.push("As Of");
+    lines.push(result.asOf);
+    lines.push("");
+  }
   const renderEntriesFirst = result.routing.detectedIntent === "historical_state";
   if (renderEntriesFirst) {
     appendEntryMatches(lines, result);
     lines.push("");
+    appendClaimTransitions(lines, result);
+    lines.push("");
     appendEpisodeMatches(lines, result);
   } else {
     appendEpisodeMatches(lines, result);
     lines.push("");
     appendEntryMatches(lines, result);
+    lines.push("");
+    appendClaimTransitions(lines, result);
   }
   if (result.notices.length > 0) {
     lines.push("");
@@ -241,15 +258,26 @@ function formatUnifiedRecallResults(result) {
 }
 function appendEntryMatches(lines, result) {
   lines.push("Entry Matches");
-  if (result.entries.length === 0) {
+  if (result.projectedEntries.length === 0) {
     lines.push("None.");
     return;
   }
-  for (const [index, entry] of result.entries.entries()) {
+  for (const [familyIndex, family] of result.entryFamilies.entries()) {
     lines.push(
-      `${index + 1}. ${entry.entry.id} | ${entry.entry.type} | ${entry.entry.subject} | score ${entry.score.toFixed(2)} | importance ${entry.entry.importance}`
+      family.claimKey ? `Family ${familyIndex + 1}. claim_key=${family.claimKey} | slot_policy=${family.slotPolicy} | primary=${family.primary.entryId} | subject=${family.subject}` : `Standalone ${familyIndex + 1}. ${family.primary.entryId} | subject=${family.subject}`
     );
-    lines.push(`   ${truncate(entry.entry.content, 220)}`);
+    for (const [entryIndex, entry] of family.entries.entries()) {
+      lines.push(
+        `   ${entryIndex + 1}. ${entry.entryId} | ${entry.recall.entry.type} | ${entry.recall.entry.subject} | score ${entry.recall.score.toFixed(2)} | state=${entry.memoryState} | claim_status=${formatClaimStatus(entry.claimStatus)}`
+      );
+      lines.push(`      ${truncate(entry.recall.entry.content, 220)}`);
+      lines.push(`      freshness=${entry.freshness.label}`);
+      const provenance = formatProjectedEntryProvenance(entry);
+      if (provenance) {
+        lines.push(`      provenance=${provenance}`);
+      }
+      lines.push(`      why_surfaced=${entry.whySurfaced.summary}`);
+    }
   }
 }
 function appendEpisodeMatches(lines, result) {
@@ -266,6 +294,25 @@ function appendEpisodeMatches(lines, result) {
     lines.push(`   why_matched=${describeEpisodeMatch(episode)}`);
   }
 }
+function appendClaimTransitions(lines, result) {
+  lines.push("Claim Transitions");
+  if (result.claimTransitions.length === 0) {
+    lines.push("None.");
+    return;
+  }
+  for (const [index, transition] of result.claimTransitions.entries()) {
+    lines.push(
+      `${index + 1}. family=${transition.claimKey ?? transition.familyKey} | slot_policy=${transition.slotPolicy}${transition.currentEntryId ? ` | current=${transition.currentEntryId}` : ""}${transition.priorEntryId ? ` | prior=${transition.priorEntryId}` : ""}`
+    );
+    lines.push(`   ${transition.summary}`);
+    if (transition.episodeContext) {
+      lines.push(
+        `   episode=${transition.episodeContext.episodeId} | ${transition.episodeContext.startedAt} -> ${transition.episodeContext.endedAt ?? transition.episodeContext.startedAt}`
+      );
+      lines.push(`   ${truncate(transition.episodeContext.summary.trim(), 220)}`);
+    }
+  }
+}
 function formatUnifiedRecallLogSummary(result) {
   const entrySubjects = result.entries.map((entry) => entry.entry.subject.trim()).filter((subject) => subject.length > 0);
   const displayed = entrySubjects.slice(0, RESULT_SUBJECT_LOG_LIMIT).map((subject) => JSON.stringify(truncate(subject, 80)));
@@ -273,7 +320,11 @@ function formatUnifiedRecallLogSummary(result) {
   const suffix = displayed.length === 0 ? "" : ` [entry subjects: ${displayed.join(", ")}${remaining > 0 ? `, ... and ${remaining} more` : ""}]`;
   return `${result.episodes.length} episode${result.episodes.length === 1 ? "" : "s"}, ${result.entries.length} entr${result.entries.length === 1 ? "y" : "ies"}${suffix}`;
 }
-function formatTrace(entry, supersededBy, supersedes, recallEvents) {
+function formatTrace(entry, supersededBy, supersedes, claimFamily, recallEvents) {
+  const slotPolicy = entry.claim_key ? claimFamily ? {
+    policy: claimFamily.slotPolicy ?? resolveClaimSlotPolicy(claimFamily.claimKey).policy,
+    reason: claimFamily.slotPolicyReason ?? resolveClaimSlotPolicy(claimFamily.claimKey).reason
+  } : resolveClaimSlotPolicy(entry.claim_key) : void 0;
   const lines = [
     `Trace for ${entry.id} | ${entry.subject}`,
     `type=${entry.type} expiry=${entry.expiry} importance=${entry.importance} retired=${entry.retired}`,
@@ -287,6 +338,22 @@ function formatTrace(entry, supersededBy, supersedes, recallEvents) {
   }
   if (entry.claim_key) {
     lines.push(`claim_key=${entry.claim_key}`);
+    if (slotPolicy) {
+      lines.push(`slot_policy=${slotPolicy.policy}`);
+      lines.push(`slot_policy_reason=${slotPolicy.reason}`);
+    }
+  }
+  if (claimFamily && claimFamily.entries.length > 0) {
+    lines.push(
+      `claim_family=${claimFamily.claimKey} | slot_policy=${slotPolicy?.policy ?? "exclusive"} | ${claimFamily.entries.map((item) => `${item.id}:${describeTraceEntryState(item)}:${formatClaimLifecycleLabel(item)}`).join(", ")}`
+    );
+    if (slotPolicy) {
+      lines.push(`claim_family_policy_reason=${slotPolicy.reason}`);
+    }
+    const transitionSummary = summarizeTraceClaimFamilyTransition(claimFamily.entries);
+    if (transitionSummary) {
+      lines.push(`transition=${transitionSummary}`);
+    }
   }
   if (entry.valid_from || entry.valid_to) {
     lines.push(`validity=${entry.valid_from ?? "?"} -> ${entry.valid_to ?? "ongoing"}`);
@@ -350,6 +417,50 @@ function describeEpisodeMatch(result) {
   }
   return "Matched episodic recall ranking.";
 }
+function formatClaimStatus(status) {
+  return status === "no_key" ? "no-key" : status;
+}
+function formatProjectedEntryProvenance(entry) {
+  const parts = [
+    entry.provenance.supersededById ? `superseded_by=${entry.provenance.supersededById}` : void 0,
+    entry.provenance.supersessionKind ? `kind=${entry.provenance.supersessionKind}` : void 0,
+    entry.provenance.supersessionReason ? `reason=${truncate(entry.provenance.supersessionReason, 120)}` : void 0,
+    entry.provenance.supportSourceKind ? `support=${entry.provenance.supportSourceKind}` : void 0,
+    entry.provenance.supportMode ? `support_mode=${entry.provenance.supportMode}` : void 0,
+    entry.provenance.supportObservedAt ? `observed=${entry.provenance.supportObservedAt}` : void 0,
+    entry.provenance.supportLocator ? `locator=${truncate(entry.provenance.supportLocator, 120)}` : void 0
+  ].filter((value) => value !== void 0);
+  return parts.join(" | ");
+}
+function describeTraceEntryState(entry) {
+  if (entry.superseded_by) {
+    return "superseded";
+  }
+  if (entry.retired || entry.valid_to) {
+    return "historical";
+  }
+  return "current";
+}
+function formatClaimLifecycleLabel(entry) {
+  if (!entry.claim_key) {
+    return "no-key";
+  }
+  return entry.claim_key_status ?? "legacy";
+}
+function summarizeTraceClaimFamilyTransition(entries) {
+  const current = entries.find((entry) => !entry.retired && !entry.superseded_by);
+  const prior = [...entries].reverse().find((entry) => entry.id !== current?.id && (entry.superseded_by !== void 0 || entry.retired || entry.valid_to !== void 0));
+  if (current && prior) {
+    return `${prior.id} -> ${current.id}`;
+  }
+  if (prior) {
+    return `${prior.id} is historical with no current sibling in the traced family`;
+  }
+  if (current) {
+    return `${current.id} is the only current sibling in the traced family`;
+  }
+  return void 0;
+}
 
 // src/adapters/openclaw/tools/recall.ts
 var RECALL_TOOL_PARAMETERS = {
@@ -389,6 +500,10 @@ var RECALL_TOOL_PARAMETERS = {
       type: "array",
       items: { type: "string" },
       description: "Optional tags to filter by once you already know the relevant entity, system, or theme."
+    },
+    asOf: {
+      type: "string",
+      description: "Optional reference time for current-vs-prior resolution. Supports ISO timestamps and the same natural-language date phrases used elsewhere in recall."
     }
   },
   required: ["query"]
@@ -409,6 +524,7 @@ function createAgenrRecallTool(ctx, servicesPromise, logger) {
         const services = await servicesPromise;
         const types = parseEntryTypes(readStringArrayParam(params, "types"));
         const tags = normalizeStringArray(readStringArrayParam(params, "tags"));
+        const asOf = readStringParam2(params, "asOf");
         const request = {
           text: query,
           ...mode ? { mode } : {},
@@ -416,6 +532,7 @@ function createAgenrRecallTool(ctx, servicesPromise, logger) {
           ...threshold !== void 0 ? { threshold } : {},
           ...types.length > 0 ? { types } : {},
           ...tags.length > 0 ? { tags } : {},
+          ...asOf ? { asOf } : {},
           sessionKey: ctx.sessionKey
         };
         logToolCall(
@@ -427,7 +544,8 @@ function createAgenrRecallTool(ctx, servicesPromise, logger) {
             mode,
             limit,
             types,
-            tags
+            tags,
+            ...asOf ? { asOf } : {}
           }),
           sanitizeRecallToolParams({
             query,
@@ -435,7 +553,8 @@ function createAgenrRecallTool(ctx, servicesPromise, logger) {
             limit,
             threshold,
             types,
-            tags
+            tags,
+            ...asOf ? { asOf } : {}
           })
         );
         const result = await runUnifiedRecall(request, {
@@ -443,13 +562,17 @@ function createAgenrRecallTool(ctx, servicesPromise, logger) {
           recall: services.recall,
           embeddingAvailable: services.embeddingStatus.available,
           embeddingError: services.embeddingStatus.error,
+          claimSlotPolicyConfig: services.pluginConfig.memoryPolicy?.slotPolicies,
           debugLog: (message) => {
             logger.debug?.(message);
           },
           embedQuery: services.embeddingStatus.available ? async (text) => {
             const vectors = await services.embedding.embed([text]);
             return vectors[0] ?? [];
-          } : void 0
+          } : void 0,
+          recallOptions: {
+            slotPolicyConfig: services.pluginConfig.memoryPolicy?.slotPolicies
+          }
         });
         logger.info(
           `[agenr] tool=agenr_recall session=${ctx.sessionId ?? "unknown"} key=${ctx.sessionKey ?? "unknown"} result: ${formatUnifiedRecallLogSummary(result)}`
@@ -463,6 +586,7 @@ function createAgenrRecallTool(ctx, servicesPromise, logger) {
             queried: result.routing.queried,
             reason: result.routing.reason
           },
+          ...result.asOf ? { asOf: result.asOf } : {},
           ...result.timeWindow ? { timeWindow: result.timeWindow } : {},
           episodes: result.episodes.map((episode) => ({
             id: episode.episode.id,
@@ -486,6 +610,30 @@ function createAgenrRecallTool(ctx, servicesPromise, logger) {
             tags: entry.entry.tags,
             content: entry.entry.content
           })),
+          projectedEntries: result.projectedEntries.map((entry) => ({
+            id: entry.entryId,
+            familyKey: entry.familyKey,
+            claimKey: entry.claimKey,
+            slotPolicy: entry.slotPolicy,
+            memoryState: entry.memoryState,
+            claimStatus: entry.claimStatus,
+            freshness: entry.freshness,
+            provenance: entry.provenance,
+            whySurfaced: entry.whySurfaced
+          })),
+          entryFamilies: result.entryFamilies.map((family) => ({
+            familyKey: family.familyKey,
+            claimKey: family.claimKey,
+            slotPolicy: family.slotPolicy,
+            subject: family.subject,
+            primaryEntryId: family.primary.entryId,
+            entries: family.entries.map((entry) => ({
+              id: entry.entryId,
+              memoryState: entry.memoryState,
+              claimStatus: entry.claimStatus
+            }))
+          })),
+          claimTransitions: result.claimTransitions,
           notices: result.notices
         });
       } catch (error) {
@@ -627,9 +775,10 @@ function createAgenrStoreTool(ctx, servicesPromise, logger) {
         const tags = normalizeStringArray(readStringArrayParam2(params, "tags"));
         const sourceContext = readStringParam4(params, "sourceContext");
         const supersedes = readStringParam4(params, "supersedes");
-        const claimKey = readStringParam4(params, "claimKey");
+        const claimKey = readStringParam4(params, "claimKey", { trim: false });
         const validFrom = readStringParam4(params, "validFrom");
         const validTo = readStringParam4(params, "validTo");
+        const claimSupportObservedAt = (/* @__PURE__ */ new Date()).toISOString();
         logToolCall(
           logger,
           "agenr_store",
@@ -660,7 +809,11 @@ function createAgenrStoreTool(ctx, servicesPromise, logger) {
               ...expiry !== void 0 ? { expiry } : {},
               ...tags.length > 0 ? { tags } : {},
               ...supersedes ? { supersedes } : {},
-              ...claimKey ? { claim_key: claimKey } : {},
+              ...claimKey ? {
+                claim_key: claimKey,
+                claim_key_raw: claimKey,
+                ...buildToolCallClaimSupport(ctx, "agenr_store", claimSupportObservedAt)
+              } : {},
               ...validFrom ? { valid_from: validFrom } : {},
               ...validTo ? { valid_to: validTo } : {},
               source_file: buildSessionSourceFile(ctx),
@@ -752,13 +905,14 @@ function createAgenrTraceTool(ctx, servicesPromise, logger) {
             entryId: entry.id
           });
         }
-        return textResult4(formatTrace(trace.entry, trace.supersededBy, trace.supersedes, trace.recallEvents), {
+        return textResult4(formatTrace(trace.entry, trace.supersededBy, trace.supersedes, trace.claimFamily, trace.recallEvents), {
           status: "ok",
           sessionKey: ctx.sessionKey,
           trace: {
             entry: trace.entry,
             supersededBy: trace.supersededBy,
             supersedes: trace.supersedes,
+            claimFamily: trace.claimFamily,
             recallEvents: trace.recallEvents
           }
         });
@@ -819,34 +973,49 @@ function createAgenrUpdateTool(ctx, servicesPromise, logger) {
         const subject = readStringParam6(params, "subject");
         const importance = readNumberParam3(params, "importance", { integer: true, strict: true });
         const expiry = parseExpiry(readStringParam6(params, "expiry"));
-        const claimKeyInput = readStringParam6(params, "claimKey");
+        const claimKeyInput = readStringParam6(params, "claimKey", { trim: false });
         const validFrom = readStringParam6(params, "validFrom");
         const validTo = readStringParam6(params, "validTo");
-        const normalizedClaimKey = claimKeyInput === void 0 ? void 0 : (() => {
-          const claimKey = normalizeClaimKey(claimKeyInput);
-          if (!claimKey.ok) {
+        const claimSupportObservedAt = (/* @__PURE__ */ new Date()).toISOString();
+        const claimSupport = claimKeyInput === void 0 ? void 0 : buildToolCallClaimSupport(ctx, "agenr_update", claimSupportObservedAt);
+        const normalizedClaimKeyUpdate = claimKeyInput === void 0 ? void 0 : (() => {
+          try {
+            return normalizeManualClaimKeyUpdate({
+              claimKey: claimKeyInput,
+              rawClaimKey: claimKeyInput,
+              supportSourceKind: claimSupport?.claim_support_source_kind,
+              supportLocator: claimSupport?.claim_support_locator,
+              supportObservedAt: claimSupport?.claim_support_observed_at,
+              supportMode: claimSupport?.claim_support_mode
+            });
+          } catch {
             throw new Error("claimKey must use canonical entity/attribute format.");
           }
-          return claimKey.value.claimKey;
         })();
         logToolCall(
           logger,
           "agenr_update",
           ctx,
           `target=${formatTargetSelector(id, subject)}${importance !== void 0 ? ` importance=${importance}` : ""}${expiry !== void 0 ? ` expiry=${expiry}` : ""}`,
-          sanitizeUpdateToolParams({ id, subject, importance, expiry, claimKey: normalizedClaimKey, validFrom, validTo })
+          sanitizeUpdateToolParams({ id, subject, importance, expiry, claimKey: normalizedClaimKeyUpdate?.claimKey, validFrom, validTo })
         );
         const services = await servicesPromise;
         const entry = await resolveTargetEntry(services, params);
-        if (importance === void 0 && expiry === void 0 && normalizedClaimKey === void 0 && validFrom === void 0 && validTo === void 0) {
+        if (importance === void 0 && expiry === void 0 && normalizedClaimKeyUpdate === void 0 && validFrom === void 0 && validTo === void 0) {
           throw new Error("Provide at least one update field: importance, expiry, claimKey, validFrom, or validTo.");
         }
+        const mergedValidity = validateTemporalValidityRange(validFrom ?? entry.valid_from, validTo ?? entry.valid_to);
+        if (!mergedValidity.ok) {
+          throw new Error(mergedValidity.message);
+        }
+        const normalizedValidFrom = validFrom !== void 0 ? mergedValidity.value.validFrom : void 0;
+        const normalizedValidTo = validTo !== void 0 ? mergedValidity.value.validTo : void 0;
         const updated = await services.entries.updateEntry(entry.id, {
           ...importance !== void 0 ? { importance } : {},
           ...expiry !== void 0 ? { expiry } : {},
-          ...normalizedClaimKey !== void 0 ? { claim_key: normalizedClaimKey } : {},
-          ...validFrom !== void 0 ? { valid_from: validFrom } : {},
-          ...validTo !== void 0 ? { valid_to: validTo } : {}
+          ...normalizedClaimKeyUpdate?.updateFields ?? {},
+          ...validFrom !== void 0 ? { valid_from: normalizedValidFrom } : {},
+          ...validTo !== void 0 ? { valid_to: normalizedValidTo } : {}
         });
         if (!updated) {
           return failedTextResult5(`Entry ${entry.id} is not active, so it could not be updated.`, {
@@ -861,9 +1030,9 @@ function createAgenrUpdateTool(ctx, servicesPromise, logger) {
           sessionKey: ctx.sessionKey,
           ...importance !== void 0 ? { importance } : {},
           ...expiry !== void 0 ? { expiry } : {},
-          ...normalizedClaimKey !== void 0 ? { claimKey: normalizedClaimKey } : {},
-          ...validFrom !== void 0 ? { validFrom } : {},
-          ...validTo !== void 0 ? { validTo } : {}
+          ...normalizedClaimKeyUpdate !== void 0 ? { claimKey: normalizedClaimKeyUpdate.claimKey } : {},
+          ...validFrom !== void 0 ? { validFrom: normalizedValidFrom } : {},
+          ...validTo !== void 0 ? { validTo: normalizedValidTo } : {}
         });
       } catch (error) {
         logToolFailure(logger, "agenr_update", ctx, error);
@@ -886,17 +1055,11 @@ function registerAgenrOpenClawTools(api, servicesPromise, logger) {
 var openclaw_plugin_default = {
   id: "agenr",
   name: "agenr",
-  version: "1.7.2",
+  version: "1.8.1",
   description: "agenr memory plugin for OpenClaw",
   kind: "memory",
   contracts: {
-    tools: [
-      "agenr_store",
-      "agenr_recall",
-      "agenr_retire",
-      "agenr_update",
-      "agenr_trace"
-    ]
+    tools: ["agenr_store", "agenr_recall", "agenr_retire", "agenr_update", "agenr_trace"]
   },
   uiHints: {
     dbPath: {
@@ -922,6 +1085,10 @@ var openclaw_plugin_default = {
     storeNudge: {
       label: "Store nudge",
       help: "Optional mid-session reminder settings for prompting durable memory storage after several turns of memory silence."
+    },
+    memoryPolicy: {
+      label: "Memory policy",
+      help: "Optional runtime overrides for claim-aware read behavior such as slot-policy classes."
     }
   },
   configSchema: {
@@ -971,6 +1138,31 @@ var openclaw_plugin_default = {
             description: "Maximum nudges injected during one session lifetime. Defaults to 5."
           }
         }
+      },
+      memoryPolicy: {
+        type: "object",
+        additionalProperties: false,
+        description: "Optional runtime overrides for claim-aware read behavior exposed by the OpenClaw adapter.",
+        properties: {
+          slotPolicies: {
+            type: "object",
+            additionalProperties: false,
+            description: "Claim-slot policy overrides keyed by canonical claim-key attribute head.",
+            properties: {
+              attributeHeads: {
+                type: "object",
+                description: "Map canonical attribute heads such as `integration` or `preference` to `exclusive` or `multivalued` read-time slot behavior.",
+                propertyNames: {
+                  pattern: "^[A-Za-z0-9][A-Za-z0-9_-]*$"
+                },
+                additionalProperties: {
+                  type: "string",
+                  enum: ["exclusive", "multivalued"]
+                }
+              }
+            }
+          }
+        }
       }
     }
   }
@@ -1023,7 +1215,11 @@ function normalizeAgenrOpenClawPluginConfig(value) {
   if (!storeNudgeResult.ok) {
     errors.push(...storeNudgeResult.errors);
   }
-  const allowedKeys = /* @__PURE__ */ new Set(["dbPath", "configPath", "continuityModel", "episodeModel", "claimExtractionModel", "storeNudge"]);
+  const memoryPolicyResult = normalizeMemoryPolicyConfig(value.memoryPolicy);
+  if (!memoryPolicyResult.ok) {
+    errors.push(...memoryPolicyResult.errors);
+  }
+  const allowedKeys = /* @__PURE__ */ new Set(["dbPath", "configPath", "continuityModel", "episodeModel", "claimExtractionModel", "storeNudge", "memoryPolicy"]);
   for (const key of Object.keys(value)) {
     if (!allowedKeys.has(key)) {
       errors.push(`unknown config field: ${key}`);
@@ -1040,7 +1236,8 @@ function normalizeAgenrOpenClawPluginConfig(value) {
       ...continuityModel ? { continuityModel } : {},
       ...episodeModel ? { episodeModel } : {},
       ...claimExtractionModel ? { claimExtractionModel } : {},
-      ...storeNudgeResult.ok && storeNudgeResult.value ? { storeNudge: storeNudgeResult.value } : {}
+      ...storeNudgeResult.ok && storeNudgeResult.value ? { storeNudge: storeNudgeResult.value } : {},
+      ...memoryPolicyResult.ok && memoryPolicyResult.value ? { memoryPolicy: memoryPolicyResult.value } : {}
     }
   };
 }
@@ -1101,6 +1298,80 @@ function normalizeStoreNudgeConfig(value) {
     value: Object.keys(normalizedValue).length > 0 ? resolveStoreNudgeConfig(normalizedValue) : void 0
   };
 }
+function normalizeMemoryPolicyConfig(value) {
+  if (value === void 0) {
+    return { ok: true, value: void 0 };
+  }
+  if (!isRecord(value)) {
+    return { ok: false, errors: ["memoryPolicy must be an object when provided"] };
+  }
+  const errors = [];
+  const slotPoliciesResult = normalizeClaimSlotPolicyConfig(value.slotPolicies);
+  if (!slotPoliciesResult.ok) {
+    errors.push(...slotPoliciesResult.errors);
+  }
+  const allowedKeys = /* @__PURE__ */ new Set(["slotPolicies"]);
+  for (const key of Object.keys(value)) {
+    if (!allowedKeys.has(key)) {
+      errors.push(`unknown config field: memoryPolicy.${key}`);
+    }
+  }
+  if (errors.length > 0) {
+    return { ok: false, errors };
+  }
+  return {
+    ok: true,
+    value: slotPoliciesResult.ok && slotPoliciesResult.value ? {
+      slotPolicies: slotPoliciesResult.value
+    } : void 0
+  };
+}
+function normalizeClaimSlotPolicyConfig(value) {
+  if (value === void 0) {
+    return { ok: true, value: void 0 };
+  }
+  if (!isRecord(value)) {
+    return { ok: false, errors: ["memoryPolicy.slotPolicies must be an object when provided"] };
+  }
+  const errors = [];
+  const attributeHeads = normalizeClaimSlotPolicyAttributeHeads(value.attributeHeads, errors);
+  const allowedKeys = /* @__PURE__ */ new Set(["attributeHeads"]);
+  for (const key of Object.keys(value)) {
+    if (!allowedKeys.has(key)) {
+      errors.push(`unknown config field: memoryPolicy.slotPolicies.${key}`);
+    }
+  }
+  if (errors.length > 0) {
+    return { ok: false, errors };
+  }
+  return {
+    ok: true,
+    value: attributeHeads ? { attributeHeads } : void 0
+  };
+}
+function normalizeClaimSlotPolicyAttributeHeads(value, errors) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!isRecord(value)) {
+    errors.push("memoryPolicy.slotPolicies.attributeHeads must be an object when provided");
+    return void 0;
+  }
+  const normalized = {};
+  for (const [rawKey, rawPolicy] of Object.entries(value)) {
+    const attributeHead = rawKey.trim().toLowerCase();
+    if (!/^[a-z0-9][a-z0-9_-]*$/.test(attributeHead)) {
+      errors.push(`memoryPolicy.slotPolicies.attributeHeads.${rawKey} must use a canonical attribute-head label`);
+      continue;
+    }
+    if (rawPolicy !== "exclusive" && rawPolicy !== "multivalued") {
+      errors.push(`memoryPolicy.slotPolicies.attributeHeads.${attributeHead} must be "exclusive" or "multivalued"`);
+      continue;
+    }
+    normalized[attributeHead] = rawPolicy;
+  }
+  return Object.keys(normalized).length > 0 ? normalized : void 0;
+}
 function normalizeOptionalBoolean(value, label, errors) {
   if (value === void 0) {
     return void 0;
@@ -2868,6 +3139,12 @@ function createAgenrMemoryRuntime(servicesPromise) {
       };
       return {
         manager: {
+          async search() {
+            return [];
+          },
+          async readFile({ relPath }) {
+            throw new Error(`[agenr] memory file reads are not supported for "${relPath}"`);
+          },
           status() {
             return status;
           },
@@ -2896,213 +3173,6 @@ function createAgenrMemoryRuntime(servicesPromise) {
   };
 }
 
-// src/adapters/db/openclaw-repository.ts
-var ZERO_VECTOR = JSON.stringify(Array.from({ length: EMBEDDING_DIMENSIONS }, () => 0));
-var ENTRY_SELECT_COLUMNS = `
-  id,
-  type,
-  subject,
-  content,
-  importance,
-  expiry,
-  tags,
-  source_file,
-  source_context,
-  embedding,
-  content_hash,
-  norm_content_hash,
-  quality_score,
-  recall_count,
-  last_recalled_at,
-  superseded_by,
-  valid_from,
-  valid_to,
-  claim_key,
-  supersession_kind,
-  supersession_reason,
-  cluster_id,
-  user_id,
-  project,
-  retired,
-  retired_at,
-  retired_reason,
-  created_at,
-  updated_at
-`;
-function createOpenClawRepository(executor) {
-  return {
-    listCoreEntries: async (limit) => listCoreEntries(executor, limit),
-    findEntryBySubject: async (subject) => findEntryBySubject(executor, subject),
-    findMostRecentEntry: async () => findMostRecentEntry(executor),
-    getEntryTrace: async (entryId) => getEntryTrace(executor, entryId),
-    getMemoryStatusSnapshot: async () => getMemoryStatusSnapshot(executor),
-    probeVectorAvailability: async () => probeVectorAvailability(executor)
-  };
-}
-async function listCoreEntries(executor, limit) {
-  if (limit <= 0) {
-    return [];
-  }
-  const result = await executor.execute({
-    sql: `
-      SELECT
-        ${ENTRY_SELECT_COLUMNS}
-      FROM entries
-      WHERE ${buildActiveEntryClause()}
-        AND expiry = 'core'
-      ORDER BY importance DESC, created_at DESC
-      LIMIT ?
-    `,
-    args: [limit]
-  });
-  return result.rows.map((row) => mapEntryRow(row));
-}
-async function findEntryBySubject(executor, subject) {
-  const normalizedSubject = subject.trim();
-  if (normalizedSubject.length === 0) {
-    return null;
-  }
-  const result = await executor.execute({
-    sql: `
-      SELECT
-        ${ENTRY_SELECT_COLUMNS},
-        CASE
-          WHEN lower(subject) = lower(?) THEN 0
-          WHEN lower(subject) LIKE lower(?) THEN 1
-          ELSE 2
-        END AS match_rank
-      FROM entries
-      WHERE lower(subject) = lower(?)
-         OR lower(subject) LIKE lower(?)
-      ORDER BY match_rank ASC, created_at DESC
-      LIMIT 1
-    `,
-    args: [normalizedSubject, `%${normalizedSubject}%`, normalizedSubject, `%${normalizedSubject}%`]
-  });
-  const row = result.rows[0];
-  return row ? mapEntryRow(row) : null;
-}
-async function findMostRecentEntry(executor) {
-  const result = await executor.execute({
-    sql: `
-      SELECT
-        ${ENTRY_SELECT_COLUMNS}
-      FROM entries
-      ORDER BY created_at DESC
-      LIMIT 1
-    `
-  });
-  const row = result.rows[0];
-  return row ? mapEntryRow(row) : null;
-}
-async function getEntryTrace(executor, entryId) {
-  const entry = await getEntryByIdIncludingInactive(executor, entryId);
-  if (!entry) {
-    return null;
-  }
-  const [supersededBy, supersedes, recallEvents] = await Promise.all([
-    entry.superseded_by ? getEntryByIdIncludingInactive(executor, entry.superseded_by) : Promise.resolve(null),
-    listSupersededEntries(executor, entry.id),
-    listRecallEvents(executor, entry.id)
-  ]);
-  return {
-    entry,
-    ...supersededBy ? { supersededBy } : {},
-    supersedes,
-    recallEvents
-  };
-}
-async function getMemoryStatusSnapshot(executor) {
-  const result = await executor.execute({
-    sql: `
-      SELECT
-        COUNT(*) AS active_entries,
-        SUM(CASE WHEN expiry = 'core' THEN 1 ELSE 0 END) AS core_entries,
-        COUNT(DISTINCT source_file) AS source_files
-      FROM entries
-      WHERE ${buildActiveEntryClause()}
-    `
-  });
-  const row = result.rows[0];
-  if (!row) {
-    return {
-      activeEntries: 0,
-      coreEntries: 0,
-      sourceFiles: 0
-    };
-  }
-  return {
-    activeEntries: readNumber(row, "active_entries", 0),
-    coreEntries: readNumber(row, "core_entries", 0),
-    sourceFiles: readNumber(row, "source_files", 0)
-  };
-}
-async function probeVectorAvailability(executor) {
-  try {
-    await executor.execute({
-      sql: `
-        SELECT COUNT(*) AS matches
-        FROM vector_top_k('${VECTOR_INDEX_NAME}', vector32(?), ?) AS matches
-      `,
-      args: [ZERO_VECTOR, 1]
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function getEntryByIdIncludingInactive(executor, entryId) {
-  const normalizedId = entryId.trim();
-  if (normalizedId.length === 0) {
-    return null;
-  }
-  const result = await executor.execute({
-    sql: `
-      SELECT
-        ${ENTRY_SELECT_COLUMNS}
-      FROM entries
-      WHERE id = ?
-      LIMIT 1
-    `,
-    args: [normalizedId]
-  });
-  const row = result.rows[0];
-  return row ? mapEntryRow(row) : null;
-}
-async function listSupersededEntries(executor, entryId) {
-  const result = await executor.execute({
-    sql: `
-      SELECT
-        ${ENTRY_SELECT_COLUMNS}
-      FROM entries
-      WHERE superseded_by = ?
-      ORDER BY created_at DESC
-    `,
-    args: [entryId]
-  });
-  return result.rows.map((row) => mapEntryRow(row));
-}
-async function listRecallEvents(executor, entryId) {
-  const result = await executor.execute({
-    sql: `
-      SELECT
-        query,
-        session_key,
-        recalled_at
-      FROM recall_events
-      WHERE entry_id = ?
-      ORDER BY recalled_at DESC
-      LIMIT 10
-    `,
-    args: [entryId]
-  });
-  return result.rows.map((row) => ({
-    query: readOptionalString(row, "query"),
-    sessionKey: readOptionalString(row, "session_key"),
-    recalledAt: readRequiredString(row, "recalled_at")
-  }));
-}
-
 // src/app/openclaw/runtime.ts
 async function createAgenrOpenClawServices(config, options) {
   const { resolvedConfig, agenrConfig: loadedAgenrConfig } = resolveRuntimeConfig(config, options.resolvePath);
@@ -3159,7 +3229,9 @@ async function createRuntimeServices(dbPath, config, embeddingStatus, openClawCo
   return {
     entries: database,
     episodes: database,
-    memory: createOpenClawRepository(database),
+    memory: createOpenClawRepository(database, {
+      claimSlotPolicyConfig: openClawContext.pluginConfig.memoryPolicy?.slotPolicies
+    }),
     embedding,
     recall: createRecallAdapter(database, embedding),
     claimExtraction,
@@ -3244,7 +3316,6 @@ var openclaw_default = definePluginEntry({
   kind: "memory",
   configSchema: createAgenrOpenClawPluginConfigSchema(),
   register(api) {
-    const memoryApi = api;
     const sessionStartTracker = createSessionStartTracker();
     const midSessionTracker = createMidSessionTracker();
     const pluginConfig = coerceAgenrOpenClawPluginConfig(api.pluginConfig);
@@ -3260,9 +3331,11 @@ var openclaw_default = definePluginEntry({
       },
       resolvePath: api.resolvePath
     });
-    api.registerMemoryPromptSection(buildAgenrMemoryPromptSection);
-    memoryApi.registerMemoryFlushPlan?.((params) => buildAgenrMemoryFlushPlan(params, api.logger));
-    memoryApi.registerMemoryRuntime?.(createAgenrMemoryRuntime(servicesPromise));
+    api.registerMemoryCapability({
+      promptBuilder: buildAgenrMemoryPromptSection,
+      flushPlanResolver: (params) => buildAgenrMemoryFlushPlan(params, api.logger),
+      runtime: createAgenrMemoryRuntime(servicesPromise)
+    });
     registerAgenrOpenClawTools(api, servicesPromise, api.logger);
     api.on(
       "before_prompt_build",