@remnic/core 9.6.30 → 9.6.31

package/dist/orchestrator.d.ts

@@ -72,6 +72,7 @@ import './user-model.js';
 import './lcm/archive.js';
 import './lcm/summarizer.js';
 import './lcm/dag.js';
+import './lcm/recall.js';
 import './lcm/queue.js';
 import './connectors/codex-materialize.js';
 import './logger.js';

package/dist/orchestrator.js

@@ -43,7 +43,7 @@ import {
   throwIfRecallAborted,
   tokenizeRecallQuery,
   utcDateKeysForLocalDay
-} from "./chunk-3VSTTB74.js";
+} from "./chunk-WSOEYOHN.js";
 import "./chunk-J3XHPFEU.js";
 import {
   formatCompressionGuidelinesForRecall
@@ -54,9 +54,9 @@ import "./chunk-ILNPU5W5.js";
 import "./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 "./chunk-7N2RUBAP.js";
 import "./chunk-MTR7BZQN.js";
 import "./chunk-UWK5OXUJ.js";
@@ -78,7 +78,7 @@ import "./chunk-4OKLXWDZ.js";
 import "./chunk-UHGBNIOS.js";
 import "./chunk-BCDKBDSY.js";
 import "./chunk-YN2UN7N3.js";
-import "./chunk-IRMLYBMU.js";
+import "./chunk-T67LUYCR.js";
 import "./chunk-I6WYQSX4.js";
 import "./chunk-4EX5WZ4M.js";
 import "./chunk-XZ5I7OZR.js";
@@ -87,7 +87,7 @@ import "./chunk-FDPZVY6D.js";
 import "./chunk-5IZL4DCV.js";
 import "./chunk-2IZAGAJR.js";
 import "./chunk-E3VODCC3.js";
-import "./chunk-XGSOXFD4.js";
+import "./chunk-6TCXIRP5.js";
 import "./chunk-DE6ENYLG.js";
 import "./chunk-HHAA35A3.js";
 import "./chunk-X7XN6YU4.js";
@@ -113,13 +113,13 @@ import "./chunk-5GSUBCZM.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-KAWTOYAW.js";
 import "./chunk-QT2RZNRT.js";
-import "./chunk-BFU7H32D.js";
-import "./chunk-7O2JL5RY.js";
+import "./chunk-OH7QLI6W.js";
+import "./chunk-DEOYTFA6.js";
 import "./chunk-IAIPNEHD.js";
-import "./chunk-77UPM7P3.js";
+import "./chunk-TVIVY7KU.js";
 import "./chunk-YVVQUAOO.js";
 import "./chunk-LUPVCGYK.js";
-import "./chunk-R26WO46Z.js";
+import "./chunk-DGFU5MSX.js";
 import "./chunk-I73G4UH7.js";
 import "./chunk-VEWZZM3H.js";
 import "./chunk-Q6IP2ARR.js";

package/dist/response-guidance-recall.d.ts

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

package/dist/response-guidance-recall.js

@@ -1,10 +1,10 @@
 import {
   buildResponseGuidanceRecallSection,
   shouldRecallResponseGuidance
-} from "./chunk-XGSOXFD4.js";
+} from "./chunk-6TCXIRP5.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/targeted-fact-recall.d.ts

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

package/dist/targeted-fact-recall.js

@@ -1,10 +1,10 @@
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
-} from "./chunk-IRMLYBMU.js";
+} from "./chunk-T67LUYCR.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.6.30",
+  "version": "9.6.31",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3000,7 +3000,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.6.30"
+    "@remnic/coding-graph": "^9.6.31"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/evidence-pack.test.ts

@@ -1,7 +1,10 @@
 import assert from "node:assert/strict";
 import test from "node:test";
 
