Skip to content
3 min read · 547 words

@nhtio/adk/batteries/llm/openai_chat_completions ​

OpenAI Chat Completions adapter battery with swappable translation helpers and wire types.

Remarks ​

Opinionated OpenAI Chat Completions LLM battery. Ships an OpenAIChatCompletionsAdapter that targets any OpenAI-Chat-Completions-compatible endpoint (OpenAI proper, OpenRouter, Together, Groq, Ollama's /v1, vLLM, LM Studio, llama.cpp's /v1, Azure OpenAI behind a proxy, LiteLLM, custom gateways, etc.) and translates the ADK's primitives into the Chat Completions wire shape.

Re-exports the adapter class, every translation helper (each under its unprefixed name AND a default*-prefixed alias so consumers can compose partial overrides against the bundled defaults), every option / wire-shape type alias, the validation schema + validateOptions wrapper, and the six battery-scoped exception classes.

See the project README for the design-decisions block governing this battery (trust-framed envelopes, per-tool trust, swappable translation helpers, per-dispatch override channel via stash, trust-tier-distinct envelopes, multi-identity rendering, opaque-reasoning round-trips, etc.).

References ​

AssembledToolCall ​

Re-exports AssembledToolCall


buildChatCompletionsHistory ​

Re-exports buildChatCompletionsHistory


ChatCompletionsBucketLabel ​

Re-exports ChatCompletionsBucketLabel


ChatCompletionsBucketOrder ​

Re-exports ChatCompletionsBucketOrder


ChatCompletionsChunk ​

Re-exports ChatCompletionsChunk


ChatCompletionsHelpers ​

Re-exports ChatCompletionsHelpers


ChatCompletionsMessage ​

Re-exports ChatCompletionsMessage


ChatCompletionsResponse ​

Re-exports ChatCompletionsResponse


ChatCompletionsRetryConfig ​

Re-exports ChatCompletionsRetryConfig


ChatCompletionsTool ​

Re-exports ChatCompletionsTool


ChatCompletionsToolCallDelta ​

Re-exports ChatCompletionsToolCallDelta


ChatCompletionsToolCallDeltaAccumulator ​

Re-exports ChatCompletionsToolCallDeltaAccumulator


createChatCompletionsToolCallDeltaAccumulator ​

Re-exports createChatCompletionsToolCallDeltaAccumulator


deCollideToolCallIds ​

Re-exports deCollideToolCallIds


defaultBuildChatCompletionsHistory ​

Re-exports defaultBuildChatCompletionsHistory


defaultCreateChatCompletionsToolCallDeltaAccumulator ​

Re-exports defaultCreateChatCompletionsToolCallDeltaAccumulator


defaultDescriptionToChatCompletionsJsonSchema ​

Re-exports defaultDescriptionToChatCompletionsJsonSchema


defaultFilterThoughts ​

Re-exports defaultFilterThoughts


defaultRenderChatCompletionsSystemPrompt ​

Re-exports defaultRenderChatCompletionsSystemPrompt


defaultRenderChatCompletionsToolCallResult ​

Re-exports defaultRenderChatCompletionsToolCallResult


defaultRenderFirstPartyRetrievables ​

Re-exports defaultRenderFirstPartyRetrievables


defaultRenderMemories ​

Re-exports defaultRenderMemories


defaultRenderRetrievables ​

Re-exports defaultRenderRetrievables


defaultRenderRetrievableSafetyDirective ​

Re-exports defaultRenderRetrievableSafetyDirective


defaultRenderStandingInstructions ​

Re-exports defaultRenderStandingInstructions


defaultRenderThirdPartyPrivateRetrievables ​

Re-exports defaultRenderThirdPartyPrivateRetrievables


defaultRenderThirdPartyPublicRetrievables ​

Re-exports defaultRenderThirdPartyPublicRetrievables


defaultRenderThought ​

Re-exports defaultRenderThought


defaultRenderTimelineMessage ​

