---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/context/compact/summarizer/interfaces/AssembleCompactedTurnsOptions.md
description: 'Options for [`assembleCompactedTurns`](https://adk.nht.io/api/@nhtio/adk/batteries/context/compact/summarizer/functions/assembleCompactedTurns).'
---

# Interface: AssembleCompactedTurnsOptions

Defined in: [src/batteries/context/compact/summarizer.ts:176](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L176)

Options for [assembleCompactedTurns](../functions/assembleCompactedTurns.md).

## Properties

| Property                                                     | Type                                                                             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Defined in                                                                                                                                              |
| ------------------------------------------------------------ | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  `encoding?`                   | `string`                                                                         | The encoding to measure under. Default: `'cl100k_base'`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | [src/batteries/context/compact/summarizer.ts:183](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L183) |
|  `estimateTokens`        | [`EstimateTokensFn`](../../../thrift/contracts/type-aliases/EstimateTokensFn.md) | REQUIRED. Measures token costs (the older-region threshold check, and [OnCostFn](../../contracts/type-aliases/OnCostFn.md) reporting).                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | [src/batteries/context/compact/summarizer.ts:181](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L181) |
|  `keepVerbatim?`           | `number`                                                                         | How many of the most recent turns stay verbatim. Default: [DEFAULT\_KEEP\_VERBATIM](../variables/DEFAULT_KEEP_VERBATIM.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | [src/batteries/context/compact/summarizer.ts:185](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L185) |
|  `onCost?`                       | [`OnCostFn`](../../contracts/type-aliases/OnCostFn.md)                           | Fired once per summarization call that actually runs (never on the below-threshold pass-through path). See [OnCostFn](../../contracts/type-aliases/OnCostFn.md).                                                                                                                                                                                                                                                                                                                                                                                                                                        | [src/batteries/context/compact/summarizer.ts:198](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L198) |
|  `priorState?`               | { `coveredOlder`: `number`; `summary`: `string` | `null`; }                   | The caller's own bookkeeping of prior state, threaded through explicitly (replacing the original `#compactSummary`/`#compactCoveredOlder` private fields on the flagship agent's class instance): the rolling summary text produced by a previous call, and how many older-region turns that summary already covers. Omit on the FIRST call for a fresh run (equivalent to the originals' `null`/`0` initial values). This battery holds no state of its own between calls — see [AssembleCompactedTurnsResult](AssembleCompactedTurnsResult.md) for what to persist and pass back in on the next call. | [src/batteries/context/compact/summarizer.ts:207](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L207) |
| `priorState.coveredOlder`                                    | `number`                                                                         | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | [src/batteries/context/compact/summarizer.ts:207](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L207) |
| `priorState.summary`                                         | `string` | `null`                                                               | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | [src/batteries/context/compact/summarizer.ts:207](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L207) |
|  `summariseAtTokens?` | `number`                                                                         | The older-region token threshold past which a (re)summarization fires. Default: [DEFAULT\_SUMMARISE\_AT\_TOKENS](../variables/DEFAULT_SUMMARISE_AT_TOKENS.md).                                                                                                                                                                                                                                                                                                                                                                                                                                             | [src/batteries/context/compact/summarizer.ts:188](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L188) |
|  `summarize`                  | [`SummarizeFn`](../../contracts/type-aliases/SummarizeFn.md)                     | REQUIRED. The model-call seam — see [SummarizeFn](../../contracts/type-aliases/SummarizeFn.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | [src/batteries/context/compact/summarizer.ts:178](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L178) |
|  `summaryMessageId?`   | `string`                                                                         | The id assigned to the synthetic summary message/turn. Default: [DEFAULT\_SUMMARY\_MESSAGE\_ID](../variables/DEFAULT_SUMMARY_MESSAGE_ID.md) — see that constant's TSDoc for the cross-battery contract with Token Thrift's `isSummaryMessage` predicate before changing this.                                                                                                                                                                                                                                                                                                                              | [src/batteries/context/compact/summarizer.ts:195](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L195) |
|  `systemPrompt?`           | `string`                                                                         | The compaction instructions passed through to [summariseTurns](../functions/summariseTurns.md). Default: [COMPACTION\_SYSTEM\_PROMPT](../variables/COMPACTION_SYSTEM_PROMPT.md).                                                                                                                                                                                                                                                                                                                                                                                                                          | [src/batteries/context/compact/summarizer.ts:191](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/context/compact/summarizer.ts#L191) |