@framers/agentos 0.1.247 → 0.1.249

package/dist/memory/ingest/SessionSummarizer.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @file SessionSummarizer.ts
+ * @description Session-level contextual retrieval (Anthropic Sep 2024
+ * variant, adapted to conversational memory).
+ *
+ * ## What this does
+ *
+ * For each session in a benchmark case (e.g. a `conv-26` chat thread in
+ * LOCOMO or a `haystack_sessions[i]` entry in LongMemEval), an LLM
+ * generates a dense 50–100 token summary that captures the topic,
+ * key user-stated facts (names, numbers, dates, preferences), and key
+ * assistant-stated facts. That summary is then prepended to *every*
+ * chunk produced from that session before embedding — giving the
+ * embedding vector global session context it would otherwise lack.
+ *
+ * ## Why session-granularity (not per-chunk)
+ *
+ * Anthropic's canonical
+ * {@link https://www.anthropic.com/news/contextual-retrieval Contextual Retrieval}
+ * prepends context *per chunk*. That's right for heterogeneous documents
+ * where each chunk might cover a different topic. Conversational data is
+ * different: a session is a topically-coherent thread. Adjacent chunks in
+ * the same session share context, so per-chunk contextualization would
+ * fire ~10× as many LLM calls at the *same* summarization model for the
+ * same downstream embedding benefit — this is a same-model
+ * granularity comparison, not a cross-reader pricing claim.
+ *
+ * The closest industry analog is Mastra Observational Memory's Observer
+ * phase (rewrites full messages into dense observations). Ours is a
+ * lighter variant — we *prepend* a summary to preserve the original
+ * chunk text verbatim, rather than rewriting it.
+ *
+ * ## Caching
+ *
+ * Summaries are cached to disk under `<cacheDir>/<sha256-hex>.txt`. The
+ * cache key hashes the session text, model id, and template version so
+ * any of those three changing invalidates the cache cleanly. Mirrors
+ * the {@link CachedEmbedder} pattern for consistency.
+ *
+ * ## Cost
+ *
+ * Single LLM call per unique session. For LongMemEval-S (~50 sessions
+ * per case × 500 cases) with gpt-5-mini / Haiku pricing:
+ *   ~25,000 calls × 50–100 output tokens × 2,000 input tokens (session)
+ *   ≈ $50–90 one-time across all cases. Cached thereafter.
+ *
+ * ## Expected lift
+ *
+ * Anthropic's published numbers: −49% retrieval failure with contextual
+ * embeddings alone, −67% when combined with reranking. We already have
+ * Cohere rerank-v3.5 wired, so the upper bound applies. Our Phase A
+ * multi-session ceiling of 50% is the main target; expected lift
+ * +8–15pp on multi-session categories across LongMemEval and LOCOMO.
+ *
+ * @module agentos-bench/cognitive/SessionSummarizer
+ */
+/**
+ * Callable that invokes a chat LLM given a system + user prompt and
+ * returns the generated text. The bench constructs one from the
+ * existing {@link IReader} so summarization reuses the same pricing +
+ * timeout plumbing as the benchmark's reader.
+ */
+export type SessionSummarizerInvoker = (system: string, user: string) => Promise<{
+    text: string;
+    tokensIn: number;
+    tokensOut: number;
+    model: string;
+}>;
+/**
+ * Options for constructing a {@link SessionSummarizer}.
+ */
+export interface SessionSummarizerOptions {
+    /** LLM invoker — produces the summary text. */
+    invoker: SessionSummarizerInvoker;
+    /**
+     * Optional directory for persistent disk cache. When set, summaries
+     * survive across process restarts and re-runs. Mirrors the
+     * {@link CachedEmbedder} cache layout.
+     */
+    cacheDir?: string;
+    /**
+     * Model identifier baked into the cache key so switching models
+     * invalidates the cache automatically. Should match the invoker's
+     * underlying model.
+     */
+    modelId: string;
+    /**
+     * Maximum tokens to ask the LLM to emit. Default 140 (generous headroom
+     * over the 50–100 target; truncate post-hoc if needed).
+     */
+    maxTokens?: number;
+    /**
+     * Template version. Bump whenever the summarization prompt changes so
+     * disk caches from prior versions are invalidated.
+     * Current: `'v1-2026-04-19'`.
+     */
+    templateVersion?: string;
+    /** Optional cost-tracker hook. Called after every uncached call. */
+    onCallCost?: (tokensIn: number, tokensOut: number, model: string) => void;
+}
+/**
+ * Summary cache stats for diagnostics / budget tracking.
+ */
+export interface SummarizerStats {
+    hits: number;
+    misses: number;
+    writes: number;
+    /** Total tokens consumed on uncached LLM calls. */
+    tokensIn: number;
+    tokensOut: number;
+}
+/**
+ * LLM-backed session summarizer with a persistent on-disk cache.
+ *
+ * @example
+ * ```ts
+ * const summarizer = new SessionSummarizer({
+ *   invoker: async (system, user) => {
+ *     const resp = await reader.invoke({ system, user, maxTokens: 140, temperature: 0 });
+ *     return { text: resp.text, tokensIn: resp.tokensIn, tokensOut: resp.tokensOut, model: resp.model };
+ *   },
+ *   cacheDir: '/path/to/data/.session-summary-cache',
+ *   modelId: 'gpt-5-mini',
+ * });
+ *
+ * const summary = await summarizer.summarize('conv-26-session-3', sessionText);
+ * // => "User discussed adopting a new rescue dog from a Portland shelter..."
+ * ```
+ */
+export declare class SessionSummarizer {
+    private readonly opts;
+    /** Running stats for diagnostics. */
+    readonly stats: SummarizerStats;
+    private readonly systemPrompt;
+    private readonly templateVersion;
+    private readonly maxTokens;
+    constructor(opts: SessionSummarizerOptions);
+    /**
+     * Summarize a single session. Returns cached result if available,
+     * otherwise calls the LLM and writes to cache.
+     *
+     * @param sessionKey — a stable identifier for the session (e.g. `${caseId}:${sessionId}`).
+     *                    Used only for logging; the cache key is content-addressed.
+     * @param sessionText — the raw text of the session (all turns concatenated).
+     */
+    summarize(_sessionKey: string, sessionText: string): Promise<string>;
+    /**
+     * Build the SHA-256 cache key from session content + model + template.
+     * Exposed for tests; callers should use {@link summarize}.
+     */
+    computeCacheKey(sessionText: string): string;
+    /** Expose the resolved template version — useful for cache-key fingerprints in other layers. */
+    getTemplateVersion(): string;
+}
+//# sourceMappingURL=SessionSummarizer.d.ts.map

package/dist/memory/ingest/SessionSummarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionSummarizer.d.ts","sourceRoot":"","sources":["../../../src/memory/ingest/SessionSummarizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAMH;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,KACT,OAAO,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,+CAA+C;IAC/C,OAAO,EAAE,wBAAwB,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,iBAAiB;IAchB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAbjC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAM7B;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEN,IAAI,EAAE,wBAAwB;IAM3D;;;;;;;OAOG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqD1E;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAU5C,gGAAgG;IAChG,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/memory/ingest/SessionSummarizer.js

@@ -0,0 +1,178 @@
+/**
+ * @file SessionSummarizer.ts
+ * @description Session-level contextual retrieval (Anthropic Sep 2024
+ * variant, adapted to conversational memory).
+ *
+ * ## What this does
+ *
+ * For each session in a benchmark case (e.g. a `conv-26` chat thread in
+ * LOCOMO or a `haystack_sessions[i]` entry in LongMemEval), an LLM
+ * generates a dense 50–100 token summary that captures the topic,
+ * key user-stated facts (names, numbers, dates, preferences), and key
+ * assistant-stated facts. That summary is then prepended to *every*
+ * chunk produced from that session before embedding — giving the
+ * embedding vector global session context it would otherwise lack.
+ *
+ * ## Why session-granularity (not per-chunk)
+ *
+ * Anthropic's canonical
+ * {@link https://www.anthropic.com/news/contextual-retrieval Contextual Retrieval}
+ * prepends context *per chunk*. That's right for heterogeneous documents
+ * where each chunk might cover a different topic. Conversational data is
+ * different: a session is a topically-coherent thread. Adjacent chunks in
+ * the same session share context, so per-chunk contextualization would
+ * fire ~10× as many LLM calls at the *same* summarization model for the
+ * same downstream embedding benefit — this is a same-model
+ * granularity comparison, not a cross-reader pricing claim.
+ *
+ * The closest industry analog is Mastra Observational Memory's Observer
+ * phase (rewrites full messages into dense observations). Ours is a
+ * lighter variant — we *prepend* a summary to preserve the original
+ * chunk text verbatim, rather than rewriting it.
+ *
+ * ## Caching
+ *
+ * Summaries are cached to disk under `<cacheDir>/<sha256-hex>.txt`. The
+ * cache key hashes the session text, model id, and template version so
+ * any of those three changing invalidates the cache cleanly. Mirrors
+ * the {@link CachedEmbedder} pattern for consistency.
+ *
+ * ## Cost
+ *
+ * Single LLM call per unique session. For LongMemEval-S (~50 sessions
+ * per case × 500 cases) with gpt-5-mini / Haiku pricing:
+ *   ~25,000 calls × 50–100 output tokens × 2,000 input tokens (session)
+ *   ≈ $50–90 one-time across all cases. Cached thereafter.
+ *
+ * ## Expected lift
+ *
+ * Anthropic's published numbers: −49% retrieval failure with contextual
+ * embeddings alone, −67% when combined with reranking. We already have
+ * Cohere rerank-v3.5 wired, so the upper bound applies. Our Phase A
+ * multi-session ceiling of 50% is the main target; expected lift
+ * +8–15pp on multi-session categories across LongMemEval and LOCOMO.
+ *
+ * @module agentos-bench/cognitive/SessionSummarizer
+ */
+import { promises as fs } from 'node:fs';
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+/** Default summarization prompt — see file docstring for rationale. */
+const DEFAULT_SYSTEM_PROMPT = [
+    'You produce a concise search-retrieval summary of a conversation session.',
+    'Your output will be prepended to individual turn-level chunks before vector embedding, so the embedding captures the session-wide context each chunk alone would miss.',
+    'Target length: 50–100 tokens. No preamble, no sign-off — emit only the summary.',
+    'Structure the summary as dense prose:',
+    '  1. The topic or theme of the session (one short clause).',
+    '  2. The specific facts the user stated — names, numbers, dates, preferences, decisions, named items (e.g. "Wells Fargo mortgage", "turbinado sugar", "mid-century dresser").',
+    '  3. The specific facts the assistant stated, suggested, or provided (numbers, recommendations, named entities).',
+    'Be concrete. Use exact nouns and numbers from the conversation. Do not generalize. Do not editorialize.',
+].join(' ');
+const DEFAULT_TEMPLATE_VERSION = 'v1-2026-04-19';
+/**
+ * LLM-backed session summarizer with a persistent on-disk cache.
+ *
+ * @example
+ * ```ts
+ * const summarizer = new SessionSummarizer({
+ *   invoker: async (system, user) => {
+ *     const resp = await reader.invoke({ system, user, maxTokens: 140, temperature: 0 });
+ *     return { text: resp.text, tokensIn: resp.tokensIn, tokensOut: resp.tokensOut, model: resp.model };
+ *   },
+ *   cacheDir: '/path/to/data/.session-summary-cache',
+ *   modelId: 'gpt-5-mini',
+ * });
+ *
+ * const summary = await summarizer.summarize('conv-26-session-3', sessionText);
+ * // => "User discussed adopting a new rescue dog from a Portland shelter..."
+ * ```
+ */
+export class SessionSummarizer {
+    constructor(opts) {
+        this.opts = opts;
+        /** Running stats for diagnostics. */
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            writes: 0,
+            tokensIn: 0,
+            tokensOut: 0,
+        };
+        this.systemPrompt = DEFAULT_SYSTEM_PROMPT;
+        this.templateVersion = opts.templateVersion ?? DEFAULT_TEMPLATE_VERSION;
+        this.maxTokens = opts.maxTokens ?? 140;
+    }
+    /**
+     * Summarize a single session. Returns cached result if available,
+     * otherwise calls the LLM and writes to cache.
+     *
+     * @param sessionKey — a stable identifier for the session (e.g. `${caseId}:${sessionId}`).
+     *                    Used only for logging; the cache key is content-addressed.
+     * @param sessionText — the raw text of the session (all turns concatenated).
+     */
+    async summarize(_sessionKey, sessionText) {
+        const trimmed = sessionText.trim();
+        if (!trimmed)
+            return '';
+        const cacheKey = this.computeCacheKey(trimmed);
+        // Try disk cache
+        if (this.opts.cacheDir) {
+            const cachePath = path.join(this.opts.cacheDir, `${cacheKey}.txt`);
+            try {
+                const cached = await fs.readFile(cachePath, 'utf8');
+                this.stats.hits += 1;
+                return cached;
+            }
+            catch {
+                // File doesn't exist or can't be read — fall through to LLM call.
+            }
+        }
+        this.stats.misses += 1;
+        const response = await this.opts.invoker(this.systemPrompt, trimmed);
+        const summary = response.text.trim();
+        this.stats.tokensIn += response.tokensIn;
+        this.stats.tokensOut += response.tokensOut;
+        if (this.opts.onCallCost) {
+            this.opts.onCallCost(response.tokensIn, response.tokensOut, response.model);
+        }
+        // Persist to disk cache (best-effort; exclusive create so concurrent
+        // writers don't tear). Non-fatal on write failure — caller still
+        // gets the summary for this call.
+        if (this.opts.cacheDir) {
+            try {
+                await fs.mkdir(this.opts.cacheDir, { recursive: true });
+                const cachePath = path.join(this.opts.cacheDir, `${cacheKey}.txt`);
+                await fs.writeFile(cachePath, summary, { encoding: 'utf8', flag: 'wx' });
+                this.stats.writes += 1;
+            }
+            catch (err) {
+                const code = err?.code;
+                // EEXIST means another writer got there first — their content is
+                // valid. Any other error is logged but non-fatal.
+                if (code !== 'EEXIST') {
+                    // eslint-disable-next-line no-console
+                    console.warn(`[SessionSummarizer] Failed to write cache for key ${cacheKey.slice(0, 8)}...: ${String(err)}`);
+                }
+            }
+        }
+        return summary;
+    }
+    /**
+     * Build the SHA-256 cache key from session content + model + template.
+     * Exposed for tests; callers should use {@link summarize}.
+     */
+    computeCacheKey(sessionText) {
+        return createHash('sha256')
+            .update(this.opts.modelId)
+            .update('\n')
+            .update(this.templateVersion)
+            .update('\n')
+            .update(sessionText)
+            .digest('hex');
+    }
+    /** Expose the resolved template version — useful for cache-key fingerprints in other layers. */
+    getTemplateVersion() {
+        return this.templateVersion;
+    }
+}
+//# sourceMappingURL=SessionSummarizer.js.map

