@hy-sde-org/dsh-memory-extraction 0.1.2-rc.1

package/dist/engine.js

@@ -0,0 +1,411 @@
+/**
+ * The memory-extraction engine: a bounded, fail-open pipeline over frozen
+ * evidence. Ported from Maka `memory-extraction.ts` with the compaction-only
+ * surface (no `remember`/`extract` tools, no per-checkpoint policy denials,
+ * no range-splitting) and the same load-bearing rules:
+ *
+ * - evidence is user-authored text only, bounded and fail-closed on overflow;
+ * - proposal → admission → canonicalization → re-admission, with verbatim
+ *   quote verification and deterministic secret rejection;
+ * - the per-session cursor only moves to a committed boundary; empty ranges
+ *   still advance; a failed range becomes one pending record retried by the
+ *   next trigger and then discarded;
+ * - every run is idempotent by deterministic operation id.
+ *
+ * The engine is pure (ports only, no cordis, no live session) so the whole
+ * state machine is unit-testable with fakes.
+ * @module @hy-sde-org/dsh-memory-extraction/engine
+ */
+import { createHash } from 'node:crypto';
+import { evidenceByRef, fitMemoryExtractionEvidence, planMemoryCoverage, projectMemoryExtractionEvidence, renderMemoryLocalizationContext, searchSameSessionMemoryHistory, } from "./evidence.js";
+import { admitMemoryProposalItem, buildFirstMemoryProposalPrompt, buildLocalizedMemoryProposalPrompt, buildMemoryCanonicalizationPrompt, deterministicMemoryPolicyRejection, parseLocalizedMemoryProposal, parseMemoryCanonicalization, parseMemoryProposal, } from "./proposal.js";
+/** Max auxiliary model calls per range (Maka: 3). */
+export const MAX_MEMORY_EXTRACTION_MODEL_CALLS = 3;
+/** One later retry after a settled failure, then discard (Maka keeps more states). */
+export const MAX_FAILURE_ATTEMPTS = 2;
+export class MemoryExtractionEngine {
+    ports;
+    constructor(ports) {
+        this.ports = ports;
+    }
+    async execute(snapshot) {
+        if (!validSnapshot(snapshot))
+            return { status: 'unavailable', reason: 'invalid snapshot' };
+        const operationId = memoryExtractionOperationId(snapshot);
+        const gate = await this.ports.readGate(snapshot);
+        if (!gate.allowed)
+            return { status: 'unavailable', reason: `gate: ${gate.reason}` };
+        const existing = await this.ports.readReceipt(operationId);
+        if (existing) {
+            return existing.status === 'extracted'
+                ? { status: 'extracted', items: existing.items }
+                : { status: 'skipped' };
+        }
+        const entries = await this.ports.readEvents(snapshot.sessionId, 0, snapshot.boundarySeq);
+        const cursor = await this.ports.readCursor(snapshot.sessionId);
+        const expectedCursor = cursor?.processedSeq ?? -1;
+        if (expectedCursor >= snapshot.boundarySeq)
+            return { status: 'no_range' };
+        const pendingFailure = await this.ports.readFailure(snapshot.sessionId);
+        if (pendingFailure && pendingFailure.throughSeq > snapshot.boundarySeq) {
+            return { status: 'unavailable', reason: 'pending failure outside trigger boundary' };
+        }
+        if (pendingFailure && pendingFailure.fromSeq !== expectedCursor + 1) {
+            // Stale pending (cursor advanced but the failure row was not removed).
+            await this.ports.deleteFailure(snapshot.sessionId);
+        }
+        else if (pendingFailure) {
+            const expectedHash = memoryCoverageHash(entries, expectedCursor, pendingFailure.throughSeq);
+            if (pendingFailure.coverageHash !== expectedHash) {
+                return { status: 'unavailable', reason: 'pending failure coverage changed' };
+            }
+            const retried = await this.processRange({
+                snapshot,
+                operationId: pendingFailure.operationId,
+                expectedCursor,
+                throughSeq: pendingFailure.throughSeq,
+                expectedCoverageHash: pendingFailure.coverageHash,
+                entries,
+            });
+            if (retried.kind === 'committed') {
+                await this.ports.deleteFailure(snapshot.sessionId);
+                return retried.committed.length > 0
+                    ? { status: 'extracted', items: retried.committed }
+                    : { status: 'skipped' };
+            }
+            if (retried.kind === 'blocked') {
+                return { status: 'unavailable', reason: 'blocked' };
+            }
+            const settled = await this.settleCountedFailure({
+                snapshot,
+                operationId: pendingFailure.operationId,
+                expectedCursor,
+                throughSeq: pendingFailure.throughSeq,
+                coverageHash: pendingFailure.coverageHash,
+                failureClass: retried.failureClass,
+                priorAttempts: pendingFailure.attempts,
+            });
+            if (settled === 'discarded')
+                await this.ports.deleteFailure(snapshot.sessionId);
+            return { status: 'unavailable', reason: `failure: ${retried.failureClass}` };
+        }
+        const processed = await this.processRange({
+            snapshot,
+            operationId,
+            expectedCursor,
+            throughSeq: snapshot.boundarySeq,
+            entries,
+        });
+        if (processed.kind === 'committed') {
+            return processed.committed.length > 0
+                ? { status: 'extracted', items: processed.committed }
+                : { status: 'skipped' };
+        }
+        if (processed.kind === 'blocked')
+            return { status: 'unavailable', reason: 'blocked' };
+        const settled = await this.settleCountedFailure({
+            snapshot,
+            operationId,
+            expectedCursor,
+            throughSeq: snapshot.boundarySeq,
+            coverageHash: memoryCoverageHash(entries, expectedCursor, snapshot.boundarySeq),
+            failureClass: processed.failureClass,
+            priorAttempts: 0,
+        });
+        if (settled === 'discarded')
+            await this.ports.deleteFailure(snapshot.sessionId);
+        return { status: 'unavailable', reason: `failure: ${processed.failureClass}` };
+    }
+    /* ── range processing ─────────────────────────────────────────────────── */
+    async processRange(input) {
+        const pendingEntries = input.entries.filter(entry => entry.seq > input.expectedCursor && entry.seq <= input.throughSeq);
+        const coverageHash = memoryCoverageHash(input.entries, input.expectedCursor, input.throughSeq);
+        if (input.expectedCoverageHash !== undefined && input.expectedCoverageHash !== coverageHash) {
+            return { kind: 'blocked' };
+        }
+        if (pendingEntries.length === 0) {
+            await this.commitEmpty(input.snapshot, input.operationId, input.expectedCursor, input.throughSeq);
+            return { kind: 'committed', committed: [] };
+        }
+        const coverage = planMemoryCoverage(pendingEntries);
+        if (!coverage)
+            return { kind: 'counted_failure', failureClass: 'evidence' };
+        // A range with events but no user evidence still advances: no model call.
+        if (coverage.evidence.length === 0) {
+            await this.commitEmpty(input.snapshot, input.operationId, input.expectedCursor, input.throughSeq);
+            return { kind: 'committed', committed: [] };
+        }
+        const budget = { remaining: MAX_MEMORY_EXTRACTION_MODEL_CALLS };
+        const now = this.now();
+        const result = await this.processCoverage({
+            snapshot: input.snapshot,
+            operationId: input.operationId,
+            expectedCursor: input.expectedCursor,
+            throughSeq: input.throughSeq,
+            coverage,
+            entries: input.entries,
+            budget,
+            now,
+        });
+        return result;
+    }
+    async processCoverage(input) {
+        const { coverage, budget } = input;
+        // Stage 1: proposal over the bounded evidence.
+        let proposals;
+        let localizedEvidence;
+        let interpretationContext;
+        const stageOne = await this.callModel(input.snapshot, buildFirstMemoryProposalPrompt({ now: input.now, evidence: coverage.evidence }), 'proposal', budget);
+        if (stageOne.kind !== 'ok')
+            return stageOne;
+        const first = parseMemoryProposal(stageOne.text);
+        if (!first)
+            return { kind: 'counted_failure', failureClass: 'schema' };
+        if (first.status === 'search_required') {
+            if (!(await this.allowed(input.snapshot)))
+                return { kind: 'blocked' };
+            const localizedEntries = searchSameSessionMemoryHistory(input.entries, input.throughSeq, first.search, input.expectedCursor);
+            if (localizedEntries.length === 0)
+                return { kind: 'counted_failure', failureClass: 'localization' };
+            interpretationContext = renderMemoryLocalizationContext(localizedEntries);
+            if (!interpretationContext)
+                return { kind: 'counted_failure', failureClass: 'localization' };
+            const projected = projectMemoryExtractionEvidence(localizedEntries.map(entry => entry.event));
+            const fitted = fitMemoryExtractionEvidence(projected);
+            if (!fitted)
+                return { kind: 'counted_failure', failureClass: 'evidence' };
+            localizedEvidence = fitted;
+            if (budget.remaining <= 0)
+                return { kind: 'counted_failure', failureClass: 'localization' };
+            const localizedCall = await this.callModel(input.snapshot, buildLocalizedMemoryProposalPrompt({
+                now: input.now,
+                evidence: fitted,
+                interpretationContext,
+            }), 'localized', budget);
+            if (localizedCall.kind !== 'ok')
+                return localizedCall;
+            const localized = parseLocalizedMemoryProposal(localizedCall.text);
+            if (!localized)
+                return { kind: 'counted_failure', failureClass: 'schema' };
+            if (localized.status === 'cannot_resolve') {
+                return { kind: 'counted_failure', failureClass: 'localization' };
+            }
+            proposals = localized.incidents;
+        }
+        else if (first.status === 'cannot_resolve') {
+            return { kind: 'counted_failure', failureClass: 'localization' };
+        }
+        else {
+            proposals = first.incidents;
+        }
+        // Admission (incidental): skip policy-rejected or unverifiable items.
+        const evidenceMap = evidenceByRef(localizedEvidence ?? coverage.evidence);
+        const candidates = [];
+        for (const proposal of proposals) {
+            if (deterministicMemoryPolicyRejection(proposal))
+                continue;
+            const admitted = admitMemoryProposalItem(proposal, evidenceMap);
+            if (admitted === undefined)
+                continue;
+            candidates.push({
+                candidateId: `candidate_${candidates.length}`,
+                item: proposal,
+                admitted,
+            });
+        }
+        if (candidates.length === 0) {
+            await this.commitEmpty(input.snapshot, input.operationId, input.expectedCursor, input.throughSeq);
+            return { kind: 'committed', committed: [] };
+        }
+        // Stage 2: canonicalization, then re-admission against the same evidence.
+        const writes = [];
+        const canonicalPrompt = buildMemoryCanonicalizationPrompt({
+            now: input.now,
+            candidates: candidates.map(candidate => ({
+                candidateId: candidate.candidateId,
+                evidence: candidate.item.evidence
+                    .map(citation => ({
+                    sourceRef: citation.sourceRef,
+                    quote: citation.quote,
+                    observedAt: Math.max(0, ...candidate.admitted.citedSeqs),
+                })),
+            })),
+        });
+        let byId;
+        let canonicalFailureClass = 'schema';
+        while (byId === undefined && budget.remaining > 0) {
+            const canonicalCall = await this.callModel(input.snapshot, canonicalPrompt, 'canonicalize', budget);
+            if (canonicalCall.kind === 'blocked')
+                return canonicalCall;
+            if (canonicalCall.kind !== 'ok') {
+                canonicalFailureClass = 'provider';
+                continue;
+            }
+            const parsed = parseMemoryCanonicalization(canonicalCall.text);
+            if (parsed === undefined || parsed.results.length !== candidates.length) {
+                canonicalFailureClass = 'schema';
+                continue;
+            }
+            const indexed = new Map(parsed.results.map(result => [result.candidateId, result]));
+            if (indexed.size !== candidates.length
+                || candidates.some(candidate => !indexed.has(candidate.candidateId))) {
+                canonicalFailureClass = 'schema';
+                continue;
+            }
+            const entries = [];
+            for (const [id, result] of indexed) {
+                entries.push([
+                    id,
+                    {
+                        status: result.status,
+                        ...result.content !== undefined ? { content: result.content } : {},
+                    },
+                ]);
+            }
+            byId = new Map(entries);
+        }
+        if (byId === undefined) {
+            return budget.remaining <= 0 && canonicalFailureClass === 'provider'
+                ? { kind: 'counted_failure', failureClass: 'provider' }
+                : { kind: 'counted_failure', failureClass: canonicalFailureClass };
+        }
+        for (const candidate of candidates) {
+            const result = byId.get(candidate.candidateId);
+            if (result === undefined || result.status === 'rejected')
+                continue;
+            const content = result.content;
+            if (content === undefined)
+                continue;
+            const canonicalProposal = {
+                content,
+                evidence: candidate.item.evidence,
+            };
+            if (deterministicMemoryPolicyRejection(canonicalProposal))
+                continue;
+            const admitted = admitMemoryProposalItem(canonicalProposal, evidenceMap);
+            if (admitted === undefined)
+                continue;
+            writes.push(admitted);
+        }
+        if (writes.length === 0) {
+            await this.commitEmpty(input.snapshot, input.operationId, input.expectedCursor, input.throughSeq);
+            return { kind: 'committed', committed: [] };
+        }
+        if (!(await this.allowed(input.snapshot)))
+            return { kind: 'blocked' };
+        // Commit order: items first (dedupe is the cross-store idempotency
+        // backstop), then cursor, then receipt.
+        const committed = await this.ports.commitItems({
+            sessionId: input.snapshot.sessionId,
+            ...input.snapshot.workspaceKey !== undefined
+                ? { workspaceKey: input.snapshot.workspaceKey }
+                : {},
+            trigger: input.snapshot.trigger,
+            boundarySeq: input.throughSeq,
+            items: writes,
+        });
+        await this.ports.writeCursor({
+            sessionId: input.snapshot.sessionId,
+            processedSeq: input.throughSeq,
+            updatedAt: this.now(),
+        });
+        await this.ports.writeReceipt({
+            operationId: input.operationId,
+            sessionId: input.snapshot.sessionId,
+            status: 'extracted',
+            items: [...committed.committed],
+            committedAt: this.now(),
+        });
+        return { kind: 'committed', committed: committed.committed };
+    }
+    async commitEmpty(snapshot, operationId, expectedCursor, throughSeq) {
+        await this.ports.writeCursor({
+            sessionId: snapshot.sessionId,
+            processedSeq: Math.max(expectedCursor, throughSeq),
+            updatedAt: this.now(),
+        });
+        await this.ports.writeReceipt({
+            operationId,
+            sessionId: snapshot.sessionId,
+            status: 'skipped',
+            items: [],
+            committedAt: this.now(),
+        });
+    }
+    async settleCountedFailure(input) {
+        const attempts = input.priorAttempts + 1;
+        if (attempts >= MAX_FAILURE_ATTEMPTS) {
+            // Discard: advance the cursor and record the settlement. The range is
+            // intentionally dropped after one retry (never a third identical run).
+            await this.ports.writeCursor({
+                sessionId: input.snapshot.sessionId,
+                processedSeq: input.throughSeq,
+                updatedAt: this.now(),
+            });
+            await this.ports.writeReceipt({
+                operationId: input.operationId,
+                sessionId: input.snapshot.sessionId,
+                status: 'discarded',
+                items: [],
+                committedAt: this.now(),
+            });
+            return 'discarded';
+        }
+        await this.ports.writeFailure({
+            sessionId: input.snapshot.sessionId,
+            fromSeq: input.expectedCursor + 1,
+            throughSeq: input.throughSeq,
+            coverageHash: input.coverageHash,
+            operationId: input.operationId,
+            attempts,
+            failureClass: input.failureClass,
+            failedAt: this.now(),
+        });
+        return 'retry_later';
+    }
+    async callModel(snapshot, prompt, stage, budget) {
+        if (budget.remaining <= 0)
+            return { kind: 'counted_failure', failureClass: 'provider' };
+        if (!(await this.allowed(snapshot)))
+            return { kind: 'blocked' };
+        budget.remaining -= 1;
+        const result = await this.ports.generate({ snapshot, prompt, stage });
+        if (result.ok)
+            return { kind: 'ok', text: result.text };
+        if (!(await this.allowed(snapshot)))
+            return { kind: 'blocked' };
+        return result.errorClass === 'provider' || result.errorClass === 'timeout'
+            ? { kind: 'counted_failure', failureClass: 'provider' }
+            : { kind: 'blocked' };
+    }
+    async allowed(snapshot) {
+        return (await this.ports.readGate(snapshot)).allowed;
+    }
+    now() {
+        if (this.ports.now === undefined)
+            return Date.now();
+        return this.ports.now();
+    }
+}
+/* ── helpers ─────────────────────────────────────────────────────────────── */
+export function memoryExtractionOperationId(snapshot) {
+    return `memory_${createHash('sha256')
+        .update(JSON.stringify({
+        sessionId: snapshot.sessionId,
+        trigger: snapshot.trigger,
+        boundarySeq: snapshot.boundarySeq,
+    }))
+        .digest('hex')}`;
+}
+export function memoryCoverageHash(entries, fromSeq, throughSeq) {
+    return createHash('sha256')
+        .update(JSON.stringify(entries
+        .filter(entry => entry.seq > fromSeq && entry.seq <= throughSeq)
+        .map(entry => [entry.seq, `${entry.event.role}:${entry.event.author}:${entry.event.text?.length ?? 0}`])))
+        .digest('hex');
+}
+function validSnapshot(snapshot) {
+    return (typeof snapshot.sessionId === 'string' && snapshot.sessionId.length > 0
+        && Number.isSafeInteger(snapshot.boundarySeq) && snapshot.boundarySeq >= 0);
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/events.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Projection of DSH session events into the portable text events the
+ * extraction pipeline reasons about. Deliberately lossy: only user-role text
+ * (evidence) and assistant-role text (interpretation context) carry `text`;
+ * tool calls/results, reasoning blocks, attachments, and runtime markers stay
+ * opaque (`role: 'other'`, no text) so nothing outside the memory domain can
+ * leak into prompts. Ported from Maka's `projectRuntimeConversation` /
+ * history-projection semantics.
+ * @module @hy-sde-org/dsh-memory-extraction/events
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { MemoryExtractionTextEvent } from './types.ts';
+/**
+ * Project one session event window into portable text events. `turns` tracks
+ * the open `turn/start…turn/end` so `user/message` events (which carry no turn
+ * field) still get a turn identity for localization grouping.
+ */
+export declare function projectTextEvents(events: readonly SessionEvent[]): MemoryExtractionTextEvent[];
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAU3D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,yBAAyB,EAAE,CAqD9F"}

package/dist/events.js

@@ -0,0 +1,76 @@
+/**
+ * Projection of DSH session events into the portable text events the
+ * extraction pipeline reasons about. Deliberately lossy: only user-role text
+ * (evidence) and assistant-role text (interpretation context) carry `text`;
+ * tool calls/results, reasoning blocks, attachments, and runtime markers stay
+ * opaque (`role: 'other'`, no text) so nothing outside the memory domain can
+ * leak into prompts. Ported from Maka's `projectRuntimeConversation` /
+ * history-projection semantics.
+ * @module @hy-sde-org/dsh-memory-extraction/events
+ */
+/** Join visible text blocks only (reasoning and images are never text evidence). */
+function textBlocks(content) {
+    return content
+        .filter(block => block.type === 'text')
+        .map(block => block.text)
+        .join('');
+}
+/**
+ * Project one session event window into portable text events. `turns` tracks
+ * the open `turn/start…turn/end` so `user/message` events (which carry no turn
+ * field) still get a turn identity for localization grouping.
+ */
+export function projectTextEvents(events) {
+    const projected = [];
+    let currentTurn;
+    for (const event of events) {
+        const seq = event.seq;
+        if (event.type === 'turn/start') {
+            currentTurn = event.data.turn;
+            continue;
+        }
+        if (event.type === 'turn/end') {
+            currentTurn = undefined;
+            continue;
+        }
+        if (event.type === 'user/message') {
+            const rawKind = event.data.source.kind;
+            const author = rawKind === 'user' || rawKind === 'plugin' || rawKind === 'model' || rawKind === 'tool'
+                ? rawKind
+                : 'other';
+            const text = textBlocks(event.data.content);
+            projected.push({
+                seq,
+                role: 'user',
+                author,
+                ...text.length > 0 ? { text } : {},
+                ...currentTurn !== undefined ? { turn: currentTurn } : {},
+                time: event.time,
+            });
+            continue;
+        }
+        if (event.type === 'assistant/message') {
+            const text = textBlocks(event.data.message.content);
+            projected.push({
+                seq,
+                role: 'assistant',
+                author: 'model',
+                ...text.length > 0 ? { text } : {},
+                ...currentTurn !== undefined ? { turn: currentTurn } : {},
+                time: event.time,
+            });
+            continue;
+        }
+        // Tool calls, tool results, checkpoints, compaction markers, headers, …
+        // carry no memory text: opaque, no text, never evidence.
+        projected.push({
+            seq,
+            role: 'other',
+            author: event.type === 'tool/call' || event.type === 'tool/result' ? 'tool' : 'other',
+            ...currentTurn !== undefined ? { turn: currentTurn } : {},
+            time: event.time,
+        });
+    }
+    return projected;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/evidence.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Evidence planning for automatic memory extraction: which session events are
+ * Memory evidence (user-authored text only), how the bounded evidence index is
+ * fitted, and the same-session history search that localizes elliptical
+ * assertions. Ported from Maka `memory-extraction-evidence.ts`; provider-prefix
+ * binding is dropped (the bounded evidence text is authoritative for both the
+ * model and admission — see the package README deviation note).
+ * @module @hy-sde-org/dsh-memory-extraction/evidence
+ */
+import type { MemoryCoveragePlan, MemoryEvidenceCitation, MemoryExtractionEventEntry, MemoryExtractionEvidence, MemoryExtractionTextEvent } from './types.ts';
+export declare const MAX_MEMORY_EVIDENCE_JSON_CHARS = 12000;
+export declare const MAX_EVIDENCE_TEXT_CHARS = 4000;
+export declare const MIN_EVIDENCE_TEXT_CHARS = 64;
+export declare const MAX_LOCALIZED_TURNS = 7;
+export declare const MAX_LOCALIZED_CONTEXT_CHARS = 12000;
+export declare const MAX_LOCALIZED_EVENT_CHARS = 2000;
+/**
+ * Plan one complete trigger range. Tool and runtime-control events produce no
+ * evidence but stay in the range so the session cursor crosses them instead of
+ * reconsidering them. If every user evidence record cannot fit the bounded
+ * evidence index, fail closed instead of silently consuming part of the range.
+ */
+export declare function planMemoryCoverage(pendingEntries: readonly MemoryExtractionEventEntry[], options?: {
+    readonly maxEvidenceJsonChars?: number;
+}): MemoryCoveragePlan | undefined;
+/** Projects only stable user-authored text into Memory evidence. */
+export declare function projectMemoryExtractionEvidence(events: readonly MemoryExtractionTextEvent[]): readonly MemoryExtractionEvidence[];
+/**
+ * Keep every evidence record represented while shrinking supplemental text to
+ * the actual serialized JSON budget. `undefined` means even the record
+ * identities cannot fit and the cursor must not advance.
+ */
+export declare function fitMemoryExtractionEvidence(evidence: readonly MemoryExtractionEvidence[], maxJsonChars?: number): readonly MemoryExtractionEvidence[] | undefined;
+export declare function memoryExtractionEvidenceJsonSize(evidence: readonly MemoryExtractionEvidence[]): number;
+/** The bounded evidence index rendered into the pipeline prompts. */
+export declare function renderMemoryExtractionEvidence(evidence: readonly MemoryExtractionEvidence[]): readonly {
+    readonly sourceRef: string;
+    readonly type: 'user_message';
+    readonly observedAt: number;
+    readonly text: string;
+}[];
+/**
+ * Rank matching turns by term coverage and recency, then add a one-turn
+ * neighborhood. Applies over the same bounded event window (`throughSeq`).
+ * A "turn" is the adapter-declared `turn` id when present (DSH turn numbers);
+ * otherwise each text event is its own group.
+ */
+export declare function searchSameSessionMemoryHistory(entries: readonly MemoryExtractionEventEntry[], throughSeq: number, search: {
+    readonly terms: readonly string[];
+    readonly roles?: readonly string[];
+}, afterSeq?: number): readonly MemoryExtractionEventEntry[];
+/** Bounded user/assistant text used only to interpret elliptical user evidence. */
+export declare function renderMemoryLocalizationContext(entries: readonly MemoryExtractionEventEntry[]): string;
+/** Resolve the admission evidence map for one coverage plan. */
+export declare function evidenceByRef(evidence: readonly MemoryExtractionEvidence[]): ReadonlyMap<string, MemoryExtractionEvidence>;
+/** Whether one citation's quote is verbatim inside its referenced evidence. */
+export declare function evidenceContainsCitation(citation: MemoryEvidenceCitation, evidence: ReadonlyMap<string, MemoryExtractionEvidence>): boolean;
+export declare function normalizeEvidenceText(value: string): string;
+export declare function minuteTimestamp(value: number): number;
+export declare function historyRole(event: MemoryExtractionTextEvent): 'user' | 'assistant';
+export declare function sliceCodePoints(value: string, maximum: number): string;
+/** Event identity of one entry, used by the coverage hash. */
+export declare function coverageEntryIdentity(entry: MemoryExtractionEventEntry): [number, string];
+/** Sort helper retained for tests and derived projections. */
+export declare function sortEntriesBySeq(entries: readonly MemoryExtractionEventEntry[]): MemoryExtractionEventEntry[];
+//# sourceMappingURL=evidence.d.ts.map

package/dist/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../src/evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,8BAA8B,QAAS,CAAA;AACpD,eAAO,MAAM,uBAAuB,OAAQ,CAAA;AAC5C,eAAO,MAAM,uBAAuB,KAAK,CAAA;AACzC,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,eAAO,MAAM,2BAA2B,QAAS,CAAA;AACjD,eAAO,MAAM,yBAAyB,OAAQ,CAAA;AAE9C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,SAAS,0BAA0B,EAAE,EACrD,OAAO,GAAE;IAAE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,kBAAkB,GAAG,SAAS,CAWhC;AAED,oEAAoE;AACpE,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,yBAAyB,EAAE,GAC3C,SAAS,wBAAwB,EAAE,CAcrC;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,EAC7C,YAAY,SAAiC,GAC5C,SAAS,wBAAwB,EAAE,GAAG,SAAS,CAoBjD;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAAG,MAAM,CAEtG;AAED,qEAAqE;AACrE,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,SAAS;IACV,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,EAAE,CAOF;AASD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,SAAS,0BAA0B,EAAE,EAC9C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EACjF,QAAQ,SAAI,GACX,SAAS,0BAA0B,EAAE,CAyCvC;AAED,mFAAmF;AACnF,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,SAAS,0BAA0B,EAAE,GAC7C,MAAM,CAcR;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAE/C;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,GACtD,OAAO,CAMT;AAsBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,GAAG,WAAW,CAElF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKzF;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,GAAG,0BAA0B,EAAE,CAE7G"}