MemoryPolicy class
Tuning for the orchestrator's memory behavior.
Constructors
- MemoryPolicy({double headroomFraction = 0.15, int minContextTokens = 2048, int maxContextTokens = 32768, double resizeHysteresisFraction = 0.10, Duration resizeCooldown = const Duration(seconds: 30), Duration pollInterval = const Duration(seconds: 5), double pressureAvailableFraction = 0.08, bool unloadOnCritical = false, int maxStashBytes = 1024 * 1024 * 1024})
-
Creates a policy.
const
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- headroomFraction → double
-
Fraction of available memory deliberately left unused.
final
- maxContextTokens → int
-
Hard ceiling on planned context size, regardless of memory.
final
- maxStashBytes → int
-
Byte cap on the engine-side in-memory KV stash. When agent swaps push
past it, the oldest stashes are dropped (those agents re-prefill on
their next turn). The most recent stash is always kept, even alone
over the cap.
final
- minContextTokens → int
-
Below this context size the orchestrator refuses to shrink further
and reports memory-critical instead.
final
- pollInterval → Duration
-
How often the orchestrator samples system memory.
final
- pressureAvailableFraction → double
-
Available memory below this fraction of total counts as pressure:
shrinks apply immediately, growth is suppressed.
final
- resizeCooldown → Duration
-
Minimum quiet period between resizes. Bypassed under pressure.
final
- resizeHysteresisFraction → double
-
Target/current differences within this fraction are ignored —
resizing recreates the context, so thrash costs more than being
slightly off-budget.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- unloadOnCritical → bool
-
Whether a memory-critical verdict unloads the model (instead of only
emitting an event and hoping the app reacts).
final
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited