@remnic/core 9.69.36 → 9.69.38

package/dist/extraction-faithfulness.js

@@ -9,17 +9,19 @@ import {
   parseFaithfulnessResponse,
   runFaithfulnessGateBatch,
   serializeFaithfulnessFields
-} from "./chunk-S2ULTQZR.js";
+} from "./chunk-3N3PBBEH.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-YEN4TREG.js";
+import "./chunk-LQNRVPTV.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
-import "./chunk-65RENJGB.js";
+import "./chunk-CWTCMZGE.js";
+import "./chunk-E2AWJ7KQ.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/extraction-judge-telemetry.d.ts

@@ -1,5 +1,5 @@
 import { JudgeVerdictKind } from './extraction-judge.js';
-import './types-yDgWDkrJ.js';
+import './types-Cyr32ABj.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -7,6 +7,7 @@ import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
@@ -18,6 +19,7 @@ import './local-llm.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './resolve-provider-secret.js';
+import './cli-fallback.js';
 
 /**
  * Extraction Judge Telemetry (issue #562, PR 3).

package/dist/extraction-judge-training.d.ts

@@ -1,5 +1,5 @@
 import { JudgeVerdictKind } from './extraction-judge.js';
-import './types-yDgWDkrJ.js';
+import './types-Cyr32ABj.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -7,6 +7,7 @@ import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
@@ -18,6 +19,7 @@ import './local-llm.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './resolve-provider-secret.js';
+import './cli-fallback.js';
 
 /**
  * Extraction Judge Training Data Shim (issue #562, PR 4).

package/dist/extraction-judge.d.ts

@@ -1,4 +1,4 @@
-import { a1 as ImportanceLevel, P as PluginConfig } from './types-yDgWDkrJ.js';
+import { a1 as ImportanceLevel, P as PluginConfig } from './types-Cyr32ABj.js';
 import { LocalLlmClient } from './local-llm.js';
 import { FallbackLlmClient } from './fallback-llm.js';
 import './message-parts/index.js';
@@ -8,6 +8,7 @@ import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
@@ -17,6 +18,7 @@ import './semantic-merge-config.js';
 import './types-continuity.js';
 import './model-registry.js';
 import './resolve-provider-secret.js';
+import './cli-fallback.js';
 
 /**
  * Extraction Judge — LLM-as-judge fact-worthiness gate (issue #376).

package/dist/extraction-judge.js

@@ -10,20 +10,22 @@ import {
   normalizeCachedVerdict,
   validateProcedureExtraction,
   verdictCacheSize
-} from "./chunk-BNGHPYZU.js";
-import "./chunk-7CBKAQIG.js";
+} from "./chunk-YUW66UAH.js";
+import "./chunk-BOADKFN4.js";
 import "./chunk-QW27DOHG.js";
-import "./chunk-YEN4TREG.js";
+import "./chunk-LQNRVPTV.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
-import "./chunk-65RENJGB.js";
+import "./chunk-CWTCMZGE.js";
+import "./chunk-E2AWJ7KQ.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-JUOZ62Y7.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/extraction-liveness.d.ts

@@ -1,11 +1,12 @@
 import './operator-doctor-types.js';
-export { l as ExtractionBufferSnapshot, aH as ExtractionBufferSource, de as ExtractionLivenessConfig, y as ExtractionLivenessStatus, df as ExtractionLivenessWarnThrottle, dg as ExtractionRootStats, dh as ExtractionWatermarkOrStorage, di as ExtractionWatermarkRead, dj as coerceExtractionWatermark, dk as computeExtractionLivenessStatus, dl as evaluateExtractionLiveness, dm as formatAgeMs, dn as gatherExtractionLivenessStatus, dp as parseExtractionLivenessConfig, dq as renderExtractionLivenessStats, dr as resolveExtractionLivenessConfig, aJ as summarizeExtractionLiveness } from './types-yDgWDkrJ.js';
+export { l as ExtractionBufferSnapshot, aI as ExtractionBufferSource, df as ExtractionLivenessConfig, y as ExtractionLivenessStatus, dg as ExtractionLivenessWarnThrottle, dh as ExtractionRootStats, di as ExtractionWatermarkOrStorage, dj as ExtractionWatermarkRead, dk as coerceExtractionWatermark, dl as computeExtractionLivenessStatus, dm as evaluateExtractionLiveness, dn as formatAgeMs, dp as gatherExtractionLivenessStatus, dq as parseExtractionLivenessConfig, dr as renderExtractionLivenessStats, ds as resolveExtractionLivenessConfig, aK as summarizeExtractionLiveness } from './types-Cyr32ABj.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';

package/dist/extraction-normalization.d.ts

@@ -1,4 +1,4 @@
-import { aw as ExtractedFact } from './types-yDgWDkrJ.js';
+import { aw as ExtractedFact } from './types-Cyr32ABj.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -6,6 +6,7 @@ import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';

package/dist/extraction-normalization.js

@@ -4,8 +4,8 @@ import {
   extractionCueAnchors,
   extractionText,
   isPlainRecord
-} from "./chunk-R4OCGPSH.js";
-import "./chunk-7CBKAQIG.js";
+} from "./chunk-FJMYMJLR.js";
+import "./chunk-BOADKFN4.js";
 import "./chunk-QW27DOHG.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-5GKPFL3S.js";

package/dist/extraction-prompt.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-yDgWDkrJ.js';
+import { P as PluginConfig } from './types-Cyr32ABj.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -6,6 +6,7 @@ import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
@@ -24,6 +25,7 @@ import './types-continuity.js';
  */
 
 declare 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}";
