UNPKG

openclaw

Version:

Multi-channel AI gateway with extensible messaging integrations

980 lines (979 loc) 39.8 kB
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 };