@framers/agentos 0.1.46 → 0.1.48

package/dist/memory/config.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview Configuration types for the Cognitive Memory System.
+ * @module agentos/memory/config
+ */
+import type { IWorkingMemory } from '../cognitive_substrate/memory/IWorkingMemory.js';
+import type { IKnowledgeGraph } from '../core/knowledge/IKnowledgeGraph.js';
+import type { IVectorStore } from '../rag/IVectorStore.js';
+import type { IEmbeddingManager } from '../rag/IEmbeddingManager.js';
+import type { MemoryBudgetAllocation } from './types.js';
+import type { InfiniteContextConfig } from './context/types.js';
+/** Pleasure-Arousal-Dominance emotional state. */
+export interface PADState {
+    valence: number;
+    arousal: number;
+    dominance: number;
+}
+export interface HexacoTraits {
+    honesty?: number;
+    emotionality?: number;
+    extraversion?: number;
+    agreeableness?: number;
+    conscientiousness?: number;
+    openness?: number;
+}
+export interface EncodingConfig {
+    /** Base encoding strength before personality modulation. @default 0.5 */
+    baseStrength: number;
+    /** Emotional intensity threshold for flashbulb memory. @default 0.8 */
+    flashbulbThreshold: number;
+    /** Strength multiplier for flashbulb memories. @default 2.0 */
+    flashbulbStrengthMultiplier: number;
+    /** Stability multiplier for flashbulb memories. @default 5.0 */
+    flashbulbStabilityMultiplier: number;
+    /** Base stability in ms (how long before strength halves). @default 3_600_000 (1 hour) */
+    baseStabilityMs: number;
+}
+export interface DecayConfig {
+    /** Minimum strength before a trace is soft-deleted. @default 0.05 */
+    pruningThreshold: number;
+    /** Half-life for recency boost (ms). @default 86_400_000 (24 hours) */
+    recencyHalfLifeMs: number;
+    /** Cosine similarity threshold for interference detection. @default 0.7 */
+    interferenceThreshold: number;
+}
+export interface ObserverConfig {
+    /** Token threshold before observer activates. @default 30_000 */
+    activationThresholdTokens: number;
+    /** LLM model ID for observation extraction (per-persona). */
+    modelId?: string;
+    /** LLM invoker function. */
+    llmInvoker?: (systemPrompt: string, userPrompt: string) => Promise<string>;
+}
+export interface ReflectorConfig {
+    /** Token threshold for notes before reflection triggers. @default 40_000 */
+    activationThresholdTokens: number;
+    /** LLM model ID for reflection/consolidation (per-persona). */
+    modelId?: string;
+    /** LLM invoker function. */
+    llmInvoker?: (systemPrompt: string, userPrompt: string) => Promise<string>;
+}
+export interface MemoryGraphConfig {
+    /** Which backend to use. @default 'knowledge-graph' */
+    backend: 'graphology' | 'knowledge-graph';
+    /** Max hops for spreading activation. @default 3 */
+    maxDepth: number;
+    /** Activation decay per hop. @default 0.5 */
+    decayPerHop: number;
+    /** Minimum activation to continue spreading. @default 0.1 */
+    activationThreshold: number;
+    /** Hebbian learning rate for co-activation edge strengthening. @default 0.1 */
+    hebbianLearningRate: number;
+}
+export interface ConsolidationConfig {
+    /** How often to run consolidation (ms). @default 3_600_000 (1 hour) */
+    intervalMs: number;
+    /** Max traces to process per cycle. @default 500 */
+    maxTracesPerCycle: number;
+    /** Similarity threshold for merging redundant traces. @default 0.92 */
+    mergeSimilarityThreshold: number;
+    /** Minimum cluster size for schema integration. @default 5 */
+    minClusterSize: number;
+}
+export interface CognitiveMemoryPersonaConfig {
+    /** Feature detection strategy. @default 'keyword' */
+    featureDetectionStrategy?: 'keyword' | 'llm' | 'hybrid';
+    /** Working memory slot capacity override. */
+    workingMemoryCapacity?: number;
+    /** Token budget allocation percentages override. */
+    tokenBudget?: Partial<MemoryBudgetAllocation>;
+    /** Encoding config overrides. */
+    encoding?: Partial<EncodingConfig>;
+    /** Decay config overrides. */
+    decay?: Partial<DecayConfig>;
+    /** Observer config (Batch 2). */
+    observer?: Partial<ObserverConfig>;
+    /** Reflector config (Batch 2). */
+    reflector?: Partial<ReflectorConfig>;
+    /** Memory graph config (Batch 2). */
+    graph?: Partial<MemoryGraphConfig>;
+    /** Infinite context config (Batch 3). */
+    infiniteContext?: Partial<InfiniteContextConfig>;
+}
+export interface CognitiveMemoryConfig {
+    workingMemory: IWorkingMemory;
+    knowledgeGraph: IKnowledgeGraph;
+    vectorStore: IVectorStore;
+    embeddingManager: IEmbeddingManager;
+    agentId: string;
+    traits: HexacoTraits;
+    /** Callback to get current mood from MoodEngine or similar. */
+    moodProvider: () => PADState;
+    /** @default 'keyword' */
+    featureDetectionStrategy: 'keyword' | 'llm' | 'hybrid';
+    /** Required when strategy is 'llm' or 'hybrid'. */
+    featureDetectionLlmInvoker?: (systemPrompt: string, userPrompt: string) => Promise<string>;
+    encoding?: Partial<EncodingConfig>;
+    decay?: Partial<DecayConfig>;
+    /** @default 7 (Miller's number) */
+    workingMemoryCapacity?: number;
+    tokenBudget?: Partial<MemoryBudgetAllocation>;
+    observer?: Partial<ObserverConfig>;
+    reflector?: Partial<ReflectorConfig>;
+    graph?: Partial<MemoryGraphConfig>;
+    consolidation?: Partial<ConsolidationConfig>;
+    /** Infinite context window config. Enables transparent compaction for forever conversations. */
+    infiniteContext?: Partial<InfiniteContextConfig>;
+    /** Max context window size in tokens (required for infinite context). */
+    maxContextTokens?: number;
+    /** @default 'cogmem' */
+    collectionPrefix?: string;
+}
+export declare const DEFAULT_ENCODING_CONFIG: EncodingConfig;
+export declare const DEFAULT_DECAY_CONFIG: DecayConfig;
+export declare const DEFAULT_BUDGET_ALLOCATION: MemoryBudgetAllocation;
+//# sourceMappingURL=config.d.ts.map

