@remnic/core 9.69.35 → 9.69.37

package/dist/chunk-3SL52JKD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extraction-span-materialize.ts"],"sourcesContent":["/**\n * Span-mode materialization for production extraction (issue #2333 Phase B).\n *\n * Runs immediately after the extraction result is parsed and BEFORE\n * sanitize/grounding/judge/dedup/persistence, so everything downstream sees\n * exactly one content form and the content-hash dedup invariant (checklist\n * §13) holds by construction. Offsets die here — nothing offset-based is\n * stored.\n *\n * Modes:\n * - \"off\":    spans are never requested; a stray span is stripped untrusted.\n * - \"shadow\": spans are requested alongside full content; materialization\n *             runs for comparison only, the generated content is persisted\n *             unchanged (zero behavior change), agreement telemetry logged.\n * - \"on\":     materialized frame+span content is persisted; per-fact fail-open\n *             to the generated content (the frame) on any validation failure.\n *\n * Validation (identical to the Phase A bench contract):\n * - `0 <= charStart < charEnd <= turn.text.length`, end-exclusive, integers;\n * - slice length <= 400 chars and non-whitespace;\n * - frame 1..15 words;\n * - the turn text's stamp (sha256 + length of the exact in-memory string the\n *   model saw) must verify — offset drift is rejected, never guessed around.\n */\n\nimport { log } from \"./logger.js\";\nimport { stampSpanSource, verifySpanSource, type SpanSourceStamp } from \"./extraction-span-source-hash.js\";\nimport { validateSpanOffsets } from \"./extraction-span-validate.js\";\nimport { sliceSpanText } from \"./extraction-span-slice.js\";\nimport type { ExtractionResult } from \"./types.js\";\nimport type { ExtractedFactSpanRef } from \"./extraction-span-config.js\";\n\nexport const SPAN_MAX_SLICE_CHARS = 400;\nexport const SPAN_MAX_FRAME_WORDS = 15;\n\nexport type SpanMode = \"off\" | \"shadow\" | \"on\";\n\n/** A source turn exactly as rendered into the extraction prompt. */\nexport interface SpanMaterializeTurn {\n  text: string;\n  stamp: SpanSourceStamp;\n}\n\nexport interface SpanMaterializeFact {\n  content: string;\n  span?: ExtractedFactSpanRef | null;\n  quote?: string;\n}\n\nexport interface SpanMaterializeTelemetry {\n  /** Facts that carried a span ref. */\n  attempts: number;\n  /** Spans that failed validation and fell back to generated content. */\n  fallbacks: number;\n  /** Shadow mode only: comparisons made / exact-or-containment agreements. */\n  shadowComparisons: number;\n  shadowAgreements: number;\n}\n\n/** Strip span refs from facts that were never given the span prompt\n * (e.g. the proactive second pass). Untrusted: never validated, never used.\n * The key is omitted entirely so no `span: undefined` reaches persistence. */\nexport function stripUntrustedFactSpans<T extends { span?: unknown }>(facts: readonly T[]): T[] {\n  return facts.map((fact) => {\n    if (fact.span === undefined || fact.span === null) return fact;\n    const { span: _span, ...rest } = fact;\n    return rest as T;\n  });\n}\n\nexport function buildSpanMaterializeTurns(texts: readonly string[]): SpanMaterializeTurn[] {\n  return texts.map((text) => ({ text, stamp: stampSpanSource(text) }));\n}\n\nexport function truncateLocalExtractionConversation(\n  conversation: string,\n  maxConversationChars: number,\n): string {\n  return conversation.length > maxConversationChars\n    ? `${conversation.slice(0, maxConversationChars)}\\n\\n[truncated]`\n    : conversation;\n}\n\nexport function bindLocalExtractionPrompt(\n  conversation: string,\n  turns: readonly { role: string; content: string; extractionContextOnly?: boolean }[],\n  maxConversationChars: number,\n  renderedConversation: string = conversation,\n): { promptConversation: string; spanTurns: SpanMaterializeTurn[] } {\n  const promptConversation = truncateLocalExtractionConversation(conversation, maxConversationChars);\n  if (conversation.length <= maxConversationChars || !conversation.endsWith(renderedConversation)) {\n    return { promptConversation, spanTurns: buildSpanMaterializeTurns(turns.map((turn) => turn.content)) };\n  }\n  const renderedStart = conversation.length - renderedConversation.length;\n  const limit = maxConversationChars;\n  const texts: string[] = [];\n  let pos = 0;\n  for (let index = 0; index < turns.length; index += 1) {\n    const turn = turns[index];\n    if (turn === undefined) {\n      texts.push(\"\");\n      continue;\n    }\n    if (index > 0) pos += 2;\n    const label = turn.extractionContextOnly === true ? `context ${turn.role}` : turn.role;\n    pos += `[${label}] `.length;\n    const absStart = renderedStart + pos;\n    const absEnd = absStart + turn.content.length;\n    texts.push(absEnd > absStart && limit > absStart ? conversation.slice(absStart, Math.min(absEnd, limit)) : \"\");\n    pos += turn.content.length;\n  }\n  return { promptConversation, spanTurns: buildSpanMaterializeTurns(texts) };\n}\n\nexport function factCarriesSpan(fact: { span?: ExtractedFactSpanRef | null }): boolean {\n  return fact.span !== undefined && fact.span !== null;\n}\n\n/**\n * Materialize one fact's span. Never throws: any validation failure falls\n * open to the fact's generated content and is counted.\n */\nexport function materializeFactSpan<T extends SpanMaterializeFact>(\n  fact: T,\n  turns: readonly SpanMaterializeTurn[],\n  mode: SpanMode,\n): { fact: T; outcome: \"span\" | \"fallback\"; materialized?: string } {\n  const span = fact.span ?? null;\n  if (span === null) {\n    return { fact, outcome: \"fallback\" };\n  }\n  const { sourceMessageIndex, charStart, charEnd, frame, sourceHash, sourceLength } = span;\n  const turn = turns[sourceMessageIndex];\n  if (\n    !Number.isInteger(sourceMessageIndex) ||\n    sourceMessageIndex < 0 ||\n    sourceMessageIndex >= turns.length ||\n    turn === undefined\n  ) {\n    return { fact: stripSpan(fact), outcome: \"fallback\" };\n  }\n  const stampCheck = verifySpanSource(turn.text, turn.stamp);\n  if (!stampCheck.ok) {\n    return { fact: stripSpan(fact), outcome: \"fallback\" };\n  }\n  if (\n    (sourceHash !== undefined && sourceHash !== turn.stamp.hash) ||\n    (sourceLength !== undefined && sourceLength !== turn.stamp.length)\n  ) {\n    return { fact: stripSpan(fact), outcome: \"fallback\" };\n  }\n  const offsetCheck = validateSpanOffsets({ start: charStart, end: charEnd, textLength: turn.text.length });\n  if (!offsetCheck.ok) {\n    return { fact: stripSpan(fact), outcome: \"fallback\" };\n  }\n  const slice = sliceSpanText({ text: turn.text, start: charStart, end: charEnd });\n  if (slice.length > SPAN_MAX_SLICE_CHARS || slice.trim().length === 0) {\n    return { fact: stripSpan(fact), outcome: \"fallback\" };\n  }\n  const frameWords = frame.trim().split(/\\s+/).filter(Boolean);\n  if (frameWords.length === 0 || frameWords.length > SPAN_MAX_FRAME_WORDS) {\n    return { fact: stripSpan(fact), outcome: \"fallback\" };\n  }\n\n  const trimmedFrame = frameWords.join(\" \");\n  const materialized = /[:—-]$/.test(trimmedFrame)\n    ? `${trimmedFrame} ${slice}`\n    : `${trimmedFrame}: ${slice}`;\n\n  if (mode === \"on\") {\n    return {\n      fact: { ...stripSpan(fact), content: materialized, quote: slice },\n      outcome: \"span\",\n      materialized,\n    };\n  }\n  // shadow: persist generated content unchanged; materialize for comparison.\n  return { fact: stripSpan(fact), outcome: \"span\", materialized };\n}\n\n/** Shadow agreement: exact match or containment either way. */\nexport function spanAgreesWithContent(materialized: string, content: string): boolean {\n  const left = materialized.trim();\n  const right = content.trim();\n  return left === right || left.includes(right) || right.includes(left);\n}\n\n/**\n * Whole-result span materialization pass (issue #2333 Phase B). Called from\n * `ExtractionEngine.applySpanMaterialization` after parse, before sanitize /\n * grounding / judge / dedup / persist. \"off\" strips stray spans untrusted.\n * Shadow logs agreement telemetry and persists generated content. \"on\"\n * persists materialized frame+span content; facts that omit the optional\n * span are dropped so a short frame cannot persist as a standalone memory.\n */\nexport function applyExtractionSpanMaterialization(\n  result: ExtractionResult,\n  turns: readonly SpanMaterializeTurn[],\n  mode: SpanMode,\n): ExtractionResult {\n  if (mode === \"off\") {\n    return { ...result, facts: stripUntrustedFactSpans(result.facts) };\n  }\n  let attempts = 0;\n  let fallbacks = 0;\n  let agreements = 0;\n  const facts = result.facts.flatMap((fact) => {\n    if (!factCarriesSpan(fact)) {\n      return mode === \"on\" ? [] : [fact];\n    }\n    attempts += 1;\n    const { fact: materialized, outcome, materialized: text } = materializeFactSpan(\n      fact,\n      turns,\n      mode,\n    );\n    if (outcome === \"fallback\") {\n      fallbacks += 1;\n    } else if (mode === \"shadow\" && text !== undefined) {\n      if (spanAgreesWithContent(text, fact.content)) {\n        agreements += 1;\n      }\n    }\n    return [materialized];\n  });\n  if (mode === \"shadow\") {\n    log.info(\n      `extraction span-mode shadow: ${agreements}/${attempts} span facts agree with generated content (${fallbacks} span validation fallbacks)`,\n    );\n  } else if (fallbacks > 0) {\n    log.info(\n      `extraction span-mode: ${fallbacks}/${attempts} span facts fell back to generated content`,\n    );\n  }\n  return { ...result, facts };\n}\n\nfunction stripSpan<T extends SpanMaterializeFact>(fact: T): T {\n  const { span: _span, ...rest } = fact;\n  return rest as T;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-EEBQFG5E.js → chunk-3YMDY3ZF.js}

