@nhtio/adk

Appearance

3 min read · 655 words

@nhtio/adk/batteries/llm/bedrock_converse ​

Native AWS Bedrock Converse adapter battery with swappable translation helpers and wire types.

Remarks ​

Targets Bedrock's NATIVE POST {baseURL}/model/{modelId}/converse surface over plain HTTPS with a Bedrock API key (Authorization: Bearer ABSK…) — no AWS SDK, no SigV4 signer, so the battery stays cross-environment and dependency-light.

Converse is a content-BLOCK protocol and differs from Chat Completions structurally: a turn's payload is a typed content[] ({text}, {image}, {toolUse}, {toolResult}) so one assistant turn can carry prose and a tool call together; a tool result rides a user turn; system text is a top-level system[]; roles must strictly alternate; and toolConfig is REQUIRED whenever any tool block appears, including pure history replay.

That last pair is why this battery exists. A gateway fronting Converse has to repair non-alternating history on your behalf — typically by merging consecutive same-role turns — and that repair is invisible in the response, which makes a gateway's fix indistinguishable from vendor tolerance. BedrockConverseAdapterOptions.alternationPolicy exposes the choice: 'merge' (default, lossless), 'filler', or 'reject' to let Converse's own error surface when you are auditing what the vendor actually enforces. See the validation battery's "Which API surface a rule applies to" guide.

References ​

BedrockConverseAdapter ​

Re-exports BedrockConverseAdapter

BedrockConverseAdapterOptions ​

Re-exports BedrockConverseAdapterOptions

BedrockConverseHelpers ​

Re-exports BedrockConverseHelpers

bedrockConverseOptionsSchema ​

Re-exports bedrockConverseOptionsSchema

buildConverseRequest ​

Re-exports buildConverseRequest

ChatCompletionsBucketLabel ​

Re-exports ChatCompletionsBucketLabel

ChatCompletionsBucketOrder ​

Re-exports ChatCompletionsBucketOrder

ChatCompletionsRetryConfig ​

Re-exports ChatCompletionsRetryConfig

ChatHelpersCommon ​

Re-exports ChatHelpersCommon

ConverseContentBlock ​

Re-exports ConverseContentBlock

ConverseImageBlock ​

Re-exports ConverseImageBlock

ConverseInferenceConfig ​

Re-exports ConverseInferenceConfig

ConverseMessage ​

Re-exports ConverseMessage

ConverseRequest ​

Re-exports ConverseRequest

ConverseRequestBuildInput ​

Re-exports ConverseRequestBuildInput

ConverseResponse ​

Re-exports ConverseResponse

ConverseRole ​

Re-exports ConverseRole

ConverseSystemBlock ​

Re-exports ConverseSystemBlock

ConverseToolChoice ​

Re-exports ConverseToolChoice

ConverseToolConfig ​

Re-exports ConverseToolConfig

ConverseToolResult ​

Re-exports ConverseToolResult

ConverseToolSpec ​

Re-exports ConverseToolSpec

ConverseToolUse ​

Re-exports ConverseToolUse

ConverseUsage ​

Re-exports ConverseUsage

deCollideToolCallIds ​

Re-exports deCollideToolCallIds

DEFAULT_CONVERSE_BUCKET_ORDER ​

Re-exports DEFAULT_CONVERSE_BUCKET_ORDER

defaultBuildConverseRequest ​

Re-exports defaultBuildConverseRequest

defaultDescriptionToChatCompletionsJsonSchema ​

Re-exports defaultDescriptionToChatCompletionsJsonSchema

defaultEnforceConverseAlternation ​

Re-exports defaultEnforceConverseAlternation

defaultExtractConverseGeneration ​

Re-exports defaultExtractConverseGeneration

defaultFilterThoughts ​

Re-exports defaultFilterThoughts

defaultMediaToConverseImage ​

Re-exports defaultMediaToConverseImage

defaultRenderArtifactHandleBody ​

Re-exports defaultRenderArtifactHandleBody

defaultRenderChatCompletionsSystemPrompt ​

Re-exports defaultRenderChatCompletionsSystemPrompt

defaultRenderConverseToolResult ​

Re-exports defaultRenderConverseToolResult

defaultRenderFirstPartyRetrievables ​

Re-exports defaultRenderFirstPartyRetrievables

defaultRenderMemories ​

Re-exports defaultRenderMemories

defaultRenderRetrievableHandleBody ​

Re-exports defaultRenderRetrievableHandleBody

defaultRenderRetrievables ​

Re-exports defaultRenderRetrievables