package/dist/memory/config.d.ts.map

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

package/dist/memory/config.js

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Configuration types for the Cognitive Memory System.
+ * @module agentos/memory/config
+ */
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+export const DEFAULT_ENCODING_CONFIG = {
+    baseStrength: 0.5,
+    flashbulbThreshold: 0.8,
+    flashbulbStrengthMultiplier: 2.0,
+    flashbulbStabilityMultiplier: 5.0,
+    baseStabilityMs: 3600000,
+};
+export const DEFAULT_DECAY_CONFIG = {
+    pruningThreshold: 0.05,
+    recencyHalfLifeMs: 86400000,
+    interferenceThreshold: 0.7,
+};
+export const DEFAULT_BUDGET_ALLOCATION = {
+    workingMemory: 0.15,
+    semanticRecall: 0.45,
+    recentEpisodic: 0.25,
+    prospectiveAlerts: 0.05,
+    graphAssociations: 0.05,
+    observationNotes: 0.05,
+};
+//# sourceMappingURL=config.js.map

package/dist/memory/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/memory/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6KH,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,YAAY,EAAE,GAAG;IACjB,kBAAkB,EAAE,GAAG;IACvB,2BAA2B,EAAE,GAAG;IAChC,4BAA4B,EAAE,GAAG;IACjC,eAAe,EAAE,OAAS;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,QAAU;IAC7B,qBAAqB,EAAE,GAAG;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAA2B;IAC/D,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;CACvB,CAAC"}