@@ -3,7 +3,7 @@ import {
   readNamespaceMaintenanceLastRanStatuses,
   readNamespaceMaintenanceStatuses,
   runNamespaceMaintenancePlan
-} from "./chunk-ZBEGS7OB.js";
+} from "./chunk-JPKZTCWZ.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -14,7 +14,7 @@ import {
 } from "./chunk-CMTINOFS.js";
 import {
   summarizeCorpusAndReplica
-} from "./chunk-L2WQVSKP.js";
+} from "./chunk-G5MO3VQA.js";
 import {
   readJudgeVerdictStats
 } from "./chunk-OZKOPQCM.js";
@@ -38,23 +38,23 @@ import {
 } from "./chunk-YBPYIAA5.js";
 import {
   parseConfig
-} from "./chunk-DVOBLPSQ.js";
+} from "./chunk-D2DIYEFW.js";
 import {
   readAggregateExtractionWatermark
-} from "./chunk-UDZYNIDJ.js";
+} from "./chunk-4WGAMREC.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-HUT2JR6I.js";
+} from "./chunk-L5OXE4PX.js";
 import {
   listNamespaces
-} from "./chunk-BJETIR53.js";
+} from "./chunk-WS3WNLST.js";
 import {
   analyzeGraphHealth
-} from "./chunk-5FAGCOZD.js";
+} from "./chunk-GWK7FEUL.js";
 import {
   StorageManager
-} from "./chunk-5VAF4ID4.js";
+} from "./chunk-ZEPVWLCN.js";
 import {
   lintWorkspaceFiles
 } from "./chunk-DM2T26WE.js";
@@ -1069,7 +1069,7 @@ async function summarizeBufferSurpriseDistribution(storage, config) {
   }
 }
 async function summarizeGraphEdgeDecayStatus(config) {
-  const { readGraphEdgeDecayStatus } = await import("./graph-edge-decay-MKIRZ762.js");
+  const { readGraphEdgeDecayStatus } = await import("./graph-edge-decay-ROSUPDX3.js");
   const { graphEdgeDecayEnabled } = config;
   const enabled = graphEdgeDecayEnabled === true;
   if (!enabled) {
@@ -1683,4 +1683,4 @@ export {
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-EEBQFG5E.js.map
+//# sourceMappingURL=chunk-3YMDY3ZF.js.map

package/dist/{chunk-5JG5EBVL.js → chunk-4DPDIOVA.js}

@@ -1,6 +1,6 @@
 import {
   isRecallDisclosure
-} from "./chunk-4MDKNUV4.js";
+} from "./chunk-RN3MVLW3.js";
 import {
   estimateTokenCount
 } from "./chunk-TOTT6S2V.js";
@@ -306,4 +306,4 @@ export {
   RecallXrayBuilder,
   summarizeDisclosureTokens
 };
-//# sourceMappingURL=chunk-5JG5EBVL.js.map
+//# sourceMappingURL=chunk-4DPDIOVA.js.map

package/dist/{chunk-UDZYNIDJ.js → chunk-4WGAMREC.js}

@@ -1,6 +1,6 @@
 import {
   resolveCorpusNamespaceRoots
-} from "./chunk-ECKG5WSI.js";
+} from "./chunk-JZYECQWN.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-MZWSOLMT.js";
@@ -200,4 +200,4 @@ async function readAggregateExtractionWatermark(options) {
 export {
   readAggregateExtractionWatermark
 };
-//# sourceMappingURL=chunk-UDZYNIDJ.js.map
+//# sourceMappingURL=chunk-4WGAMREC.js.map

package/dist/{chunk-HXSAWV3A.js → chunk-57GDHV2D.js}

@@ -1,9 +1,9 @@
 import {
   resolveDefaultNamespaceRoot
-} from "./chunk-RUXPVSML.js";
+} from "./chunk-2AR5JFD7.js";
 import {
   StorageManager
-} from "./chunk-5VAF4ID4.js";
+} from "./chunk-ZEPVWLCN.js";
 import {
   composeLocationDayBody,
   composeLocationDayMeta,
@@ -728,4 +728,4 @@ export {
   runLocationBackfill,
   runLocationCliCommand
 };
-//# sourceMappingURL=chunk-HXSAWV3A.js.map
+//# sourceMappingURL=chunk-57GDHV2D.js.map

package/dist/{chunk-Z7ACR6MJ.js → chunk-5LLQAUMI.js}

@@ -1,7 +1,7 @@
 import {
   SUPPORT_PASSPORT_DRAFT_MAX_CONTENT_CHARACTERS,
   SUPPORT_PASSPORT_DRAFT_MAX_MEMORIES
-} from "./chunk-JHZCXUQI.js";
+} from "./chunk-JLXWRQNR.js";
 import {
   SUPPORT_PASSPORT_SOURCE_MEMORY_ID_MAX_LENGTH
 } from "./chunk-PWPIERBM.js";
@@ -343,4 +343,4 @@ export {
   parseSupportPassportModelJob,
   SupportPassportModelBridge
 };
-//# sourceMappingURL=chunk-Z7ACR6MJ.js.map
+//# sourceMappingURL=chunk-5LLQAUMI.js.map

package/dist/{chunk-P3ONDDIJ.js → chunk-5SYI2F47.js}