defaultRenderRetrievableSafetyDirective ​

Re-exports defaultRenderRetrievableSafetyDirective

defaultRenderStandingInstructions ​

Re-exports defaultRenderStandingInstructions

defaultRenderThirdPartyPrivateRetrievables ​

Re-exports defaultRenderThirdPartyPrivateRetrievables

defaultRenderThirdPartyPublicRetrievables ​

Re-exports defaultRenderThirdPartyPublicRetrievables

defaultRenderThought ​

Re-exports defaultRenderThought

defaultRenderTrustedContent ​

Re-exports defaultRenderTrustedContent

defaultRenderUntrustedContent ​

Re-exports defaultRenderUntrustedContent

defaultSanitizeConverseSchema ​

Re-exports defaultSanitizeConverseSchema

defaultSanitizeToolUseId ​

Re-exports defaultSanitizeToolUseId

defaultToolsToConverseTools ​

Re-exports defaultToolsToConverseTools

DescriptionLike ​

Re-exports DescriptionLike

descriptionToChatCompletionsJsonSchema ​

Re-exports descriptionToChatCompletionsJsonSchema

E_CONVERSE_ALTERNATION_VIOLATION ​

Re-exports E_CONVERSE_ALTERNATION_VIOLATION

E_CONVERSE_INVALID_TOOL_INPUT ​

Re-exports E_CONVERSE_INVALID_TOOL_INPUT

E_CONVERSE_MISSING_TOOL_CONFIG ​

Re-exports E_CONVERSE_MISSING_TOOL_CONFIG

E_CONVERSE_REQUEST_FAILED ​

Re-exports E_CONVERSE_REQUEST_FAILED

E_CONVERSE_STREAM_ERROR ​

Re-exports E_CONVERSE_STREAM_ERROR

E_INVALID_BEDROCK_CONVERSE_OPTIONS ​

Re-exports E_INVALID_BEDROCK_CONVERSE_OPTIONS

enforceConverseAlternation ​

Re-exports enforceConverseAlternation

extractConverseGeneration ​

Re-exports extractConverseGeneration

filterThoughts ​

Re-exports filterThoughts

JsonSchema ​

Re-exports JsonSchema

mediaToConverseImage ​

Re-exports mediaToConverseImage

MemoryAttrs ​

Re-exports MemoryAttrs

PromptAssembledObserverFn ​

Re-exports PromptAssembledObserverFn

RawGenerationObserverFn ​

Re-exports RawGenerationObserverFn

renderArtifactHandleBody ​

Re-exports renderArtifactHandleBody

renderChatCompletionsSystemPrompt ​

Re-exports renderChatCompletionsSystemPrompt

renderConverseToolResult ​

Re-exports renderConverseToolResult

renderFirstPartyRetrievables ​

Re-exports renderFirstPartyRetrievables

renderMemories ​

Re-exports renderMemories

renderRetrievableHandleBody ​

Re-exports renderRetrievableHandleBody

renderRetrievables ​

Re-exports renderRetrievables

renderRetrievableSafetyDirective ​

Re-exports renderRetrievableSafetyDirective

renderStandingInstructions ​

Re-exports renderStandingInstructions

renderThirdPartyPrivateRetrievables ​

Re-exports renderThirdPartyPrivateRetrievables

renderThirdPartyPublicRetrievables ​

Re-exports renderThirdPartyPublicRetrievables

renderThought ​

Re-exports renderThought

renderTrustedContent ​

Re-exports renderTrustedContent

renderUntrustedContent ​

Re-exports renderUntrustedContent

RetrievableAttrs ​

Re-exports RetrievableAttrs

sanitizeConverseSchema ​

Re-exports sanitizeConverseSchema

sanitizeToolUseId ​

Re-exports sanitizeToolUseId

StandingInstructionAttrs ​

Re-exports StandingInstructionAttrs

ThoughtAttrs ​

Re-exports ThoughtAttrs

ToolCallIdFilterFn ​

Re-exports ToolCallIdFilterFn

ToolCallParserFn ​

Re-exports ToolCallParserFn

ToolCallParserName ​

Re-exports ToolCallParserName

toolsToConverseTools ​

Re-exports toolsToConverseTools

TrustedContentAttrs ​

Re-exports TrustedContentAttrs

UnsupportedMediaPolicy ​

Re-exports UnsupportedMediaPolicy

UntrustedContentAttrs ​

Re-exports UntrustedContentAttrs

validateOptions ​

Re-exports validateOptions

Copyright © 2025-present New Horizon Technology LTD