package/dist/memory/consolidation/ConsolidationPipeline.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Consolidation Pipeline — background memory maintenance.
+ *
+ * Runs periodically (default: hourly) to maintain memory health:
+ * 1. Decay sweep — apply Ebbinghaus to all traces, soft-delete below threshold
+ * 2. Replay — re-process recent traces, find co-activation patterns, create graph edges
+ * 3. Schema integration — cluster episodic traces, LLM-summarize into semantic nodes
+ * 4. Conflict resolution — scan CONTRADICTS edges, resolve by confidence + personality
+ * 5. Spaced repetition — boost traces past nextReinforcementAt
+ * 6. Hybrid feature re-classification — if hybrid strategy, re-run LLM on keyword-only traces
+ *
+ * @module agentos/memory/consolidation/ConsolidationPipeline
+ */
+import type { ConsolidationConfig, DecayConfig, HexacoTraits } from '../config.js';
+import type { IMemoryGraph } from '../graph/IMemoryGraph.js';
+import type { MemoryStore } from '../store/MemoryStore.js';
+export interface ConsolidationResult {
+    /** Traces pruned (soft-deleted). */
+    prunedCount: number;
+    /** Co-activation edges created. */
+    edgesCreated: number;
+    /** Schema nodes created from episodic clusters. */
+    schemasCreated: number;
+    /** Conflicts resolved. */
+    conflictsResolved: number;
+    /** Traces reinforced via spaced repetition. */
+    reinforcedCount: number;
+    /** Total traces processed. */
+    totalProcessed: number;
+    /** Duration in ms. */
+    durationMs: number;
+}
+export interface ConsolidationPipelineConfig {
+    store: MemoryStore;
+    graph?: IMemoryGraph;
+    traits: HexacoTraits;
+    agentId: string;
+    decay?: Partial<DecayConfig>;
+    consolidation?: Partial<ConsolidationConfig>;
+    /** LLM invoker for schema integration (optional). */
+    llmInvoker?: (systemPrompt: string, userPrompt: string) => Promise<string>;
+}
+export declare class ConsolidationPipeline {
+    private config;
+    private consolidationConfig;
+    private decayConfig;
+    private timer;
+    private lastRunAt;
+    constructor(config: ConsolidationPipelineConfig);
+    /**
+     * Start the periodic consolidation timer.
+     */
+    start(): void;
+    /**
+     * Stop the periodic consolidation timer.
+     */
+    stop(): void;
+    /**
+     * Run a single consolidation cycle.
+     */
+    run(): Promise<ConsolidationResult>;
+    /** Get timestamp of last consolidation run. */
+    getLastRunAt(): number;
+    private decaySweep;
+    private replayCoActivation;
+    private schemaIntegration;
+    private resolveConflicts;
+    private spacedRepetitionSweep;
+}
+//# sourceMappingURL=ConsolidationPipeline.d.ts.map

package/dist/memory/consolidation/ConsolidationPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsolidationPipeline.d.ts","sourceRoot":"","sources":["../../../src/memory/consolidation/ConsolidationPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGnF,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM3D,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7C,qDAAqD;IACrD,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5E;AAiBD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,mBAAmB,CAAgC;IAC3D,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,SAAS,CAAa;gBAElB,MAAM,EAAE,2BAA2B;IAS/C;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,mBAAmB,CAAC;IA6CzC,+CAA+C;IAC/C,YAAY,IAAI,MAAM;YAQR,UAAU;YAYV,kBAAkB;YA6DlB,iBAAiB;YA2FjB,gBAAgB;YAyChB,qBAAqB;CAepC"}

