--- url: >- https://adk.nht.io/api/@nhtio/adk/batteries/interfaces/WebLLMChatCompletionsAdapterOptions.md --- # Interface: WebLLMChatCompletionsAdapterOptions Defined in: [batteries/llm/webllm\_chat\_completions/types.ts:54](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L54) ## Extends * [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)<[`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md), `"apiKey"` | `"baseURL"` | `"headers"` | `"fetch"` | `"retry"` | `"requestTimeoutMs"`> ## Properties | Property | Type | Default value | Description | Inherited from | Defined in | | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `audio?` | { `format`: `"wav"` | `"mp3"` | `"flac"` | `"opus"` | `"pcm16"`; `voice`: `string`; } | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`audio`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-audio) | [batteries/llm/openai\_chat\_completions/types.ts:545](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L545) | | `audio.format` | `"wav"` | `"mp3"` | `"flac"` | `"opus"` | `"pcm16"` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:545](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L545) | | `audio.voice` | `string` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:545](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L545) | | `autoAck?` | `boolean` | `false` | Whether the executor should call [ctx.ack()](../../types/interfaces/DispatchContext.md#ack) itself when a generation completes with no tool calls (a terminal text answer). **Remarks** `ack()` is terminal and one-shot: once called, the dispatch loop exits after the current iteration. When the executor acks automatically, it seizes turn-completion control from the implementor — a `dispatchOutputPipeline` quality gate can never run, because the signal is already set before the output pipeline executes. This option therefore defaults to **`false`** (opt-in). With `autoAck: false`, a tool-call-free response leaves the context unsignalled and the executor returns; the implementor's output pipeline (or a later iteration) is responsible for calling `ctx.ack()` / `ctx.nack()`. This is the seam that makes output-side quality gates (citation enforcement, schema validation, regenerate-on-reject) possible. Set `autoAck: true` to restore single-shot behavior: the executor acks the moment a tool-call-free answer finishes, terminating the turn without giving the output pipeline a vote. The tool-call path is unaffected by this flag — it always withholds ack so the runner can iterate and execute the calls. Error paths always [nack](../../types/interfaces/DispatchContext.md#nack) regardless of this flag. | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`autoAck`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-autoack) | [batteries/llm/openai\_chat\_completions/types.ts:541](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L541) | | `bucketOrder?` | [`ChatCompletionsBucketOrder`](../llm/openai_chat_completions/types/type-aliases/ChatCompletionsBucketOrder.md) | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`bucketOrder`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-bucketorder) | [batteries/llm/openai\_chat\_completions/types.ts:444](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L444) | | `chatOptions?` | `ChatOptions` | `ChatOptions`\[] | `undefined` | - | - | [batteries/llm/webllm\_chat\_completions/types.ts:63](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L63) | | `contextWindow?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`contextWindow`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-contextwindow) | [batteries/llm/openai\_chat\_completions/types.ts:445](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L445) | | `createEngine?` | (`input`: { `chatOptions?`: `ChatOptions` | `ChatOptions`\[]; `engineConfig?`: `MLCEngineConfig`; `model`: `string`; `onInitProgress?`: (`report`: `InitProgressReport`) => `void`; }) => `Promise`<`MLCEngineInterface`> | `undefined` | - | - | [batteries/llm/webllm\_chat\_completions/types.ts:64](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L64) | | `engine?` | `MLCEngineInterface` | `undefined` | - | - | [batteries/llm/webllm\_chat\_completions/types.ts:61](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L61) | | `engineConfig?` | `MLCEngineConfig` | `undefined` | - | - | [batteries/llm/webllm\_chat\_completions/types.ts:62](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L62) | | `extra_body?` | [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)<`string`, `unknown`> | `undefined` | - | - | [batteries/llm/webllm\_chat\_completions/types.ts:60](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L60) | | `frequency_penalty?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`frequency_penalty`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-frequency_penalty) | [batteries/llm/openai\_chat\_completions/types.ts:546](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L546) | | `function_call?` | | `"auto"` | `"none"` | { `name`: `string`; } | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`function_call`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-function_call) | [batteries/llm/openai\_chat\_completions/types.ts:547](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L547) | | `functions?` | { `description?`: `string`; `name`: `string`; `parameters?`: [`JsonSchema`](../llm/openai_chat_completions/types/interfaces/JsonSchema.md); }\[] | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`functions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-functions) | [batteries/llm/openai\_chat\_completions/types.ts:548](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L548) | | `helpers?` | [`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)<[`ChatCompletionsHelpers`](../llm/openai_chat_completions/types/interfaces/ChatCompletionsHelpers.md)> | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`helpers`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-helpers) | [batteries/llm/openai\_chat\_completions/types.ts:469](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L469) | | `ignore_eos?` | `boolean` | `undefined` | - | - | [batteries/llm/webllm\_chat\_completions/types.ts:59](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L59) | | `isWebGPUAvailable?` | () => `boolean` | `undefined` | - | - | [batteries/llm/webllm\_chat\_completions/types.ts:71](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L71) | | `logit_bias?` | [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)<`string`, `number`> | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`logit_bias`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-logit_bias) | [batteries/llm/openai\_chat\_completions/types.ts:549](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L549) | | `logprobs?` | `boolean` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`logprobs`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-logprobs) | [batteries/llm/openai\_chat\_completions/types.ts:550](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L550) | | `max_completion_tokens?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`max_completion_tokens`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-max_completion_tokens) | [batteries/llm/openai\_chat\_completions/types.ts:551](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L551) | | `max_tokens?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`max_tokens`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-max_tokens) | [batteries/llm/openai\_chat\_completions/types.ts:552](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L552) | | `metadata?` | [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)<`string`, `string`> | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`metadata`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-metadata) | [batteries/llm/openai\_chat\_completions/types.ts:553](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L553) | | `modalities?` | (`"text"` | `"audio"`)\[] | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`modalities`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-modalities) | [batteries/llm/openai\_chat\_completions/types.ts:554](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L554) | | `model` | `string` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`model`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-model) | [batteries/llm/openai\_chat\_completions/types.ts:544](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L544) | | `n?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`n`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-n) | [batteries/llm/openai\_chat\_completions/types.ts:555](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L555) | | `onInitProgress?` | (`report`: `InitProgressReport`) => `void` | `undefined` | - | - | [batteries/llm/webllm\_chat\_completions/types.ts:70](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L70) | | `parallel_tool_calls?` | `boolean` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`parallel_tool_calls`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-parallel_tool_calls) | [batteries/llm/openai\_chat\_completions/types.ts:556](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L556) | | `prediction?` | { `content`: | `string` | { `text`: `string`; `type`: `"text"`; }\[]; `type`: `"content"`; } | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`prediction`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-prediction) | [batteries/llm/openai\_chat\_completions/types.ts:557](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L557) | | `prediction.content` | | `string` | { `text`: `string`; `type`: `"text"`; }\[] | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:559](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L559) | | `prediction.type` | `"content"` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:558](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L558) | | `presence_penalty?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`presence_penalty`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-presence_penalty) | [batteries/llm/openai\_chat\_completions/types.ts:561](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L561) | | `prompt_cache_key?` | `string` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`prompt_cache_key`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-prompt_cache_key) | [batteries/llm/openai\_chat\_completions/types.ts:562](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L562) | | `prompt_cache_retention?` | `"in_memory"` | `"24h"` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`prompt_cache_retention`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-prompt_cache_retention) | [batteries/llm/openai\_chat\_completions/types.ts:563](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L563) | | `reasoning_effort?` | `"low"` | `"high"` | `"minimal"` | `"medium"` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`reasoning_effort`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-reasoning_effort) | [batteries/llm/openai\_chat\_completions/types.ts:564](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L564) | | `reasoningFieldPrecedence?` | [`ReasoningFieldPrecedence`](../llm/openai_chat_completions/types/type-aliases/ReasoningFieldPrecedence.md) | `['reasoning', 'reasoning_content']` | Ordered precedence of the wire fields the adapter reads for model reasoning/thinking output. **Remarks** Reasoning is not part of OpenAI's official Chat Completions spec, so OpenAI-compatible providers disagree on the field name: Ollama's `/v1` and current vLLM emit `reasoning`, while legacy vLLM (≤0.8) and the DeepSeek API emit `reasoning_content`. The adapter reads every field in this list that is present on the response. Precedence governs two things. When more than one listed field is present with **identical** content (or only one is present), the adapter emits a single thought attributed to the highest-precedence field. When listed fields are present with **divergent** content, each surfaces as its own thought (ordered by precedence) rather than silently dropping one — a thought stream is the wrong place to lose data. | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`reasoningFieldPrecedence`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-reasoningfieldprecedence) | [batteries/llm/openai\_chat\_completions/types.ts:468](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L468) | | `repetition_penalty?` | `number` | `undefined` | - | - | [batteries/llm/webllm\_chat\_completions/types.ts:58](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/webllm_chat_completions/types.ts#L58) | | `replayCompatibility?` | readonly `string`\[] | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`replayCompatibility`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-replaycompatibility) | [batteries/llm/openai\_chat\_completions/types.ts:449](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L449) | | `response_format?` | | { `type`: `"text"`; } | { `type`: `"json_object"`; } | { `json_schema`: { `description?`: `string`; `name`: `string`; `schema`: [`JsonSchema`](../llm/openai_chat_completions/types/interfaces/JsonSchema.md); `strict?`: `boolean`; }; `type`: `"json_schema"`; } | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`response_format`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-response_format) | [batteries/llm/openai\_chat\_completions/types.ts:565](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L565) | | `safety_identifier?` | `string` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`safety_identifier`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-safety_identifier) | [batteries/llm/openai\_chat\_completions/types.ts:577](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L577) | | `seed?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`seed`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-seed) | [batteries/llm/openai\_chat\_completions/types.ts:578](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L578) | | `selfIdentity?` | `string` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`selfIdentity`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-selfidentity) | [batteries/llm/openai\_chat\_completions/types.ts:446](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L446) | | `service_tier?` | `"default"` | `"auto"` | `"flex"` | `"priority"` | `"scale"` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`service_tier`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-service_tier) | [batteries/llm/openai\_chat\_completions/types.ts:579](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L579) | | `spoolStore?` | [`SpoolStore`](../../common/type-aliases/SpoolStore.md) | a new `InMemorySpoolStore` per dispatch | Backing store for `string` / `Uint8Array` tool returns. Tool output bytes are written under the tool call's id; the resulting [@nhtio/adk!SpooledArtifact](../../spooled_artifact/classes/SpooledArtifact.md) (or the tool's configured subclass) is the model-visible handle for the rest of the turn. **Remarks** Defaults to a fresh, ephemeral per-dispatch [@nhtio/adk/batteries/storage/in\_memory!InMemorySpoolStore](../storage/in_memory/classes/InMemorySpoolStore.md). Inject an [@nhtio/adk/batteries/storage/opfs!OpfsSpoolStore](../storage/opfs/classes/OpfsSpoolStore.md) or a Flydrive-backed store to persist artifacts to durable storage (and to stream large/binary tool output to disk rather than buffering it in memory). **Lifetime / namespacing:** the default store is per-dispatch, so tool-call ids only need to be unique within a dispatch. An injected durable store persists across turns and dispatches, so the tool-call ids used as keys must be globally unique for that store (or the store must apply its own `keyPrefix`); the adapter does not namespace keys for you, and it does not delete entries — lifetime and cleanup of an injected store are the consumer's responsibility. | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`spoolStore`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-spoolstore) | [batteries/llm/openai\_chat\_completions/types.ts:490](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L490) | | `stop?` | `string` | `string`\[] | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`stop`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-stop) | [batteries/llm/openai\_chat\_completions/types.ts:580](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L580) | | `store?` | `boolean` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`store`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-store) | [batteries/llm/openai\_chat\_completions/types.ts:581](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L581) | | `stream?` | `boolean` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`stream`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-stream) | [batteries/llm/openai\_chat\_completions/types.ts:439](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L439) | | `stream_options?` | { `include_obfuscation?`: `boolean`; `include_usage?`: `boolean`; } | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`stream_options`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-stream_options) | [batteries/llm/openai\_chat\_completions/types.ts:582](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L582) | | `stream_options.include_obfuscation?` | `boolean` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:582](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L582) | | `stream_options.include_usage?` | `boolean` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:582](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L582) | | `streamIdleTimeoutMs?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`streamIdleTimeoutMs`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-streamidletimeoutms) | [batteries/llm/openai\_chat\_completions/types.ts:440](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L440) | | `strictToolChoice?` | `boolean` | `false` | When `tool_choice` (or the `allowed_tools` variant) forces the model onto a specific tool name, and that name resolves to an ephemeral, forged artifact-query tool (one produced by `.forgeTools(ctx)` — i.e. `tool.ephemeral === true`), this flag controls how the adapter reacts: - `false` (default): emit a single `helpers.log.warn({ kind: 'tool-choice-forged-artifact', ... })` record and continue. Forging an artifact-query tool by name is almost always a misconfiguration — the tool may not exist in the next iteration once the artifact ages out — but the call still goes through. - `true`: hard-fail with `E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS`. Use this in production deployments where forcing a forged tool indicates a real bug. | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`strictToolChoice`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-stricttoolchoice) | [batteries/llm/openai\_chat\_completions/types.ts:506](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L506) | | `temperature?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`temperature`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-temperature) | [batteries/llm/openai\_chat\_completions/types.ts:583](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L583) | | `thoughtSurfacing?` | `"all-self"` | `"latest-self"` | `"all"` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`thoughtSurfacing`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-thoughtsurfacing) | [batteries/llm/openai\_chat\_completions/types.ts:447](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L447) | | `tokenEncoding?` | | `"gpt2"` | `"r50k_base"` | `"p50k_base"` | `"p50k_edit"` | `"cl100k_base"` | `"o200k_base"` | `"gemini"` | `"llama2"` | `"claude"` | `null` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`tokenEncoding`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-tokenencoding) | [batteries/llm/openai\_chat\_completions/types.ts:448](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L448) | | `tool_choice?` | | `"required"` | `"auto"` | `"none"` | { `function`: { `name`: `string`; }; `type`: `"function"`; } | { `custom`: { `name`: `string`; }; `type`: `"custom"`; } | { `allowed_tools`: { `mode`: `"required"` | `"auto"`; `tools`: ( | { `function`: { `name`: `string`; }; `type`: `"function"`; } | { `custom`: { `name`: `string`; }; `type`: `"custom"`; })\[]; }; `type`: `"allowed_tools"`; } | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`tool_choice`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-tool_choice) | [batteries/llm/openai\_chat\_completions/types.ts:584](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L584) | | `top_logprobs?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`top_logprobs`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-top_logprobs) | [batteries/llm/openai\_chat\_completions/types.ts:600](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L600) | | `top_p?` | `number` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`top_p`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-top_p) | [batteries/llm/openai\_chat\_completions/types.ts:601](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L601) | | `unsupportedMediaPolicy?` | [`UnsupportedMediaPolicy`](../llm/openai_chat_completions/types/type-aliases/UnsupportedMediaPolicy.md) | `'throw'` | Policy for how the adapter handles a [@nhtio/adk!Media](../../common/classes/Media.md) instance whose modality the OpenAI Chat Completions wire format does not natively support (today: video). See [UnsupportedMediaPolicy](../llm/openai_chat_completions/types/type-aliases/UnsupportedMediaPolicy.md). | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`unsupportedMediaPolicy`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-unsupportedmediapolicy) | [batteries/llm/openai\_chat\_completions/types.ts:515](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L515) | | `user?` | `string` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`user`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-user) | [batteries/llm/openai\_chat\_completions/types.ts:602](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L602) | | `verbosity?` | `"low"` | `"high"` | `"medium"` | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`verbosity`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-verbosity) | [batteries/llm/openai\_chat\_completions/types.ts:603](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L603) | | `web_search_options?` | { `search_context_size?`: `"low"` | `"high"` | `"medium"`; `user_location?`: { `approximate`: { `city?`: `string`; `country?`: `string`; `region?`: `string`; `timezone?`: `string`; }; `type`: `"approximate"`; }; } | `undefined` | - | [`OpenAIChatCompletionsAdapterOptions`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md).[`web_search_options`](../llm/openai_chat_completions/types/interfaces/OpenAIChatCompletionsAdapterOptions.md#property-web_search_options) | [batteries/llm/openai\_chat\_completions/types.ts:604](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L604) | | `web_search_options.search_context_size?` | `"low"` | `"high"` | `"medium"` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:605](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L605) | | `web_search_options.user_location?` | { `approximate`: { `city?`: `string`; `country?`: `string`; `region?`: `string`; `timezone?`: `string`; }; `type`: `"approximate"`; } | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:606](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L606) | | `web_search_options.user_location.approximate` | { `city?`: `string`; `country?`: `string`; `region?`: `string`; `timezone?`: `string`; } | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:608](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L608) | | `web_search_options.user_location.approximate.city?` | `string` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:609](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L609) | | `web_search_options.user_location.approximate.country?` | `string` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:610](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L610) | | `web_search_options.user_location.approximate.region?` | `string` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:611](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L611) | | `web_search_options.user_location.approximate.timezone?` | `string` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:612](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L612) | | `web_search_options.user_location.type` | `"approximate"` | `undefined` | - | - | [batteries/llm/openai\_chat\_completions/types.ts:607](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/llm/openai_chat_completions/types.ts#L607) |