+declare function extractionResponseShape(spanMode?: "off" | "shadow" | "on"): string;
 declare const EXTRACTION_RESPONSE_PLACEHOLDERS: Record<string, true>;
 declare 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\"}.";
 /**
@@ -41,6 +43,14 @@ declare const OUTPUT_LANGUAGE_POLICY = "Output language: write facts, profile up
  * Returns an empty string when the gate is off (byte-identical prompt).
  */
 declare function eventTimePromptInstruction(config: PluginConfig): string;
+/**
+ * Span-mode extraction instructions (issue #2333 Phase B). Empty when the
+ * mode is off (byte-identical prompt). The offset convention mirrors the
+ * Phase A bench: messages numbered in order from 0, offsets index the
+ * message's own text (after the `[role] ` tag), [charStart, charEnd)
+ * end-exclusive.
+ */
+declare function spanModePromptSection(spanMode: "off" | "shadow" | "on"): string;
 /**
  * Build extraction instructions shared between local and cloud LLM.
  *
@@ -62,4 +72,4 @@ declare function buildConsolidationSystemPrompt(config: PluginConfig): string;
  */
 declare function buildProfileConsolidationSystemPrompt(targetLines: number): string;
 
-export { CONSOLIDATION_RESPONSE_SCHEMA, CUE_ANCHOR_PROMPT_INSTRUCTION, EXTRACTION_RESPONSE_PLACEHOLDERS, EXTRACTION_RESPONSE_SHAPE, OUTPUT_LANGUAGE_POLICY, PROFILE_CONSOLIDATION_RESPONSE_SCHEMA, buildConsolidationSystemPrompt, buildExtractionInstructions, buildProfileConsolidationSystemPrompt, eventTimePromptInstruction };
+export { CONSOLIDATION_RESPONSE_SCHEMA, CUE_ANCHOR_PROMPT_INSTRUCTION, EXTRACTION_RESPONSE_PLACEHOLDERS, EXTRACTION_RESPONSE_SHAPE, OUTPUT_LANGUAGE_POLICY, PROFILE_CONSOLIDATION_RESPONSE_SCHEMA, buildConsolidationSystemPrompt, buildExtractionInstructions, buildProfileConsolidationSystemPrompt, eventTimePromptInstruction, extractionResponseShape, spanModePromptSection };

package/dist/extraction-prompt.js

@@ -8,8 +8,10 @@ import {
   buildConsolidationSystemPrompt,
   buildExtractionInstructions,
   buildProfileConsolidationSystemPrompt,
-  eventTimePromptInstruction
-} from "./chunk-7CBKAQIG.js";
+  eventTimePromptInstruction,
+  extractionResponseShape,
+  spanModePromptSection
+} from "./chunk-BOADKFN4.js";
 import "./chunk-QW27DOHG.js";
 import "./chunk-JUOZ62Y7.js";
 import "./chunk-PZ5AY32C.js";