package/dist/memory/consolidation/ConsolidationPipeline.js

@@ -0,0 +1,301 @@
+/**
+ * @fileoverview Consolidation Pipeline — background memory maintenance.
+ *
+ * Runs periodically (default: hourly) to maintain memory health:
+ * 1. Decay sweep — apply Ebbinghaus to all traces, soft-delete below threshold
+ * 2. Replay — re-process recent traces, find co-activation patterns, create graph edges
+ * 3. Schema integration — cluster episodic traces, LLM-summarize into semantic nodes
+ * 4. Conflict resolution — scan CONTRADICTS edges, resolve by confidence + personality
+ * 5. Spaced repetition — boost traces past nextReinforcementAt
+ * 6. Hybrid feature re-classification — if hybrid strategy, re-run LLM on keyword-only traces
+ *
+ * @module agentos/memory/consolidation/ConsolidationPipeline
+ */
+import { DEFAULT_DECAY_CONFIG } from '../config.js';
+import { findPrunableTraces } from '../decay/DecayModel.js';
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_CONSOLIDATION = {
+    intervalMs: 3600000,
+    maxTracesPerCycle: 500,
+    mergeSimilarityThreshold: 0.92,
+    minClusterSize: 5,
+};
+// ---------------------------------------------------------------------------
+// ConsolidationPipeline
+// ---------------------------------------------------------------------------
+export class ConsolidationPipeline {
+    constructor(config) {
+        this.timer = null;
+        this.lastRunAt = 0;
+        this.config = config;
+        this.consolidationConfig = {
+            ...DEFAULT_CONSOLIDATION,
+            ...config.consolidation,
+        };
+        this.decayConfig = { ...DEFAULT_DECAY_CONFIG, ...config.decay };
+    }
+    /**
+     * Start the periodic consolidation timer.
+     */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => { void this.run(); }, this.consolidationConfig.intervalMs);
+    }
+    /**
+     * Stop the periodic consolidation timer.
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /**
+     * Run a single consolidation cycle.
+     */
+    async run() {
+        const startTime = Date.now();
+        const result = {
+            prunedCount: 0,
+            edgesCreated: 0,
+            schemasCreated: 0,
+            conflictsResolved: 0,
+            reinforcedCount: 0,
+            totalProcessed: 0,
+            durationMs: 0,
+        };
+        const now = Date.now();
+        // Gather traces from the store (scope: user for this agent)
+        const traces = await this.config.store.getByScope('user', this.config.agentId);
+        const batch = traces.slice(0, this.consolidationConfig.maxTracesPerCycle);
+        result.totalProcessed = batch.length;
+        // --- Step 1: Decay sweep ---
+        result.prunedCount = await this.decaySweep(batch, now);
+        // --- Step 2: Co-activation replay ---
+        if (this.config.graph) {
+            result.edgesCreated = await this.replayCoActivation(batch, now);
+        }
+        // --- Step 3: Schema integration ---
+        if (this.config.graph && this.config.llmInvoker) {
+            result.schemasCreated = await this.schemaIntegration();
+        }
+        // --- Step 4: Conflict resolution ---
+        if (this.config.graph) {
+            result.conflictsResolved = await this.resolveConflicts(batch);
+        }
+        // --- Step 5: Spaced repetition reinforcement ---
+        result.reinforcedCount = await this.spacedRepetitionSweep(batch, now);
+        result.durationMs = Date.now() - startTime;
+        this.lastRunAt = now;
+        return result;
+    }
+    /** Get timestamp of last consolidation run. */
+    getLastRunAt() {
+        return this.lastRunAt;
+    }
+    // =========================================================================
+    // Step 1: Decay sweep
+    // =========================================================================
+    async decaySweep(traces, now) {
+        const prunable = findPrunableTraces(traces, now, this.decayConfig);
+        for (const traceId of prunable) {
+            await this.config.store.softDelete(traceId);
+        }
+        return prunable.length;
+    }
+    // =========================================================================
+    // Step 2: Co-activation replay
+    // =========================================================================
+    async replayCoActivation(traces, now) {
+        if (!this.config.graph)
+            return 0;
+        let edgesCreated = 0;
+        const recentTraces = traces.filter((t) => t.isActive && (now - t.createdAt) < 86400000);
+        // Find traces that share entities → create SHARED_ENTITY edges
+        const entityIndex = new Map();
+        for (const trace of recentTraces) {
+            for (const entity of trace.entities) {
+                const list = entityIndex.get(entity) ?? [];
+                list.push(trace.id);
+                entityIndex.set(entity, list);
+            }
+        }
+        for (const [, traceIds] of entityIndex) {
+            if (traceIds.length < 2)
+                continue;
+            for (let i = 0; i < traceIds.length && i < 10; i++) {
+                for (let j = i + 1; j < traceIds.length && j < 10; j++) {
+                    if (this.config.graph.hasNode(traceIds[i]) && this.config.graph.hasNode(traceIds[j])) {
+                        await this.config.graph.addEdge({
+                            sourceId: traceIds[i],
+                            targetId: traceIds[j],
+                            type: 'SHARED_ENTITY',
+                            weight: 0.5,
+                            createdAt: now,
+                        });
+                        edgesCreated++;
+                    }
+                }
+            }
+        }
+        // Find temporally adjacent traces → create TEMPORAL_SEQUENCE edges
+        const sorted = [...recentTraces].sort((a, b) => a.createdAt - b.createdAt);
+        for (let i = 0; i < sorted.length - 1; i++) {
+            const gap = sorted[i + 1].createdAt - sorted[i].createdAt;
+            if (gap < 300000) { // Within 5 minutes
+                if (this.config.graph.hasNode(sorted[i].id) && this.config.graph.hasNode(sorted[i + 1].id)) {
+                    await this.config.graph.addEdge({
+                        sourceId: sorted[i].id,
+                        targetId: sorted[i + 1].id,
+                        type: 'TEMPORAL_SEQUENCE',
+                        weight: 0.3,
+                        createdAt: now,
+                    });
+                    edgesCreated++;
+                }
+            }
+        }
+        return edgesCreated;
+    }
+    // =========================================================================
+    // Step 3: Schema integration
+    // =========================================================================
+    async schemaIntegration() {
+        if (!this.config.graph || !this.config.llmInvoker)
+            return 0;
+        const clusters = await this.config.graph.detectClusters(this.consolidationConfig.minClusterSize);
+        let schemasCreated = 0;
+        for (const cluster of clusters) {
+            // Gather content from cluster members
+            const contents = [];
+            for (const id of cluster.memberIds) {
+                const trace = this.config.store.getTrace(id);
+                if (trace)
+                    contents.push(trace.content);
+            }
+            if (contents.length < this.consolidationConfig.minClusterSize)
+                continue;
+            try {
+                const summary = await this.config.llmInvoker('Summarize the following related memories into a single semantic knowledge statement. Be concise (1-2 sentences). Output only the summary.', contents.join('\n---\n'));
+                if (summary.trim()) {
+                    // Store as a new semantic trace
+                    const now = Date.now();
+                    const schemaTrace = {
+                        id: `schema_${now}_${schemasCreated}`,
+                        type: 'semantic',
+                        scope: 'user',
+                        scopeId: this.config.agentId,
+                        content: summary.trim(),
+                        entities: [],
+                        tags: ['schema', 'consolidated'],
+                        provenance: {
+                            sourceType: 'reflection',
+                            sourceTimestamp: now,
+                            confidence: 0.8,
+                            verificationCount: cluster.memberIds.length,
+                        },
+                        emotionalContext: { valence: 0, arousal: 0, dominance: 0, intensity: 0, gmiMood: '' },
+                        encodingStrength: 0.7,
+                        stability: 7200000, // 2 hours (schemas are more stable)
+                        retrievalCount: 0,
+                        lastAccessedAt: now,
+                        accessCount: 0,
+                        reinforcementInterval: 7200000,
+                        associatedTraceIds: cluster.memberIds,
+                        createdAt: now,
+                        updatedAt: now,
+                        consolidatedAt: now,
+                        isActive: true,
+                    };
+                    await this.config.store.store(schemaTrace);
+                    // Add SCHEMA_INSTANCE edges from cluster members to schema
+                    if (this.config.graph) {
+                        await this.config.graph.addNode(schemaTrace.id, {
+                            type: 'semantic',
+                            scope: 'user',
+                            scopeId: this.config.agentId,
+                            strength: 0.7,
+                            createdAt: now,
+                        });
+                        for (const memberId of cluster.memberIds) {
+                            if (this.config.graph.hasNode(memberId)) {
+                                await this.config.graph.addEdge({
+                                    sourceId: memberId,
+                                    targetId: schemaTrace.id,
+                                    type: 'SCHEMA_INSTANCE',
+                                    weight: 0.6,
+                                    createdAt: now,
+                                });
+                            }
+                        }
+                    }
+                    schemasCreated++;
+                }
+            }
+            catch {
+                // LLM failure is non-critical
+            }
+        }
+        return schemasCreated;
+    }
+    // =========================================================================
+    // Step 4: Conflict resolution
+    // =========================================================================
+    async resolveConflicts(traces) {
+        if (!this.config.graph)
+            return 0;
+        const clamp = (v) => v == null ? 0.5 : Math.max(0, Math.min(1, v));
+        const honesty = clamp(this.config.traits.honesty);
+        let resolved = 0;
+        for (const trace of traces) {
+            if (!trace.isActive)
+                continue;
+            const conflicts = this.config.graph.getConflicts(trace.id);
+            for (const conflict of conflicts) {
+                const otherId = conflict.sourceId === trace.id ? conflict.targetId : conflict.sourceId;
+                const other = this.config.store.getTrace(otherId);
+                if (!other || !other.isActive)
+                    continue;
+                // Determine which trace to keep
+                if (honesty > 0.6) {
+                    // High honesty: prefer newer information
+                    const loser = trace.createdAt > other.createdAt ? other : trace;
+                    await this.config.store.softDelete(loser.id);
+                    resolved++;
+                }
+                else {
+                    // Default: prefer higher confidence
+                    if (Math.abs(trace.provenance.confidence - other.provenance.confidence) > 0.2) {
+                        const loser = trace.provenance.confidence < other.provenance.confidence ? trace : other;
+                        await this.config.store.softDelete(loser.id);
+                        resolved++;
+                    }
+                    // If confidence is similar, let both coexist
+                }
+            }
+        }
+        return resolved;
+    }
+    // =========================================================================
+    // Step 5: Spaced repetition sweep
+    // =========================================================================
+    async spacedRepetitionSweep(traces, now) {
+        let reinforced = 0;
+        for (const trace of traces) {
+            if (!trace.isActive)
+                continue;
+            if (!trace.nextReinforcementAt)
+                continue;
+            if (now < trace.nextReinforcementAt)
+                continue;
+            // Boost the trace via recordAccess
+            await this.config.store.recordAccess(trace.id);
+            reinforced++;
+        }
+        return reinforced;
+    }
+}
+//# sourceMappingURL=ConsolidationPipeline.js.map