-import { buildEvidencePack } from "./evidence-pack.js";
+import {
+  buildEvidencePack,
+  type EvidencePackSelectionReceipt,
+} from "./evidence-pack.js";
 
 test("buildEvidencePack deduplicates evidence and stays within budget", () => {
   const pack = buildEvidencePack(
@@ -87,3 +90,65 @@ test("buildEvidencePack keeps query-focused evidence from later long turns", ()
   assert.match(pack, /Dec 16, 2023 - Jan 15, 2024/);
   assert.match(pack, /Feb 16 - Mar 15, 2024/);
 });
+
+test("buildEvidencePack reports only appended blocks with exact content-free offsets", () => {
+  const receipts: EvidencePackSelectionReceipt[] = [];
+  const items = [
+    {
+      id: "selected",
+      archiveRowId: 41,
+      sessionId: "private-session",
+      turnIndex: 7,
+      role: "user",
+      content: "selected private evidence",
+      score: 2,
+    },
+    {
+      id: "duplicate-content",
+      archiveRowId: 42,
+      sessionId: "private-session",
+      turnIndex: 8,
+      role: "assistant",
+      content: "selected private evidence",
+      score: 1,
+    },
+    {
+      id: "budget-rejected",
+      archiveRowId: 43,
+      sessionId: "private-session",
+      turnIndex: 9,
+      role: "assistant",
+      content: "this block cannot fit inside the remaining budget",
+    },
+  ];
+  const options = {
+    title: "Receipt evidence",
+    maxChars:
+      "## Receipt evidence".length +
+      2 +
+      "[private-session, turn 7, user, score 2.000]: selected private evidence".length,
+    maxItemChars: 200,
+  };
+
+  const baseline = buildEvidencePack(items, options);
+  const traced = buildEvidencePack(items, {
+    ...options,
+    onSelection: (receipt) => receipts.push(receipt),
+  });
+
+  assert.equal(traced, baseline);
+  assert.equal(receipts.length, 1);
+  const receipt = receipts[0]!;
+  assert.equal(
+    traced.slice(receipt.blockStart, receipt.blockEnd),
+    "[private-session, turn 7, user, score 2.000]: selected private evidence",
+  );
+  assert.deepEqual(receipt.item, {
+    archiveRowId: 41,
+    turnIndex: 7,
+    role: "user",
+    score: 2,
+  });
+  assert.equal("content" in receipt.item, false);
+  assert.equal("sessionId" in receipt.item, false);
+});

package/src/evidence-pack.ts

@@ -14,6 +14,23 @@ export 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. */
+export interface EvidencePackSelectedItem {
+  archiveRowId?: number;
+  turnIndex?: number;
+  role?: string;
+  score?: number;
+}
+
+export interface EvidencePackSelectionReceipt {
+  item: EvidencePackSelectedItem;
+  /** Half-open offsets within the returned evidence-pack string. */
+  blockStart: number;
+  blockEnd: number;
 }
 
 const DEFAULT_MAX_ITEM_CHARS = 1_200;
@@ -96,15 +113,37 @@ export function buildEvidencePack(
       block.length > remaining ? clipText(block, remaining) : block;
     if (!finalBlock.trim()) break;
 
+    const blockStart = used + separatorLength;
+    const blockEnd = blockStart + finalBlock.length;
     lines.push(finalBlock);
     used += separatorLength + finalBlock.length;
     if (id) seenIds.add(id);
     seenContent.add(contentKey);
+    options.onSelection?.({
+      item: evidencePackSelectedItem(item),
+      blockStart,
+      blockEnd,
+    });
   }
 
   return lines.length === 1 ? "" : lines.join("\n\n");
 }
 
+function evidencePackSelectedItem(
+  item: EvidencePackItem,
+): EvidencePackSelectedItem {
+  return {
+    ...(typeof item.archiveRowId === "number"
+      ? { archiveRowId: item.archiveRowId }
+      : {}),
+    ...(typeof item.turnIndex === "number" ? { turnIndex: item.turnIndex } : {}),
+    ...(typeof item.role === "string" ? { role: item.role } : {}),
+    ...(typeof item.score === "number" && Number.isFinite(item.score)
+      ? { score: item.score }
+      : {}),
+  };
+}
+
 export function insertAfterEvidenceHeading(
   evidence: string,
   title: string,