@remnic/core 9.6.30 → 9.6.31

package/dist/{chunk-KCYE2MZM.js → chunk-UXPUUL3G.js}

@@ -1,11 +1,15 @@
 // src/lcm/recall.ts
 function assembleCompressedHistory(dag, archive, sessionId, config) {
+  return assembleCompressedHistoryWithTrace(dag, archive, sessionId, config).text;
+}
+function assembleCompressedHistoryWithTrace(dag, archive, sessionId, config) {
   const maxTurn = archive.getMaxTurnIndex(sessionId);
-  if (maxTurn < 0) return "";
+  if (maxTurn < 0) return { text: "", selectedSummaries: [] };
   const allNodes = dag.getAllNodes(sessionId);
-  if (allNodes.length === 0) return "";
+  if (allNodes.length === 0) return { text: "", selectedSummaries: [] };
   const freshTailStart = Math.max(0, maxTurn - config.freshTailTurns + 1);
   const sections = [];
+  const selectedNodes = [];
   let usedChars = 0;
   if (freshTailStart > 0) {
     const oldNodes = selectBestCoverage(allNodes, 0, freshTailStart - 1);
@@ -15,6 +19,7 @@ function assembleCompressedHistory(dag, archive, sessionId, config) {
 ${node.summary_text}`;
       if (usedChars + entry.length > config.budgetChars) break;
       sections.push(entry);
+      selectedNodes.push(node);
       usedChars += entry.length;
     }
   }
@@ -27,12 +32,27 @@ ${node.summary_text}`;
 ${node.summary_text}`;
     if (usedChars + entry.length > config.budgetChars) break;
     sections.push(entry);
+    selectedNodes.push(node);
     usedChars += entry.length;
   }
-  if (sections.length === 0) return "";
-  return `## Session History (Compressed)
-
-${sections.join("\n\n")}`;
+  if (sections.length === 0) return { text: "", selectedSummaries: [] };
+  const prefix = "## Session History (Compressed)\n\n";
+  const text = `${prefix}${sections.join("\n\n")}`;
+  let entryStart = prefix.length;
+  const selectedSummaries = selectedNodes.map((node, index) => {
+    const entryEnd = entryStart + sections[index].length;
+    const receipt = {
+      id: node.id,
+      depth: node.depth,
+      msgStart: node.msg_start,
+      msgEnd: node.msg_end,
+      entryStart,
+      entryEnd
+    };
+    entryStart = entryEnd + 2;
+    return receipt;
+  });
+  return { text, selectedSummaries };
 }
 function selectBestCoverage(allNodes, fromTurn, toTurn) {
   const candidates = allNodes.filter(
@@ -64,6 +84,7 @@ function formatRangeLabel(node, maxTurn) {
 }
 
 export {
-  assembleCompressedHistory
+  assembleCompressedHistory,
+  assembleCompressedHistoryWithTrace
 };
-//# sourceMappingURL=chunk-KCYE2MZM.js.map
+//# sourceMappingURL=chunk-UXPUUL3G.js.map

package/dist/chunk-UXPUUL3G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lcm/recall.ts"],"sourcesContent":["import type { LcmDag, SummaryNode } from \"./dag.js\";\nimport type { LcmArchive } from \"./archive.js\";\nimport { log } from \"../logger.js\";\n\nexport interface LcmRecallConfig {\n  freshTailTurns: number;\n  budgetChars: number;\n}\n\nexport interface LcmSummarySelectionReceipt {\n  id: string;\n  depth: number;\n  msgStart: number;\n  msgEnd: number;\n  /** Half-open offsets within the returned compressed-history string. */\n  entryStart: number;\n  entryEnd: number;\n}\n\nexport interface LcmRecallWithTraceResult {\n  text: string;\n  selectedSummaries: LcmSummarySelectionReceipt[];\n}\n\n/**\n * Assemble a compressed session history section from the summary DAG.\n *\n * Strategy:\n * 1. For the \"fresh tail\" (most recent N turns), use leaf-level summaries for maximum detail.\n * 2. For older portions, use the deepest available summary nodes (most compressed).\n * 3. Fill within budget, prioritizing recent content.\n */\nexport function assembleCompressedHistory(\n  dag: LcmDag,\n  archive: LcmArchive,\n  sessionId: string,\n  config: LcmRecallConfig,\n): string {\n  return assembleCompressedHistoryWithTrace(dag, archive, sessionId, config).text;\n}\n\nexport function assembleCompressedHistoryWithTrace(\n  dag: LcmDag,\n  archive: LcmArchive,\n  sessionId: string,\n  config: LcmRecallConfig,\n): LcmRecallWithTraceResult {\n  const maxTurn = archive.getMaxTurnIndex(sessionId);\n  if (maxTurn < 0) return { text: \"\", selectedSummaries: [] };\n\n  const allNodes = dag.getAllNodes(sessionId);\n  if (allNodes.length === 0) return { text: \"\", selectedSummaries: [] };\n\n  const freshTailStart = Math.max(0, maxTurn - config.freshTailTurns + 1);\n  const sections: string[] = [];\n  const selectedNodes: SummaryNode[] = [];\n  let usedChars = 0;\n\n  // Collect nodes covering the \"old\" portion (before fresh tail)\n  if (freshTailStart > 0) {\n    const oldNodes = selectBestCoverage(allNodes, 0, freshTailStart - 1);\n    for (const node of oldNodes) {\n      const label = formatRangeLabel(node, maxTurn);\n      const entry = `**${label}** (depth ${node.depth}):\\n${node.summary_text}`;\n      if (usedChars + entry.length > config.budgetChars) break;\n      sections.push(entry);\n      selectedNodes.push(node);\n      usedChars += entry.length;\n    }\n  }\n\n  // Collect leaf nodes that overlap with the fresh tail region.\n  // The old section uses deep nodes (depth > 0), so leaf nodes included here\n  // won't duplicate old-section content. Use msg_end >= freshTailStart to\n  // include straddling leaf nodes that partially cover the fresh region.\n  const freshNodes = allNodes\n    .filter(\n      (n) => n.depth === 0 && n.msg_end >= freshTailStart && n.msg_end <= maxTurn,\n    )\n    .sort((a, b) => a.msg_start - b.msg_start);\n\n  for (const node of freshNodes) {\n    const label = `Recent (turns ${node.msg_start}-${node.msg_end})`;\n    const entry = `**${label}**:\\n${node.summary_text}`;\n    if (usedChars + entry.length > config.budgetChars) break;\n    sections.push(entry);\n    selectedNodes.push(node);\n    usedChars += entry.length;\n  }\n\n  if (sections.length === 0) return { text: \"\", selectedSummaries: [] };\n\n  const prefix = \"## Session History (Compressed)\\n\\n\";\n  const text = `${prefix}${sections.join(\"\\n\\n\")}`;\n  let entryStart = prefix.length;\n  const selectedSummaries = selectedNodes.map((node, index) => {\n    const entryEnd = entryStart + sections[index]!.length;\n    const receipt: LcmSummarySelectionReceipt = {\n      id: node.id,\n      depth: node.depth,\n      msgStart: node.msg_start,\n      msgEnd: node.msg_end,\n      entryStart,\n      entryEnd,\n    };\n    entryStart = entryEnd + 2;\n    return receipt;\n  });\n  return { text, selectedSummaries };\n}\n\n/**\n * Select the best coverage for a turn range.\n * Prefers deeper (more compressed) nodes. Avoids overlapping coverage.\n */\nfunction selectBestCoverage(\n  allNodes: SummaryNode[],\n  fromTurn: number,\n  toTurn: number,\n): SummaryNode[] {\n  // Filter to nodes fully contained in the requested range. Straddling nodes\n  // would duplicate protected fresh-tail turns while still emitting their full\n  // summary text and range label.\n  const candidates = allNodes.filter(\n    (n) => n.msg_start >= fromTurn && n.msg_end <= toTurn,\n  );\n\n  if (candidates.length === 0) return [];\n\n  // Sort by msg_start ascending, then depth descending (prefer deeper at same position)\n  candidates.sort((a, b) => {\n    if (a.msg_start !== b.msg_start) return a.msg_start - b.msg_start;\n    return b.depth - a.depth;\n  });\n\n  // Greedily select non-overlapping nodes, preferring deeper coverage.\n  const selected: SummaryNode[] = [];\n  let coveredUpTo = fromTurn - 1;\n\n  for (const node of candidates) {\n    if (node.msg_start > coveredUpTo) {\n      selected.push(node);\n      coveredUpTo = node.msg_end;\n      if (coveredUpTo >= toTurn) break;\n    }\n  }\n\n  // Re-sort selected by msg_start for chronological output\n  selected.sort((a, b) => a.msg_start - b.msg_start);\n  return selected;\n}\n\nfunction formatRangeLabel(node: SummaryNode, maxTurn: number): string {\n  const startPct = Math.round((node.msg_start / Math.max(1, maxTurn)) * 100);\n  const endPct = Math.round((node.msg_end / Math.max(1, maxTurn)) * 100);\n\n  if (startPct < 33) return `Early session (turns ${node.msg_start}-${node.msg_end})`;\n  if (endPct < 66) return `Mid session (turns ${node.msg_start}-${node.msg_end})`;\n  return `Later session (turns ${node.msg_start}-${node.msg_end})`;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-3VSTTB74.js → chunk-WSOEYOHN.js}

@@ -19,7 +19,7 @@ import {
 } from "./chunk-7HYPN2GC.js";
 import {
   LcmEngine
-} from "./chunk-5AJIDEFT.js";
+} from "./chunk-XFTPUXCE.js";
 import {
   cleanupConversationChunks
 } from "./chunk-RP7YXA67.js";
@@ -61,7 +61,7 @@ import {
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
-} from "./chunk-IRMLYBMU.js";
+} from "./chunk-T67LUYCR.js";
 import {
   buildTemporalTimelineRecallSection
 } from "./chunk-I6WYQSX4.js";
@@ -87,7 +87,7 @@ import {
 import {
   buildResponseGuidanceRecallSection,
   shouldRecallResponseGuidance
-} from "./chunk-XGSOXFD4.js";
+} from "./chunk-6TCXIRP5.js";
 import {
   mergeWithAgentResults,
   runDirectAgent,
@@ -177,18 +177,18 @@ import {
 import {
   buildFocusedListRecallSection,
   shouldRecallFocusedListEvidence
-} from "./chunk-BFU7H32D.js";
+} from "./chunk-OH7QLI6W.js";
 import {
   buildEventOrderRecallSection,
   shouldRecallEventOrderEvidence
-} from "./chunk-7O2JL5RY.js";
+} from "./chunk-DEOYTFA6.js";
 import {
   pickFactEventTimeAnchor,
   resolveFactEventTime
 } from "./chunk-IAIPNEHD.js";
 import {
   buildExplicitCueRecallSection
-} from "./chunk-77UPM7P3.js";
+} from "./chunk-TVIVY7KU.js";
 import {
   formatDaySummaryMemories
 } from "./chunk-I73G4UH7.js";
@@ -23092,4 +23092,4 @@ export {
   blendGraphExpandedRecallScore,
   Orchestrator
 };
-//# sourceMappingURL=chunk-3VSTTB74.js.map
+//# sourceMappingURL=chunk-WSOEYOHN.js.map

package/dist/{chunk-5AJIDEFT.js → chunk-XFTPUXCE.js}

@@ -2,8 +2,8 @@ import {
   LcmWorkQueue
 } from "./chunk-TPDBFYEG.js";
 import {
-  assembleCompressedHistory
-} from "./chunk-KCYE2MZM.js";
+  assembleCompressedHistoryWithTrace
+} from "./chunk-UXPUUL3G.js";
 import {
   ensureLcmStateDir,
   openLcmDatabase
@@ -269,15 +269,19 @@ var LcmEngine = class {
   }
   /** Build the compressed history recall section for a session. */
   async assembleRecall(sessionId, budgetChars) {
-    if (!this.config.enabled) return "";
+    return (await this.assembleRecallWithTrace(sessionId, budgetChars)).text;
+  }
+  /** Build compressed recall plus content-free selected-summary receipts. */
+  async assembleRecallWithTrace(sessionId, budgetChars) {
+    if (!this.config.enabled) return { text: "", selectedSummaries: [] };
     const normalizedSessionId = normalizeLcmSessionId(sessionId);
-    if (!normalizedSessionId) return "";
+    if (!normalizedSessionId) return { text: "", selectedSummaries: [] };
     await this.ensureInitialized();
     const effectiveBudget = Math.ceil(
       budgetChars * this.config.recallBudgetShare
     );
-    if (effectiveBudget <= 0) return "";
-    return assembleCompressedHistory(this.dag, this.archive, normalizedSessionId, {
+    if (effectiveBudget <= 0) return { text: "", selectedSummaries: [] };
+    return assembleCompressedHistoryWithTrace(this.dag, this.archive, normalizedSessionId, {
       freshTailTurns: this.config.freshTailTurns,
       budgetChars: effectiveBudget
     });
@@ -522,4 +526,4 @@ export {
   extractLcmConfig,
   LcmEngine
 };
-//# sourceMappingURL=chunk-5AJIDEFT.js.map
+//# sourceMappingURL=chunk-XFTPUXCE.js.map

package/dist/chunk-XFTPUXCE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lcm/engine.ts"],"sourcesContent":["import type Database from \"better-sqlite3\";\nimport { openLcmDatabase, ensureLcmStateDir } from \"./schema.js\";\nimport { LcmArchive, type LcmStructuredRecallMatch } from \"./archive.js\";\nimport { LcmDag } from \"./dag.js\";\nimport { LcmSummarizer, type SummarizeFn } from \"./summarizer.js\";\nimport {\n  assembleCompressedHistoryWithTrace,\n  type LcmRecallConfig,\n  type LcmRecallWithTraceResult,\n} from \"./recall.js\";\nimport { LcmWorkQueue, type LcmObserveMessage } from \"./queue.js\";\nimport type { PluginConfig } from \"../types.js\";\nimport { log } from \"../logger.js\";\n\nexport interface LcmEngineConfig {\n  enabled: boolean;\n  leafBatchSize: number;\n  rollupFanIn: number;\n  freshTailTurns: number;\n  maxDepth: number;\n  deterministicMaxTokens: number;\n  archiveRetentionDays: number;\n  recallBudgetShare: number;\n  observeConcurrency: number;\n  telemetryPrefilterEnabled: boolean;\n  messagePartsEnabled: boolean;\n  messagePartsRecallMaxResults: number;\n}\n\n/** An expanded archive row with stable lineage identity; content may be budget-truncated. */\nexport interface LcmExpandedMessage {\n  id: number;\n  session_id: string;\n  turn_index: number;\n  role: string;\n  content: string;\n}\n\nfunction positiveInteger(value: unknown, fallback: number, min = 1): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return fallback;\n  return Math.max(min, Math.floor(value));\n}\n\nexport function extractLcmConfig(cfg: PluginConfig): LcmEngineConfig {\n  return {\n    enabled: (cfg as any).lcmEnabled === true,\n    leafBatchSize: positiveInteger((cfg as any).lcmLeafBatchSize, 8),\n    rollupFanIn: positiveInteger((cfg as any).lcmRollupFanIn, 4, 2),\n    freshTailTurns: positiveInteger((cfg as any).lcmFreshTailTurns, 16),\n    maxDepth: positiveInteger((cfg as any).lcmMaxDepth, 5),\n    deterministicMaxTokens: positiveInteger((cfg as any).lcmDeterministicMaxTokens, 512),\n    archiveRetentionDays: positiveInteger((cfg as any).lcmArchiveRetentionDays, 90, 0),\n    recallBudgetShare: (cfg as any).lcmRecallBudgetShare ?? 0.15,\n    observeConcurrency:\n      typeof (cfg as any).lcmObserveConcurrency === \"number\" &&\n        Number.isFinite((cfg as any).lcmObserveConcurrency)\n        ? Math.max(1, Math.floor((cfg as any).lcmObserveConcurrency))\n        : 1,\n    telemetryPrefilterEnabled: (cfg as any).lcmTelemetryPrefilterEnabled !== false,\n    messagePartsEnabled: (cfg as any).messagePartsEnabled === true,\n    messagePartsRecallMaxResults:\n      typeof (cfg as any).messagePartsRecallMaxResults === \"number\"\n        ? Math.max(0, Math.floor((cfg as any).messagePartsRecallMaxResults))\n        : 6,\n  };\n}\n\nfunction normalizeLcmSessionId(sessionId: string): string {\n  return sessionId.trim();\n}\n\nfunction normalizeOptionalLcmSessionId(sessionId?: string): string | undefined {\n  if (sessionId === undefined) {\n    return undefined;\n  }\n  const normalized = normalizeLcmSessionId(sessionId);\n  return normalized.length > 0 ? normalized : undefined;\n}\n\nconst EMPTY_LCM_STATS = {\n  totalMessages: 0,\n  totalSummaryNodes: 0,\n  maxDepth: -1,\n} as const;\n\nexport class LcmEngine {\n  private db: Database.Database | null = null;\n  private archive: LcmArchive | null = null;\n  private dag: LcmDag | null = null;\n  private summarizer: LcmSummarizer | null = null;\n  private observeQueue: LcmWorkQueue | null = null;\n  private closed = false;\n  private readonly config: LcmEngineConfig;\n  private readonly memoryDir: string;\n  private initPromise: Promise<void> | null = null;\n  private readonly pendingObserveInitCounts = new Map<string, number>();\n  private readonly pendingObserveInitWaiters = new Map<string, Array<() => void>>();\n  private readonly pendingObserveInitIdleWaiters: Array<() => void> = [];\n\n  constructor(\n    pluginConfig: PluginConfig,\n    private readonly summarizeFn: SummarizeFn,\n  ) {\n    this.config = extractLcmConfig(pluginConfig);\n    this.memoryDir = pluginConfig.memoryDir;\n  }\n\n  get enabled(): boolean {\n    return this.config.enabled;\n  }\n\n  /** Lazy init — open database on first use. */\n  async ensureInitialized(): Promise<void> {\n    if (this.closed) return;\n    if (this.db) return;\n    if (this.initPromise) {\n      await this.initPromise;\n      return;\n    }\n    this.initPromise = this.doInit().catch((err) => {\n      // Reset so next call retries instead of caching the failure\n      this.initPromise = null;\n      throw err;\n    });\n    await this.initPromise;\n  }\n\n  private async doInit(): Promise<void> {\n    await ensureLcmStateDir(this.memoryDir);\n    const db = openLcmDatabase(this.memoryDir);\n    const archive = new LcmArchive(db);\n    const dag = new LcmDag(db);\n    const { telemetryPrefilterEnabled } = this.config;\n    const summarizer = new LcmSummarizer(\n      archive,\n      dag,\n      this.summarizeFn,\n      {\n        leafBatchSize: this.config.leafBatchSize,\n        rollupFanIn: this.config.rollupFanIn,\n        maxDepth: this.config.maxDepth,\n        deterministicMaxTokens: this.config.deterministicMaxTokens,\n        telemetryPrefilterEnabled,\n      },\n    );\n    const observeQueue = new LcmWorkQueue({\n      concurrency: this.config.observeConcurrency,\n      worker: async (sessionId, messages) => {\n        await this.processObserveMessages(sessionId, messages);\n      },\n      hooks: {\n        onJobStart: ({ sessionId, depth, inFlight, waitMs }) => {\n          log.debug(\n            `LCM observe queue start: session=${sessionId}, depth=${depth}, inFlight=${inFlight}, wait=${waitMs}ms`,\n          );\n        },\n        onJobFinish: ({\n          sessionId,\n          depth,\n          inFlight,\n          waitMs,\n          runMs,\n          totalMs,\n          error,\n        }) => {\n          if (error) {\n            log.error(\n              `LCM observe queue failure: session=${sessionId}, depth=${depth}, inFlight=${inFlight}, wait=${waitMs}ms, run=${runMs}ms, total=${totalMs}ms, error=${error}`,\n            );\n            return;\n          }\n\n          log.debug(\n            `LCM observe queue finish: session=${sessionId}, depth=${depth}, inFlight=${inFlight}, wait=${waitMs}ms, run=${runMs}ms, total=${totalMs}ms`,\n          );\n        },\n      },\n    });\n\n    if (this.closed) {\n      db.close();\n      return;\n    }\n\n    this.db = db;\n    this.archive = archive;\n    this.dag = dag;\n    this.summarizer = summarizer;\n    this.observeQueue = observeQueue;\n    log.info(\"LCM engine initialized\");\n  }\n\n  /**\n   * Enqueue messages from agent_end hook.\n   * The queue worker performs the archive append and incremental summarization.\n   */\n  async observeMessages(\n    sessionId: string,\n    messages: LcmObserveMessage[],\n  ): Promise<void> {\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return;\n    this.enqueueObserveMessages(normalizedSessionId, messages);\n  }\n\n  /** Enqueue an observe job without waiting for worker completion. */\n  enqueueObserveMessages(\n    sessionId: string,\n    messages: LcmObserveMessage[],\n  ): void {\n    if (!this.config.enabled || this.closed) return;\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return;\n    if (messages.length === 0) return;\n\n    this.reservePendingObserveInit(normalizedSessionId);\n\n    void this.ensureInitialized()\n      .then(() => {\n        if (this.closed || !this.observeQueue) return;\n        this.observeQueue.enqueue(normalizedSessionId, messages);\n        log.debug(\n          `LCM observe enqueued: session=${normalizedSessionId}, depth=${this.observeQueue.depth}, inFlight=${this.observeQueue.inFlightCount}`,\n        );\n      })\n      .catch((err) => {\n        if (this.closed) return;\n        log.error(`LCM observe enqueue initialization error: ${err}`);\n      })\n      .finally(() => {\n        this.releasePendingObserveInit(normalizedSessionId);\n      });\n  }\n\n  private async processObserveMessages(\n    sessionId: string,\n    messages: LcmObserveMessage[],\n  ): Promise<void> {\n    if (this.closed) return;\n    await this.ensureInitialized();\n    if (this.closed || !this.archive || !this.summarizer) return;\n\n    if (messages.length === 0) return;\n\n    const currentMax = this.archive.getMaxTurnIndex(sessionId);\n    const { messagePartsEnabled } = this.config;\n    const newMessages = messages.map((m, i) => ({\n      turnIndex: currentMax + 1 + i,\n      role: m.role,\n      content: m.content,\n      parts: messagePartsEnabled ? m.parts : undefined,\n      rawContent: messagePartsEnabled ? m.rawContent : undefined,\n      sourceFormat: messagePartsEnabled ? m.sourceFormat : undefined,\n    }));\n\n    this.archive.appendMessages(sessionId, newMessages, {\n      messagePartsEnabled,\n    });\n\n    // Trigger incremental summarization inside the worker, after append.\n    try {\n      await this.summarizer.summarizeIncremental(sessionId);\n    } catch (err) {\n      log.debug(`LCM incremental summarization error: ${err}`);\n    }\n  }\n\n  get observeQueueDepth(): number {\n    return this.observeQueue?.depth ?? 0;\n  }\n\n  get observeQueueInFlightCount(): number {\n    return this.observeQueue?.inFlightCount ?? 0;\n  }\n\n  async waitForObserveQueueIdle(): Promise<void> {\n    if (!this.config.enabled || this.closed) return;\n    await this.ensureInitialized();\n    if (this.closed) return;\n    await this.waitForPendingObserveInitIdle();\n    await this.observeQueue?.whenIdle();\n  }\n\n  async waitForSessionObserveIdle(sessionId: string): Promise<void> {\n    if (!this.config.enabled || this.closed) return;\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return;\n    await this.ensureInitialized();\n    if (this.closed) return;\n    await this.waitForPendingObserveInitIdle(normalizedSessionId);\n    await this.observeQueue?.whenSessionIdle(normalizedSessionId);\n  }\n\n  private reservePendingObserveInit(sessionId: string): void {\n    const count = this.pendingObserveInitCounts.get(sessionId) ?? 0;\n    this.pendingObserveInitCounts.set(sessionId, count + 1);\n  }\n\n  private releasePendingObserveInit(sessionId: string): void {\n    const count = this.pendingObserveInitCounts.get(sessionId);\n    if (!count) return;\n\n    if (count === 1) {\n      this.pendingObserveInitCounts.delete(sessionId);\n      const waiters = this.pendingObserveInitWaiters.get(sessionId) ?? [];\n      this.pendingObserveInitWaiters.delete(sessionId);\n      for (const resolve of waiters) resolve();\n      if (this.pendingObserveInitCounts.size === 0) {\n        const idleWaiters = this.pendingObserveInitIdleWaiters.splice(\n          0,\n          this.pendingObserveInitIdleWaiters.length,\n        );\n        for (const resolve of idleWaiters) resolve();\n      }\n      return;\n    }\n\n    this.pendingObserveInitCounts.set(sessionId, count - 1);\n  }\n\n  private async waitForPendingObserveInitIdle(sessionId?: string): Promise<void> {\n    if (sessionId) {\n      if (!this.pendingObserveInitCounts.has(sessionId)) return;\n      await new Promise<void>((resolve) => {\n        const waiters = this.pendingObserveInitWaiters.get(sessionId) ?? [];\n        waiters.push(resolve);\n        this.pendingObserveInitWaiters.set(sessionId, waiters);\n      });\n      return;\n    }\n\n    if (this.pendingObserveInitCounts.size === 0) return;\n    await new Promise<void>((resolve) => {\n      this.pendingObserveInitIdleWaiters.push(resolve);\n    });\n  }\n\n  /** Build the compressed history recall section for a session. */\n  async assembleRecall(\n    sessionId: string,\n    budgetChars: number,\n  ): Promise<string> {\n    return (await this.assembleRecallWithTrace(sessionId, budgetChars)).text;\n  }\n\n  /** Build compressed recall plus content-free selected-summary receipts. */\n  async assembleRecallWithTrace(\n    sessionId: string,\n    budgetChars: number,\n  ): Promise<LcmRecallWithTraceResult> {\n    if (!this.config.enabled) return { text: \"\", selectedSummaries: [] };\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return { text: \"\", selectedSummaries: [] };\n    await this.ensureInitialized();\n\n    const effectiveBudget = Math.ceil(\n      budgetChars * this.config.recallBudgetShare,\n    );\n    if (effectiveBudget <= 0) return { text: \"\", selectedSummaries: [] };\n\n    return assembleCompressedHistoryWithTrace(this.dag!, this.archive!, normalizedSessionId, {\n      freshTailTurns: this.config.freshTailTurns,\n      budgetChars: effectiveBudget,\n    });\n  }\n\n  async searchStructuredParts(\n    sessionId: string,\n    query: string,\n    limit = this.config.messagePartsRecallMaxResults,\n  ): Promise<LcmStructuredRecallMatch[]> {\n    const { messagePartsEnabled } = this.config;\n    if (!this.config.enabled || !messagePartsEnabled) return [];\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return [];\n    await this.ensureInitialized();\n    if (!this.archive) return [];\n    return this.archive.searchStructuredParts(query, limit, normalizedSessionId);\n  }\n\n  formatStructuredRecall(\n    matches: LcmStructuredRecallMatch[],\n    budgetChars: number,\n  ): string {\n    if (matches.length === 0 || budgetChars <= 0) return \"\";\n    const lines: string[] = [];\n    let used = \"## Structured Session Matches\\n\\n\".length;\n    for (const match of matches) {\n      const label = match.file_path\n        ? `${match.kind} ${match.file_path}`\n        : match.tool_name\n          ? `${match.kind} ${match.tool_name}`\n          : match.kind;\n      const excerpt = match.content.replace(/\\s+/g, \" \").slice(0, 220);\n      const line = `- turn ${match.turn_index} (${match.role}): ${label} — ${excerpt}`;\n      if (used + line.length + 1 > budgetChars) break;\n      lines.push(line);\n      used += line.length + 1;\n    }\n    return lines.length > 0 ? `## Structured Session Matches\\n\\n${lines.join(\"\\n\")}` : \"\";\n  }\n\n  /** Flush pending summaries before compaction (called from before_compaction hook). */\n  async preCompactionFlush(sessionId: string): Promise<void> {\n    if (!this.config.enabled) return;\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return;\n    await this.ensureInitialized();\n    await this.waitForSessionObserveIdle(normalizedSessionId);\n\n    try {\n      await this.summarizer!.summarizeIncremental(normalizedSessionId);\n    } catch (err) {\n      log.debug(`LCM pre-compaction flush error: ${err}`);\n    }\n  }\n\n  /** Record a compaction event with real token counts (called from after_compaction hook). */\n  async recordCompaction(\n    sessionId: string,\n    tokensBefore: number,\n    tokensAfter: number,\n  ): Promise<void> {\n    if (!this.config.enabled) return;\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return;\n    await this.ensureInitialized();\n    await this.waitForSessionObserveIdle(normalizedSessionId);\n\n    const maxTurn = this.archive!.getMaxTurnIndex(normalizedSessionId);\n\n    this.dag!.recordCompaction(normalizedSessionId, maxTurn, tokensBefore, tokensAfter);\n    log.info(\n      `LCM compaction recorded: session=${normalizedSessionId}, turn=${maxTurn}, tokens ${tokensBefore}→${tokensAfter}`,\n    );\n  }\n\n  /** Verify archive coverage after compaction. */\n  async verifyPostCompaction(sessionId: string): Promise<void> {\n    if (!this.config.enabled) return;\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return;\n    await this.ensureInitialized();\n\n    const msgCount = this.archive!.getMessageCount(normalizedSessionId);\n    const nodeCount = this.dag!.getNodeCount(normalizedSessionId);\n    log.debug(\n      `LCM post-compaction verify: session=${normalizedSessionId}, messages=${msgCount}, summaryNodes=${nodeCount}`,\n    );\n  }\n\n  // ── MCP Tool implementations ──\n\n  /** Search across all conversation history via FTS (snippet mode). */\n  async searchContext(\n    query: string,\n    limit: number,\n    sessionId?: string,\n    sessionPrefix?: string,\n  ): Promise<\n    Array<{\n      turn_index: number;\n      role: string;\n      snippet: string;\n      session_id: string;\n    }>\n  > {\n    if (!this.config.enabled) return [];\n    const normalizedSessionId = normalizeOptionalLcmSessionId(sessionId);\n    if (sessionId !== undefined && !normalizedSessionId) return [];\n    const normalizedSessionPrefix = normalizeOptionalLcmSessionId(sessionPrefix);\n    if (sessionPrefix !== undefined && !normalizedSessionPrefix) return [];\n    await this.ensureInitialized();\n    return this.archive!.search(query, limit, normalizedSessionId, normalizedSessionPrefix);\n  }\n\n  /** Search via FTS returning full message content (not snippets). */\n  async searchContextFull(\n    query: string,\n    limit: number,\n    sessionId?: string,\n    sessionPrefix?: string,\n  ): Promise<\n    Array<{\n      id: number;\n      turn_index: number;\n      role: string;\n      content: string;\n      session_id: string;\n      score: number;\n    }>\n  > {\n    if (!this.config.enabled) return [];\n    const normalizedSessionId = normalizeOptionalLcmSessionId(sessionId);\n    if (sessionId !== undefined && !normalizedSessionId) return [];\n    const normalizedSessionPrefix = normalizeOptionalLcmSessionId(sessionPrefix);\n    if (sessionPrefix !== undefined && !normalizedSessionPrefix) return [];\n    await this.ensureInitialized();\n    return this.archive!.searchWithContent(\n      query,\n      limit,\n      normalizedSessionId,\n      1000,\n      normalizedSessionPrefix,\n    );\n  }\n\n  /** Get a compressed summary of a turn range. */\n  async describeContext(\n    sessionId: string,\n    fromTurn: number,\n    toTurn: number,\n  ): Promise<{ summary: string; turn_count: number; depth: number } | null> {\n    if (!this.config.enabled) return null;\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return null;\n    await this.ensureInitialized();\n\n    const nodes = this.dag!.getCoveringNodes(normalizedSessionId, fromTurn, toTurn);\n    if (nodes.length === 0) {\n      // No summary exists — build a description from raw messages\n      const messages = this.archive!.getMessages(normalizedSessionId, fromTurn, toTurn);\n      if (messages.length === 0) return null;\n      const preview = messages\n        .slice(0, 5)\n        .map((m) => `[${m.role}] ${m.content.slice(0, 100)}`)\n        .join(\"\\n\");\n      return {\n        summary: `No summary available for this range. Preview of ${messages.length} messages:\\n${preview}`,\n        turn_count: messages.length,\n        depth: -1,\n      };\n    }\n\n    // Use the deepest covering node\n    const best = nodes[0]; // Already sorted by depth DESC\n    return {\n      summary: best.summary_text,\n      turn_count: best.msg_end - best.msg_start + 1,\n      depth: best.depth,\n    };\n  }\n\n  /** Retrieve raw messages for a turn range (lossless expansion). */\n  async expandContext(\n    sessionId: string,\n    fromTurn: number,\n    toTurn: number,\n    maxTokens: number,\n  ): Promise<LcmExpandedMessage[]> {\n    if (!this.config.enabled) return [];\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return [];\n    await this.ensureInitialized();\n\n    const messages = this.archive!.getMessages(normalizedSessionId, fromTurn, toTurn);\n    if (messages.length === 0) return [];\n\n    // Enforce token budget — keep first and last, truncate middle\n    const maxChars = maxTokens * 4;\n    let totalChars = 0;\n    for (const m of messages) totalChars += m.content.length;\n\n    if (totalChars <= maxChars) {\n      return messages.map((m) => ({\n        id: m.id,\n        session_id: m.session_id,\n        turn_index: m.turn_index,\n        role: m.role,\n        content: m.content,\n      }));\n    }\n\n    // Keep first and last messages, truncate from middle\n    const result: LcmExpandedMessage[] = [];\n    let budget = maxChars;\n\n    // Reserve space for the last message\n    const lastMsg = messages[messages.length - 1];\n    const lastMsgChars = Math.min(\n      lastMsg.content.length,\n      Math.floor(maxChars * 0.3),\n    );\n    budget -= lastMsgChars;\n\n    // Add messages from the beginning\n    for (let i = 0; i < messages.length - 1; i++) {\n      if (budget <= 0) break;\n      const m = messages[i];\n      const truncated = m.content.slice(0, budget);\n      result.push({\n        id: m.id,\n        session_id: m.session_id,\n        turn_index: m.turn_index,\n        role: m.role,\n        content: truncated,\n      });\n      budget -= truncated.length;\n    }\n\n    // Always append the last message\n    result.push({\n      id: lastMsg.id,\n      session_id: lastMsg.session_id,\n      turn_index: lastMsg.turn_index,\n      role: lastMsg.role,\n      content: lastMsg.content.slice(0, lastMsgChars + Math.max(0, budget)),\n    });\n\n    return result;\n  }\n\n  /** Get statistics about the LCM archive. */\n  async getStats(sessionId?: string): Promise<{\n    totalMessages: number;\n    totalSummaryNodes: number;\n    maxDepth: number;\n    maxTurnIndex?: number;\n  }> {\n    if (!this.config.enabled)\n      return { totalMessages: 0, totalSummaryNodes: 0, maxDepth: -1 };\n    const normalizedSessionId = normalizeOptionalLcmSessionId(sessionId);\n    if (sessionId !== undefined && !normalizedSessionId) {\n      return { ...EMPTY_LCM_STATS };\n    }\n    await this.ensureInitialized();\n\n    if (normalizedSessionId) {\n      return {\n        totalMessages: this.archive!.getMessageCount(normalizedSessionId),\n        totalSummaryNodes: this.dag!.getNodeCount(normalizedSessionId),\n        maxDepth: this.dag!.getMaxDepth(normalizedSessionId),\n        maxTurnIndex: this.archive!.getMaxTurnIndex(normalizedSessionId),\n      };\n    }\n\n    return {\n      totalMessages: this.archive!.getTotalMessageCount(),\n      totalSummaryNodes: 0, // Would need a global count query\n      maxDepth: -1,\n    };\n  }\n\n  /** Clear all LCM archive and summary state for one session. */\n  async clearSession(sessionId: string): Promise<void> {\n    if (!this.config.enabled || this.closed) return;\n    const normalizedSessionId = normalizeLcmSessionId(sessionId);\n    if (!normalizedSessionId) return;\n    await this.ensureInitialized();\n    if (this.closed || !this.archive || !this.dag) return;\n    await this.waitForSessionObserveIdle(normalizedSessionId);\n    this.dag.deleteSession(normalizedSessionId);\n    this.archive.deleteSession(normalizedSessionId);\n  }\n\n  /** Clear all LCM archive and summary state without closing the engine. */\n  async clearAll(): Promise<void> {\n    if (!this.config.enabled || this.closed) return;\n    await this.ensureInitialized();\n    if (this.closed || !this.archive || !this.dag) return;\n    await this.waitForObserveQueueIdle();\n    this.dag.deleteAll();\n    this.archive.deleteAll();\n  }\n\n  /** Prune old data beyond retention period. */\n  async prune(): Promise<{ messagesPruned: number; nodesPruned: number }> {\n    if (!this.config.enabled) return { messagesPruned: 0, nodesPruned: 0 };\n    await this.ensureInitialized();\n\n    const messagesPruned = this.archive!.pruneOldMessages(\n      this.config.archiveRetentionDays,\n    );\n    const nodesPruned = this.dag!.pruneOldNodes(\n      this.config.archiveRetentionDays,\n    );\n    return { messagesPruned, nodesPruned };\n  }\n\n  /** Close the database connection. */\n  close(): void {\n    this.closed = true;\n    if (this.db) {\n      this.db.close();\n    }\n    this.db = null;\n    this.archive = null;\n    this.dag = null;\n    this.summarizer = null;\n    this.observeQueue = null;\n    this.initPromise = null;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli.d.ts

@@ -97,6 +97,7 @@ import './lcm/engine.js';
 import './lcm/archive.js';
 import './lcm/summarizer.js';
 import './lcm/dag.js';
+import './lcm/recall.js';
 import './lcm/queue.js';
 import './types-B1VHaf2w.js';
 import './recall-explain-renderer.js';

package/dist/compounding/preference-consolidator.d.ts

@@ -5,6 +5,7 @@ import '../lcm/archive.js';
 import 'better-sqlite3';
 import '../lcm/summarizer.js';
 import '../lcm/dag.js';
+import '../lcm/recall.js';
 import '../lcm/queue.js';
 
 /**

package/dist/event-order-recall.d.ts

@@ -1,4 +1,5 @@
 import { ExplicitCueRecallEngine } from './explicit-cue-recall.js';
+import './evidence-pack.js';
 
 interface EventOrderRecallOptions {
     engine: ExplicitCueRecallEngine | null | undefined;

package/dist/event-order-recall.js

@@ -1,9 +1,9 @@
 import {
   buildEventOrderRecallSection,
   shouldRecallEventOrderEvidence
-} from "./chunk-7O2JL5RY.js";
+} from "./chunk-DEOYTFA6.js";
 import "./chunk-LUPVCGYK.js";
-import "./chunk-R26WO46Z.js";
+import "./chunk-DGFU5MSX.js";
 import "./chunk-C37ZRXX7.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/evidence-pack.d.ts

@@ -13,8 +13,23 @@ interface EvidencePackOptions {
     maxChars: number;
     maxItemChars?: number;
     query?: string;
+    /** Optional non-rendering receipt for each block actually appended. */
+    onSelection?: (receipt: EvidencePackSelectionReceipt) => void;
+}
+/** Content-free identity fields for an evidence item that survived selection. */
+interface EvidencePackSelectedItem {
+    archiveRowId?: number;
+    turnIndex?: number;
+    role?: string;
+    score?: number;
+}
+interface EvidencePackSelectionReceipt {
+    item: EvidencePackSelectedItem;
+    /** Half-open offsets within the returned evidence-pack string. */
+    blockStart: number;
+    blockEnd: number;
 }
 declare function buildEvidencePack(items: readonly EvidencePackItem[], options: EvidencePackOptions): string;
 declare function insertAfterEvidenceHeading(evidence: string, title: string, insert: string): string;
 
-export { type EvidencePackItem, type EvidencePackOptions, buildEvidencePack, insertAfterEvidenceHeading };
+export { type EvidencePackItem, type EvidencePackOptions, type EvidencePackSelectedItem, type EvidencePackSelectionReceipt, buildEvidencePack, insertAfterEvidenceHeading };

package/dist/evidence-pack.js

@@ -1,7 +1,7 @@
 import {
   buildEvidencePack,
   insertAfterEvidenceHeading
-} from "./chunk-R26WO46Z.js";
+} from "./chunk-DGFU5MSX.js";
 import "./chunk-PZ5AY32C.js";
 export {
   buildEvidencePack,

package/dist/explicit-capture.d.ts

@@ -73,6 +73,7 @@ import './lcm/engine.js';
 import './lcm/archive.js';
 import './lcm/summarizer.js';
 import './lcm/dag.js';
+import './lcm/recall.js';
 import './lcm/queue.js';
 import './policy-runtime.js';
 

package/dist/explicit-cue-recall.d.ts

@@ -1,3 +1,5 @@
+import { EvidencePackSelectionReceipt } from './evidence-pack.js';
+
 interface ExplicitCueRecallEngine {
     expandContext(sessionId: string, fromTurn: number, toTurn: number, maxTokens: number): Promise<Array<{
         id?: number;
@@ -36,12 +38,25 @@ interface ExplicitCueRecallOptions {
     includeBenchmarkAnchorCues?: boolean;
     includeContentLexicalCues?: boolean;
     includeStructuredPlanCues?: boolean;
+    /** Observe selected evidence blocks without changing rendered output. */
+    onEvidenceSelected?: (receipt: EvidencePackSelectionReceipt) => void;
 }
 interface TrajectoryAnalysisRecallOptions {
     engine: ExplicitCueRecallEngine | null | undefined;
     sessionId?: string;
     query: string;
     maxChars: number;
+    /** Observe only emitted lines; unavailable lineage is never guessed. */
+    onLineSelected?: (receipt: TrajectoryAnalysisLineReceipt) => void;
+}
+interface TrajectoryAnalysisLineReceipt {
+    /** Half-open offsets within the returned trajectory section. */
+    lineStart: number;
+    lineEnd: number;
+    /** Whether the source row set is structurally exact or unavailable. */
+    lineageStatus: "exact" | "unavailable";
+    actionArchiveRowIds: number[];
+    observationArchiveRowIds: number[];
 }
 type ExplicitTurnReference = {
     number: number;
@@ -65,4 +80,4 @@ declare function collectBenchmarkAnchorCues(query: string): string[];
 declare function collectStructuredPlanCues(query: string): string[];
 declare function collectTemporalLexicalCues(query: string): string[];
 
-export { type ExplicitCueRecallEngine, type ExplicitCueRecallOptions, type ExplicitTurnReference, type TrajectoryAnalysisRecallOptions, buildExplicitCueRecallSection, buildTrajectoryAnalysisRecallSection, collectBenchmarkAnchorCues, collectContentLexicalCues, collectExplicitTurnReferences, collectLexicalCues, collectQuestionSlotCues, collectStructuredPlanCues, collectTemporalLexicalCues, normalizeTurnExpansionEnd };
+export { type ExplicitCueRecallEngine, type ExplicitCueRecallOptions, type ExplicitTurnReference, type TrajectoryAnalysisLineReceipt, type TrajectoryAnalysisRecallOptions, buildExplicitCueRecallSection, buildTrajectoryAnalysisRecallSection, collectBenchmarkAnchorCues, collectContentLexicalCues, collectExplicitTurnReferences, collectLexicalCues, collectQuestionSlotCues, collectStructuredPlanCues, collectTemporalLexicalCues, normalizeTurnExpansionEnd };

package/dist/explicit-cue-recall.js

@@ -9,10 +9,10 @@ import {
   collectStructuredPlanCues,
   collectTemporalLexicalCues,
   normalizeTurnExpansionEnd
-} from "./chunk-77UPM7P3.js";
+} from "./chunk-TVIVY7KU.js";
 import "./chunk-YVVQUAOO.js";
 import "./chunk-LUPVCGYK.js";
-import "./chunk-R26WO46Z.js";
+import "./chunk-DGFU5MSX.js";
 import "./chunk-C37ZRXX7.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/focused-list-recall.d.ts

@@ -1,4 +1,5 @@
 import { ExplicitCueRecallEngine } from './explicit-cue-recall.js';
+import './evidence-pack.js';
 
 interface FocusedListRecallOptions {
     engine: ExplicitCueRecallEngine | null | undefined;

package/dist/focused-list-recall.js

@@ -1,9 +1,9 @@
 import {
   buildFocusedListRecallSection,
   shouldRecallFocusedListEvidence
-} from "./chunk-BFU7H32D.js";
+} from "./chunk-OH7QLI6W.js";
 import "./chunk-YVVQUAOO.js";
-import "./chunk-R26WO46Z.js";
+import "./chunk-DGFU5MSX.js";
 import "./chunk-C37ZRXX7.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/index.d.ts

@@ -7,8 +7,8 @@ export { D as DEFAULT_SELF_NAME, O as Orchestrator, c as ResolvedSpeaker, d as S
 export { normalizeProjectionPreview, normalizeProjectionTags } from './memory-projection-format.js';
 export { ModelCapabilities, ModelRegistry } from './model-registry.js';
 export { ACTIVE_STATUSES, ContradictionFilter, ContradictionJudgeBatchResult, ContradictionJudgeInput, ContradictionJudgeResult, ContradictionListResult, ContradictionVerdict, ResolutionResult, ResolutionVerb, ScanDependencies, ScanResult, computePairId, executeResolution, isCoolingDown, isValidResolutionVerb, judgeContradictionPairs, listPairs, readPair, resolvePair, runContradictionScan, writePair, writePairs } from './contradiction/index.js';
-export { EvidencePackItem, EvidencePackOptions, buildEvidencePack } from './evidence-pack.js';
-export { ExplicitCueRecallEngine, ExplicitCueRecallOptions, ExplicitTurnReference, TrajectoryAnalysisRecallOptions, buildExplicitCueRecallSection, buildTrajectoryAnalysisRecallSection, collectBenchmarkAnchorCues, collectContentLexicalCues, collectExplicitTurnReferences, collectLexicalCues, collectQuestionSlotCues, collectStructuredPlanCues, collectTemporalLexicalCues, normalizeTurnExpansionEnd } from './explicit-cue-recall.js';
+export { EvidencePackItem, EvidencePackOptions, EvidencePackSelectedItem, EvidencePackSelectionReceipt, buildEvidencePack } from './evidence-pack.js';
+export { ExplicitCueRecallEngine, ExplicitCueRecallOptions, ExplicitTurnReference, TrajectoryAnalysisLineReceipt, TrajectoryAnalysisRecallOptions, buildExplicitCueRecallSection, buildTrajectoryAnalysisRecallSection, collectBenchmarkAnchorCues, collectContentLexicalCues, collectExplicitTurnReferences, collectLexicalCues, collectQuestionSlotCues, collectStructuredPlanCues, collectTemporalLexicalCues, normalizeTurnExpansionEnd } from './explicit-cue-recall.js';
 export { TargetedFactRecallOptions, buildTargetedFactRecallSection, shouldRecallTargetedFactEvidence } from './targeted-fact-recall.js';
 export { FocusedListRecallOptions, buildFocusedListRecallSection, shouldRecallFocusedListEvidence } from './focused-list-recall.js';
 export { ResponseGuidanceRecallOptions, buildResponseGuidanceRecallSection, shouldRecallResponseGuidance } from './response-guidance-recall.js';
@@ -148,6 +148,7 @@ import './lcm/engine.js';
 import './lcm/archive.js';
 import './lcm/summarizer.js';
 import './lcm/dag.js';
+import './lcm/recall.js';
 import './lcm/queue.js';
 import './policy-runtime.js';
 import './profiling.js';

package/dist/index.js

@@ -93,7 +93,7 @@ import {
   validateTaxonomy,
   watchForChanges,
   writeManifest
-} from "./chunk-3VSTTB74.js";
+} from "./chunk-WSOEYOHN.js";
 import {
   WEARABLE_SOURCE_PREFIX,
   buildExtractionTurns,
@@ -139,9 +139,9 @@ import {
 } from "./chunk-7HYPN2GC.js";
 import "./chunk-666A3MOW.js";
 import "./chunk-VDC6RZI4.js";
-import "./chunk-5AJIDEFT.js";
+import "./chunk-XFTPUXCE.js";
 import "./chunk-TPDBFYEG.js";
-import "./chunk-KCYE2MZM.js";
+import "./chunk-UXPUUL3G.js";
 import {
   applyLcmSchema,
   ensureLcmStateDir,
@@ -214,7 +214,7 @@ import "./chunk-YN2UN7N3.js";
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
-} from "./chunk-IRMLYBMU.js";
+} from "./chunk-T67LUYCR.js";
 import "./chunk-I6WYQSX4.js";
 import {
   CODEX_THREAD_KEY_PREFIX
@@ -228,7 +228,7 @@ import "./chunk-E3VODCC3.js";
 import {
   buildResponseGuidanceRecallSection,
   shouldRecallResponseGuidance
-} from "./chunk-XGSOXFD4.js";
+} from "./chunk-6TCXIRP5.js";
 import "./chunk-DE6ENYLG.js";
 import "./chunk-HHAA35A3.js";
 import "./chunk-X7XN6YU4.js";
@@ -301,11 +301,11 @@ import "./chunk-QT2RZNRT.js";
 import {
   buildFocusedListRecallSection,
   shouldRecallFocusedListEvidence
-} from "./chunk-BFU7H32D.js";
+} from "./chunk-OH7QLI6W.js";
 import {
   buildEventOrderRecallSection,
   shouldRecallEventOrderEvidence
-} from "./chunk-7O2JL5RY.js";
+} from "./chunk-DEOYTFA6.js";
 import "./chunk-IAIPNEHD.js";
 import {
   buildExplicitCueRecallSection,
@@ -318,12 +318,12 @@ import {
   collectStructuredPlanCues,
   collectTemporalLexicalCues,
   normalizeTurnExpansionEnd
-} from "./chunk-77UPM7P3.js";
+} from "./chunk-TVIVY7KU.js";
 import "./chunk-YVVQUAOO.js";
 import "./chunk-LUPVCGYK.js";
 import {
   buildEvidencePack
-} from "./chunk-R26WO46Z.js";
+} from "./chunk-DGFU5MSX.js";
 import {
   buildExtensionsFooterForSummary,
   loadDaySummaryPrompt

package/dist/lcm/engine.d.ts

@@ -1,5 +1,6 @@
 import { LcmStructuredRecallMatch } from './archive.js';
 import { SummarizeFn } from './summarizer.js';
+import { LcmRecallWithTraceResult } from './recall.js';
 import { LcmObserveMessage } from './queue.js';
 import { P as PluginConfig } from '../types-DDUDgd7T.js';
 import 'better-sqlite3';
@@ -65,6 +66,8 @@ declare class LcmEngine {
     private waitForPendingObserveInitIdle;
     /** Build the compressed history recall section for a session. */
     assembleRecall(sessionId: string, budgetChars: number): Promise<string>;
+    /** Build compressed recall plus content-free selected-summary receipts. */
+    assembleRecallWithTrace(sessionId: string, budgetChars: number): Promise<LcmRecallWithTraceResult>;
     searchStructuredParts(sessionId: string, query: string, limit?: number): Promise<LcmStructuredRecallMatch[]>;
     formatStructuredRecall(matches: LcmStructuredRecallMatch[], budgetChars: number): string;
     /** Flush pending summaries before compaction (called from before_compaction hook). */

package/dist/lcm/engine.js

@@ -1,9 +1,9 @@
 import {
   LcmEngine,
   extractLcmConfig
-} from "../chunk-5AJIDEFT.js";
+} from "../chunk-XFTPUXCE.js";
 import "../chunk-TPDBFYEG.js";
-import "../chunk-KCYE2MZM.js";
+import "../chunk-UXPUUL3G.js";
 import "../chunk-7N2RUBAP.js";
 import "../chunk-MTR7BZQN.js";
 import "../chunk-O7BBFJLP.js";

package/dist/lcm/index.d.ts

@@ -2,7 +2,7 @@ export { LcmEngine, LcmEngineConfig, LcmExpandedMessage, extractLcmConfig } from
 export { LcmArchive, estimateTokens } from './archive.js';
 export { LcmDag, SummaryNode } from './dag.js';
 export { LcmSummarizer, SummarizeFn } from './summarizer.js';
-export { assembleCompressedHistory } from './recall.js';
+export { LcmRecallWithTraceResult, LcmSummarySelectionReceipt, assembleCompressedHistory, assembleCompressedHistoryWithTrace } from './recall.js';
 export { registerLcmTools } from './tools.js';
 export { ensureLcmStateDir, openLcmDatabase } from './schema.js';
 import './queue.js';

package/dist/lcm/index.js

@@ -2,11 +2,12 @@ import "../chunk-VDC6RZI4.js";
 import {
   LcmEngine,
   extractLcmConfig
-} from "../chunk-5AJIDEFT.js";
+} from "../chunk-XFTPUXCE.js";
 import "../chunk-TPDBFYEG.js";
 import {
-  assembleCompressedHistory
-} from "../chunk-KCYE2MZM.js";
+  assembleCompressedHistory,
+  assembleCompressedHistoryWithTrace
+} from "../chunk-UXPUUL3G.js";
 import {
   ensureLcmStateDir,
   openLcmDatabase
@@ -40,6 +41,7 @@ export {
   LcmEngine,
   LcmSummarizer,
   assembleCompressedHistory,
+  assembleCompressedHistoryWithTrace,
   ensureLcmStateDir,
   estimateTokens,
   extractLcmConfig,

package/dist/lcm/recall.d.ts

@@ -7,6 +7,19 @@ interface LcmRecallConfig {
     freshTailTurns: number;
     budgetChars: number;
 }
+interface LcmSummarySelectionReceipt {
+    id: string;
+    depth: number;
+    msgStart: number;
+    msgEnd: number;
+    /** Half-open offsets within the returned compressed-history string. */
+    entryStart: number;
+    entryEnd: number;
+}
+interface LcmRecallWithTraceResult {
+    text: string;
+    selectedSummaries: LcmSummarySelectionReceipt[];
+}
 /**
  * Assemble a compressed session history section from the summary DAG.
  *
@@ -16,5 +29,6 @@ interface LcmRecallConfig {
  * 3. Fill within budget, prioritizing recent content.
  */
 declare function assembleCompressedHistory(dag: LcmDag, archive: LcmArchive, sessionId: string, config: LcmRecallConfig): string;
+declare function assembleCompressedHistoryWithTrace(dag: LcmDag, archive: LcmArchive, sessionId: string, config: LcmRecallConfig): LcmRecallWithTraceResult;
 
-export { type LcmRecallConfig, assembleCompressedHistory };
+export { type LcmRecallConfig, type LcmRecallWithTraceResult, type LcmSummarySelectionReceipt, assembleCompressedHistory, assembleCompressedHistoryWithTrace };

package/dist/lcm/recall.js

@@ -1,8 +1,10 @@
 import {
-  assembleCompressedHistory
-} from "../chunk-KCYE2MZM.js";
+  assembleCompressedHistory,
+  assembleCompressedHistoryWithTrace
+} from "../chunk-UXPUUL3G.js";
 import "../chunk-PZ5AY32C.js";
 export {
-  assembleCompressedHistory
+  assembleCompressedHistory,
+  assembleCompressedHistoryWithTrace
 };
 //# sourceMappingURL=recall.js.map

package/dist/lcm/tools.d.ts

@@ -4,6 +4,7 @@ import 'better-sqlite3';
 import '../message-parts/index.js';
 import './summarizer.js';
 import './dag.js';
+import './recall.js';
 import './queue.js';
 import '../types-DDUDgd7T.js';
 

package/dist/mcp-memory-inspector-app.d.ts

@@ -74,6 +74,7 @@ import './lcm/engine.js';
 import './lcm/archive.js';
 import './lcm/summarizer.js';
 import './lcm/dag.js';
+import './lcm/recall.js';
 import './lcm/queue.js';
 import './policy-runtime.js';
 import './types-B1VHaf2w.js';