SummarizingConversationManagerConfig

type SummarizingConversationManagerConfig = {
  model?: Model;
  summaryRatio?: number;
  preserveRecentMessages?: number;
  summarizationSystemPrompt?: string;
  proactiveCompression?: boolean | ProactiveCompressionConfig;
  pinFirst?: number;
};

Defined in: src/conversation-manager/summarizing-conversation-manager.ts:29

Configuration for the summarization conversation manager.

Properties

model?

model?: Model;

Defined in: src/conversation-manager/summarizing-conversation-manager.ts:34

Model to use for generating summaries. Resolution order: this model > agent.auxModel > agent.model.

---

summaryRatio?

summaryRatio?: number;

Defined in: src/conversation-manager/summarizing-conversation-manager.ts:40

Ratio of messages to summarize when context overflow occurs. Value is clamped to [0.1, 0.8]. Defaults to 0.3 (summarize 30% of oldest messages).

---

preserveRecentMessages?

preserveRecentMessages?: number;

Defined in: src/conversation-manager/summarizing-conversation-manager.ts:46

Minimum number of recent messages to always keep. Defaults to 10.

---

summarizationSystemPrompt?

summarizationSystemPrompt?: string;

Defined in: src/conversation-manager/summarizing-conversation-manager.ts:52

Custom system prompt for summarization. If not provided, uses a default prompt that produces structured bullet-point summaries.

---

proactiveCompression?

proactiveCompression?: boolean | ProactiveCompressionConfig;

Defined in: src/conversation-manager/summarizing-conversation-manager.ts:61

Enable proactive context compression before the model call.

• true: compress when 70% of the context window is used (default threshold).
• { compressionThreshold: number }: compress at the specified ratio (0, 1].
• false or omitted: disabled, only reactive overflow recovery is used.

---

pinFirst?

pinFirst?: number;

Defined in: src/conversation-manager/summarizing-conversation-manager.ts:67

Number of messages at the start of the conversation to permanently pin. Pinned messages are protected from summarization and compacted to the front.