@@ -23,6 +25,8 @@ export {
   buildConsolidationSystemPrompt,
   buildExtractionInstructions,
   buildProfileConsolidationSystemPrompt,
-  eventTimePromptInstruction
+  eventTimePromptInstruction,
+  extractionResponseShape,
+  spanModePromptSection
 };
 //# sourceMappingURL=extraction-prompt.js.map

package/dist/extraction-source-grounding-rules.d.ts

@@ -1,4 +1,4 @@
-import { ab as ExtractionResult } from './types-yDgWDkrJ.js';
+import { ab as ExtractionResult } from './types-Cyr32ABj.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -6,6 +6,7 @@ import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
@@ -17,12 +18,13 @@ import './types-continuity.js';
 interface ExtractionSourceGroundingOptions {
     sourceGrounding: boolean;
     anchorTemporalExpressions: boolean;
+    spanMode?: "off" | "shadow" | "on";
 }
 declare function applyExtractionSourceGrounding(result: ExtractionResult, sourceText: string, assertionSourceText: string | undefined, roleAssertionSources: ExtractionGroundingRoleSources | undefined, messageTimestamp: Date | undefined, options: ExtractionSourceGroundingOptions): ExtractionResult;
 interface ExtractionGroundingRoleSources {
     profile?: string;
     identity?: string;
 }
-declare function filterExtractionResultBySource(result: ExtractionResult, source: string, assertionSource?: string, roleAssertionSources?: ExtractionGroundingRoleSources, eventTimeNormalizer?: (eventTime: string) => string): ExtractionResult;
+declare function filterExtractionResultBySource(result: ExtractionResult, source: string, assertionSource?: string, roleAssertionSources?: ExtractionGroundingRoleSources, eventTimeNormalizer?: (eventTime: string) => string, spanMode?: "off" | "shadow" | "on"): ExtractionResult;
 
 export { type ExtractionGroundingRoleSources, type ExtractionSourceGroundingOptions, applyExtractionSourceGrounding, filterExtractionResultBySource };

package/dist/extraction-source-grounding-rules.js

@@ -1,7 +1,7 @@
 import {
   applyExtractionSourceGrounding,
   filterExtractionResultBySource
-} from "./chunk-27IOSH2W.js";
+} from "./chunk-375ARKRS.js";
 import "./chunk-LNH76ZJX.js";
 import "./chunk-VEWZZM3H.js";
 import "./chunk-PZ5AY32C.js";

package/dist/extraction-source-grounding.d.ts

@@ -1,4 +1,4 @@
-import { ab as ExtractionResult, ax as ProvenanceConfig } from './types-yDgWDkrJ.js';
+import { ab as ExtractionResult, ax as ProvenanceConfig } from './types-Cyr32ABj.js';
 import { ExtractionGroundingRoleSources, ExtractionSourceGroundingOptions } from './extraction-source-grounding-rules.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
@@ -7,6 +7,7 @@ import './external-wiki-config.js';
 import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './background-generation-config.js';
 import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
@@ -29,6 +30,6 @@ declare function attachExtractionProvenance(result: ExtractionResult, turns: Rea
     timestamp: string;
     turnFingerprint?: string;
 }>, provenanceConfig: ProvenanceConfig): ExtractionResult;
-declare function filterExtractionResultBySource(result: ExtractionResult, source: string, assertionSource?: string, roleAssertionSources?: ExtractionGroundingRoleSources, eventTimeNormalizer?: (eventTime: string) => string): ExtractionResult;
+declare function filterExtractionResultBySource(result: ExtractionResult, source: string, assertionSource?: string, roleAssertionSources?: ExtractionGroundingRoleSources, eventTimeNormalizer?: (eventTime: string) => string, spanMode?: "off" | "shadow" | "on"): ExtractionResult;
 
 export { ExtractionGroundingRoleSources, ExtractionSourceGroundingOptions, applyExtractionSourceGrounding, attachExtractionProvenance, filterExtractionResultBySource };

package/dist/extraction-source-grounding.js

@@ -2,13 +2,13 @@ import {
   applyExtractionSourceGrounding,
   attachExtractionProvenance,
   filterExtractionResultBySource
-} from "./chunk-MPAJFFP3.js";
-import "./chunk-27IOSH2W.js";
+} from "./chunk-PGAB2V53.js";
+import "./chunk-375ARKRS.js";
 import "./chunk-LNH76ZJX.js";
 import "./chunk-VEWZZM3H.js";