Re-exports defaultRenderTimelineMessage


defaultRenderTrustedContent ​

Re-exports defaultRenderTrustedContent


defaultRenderUntrustedContent ​

Re-exports defaultRenderUntrustedContent


defaultToolsToChatCompletionsTools ​

Re-exports defaultToolsToChatCompletionsTools


DescriptionLike ​

Re-exports DescriptionLike


descriptionToChatCompletionsJsonSchema ​

Re-exports descriptionToChatCompletionsJsonSchema


E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS ​

Re-exports E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS


E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW ​

Re-exports E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW


E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR ​

Re-exports E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR


E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS ​

Re-exports E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS


E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT ​

Re-exports E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT


E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR ​

Re-exports E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR


E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED ​

Re-exports E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED


extractReasoningFields ​

Re-exports extractReasoningFields


filterThoughts ​

Re-exports filterThoughts


floorTrustTier ​

Re-exports floorTrustTier


JsonSchema ​

Re-exports JsonSchema


MemoryAttrs ​

Re-exports MemoryAttrs


neutraliseDeveloperRulesTag ​

Re-exports neutraliseDeveloperRulesTag


OpenAIChatCompletionsAdapter ​

Re-exports OpenAIChatCompletionsAdapter


OpenAIChatCompletionsAdapterOptions ​

Re-exports OpenAIChatCompletionsAdapterOptions


openAIChatCompletionsOptionsSchema ​

Re-exports openAIChatCompletionsOptionsSchema


OpenAIChatCompletionsRequestBody ​

Re-exports OpenAIChatCompletionsRequestBody


PromptAssembledObservation ​

Re-exports PromptAssembledObservation


PromptAssembledObserverFn ​

Re-exports PromptAssembledObserverFn


RawGenerationObservation ​

Re-exports RawGenerationObservation


RawGenerationObserverFn ​

Re-exports RawGenerationObserverFn


ReasoningExtract ​

Re-exports ReasoningExtract


ReasoningField ​

Re-exports ReasoningField


ReasoningFieldPrecedence ​

Re-exports ReasoningFieldPrecedence


renderChatCompletionsSystemPrompt ​

Re-exports renderChatCompletionsSystemPrompt


renderChatCompletionsToolCallResult ​

Re-exports renderChatCompletionsToolCallResult


renderFirstPartyRetrievables ​

Re-exports renderFirstPartyRetrievables


renderMemories ​

Re-exports renderMemories


renderRetrievables ​

Re-exports renderRetrievables


renderRetrievableSafetyDirective ​

Re-exports renderRetrievableSafetyDirective


renderStandingInstructions ​

Re-exports renderStandingInstructions


renderThirdPartyPrivateRetrievables ​

Re-exports renderThirdPartyPrivateRetrievables


renderThirdPartyPublicRetrievables ​

Re-exports renderThirdPartyPublicRetrievables


renderThought ​

Re-exports renderThought


renderTimelineMessage ​

Re-exports renderTimelineMessage


renderTrustedContent ​

Re-exports renderTrustedContent


renderUntrustedContent ​

Re-exports renderUntrustedContent


RetrievableAttrs ​

Re-exports RetrievableAttrs


sanitizeFilenameForDescription ​

Re-exports sanitizeFilenameForDescription


sanitizeMimeType ​

Re-exports sanitizeMimeType


StandingInstructionAttrs ​

Re-exports StandingInstructionAttrs


stripEnvelopeSpecialTokens ​

Re-exports stripEnvelopeSpecialTokens


ThoughtAttrs ​

Re-exports ThoughtAttrs


ToolCallIdFilterFn ​

Re-exports ToolCallIdFilterFn


toolsToChatCompletionsTools ​

Re-exports toolsToChatCompletionsTools


TrustedContentAttrs ​

Re-exports TrustedContentAttrs


UntrustedContentAttrs ​

Re-exports UntrustedContentAttrs


validateOptions ​

Re-exports validateOptions