package/dist/memory/consolidation/ConsolidationPipeline.js.map

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

package/dist/memory/context/CompactionEngine.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CompactionEngine — Strategy dispatcher for context window compaction.
+ *
+ * Selects and executes the appropriate compaction strategy based on config.
+ * Manages strategy lifecycle and provides a unified interface for the
+ * ContextWindowManager.
+ */
+import type { MemoryObserver } from '../observation/MemoryObserver.js';
+import type { MemoryReflector } from '../observation/MemoryReflector.js';
+import type { CompactionInput, CompactionResult, CompactionStrategy, ICompactionStrategy, InfiniteContextConfig } from './types.js';
+export declare class CompactionEngine {
+    private strategies;
+    constructor(llmInvoker: (prompt: string) => Promise<string>, observer?: MemoryObserver, reflector?: MemoryReflector);
+    /** Run compaction using the configured strategy. */
+    compact(input: CompactionInput, config: InfiniteContextConfig): Promise<CompactionResult>;
+    /** Get a specific strategy instance. */
+    getStrategy(name: CompactionStrategy): ICompactionStrategy | undefined;
+    /** List available strategy names. */
+    getAvailableStrategies(): CompactionStrategy[];
+}
+//# sourceMappingURL=CompactionEngine.d.ts.map

package/dist/memory/context/CompactionEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompactionEngine.d.ts","sourceRoot":"","sources":["../../../src/memory/context/CompactionEngine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAKpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA2D;gBAG3E,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC/C,QAAQ,CAAC,EAAE,cAAc,EACzB,SAAS,CAAC,EAAE,eAAe;IAa7B,oDAAoD;IAC9C,OAAO,CACX,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,gBAAgB,CAAC;IAQ5B,wCAAwC;IACxC,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,SAAS;IAItE,qCAAqC;IACrC,sBAAsB,IAAI,kBAAkB,EAAE;CAG/C"}

