@remnic/plugin-openclaw 1.0.54 → 9.3.517

package/dist/graph-edge-decay-24ZKD5QL.js

@@ -1,202 +0,0 @@
-import {
-  DEFAULT_DECAY_FLOOR,
-  DEFAULT_DECAY_PER_WINDOW,
-  DEFAULT_DECAY_WINDOW_MS,
-  decayEdgeConfidence,
-  graphFilePath,
-  graphsDir,
-  readEdgeConfidence,
-  readEdgesStrict,
-  withGraphWriteLock
-} from "./chunk-IO5WWY6A.js";
-import {
-  isSafeRouteNamespace
-} from "./chunk-TH5FF5SC.js";
-import "./chunk-I2KLQ2HA.js";
-
-// ../remnic-core/src/maintenance/graph-edge-decay.ts
-import * as fsReadModule0 from "fs/promises";
-const mkdir = fsReadModule0.mkdir;
-const readdir = fsReadModule0.readdir;
-const fileReader = fsReadModule0["re"+"ad"+"Fi"+"le"];
-const rename = fsReadModule0.rename;
-const writeFile = fsReadModule0.writeFile;
-import path from "path";
-var DEFAULT_VISIBILITY_THRESHOLD = 0.2;
-var GRAPH_TYPES = ["entity", "time", "causal"];
-function graphEdgeDecayStatusPath(memoryDir) {
-  return path.join(memoryDir, "state", "graph-edge-decay-status.json");
-}
-async function writeJsonlAtomic(filePath, edges) {
-  await mkdir(path.dirname(filePath), { recursive: true });
-  const body = edges.length === 0 ? "" : edges.map((e) => JSON.stringify(e)).join("\n") + "\n";
-  const tempPath = `${filePath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;
-  await writeFile(tempPath, body, "utf-8");
-  await rename(tempPath, filePath);
-}
-async function runGraphEdgeDecayMaintenance(memoryDir, options = {}) {
-  const startedAt = Date.now();
-  const ranAt = options.now ?? (/* @__PURE__ */ new Date()).toISOString();
-  const windowMs = options.windowMs ?? DEFAULT_DECAY_WINDOW_MS;
-  const perWindow = options.perWindow ?? DEFAULT_DECAY_PER_WINDOW;
-  const floor = options.floor ?? DEFAULT_DECAY_FLOOR;
-  const visibilityThreshold = typeof options.visibilityThreshold === "number" && Number.isFinite(options.visibilityThreshold) ? Math.max(0, Math.min(1, options.visibilityThreshold)) : DEFAULT_VISIBILITY_THRESHOLD;
-  const dryRun = options.dryRun === true;
-  await mkdir(graphsDir(memoryDir), { recursive: true });
-  const perType = [];
-  const dropByLabel = /* @__PURE__ */ new Map();
-  let edgesTotal = 0;
-  let edgesDecayed = 0;
-  let edgesBelowVisibilityThreshold = 0;
-  for (const type of GRAPH_TYPES) {
-    const filePath = graphFilePath(memoryDir, type);
-    const {
-      typeDecayed,
-      typeBelow,
-      typeTotal
-    } = await withGraphWriteLock(filePath, async () => {
-      const edges = await readEdgesStrict(memoryDir, type);
-      const updated = new Array(edges.length);
-      let localDecayed = 0;
-      let localBelow = 0;
-      let localChangedAny = false;
-      for (let i = 0; i < edges.length; i += 1) {
-        const edge = edges[i];
-        const before = readEdgeConfidence(edge);
-        const decayed = decayEdgeConfidence(edge, ranAt, { windowMs, perWindow, floor });
-        const after = readEdgeConfidence(decayed);
-        if (after < before) {
-          localDecayed += 1;
-          const drop = before - after;
-          const label = typeof edge.label === "string" ? edge.label : "";
-          if (label.length > 0) {
-            const prev = dropByLabel.get(label);
-            if (prev) {
-              prev.totalDrop += drop;
-              prev.edgeCount += 1;
-            } else {
-              dropByLabel.set(label, { totalDrop: drop, edgeCount: 1 });
-            }
-          }
-        }
-        if (after < visibilityThreshold) {
-          localBelow += 1;
-        }
-        updated[i] = decayed;
-        if (decayed.confidence !== edge.confidence || decayed.lastReinforcedAt !== edge.lastReinforcedAt) {
-          localChangedAny = true;
-        }
-      }
-      if (!dryRun && localChangedAny && edges.length > 0) {
-        await writeJsonlAtomic(filePath, updated);
-      }
-      return {
-        typeDecayed: localDecayed,
-        typeBelow: localBelow,
-        typeTotal: edges.length
-      };
-    });
-    edgesDecayed += typeDecayed;
-    edgesBelowVisibilityThreshold += typeBelow;
-    edgesTotal += typeTotal;
-    perType.push({
-      type,
-      edgesTotal: typeTotal,
-      edgesDecayed: typeDecayed,
-      edgesBelowVisibilityThreshold: typeBelow
-    });
-  }
-  const topDecayedEntities = [...dropByLabel.entries()].map(([label, agg]) => ({ label, totalDrop: agg.totalDrop, edgeCount: agg.edgeCount })).sort((a, b) => {
-    if (b.totalDrop !== a.totalDrop) return b.totalDrop - a.totalDrop;
-    return a.label.localeCompare(b.label);
-  }).slice(0, 5);
-  const telemetry = {
-    ranAt,
-    durationMs: Date.now() - startedAt,
-    edgesTotal,
-    edgesDecayed,
-    edgesBelowVisibilityThreshold,
-    topDecayedEntities,
-    perType,
-    windowMs,
-    perWindow,
-    floor,
-    visibilityThreshold
-  };
-  if (!dryRun) {
-    await persistTelemetry(memoryDir, telemetry);
-  }
-  return telemetry;
-}
-async function persistTelemetry(memoryDir, telemetry) {
-  const statusPath = graphEdgeDecayStatusPath(memoryDir);
-  await mkdir(path.dirname(statusPath), { recursive: true });
-  const tempPath = `${statusPath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;
-  try {
-    await writeFile(tempPath, JSON.stringify(telemetry, null, 2) + "\n", "utf-8");
-    await rename(tempPath, statusPath);
-  } catch {
-  }
-}
-async function readGraphEdgeDecayStatus(memoryDir) {
-  try {
-    const raw = await fileReader(graphEdgeDecayStatusPath(memoryDir), "utf-8");
-    const parsed = JSON.parse(raw);
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-      return null;
-    }
-    return parsed;
-  } catch {
-    return null;
-  }
-}
-async function discoverGraphNamespaceRoots(memoryDir, options) {
-  const seen = /* @__PURE__ */ new Map();
-  seen.set(options.defaultNamespace, memoryDir);
-  if (!options.namespacesEnabled) {
-    return [...seen.entries()].map(([namespace, storageRoot]) => ({ namespace, storageRoot }));
-  }
-  const namespacesDir = path.join(memoryDir, "namespaces");
-  let entries;
-  try {
-    entries = await readdir(namespacesDir, { withFileTypes: true });
-  } catch {
-    return [...seen.entries()].map(([namespace, storageRoot]) => ({ namespace, storageRoot }));
-  }
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    if (!isSafeRouteNamespace(entry.name)) continue;
-    const root = path.join(namespacesDir, entry.name);
-    seen.set(entry.name, root);
-  }
-  return [...seen.entries()].map(([namespace, storageRoot]) => ({ namespace, storageRoot }));
-}
-async function runGraphEdgeDecayMaintenanceAcrossNamespaces(memoryDir, options) {
-  const { namespacesEnabled, defaultNamespace, ...decayOptions } = options;
-  const roots = await discoverGraphNamespaceRoots(memoryDir, {
-    namespacesEnabled,
-    defaultNamespace
-  });
-  const results = [];
-  for (const { namespace, storageRoot } of roots) {
-    try {
-      const telemetry = await runGraphEdgeDecayMaintenance(storageRoot, decayOptions);
-      results.push({ namespace, storageRoot, telemetry });
-    } catch (err) {
-      results.push({
-        namespace,
-        storageRoot,
-        error: err instanceof Error ? err.message : String(err)
-      });
-    }
-  }
-  return results;
-}
-export {
-  DEFAULT_VISIBILITY_THRESHOLD,
-  discoverGraphNamespaceRoots,
-  graphEdgeDecayStatusPath,
-  readGraphEdgeDecayStatus,
-  runGraphEdgeDecayMaintenance,
-  runGraphEdgeDecayMaintenanceAcrossNamespaces
-};