@@ -1,6 +1,6 @@
 import {
   isNamespaceKind
-} from "./chunk-VYXDUPYE.js";
+} from "./chunk-Q7JK6YEB.js";
 import {
   EngramAccessInputError
 } from "./chunk-2Z24E5W2.js";
@@ -40,4 +40,4 @@ export {
   positiveIntQueryParam,
   optionalNamespaceKindQueryParam
 };
-//# sourceMappingURL=chunk-P3ONDDIJ.js.map
+//# sourceMappingURL=chunk-5SYI2F47.js.map

package/dist/{chunk-DGS34QSY.js → chunk-6E5GYDIE.js}

@@ -1,7 +1,7 @@
 import {
   graphFilePath,
   readEdgesStrict
-} from "./chunk-5FAGCOZD.js";
+} from "./chunk-GWK7FEUL.js";
 import {
   assertGraphLockHeld,
   withGraphWriteLock,
@@ -138,4 +138,4 @@ export {
   restoreRemovedNodeEdges,
   rollbackNodeEdgeRewrite
 };
-//# sourceMappingURL=chunk-DGS34QSY.js.map
+//# sourceMappingURL=chunk-6E5GYDIE.js.map

package/dist/{chunk-J7PB5UQ4.js → chunk-6Z3WW2MW.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-5VAF4ID4.js";
+} from "./chunk-ZEPVWLCN.js";
 import {
   composeMemoryEnvelope
 } from "./chunk-LSLCFCCQ.js";
@@ -546,4 +546,4 @@ export {
   setSemanticRulePromotionTestHooks,
   promoteSemanticRuleFromMemory
 };
-//# sourceMappingURL=chunk-J7PB5UQ4.js.map
+//# sourceMappingURL=chunk-6Z3WW2MW.js.map

package/dist/{chunk-GLZH5VEN.js → chunk-76DRU7C4.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-5VAF4ID4.js";
+} from "./chunk-ZEPVWLCN.js";
 import {
   getCachedRuleMemories,
   setCachedRuleMemories
@@ -119,4 +119,4 @@ export {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
 };
-//# sourceMappingURL=chunk-GLZH5VEN.js.map
+//# sourceMappingURL=chunk-76DRU7C4.js.map

package/dist/{chunk-L2QLDZJC.js → chunk-7MJBKZPU.js}

@@ -1,6 +1,6 @@
 import {
   isValidCapsuleSince
-} from "./chunk-KQAFEZQX.js";
+} from "./chunk-VDX2J7OX.js";
 import {
   CAPSULE_ID_PATTERN
 } from "./chunk-WEHSQBFR.js";
@@ -521,4 +521,4 @@ export {
   actionConfidenceRequestSchema,
   validateRequest
 };
-//# sourceMappingURL=chunk-L2QLDZJC.js.map
+//# sourceMappingURL=chunk-7MJBKZPU.js.map

package/dist/{chunk-Y63ZFP4X.js → chunk-7RKBPXY6.js}

@@ -1,6 +1,6 @@
 import {
   createSearchBackend
-} from "./chunk-JRWW7GM6.js";
+} from "./chunk-Q6D7EUSQ.js";
 import {
   namespaceIdentityToken,
   normalizeNamespaceIdentity
@@ -470,4 +470,4 @@ export {
   NamespaceSearchRouter,
   normalizeQmdResultPath
 };
-//# sourceMappingURL=chunk-Y63ZFP4X.js.map
+//# sourceMappingURL=chunk-7RKBPXY6.js.map

package/dist/chunk-A6CXG5WI.js

@@ -0,0 +1,51 @@
+// src/extraction-span-source-hash.ts
+import { createHash } from "crypto";
+var HASH_PATTERN = /^[0-9a-f]{64}$/;
+function requireText(text) {
+  if (typeof text !== "string") {
+    throw new TypeError(`text must be a string, got ${typeof text}`);
+  }
+}
+function requireStamp(expected) {
+  if (!Object.hasOwn(expected, "hash")) {
+    throw new RangeError("expected stamp is missing field hash");
+  }
+  if (!Object.hasOwn(expected, "length")) {
+    throw new RangeError("expected stamp is missing field length");
+  }
+  const { hash, length } = expected;
+  if (typeof hash !== "string" || !HASH_PATTERN.test(hash)) {
+    throw new RangeError(
+      "expected stamp field hash must be 64 lowercase hex characters"
+    );
+  }
+  if (!Number.isInteger(length) || length < 0) {
+    throw new RangeError(
+      "expected stamp field length must be a non-negative integer"
+    );
+  }
+}
+function stampSpanSource(text) {
+  requireText(text);
+  const hash = createHash("sha256").update(Buffer.from(text, "utf16le")).digest("hex");
+  return { hash, length: text.length };
+}
+function verifySpanSource(text, expected) {
+  requireText(text);
+  requireStamp(expected);
+  const actual = stampSpanSource(text);
+  const safeExpected = { hash: expected.hash, length: expected.length };
+  if (actual.length !== safeExpected.length) {
+    return { ok: false, error: "length_mismatch", expected: safeExpected, actual };
+  }
+  if (actual.hash !== safeExpected.hash) {
+    return { ok: false, error: "hash_mismatch", expected: safeExpected, actual };
+  }
+  return { ok: true };
+}
+
+export {
+  stampSpanSource,
+  verifySpanSource
+};
+//# sourceMappingURL=chunk-A6CXG5WI.js.map

package/dist/chunk-A6CXG5WI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extraction-span-source-hash.ts"],"sourcesContent":["/**\n * Span source stamp/verify (issue #2333).\n *\n * Offsets index the exact normalized string sent to the model. If that string\n * drifts before materialization, the offsets point at different characters and\n * a wrong quote is persisted as verbatim source. The stamp lets materialization\n * detect the drift without carrying the source text alongside it.\n *\n * Pure apart from hashing: no I/O, no clock, no randomness. The input text is\n * never mutated and never appears in a result or error message.\n */\n\nimport { createHash } from \"node:crypto\";\n\nexport interface SpanSourceStamp {\n  /** Hex digest of the exact string the model was shown. */\n  hash: string;\n  /** Length of that string, so a mismatch reports which dimension drifted. */\n  length: number;\n}\n\nexport type SpanSourceCheck =\n  | { ok: true }\n  | {\n      ok: false;\n      error: \"length_mismatch\" | \"hash_mismatch\";\n      expected: SpanSourceStamp;\n      actual: SpanSourceStamp;\n    };\n\nconst HASH_PATTERN = /^[0-9a-f]{64}$/;\n\nfunction requireText(text: string): void {\n  if (typeof text !== \"string\") {\n    throw new TypeError(`text must be a string, got ${typeof text}`);\n  }\n}\n\nfunction requireStamp(expected: SpanSourceStamp): void {\n  if (!Object.hasOwn(expected, \"hash\")) {\n    throw new RangeError(\"expected stamp is missing field hash\");\n  }\n  if (!Object.hasOwn(expected, \"length\")) {\n    throw new RangeError(\"expected stamp is missing field length\");\n  }\n  const { hash, length } = expected;\n  if (typeof hash !== \"string\" || !HASH_PATTERN.test(hash)) {\n    throw new RangeError(\n      \"expected stamp field hash must be 64 lowercase hex characters\",\n    );\n  }\n  if (!Number.isInteger(length) || length < 0) {\n    throw new RangeError(\n      \"expected stamp field length must be a non-negative integer\",\n    );\n  }\n}\n\n/**\n * Hash the exact string. No trimming, no newline normalization.\n *\n * The digest covers UTF-16LE code units, not UTF-8 bytes: Node's UTF-8\n * encoder replaces an unpaired surrogate with U+FFFD before hashing, so\n * \"\\ud800\", \"\\ud801\", and \"\\ufffd\" all produce ONE digest under utf8 and\n * drift between them would verify as unchanged. Unpaired surrogates reach\n * real memory text through JSON escapes, and this stamp exists to catch\n * exactly that class of silent substitution, so it hashes a lossless\n * representation of the string instead.\n */\nexport function stampSpanSource(text: string): SpanSourceStamp {\n  requireText(text);\n  const hash = createHash(\"sha256\").update(Buffer.from(text, \"utf16le\")).digest(\"hex\");\n  return { hash, length: text.length };\n}\n\n/**\n * Verify the materialized string against its stamp. Length is compared first:\n * it is the cheaper, more diagnostic dimension. Mismatch results carry both\n * stamps and never the text itself.\n */\nexport function verifySpanSource(\n  text: string,\n  expected: SpanSourceStamp,\n): SpanSourceCheck {\n  requireText(text);\n  requireStamp(expected);\n  const actual = stampSpanSource(text);\n  // Project the caller's stamp down to exactly the two stamp fields. Echoing\n  // the original object would re-export any extra property it carries — a\n  // `source` field holding the text defeats the whole point of a stamp, which\n  // exists so the content does not have to travel.\n  const safeExpected: SpanSourceStamp = { hash: expected.hash, length: expected.length };\n  if (actual.length !== safeExpected.length) {\n    return { ok: false, error: \"length_mismatch\", expected: safeExpected, actual };\n  }\n  if (actual.hash !== safeExpected.hash) {\n    return { ok: false, error: \"hash_mismatch\", expected: safeExpected, actual };\n  }\n  return { ok: true };\n}\n"],"mappings":";AAYA,SAAS,kBAAkB;AAkB3B,IAAM,eAAe;AAErB,SAAS,YAAY,MAAoB;AACvC,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,IAAI,UAAU,8BAA8B,OAAO,IAAI,EAAE;AAAA,EACjE;AACF;AAEA,SAAS,aAAa,UAAiC;AACrD,MAAI,CAAC,OAAO,OAAO,UAAU,MAAM,GAAG;AACpC,UAAM,IAAI,WAAW,sCAAsC;AAAA,EAC7D;AACA,MAAI,CAAC,OAAO,OAAO,UAAU,QAAQ,GAAG;AACtC,UAAM,IAAI,WAAW,wCAAwC;AAAA,EAC/D;AACA,QAAM,EAAE,MAAM,OAAO,IAAI;AACzB,MAAI,OAAO,SAAS,YAAY,CAAC,aAAa,KAAK,IAAI,GAAG;AACxD,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,MAAI,CAAC,OAAO,UAAU,MAAM,KAAK,SAAS,GAAG;AAC3C,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAaO,SAAS,gBAAgB,MAA+B;AAC7D,cAAY,IAAI;AAChB,QAAM,OAAO,WAAW,QAAQ,EAAE,OAAO,OAAO,KAAK,MAAM,SAAS,CAAC,EAAE,OAAO,KAAK;AACnF,SAAO,EAAE,MAAM,QAAQ,KAAK,OAAO;AACrC;AAOO,SAAS,iBACd,MACA,UACiB;AACjB,cAAY,IAAI;AAChB,eAAa,QAAQ;AACrB,QAAM,SAAS,gBAAgB,IAAI;AAKnC,QAAM,eAAgC,EAAE,MAAM,SAAS,MAAM,QAAQ,SAAS,OAAO;AACrF,MAAI,OAAO,WAAW,aAAa,QAAQ;AACzC,WAAO,EAAE,IAAI,OAAO,OAAO,mBAAmB,UAAU,cAAc,OAAO;AAAA,EAC/E;AACA,MAAI,OAAO,SAAS,aAAa,MAAM;AACrC,WAAO,EAAE,IAAI,OAAO,OAAO,iBAAiB,UAAU,cAAc,OAAO;AAAA,EAC7E;AACA,SAAO,EAAE,IAAI,KAAK;AACpB;","names":[]}

package/dist/{chunk-JSRVXI6E.js → chunk-B2YKTE7P.js}

@@ -34,10 +34,10 @@ import {
 } from "./chunk-QVSRE355.js";
 import {
   getOperation
-} from "./chunk-JHZCXUQI.js";
+} from "./chunk-JLXWRQNR.js";
 import {
   WHO_KNOWS_MCP_TOOLS
-} from "./chunk-3FJKJ5UZ.js";
+} from "./chunk-X7BCM2NA.js";
 import {
   assertOperationAllowed,
   capabilityAllowsOp,
@@ -49,7 +49,7 @@ import {
 } from "./chunk-PWPIERBM.js";
 import {
   validateRequest
-} from "./chunk-L2QLDZJC.js";
+} from "./chunk-7MJBKZPU.js";
 import {
   PROMOTION_CANDIDATES_MCP_TOOLS
 } from "./chunk-VYCOJKSX.js";
@@ -4051,4 +4051,4 @@ export {
   MCP_MIGRATED_OPERATIONS,
   EngramMcpServer
 };
-//# sourceMappingURL=chunk-JSRVXI6E.js.map
+//# sourceMappingURL=chunk-B2YKTE7P.js.map

package/dist/{chunk-Z3O53WZR.js → chunk-BICNRVEC.js}

@@ -2,7 +2,7 @@ import {
   readCausalTrajectoryRecordsStrict,
   readCausalTrajectoryRevisionToken,
   resolveCausalTrajectoryStoreDir
-} from "./chunk-B3O3IRZN.js";
+} from "./chunk-LMMQKZK3.js";
 
 // src/coding/pre-action-gate.ts
 import { createHash } from "crypto";
@@ -221,4 +221,4 @@ export {
   normalizeActionIntent,
   PreActionFailureGate
 };
-//# sourceMappingURL=chunk-Z3O53WZR.js.map
+//# sourceMappingURL=chunk-BICNRVEC.js.map

package/dist/{chunk-BNGHPYZU.js → chunk-BLHX5FQW.js}

@@ -1,6 +1,6 @@
 import {
   OUTPUT_LANGUAGE_POLICY
-} from "./chunk-7CBKAQIG.js";
+} from "./chunk-BOADKFN4.js";
 import {
   gatewayTaskChainOptions
 } from "./chunk-YEN4TREG.js";
@@ -491,4 +491,4 @@ export {
   createVerdictCache,
   createDeferCountMap
 };
-//# sourceMappingURL=chunk-BNGHPYZU.js.map
+//# sourceMappingURL=chunk-BLHX5FQW.js.map

package/dist/{chunk-7CBKAQIG.js → chunk-BOADKFN4.js}

@@ -42,9 +42,19 @@ var EXTRACTION_RESPONSE_SHAPE = `{
   "episodeTitle": "<six-to-eight word conversation segment title>",
   "relationships": [{"source": "<normalized-name>", "target": "<normalized-name>", "label": "<source-grounded relationship>"}]
 }`;
+function extractionResponseShape(spanMode = "off") {
+  if (spanMode === "off") return EXTRACTION_RESPONSE_SHAPE;
+  return EXTRACTION_RESPONSE_SHAPE.replace(
+    `"eventTime": "<optional source temporal expression>"`,
+    `"eventTime": "<optional source temporal expression>",
+    "span": {"sourceMessageIndex": <message number>, "charStart": <number>, "charEnd": <number>, "frame": "<at most 15 words>"}`
+  );
+}
 var EXTRACTION_RESPONSE_PLACEHOLDERS = {};
