@remnic/core 9.54.3 → 9.54.5

package/dist/{chunk-6R4G7N4S.js → chunk-QQXWFDRD.js}

@@ -15,13 +15,16 @@ import {
   buildRetiredFactTombstoneInputs,
   collectRetiredMemoriesForRebuild
 } from "./chunk-MLPTFODV.js";
+import {
+  normalizeQmdResultPath
+} from "./chunk-DN2IDKI5.js";
 import {
   withholdToolScopedFromSharedNamespace
 } from "./chunk-S2V7RUCL.js";
 import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier
-} from "./chunk-UU3G6GUP.js";
+} from "./chunk-BIF4SHMD.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -29,7 +32,7 @@ import {
 import {
   rewriteProjectedEntityReferences,
   rewriteProjectedMemoryEntityReference
-} from "./chunk-WRJVB3C2.js";
+} from "./chunk-PO7NXBG2.js";
 import {
   createMemorySnapshot
 } from "./chunk-S2HLHAZ4.js";
@@ -56,7 +59,7 @@ import {
   isQueuedReviewMemory,
   parseTombstoneBlockedOfflineSyncMemory,
   tombstoneBlocked
-} from "./chunk-K4QS7LXU.js";
+} from "./chunk-WZWZRZ2V.js";
 import {
   composeMemoryEnvelope,
   isSealedMemoryEnvelope,
@@ -153,10 +156,7 @@ import {
   readMemoryActionEventRowsFromLines,
   readProjectionRebuiltAt,
   serializeLifecycleAppendPayload
-} from "./chunk-7FGL6CGA.js";
-import {
-  namespaceIdentityFromToken
-} from "./chunk-EGGE52UU.js";
+} from "./chunk-DVYRD4HY.js";
 import {
   assertMemoryFrontmatterId,
   warnProjectionFallback
@@ -182,18 +182,24 @@ import {
   readProjectedMemoryState,
   readProjectedMemoryTimeline,
   updateProjectedMemoryPath
-} from "./chunk-3CSX3ETE.js";
-import {
-  assemblePersistedBody,
-  storedContentIdentityCandidates,
-  stripAttributesSuffix
-} from "./chunk-JDSVLVCG.js";
+} from "./chunk-2LWQSV6A.js";
 import {
   withHeldFileLock
 } from "./chunk-FFAZ2XFU.js";
 import {
   computeLegacyContentHash
 } from "./chunk-5FVVY2EB.js";
+import {
+  isSupportPassportPrivateMemory
+} from "./chunk-HNDIND7P.js";
+import {
+  namespaceIdentityFromToken
+} from "./chunk-EGGE52UU.js";
+import {
+  assemblePersistedBody,
+  storedContentIdentityCandidates,
+  stripAttributesSuffix
+} from "./chunk-JDSVLVCG.js";
 import {
   sanitizeMemoryContent
 } from "./chunk-5GKPFL3S.js";
