Skip to content

Graphorin API reference v0.7.0


Graphorin API reference / @graphorin/memory / / ConsolidatorCeilings

Interface: ConsolidatorCeilings

Defined in: packages/memory/src/consolidator/types.ts:67

Daily cost ceilings, tracked per budget window. How a breach is handled depends on OnBudgetExceed: 'pause' / 'throw' enforce, 'log' (the shipped standard/full presets) only WARNs and keeps running. The USD leg accumulates only when a priceUsage pricer is configured (memory-consolidation-02) - without one every call prices at $0 and maxCostPerDay can never trip. The default ceiling shape per tier is captured in CONSOLIDATOR_TIER_DEFAULTS.

Stable

Properties

PropertyModifierTypeDescriptionDefined in
cooldownMsreadonlynumberMinimum quiet period between non-manual runs per scope (MCON-8). After each run the runtime persists nextEligibleAt = now + cooldownMs; trigger-driven runs (turn / idle / cron / event / budget) inside that window defer with reason 'cooldown'. Manual fireNow(...) and DLQ replays bypass it.packages/memory/src/consolidator/types.ts:85
maxConcurrentRunsreadonlynumberADVISORY (MCON-8): the per-scope lock serializes runs, so effective concurrency is always 1 per scope regardless of this value. The field is retained for forward compatibility; it enforces nothing today.packages/memory/src/consolidator/types.ts:76
maxCostPerDayreadonlynumber-packages/memory/src/consolidator/types.ts:69
maxRunDurationMsreadonlynumber-packages/memory/src/consolidator/types.ts:77
maxTokensPerDayreadonlynumber-packages/memory/src/consolidator/types.ts:68