-for (const placeholder of EXTRACTION_RESPONSE_SHAPE.match(/<[^<>\r\n]+>/g) ?? []) {
-  EXTRACTION_RESPONSE_PLACEHOLDERS[placeholder] = true;
+for (const shape of [EXTRACTION_RESPONSE_SHAPE, extractionResponseShape("on")]) {
+  for (const placeholder of shape.match(/<[^<>\r\n]+>/g) ?? []) {
+    EXTRACTION_RESPONSE_PLACEHOLDERS[placeholder] = true;
+  }
 }
 var CUE_ANCHOR_PROMPT_INSTRUCTION = `- For each fact, emit at most 3 "cueAnchors".
 - Each cue anchor value must be a source-grounded search hook of at most 120 characters, in the form "<main entity or topic> <key aspect>".
@@ -57,6 +67,18 @@ function eventTimePromptInstruction(config) {
   return `
 When a fact states when it became or stopped being true, copy that explicit temporal expression verbatim into "eventTime". Omit "eventTime" when no such expression appears; never infer dates.`;
 }
+function spanModePromptSection(spanMode) {
+  if (spanMode === "off") return "";
+  const requestBoth = spanMode === "shadow";
+  return `
+Span mode (numbered-message offsets):
+- Conversation messages are numbered in order starting at 0 (the "[role] text" blocks).
+- For each fact, return "span": {"sourceMessageIndex": <message number>, "charStart": <number>, "charEnd": <number>, "frame": "<at most 15 words>"} pointing at the verbatim supporting words in that message's text (the text after the "] "). Offsets are [charStart, charEnd), end-exclusive, counting from the first character of the message text.
+- "frame" is at most 15 generated words that make the span self-contained: resolve pronouns to names, name the subject (e.g., frame "Maya's relocation:" + span "moved to Seattle last spring\u2026").${requestBoth ? `
+- This run is in SHADOW mode: ALSO include the full standalone "content" restatement exactly as you would normally write it, in addition to "span".` : `
+- Set "content" to the frame text (the short \u226415-word frame) \u2014 do not restate the full fact; the span plus frame carry it.`}
+- Invalid spans fall back to the frame, so keep the frame informative.`;
+}
 function buildExtractionInstructions(config, existingEntities, ambientCapture = false) {
   const lifecycleCaps = resolveMemoryLifecycleCapabilities(config);
   return `You are a memory extraction system. Analyze the following conversation and extract durable, reusable memories.
@@ -121,7 +143,7 @@ ${existingEntities.join(", ")}
 
 When you see something that matches a known entity, use THAT name exactly. Only create a NEW entity if nothing in this list represents it.
 ` : ""}
-${eventTimePromptInstruction(config)}
+${eventTimePromptInstruction(config)}${spanModePromptSection(config.extraction?.spanMode ?? "off")}
 Also extract relationships between entities mentioned in the conversation.
 - Format: {source: "entity-name", target: "entity-name", label: "relationship description"}
 - Max 5 relationships per extraction
@@ -185,14 +207,16 @@ The output should be the COMPLETE consolidated profile as valid markdown, starti
 
 export {
   EXTRACTION_RESPONSE_SHAPE,
+  extractionResponseShape,
   EXTRACTION_RESPONSE_PLACEHOLDERS,
   CUE_ANCHOR_PROMPT_INSTRUCTION,
   OUTPUT_LANGUAGE_POLICY,
   eventTimePromptInstruction,
+  spanModePromptSection,
   buildExtractionInstructions,
   CONSOLIDATION_RESPONSE_SCHEMA,
   PROFILE_CONSOLIDATION_RESPONSE_SCHEMA,
   buildConsolidationSystemPrompt,
   buildProfileConsolidationSystemPrompt
 };
-//# sourceMappingURL=chunk-7CBKAQIG.js.map
+//# sourceMappingURL=chunk-BOADKFN4.js.map

package/dist/chunk-BOADKFN4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extraction-prompt.ts"],"sourcesContent":["/**\n * Extraction prompt construction (issue #1995 sibling extraction).\n *\n * The system prompt, its JSON response shape, and the placeholder table\n * derived from that shape are prompt DATA, not engine behavior. They live here\n * so `extraction.ts` holds the pipeline and one module owns the text every\n * extraction path — local LLM, direct client, gateway fallback — sends.\n */\n\nimport { AMBIENT_CAPTURE_PROMPT_SECTION, AMBIENT_SPECULATIVE_TIER_CLAUSE } from \"./ambient-provenance.js\";\nimport { resolveMemoryLifecycleCapabilities, resolveRecallAuxiliaryCapabilities } from \"./capabilities.js\";\nimport type { PluginConfig } from \"./types.js\";\n\nexport const EXTRACTION_RESPONSE_SHAPE = `{\n  \"facts\": [{\n    \"category\": \"<category>\",\n    \"content\": \"<source-grounded statement>\",\n    \"confidence\": 0.0,\n    \"tags\": [\"<tag>\"],\n    \"entityRef\": \"<optional normalized-name>\",\n    \"cueAnchors\": [{\"type\": \"<anchor-type>\", \"value\": \"<entity-or-topic plus key aspect>\"}],\n    \"promptedByQuestion\": \"<optional source-grounded question>\",\n    \"quote\": \"<optional exact contiguous source span>\",\n    \"scope\": \"<optional project-or-global>\",\n    \"subject\": \"<optional user-or-agent>\",\n    \"structuredAttributes\": {\"<key>\": \"<value>\"},\n    \"procedureSteps\": [{\"order\": 1, \"intent\": \"<step>\"}, {\"order\": 2, \"intent\": \"<step>\"}],\n    \"reasoningTrace\": {\n      \"steps\": [{\"order\": 1, \"description\": \"<step>\"}, {\"order\": 2, \"description\": \"<step>\"}],\n      \"finalAnswer\": \"<answer>\",\n      \"observedOutcome\": \"<optional outcome>\"\n    },\n    \"eventTime\": \"<optional source temporal expression>\"\n  }],\n  \"entities\": [{\n    \"name\": \"<normalized-name>\",\n    \"type\": \"<entity-type>\",\n    \"facts\": [\"<source-grounded statement>\"],\n    \"promptedByQuestion\": \"<optional source-grounded question>\",\n    \"structuredSections\": [{\"key\": \"<section-key>\", \"title\": \"<section-title>\", \"facts\": [\"<source-grounded statement>\"]}]\n  }],\n  \"profileUpdates\": [\"<source-grounded profile update>\"],\n  \"questions\": [{\"question\": \"<source-grounded unresolved question>\", \"context\": \"<source-grounded context>\", \"priority\": 0.0}],\n  \"identityReflection\": \"<conversation-grounded agent reflection>\",\n  \"episodeTitle\": \"<six-to-eight word conversation segment title>\",\n  \"relationships\": [{\"source\": \"<normalized-name>\", \"target\": \"<normalized-name>\", \"label\": \"<source-grounded relationship>\"}]\n}`;\nexport function extractionResponseShape(spanMode: \"off\" | \"shadow\" | \"on\" = \"off\"): string {\n  if (spanMode === \"off\") return EXTRACTION_RESPONSE_SHAPE;\n  return EXTRACTION_RESPONSE_SHAPE.replace(\n    `\"eventTime\": \"<optional source temporal expression>\"`,\n    `\"eventTime\": \"<optional source temporal expression>\",\n    \"span\": {\"sourceMessageIndex\": <message number>, \"charStart\": <number>, \"charEnd\": <number>, \"frame\": \"<at most 15 words>\"}`,\n  );\n}\nexport const EXTRACTION_RESPONSE_PLACEHOLDERS: Record<string, true> = {};\nfor (const shape of [EXTRACTION_RESPONSE_SHAPE, extractionResponseShape(\"on\")]) {\n  for (const placeholder of shape.match(/<[^<>\\r\\n]+>/g) ?? []) {\n    EXTRACTION_RESPONSE_PLACEHOLDERS[placeholder] = true;\n  }\n}\nexport const CUE_ANCHOR_PROMPT_INSTRUCTION = `- For each fact, emit at most 3 \"cueAnchors\".\n- Each cue anchor value must be a source-grounded search hook of at most 120 characters, in the form \"<main entity or topic> <key aspect>\".\n- Set each cue anchor type to entity, file, tool, outcome, constraint, or date.\n- Omit cue anchors when the conversation does not support a useful search hook.\n- Example: \"Alice booked Bistro Max for Mike's surprise party\" can use {\"type\":\"entity\",\"value\":\"Mike surprise party\"} and {\"type\":\"entity\",\"value\":\"Alice restaurant booking\"}.`;\n\n/**\n * Output-language policy (issue #2190). Every prompt that produces memory\n * content embeds this verbatim so non-English conversations are not silently\n * translated to English — translated memories fail later lexical recall.\n */\nexport const OUTPUT_LANGUAGE_POLICY = `Output language: write facts, profile updates, entity names and aliases, tags, questions, and any rewritten or merged memory content in the source language of the conversation or input memories. Never translate into English or another language unless the user explicitly asked for a translation.`;\n\n/**\n * Bi-temporal event-time extraction instruction (#1578 PR2). Emitted on\n * every extraction entry path when `temporal.biTemporal` is on so the LLM\n * emits an optional per-fact `eventTime` expression. The expression is\n * resolved against the source turn timestamp at write time — never\n * wall-clock — so replay/import of old transcripts anchors correctly.\n * Returns an empty string when the gate is off (byte-identical prompt).\n */\nexport function eventTimePromptInstruction(config: PluginConfig): string {\n  if (!config.temporalBiTemporal) return \"\";\n  return `\nWhen a fact states when it became or stopped being true, copy that explicit temporal expression verbatim into \"eventTime\". Omit \"eventTime\" when no such expression appears; never infer dates.`;\n}\n\n/**\n * Span-mode extraction instructions (issue #2333 Phase B). Empty when the\n * mode is off (byte-identical prompt). The offset convention mirrors the\n * Phase A bench: messages numbered in order from 0, offsets index the\n * message's own text (after the `[role] ` tag), [charStart, charEnd)\n * end-exclusive.\n */\nexport function spanModePromptSection(spanMode: \"off\" | \"shadow\" | \"on\"): string {\n  if (spanMode === \"off\") return \"\";\n  const requestBoth = spanMode === \"shadow\";\n  return `\nSpan mode (numbered-message offsets):\n- Conversation messages are numbered in order starting at 0 (the \"[role] text\" blocks).\n- For each fact, return \"span\": {\"sourceMessageIndex\": <message number>, \"charStart\": <number>, \"charEnd\": <number>, \"frame\": \"<at most 15 words>\"} pointing at the verbatim supporting words in that message's text (the text after the \"] \"). Offsets are [charStart, charEnd), end-exclusive, counting from the first character of the message text.\n- \"frame\" is at most 15 generated words that make the span self-contained: resolve pronouns to names, name the subject (e.g., frame \"Maya's relocation:\" + span \"moved to Seattle last spring…\").${\n    requestBoth\n      ? `\n- This run is in SHADOW mode: ALSO include the full standalone \"content\" restatement exactly as you would normally write it, in addition to \"span\".`\n      : `\n- Set \"content\" to the frame text (the short ≤15-word frame) — do not restate the full fact; the span plus frame carry it.`\n  }\n- Invalid spans fall back to the frame, so keep the frame informative.`;\n}\n\n/**\n * Build extraction instructions shared between local and cloud LLM.\n *\n * `ambientCapture` marks input from an always-on recorder, which may carry\n * speech the user never authored (issue #2294).\n */\nexport function buildExtractionInstructions(\n  config: PluginConfig,\n  existingEntities?: string[],\n  ambientCapture = false\n): string {\n  const lifecycleCaps = resolveMemoryLifecycleCapabilities(config);\n  return `You are a memory extraction system. Analyze the following conversation and extract durable, reusable memories.\n\nMemory categories:\n- fact: Objective information about the world\n- preference: User likes, dislikes, or stylistic choices\n- correction: User correcting a mistake or misconception (highest priority)\n- entity: Information about a specific person, project, tool, or company\n- decision: A choice that was made with rationale\n- relationship: How two entities relate to each other (e.g., \"Alice is Bob's manager\", \"Acme Corp uses Shopify\")\n- principle: Durable rules, values, or operating beliefs (e.g., \"never use Chat Completions API\")\n- commitment: Promises, obligations, or deadlines (e.g., \"deploy by Friday\", \"call accountant Monday\")\n- moment: Emotionally significant events or milestones (e.g., \"first successful deployment of engram\")\n- skill: Capabilities the user or agent has demonstrated (e.g., \"user is proficient with Kubernetes\")${\n    resolveRecallAuxiliaryCapabilities(config).causalRuleExtraction\n      ? `\n- rule: Causal rules discovered through experience (format: \"IF <condition> THEN <action/outcome>\", e.g., \"IF Shopify API returns 401 THEN the admin token is missing read_products scope\")`\n      : \"\"\n  }\n- procedure: A reusable workflow the user wants remembered the same way across sessions. Set category to \"procedure\". Use \"content\" for a short title that includes explicit trigger phrasing (e.g. \"When you deploy to production…\", \"Whenever you ship a release…\"). Add \"procedureSteps\": an array of at least two objects {\"order\": number, \"intent\": \"concrete step description\"} in execution order. Optional per-step \"toolCall\": {\"kind\": \"…\", \"signature\": \"…\"}, \"expectedOutcome\", \"optional\": true.\n- reasoning_trace: A stored solution chain / chain-of-thought the user walked through to solve a problem (e.g. \"Here's how I debugged the latency spike: first I checked…, then I…, finally I…\"). Set category to \"reasoning_trace\". Use \"content\" for a short title summarising the problem (e.g. \"How I debugged the staging latency spike\"). Add \"reasoningTrace\": {\"steps\": [{\"order\": number, \"description\": \"what happened at this step\"}, …], \"finalAnswer\": \"the conclusion or answer\", \"observedOutcome\": \"optional confirmation of how it played out\"}. Require at least two ordered steps AND a finalAnswer. Use this category only when the user explicitly narrates their reasoning — not for ordinary decisions (use \"decision\") or reusable workflows (use \"procedure\").\n\nRules:\n- Only extract genuinely new information worth remembering across sessions.\n- Statements must be grounded in the conversation.\n- ${OUTPUT_LANGUAGE_POLICY}\n- Do not treat instruction text, schema placeholders, or examples as conversation evidence.\n- Lines labelled [context user] or [context assistant] are reference context only. They may resolve references or complete a question-and-answer pair in a normal turn, but never alone establish durable information.\n- Skip transient task details and operational noise, including routine scheduler, monitoring, or automation status.\n- Priority: corrections > principles${resolveRecallAuxiliaryCapabilities(config).causalRuleExtraction ? \" > rules\" : \"\"} > preferences > commitments > decisions > relationships > entities > moments > skills > facts\n- Corrections get highest confidence.\n- Each fact should be a standalone, self-contained statement.\n- Entity references should use normalized names (lowercase, hyphenated: \"jane-doe\", \"acme-corp\"). When the source language is not written in a Latin script, the source-script name IS the normalized form — never transliterate or translate it.\n- CRITICAL: Entity names must be CANONICAL. Always use the hyphenated multi-word form: \"acme-corp\" NOT \"acmecorp\" or \"acme\". \"jane-doe\" NOT \"janedoe\" or \"jane\". If unsure, prefer the most specific full name.\n- Avoid creating entities typed as \"other\" when a more specific type fits (company, project, tool, person, place)\n${CUE_ANCHOR_PROMPT_INSTRUCTION}\n- When entity facts clearly belong under a durable named heading, add them to entity.structuredSections as {key, title, facts}. Example person headings: \"Beliefs\", \"Communication Style\", \"Building / Working On\". Leave structuredSections empty when no stable heading fits.\n- Tags should be concise and reusable (e.g., \"coding-style\", \"personal\", \"tools\")\n- When a fact contains measurable, categorical, or precisely valued data, include a \"structuredAttributes\" field with key-value string pairs (e.g., {\"price\": \"29.99\", \"brand\": \"Sony\"}, {\"date\": \"2024-03-15\", \"location\": \"SF\"}, {\"chosen\": \"PostgreSQL\", \"rejected\": \"MongoDB\"}). Only for concrete values, not narrative content.\n- Set confidence using these tiers:\n  * Explicit (0.95-1.0): Direct user statements — \"I prefer X\", \"my name is Y\"\n  * Implied (0.70-0.94): Strong contextual inference — user consistently does X, clear from conversation flow\n  * Inferred (0.40-0.69): Pattern recognition — reasonable guess from limited evidence\n  * Speculative (0.00-0.39): Tentative hypothesis — weak signal, needs future confirmation. Speculative memories auto-expire after 30 days if not confirmed.${ambientCapture ? AMBIENT_SPECULATIVE_TIER_CLAUSE : \"\"}${\n    config.provenance?.enabled\n      ? `\n- Source quotes: For each fact, include a \"quote\" field containing the EXACT verbatim words from the conversation that support the fact. Copy a contiguous span from a single speaker turn (not a paraphrase, not a summary). Cap at ~300 characters. This grounds every memory in the literal utterance that created it.`\n      : \"\"\n  }\n- For commitments: include any deadline or timeframe mentioned${\n    lifecycleCaps.extractionScopeClassification\n      ? `\n\nScope classification:\nFor each fact, set \"scope\" to one of:\n- \"global\" — knowledge that applies across projects: core framework/library bugs, API behavior patterns, user preferences (editor, language, style), general coding patterns, infrastructure knowledge, technology facts not tied to one codebase\n- \"project\" — knowledge specific to one codebase: file paths, environment configs, deployment details, project-specific workarounds, team/stakeholder info tied to one project, repo-specific conventions. Tool, command, or CLI-flag instructions TIED TO ONE AGENT are also \"project\", because the same tool name means different things in different agent integrations (a \"search\" tool may search repository code in one agent and the web in another); when keeping such an agent-tied instruction, the fact text MUST name the originating agent as a leading \"In <agent>,\" clause (e.g. \"In Pi, use the search tool with a repository path.\"). A tool/command fact that holds in every agent and every repo is NOT agent-tied — leave it \"global\" and do not add a qualifier (e.g. \"\\`git status --short\\` emits compact output\"). Examples: \"In Pi, the search tool takes a repository path\" -> \"project\"; \"\\`git status --short\\` emits compact output\" -> \"global\".\nWhen in doubt, prefer \"project\" — it is safer to keep knowledge scoped narrowly.`\n      : \"\"\n  }\n${\n  ambientCapture\n    ? `${AMBIENT_CAPTURE_PROMPT_SECTION}\n`\n    : \"\"\n}\nEntity creation rules (STRICT):\n- Only create entities for DURABLE things: real people, companies, products, tools, ongoing projects\n- NEVER create entities for transient items: individual PRs, branches, Jira tickets, meetings, agent task IDs, log files, database tables, cron job runs, sessions\n- When you learn something about a transient item (e.g., PR #58 fixed a bug), store it as a FACT with an entityRef to the parent project — do NOT create an entity for the PR itself\n- Prefer attaching facts to broad parent entities rather than creating sub-entities. E.g., \"acme-store uses Algolia for search\" is a fact on entity \"acme-store\", NOT a new entity \"acme-store-algolia-connector\"\n- The entity list should be SHORT — think \"things that would have their own Wikipedia page\" not \"things mentioned in passing\"\n\n${\n  existingEntities && existingEntities.length > 0\n    ? `\nKNOWN ENTITIES (use these exact names when referencing existing things):\n${existingEntities.join(\", \")}\n\nWhen you see something that matches a known entity, use THAT name exactly. Only create a NEW entity if nothing in this list represents it.\n`\n    : \"\"\n}\n${eventTimePromptInstruction(config)}${spanModePromptSection(config.extraction?.spanMode ?? \"off\")}\nAlso extract relationships between entities mentioned in the conversation.\n- Format: {source: \"entity-name\", target: \"entity-name\", label: \"relationship description\"}\n- Max 5 relationships per extraction\n- Only include clear, durable relationships (e.g., \"works at\", \"created\", \"manages\", \"uses\")\n- Use normalized entity names (e.g., \"person-jane-doe\", \"company-acme-corp\")\n\n\nAlso emit \"episodeTitle\" as a six-to-eight word title for this conversation segment.\nQuestions are optional. Include only source-grounded unresolved questions that would be useful in future sessions; otherwise return an empty array.\n\nFinally, write a brief identity reflection about the agent who had this conversation, based only on the conversation. Do not write about the extraction process.`;\n}\n\nexport const CONSOLIDATION_RESPONSE_SCHEMA = `{\n  \"items\": [\n    {\n      \"existingId\": \"id\",\n      \"action\": \"ADD\",\n      \"mergeWith\": \"optional-existing-id\",\n      \"updatedContent\": \"optional replacement content\",\n      \"reason\": \"brief reason for this action\"\n    }\n  ],\n  \"profileUpdates\": [\"optional profile update\"],\n  \"entityUpdates\": [{\"name\": \"person-jane-doe\", \"type\": \"person\", \"facts\": [\"Now leads the backend team\", \"Recently migrated the user service to TypeScript\"]}]\n}`;\n\nexport const PROFILE_CONSOLIDATION_RESPONSE_SCHEMA = `{\n  \"consolidatedProfile\": \"# Behavioral Profile\\\\n\\\\n... (complete markdown)\",\n  \"removedCount\": 42,\n  \"summary\": \"brief summary of what was consolidated\"\n}`;\n\n/**\n * System prompt shared by every consolidation path (gateway, direct client,\n * local LLM). Owns the causal-rule clause and the output-language policy so\n * the three paths cannot drift (issue #2190).\n */\nexport function buildConsolidationSystemPrompt(config: PluginConfig): string {\n  return `You are a memory consolidation system. Compare new memories against existing ones and decide what to do with each.\n\nActions:\n- ADD: Keep the new memory as-is (no duplicate exists)\n- MERGE: Combine with an existing memory (provide mergeWith ID and updated content)\n- UPDATE: Replace existing memory content (provide updated content)\n- INVALIDATE: Remove existing memory (it's been superseded or is wrong)\n- SKIP: This new memory is redundant (exact duplicate or subset of existing)\n\nAlso:\n- Suggest profile updates based on patterns across memories\n- Identify entity updates for entity tracking${resolveRecallAuxiliaryCapabilities(config).causalRuleExtraction ? `\n- When merging or updating memories, look for IF→THEN causal patterns. If a memory describes \"X failed/succeeded because Y\" or \"doing X led to Y\", rewrite its content to make the causal rule explicit in the form \"IF <condition> THEN <action/outcome>\".` : \"\"}\n- ${OUTPUT_LANGUAGE_POLICY}`;\n}\n\n/**\n * System prompt shared by every profile-consolidation path (gateway, direct\n * client, local LLM). Owns the output-language policy (issue #2190).\n */\nexport function buildProfileConsolidationSystemPrompt(targetLines: number): string {\n  return `You are a profile consolidation system. You are given a behavioral profile (markdown) that has grown too large. Your job is to produce a CONSOLIDATED version that:\n\n1. PRESERVES all ## section headers and their structure\n2. MERGES duplicate or near-duplicate bullet points into single, clear statements\n3. REMOVES stale information that has been superseded by newer bullets\n4. REMOVES trivial or overly specific operational details that won't be useful across sessions\n5. KEEPS the most important, durable observations about the user's preferences, habits, identity, and working style\n6. Target roughly ${targetLines} lines — this is a soft target, prioritize quality over length\n7. Write in the same style as the existing profile — concise bullets, no fluff\n8. ${OUTPUT_LANGUAGE_POLICY}\n\nThe output should be the COMPLETE consolidated profile as valid markdown, starting with \"# Behavioral Profile\".`;\n}\n"],"mappings":";;;;;;;;;;AAaO,IAAM,4BAA4B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkClC,SAAS,wBAAwB,WAAoC,OAAe;AACzF,MAAI,aAAa,MAAO,QAAO;AAC/B,SAAO,0BAA0B;AAAA,IAC/B;AAAA,IACA;AAAA;AAAA,EAEF;AACF;AACO,IAAM,mCAAyD,CAAC;AACvE,WAAW,SAAS,CAAC,2BAA2B,wBAAwB,IAAI,CAAC,GAAG;AAC9E,aAAW,eAAe,MAAM,MAAM,eAAe,KAAK,CAAC,GAAG;AAC5D,qCAAiC,WAAW,IAAI;AAAA,EAClD;AACF;AACO,IAAM,gCAAgC;AAAA;AAAA;AAAA;AAAA;AAWtC,IAAM,yBAAyB;AAU/B,SAAS,2BAA2B,QAA8B;AACvE,MAAI,CAAC,OAAO,mBAAoB,QAAO;AACvC,SAAO;AAAA;AAET;AASO,SAAS,sBAAsB,UAA2C;AAC/E,MAAI,aAAa,MAAO,QAAO;AAC/B,QAAM,cAAc,aAAa;AACjC,SAAO;AAAA;AAAA;AAAA;AAAA,wMAKL,cACI;AAAA,uJAEA;AAAA,qIAEN;AAAA;AAEF;AAQO,SAAS,4BACd,QACA,kBACA,iBAAiB,OACT;AACR,QAAM,gBAAgB,mCAAmC,MAAM;AAC/D,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uGAaL,mCAAmC,MAAM,EAAE,uBACvC;AAAA,+LAEA,EACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOE,sBAAsB;AAAA;AAAA;AAAA;AAAA,sCAIY,mCAAmC,MAAM,EAAE,uBAAuB,aAAa,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMrH,6BAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mKAQ+H,iBAAiB,kCAAkC,EAAE,GAC/M,OAAO,YAAY,UACf;AAAA,6TAEA,EACN;AAAA,gEAEE,cAAc,gCACV;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yFAOA,EACN;AAAA,EAEA,iBACI,GAAG,8BAA8B;AAAA,IAEjC,EACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASE,oBAAoB,iBAAiB,SAAS,IAC1C;AAAA;AAAA,EAEJ,iBAAiB,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA,IAIvB,EACN;AAAA,EACE,2BAA2B,MAAM,CAAC,GAAG,sBAAsB,OAAO,YAAY,YAAY,KAAK,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYlG;AAEO,IAAM,gCAAgC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AActC,IAAM,wCAAwC;AAAA;AAAA;AAAA;AAAA;AAW9C,SAAS,+BAA+B,QAA8B;AAC3E,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+CAWsC,mCAAmC,MAAM,EAAE,uBAAuB;AAAA,oQAC8I,EAAE;AAAA,IAC7P,sBAAsB;AAC1B;AAMO,SAAS,sCAAsC,aAA6B;AACjF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAOW,WAAW;AAAA;AAAA,KAE1B,sBAAsB;AAAA;AAAA;AAG3B;","names":[]}

