Class: ContextWindowManager

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:49

Constructors

Constructor

new ContextWindowManager(managerConfig): ContextWindowManager

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:66

Parameters

managerConfig

ContextWindowManagerConfig

Returns

ContextWindowManager

Accessors

enabled

Get Signature

get enabled(): boolean

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:316

Whether infinite context is enabled.

Returns

boolean

Methods

addMessage()

addMessage(role, content): void

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:98

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/memory/context/ContextWindowManager.ts:123

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/memory/context/ContextWindowManager.ts:302

Reset all state.

Returns

void

---

findTurnHistory()

findTurnHistory(turnIndex): CompactionEntry[]

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

Find what happened to a specific turn.

Parameters

turnIndex

number

Returns

CompactionEntry[]

---

formatTransparencyReport()

formatTransparencyReport(): string

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:268

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/memory/context/ContextWindowManager.ts:227

Get all compaction entries.

Returns

readonly CompactionEntry[]

---

getConfig()

getConfig(): Readonly<InfiniteContextConfig>

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:321

Current config (read-only).

Returns

Readonly<InfiniteContextConfig>

---

getCurrentTokens()

getCurrentTokens(): number

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:205

Current total token estimate across all messages.

Returns

number

---

getCurrentTurn()

getCurrentTurn(): number

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:210

Current turn index.

Returns

number

---

getEngine()

getEngine(): CompactionEngine

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:311

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

Returns

CompactionEngine

---

getLog()

getLog(): CompactionLog

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:222

Get the compaction log.

Returns

CompactionLog

---

getMessages()

getMessages(): readonly ContextMessage[]

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:195

Get all current messages (including any summary blocks).

Returns

readonly ContextMessage[]

---

getRawMessages()

getRawMessages(): ContextMessage[]

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:200

Get only the raw (non-compacted) messages.

Returns

ContextMessage[]

---

getStats()

getStats(): ContextWindowStats

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:232

Get aggregate stats.

Returns

ContextWindowStats

---

getSummaryChain()

getSummaryChain(): SummaryChainNode[]

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

Get the summary chain for UI display.

Returns

SummaryChainNode[]

---

getSummaryContext()

getSummaryContext(): string

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:188

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/memory/context/ContextWindowManager.ts:255

Search the compaction log for a keyword.

Parameters

keyword

string

Returns

CompactionEntry[]

---

setMessages()

setMessages(messages): void

Defined in: packages/agentos/src/memory/context/ContextWindowManager.ts:215

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

Parameters

messages

ContextMessage[]

Returns

void