-import "./chunk-353KGBKY.js";
-import "./chunk-PQVCH2AE.js";
+import "./chunk-RW4QNB4J.js";
 import "./chunk-PJKTFXE2.js";
+import "./chunk-PQVCH2AE.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/extraction-span-config.d.ts

@@ -0,0 +1,16 @@
+export { dt as EXTRACTION_SPAN_MODES, ay as ExtractedFactSpanRef, du as ExtractionSpanConfig, dv as parseExtractionFields, dw as parseExtractionSpanConfig } from './types-Cyr32ABj.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './recall-state-view.js';
+import './contradiction-config.js';
+import './graph-path-scoring-config.js';
+import './background-generation-config.js';
+import './deep-recall-config.js';
+import './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './local-llm-config.js';
+import './semantic-merge-config.js';
+import './types-continuity.js';

package/dist/extraction-span-config.js

@@ -0,0 +1,15 @@
+import {
+  EXTRACTION_SPAN_MODES,
+  parseExtractionFields,
+  parseExtractionSpanConfig
+} from "./chunk-OEBLZZKK.js";
+import "./chunk-3SG4FGDV.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  EXTRACTION_SPAN_MODES,
+  parseExtractionFields,
+  parseExtractionSpanConfig
+};
+//# sourceMappingURL=extraction-span-config.js.map

package/dist/extraction-span-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/extraction-span-materialize.d.ts

@@ -0,0 +1,106 @@
+import { SpanSourceStamp } from './extraction-span-source-hash.js';
+import { ay as ExtractedFactSpanRef, ab as ExtractionResult } from './types-Cyr32ABj.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './recall-state-view.js';
+import './contradiction-config.js';
+import './graph-path-scoring-config.js';
+import './background-generation-config.js';
+import './deep-recall-config.js';
+import './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './local-llm-config.js';
+import './semantic-merge-config.js';
+import './types-continuity.js';
+
+/**
+ * Span-mode materialization for production extraction (issue #2333 Phase B).
+ *
+ * Runs immediately after the extraction result is parsed and BEFORE
+ * sanitize/grounding/judge/dedup/persistence, so everything downstream sees
+ * exactly one content form and the content-hash dedup invariant (checklist
+ * §13) holds by construction. Offsets die here — nothing offset-based is
+ * stored.
+ *
+ * Modes:
+ * - "off":    spans are never requested; a stray span is stripped untrusted.
+ * - "shadow": spans are requested alongside full content; materialization
+ *             runs for comparison only, the generated content is persisted
+ *             unchanged (zero behavior change), agreement telemetry logged.
+ * - "on":     materialized frame+span content is persisted; per-fact fail-open
+ *             to the generated content (the frame) on any validation failure.
+ *
+ * Validation (identical to the Phase A bench contract):
+ * - `0 <= charStart < charEnd <= turn.text.length`, end-exclusive, integers;
+ * - slice length <= 400 chars and non-whitespace;
+ * - frame 1..15 words;
+ * - the turn text's stamp (sha256 + length of the exact in-memory string the
+ *   model saw) must verify — offset drift is rejected, never guessed around.
+ */
+
+declare const SPAN_MAX_SLICE_CHARS = 400;
+declare const SPAN_MAX_FRAME_WORDS = 15;
+type SpanMode = "off" | "shadow" | "on";
+/** A source turn exactly as rendered into the extraction prompt. */
+interface SpanMaterializeTurn {
+    text: string;
+    stamp: SpanSourceStamp;
+}
+interface SpanMaterializeFact {
+    content: string;
+    span?: ExtractedFactSpanRef | null;
+    quote?: string;
+}
+interface SpanMaterializeTelemetry {
+    /** Facts that carried a span ref. */
+    attempts: number;
+    /** Spans that failed validation and fell back to generated content. */
+    fallbacks: number;
+    /** Shadow mode only: comparisons made / exact-or-containment agreements. */
+    shadowComparisons: number;
+    shadowAgreements: number;
+}
+/** Strip span refs from facts that were never given the span prompt
+ * (e.g. the proactive second pass). Untrusted: never validated, never used.
+ * The key is omitted entirely so no `span: undefined` reaches persistence. */
+declare function stripUntrustedFactSpans<T extends {
+    span?: unknown;
+}>(facts: readonly T[]): T[];
+declare function buildSpanMaterializeTurns(texts: readonly string[]): SpanMaterializeTurn[];
+declare function truncateLocalExtractionConversation(conversation: string, maxConversationChars: number): string;
+declare function bindLocalExtractionPrompt(conversation: string, turns: readonly {
+    role: string;
+    content: string;
+    extractionContextOnly?: boolean;
+}[], maxConversationChars: number, renderedConversation?: string): {
+    promptConversation: string;
+    spanTurns: SpanMaterializeTurn[];
+};
+declare function factCarriesSpan(fact: {
+    span?: ExtractedFactSpanRef | null;
+}): boolean;
+/**
+ * Materialize one fact's span. Never throws: any validation failure falls
+ * open to the fact's generated content and is counted.
+ */
+declare function materializeFactSpan<T extends SpanMaterializeFact>(fact: T, turns: readonly SpanMaterializeTurn[], mode: SpanMode): {
+    fact: T;
+    outcome: "span" | "fallback";
+    materialized?: string;
+};
+/** Shadow agreement: exact match or containment either way. */
+declare function spanAgreesWithContent(materialized: string, content: string): boolean;
+/**
+ * Whole-result span materialization pass (issue #2333 Phase B). Called from
+ * `ExtractionEngine.applySpanMaterialization` after parse, before sanitize /
+ * grounding / judge / dedup / persist. "off" strips stray spans untrusted.
+ * Shadow logs agreement telemetry and persists generated content. "on"
+ * persists materialized frame+span content; facts that omit the optional
+ * span are dropped so a short frame cannot persist as a standalone memory.
+ */
+declare function applyExtractionSpanMaterialization(result: ExtractionResult, turns: readonly SpanMaterializeTurn[], mode: SpanMode): ExtractionResult;
+
+export { SPAN_MAX_FRAME_WORDS, SPAN_MAX_SLICE_CHARS, type SpanMaterializeFact, type SpanMaterializeTelemetry, type SpanMaterializeTurn, type SpanMode, applyExtractionSpanMaterialization, bindLocalExtractionPrompt, buildSpanMaterializeTurns, factCarriesSpan, materializeFactSpan, spanAgreesWithContent, stripUntrustedFactSpans, truncateLocalExtractionConversation };