package/dist/{chunk-2NLLXCJG.js → chunk-BXLOS5AJ.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-765K3SAT.js";
 import {
   encryptCapsuleFile
-} from "./chunk-X7Y7WX73.js";
+} from "./chunk-DQEMWVMT.js";
 import {
   computeTransferOutputRel,
   isTransferPathExcluded
@@ -109,4 +109,4 @@ async function enforceRetention(outDirAbs, retentionDays) {
 export {
   backupMemoryDir
 };
-//# sourceMappingURL=chunk-2NLLXCJG.js.map
+//# sourceMappingURL=chunk-BXLOS5AJ.js.map

package/dist/{chunk-776GVKL7.js → chunk-CD3C4BJN.js}

@@ -1,6 +1,6 @@
 import {
   runLocationSync
-} from "./chunk-HXSAWV3A.js";
+} from "./chunk-57GDHV2D.js";
 import {
   log
 } from "./chunk-3WCASNQZ.js";
@@ -58,4 +58,4 @@ export {
   LOCATION_SYNC_DEFAULT_INTERVAL_MS,
   startLocationAutoSync
 };
-//# sourceMappingURL=chunk-776GVKL7.js.map
+//# sourceMappingURL=chunk-CD3C4BJN.js.map

package/dist/{chunk-LMCD5W5B.js → chunk-CIYUWSMZ.js}

@@ -1,6 +1,6 @@
 import {
   deepRecallRequestSchema
-} from "./chunk-L2QLDZJC.js";
+} from "./chunk-7MJBKZPU.js";
 import {
   EngramAccessInputError
 } from "./chunk-2Z24E5W2.js";