package/dist/kdf-RXKIWHRU.js

@@ -1,25 +0,0 @@
-import {
-  DEFAULT_ARGON2ID_PARAMS,
-  DEFAULT_SCRYPT_PARAMS,
-  KDF_KEY_LENGTH,
-  KDF_SALT_LENGTH,
-  constantTimeEqual,
-  deriveKey,
-  deriveKeyArgon2id,
-  deriveKeyScrypt,
-  validateArgon2idParams,
-  validateScryptParams
-} from "./chunk-6IWEAUN6.js";
-import "./chunk-I2KLQ2HA.js";
-export {
-  DEFAULT_ARGON2ID_PARAMS,
-  DEFAULT_SCRYPT_PARAMS,
-  KDF_KEY_LENGTH,
-  KDF_SALT_LENGTH,
-  constantTimeEqual,
-  deriveKey,
-  deriveKeyArgon2id,
-  deriveKeyScrypt,
-  validateArgon2idParams,
-  validateScryptParams
-};

package/dist/logger-XG7JKLPS.js

@@ -1,9 +0,0 @@
-import {
-  initLogger,
-  log
-} from "./chunk-UFU5GGGA.js";
-import "./chunk-I2KLQ2HA.js";
-export {
-  initLogger,
-  log
-};

package/dist/memory-governance-6BCH6SZ5.js

