SessionConfig

Defined in: src/index.ts:77

Configuration for a single session. Required at connect() time. Immutable after creation.

Properties

compaction?

optional compaction?: Partial<{ contextWindow: number; enabled: boolean; keepRecentTokens: number; reserveTokens: number; }>

Defined in: src/index.ts:95

Context compaction settings. Compaction is on by default — pass { enabled: false } to opt out, or override individual fields (contextWindow, reserveTokens, keepRecentTokens) to tune when compaction fires. Unset fields fall back to built-in defaults (200K context window, 16K reserve, 20K recent-keep).

---

initialTurns?

optional initialTurns?: TurnResult[]

Defined in: src/index.ts:97

Prior turns to seed the session with. Restores LLM context from previous conversation.

---

lastCompactionSummary?

optional lastCompactionSummary?: string

Defined in: src/index.ts:99

Last compaction summary from a prior session. Required for compaction continuity when restoring with initialTurns.

---

maxIterations

maxIterations: number

Defined in: src/index.ts:85

Max tool-use iterations per turn. Required.

---

model

model: ModelConfig

Defined in: src/index.ts:81

Model to use. Required.

---

repo

repo: RepoConfig

Defined in: src/index.ts:79

Repository to connect to. Required.

---

systemPrompt?

optional systemPrompt?: string

Defined in: src/index.ts:83

System prompt. If omitted, a default code-analysis prompt is built.

---

thinking?

optional thinking?: ThinkingConfig

Defined in: src/index.ts:87

Thinking/reasoning configuration. If omitted, thinking is off.