Interfaces

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?

readonly optional droppedObservations?: readonly string[]

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

readonly iteration: number

Defined in: src/core/agent/window/types.ts:153

ReAct iteration this visit belongs to.

Inherited from

WindowRecord.iteration


keepRecentTurns

readonly keepRecentTurns: number

Defined in: src/core/agent/window/types.ts:278

How many recent turns were off-limits to this visit.


measuredTokens

readonly measuredTokens: number

Defined in: src/core/agent/window/types.ts:272

Adapter-reported input tokens of the last call — what tripped the check.


observations?

readonly optional observations?: 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

WindowRecord.observations


overBudget

readonly overBudget: boolean

Defined in: src/core/agent/window/types.ts:276

True when the measurement was over budget (a drop was attempted).


refusals

readonly refusals: readonly WindowRefusal[]

Defined in: src/core/agent/window/types.ts:162

Every turn that refused to leave, named.

Inherited from

WindowRecord.refusals


removedMessageCount

readonly removedMessageCount: number

Defined in: src/core/agent/window/types.ts:157

How many messages left the window.

Inherited from

WindowRecord.removedMessageCount


removedStageIds

readonly removedStageIds: readonly string[]

Defined in: src/core/agent/window/types.ts:155

runtimeStageIds of the stages that appended the messages that left.

Inherited from

WindowRecord.removedStageIds


strategy

readonly strategy: "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

WindowRecord.strategy


thresholdTokens

readonly thresholdTokens: number

Defined in: src/core/agent/window/types.ts:274

The budget it was compared against.


windowCharsAfter

readonly windowCharsAfter: number

Defined in: src/core/agent/window/types.ts:160

Inherited from

WindowRecord.windowCharsAfter


windowCharsBefore

readonly windowCharsBefore: number

Defined in: src/core/agent/window/types.ts:159

Window size in chars before / after this visit. Exact, and not tokens.

Inherited from

WindowRecord.windowCharsBefore

On this page