Skip to main content

Interface: ConsolidationConfig

Defined in: packages/agentos/src/memory/core/config.ts:134

Properties​

deriveInsights?​

optional deriveInsights: boolean

Defined in: packages/agentos/src/memory/core/config.ts:194

Whether the consolidation engine should derive new insight traces from clusters of related memories during each cycle.

Default​

true

enabled?​

optional enabled: boolean

Defined in: packages/agentos/src/memory/core/config.ts:146

Whether the periodic consolidation timer is active. Set to false for short-lived contexts (benches, tests, one-shot scripts) where a lingering setInterval would keep the Node event loop alive past the meaningful work.

When false, CognitiveMemoryManager still constructs the pipeline so runConsolidation() works on-demand; only the auto-started timer is suppressed.

Default​

true

every?​

optional every: number

Defined in: packages/agentos/src/memory/core/config.ts:173

Numeric complement to trigger. When trigger='turns' this is the turn count; when trigger='interval' this is the millisecond period.

Default​

3_600_000

intervalMs​

intervalMs: number

Defined in: packages/agentos/src/memory/core/config.ts:148

How often to run consolidation (ms).

Default​

3_600_000 (1 hour)

maxDerivedPerCycle?​

optional maxDerivedPerCycle: number

Defined in: packages/agentos/src/memory/core/config.ts:201

Maximum number of new insight traces the engine may derive per cycle. Guards against unbounded graph growth.

Default​

10

maxTracesPerCycle​

maxTracesPerCycle: number

Defined in: packages/agentos/src/memory/core/config.ts:150

Max traces to process per cycle.

Default​

500

mergeSimilarityThreshold​

mergeSimilarityThreshold: number

Defined in: packages/agentos/src/memory/core/config.ts:152

Similarity threshold for merging redundant traces.

Default​

0.92

mergeThreshold?​

optional mergeThreshold: number

Defined in: packages/agentos/src/memory/core/config.ts:187

Cosine similarity above which two traces are candidates for merging. Must be between 0 and 1.

Default​

0.92

minClusterSize​

minClusterSize: number

Defined in: packages/agentos/src/memory/core/config.ts:154

Minimum cluster size for schema integration.

Default​

5

pruneThreshold?​

optional pruneThreshold: number

Defined in: packages/agentos/src/memory/core/config.ts:180

Minimum Ebbinghaus strength below which a trace is pruned. Must be between 0 and 1.

Default​

0.05

trigger?​

optional trigger: "manual" | "turns" | "interval"

Defined in: packages/agentos/src/memory/core/config.ts:165

What event or schedule triggers a consolidation run.

  • 'turns' – fire after every N conversation turns (every = turn count).
  • 'interval' – fire on a wall-clock timer (every = milliseconds).
  • 'manual' – only fire when explicitly requested.

Default​

'interval'