openclaw
Version:
Multi-channel AI gateway with extensible messaging integrations
980 lines (979 loc) • 39.8 kB
JavaScript
import { i as extractErrorCode } from "./error-coercion-D_-xJ90S.js";
import { d as normalizeStringEntries, y as uniqueStrings } from "./string-normalization-DsCfAx8q.js";
import { r as truncateUtf16Safe } from "./utf16-slice-D_ngcYKd.js";
import { t as formatErrorMessage } from "./errors-Db3Ymjlb.js";
import { D as resolveMemoryRemDreamingConfig, E as resolveMemoryLightDreamingConfig, T as resolveMemoryDreamingWorkspaces, y as formatMemoryDreamingDay } from "./dreaming-DmJZL5-O.js";
import "./memory-core-host-engine-foundation-BZwrR3xr.js";
import { n as listMemoryArtifactProvenance } from "./memory-artifact-provenance-DbHviOjX.js";
import "./error-runtime-Bz9Tw57Z.js";
import "./string-coerce-runtime-GQa0ehRA.js";
import { c as listSessionTranscriptCorpusEntriesForAgent } from "./memory-core-host-engine-sessions-Cn5pEjBS.js";
import "./memory-core-host-status-DAqa4uMk.js";
import "./memory-core-host-runtime-core-5HBGxdZe.js";
import { _ as normalizeMemoryCoreWorkspaceKey, b as writeMemoryCoreWorkspaceEntries, t as DREAMING_DAILY_INGESTION_NAMESPACE, y as readMemoryCoreWorkspaceEntries } from "./dreaming-state-B0qd2W7q.js";
import "./dreaming-shared-BQNg89r7.js";
import { t as appendFailedDreamingEvent } from "./dreaming-events-CzumSDAB.js";
import { m as withMemoryWorkspaceLock, o as readRecentDreamDiaryEntries } from "./dreaming-dreams-file-DQfkc_tk.js";
import { g as compareStoreTimestampDesc, z as normalizeConceptToken } from "./short-term-promotion-store-DtOtPkAq.js";
import { _ as recordRemConsideredPhaseSignals, f as recordShortTermRecalls, g as recordDreamingPhaseSignals, h as readLightStagedKeys, l as filterLiveShortTermRecallEntries, p as filterFreshLightDreamingEntries, u as readShortTermRecallEntries, x as isPromotionOriginBlocked } from "./short-term-promotion-BWqNnYfM.js";
import { n as normalizeDailyIngestionState, r as normalizeMemoryDay } from "./dreaming-ingestion-state-CsGJDNHD.js";
import { t as writeDailyDreamingPhaseBlock } from "./dreaming-markdown-DTww7Idt.js";
import { n as runDreamNarrative } from "./dreaming-narrative-PyGvnyEe.js";
import { i as listMemorySessionTombstones } from "./memory-entry-origins-DGcbM97X.js";
import { n as textSimilarity } from "./tokenize-CfwNmyGX.js";
import { a as mergeTrackedMessageHashes, c as scanSessionIngestionSource, d as sessionIngestionStateKeyFromCorpus, f as trimTrackedSessionScopes, l as sessionExclusionReason, o as readSessionIngestionState, p as writeSessionIngestionState, r as appendSessionCorpusLines, s as resolveAdmissionPolicy, u as sessionIngestionSourceFromCorpus } from "./session-ingestion-Cx5hXbYJ.js";
import path from "node:path";
import fs from "node:fs/promises";
import { createHash } from "node:crypto";
//#region extensions/memory-core/src/dreaming-phases.ts
const DAILY_MEMORY_FILENAME_RE = /^(\d{4}-\d{2}-\d{2})(?:-[^/]+)?\.md$/i;
const DAILY_INGESTION_SCORE = .62;
const DAILY_INGESTION_MAX_SNIPPET_CHARS = 280;
const DAILY_INGESTION_MIN_SNIPPET_CHARS = 8;
const DAILY_INGESTION_MAX_CHUNK_LINES = 4;
const SESSION_CHECKPOINT_TRANSCRIPT_FILENAME_RE = /\.checkpoint\..+\.jsonl$/i;
const LIGHT_DIARY_HISTORY_LIMIT = 4;
const LIGHT_DIARY_SNIPPET_SIMILARITY_THRESHOLD = .35;
const GENERIC_DAY_HEADING_RE = /^(?:(?:mon|monday|tue|tues|tuesday|wed|wednesday|thu|thur|thurs|thursday|fri|friday|sat|saturday|sun|sunday)(?:,\s+)?)?(?:(?:jan|january|feb|february|mar|march|apr|april|may|jun|june|jul|july|aug|august|sep|sept|september|oct|october|nov|november|dec|december)\s+\d{1,2}(?:st|nd|rd|th)?(?:,\s*\d{4})?|\d{1,2}[/-]\d{1,2}(?:[/-]\d{2,4})?|\d{4}[/-]\d{2}[/-]\d{2})$/i;
const MANAGED_DAILY_DREAMING_BLOCKS = [{
heading: "## Light Sleep",
startMarker: "<!-- openclaw:dreaming:light:start -->",
endMarker: "<!-- openclaw:dreaming:light:end -->"
}, {
heading: "## REM Sleep",
startMarker: "<!-- openclaw:dreaming:rem:start -->",
endMarker: "<!-- openclaw:dreaming:rem:end -->"
}];
function calculateLookbackCutoffMs(nowMs, lookbackDays) {
return nowMs - Math.max(0, lookbackDays) * 24 * 60 * 60 * 1e3;
}
function isDayWithinLookback(day, cutoffMs) {
const dayMs = Date.parse(`${day}T23:59:59.999Z`);
return Number.isFinite(dayMs) && dayMs >= cutoffMs;
}
function normalizeDailyListMarker(line) {
return line.replace(/^\d+\.\s+/, "").replace(/^[-*+]\s+/, "").trim();
}
function normalizeDailyHeading(line) {
const match = line.trim().match(/^#{1,6}\s+(.+)$/);
if (!match) return null;
const heading = match[1] ? normalizeDailyListMarker(match[1]) : "";
if (!heading || DAILY_MEMORY_FILENAME_RE.test(heading) || isGenericDailyHeading(heading)) return null;
return truncateUtf16Safe(heading, DAILY_INGESTION_MAX_SNIPPET_CHARS).replace(/\s+/g, " ");
}
function isGenericDailyHeading(heading) {
const normalized = heading.trim().replace(/\s+/g, " ");
if (!normalized) return true;
const lower = normalized.toLowerCase();
if (lower === "today" || lower === "yesterday" || lower === "tomorrow") return true;
if (lower === "morning" || lower === "afternoon" || lower === "evening" || lower === "night") return true;
return GENERIC_DAY_HEADING_RE.test(normalized);
}
function normalizeDailySnippet(line) {
const trimmed = line.trim();
if (!trimmed || trimmed.startsWith("#") || trimmed.startsWith("<!--")) return null;
const withoutListMarker = normalizeDailyListMarker(trimmed);
if (withoutListMarker.length < DAILY_INGESTION_MIN_SNIPPET_CHARS) return null;
return truncateUtf16Safe(withoutListMarker, DAILY_INGESTION_MAX_SNIPPET_CHARS).replace(/\s+/g, " ");
}
function buildDailyChunkSnippet(heading, chunkLines) {
const body = chunkLines.join(" ").trim();
const prefixed = heading ? `${heading}: ${body}` : body;
return truncateUtf16Safe(prefixed, DAILY_INGESTION_MAX_SNIPPET_CHARS).replace(/\s+/g, " ").trim();
}
function buildDailyListSnippet(heading, ancestors, snippet) {
return buildDailyChunkSnippet(heading, [[...ancestors, snippet].join(" > ").replaceAll(": > ", ": ")]);
}
function buildDailySnippetChunks(lines, limit) {
const chunks = [];
let activeHeading = null;
let chunkLines = [];
let chunkStartLine = 0;
let chunkEndLine = 0;
let listAncestors = [];
const flushChunk = () => {
if (chunkLines.length === 0) {
chunkStartLine = 0;
chunkEndLine = 0;
return;
}
const snippet = buildDailyChunkSnippet(activeHeading, chunkLines);
if (snippet.length >= DAILY_INGESTION_MIN_SNIPPET_CHARS) chunks.push({
startLine: chunkStartLine,
endLine: chunkEndLine,
snippet
});
chunkLines = [];
chunkStartLine = 0;
chunkEndLine = 0;
};
for (let index = 0; index < lines.length; index += 1) {
const line = lines[index];
if (typeof line !== "string") continue;
const heading = normalizeDailyHeading(line);
if (heading) {
flushChunk();
activeHeading = heading;
listAncestors = [];
continue;
}
const trimmed = line.trim();
if (!trimmed || trimmed.startsWith("<!--")) {
flushChunk();
listAncestors = [];
continue;
}
const listMatch = line.match(/^(\s*)(?:[-*+]|\d+\.)\s+(.+)$/);
if (listMatch) {
flushChunk();
const indent = listMatch[1]?.length ?? 0;
const listText = truncateUtf16Safe(normalizeDailyListMarker(trimmed), DAILY_INGESTION_MAX_SNIPPET_CHARS).replace(/\s+/g, " ");
if (!listText) {
listAncestors = [];
continue;
}
while ((listAncestors.at(-1)?.indent ?? -1) >= indent) listAncestors.pop();
const continuationLines = [];
let endIndex = index;
let hasNestedChild = false;
let nestedChildIndex;
for (let cursor = index + 1; cursor < lines.length; cursor += 1) {
const nextLine = lines[cursor];
if (typeof nextLine !== "string") break;
const nextTrimmed = nextLine.trim();
if (!nextTrimmed) {
let nextContentIndex = cursor + 1;
while (nextContentIndex < lines.length && !lines[nextContentIndex]?.trim()) nextContentIndex += 1;
const looseChildMatch = lines[nextContentIndex]?.match(/^(\s*)(?:[-*+]|\d+\.)\s+(.+)$/);
if (looseChildMatch && (looseChildMatch[1]?.length ?? 0) > indent) {
hasNestedChild = true;
nestedChildIndex = nextContentIndex;
}
break;
}
if (nextTrimmed.startsWith("#") || nextTrimmed.startsWith("<!--")) break;
const nextListMatch = nextLine.match(/^(\s*)(?:[-*+]|\d+\.)\s+(.+)$/);
if (nextListMatch) {
hasNestedChild = (nextListMatch[1]?.length ?? 0) > indent;
break;
}
continuationLines.push(nextTrimmed.replace(/\s+/g, " "));
endIndex = cursor;
}
const claimBody = [listText, ...continuationLines].join(" ");
const contextualSnippet = buildDailyListSnippet(activeHeading, listAncestors.map((ancestor) => ancestor.text), claimBody);
if (!(hasNestedChild && continuationLines.length === 0 && listText.endsWith(":")) && contextualSnippet.length >= DAILY_INGESTION_MIN_SNIPPET_CHARS) chunks.push({
startLine: index + 1,
endLine: endIndex + 1,
snippet: contextualSnippet,
identitySnippet: contextualSnippet
});
listAncestors.push({
indent,
text: claimBody
});
index = nestedChildIndex === void 0 ? endIndex : nestedChildIndex - 1;
if (chunks.length >= limit) break;
continue;
}
listAncestors = [];
const snippet = normalizeDailySnippet(line);
if (!snippet) {
flushChunk();
continue;
}
const nextChunkLines = chunkLines.length === 0 ? [snippet] : [...chunkLines, snippet];
const candidateSnippet = buildDailyChunkSnippet(activeHeading, nextChunkLines);
if (chunkLines.length > 0 && (chunkLines.length >= DAILY_INGESTION_MAX_CHUNK_LINES || candidateSnippet.length > DAILY_INGESTION_MAX_SNIPPET_CHARS)) flushChunk();
if (chunkLines.length === 0) chunkStartLine = index + 1;
chunkLines.push(snippet);
chunkEndLine = index + 1;
if (chunks.length >= limit) break;
}
flushChunk();
return chunks.slice(0, limit);
}
function resolveDailyFileProvenance(params) {
if (params.recorded?.originClass === "untrusted") return {
originClass: "untrusted",
observedAt: params.recorded.observedAt
};
if (params.recorded?.fileHash === params.currentHash) return {
originClass: params.recorded.originClass,
observedAt: params.recorded.observedAt
};
return {
originClass: "agent",
observedAt: params.defaultObservedAt
};
}
function findManagedDailyDreamingHeadingIndex(lines, startIndex, heading) {
for (let index = startIndex - 1; index >= 0; index -= 1) {
const trimmed = lines[index]?.trim() ?? "";
if (!trimmed) continue;
return trimmed === heading ? index : null;
}
return null;
}
function isManagedDailyDreamingBoundary(line, blockByStartMarker) {
const trimmed = line.trim();
return /^#{1,6}\s+/.test(trimmed) || blockByStartMarker.has(trimmed);
}
function stripManagedDailyDreamingLines(lines) {
const blockByStartMarker = new Map(MANAGED_DAILY_DREAMING_BLOCKS.map((block) => [block.startMarker, block]));
const sanitized = [...lines];
for (let index = 0; index < sanitized.length; index += 1) {
const block = blockByStartMarker.get(sanitized[index]?.trim() ?? "");
if (!block) continue;
let stripUntilIndex = -1;
for (let cursor = index + 1; cursor < sanitized.length; cursor += 1) {
const line = sanitized[cursor];
if ((line?.trim() ?? "") === block.endMarker) {
stripUntilIndex = cursor;
break;
}
if (line && isManagedDailyDreamingBoundary(line, blockByStartMarker)) {
stripUntilIndex = cursor - 1;
break;
}
}
if (stripUntilIndex < index) continue;
const startIndex = findManagedDailyDreamingHeadingIndex(lines, index, block.heading) ?? index;
for (let cursor = startIndex; cursor <= stripUntilIndex; cursor += 1) sanitized[cursor] = "";
index = stripUntilIndex;
}
return sanitized;
}
function buildDailyIngestionResults(params) {
const provenance = resolveDailyFileProvenance({
currentHash: createHash("sha256").update(params.raw).digest("hex"),
defaultObservedAt: params.defaultObservedAt,
...params.recorded ? { recorded: params.recorded } : {}
});
return buildDailySnippetChunks(stripManagedDailyDreamingLines(params.raw.split(/\r?\n/)), params.limit).map((chunk) => Object.assign({
path: params.path,
startLine: chunk.startLine,
endLine: chunk.endLine,
score: DAILY_INGESTION_SCORE,
snippet: chunk.snippet,
source: "memory",
provenance: {
...provenance,
sessionKind: "unknown"
}
}, chunk.identitySnippet ? { identitySnippet: chunk.identitySnippet } : {}));
}
function entryWithinLookback(entry, cutoffMs) {
if ((entry.recallDays ?? []).some((day) => isDayWithinLookback(day, cutoffMs))) return true;
if (Math.max(0, Math.floor(entry.dailyCount ?? 0)) > 0 && Math.max(0, Math.floor(entry.recallCount ?? 0)) === 0 && Math.max(0, Math.floor(entry.groundedCount ?? 0)) === 0) return false;
const lastRecalledAtMs = Date.parse(entry.lastRecalledAt);
return Number.isFinite(lastRecalledAtMs) && lastRecalledAtMs >= cutoffMs;
}
function filterRecallEntriesWithinLookback(params) {
const cutoffMs = calculateLookbackCutoffMs(params.nowMs, params.lookbackDays);
return params.entries.filter((entry) => entryWithinLookback(entry, cutoffMs));
}
function parseDailyMemoryFileName(fileName) {
const day = fileName.match(DAILY_MEMORY_FILENAME_RE)?.[1];
return day ? {
fileName,
day,
canonical: fileName.toLowerCase() === `${day}.md`
} : null;
}
function compareDailyMemoryFilesByNewestDay(left, right) {
const dayOrder = right.day.localeCompare(left.day);
if (dayOrder !== 0) return dayOrder;
if (left.canonical !== right.canonical) return left.canonical ? -1 : 1;
return left.fileName.localeCompare(right.fileName);
}
function resolveWorkspaceMemoryRelativePath(workspaceDir, filePath) {
const relativePath = path.relative(workspaceDir, filePath).replace(/\\/g, "/");
if (relativePath && relativePath !== ".." && !relativePath.startsWith("../")) return relativePath;
return `memory/${path.basename(filePath)}`;
}
async function readDailyIngestionState(workspaceDir) {
const entries = await readMemoryCoreWorkspaceEntries({
namespace: DREAMING_DAILY_INGESTION_NAMESPACE,
workspaceDir
});
return normalizeDailyIngestionState({
version: 1,
files: Object.fromEntries(entries.map((entry) => [entry.key, entry.value]))
});
}
async function writeDailyIngestionState(workspaceDir, state) {
await writeMemoryCoreWorkspaceEntries({
namespace: DREAMING_DAILY_INGESTION_NAMESPACE,
workspaceDir,
entries: Object.entries(state.files).map(([key, value]) => ({
key,
value
}))
});
}
function isCheckpointSessionTranscriptPath(absolutePath) {
return SESSION_CHECKPOINT_TRANSCRIPT_FILENAME_RE.test(path.basename(absolutePath));
}
function resolveSessionAgentsForWorkspace(params) {
const { cfg, workspaceDir, primaryWorkspaceDir } = params;
const target = normalizeMemoryCoreWorkspaceKey(workspaceDir);
const match = resolveMemoryDreamingWorkspaces(cfg, {
primaryWorkspaceDir,
primaryAgentId: "main"
}).find((entry) => normalizeMemoryCoreWorkspaceKey(entry.workspaceDir) === target);
if (!match) return [];
return uniqueStrings(match.agentIds.filter((agentId) => agentId.trim().length > 0)).toSorted();
}
async function collectSessionIngestionBatches(params) {
if (!params.cfg) {
const nextState = {
version: 3,
files: {},
seenMessages: {}
};
return {
batches: [],
nextState,
changed: JSON.stringify(nextState) !== JSON.stringify(params.state)
};
}
const agentIds = resolveSessionAgentsForWorkspace({
cfg: params.cfg,
workspaceDir: params.workspaceDir,
primaryWorkspaceDir: params.primaryWorkspaceDir
});
const cutoffMs = calculateLookbackCutoffMs(params.nowMs, params.lookbackDays);
const batchByDay = /* @__PURE__ */ new Map();
const nextFiles = { ...params.state.files };
const nextSeenMessages = { ...params.state.seenMessages };
const sources = [];
for (const agentId of agentIds) {
const knownStateKeys = /* @__PURE__ */ new Set();
const forgottenSessionIds = new Set(listMemorySessionTombstones({ agentId }).map((tombstone) => tombstone.sessionId));
for (const entry of await listSessionTranscriptCorpusEntriesForAgent(agentId, { includeRetainedSqlite: true })) {
knownStateKeys.add(sessionIngestionStateKeyFromCorpus(entry));
const source = sessionIngestionSourceFromCorpus(entry);
if (!source) continue;
if (entry.artifactKind !== "active-session" || isCheckpointSessionTranscriptPath(entry.sessionFile)) continue;
const excludedReason = sessionExclusionReason(source, params.admissionPolicy, forgottenSessionIds);
if (excludedReason) {
nextFiles[source.stateKey] = {
mtimeMs: entry.updatedAtMs ?? 0,
size: 0,
contentHash: "",
lineCount: 0,
lastContentLine: 0,
excludedReason
};
continue;
}
sources.push(source);
}
for (const stateKey of Object.keys(nextFiles)) if (stateKey.startsWith(`${agentId}:`) && !knownStateKeys.has(stateKey)) delete nextFiles[stateKey];
}
const sortedSources = sources.toSorted((a, b) => {
if (a.agentId !== b.agentId) return a.agentId.localeCompare(b.agentId);
return a.sessionPath.localeCompare(b.sessionPath);
});
const totalCap = 240;
let remaining = totalCap;
const perFileCap = Math.min(80, Math.max(12, Math.ceil(totalCap / Math.max(1, sortedSources.length))));
for (const source of sortedSources) {
if (remaining <= 0) break;
const fileCap = Math.max(1, Math.min(perFileCap, remaining));
const scan = await scanSessionIngestionSource({
source,
previous: params.state.files[source.stateKey],
seenMessages: nextSeenMessages,
timezone: params.timezone,
maxCandidates: fileCap,
classifyDay: (day) => isDayWithinLookback(day, cutoffMs) ? "include" : "skip"
});
if (scan.status === "absent") {
delete nextFiles[source.stateKey];
continue;
}
if (scan.fileState) nextFiles[source.stateKey] = scan.fileState;
if (scan.status !== "scanned") continue;
for (const candidate of scan.candidates) {
const bucket = batchByDay.get(candidate.day) ?? [];
bucket.push(candidate);
batchByDay.set(candidate.day, bucket);
}
if (scan.candidates.length > 0) {
const previousSeen = nextSeenMessages[source.scope] ?? [];
nextSeenMessages[source.scope] = mergeTrackedMessageHashes(previousSeen, scan.candidates.map((candidate) => candidate.hash));
remaining -= scan.candidates.length;
}
}
const trimmedSeenMessages = trimTrackedSessionScopes(nextSeenMessages);
const batches = [];
for (const day of [...batchByDay.keys()].toSorted()) {
const lines = batchByDay.get(day) ?? [];
if (lines.length === 0) continue;
const results = await appendSessionCorpusLines({
workspaceDir: params.workspaceDir,
day,
lines
});
if (results.length > 0) batches.push({
day,
results
});
}
const nextState = {
version: 3,
files: nextFiles,
seenMessages: trimmedSeenMessages
};
return {
batches,
nextState,
changed: JSON.stringify(nextState) !== JSON.stringify(params.state)
};
}
async function ingestSessionTranscriptSignals(params) {
await withMemoryWorkspaceLock(params.workspaceDir, async () => {
const state = await readSessionIngestionState(params.workspaceDir);
const collected = await collectSessionIngestionBatches({
workspaceDir: params.workspaceDir,
cfg: params.cfg,
primaryWorkspaceDir: params.primaryWorkspaceDir,
lookbackDays: params.lookbackDays,
nowMs: params.nowMs,
timezone: params.timezone,
state,
admissionPolicy: params.admissionPolicy
});
const ingestionDayBucket = formatMemoryDreamingDay(params.nowMs, params.timezone);
for (const batch of collected.batches) await recordShortTermRecalls({
workspaceDir: params.workspaceDir,
query: `__dreaming_sessions__:${batch.day}`,
results: batch.results,
signalType: "daily",
dedupeByQueryPerDay: true,
dayBucket: ingestionDayBucket,
nowMs: params.nowMs,
timezone: params.timezone
});
if (collected.changed) await writeSessionIngestionState(params.workspaceDir, collected.nextState);
});
}
const DEFAULT_DAILY_INGESTION_LOOKBACK_DAYS = 14;
function dailyIngestionLookbackDays(phaseLookbackDays) {
return Math.max(DEFAULT_DAILY_INGESTION_LOOKBACK_DAYS, phaseLookbackDays);
}
async function collectDailyIngestionBatches(params) {
const provenanceEntries = await listMemoryArtifactProvenance({ workspaceDir: params.workspaceDir });
const provenanceByPath = new Map(provenanceEntries.map((entry) => [entry.relativePath, entry.provenance]));
const memoryDir = path.join(params.workspaceDir, "memory");
const cutoffMs = calculateLookbackCutoffMs(params.nowMs, params.lookbackDays);
const files = (await fs.readdir(memoryDir, { withFileTypes: true }).catch((err) => {
if (extractErrorCode(err) === "ENOENT") return [];
throw err;
})).filter((entry) => entry.isFile()).map((entry) => {
const file = parseDailyMemoryFileName(entry.name);
if (!file) return null;
if (!isDayWithinLookback(file.day, cutoffMs)) return null;
return file;
}).filter((entry) => entry !== null).toSorted(compareDailyMemoryFilesByNewestDay);
const batches = [];
const nextFiles = {};
let changed = false;
const totalCap = Math.max(20, params.limit * 4);
const perFileCap = Math.max(6, Math.ceil(totalCap / Math.max(1, Math.max(files.length, 1))));
let total = 0;
for (const file of files) {
const relativePath = `memory/${file.fileName}`;
const filePath = path.join(memoryDir, file.fileName);
const stat = await fs.stat(filePath).catch((err) => {
if (extractErrorCode(err) === "ENOENT") return null;
throw err;
});
if (!stat) continue;
const fingerprint = {
mtimeMs: Math.floor(Math.max(0, stat.mtimeMs)),
size: Math.floor(Math.max(0, stat.size))
};
nextFiles[relativePath] = fingerprint;
const previous = params.state.files[relativePath];
const unchanged = previous !== void 0 && previous.mtimeMs === fingerprint.mtimeMs && previous.size === fingerprint.size;
const previousDreamingDay = normalizeMemoryDay(previous?.lastDreamingDayIngested);
if (unchanged && previousDreamingDay === params.ingestionDreamingDay) {
nextFiles[relativePath] = {
...fingerprint,
lastDreamingDayIngested: previousDreamingDay
};
continue;
}
changed = true;
const raw = await fs.readFile(filePath, "utf-8").catch((err) => {
if (extractErrorCode(err) === "ENOENT") return "";
throw err;
});
if (!raw) continue;
const recordedProvenance = provenanceByPath.get(relativePath);
const results = buildDailyIngestionResults({
raw,
path: relativePath,
limit: Math.min(perFileCap, totalCap - total),
defaultObservedAt: fingerprint.mtimeMs,
...recordedProvenance ? { recorded: recordedProvenance } : {}
});
if (results.length === 0) continue;
batches.push({
day: file.day,
results
});
total += results.length;
nextFiles[relativePath] = {
...fingerprint,
lastDreamingDayIngested: params.ingestionDreamingDay
};
if (total >= totalCap) break;
}
if (!changed) {
const previousKeys = Object.keys(params.state.files);
const nextKeys = Object.keys(nextFiles);
if (previousKeys.length !== nextKeys.length || previousKeys.some((key) => !Object.hasOwn(nextFiles, key))) changed = true;
}
return {
batches,
nextState: {
version: 1,
files: nextFiles
},
changed
};
}
async function ingestDailyMemorySignals(params) {
await withMemoryWorkspaceLock(params.workspaceDir, async () => {
const state = await readDailyIngestionState(params.workspaceDir);
const ingestionDayBucket = formatMemoryDreamingDay(params.nowMs, params.timezone);
const collected = await collectDailyIngestionBatches({
workspaceDir: params.workspaceDir,
lookbackDays: params.lookbackDays,
limit: params.limit,
nowMs: params.nowMs,
ingestionDreamingDay: ingestionDayBucket,
state
});
for (const batch of collected.batches) await recordShortTermRecalls({
workspaceDir: params.workspaceDir,
query: `__dreaming_daily__:${batch.day}`,
results: batch.results,
signalType: "daily",
dedupeByQueryPerDay: false,
dayBucket: batch.day,
nowMs: params.nowMs,
timezone: params.timezone
});
if (collected.changed) await writeDailyIngestionState(params.workspaceDir, collected.nextState);
});
}
async function seedHistoricalDailyMemorySignals(params) {
const normalizedPaths = uniqueStrings(normalizeStringEntries(params.filePaths));
if (normalizedPaths.length === 0) return {
importedFileCount: 0,
importedSignalCount: 0,
skippedPaths: []
};
return await withMemoryWorkspaceLock(params.workspaceDir, async () => {
const provenanceEntries = await listMemoryArtifactProvenance({ workspaceDir: params.workspaceDir });
const provenanceByPath = new Map(provenanceEntries.map((entry) => [entry.relativePath, entry.provenance]));
const resolved = normalizedPaths.map((filePath) => {
const fileName = path.basename(filePath);
const file = parseDailyMemoryFileName(fileName);
if (!file) return {
filePath,
fileName,
relativePath: "",
file: null
};
return {
filePath,
fileName,
relativePath: resolveWorkspaceMemoryRelativePath(params.workspaceDir, filePath),
file
};
}).toSorted((a, b) => {
if (a.file && b.file) return compareDailyMemoryFilesByNewestDay(a.file, b.file);
if (a.file) return -1;
if (b.file) return 1;
return a.filePath.localeCompare(b.filePath);
});
const valid = resolved.filter((entry) => Boolean(entry.file));
const skippedPaths = resolved.filter((entry) => !entry.file).map((entry) => entry.filePath);
const totalCap = Math.max(20, params.limit * 4);
const perFileCap = Math.max(6, Math.ceil(totalCap / Math.max(1, valid.length)));
let importedSignalCount = 0;
let importedFileCount = 0;
for (const entry of valid) {
if (importedSignalCount >= totalCap) break;
const raw = await fs.readFile(entry.filePath, "utf-8").catch((err) => {
if (extractErrorCode(err) === "ENOENT") {
skippedPaths.push(entry.filePath);
return "";
}
throw err;
});
if (!raw) continue;
const recordedProvenance = provenanceByPath.get(entry.relativePath);
const results = buildDailyIngestionResults({
raw,
path: entry.relativePath,
limit: Math.min(perFileCap, totalCap - importedSignalCount),
defaultObservedAt: params.nowMs,
...recordedProvenance ? { recorded: recordedProvenance } : {}
});
if (results.length === 0) continue;
await recordShortTermRecalls({
workspaceDir: params.workspaceDir,
query: `__dreaming_daily__:${entry.file.day}`,
results,
signalType: "daily",
dedupeByQueryPerDay: true,
dayBucket: formatMemoryDreamingDay(params.nowMs, params.timezone),
nowMs: params.nowMs,
timezone: params.timezone
});
importedSignalCount += results.length;
importedFileCount += 1;
}
return {
importedFileCount,
importedSignalCount,
skippedPaths
};
});
}
function entryAverageScore(entry) {
const signalCount = Math.max(0, Math.floor(entry.recallCount ?? 0) + Math.floor(entry.dailyCount ?? 0) + Math.floor(entry.groundedCount ?? 0));
return signalCount > 0 ? Math.max(0, Math.min(1, entry.totalScore / signalCount)) : 0;
}
function dedupeEntries(entries, threshold) {
const deduped = [];
for (const entry of entries) {
const duplicate = deduped.find((candidate) => candidate.path === entry.path && textSimilarity(candidate.snippet, entry.snippet) >= threshold);
if (duplicate) {
duplicate.sourceEntryKeys.push(entry.key);
if (entry.recallCount > duplicate.recallCount) duplicate.recallCount = entry.recallCount;
duplicate.totalScore = Math.max(duplicate.totalScore, entry.totalScore);
duplicate.maxScore = Math.max(duplicate.maxScore, entry.maxScore);
duplicate.queryHashes = uniqueStrings([...duplicate.queryHashes, ...entry.queryHashes]);
duplicate.recallDays = [.../* @__PURE__ */ new Set([...duplicate.recallDays, ...entry.recallDays])].toSorted();
duplicate.conceptTags = uniqueStrings([...duplicate.conceptTags, ...entry.conceptTags]);
duplicate.lastRecalledAt = compareStoreTimestampDesc(entry.lastRecalledAt, duplicate.lastRecalledAt) < 0 ? entry.lastRecalledAt : duplicate.lastRecalledAt;
continue;
}
deduped.push({
...entry,
sourceEntryKeys: [entry.key]
});
}
return deduped;
}
function normalizeDiaryCoverageText(text) {
return text.toLowerCase().replace(/\s+/g, " ").trim();
}
function isEntryCoveredByRecentDiary(entry, recentDiaryEntries) {
const snippet = normalizeDiaryCoverageText(entry.snippet);
if (!snippet) return false;
return recentDiaryEntries.some((diaryEntry) => {
return normalizeDiaryCoverageText(diaryEntry).includes(snippet) || textSimilarity(entry.snippet, diaryEntry) >= LIGHT_DIARY_SNIPPET_SIMILARITY_THRESHOLD;
});
}
function prioritizeLightEntriesByDiaryCoverage(entries, recentDiaryEntries) {
if (recentDiaryEntries.length === 0) return entries;
const fresh = [];
const covered = [];
for (const entry of entries) if (isEntryCoveredByRecentDiary(entry, recentDiaryEntries)) covered.push(entry);
else fresh.push(entry);
return [...fresh, ...covered];
}
function buildLightDreamingBody(entries) {
if (entries.length === 0) return ["- No notable updates."];
const lines = [];
for (const entry of entries) {
const snippet = entry.snippet || "(no snippet captured)";
lines.push(`- Candidate: ${snippet}`);
lines.push(` - confidence: ${entryAverageScore(entry).toFixed(2)}`);
lines.push(` - evidence: ${entry.path}:${entry.startLine}-${entry.endLine}`);
lines.push(` - recalls: ${entry.recallCount}`);
lines.push(` - status: staged`);
}
return lines;
}
function calculateCandidateTruthConfidence(entry) {
const recallStrength = Math.min(1, Math.log1p(entry.recallCount) / Math.log1p(6));
const averageScore = entryAverageScore(entry);
const consolidation = Math.min(1, (entry.recallDays?.length ?? 0) / 3);
const conceptual = Math.min(1, (entry.conceptTags?.length ?? 0) / 6);
return Math.max(0, Math.min(1, averageScore * .45 + recallStrength * .25 + consolidation * .2 + conceptual * .1));
}
function selectRemCandidateTruths(entries, limit) {
if (limit <= 0) return [];
return dedupeEntries(entries.filter((entry) => !entry.promotedAt), .88).map((entry) => ({
key: entry.key,
snippet: entry.snippet || "(no snippet captured)",
confidence: calculateCandidateTruthConfidence(entry),
evidence: `${entry.path}:${entry.startLine}-${entry.endLine}`
})).filter((entry) => entry.confidence >= .45).toSorted((a, b) => b.confidence - a.confidence || a.snippet.localeCompare(b.snippet)).slice(0, limit);
}
function buildRemReflections(entries, limit, minPatternStrength) {
const tagStats = /* @__PURE__ */ new Map();
for (const entry of entries) for (const tag of new Set(entry.conceptTags.map(normalizeConceptToken))) {
if (!tag) continue;
const stat = tagStats.get(tag) ?? {
count: 0,
evidence: /* @__PURE__ */ new Set()
};
stat.count += 1;
stat.evidence.add(`${entry.path}:${entry.startLine}-${entry.endLine}`);
tagStats.set(tag, stat);
}
const ranked = [...tagStats.entries()].map(([tag, stat]) => {
return {
tag,
strength: Math.min(1, stat.count / Math.max(1, entries.length) * 2),
stat
};
}).filter((entry) => entry.strength >= minPatternStrength).toSorted((a, b) => b.strength - a.strength || b.stat.count - a.stat.count || a.tag.localeCompare(b.tag)).slice(0, limit);
if (ranked.length === 0) return ["- No strong patterns surfaced."];
const lines = [];
for (const entry of ranked) {
lines.push(`- Theme: \`${entry.tag}\` kept surfacing across ${entry.stat.count} memories.`);
lines.push(` - confidence: ${entry.strength.toFixed(2)}`);
lines.push(` - evidence: ${[...entry.stat.evidence].slice(0, 3).join(", ")}`);
lines.push(` - note: reflection`);
}
return lines;
}
function previewRemDreaming(params) {
const reflections = buildRemReflections(params.entries, params.limit, params.minPatternStrength);
const candidateSelections = selectRemCandidateTruths(params.entries, Math.max(1, Math.min(3, params.limit)));
const candidateTruths = candidateSelections.map((entry) => ({
snippet: entry.snippet,
confidence: entry.confidence,
evidence: entry.evidence
}));
const candidateKeys = uniqueStrings(candidateSelections.map((entry) => entry.key));
const bodyLines = [
"### Reflections",
...reflections,
"",
"### Possible Lasting Truths",
...candidateTruths.length > 0 ? candidateTruths.map((entry) => `- ${entry.snippet} [confidence=${entry.confidence.toFixed(2)} evidence=${entry.evidence}]`) : ["- No strong candidate truths surfaced."]
];
return {
sourceEntryCount: params.entries.length,
reflections,
candidateTruths,
candidateKeys,
bodyLines
};
}
async function ingestDreamingPhaseSignals(params) {
const nowMs = typeof params.nowMs === "number" && Number.isFinite(params.nowMs) ? params.nowMs : Date.now();
await ingestDailyMemorySignals({
workspaceDir: params.workspaceDir,
lookbackDays: dailyIngestionLookbackDays(params.config.lookbackDays),
limit: params.config.limit,
nowMs,
timezone: params.config.timezone
});
await ingestSessionTranscriptSignals({
workspaceDir: params.workspaceDir,
cfg: params.cfg,
primaryWorkspaceDir: params.primaryWorkspaceDir,
lookbackDays: params.config.lookbackDays,
nowMs,
timezone: params.config.timezone,
admissionPolicy: params.admissionPolicy
});
return nowMs;
}
async function runLightDreaming(params) {
const nowMs = await ingestDreamingPhaseSignals(params);
const { capped, recentDiaryEntries } = await withMemoryWorkspaceLock(params.workspaceDir, async () => {
const rankedEntries = dedupeEntries((await filterLiveShortTermRecallEntries({
workspaceDir: params.workspaceDir,
entries: await filterFreshLightDreamingEntries({
workspaceDir: params.workspaceDir,
nowMs,
entries: filterRecallEntriesWithinLookback({
entries: await readShortTermRecallEntries({
workspaceDir: params.workspaceDir,
nowMs
}),
nowMs,
lookbackDays: params.config.lookbackDays
})
})
})).filter((entry) => !isPromotionOriginBlocked(entry)).toSorted((a, b) => {
const byTime = compareStoreTimestampDesc(a.lastRecalledAt, b.lastRecalledAt);
if (byTime !== 0) return byTime;
return b.recallCount - a.recallCount;
}), params.config.dedupeSimilarity);
const recentDiaryEntries = await readRecentDreamDiaryEntries({
workspaceDir: params.workspaceDir,
limit: LIGHT_DIARY_HISTORY_LIMIT
});
const entries = prioritizeLightEntriesByDiaryCoverage(rankedEntries, recentDiaryEntries);
const capped = entries.slice(0, params.config.limit);
const bodyLines = buildLightDreamingBody(capped);
await writeDailyDreamingPhaseBlock({
workspaceDir: params.workspaceDir,
phase: "light",
bodyLines,
nowMs,
timezone: params.config.timezone,
storage: params.config.storage
});
await recordDreamingPhaseSignals({
workspaceDir: params.workspaceDir,
phase: "light",
keys: capped.map((entry) => entry.key),
nowMs
});
if (params.config.enabled && entries.length > 0 && params.config.storage.mode !== "separate") params.logger.info(`memory-core: light dreaming staged ${Math.min(entries.length, params.config.limit)} candidate(s) [workspace=${params.workspaceDir}].`);
return {
capped,
recentDiaryEntries
};
});
if (params.subagent && capped.length > 0) {
const themes = uniqueStrings(capped.flatMap((e) => e.conceptTags).filter(Boolean));
const data = {
phase: "light",
snippets: capped.map((e) => e.snippet).filter(Boolean),
sourceEntryKeys: capped.flatMap((entry) => entry.sourceEntryKeys),
currentDate: formatMemoryDreamingDay(nowMs, params.config.timezone),
...themes.length > 0 ? { themes } : {},
...recentDiaryEntries.length > 0 ? { recentDiaryEntries } : {}
};
return await runDreamNarrative({
agentId: params.agentId,
subagent: params.subagent,
workspaceDir: params.workspaceDir,
data,
nowMs,
timezone: params.config.timezone,
model: params.config.execution?.model,
logger: params.logger,
detached: params.detachNarratives
});
}
return { status: "skipped" };
}
async function runRemDreaming(params) {
const nowMs = await ingestDreamingPhaseSignals(params);
const { entries, preview } = await withMemoryWorkspaceLock(params.workspaceDir, async () => {
const allEntries = (await filterLiveShortTermRecallEntries({
workspaceDir: params.workspaceDir,
entries: filterRecallEntriesWithinLookback({
entries: await readShortTermRecallEntries({
workspaceDir: params.workspaceDir,
nowMs
}),
nowMs,
lookbackDays: params.config.lookbackDays
})
})).filter((entry) => !isPromotionOriginBlocked(entry));
const lightKeys = await readLightStagedKeys({
workspaceDir: params.workspaceDir,
nowMs
});
const stagedEntries = lightKeys.size > 0 ? allEntries.filter((entry) => lightKeys.has(entry.key)) : [];
const entries = stagedEntries.length > 0 ? stagedEntries : allEntries;
const preview = previewRemDreaming({
entries,
limit: params.config.limit,
minPatternStrength: params.config.minPatternStrength
});
await writeDailyDreamingPhaseBlock({
workspaceDir: params.workspaceDir,
phase: "rem",
bodyLines: preview.bodyLines,
nowMs,
timezone: params.config.timezone,
storage: params.config.storage
});
if (stagedEntries.length > 0) await recordRemConsideredPhaseSignals({
workspaceDir: params.workspaceDir,
keys: stagedEntries.map((entry) => entry.key),
nowMs
});
await recordDreamingPhaseSignals({
workspaceDir: params.workspaceDir,
phase: "rem",
keys: preview.candidateKeys,
nowMs
});
if (params.config.enabled && entries.length > 0 && params.config.storage.mode !== "separate") params.logger.info(`memory-core: REM dreaming wrote reflections from ${entries.length} recent memory trace(s) [workspace=${params.workspaceDir}].`);
return {
entries,
preview
};
});
if (params.subagent && entries.length > 0) {
const snippets = preview.candidateTruths.map((t) => t.snippet).filter(Boolean);
const themes = preview.reflections.filter((r) => !r.startsWith("- No strong") && !r.startsWith(" -"));
const data = {
phase: "rem",
sourceEntryKeys: entries.map((entry) => entry.key),
snippets: snippets.length > 0 ? snippets : entries.slice(0, 8).map((e) => e.snippet).filter(Boolean),
...themes.length > 0 ? { themes } : {}
};
return await runDreamNarrative({
agentId: params.agentId,
subagent: params.subagent,
workspaceDir: params.workspaceDir,
data,
nowMs,
timezone: params.config.timezone,
model: params.config.execution?.model,
logger: params.logger,
detached: params.detachNarratives
});
}
return { status: "skipped" };
}
async function runDreamingSweepPhases(params) {
const sweepNowMs = typeof params.nowMs === "number" && Number.isFinite(params.nowMs) ? params.nowMs : Date.now();
const admissionPolicy = resolveAdmissionPolicy(params.pluginConfig);
let degradedPhases = 0;
let pendingNarratives = 0;
async function runPhase(phase, config, run) {
if (!config.enabled || config.limit <= 0) return;
try {
const outcome = await run({
...params,
config,
nowMs: sweepNowMs,
admissionPolicy
});
if (outcome.status === "degraded") degradedPhases += 1;
else if (outcome.status === "pending") pendingNarratives += 1;
} catch (err) {
await appendFailedDreamingEvent({
workspaceDir: params.workspaceDir,
phase,
error: formatErrorMessage(err),
storageMode: config.storage.mode,
nowMs: sweepNowMs,
logger: params.logger
});
throw err;
}
}
await runPhase("light", resolveMemoryLightDreamingConfig(params), runLightDreaming);
await runPhase("rem", resolveMemoryRemDreamingConfig(params), runRemDreaming);
return {
degradedPhases,
pendingNarratives
};
}
//#endregion
export { seedHistoricalDailyMemorySignals as i, previewRemDreaming as n, runDreamingSweepPhases as r, filterRecallEntriesWithinLookback as t };