@@ -224,6 +230,7 @@ import {
   isErrnoCode
 } from "./chunk-5UZXUTVO.js";
 import {
+  ALL_CATEGORY_DIRS,
   RECALL_FALLBACK_DIRS,
   categoryDirName,
   getCategoryDir
@@ -3783,8 +3790,39 @@ function decodeYamlScalar(value) {
 
 // src/orchestration/qmd-result-resolver.ts
 import path7 from "path";
+var INTERNAL_QMD_ROOTS = /* @__PURE__ */ new Set([
+  ...ALL_CATEGORY_DIRS,
+  "activity",
+  "archive",
+  "artifacts",
+  "cold",
+  "config",
+  "entities",
+  "identity",
+  "meetings",
+  "namespaces",
+  "state",
+  "summaries",
+  "transcripts",
+  "wearables",
+  "work",
+  "workspace"
+]);
+var PRIVATE_RESULT_RESOLUTION_CONCURRENCY = 16;
 function qmdCollectionPathParts(resultPath) {
   if (!resultPath || path7.isAbsolute(resultPath)) return null;
+  if (resultPath.trim().startsWith("qmd://")) {
+    try {
+      const parsed = new URL(resultPath.trim());
+      if (parsed.protocol !== "qmd:" || !parsed.hostname) return null;
+      const collection2 = parsed.hostname;
+      const relativePath = normalizeQmdResultPath(resultPath, collection2).replace(/\\/g, "/").replace(/^\/+/, "");
+      if (!relativePath) return null;
+      return { collection: collection2, relativePath };
+    } catch {
+      return null;
+    }
+  }
   const normalized = resultPath.replace(/\\/g, "/").replace(/^\/+/, "");
   const slashIndex = normalized.indexOf("/");
   if (slashIndex <= 0 || slashIndex >= normalized.length - 1) return null;
@@ -3848,6 +3886,7 @@ var QmdResultResolver = class {
     const fallbackStorageDir = storageDirOrNull(fallbackStorage);
     const config = this.getConfig();
     const coldCollection = config.qmdColdCollection ?? "openclaw-engram-cold";
+    const fallbackResultPath = resultPath.trim().startsWith("qmd://") && parts?.collection === config.qmdCollection ? parts.relativePath : resultPath;
     if (parts && parts.collection === coldCollection) {
       const storages = [];
       const seenStorageDirs = /* @__PURE__ */ new Set();
@@ -3884,10 +3923,7 @@ var QmdResultResolver = class {
         }
         try {
           const coldRoot = path7.join(storageDir, "cold");
-          for (const candidate of qmdResultPathCandidates(
-            coldRoot,
-            parts.relativePath
-          )) {
+          for (const candidate of qmdResultPathCandidates(coldRoot, parts.relativePath)) {
             const memory = await storage.readMemoryByPath(candidate);
             if (memory) return memory;
           }
@@ -3906,10 +3942,7 @@ var QmdResultResolver = class {
     if (parts && collectionNamespace) {
       try {
         const collectionStorage = await this.storageFor(collectionNamespace);
-        for (const candidate of qmdResultPathCandidates(
-          collectionStorage.dir,
-          parts.relativePath
-        )) {
+        for (const candidate of qmdResultPathCandidates(collectionStorage.dir, parts.relativePath)) {
           const memory = await collectionStorage.readMemoryByPath(candidate);
           if (memory) return memory;
         }
@@ -3927,10 +3960,7 @@ var QmdResultResolver = class {
     if (preferredNamespace) {
       try {
         const preferredStorage = await this.storageFor(preferredNamespace);
-        for (const candidate of qmdResultPathCandidates(
-          preferredStorage.dir,
-          resultPath
-        )) {
+        for (const candidate of qmdResultPathCandidates(preferredStorage.dir, fallbackResultPath)) {
           const memory = await preferredStorage.readMemoryByPath(candidate);
           if (memory) return memory;
         }
@@ -3942,54 +3972,77 @@ var QmdResultResolver = class {
           error: err.message
         });
       }
-      if (!path7.isAbsolute(resultPath)) return null;
+      if (!path7.isAbsolute(fallbackResultPath)) return null;
     }
-    if (path7.isAbsolute(resultPath)) {
+    if (path7.isAbsolute(fallbackResultPath)) {
       if (!fallbackStorageDir) {
-        return await fallbackStorage.readMemoryByPath(resultPath);
+        return await fallbackStorage.readMemoryByPath(fallbackResultPath);
       }
       const ownerStorage = await this.storageForAbsoluteQmdResultPath(
-        resultPath,
+        fallbackResultPath,
         fallbackStorage,
         recallNamespaces
       );
       if (!ownerStorage) return null;
-      for (const candidate of qmdResultPathCandidates(
-        ownerStorage.dir,
-        resultPath
-      )) {
+      for (const candidate of qmdResultPathCandidates(ownerStorage.dir, fallbackResultPath)) {
         const memory = await ownerStorage.storage.readMemoryByPath(candidate);
         if (memory) return memory;
       }
       return null;
     }
     if (!fallbackStorageDir) {
-      return await fallbackStorage.readMemoryByPath(resultPath);
+      return await fallbackStorage.readMemoryByPath(fallbackResultPath);
     }
-    for (const candidate of qmdResultPathCandidates(
-      fallbackStorageDir,
-      resultPath
-    )) {
+    for (const candidate of qmdResultPathCandidates(fallbackStorageDir, fallbackResultPath)) {
       const memory = await fallbackStorage.readMemoryByPath(candidate);
       if (memory) return memory;
     }
     return null;
   }
+  async filterPrivateSearchResults(results, fallbackStorage, namespaces = [], preserveUnresolved = false, visibilityCache = /* @__PURE__ */ new Map()) {
+    const namespaceKey = namespaces.join("\0");
+    const entries = results.filter((result) => Boolean(result.path)).map((result) => ({
+      result,
+      cacheKey: `${namespaceKey}\0${preserveUnresolved ? "1" : "0"}\0${result.namespace ?? ""}\0${result.path}`
+    }));
+    const pending = /* @__PURE__ */ new Map();
+    for (const { result, cacheKey } of entries) {
+      if (!visibilityCache.has(cacheKey)) pending.set(cacheKey, result);
+    }
+    const unresolved = [...pending];
+    for (let offset = 0; offset < unresolved.length; offset += PRIVATE_RESULT_RESOLUTION_CONCURRENCY) {
+      await Promise.all(
+        unresolved.slice(offset, offset + PRIVATE_RESULT_RESOLUTION_CONCURRENCY).map(async ([cacheKey, result]) => {
+          visibilityCache.set(
+            cacheKey,
+            await this.isVisibleSearchResult(result, fallbackStorage, namespaces, preserveUnresolved)
+          );
+        })
+      );
+    }
+    return entries.filter(({ cacheKey }) => visibilityCache.get(cacheKey) === true).map(({ result }) => result);
+  }
+  async isVisibleSearchResult(result, fallbackStorage, namespaces, preserveUnresolved) {
+    const parts = qmdCollectionPathParts(result.path);
+    const config = this.getConfig();
+    const collectionIsKnownInternal = parts !== null && INTERNAL_QMD_ROOTS.has(parts.collection);
+    const collectionIsConfigured = parts !== null && (parts.collection === config.qmdCollection || parts.collection === (config.qmdColdCollection ?? "openclaw-engram-cold") || this.qmdCollectionNamespaceFromPrefix(parts.collection) !== null);
+    let memory = await this.readQmdResultMemory(result.path, fallbackStorage, namespaces, result.namespace);
+    if (!memory && parts && !collectionIsKnownInternal && !collectionIsConfigured) {
+      memory = await this.readQmdResultMemory(parts.relativePath, fallbackStorage, namespaces, result.namespace);
+    }
+    const absoluteInsideMemoryRoot = path7.isAbsolute(result.path) && isPathInsideStorageRoot(path7.resolve(config.memoryDir), path7.resolve(result.path));
+    const hasExplicitQmdCollection = result.path.trim().startsWith("qmd://");
+    const unresolvedInternalPath = !memory && (absoluteInsideMemoryRoot || collectionIsKnownInternal && (!preserveUnresolved || hasExplicitQmdCollection) || hasExplicitQmdCollection && collectionIsConfigured);
+    const unresolvedExternalCollection = !memory && (parts !== null && !collectionIsKnownInternal && !collectionIsConfigured || path7.isAbsolute(result.path) && !isPathInsideStorageRoot(path7.resolve(config.memoryDir), path7.resolve(result.path)));
+    return memory !== null && !isSupportPassportPrivateMemory(memory) || !memory && !unresolvedInternalPath && (preserveUnresolved || unresolvedExternalCollection);
+  }
   async resolveColdQmdResultForRecall(result, fallbackStorage, recallNamespaces = []) {
-    const memory = await this.readQmdResultMemory(
-      result.path,
-      fallbackStorage,
-      recallNamespaces,
-      result.namespace
-    );
+    const memory = await this.readQmdResultMemory(result.path, fallbackStorage, recallNamespaces, result.namespace);
     if (!memory) return null;
     let ownerNamespace = null;
     if (path7.isAbsolute(memory.path)) {
-      const ownerStorage = await this.storageForAbsoluteQmdResultPath(
-        memory.path,
-        fallbackStorage,
-        recallNamespaces
-      );
+      const ownerStorage = await this.storageForAbsoluteQmdResultPath(memory.path, fallbackStorage, recallNamespaces);
       ownerNamespace = ownerStorage?.namespace ?? null;
       if (!ownerNamespace && resolveNamespaceCapabilities(this.getConfig()).namespaces) return null;
     }
@@ -4039,9 +4092,7 @@ var QmdResultResolver = class {
       const relativeToNamespaces = path7.relative(namespacesRoot, resolvedPath);
       const [namespaceSegment] = relativeToNamespaces.split(/[\\/]/);
       if (namespaceSegment) {
-        candidateNamespaces.add(
-          namespaceIdentityFromToken(namespaceSegment) ?? namespaceSegment
-        );
+        candidateNamespaces.add(namespaceIdentityFromToken(namespaceSegment) ?? namespaceSegment);
       }
     }
     for (const policy of config.namespacePolicies ?? []) {
@@ -4052,7 +4103,6 @@ var QmdResultResolver = class {
       try {
         maybeAddStorage(await this.storageFor(ns), ns);
       } catch {
-        continue;
       }
     }
     matches.sort((a, b) => b.dir.length - a.dir.length);
@@ -5443,7 +5493,7 @@ var SORT_STR = (a, b) => a < b ? -1 : a > b ? 1 : 0;
 // src/storage/supersession-audit.ts
 import { readdir as readdir5 } from "fs/promises";
 import path10 from "path";
-async function hasSupersessionAudit(lookup, oldMemoryId, newMemoryId, auditBody) {
+async function hasSupersessionAudit(lookup, oldMemoryId, newMemoryId, auditBody, structuredAttributes) {
   let entries;
   try {
     entries = await readdir5(lookup.correctionsDir, { withFileTypes: true });
@@ -5454,7 +5504,9 @@ async function hasSupersessionAudit(lookup, oldMemoryId, newMemoryId, auditBody)
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
     const memory = await lookup.readMemoryByPath(path10.join(lookup.correctionsDir, entry.name));
-    if (memory?.frontmatter.category === "correction" && (memory.frontmatter.sourceMemoryId === oldMemoryId || memory.frontmatter.sourceMemoryId === void 0 && memory.frontmatter.lineage?.includes(oldMemoryId)) && memory.frontmatter.lineage?.includes(newMemoryId) && memory.content === auditBody) {
+    if (memory?.frontmatter.category === "correction" && (memory.frontmatter.sourceMemoryId === oldMemoryId || memory.frontmatter.sourceMemoryId === void 0 && memory.frontmatter.lineage?.includes(oldMemoryId)) && memory.frontmatter.lineage?.includes(newMemoryId) && stripAttributesSuffix(memory.content) === auditBody && (structuredAttributes === void 0 || Object.entries(structuredAttributes).every(
+      ([key, value]) => memory.frontmatter.structuredAttributes?.[key] === value
+    ))) {
       return true;
     }
   }
@@ -5502,7 +5554,7 @@ async function runSupersessionSideEffects(options) {
         if (!exists) await options.appendTombstone(exactInput);
       }
     }
-    const auditBody = `Superseded: ${currentBefore.content}
+    const auditBody = `Superseded: ${options.audit?.content ?? currentBefore.content}
 
 Reason: ${reason}`;
     const auditExists = await hasSupersessionAudit(
@@ -5512,7 +5564,8 @@ Reason: ${reason}`;
       },
       oldMemoryId,
       newMemoryId,
-      auditBody
+      auditBody,
+      options.audit?.structuredAttributes
     );
     if (!auditExists) {
       const auditEnvelope = composeMemoryEnvelope(
@@ -5520,11 +5573,13 @@ Reason: ${reason}`;
           content: auditBody,
           category: "correction",
           confidence: 1,
-          tags: ["supersession", "auto-resolved"]
+          tags: options.audit?.tags ?? ["supersession", "auto-resolved"],
+          structuredAttributes: options.audit?.structuredAttributes
         },
-        { source: "contradiction-detection" }
+        { source: options.audit?.source ?? "contradiction-detection" }
       );
       await options.writeSealedMemory(auditEnvelope, {
+        actor: options.actor,
         lineage: [oldMemoryId, newMemoryId],
         sourceMemoryId: oldMemoryId
       });
@@ -8693,7 +8748,8 @@ ${sanitized.text}
         id: duplicateBlocked.frontmatter.id,
         tombstoneBlocked: true,
         blockedBy: duplicateBlocked.frontmatter.blockedBy,
-        duplicateOf: duplicateBlocked.frontmatter.id
+        duplicateOf: duplicateBlocked.frontmatter.id,
+        memory: duplicateBlocked
       };
     }
     await this.patchHotMemoriesCache({ addedPath: filePath }, "memory-create");
@@ -8724,7 +8780,7 @@ ${sanitized.text}
       }
     }
     log.debug(`wrote memory ${id} to ${filePath}`);
-    return { id, tombstoneBlocked: tombstoneBlocked2, ...fm.blockedBy ? { blockedBy: fm.blockedBy } : {} };
+    return { id, tombstoneBlocked: tombstoneBlocked2, ...fm.blockedBy ? { blockedBy: fm.blockedBy } : {}, memory: { path: filePath, frontmatter: fm, content: sanitized.text } };
   }
   /**
    * Sealed-envelope write entry point (issue #1989 PR2).
@@ -10763,20 +10819,15 @@ ${current.content}
     }
     return updated;
   }
-  /**
-   * Get a memory by its ID.
-   */
   async getMemoryById(id) {
     const memories = await this.readAllMemories();
     return memories.find((m) => m.frontmatter.id === id) ?? null;
   }
-  /**
-   * Resolve existing active memory IDs to their on-disk paths.
-   *
-   * Uses a lightweight directory scan (collectActiveMemoryPaths) that reads
-   * file names without parsing frontmatter — much cheaper than readAllMemories()
-   * for citation usage tracking and other existence checks.
-   */
+  async getMemoryByIdIncludingArchived(id) {
+    const active = await this.getMemoryById(id);
+    return active ?? (await this.readAllColdMemories()).find((memory) => memory.frontmatter.id === id) ?? (await this.readArchivedMemories()).find((memory) => memory.frontmatter.id === id) ?? null;
+  }
+  /** Resolve existing active memory IDs through a lightweight directory scan. */
   async findExistingMemoryPaths(ids, preferredPaths = /* @__PURE__ */ new Map()) {
     if (ids.length === 0) return /* @__PURE__ */ new Map();
     const wantedIds = new Set(ids);
@@ -10862,7 +10913,8 @@ ${current.content}
       accessCount: memory.frontmatter.accessCount,
       lastAccessed: memory.frontmatter.lastAccessed,
       tags: normalizeProjectionTags(memory.frontmatter.tags),
-      preview: normalizeProjectionPreview(memory.content)
+      preview: normalizeProjectionPreview(memory.content),
+      privateRecord: isSupportPassportPrivateMemory(memory)
     };
   }
   async getMemoryTimeline(memoryId, limit = 200) {
@@ -11081,6 +11133,8 @@ ${current.content}
         exactReplay,
         currentBefore,
         updatedFm,
+        actor: options.actor,
+        audit: options.audit,
         citationTemplate: this.citationTemplate,
         correctionsDir: this.correctionsDir,
         readMemoryByPath: (filePath) => this.readMemoryByPath(filePath),
@@ -11104,7 +11158,7 @@ ${current.content}
             memoryId: oldMemoryId,
             eventType: "superseded",
             timestamp: supersededAt,
-            actor: "storage.supersedeMemory",
+            actor: options.actor ?? "storage.supersedeMemory",
             reasonCode: reason,
             before: exactReplay ? { ...beforeState, status: "active" } : beforeState,
             after: afterState,
@@ -11332,4 +11386,4 @@ export {
   isValidBufferSurpriseEvent,
   StorageManager3 as StorageManager
 };
-//# sourceMappingURL=chunk-6R4G7N4S.js.map
+//# sourceMappingURL=chunk-QQXWFDRD.js.map