Class ContextWindowGarbageCollector

java.lang.Object

uno.anahata.asi.agi.event.BasicPropertyChangeSource

uno.anahata.asi.agi.context.ContextWindowGarbageCollector

All Implemented Interfaces:

PropertyChangeSource, Rebindable

public class ContextWindowGarbageCollector
extends BasicPropertyChangeSource

Orchestrates the monitoring and logging of the Context Window Garbage Collection (CwGC). This class calculates high-fidelity metrics for prompt load and recycling efficiency using a one-pass calculation strategy.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ContextWindowGarbageCollector.Stats	Data object containing the categorized token metrics.

Field Summary

Fields

Modifier and Type	Field	Description
private final ContextManager	contextManager	The parent ContextManager orchestrating the active session.
private final List<GarbageCollectorRecord>	logRecords	The concurrent log records of all garbage collection sweeps.
private ContextWindowGarbageCollector.Stats	stats	The results of the last token calculation pass.

Fields inherited from class BasicPropertyChangeSource

propertyChangeSupport

Constructor Summary

Constructors

Constructor	Description
ContextWindowGarbageCollector(@NonNull ContextManager contextManager)	Constructs a ContextWindowGarbageCollector with its parent manager.

Method Summary

Modifier and Type	Method	Description
void	calculate()	Performs a comprehensive, one-pass calculation of all token metrics in the current context.
void	clearLog()	Clears the collection logs.
List<GarbageCollectorRecord>	getRecords()	Gets an unmodifiable view of the collection log.
void	recordCollection(@NonNull AbstractMessage message)	Records the recycling of a message turn.
private String	summarizeParts(AbstractMessage message)	Generates a compact parts summary string for a message being garbage collected.

Methods inherited from class BasicPropertyChangeSource

addPropertyChangeListener, addPropertyChangeListener, rebind, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface PropertyChangeSource

getPropertyChangeSupport

Field Details

contextManager

private final ContextManager contextManager

The parent ContextManager orchestrating the active session.

logRecords

private final List<GarbageCollectorRecord> logRecords

The concurrent log records of all garbage collection sweeps.

stats

private ContextWindowGarbageCollector.Stats stats

The results of the last token calculation pass.

Constructor Details

ContextWindowGarbageCollector

public ContextWindowGarbageCollector(@NonNull
 @NonNull ContextManager contextManager)

Constructs a ContextWindowGarbageCollector with its parent manager.

Parameters:

contextManager - The parent ContextManager instance.

Method Details

calculate

public void calculate()

Performs a comprehensive, one-pass calculation of all token metrics in the current context. This categorizes tokens into system instructions, tools, metadata, and various history states using the active session tokenizer.

summarizeParts

private String summarizeParts(AbstractMessage message)

Generates a compact parts summary string for a message being garbage collected.

Parameters:

message - The message to summarize.

Returns:

The formatted summary string.

recordCollection

public void recordCollection(@NonNull
 @NonNull AbstractMessage message)

Records the recycling of a message turn.

Parameters:

message - The message being garbage collected.

clearLog

public void clearLog()

Clears the collection logs.

getRecords

public List<GarbageCollectorRecord> getRecords()

Gets an unmodifiable view of the collection log.

Returns:

The list of collection records.