package/dist/memory/ingest/SessionSummarizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionSummarizer.js","sourceRoot":"","sources":["../../../src/memory/ingest/SessionSummarizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AA+D7B,uEAAuE;AACvE,MAAM,qBAAqB,GAAG;IAC5B,2EAA2E;IAC3E,wKAAwK;IACxK,iFAAiF;IACjF,uCAAuC;IACvC,4DAA4D;IAC5D,+KAA+K;IAC/K,kHAAkH;IAClH,yGAAyG;CAC1G,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,iBAAiB;IAc5B,YAA6B,IAA8B;QAA9B,SAAI,GAAJ,IAAI,CAA0B;QAb3D,qCAAqC;QAC5B,UAAK,GAAoB;YAChC,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,CAAC;SACb,CAAC;QAOA,IAAI,CAAC,YAAY,GAAG,qBAAqB,CAAC;QAC1C,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,wBAAwB,CAAC;QACxE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,CAAC,WAAmB,EAAE,WAAmB;QACtD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAE/C,iBAAiB;QACjB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,MAAM,CAAC,CAAC;YACnE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACpD,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;gBACrB,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,kEAAkE;YACpE,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC;QAE3C,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9E,CAAC;QAED,qEAAqE;QACrE,iEAAiE;QACjE,kCAAkC;QAClC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,MAAM,CAAC,CAAC;gBACnE,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAI,GAA6B,EAAE,IAAI,CAAC;gBAClD,iEAAiE;gBACjE,kDAAkD;gBAClD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACtB,sCAAsC;oBACtC,OAAO,CAAC,IAAI,CACV,qDAAqD,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/F,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,WAAmB;QACjC,OAAO,UAAU,CAAC,QAAQ,CAAC;aACxB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;aACzB,MAAM,CAAC,IAAI,CAAC;aACZ,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;aAC5B,MAAM,CAAC,IAAI,CAAC;aACZ,MAAM,CAAC,WAAW,CAAC;aACnB,MAAM,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,gGAAgG;IAChG,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/memory/retrieval/fact-supersession/FactSupersession.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @file FactSupersession.ts
+ * @description Post-retrieval filter that uses an LLM to identify and
+ * drop memory traces whose factual claims have been superseded by
+ * later traces about the same subject.
+ *
+ * ## What this does
+ *
+ * Given a query and a list of retrieved `ScoredMemoryTrace`s, fires
+ * one LLM call with a strict JSON output contract. The LLM returns
+ * `{ dropIds: string[] }` — trace IDs to remove. The class filters
+ * the input list and returns the survivors in original order.
+ *
+ * ## Failure modes (never throws)
+ *
+ * - Parse error → return original traces + `parse-failed` diagnostic.
+ * - Schema mismatch → return original + `schema-mismatch` diagnostic.
+ * - Timeout → return original + `timeout` diagnostic.
+ * - LLM throws → return original + `llm-error` diagnostic.
+ * - All IDs dropped (adversarial output) → safety clamp, return
+ *   original + `drop-all-rejected` diagnostic.
+ *
+ * ## Why this exists
+ *
+ * The baseline + Hybrid retrieval surfaces BOTH statements when a
+ * user has updated a fact ("I live in NYC" + "I moved to Berlin").
+ * The reader sometimes picks the older or hedges. A supersession
+ * pass gives the reader only the canonical current state.
+ *
+ * @module agentos/memory/retrieval/fact-supersession/FactSupersession
+ */
+import type { ScoredMemoryTrace } from '../../core/types.js';
+export type LlmInvoker = (systemPrompt: string, userPrompt: string) => Promise<string>;
+/** Options for constructing a {@link FactSupersession}. */
+export interface FactSupersessionOptions {
+    /** LLM invoker used for the supersession pass. */
+    llmInvoker: LlmInvoker;
+    /** Max traces to send to the LLM. @default 10 */
+    maxTraces?: number;
+    /** Max wall-clock ms before timeout fallback. @default 8000 */
+    timeoutMs?: number;
+}
+/** Per-call input to {@link FactSupersession.resolve}. */
+export interface FactSupersessionInput {
+    traces: ScoredMemoryTrace[];
+    query: string;
+}
+/** Per-call output from {@link FactSupersession.resolve}. */
+export interface FactSupersessionResult {
+    /** Traces surviving the filter, in original order. */
+    traces: ScoredMemoryTrace[];
+    /** IDs dropped by the LLM (subset of input trace IDs). */
+    droppedIds: string[];
+    diagnostics: {
+        llmLatencyMs: number;
+        parseOk: boolean;
+        notes?: string[];
+    };
+}
+/**
+ * Post-retrieval fact supersession filter.
+ *
+ * @example
+ * ```ts
+ * const fs = new FactSupersession({
+ *   llmInvoker: async (system, user) => (await reader.invoke({ system, user, maxTokens: 200, temperature: 0 })).text,
+ * });
+ * const result = await fs.resolve({ traces: retrieval.retrieved, query: caseQuery });
+ * // Feed `result.traces` to the reader instead of `retrieval.retrieved`.
+ * ```
+ */
+export declare class FactSupersession {
+    private readonly llmInvoker;
+    private readonly maxTraces;
+    private readonly timeoutMs;
+    constructor(opts: FactSupersessionOptions);
+    resolve(input: FactSupersessionInput): Promise<FactSupersessionResult>;
+    private buildUserPrompt;
+    private invokeWithTimeout;
+    private parseDropIds;
+}
+//# sourceMappingURL=FactSupersession.d.ts.map