package/dist/extraction-span-materialize.js

@@ -0,0 +1,30 @@
+import {
+  SPAN_MAX_FRAME_WORDS,
+  SPAN_MAX_SLICE_CHARS,
+  applyExtractionSpanMaterialization,
+  bindLocalExtractionPrompt,
+  buildSpanMaterializeTurns,
+  factCarriesSpan,
+  materializeFactSpan,
+  spanAgreesWithContent,
+  stripUntrustedFactSpans,
+  truncateLocalExtractionConversation
+} from "./chunk-XVZA6VXC.js";
+import "./chunk-JE26AUX6.js";
+import "./chunk-A6CXG5WI.js";
+import "./chunk-QJ2AX6DU.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  SPAN_MAX_FRAME_WORDS,
+  SPAN_MAX_SLICE_CHARS,
+  applyExtractionSpanMaterialization,
+  bindLocalExtractionPrompt,
+  buildSpanMaterializeTurns,
+  factCarriesSpan,
+  materializeFactSpan,
+  spanAgreesWithContent,
+  stripUntrustedFactSpans,
+  truncateLocalExtractionConversation
+};
+//# sourceMappingURL=extraction-span-materialize.js.map

package/dist/extraction-span-materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/extraction-span-slice.js

@@ -1,16 +1,7 @@
+import {
+  sliceSpanText
+} from "./chunk-JE26AUX6.js";
 import "./chunk-PZ5AY32C.js";
-
-// src/extraction-span-slice.ts
-function sliceSpanText(opts) {
-  const { text, start, end } = opts;
-  if (!Number.isInteger(start) || !Number.isInteger(end)) {
-    throw new TypeError("span offsets must be integers");
-  }
-  if (start < 0 || end < start || end > text.length) {
-    throw new RangeError("span offsets out of range");
-  }
-  return text.slice(start, end);
-}
 export {
   sliceSpanText
 };

