cogmem 3.6.5 → 3.7.1

package/dist/host/openclaw/AutoMemoryPluginInstaller.js

@@ -5,7 +5,7 @@ import { basename, dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { resolveCogmemConfigPath } from '../../config/CogmemConfig.js';
 const PLUGIN_ID = 'cogmem-auto-memory';
-const PLUGIN_VERSION = '0.6.3';
+const PLUGIN_VERSION = '0.7.1';
 function defaultPublicEntrypoint() {
     return join(resolve(dirname(fileURLToPath(import.meta.url)), '../..'), 'public.js');
 }
@@ -516,15 +516,29 @@ function createMemoryUsageReceipt(input) {
 
 function formatSourceAnchor(anchor) {
   return [
-    anchor.memoryId ? 'memory:' + anchor.memoryId : '',
-    anchor.eventId ? 'event:' + anchor.eventId : '',
-    anchor.sessionId ? 'session:' + anchor.sessionId : '',
-    anchor.role ? 'role:' + anchor.role : '',
+    anchor.memoryId ? 'memory:' + serializeUntrustedMemory(anchor.memoryId, 160) : '',
+    anchor.eventId ? 'event:' + serializeUntrustedMemory(anchor.eventId, 160) : '',
+    anchor.sessionId ? 'session:' + serializeUntrustedMemory(anchor.sessionId, 160) : '',
+    anchor.role ? 'role:' + serializeUntrustedMemory(anchor.role, 80) : '',
   ].filter(Boolean).join('; ');
 }
 
 function listLines(values) {
-  return values.length ? values.map((value) => '- ' + value) : ['- none'];
+  return values.length ? values.map((value) => '- ' + serializeUntrustedMemory(value, 260)) : ['- none'];
+}
+
+function serializeUntrustedMemory(input, limit) {
+  const clean = stripCogmemRecallBlocks(String(input || '')).text
+    .replace(new RegExp('</?COGMEM_[A-Z0-9_:-]+[^>]*>', 'gi'), '')
+    .replace(new RegExp('[\\\\u0000-\\\\u0008\\\\u000b\\\\u000c\\\\u000e-\\\\u001f\\\\u007f]', 'g'), ' ')
+    .replace(new RegExp('\\\\s+', 'g'), ' ')
+    .trim()
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
+  return clean.slice(0, Math.max(0, Number(limit || 500)));
 }
 
 function clampBlock(text, closingTag, maxChars) {
@@ -535,14 +549,14 @@ function clampBlock(text, closingTag, maxChars) {
 
 function formatMemoryUsageBridge(receipt, maxChars) {
   const lines = [
-    '<COGMEM_TURN_BRIDGE turn_id="' + String(receipt.turnId).replace(/"/g, '&quot;') + '" source="cogmem" compact="true" ttl_turns="' + receipt.ttlTurns + '" compile_allowed="false">',
+    '<COGMEM_TURN_BRIDGE turn_id="' + serializeUntrustedMemory(receipt.turnId, 180) + '" source="cogmem" compact="true" ttl_turns="' + receipt.ttlTurns + '" compile_allowed="false">',
     'Previous assistant answer used Cogmem memory.',
     '',
     'Used memory themes:',
     ...listLines(receipt.usedThemes || []),
     '',
     'Working conclusion produced in that turn:',
-    '- ' + (receipt.workingConclusion || 'No compact conclusion recorded.'),
+    '- ' + serializeUntrustedMemory(receipt.workingConclusion || 'No compact conclusion recorded.', 260),
     '',
     'Source anchors:',
     ...listLines((receipt.sourceAnchors || []).map(formatSourceAnchor)),
@@ -608,7 +622,7 @@ function formatSessionWorkingState(state, maxChars) {
   const lines = [
     '<COGMEM_SESSION_STATE scope="current_session" compact="true" persistence="session_only" compile_allowed="false">',
     'Current working topic:',
-    '- ' + (state.currentTopic || 'unspecified'),
+    '- ' + serializeUntrustedMemory(state.currentTopic || 'unspecified', 180),
     '',
     'Current design direction:',
     ...listLines(state.designDirection || []),
@@ -663,6 +677,9 @@ function classifyRecallIntent(query) {
   if (/原话|怎么说的|完整对话|上一句|下一句|exact quote|verbatim/.test(text)) {
     return 'forensic_quote';
   }
+  if (/(让你.{0,20}(对|给|把)?.{0,20}(做过|做了|启动|安装|配置|修改|重启|停止|操作|处理|执行)|对.{0,30}(做过什么|做了什么|哪些操作)|what did (i ask you to do|you do) to|operations? on)/i.test(text)) {
+    return 'action_history';
+  }
   if (/记得.{0,12}(聊过|讨论过|说过)|还记得|之前.{0,12}(聊过|讨论过|说过)|以前.{0,12}(聊过|讨论过|说过)|(过去|几个月前|半年前|上个月|前几天|昨天|上次|上个).{0,20}(聊过|讨论过|说过)|当时.{0,12}(聊|说|问)|那次.{0,12}(聊|说|问)|有没有.{0,12}(记录|聊过|讨论过)|have we discussed|did we talk about|previously discussed/.test(text)) {
     return 'historical_discussion';
   }
@@ -992,7 +1009,7 @@ function audit(config, record) {
 const plugin = {
   id: PLUGIN_ID,
   name: 'CogMem Auto Memory',
-  version: '0.6.3',
+  version: '${PLUGIN_VERSION}',
   register(api) {
     if (!api || typeof api.on !== 'function') {
       throw new Error('OpenClaw plugin API missing api.on');
@@ -1314,7 +1331,7 @@ async function recallPayload(input, config, kernel, memory, formatStrategyContex
   let result = await memory.recall({
     agentId: config.agentId || 'openclaw', projectId: config.projectId || 'openclaw',
     query: input.query || '', sessionId: input.sessionId, threadId: input.threadId,
-    excludeSessionId: input.excludeSessionId, intent: input.intent || 'memory_recall',
+    excludeSessionId: input.excludeSessionId, intent: input.intent || undefined,
     anchorEventId: input.anchorEventId, anchorText: input.anchorText,
     limit: Number(config.limit || 3), retrievalPolicy: strategyCapsule && strategyCapsule.retrievalPolicy,
   });
@@ -1327,7 +1344,7 @@ async function recallPayload(input, config, kernel, memory, formatStrategyContex
     result = await memory.recall({
       agentId: config.agentId || 'openclaw', projectId: config.projectId || 'openclaw',
       query: input.query || '', sessionId: input.sessionId, threadId: input.threadId,
-      excludeSessionId: input.excludeSessionId, intent: input.intent || 'memory_recall',
+      excludeSessionId: input.excludeSessionId, intent: input.intent || undefined,
       anchorEventId: input.anchorEventId, anchorText: input.anchorText,
       limit: Number(config.limit || 3), retrievalPolicy: strategyCapsule && strategyCapsule.retrievalPolicy,
     });
@@ -1338,18 +1355,42 @@ async function recallPayload(input, config, kernel, memory, formatStrategyContex
     maxMemoryRatio: Number(config.contextMemoryMaxRatio || 0.25), strategy: strategyCapsule,
     candidates: result.items.map(contextCandidateFromRecallItem),
   });
-  const plannedResult = activationPlan
+  let plannedResult = activationPlan
     ? { ...result, items: activationPlan.selected.map((candidate) => candidate.recallItem) }
     : result;
+  let activationReceipt = activationPlan && activationPlan.receipt;
+  if (activationPlan && Array.isArray(result.items)) {
+    const selectedIds = new Set(plannedResult.items.map((item) => item && item.id).filter(Boolean));
+    const strictFacetItem = (result.decisionTrace && result.decisionTrace.selectedLane === 'facet_graph_raw_ledger')
+      ? result.items.find((item) => item && item.canonicalId && Array.isArray(item.matchedFacets) && item.matchedFacets.length > 0)
+      : undefined;
+    if (strictFacetItem && !selectedIds.has(strictFacetItem.id)) {
+      plannedResult = { ...plannedResult, items: [strictFacetItem, ...plannedResult.items].slice(0, Number(config.limit || 3)) };
+      activationReceipt = {
+        ...(activationReceipt || {}),
+        facetGraphRetained: true,
+        retainedCanonicalId: strictFacetItem.canonicalId,
+        matchedFacets: strictFacetItem.matchedFacets,
+        reason: 'strict_facet_match_must_not_be_silently_dropped',
+      };
+    }
+  }
   const anchorItem = plannedResult.items.find((item) => item && item.sourceAnchor && item.sourceAnchor.eventId);
+  const selectedCanonicalIds = new Set(plannedResult.items.map((item) => item && item.canonicalId).filter(Boolean));
+  const selectedEpisodeCards = Array.isArray(result.atlasCards)
+    ? result.atlasCards.filter((card) => card && selectedCanonicalIds.has(card.canonicalId))
+    : [];
+  plannedResult = { ...plannedResult, atlasCards: selectedEpisodeCards };
   const recallContext = formatRecallContext(plannedResult, config);
   return {
     context: recallContext ? (strategyCapsule ? formatStrategyContext(strategyCapsule) + '\n\n' : '') + recallContext : '',
     items: compactRecallItems(plannedResult.items, config), itemCount: plannedResult.items.length,
-    recallMode: result.recallMode, fallbackUsed: result.fallbackUsed, intent: input.intent || 'memory_recall',
+    recallMode: result.recallMode, fallbackUsed: result.fallbackUsed, intent: (result.queryPlan && result.queryPlan.intent) || input.intent || 'memory_recall',
     anchorEventId: anchorItem && anchorItem.sourceAnchor && anchorItem.sourceAnchor.eventId,
     anchorText: anchorItem && anchorItem.text, queryPlan: result.queryPlan, decisionTrace: result.decisionTrace,
-    activationReceipt: activationPlan && activationPlan.receipt, strategyCapsule,
+    atlasCards: result.atlasCards, selectedEpisodeCards,
+    relatedButNotSelected: result.relatedButNotSelected, relaxationTrace: result.relaxationTrace,
+    activationReceipt, strategyCapsule,
     strategyReplanned: replan.replanned, strategyReplanReason: replan.reason,
     recallLatencyMs: Date.now() - recallStartedAt,
   };
@@ -1394,16 +1435,27 @@ function stripCogmemRecallBlocks(text) {
 
 function formatAtlasContext(result, maxChars) {
   const nodes = Array.isArray(result && result.nodes) ? result.nodes : [];
-  if (!nodes.length) return '';
+  const cards = Array.isArray(result && result.cards) ? result.cards : [];
+  if (!nodes.length && !cards.length) return '';
   const edges = Array.isArray(result && result.edges) ? result.edges : [];
   const actions = Array.isArray(result && result.nextActions) ? result.nextActions : [];
   const nodeDetails = Array.isArray(result && result.nodeDetails) ? result.nodeDetails : [];
   const lines = [
-    '<COGMEM_MEMORY_ATLAS version="memory_atlas.v1" volatile="true" persistence="forbidden" evidence_authority="raw_event_ids_only">',
+    '<COGMEM_MEMORY_ATLAS version="memory_atlas.v2" volatile="true" persistence="forbidden" evidence_authority="raw_event_ids_only">',
     'Bounded navigation map; use it to choose nodes and paths, not as durable evidence.',
-    'Matched facets: ' + safeAtlasText(JSON.stringify(result.facets || {}), 1000),
+    'Matched facets: ' + safeAtlasText(JSON.stringify(result.facets && result.facets.planner || result.facets || {}), 1400),
     'Cold memory resurrected: ' + String(result.coldMemoryResurrected === true),
     '',
+    'Selected memory cards:',
+    ...cards.slice(0, 8).map((card) => '- ' + formatAtlasCard(card)),
+    ...(cards.length ? [
+      '',
+      'Related but not selected:',
+      ...cards.flatMap((card) => Array.isArray(card.relatedButNotSelected) ? card.relatedButNotSelected : [])
+        .slice(0, 8)
+        .map((card) => '- ' + safeAtlasText(card.displayTitle, 160) + ' [' + safeAtlasText(card.reason, 160) + ']'),
+      '',
+    ] : []),
     'Nodes:',
     ...nodes.slice(0, 30).map((node) => '- ' + JSON.stringify({
       id: safeAtlasText(node.id, 500), type: safeAtlasText(node.nodeType, 80),
@@ -1435,10 +1487,20 @@ function formatAtlasContext(result, maxChars) {
 }
 
 function safeAtlasText(input, limit) {
+  return serializeUntrustedMemory(input, limit);
+}
+
+function serializeUntrustedMemory(input, limit) {
   const clean = stripCogmemRecallBlocks(String(input || '')).text
-    .replace(/[<>]/g, (value) => value === '<' ? '\\u003c' : '\\u003e')
+    .replace(/<\/?COGMEM_[A-Z0-9_:-]+[^>]*>/gi, '')
+    .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, ' ')
     .replace(/\s+/g, ' ')
-    .trim();
+    .trim()
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
   return clean.slice(0, Math.max(0, Number(limit || 500)));
 }
 
@@ -1695,6 +1757,9 @@ function compactRecallItems(items, config) {
     projectId: item.projectId,
     sourceAnchor: item.sourceAnchor,
     whyMatched: item.whyMatched,
+    canonicalId: item.canonicalId,
+    displayTitle: item.displayTitle,
+    matchedFacets: item.matchedFacets,
   }));
 }
 
@@ -1731,34 +1796,47 @@ function formatRecallContext(result, config) {
   if (result.decisionTrace) {
     lines.push('recallDecision=' + formatRecallDecision(result.decisionTrace));
   }
+  if (Array.isArray(result.atlasCards) && result.atlasCards.length) {
+    lines.push('selectedMemoryCards=' + result.atlasCards.slice(0, Number(config.memoryContextMaxItems || config.limit || 3)).map(formatAtlasCard).join(' | '));
+  }
+  if (Array.isArray(result.relaxationTrace) && result.relaxationTrace.length) {
+    lines.push('relaxationTrace=' + result.relaxationTrace.map((step) => serializeUntrustedMemory(step.from, 80) + ' -> ' + serializeUntrustedMemory(step.to, 80) + ' (' + serializeUntrustedMemory(step.reason, 160) + ')').join(' | '));
+  }
+  if (Array.isArray(result.relatedButNotSelected) && result.relatedButNotSelected.length) {
+    lines.push('relatedButNotSelected=' + result.relatedButNotSelected.slice(0, 4).map((item) => serializeUntrustedMemory(item.displayTitle, 160) + ' [' + serializeUntrustedMemory(item.reason, 160) + ']').join(' | '));
+  }
   lines.push('');
   if (result.narrative && result.narrative.summary) {
-    lines.push(result.narrative.summary);
+    lines.push(serializeUntrustedMemory(result.narrative.summary, 800));
   }
   const maxItems = Number(config.memoryContextMaxItems || config.limit || 3);
   const sourceWindowMaxChars = Number(config.sourceWindowMaxChars || 1200);
   const includeSourceWindow = config.includeSourceWindowByDefault === true;
   for (const item of result.items.slice(0, maxItems)) {
-    const source = item.source ? ' [' + item.source + ']' : '';
-    lines.push('- ' + item.text + source);
+    const source = item.source ? ' [' + serializeUntrustedMemory(item.source, 220) + ']' : '';
+    lines.push('- ' + serializeUntrustedMemory(item.text, 500) + source);
     const sourceType = item.sourceType || 'compiled_memory';
     const quote = item.canAnswerExactQuote === true ? 'true' : 'false';
     const confidence = Number.isFinite(item.confidence) ? String(item.confidence) : 'unknown';
-    const anchor = item.sourceAnchor ? '; anchorEvent=' + (item.sourceAnchor.eventId || 'unknown')
-      + (item.sourceAnchor.sessionId ? '; session=' + item.sourceAnchor.sessionId : '')
-      + (item.sourceAnchor.role ? '; role=' + item.sourceAnchor.role : '') : '';
-    const why = item.whyMatched ? '; whyMatched=' + item.whyMatched : '';
-    lines.push('  sourceType=' + sourceType + '; confidence=' + confidence + '; canAnswerExactQuote=' + quote + anchor + why);
+    const anchor = item.sourceAnchor ? '; anchorEvent=' + serializeUntrustedMemory(item.sourceAnchor.eventId || 'unknown', 160)
+      + (item.sourceAnchor.sessionId ? '; session=' + serializeUntrustedMemory(item.sourceAnchor.sessionId, 160) : '')
+      + (item.sourceAnchor.role ? '; role=' + serializeUntrustedMemory(item.sourceAnchor.role, 80) : '') : '';
+    const why = item.whyMatched ? '; whyMatched=' + serializeUntrustedMemory(item.whyMatched, 180) : '';
+    const canonical = item.canonicalId ? '; canonicalId=' + serializeUntrustedMemory(item.canonicalId, 180) : '';
+    const matchedFacets = Array.isArray(item.matchedFacets) && item.matchedFacets.length
+      ? '; matchedFacets=' + item.matchedFacets.map((facet) => serializeUntrustedMemory(facet.type, 80) + ':' + serializeUntrustedMemory(facet.value, 160)).join(',')
+      : '';
+    lines.push('  sourceType=' + serializeUntrustedMemory(sourceType, 120) + '; confidence=' + confidence + '; canAnswerExactQuote=' + quote + canonical + matchedFacets + anchor + why);
     if (item.sourceContext && item.sourceContext.event) {
       const anchorEvent = item.sourceContext.event;
       const anchorFormatted = formatContextEvent(anchorEvent, Math.min(220, sourceWindowMaxChars));
       lines.push('  sourceContext=' + anchorFormatted.line);
       lines.push('  sourceWindow=' + formatSourceWindow(item.sourceContext.window, item.sourceContext));
       if (item.sourceContext.locator && item.sourceContext.locator.command) {
-        lines.push('  sourceLocator=' + item.sourceContext.locator.command);
+        lines.push('  sourceLocator=' + serializeUntrustedMemory(item.sourceContext.locator.command, 500));
       } else if (item.sourceContext.event.eventId) {
         const project = item.sourceContext.event.projectId ? ' --project ' + item.sourceContext.event.projectId : '';
-        lines.push('  sourceLocator=cogmem memory show --event ' + item.sourceContext.event.eventId + project + ' --before 2 --after 2 --json');
+        lines.push('  sourceLocator=' + serializeUntrustedMemory('cogmem memory show --event ' + item.sourceContext.event.eventId + project + ' --before 2 --after 2 --json', 500));
       }
       const seenEventIds = new Set([anchorEvent.eventId].filter(Boolean));
       const before = uniqueWindowEvents(Array.isArray(item.sourceContext.before) ? item.sourceContext.before : [], seenEventIds).slice(-2);
@@ -1801,6 +1879,24 @@ function formatRecallDecision(trace) {
     + ',raw:' + Number(counts.rawLedger || 0);
 }
 
+function formatAtlasCard(card) {
+  const facets = Array.isArray(card && card.matchedFacets)
+    ? card.matchedFacets.map((facet) => serializeUntrustedMemory(facet.type, 80) + ':' + serializeUntrustedMemory(facet.value, 160)).join(',')
+    : '';
+  const paths = Array.isArray(card && card.matchedPaths)
+    ? card.matchedPaths.map((path) => serializeUntrustedMemory(path.relation, 80) + '@' + serializeUntrustedMemory(path.facet && path.facet.nodeId || 'facet', 180)).slice(0, 6).join(',')
+    : '';
+  const locator = card && card.sourceLocator && card.sourceLocator.command ? '; sourceLocator=' + serializeUntrustedMemory(card.sourceLocator.command, 500) : '';
+  const why = card && card.whyMatched ? '; whyMatched=' + serializeUntrustedMemory(card.whyMatched, 180) : '';
+  return serializeUntrustedMemory(card && card.canonicalId || 'episode:unknown', 180)
+    + '; title=' + serializeUntrustedMemory(card && card.displayTitle, 120)
+    + '; summary=' + serializeUntrustedMemory(card && card.oneLineSummary, 180)
+    + (facets ? '; matchedFacets=' + facets : '')
+    + (paths ? '; matchedPaths=' + paths : '')
+    + why
+    + locator;
+}
+
 function clampRecallContext(text, maxChars) {
   const closingTag = '</COGMEM_RECALL_CONTEXT>';
   if (text.length <= maxChars) return text;
@@ -1809,10 +1905,10 @@ function clampRecallContext(text, maxChars) {
 }
 
 function formatContextEvent(event, limit) {
-  const truncation = truncateLineWithMeta(event && event.text, limit);
-  const label = contextEventLabel(event);
-  const role = event && event.role ? event.role : 'unknown';
-  const eventId = event && event.eventId ? event.eventId : 'unknown';
+  const truncation = truncateLineWithMeta(serializeUntrustedMemory(event && event.text, limit), limit);
+  const label = serializeUntrustedMemory(contextEventLabel(event), 120);
+  const role = serializeUntrustedMemory(event && event.role ? event.role : 'unknown', 80);
+  const eventId = serializeUntrustedMemory(event && event.eventId ? event.eventId : 'unknown', 160);
   const charRange = event && event.charRange ? '; charRange=' + event.charRange.start + '-' + event.charRange.end : '';
   const sourceRange = formatSourceRange(event && event.sourceRange);
   const textLength = Number.isFinite(event && event.textLength) ? event.textLength : truncation.originalChars;
@@ -1834,17 +1930,17 @@ function formatSourceWindow(window, context) {
   const dropped = Array.isArray(window && window.droppedOverlapEventIds) ? window.droppedOverlapEventIds : [];
   return 'before=' + formatWindowSide(before)
     + '; after=' + formatWindowSide(after)
-    + '; overlap=' + (overlapEventIds.length ? overlapEventIds.join(',') : 'none')
-    + '; droppedOverlap=' + (dropped.length ? dropped.join(',') : 'none')
-    + '; overlapHandling=' + ((window && window.overlapHandling) || 'drop_from_after');
+    + '; overlap=' + (overlapEventIds.length ? overlapEventIds.map((id) => serializeUntrustedMemory(id, 120)).join(',') : 'none')
+    + '; droppedOverlap=' + (dropped.length ? dropped.map((id) => serializeUntrustedMemory(id, 120)).join(',') : 'none')
+    + '; overlapHandling=' + serializeUntrustedMemory((window && window.overlapHandling) || 'drop_from_after', 120);
 }
 
 function formatWindowSide(side) {
   return 'requestedCount=' + Number(side.requestedCount || 0)
     + ', count=' + Number(side.count || 0)
     + ', excludesAnchor=' + (side.excludesAnchor !== false)
-    + ', ordering=' + (side.ordering || 'chronological')
-    + ', roleFilter=' + (side.roleFilter || 'all');
+    + ', ordering=' + serializeUntrustedMemory(side.ordering || 'chronological', 80)
+    + ', roleFilter=' + serializeUntrustedMemory(side.roleFilter || 'all', 80);
 }
 
 function uniqueWindowEvents(events, seenEventIds) {

package/dist/mcp/server.js

@@ -5,7 +5,7 @@ import { callCogmemMcpTool, listCogmemMcpTools, } from './CoreMcpTools.js';
 export function createCogmemMcpServer(runtime = {}) {
     const server = new Server({
         name: 'cogmem-core',
-        version: '3.6.5',
+        version: '3.7.1',
     }, {
         capabilities: {
             tools: {},

package/dist/recall/RecallExplanation.d.ts

@@ -44,7 +44,7 @@ export interface RecallExplanation {
     projectId?: string;
     agentId?: string;
     collection?: string;
-    recallMode: MemoryKernelNavigationResult['recallMode'] | 'raw_ledger_fallback';
+    recallMode: MemoryKernelNavigationResult['recallMode'] | 'raw_ledger_fallback' | 'atlas_facet_recall' | 'atlas_raw_grounded_recall';
     fallbackUsed: boolean;
     narrative?: NonNullable<MemoryKernelNavigationResult['navigation']>['narrative'];
     pulseTrace?: NonNullable<MemoryKernelNavigationResult['navigation']>['pulse']['trace'];

package/dist/store/MemoryAtlasStore.d.ts

@@ -1,5 +1,8 @@
 import type Database from 'bun:sqlite';
-import type { MemoryAtlasAction, MemoryAtlasEdge, MemoryAtlasNode } from '../atlas/MemoryAtlasTypes.js';
+import type { FacetQueryPlan } from '../atlas/FacetQueryPlanner.js';
+import type { MemoryAtlasAction, MemoryAtlasCard, MemoryAtlasEdge, MemoryAtlasNode, MemoryAtlasRelatedCard } from '../atlas/MemoryAtlasTypes.js';
+export declare const MEMORY_ATLAS_PROJECTION_NAME = "memory_atlas.v2";
+export declare const MEMORY_ATLAS_PROJECTION_SCHEMA_VERSION = "3.7.2";
 export declare class MemoryAtlasStore {
     readonly db: Database;
     constructor(db: Database);
@@ -18,6 +21,9 @@ export declare class MemoryAtlasStore {
         keywords?: string[];
         targetNodeIds?: string[];
     }): MemoryAtlasNode[];
+    searchCanonicalEpisodeCards(projectId: string, plan: FacetQueryPlan, limit: number): MemoryAtlasCard[];
+    relatedEpisodeCards(projectId: string, canonicalId: string, selectedIds: Set<string>, limit: number): MemoryAtlasRelatedCard[];
+    private topicRelatedCardsForPlan;
     resolveTargetNodeIds(projectId: string, query: string): {
         nodeIds: string[];
         entitySourceIds: string[];
@@ -46,6 +52,8 @@ export declare class MemoryAtlasStore {
     decay(projectId?: string, factor?: number, now?: number): number;
     projectionNeedsRefresh(projectId: string): boolean;
     markProjectionClean(projectId: string, metadata?: Record<string, unknown>, now?: number): void;
+    markProjectionDirty(projectId: string, metadata?: Record<string, unknown>, now?: number): void;
+    aggregateFacetNodeSupport(projectId: string, now?: number): void;
     markProjectionFailed(projectId: string, error: string, now?: number): void;
     getProjectionState(projectId: string): {
         status: string;
@@ -56,5 +64,8 @@ export declare class MemoryAtlasStore {
     countDocuments(projectId?: string): number;
     private refreshFtsNode;
     private topicRelationEdges;
+    private episodeEdgesForFacet;
+    private episodeRows;
+    private cardFromEpisodeRow;
 }
 //# sourceMappingURL=MemoryAtlasStore.d.ts.map