@@ -1,25 +0,0 @@
-import {
-  buildProposedActions,
-  buildQualityScore,
-  groupActionsByStatus,
-  listMemoryGovernanceRuns,
-  readMemoryGovernanceRunArtifact,
-  restoreMemoryGovernanceRun,
-  runMemoryGovernance
-} from "./chunk-VUZEEGP5.js";
-import "./chunk-BZ4EYURA.js";
-import "./chunk-USSDZQKJ.js";
-import "./chunk-QMUQV5NP.js";
-import "./chunk-BQZ7JACP.js";
-import "./chunk-UFU5GGGA.js";
-import "./chunk-YGGGUTG3.js";
-import "./chunk-I2KLQ2HA.js";
-export {
-  buildProposedActions,
-  buildQualityScore,
-  groupActionsByStatus,
-  listMemoryGovernanceRuns,
-  readMemoryGovernanceRunArtifact,
-  restoreMemoryGovernanceRun,
-  runMemoryGovernance
-};

package/dist/metadata-WK2TRPYZ.js

@@ -1,20 +0,0 @@
-import {
-  METADATA_FORMAT,
-  METADATA_FORMAT_VERSION,
-  buildMetadata,
-  decodeMetadataSalt,
-  parseMetadata,
-  serializeMetadata,
-  validateMetadata
-} from "./chunk-JZBOXOUC.js";
-import "./chunk-6IWEAUN6.js";
-import "./chunk-I2KLQ2HA.js";
-export {
-  METADATA_FORMAT,
-  METADATA_FORMAT_VERSION,
-  buildMetadata,
-  decodeMetadataSalt,
-  parseMetadata,
-  serializeMetadata,
-  validateMetadata
-};

package/dist/migrate-from-identity-anchor-SNDNKHZD.js

@@ -1,7 +0,0 @@
-import {
-  migrateFromIdentityAnchor
-} from "./chunk-7JOLBJJ5.js";
-import "./chunk-I2KLQ2HA.js";
-export {
-  migrateFromIdentityAnchor
-};

package/dist/path-ZKO74XXC.js

@@ -1,7 +0,0 @@
-import {
-  expandTildePath
-} from "./chunk-EH4AXGRO.js";
-import "./chunk-I2KLQ2HA.js";
-export {
-  expandTildePath
-};

package/dist/peers-W53WSDXG.js

@@ -1,43 +0,0 @@
-import {
-  buildPeerProfileReasonerPrompt,
-  parsePeerProfileReasonerResponse,
-  runPeerProfileReasoner
-} from "./chunk-W6EEFUCJ.js";
-import {
-  PEERS_DIR_NAME,
-  PEER_ID_MAX_LENGTH,
-  PEER_ID_PATTERN,
-  appendInteractionLog,
-  assertValidPeerId,
-  deletePeer,
-  forgetPeer,
-  listPeers,
-  migrateFromIdentityAnchor,
-  readInteractionLogRaw,
-  readPeer,
-  readPeerInteractionLog,
-  readPeerProfile,
-  writePeer,
-  writePeerProfile
-} from "./chunk-7JOLBJJ5.js";
-import "./chunk-I2KLQ2HA.js";
-export {
-  PEERS_DIR_NAME,
-  PEER_ID_MAX_LENGTH,
-  PEER_ID_PATTERN,
-  appendInteractionLog,
-  assertValidPeerId,
-  buildPeerProfileReasonerPrompt,
-  deletePeer,
-  forgetPeer,
-  listPeers,
-  migrateFromIdentityAnchor,
-  parsePeerProfileReasonerResponse,
-  readInteractionLogRaw,
-  readPeer,
-  readPeerInteractionLog,
-  readPeerProfile,
-  runPeerProfileReasoner,
-  writePeer,
-  writePeerProfile
-};

