TokenBudgetRecord
Interface: TokenBudgetRecord
Defined in: src/core/agent/window/types.ts:269
What one OVER-BUDGET visit to tokenBudget put in the ledger.
Extends
Properties
droppedObservations?
readonlyoptionaldroppedObservations?: readonlystring[]
Defined in: src/core/agent/window/types.ts:179
The tools whose RESULTS left the window on this visit, in first-appearance order (9.57.0). Present only when at least one did.
This is the record's half of the sentence the drop notice says on the wire, and it is filed even when no notice was authored at all — a removal further into the window tells the model nothing, and then this is the only place the fact exists. Uncapped and unfiltered, because the record is not the wire: the notice prints at most four names and only plain identifiers, this prints every name exactly as the tool declared it.
The failure it exists for was measured: a model whose whats_here result
had been evicted assembled a plausible id from an entity name it
remembered, was refused, and spent actions on it — and nothing in the run
said the evidence had gone.
Inherited from
WindowRecord.droppedObservations
iteration
readonlyiteration:number
Defined in: src/core/agent/window/types.ts:153
ReAct iteration this visit belongs to.
Inherited from
keepRecentTurns
readonlykeepRecentTurns:number
Defined in: src/core/agent/window/types.ts:278
How many recent turns were off-limits to this visit.
measuredTokens
readonlymeasuredTokens:number
Defined in: src/core/agent/window/types.ts:272
Adapter-reported input tokens of the last call — what tripped the check.
observations?
readonlyoptionalobservations?:WindowObservations
Defined in: src/core/agent/window/types.ts:189
What the last-tool-result pin did on this visit (9.57.0). Present only when it did something: held a turn, turned one away at the ceiling, or stood down.
See WindowObservations. An agent with keepLastToolResults: false
— or one whose window held no pinnable tool result — never carries this
key, so its records are the exact shape they were before 9.57.0.
Inherited from
overBudget
readonlyoverBudget:boolean
Defined in: src/core/agent/window/types.ts:276
True when the measurement was over budget (a drop was attempted).
refusals
readonlyrefusals: readonlyWindowRefusal[]
Defined in: src/core/agent/window/types.ts:162
Every turn that refused to leave, named.
Inherited from
removedMessageCount
readonlyremovedMessageCount:number
Defined in: src/core/agent/window/types.ts:157
How many messages left the window.
Inherited from
WindowRecord.removedMessageCount
removedStageIds
readonlyremovedStageIds: readonlystring[]
Defined in: src/core/agent/window/types.ts:155
runtimeStageIds of the stages that appended the messages that left.
Inherited from
strategy
readonlystrategy:"token-budget"
Defined in: src/core/agent/window/types.ts:270
WindowStrategy.name of the strategy that decided — 'summarize-oldest',
'sliding-window', 'token-budget', or your own. Narrow on it.
Overrides
thresholdTokens
readonlythresholdTokens:number
Defined in: src/core/agent/window/types.ts:274
The budget it was compared against.
windowCharsAfter
readonlywindowCharsAfter:number
Defined in: src/core/agent/window/types.ts:160
Inherited from
windowCharsBefore
readonlywindowCharsBefore:number
Defined in: src/core/agent/window/types.ts:159
Window size in chars before / after this visit. Exact, and not tokens.