@@ -39,4 +39,4 @@ async function respondDeepRecall(req, res, respondJson, readJsonBody, service, s
 export {
   respondDeepRecall
 };
-//# sourceMappingURL=chunk-LMCD5W5B.js.map
+//# sourceMappingURL=chunk-CIYUWSMZ.js.map

package/dist/{chunk-YJ6VCDMZ.js → chunk-CQ7SSBO4.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-SOBJ6NEY.js";
 import {
   summarizeDisclosureTokens
-} from "./chunk-5JG5EBVL.js";
+} from "./chunk-4DPDIOVA.js";
 import {
   summarizeRetrievedMemoryProvenance
 } from "./chunk-I4WBNM3M.js";
@@ -610,4 +610,4 @@ export {
   renderRecallExplain,
   parseRecallExplainFormat
 };
-//# sourceMappingURL=chunk-YJ6VCDMZ.js.map
+//# sourceMappingURL=chunk-CQ7SSBO4.js.map

package/dist/{chunk-CNV2A557.js → chunk-CYEMS2PG.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-5VAF4ID4.js";
+} from "./chunk-ZEPVWLCN.js";
 import {
   normalizeEntityName
 } from "./chunk-YXZG5TVN.js";
@@ -957,4 +957,4 @@ export {
   resolveBriefingSaveDir,
   briefingFilename
 };
-//# sourceMappingURL=chunk-CNV2A557.js.map
+//# sourceMappingURL=chunk-CYEMS2PG.js.map

package/dist/{chunk-DVOBLPSQ.js → chunk-D2DIYEFW.js}

@@ -15,7 +15,7 @@ import {
   PRE_ACTION_GATE_DEFAULT_TIMEOUT_MS,
   normalizeActionIntent,
   sanitizePayloadString
-} from "./chunk-Z3O53WZR.js";
+} from "./chunk-BICNRVEC.js";
 import {
   parseSubjectRuntimeConfig
 } from "./chunk-WIKO4SCR.js";
