Class: ContextWindowManager

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:58

Constructors

Constructor

new ContextWindowManager(managerConfig): ContextWindowManager

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:75

Parameters

managerConfig

ContextWindowManagerConfig

Returns

ContextWindowManager

Accessors

enabled

Get Signature

get enabled(): boolean

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:344

Whether infinite context is enabled.

Returns

boolean

Methods

addMessage()

addMessage(role, content): void

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:107

Add a message to the tracked conversation. Call this for every message (user, assistant, system, tool).

Parameters

role

"user" | "tool" | "system" | "assistant"

content

string

Returns

void

---

beforeTurn()

beforeTurn(systemPromptTokens, memoryBudgetTokens, emotionalContext?): Promise<ContextMessage[]>

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:134

Check whether compaction is needed and perform it if so. Call this BEFORE assembling the prompt for the LLM.

Returns the current message list (potentially compacted).

Parameters

systemPromptTokens

number

memoryBudgetTokens

number

emotionalContext?

EmotionalContext

Returns

Promise<ContextMessage[]>

---

clear()

clear(): void

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:330

Reset all state.

Returns

void

---

findTurnHistory()

findTurnHistory(turnIndex): CompactionEntry[]

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:288

Find what happened to a specific turn.

Parameters

turnIndex

number

Returns

CompactionEntry[]

---

formatTransparencyReport()

formatTransparencyReport(): string

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:296

Format a transparency report for the agent's context. Includes: current state, recent compactions, summary chain.

Returns

string

---

getCompactionHistory()

getCompactionHistory(): readonly CompactionEntry[]

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:255

Get all compaction entries.

Returns

readonly CompactionEntry[]

---

getConfig()

getConfig(): Readonly<InfiniteContextConfig>

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:349

Current config (read-only).

Returns

Readonly<InfiniteContextConfig>

---

getCurrentTokens()

getCurrentTokens(): number

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:233

Current total token estimate across all messages.

Returns

number

---

getCurrentTurn()

getCurrentTurn(): number

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:238

Current turn index.

Returns

number

---

getEngine()

getEngine(): CompactionEngine

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:339

Get the compaction engine (for strategy inspection/testing).

Returns

CompactionEngine

---

getLog()

getLog(): CompactionLog

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:250

Get the compaction log.

Returns

CompactionLog

---

getMessages()

getMessages(): readonly ContextMessage[]

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:223

Get all current messages (including any summary blocks).

Returns

readonly ContextMessage[]

---

getRawMessages()

getRawMessages(): ContextMessage[]

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:228

Get only the raw (non-compacted) messages.

Returns

ContextMessage[]

---

getStats()

getStats(): ContextWindowStats

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:260

Get aggregate stats.

Returns

ContextWindowStats

---

getSummaryChain()

getSummaryChain(): SummaryChainNode[]

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:278

Get the summary chain for UI display.

Returns

SummaryChainNode[]

---

getSummaryContext()

getSummaryContext(): string

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:216

Get the formatted summary chain for injection into the system prompt or as a conversation-history block.

Returns

string

---

searchHistory()

searchHistory(keyword): CompactionEntry[]

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:283

Search the compaction log for a keyword.

Parameters

keyword

string

Returns

CompactionEntry[]

---

setMessages()

setMessages(messages): void

Defined in: packages/agentos/src/cognition/memory/pipeline/context/ContextWindowManager.ts:243

Replace the message list (e.g. after external manipulation).

Parameters

messages

ContextMessage[]

Returns

void