Skip to main content

Interface: ExtendedConsolidationConfig

Defined in: packages/agentos/src/memory/facade/types.ts:52

Extended consolidation configuration that adds lifecycle-management fields on top of the core ConsolidationConfig used internally.

The trigger + every pair replace the internal intervalMs at the facade level; adapters translate these to the internal representation.

Properties​

deriveInsights?​

optional deriveInsights: boolean

Defined in: packages/agentos/src/memory/facade/types.ts:89

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

Default​

true

every?​

optional every: number

Defined in: packages/agentos/src/memory/facade/types.ts:68

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

Default​

3_600_000

intervalMs?​

optional intervalMs: number

Defined in: packages/agentos/src/memory/facade/types.ts:105

How often to run consolidation in milliseconds (internal scheduler). Superseded by trigger+every at the facade level; kept for compatibility.

Default​

3_600_000

maxDerivedPerCycle?​

optional maxDerivedPerCycle: number

Defined in: packages/agentos/src/memory/facade/types.ts:96

Maximum number of new insight traces derived per consolidation cycle. Guards against unbounded graph growth.

Default​

10

maxTracesPerCycle?​

optional maxTracesPerCycle: number

Defined in: packages/agentos/src/memory/facade/types.ts:112

Maximum number of traces to process per consolidation cycle. Bounds CPU/memory cost of a single run.

Default​

500

mergeSimilarityThreshold?​

optional mergeSimilarityThreshold: number

Defined in: packages/agentos/src/memory/facade/types.ts:118

Similarity threshold used when merging redundant traces.

Default​

0.92

mergeThreshold?​

optional mergeThreshold: number

Defined in: packages/agentos/src/memory/facade/types.ts:82

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

Default​

0.92

minClusterSize?​

optional minClusterSize: number

Defined in: packages/agentos/src/memory/facade/types.ts:124

Minimum cluster size required before schema integration fires.

Default​

5

pruneThreshold?​

optional pruneThreshold: number

Defined in: packages/agentos/src/memory/facade/types.ts:75

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

Default​

0.05

trigger?​

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

Defined in: packages/agentos/src/memory/facade/types.ts:60

What event or schedule triggers a consolidation run.

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

Default​

'interval'