@@ -32,6 +32,9 @@ import {
   parseCorrectionIntentConfig,
   parseFaithfulnessGateConfig
 } from "./chunk-H4WG3UQZ.js";
+import {
+  parseExtractionFields
+} from "./chunk-OEBLZZKK.js";
 import {
   parseExternalWikiRoots
 } from "./chunk-NDNTNE3S.js";
@@ -78,9 +81,6 @@ import {
 import {
   parseReplicaPeersConfig
 } from "./chunk-WNIUPHWV.js";
-import {
-  parseExtractionLivenessConfig
-} from "./chunk-3SG4FGDV.js";
 import {
   parseExternalWikiRecallGuard
 } from "./chunk-JV3C2MNQ.js";
@@ -3368,7 +3368,7 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
     dreaming,
     dreamsPhases,
     procedural,
-    extractionLiveness: parseExtractionLivenessConfig(cfg),
+    ...parseExtractionFields(cfg),
     replicaPeers: parseReplicaPeersConfig(cfg),
     converge: parseConvergeConfig(cfg.converge),
     wearables,
@@ -4807,4 +4807,4 @@ export {
   VALID_MEMORY_CATEGORIES,
   parseConfig
 };
-//# sourceMappingURL=chunk-DVOBLPSQ.js.map
+//# sourceMappingURL=chunk-D2DIYEFW.js.map