@dcyfr/ai 2.1.3 → 3.0.0

package/dist/ai/src/compaction/context-compactor.d.ts

@@ -0,0 +1,149 @@
+/**
+ * @module compaction/context-compactor
+ * @description Context compaction with LLM-powered pre-flush summarization.
+ *
+ * Implements a three-stage compaction pipeline:
+ * 1. Monitor — calculate context utilization
+ * 2. Pre-flush — LLM-powered summarization before compaction
+ * 3. Compact — remove oldest turns, inject summary
+ *
+ * @license MIT
+ * @copyright DCYFR Labs (https://www.dcyfr.ai)
+ */
+import type { DCYFRMemory } from '../../memory/types.js';
+export interface ContextCompactorConfig {
+    /** Context utilization threshold (0-1) to trigger compaction. Default: 0.7 */
+    threshold?: number;
+    /** Number of recent turns to preserve after compaction. Default: 5 */
+    preserveRecentTurns?: number;
+    /** Maximum tokens for the summary. Default: 500 */
+    maxSummaryTokens?: number;
+    /** Token counter function. Default: rough estimate (4 chars = 1 token) */
+    tokenCounter?: (text: string) => number;
+    /** LLM call function for pre-flush summarization */
+    llmCall?: (prompt: string, systemPrompt: string) => Promise<string>;
+    /** Memory adapter for persisting pre-flush summaries */
+    memory?: DCYFRMemory;
+    /** Enable debug logging. Default: false */
+    debug?: boolean;
+}
+export interface ContextMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    timestamp?: Date;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentContext {
+    /** System prompt */
+    systemPrompt: string;
+    /** Injected skills */
+    skills?: string;
+    /** Retrieved memories */
+    memories?: string;
+    /** Conversation turns */
+    messages: ContextMessage[];
+    /** Tool results from current turn */
+    toolResults?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface ContextUtilization {
+    /** Total tokens used */
+    totalTokens: number;
+    /** Context window size (model maximum) */
+    windowSize: number;
+    /** Utilization ratio (0-1) */
+    utilization: number;
+    /** Breakdown by component */
+    breakdown: {
+        systemPrompt: number;
+        skills: number;
+        memories: number;
+        conversation: number;
+        toolResults: number;
+    };
+    /** Whether compaction is recommended */
+    shouldCompact: boolean;
+    /** Estimated tokens to free via compaction */
+    estimatedSavings: number;
+}
+export interface PreFlushSummary {
+    /** Key facts extracted from conversation */
+    facts: string[];
+    /** Decisions made during conversation */
+    decisions: string[];
+    /** Outstanding questions or tasks */
+    outstandingQuestions: string[];
+    /** Conversation summary for injection */
+    summary: string;
+    /** Timestamp of pre-flush */
+    timestamp: Date;
+    /** Original turn count before flush */
+    originalTurnCount: number;
+}
+export interface CompactionResult {
+    /** Whether compaction was performed */
+    compacted: boolean;
+    /** Tokens before compaction */
+    tokensBefore: number;
+    /** Tokens after compaction */
+    tokensAfter: number;
+    /** Tokens saved */
+    tokensSaved: number;
+    /** Pre-flush summary (if performed) */
+    preFlushSummary?: PreFlushSummary;
+    /** Error if compaction failed */
+    error?: string;
+}
+export declare class ContextCompactor {
+    private readonly threshold;
+    private readonly preserveRecentTurns;
+    private readonly maxSummaryTokens;
+    private readonly tokenCounter;
+    private readonly llmCall?;
+    private readonly memory?;
+    private readonly debug;
+    private readonly contextWindowSize;
+    private lastPreFlushSummary?;
+    private preFlushRetryPending;
+    constructor(config?: ContextCompactorConfig);
+    /**
+     * Calculate context utilization and breakdown by component.
+     */
+    calculateUtilization(context: AgentContext): ContextUtilization;
+    /**
+     * Generate an LLM-powered summary before compaction.
+     * Extracts facts, decisions, and outstanding questions.
+     */
+    preFlush(context: AgentContext): Promise<PreFlushSummary | null>;
+    /**
+     * Compact the context by removing older turns and injecting a summary.
+     */
+    compact(context: AgentContext): Promise<CompactionResult>;
+    /**
+     * Priority for hook registration.
+     * Lower numbers execute first.
+     * Security hooks: 0
+     * Context compaction: 50
+     * User hooks: 100
+     */
+    static readonly HOOK_PRIORITY = 50;
+    /**
+     * Execute compaction as a beforeExecute hook.
+     * Returns the potentially modified context.
+     */
+    executeAsHook(context: AgentContext): Promise<AgentContext>;
+    /**
+     * Get the last pre-flush summary (useful for debugging/auditing).
+     */
+    getLastPreFlushSummary(): PreFlushSummary | undefined;
+    /**
+     * Whether a pre-flush retry is pending.
+     */
+    isPreFlushRetryPending(): boolean;
+    /**
+     * Clear the pending retry flag (for testing).
+     */
+    clearPreFlushRetryPending(): void;
+}
+//# sourceMappingURL=context-compactor.d.ts.map

package/dist/ai/src/compaction/context-compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compactor.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/compaction/context-compactor.ts"],"names":[],"mappings":"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"}

package/dist/ai/src/compaction/context-compactor.js

@@ -0,0 +1,302 @@
+/**
+ * @module compaction/context-compactor
+ * @description Context compaction with LLM-powered pre-flush summarization.
+ *
+ * Implements a three-stage compaction pipeline:
+ * 1. Monitor — calculate context utilization
+ * 2. Pre-flush — LLM-powered summarization before compaction
+ * 3. Compact — remove oldest turns, inject summary
+ *
+ * @license MIT
+ * @copyright DCYFR Labs (https://www.dcyfr.ai)
+ */
+/* ------------------------------------------------------------------ */
+/*  Constants                                                          */
+/* ------------------------------------------------------------------ */
+const DEFAULT_MODEL_CONTEXT_WINDOW = 128000; // Claude 3.5 / GPT-4o default
+const PRE_FLUSH_SYSTEM_PROMPT = `You are a context compaction assistant. Your job is to extract key information from a conversation before it is summarized.
+
+Extract the following in JSON format:
+{
+  "facts": ["fact 1", "fact 2", ...],
+  "decisions": ["decision 1", "decision 2", ...],
+  "outstandingQuestions": ["question 1", "question 2", ...],
+  "summary": "Brief summary of the conversation..."
+}
+
+Rules:
+- Facts should be concrete, actionable pieces of information learned
+- Decisions should be choices or conclusions reached during the conversation
+- Outstanding questions should be unresolved queries or pending tasks
+- Summary should be 2-3 sentences capturing the essence of the conversation
+- Be concise — this output will be injected into future context`;
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                            */
+/* ------------------------------------------------------------------ */
+function defaultTokenCounter(text) {
+    // Rough estimate: ~4 characters per token for English text
+    return Math.ceil(text.length / 4);
+}
+function countMessageTokens(messages, counter) {
+    return messages.reduce((sum, msg) => sum + counter(msg.content), 0);
+}
+function formatConversationForSummary(messages) {
+    return messages
+        .map((m) => `[${m.role.toUpperCase()}]: ${m.content.slice(0, 1000)}`)
+        .join('\n\n');
+}
+function parsePreFlushResponse(response) {
+    try {
+        // Try to extract JSON from the response
+        const jsonMatch = /\{[\s\S]*\}/.exec(response);
+        if (jsonMatch) {
+            const parsed = JSON.parse(jsonMatch[0]);
+            return {
+                facts: Array.isArray(parsed.facts) ? parsed.facts : [],
+                decisions: Array.isArray(parsed.decisions) ? parsed.decisions : [],
+                outstandingQuestions: Array.isArray(parsed.outstandingQuestions) ? parsed.outstandingQuestions : [],
+                summary: typeof parsed.summary === 'string' ? parsed.summary : 'No summary available.',
+            };
+        }
+    }
+    catch {
+        // Fall through to default
+    }
+    // Fallback: treat entire response as summary
+    return {
+        facts: [],
+        decisions: [],
+        outstandingQuestions: [],
+        summary: response.slice(0, 500),
+    };
+}
+function buildSummaryInjection(summary) {
+    const parts = [
+        '<!-- Previous Context Summary -->',
+        '',
+        `**Summary:** ${summary.summary}`,
+    ];
+    if (summary.facts.length > 0) {
+        parts.push('', '**Key Facts:**');
+        summary.facts.forEach((f) => parts.push(`- ${f}`));
+    }
+    if (summary.decisions.length > 0) {
+        parts.push('', '**Decisions Made:**');
+        summary.decisions.forEach((d) => parts.push(`- ${d}`));
+    }
+    if (summary.outstandingQuestions.length > 0) {
+        parts.push('', '**Outstanding Questions:**');
+        summary.outstandingQuestions.forEach((q) => parts.push(`- ${q}`));
+    }
+    parts.push('', '<!-- End Previous Context Summary -->', '');
+    return parts.join('\n');
+}
+/* ------------------------------------------------------------------ */
+/*  ContextCompactor                                                   */
+/* ------------------------------------------------------------------ */
+export class ContextCompactor {
+    threshold;
+    preserveRecentTurns;
+    maxSummaryTokens;
+    tokenCounter;
+    llmCall;
+    memory;
+    debug;
+    contextWindowSize;
+    lastPreFlushSummary;
+    preFlushRetryPending = false;
+    constructor(config = {}) {
+        this.threshold = config.threshold ?? 0.7;
+        this.preserveRecentTurns = config.preserveRecentTurns ?? 5;
+        this.maxSummaryTokens = config.maxSummaryTokens ?? 500;
+        this.tokenCounter = config.tokenCounter ?? defaultTokenCounter;
+        this.llmCall = config.llmCall;
+        this.memory = config.memory;
+        this.debug = config.debug ?? false;
+        this.contextWindowSize = DEFAULT_MODEL_CONTEXT_WINDOW;
+    }
+    /* ---- Stage 1: Monitor ------------------------------------------ */
+    /**
+     * Calculate context utilization and breakdown by component.
+     */
+    calculateUtilization(context) {
+        const systemPromptTokens = this.tokenCounter(context.systemPrompt);
+        const skillsTokens = context.skills ? this.tokenCounter(context.skills) : 0;
+        const memoriesTokens = context.memories ? this.tokenCounter(context.memories) : 0;
+        const conversationTokens = countMessageTokens(context.messages, this.tokenCounter);
+        const toolResultsTokens = context.toolResults ? this.tokenCounter(context.toolResults) : 0;
+        const totalTokens = systemPromptTokens + skillsTokens + memoriesTokens + conversationTokens + toolResultsTokens;
+        const utilization = totalTokens / this.contextWindowSize;
+        // Estimate savings: remove all but recent turns, add summary
+        const recentTurns = context.messages.slice(-this.preserveRecentTurns);
+        const recentTokens = countMessageTokens(recentTurns, this.tokenCounter);
+        const estimatedSavings = Math.max(0, conversationTokens - recentTokens - this.maxSummaryTokens);
+        return {
+            totalTokens,
+            windowSize: this.contextWindowSize,
+            utilization,
+            breakdown: {
+                systemPrompt: systemPromptTokens,
+                skills: skillsTokens,
+                memories: memoriesTokens,
+                conversation: conversationTokens,
+                toolResults: toolResultsTokens,
+            },
+            shouldCompact: utilization >= this.threshold,
+            estimatedSavings,
+        };
+    }
+    /* ---- Stage 2: Pre-Flush ---------------------------------------- */
+    /**
+     * Generate an LLM-powered summary before compaction.
+     * Extracts facts, decisions, and outstanding questions.
+     */
+    async preFlush(context) {
+        if (!this.llmCall) {
+            if (this.debug) {
+                console.warn('[ContextCompactor] preFlush skipped: no llmCall configured');
+            }
+            return null;
+        }
+        const conversationText = formatConversationForSummary(context.messages);
+        const prompt = `Analyze this conversation and extract key information:\n\n${conversationText}`;
+        try {
+            const response = await this.llmCall(prompt, PRE_FLUSH_SYSTEM_PROMPT);
+            const parsed = parsePreFlushResponse(response);
+            const summary = {
+                ...parsed,
+                timestamp: new Date(),
+                originalTurnCount: context.messages.length,
+            };
+            // Persist to memory if configured
+            if (this.memory) {
+                await this.memory.addAgentMemory('context-compactor', `preflush-${Date.now()}`, { type: 'preFlushSummary', ...summary });
+            }
+            this.lastPreFlushSummary = summary;
+            this.preFlushRetryPending = false;
+            if (this.debug) {
+                console.log('[ContextCompactor] preFlush completed:', {
+                    facts: summary.facts.length,
+                    decisions: summary.decisions.length,
+                    outstandingQuestions: summary.outstandingQuestions.length,
+                });
+            }
+            return summary;
+        }
+        catch (error) {
+            if (this.debug) {
+                console.error('[ContextCompactor] preFlush failed:', error);
+            }
+            // Mark for retry on next turn (graceful degradation)
+            this.preFlushRetryPending = true;
+            return null;
+        }
+    }
+    /* ---- Stage 3: Compact ------------------------------------------ */
+    /**
+     * Compact the context by removing older turns and injecting a summary.
+     */
+    async compact(context) {
+        const utilization = this.calculateUtilization(context);
+        const tokensBefore = utilization.totalTokens;
+        if (!utilization.shouldCompact) {
+            return {
+                compacted: false,
+                tokensBefore,
+                tokensAfter: tokensBefore,
+                tokensSaved: 0,
+            };
+        }
+        // Stage 2: Pre-flush if we have an LLM
+        let preFlushSummary = await this.preFlush(context);
+        // Graceful degradation: if pre-flush failed and we have a pending retry, skip compaction this turn
+        if (!preFlushSummary && this.preFlushRetryPending && !this.lastPreFlushSummary) {
+            if (this.debug) {
+                console.warn('[ContextCompactor] compact deferred: waiting for pre-flush retry');
+            }
+            return {
+                compacted: false,
+                tokensBefore,
+                tokensAfter: tokensBefore,
+                tokensSaved: 0,
+                error: 'Pre-flush failed, retrying on next turn',
+            };
+        }
+        // Use last successful summary if current pre-flush failed
+        if (!preFlushSummary && this.lastPreFlushSummary) {
+            preFlushSummary = this.lastPreFlushSummary;
+        }
+        // Keep only recent turns
+        const recentTurns = context.messages.slice(-this.preserveRecentTurns);
+        // Build compacted messages
+        const compactedMessages = [];
+        // Inject summary as a system-like message if available
+        if (preFlushSummary) {
+            const summaryContent = buildSummaryInjection(preFlushSummary);
+            compactedMessages.push({
+                role: 'assistant',
+                content: summaryContent,
+                timestamp: new Date(),
+                metadata: { type: 'context_summary', originalTurnCount: preFlushSummary.originalTurnCount },
+            });
+        }
+        // Add recent turns
+        compactedMessages.push(...recentTurns);
+        // Update context in place
+        context.messages.length = 0;
+        context.messages.push(...compactedMessages);
+        // Calculate new token count
+        const newUtilization = this.calculateUtilization(context);
+        const tokensAfter = newUtilization.totalTokens;
+        return {
+            compacted: true,
+            tokensBefore,
+            tokensAfter,
+            tokensSaved: tokensBefore - tokensAfter,
+            preFlushSummary: preFlushSummary ?? undefined,
+        };
+    }
+    /* ---- Hook interface -------------------------------------------- */
+    /**
+     * Priority for hook registration.
+     * Lower numbers execute first.
+     * Security hooks: 0
+     * Context compaction: 50
+     * User hooks: 100
+     */
+    static HOOK_PRIORITY = 50;
+    /**
+     * Execute compaction as a beforeExecute hook.
+     * Returns the potentially modified context.
+     */
+    async executeAsHook(context) {
+        const result = await this.compact(context);
+        if (this.debug && result.compacted) {
+            console.log('[ContextCompactor] hook executed:', {
+                tokensSaved: result.tokensSaved,
+                newUtilization: this.calculateUtilization(context).utilization,
+            });
+        }
+        return context;
+    }
+    /* ---- Lifecycle ------------------------------------------------- */
+    /**
+     * Get the last pre-flush summary (useful for debugging/auditing).
+     */
+    getLastPreFlushSummary() {
+        return this.lastPreFlushSummary;
+    }
+    /**
+     * Whether a pre-flush retry is pending.
+     */
+    isPreFlushRetryPending() {
+        return this.preFlushRetryPending;
+    }
+    /**
+     * Clear the pending retry flag (for testing).
+     */
+    clearPreFlushRetryPending() {
+        this.preFlushRetryPending = false;
+    }
+}
+//# sourceMappingURL=context-compactor.js.map

package/dist/ai/src/compaction/context-compactor.js.map

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

package/dist/ai/src/compaction/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Context Compaction Module
+ *
+ * Provides automatic context window management with LLM-powered
+ * pre-flush summarization to preserve critical information.
+ *
+ * @packageDocumentation
+ */
+export { ContextCompactor, type ContextCompactorConfig, type ContextMessage, type AgentContext, type ContextUtilization, type PreFlushSummary, type CompactionResult, } from './context-compactor.js';
+export { MemoryCompaction, type MemoryCompactionConfig, type MemoryEntry, type DeduplicationResult, type ConversationSummaryResult, type FactArchivalResult, } from './memory-compaction.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/src/compaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/compaction/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/ai/src/compaction/index.js

@@ -0,0 +1,11 @@
+/**
+ * Context Compaction Module
+ *
+ * Provides automatic context window management with LLM-powered
+ * pre-flush summarization to preserve critical information.
+ *
+ * @packageDocumentation
+ */
+export { ContextCompactor, } from './context-compactor.js';
+export { MemoryCompaction, } from './memory-compaction.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/src/compaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/ai/src/compaction/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,gBAAgB,GAOjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,GAMjB,MAAM,wBAAwB,CAAC"}

package/dist/ai/src/compaction/memory-compaction.d.ts

@@ -0,0 +1,138 @@
+/**
+ * @module compaction/memory-compaction
+ * @description Memory compaction utilities for FileMemoryAdapter.
+ *
+ * Extends context compaction to:
+ * 1. Deduplicate entries across file-based and mem0 backends
+ * 2. Use hybrid search (BM25 + vector) for dedup when SQLite index available
+ * 3. Consolidate conversation files >N days old into monthly summaries
+ * 4. Archive contradicted/stale facts instead of deleting
+ *
+ * @license MIT
+ * @copyright DCYFR Labs (https://www.dcyfr.ai)
+ */
+export interface MemoryEntry {
+    /** Unique ID */
+    id: string;
+    /** Memory content */
+    content: string;
+    /** Source backend: 'file' or 'mem0' */
+    source: 'file' | 'mem0';
+    /** SHA-256 of content */
+    hash: string;
+    /** Timestamp */
+    timestamp: string;
+    /** Topic/category */
+    topic?: string;
+    /** Owner (userId or agentId) */
+    owner?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface DeduplicationResult {
+    /** Total entries before dedup */
+    totalBefore: number;
+    /** Total entries after dedup */
+    totalAfter: number;
+    /** Number of duplicates removed */
+    duplicatesRemoved: number;
+    /** Entries kept (deduplicated) */
+    entries: MemoryEntry[];
+    /** Duplicate pairs found */
+    duplicatePairs: Array<{
+        kept: string;
+        removed: string;
+        similarity: number;
+    }>;
+}
+export interface ConversationSummaryResult {
+    /** Number of conversation files processed */
+    filesProcessed: number;
+    /** Number of monthly summaries created */
+    summariesCreated: number;
+    /** Paths of created summary files */
+    summaryPaths: string[];
+    /** Paths of archived conversation files */
+    archivedPaths: string[];
+}
+export interface FactArchivalResult {
+    /** Number of facts evaluated */
+    factsEvaluated: number;
+    /** Number of stale facts archived */
+    factsArchived: number;
+    /** Archived facts with reasons */
+    archivedFacts: Array<{
+        id: string;
+        content: string;
+        reason: string;
+    }>;
+    /** Path to archive file */
+    archivePath: string;
+}
+export interface MemoryCompactionConfig {
+    /** Memory root directory (default: ~/.dcyfr/memory) */
+    rootDir: string;
+    /** Agent ID for namespacing */
+    agentId: string;
+    /** BM25 similarity threshold for dedup (0-1). Default: 0.85 */
+    dedupThreshold?: number;
+    /** Conversation retention period in days. Default: 30 */
+    retentionDays?: number;
+    /** Optional LLM function for fact contradiction detection */
+    llmCall?: (prompt: string, systemPrompt: string) => Promise<string>;
+    /** Optional embedding function for vector-based dedup */
+    embedFn?: (text: string) => Promise<number[]>;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export declare class MemoryCompaction {
+    private readonly rootDir;
+    private readonly agentId;
+    private readonly dedupThreshold;
+    private readonly retentionDays;
+    private readonly llmCall?;
+    private readonly embedFn?;
+    private readonly debug;
+    constructor(config: MemoryCompactionConfig);
+    /**
+     * Deduplicate memory entries across file and mem0 backends.
+     *
+     * Algorithm:
+     * 1. Collect all entries from file backend
+     * 2. Collect all entries from mem0 backend (if provided)
+     * 3. Hash-based exact dedup (O(n))
+     * 4. Similarity-based fuzzy dedup (O(n²) but typically small n)
+     * 5. Keep file-backend entries over mem0 (file is source of truth)
+     */
+    deduplicateEntries(fileEntries: MemoryEntry[], mem0Entries?: MemoryEntry[]): DeduplicationResult;
+    /**
+     * Enhanced deduplication using vector embeddings when available.
+     * Falls back to BM25-only (textSimilarity) when embeddings unavailable.
+     */
+    deduplicateWithHybridSearch(entries: MemoryEntry[]): Promise<DeduplicationResult>;
+    /**
+     * Consolidate conversation files older than retentionDays into monthly summaries.
+     *
+     * 1. Scan conversations directory for files older than threshold
+     * 2. Group by month
+     * 3. Generate summary per month (LLM if available, else concatenate)
+     * 4. Write summary to summaries directory
+     * 5. Move original files to archive
+     */
+    compactConversations(): Promise<ConversationSummaryResult>;
+    /**
+     * Archive stale or contradicted facts to facts-archived.md.
+     *
+     * Strategy:
+     * 1. Read all facts from facts.md
+     * 2. Detect contradictions (LLM-powered when available)
+     * 3. Move stale/contradicted facts to facts-archived.md
+     * 4. Rewrite facts.md without archived entries
+     */
+    archiveStaleFacts(): Promise<FactArchivalResult>;
+    private _fallbackSummary;
+    private _detectContradictions;
+    private _detectContradictionsWithLLM;
+    private _detectContradictionsHeuristic;
+}
+//# sourceMappingURL=memory-compaction.d.ts.map

package/dist/ai/src/compaction/memory-compaction.d.ts.map

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