package/dist/memory/context/CompactionEngine.js

@@ -0,0 +1,35 @@
+/**
+ * CompactionEngine — Strategy dispatcher for context window compaction.
+ *
+ * Selects and executes the appropriate compaction strategy based on config.
+ * Manages strategy lifecycle and provides a unified interface for the
+ * ContextWindowManager.
+ */
+import { HierarchicalStrategy } from './strategies/HierarchicalStrategy.js';
+import { HybridStrategy } from './strategies/HybridStrategy.js';
+import { SlidingSummaryStrategy } from './strategies/SlidingSummaryStrategy.js';
+export class CompactionEngine {
+    constructor(llmInvoker, observer, reflector) {
+        this.strategies = new Map();
+        this.strategies.set('sliding', new SlidingSummaryStrategy(llmInvoker));
+        this.strategies.set('hierarchical', new HierarchicalStrategy(llmInvoker));
+        this.strategies.set('hybrid', new HybridStrategy(llmInvoker, observer, reflector));
+    }
+    /** Run compaction using the configured strategy. */
+    async compact(input, config) {
+        const strategy = this.strategies.get(config.strategy);
+        if (!strategy) {
+            throw new Error(`Unknown compaction strategy: ${config.strategy}`);
+        }
+        return strategy.compact(input, config);
+    }
+    /** Get a specific strategy instance. */
+    getStrategy(name) {
+        return this.strategies.get(name);
+    }
+    /** List available strategy names. */
+    getAvailableStrategies() {
+        return Array.from(this.strategies.keys());
+    }
+}
+//# sourceMappingURL=CompactionEngine.js.map

package/dist/memory/context/CompactionEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompactionEngine.js","sourceRoot":"","sources":["../../../src/memory/context/CompactionEngine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,MAAM,OAAO,gBAAgB;IAG3B,YACE,UAA+C,EAC/C,QAAyB,EACzB,SAA2B;QALrB,eAAU,GAAiD,IAAI,GAAG,EAAE,CAAC;QAO3E,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,CAAC,GAAG,CACjB,cAAc,EACd,IAAI,oBAAoB,CAAC,UAAU,CAAC,CACrC,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,GAAG,CACjB,QAAQ,EACR,IAAI,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CACpD,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,OAAO,CACX,KAAsB,EACtB,MAA6B;QAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,wCAAwC;IACxC,WAAW,CAAC,IAAwB;QAClC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,qCAAqC;IACrC,sBAAsB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF"}