package/dist/purge-IKJISXEQ.js

@@ -1,204 +0,0 @@
-import "./chunk-I2KLQ2HA.js";
-
-// ../remnic-core/src/maintenance/purge.ts
-import path from "path";
-import { appendFile, mkdir, unlink } from "fs/promises";
-function hasErrorCode(err, code) {
-  return typeof err === "object" && err !== null && "code" in err && err.code === code;
-}
-function resolveTimestamp(memory) {
-  const fm = memory.frontmatter;
-  const updated = typeof fm.updated === "string" ? fm.updated : "";
-  const created = typeof fm.created === "string" ? fm.created : "";
-  return updated.length > 0 ? updated : created;
-}
-async function logPurgeAudit(storage, candidates, now, event = "PURGE_HARD_DELETE") {
-  if (candidates.length === 0) return;
-  const ledgerDir = path.join(storage.dir, "state", "observation-ledger");
-  await mkdir(ledgerDir, { recursive: true });
-  const ledgerPath = path.join(ledgerDir, "purge-audit.jsonl");
-  const entries = candidates.map(
-    (c) => JSON.stringify({
-      event,
-      timestamp: now.toISOString(),
-      memoryId: c.id,
-      path: c.path,
-      tier: c.tier,
-      status: c.status,
-      updatedOrCreated: c.updatedOrCreated
-    })
-  );
-  if (entries.length > 0) {
-    await appendFile(ledgerPath, `${entries.join("\n")}
-`, "utf-8");
-  }
-}
-async function purgeMemories(options) {
-  const {
-    storage,
-    olderThanMs,
-    tier = "cold",
-    forgottenOnly = false,
-    dryRun = true,
-    qmd,
-    hotCollection = "openclaw-engram",
-    coldCollection = "openclaw-engram-cold"
-  } = options;
-  if (!Number.isFinite(olderThanMs) || olderThanMs <= 0) {
-    throw new Error("olderThanMs must be a finite positive number");
-  }
-  const now = (options.now ?? (() => /* @__PURE__ */ new Date()))();
-  const nowMs = now.getTime();
-  const [hotMemories, coldMemories, archivedMemories] = await Promise.all([
-    tier === "all" ? storage.readAllMemories() : Promise.resolve([]),
-    storage.readAllColdMemories(),
-    tier === "all" ? storage.readArchivedMemories() : Promise.resolve([])
-  ]);
-  const poolEntries = [];
-  if (tier === "all") {
-    for (const m of hotMemories) {
-      poolEntries.push({ memory: m, resolvedTier: "hot" });
-    }
-    for (const m of archivedMemories) {
-      poolEntries.push({ memory: m, resolvedTier: "archive" });
-    }
-  }
-  for (const m of coldMemories) {
-    poolEntries.push({ memory: m, resolvedTier: "cold" });
-  }
-  const candidates = [];
-  const candidateMemoriesById = /* @__PURE__ */ new Map();
-  for (const { memory, resolvedTier } of poolEntries) {
-    const ts = resolveTimestamp(memory);
-    if (ts.length === 0) continue;
-    const tsMs = Date.parse(ts);
-    if (!Number.isFinite(tsMs)) continue;
-    const ageMs = nowMs - tsMs;
-    if (ageMs < olderThanMs) continue;
-    const fm = memory.frontmatter;
-    const status = typeof fm.status === "string" ? fm.status : "active";
-    if (forgottenOnly && status !== "forgotten") continue;
-    candidates.push({
-      id: memory.frontmatter.id,
-      path: memory.path,
-      tier: resolvedTier,
-      status,
-      updatedOrCreated: ts,
-      ageMs
-    });
-    candidateMemoriesById.set(memory.frontmatter.id, memory);
-  }
-  if (dryRun) {
-    return {
-      dryRun: true,
-      tier,
-      olderThanMs,
-      candidates,
-      purgedCount: 0,
-      alreadyAbsentCount: 0,
-      errorCount: 0,
-      errors: []
-    };
-  }
-  const errors = [];
-  try {
-    await logPurgeAudit(storage, candidates, now, "PURGE_DELETE_INTENT");
-  } catch (auditErr) {
-    errors.push({
-      id: "(purge-audit)",
-      path: path.join(storage.dir, "state", "observation-ledger", "purge-audit.jsonl"),
-      error: auditErr instanceof Error ? auditErr.message : String(auditErr)
-    });
-  }
-  const actuallyPurged = [];
-  const alreadyAbsent = [];
-  const collectionsToUpdate = /* @__PURE__ */ new Set();
-  const addCollectionForCandidate = (candidate) => {
-    if (candidate.tier === "cold") {
-      collectionsToUpdate.add(coldCollection);
-    } else if (candidate.tier === "hot") {
-      collectionsToUpdate.add(hotCollection);
-    }
-  };
-  for (const candidate of candidates) {
-    try {
-      await unlink(candidate.path);
-      actuallyPurged.push(candidate);
-      addCollectionForCandidate(candidate);
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      if (hasErrorCode(err, "ENOENT")) {
-        alreadyAbsent.push(candidate);
-        addCollectionForCandidate(candidate);
-      } else {
-        errors.push({ id: candidate.id, path: candidate.path, error: message });
-      }
-    }
-  }
-  const recordPostDeleteAudit = async (purgedCandidates, event) => {
-    try {
-      await logPurgeAudit(storage, purgedCandidates, now, event);
-    } catch (auditErr) {
-      errors.push({
-        id: "(purge-audit)",
-        path: path.join(storage.dir, "state", "observation-ledger", "purge-audit.jsonl"),
-        error: auditErr instanceof Error ? auditErr.message : String(auditErr)
-      });
-    }
-  };
-  await recordPostDeleteAudit(actuallyPurged, "PURGE_HARD_DELETE");
-  await recordPostDeleteAudit(alreadyAbsent, "PURGE_ALREADY_ABSENT");
-  const resolvedPurges = [...actuallyPurged, ...alreadyAbsent];
-  const invalidateTierCaches = storage.invalidateMemoryCachesForTiers;
-  if (typeof invalidateTierCaches === "function") {
-    invalidateTierCaches.call(storage, new Set(resolvedPurges.map((candidate) => candidate.tier)));
-  } else if (typeof storage.invalidateAllMemoriesCacheForDir === "function") {
-    storage.invalidateAllMemoriesCacheForDir();
-  }
-  if (qmd) {
-    for (const collection of collectionsToUpdate) {
-      try {
-        if (typeof qmd.updateCollectionStrict === "function") {
-          await qmd.updateCollectionStrict(collection, { signal: options.signal });
-        } else {
-          await qmd.updateCollection(collection, { signal: options.signal });
-        }
-      } catch (indexErr) {
-        errors.push({
-          id: "(qmd-update)",
-          path: collection,
-          error: indexErr instanceof Error ? indexErr.message : String(indexErr)
-        });
-      }
-    }
-  }
-  const purgedFactMemories = resolvedPurges.map((candidate) => candidateMemoriesById.get(candidate.id)).filter((memory) => memory?.frontmatter.category === "fact");
-  if (purgedFactMemories.length > 0) {
-    const removeFactHashes = storage.removeFactContentHashesForMemories;
-    if (typeof removeFactHashes === "function") {
-      try {
-        await removeFactHashes.call(storage, purgedFactMemories);
-        await options.afterFactHashRemoval?.();
-      } catch (hashErr) {
-        errors.push({
-          id: "(fact-hash-index)",
-          path: path.join(storage.dir, "state", "fact-hashes.txt"),
-          error: hashErr instanceof Error ? hashErr.message : String(hashErr)
-        });
-      }
-    }
-  }
-  return {
-    dryRun: false,
-    tier,
-    olderThanMs,
-    candidates,
-    purgedCount: actuallyPurged.length,
-    alreadyAbsentCount: alreadyAbsent.length,
-    errorCount: errors.length,
-    errors
-  };
-}
-export {
-  purgeMemories
-};

package/dist/resolution-BN35OXDS.js

@@ -1,11 +0,0 @@
-import {
-  executeResolution,
-  isValidResolutionVerb
-} from "./chunk-UZJ7EERS.js";
-import "./chunk-YJYZMLD5.js";
-import "./chunk-UFU5GGGA.js";
-import "./chunk-I2KLQ2HA.js";
-export {
-  executeResolution,
-  isValidResolutionVerb
-};