package/dist/extraction-span-slice.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/extraction-span-slice.ts"],"sourcesContent":["/**\n * Isolated span slicer (issue #2333 leftover).\n *\n * Pure. Extraction wiring waits on the Phase A bench gate.\n */\n\nexport function sliceSpanText(opts: {\n  text: string;\n  start: number;\n  end: number;\n}): string {\n  const { text, start, end } = opts;\n  if (!Number.isInteger(start) || !Number.isInteger(end)) {\n    throw new TypeError(\"span offsets must be integers\");\n  }\n  if (start < 0 || end < start || end > text.length) {\n    throw new RangeError(\"span offsets out of range\");\n  }\n  return text.slice(start, end);\n}\n"],"mappings":";;;AAMO,SAAS,cAAc,MAInB;AACT,QAAM,EAAE,MAAM,OAAO,IAAI,IAAI;AAC7B,MAAI,CAAC,OAAO,UAAU,KAAK,KAAK,CAAC,OAAO,UAAU,GAAG,GAAG;AACtD,UAAM,IAAI,UAAU,+BAA+B;AAAA,EACrD;AACA,MAAI,QAAQ,KAAK,MAAM,SAAS,MAAM,KAAK,QAAQ;AACjD,UAAM,IAAI,WAAW,2BAA2B;AAAA,EAClD;AACA,SAAO,KAAK,MAAM,OAAO,GAAG;AAC9B;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/extraction-span-source-hash.js

@@ -1,50 +1,8 @@
+import {
+  stampSpanSource,
+  verifySpanSource
+} from "./chunk-A6CXG5WI.js";
 import "./chunk-PZ5AY32C.js";
-
-// 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

package/dist/extraction-span-source-hash.js.map

@@ -1 +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":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/extraction-span-validate.js

@@ -1,19 +1,7 @@
+import {
+  validateSpanOffsets
+} from "./chunk-QJ2AX6DU.js";
 import "./chunk-PZ5AY32C.js";
-
-// src/extraction-span-validate.ts
-function validateSpanOffsets(opts) {
-  const { start, end, textLength } = opts;
-  if (!Number.isInteger(start) || !Number.isInteger(end) || !Number.isInteger(textLength)) {
-    throw new TypeError("span offsets must be integers");
-  }
-  if (start < 0 || end < start || end > textLength) {
-    return { ok: false, error: "out_of_range" };
-  }
-  if (start === end) {
-    return { ok: false, error: "empty" };
-  }
-  return { ok: true };
-}
 export {
   validateSpanOffsets
 };

package/dist/extraction-span-validate.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/extraction-span-validate.ts"],"sourcesContent":["/**\n * Isolated span-offset validator (issue #2333 leftover).\n *\n * Pure. Extraction wiring waits on the Phase A bench gate.\n */\n\nexport type SpanValidateOk = { ok: true };\nexport type SpanValidateErr = { ok: false; error: \"out_of_range\" | \"empty\" };\nexport type SpanValidateResult = SpanValidateOk | SpanValidateErr;\n\nexport function validateSpanOffsets(opts: {\n  start: number;\n  end: number;\n  textLength: number;\n}): SpanValidateResult {\n  const { start, end, textLength } = opts;\n  if (!Number.isInteger(start) || !Number.isInteger(end) || !Number.isInteger(textLength)) {\n    throw new TypeError(\"span offsets must be integers\");\n  }\n  if (start < 0 || end < start || end > textLength) {\n    return { ok: false, error: \"out_of_range\" };\n  }\n  if (start === end) {\n    return { ok: false, error: \"empty\" };\n  }\n  return { ok: true };\n}\n"],"mappings":";;;AAUO,SAAS,oBAAoB,MAIb;AACrB,QAAM,EAAE,OAAO,KAAK,WAAW,IAAI;AACnC,MAAI,CAAC,OAAO,UAAU,KAAK,KAAK,CAAC,OAAO,UAAU,GAAG,KAAK,CAAC,OAAO,UAAU,UAAU,GAAG;AACvF,UAAM,IAAI,UAAU,+BAA+B;AAAA,EACrD;AACA,MAAI,QAAQ,KAAK,MAAM,SAAS,MAAM,YAAY;AAChD,WAAO,EAAE,IAAI,OAAO,OAAO,eAAe;AAAA,EAC5C;AACA,MAAI,UAAU,KAAK;AACjB,WAAO,EAAE,IAAI,OAAO,OAAO,QAAQ;AAAA,EACrC;AACA,SAAO,EAAE,IAAI,KAAK;AACpB;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}