package/dist/memory/retrieval/fact-supersession/FactSupersession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactSupersession.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/fact-supersession/FactSupersession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEvF,2DAA2D;AAC3D,MAAM,WAAW,uBAAuB;IACtC,kDAAkD;IAClD,UAAU,EAAE,UAAU,CAAC;IACvB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH;AAkBD;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,uBAAuB;IAMnC,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAkE5E,OAAO,CAAC,eAAe;YAST,iBAAiB;IAS/B,OAAO,CAAC,YAAY;CAmBrB"}

package/dist/memory/retrieval/fact-supersession/FactSupersession.js

@@ -0,0 +1,159 @@
+/**
+ * @file FactSupersession.ts
+ * @description Post-retrieval filter that uses an LLM to identify and
+ * drop memory traces whose factual claims have been superseded by
+ * later traces about the same subject.
+ *
+ * ## What this does
+ *
+ * Given a query and a list of retrieved `ScoredMemoryTrace`s, fires
+ * one LLM call with a strict JSON output contract. The LLM returns
+ * `{ dropIds: string[] }` — trace IDs to remove. The class filters
+ * the input list and returns the survivors in original order.
+ *
+ * ## Failure modes (never throws)
+ *
+ * - Parse error → return original traces + `parse-failed` diagnostic.
+ * - Schema mismatch → return original + `schema-mismatch` diagnostic.
+ * - Timeout → return original + `timeout` diagnostic.
+ * - LLM throws → return original + `llm-error` diagnostic.
+ * - All IDs dropped (adversarial output) → safety clamp, return
+ *   original + `drop-all-rejected` diagnostic.
+ *
+ * ## Why this exists
+ *
+ * The baseline + Hybrid retrieval surfaces BOTH statements when a
+ * user has updated a fact ("I live in NYC" + "I moved to Berlin").
+ * The reader sometimes picks the older or hedges. A supersession
+ * pass gives the reader only the canonical current state.
+ *
+ * @module agentos/memory/retrieval/fact-supersession/FactSupersession
+ */
+/**
+ * Canonical supersession system prompt. Strict rules: supersession
+ * requires contradiction between two claims about the same (subject,
+ * predicate); complementary facts never supersede.
+ */
+const SUPERSESSION_SYSTEM_PROMPT = `You are a fact-supersession analyzer for memory retrieval. Given a user question and N retrieved memory traces, identify traces containing FACTS that have been SUPERSEDED by later traces about the same subject.
+
+Rules:
+1. Supersession requires contradiction — two traces making DIFFERENT claims about the same (subject, predicate).
+2. Use the timestamp field to order claims chronologically. The LATER trace wins.
+3. Traces about DIFFERENT subjects are never mutually superseding.
+4. Complementary facts (different predicates about the same subject) never supersede each other.
+5. Return a JSON object: {"dropIds": ["id1", "id2"]}. Drop ONLY the outdated ones. Return {"dropIds": []} if no supersession detected.
+
+Do not drop traces that are not clearly superseded.`;
+/**
+ * Post-retrieval fact supersession filter.
+ *
+ * @example
+ * ```ts
+ * const fs = new FactSupersession({
+ *   llmInvoker: async (system, user) => (await reader.invoke({ system, user, maxTokens: 200, temperature: 0 })).text,
+ * });
+ * const result = await fs.resolve({ traces: retrieval.retrieved, query: caseQuery });
+ * // Feed `result.traces` to the reader instead of `retrieval.retrieved`.
+ * ```
+ */
+export class FactSupersession {
+    constructor(opts) {
+        this.llmInvoker = opts.llmInvoker;
+        this.maxTraces = opts.maxTraces ?? 10;
+        this.timeoutMs = opts.timeoutMs ?? 8000;
+    }
+    async resolve(input) {
+        const start = Date.now();
+        const notes = [];
+        if (input.traces.length === 0) {
+            return {
+                traces: [],
+                droppedIds: [],
+                diagnostics: { llmLatencyMs: 0, parseOk: true },
+            };
+        }
+        const window = input.traces.slice(0, this.maxTraces);
+        const userPrompt = this.buildUserPrompt(input.query, window);
+        let llmText;
+        try {
+            llmText = await this.invokeWithTimeout(userPrompt);
+        }
+        catch (err) {
+            const reason = err?.message?.includes('timeout')
+                ? 'fact-supersession:timeout'
+                : 'fact-supersession:llm-error';
+            notes.push(reason);
+            return {
+                traces: input.traces,
+                droppedIds: [],
+                diagnostics: { llmLatencyMs: Date.now() - start, parseOk: false, notes },
+            };
+        }
+        const parsed = this.parseDropIds(llmText);
+        if (!parsed.ok) {
+            notes.push(parsed.reason);
+            return {
+                traces: input.traces,
+                droppedIds: [],
+                diagnostics: { llmLatencyMs: Date.now() - start, parseOk: false, notes },
+            };
+        }
+        if (parsed.dropIds.length >= input.traces.length) {
+            notes.push('fact-supersession:drop-all-rejected');
+            return {
+                traces: input.traces,
+                droppedIds: [],
+                diagnostics: { llmLatencyMs: Date.now() - start, parseOk: true, notes },
+            };
+        }
+        const dropSet = new Set(parsed.dropIds);
+        const filtered = input.traces.filter((t) => !dropSet.has(t.id));
+        const realDropped = input.traces
+            .filter((t) => dropSet.has(t.id))
+            .map((t) => t.id);
+        return {
+            traces: filtered,
+            droppedIds: realDropped,
+            diagnostics: {
+                llmLatencyMs: Date.now() - start,
+                parseOk: true,
+                notes: notes.length > 0 ? notes : undefined,
+            },
+        };
+    }
+    buildUserPrompt(query, traces) {
+        const lines = traces.map((t) => {
+            const ts = new Date(t.createdAt).toISOString();
+            const content = t.content.length > 500 ? `${t.content.slice(0, 500)}...` : t.content;
+            return `[id=${t.id} | ts=${ts} | "${content}"]`;
+        });
+        return `Question: ${query}\n\nTraces (id | timestamp | content):\n${lines.join('\n')}\n\nReturn JSON only.`;
+    }
+    async invokeWithTimeout(userPrompt) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error('fact-supersession timeout')), this.timeoutMs);
+            this.llmInvoker(SUPERSESSION_SYSTEM_PROMPT, userPrompt)
+                .then((text) => { clearTimeout(timer); resolve(text); })
+                .catch((err) => { clearTimeout(timer); reject(err); });
+        });
+    }
+    parseDropIds(text) {
+        const cleaned = text.trim().replace(/^```(?:json)?/i, '').replace(/```$/i, '').trim();
+        let obj;
+        try {
+            obj = JSON.parse(cleaned);
+        }
+        catch {
+            return { ok: false, reason: 'fact-supersession:parse-failed' };
+        }
+        if (!obj || typeof obj !== 'object' || !Array.isArray(obj.dropIds)) {
+            return { ok: false, reason: 'fact-supersession:schema-mismatch' };
+        }
+        const arr = obj.dropIds;
+        if (!arr.every((v) => typeof v === 'string')) {
+            return { ok: false, reason: 'fact-supersession:schema-mismatch' };
+        }
+        return { ok: true, dropIds: arr };
+    }
+}
+//# sourceMappingURL=FactSupersession.js.map

package/dist/memory/retrieval/fact-supersession/FactSupersession.js.map

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

package/dist/memory/retrieval/fact-supersession/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @module agentos/memory/retrieval/fact-supersession
+ * @description Post-retrieval LLM-based supersession filter — drops
+ * memory traces whose factual claims have been superseded by later
+ * traces about the same subject. Used to push knowledge-update
+ * accuracy past the ceiling hit by pure retrieval + rerank.
+ */
+export { FactSupersession } from './FactSupersession.js';
+export type { FactSupersessionOptions, FactSupersessionInput, FactSupersessionResult, } from './FactSupersession.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/retrieval/fact-supersession/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/fact-supersession/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC"}

package/dist/memory/retrieval/fact-supersession/index.js

@@ -0,0 +1,9 @@
+/**
+ * @module agentos/memory/retrieval/fact-supersession
+ * @description Post-retrieval LLM-based supersession filter — drops
+ * memory traces whose factual claims have been superseded by later
+ * traces about the same subject. Used to push knowledge-update
+ * accuracy past the ceiling hit by pure retrieval + rerank.
+ */
+export { FactSupersession } from './FactSupersession.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/retrieval/fact-supersession/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/retrieval/fact-supersession/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}